/**
 * Copyright (c) Meta Platforms, Inc. and affiliates.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 *
 * @flow strict-local
 * @format
 */

/**
 * A readonly view of URLSearchParams that only exposes read operations.
 */
export interface ReadonlyURLSearchParams {
  get(name: string): string | null;
  getAll(name: string): Array<string>;
  has(name: string, value?: string): boolean;
  +size: number;
  entries(): Iterator<[string, string]>;
  keys(): Iterator<string>;
  values(): Iterator<string>;
  forEach<This>(
    callback: (
      this: This,
      value: string,
      name: string,
      params: URLSearchParams,
    ) => mixed,
    thisArg: This,
  ): void;
  toString(): string;
  @@iterator(): Iterator<[string, string]>;
}

/**
 * A readonly view of URL that prevents mutation of URL properties.
 * Used for URLs passed between module boundaries.
 */
export interface ReadonlyURL {
  +hash: string;
  +host: string;
  +hostname: string;
  +href: string;
  +origin: string;
  +password: string;
  +pathname: string;
  +port: string;
  +protocol: string;
  +search: string;
  +searchParams: ReadonlyURLSearchParams;
  +username: string;
  toString(): string;
  toJSON(): string;
}