electron-effect-rpc 0.9.0 → 0.11.0

package/dist/main.js

@@ -1,34 +1,35 @@
 import * as S from "effect/Schema";
-import { Cause, Effect, Exit, FiberId, Stream } from "effect";
-import * as Runtime from "effect/Runtime";
+import { Cause, Effect, Exit, Fiber, Result, Stream } from "effect";
+import { isFunctionValue, isNumberValue, isRecord, isStringValue, toDiagnosticCause, } from "./boundary.js";
 import { isNoErrorSchema } from "./contract.js";
-import { extractErrorTag, formatUnknown, isRecord, safelyCall, toDefectEnvelope, } from "./protocol.js";
+import { extractErrorTag, formatUnknown, safelyCall, toDefectEnvelope, } from "./protocol.js";
 import { assertValidChannelPrefix, defaultChannelPrefix, } from "./types.js";
+function readNamed(record, key) {
+    return record[key];
+}
 function resolveChannelPrefix(prefix) {
     return prefix ? assertValidChannelPrefix(prefix) : defaultChannelPrefix;
 }
 function isWebContentsLike(value) {
-    if (!isRecord(value))
-        return false;
-    return (typeof value.id === "number" &&
-        typeof value.isDestroyed === "function" &&
-        typeof value.send === "function");
+    return (isRecord(value) &&
+        isNumberValue(value.id) &&
+        isFunctionValue(value.isDestroyed) &&
+        isFunctionValue(value.send) &&
+        (value.once === undefined || isFunctionValue(value.once)) &&
+        (value.removeListener === undefined || isFunctionValue(value.removeListener)));
+}
+function parseWebContentsLike(value) {
+    return isWebContentsLike(value) ? value : null;
 }
 function extractSender(event) {
     if (!isRecord(event))
         return null;
-    return isWebContentsLike(event.sender) ? event.sender : null;
-}
-function isImplementation(value) {
-    return typeof value === "function";
-}
-function isStreamImplementation(value) {
-    return typeof value === "function";
+    return parseWebContentsLike(event.sender);
 }
 export function createRpcEndpoint(contract, ipc, implementations, options) {
     const channelPrefix = resolveChannelPrefix(options.channelPrefix);
     const diagnostics = options.diagnostics;
-    const runPromiseExit = Runtime.runPromiseExit(options.runtime);
+    const runPromiseExit = Effect.runPromiseExitWith(options.context);
     const implementationsByName = implementations;
     const methodNames = new Set(contract.methods.map((method) => method.name));
     for (const name in implementations) {
@@ -39,14 +40,14 @@ export function createRpcEndpoint(contract, ipc, implementations, options) {
     function reportProtocolError(method, response, cause) {
         safelyCall(diagnostics?.onProtocolError, {
             method,
-            response,
-            cause,
+            response: toDiagnosticCause(response),
+            cause: toDiagnosticCause(cause),
         });
     }
     const listeners = new Map();
     for (const method of contract.methods) {
-        const impl = implementationsByName[method.name];
-        if (!isImplementation(impl)) {
+        const impl = readNamed(implementationsByName, method.name);
+        if (!isFunctionValue(impl)) {
             throw new Error(`Missing implementation for RPC method: ${method.name}`);
         }
         const decodeInput = S.decodeUnknownSync(method.req);
@@ -63,7 +64,7 @@ export function createRpcEndpoint(contract, ipc, implementations, options) {
                     scope: "rpc-request",
                     name: method.name,
                     payload: rawPayload,
-                    cause,
+                    cause: toDiagnosticCause(cause),
                 });
                 return toDefectEnvelope(cause, `RPC ${method.name} request decode failed`);
             }
@@ -87,7 +88,7 @@ export function createRpcEndpoint(contract, ipc, implementations, options) {
                     return toDefectEnvelope(cause, `RPC ${method.name} success encoding failed`);
                 }
             }
-            const failure = Cause.failureOption(exit.cause);
+            const failure = Cause.findErrorOption(exit.cause);
             if (failure._tag === "Some") {
                 if (!encodeFailure) {
                     return toDefectEnvelope(failure.value, `RPC ${method.name} returned a typed failure, but method declares NoError`);
@@ -106,9 +107,9 @@ export function createRpcEndpoint(contract, ipc, implementations, options) {
                     return toDefectEnvelope(cause, `RPC ${method.name} failure encoding failed`);
                 }
             }
-            const defect = Cause.dieOption(exit.cause);
-            if (defect._tag === "Some") {
-                return toDefectEnvelope(defect.value, `RPC ${method.name} defect`);
+            const defect = Cause.findDefect(exit.cause);
+            if (Result.isSuccess(defect)) {
+                return toDefectEnvelope(defect.success, `RPC ${method.name} defect`);
             }
             return toDefectEnvelope(exit.cause, `RPC ${method.name} interrupted`);
         });
@@ -133,10 +134,10 @@ export function createRpcEndpoint(contract, ipc, implementations, options) {
                 throw new Error(`Stream implementation provided for unknown stream method: ${name}`);
             }
         }
-        const runFork = Runtime.runFork(options.runtime);
+        const runFork = Effect.runForkWith(options.context);
         for (const method of streamMethods) {
-            const impl = streamHandlerImpls[method.name];
-            if (!isStreamImplementation(impl)) {
+            const impl = readNamed(streamHandlerImpls, method.name);
+            if (!isFunctionValue(impl)) {
                 throw new Error(`Missing implementation for stream method: ${method.name}`);
             }
             const decodeInput = S.decodeUnknownSync(method.req);
@@ -149,7 +150,7 @@ export function createRpcEndpoint(contract, ipc, implementations, options) {
                 }
                 const streamId = rawPayload.streamId;
                 const rawData = rawPayload.data;
-                if (typeof streamId !== "string" || streamId.length === 0) {
+                if (!isStringValue(streamId) || streamId.length === 0) {
                     return toDefectEnvelope("Invalid streamId");
                 }
                 if (activeStreams.has(streamId)) {
@@ -167,8 +168,8 @@ export function createRpcEndpoint(contract, ipc, implementations, options) {
                     const decodeCtx = {
                         scope: "stream-request",
                         name: method.name,
-                        payload: rawData,
-                        cause,
+                        payload: toDiagnosticCause(rawData),
+                        cause: toDiagnosticCause(cause),
                     };
                     safelyCall(diagnostics?.onDecodeFailure, decodeCtx);
                     return toDefectEnvelope(cause, `Stream ${method.name} request decode failed`);
@@ -180,8 +181,8 @@ export function createRpcEndpoint(contract, ipc, implementations, options) {
                             sender.send(sfChannel, frame);
                         }
                     },
-                    catch: () => undefined,
-                }).pipe(Effect.ignore);
+                    catch: toDiagnosticCause,
+                }).pipe(Effect.tapError((cause) => Effect.sync(() => reportProtocolError(method.name, frame, cause))), Effect.ignore);
                 let handlerStream;
                 try {
                     handlerStream = impl(input, { sender });
@@ -190,7 +191,7 @@ export function createRpcEndpoint(contract, ipc, implementations, options) {
                     return toDefectEnvelope(cause, `Stream ${method.name} implementation threw`);
                 }
                 const buildTerminalFrame = (cause) => {
-                    const failure = Cause.failureOption(cause);
+                    const failure = Cause.findErrorOption(cause);
                     if (failure._tag === "Some") {
                         if (encodeFailure) {
                             try {
@@ -217,14 +218,16 @@ export function createRpcEndpoint(contract, ipc, implementations, options) {
                             message: `Stream ${method.name} returned a typed failure, but method declares NoError: ${formatUnknown(failure.value)}`,
                         };
                     }
-                    if (Cause.isInterruptedOnly(cause)) {
+                    if (Cause.hasInterruptsOnly(cause)) {
                         return { type: "end", streamId };
                     }
-                    const defect = Cause.dieOption(cause);
+                    const defect = Cause.findDefect(cause);
                     return {
                         type: "defect",
                         streamId,
-                        message: defect._tag === "Some" ? formatUnknown(defect.value) : "Stream failed unexpectedly",
+                        message: Result.isSuccess(defect)
+                            ? formatUnknown(defect.success)
+                            : "Stream failed unexpectedly",
                     };
                 };
                 // Reserve entry BEFORE forking
@@ -233,7 +236,7 @@ export function createRpcEndpoint(contract, ipc, implementations, options) {
                     senderId: sender.id,
                 };
                 const onSenderDestroyed = () => {
-                    entry.fiber?.unsafeInterruptAsFork(FiberId.none);
+                    entry.fiber?.interruptUnsafe();
                 };
                 const streamEffect = handlerStream.pipe(Stream.mapEffect((chunk) => Effect.suspend(() => {
                     // A destroyed renderer can never consume more chunks:
@@ -241,18 +244,17 @@ export function createRpcEndpoint(contract, ipc, implementations, options) {
                     if (sender.isDestroyed()) {
                         return Effect.interrupt;
                     }
-                    return Effect.try({
-                        try: () => sender.send(sfChannel, { type: "data", streamId, payload: encodeChunk(chunk) }),
-                        catch: () => undefined,
-                    }).pipe(Effect.ignore);
-                })), Stream.runDrain, Effect.andThen(() => trySend({ type: "end", streamId })), Effect.catchAllCause((cause) => sender.isDestroyed() ? Effect.void : trySend(buildTerminalFrame(cause))), Effect.ensuring(Effect.sync(() => {
+                    // A lost chunk invalidates the stream. Let the transport boundary
+                    // send a defect frame instead of reporting successful completion.
+                    return Effect.sync(() => sender.send(sfChannel, { type: "data", streamId, payload: encodeChunk(chunk) }));
+                })), Stream.runDrain, Effect.andThen(() => trySend({ type: "end", streamId })), Effect.catchCause((cause) => sender.isDestroyed() ? Effect.void : trySend(buildTerminalFrame(cause))), Effect.ensuring(Effect.sync(() => {
                     activeStreams.delete(streamId);
-                    if (typeof sender.removeListener === "function") {
+                    if (sender.removeListener) {
                         sender.removeListener("destroyed", onSenderDestroyed);
                     }
                 })));
                 activeStreams.set(streamId, entry);
-                if (typeof sender.once === "function") {
+                if (sender.once) {
                     sender.once("destroyed", onSenderDestroyed);
                 }
                 let fiber;
@@ -261,7 +263,7 @@ export function createRpcEndpoint(contract, ipc, implementations, options) {
                 }
                 catch (cause) {
                     activeStreams.delete(streamId);
-                    if (typeof sender.removeListener === "function") {
+                    if (sender.removeListener) {
                         sender.removeListener("destroyed", onSenderDestroyed);
                     }
                     return toDefectEnvelope(cause, `Stream ${method.name} failed to start`);
@@ -302,7 +304,7 @@ export function createRpcEndpoint(contract, ipc, implementations, options) {
                         return { cancelled: false };
                     }
                     const streamId = rawPayload.streamId;
-                    if (typeof streamId !== "string")
+                    if (!isStringValue(streamId))
                         return { cancelled: false };
                     const entry = activeStreams.get(streamId);
                     if (!entry)
@@ -313,7 +315,7 @@ export function createRpcEndpoint(contract, ipc, implementations, options) {
                         return { cancelled: false };
                     // Interrupt the fiber
                     if (entry.fiber) {
-                        entry.fiber.unsafeInterruptAsFork(FiberId.none);
+                        entry.fiber.interruptUnsafe();
                     }
                     return { cancelled: true };
                 });
@@ -340,7 +342,7 @@ export function createRpcEndpoint(contract, ipc, implementations, options) {
         // Interrupt all active stream fibers first
         for (const entry of activeStreams.values()) {
             if (entry.fiber) {
-                entry.fiber.unsafeInterruptAsFork(FiberId.none);
+                entry.fiber.interruptUnsafe();
             }
         }
         activeStreams.clear();
@@ -439,12 +441,12 @@ export function createEventPublisher(_contract, options) {
             safelyCall(diagnostics?.onDecodeFailure, {
                 scope: "event-payload",
                 name: item.event.name,
-                payload: item.payload,
-                cause,
+                payload: toDiagnosticCause(item.payload),
+                cause: toDiagnosticCause(cause),
             });
             safelyCall(diagnostics?.onDroppedEvent, {
                 event: item.event.name,
-                payload: item.payload,
+                payload: toDiagnosticCause(item.payload),
                 reason: "encoding_failed",
                 queued: queue.length,
                 dropped,
@@ -456,7 +458,7 @@ export function createEventPublisher(_contract, options) {
             dropped += 1;
             safelyCall(diagnostics?.onDroppedEvent, {
                 event: item.event.name,
-                payload: item.payload,
+                payload: toDiagnosticCause(item.payload),
                 reason: "window_unavailable",
                 queued: queue.length,
                 dropped,
@@ -469,7 +471,7 @@ export function createEventPublisher(_contract, options) {
                 dropped += 1;
                 safelyCall(diagnostics?.onDroppedEvent, {
                     event: item.event.name,
-                    payload: item.payload,
+                    payload: toDiagnosticCause(item.payload),
                     reason: "window_unavailable",
                     queued: queue.length,
                     dropped,
@@ -483,12 +485,12 @@ export function createEventPublisher(_contract, options) {
                 dropped += 1;
                 safelyCall(diagnostics?.onDispatchFailure, {
                     event: item.event.name,
-                    payload: item.payload,
-                    cause,
+                    payload: toDiagnosticCause(item.payload),
+                    cause: toDiagnosticCause(cause),
                 });
                 safelyCall(diagnostics?.onDroppedEvent, {
                     event: item.event.name,
-                    payload: item.payload,
+                    payload: toDiagnosticCause(item.payload),
                     reason: "dispatch_failed",
                     queued: queue.length,
                     dropped,
@@ -502,7 +504,10 @@ export function createEventPublisher(_contract, options) {
         }
         draining = true;
         try {
-            while (running && !disposed && queue.length > 0) {
+            while (queue.length > 0) {
+                if (!running || disposed) {
+                    break;
+                }
                 const next = queue.shift();
                 if (!next) {
                     continue;
@@ -524,7 +529,7 @@ export function createEventPublisher(_contract, options) {
             if (evicted) {
                 safelyCall(diagnostics?.onDroppedEvent, {
                     event: evicted.event.name,
-                    payload: evicted.payload,
+                    payload: toDiagnosticCause(evicted.payload),
                     reason: "queue_full",
                     queued: queue.length,
                     dropped,

package/dist/preload-bridge.d.ts

@@ -1,8 +1,22 @@
-import { type ChannelPrefix, type EventSubscribe, type RpcInvoke } from "./types.ts";
+import { type IpcEncodedValue } from "./boundary.ts";
+import { type ChannelPrefix, type EventSubscribe, type IpcInvokeEvent, type OnStreamFrame, type RpcInvoke } from "./types.ts";
+export type ExposedRpcApi = {
+    readonly invoke: RpcInvoke;
+    readonly onStreamFrame: OnStreamFrame;
+};
+export type ExposedEventsApi = {
+    readonly subscribe: EventSubscribe;
+};
+export type ExposedIpcApi = {
+    readonly invoke: RpcInvoke;
+    readonly subscribe: EventSubscribe;
+    readonly onStreamFrame: OnStreamFrame;
+};
+export type ExposedBridgeValue = ExposedRpcApi | ExposedEventsApi | ExposedIpcApi;
 export type BridgeAdapters = {
     readonly invoke: RpcInvoke;
     readonly subscribe: EventSubscribe;
-    readonly onStreamFrame: (listener: (frame: unknown) => void) => () => void;
+    readonly onStreamFrame: OnStreamFrame;
 };
 export type BridgeAdaptersOptions = {
     readonly channelPrefix?: ChannelPrefix;
@@ -15,18 +29,32 @@ export type IpcBridgeExposureOptions = BridgeAdaptersOptions & {
     readonly global?: string;
 };
 type ContextBridgeLike = {
-    readonly exposeInMainWorld: (name: string, value: Record<string, unknown>) => void;
+    readonly exposeInMainWorld: (name: string, value: ExposedBridgeValue) => void;
 };
 type IpcRendererLike = {
-    readonly invoke: (channel: string, payload: unknown) => Promise<unknown>;
-    readonly on: (channel: string, handler: (event: unknown, payload: unknown) => void) => void;
-    readonly removeListener: (channel: string, handler: (event: unknown, payload: unknown) => void) => void;
+    readonly invoke: (channel: string, payload: IpcEncodedValue) => Promise<IpcEncodedValue>;
+    readonly on: (channel: string, handler: (event: IpcInvokeEvent, payload: IpcEncodedValue) => void) => void;
+    readonly removeListener: (channel: string, handler: (event: IpcInvokeEvent, payload: IpcEncodedValue) => void) => void;
 };
-type ElectronRendererBindings = {
+export type ElectronRendererBindings = {
     readonly contextBridge: ContextBridgeLike;
     readonly ipcRenderer: IpcRendererLike;
 };
-export declare function resolveElectronRendererBindings(moduleCandidate: unknown): ElectronRendererBindings;
+type ElectronRuntimeFunction = (...arguments_: never[]) => void;
+type ElectronDirectModuleCandidate = {
+    readonly contextBridge: {
+        readonly exposeInMainWorld: ElectronRuntimeFunction;
+    };
+    readonly ipcRenderer: {
+        readonly invoke: ElectronRuntimeFunction;
+        readonly on: ElectronRuntimeFunction;
+        readonly removeListener: ElectronRuntimeFunction;
+    };
+};
+export type ElectronModuleCandidate = ElectronDirectModuleCandidate | {
+    readonly default: ElectronModuleCandidate;
+};
+export declare function resolveElectronRendererBindings<T>(moduleCandidate: T): ElectronRendererBindings;
 export declare function createBridgeAdaptersFromBindings(bindings: ElectronRendererBindings, options?: BridgeAdaptersOptions): BridgeAdapters;
 export declare function exposeRpcBridgeFromBindings(bindings: ElectronRendererBindings, options?: BridgeExposureOptions): void;
 export declare function exposeIpcBridgeFromBindings(bindings: ElectronRendererBindings, options?: IpcBridgeExposureOptions): void;

package/dist/preload-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preload-bridge.d.ts","sourceRoot":"","sources":["../src/preload-bridge.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,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;IACnC,QAAQ,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CAC5E,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;AAEF,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACpF,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,QAAQ,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAC;IAC5F,QAAQ,CAAC,cAAc,EAAE,CACvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,KAChD,IAAI,CAAC;CACX,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;CACvC,CAAC;AAeF,wBAAgB,+BAA+B,CAC7C,eAAe,EAAE,OAAO,GACvB,wBAAwB,CAqB1B;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,wBAAwB,EAClC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,cAAc,CAkChB;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,wBAAwB,EAClC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAiBN;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,wBAAwB,EAClC,OAAO,CAAC,EAAE,wBAAwB,GACjC,IAAI,CAaN"}
+{"version":3,"file":"preload-bridge.d.ts","sourceRoot":"","sources":["../src/preload-bridge.ts"],"names":[],"mappings":"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"}

package/dist/preload-bridge.js

@@ -1,32 +1,34 @@
-import { isRecord } from "./protocol.js";
+import { isFunctionValue, isRecord } from "./boundary.js";
 import { assertValidChannelPrefix, defaultChannelPrefix, } from "./types.js";
 function isContextBridgeLike(value) {
-    return isRecord(value) && typeof value.exposeInMainWorld === "function";
+    return isRecord(value) && isFunctionValue(value.exposeInMainWorld);
 }
 function isIpcRendererLike(value) {
     return (isRecord(value) &&
-        typeof value.invoke === "function" &&
-        typeof value.on === "function" &&
-        typeof value.removeListener === "function");
+        isFunctionValue(value.invoke) &&
+        isFunctionValue(value.on) &&
+        isFunctionValue(value.removeListener));
+}
+function isElectronRendererBindings(value) {
+    return (isRecord(value) &&
+        isContextBridgeLike(value.contextBridge) &&
+        isIpcRendererLike(value.ipcRenderer));
+}
+function parseElectronRendererBindings(value) {
+    return isElectronRendererBindings(value) ? value : null;
 }
 export function resolveElectronRendererBindings(moduleCandidate) {
-    const moduleDefault = isRecord(moduleCandidate) ? moduleCandidate.default : undefined;
-    const source = isRecord(moduleCandidate)
-        ? moduleCandidate
-        : isRecord(moduleDefault)
-            ? moduleDefault
-            : undefined;
-    if (!source) {
-        throw new Error("electron-effect-rpc/preload requires Electron preload runtime bindings.");
+    const direct = parseElectronRendererBindings(moduleCandidate);
+    if (direct) {
+        return direct;
     }
-    const { contextBridge, ipcRenderer } = source;
-    if (!isContextBridgeLike(contextBridge) || !isIpcRendererLike(ipcRenderer)) {
-        throw new Error("electron-effect-rpc/preload requires Electron preload runtime bindings.");
+    if (isRecord(moduleCandidate)) {
+        const fromDefault = parseElectronRendererBindings(moduleCandidate.default);
+        if (fromDefault) {
+            return fromDefault;
+        }
     }
-    return {
-        contextBridge,
-        ipcRenderer,
-    };
+    throw new Error("electron-effect-rpc/preload requires Electron preload runtime bindings.");
 }
 export function createBridgeAdaptersFromBindings(bindings, options) {
     const channelPrefix = options?.channelPrefix

package/dist/protocol.d.ts

@@ -1,29 +1,29 @@
+import { type IpcEncodedValue } from "./boundary.ts";
 export type RpcSuccessEnvelope = {
     readonly type: "success";
-    readonly data: unknown;
+    readonly data: IpcEncodedValue;
 };
 export type RpcFailureEnvelope = {
     readonly type: "failure";
     readonly error: {
         readonly tag: string;
-        readonly data: unknown;
+        readonly data: IpcEncodedValue;
     };
 };
 export type RpcDefectEnvelope = {
     readonly type: "defect";
     readonly message: string;
-    readonly cause?: unknown;
+    readonly cause?: IpcEncodedValue;
 };
 export type RpcResponseEnvelope = RpcSuccessEnvelope | RpcFailureEnvelope | RpcDefectEnvelope;
-export declare function isRecord(value: unknown): value is Record<string, unknown>;
-export declare function formatUnknown(value: unknown): string;
-export declare function extractErrorTag(error: unknown): string;
-export declare function toDefectEnvelope(cause: unknown, prefix?: string): RpcDefectEnvelope;
+export { formatUnknown, isRecord, isStringValue } from "./boundary.ts";
+export declare function extractErrorTag<T>(error: T): string;
+export declare function toDefectEnvelope<T>(cause: T, prefix?: string): RpcDefectEnvelope;
 export declare function safelyCall<T>(callback: ((context: T) => void) | undefined, context: T): void;
 export type StreamDataFrame = {
     readonly type: "data";
     readonly streamId: string;
-    readonly payload: unknown;
+    readonly payload: IpcEncodedValue;
 };
 export type StreamEndFrame = {
     readonly type: "end";
@@ -34,7 +34,7 @@ export type StreamErrorFrame = {
     readonly streamId: string;
     readonly error: {
         readonly tag: string;
-        readonly data: unknown;
+        readonly data: IpcEncodedValue;
     };
 };
 export type StreamDefectFrame = {
@@ -43,7 +43,7 @@ export type StreamDefectFrame = {
     readonly message: string;
 };
 export type StreamFrame = StreamDataFrame | StreamEndFrame | StreamErrorFrame | StreamDefectFrame;
-export declare function extractStreamIdFromRaw(value: unknown): string | null;
-export declare function parseStreamFrame(value: unknown): StreamFrame | null;
-export declare function parseRpcResponseEnvelope(value: unknown): RpcResponseEnvelope | null;
+export declare function extractStreamIdFromRaw<T>(value: T): string | null;
+export declare function parseStreamFrame<T>(value: T): StreamFrame | null;
+export declare function parseRpcResponseEnvelope<T>(value: T): RpcResponseEnvelope | null;
 //# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;KACxB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;AAM9F,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUtD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAOnF;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAU5F;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;KACxB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,cAAc,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAElG,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAKpE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CA4CnE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CA+CnF"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;KAChC,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;AAM9F,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEvE,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAUnD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAOhF;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAU5F;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;KAChC,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,cAAc,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAMlG,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,GAAG,IAAI,CAMjE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,WAAW,GAAG,IAAI,CAiChE;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,mBAAmB,GAAG,IAAI,CAyBhF"}

package/dist/protocol.js

@@ -1,14 +1,11 @@
-function hasOwn(record, key) {
-    return Object.prototype.hasOwnProperty.call(record, key);
-}
-export function isRecord(value) {
-    return typeof value === "object" && value !== null;
-}
-export function formatUnknown(value) {
-    return value instanceof Error ? value.message : String(value);
-}
+import * as S from "effect/Schema";
+import { formatUnknown, isRecord, isStringValue, } from "./boundary.js";
+const TaggedValue = S.Struct({
+    _tag: S.String,
+});
+export { formatUnknown, isRecord, isStringValue } from "./boundary.js";
 export function extractErrorTag(error) {
-    if (isRecord(error) && typeof error._tag === "string") {
+    if (S.is(TaggedValue)(error)) {
         return error._tag;
     }
     if (error instanceof Error && error.name.length > 0) {
@@ -35,84 +32,69 @@ export function safelyCall(callback, context) {
         // Diagnostics hooks must never crash transport internals.
     }
 }
+function hasOwn(record, key) {
+    return Object.prototype.hasOwnProperty.call(record, key);
+}
 export function extractStreamIdFromRaw(value) {
-    if (!isRecord(value) || typeof value.streamId !== "string") {
+    if (!isRecord(value)) {
         return null;
     }
-    return value.streamId;
+    const streamId = value.streamId;
+    return isStringValue(streamId) ? streamId : null;
 }
 export function parseStreamFrame(value) {
-    if (!isRecord(value) || typeof value.type !== "string") {
+    if (!isRecord(value)) {
         return null;
     }
-    if (typeof value.streamId !== "string") {
+    const streamId = extractStreamIdFromRaw(value);
+    if (streamId === null) {
         return null;
     }
-    const streamId = value.streamId;
     switch (value.type) {
         case "data":
-            if (!hasOwn(value, "payload")) {
-                return null;
-            }
-            return { type: "data", streamId, payload: value.payload };
+            return hasOwn(value, "payload") ? { type: "data", streamId, payload: value.payload } : null;
         case "end":
             return { type: "end", streamId };
-        case "error":
-            if (!isRecord(value.error) ||
-                typeof value.error.tag !== "string" ||
-                !hasOwn(value.error, "data")) {
+        case "error": {
+            const error = value.error;
+            if (!isRecord(error) || !isStringValue(error.tag) || !hasOwn(error, "data")) {
                 return null;
             }
             return {
                 type: "error",
                 streamId,
-                error: { tag: value.error.tag, data: value.error.data },
+                error: { tag: error.tag, data: error.data },
             };
+        }
         case "defect":
-            if (typeof value.message !== "string") {
-                return null;
-            }
-            return { type: "defect", streamId, message: value.message };
+            return isStringValue(value.message)
+                ? { type: "defect", streamId, message: value.message }
+                : null;
         default:
             return null;
     }
 }
 export function parseRpcResponseEnvelope(value) {
-    if (!isRecord(value) || typeof value.type !== "string") {
+    if (!isRecord(value)) {
         return null;
     }
     switch (value.type) {
         case "success":
-            if (!hasOwn(value, "data")) {
-                return null;
-            }
-            return {
-                type: "success",
-                data: value.data,
-            };
-        case "failure":
-            if (!isRecord(value.error) || typeof value.error.tag !== "string") {
-                return null;
-            }
-            if (!hasOwn(value.error, "data")) {
+            return hasOwn(value, "data") ? { type: "success", data: value.data } : null;
+        case "failure": {
+            const error = value.error;
+            if (!isRecord(error) || !isStringValue(error.tag) || !hasOwn(error, "data")) {
                 return null;
             }
             return {
                 type: "failure",
-                error: {
-                    tag: value.error.tag,
-                    data: value.error.data,
-                },
+                error: { tag: error.tag, data: error.data },
             };
+        }
         case "defect":
-            if (typeof value.message !== "string") {
-                return null;
-            }
-            return {
-                type: "defect",
-                message: value.message,
-                cause: value.cause,
-            };
+            return isStringValue(value.message)
+                ? { type: "defect", message: value.message, cause: value.cause }
+                : null;
         default:
             return null;
     }