@miaixz/sdk 0.5.0

package/dist/runtime/direct-host-bridge.js

@@ -0,0 +1,299 @@
+import { MiaixzSdkError } from "../api/errors.js";
+import { MIAIXZ_MODULE_PROTOCOL_VERSION, } from "../contracts/index.js";
+import { isMiaixzModulePermission } from "../contracts/permission.js";
+import { translateMiaixzDefaultMessage } from "../i18n/default-translator.js";
+const moduleIdentifierPattern = /^[a-z][a-z0-9-]{1,63}$/;
+/**
+ * Creates a localized Direct Bridge error without including caller-owned data.
+ *
+ * @param code - Stable Bridge error code.
+ * @param messageKey - Registered internationalization message key.
+ * @returns Localized SDK error.
+ */
+function createBridgeError(code, messageKey) {
+    return new MiaixzSdkError(translateMiaixzDefaultMessage(messageKey), { code });
+}
+/**
+ * Determines whether a value is a plain record without a custom prototype.
+ *
+ * @param value - Runtime value to inspect.
+ * @returns Whether the value is a plain record.
+ */
+function isPlainRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+/**
+ * Determines whether a record contains only the supplied keys.
+ *
+ * @param value - Record whose keys should be inspected.
+ * @param allowedKeys - Complete set of allowed keys.
+ * @returns Whether every enumerable own key is allowed.
+ */
+function hasOnlyKeys(value, allowedKeys) {
+    return Object.keys(value).every((key) => allowedKeys.has(key));
+}
+/**
+ * Validates one module identifier before creating a bridge.
+ *
+ * @param moduleId - Module identifier to validate.
+ * @returns The unchanged valid identifier.
+ * @throws MiaixzSdkError When the identifier violates the module grammar.
+ */
+function parseModuleId(moduleId) {
+    if (!moduleIdentifierPattern.test(moduleId)) {
+        throw createBridgeError("BRIDGE_MESSAGE_INVALID", "sdk.error.bridge.messageInvalid");
+    }
+    return moduleId;
+}
+/**
+ * Validates and defensively copies one same-site navigation request.
+ *
+ * @param request - Navigation request to validate.
+ * @returns Frozen request containing a cloned state value.
+ * @throws MiaixzSdkError When the request or state is invalid.
+ */
+function parseNavigationRequest(request) {
+    if (!isPlainRecord(request) ||
+        !hasOnlyKeys(request, new Set(["path", "replace", "state"])) ||
+        typeof request.path !== "string" ||
+        !request.path.startsWith("/") ||
+        request.path.startsWith("//") ||
+        request.path.includes("\\") ||
+        (request.replace !== undefined && typeof request.replace !== "boolean")) {
+        throw createBridgeError("BRIDGE_MESSAGE_INVALID", "sdk.error.bridge.messageInvalid");
+    }
+    let state;
+    if (request.state !== undefined) {
+        try {
+            state = structuredClone(request.state);
+        }
+        catch {
+            throw createBridgeError("BRIDGE_NAVIGATION_STATE_INVALID", "sdk.error.bridge.navigationStateInvalid");
+        }
+    }
+    return Object.freeze({
+        path: request.path,
+        ...(request.replace === undefined ? {} : { replace: request.replace }),
+        ...(request.state === undefined ? {} : { state }),
+    });
+}
+/**
+ * Validates and freezes one non-wildcard module permission list.
+ *
+ * @param permissions - Permission list to validate.
+ * @returns Frozen defensive permission copy.
+ * @throws MiaixzSdkError When any permission is malformed.
+ */
+function parsePermissions(permissions) {
+    if (!Array.isArray(permissions) || !permissions.every(isMiaixzModulePermission)) {
+        throw createBridgeError("BRIDGE_MESSAGE_INVALID", "sdk.error.bridge.messageInvalid");
+    }
+    return Object.freeze([...permissions]);
+}
+/**
+ * Validates one event name against the module bound to the bridge.
+ *
+ * @param moduleId - Module identifier owning the bridge.
+ * @param type - Event type to validate.
+ * @returns The unchanged valid event type.
+ * @throws MiaixzSdkError When the event is outside the module namespace.
+ */
+function parseEventType(moduleId, type) {
+    if (typeof type !== "string") {
+        throw createBridgeError("BRIDGE_MESSAGE_INVALID", "sdk.error.bridge.messageInvalid");
+    }
+    const separator = type.indexOf(":");
+    const owner = type.slice(0, separator);
+    const eventName = type.slice(separator + 1);
+    if (separator < 0 ||
+        type.indexOf(":", separator + 1) >= 0 ||
+        owner !== moduleId ||
+        !moduleIdentifierPattern.test(owner) ||
+        !moduleIdentifierPattern.test(eventName)) {
+        throw createBridgeError("BRIDGE_MESSAGE_INVALID", "sdk.error.bridge.messageInvalid");
+    }
+    return type;
+}
+/**
+ * Implements the same-runtime Host Bridge with explicit capability injection.
+ */
+class MiaixzDirectHostBridge {
+    /**
+     * Micro-frontend protocol version implemented by the bridge.
+     */
+    protocolVersion = MIAIXZ_MODULE_PROTOCOL_VERSION;
+    #moduleId;
+    #adapter;
+    #subscriptions = new Set();
+    #disposed = false;
+    /**
+     * Creates one module-scoped Direct Bridge.
+     *
+     * @param options - Validated module identity and injected host capabilities.
+     */
+    constructor(options) {
+        this.#moduleId = parseModuleId(options.moduleId);
+        this.#adapter = options.adapter;
+    }
+    /**
+     * Reads the current non-sensitive host context.
+     *
+     * @returns Immutable runtime context from the host Adapter.
+     */
+    getContext() {
+        return Promise.resolve().then(() => {
+            this.#assertActive();
+            return this.#requireCapability("getContext")();
+        });
+    }
+    /**
+     * Sends a validated same-site navigation request to the host.
+     *
+     * @param request - Navigation request to validate and clone.
+     * @returns Promise settled after the host handles navigation.
+     */
+    navigate(request) {
+        return Promise.resolve().then(() => {
+            this.#assertActive();
+            const parsed = parseNavigationRequest(request);
+            return this.#requireCapability("navigate")(parsed);
+        });
+    }
+    /**
+     * Checks whether all validated permissions are available.
+     *
+     * @param permissions - Non-wildcard permissions to evaluate.
+     * @returns Whether every requested permission is available.
+     */
+    hasPermissions(permissions) {
+        return Promise.resolve().then(() => {
+            this.#assertActive();
+            const parsed = parsePermissions(permissions);
+            return this.#requireCapability("hasPermissions")(parsed);
+        });
+    }
+    /**
+     * Registers messages owned by the module bound to the bridge.
+     *
+     * @param namespace - Namespace that must equal the module identifier.
+     * @param catalog - Project message catalog to register.
+     * @returns Promise settled after the host registers the catalog.
+     */
+    registerMessages(namespace, catalog) {
+        return Promise.resolve().then(() => {
+            this.#assertActive();
+            if (namespace !== this.#moduleId) {
+                throw createBridgeError("BRIDGE_MESSAGE_INVALID", "sdk.error.bridge.messageInvalid");
+            }
+            return this.#requireCapability("registerMessages")(namespace, catalog);
+        });
+    }
+    /**
+     * Emits one event owned by the module bound to the bridge.
+     *
+     * @typeParam T - Event payload type.
+     * @param type - Module-scoped event name.
+     * @param payload - Event payload delivered to the host.
+     * @returns Promise settled after event delivery.
+     */
+    emit(type, payload) {
+        return Promise.resolve().then(() => {
+            this.#assertActive();
+            const parsedType = parseEventType(this.#moduleId, type);
+            return this.#requireCapability("emit")(parsedType, payload);
+        });
+    }
+    /**
+     * Subscribes to one event owned by the module bound to the bridge.
+     *
+     * @typeParam T - Event payload type.
+     * @param type - Module-scoped event name.
+     * @param listener - Event listener invoked by the host.
+     * @returns Idempotent asynchronous unsubscribe function.
+     */
+    subscribe(type, listener) {
+        return Promise.resolve().then(async () => {
+            this.#assertActive();
+            const parsedType = parseEventType(this.#moduleId, type);
+            if (typeof listener !== "function") {
+                throw createBridgeError("BRIDGE_MESSAGE_INVALID", "sdk.error.bridge.messageInvalid");
+            }
+            const unsubscribe = await this.#requireCapability("subscribe")(parsedType, listener);
+            if (typeof unsubscribe !== "function") {
+                throw createBridgeError("BRIDGE_MESSAGE_INVALID", "sdk.error.bridge.messageInvalid");
+            }
+            let cancelled = false;
+            const cancel = async () => {
+                if (cancelled)
+                    return;
+                cancelled = true;
+                this.#subscriptions.delete(cancel);
+                await Promise.resolve().then(unsubscribe);
+            };
+            if (this.#disposed) {
+                try {
+                    await cancel();
+                }
+                catch {
+                    // Cleanup failures cannot replace the deterministic disposed result.
+                }
+                throw createBridgeError("BRIDGE_DISPOSED", "sdk.error.bridge.disposed");
+            }
+            this.#subscriptions.add(cancel);
+            return cancel;
+        });
+    }
+    /**
+     * Releases tracked subscriptions and prevents further Adapter calls.
+     */
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        const subscriptions = [...this.#subscriptions];
+        this.#subscriptions.clear();
+        for (const unsubscribe of subscriptions) {
+            void unsubscribe().catch(() => undefined);
+        }
+    }
+    /**
+     * Rejects calls made after the bridge has been released.
+     *
+     * @throws MiaixzSdkError When the bridge has already been disposed.
+     */
+    #assertActive() {
+        if (this.#disposed) {
+            throw createBridgeError("BRIDGE_DISPOSED", "sdk.error.bridge.disposed");
+        }
+    }
+    /**
+     * Returns one injected Adapter capability.
+     *
+     * @typeParam Name - Adapter capability name.
+     * @param name - Capability to resolve.
+     * @returns Injected Adapter capability.
+     * @throws MiaixzSdkError When the host omitted the requested capability.
+     */
+    #requireCapability(name) {
+        const capability = this.#adapter[name];
+        if (capability === undefined) {
+            throw createBridgeError("BRIDGE_CAPABILITY_UNAVAILABLE", "sdk.error.bridge.capabilityUnavailable");
+        }
+        return capability;
+    }
+}
+/**
+ * Creates a module-scoped same-runtime Host Bridge.
+ *
+ * @param options - Module identity and explicitly injected host capabilities.
+ * @returns Host Bridge that delegates validated calls to the Adapter.
+ * @throws MiaixzSdkError When the module identifier is invalid.
+ * @public
+ */
+export function createMiaixzDirectHostBridge(options) {
+    return new MiaixzDirectHostBridge(options);
+}
+//# sourceMappingURL=direct-host-bridge.js.map

package/dist/runtime/direct-host-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-host-bridge.js","sourceRoot":"","sources":["../../src/runtime/direct-host-bridge.ts"],"names":[],"mappings":"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","sourcesContent":["import { MiaixzSdkError } from \"../api/errors.js\";\nimport {\n  MIAIXZ_MODULE_PROTOCOL_VERSION,\n  type MiaixzDirectHostBridgeOptions,\n  type MiaixzHostAdapter,\n  type MiaixzHostBridge,\n  type MiaixzNavigationRequest,\n} from \"../contracts/index.js\";\nimport { isMiaixzModulePermission } from \"../contracts/permission.js\";\nimport { translateMiaixzDefaultMessage } from \"../i18n/default-translator.js\";\nimport type { MiaixzMessageCatalog } from \"../i18n/index.js\";\nimport type { MiaixzRuntimeContext } from \"../types/index.js\";\n\nconst moduleIdentifierPattern = /^[a-z][a-z0-9-]{1,63}$/;\n\n/**\n * Creates a localized Direct Bridge error without including caller-owned data.\n *\n * @param code - Stable Bridge error code.\n * @param messageKey - Registered internationalization message key.\n * @returns Localized SDK error.\n */\nfunction createBridgeError(\n  code:\n    | \"BRIDGE_CAPABILITY_UNAVAILABLE\"\n    | \"BRIDGE_DISPOSED\"\n    | \"BRIDGE_MESSAGE_INVALID\"\n    | \"BRIDGE_NAVIGATION_STATE_INVALID\",\n  messageKey:\n    | \"sdk.error.bridge.capabilityUnavailable\"\n    | \"sdk.error.bridge.disposed\"\n    | \"sdk.error.bridge.messageInvalid\"\n    | \"sdk.error.bridge.navigationStateInvalid\",\n): MiaixzSdkError {\n  return new MiaixzSdkError(translateMiaixzDefaultMessage(messageKey), { code });\n}\n\n/**\n * Determines whether a value is a plain record without a custom prototype.\n *\n * @param value - Runtime value to inspect.\n * @returns Whether the value is a plain record.\n */\nfunction isPlainRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return false;\n  const prototype = Object.getPrototypeOf(value);\n  return prototype === Object.prototype || prototype === null;\n}\n\n/**\n * Determines whether a record contains only the supplied keys.\n *\n * @param value - Record whose keys should be inspected.\n * @param allowedKeys - Complete set of allowed keys.\n * @returns Whether every enumerable own key is allowed.\n */\nfunction hasOnlyKeys(\n  value: Readonly<Record<string, unknown>>,\n  allowedKeys: ReadonlySet<string>,\n): boolean {\n  return Object.keys(value).every((key) => allowedKeys.has(key));\n}\n\n/**\n * Validates one module identifier before creating a bridge.\n *\n * @param moduleId - Module identifier to validate.\n * @returns The unchanged valid identifier.\n * @throws MiaixzSdkError When the identifier violates the module grammar.\n */\nfunction parseModuleId(moduleId: string): string {\n  if (!moduleIdentifierPattern.test(moduleId)) {\n    throw createBridgeError(\"BRIDGE_MESSAGE_INVALID\", \"sdk.error.bridge.messageInvalid\");\n  }\n  return moduleId;\n}\n\n/**\n * Validates and defensively copies one same-site navigation request.\n *\n * @param request - Navigation request to validate.\n * @returns Frozen request containing a cloned state value.\n * @throws MiaixzSdkError When the request or state is invalid.\n */\nfunction parseNavigationRequest(\n  request: Readonly<MiaixzNavigationRequest>,\n): MiaixzNavigationRequest {\n  if (\n    !isPlainRecord(request) ||\n    !hasOnlyKeys(request, new Set([\"path\", \"replace\", \"state\"])) ||\n    typeof request.path !== \"string\" ||\n    !request.path.startsWith(\"/\") ||\n    request.path.startsWith(\"//\") ||\n    request.path.includes(\"\\\\\") ||\n    (request.replace !== undefined && typeof request.replace !== \"boolean\")\n  ) {\n    throw createBridgeError(\"BRIDGE_MESSAGE_INVALID\", \"sdk.error.bridge.messageInvalid\");\n  }\n\n  let state: unknown;\n  if (request.state !== undefined) {\n    try {\n      state = structuredClone(request.state);\n    } catch {\n      throw createBridgeError(\n        \"BRIDGE_NAVIGATION_STATE_INVALID\",\n        \"sdk.error.bridge.navigationStateInvalid\",\n      );\n    }\n  }\n\n  return Object.freeze({\n    path: request.path,\n    ...(request.replace === undefined ? {} : { replace: request.replace }),\n    ...(request.state === undefined ? {} : { state }),\n  });\n}\n\n/**\n * Validates and freezes one non-wildcard module permission list.\n *\n * @param permissions - Permission list to validate.\n * @returns Frozen defensive permission copy.\n * @throws MiaixzSdkError When any permission is malformed.\n */\nfunction parsePermissions(permissions: readonly string[]): readonly string[] {\n  if (!Array.isArray(permissions) || !permissions.every(isMiaixzModulePermission)) {\n    throw createBridgeError(\"BRIDGE_MESSAGE_INVALID\", \"sdk.error.bridge.messageInvalid\");\n  }\n  return Object.freeze([...permissions]);\n}\n\n/**\n * Validates one event name against the module bound to the bridge.\n *\n * @param moduleId - Module identifier owning the bridge.\n * @param type - Event type to validate.\n * @returns The unchanged valid event type.\n * @throws MiaixzSdkError When the event is outside the module namespace.\n */\nfunction parseEventType(moduleId: string, type: string): string {\n  if (typeof type !== \"string\") {\n    throw createBridgeError(\"BRIDGE_MESSAGE_INVALID\", \"sdk.error.bridge.messageInvalid\");\n  }\n  const separator = type.indexOf(\":\");\n  const owner = type.slice(0, separator);\n  const eventName = type.slice(separator + 1);\n  if (\n    separator < 0 ||\n    type.indexOf(\":\", separator + 1) >= 0 ||\n    owner !== moduleId ||\n    !moduleIdentifierPattern.test(owner) ||\n    !moduleIdentifierPattern.test(eventName)\n  ) {\n    throw createBridgeError(\"BRIDGE_MESSAGE_INVALID\", \"sdk.error.bridge.messageInvalid\");\n  }\n  return type;\n}\n\n/**\n * Implements the same-runtime Host Bridge with explicit capability injection.\n */\nclass MiaixzDirectHostBridge implements MiaixzHostBridge {\n  /**\n   * Micro-frontend protocol version implemented by the bridge.\n   */\n  readonly protocolVersion = MIAIXZ_MODULE_PROTOCOL_VERSION;\n\n  readonly #moduleId: string;\n  readonly #adapter: MiaixzHostAdapter;\n  readonly #subscriptions = new Set<() => Promise<void>>();\n  #disposed = false;\n\n  /**\n   * Creates one module-scoped Direct Bridge.\n   *\n   * @param options - Validated module identity and injected host capabilities.\n   */\n  constructor(options: Readonly<MiaixzDirectHostBridgeOptions>) {\n    this.#moduleId = parseModuleId(options.moduleId);\n    this.#adapter = options.adapter;\n  }\n\n  /**\n   * Reads the current non-sensitive host context.\n   *\n   * @returns Immutable runtime context from the host Adapter.\n   */\n  getContext(): Promise<Readonly<MiaixzRuntimeContext>> {\n    return Promise.resolve().then(() => {\n      this.#assertActive();\n      return this.#requireCapability(\"getContext\")();\n    });\n  }\n\n  /**\n   * Sends a validated same-site navigation request to the host.\n   *\n   * @param request - Navigation request to validate and clone.\n   * @returns Promise settled after the host handles navigation.\n   */\n  navigate(request: Readonly<MiaixzNavigationRequest>): Promise<void> {\n    return Promise.resolve().then(() => {\n      this.#assertActive();\n      const parsed = parseNavigationRequest(request);\n      return this.#requireCapability(\"navigate\")(parsed);\n    });\n  }\n\n  /**\n   * Checks whether all validated permissions are available.\n   *\n   * @param permissions - Non-wildcard permissions to evaluate.\n   * @returns Whether every requested permission is available.\n   */\n  hasPermissions(permissions: readonly string[]): Promise<boolean> {\n    return Promise.resolve().then(() => {\n      this.#assertActive();\n      const parsed = parsePermissions(permissions);\n      return this.#requireCapability(\"hasPermissions\")(parsed);\n    });\n  }\n\n  /**\n   * Registers messages owned by the module bound to the bridge.\n   *\n   * @param namespace - Namespace that must equal the module identifier.\n   * @param catalog - Project message catalog to register.\n   * @returns Promise settled after the host registers the catalog.\n   */\n  registerMessages(namespace: string, catalog: MiaixzMessageCatalog): Promise<void> {\n    return Promise.resolve().then(() => {\n      this.#assertActive();\n      if (namespace !== this.#moduleId) {\n        throw createBridgeError(\"BRIDGE_MESSAGE_INVALID\", \"sdk.error.bridge.messageInvalid\");\n      }\n      return this.#requireCapability(\"registerMessages\")(namespace, catalog);\n    });\n  }\n\n  /**\n   * Emits one event owned by the module bound to the bridge.\n   *\n   * @typeParam T - Event payload type.\n   * @param type - Module-scoped event name.\n   * @param payload - Event payload delivered to the host.\n   * @returns Promise settled after event delivery.\n   */\n  emit<T = unknown>(type: string, payload: T): Promise<void> {\n    return Promise.resolve().then(() => {\n      this.#assertActive();\n      const parsedType = parseEventType(this.#moduleId, type);\n      return this.#requireCapability(\"emit\")<T>(parsedType, payload);\n    });\n  }\n\n  /**\n   * Subscribes to one event owned by the module bound to the bridge.\n   *\n   * @typeParam T - Event payload type.\n   * @param type - Module-scoped event name.\n   * @param listener - Event listener invoked by the host.\n   * @returns Idempotent asynchronous unsubscribe function.\n   */\n  subscribe<T = unknown>(\n    type: string,\n    listener: (payload: T) => void,\n  ): Promise<() => Promise<void>> {\n    return Promise.resolve().then(async () => {\n      this.#assertActive();\n      const parsedType = parseEventType(this.#moduleId, type);\n      if (typeof listener !== \"function\") {\n        throw createBridgeError(\"BRIDGE_MESSAGE_INVALID\", \"sdk.error.bridge.messageInvalid\");\n      }\n      const unsubscribe = await this.#requireCapability(\"subscribe\")<T>(parsedType, listener);\n      if (typeof unsubscribe !== \"function\") {\n        throw createBridgeError(\"BRIDGE_MESSAGE_INVALID\", \"sdk.error.bridge.messageInvalid\");\n      }\n\n      let cancelled = false;\n      const cancel = async (): Promise<void> => {\n        if (cancelled) return;\n        cancelled = true;\n        this.#subscriptions.delete(cancel);\n        await Promise.resolve().then(unsubscribe);\n      };\n\n      if (this.#disposed) {\n        try {\n          await cancel();\n        } catch {\n          // Cleanup failures cannot replace the deterministic disposed result.\n        }\n        throw createBridgeError(\"BRIDGE_DISPOSED\", \"sdk.error.bridge.disposed\");\n      }\n      this.#subscriptions.add(cancel);\n      return cancel;\n    });\n  }\n\n  /**\n   * Releases tracked subscriptions and prevents further Adapter calls.\n   */\n  dispose(): void {\n    if (this.#disposed) return;\n    this.#disposed = true;\n    const subscriptions = [...this.#subscriptions];\n    this.#subscriptions.clear();\n    for (const unsubscribe of subscriptions) {\n      void unsubscribe().catch(() => undefined);\n    }\n  }\n\n  /**\n   * Rejects calls made after the bridge has been released.\n   *\n   * @throws MiaixzSdkError When the bridge has already been disposed.\n   */\n  #assertActive(): void {\n    if (this.#disposed) {\n      throw createBridgeError(\"BRIDGE_DISPOSED\", \"sdk.error.bridge.disposed\");\n    }\n  }\n\n  /**\n   * Returns one injected Adapter capability.\n   *\n   * @typeParam Name - Adapter capability name.\n   * @param name - Capability to resolve.\n   * @returns Injected Adapter capability.\n   * @throws MiaixzSdkError When the host omitted the requested capability.\n   */\n  #requireCapability<Name extends keyof MiaixzHostAdapter>(\n    name: Name,\n  ): NonNullable<MiaixzHostAdapter[Name]> {\n    const capability = this.#adapter[name];\n    if (capability === undefined) {\n      throw createBridgeError(\n        \"BRIDGE_CAPABILITY_UNAVAILABLE\",\n        \"sdk.error.bridge.capabilityUnavailable\",\n      );\n    }\n    return capability as NonNullable<MiaixzHostAdapter[Name]>;\n  }\n}\n\n/**\n * Creates a module-scoped same-runtime Host Bridge.\n *\n * @param options - Module identity and explicitly injected host capabilities.\n * @returns Host Bridge that delegates validated calls to the Adapter.\n * @throws MiaixzSdkError When the module identifier is invalid.\n * @public\n */\nexport function createMiaixzDirectHostBridge(\n  options: Readonly<MiaixzDirectHostBridgeOptions>,\n): MiaixzHostBridge {\n  return new MiaixzDirectHostBridge(options);\n}\n"]}

package/dist/runtime/index.d.ts

@@ -0,0 +1,5 @@
+export type { MiaixzDirectHostBridgeOptions, MiaixzHostAdapter, MiaixzHostBridge, MiaixzNavigationRequest, } from "../contracts/index.js";
+export { createMiaixzDirectHostBridge } from "./direct-host-bridge.js";
+export { createMiaixzPostMessageChildBridge, createMiaixzPostMessageHost, } from "./post-message-bridge.js";
+export type { MiaixzBridgeEnvelope, MiaixzPostMessageChildOptions, MiaixzPostMessageHost, MiaixzPostMessageHostOptions, } from "../contracts/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,6BAA6B,EAC7B,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EACL,kCAAkC,EAClC,2BAA2B,GAC5B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,oBAAoB,EACpB,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,3 @@
+export { createMiaixzDirectHostBridge } from "./direct-host-bridge.js";
+export { createMiaixzPostMessageChildBridge, createMiaixzPostMessageHost, } from "./post-message-bridge.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EACL,kCAAkC,EAClC,2BAA2B,GAC5B,MAAM,0BAA0B,CAAC","sourcesContent":["export type {\n  MiaixzDirectHostBridgeOptions,\n  MiaixzHostAdapter,\n  MiaixzHostBridge,\n  MiaixzNavigationRequest,\n} from \"../contracts/index.js\";\nexport { createMiaixzDirectHostBridge } from \"./direct-host-bridge.js\";\nexport {\n  createMiaixzPostMessageChildBridge,\n  createMiaixzPostMessageHost,\n} from \"./post-message-bridge.js\";\nexport type {\n  MiaixzBridgeEnvelope,\n  MiaixzPostMessageChildOptions,\n  MiaixzPostMessageHost,\n  MiaixzPostMessageHostOptions,\n} from \"../contracts/index.js\";\n"]}

package/dist/runtime/post-message-bridge.d.ts

@@ -0,0 +1,20 @@
+import { type MiaixzHostBridge, type MiaixzPostMessageChildOptions, type MiaixzPostMessageHost, type MiaixzPostMessageHostOptions } from "../contracts/index.js";
+/**
+ * Creates the Host side of a validated iframe postMessage Bridge.
+ *
+ * @param options - Manifest, target, origin, Adapter, and timeout configuration.
+ * @returns Host lifecycle whose ready Promise tracks the handshake.
+ * @throws MiaixzSdkError When construction parameters or browser capabilities are invalid.
+ * @public
+ */
+export declare function createMiaixzPostMessageHost(options: MiaixzPostMessageHostOptions): MiaixzPostMessageHost;
+/**
+ * Creates and handshakes the Child side of an iframe postMessage Bridge.
+ *
+ * @param options - Module identity, target, origin, and timeout configuration.
+ * @returns Promise resolving to the connected Host Bridge.
+ * @throws MiaixzSdkError When construction, handshake, or browser capabilities are invalid.
+ * @public
+ */
+export declare function createMiaixzPostMessageChildBridge(options: MiaixzPostMessageChildOptions): Promise<MiaixzHostBridge>;
+//# sourceMappingURL=post-message-bridge.d.ts.map

package/dist/runtime/post-message-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-message-bridge.d.ts","sourceRoot":"","sources":["../../src/runtime/post-message-bridge.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,gBAAgB,EAGrB,KAAK,6BAA6B,EAClC,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EAClC,MAAM,uBAAuB,CAAC;AA2vC/B;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,qBAAqB,CAEvB;AAED;;;;;;;GAOG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,gBAAgB,CAAC,CAM3B"}