@miaixz/sdk 0.5.0

package/dist/context/context.d.ts

@@ -0,0 +1,123 @@
+import type { MiaixzEventBus, MiaixzSdkEventMap } from "../events/index.js";
+import { type MiaixzTranslator } from "../i18n/index.js";
+import { type MiaixzKeyValueStorage, type MiaixzStorageMigration } from "../storage/index.js";
+import type { MiaixzRuntimeContext } from "../types/index.js";
+/**
+ * Configures a Miaixz runtime-context store.
+ *
+ * @public
+ */
+export interface MiaixzContextStoreOptions {
+    /**
+     * Identifies the consuming frontend application and its physical storage namespace.
+     */
+    readonly appId: string;
+    /**
+     * Optional context merged over persisted state.
+     */
+    readonly initialContext?: MiaixzRuntimeContext;
+    /**
+     * Optional key-value storage used for persistence.
+     */
+    readonly storage?: MiaixzKeyValueStorage;
+    /**
+     * Indicates whether context should be persisted.
+     *
+     * @defaultValue true
+     */
+    readonly persist?: boolean;
+    /**
+     * Supplies optional sequential migrations for older Context schemas.
+     */
+    readonly migrations?: readonly MiaixzStorageMigration[];
+    /**
+     * Optional event bus used to synchronize service instances.
+     */
+    readonly events?: MiaixzEventBus<MiaixzSdkEventMap>;
+    /**
+     * Optional translator used for context errors.
+     */
+    readonly translate?: MiaixzTranslator;
+}
+/**
+ * Determines whether a value is a valid runtime context.
+ *
+ * @param value - Value to inspect.
+ * @returns Whether `value` is a valid string-valued runtime context.
+ * @public
+ */
+export declare function isMiaixzRuntimeContext(value: unknown): value is MiaixzRuntimeContext;
+/**
+ * Converts tenant, organization, space, locale, and trace context into request headers.
+ *
+ * @param context - Runtime context to convert.
+ * @returns Headers containing all defined runtime-context values.
+ * @public
+ */
+export declare function miaixzContextToHeaders(context: Readonly<MiaixzRuntimeContext>): Headers;
+/**
+ * Stores request context independently of URL route parameters.
+ *
+ * @public
+ */
+export declare class MiaixzContextStore {
+    #private;
+    /**
+     * Creates a runtime-context store.
+     *
+     * @param options - Initial state plus persistence, events, and translation adapters.
+     * @throws MiaixzSdkError When app, migration, or explicit Context configuration is invalid.
+     */
+    constructor(options: MiaixzContextStoreOptions);
+    /**
+     * Returns the active request context.
+     *
+     * @returns An immutable copy of the current request context.
+     */
+    getSnapshot(): Readonly<MiaixzRuntimeContext>;
+    /**
+     * Replaces, persists, and broadcasts the full runtime context.
+     *
+     * @param context - Complete runtime context to activate.
+     * @throws MiaixzSdkError When the supplied Context contains an invalid value.
+     */
+    set(context: MiaixzRuntimeContext): void;
+    /**
+     * Merges a partial update into the current runtime context.
+     *
+     * @param context - Partial context values to merge.
+     * @throws MiaixzSdkError When the merged Context contains an invalid value.
+     */
+    patch(context: Partial<MiaixzRuntimeContext>): void;
+    /**
+     * Clears all runtime context values.
+     */
+    clear(): void;
+    /**
+     * Registers a context listener and returns its unsubscribe function.
+     *
+     * @param listener - Callback invoked with each context snapshot.
+     * @returns Function that unregisters the listener.
+     */
+    subscribe(listener: (context: Readonly<MiaixzRuntimeContext>) => void): () => void;
+    /**
+     * Request-client provider that returns headers for the latest context.
+     *
+     * @returns Headers for the active runtime context.
+     */
+    readonly headersProvider: () => Headers;
+    /**
+     * Releases event subscriptions and local listeners.
+     */
+    destroy(): void;
+}
+/**
+ * Creates a context store with optional browser persistence.
+ *
+ * @param options - Application identity, optional initial state, and runtime adapters.
+ * @returns Configured runtime-context store.
+ * @throws MiaixzSdkError When app, migration, or explicit Context configuration is invalid.
+ * @public
+ */
+export declare function createMiaixzContextStore(options: MiaixzContextStoreOptions): MiaixzContextStore;
+//# sourceMappingURL=context.d.ts.map

package/dist/context/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAIL,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAG9D;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,oBAAoB,CAAC;IAE/C;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAEzC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAExD;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAEpD;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAID;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAGpF;AA0CD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAiBvF;AAmBD;;;;GAIG;AACH,qBAAa,kBAAkB;;IAW7B;;;;;OAKG;IACH,YAAY,OAAO,EAAE,yBAAyB,EAmC7C;IAED;;;;OAIG;IACH,WAAW,IAAI,QAAQ,CAAC,oBAAoB,CAAC,CAE5C;IAED;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAEvC;IAgBD;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAElD;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAEZ;IAED;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAGjF;IAED;;;;OAIG;IACH,QAAQ,CAAC,eAAe,QAAO,OAAO,CAA0C;IAEhF;;OAEG;IACH,OAAO,IAAI,IAAI,CAGd;CAyBF;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CAE/F"}

package/dist/context/context.js

@@ -0,0 +1,252 @@
+import { miaixzHeaders } from "../consts/index.js";
+import { MiaixzSdkError } from "../api/errors.js";
+import { miaixzDefaultI18n } from "../i18n/index.js";
+import { getMiaixzBrowserStorage, readMiaixzVersionedValue, writeMiaixzVersionedValue, } from "../storage/index.js";
+import { isRecord } from "../utils/object.js";
+const miaixzContextSchemaVersion = 1;
+/**
+ * Determines whether a value is a valid runtime context.
+ *
+ * @param value - Value to inspect.
+ * @returns Whether `value` is a valid string-valued runtime context.
+ * @public
+ */
+export function isMiaixzRuntimeContext(value) {
+    if (!isRecord(value))
+        return false;
+    return Object.values(value).every((entry) => entry === undefined || typeof entry === "string");
+}
+/**
+ * Parses and canonicalizes a runtime context by removing undefined fields.
+ *
+ * @param value - Runtime value to validate and normalize.
+ * @param translate - Translator used for explicit invalid Context errors.
+ * @returns A canonical runtime context containing only defined string values.
+ * @throws MiaixzSdkError When the value is not a valid runtime context.
+ */
+function parseRuntimeContext(value, translate) {
+    if (!isMiaixzRuntimeContext(value)) {
+        throw new MiaixzSdkError(translate("sdk.error.context.invalid"), {
+            code: "CONTEXT_INVALID",
+        });
+    }
+    return Object.fromEntries(Object.entries(value).filter((entry) => entry[1] !== undefined));
+}
+/**
+ * Applies explicit Context fields over persisted state, treating undefined as deletion.
+ *
+ * @param persisted - Canonical persisted Context state.
+ * @param initial - Valid explicit Context fields supplied by the host.
+ * @param translate - Translator used to normalize the merged state.
+ * @returns Canonical merged Context state.
+ */
+function mergeInitialContext(persisted, initial, translate) {
+    const merged = { ...persisted };
+    for (const [key, value] of Object.entries(initial)) {
+        if (value === undefined)
+            delete merged[key];
+        else
+            merged[key] = value;
+    }
+    return parseRuntimeContext(merged, translate);
+}
+/**
+ * Converts tenant, organization, space, locale, and trace context into request headers.
+ *
+ * @param context - Runtime context to convert.
+ * @returns Headers containing all defined runtime-context values.
+ * @public
+ */
+export function miaixzContextToHeaders(context) {
+    const headers = new Headers();
+    const mapping = [
+        ["userId", miaixzHeaders.userId],
+        ["tenantId", miaixzHeaders.tenantId],
+        ["organizationId", miaixzHeaders.organizationId],
+        ["departmentId", miaixzHeaders.departmentId],
+        ["spaceId", miaixzHeaders.spaceId],
+        ["locale", miaixzHeaders.locale],
+        ["timezone", miaixzHeaders.timezone],
+        ["traceId", miaixzHeaders.traceId],
+    ];
+    for (const [key, header] of mapping) {
+        const value = context[key];
+        if (value)
+            headers.set(header, value);
+    }
+    return headers;
+}
+/**
+ * Compares string-valued context records to suppress duplicate event delivery.
+ *
+ * @param first - First context to compare.
+ * @param second - Second context to compare.
+ * @returns Whether both contexts contain equivalent values.
+ */
+function contextsEqual(first, second) {
+    const keys = new Set([...Object.keys(first), ...Object.keys(second)]);
+    return [...keys].every((key) => first[key] === second[key]);
+}
+/**
+ * Stores request context independently of URL route parameters.
+ *
+ * @public
+ */
+export class MiaixzContextStore {
+    #storage;
+    #appId;
+    #persist;
+    #migrations;
+    #listeners = new Set();
+    #events;
+    #translate;
+    #context;
+    #stopEventListener;
+    /**
+     * Creates a runtime-context store.
+     *
+     * @param options - Initial state plus persistence, events, and translation adapters.
+     * @throws MiaixzSdkError When app, migration, or explicit Context configuration is invalid.
+     */
+    constructor(options) {
+        this.#translate = options.translate ?? miaixzDefaultI18n.t;
+        readMiaixzVersionedValue({
+            scope: { appId: options.appId },
+            kind: "context",
+            schemaVersion: miaixzContextSchemaVersion,
+            ...(options.migrations === undefined ? {} : { migrations: options.migrations }),
+            parse: (value) => parseRuntimeContext(value, this.#translate),
+        });
+        if (options.initialContext !== undefined) {
+            parseRuntimeContext(options.initialContext, this.#translate);
+        }
+        this.#storage = options.storage ?? getMiaixzBrowserStorage();
+        this.#appId = options.appId;
+        this.#persist = options.persist ?? true;
+        this.#migrations = options.migrations;
+        this.#events = options.events;
+        const persisted = this.#persist
+            ? readMiaixzVersionedValue({
+                ...(this.#storage === undefined ? {} : { storage: this.#storage }),
+                scope: { appId: this.#appId },
+                kind: "context",
+                schemaVersion: miaixzContextSchemaVersion,
+                ...(this.#migrations === undefined ? {} : { migrations: this.#migrations }),
+                parse: (value) => parseRuntimeContext(value, this.#translate),
+            })
+            : undefined;
+        this.#context =
+            options.initialContext === undefined
+                ? { ...persisted }
+                : mergeInitialContext(persisted ?? {}, options.initialContext, this.#translate);
+        if (this.#persist && options.initialContext !== undefined)
+            this.#persistSnapshot();
+        this.#stopEventListener = this.#events?.on("context:changed", (context) => {
+            if (isMiaixzRuntimeContext(context))
+                this.#set(context, false);
+        });
+    }
+    /**
+     * Returns the active request context.
+     *
+     * @returns An immutable copy of the current request context.
+     */
+    getSnapshot() {
+        return Object.freeze({ ...this.#context });
+    }
+    /**
+     * Replaces, persists, and broadcasts the full runtime context.
+     *
+     * @param context - Complete runtime context to activate.
+     * @throws MiaixzSdkError When the supplied Context contains an invalid value.
+     */
+    set(context) {
+        this.#set(context, true);
+    }
+    /**
+     * Commits validated context and optionally broadcasts it.
+     *
+     * @param context - Complete runtime context to commit.
+     * @param broadcast - Whether to publish the change through the event bus.
+     */
+    #set(context, broadcast) {
+        const normalized = parseRuntimeContext(context, this.#translate);
+        if (contextsEqual(this.#context, normalized))
+            return;
+        this.#context = normalized;
+        this.#commit();
+        if (broadcast)
+            this.#events?.emit("context:changed", this.getSnapshot());
+    }
+    /**
+     * Merges a partial update into the current runtime context.
+     *
+     * @param context - Partial context values to merge.
+     * @throws MiaixzSdkError When the merged Context contains an invalid value.
+     */
+    patch(context) {
+        this.set({ ...this.#context, ...context });
+    }
+    /**
+     * Clears all runtime context values.
+     */
+    clear() {
+        this.#set({}, true);
+    }
+    /**
+     * Registers a context listener and returns its unsubscribe function.
+     *
+     * @param listener - Callback invoked with each context snapshot.
+     * @returns Function that unregisters the listener.
+     */
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    }
+    /**
+     * Request-client provider that returns headers for the latest context.
+     *
+     * @returns Headers for the active runtime context.
+     */
+    headersProvider = () => miaixzContextToHeaders(this.#context);
+    /**
+     * Releases event subscriptions and local listeners.
+     */
+    destroy() {
+        this.#stopEventListener?.();
+        this.#listeners.clear();
+    }
+    /**
+     * Persists the current context and notifies local listeners.
+     */
+    #commit() {
+        if (this.#persist)
+            this.#persistSnapshot();
+        const snapshot = this.getSnapshot();
+        for (const listener of this.#listeners)
+            listener(snapshot);
+    }
+    /**
+     * Writes the current Context through the shared versioned storage primitive.
+     */
+    #persistSnapshot() {
+        writeMiaixzVersionedValue({
+            ...(this.#storage === undefined ? {} : { storage: this.#storage }),
+            scope: { appId: this.#appId },
+            kind: "context",
+            schemaVersion: miaixzContextSchemaVersion,
+        }, this.#context);
+    }
+}
+/**
+ * Creates a context store with optional browser persistence.
+ *
+ * @param options - Application identity, optional initial state, and runtime adapters.
+ * @returns Configured runtime-context store.
+ * @throws MiaixzSdkError When app, migration, or explicit Context configuration is invalid.
+ * @public
+ */
+export function createMiaixzContextStore(options) {
+    return new MiaixzContextStore(options);
+}
+//# sourceMappingURL=context.js.map

package/dist/context/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context/context.ts"],"names":[],"mappings":"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","sourcesContent":["import { miaixzHeaders } from \"../consts/index.js\";\nimport { MiaixzSdkError } from \"../api/errors.js\";\nimport type { MiaixzEventBus, MiaixzSdkEventMap } from \"../events/index.js\";\nimport { miaixzDefaultI18n, type MiaixzTranslator } from \"../i18n/index.js\";\nimport {\n  getMiaixzBrowserStorage,\n  readMiaixzVersionedValue,\n  writeMiaixzVersionedValue,\n  type MiaixzKeyValueStorage,\n  type MiaixzStorageMigration,\n} from \"../storage/index.js\";\nimport type { MiaixzRuntimeContext } from \"../types/index.js\";\nimport { isRecord } from \"../utils/object.js\";\n\n/**\n * Configures a Miaixz runtime-context store.\n *\n * @public\n */\nexport interface MiaixzContextStoreOptions {\n  /**\n   * Identifies the consuming frontend application and its physical storage namespace.\n   */\n  readonly appId: string;\n\n  /**\n   * Optional context merged over persisted state.\n   */\n  readonly initialContext?: MiaixzRuntimeContext;\n\n  /**\n   * Optional key-value storage used for persistence.\n   */\n  readonly storage?: MiaixzKeyValueStorage;\n\n  /**\n   * Indicates whether context should be persisted.\n   *\n   * @defaultValue true\n   */\n  readonly persist?: boolean;\n\n  /**\n   * Supplies optional sequential migrations for older Context schemas.\n   */\n  readonly migrations?: readonly MiaixzStorageMigration[];\n\n  /**\n   * Optional event bus used to synchronize service instances.\n   */\n  readonly events?: MiaixzEventBus<MiaixzSdkEventMap>;\n\n  /**\n   * Optional translator used for context errors.\n   */\n  readonly translate?: MiaixzTranslator;\n}\n\nconst miaixzContextSchemaVersion = 1;\n\n/**\n * Determines whether a value is a valid runtime context.\n *\n * @param value - Value to inspect.\n * @returns Whether `value` is a valid string-valued runtime context.\n * @public\n */\nexport function isMiaixzRuntimeContext(value: unknown): value is MiaixzRuntimeContext {\n  if (!isRecord(value)) return false;\n  return Object.values(value).every((entry) => entry === undefined || typeof entry === \"string\");\n}\n\n/**\n * Parses and canonicalizes a runtime context by removing undefined fields.\n *\n * @param value - Runtime value to validate and normalize.\n * @param translate - Translator used for explicit invalid Context errors.\n * @returns A canonical runtime context containing only defined string values.\n * @throws MiaixzSdkError When the value is not a valid runtime context.\n */\nfunction parseRuntimeContext(value: unknown, translate: MiaixzTranslator): MiaixzRuntimeContext {\n  if (!isMiaixzRuntimeContext(value)) {\n    throw new MiaixzSdkError(translate(\"sdk.error.context.invalid\"), {\n      code: \"CONTEXT_INVALID\",\n    });\n  }\n  return Object.fromEntries(\n    Object.entries(value).filter((entry): entry is [string, string] => entry[1] !== undefined),\n  ) as MiaixzRuntimeContext;\n}\n\n/**\n * Applies explicit Context fields over persisted state, treating undefined as deletion.\n *\n * @param persisted - Canonical persisted Context state.\n * @param initial - Valid explicit Context fields supplied by the host.\n * @param translate - Translator used to normalize the merged state.\n * @returns Canonical merged Context state.\n */\nfunction mergeInitialContext(\n  persisted: Readonly<MiaixzRuntimeContext>,\n  initial: Readonly<MiaixzRuntimeContext>,\n  translate: MiaixzTranslator,\n): MiaixzRuntimeContext {\n  const merged: Record<string, string | undefined> = { ...persisted };\n  for (const [key, value] of Object.entries(initial)) {\n    if (value === undefined) delete merged[key];\n    else merged[key] = value;\n  }\n  return parseRuntimeContext(merged, translate);\n}\n\n/**\n * Converts tenant, organization, space, locale, and trace context into request headers.\n *\n * @param context - Runtime context to convert.\n * @returns Headers containing all defined runtime-context values.\n * @public\n */\nexport function miaixzContextToHeaders(context: Readonly<MiaixzRuntimeContext>): Headers {\n  const headers = new Headers();\n  const mapping: readonly [keyof MiaixzRuntimeContext, string][] = [\n    [\"userId\", miaixzHeaders.userId],\n    [\"tenantId\", miaixzHeaders.tenantId],\n    [\"organizationId\", miaixzHeaders.organizationId],\n    [\"departmentId\", miaixzHeaders.departmentId],\n    [\"spaceId\", miaixzHeaders.spaceId],\n    [\"locale\", miaixzHeaders.locale],\n    [\"timezone\", miaixzHeaders.timezone],\n    [\"traceId\", miaixzHeaders.traceId],\n  ];\n  for (const [key, header] of mapping) {\n    const value = context[key];\n    if (value) headers.set(header, value);\n  }\n  return headers;\n}\n\n/**\n * Compares string-valued context records to suppress duplicate event delivery.\n *\n * @param first - First context to compare.\n * @param second - Second context to compare.\n * @returns Whether both contexts contain equivalent values.\n */\nfunction contextsEqual(\n  first: Readonly<MiaixzRuntimeContext>,\n  second: Readonly<MiaixzRuntimeContext>,\n): boolean {\n  const keys = new Set([...Object.keys(first), ...Object.keys(second)]);\n  return [...keys].every(\n    (key) => first[key as keyof MiaixzRuntimeContext] === second[key as keyof MiaixzRuntimeContext],\n  );\n}\n\n/**\n * Stores request context independently of URL route parameters.\n *\n * @public\n */\nexport class MiaixzContextStore {\n  readonly #storage: MiaixzKeyValueStorage | undefined;\n  readonly #appId: string;\n  readonly #persist: boolean;\n  readonly #migrations: readonly MiaixzStorageMigration[] | undefined;\n  readonly #listeners = new Set<(context: Readonly<MiaixzRuntimeContext>) => void>();\n  readonly #events: MiaixzEventBus<MiaixzSdkEventMap> | undefined;\n  readonly #translate: MiaixzTranslator;\n  #context: MiaixzRuntimeContext;\n  #stopEventListener: (() => void) | undefined;\n\n  /**\n   * Creates a runtime-context store.\n   *\n   * @param options - Initial state plus persistence, events, and translation adapters.\n   * @throws MiaixzSdkError When app, migration, or explicit Context configuration is invalid.\n   */\n  constructor(options: MiaixzContextStoreOptions) {\n    this.#translate = options.translate ?? miaixzDefaultI18n.t;\n    readMiaixzVersionedValue({\n      scope: { appId: options.appId },\n      kind: \"context\",\n      schemaVersion: miaixzContextSchemaVersion,\n      ...(options.migrations === undefined ? {} : { migrations: options.migrations }),\n      parse: (value) => parseRuntimeContext(value, this.#translate),\n    });\n    if (options.initialContext !== undefined) {\n      parseRuntimeContext(options.initialContext, this.#translate);\n    }\n    this.#storage = options.storage ?? getMiaixzBrowserStorage();\n    this.#appId = options.appId;\n    this.#persist = options.persist ?? true;\n    this.#migrations = options.migrations;\n    this.#events = options.events;\n    const persisted = this.#persist\n      ? readMiaixzVersionedValue({\n          ...(this.#storage === undefined ? {} : { storage: this.#storage }),\n          scope: { appId: this.#appId },\n          kind: \"context\",\n          schemaVersion: miaixzContextSchemaVersion,\n          ...(this.#migrations === undefined ? {} : { migrations: this.#migrations }),\n          parse: (value) => parseRuntimeContext(value, this.#translate),\n        })\n      : undefined;\n    this.#context =\n      options.initialContext === undefined\n        ? { ...persisted }\n        : mergeInitialContext(persisted ?? {}, options.initialContext, this.#translate);\n    if (this.#persist && options.initialContext !== undefined) this.#persistSnapshot();\n    this.#stopEventListener = this.#events?.on(\"context:changed\", (context) => {\n      if (isMiaixzRuntimeContext(context)) this.#set(context, false);\n    });\n  }\n\n  /**\n   * Returns the active request context.\n   *\n   * @returns An immutable copy of the current request context.\n   */\n  getSnapshot(): Readonly<MiaixzRuntimeContext> {\n    return Object.freeze({ ...this.#context });\n  }\n\n  /**\n   * Replaces, persists, and broadcasts the full runtime context.\n   *\n   * @param context - Complete runtime context to activate.\n   * @throws MiaixzSdkError When the supplied Context contains an invalid value.\n   */\n  set(context: MiaixzRuntimeContext): void {\n    this.#set(context, true);\n  }\n\n  /**\n   * Commits validated context and optionally broadcasts it.\n   *\n   * @param context - Complete runtime context to commit.\n   * @param broadcast - Whether to publish the change through the event bus.\n   */\n  #set(context: MiaixzRuntimeContext, broadcast: boolean): void {\n    const normalized = parseRuntimeContext(context, this.#translate);\n    if (contextsEqual(this.#context, normalized)) return;\n    this.#context = normalized;\n    this.#commit();\n    if (broadcast) this.#events?.emit(\"context:changed\", this.getSnapshot());\n  }\n\n  /**\n   * Merges a partial update into the current runtime context.\n   *\n   * @param context - Partial context values to merge.\n   * @throws MiaixzSdkError When the merged Context contains an invalid value.\n   */\n  patch(context: Partial<MiaixzRuntimeContext>): void {\n    this.set({ ...this.#context, ...context });\n  }\n\n  /**\n   * Clears all runtime context values.\n   */\n  clear(): void {\n    this.#set({}, true);\n  }\n\n  /**\n   * Registers a context listener and returns its unsubscribe function.\n   *\n   * @param listener - Callback invoked with each context snapshot.\n   * @returns Function that unregisters the listener.\n   */\n  subscribe(listener: (context: Readonly<MiaixzRuntimeContext>) => void): () => void {\n    this.#listeners.add(listener);\n    return () => this.#listeners.delete(listener);\n  }\n\n  /**\n   * Request-client provider that returns headers for the latest context.\n   *\n   * @returns Headers for the active runtime context.\n   */\n  readonly headersProvider = (): Headers => miaixzContextToHeaders(this.#context);\n\n  /**\n   * Releases event subscriptions and local listeners.\n   */\n  destroy(): void {\n    this.#stopEventListener?.();\n    this.#listeners.clear();\n  }\n\n  /**\n   * Persists the current context and notifies local listeners.\n   */\n  #commit(): void {\n    if (this.#persist) this.#persistSnapshot();\n    const snapshot = this.getSnapshot();\n    for (const listener of this.#listeners) listener(snapshot);\n  }\n\n  /**\n   * Writes the current Context through the shared versioned storage primitive.\n   */\n  #persistSnapshot(): void {\n    writeMiaixzVersionedValue(\n      {\n        ...(this.#storage === undefined ? {} : { storage: this.#storage }),\n        scope: { appId: this.#appId },\n        kind: \"context\",\n        schemaVersion: miaixzContextSchemaVersion,\n      },\n      this.#context,\n    );\n  }\n}\n\n/**\n * Creates a context store with optional browser persistence.\n *\n * @param options - Application identity, optional initial state, and runtime adapters.\n * @returns Configured runtime-context store.\n * @throws MiaixzSdkError When app, migration, or explicit Context configuration is invalid.\n * @public\n */\nexport function createMiaixzContextStore(options: MiaixzContextStoreOptions): MiaixzContextStore {\n  return new MiaixzContextStore(options);\n}\n"]}

package/dist/context/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./context.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/context/index.js

@@ -0,0 +1,2 @@
+export * from "./context.js";
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC","sourcesContent":["export * from \"./context.js\";\n"]}

package/dist/contracts/host-context.d.ts

@@ -0,0 +1,132 @@
+import type { MiaixzMessageCatalog } from "../i18n/index.js";
+import type { MiaixzRuntimeContext } from "../types/index.js";
+/**
+ * Describes a navigation request issued by a remote module through its host bridge.
+ *
+ * @public
+ */
+export interface MiaixzNavigationRequest {
+    /**
+     * Same-site absolute path requested by the module.
+     */
+    readonly path: string;
+    /**
+     * Whether the host should replace the active history entry.
+     */
+    readonly replace?: boolean;
+    /**
+     * Optional structured-clone-compatible navigation state.
+     */
+    readonly state?: unknown;
+}
+/**
+ * Defines the capabilities a host exposes to an integrated or iframe module.
+ *
+ * This task freezes the public shape only; runtime implementations are supplied by Host Bridge
+ * tasks and never expose authentication credentials.
+ *
+ * @public
+ */
+export interface MiaixzHostBridge {
+    /**
+     * Micro-frontend protocol version implemented by the bridge.
+     */
+    readonly protocolVersion: "1.0.0";
+    /**
+     * Reads the current non-sensitive host runtime context.
+     *
+     * @returns Immutable runtime context from the host.
+     */
+    getContext(): Promise<Readonly<MiaixzRuntimeContext>>;
+    /**
+     * Requests same-site navigation from the host.
+     *
+     * @param request - Validated navigation request.
+     * @returns Promise resolved after the host handles navigation.
+     */
+    navigate(request: Readonly<MiaixzNavigationRequest>): Promise<void>;
+    /**
+     * Checks whether all requested permissions are available.
+     *
+     * @param permissions - Permission names to evaluate.
+     * @returns Whether every requested permission is available.
+     */
+    hasPermissions(permissions: readonly string[]): Promise<boolean>;
+    /**
+     * Registers a module-owned internationalization catalog with the host.
+     *
+     * @param namespace - Module message namespace.
+     * @param catalog - Localized messages owned by the module.
+     * @returns Promise resolved after registration.
+     */
+    registerMessages(namespace: string, catalog: MiaixzMessageCatalog): Promise<void>;
+    /**
+     * Emits one module-scoped event through the host.
+     *
+     * @typeParam T - Event payload type.
+     * @param type - Module-scoped event name.
+     * @param payload - Structured-clone-compatible event payload.
+     * @returns Promise resolved after event delivery.
+     */
+    emit<T = unknown>(type: string, payload: T): Promise<void>;
+    /**
+     * Subscribes to one module-scoped host event.
+     *
+     * @typeParam T - Event payload type.
+     * @param type - Module-scoped event name.
+     * @param listener - Callback that receives event payloads.
+     * @returns Asynchronous unsubscribe function.
+     */
+    subscribe<T = unknown>(type: string, listener: (payload: T) => void): Promise<() => Promise<void>>;
+    /**
+     * Releases resources and pending work owned by the bridge.
+     */
+    dispose(): void;
+}
+/**
+ * Supplies the optional capabilities exposed by one Miaixz host.
+ *
+ * @public
+ */
+export interface MiaixzHostAdapter {
+    /**
+     * Reads the current non-sensitive host runtime context when available.
+     */
+    readonly getContext?: MiaixzHostBridge["getContext"];
+    /**
+     * Handles validated same-site navigation requests when available.
+     */
+    readonly navigate?: MiaixzHostBridge["navigate"];
+    /**
+     * Evaluates validated module permissions when available.
+     */
+    readonly hasPermissions?: MiaixzHostBridge["hasPermissions"];
+    /**
+     * Registers module-owned internationalization resources when available.
+     */
+    readonly registerMessages?: MiaixzHostBridge["registerMessages"];
+    /**
+     * Emits module-scoped events when available.
+     */
+    readonly emit?: MiaixzHostBridge["emit"];
+    /**
+     * Subscribes to module-scoped events when available.
+     */
+    readonly subscribe?: MiaixzHostBridge["subscribe"];
+}
+/**
+ * Configures a same-runtime bridge for one identified module.
+ *
+ * @public
+ */
+export interface MiaixzDirectHostBridgeOptions {
+    /**
+     * Identifies the module allowed to use the bridge.
+     */
+    readonly moduleId: string;
+    /**
+     * Supplies the host capabilities exposed to the module.
+     */
+    readonly adapter: MiaixzHostAdapter;
+}
+//# sourceMappingURL=host-context.d.ts.map

package/dist/contracts/host-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-context.d.ts","sourceRoot":"","sources":["../../src/contracts/host-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAElC;;;;OAIG;IACH,UAAU,IAAI,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAEtD;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE;;;;;OAKG;IACH,cAAc,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjE;;;;;;OAMG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElF;;;;;;;OAOG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;;;;;;OAOG;IACH,SAAS,CAAC,CAAC,GAAG,OAAO,EACnB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,GAC7B,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhC;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAErD;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAEjD;;OAEG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;IAE7D;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;IAEjE;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC;CACpD;AAED;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;CACrC"}

package/dist/contracts/host-context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=host-context.js.map

package/dist/contracts/host-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-context.js","sourceRoot":"","sources":["../../src/contracts/host-context.ts"],"names":[],"mappings":"","sourcesContent":["import type { MiaixzMessageCatalog } from \"../i18n/index.js\";\nimport type { MiaixzRuntimeContext } from \"../types/index.js\";\n\n/**\n * Describes a navigation request issued by a remote module through its host bridge.\n *\n * @public\n */\nexport interface MiaixzNavigationRequest {\n  /**\n   * Same-site absolute path requested by the module.\n   */\n  readonly path: string;\n\n  /**\n   * Whether the host should replace the active history entry.\n   */\n  readonly replace?: boolean;\n\n  /**\n   * Optional structured-clone-compatible navigation state.\n   */\n  readonly state?: unknown;\n}\n\n/**\n * Defines the capabilities a host exposes to an integrated or iframe module.\n *\n * This task freezes the public shape only; runtime implementations are supplied by Host Bridge\n * tasks and never expose authentication credentials.\n *\n * @public\n */\nexport interface MiaixzHostBridge {\n  /**\n   * Micro-frontend protocol version implemented by the bridge.\n   */\n  readonly protocolVersion: \"1.0.0\";\n\n  /**\n   * Reads the current non-sensitive host runtime context.\n   *\n   * @returns Immutable runtime context from the host.\n   */\n  getContext(): Promise<Readonly<MiaixzRuntimeContext>>;\n\n  /**\n   * Requests same-site navigation from the host.\n   *\n   * @param request - Validated navigation request.\n   * @returns Promise resolved after the host handles navigation.\n   */\n  navigate(request: Readonly<MiaixzNavigationRequest>): Promise<void>;\n\n  /**\n   * Checks whether all requested permissions are available.\n   *\n   * @param permissions - Permission names to evaluate.\n   * @returns Whether every requested permission is available.\n   */\n  hasPermissions(permissions: readonly string[]): Promise<boolean>;\n\n  /**\n   * Registers a module-owned internationalization catalog with the host.\n   *\n   * @param namespace - Module message namespace.\n   * @param catalog - Localized messages owned by the module.\n   * @returns Promise resolved after registration.\n   */\n  registerMessages(namespace: string, catalog: MiaixzMessageCatalog): Promise<void>;\n\n  /**\n   * Emits one module-scoped event through the host.\n   *\n   * @typeParam T - Event payload type.\n   * @param type - Module-scoped event name.\n   * @param payload - Structured-clone-compatible event payload.\n   * @returns Promise resolved after event delivery.\n   */\n  emit<T = unknown>(type: string, payload: T): Promise<void>;\n\n  /**\n   * Subscribes to one module-scoped host event.\n   *\n   * @typeParam T - Event payload type.\n   * @param type - Module-scoped event name.\n   * @param listener - Callback that receives event payloads.\n   * @returns Asynchronous unsubscribe function.\n   */\n  subscribe<T = unknown>(\n    type: string,\n    listener: (payload: T) => void,\n  ): Promise<() => Promise<void>>;\n\n  /**\n   * Releases resources and pending work owned by the bridge.\n   */\n  dispose(): void;\n}\n\n/**\n * Supplies the optional capabilities exposed by one Miaixz host.\n *\n * @public\n */\nexport interface MiaixzHostAdapter {\n  /**\n   * Reads the current non-sensitive host runtime context when available.\n   */\n  readonly getContext?: MiaixzHostBridge[\"getContext\"];\n\n  /**\n   * Handles validated same-site navigation requests when available.\n   */\n  readonly navigate?: MiaixzHostBridge[\"navigate\"];\n\n  /**\n   * Evaluates validated module permissions when available.\n   */\n  readonly hasPermissions?: MiaixzHostBridge[\"hasPermissions\"];\n\n  /**\n   * Registers module-owned internationalization resources when available.\n   */\n  readonly registerMessages?: MiaixzHostBridge[\"registerMessages\"];\n\n  /**\n   * Emits module-scoped events when available.\n   */\n  readonly emit?: MiaixzHostBridge[\"emit\"];\n\n  /**\n   * Subscribes to module-scoped events when available.\n   */\n  readonly subscribe?: MiaixzHostBridge[\"subscribe\"];\n}\n\n/**\n * Configures a same-runtime bridge for one identified module.\n *\n * @public\n */\nexport interface MiaixzDirectHostBridgeOptions {\n  /**\n   * Identifies the module allowed to use the bridge.\n   */\n  readonly moduleId: string;\n\n  /**\n   * Supplies the host capabilities exposed to the module.\n   */\n  readonly adapter: MiaixzHostAdapter;\n}\n"]}

package/dist/contracts/index.d.ts

@@ -0,0 +1,8 @@
+export type { MiaixzDirectHostBridgeOptions, MiaixzHostAdapter, MiaixzHostBridge, MiaixzNavigationRequest, } from "./host-context.js";
+export type { MiaixzIntegratedModule, MiaixzModuleHandle, MiaixzModuleMountContext, } from "./lifecycle.js";
+export { MIAIXZ_MODULE_PROTOCOL_VERSION, isMiaixzHostVersionCompatible, parseMiaixzModuleManifest, } from "./module-manifest.js";
+export type { MiaixzHostCapability, MiaixzModuleKind, MiaixzModuleManifest, MiaixzModuleManifestParseOptions, } from "./module-manifest.js";
+export type { MiaixzModuleNavigationItem } from "./navigation.js";
+export type { MiaixzBridgeEnvelope, MiaixzPostMessageChildOptions, MiaixzPostMessageHost, MiaixzPostMessageHostOptions, } from "./post-message.js";
+export type { MiaixzModuleRoute } from "./route.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,6BAA6B,EAC7B,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,8BAA8B,EAC9B,6BAA6B,EAC7B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,gCAAgC,GACjC,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAClE,YAAY,EACV,oBAAoB,EACpB,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/contracts/index.js

@@ -0,0 +1,2 @@
+export { MIAIXZ_MODULE_PROTOCOL_VERSION, isMiaixzHostVersionCompatible, parseMiaixzModuleManifest, } from "./module-manifest.js";
+//# sourceMappingURL=index.js.map

package/dist/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,8BAA8B,EAC9B,6BAA6B,EAC7B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC","sourcesContent":["export type {\n  MiaixzDirectHostBridgeOptions,\n  MiaixzHostAdapter,\n  MiaixzHostBridge,\n  MiaixzNavigationRequest,\n} from \"./host-context.js\";\nexport type {\n  MiaixzIntegratedModule,\n  MiaixzModuleHandle,\n  MiaixzModuleMountContext,\n} from \"./lifecycle.js\";\nexport {\n  MIAIXZ_MODULE_PROTOCOL_VERSION,\n  isMiaixzHostVersionCompatible,\n  parseMiaixzModuleManifest,\n} from \"./module-manifest.js\";\nexport type {\n  MiaixzHostCapability,\n  MiaixzModuleKind,\n  MiaixzModuleManifest,\n  MiaixzModuleManifestParseOptions,\n} from \"./module-manifest.js\";\nexport type { MiaixzModuleNavigationItem } from \"./navigation.js\";\nexport type {\n  MiaixzBridgeEnvelope,\n  MiaixzPostMessageChildOptions,\n  MiaixzPostMessageHost,\n  MiaixzPostMessageHostOptions,\n} from \"./post-message.js\";\nexport type { MiaixzModuleRoute } from \"./route.js\";\n"]}

package/dist/contracts/lifecycle.d.ts

@@ -0,0 +1,49 @@
+import type { MiaixzHostBridge } from "./host-context.js";
+import type { MiaixzModuleManifest } from "./module-manifest.js";
+/**
+ * Provides the host-owned resources required to mount an integrated module.
+ *
+ * @public
+ */
+export interface MiaixzModuleMountContext {
+    /**
+     * DOM container owned by the host application.
+     */
+    readonly container: HTMLElement;
+    /**
+     * Capability-limited bridge supplied by the host.
+     */
+    readonly bridge: MiaixzHostBridge;
+    /**
+     * Validated immutable manifest associated with the module.
+     */
+    readonly manifest: Readonly<MiaixzModuleManifest>;
+}
+/**
+ * Represents the resources returned by a mounted integrated module.
+ *
+ * @public
+ */
+export interface MiaixzModuleHandle {
+    /**
+     * Releases every resource created by the mounted module.
+     *
+     * @returns Nothing, or a promise resolved after asynchronous cleanup.
+     */
+    unmount(): void | Promise<void>;
+}
+/**
+ * Defines the only lifecycle entry exposed by an integrated module.
+ *
+ * @public
+ */
+export interface MiaixzIntegratedModule {
+    /**
+     * Mounts the module into its host-owned container.
+     *
+     * @param context - Validated host resources supplied to the module.
+     * @returns Handle used by the host to unmount the module.
+     */
+    mount(context: MiaixzModuleMountContext): MiaixzModuleHandle | Promise<MiaixzModuleHandle>;
+}
+//# sourceMappingURL=lifecycle.d.ts.map