@dormer/renderer 0.0.0-stage → 0.1.3

package/package.json

@@ -1,6 +1,18 @@
 {
   "name": "@dormer/renderer",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.3",
+  "description": "Typed renderer-side access to the Dormer bridge (invoke, send, on, stream)",
+  "type": "module",
+  "license": "Apache-2.0 OR MIT",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/veerareddyvishal144/dormer.git",
+    "directory": "packages/renderer"
+  }
+}

package/src/index.ts

@@ -0,0 +1,45 @@
+// Thin typed wrapper over the host-injected `window.dormer` bridge.
+export interface DormerErrorLike extends Error { code: string; data?: unknown; retry: boolean }
+export interface InvokeOptions { signal?: AbortSignal }
+export type BinaryInput = Uint8Array | ArrayBuffer | ArrayBufferView;
+/** Trailing argument a handler receives for each part of a chunked upload (bodies > ~16 MiB). */
+export interface BulkChunkMeta { __dormerChunk: { upload: string; chunk: number; of: number; total: number } }
+export interface DormerBridge {
+  invoke<T = unknown>(channel: string, ...args: unknown[]): Promise<T>;
+  invokeWith<T = unknown>(opts: InvokeOptions, channel: string, ...args: unknown[]): Promise<T>;
+  /**
+   * Bulk/binary upload over the custom scheme (ADR-0005 §3). The handler registered with
+   * `ipcMain.handle(channel, (event, bytes: Buffer, ...args) => ...)` receives the bytes as its
+   * first argument. Returns a `Uint8Array` when the handler returns binary, else the JSON value.
+   * Uploads above ~16 MiB are sent as sequential 8 MiB chunk calls, each with a trailing
+   * `BulkChunkMeta` argument; the result of the last chunk call is returned.
+   */
+  invokeBinary<T = unknown>(channel: string, data: BinaryInput, ...args: unknown[]): Promise<T>;
+  invokeBinaryWith<T = unknown>(opts: InvokeOptions, channel: string, data: BinaryInput, ...args: unknown[]): Promise<T>;
+  send(channel: string, ...args: unknown[]): void;
+  on(channel: string, listener: (...args: any[]) => void): () => void;
+  once(channel: string, listener: (...args: any[]) => void): () => void;
+  off(channel: string, listener: (...args: any[]) => void): void;
+  stream(channel: string, ...args: unknown[]): ReadableStream<Uint8Array>;
+  readonly windowId: number;
+  readonly platform: "darwin" | "win32" | "linux";
+  readonly version: number;
+}
+declare global { interface Window { dormer?: DormerBridge } }
+
+function bridge(): DormerBridge {
+  const b = (globalThis as unknown as Window).dormer;
+  if (!b) throw new Error("Dormer bridge not available: this page is not running inside a Dormer window");
+  return b;
+}
+export const isDormer = (): boolean => Boolean((globalThis as unknown as Window).dormer);
+export const invoke = <T = unknown>(channel: string, ...args: unknown[]): Promise<T> => bridge().invoke<T>(channel, ...args);
+export const invokeWith = <T = unknown>(opts: InvokeOptions, channel: string, ...args: unknown[]): Promise<T> => bridge().invokeWith<T>(opts, channel, ...args);
+export const invokeBinary = <T = unknown>(channel: string, data: BinaryInput, ...args: unknown[]): Promise<T> => bridge().invokeBinary<T>(channel, data, ...args);
+export const invokeBinaryWith = <T = unknown>(opts: InvokeOptions, channel: string, data: BinaryInput, ...args: unknown[]): Promise<T> => bridge().invokeBinaryWith<T>(opts, channel, data, ...args);
+export const send = (channel: string, ...args: unknown[]): void => bridge().send(channel, ...args);
+export const on = (channel: string, listener: (...args: any[]) => void): (() => void) => bridge().on(channel, listener);
+export const once = (channel: string, listener: (...args: any[]) => void): (() => void) => bridge().once(channel, listener);
+export const stream = (channel: string, ...args: unknown[]): ReadableStream<Uint8Array> => bridge().stream(channel, ...args);
+export const platform = (): DormerBridge["platform"] => bridge().platform;
+export const windowId = (): number => bridge().windowId;

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.