request-iframe 0.0.1

package/library/types/index.d.ts

@@ -0,0 +1,408 @@
+/**
+ * Request default configuration
+ * Can be set when creating requestIframeClient, and can be overridden on each request
+ */
+export interface RequestDefaults {
+    /** ACK confirmation timeout (milliseconds), timeout for waiting for the other party to acknowledge the message, default 500 */
+    ackTimeout?: number;
+    /** Request timeout (milliseconds), timeout for waiting for the server to return the result, default 5000 */
+    timeout?: number;
+    /** Async request timeout (milliseconds), timeout after the server indicates it's an async task, default 120000 */
+    asyncTimeout?: number;
+}
+/**
+ * sender.send configuration options
+ */
+export interface RequestOptions extends RequestDefaults {
+    /** Custom request ID */
+    requestId?: string;
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Request cookies */
+    cookies?: Record<string, string>;
+}
+/**
+ * sender.send request configuration (internal use)
+ */
+export interface RequestConfig extends RequestOptions {
+    /** Interaction event ID (equivalent to path) */
+    path: string;
+    /** Request body */
+    body?: Record<string, any>;
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Request cookies */
+    cookies?: Record<string, string>;
+}
+/**
+ * Response data
+ */
+export interface Response<T = any> {
+    /** Response data */
+    data: T;
+    /** Status code */
+    status: number;
+    /** Status text */
+    statusText: string;
+    /** Request ID */
+    requestId: string;
+    /** Response headers (Set-Cookie is a string array) */
+    headers?: Record<string, string | string[]>;
+    /** File data (if response is a file) */
+    fileData?: {
+        content: string;
+        mimeType?: string;
+        fileName?: string;
+    };
+    /** Stream data (if response is a stream) */
+    stream?: import('../stream').IIframeReadableStream<T>;
+}
+/**
+ * Error response
+ */
+export interface ErrorResponse {
+    /** Error message */
+    message: string;
+    /** Error code */
+    code?: string;
+    /** Request configuration */
+    config?: RequestConfig;
+    /** Response data (if available) */
+    response?: {
+        data: any;
+        status: number;
+        statusText: string;
+    };
+    /** Request ID */
+    requestId?: string;
+}
+/**
+ * Interceptor function type
+ */
+export type InterceptorFunction<T> = (value: T) => T | Promise<T>;
+/**
+ * Request interceptor
+ */
+export interface RequestInterceptor {
+    fulfilled: InterceptorFunction<RequestConfig>;
+    rejected?: (error: any) => any;
+}
+/**
+ * Response interceptor
+ */
+export interface ResponseInterceptor {
+    fulfilled: InterceptorFunction<Response>;
+    rejected?: (error: ErrorResponse) => any;
+}
+/**
+ * PostMessage message format
+ *
+ * @description
+ * The __requestIframe__ field is the protocol version identifier, used to:
+ * - Distinguish request-iframe framework messages from other messages
+ * - Support compatibility handling for future version upgrades
+ *
+ * Version evolution rules:
+ * - Minor updates (e.g., adding optional fields): keep version number unchanged
+ * - Major updates (e.g., changing core field structure): increment version number
+ */
+export interface PostMessageData {
+    /**
+     * Protocol version identifier
+     * - Used to identify request-iframe framework messages
+     * - The value represents the protocol version number, current version is 1
+     * - Future version upgrades can use this field for compatibility handling
+     */
+    __requestIframe__: number;
+    /**
+     * Message creation timestamp (milliseconds)
+     * - Used for debugging and analyzing message latency
+     * - Automatically added when each message is sent
+     */
+    timestamp: number;
+    /** Message isolation key (used to isolate different businesses/instances) */
+    secretKey?: string;
+    /** Message type */
+    type: 'request' | 'ack' | 'async' | 'response' | 'error' | 'received' | 'ping' | 'pong' | 'stream_start' | 'stream_data' | 'stream_end' | 'stream_error' | 'stream_cancel';
+    /** Request ID */
+    requestId: string;
+    /** Request path */
+    path?: string;
+    /** Request body */
+    body?: any;
+    /**
+     * Headers
+     * - On request: request headers
+     * - On response: response headers (Set-Cookie is a string array)
+     */
+    headers?: Record<string, string | string[]>;
+    /**
+     * Cookies (only used for requests)
+     * - On request: request cookies (auto-carried by client + manually passed by user)
+     * - On response: no longer used, use headers['Set-Cookie'] instead
+     */
+    cookies?: Record<string, string>;
+    /** Response data */
+    data?: any;
+    /** File data (base64 encoded, used for sendFile) */
+    fileData?: {
+        content: string;
+        mimeType?: string;
+        fileName?: string;
+    };
+    /** Error information */
+    error?: {
+        message: string;
+        code?: string;
+    };
+    /** Status code */
+    status?: number;
+    /** Status text */
+    statusText?: string;
+    /** Whether client confirmation of receipt is required (for response/error messages) */
+    requireAck?: boolean;
+}
+/**
+ * Server Request object (similar to express)
+ */
+export interface ServerRequest {
+    /** Request body */
+    body: any;
+    /** Request headers */
+    headers: Record<string, string>;
+    /** Request cookies */
+    cookies: Record<string, string>;
+    /** Request path */
+    path: string;
+    /** Request ID */
+    requestId: string;
+    /** Sender origin */
+    origin: string;
+    /** Sender window reference */
+    source: Window;
+    /** Response object reference (consistent with Express) */
+    res: ServerResponse;
+}
+/**
+ * Send response options
+ */
+export interface SendOptions {
+    /**
+     * Whether client confirmation of receipt is required
+     * - If true, the Promise returned by send/json/sendFile will resolve after the client confirms receipt
+     * - If false (default), resolves immediately without waiting for client confirmation
+     */
+    requireAck?: boolean;
+}
+/**
+ * Send file options
+ */
+export interface SendFileOptions extends SendOptions {
+    /** File MIME type */
+    mimeType?: string;
+    /** File name */
+    fileName?: string;
+}
+/**
+ * Cookie options (consistent with Express)
+ */
+export interface CookieOptions {
+    /** Cookie expiration time */
+    expires?: Date;
+    /** Cookie maximum age (seconds) */
+    maxAge?: number;
+    /** Cookie domain */
+    domain?: string;
+    /** Cookie path */
+    path?: string;
+    /** Whether to send only over HTTPS connections */
+    secure?: boolean;
+    /** Whether to forbid JavaScript access */
+    httpOnly?: boolean;
+    /** Cookie SameSite attribute */
+    sameSite?: boolean | 'lax' | 'strict' | 'none';
+}
+/**
+ * Server Response object (similar to express)
+ */
+export interface ServerResponse {
+    /**
+     * Send response data
+     * @param data Response data
+     * @param options Send options
+     * @returns Promise<boolean> - If requireAck is true, resolves after client confirms receipt; otherwise resolves immediately
+     */
+    send(data: any, options?: SendOptions): Promise<boolean>;
+    /**
+     * Send JSON response
+     * @param data JSON data
+     * @param options Send options
+     * @returns Promise<boolean> - If requireAck is true, resolves after client confirms receipt; otherwise resolves immediately
+     */
+    json(data: any, options?: SendOptions): Promise<boolean>;
+    /**
+     * Send file (base64 encoded)
+     * @param content File content
+     * @param options Send options (includes mimeType, fileName, requireAck)
+     * @returns Promise<boolean> - If requireAck is true, resolves after client confirms receipt; otherwise resolves immediately
+     */
+    sendFile(content: string | Blob | File, options?: SendFileOptions): Promise<boolean>;
+    /**
+     * Send stream response
+     * @param stream Writable stream object
+     * @returns Promise<void> - Resolves after stream transfer completes
+     */
+    sendStream(stream: import('../stream').IframeWritableStream): Promise<void>;
+    /** Set response status code (chainable) */
+    status(code: number): ServerResponse;
+    /** Set response header (consistent with Express, returns void) */
+    setHeader(name: string, value: string | number | string[]): void;
+    /** Set response header (chainable version, compatible with Express res.set) */
+    set(name: string, value: string | number | string[]): ServerResponse;
+    /** Set response cookie (consistent with Express, uses cookie method) */
+    cookie(name: string, value: string, options?: CookieOptions): ServerResponse;
+    /** Clear cookie (consistent with Express) */
+    clearCookie(name: string, options?: CookieOptions): ServerResponse;
+    /** Current status code */
+    statusCode: number;
+    /** Response headers (Set-Cookie is a string array) */
+    headers: Record<string, string | string[]>;
+    /** Internal property: whether response has been sent */
+    _sent?: boolean;
+}
+/**
+ * Path matcher type (supports string, RegExp, PathPattern, Array)
+ */
+export type PathMatcher = string | RegExp | Array<string | RegExp>;
+/**
+ * Middleware function type
+ */
+export type Middleware = (req: ServerRequest, res: ServerResponse, next: () => void | Promise<void>) => void | Promise<void>;
+/**
+ * Server handler function (similar to express)
+ */
+export type ServerHandler = (req: ServerRequest, res: ServerResponse) => any | Promise<any>;
+/**
+ * server.on/off event names (low-level)
+ */
+export type ServerEventName = 'request' | 'ack' | 'async' | 'response' | 'error' | 'received' | 'ping' | 'pong';
+/**
+ * Client interface
+ */
+export interface RequestIframeClient {
+    /** Interceptors (only effective for send) */
+    interceptors: {
+        request: import('../interceptors').RequestInterceptorManager;
+        response: import('../interceptors').ResponseInterceptorManager;
+    };
+    /** Send request */
+    send<T = any>(path: string, body?: Record<string, any>, options?: RequestOptions): Promise<Response<T>>;
+    /** Check if server is reachable */
+    isConnect(): Promise<boolean>;
+    /**
+     * Get all cookies matching the specified path
+     * @param path Request path, returns all cookies if not provided
+     */
+    getCookies(path?: string): Record<string, string>;
+    /**
+     * Get specified cookie
+     * @param name Cookie name
+     * @param path Path (optional)
+     */
+    getCookie(name: string, path?: string): string | undefined;
+    /**
+     * Set cookie
+     * @param name Cookie name
+     * @param value Cookie value
+     * @param options Cookie options (path, etc.)
+     */
+    setCookie(name: string, value: string, options?: {
+        path?: string;
+        expires?: Date;
+        maxAge?: number;
+    }): void;
+    /**
+     * Delete specified cookie
+     * @param name Cookie name
+     * @param path Path (optional, defaults to '/')
+     */
+    removeCookie(name: string, path?: string): void;
+    /**
+     * Clear all cookies
+     */
+    clearCookies(): void;
+}
+/**
+ * Client server interface (used on client side, handles responses only)
+ */
+export interface RequestIframeClientServer {
+    /** Destroy server (remove message listener) */
+    destroy(): void;
+    /** Internal method: listen to low-level events */
+    _on(event: ServerEventName, fn: (payload: any) => void): void;
+    /** Internal method: unsubscribe from low-level events */
+    _off(event: ServerEventName, fn?: (payload: any) => void): void;
+    /** Internal method: for client to register pending Promise for response */
+    _registerPendingRequest(requestId: string, resolve: (data: PostMessageData) => void, reject: (error: Error) => void, origin?: string): void;
+    /** Internal method: for client to cancel waiting */
+    _unregisterPendingRequest(requestId: string): void;
+}
+/**
+ * Server interface (used on server side, handles requests and responses)
+ */
+export interface RequestIframeServer {
+    /** Message isolation key (read-only) */
+    readonly secretKey?: string;
+    /** Whether message handling is enabled */
+    readonly isOpen: boolean;
+    /** Enable message handling (register message handler) */
+    open(): void;
+    /** Disable message handling (unregister message handler, but don't release resources) */
+    close(): void;
+    /**
+     * Register middleware
+     * - use(middleware): Register global middleware (executed before all routes)
+     * - use(path, middleware): Register path-matching middleware (path supports string, RegExp, PathPattern, Array)
+     */
+    use(middleware: Middleware): void;
+    use(path: PathMatcher, middleware: Middleware): void;
+    /** Register route handler */
+    on(path: string, handler: ServerHandler): void;
+    /** Unregister route handler */
+    off(path: string): void;
+    /** Batch register route handlers (via key: value object) */
+    map(handlers: Record<string, ServerHandler>): void;
+    /** Destroy server (close and release resources) */
+    destroy(): void;
+}
+/**
+ * requestIframeClient entry options
+ */
+export interface RequestIframeClientOptions extends RequestDefaults {
+    /**
+     * Message isolation key.
+     * If configured, automatically adds a unified prefix to the path of all messages (to avoid conflicts between different businesses), and only processes framework messages with the same secretKey.
+     */
+    secretKey?: string;
+    /**
+     * Whether to enable trace mode.
+     * If true, logs will be printed at various points such as before and after requests.
+     */
+    trace?: boolean;
+}
+/**
+ * requestIframeServer entry options
+ */
+export interface RequestIframeServerOptions extends Pick<RequestDefaults, 'ackTimeout'> {
+    /**
+     * Message isolation key.
+     * If configured, automatically adds a unified prefix to the path of all messages (to avoid conflicts between different businesses), and only processes framework messages with the same secretKey.
+     */
+    secretKey?: string;
+    /**
+     * Whether to enable trace mode.
+     * If true, logs will be printed at various points such as before and after requests, server receive/respond, etc.
+     */
+    trace?: boolean;
+}
+//# sourceMappingURL=index.d.ts.map

package/library/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,+HAA+H;IAC/H,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4GAA4G;IAC5G,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kHAAkH;IAClH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,GAAG;IAC/B,oBAAoB;IACpB,IAAI,EAAE,CAAC,CAAC;IACR,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC5C,wCAAwC;IACxC,QAAQ,CAAC,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,WAAW,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,mCAAmC;IACnC,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,GAAG,CAAC;QACV,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAC9C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,GAAG,CAAC;CAC1C;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GACjF,cAAc,GAAG,aAAa,GAAG,YAAY,GAAG,cAAc,GAAG,eAAe,CAAC;IACvF,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC5C;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,oBAAoB;IACpB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,oDAAoD;IACpD,QAAQ,CAAC,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,wBAAwB;IACxB,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uFAAuF;IACvF,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,IAAI,EAAE,GAAG,CAAC;IACV,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,GAAG,EAAE,cAAc,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrF;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,OAAO,WAAW,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,2CAA2C;IAC3C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC;IACrC,kEAAkE;IAClE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IACjE,+EAA+E;IAC/E,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc,CAAC;IACrE,wEAAwE;IACxE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC;IAC7E,6CAA6C;IAC7C,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC;IACnE,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC3C,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CACvB,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAC7B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,cAAc,KAChB,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,YAAY,EAAE;QACZ,OAAO,EAAE,OAAO,iBAAiB,EAAE,yBAAyB,CAAC;QAC7D,QAAQ,EAAE,OAAO,iBAAiB,EAAE,0BAA0B,CAAC;KAChE,CAAC;IACF,mBAAmB;IACnB,IAAI,CAAC,CAAC,GAAG,GAAG,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACxB,mCAAmC;IACnC,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B;;;OAGG;IACH,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3D;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3G;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD;;OAEG;IACH,YAAY,IAAI,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,+CAA+C;IAC/C,OAAO,IAAI,IAAI,CAAC;IAChB,kDAAkD;IAClD,GAAG,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;IAC9D,yDAAyD;IACzD,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;IAChE,2EAA2E;IAC3E,uBAAuB,CACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,EACxC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAC9B,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAAC;IACR,oDAAoD;IACpD,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,yDAAyD;IACzD,IAAI,IAAI,IAAI,CAAC;IACb,yFAAyF;IACzF,KAAK,IAAI,IAAI,CAAC;IACd;;;;OAIG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACrD,6BAA6B;IAC7B,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/C,+BAA+B;IAC/B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,4DAA4D;IAC5D,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI,CAAC;IACnD,mDAAmD;IACnD,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,eAAe;IACjE;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC;IACrF;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/library/types/index.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/library/utils/cache.d.ts

@@ -0,0 +1,19 @@
+import { MessageChannel, ChannelType } from '../message';
+/**
+ * Get or create MessageChannel instance
+ * - Within the same window, only one channel is created per type + secretKey combination
+ * - Uses reference counting to manage lifecycle
+ * @param secretKey secret key for message isolation
+ * @param type channel type (defaults to postMessage)
+ */
+export declare function getOrCreateMessageChannel(secretKey?: string, type?: ChannelType): MessageChannel;
+/**
+ * Release MessageChannel reference
+ * - When reference count reaches 0, destroy channel and remove from cache
+ */
+export declare function releaseMessageChannel(channel: MessageChannel): void;
+/**
+ * Clear all MessageChannel cache (mainly for testing)
+ */
+export declare function clearMessageChannelCache(): void;
+//# sourceMappingURL=cache.d.ts.map

package/library/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA2BzD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,CAAC,EAAE,MAAM,EAClB,IAAI,GAAE,WAAsC,GAC3C,cAAc,CAYhB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAYnE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C"}

package/library/utils/cache.js

@@ -0,0 +1,83 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.clearMessageChannelCache = clearMessageChannelCache;
+exports.getOrCreateMessageChannel = getOrCreateMessageChannel;
+exports.releaseMessageChannel = releaseMessageChannel;
+require("core-js/modules/es.array.iterator.js");
+require("core-js/modules/es.map.js");
+require("core-js/modules/web.dom-collections.for-each.js");
+require("core-js/modules/web.dom-collections.iterator.js");
+var _message = require("../message");
+/**
+ * Global cache Symbol (used to store MessageChannel instance cache on window)
+ * Using Symbol.for() ensures multiple library copies share the same cache, avoiding multiple instance creation
+ */
+var MESSAGE_CHANNEL_CACHE_SYMBOL = Symbol.for('__requestIframeMessageChannelCache__');
+
+/**
+ * Get the MessageChannel cache from window
+ */
+function getChannelCacheForWindow(win) {
+  if (!(MESSAGE_CHANNEL_CACHE_SYMBOL in win)) {
+    win[MESSAGE_CHANNEL_CACHE_SYMBOL] = new Map();
+  }
+  return win[MESSAGE_CHANNEL_CACHE_SYMBOL];
+}
+
+/**
+ * Generate cache key
+ * Cache key format: "type:secretKey" or "type:" when no secretKey
+ * Different channel types use separate cache entries
+ */
+function getCacheKey(type, secretKey) {
+  return `${type}:${secretKey !== null && secretKey !== void 0 ? secretKey : ''}`;
+}
+
+/**
+ * Get or create MessageChannel instance
+ * - Within the same window, only one channel is created per type + secretKey combination
+ * - Uses reference counting to manage lifecycle
+ * @param secretKey secret key for message isolation
+ * @param type channel type (defaults to postMessage)
+ */
+function getOrCreateMessageChannel(secretKey, type = _message.ChannelType.POST_MESSAGE) {
+  var cache = getChannelCacheForWindow(window);
+  var key = getCacheKey(type, secretKey);
+  var channel = cache.get(key);
+  if (!channel) {
+    channel = new _message.MessageChannel(secretKey, type);
+    cache.set(key, channel);
+  }
+  channel.addRef();
+  return channel;
+}
+
+/**
+ * Release MessageChannel reference
+ * - When reference count reaches 0, destroy channel and remove from cache
+ */
+function releaseMessageChannel(channel) {
+  var refCount = channel.release();
+  if (refCount <= 0) {
+    var cache = getChannelCacheForWindow(window);
+    var key = getCacheKey(channel.type, channel.secretKey);
+    if (cache.get(key) === channel) {
+      cache.delete(key);
+      channel.destroy();
+    }
+  }
+}
+
+/**
+ * Clear all MessageChannel cache (mainly for testing)
+ */
+function clearMessageChannelCache() {
+  var cache = getChannelCacheForWindow(window);
+  cache.forEach(channel => {
+    channel.destroy();
+  });
+  cache.clear();
+}

package/library/utils/cookie.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Cookie management utilities
+ * Implements browser-like Cookie mechanism
+ */
+/**
+ * Cookie storage item
+ */
+export interface CookieItem {
+    /** Cookie name */
+    name: string;
+    /** Cookie value */
+    value: string;
+    /** Path, defaults to '/' */
+    path: string;
+    /** Expiration time (timestamp) */
+    expires?: number;
+    /** HttpOnly flag (marker only, no actual effect in postMessage) */
+    httpOnly?: boolean;
+    /** Secure flag (marker only) */
+    secure?: boolean;
+    /** SameSite attribute (marker only) */
+    sameSite?: 'Strict' | 'Lax' | 'None';
+}
+/**
+ * Cookie options (for res.cookie)
+ */
+export interface CookieOptions {
+    /** Path, defaults to '/' */
+    path?: string;
+    /** Expiration date */
+    expires?: Date;
+    /** Max-Age (seconds) */
+    maxAge?: number;
+    /** HttpOnly flag */
+    httpOnly?: boolean;
+    /** Secure flag */
+    secure?: boolean;
+    /** SameSite attribute */
+    sameSite?: 'Strict' | 'Lax' | 'None';
+}
+/**
+ * Parse Set-Cookie string to CookieItem
+ * @param setCookieStr Set-Cookie string, e.g., "token=abc; Path=/; HttpOnly"
+ */
+export declare function parseSetCookie(setCookieStr: string): CookieItem | null;
+/**
+ * Serialize CookieItem to Set-Cookie string
+ */
+export declare function serializeSetCookie(cookie: CookieItem): string;
+/**
+ * Create Set-Cookie string from CookieOptions
+ */
+export declare function createSetCookie(name: string, value: string, options?: CookieOptions): string;
+/**
+ * Create Set-Cookie string to delete Cookie
+ */
+export declare function createClearCookie(name: string, options?: {
+    path?: string;
+}): string;
+/**
+ * Check if request path matches Cookie's path attribute
+ * Implements RFC 6265 path matching algorithm
+ * @param requestPath request path, e.g., "/api/users"
+ * @param cookiePath Cookie's path attribute, e.g., "/api"
+ */
+export declare function matchCookiePath(requestPath: string, cookiePath: string): boolean;
+/**
+ * Cookie storage manager
+ */
+export declare class CookieStore {
+    private cookies;
+    /**
+     * Generate unique key for Cookie
+     */
+    private getKey;
+    /**
+     * Set Cookie
+     */
+    set(cookie: CookieItem): void;
+    /**
+     * Set Cookie from Set-Cookie string
+     */
+    setFromSetCookie(setCookieStr: string): void;
+    /**
+     * Remove Cookie
+     */
+    remove(name: string, path?: string): void;
+    /**
+     * Get all Cookies matching specified path
+     * @param requestPath request path
+     * @returns matching cookies, format: Record<string, string>
+     */
+    getForPath(requestPath: string): Record<string, string>;
+    /**
+     * Get Cookie value by name
+     * @param name Cookie name
+     * @param path path (optional, returns first match if not specified)
+     */
+    get(name: string, path?: string): string | undefined;
+    /**
+     * Get all Cookies (with full info)
+     */
+    getAll(): CookieItem[];
+    /**
+     * Get all Cookies (simple format)
+     */
+    getAllSimple(): Record<string, string>;
+    /**
+     * Clear all Cookies
+     */
+    clear(): void;
+    /**
+     * Cleanup expired Cookies
+     */
+    cleanup(): void;
+}
+//# sourceMappingURL=cookie.d.ts.map

package/library/utils/cookie.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie.d.ts","sourceRoot":"","sources":["../../src/utils/cookie.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kBAAkB;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA8DtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAwB7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CA2B5F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAInF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAmBhF;AAkBD;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAsC;IAErD;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAK7B;;OAEG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAY5C;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAY,GAAG,IAAI;IAK9C;;;;OAIG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAsBvD;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAqBpD;;OAEG;IACH,MAAM,IAAI,UAAU,EAAE;IAatB;;OAEG;IACH,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAatC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,IAAI,IAAI;CAYhB"}