/**

 * 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

 */

import type {ReactClientValue} from 'react-server/src/ReactFlightServer';

import type {

  ImportMetadata,

  ImportManifestEntry,

} from './shared/ReactFlightImportMetadata';

import type {

  ClientReference,

  ServerReference,

} from './ReactFlightTurbopackReferences';

export type {ClientReference, ServerReference};

export type ClientManifest = {

  [id: string]: ClientReferenceManifestEntry,

};

export type ServerReferenceId = string;

export type ClientReferenceMetadata = ImportMetadata;

export opaque type ClientReferenceManifestEntry = ImportManifestEntry;

export type ClientReferenceKey = string;

export {

  isClientReference,

  isServerReference,

} from './ReactFlightTurbopackReferences';

export function getClientReferenceKey(

  reference: ClientReference<any>,

): ClientReferenceKey {

  return reference.$$async ? reference.$$id + '#async' : reference.$$id;

}

export function resolveClientReferenceMetadata<T>(

  config: ClientManifest,

  clientReference: ClientReference<T>,

): ClientReferenceMetadata {

  const modulePath = clientReference.$$id;

  let name = '';

  let resolvedModuleData = config[modulePath];

  if (resolvedModuleData) {

    // The potentially aliased name.

    name = resolvedModuleData.name;

  } else {

    // We didn't find this specific export name but we might have the * export

    // which contains this name as well.

    // TODO: It's unfortunate that we now have to parse this string. We should

    // probably go back to encoding path and name separately on the client reference.

    const idx = modulePath.lastIndexOf('#');

    if (idx !== -1) {

      name = modulePath.slice(idx + 1);

      resolvedModuleData = config[modulePath.slice(0, idx)];

    }

    if (!resolvedModuleData) {

      throw new Error(

        'Could not find the module "' +

          modulePath +

          '" in the React Client Manifest. ' +

          'This is probably a bug in the React Server Components bundler.',

      );

    }

  }

  if (clientReference.$$async === true) {

    return [resolvedModuleData.id, resolvedModuleData.chunks, name, 1];

  } else {

    return [resolvedModuleData.id, resolvedModuleData.chunks, name];

  }

}

export function getServerReferenceId<T>(

  config: ClientManifest,

  serverReference: ServerReference<T>,

): ServerReferenceId {

  return serverReference.$$id;

}

export function getServerReferenceBoundArguments<T>(

  config: ClientManifest,

  serverReference: ServerReference<T>,

): null | Array<ReactClientValue> {

  return serverReference.$$bound;

}