craft-native 0.0.37

package/dist/bridge/core.d.ts

@@ -0,0 +1,474 @@
+/**
+ * Craft Native Bridge Core
+ * Bidirectional async communication, message queue, and type-safe protocols
+ */
+import { EventEmitter } from 'events';
+interface WkWebKitGlobal {
+    messageHandlers?: {
+        craft?: {
+            postMessage(message: unknown): void;
+        };
+    };
+}
+interface AndroidWebViewGlobal {
+    postMessage(message: string): void;
+}
+interface CraftIPCGlobal {
+    send(channel: string, message: unknown): void;
+}
+declare global {
+    interface Window {
+        webkit?: WkWebKitGlobal;
+        CraftBridge?: AndroidWebViewGlobal;
+        craftIPC?: CraftIPCGlobal;
+    }
+}
+/**
+ * Bridge error codes returned by the native layer.
+ * Used in BridgeMessage.error.code field.
+ */
+export declare const BridgeErrorCodes: {
+    /** Generic/unknown error */
+    readonly UNKNOWN: -1;
+    /** Operation timed out waiting for native response */
+    readonly TIMEOUT: -2;
+    /** Offline queue full, cannot enqueue more requests */
+    readonly QUEUE_FULL: -3;
+    /** Binary transfer not enabled */
+    readonly BINARY_DISABLED: -4;
+    /** Expected binary response but got non-binary */
+    readonly EXPECTED_BINARY: -5;
+    /** Bridge destroyed while requests were pending */
+    readonly BRIDGE_DESTROYED: -6;
+    /** Bridge in-flight request limit exceeded (backpressure) */
+    readonly BUSY: -7;
+    /** Native side speaks an incompatible bridge protocol version */
+    readonly PROTOCOL_MISMATCH: -8;
+    /** Bridge transitioned from connected to disconnected with requests in flight */
+    readonly DISCONNECTED: -9;
+};
+export type BridgeErrorCode = typeof BridgeErrorCodes[keyof typeof BridgeErrorCodes];
+/**
+ * Bridge wire-protocol version. Bumped when the message envelope changes in a
+ * backwards-incompatible way. Native and SDK must agree, or the bridge will
+ * reject the handshake with PROTOCOL_MISMATCH.
+ */
+export declare const BRIDGE_PROTOCOL_VERSION = 1;
+export interface BridgeMessage<T = unknown> {
+    id: string;
+    type: 'request' | 'response' | 'event' | 'stream';
+    method?: string;
+    params?: T;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+    streamId?: string;
+    streamEvent?: 'data' | 'end' | 'error';
+}
+export interface BridgeConfig {
+    timeout?: number;
+    retries?: number;
+    retryDelay?: number;
+    queueSize?: number;
+    batchSize?: number;
+    batchDelay?: number;
+    enableOfflineQueue?: boolean;
+    enableBinaryTransfer?: boolean;
+    /**
+     * Maximum number of in-flight requests before new requests are rejected
+     * with `BridgeErrorCodes.BUSY`. Prevents user code from DOSing the native
+     * layer with tight loops. Defaults to 10_000.
+     */
+    maxConcurrentRequests?: number;
+    /**
+     * Origin to use when the bridge falls back to `window.parent.postMessage`
+     * (i.e. Craft is running inside a host iframe rather than a native
+     * webview). Defaults to `null`, which **disables** the postMessage path
+     * entirely — `'*'` was the old default and leaks bridge traffic to any
+     * cross-origin parent. Set this to your host page's exact origin
+     * (e.g. `'https://app.example.com'`) when embedding.
+     */
+    parentOrigin?: string | null;
+}
+export interface StreamController<T> {
+    onData(callback: (data: T) => void): void;
+    onEnd(callback: () => void): void;
+    onError(callback: (error: Error) => void): void;
+    cancel(): void;
+}
+export declare class NativeBridge extends EventEmitter {
+    private config;
+    private pendingRequests;
+    private offlineQueue;
+    private connected;
+    private streams;
+    private batchBuffer;
+    private batchTimer;
+    private destroyed;
+    private readonly idPrefix;
+    private idCounter;
+    private nextMessageId;
+    private boundHandleMessage;
+    private craftReadyHandler;
+    constructor(config?: BridgeConfig);
+    private setupBridge;
+    private teardownBridgeListeners;
+    private handleMessage;
+    /** True when the given id starts with this bridge's per-instance prefix. */
+    private isOwnId;
+    private handleResponse;
+    private handleEvent;
+    private handleStream;
+    /**
+     * Send a request to native and wait for response
+     */
+    request<T = unknown, R = unknown>(method: string, params?: T, options?: {
+        timeout?: number;
+    }): Promise<R>;
+    private requestWithRetry;
+    private isRetryableError;
+    private sendRequest;
+    /**
+     * Negotiate the wire-protocol version with the native layer. Throws
+     * BridgeError(PROTOCOL_MISMATCH) if the native side reports a version we
+     * don't speak.
+     *
+     * This is **opt-in** — you must call it explicitly. It assumes the host
+     * registers a `_handshake` handler; the Zig core's
+     * `Bridge.registerDefaults()` does this for you. If you're embedding Craft
+     * inside a host that hasn't wired `_handshake`, do not call this method
+     * (the timeout path will reject with TIMEOUT, which is louder than a
+     * silent mismatch but still a failure).
+     */
+    handshake(): Promise<{
+        nativeVersion: number;
+    }>;
+    /**
+     * Send a fire-and-forget message (no response expected)
+     */
+    notify<T = unknown>(method: string, params?: T): void;
+    /**
+     * Create a stream for receiving multiple responses.
+     *
+     * @param method - native method name
+     * @param params - method params
+     * @param options.bufferLimit - max events buffered before consumer registers
+     *   `onData`. Once exceeded the stream is failed with `BUFFER_OVERFLOW`
+     *   instead of growing indefinitely. Defaults to 1000.
+     */
+    stream<T = unknown>(method: string, params?: unknown, options?: {
+        bufferLimit?: number;
+    }): StreamController<T>;
+    /**
+     * Send binary data to native
+     */
+    sendBinary(method: string, data: ArrayBuffer | Uint8Array): Promise<void>;
+    /**
+     * Receive binary data from native
+     */
+    receiveBinary(method: string, params?: unknown): Promise<ArrayBuffer>;
+    /**
+     * Batch multiple requests
+     */
+    batch<T extends Array<{
+        method: string;
+        params?: unknown;
+    }>>(requests: T): Promise<Array<{
+        result?: unknown;
+        error?: {
+            code: number;
+            message: string;
+        };
+    }>>;
+    /**
+     * Add request to batch buffer (auto-flushed)
+     */
+    addToBatch<T = unknown>(method: string, params?: T): void;
+    private flushBatch;
+    /**
+     * Set connection status. Emits `'connected'` / `'disconnected'`. On
+     * disconnect, every outstanding pending request is rejected with
+     * `BridgeErrorCodes.DISCONNECTED` immediately — previously they sat
+     * until `timeout` (default 30s) expired, hanging the calling app.
+     */
+    setConnected(connected: boolean): void;
+    private flushOfflineQueue;
+    /**
+     * Dispatch a message to whichever native transport is available. Returns
+     * `true` when the message was handed off to a transport, `false` when no
+     * transport could be found — the caller (only `sendRequest` cares) can
+     * use that to fail fast instead of waiting for the request timeout.
+     */
+    private send;
+    /**
+     * Reject the pending entry corresponding to `message.id` with `error`,
+     * if any. Used by `send()` when serialization or transport throws so
+     * the caller's promise rejects immediately.
+     */
+    private failPendingForMessage;
+    private delay;
+    private arrayBufferToBase64;
+    private base64ToArrayBuffer;
+    /**
+     * Destroy the bridge. Idempotent.
+     */
+    destroy(): void;
+}
+export declare class BridgeError extends Error {
+    code: number;
+    data?: unknown;
+    constructor(message: string, code: number, data?: unknown);
+}
+export interface BridgeMethod<P = void, R = void> {
+    method: string;
+    params: P;
+    result: R;
+}
+export type InferParams<T> = T extends BridgeMethod<infer P, unknown> ? P : never;
+export type InferResult<T> = T extends BridgeMethod<unknown, infer R> ? R : never;
+export declare function createTypedBridge<T extends Record<string, BridgeMethod<any, any>>>(bridge: NativeBridge): { [K in keyof T]: (params: InferParams<T[K]>) => Promise<InferResult<T[K]>>; };
+export interface MenuItem {
+    id: string;
+    label: string;
+    accelerator?: string;
+    type?: 'normal' | 'separator' | 'checkbox' | 'radio';
+    checked?: boolean;
+    enabled?: boolean;
+    visible?: boolean;
+    icon?: string;
+    submenu?: MenuItem[];
+}
+export declare class NativeMenus {
+    private bridge;
+    constructor(bridge: NativeBridge);
+    /**
+     * Set application menu
+     */
+    setApplicationMenu(menu: MenuItem[]): Promise<void>;
+    /**
+     * Show context menu
+     */
+    showContextMenu(menu: MenuItem[], position?: {
+        x: number;
+        y: number;
+    }): Promise<string | null>;
+    /**
+     * Update menu item
+     */
+    updateMenuItem(id: string, updates: Partial<MenuItem>): Promise<void>;
+    /**
+     * Listen for menu item clicks
+     */
+    onMenuClick(callback: (id: string) => void): () => void;
+}
+export interface OpenDialogOptions {
+    title?: string;
+    defaultPath?: string;
+    buttonLabel?: string;
+    filters?: Array<{
+        name: string;
+        extensions: string[];
+    }>;
+    properties?: Array<'openFile' | 'openDirectory' | 'multiSelections' | 'showHiddenFiles' | 'createDirectory' | 'promptToCreate' | 'noResolveAliases' | 'treatPackageAsDirectory' | 'dontAddToRecent'>;
+    message?: string;
+}
+export interface SaveDialogOptions {
+    title?: string;
+    defaultPath?: string;
+    buttonLabel?: string;
+    filters?: Array<{
+        name: string;
+        extensions: string[];
+    }>;
+    properties?: Array<'showHiddenFiles' | 'createDirectory' | 'showOverwriteConfirmation' | 'dontAddToRecent'>;
+    message?: string;
+    nameFieldLabel?: string;
+    showsTagField?: boolean;
+}
+export interface MessageBoxOptions {
+    type?: 'none' | 'info' | 'error' | 'question' | 'warning';
+    buttons?: string[];
+    defaultId?: number;
+    cancelId?: number;
+    title?: string;
+    message: string;
+    detail?: string;
+    checkboxLabel?: string;
+    checkboxChecked?: boolean;
+    icon?: string;
+}
+export declare class NativeDialogs {
+    private bridge;
+    constructor(bridge: NativeBridge);
+    /**
+     * Show open file dialog
+     */
+    showOpenDialog(options?: OpenDialogOptions): Promise<{
+        canceled: boolean;
+        filePaths: string[];
+    }>;
+    /**
+     * Show save file dialog
+     */
+    showSaveDialog(options?: SaveDialogOptions): Promise<{
+        canceled: boolean;
+        filePath?: string;
+    }>;
+    /**
+     * Show message box
+     */
+    showMessageBox(options: MessageBoxOptions): Promise<{
+        response: number;
+        checkboxChecked?: boolean;
+    }>;
+    /**
+     * Show error box
+     */
+    showErrorBox(title: string, content: string): Promise<void>;
+    /**
+     * Show color picker
+     */
+    showColorPicker(options?: {
+        defaultColor?: string;
+        title?: string;
+    }): Promise<string | null>;
+    /**
+     * Show font picker
+     */
+    showFontPicker(options?: {
+        defaultFont?: {
+            family: string;
+            size: number;
+        };
+        title?: string;
+    }): Promise<{
+        family: string;
+        size: number;
+    } | null>;
+}
+export interface NativeComponent {
+    id: string;
+    type: string;
+    props: Record<string, unknown>;
+}
+export declare class NativeComponentBridge {
+    private bridge;
+    private components;
+    constructor(bridge: NativeBridge);
+    private handleComponentEvent;
+    /**
+     * Create a native sidebar
+     */
+    createSidebar(config: {
+        width?: number;
+        minWidth?: number;
+        maxWidth?: number;
+        position?: 'left' | 'right';
+        collapsible?: boolean;
+        collapsed?: boolean;
+        variant?: 'tahoe' | 'vibrancy' | 'solid' | 'transparent' | 'workspace' | 'desktop';
+        material?: 'auto' | 'sidebar' | 'hud' | 'popover' | 'content';
+        backgroundEffect?: 'none' | 'vibrancy' | 'shimmer';
+        allowsVibrancy?: boolean;
+        sections?: Array<{
+            id: string;
+            label?: string;
+            title?: string;
+            items?: Array<{
+                id: string;
+                label: string;
+                icon?: string;
+                href?: string;
+                badge?: string | number;
+            }>;
+        }>;
+    }): Promise<string>;
+    /**
+     * Create a native file browser
+     */
+    createFileBrowser(config: {
+        rootPath?: string;
+        showHidden?: boolean;
+        selectionMode?: 'single' | 'multiple';
+        fileFilter?: Array<{
+            name: string;
+            extensions: string[];
+        }>;
+    }): Promise<string>;
+    /**
+     * Create a native split view
+     */
+    createSplitView(config: {
+        orientation?: 'horizontal' | 'vertical';
+        dividerStyle?: 'thin' | 'thick' | 'paneSplitter';
+        initialPosition?: number;
+        minPositions?: [number, number];
+    }): Promise<string>;
+    /**
+     * Update component props
+     */
+    updateComponent(componentId: string, props: Record<string, unknown>): Promise<void>;
+    /**
+     * Destroy component
+     */
+    destroyComponent(componentId: string): Promise<void>;
+    /**
+     * Listen for component events
+     */
+    onComponentEvent(componentId: string, eventType: string, callback: (data: unknown) => void): () => void;
+    /**
+     * Get selection from file browser
+     */
+    getFileBrowserSelection(componentId: string): Promise<string[]>;
+}
+/**
+ * Get the process-wide singleton bridge, constructing it on first call.
+ *
+ * **Caveats for multi-window apps:**
+ *   - The first caller's `config` wins; later calls receive the existing
+ *     instance regardless of the config they pass — and we now log a
+ *     `console.warn` when a follow-up caller passes a config that differs
+ *     from the original (so silently-discarded configs are at least
+ *     visible during development).
+ *   - Calling `destroy()` on the returned bridge tears down state for
+ *     every consumer, not just the caller.
+ *
+ * If your app opens more than one window or test harness, prefer
+ * {@link createBridge} to create independent instances and pass them
+ * explicitly to the components that need them.
+ */
+export declare function getBridge(config?: BridgeConfig): NativeBridge;
+/**
+ * Create an independent bridge instance. Use this in multi-window apps and
+ * tests where the singleton from {@link getBridge} would cause two callers
+ * to share state.
+ */
+export declare function createBridge(config?: BridgeConfig): NativeBridge;
+/**
+ * Reset the global bridge. Intended for tests that need to start from a
+ * known state — call `destroy()` on the previous instance first if you
+ * created any pending work.
+ */
+export declare function resetGlobalBridge(): void;
+export declare function getMenus(): NativeMenus;
+export declare function getDialogs(): NativeDialogs;
+export declare function getComponents(): NativeComponentBridge;
+declare const bridgeCore: {
+    NativeBridge: typeof NativeBridge;
+    BridgeError: typeof BridgeError;
+    BridgeErrorCodes: typeof BridgeErrorCodes;
+    createTypedBridge: typeof createTypedBridge;
+    NativeMenus: typeof NativeMenus;
+    NativeDialogs: typeof NativeDialogs;
+    NativeComponentBridge: typeof NativeComponentBridge;
+    getBridge: typeof getBridge;
+    createBridge: typeof createBridge;
+    getMenus: typeof getMenus;
+    getDialogs: typeof getDialogs;
+    getComponents: typeof getComponents;
+};
+export default bridgeCore;
+//# sourceMappingURL=core.d.ts.map

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

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

package/dist/bridge/ids.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Cryptographically-secure ID helpers shared across the bridge implementations.
+ *
+ * Math.random() is not safe for IDs that are routed back to the page (callback
+ * IDs, webview IDs) — predictable IDs let injected JS hijack pending callbacks.
+ * Use these helpers instead.
+ */
+/**
+ * Returns a v4 UUID string. Falls back to crypto.getRandomValues when
+ * randomUUID is unavailable. Throws if no Web Crypto is available at all,
+ * which would indicate a non-browser, non-Node environment we don't support.
+ */
+export declare function secureUUID(): string;
+/**
+ * Returns a prefixed, secure ID, e.g. `webview_3f7a…`.
+ */
+export declare function secureId(prefix: string): string;
+//# sourceMappingURL=ids.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/bridge/ids.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAcnC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/C"}