electron-effect-rpc 0.2.0 → 0.4.0

package/README.md

@@ -1,24 +1,26 @@
 # electron-effect-rpc
 
-Typed IPC RPC for Electron, built on Effect and @effect/schema. This library
-lets you define a shared contract, generate a typed RPC client in the renderer,
-register handlers in the main process, and stream typed events across processes.
+Typed IPC RPC for Electron, built on Effect and @effect/schema.
 
-This package is ESM-only. It targets modern Electron runtimes (current project
-uses Electron 38) and assumes ESM-capable bundling.
+The ergonomic default is now a single shared `createIpcKit` configuration that
+you reuse in main, preload, and renderer code. Low-level subpath APIs still
+exist and remain fully supported.
+
+This package is ESM-only. It targets modern Electron runtimes and assumes an
+ESM-capable build pipeline.
 
 ## Features
 - Single shared contract for methods and events.
-- End-to-end type safety using @effect/schema.
-- Promise-based renderer client with typed errors.
-- Effect-based main handlers with explicit runtime injection.
-- Explicit lifecycle handles for main-process RPC and event publishing.
-- Bounded event queue with drop-oldest backpressure.
+- Single shared kit config to eliminate cross-process prefix drift.
+- End-to-end schema validation at IPC boundaries.
+- Effect-first renderer RPC with typed domain and defect channels.
+- Effect-native main handlers with explicit runtime injection.
+- Explicit lifecycle handles and bounded event queue backpressure.
 - Structured diagnostics hooks for decode/protocol/dispatch failures.
 
 ## Requirements
 - Electron with context isolation enabled.
-- ESM-capable build pipeline.
+- ESM-capable bundling.
 - Peer dependencies: `effect`, `@effect/schema`, `electron`.
 
 ## Installation
@@ -26,31 +28,12 @@ uses Electron 38) and assumes ESM-capable bundling.
 bun add electron-effect-rpc effect @effect/schema
 ```
 
-If you are in a monorepo workspace, add the dependency to the target package
-and let the workspace resolver handle the rest.
-
-## Core Concepts
-
-### Communication directions
-
-This library provides two communication patterns for Electron IPC:
-
-| Direction | Mechanism | Pattern | Use case |
-|-----------|-----------|---------|----------|
-| **Renderer → Main** | RPC methods | Request/response | Fetching data, triggering actions, calling main process APIs |
-| **Main → Renderer** | Event bus | Push/broadcast | Progress updates, state changes, background task notifications |
-
-**RPC methods** are for when the renderer needs something from the main process. The renderer calls a method and awaits a typed response.
-
-**Events** are for when the main process needs to notify the renderer. The main process emits events whenever it wants, and the renderer subscribes to receive them.
-
-### Defining methods and events
-
-Define methods and events using schema-based helpers:
+## Quickstart (Kit-First)
 
+### 1) Define contract and kit once
 ```ts
 import * as S from "@effect/schema/Schema";
-import { defineContract, event, rpc } from "electron-effect-rpc/contract";
+import { createIpcKit, defineContract, event, rpc } from "electron-effect-rpc";
 
 export const GetAppVersion = rpc(
   "GetAppVersion",
@@ -67,218 +50,143 @@ export const WorkUnitProgress = event(
   })
 );
 
-const methods = [GetAppVersion] as const;
-const events = [WorkUnitProgress] as const;
+const contract = defineContract({
+  methods: [GetAppVersion] as const,
+  events: [WorkUnitProgress] as const,
+});
 
-export const contract = defineContract({ methods, events });
+export const ipc = createIpcKit({
+  contract,
+  channelPrefix: { rpc: "rpc/", event: "event/" },
+  bridge: { global: "api" },
+  decode: { rpc: "envelope", events: "safe" },
+});
 ```
 
-### Errors
-Error schemas should be `Schema.TaggedError` classes. If a method does not
-declare an error schema, it uses `NoError` and the error channel is `never`.
-
-```ts
-import * as S from "@effect/schema/Schema";
-import { rpc } from "electron-effect-rpc/contract";
-
-export class FileReadError extends S.TaggedError<FileReadError>()("FileReadError", {
-  message: S.String,
-  path: S.String,
-}) {}
-
-export const ReadTextFile = rpc(
-  "ReadTextFile",
-  S.Struct({ path: S.String }),
-  S.Struct({ content: S.String }),
-  FileReadError
-);
-```
-
-## Usage
-
-### Main process: register handlers
+### 2) Main process
 ```ts
 import { app, ipcMain } from "electron";
 import { Effect } from "effect";
 import * as Runtime from "effect/Runtime";
-import { createRpcEndpoint, createEventPublisher } from "electron-effect-rpc/main";
-import { contract, WorkUnitProgress } from "./contract.ts";
-
-const implementations = {
-  GetAppVersion: () => Effect.succeed({ version: app.getVersion() }),
-};
+import { ipc, WorkUnitProgress } from "./shared-ipc.ts";
 
-const endpoint = createRpcEndpoint(contract, ipcMain, implementations, {
+const mainRpc = ipc.main({
+  ipcMain,
+  handlers: {
+    GetAppVersion: () => Effect.succeed({ version: app.getVersion() }),
+  },
   runtime: Runtime.defaultRuntime,
-});
-endpoint.start();
-
-const publisher = createEventPublisher(contract, {
   getWindow: () => mainWindow,
 });
-publisher.start();
 
-publisher.publish(WorkUnitProgress, {
+mainRpc.start();
+
+void Effect.runPromise(mainRpc.publish(WorkUnitProgress, {
   requestId: "req-1",
-  chunk: "working...",
+  chunk: "starting",
   done: false,
-});
-```
-
-Pass the runtime used to execute handler effects:
-
-```ts
-import * as Runtime from "effect/Runtime";
-import { createRpcEndpoint } from "electron-effect-rpc/main";
-import { contract } from "./contract.ts";
-
-const endpoint = createRpcEndpoint(contract, ipcMain, implementations, {
-  runtime: Runtime.defaultRuntime,
-});
-
-endpoint.start();
+}));
 ```
 
-### Preload: expose bridge globals
+### 3) Preload
 ```ts
-import { exposeRpcBridge } from "electron-effect-rpc/preload";
+import { ipc } from "./shared-ipc.ts";
 
-exposeRpcBridge();
+ipc.preload().expose();
 ```
 
-Defaults:
-- RPC global: `window.rpc.invoke(method, payload)`
-- Events global: `window.events.subscribe(name, handler)`
-- Channel prefix: `rpc/` and `event/`
+This exposes one global by default: `window.api`.
 
-You can override globals and prefixes:
+### 4) Renderer
 ```ts
-exposeRpcBridge({
-  rpcGlobal: "rpcApi",
-  eventsGlobal: "rpcEvents",
-  channelPrefix: { rpc: "rpc/", event: "events/" },
-});
-```
-
-Or use low-level bridge adapters for custom exposure:
-```ts
-import { createBridgeAdapters } from "electron-effect-rpc/preload";
-
-const bridge = createBridgeAdapters();
-// bridge.invoke(method, payload)
-// bridge.subscribe(name, handler)
-```
-
-### Renderer: create client and subscriber
-```ts
-import { createRpcClient, createEventSubscriber } from "electron-effect-rpc/renderer";
-import { contract, WorkUnitProgress } from "./contract.ts";
-
-const client = createRpcClient(contract, { invoke: window.rpc.invoke });
-const events = createEventSubscriber(contract, {
-  subscribe: window.events.subscribe,
-  decodeMode: "safe", // default
-});
+import { Effect } from "effect";
+import { ipc, WorkUnitProgress } from "./shared-ipc.ts";
 
-const { version } = await client.GetAppVersion();
+const { client, events } = ipc.renderer(window.api);
+const { version } = await Effect.runPromise(client.GetAppVersion());
 
-events.subscribe(WorkUnitProgress, (payload) => {
+const unsubscribe = events.subscribe(WorkUnitProgress, (payload) => {
   console.log(payload.chunk);
 });
-```
 
-### Window type augmentation
-If you expose globals in preload, add a local `globals.d.ts`:
+// later
+unsubscribe();
+events.dispose();
+```
 
+### 5) Window typing
 ```ts
 declare global {
   interface Window {
-    rpc: {
+    api: {
       invoke: (method: string, payload: unknown) => Promise<unknown>;
-    };
-    events: {
       subscribe: (name: string, handler: (payload: unknown) => void) => () => void;
     };
   }
 }
 ```
 
-## Testing
+## Error Model
 
-### Renderer client tests
-Use the testing helpers to stub invoke behavior:
+Domain failures are modeled with tagged error schemas and are surfaced in the
+Effect error channel as those same tagged values. Unexpected failures,
+transport defects, and protocol mismatches are surfaced as `RpcDefectError`,
+which includes a stable `code` discriminator:
+`request_encoding_failed`, `invoke_failed`,
+`success_payload_decoding_failed`, `failure_payload_decoding_failed`,
+`noerror_contract_violation`, `invalid_response_envelope`,
+`legacy_decode_failed`, and `remote_defect`.
 
-```ts
-import { createRpcClient } from "electron-effect-rpc/renderer";
-import { createInvokeStub } from "electron-effect-rpc/testing";
-import { contract } from "./contract.ts";
-
-const invoke = createInvokeStub(async (method, payload) => {
-  return {
-    type: "success",
-    data: { version: "1.0.0" },
-  };
-});
+## Breaking Changes
 
-const client = createRpcClient(contract, { invoke });
-await client.GetAppVersion();
+Renderer RPC methods now return `Effect.Effect` instead of `Promise`, and
+`IpcMainHandle.emit` was removed in favor of `publish`.
 
-expect(invoke.invocations).toEqual([
-  { method: "GetAppVersion", payload: {} },
-]);
+Before:
+
+```ts
+const result = await client.GetAppVersion();
+await mainRpc.emit(WorkUnitProgress, payload);
 ```
 
-### Main process tests
-You can stub `IpcMainLike` and collect registered handlers:
+After:
 
 ```ts
-import * as Runtime from "effect/Runtime";
-import { createRpcEndpoint } from "electron-effect-rpc/main";
-import type { IpcMainLike } from "electron-effect-rpc/types";
-import { contract } from "./contract.ts";
-
-const handlers = new Map<string, (event: unknown, payload: unknown) => unknown>();
-const ipcMainStub: IpcMainLike = {
-  handle: (channel, handler) => {
-    handlers.set(channel, handler);
-  },
-  removeHandler: (channel) => {
-    handlers.delete(channel);
-  },
-};
-
-const endpoint = createRpcEndpoint(contract, ipcMainStub, implementations, {
-  runtime: Runtime.defaultRuntime,
-});
-endpoint.start();
+const result = await Effect.runPromise(client.GetAppVersion());
+await Effect.runPromise(mainRpc.publish(WorkUnitProgress, payload));
 ```
 
-## Error Handling
-- If a handler fails with a typed domain error, the renderer client rejects
-  with that error instance.
-- If a handler dies or throws a defect, the renderer client rejects with
-  `RpcDefectError`.
+## Low-Level APIs (Still Supported)
 
-## API Surface
-
-Entry points:
+If you need direct control, keep using subpath entry points:
 - `electron-effect-rpc/contract`
-  - `rpc`, `event`, `defineContract`, `exitSchemaFor`, `SchemaNoContext`, `NoError`
-- `electron-effect-rpc/types`
-  - Type aliases such as `Implementations`, `RpcClient`, `RpcEventPublisher`, `IpcMainLike`
 - `electron-effect-rpc/main`
-  - `createRpcEndpoint`, `createEventPublisher`
 - `electron-effect-rpc/renderer`
-  - `createRpcClient`, `createEventSubscriber`, `RpcDefectError`
 - `electron-effect-rpc/preload`
-  - `exposeRpcBridge`, `createBridgeAdapters`
+- `electron-effect-rpc/types`
 - `electron-effect-rpc/testing`
-  - `createInvokeStub`, `createDeferred`
+
+## Root API Surface
+
+The root entry point exports:
+- `createIpcKit`
+- `rpc`, `event`, `defineContract`, `NoError`
+- Types: `IpcKit`, `IpcKitOptions`, `IpcMainHandle`, `IpcBridge`, `IpcBridgeGlobal`
+
+Low-level factories like `createRpcClient` remain subpath-only by design.
+
+## Tutorials
+
+For deeper walkthroughs and production guidance:
+- [Tutorial Index](./docs/tutorials/README.md)
+- [First RPC: Main + Preload + Renderer](./docs/tutorials/01-first-rpc.md)
+- [Typed Errors, Defects, and Diagnostics](./docs/tutorials/02-typed-errors-defects-diagnostics.md)
+- [Events, Lifecycle, and Backpressure](./docs/tutorials/03-events-lifecycle-backpressure.md)
 
 ## Conventions
 - Relative imports use `.ts` extensions.
 - Package imports are extensionless.
-- No `index.ts` barrel files.
+- No `index.ts` barrel files in subpath modules.
 
 ## License
 MIT

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createIpcKit } from "./kit.ts";
+export { defineContract, event, NoError, rpc } from "./contract.ts";
+export type { IpcBridge, IpcBridgeGlobal, IpcKit, IpcKitOptions, IpcMainHandle, } from "./kit.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpE,YAAY,EACV,SAAS,EACT,eAAe,EACf,MAAM,EACN,aAAa,EACb,aAAa,GACd,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createIpcKit } from "./kit.js";
+export { defineContract, event, NoError, rpc } from "./contract.js";

package/dist/kit.d.ts

@@ -0,0 +1,70 @@
+import { Effect } from "effect";
+import type * as Runtime from "effect/Runtime";
+import type { AnyEvent, AnyMethod, RpcContract, RpcEventPayload } from "./contract.ts";
+import { type ChannelPrefix, type EventDecodeMode, type EventPublisherDiagnostics, type EventSubscribe, type EventSubscriber, type IpcMainLike, type Implementations, type RendererWindowLike, type RpcClient, type RpcEndpoint, type RpcEndpointDiagnostics, type RpcEventPublisher, type RpcInvoke, type RpcResponseDecodeMode } from "./types.ts";
+export type IpcBridge = {
+    readonly invoke: RpcInvoke;
+    readonly subscribe: EventSubscribe;
+};
+export type IpcBridgeGlobal<Name extends string = "api"> = {
+    readonly [K in Name]: IpcBridge;
+};
+export type IpcKitOptions<C extends RpcContract<readonly AnyMethod[], readonly AnyEvent[]>> = {
+    readonly contract: C;
+    readonly channelPrefix?: ChannelPrefix;
+    readonly bridge?: {
+        readonly global?: string;
+    };
+    readonly decode?: {
+        readonly rpc?: RpcResponseDecodeMode;
+        readonly events?: EventDecodeMode;
+    };
+};
+type IpcMainOptions<C extends RpcContract<readonly AnyMethod[], readonly AnyEvent[]>, R> = {
+    readonly ipcMain: IpcMainLike;
+    readonly handlers: Implementations<C, R>;
+    readonly runtime: Runtime.Runtime<R>;
+    readonly getWindow: () => RendererWindowLike | null;
+    readonly maxQueueSize?: number;
+    readonly diagnostics?: {
+        readonly rpc?: RpcEndpointDiagnostics;
+        readonly events?: EventPublisherDiagnostics;
+    };
+};
+export type IpcMainHandle<C extends RpcContract<readonly AnyMethod[], readonly AnyEvent[]>> = {
+    readonly endpoint: RpcEndpoint;
+    readonly publisher: RpcEventPublisher<C>;
+    readonly start: () => void;
+    readonly stop: () => void;
+    readonly dispose: () => void;
+    readonly isRunning: () => boolean;
+    readonly publish: <E extends C["events"][number]>(event: E, payload: RpcEventPayload<E>) => Effect.Effect<void, never>;
+    readonly stats: () => {
+        readonly queued: number;
+        readonly dropped: number;
+    };
+};
+export type IpcKit<C extends RpcContract<readonly AnyMethod[], readonly AnyEvent[]>> = {
+    readonly contract: C;
+    readonly config: {
+        readonly channelPrefix: ChannelPrefix;
+        readonly bridgeGlobal: string;
+        readonly rpcDecodeMode: RpcResponseDecodeMode;
+        readonly eventDecodeMode: EventDecodeMode;
+    };
+    readonly main: <R>(options: IpcMainOptions<C, R>) => IpcMainHandle<C>;
+    readonly preload: (options?: {
+        readonly global?: string;
+    }) => {
+        readonly global: string;
+        readonly bridge: IpcBridge;
+        readonly expose: () => void;
+    };
+    readonly renderer: (bridge: IpcBridge) => {
+        readonly client: RpcClient<C>;
+        readonly events: EventSubscriber<C>;
+    };
+};
+export declare function createIpcKit<const Methods extends ReadonlyArray<AnyMethod>, const Events extends ReadonlyArray<AnyEvent>>(options: IpcKitOptions<RpcContract<Methods, Events>>): IpcKit<RpcContract<Methods, Events>>;
+export {};
+//# sourceMappingURL=kit.d.ts.map

package/dist/kit.d.ts.map

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

package/dist/kit.js

@@ -0,0 +1,134 @@
+import { Effect } from "effect";
+import { createEventPublisher, createRpcEndpoint } from "./main.js";
+import { exposeIpcBridge, createBridgeAdapters } from "./preload.js";
+import { createEventSubscriber, createRpcClient } from "./renderer.js";
+import { defaultChannelPrefix, } from "./types.js";
+export function createIpcKit(options) {
+    const contract = options.contract;
+    const channelPrefix = options.channelPrefix
+        ? { ...options.channelPrefix }
+        : { ...defaultChannelPrefix };
+    const bridgeGlobal = options.bridge?.global ?? "api";
+    const rpcDecodeMode = options.decode?.rpc ?? "envelope";
+    const eventDecodeMode = options.decode?.events ?? "safe";
+    const main = (mainOptions) => {
+        const endpoint = createRpcEndpoint(contract, mainOptions.ipcMain, mainOptions.handlers, {
+            runtime: mainOptions.runtime,
+            channelPrefix,
+            diagnostics: mainOptions.diagnostics?.rpc,
+        });
+        const publisher = createEventPublisher(contract, {
+            getWindow: mainOptions.getWindow,
+            maxQueueSize: mainOptions.maxQueueSize,
+            channelPrefix,
+            diagnostics: mainOptions.diagnostics?.events,
+        });
+        function start() {
+            endpoint.start();
+            try {
+                publisher.start();
+            }
+            catch (cause) {
+                try {
+                    endpoint.stop();
+                }
+                catch {
+                    // Best effort rollback.
+                }
+                throw cause;
+            }
+        }
+        function stop() {
+            let firstError;
+            try {
+                publisher.stop();
+            }
+            catch (cause) {
+                firstError ??= cause;
+            }
+            try {
+                endpoint.stop();
+            }
+            catch (cause) {
+                firstError ??= cause;
+            }
+            if (firstError !== undefined) {
+                throw firstError;
+            }
+        }
+        function dispose() {
+            let firstError;
+            try {
+                publisher.dispose();
+            }
+            catch (cause) {
+                firstError ??= cause;
+            }
+            try {
+                endpoint.dispose();
+            }
+            catch (cause) {
+                firstError ??= cause;
+            }
+            if (firstError !== undefined) {
+                throw firstError;
+            }
+        }
+        function isRunning() {
+            return endpoint.isRunning() && publisher.isRunning();
+        }
+        function publish(event, payload) {
+            return publisher.publish(event, payload);
+        }
+        return {
+            endpoint,
+            publisher,
+            start,
+            stop,
+            dispose,
+            isRunning,
+            publish,
+            stats: publisher.stats,
+        };
+    };
+    const preload = (preloadOptions) => {
+        const global = preloadOptions?.global ?? bridgeGlobal;
+        const bridge = createBridgeAdapters({
+            channelPrefix,
+        });
+        return {
+            global,
+            bridge,
+            expose: () => {
+                exposeIpcBridge({
+                    global,
+                    channelPrefix,
+                });
+            },
+        };
+    };
+    const renderer = (bridge) => {
+        return {
+            client: createRpcClient(contract, {
+                invoke: bridge.invoke,
+                rpcDecodeMode,
+            }),
+            events: createEventSubscriber(contract, {
+                subscribe: bridge.subscribe,
+                decodeMode: eventDecodeMode,
+            }),
+        };
+    };
+    return {
+        contract,
+        config: {
+            channelPrefix,
+            bridgeGlobal,
+            rpcDecodeMode,
+            eventDecodeMode,
+        },
+        main,
+        preload,
+        renderer,
+    };
+}

package/dist/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EAKZ,MAAM,eAAe,CAAC;AAQvB,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,SAAS,EAEd,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAmBpB,wBAAgB,iBAAiB,CAC/B,KAAK,CAAC,OAAO,SAAS,aAAa,CAAC,SAAS,CAAC,EAC9C,KAAK,CAAC,MAAM,SAAS,aAAa,CAAC,QAAQ,CAAC,EAC5C,CAAC,GAAG,KAAK,EAET,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EACtC,GAAG,EAAE,WAAW,EAChB,eAAe,EAAE,eAAe,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,EACjE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,WAAW,CA4Kb;AAmBD,wBAAgB,oBAAoB,CAClC,KAAK,CAAC,OAAO,SAAS,aAAa,CAAC,SAAS,CAAC,EAC9C,KAAK,CAAC,MAAM,SAAS,aAAa,CAAC,QAAQ,CAAC,EAE5C,SAAS,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EACvC,OAAO,EAAE,qBAAqB,GAC7B,iBAAiB,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CA8KjD"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EAKZ,MAAM,eAAe,CAAC;AAQvB,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,SAAS,EAEd,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAmBpB,wBAAgB,iBAAiB,CAC/B,KAAK,CAAC,OAAO,SAAS,aAAa,CAAC,SAAS,CAAC,EAC9C,KAAK,CAAC,MAAM,SAAS,aAAa,CAAC,QAAQ,CAAC,EAC5C,CAAC,GAAG,KAAK,EAET,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EACtC,GAAG,EAAE,WAAW,EAChB,eAAe,EAAE,eAAe,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,EACjE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,WAAW,CAgNb;AAmBD,wBAAgB,oBAAoB,CAClC,KAAK,CAAC,OAAO,SAAS,aAAa,CAAC,SAAS,CAAC,EAC9C,KAAK,CAAC,MAAM,SAAS,aAAa,CAAC,QAAQ,CAAC,EAE5C,SAAS,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EACvC,OAAO,EAAE,qBAAqB,GAC7B,iBAAiB,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAkMjD"}

package/dist/main.js

@@ -109,8 +109,23 @@ export function createRpcEndpoint(contract, ipc, implementations, options) {
         if (running) {
             return;
         }
-        for (const [channel, listener] of listeners) {
-            ipc.handle(channel, listener);
+        const registeredChannels = [];
+        try {
+            for (const [channel, listener] of listeners) {
+                ipc.handle(channel, listener);
+                registeredChannels.push(channel);
+            }
+        }
+        catch (cause) {
+            for (const channel of registeredChannels) {
+                try {
+                    ipc.removeHandler(channel);
+                }
+                catch {
+                    // Best-effort rollback: avoid leaving partial registration behind.
+                }
+            }
+            throw cause;
         }
         running = true;
     }
@@ -118,17 +133,35 @@ export function createRpcEndpoint(contract, ipc, implementations, options) {
         if (!running) {
             return;
         }
+        let firstError;
         for (const channel of listeners.keys()) {
-            ipc.removeHandler(channel);
+            try {
+                ipc.removeHandler(channel);
+            }
+            catch (cause) {
+                firstError ??= cause;
+            }
         }
         running = false;
+        if (firstError !== undefined) {
+            throw firstError;
+        }
     }
     function dispose() {
         if (disposed) {
             return;
         }
-        stop();
+        let stopError;
+        try {
+            stop();
+        }
+        catch (cause) {
+            stopError = cause;
+        }
         disposed = true;
+        if (stopError !== undefined) {
+            throw stopError;
+        }
     }
     function isRunning() {
         return running;
@@ -193,17 +226,33 @@ export function createEventPublisher(_contract, options) {
         }
         const window = options.getWindow();
         if (!window || window.isDestroyed()) {
+            dropped += 1;
+            safelyCall(diagnostics?.onDroppedEvent, {
+                event: item.event.name,
+                payload: item.payload,
+                reason: "window_unavailable",
+                queued: queue.length,
+                dropped,
+            });
             return;
         }
         try {
             window.webContents.send(`${channelPrefix.event}${item.event.name}`, encoded);
         }
         catch (cause) {
+            dropped += 1;
             safelyCall(diagnostics?.onDispatchFailure, {
                 event: item.event.name,
                 payload: item.payload,
                 cause,
             });
+            safelyCall(diagnostics?.onDroppedEvent, {
+                event: item.event.name,
+                payload: item.payload,
+                reason: "dispatch_failed",
+                queued: queue.length,
+                dropped,
+            });
         }
     }
     function drain() {

package/dist/preload.d.ts

@@ -10,6 +10,10 @@ export type BridgeExposureOptions = BridgeAdaptersOptions & {
     readonly rpcGlobal?: string;
     readonly eventsGlobal?: string;
 };
+export type IpcBridgeExposureOptions = BridgeAdaptersOptions & {
+    readonly global?: string;
+};
 export declare function createBridgeAdapters(options?: BridgeAdaptersOptions): BridgeAdapters;
 export declare function exposeRpcBridge(options?: BridgeExposureOptions): void;
+export declare function exposeIpcBridge(options?: IpcBridgeExposureOptions): void;
 //# sourceMappingURL=preload.d.ts.map

package/dist/preload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preload.d.ts","sourceRoot":"","sources":["../src/preload.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,qBAAqB,GAAG;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,cAAc,CAsBhB;AAED,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAerE"}
+{"version":3,"file":"preload.d.ts","sourceRoot":"","sources":["../src/preload.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,qBAAqB,GAAG;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,qBAAqB,GAAG;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAwCF,wBAAgB,oBAAoB,CAClC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,cAAc,CAuBhB;AAED,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAgBrE;AAED,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAYxE"}

package/dist/preload.js

@@ -1,7 +1,20 @@
-import { contextBridge, ipcRenderer } from "electron";
+import * as electronModule from "electron";
 import { defaultChannelPrefix, } from "./types.js";
+function resolveElectronRendererBindings() {
+    const moduleDefault = electronModule.default;
+    const source = moduleDefault && typeof moduleDefault === "object"
+        ? moduleDefault
+        : electronModule;
+    const contextBridge = source.contextBridge;
+    const ipcRenderer = source.ipcRenderer;
+    if (!contextBridge || !ipcRenderer) {
+        throw new Error("electron-effect-rpc/preload requires Electron preload runtime bindings.");
+    }
+    return { contextBridge, ipcRenderer };
+}
 export function createBridgeAdapters(options) {
     const channelPrefix = options?.channelPrefix ?? defaultChannelPrefix;
+    const { ipcRenderer } = resolveElectronRendererBindings();
     const invoke = (method, payload) => ipcRenderer.invoke(`${channelPrefix.rpc}${method}`, payload);
     const subscribe = (event, listener) => {
         const wrapped = (_event, payload) => listener(payload);
@@ -19,6 +32,7 @@ export function createBridgeAdapters(options) {
 export function exposeRpcBridge(options) {
     const rpcGlobal = options?.rpcGlobal ?? "rpc";
     const eventsGlobal = options?.eventsGlobal ?? "events";
+    const { contextBridge } = resolveElectronRendererBindings();
     const adapters = createBridgeAdapters({
         channelPrefix: options?.channelPrefix,
     });
@@ -29,3 +43,14 @@ export function exposeRpcBridge(options) {
         subscribe: adapters.subscribe,
     });
 }
+export function exposeIpcBridge(options) {
+    const global = options?.global ?? "api";
+    const { contextBridge } = resolveElectronRendererBindings();
+    const adapters = createBridgeAdapters({
+        channelPrefix: options?.channelPrefix,
+    });
+    contextBridge.exposeInMainWorld(global, {
+        invoke: adapters.invoke,
+        subscribe: adapters.subscribe,
+    });
+}

package/dist/renderer.d.ts

@@ -1,6 +1,6 @@
 import { type RpcContract } from "./contract.ts";
 import { type AnyEvent, type AnyMethod, type EventSubscriber, type EventSubscriberOptions, type RpcClient, type RpcClientOptions } from "./types.ts";
-export declare function createRpcClient<const Methods extends ReadonlyArray<AnyMethod>, const Events extends ReadonlyArray<AnyEvent>>(contract: RpcContract<Methods, Events>, options?: RpcClientOptions): RpcClient<RpcContract<Methods, Events>>;
-export declare function createEventSubscriber<const Methods extends ReadonlyArray<AnyMethod>, const Events extends ReadonlyArray<AnyEvent>>(contract: RpcContract<Methods, Events>, options?: EventSubscriberOptions): EventSubscriber<RpcContract<Methods, Events>>;
+export declare function createRpcClient<const Methods extends ReadonlyArray<AnyMethod>, const Events extends ReadonlyArray<AnyEvent>>(contract: RpcContract<Methods, Events>, options: RpcClientOptions): RpcClient<RpcContract<Methods, Events>>;
+export declare function createEventSubscriber<const Methods extends ReadonlyArray<AnyMethod>, const Events extends ReadonlyArray<AnyEvent>>(contract: RpcContract<Methods, Events>, options: EventSubscriberOptions): EventSubscriber<RpcContract<Methods, Events>>;
 export { RpcDefectError } from "./types.ts";
 //# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,WAAW,EAIjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,SAAS,EAGd,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAE3B,KAAK,SAAS,EACd,KAAK,gBAAgB,EAEtB,MAAM,YAAY,CAAC;AAuDpB,wBAAgB,eAAe,CAC7B,KAAK,CAAC,OAAO,SAAS,aAAa,CAAC,SAAS,CAAC,EAC9C,KAAK,CAAC,MAAM,SAAS,aAAa,CAAC,QAAQ,CAAC,EAE5C,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EACtC,OAAO,CAAC,EAAE,gBAAgB,GACzB,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAqHzC;AAqBD,wBAAgB,qBAAqB,CACnC,KAAK,CAAC,OAAO,SAAS,aAAa,CAAC,SAAS,CAAC,EAC9C,KAAK,CAAC,MAAM,SAAS,aAAa,CAAC,QAAQ,CAAC,EAE5C,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EACtC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,eAAe,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CA+E/C;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,WAAW,EAIjB,MAAM,eAAe,CAAC;AAOvB,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,SAAS,EAGd,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAE3B,KAAK,SAAS,EACd,KAAK,gBAAgB,EAGtB,MAAM,YAAY,CAAC;AAuEpB,wBAAgB,eAAe,CAC7B,KAAK,CAAC,OAAO,SAAS,aAAa,CAAC,SAAS,CAAC,EAC9C,KAAK,CAAC,MAAM,SAAS,aAAa,CAAC,QAAQ,CAAC,EAE5C,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EACtC,OAAO,EAAE,gBAAgB,GACxB,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CA0KzC;AAqBD,wBAAgB,qBAAqB,CACnC,KAAK,CAAC,OAAO,SAAS,aAAa,CAAC,SAAS,CAAC,EAC9C,KAAK,CAAC,MAAM,SAAS,aAAa,CAAC,QAAQ,CAAC,EAE5C,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EACtC,OAAO,EAAE,sBAAsB,GAC9B,eAAe,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAyF/C;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/renderer.js

@@ -1,7 +1,7 @@
 import * as S from "@effect/schema/Schema";
-import { Cause, Exit } from "effect";
+import { Cause, Effect, Exit } from "effect";
 import { exitSchemaFor, isNoErrorSchema, } from "./contract.js";
-import { formatUnknown, parseRpcResponseEnvelope, safelyCall } from "./protocol.js";
+import { formatUnknown, parseRpcResponseEnvelope, safelyCall, } from "./protocol.js";
 import { RpcDefectError, } from "./types.js";
 function requireInvoke(options) {
     if (!options?.invoke) {
@@ -15,110 +15,124 @@ function requireSubscribe(options) {
     }
     return options.subscribe;
 }
+function rpcDefect(code, message, cause) {
+    return new RpcDefectError(code, message, cause);
+}
 function decodeLegacyExit(method, raw) {
-    const exitSchema = exitSchemaFor(method);
-    const decodeExit = S.decodeUnknownSync(exitSchema);
-    const exit = decodeExit(raw);
-    if (Exit.isSuccess(exit)) {
-        return exit.value;
-    }
-    const failureOption = Cause.failureOption(exit.cause);
-    if (failureOption._tag === "Some") {
-        throw failureOption.value;
-    }
-    const defectOption = Cause.dieOption(exit.cause);
-    if (defectOption._tag === "Some") {
-        const defect = defectOption.value;
-        if (defect instanceof Error) {
-            throw new RpcDefectError(defect.message, defect);
+    return Effect.try({
+        try: () => S.decodeUnknownSync(exitSchemaFor(method))(raw),
+        catch: (cause) => rpcDefect("legacy_decode_failed", `RPC ${method.name} legacy response decoding failed: ${formatUnknown(cause)}`, cause),
+    }).pipe(Effect.flatMap((exit) => {
+        if (Exit.isSuccess(exit)) {
+            return Effect.succeed(exit.value);
         }
-        throw new RpcDefectError(String(defect), defect);
-    }
-    throw new RpcDefectError("RPC call was interrupted or failed unexpectedly", exit.cause);
+        const failureOption = Cause.failureOption(exit.cause);
+        if (failureOption._tag === "Some") {
+            return Effect.fail(failureOption.value);
+        }
+        const defectOption = Cause.dieOption(exit.cause);
+        if (defectOption._tag === "Some") {
+            const defect = defectOption.value;
+            const message = defect instanceof Error ? defect.message : String(defect);
+            return Effect.fail(rpcDefect("remote_defect", message, defect));
+        }
+        return Effect.fail(rpcDefect("remote_defect", "RPC call was interrupted or failed unexpectedly", exit.cause));
+    }));
 }
 export function createRpcClient(contract, options) {
     const invoke = requireInvoke(options);
     const diagnostics = options?.diagnostics;
     const decodeMode = options?.rpcDecodeMode ?? "envelope";
-    const call = async (method, input) => {
-        let encoded;
-        try {
-            encoded = S.encodeSync(method.req)(input);
-        }
-        catch (cause) {
-            safelyCall(diagnostics?.onDecodeFailure, {
-                scope: "rpc-request",
-                name: method.name,
-                payload: input,
-                cause,
-            });
-            throw new Error(`RPC ${method.name} request encoding failed: ${formatUnknown(cause)}`);
-        }
-        const raw = await invoke(method.name, encoded);
-        const envelope = parseRpcResponseEnvelope(raw);
-        if (envelope) {
-            switch (envelope.type) {
-                case "success":
-                    try {
-                        return S.decodeUnknownSync(method.res)(envelope.data);
-                    }
-                    catch (cause) {
+    const decodeEnvelope = (method, envelope) => {
+        switch (envelope.type) {
+            case "success":
+                return Effect.try({
+                    try: () => S.decodeUnknownSync(method.res)(envelope.data),
+                    catch: (cause) => {
                         safelyCall(diagnostics?.onDecodeFailure, {
                             scope: "rpc-response",
                             name: method.name,
                             payload: envelope.data,
                             cause,
                         });
-                        throw new Error(`RPC ${method.name} success payload decoding failed: ${formatUnknown(cause)}`);
-                    }
-                case "failure":
-                    if (isNoErrorSchema(method.err)) {
-                        throw new RpcDefectError(`RPC ${method.name} received a failure for a method that declares NoError`, envelope.error);
-                    }
-                    let decodedError;
-                    try {
-                        decodedError = S.decodeUnknownSync(method.err)(envelope.error.data);
-                    }
-                    catch (cause) {
+                        return rpcDefect("success_payload_decoding_failed", `RPC ${method.name} success payload decoding failed: ${formatUnknown(cause)}`, cause);
+                    },
+                });
+            case "failure":
+                if (isNoErrorSchema(method.err)) {
+                    return Effect.fail(rpcDefect("noerror_contract_violation", `RPC ${method.name} received a failure for a method that declares NoError`, envelope.error));
+                }
+                const errorSchema = method.err;
+                return Effect.try({
+                    try: () => S.decodeUnknownSync(errorSchema)(envelope.error.data),
+                    catch: (cause) => {
                         safelyCall(diagnostics?.onDecodeFailure, {
                             scope: "rpc-response",
                             name: method.name,
                             payload: envelope.error,
                             cause,
                         });
-                        throw new Error(`RPC ${method.name} failure payload decoding failed: ${formatUnknown(cause)}`);
-                    }
-                    throw decodedError;
-                case "defect":
-                    throw new RpcDefectError(envelope.message, envelope.cause);
-            }
+                        return rpcDefect("failure_payload_decoding_failed", `RPC ${method.name} failure payload decoding failed: ${formatUnknown(cause)}`, cause);
+                    },
+                }).pipe(Effect.flatMap((decodedError) => Effect.fail(decodedError)));
+            case "defect":
+                return Effect.fail(rpcDefect("remote_defect", envelope.message, envelope.cause));
+        }
+    };
+    const call = (method, input) => Effect.try({
+        try: () => S.encodeSync(method.req)(input),
+        catch: (cause) => {
+            safelyCall(diagnostics?.onDecodeFailure, {
+                scope: "rpc-request",
+                name: method.name,
+                payload: input,
+                cause,
+            });
+            return rpcDefect("request_encoding_failed", `RPC ${method.name} request encoding failed: ${formatUnknown(cause)}`, cause);
+        },
+    }).pipe(Effect.flatMap((encoded) => Effect.tryPromise({
+        try: () => invoke(method.name, encoded),
+        catch: (cause) => {
+            safelyCall(diagnostics?.onProtocolError, {
+                method: method.name,
+                response: undefined,
+                cause,
+            });
+            return rpcDefect("invoke_failed", `RPC ${method.name} invoke failed: ${formatUnknown(cause)}`, cause);
+        },
+    })), Effect.flatMap((raw) => {
+        const envelope = parseRpcResponseEnvelope(raw);
+        if (envelope) {
+            return decodeEnvelope(method, envelope);
         }
         if (decodeMode === "dual") {
-            try {
-                return decodeLegacyExit(method, raw);
-            }
-            catch (cause) {
-                safelyCall(diagnostics?.onProtocolError, {
-                    method: method.name,
-                    response: raw,
-                    cause,
-                });
-                throw cause;
-            }
+            return decodeLegacyExit(method, raw).pipe(Effect.tapError((cause) => {
+                if (cause instanceof RpcDefectError &&
+                    cause.code === "legacy_decode_failed") {
+                    return Effect.sync(() => safelyCall(diagnostics?.onProtocolError, {
+                        method: method.name,
+                        response: raw,
+                        cause,
+                    }));
+                }
+                return Effect.void;
+            }));
         }
-        const cause = new Error(`RPC ${method.name} response was not a valid envelope.`);
+        const cause = rpcDefect("invalid_response_envelope", `RPC ${method.name} response was not a valid envelope.`, raw);
         safelyCall(diagnostics?.onProtocolError, {
             method: method.name,
             response: raw,
             cause,
         });
-        throw cause;
-    };
+        return Effect.fail(cause);
+    }));
     const client = Object.create(null);
     const clientRecord = client;
     for (const method of contract.methods) {
-        const caller = (input) => {
-            const payload = input ?? S.decodeUnknownSync(method.req)({});
+        const caller = (...args) => {
+            const payload = args.length === 0
+                ? {}
+                : args[0];
             return call(method, payload);
         };
         clientRecord[method.name] = caller;
@@ -187,10 +201,19 @@ export function createEventSubscriber(contract, options) {
         return registerUnsubscribe(unsubscribe);
     };
     function dispose() {
+        let firstError;
         for (const unsubscribe of subscriptions) {
-            unsubscribe();
+            try {
+                unsubscribe();
+            }
+            catch (cause) {
+                firstError ??= cause;
+            }
         }
         subscriptions.clear();
+        if (firstError !== undefined) {
+            throw firstError;
+        }
     }
     return {
         subscribe: subscribeEvent,

package/dist/types.d.ts

@@ -5,16 +5,19 @@ export type { AnyEvent, AnyMethod, ErrorSchema, ExtractMethod, RpcContract, RpcE
 export type Implementations<C extends RpcContract<readonly AnyMethod[], readonly AnyEvent[]>, R = never> = {
     readonly [Name in C["methods"][number]["name"]]: (input: RpcInput<ExtractMethod<C["methods"], Name>>) => Effect.Effect<RpcOutput<ExtractMethod<C["methods"], Name>>, RpcError<ExtractMethod<C["methods"], Name>>, R>;
 };
-type IsEmptyObject<T> = keyof T extends never ? true : false;
-export type RpcCaller<M extends AnyMethod> = IsEmptyObject<RpcInput<M>> extends true ? () => Promise<RpcOutput<M>> : (input: RpcInput<M>) => Promise<RpcOutput<M>>;
-export type RpcClient<C extends RpcContract<readonly AnyMethod[], readonly AnyEvent[]>> = {
-    readonly [Name in C["methods"][number]["name"]]: RpcCaller<ExtractMethod<C["methods"], Name>>;
-};
+type IsEmptyObject<T> = T extends object ? keyof T extends never ? true : false : false;
+export type RpcDefectCode = "request_encoding_failed" | "invoke_failed" | "success_payload_decoding_failed" | "failure_payload_decoding_failed" | "noerror_contract_violation" | "invalid_response_envelope" | "legacy_decode_failed" | "remote_defect";
 export declare class RpcDefectError extends Error {
+    readonly code: RpcDefectCode;
     readonly cause: unknown;
     readonly _tag = "RpcDefectError";
-    constructor(message: string, cause: unknown);
+    constructor(code: RpcDefectCode, message: string, cause: unknown);
 }
+export type RpcMethodError<M extends AnyMethod> = RpcError<M> | RpcDefectError;
+export type RpcCaller<M extends AnyMethod> = IsEmptyObject<RpcInput<M>> extends true ? () => Effect.Effect<RpcOutput<M>, RpcMethodError<M>> : (input: RpcInput<M>) => Effect.Effect<RpcOutput<M>, RpcMethodError<M>>;
+export type RpcClient<C extends RpcContract<readonly AnyMethod[], readonly AnyEvent[]>> = {
+    readonly [Name in C["methods"][number]["name"]]: RpcCaller<ExtractMethod<C["methods"], Name>>;
+};
 export type ChannelPrefix = {
     readonly rpc: string;
     readonly event: string;
@@ -37,7 +40,7 @@ export type DispatchFailureContext = {
     readonly payload: unknown;
     readonly cause: unknown;
 };
-export type DroppedEventReason = "queue_full" | "encoding_failed";
+export type DroppedEventReason = "queue_full" | "encoding_failed" | "window_unavailable" | "dispatch_failed";
 export type DroppedEventContext = {
     readonly event: string;
     readonly payload: unknown;
@@ -52,7 +55,7 @@ export type RpcClientDiagnostics = {
     readonly onProtocolError?: (context: ProtocolErrorContext) => void;
 };
 export type RpcClientOptions = {
-    readonly invoke?: RpcInvoke;
+    readonly invoke: RpcInvoke;
     readonly diagnostics?: RpcClientDiagnostics;
     readonly rpcDecodeMode?: RpcResponseDecodeMode;
 };
@@ -112,7 +115,7 @@ export type EventSubscriberDiagnostics = {
     readonly onDecodeFailure?: (context: DecodeFailureContext) => void;
 };
 export type EventSubscriberOptions = {
-    readonly subscribe?: EventSubscribe;
+    readonly subscribe: EventSubscribe;
     readonly decodeMode?: EventDecodeMode;
     readonly diagnostics?: EventSubscriberDiagnostics;
 };
@@ -121,4 +124,5 @@ export interface EventSubscriber<C extends RpcContract<readonly AnyMethod[], rea
     readonly subscribeByName: (name: string, handler: (payload: unknown) => void) => () => void;
     readonly dispose: () => void;
 }
+export type { IpcBridge, IpcBridgeGlobal, IpcKit, IpcKitOptions, IpcMainHandle, } from "./kit.ts";
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,6 +1,7 @@
 export class RpcDefectError extends Error {
-    constructor(message, cause) {
+    constructor(code, message, cause) {
         super(message);
+        this.code = code;
         this.cause = cause;
         this._tag = "RpcDefectError";
         this.name = "RpcDefectError";

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "electron-effect-rpc",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Typed IPC RPC for Electron, built on Effect and @effect/schema",
   "type": "module",
   "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
     "./main": {
       "types": "./dist/main.d.ts",
       "default": "./dist/main.js"
@@ -35,6 +39,12 @@
   "scripts": {
     "build": "tsc",
     "prepublishOnly": "bun run build",
+    "test:unit": "bun test",
+    "test:types": "bun run typecheck && bunx tsc -p tsconfig.type-tests.json --noEmit",
+    "test:packaging": "bash ./scripts/run-packaging-checks.sh",
+    "test:integration": "bun test __tests__/integration.test.ts",
+    "test:stress": "bun test __tests__/stress.test.ts",
+    "test:full": "bun run test:unit && bun run test:types && bun run test:packaging && bun run test:integration && bun run test:stress",
     "test": "bun test",
     "typecheck": "tsc --noEmit"
   },