<?php

declare(strict_types=1);

namespace Drupal\nodehive_path_alias;

/**
 * Resolves path aliases scoped to a NodeHive space.
 */
interface PathAliasSpaceLookupInterface {

  /**
   * Returns the system path for an alias within a space, or NULL if not found.
   *
   * @param string $alias
   *   The URL alias (e.g. '/about').
   * @param int $spaceId
   *   The integer space ID.
   * @param string|null $langcode
   *   Optional content language code.
   *
   * @return string|null
   *   The system path (e.g. '/node/42') or NULL.
   */
  public function resolve(string $alias, int $spaceId, ?string $langcode): ?string;

}
