effect 4.0.0-beta.65 → 4.0.0-beta.67

package/dist/unstable/rpc/RpcWorker.d.ts

@@ -1,4 +1,21 @@
 /**
+ * Helpers for passing a schema-encoded bootstrap message to worker-backed RPC
+ * protocols.
+ *
+ * Worker RPC protocols can send one initial message when each worker starts,
+ * before ordinary RPC requests begin flowing. Use this module to build and
+ * provide that message from the client side, and to decode it inside the
+ * worker-side server. Common payloads include per-worker configuration,
+ * credentials or session metadata, feature flags, preloaded data, or
+ * transferable resources such as `ArrayBuffer` and `MessagePort` values.
+ *
+ * The initial message uses the supplied schema's JSON codec and is posted as a
+ * worker message, so it is separate from the normal `RpcSerialization` used for
+ * RPC request and response traffic. Values still need to be valid for the
+ * worker transport's structured clone boundary. Transferable annotations can
+ * collect objects for the `postMessage` transfer list, but transferring moves
+ * ownership to the worker and may detach buffers from the sender.
+ *
  * @since 4.0.0
  */
 import type { NoSuchElementError } from "../../Cause.ts";
@@ -9,19 +26,27 @@ import * as Schema from "../../Schema.ts";
 import type { Protocol } from "./RpcServer.ts";
 declare const InitialMessage_base: Context.ServiceClass<InitialMessage, "effect/rpc/RpcWorker/InitialMessage", Effect.Effect<readonly [data: unknown, transfers: readonly Transferable[]], never, never>>;
 /**
- * @since 4.0.0
+ * Context service that supplies the initial RPC worker message as encoded data
+ * paired with any transferables that should be posted with it.
+ *
  * @category initial message
+ * @since 4.0.0
  */
 export declare class InitialMessage extends InitialMessage_base {
 }
 /**
- * @since 4.0.0
+ * Types related to the encoded initial message exchanged with an RPC worker.
+ *
  * @category initial message
+ * @since 4.0.0
  */
 export declare namespace InitialMessage {
     /**
-     * @since 4.0.0
+     * Tagged wire representation of an RPC worker initial message after schema
+     * encoding.
+     *
      * @category initial message
+     * @since 4.0.0
      */
     interface Encoded {
         readonly _tag: "InitialMessage";
@@ -29,18 +54,27 @@ export declare namespace InitialMessage {
     }
 }
 /**
- * @since 4.0.0
+ * Runs an effect, encodes its result with the schema's JSON codec, and returns
+ * the encoded value together with collected transferables.
+ *
  * @category initial message
+ * @since 4.0.0
  */
 export declare const makeInitialMessage: <S extends Schema.Top, E, R2>(schema: S, effect: Effect.Effect<S["Type"], E, R2>) => Effect.Effect<readonly [data: unknown, transferables: ReadonlyArray<globalThis.Transferable>], E | Schema.SchemaError, S["EncodingServices"] | R2>;
 /**
- * @since 4.0.0
+ * Provides the `InitialMessage` service from a schema and build effect,
+ * capturing the layer context and dying if schema encoding fails.
+ *
  * @category initial message
+ * @since 4.0.0
  */
 export declare const layerInitialMessage: <S extends Schema.Top, R2>(schema: S, build: Effect.Effect<S["Type"], never, R2>) => Layer.Layer<InitialMessage, never, S["EncodingServices"] | R2>;
 /**
- * @since 4.0.0
+ * Reads the protocol initial message and decodes it with the supplied schema,
+ * failing if no initial message is available or decoding fails.
+ *
  * @category initial message
+ * @since 4.0.0
  */
 export declare const initialMessage: <S extends Schema.Top>(schema: S) => Effect.Effect<S["Type"], NoSuchElementError | Schema.SchemaError, Protocol | S["DecodingServices"]>;
 export {};

package/dist/unstable/rpc/RpcWorker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RpcWorker.d.ts","sourceRoot":"","sources":["../../../src/unstable/rpc/RpcWorker.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;;AAE9C;;;GAGG;AACH,qBAAa,cAAe,SAAQ,mBAQM;CAAG;AAE7C;;;GAGG;AACH,MAAM,CAAC,OAAO,WAAW,cAAc,CAAC;IACtC;;;OAGG;IACH,UAAiB,OAAO;QACtB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;QAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KACxB;CACF;AAID;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,EAC5D,QAAQ,CAAC,EACT,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KACtC,MAAM,CAAC,MAAM,CACd,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EAC/E,CAAC,GAAG,MAAM,CAAC,WAAW,EACtB,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAU3B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,EAAE,EAC1D,QAAQ,CAAC,EACT,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KACzC,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAO7D,CAAA;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,CAAC,GAAG,EACjD,QAAQ,CAAC,KACR,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAAC,WAAW,EAAE,QAAQ,GAAG,CAAC,CAAC,kBAAkB,CAAC,CAKlG,CAAA"}
+{"version":3,"file":"RpcWorker.d.ts","sourceRoot":"","sources":["../../../src/unstable/rpc/RpcWorker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;;AAE9C;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,mBAQM;CAAG;AAE7C;;;;;GAKG;AACH,MAAM,CAAC,OAAO,WAAW,cAAc,CAAC;IACtC;;;;;;OAMG;IACH,UAAiB,OAAO;QACtB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;QAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KACxB;CACF;AAID;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,EAC5D,QAAQ,CAAC,EACT,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KACtC,MAAM,CAAC,MAAM,CACd,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EAC/E,CAAC,GAAG,MAAM,CAAC,WAAW,EACtB,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAU3B,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,EAAE,EAC1D,QAAQ,CAAC,EACT,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KACzC,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAO7D,CAAA;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,CAAC,GAAG,EACjD,QAAQ,CAAC,KACR,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAAC,WAAW,EAAE,QAAQ,GAAG,CAAC,CAAC,kBAAkB,CAAC,CAKlG,CAAA"}

package/dist/unstable/rpc/RpcWorker.js

@@ -4,14 +4,20 @@ import * as Layer from "../../Layer.js";
 import * as Schema from "../../Schema.js";
 import * as Transferable from "../workers/Transferable.js";
 /**
- * @since 4.0.0
+ * Context service that supplies the initial RPC worker message as encoded data
+ * paired with any transferables that should be posted with it.
+ *
  * @category initial message
+ * @since 4.0.0
  */
 export class InitialMessage extends /*#__PURE__*/Context.Service()("effect/rpc/RpcWorker/InitialMessage") {}
 const ProtocolTag = /*#__PURE__*/Context.Service("@effect/rpc/RpcServer/Protocol");
 /**
- * @since 4.0.0
+ * Runs an effect, encodes its result with the schema's JSON codec, and returns
+ * the encoded value together with collected transferables.
+ *
  * @category initial message
+ * @since 4.0.0
  */
 export const makeInitialMessage = (schema, effect) => {
   const schemaJson = Schema.toCodecJson(schema);
@@ -21,13 +27,19 @@ export const makeInitialMessage = (schema, effect) => {
   });
 };
 /**
- * @since 4.0.0
+ * Provides the `InitialMessage` service from a schema and build effect,
+ * capturing the layer context and dying if schema encoding fails.
+ *
  * @category initial message
+ * @since 4.0.0
  */
 export const layerInitialMessage = (schema, build) => Layer.effect(InitialMessage)(Effect.contextWith(context => Effect.succeed(Effect.provideContext(Effect.orDie(makeInitialMessage(schema, build)), context))));
 /**
- * @since 4.0.0
+ * Reads the protocol initial message and decodes it with the supplied schema,
+ * failing if no initial message is available or decoding fails.
+ *
  * @category initial message
+ * @since 4.0.0
  */
-export const initialMessage = schema => ProtocolTag.asEffect().pipe(Effect.flatMap(protocol => protocol.initialMessage), Effect.flatMap(o => o.asEffect()), Effect.flatMap(Schema.decodeUnknownEffect(Schema.toCodecJson(schema))));
+export const initialMessage = schema => ProtocolTag.pipe(Effect.flatMap(protocol => protocol.initialMessage), Effect.flatMap(Effect.fromOption), Effect.flatMap(Schema.decodeUnknownEffect(Schema.toCodecJson(schema))));
 //# sourceMappingURL=RpcWorker.js.map

package/dist/unstable/rpc/RpcWorker.js.map

@@ -1 +1 @@
-{"version":3,"file":"RpcWorker.js","names":["Context","Effect","Layer","Schema","Transferable","InitialMessage","Service","ProtocolTag","makeInitialMessage","schema","effect","schemaJson","toCodecJson","flatMap","value","collector","makeCollectorUnsafe","encodeEffect","pipe","provideService","Collector","map","encoded","clearUnsafe","layerInitialMessage","build","contextWith","context","succeed","provideContext","orDie","initialMessage","asEffect","protocol","o","decodeUnknownEffect"],"sources":["../../../src/unstable/rpc/RpcWorker.ts"],"sourcesContent":[null],"mappings":"AAIA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,YAAY,MAAM,4BAA4B;AAG1D;;;;AAIA,OAAM,MAAOC,cAAe,sBAAQL,OAAO,CAACM,OAAO,EAQhD,CAAC,qCAAqC,CAAC;AAiB1C,MAAMC,WAAW,gBAAoBP,OAAO,CAACM,OAAO,CAAC,gCAAgC,CAAQ;AAE7F;;;;AAIA,OAAO,MAAME,kBAAkB,GAAGA,CAChCC,MAAS,EACTC,MAAuC,KAKrC;EACF,MAAMC,UAAU,GAAGR,MAAM,CAACS,WAAW,CAACH,MAAM,CAAC;EAC7C,OAAOR,MAAM,CAACY,OAAO,CAACH,MAAM,EAAGI,KAAK,IAAI;IACtC,MAAMC,SAAS,GAAGX,YAAY,CAACY,mBAAmB,EAAE;IACpD,OAAOb,MAAM,CAACc,YAAY,CAACN,UAAU,CAAC,CAACG,KAAK,CAAC,CAACI,IAAI,CAChDjB,MAAM,CAACkB,cAAc,CAACf,YAAY,CAACgB,SAAS,EAAEL,SAAS,CAAC,EACxDd,MAAM,CAACoB,GAAG,CAAEC,OAAO,IAAK,CAACA,OAAO,EAAEP,SAAS,CAACQ,WAAW,EAAE,CAAU,CAAC,CACrE;EACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;AAIA,OAAO,MAAMC,mBAAmB,GAAGA,CACjCf,MAAS,EACTgB,KAA0C,KAE1CvB,KAAK,CAACQ,MAAM,CAACL,cAAc,CAAC,CAC1BJ,MAAM,CAACyB,WAAW,CAAEC,OAAoD,IACtE1B,MAAM,CAAC2B,OAAO,CACZ3B,MAAM,CAAC4B,cAAc,CAAC5B,MAAM,CAAC6B,KAAK,CAACtB,kBAAkB,CAACC,MAAM,EAAEgB,KAAK,CAAC,CAAC,EAAEE,OAAO,CAAC,CAChF,CACF,CACF;AAEH;;;;AAIA,OAAO,MAAMI,cAAc,GACzBtB,MAAS,IAETF,WAAW,CAACyB,QAAQ,EAAE,CAACd,IAAI,CACzBjB,MAAM,CAACY,OAAO,CAAEoB,QAAQ,IAAKA,QAAQ,CAACF,cAAc,CAAC,EACrD9B,MAAM,CAACY,OAAO,CAAEqB,CAAC,IAAKA,CAAC,CAACF,QAAQ,EAAE,CAAC,EACnC/B,MAAM,CAACY,OAAO,CAACV,MAAM,CAACgC,mBAAmB,CAAChC,MAAM,CAACS,WAAW,CAACH,MAAM,CAAC,CAAC,CAAC,CACvE","ignoreList":[]}
+{"version":3,"file":"RpcWorker.js","names":["Context","Effect","Layer","Schema","Transferable","InitialMessage","Service","ProtocolTag","makeInitialMessage","schema","effect","schemaJson","toCodecJson","flatMap","value","collector","makeCollectorUnsafe","encodeEffect","pipe","provideService","Collector","map","encoded","clearUnsafe","layerInitialMessage","build","contextWith","context","succeed","provideContext","orDie","initialMessage","protocol","fromOption","decodeUnknownEffect"],"sources":["../../../src/unstable/rpc/RpcWorker.ts"],"sourcesContent":[null],"mappings":"AAqBA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,YAAY,MAAM,4BAA4B;AAG1D;;;;;;;AAOA,OAAM,MAAOC,cAAe,sBAAQL,OAAO,CAACM,OAAO,EAQhD,CAAC,qCAAqC,CAAC;AAsB1C,MAAMC,WAAW,gBAAoBP,OAAO,CAACM,OAAO,CAAC,gCAAgC,CAAQ;AAE7F;;;;;;;AAOA,OAAO,MAAME,kBAAkB,GAAGA,CAChCC,MAAS,EACTC,MAAuC,KAKrC;EACF,MAAMC,UAAU,GAAGR,MAAM,CAACS,WAAW,CAACH,MAAM,CAAC;EAC7C,OAAOR,MAAM,CAACY,OAAO,CAACH,MAAM,EAAGI,KAAK,IAAI;IACtC,MAAMC,SAAS,GAAGX,YAAY,CAACY,mBAAmB,EAAE;IACpD,OAAOb,MAAM,CAACc,YAAY,CAACN,UAAU,CAAC,CAACG,KAAK,CAAC,CAACI,IAAI,CAChDjB,MAAM,CAACkB,cAAc,CAACf,YAAY,CAACgB,SAAS,EAAEL,SAAS,CAAC,EACxDd,MAAM,CAACoB,GAAG,CAAEC,OAAO,IAAK,CAACA,OAAO,EAAEP,SAAS,CAACQ,WAAW,EAAE,CAAU,CAAC,CACrE;EACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;AAOA,OAAO,MAAMC,mBAAmB,GAAGA,CACjCf,MAAS,EACTgB,KAA0C,KAE1CvB,KAAK,CAACQ,MAAM,CAACL,cAAc,CAAC,CAC1BJ,MAAM,CAACyB,WAAW,CAAEC,OAAoD,IACtE1B,MAAM,CAAC2B,OAAO,CACZ3B,MAAM,CAAC4B,cAAc,CAAC5B,MAAM,CAAC6B,KAAK,CAACtB,kBAAkB,CAACC,MAAM,EAAEgB,KAAK,CAAC,CAAC,EAAEE,OAAO,CAAC,CAChF,CACF,CACF;AAEH;;;;;;;AAOA,OAAO,MAAMI,cAAc,GACzBtB,MAAS,IAETF,WAAW,CAACW,IAAI,CACdjB,MAAM,CAACY,OAAO,CAAEmB,QAAQ,IAAKA,QAAQ,CAACD,cAAc,CAAC,EACrD9B,MAAM,CAACY,OAAO,CAACZ,MAAM,CAACgC,UAAU,CAAC,EACjChC,MAAM,CAACY,OAAO,CAACV,MAAM,CAAC+B,mBAAmB,CAAC/B,MAAM,CAACS,WAAW,CAACH,MAAM,CAAC,CAAC,CAAC,CACvE","ignoreList":[]}

package/dist/unstable/rpc/Utils.d.ts

@@ -2,12 +2,20 @@ import * as Effect from "../../Effect.ts";
 import type { Protocol } from "./RpcClient.ts";
 import type { FromServerEncoded } from "./RpcMessage.ts";
 /**
+ * Builds a service with a `run` method that buffers writes until `run` installs
+ * a writer, replays buffered writes with their original contexts, and restores
+ * the previous writer when the run ends.
+ *
  * @since 4.0.0
  */
 export declare const withRun: <A extends {
     readonly run: (f: (...args: Array<any>) => Effect.Effect<void>) => Effect.Effect<never>;
 }>() => <EX, RX>(f: (write: Parameters<A["run"]>[0]) => Effect.Effect<Omit<A, "run">, EX, RX>) => Effect.Effect<A, EX, RX>;
 /**
+ * Builds an RPC client protocol service that tracks active client IDs and
+ * buffers server responses per client until that client's `run` handler is
+ * installed.
+ *
  * @since 4.0.0
  */
 export declare const withRunClient: <EX, RX>(f: (write: (clientId: number, response: FromServerEncoded) => Effect.Effect<void>, clientIds: ReadonlySet<number>) => Effect.Effect<Omit<Protocol["Service"], "run">, EX, RX>) => Effect.Effect<Protocol["Service"], EX, RX>;

package/dist/unstable/rpc/Utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Utils.d.ts","sourceRoot":"","sources":["../../../src/unstable/rpc/Utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAExD;;GAEG;AACH,eAAO,MAAM,OAAO,GAClB,CAAC,SAAS;IACR,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;CACxF,QAEF,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CA4B3G,CAAA;AAEJ;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,EAAE,EAAE,EAAE,EAClC,GAAG,CACD,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAC7E,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,KAC3D,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,CA+CxC,CAAA"}
+{"version":3,"file":"Utils.d.ts","sourceRoot":"","sources":["../../../src/unstable/rpc/Utils.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAClB,CAAC,SAAS;IACR,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;CACxF,QAEF,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CA4B3G,CAAA;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,EAAE,EAAE,EAAE,EAClC,GAAG,CACD,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAC7E,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,KAC3D,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,CA+CxC,CAAA"}

package/dist/unstable/rpc/Utils.js

@@ -1,6 +1,10 @@
 import * as Effect from "../../Effect.js";
 import * as Semaphore from "../../Semaphore.js";
 /**
+ * Builds a service with a `run` method that buffers writes until `run` installs
+ * a writer, replays buffered writes with their original contexts, and restores
+ * the previous writer when the run ends.
+ *
  * @since 4.0.0
  */
 export const withRun = () => f => Effect.suspend(() => {
@@ -29,6 +33,10 @@ export const withRun = () => f => Effect.suspend(() => {
   }));
 });
 /**
+ * Builds an RPC client protocol service that tracks active client IDs and
+ * buffers server responses per client until that client's `run` handler is
+ * installed.
+ *
  * @since 4.0.0
  */
 export const withRunClient = f => Effect.suspend(() => {

package/dist/unstable/rpc/Utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"Utils.js","names":["Effect","Semaphore","withRun","f","suspend","semaphore","makeUnsafe","buffer","write","args","contextWith","context","push","void","map","a","run","withPermits","gen","prev","provideContext","onExit","never","withRunClient","clientIds","Set","clientBuffers","Map","clientWrites","clientId","data","get","set","clientWrite","add","delete"],"sources":["../../../src/unstable/rpc/Utils.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Utils.js","names":["Effect","Semaphore","withRun","f","suspend","semaphore","makeUnsafe","buffer","write","args","contextWith","context","push","void","map","a","run","withPermits","gen","prev","provideContext","onExit","never","withRunClient","clientIds","Set","clientBuffers","Map","clientWrites","clientId","data","get","set","clientWrite","add","delete"],"sources":["../../../src/unstable/rpc/Utils.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}