@keemakr/ui-sdk 1.2.0 → 1.3.0-poc-20260911235111

package/dist/index.d.ts

@@ -4,3 +4,5 @@ export { childNodesOf, KNOWN_CONTAINERS, KNOWN_NODE_TYPES } from './nodes.js';
 export type { ContainerChild, ContainerNodeType, KnownNodeType } from './nodes.js';
 export { defineScreen, defineSurface } from './define.js';
 export type { ScreenDefinition, ScreenParams, LoadHandler, ActionHandler } from './define.js';
+export { createWidgetClient } from './widget.js';
+export type { WidgetClient, WidgetClientOptions, WidgetFetch, WidgetResponse, WidgetStorage, } from './widget.js';

package/dist/index.js

@@ -9,3 +9,4 @@
 export { UI_SCHEMA_VERSION, pressSchema, buttonSchema, cellSchema, nodeSchema, screenTreeSchema, actionResultSchema, screenLoadRequestSchema, screenLoadResponseSchema, screenActionRequestSchema, interfaceFamilySchema, surfaceDefinitionSchema, surfaceSchema, screenRegistrationSchema, uiManifestSchema, } from './schema.js';
 export { childNodesOf, KNOWN_CONTAINERS, KNOWN_NODE_TYPES } from './nodes.js';
 export { defineScreen, defineSurface } from './define.js';
+export { createWidgetClient } from './widget.js';

package/dist/widget.d.ts

@@ -0,0 +1,36 @@
+export interface WidgetStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+export interface WidgetResponse {
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+}
+export type WidgetFetch = (url: string, init: {
+    method: 'GET' | 'POST';
+    headers?: Record<string, string>;
+    body?: unknown;
+}) => Promise<WidgetResponse>;
+export interface WidgetClientOptions {
+    coreUrl: string;
+    widgetId: string;
+    routeKey?: string;
+    storage?: WidgetStorage;
+    fetch?: WidgetFetch;
+}
+export interface WidgetClient {
+    bootstrap(): Promise<void>;
+    getMessages(): Promise<unknown>;
+    sendMessage(input: {
+        text: string;
+        idempotencyKey?: string;
+        attachmentIds?: string[];
+    }): Promise<unknown>;
+    assertHandle(kind: 'email' | 'phone', value: string): Promise<unknown>;
+    verifyHandle(challengeId: string, code: string): Promise<unknown>;
+    uploadAttachment(bytes: Uint8Array, mediaType: string): Promise<unknown>;
+    forget(): void;
+}
+export declare function createWidgetClient(options: WidgetClientOptions): WidgetClient;

package/dist/widget.js

@@ -0,0 +1,90 @@
+function browserStorage() {
+    const storage = globalThis.localStorage;
+    if (!storage)
+        throw new Error('widget storage is unavailable');
+    return storage;
+}
+function browserFetch() {
+    const value = globalThis.fetch;
+    if (typeof value !== 'function')
+        throw new Error('widget fetch is unavailable');
+    return value.bind(globalThis);
+}
+function randomId() {
+    const crypto = globalThis.crypto;
+    if (!crypto?.randomUUID)
+        throw new Error('crypto.randomUUID is unavailable');
+    return crypto.randomUUID();
+}
+export function createWidgetClient(options) {
+    const coreUrl = options.coreUrl.replace(/\/$/, '');
+    const routeKey = options.routeKey ?? 'default';
+    const storage = options.storage ?? browserStorage();
+    const request = options.fetch ?? browserFetch();
+    const storageKey = `kee:widget:${options.widgetId}:${routeKey}`;
+    const query = new URLSearchParams({
+        widget_id: options.widgetId,
+        route_key: routeKey,
+    }).toString();
+    async function decode(response) {
+        const body = await response.json();
+        if (!response.ok)
+            throw new Error(`widget request failed (${response.status})`);
+        return body;
+    }
+    async function bootstrap(retry = true) {
+        const visitorToken = storage.getItem(storageKey);
+        const response = await request(`${coreUrl}/api/channels/widget/bootstrap?${query}`, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({
+                widget_id: options.widgetId,
+                route_key: routeKey,
+                ...(visitorToken ? { visitor_token: visitorToken } : {}),
+            }),
+        });
+        if (!response.ok && response.status === 401 && visitorToken && retry) {
+            storage.removeItem(storageKey);
+            return bootstrap(false);
+        }
+        const body = (await decode(response));
+        if (typeof body.visitor_token !== 'string')
+            throw new Error('widget bootstrap token is missing');
+        storage.setItem(storageKey, body.visitor_token);
+    }
+    async function authorizedRequest(path, init, retry = true) {
+        if (!storage.getItem(storageKey))
+            await bootstrap();
+        const token = storage.getItem(storageKey);
+        const response = await request(`${coreUrl}/api/channels/widget/${path}?${query}`, {
+            ...init,
+            headers: { authorization: `Bearer ${token}`, ...init.headers },
+        });
+        if (!response.ok && response.status === 401 && retry) {
+            storage.removeItem(storageKey);
+            await bootstrap(false);
+            return authorizedRequest(path, init, false);
+        }
+        return decode(response);
+    }
+    async function post(path, body, headers) {
+        return authorizedRequest(path, { method: 'POST', headers, body });
+    }
+    async function get(path) {
+        return authorizedRequest(path, { method: 'GET' });
+    }
+    return {
+        bootstrap,
+        getMessages: () => get('messages'),
+        sendMessage: ({ text, idempotencyKey = randomId(), attachmentIds = [] }) => post('messages', JSON.stringify({ text, idempotency_key: idempotencyKey, attachment_ids: attachmentIds }), { 'content-type': 'application/json' }),
+        assertHandle: (kind, value) => post('handles', JSON.stringify({ kind, value }), { 'content-type': 'application/json' }),
+        verifyHandle: (challengeId, code) => post('handles/verify', JSON.stringify({ challenge_id: challengeId, code }), {
+            'content-type': 'application/json',
+        }),
+        uploadAttachment: (bytes, mediaType) => post('attachments', bytes, {
+            'content-type': 'application/octet-stream',
+            'x-kee-media-type': mediaType,
+        }),
+        forget: () => storage.removeItem(storageKey),
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keemakr/ui-sdk",
-  "version": "1.2.0",
+  "version": "1.3.0-poc-20260911235111",
   "description": "Product screens for keemakr marketplace modules: a versioned, server-driven UI tree schema plus defineScreen() handlers. Module code never ships to the browser — keemakr-core validates the tree and renders it with platform components.",
   "license": "MIT",
   "type": "module",
@@ -16,6 +16,11 @@
       "types": "./dist/build.d.ts",
       "import": "./dist/build.js",
       "default": "./dist/build.js"
+    },
+    "./widget": {
+      "types": "./dist/widget.d.ts",
+      "import": "./dist/widget.js",
+      "default": "./dist/widget.js"
     }
   },
   "bin": {