@miaixz/sdk 0.5.0

package/dist/events/events.js

@@ -0,0 +1,486 @@
+import { MiaixzSdkError } from "../api/errors.js";
+import { isMiaixzAppearanceSettings } from "../appearance/index.js";
+import { isMiaixzSdkConfig } from "../config/index.js";
+import { isMiaixzRuntimeContext } from "../context/index.js";
+import { miaixzDefaultI18n } from "../i18n/index.js";
+const miaixzEventChannelPattern = /^miaixz:v1:[a-z][a-z0-9-]{1,63}:events$/;
+const miaixzUuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+const miaixzEventEnvelopeKeys = new Set(["version", "eventId", "sourceId", "type", "payload"]);
+const miaixzRuntimeContextKeys = new Set([
+    "userId",
+    "tenantId",
+    "organizationId",
+    "departmentId",
+    "spaceId",
+    "locale",
+    "timezone",
+    "traceId",
+]);
+const miaixzSdkConfigKeys = new Set([
+    "apiBaseUrl",
+    "environment",
+    "release",
+    "services",
+    "features",
+    "appearance",
+    "requestTimeoutMs",
+]);
+const miaixzSensitiveEventKeys = new Set([
+    "authorization",
+    "authorizationheader",
+    "cookie",
+    "cookies",
+    "session",
+]);
+const miaixzEventDeduplicationLimit = 1_000;
+const miaixzEventDeduplicationTtlMs = 5 * 60 * 1_000;
+/**
+ * Determines whether a property name conventionally contains credential material.
+ *
+ * @param key - Property or map key to normalize.
+ * @returns Whether the key names a token, cookie, authorization value, or full session.
+ */
+function isSensitiveEventKey(key) {
+    const normalizedKey = key.replace(/[-_]/g, "").toLowerCase();
+    return (miaixzSensitiveEventKeys.has(normalizedKey) ||
+        normalizedKey === "token" ||
+        normalizedKey.endsWith("token"));
+}
+/**
+ * Determines whether a value is a plain data object without accessors.
+ *
+ * @param value - Runtime value to inspect.
+ * @returns Whether the value contains only enumerable own data properties.
+ */
+function isPlainEventObject(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null)
+        return false;
+    if (Object.getOwnPropertySymbols(value).length > 0)
+        return false;
+    const descriptors = Object.getOwnPropertyDescriptors(value);
+    return Object.values(descriptors).every((descriptor) => descriptor.enumerable === true && "value" in descriptor);
+}
+/**
+ * Determines whether a plain object contains exactly the allowed enumerable keys.
+ *
+ * @param value - Plain object to inspect.
+ * @param allowedKeys - Complete allowed-key set.
+ * @returns Whether every key is allowed and the key counts match.
+ */
+function hasExactEventKeys(value, allowedKeys) {
+    const keys = Object.keys(value);
+    return keys.length === allowedKeys.size && keys.every((key) => allowedKeys.has(key));
+}
+/**
+ * Determines whether an event payload contains a credential-shaped field.
+ *
+ * The traversal never invokes accessors and treats unsupported object shapes as unsafe.
+ *
+ * @param value - Cloned payload to inspect.
+ * @param visited - Objects already inspected while following recursive references.
+ * @returns Whether the payload contains a token, cookie, authorization, or session field.
+ */
+function containsSensitiveEventData(value, visited = new WeakSet()) {
+    if (value === null || typeof value !== "object")
+        return false;
+    if (visited.has(value))
+        return false;
+    visited.add(value);
+    if (Array.isArray(value)) {
+        return value.some((entry) => containsSensitiveEventData(entry, visited));
+    }
+    if (value instanceof Map) {
+        for (const [key, entry] of value) {
+            if (typeof key === "string" && isSensitiveEventKey(key))
+                return true;
+            if (containsSensitiveEventData(key, visited) || containsSensitiveEventData(entry, visited)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    if (value instanceof Set) {
+        for (const entry of value) {
+            if (containsSensitiveEventData(entry, visited))
+                return true;
+        }
+        return false;
+    }
+    if (value instanceof ArrayBuffer || ArrayBuffer.isView(value) || value instanceof Date) {
+        return false;
+    }
+    for (const key of Reflect.ownKeys(value)) {
+        if (typeof key === "string" && isSensitiveEventKey(key))
+            return true;
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (descriptor === undefined || !("value" in descriptor))
+            return true;
+        if (containsSensitiveEventData(descriptor.value, visited))
+            return true;
+    }
+    return false;
+}
+/**
+ * Validates the built-in authentication status payload.
+ *
+ * @param payload - Untrusted event payload.
+ * @returns Whether the payload contains exactly one supported status field.
+ */
+function isMiaixzAuthStatusEvent(payload) {
+    return (isPlainEventObject(payload) &&
+        hasExactEventKeys(payload, new Set(["status"])) &&
+        (payload.status === "authenticated" || payload.status === "anonymous"));
+}
+/**
+ * Validates the built-in runtime-context payload.
+ *
+ * @param payload - Untrusted event payload.
+ * @returns Whether the payload contains only supported string-valued Context fields.
+ */
+function isMiaixzContextEvent(payload) {
+    return (isPlainEventObject(payload) &&
+        Object.keys(payload).every((key) => miaixzRuntimeContextKeys.has(key)) &&
+        isMiaixzRuntimeContext(payload));
+}
+/**
+ * Validates the built-in appearance payload and its nested settings.
+ *
+ * @param payload - Untrusted event payload.
+ * @returns Whether the payload uses schema version one and valid appearance settings.
+ */
+function isMiaixzAppearanceEvent(payload) {
+    return (isPlainEventObject(payload) &&
+        hasExactEventKeys(payload, new Set(["schemaVersion", "value"])) &&
+        payload.schemaVersion === 1 &&
+        isMiaixzAppearanceSettings(payload.value));
+}
+/**
+ * Validates the built-in locale-change payload.
+ *
+ * @param payload - Untrusted event payload.
+ * @returns Whether the payload contains exactly one valid BCP 47 locale.
+ */
+function isMiaixzLocaleEvent(payload) {
+    if (!isPlainEventObject(payload) ||
+        !hasExactEventKeys(payload, new Set(["locale"])) ||
+        typeof payload.locale !== "string") {
+        return false;
+    }
+    try {
+        return Intl.getCanonicalLocales(payload.locale).length === 1;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Validates the built-in SDK configuration payload.
+ *
+ * @param payload - Untrusted event payload.
+ * @returns Whether the payload contains only supported configuration fields and values.
+ */
+function isMiaixzConfigEvent(payload) {
+    return (isPlainEventObject(payload) &&
+        Object.keys(payload).every((key) => miaixzSdkConfigKeys.has(key)) &&
+        isMiaixzSdkConfig(payload));
+}
+const miaixzBuiltinEventValidators = Object.freeze({
+    "auth:changed": isMiaixzAuthStatusEvent,
+    "context:changed": isMiaixzContextEvent,
+    "appearance:changed": isMiaixzAppearanceEvent,
+    "locale:changed": isMiaixzLocaleEvent,
+    "config:changed": isMiaixzConfigEvent,
+});
+/**
+ * Creates a localized event error without including rejected payload data.
+ *
+ * @param code - Stable event error code.
+ * @param messageKey - Registered internationalization message key.
+ * @returns Localized SDK event error.
+ */
+function createMiaixzEventError(code, messageKey) {
+    return new MiaixzSdkError(miaixzDefaultI18n.t(messageKey), { code });
+}
+/**
+ * Creates a secure UUID for event sources and messages.
+ *
+ * @returns A cryptographically secure UUID.
+ * @throws MiaixzSdkError When the runtime cannot generate secure UUIDs.
+ */
+function createMiaixzEventId() {
+    if (typeof globalThis.crypto?.randomUUID !== "function") {
+        throw createMiaixzEventError("EVENT_CRYPTO_UNAVAILABLE", "sdk.error.event.cryptoUnavailable");
+    }
+    return globalThis.crypto.randomUUID();
+}
+/**
+ * Validates an untrusted BroadcastChannel envelope without executing accessors.
+ *
+ * @param value - Broadcast message data to inspect.
+ * @returns Whether the value is a complete version-one event envelope.
+ */
+function isMiaixzEventEnvelope(value) {
+    return (isPlainEventObject(value) &&
+        hasExactEventKeys(value, miaixzEventEnvelopeKeys) &&
+        value.version === 1 &&
+        typeof value.eventId === "string" &&
+        miaixzUuidPattern.test(value.eventId) &&
+        typeof value.sourceId === "string" &&
+        miaixzUuidPattern.test(value.sourceId) &&
+        typeof value.type === "string" &&
+        value.type.length > 0);
+}
+/**
+ * Produces a structured-cloned event payload before external delivery.
+ *
+ * @param payload - Payload to clone.
+ * @returns Detached payload clone safe to place in an event envelope.
+ * @throws MiaixzSdkError When structured cloning is unavailable or fails.
+ */
+function cloneMiaixzEventPayload(payload) {
+    if (typeof globalThis.structuredClone !== "function") {
+        throw createMiaixzEventError("EVENT_PAYLOAD_NOT_CLONEABLE", "sdk.error.event.payloadNotCloneable");
+    }
+    try {
+        return globalThis.structuredClone(payload);
+    }
+    catch {
+        throw createMiaixzEventError("EVENT_PAYLOAD_NOT_CLONEABLE", "sdk.error.event.payloadNotCloneable");
+    }
+}
+/**
+ * Applies a registered payload validator and the credential-exposure guard safely.
+ *
+ * @param validator - Event-specific runtime validator.
+ * @param payload - Cloned or externally received payload.
+ * @returns Whether the payload is valid and free of credential-shaped fields.
+ */
+function isValidMiaixzEventPayload(validator, payload) {
+    try {
+        return !containsSensitiveEventData(payload) && validator(payload);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Typed local and optional same-origin cross-tab event bus.
+ *
+ * @typeParam Events - Event-name map whose values define payload types.
+ * @public
+ */
+export class MiaixzEventBus {
+    #listeners = new Map();
+    #validators;
+    #channel;
+    #sourceId;
+    #receivedEventIds = new Map();
+    #messageListener;
+    #closed = false;
+    /**
+     * Creates a local-first event bus and an optional validated BroadcastChannel.
+     *
+     * @param options - Channel factory and application-defined runtime validators.
+     * @throws MiaixzSdkError When an explicit channel name or secure UUID capability is invalid.
+     */
+    constructor(options = {}) {
+        this.#validators = Object.freeze({
+            ...options.validators,
+            ...miaixzBuiltinEventValidators,
+        });
+        const channelName = options.channelName ?? false;
+        if (channelName === false) {
+            this.#channel = undefined;
+            this.#sourceId = undefined;
+            this.#messageListener = undefined;
+            return;
+        }
+        if (!miaixzEventChannelPattern.test(channelName)) {
+            throw createMiaixzEventError("EVENT_CHANNEL_INVALID", "sdk.error.event.channelInvalid");
+        }
+        const hasChannelFactory = typeof options.broadcastChannelFactory === "function";
+        const hasNativeChannel = typeof globalThis.BroadcastChannel === "function";
+        if (!hasChannelFactory && !hasNativeChannel) {
+            this.#channel = undefined;
+            this.#sourceId = undefined;
+            this.#messageListener = undefined;
+            return;
+        }
+        const sourceId = createMiaixzEventId();
+        const channel = hasChannelFactory
+            ? options.broadcastChannelFactory?.(channelName)
+            : new globalThis.BroadcastChannel(channelName);
+        if (channel === undefined) {
+            this.#channel = undefined;
+            this.#sourceId = undefined;
+            this.#messageListener = undefined;
+            return;
+        }
+        this.#channel = channel;
+        this.#sourceId = sourceId;
+        this.#messageListener = (event) => {
+            this.#receive(event.data);
+        };
+        this.#channel.addEventListener("message", this.#messageListener);
+    }
+    /**
+     * Registers a typed listener and returns its unsubscribe function.
+     *
+     * @param type - Event name to observe.
+     * @param listener - Callback invoked with the typed event payload.
+     * @returns Function that unregisters the listener, or a no-op after closure.
+     */
+    on(type, listener) {
+        if (this.#closed)
+            return () => undefined;
+        const listeners = this.#listeners.get(type) ?? new Set();
+        listeners.add(listener);
+        this.#listeners.set(type, listeners);
+        return () => {
+            listeners.delete(listener);
+            if (listeners.size === 0)
+                this.#listeners.delete(type);
+        };
+    }
+    /**
+     * Registers a typed listener that is removed after its first event.
+     *
+     * @param type - Event name to observe once.
+     * @param listener - Callback invoked with the typed event payload.
+     * @returns Function that unregisters the listener before delivery.
+     */
+    once(type, listener) {
+        if (this.#closed)
+            return () => undefined;
+        const unsubscribe = this.on(type, (payload) => {
+            unsubscribe();
+            listener(payload);
+        });
+        return unsubscribe;
+    }
+    /**
+     * Publishes an event synchronously to local listeners before optional cross-tab delivery.
+     *
+     * @param type - Event name to publish.
+     * @param payload - Typed event payload.
+     * @param options - Optional cross-tab publication behavior.
+     * @throws MiaixzSdkError When the bus is closed, a required validator is missing, cloning fails, or secure UUIDs are unavailable.
+     */
+    emit(type, payload, options = {}) {
+        if (this.#closed) {
+            throw createMiaixzEventError("EVENT_CHANNEL_INVALID", "sdk.error.event.channelInvalid");
+        }
+        this.#dispatch(type, payload);
+        if (options.broadcast === false ||
+            this.#channel === undefined ||
+            this.#sourceId === undefined) {
+            return;
+        }
+        const validator = Object.hasOwn(this.#validators, type) ? this.#validators[type] : undefined;
+        if (validator === undefined) {
+            if (options.broadcast === true) {
+                throw createMiaixzEventError("EVENT_VALIDATOR_MISSING", "sdk.error.event.validatorMissing");
+            }
+            return;
+        }
+        const clonedPayload = cloneMiaixzEventPayload(payload);
+        if (!isValidMiaixzEventPayload(validator, clonedPayload))
+            return;
+        this.#channel.postMessage({
+            version: 1,
+            eventId: createMiaixzEventId(),
+            sourceId: this.#sourceId,
+            type,
+            payload: clonedPayload,
+        });
+    }
+    /**
+     * Removes listeners for one event type or all event types.
+     *
+     * @param type - Optional event name whose listeners should be removed.
+     */
+    clear(type) {
+        if (type === undefined)
+            this.#listeners.clear();
+        else
+            this.#listeners.delete(type);
+    }
+    /**
+     * Removes listeners and deduplication state, then closes the underlying channel once.
+     */
+    close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.clear();
+        this.#receivedEventIds.clear();
+        if (this.#channel && this.#messageListener) {
+            this.#channel.removeEventListener("message", this.#messageListener);
+        }
+        this.#channel?.close();
+    }
+    /**
+     * Delivers one event to current local listeners in registration order.
+     *
+     * @param type - Event name to dispatch.
+     * @param payload - Event payload to deliver.
+     */
+    #dispatch(type, payload) {
+        for (const listener of this.#listeners.get(type) ?? [])
+            listener(payload);
+    }
+    /**
+     * Validates, deduplicates, and dispatches one untrusted channel message.
+     *
+     * @param value - Message data delivered by BroadcastChannel.
+     */
+    #receive(value) {
+        if (this.#closed || !isMiaixzEventEnvelope(value) || value.sourceId === this.#sourceId)
+            return;
+        this.#pruneReceivedEventIds(Date.now());
+        if (this.#receivedEventIds.has(value.eventId))
+            return;
+        const validator = Object.hasOwn(this.#validators, value.type)
+            ? this.#validators[value.type]
+            : undefined;
+        if (validator === undefined)
+            return;
+        if (!isValidMiaixzEventPayload(validator, value.payload))
+            return;
+        this.#receivedEventIds.set(value.eventId, Date.now());
+        while (this.#receivedEventIds.size > miaixzEventDeduplicationLimit) {
+            const oldest = this.#receivedEventIds.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.#receivedEventIds.delete(oldest);
+        }
+        this.#dispatch(value.type, value.payload);
+    }
+    /**
+     * Removes received event identifiers whose fixed five-minute TTL has elapsed.
+     *
+     * @param now - Current Unix time in milliseconds.
+     */
+    #pruneReceivedEventIds(now) {
+        for (const [eventId, receivedAt] of this.#receivedEventIds) {
+            if (now - receivedAt < miaixzEventDeduplicationTtlMs)
+                continue;
+            this.#receivedEventIds.delete(eventId);
+        }
+    }
+}
+/**
+ * Creates a typed local-first event bus with optional same-origin cross-tab delivery.
+ *
+ * @typeParam Events - Event-name map whose values define payload types.
+ * @param options - Optional channel and runtime-validator configuration.
+ * @returns Configured typed event bus.
+ * @public
+ */
+export function createMiaixzEventBus(options) {
+    return new MiaixzEventBus(options);
+}
+//# sourceMappingURL=events.js.map

package/dist/events/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/events/events.ts"],"names":[],"mappings":"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","sourcesContent":["import { MiaixzSdkError } from \"../api/errors.js\";\nimport { isMiaixzAppearanceSettings } from \"../appearance/index.js\";\nimport { isMiaixzSdkConfig } from \"../config/index.js\";\nimport { isMiaixzRuntimeContext } from \"../context/index.js\";\nimport { miaixzDefaultI18n, type MiaixzLocale } from \"../i18n/index.js\";\nimport type {\n  MiaixzAppearancePayload,\n  MiaixzRuntimeContext,\n  MiaixzSdkConfig,\n} from \"../types/index.js\";\n\n/**\n * Validates an untrusted event payload before it crosses a browser-context boundary.\n *\n * @public\n */\nexport type MiaixzEventValidator = (payload: unknown) => boolean;\n\n/**\n * Describes the only authentication state that may cross an SDK event channel.\n *\n * @public\n */\nexport interface MiaixzAuthStatusEvent {\n  /**\n   * Reports whether credentials exist without exposing a session or token.\n   */\n  readonly status: \"authenticated\" | \"anonymous\";\n}\n\n/**\n * Describes a locale change shared between same-origin application instances.\n *\n * @public\n */\nexport interface MiaixzLocaleChangedEvent {\n  /**\n   * Contains the canonical or otherwise valid BCP 47 locale to activate.\n   */\n  readonly locale: MiaixzLocale;\n}\n\n/**\n * Maps built-in SDK event names to their payload types.\n *\n * @public\n */\nexport interface MiaixzSdkEventMap {\n  /**\n   * Contains a non-sensitive authentication invalidation signal.\n   */\n  readonly \"auth:changed\": Readonly<MiaixzAuthStatusEvent>;\n\n  /**\n   * Contains the runtime-context snapshot after it changes.\n   */\n  readonly \"context:changed\": Readonly<MiaixzRuntimeContext>;\n\n  /**\n   * Contains the versioned appearance snapshot after it changes.\n   */\n  readonly \"appearance:changed\": Readonly<MiaixzAppearancePayload>;\n\n  /**\n   * Contains the active locale after it changes.\n   */\n  readonly \"locale:changed\": Readonly<MiaixzLocaleChangedEvent>;\n\n  /**\n   * Contains the SDK configuration snapshot after it changes.\n   */\n  readonly \"config:changed\": Readonly<MiaixzSdkConfig>;\n}\n\n/**\n * Configures local and optional same-origin cross-tab event delivery.\n *\n * @public\n */\nexport interface MiaixzEventBusOptions {\n  /**\n   * Selects a validated BroadcastChannel name, or disables cross-tab delivery.\n   *\n   * @defaultValue false\n   */\n  readonly channelName?: string | false;\n\n  /**\n   * Supplies runtime validators for application-defined event names.\n   */\n  readonly validators?: Readonly<Record<string, MiaixzEventValidator>>;\n\n  /**\n   * Creates a BroadcastChannel for tests or compatible custom browser runtimes.\n   */\n  readonly broadcastChannelFactory?: (name: string) => BroadcastChannel;\n}\n\n/**\n * Defines the only envelope accepted over a Miaixz BroadcastChannel.\n *\n * @public\n */\nexport interface MiaixzEventEnvelope {\n  /**\n   * Identifies the frozen event-envelope schema.\n   */\n  readonly version: 1;\n\n  /**\n   * Uniquely identifies one broadcast operation for deduplication.\n   */\n  readonly eventId: string;\n\n  /**\n   * Identifies the event-bus instance that originated the message.\n   */\n  readonly sourceId: string;\n\n  /**\n   * Names the typed event represented by the payload.\n   */\n  readonly type: string;\n\n  /**\n   * Contains untrusted data that must pass the registered runtime validator.\n   */\n  readonly payload: unknown;\n}\n\n/**\n * Configures one event publication.\n *\n * @public\n */\nexport interface MiaixzEventEmitOptions {\n  /**\n   * Indicates whether a locally dispatched event may also cross the configured channel.\n   *\n   * @defaultValue true\n   */\n  readonly broadcast?: boolean;\n}\n\n/**\n * Extracts string event names from an event map.\n *\n * @public\n */\nexport type MiaixzEventName<Events extends object> = Extract<keyof Events, string>;\n\n/**\n * Receives a typed event payload.\n *\n * @public\n */\nexport type MiaixzEventListener<T> = (payload: T) => void;\n\nconst miaixzEventChannelPattern = /^miaixz:v1:[a-z][a-z0-9-]{1,63}:events$/;\nconst miaixzUuidPattern =\n  /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\nconst miaixzEventEnvelopeKeys = new Set([\"version\", \"eventId\", \"sourceId\", \"type\", \"payload\"]);\nconst miaixzRuntimeContextKeys = new Set([\n  \"userId\",\n  \"tenantId\",\n  \"organizationId\",\n  \"departmentId\",\n  \"spaceId\",\n  \"locale\",\n  \"timezone\",\n  \"traceId\",\n]);\nconst miaixzSdkConfigKeys = new Set([\n  \"apiBaseUrl\",\n  \"environment\",\n  \"release\",\n  \"services\",\n  \"features\",\n  \"appearance\",\n  \"requestTimeoutMs\",\n]);\nconst miaixzSensitiveEventKeys = new Set([\n  \"authorization\",\n  \"authorizationheader\",\n  \"cookie\",\n  \"cookies\",\n  \"session\",\n]);\nconst miaixzEventDeduplicationLimit = 1_000;\nconst miaixzEventDeduplicationTtlMs = 5 * 60 * 1_000;\n\n/**\n * Determines whether a property name conventionally contains credential material.\n *\n * @param key - Property or map key to normalize.\n * @returns Whether the key names a token, cookie, authorization value, or full session.\n */\nfunction isSensitiveEventKey(key: string): boolean {\n  const normalizedKey = key.replace(/[-_]/g, \"\").toLowerCase();\n  return (\n    miaixzSensitiveEventKeys.has(normalizedKey) ||\n    normalizedKey === \"token\" ||\n    normalizedKey.endsWith(\"token\")\n  );\n}\n\n/**\n * Determines whether a value is a plain data object without accessors.\n *\n * @param value - Runtime value to inspect.\n * @returns Whether the value contains only enumerable own data properties.\n */\nfunction isPlainEventObject(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return false;\n  const prototype = Object.getPrototypeOf(value);\n  if (prototype !== Object.prototype && prototype !== null) return false;\n  if (Object.getOwnPropertySymbols(value).length > 0) return false;\n  const descriptors = Object.getOwnPropertyDescriptors(value);\n  return Object.values(descriptors).every(\n    (descriptor) => descriptor.enumerable === true && \"value\" in descriptor,\n  );\n}\n\n/**\n * Determines whether a plain object contains exactly the allowed enumerable keys.\n *\n * @param value - Plain object to inspect.\n * @param allowedKeys - Complete allowed-key set.\n * @returns Whether every key is allowed and the key counts match.\n */\nfunction hasExactEventKeys(\n  value: Record<string, unknown>,\n  allowedKeys: ReadonlySet<string>,\n): boolean {\n  const keys = Object.keys(value);\n  return keys.length === allowedKeys.size && keys.every((key) => allowedKeys.has(key));\n}\n\n/**\n * Determines whether an event payload contains a credential-shaped field.\n *\n * The traversal never invokes accessors and treats unsupported object shapes as unsafe.\n *\n * @param value - Cloned payload to inspect.\n * @param visited - Objects already inspected while following recursive references.\n * @returns Whether the payload contains a token, cookie, authorization, or session field.\n */\nfunction containsSensitiveEventData(value: unknown, visited = new WeakSet<object>()): boolean {\n  if (value === null || typeof value !== \"object\") return false;\n  if (visited.has(value)) return false;\n  visited.add(value);\n  if (Array.isArray(value)) {\n    return value.some((entry) => containsSensitiveEventData(entry, visited));\n  }\n  if (value instanceof Map) {\n    for (const [key, entry] of value) {\n      if (typeof key === \"string\" && isSensitiveEventKey(key)) return true;\n      if (containsSensitiveEventData(key, visited) || containsSensitiveEventData(entry, visited)) {\n        return true;\n      }\n    }\n    return false;\n  }\n  if (value instanceof Set) {\n    for (const entry of value) {\n      if (containsSensitiveEventData(entry, visited)) return true;\n    }\n    return false;\n  }\n  if (value instanceof ArrayBuffer || ArrayBuffer.isView(value) || value instanceof Date) {\n    return false;\n  }\n  for (const key of Reflect.ownKeys(value)) {\n    if (typeof key === \"string\" && isSensitiveEventKey(key)) return true;\n    const descriptor = Object.getOwnPropertyDescriptor(value, key);\n    if (descriptor === undefined || !(\"value\" in descriptor)) return true;\n    if (containsSensitiveEventData(descriptor.value, visited)) return true;\n  }\n  return false;\n}\n\n/**\n * Validates the built-in authentication status payload.\n *\n * @param payload - Untrusted event payload.\n * @returns Whether the payload contains exactly one supported status field.\n */\nfunction isMiaixzAuthStatusEvent(payload: unknown): payload is MiaixzAuthStatusEvent {\n  return (\n    isPlainEventObject(payload) &&\n    hasExactEventKeys(payload, new Set([\"status\"])) &&\n    (payload.status === \"authenticated\" || payload.status === \"anonymous\")\n  );\n}\n\n/**\n * Validates the built-in runtime-context payload.\n *\n * @param payload - Untrusted event payload.\n * @returns Whether the payload contains only supported string-valued Context fields.\n */\nfunction isMiaixzContextEvent(payload: unknown): payload is MiaixzRuntimeContext {\n  return (\n    isPlainEventObject(payload) &&\n    Object.keys(payload).every((key) => miaixzRuntimeContextKeys.has(key)) &&\n    isMiaixzRuntimeContext(payload)\n  );\n}\n\n/**\n * Validates the built-in appearance payload and its nested settings.\n *\n * @param payload - Untrusted event payload.\n * @returns Whether the payload uses schema version one and valid appearance settings.\n */\nfunction isMiaixzAppearanceEvent(payload: unknown): payload is MiaixzAppearancePayload {\n  return (\n    isPlainEventObject(payload) &&\n    hasExactEventKeys(payload, new Set([\"schemaVersion\", \"value\"])) &&\n    payload.schemaVersion === 1 &&\n    isMiaixzAppearanceSettings(payload.value)\n  );\n}\n\n/**\n * Validates the built-in locale-change payload.\n *\n * @param payload - Untrusted event payload.\n * @returns Whether the payload contains exactly one valid BCP 47 locale.\n */\nfunction isMiaixzLocaleEvent(payload: unknown): payload is MiaixzLocaleChangedEvent {\n  if (\n    !isPlainEventObject(payload) ||\n    !hasExactEventKeys(payload, new Set([\"locale\"])) ||\n    typeof payload.locale !== \"string\"\n  ) {\n    return false;\n  }\n  try {\n    return Intl.getCanonicalLocales(payload.locale).length === 1;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Validates the built-in SDK configuration payload.\n *\n * @param payload - Untrusted event payload.\n * @returns Whether the payload contains only supported configuration fields and values.\n */\nfunction isMiaixzConfigEvent(payload: unknown): payload is MiaixzSdkConfig {\n  return (\n    isPlainEventObject(payload) &&\n    Object.keys(payload).every((key) => miaixzSdkConfigKeys.has(key)) &&\n    isMiaixzSdkConfig(payload)\n  );\n}\n\nconst miaixzBuiltinEventValidators: Readonly<Record<string, MiaixzEventValidator>> = Object.freeze({\n  \"auth:changed\": isMiaixzAuthStatusEvent,\n  \"context:changed\": isMiaixzContextEvent,\n  \"appearance:changed\": isMiaixzAppearanceEvent,\n  \"locale:changed\": isMiaixzLocaleEvent,\n  \"config:changed\": isMiaixzConfigEvent,\n});\n\n/**\n * Creates a localized event error without including rejected payload data.\n *\n * @param code - Stable event error code.\n * @param messageKey - Registered internationalization message key.\n * @returns Localized SDK event error.\n */\nfunction createMiaixzEventError(\n  code:\n    | \"EVENT_CHANNEL_INVALID\"\n    | \"EVENT_VALIDATOR_MISSING\"\n    | \"EVENT_PAYLOAD_NOT_CLONEABLE\"\n    | \"EVENT_CRYPTO_UNAVAILABLE\",\n  messageKey:\n    | \"sdk.error.event.channelInvalid\"\n    | \"sdk.error.event.validatorMissing\"\n    | \"sdk.error.event.payloadNotCloneable\"\n    | \"sdk.error.event.cryptoUnavailable\",\n): MiaixzSdkError {\n  return new MiaixzSdkError(miaixzDefaultI18n.t(messageKey), { code });\n}\n\n/**\n * Creates a secure UUID for event sources and messages.\n *\n * @returns A cryptographically secure UUID.\n * @throws MiaixzSdkError When the runtime cannot generate secure UUIDs.\n */\nfunction createMiaixzEventId(): string {\n  if (typeof globalThis.crypto?.randomUUID !== \"function\") {\n    throw createMiaixzEventError(\"EVENT_CRYPTO_UNAVAILABLE\", \"sdk.error.event.cryptoUnavailable\");\n  }\n  return globalThis.crypto.randomUUID();\n}\n\n/**\n * Validates an untrusted BroadcastChannel envelope without executing accessors.\n *\n * @param value - Broadcast message data to inspect.\n * @returns Whether the value is a complete version-one event envelope.\n */\nfunction isMiaixzEventEnvelope(value: unknown): value is MiaixzEventEnvelope {\n  return (\n    isPlainEventObject(value) &&\n    hasExactEventKeys(value, miaixzEventEnvelopeKeys) &&\n    value.version === 1 &&\n    typeof value.eventId === \"string\" &&\n    miaixzUuidPattern.test(value.eventId) &&\n    typeof value.sourceId === \"string\" &&\n    miaixzUuidPattern.test(value.sourceId) &&\n    typeof value.type === \"string\" &&\n    value.type.length > 0\n  );\n}\n\n/**\n * Produces a structured-cloned event payload before external delivery.\n *\n * @param payload - Payload to clone.\n * @returns Detached payload clone safe to place in an event envelope.\n * @throws MiaixzSdkError When structured cloning is unavailable or fails.\n */\nfunction cloneMiaixzEventPayload(payload: unknown): unknown {\n  if (typeof globalThis.structuredClone !== \"function\") {\n    throw createMiaixzEventError(\n      \"EVENT_PAYLOAD_NOT_CLONEABLE\",\n      \"sdk.error.event.payloadNotCloneable\",\n    );\n  }\n  try {\n    return globalThis.structuredClone(payload);\n  } catch {\n    throw createMiaixzEventError(\n      \"EVENT_PAYLOAD_NOT_CLONEABLE\",\n      \"sdk.error.event.payloadNotCloneable\",\n    );\n  }\n}\n\n/**\n * Applies a registered payload validator and the credential-exposure guard safely.\n *\n * @param validator - Event-specific runtime validator.\n * @param payload - Cloned or externally received payload.\n * @returns Whether the payload is valid and free of credential-shaped fields.\n */\nfunction isValidMiaixzEventPayload(validator: MiaixzEventValidator, payload: unknown): boolean {\n  try {\n    return !containsSensitiveEventData(payload) && validator(payload);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Typed local and optional same-origin cross-tab event bus.\n *\n * @typeParam Events - Event-name map whose values define payload types.\n * @public\n */\nexport class MiaixzEventBus<Events extends object = MiaixzSdkEventMap> {\n  readonly #listeners = new Map<string, Set<MiaixzEventListener<unknown>>>();\n  readonly #validators: Readonly<Record<string, MiaixzEventValidator>>;\n  readonly #channel: BroadcastChannel | undefined;\n  readonly #sourceId: string | undefined;\n  readonly #receivedEventIds = new Map<string, number>();\n  readonly #messageListener: ((event: MessageEvent<unknown>) => void) | undefined;\n  #closed = false;\n\n  /**\n   * Creates a local-first event bus and an optional validated BroadcastChannel.\n   *\n   * @param options - Channel factory and application-defined runtime validators.\n   * @throws MiaixzSdkError When an explicit channel name or secure UUID capability is invalid.\n   */\n  constructor(options: MiaixzEventBusOptions = {}) {\n    this.#validators = Object.freeze({\n      ...options.validators,\n      ...miaixzBuiltinEventValidators,\n    });\n    const channelName = options.channelName ?? false;\n    if (channelName === false) {\n      this.#channel = undefined;\n      this.#sourceId = undefined;\n      this.#messageListener = undefined;\n      return;\n    }\n    if (!miaixzEventChannelPattern.test(channelName)) {\n      throw createMiaixzEventError(\"EVENT_CHANNEL_INVALID\", \"sdk.error.event.channelInvalid\");\n    }\n    const hasChannelFactory = typeof options.broadcastChannelFactory === \"function\";\n    const hasNativeChannel = typeof globalThis.BroadcastChannel === \"function\";\n    if (!hasChannelFactory && !hasNativeChannel) {\n      this.#channel = undefined;\n      this.#sourceId = undefined;\n      this.#messageListener = undefined;\n      return;\n    }\n    const sourceId = createMiaixzEventId();\n    const channel = hasChannelFactory\n      ? options.broadcastChannelFactory?.(channelName)\n      : new globalThis.BroadcastChannel(channelName);\n    if (channel === undefined) {\n      this.#channel = undefined;\n      this.#sourceId = undefined;\n      this.#messageListener = undefined;\n      return;\n    }\n    this.#channel = channel;\n    this.#sourceId = sourceId;\n    this.#messageListener = (event: MessageEvent<unknown>): void => {\n      this.#receive(event.data);\n    };\n    this.#channel.addEventListener(\"message\", this.#messageListener);\n  }\n\n  /**\n   * Registers a typed listener and returns its unsubscribe function.\n   *\n   * @param type - Event name to observe.\n   * @param listener - Callback invoked with the typed event payload.\n   * @returns Function that unregisters the listener, or a no-op after closure.\n   */\n  on<Name extends MiaixzEventName<Events>>(\n    type: Name,\n    listener: MiaixzEventListener<Events[Name]>,\n  ): () => void {\n    if (this.#closed) return (): void => undefined;\n    const listeners = this.#listeners.get(type) ?? new Set<MiaixzEventListener<unknown>>();\n    listeners.add(listener as MiaixzEventListener<unknown>);\n    this.#listeners.set(type, listeners);\n    return (): void => {\n      listeners.delete(listener as MiaixzEventListener<unknown>);\n      if (listeners.size === 0) this.#listeners.delete(type);\n    };\n  }\n\n  /**\n   * Registers a typed listener that is removed after its first event.\n   *\n   * @param type - Event name to observe once.\n   * @param listener - Callback invoked with the typed event payload.\n   * @returns Function that unregisters the listener before delivery.\n   */\n  once<Name extends MiaixzEventName<Events>>(\n    type: Name,\n    listener: MiaixzEventListener<Events[Name]>,\n  ): () => void {\n    if (this.#closed) return (): void => undefined;\n    const unsubscribe = this.on(type, (payload) => {\n      unsubscribe();\n      listener(payload);\n    });\n    return unsubscribe;\n  }\n\n  /**\n   * Publishes an event synchronously to local listeners before optional cross-tab delivery.\n   *\n   * @param type - Event name to publish.\n   * @param payload - Typed event payload.\n   * @param options - Optional cross-tab publication behavior.\n   * @throws MiaixzSdkError When the bus is closed, a required validator is missing, cloning fails, or secure UUIDs are unavailable.\n   */\n  emit<Name extends MiaixzEventName<Events>>(\n    type: Name,\n    payload: Events[Name],\n    options: Readonly<MiaixzEventEmitOptions> = {},\n  ): void {\n    if (this.#closed) {\n      throw createMiaixzEventError(\"EVENT_CHANNEL_INVALID\", \"sdk.error.event.channelInvalid\");\n    }\n    this.#dispatch(type, payload);\n    if (\n      options.broadcast === false ||\n      this.#channel === undefined ||\n      this.#sourceId === undefined\n    ) {\n      return;\n    }\n    const validator = Object.hasOwn(this.#validators, type) ? this.#validators[type] : undefined;\n    if (validator === undefined) {\n      if (options.broadcast === true) {\n        throw createMiaixzEventError(\"EVENT_VALIDATOR_MISSING\", \"sdk.error.event.validatorMissing\");\n      }\n      return;\n    }\n    const clonedPayload = cloneMiaixzEventPayload(payload);\n    if (!isValidMiaixzEventPayload(validator, clonedPayload)) return;\n    this.#channel.postMessage({\n      version: 1,\n      eventId: createMiaixzEventId(),\n      sourceId: this.#sourceId,\n      type,\n      payload: clonedPayload,\n    } satisfies MiaixzEventEnvelope);\n  }\n\n  /**\n   * Removes listeners for one event type or all event types.\n   *\n   * @param type - Optional event name whose listeners should be removed.\n   */\n  clear(type?: MiaixzEventName<Events>): void {\n    if (type === undefined) this.#listeners.clear();\n    else this.#listeners.delete(type);\n  }\n\n  /**\n   * Removes listeners and deduplication state, then closes the underlying channel once.\n   */\n  close(): void {\n    if (this.#closed) return;\n    this.#closed = true;\n    this.clear();\n    this.#receivedEventIds.clear();\n    if (this.#channel && this.#messageListener) {\n      this.#channel.removeEventListener(\"message\", this.#messageListener);\n    }\n    this.#channel?.close();\n  }\n\n  /**\n   * Delivers one event to current local listeners in registration order.\n   *\n   * @param type - Event name to dispatch.\n   * @param payload - Event payload to deliver.\n   */\n  #dispatch(type: string, payload: unknown): void {\n    for (const listener of this.#listeners.get(type) ?? []) listener(payload);\n  }\n\n  /**\n   * Validates, deduplicates, and dispatches one untrusted channel message.\n   *\n   * @param value - Message data delivered by BroadcastChannel.\n   */\n  #receive(value: unknown): void {\n    if (this.#closed || !isMiaixzEventEnvelope(value) || value.sourceId === this.#sourceId) return;\n    this.#pruneReceivedEventIds(Date.now());\n    if (this.#receivedEventIds.has(value.eventId)) return;\n    const validator = Object.hasOwn(this.#validators, value.type)\n      ? this.#validators[value.type]\n      : undefined;\n    if (validator === undefined) return;\n    if (!isValidMiaixzEventPayload(validator, value.payload)) return;\n    this.#receivedEventIds.set(value.eventId, Date.now());\n    while (this.#receivedEventIds.size > miaixzEventDeduplicationLimit) {\n      const oldest = this.#receivedEventIds.keys().next().value as string | undefined;\n      if (oldest === undefined) break;\n      this.#receivedEventIds.delete(oldest);\n    }\n    this.#dispatch(value.type, value.payload);\n  }\n\n  /**\n   * Removes received event identifiers whose fixed five-minute TTL has elapsed.\n   *\n   * @param now - Current Unix time in milliseconds.\n   */\n  #pruneReceivedEventIds(now: number): void {\n    for (const [eventId, receivedAt] of this.#receivedEventIds) {\n      if (now - receivedAt < miaixzEventDeduplicationTtlMs) continue;\n      this.#receivedEventIds.delete(eventId);\n    }\n  }\n}\n\n/**\n * Creates a typed local-first event bus with optional same-origin cross-tab delivery.\n *\n * @typeParam Events - Event-name map whose values define payload types.\n * @param options - Optional channel and runtime-validator configuration.\n * @returns Configured typed event bus.\n * @public\n */\nexport function createMiaixzEventBus<Events extends object = MiaixzSdkEventMap>(\n  options?: MiaixzEventBusOptions,\n): MiaixzEventBus<Events> {\n  return new MiaixzEventBus<Events>(options);\n}\n"]}

package/dist/events/index.d.ts

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

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

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

package/dist/events/index.js

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

package/dist/events/index.js.map

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