@useragent-kit/sdk 0.0.0 → 0.0.1

package/dist/bridge/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * window.host bridge factory.
+ *
+ * Creates an HostBridge object that can be assigned to window.host (or any
+ * comparable injection point). The bridge translates between the binary
+ * adapter API and the string-oriented API that guest apps consume.
+ *
+ * @example
+ * ```ts
+ * import { createWindowHostBridge } from "@polkadot-apps/host-sdk/bridge";
+ *
+ * window.host = createWindowHostBridge({ adapter, encoding });
+ * ```
+ */
+import type { CreateWindowHostBridgeOptions, HostBridge } from "./types.js";
+/**
+ * Create a HostBridge backed by the given adapter and encoding utilities.
+ *
+ * The returned object is suitable for assignment to window.host, a webview
+ * postMessage bridge, or any injection point that guest apps will call.
+ */
+export declare function createWindowHostBridge(options: CreateWindowHostBridgeOptions): HostBridge;
+/**
+ * Normalize a .dot domain name into the canonical app ID used for
+ * Statement Store namespacing (the `decryption_key` field).
+ *
+ * All hosts MUST use this function to derive the app ID so that
+ * statements published by one host are visible to all others.
+ *
+ * Rules:
+ * - Strip trailing `.dot` suffix (case-insensitive)
+ * - Lowercase
+ * - Trim whitespace
+ *
+ * Examples:
+ *   "voxchat.dot" → "voxchat"
+ *   "VoxChat.DOT" → "voxchat"
+ *   "voxchat"     → "voxchat"
+ *   "my-app.dot"  → "my-app"
+ */
+export declare function normalizeAppId(name: string): string;
+/**
+ * Reset module-scoped rate limiter state.
+ *
+ * @internal Intended for use in tests only. Not part of the public API.
+ */
+export declare function __resetRateLimiterForTesting(): void;
+export type { BridgeStatement, BridgeUnsubscribe, BridgeEncodingUtils, HostBridgeAdapter, HostStoreStatus, CreateWindowHostBridgeOptions, StatementEventPayload, HostBridge, } from "./types.js";
+export { HostError, isHostError } from "../errors.js";
+export type { HostErrorCode } from "../errors.js";
+export { BRIDGE_ERROR_CODES, BRIDGE_EVENT_NAMES, BRIDGE_EXPERIMENTAL_SURFACE, BRIDGE_STABLE_SURFACE, BRIDGE_VERSION, DEFAULT_BRIDGE_PROFILE, createBridgeMetadata, } from "./contract.js";
+export type { BridgeErrorCode, BridgeEventName, BridgeExperimentalSurfaceEntry, BridgeProfile, BridgeStableSurfaceEntry, BridgeExtensionCapabilities, BridgeCapabilities, BridgeMetadata, BridgeMetadataOptions, } from "./contract.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAGV,6BAA6B,EAC7B,UAAU,EAEX,MAAM,YAAY,CAAC;AAwFpB;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,UAAU,CA0NzF;AAID;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD;AAGD,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,6BAA6B,EAC7B,qBAAqB,EACrB,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,EACrB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,eAAe,EACf,eAAe,EACf,8BAA8B,EAC9B,aAAa,EACb,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,EAClB,cAAc,EACd,qBAAqB,GACtB,MAAM,eAAe,CAAC"}

package/dist/bridge/index.js

@@ -0,0 +1,302 @@
+/**
+ * window.host bridge factory.
+ *
+ * Creates an HostBridge object that can be assigned to window.host (or any
+ * comparable injection point). The bridge translates between the binary
+ * adapter API and the string-oriented API that guest apps consume.
+ *
+ * @example
+ * ```ts
+ * import { createWindowHostBridge } from "@polkadot-apps/host-sdk/bridge";
+ *
+ * window.host = createWindowHostBridge({ adapter, encoding });
+ * ```
+ */
+import { createBridgeMetadata } from "./contract.js";
+import { bridgeDestroyedError, rateLimitError, unsupportedCapabilityError } from "../errors.js";
+// ── Rate limiter ──────────────────────────────────────────────────────────
+//
+// Module-scoped sliding window: state persists across bridge destroy/remount
+// so a malicious product cannot reset counters by cycling the bridge.
+// The signing gate (adapter.sign()) remains the primary control.
+/** Maximum calls allowed in the sliding window. */
+const RATE_LIMIT_MAX_CALLS = 20;
+/** Duration of the sliding window in milliseconds. */
+const RATE_LIMIT_WINDOW_MS = 10000;
+/** Module-scoped timestamps for write() rate limiting. */
+const writeTimes = [];
+/** Module-scoped timestamps for resolveUsername() rate limiting. */
+const resolveUsernameTimes = [];
+// ── Internal helpers ───────────────────────────────────────────────────────
+/**
+ * Minimal event emitter backed by a Map of Sets.
+ * Listeners for the same event are deduplicated by reference.
+ */
+function createEmitter() {
+    const listeners = new Map();
+    function on(event, cb) {
+        let set = listeners.get(event);
+        if (!set) {
+            set = new Set();
+            listeners.set(event, set);
+        }
+        set.add(cb);
+    }
+    function off(event, cb) {
+        listeners.get(event)?.delete(cb);
+    }
+    function emit(event, data) {
+        const set = listeners.get(event);
+        if (!set)
+            return;
+        for (const cb of set) {
+            try {
+                cb(data);
+            }
+            catch (e) {
+                console.warn("[host-bridge] listener error:", e);
+            }
+        }
+    }
+    function clear() {
+        listeners.clear();
+    }
+    return { on, off, emit, clear };
+}
+/**
+ * Encode a Uint8Array to a base64 string using the standard alphabet.
+ * Uses TextDecoder-free approach for compatibility with all environments.
+ */
+function uint8ArrayToBase64(bytes) {
+    let binary = "";
+    for (let i = 0; i < bytes.length; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+}
+/**
+ * Decode a base64 string to a Uint8Array.
+ */
+function base64ToUint8Array(b64) {
+    const binary = atob(b64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+// ── Factory ────────────────────────────────────────────────────────────────
+/**
+ * Create a HostBridge backed by the given adapter and encoding utilities.
+ *
+ * The returned object is suitable for assignment to window.host, a webview
+ * postMessage bridge, or any injection point that guest apps will call.
+ */
+export function createWindowHostBridge(options) {
+    const { adapter, encoding } = options;
+    const storagePrefix = options.storagePrefix ?? "";
+    const bridgeMetadata = createBridgeMetadata(options.metadata, adapter.resolveUsername !== undefined);
+    // Channel registry: hex(topic) → original channel string.
+    // Allows dispatching incoming statements back to the channel name.
+    const channelRegistry = new Map();
+    const emitter = createEmitter();
+    // Rate limiter state is module-scoped (see top of file) to survive destroy/remount.
+    let destroyed = false;
+    // ── Statement dispatch ─────────────────────────────────────────────────
+    function onStatement(stmt) {
+        if (destroyed)
+            return;
+        // Resolve channel string from the registry. Try channel field first,
+        // then fall back to matching any topic against the registry.
+        // Statements published via write() typically set topics but not channel.
+        let channelString;
+        if (stmt.channel && stmt.channel.length > 0) {
+            channelString = channelRegistry.get(encoding.hexEncode(stmt.channel));
+        }
+        if (channelString === undefined) {
+            for (const topic of stmt.topics) {
+                channelString = channelRegistry.get(encoding.hexEncode(topic));
+                if (channelString !== undefined)
+                    break;
+            }
+        }
+        if (channelString === undefined)
+            return;
+        const payload = {
+            author: stmt.proofPubkey && stmt.proofPubkey.length > 0
+                ? encoding.hexEncode(stmt.proofPubkey)
+                : undefined,
+            channel: channelString,
+            data: uint8ArrayToBase64(stmt.data),
+            timestampMs: stmt.timestampMs ?? Date.now(),
+        };
+        emitter.emit("statement", payload);
+    }
+    // ── Subscription management ────────────────────────────────────────────
+    //
+    // Each channel gets its own independent adapter subscription with a single
+    // topic. Many adapters use matchAll semantics (all listed topics must be
+    // present in a statement), so passing multiple topics in one call would
+    // only match statements carrying ALL of them - which never happens for
+    // independent channels.
+    // Maps hex(topic) -> unsubscribe function for that topic's subscription.
+    const topicUnsubs = new Map();
+    function subscribeToTopic(topic, topicHex) {
+        if (destroyed)
+            return;
+        if (topicUnsubs.has(topicHex))
+            return;
+        topicUnsubs.set(topicHex, adapter.statements.subscribe([topic], onStatement));
+    }
+    // ── HostBridge implementation ──────────────────────────────────────────
+    const statements = Object.freeze({
+        async subscribe(channel) {
+            if (destroyed)
+                return false;
+            const topic = encoding.stringToTopic(channel);
+            const topicHex = encoding.hexEncode(topic);
+            // Idempotent: skip if this channel is already registered.
+            if (channelRegistry.has(topicHex))
+                return true;
+            channelRegistry.set(topicHex, channel);
+            // Each channel gets its own independent subscription.
+            subscribeToTopic(topic, topicHex);
+            return true;
+        },
+        async write(channel, data) {
+            if (destroyed)
+                throw bridgeDestroyedError();
+            // Sliding window rate limit check.
+            const now = Date.now();
+            // Evict timestamps outside the window.
+            while (writeTimes.length > 0 && now - writeTimes[0] > RATE_LIMIT_WINDOW_MS) {
+                writeTimes.shift();
+            }
+            if (writeTimes.length >= RATE_LIMIT_MAX_CALLS) {
+                throw rateLimitError("writes", RATE_LIMIT_MAX_CALLS, RATE_LIMIT_WINDOW_MS);
+            }
+            writeTimes.push(now);
+            const nowMs = Date.now();
+            const nowSecs = Math.floor(nowMs / 1000);
+            const dataBytes = base64ToUint8Array(data);
+            const channelTopic = encoding.stringToTopic(channel);
+            // Channel hash goes into topics[0] for subscription matching.
+            // The SCALE channel field (tag 3) is left empty because the node's
+            // subscription API filters on topics, not channel.
+            const signingPayload = encoding.buildSigningPayload(nowSecs, null, null, 0, channelTopic, dataBytes);
+            // sign() rejects if signing is unavailable - propagate directly.
+            const { publicKey, signature } = await adapter.sign(signingPayload);
+            const assembledBytes = encoding.assembleStatement(signingPayload, publicKey, signature);
+            await adapter.statements.submit(assembledBytes);
+            return true;
+        },
+        async status() {
+            return adapter.statements.status();
+        },
+    });
+    const storage = Object.freeze({
+        async get(key) {
+            return adapter.storage.get(storagePrefix + key);
+        },
+        async set(key, value) {
+            await adapter.storage.set(storagePrefix + key, value);
+            return true;
+        },
+        async remove(key) {
+            await adapter.storage.remove(storagePrefix + key);
+            return true;
+        },
+    });
+    const identity = Object.freeze({
+        async resolveUsername(username) {
+            if (destroyed)
+                throw bridgeDestroyedError();
+            if (!adapter.resolveUsername) {
+                throw unsupportedCapabilityError("resolveUsername");
+            }
+            // Sliding window rate limit check.
+            const now = Date.now();
+            while (resolveUsernameTimes.length > 0 &&
+                now - resolveUsernameTimes[0] > RATE_LIMIT_WINDOW_MS) {
+                resolveUsernameTimes.shift();
+            }
+            if (resolveUsernameTimes.length >= RATE_LIMIT_MAX_CALLS) {
+                throw rateLimitError("identity lookups", RATE_LIMIT_MAX_CALLS, RATE_LIMIT_WINDOW_MS);
+            }
+            resolveUsernameTimes.push(now);
+            // Normalize to ASCII lowercase before forwarding to adapter,
+            // ensuring consistent storage key derivation regardless of adapter implementation.
+            const normalized = username.replace(/[A-Z]/g, (c) => String.fromCharCode(c.charCodeAt(0) | 0x20));
+            return adapter.resolveUsername(normalized);
+        },
+    });
+    const bridge = {
+        __bridge: bridgeMetadata,
+        statements,
+        storage,
+        identity,
+        async getAddress() {
+            return adapter.getAddress();
+        },
+        on(event, callback) {
+            emitter.on(event, callback);
+        },
+        off(event, callback) {
+            emitter.off(event, callback);
+        },
+        destroy() {
+            if (destroyed)
+                return;
+            destroyed = true;
+            // Clear emitter first to prevent late callbacks from reaching listeners.
+            emitter.clear();
+            channelRegistry.clear();
+            // NOTE: writeTimes and resolveUsernameTimes are intentionally NOT cleared here.
+            // They are module-scoped so that rate limit counters survive destroy/remount
+            // cycles, preventing a malicious product from bypassing limits by cycling bridges.
+            // Unsubscribe each independent topic subscription.
+            for (const unsub of topicUnsubs.values()) {
+                unsub();
+            }
+            topicUnsubs.clear();
+        },
+    };
+    return bridge;
+}
+// ── App ID normalization ──────────────────────────────────────────────────
+/**
+ * Normalize a .dot domain name into the canonical app ID used for
+ * Statement Store namespacing (the `decryption_key` field).
+ *
+ * All hosts MUST use this function to derive the app ID so that
+ * statements published by one host are visible to all others.
+ *
+ * Rules:
+ * - Strip trailing `.dot` suffix (case-insensitive)
+ * - Lowercase
+ * - Trim whitespace
+ *
+ * Examples:
+ *   "voxchat.dot" → "voxchat"
+ *   "VoxChat.DOT" → "voxchat"
+ *   "voxchat"     → "voxchat"
+ *   "my-app.dot"  → "my-app"
+ */
+export function normalizeAppId(name) {
+    return name
+        .trim()
+        .toLowerCase()
+        .replace(/\.dot$/i, "");
+}
+/**
+ * Reset module-scoped rate limiter state.
+ *
+ * @internal Intended for use in tests only. Not part of the public API.
+ */
+export function __resetRateLimiterForTesting() {
+    writeTimes.length = 0;
+    resolveUsernameTimes.length = 0;
+}
+export { HostError, isHostError } from "../errors.js";
+export { BRIDGE_ERROR_CODES, BRIDGE_EVENT_NAMES, BRIDGE_EXPERIMENTAL_SURFACE, BRIDGE_STABLE_SURFACE, BRIDGE_VERSION, DEFAULT_BRIDGE_PROFILE, createBridgeMetadata, } from "./contract.js";
+//# sourceMappingURL=index.js.map

package/dist/bridge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"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"}

package/dist/bridge/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Types for the window.host bridge adapter pattern.
+ *
+ * The bridge sits between a host runtime (which implements HostBridgeAdapter)
+ * and a guest web app (which uses HostBridge). It translates between the
+ * low-level binary adapter API and the string-oriented API that apps expect.
+ */
+import type { HostStoreStatus } from "../types.js";
+import type { BridgeMetadata, BridgeMetadataOptions } from "./contract.js";
+/** A decoded statement as delivered by the adapter's subscribe callback. */
+export interface BridgeStatement {
+    proofPubkey: Uint8Array | undefined;
+    channel: Uint8Array | undefined;
+    topics: Uint8Array[];
+    data: Uint8Array;
+    priority: number;
+    timestampMs?: number;
+}
+/** Cancels an adapter subscription when called. */
+export type BridgeUnsubscribe = () => void;
+/** The host runtime must implement this interface to back a HostBridge. */
+export interface HostBridgeAdapter {
+    statements: {
+        subscribe(topics: Uint8Array[], onStatement: (stmt: BridgeStatement) => void): BridgeUnsubscribe;
+        submit(encodedStatement: Uint8Array): Promise<void>;
+        status(): Promise<HostStoreStatus>;
+    };
+    storage: {
+        get(key: string): Promise<string | null>;
+        set(key: string, value: string): Promise<void>;
+        remove(key: string): Promise<void>;
+    };
+    getAddress(): Promise<string>;
+    sign(payload: Uint8Array): Promise<{
+        publicKey: Uint8Array;
+        signature: Uint8Array;
+    }>;
+    /** Optional: resolve a username to an account ID on the People chain. */
+    resolveUsername?(username: string): Promise<string | null>;
+}
+export type { HostStoreStatus } from "../types.js";
+export type { StatementEventPayload } from "../events.js";
+/** Pure encoding helpers required by the bridge - no I/O, no side effects. */
+export interface BridgeEncodingUtils {
+    /** Hash a string into a 32-byte topic (blake2b-256). */
+    stringToTopic(s: string): Uint8Array;
+    /** Build the signing payload for a statement (step 1 of 2). */
+    buildSigningPayload(nowSecs: number, decryptionKey: Uint8Array | null, channel: Uint8Array | null, priority: number, topicsFlat: Uint8Array, data: Uint8Array): Uint8Array;
+    /** Assemble a complete statement from payload + signature (step 2 of 2). */
+    assembleStatement(signingPayloadWithHeader: Uint8Array, sr25519Pubkey: Uint8Array, signature: Uint8Array): Uint8Array;
+    /** Hex-encode bytes with 0x prefix. */
+    hexEncode(bytes: Uint8Array): string;
+}
+/** Options for createWindowHostBridge. */
+export interface CreateWindowHostBridgeOptions {
+    adapter: HostBridgeAdapter;
+    encoding: BridgeEncodingUtils;
+    /** Optional prefix prepended to all storage keys (e.g. "voxchat:"). */
+    storagePrefix?: string;
+    /** Optional metadata describing the host profile and extension capabilities. */
+    metadata?: BridgeMetadataOptions;
+}
+/** The bridge object exposed to the app (assigned to window.host or similar). */
+export interface HostBridge {
+    /** Immutable bridge metadata for version/profile/capability feature detection. */
+    readonly __bridge: BridgeMetadata;
+    statements: {
+        /** Register interest in a channel. Topics are accumulated across calls. */
+        subscribe(channel: string): Promise<boolean>;
+        /** Sign and submit data to a channel. Data must be base64-encoded. */
+        write(channel: string, data: string): Promise<boolean>;
+        /** Query the health of the underlying statement store. */
+        status(): Promise<HostStoreStatus>;
+    };
+    storage: {
+        get(key: string): Promise<string | null>;
+        set(key: string, value: string): Promise<boolean>;
+        remove(key: string): Promise<boolean>;
+    };
+    identity: {
+        /** Resolve a username to a hex account ID. Throws if not supported. */
+        resolveUsername(username: string): Promise<string | null>;
+    };
+    /** Return the hex-encoded address of the current account. */
+    getAddress(): Promise<string>;
+    /** Register an event listener. */
+    on(event: string, callback: (data: unknown) => void): void;
+    /** Remove an event listener. */
+    off(event: string, callback: (data: unknown) => void): void;
+    /** Tear down the bridge: unsubscribe from adapter, clear state. */
+    destroy(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/bridge/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bridge/types.ts"],"names":[],"mappings":"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"}

package/dist/bridge/types.js

@@ -0,0 +1,9 @@
+/**
+ * Types for the window.host bridge adapter pattern.
+ *
+ * The bridge sits between a host runtime (which implements HostBridgeAdapter)
+ * and a guest web app (which uses HostBridge). It translates between the
+ * low-level binary adapter API and the string-oriented API that apps expect.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/bridge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bridge/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}