Initial commit

index.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Type definitions for @metatrom/ior-resolver
+ */
+
+export interface IORResolverContext {
+  originModulePath: string;
+  [key: string]: any;
+}
+
+export interface IORResolverResult {
+  type: 'sourceFile';
+  filePath: string;
+}
+
+export type IORResolver = (
+  context: IORResolverContext,
+  moduleName: string,
+  platform?: string
+) => IORResolverResult | undefined;
+
+export interface RemoteComponentConfig {
+  type: 'github' | 'gitea' | 'ipfs' | 'p2p';
+  owner?: string;
+  repository?: string;
+  componentName?: string;
+  version?: string;
+  branch?: string;
+  instance?: string;
+  hash?: string;
+  peerId?: string;
+}
+
+/**
+ * Create an IOR resolver for Metro bundler
+ * @param projectRoot - The root directory of the project
+ * @returns A resolver function for Metro
+ */
+export function createIORResolver(projectRoot: string): IORResolver;
+
+/**
+ * Create a hot-reloadable IOR resolver for Metro bundler
+ * @param projectRoot - The root directory of the project
+ * @returns A resolver function for Metro with hot reload support
+ */
+export function createHotReloadableResolver(projectRoot: string): IORResolver;
+
+/**
+ * Build mappings for local IOR components
+ * @param projectRoot - The root directory of the project
+ * @returns A Map of IOR to file path mappings
+ */
+export function buildIORMappings(projectRoot: string): Map<string, string>;
+
+/**
+ * Build mappings for local IOR components
+ * @param projectRoot - The root directory of the project
+ * @returns A Map of IOR to file path mappings
+ */
+export function buildLocalIORMappings(projectRoot: string): Map<string, string>;
+
+/**
+ * Fetch a remote component based on IOR
+ * @param ior - The IOR string to resolve
+ * @returns Promise resolving to the cached component path
+ */
+export function fetchRemoteComponent(ior: string): Promise<string>;
+
+/**
+ * Parse a remote IOR string
+ * @param ior - The IOR string to parse
+ * @returns The parsed configuration or null if invalid
+ */
+export function parseRemoteIOR(ior: string): RemoteComponentConfig | null;
+
+/**
+ * Clear the remote component cache
+ */
+export function clearRemoteCache(): void;
+
+/**
+ * Metro resolver module
+ */
+export const metro: {
+  createIORResolver: typeof createIORResolver;
+  createHotReloadableResolver: typeof createHotReloadableResolver;
+  buildIORMappings: typeof buildIORMappings;
+  buildLocalIORMappings: typeof buildLocalIORMappings;
+  fetchRemoteComponent: typeof fetchRemoteComponent;
+  parseRemoteIOR: typeof parseRemoteIOR;
+  clearRemoteCache: typeof clearRemoteCache;
+};