effect 4.0.0-beta.66 → 4.0.0-beta.68

package/dist/unstable/workers/Worker.d.ts.map

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

package/dist/unstable/workers/Worker.js

@@ -1,4 +1,28 @@
 /**
+ * Client-side worker primitives shared by browser, Node, and Bun platform
+ * packages.
+ *
+ * A `WorkerPlatform` turns a numeric worker id into a long-lived `Worker`
+ * client using a runtime-specific `Spawner`. This module is the low-level
+ * building block used by worker-backed RPC clients and by platform adapters
+ * that need to communicate with dedicated workers, shared workers,
+ * `MessagePort`s, worker threads, or child-process transports while keeping
+ * setup, message handling, and cleanup inside `Effect` scopes.
+ *
+ * The worker protocol separates spawning from message delivery. Calls to
+ * `send` made before the platform reports readiness are buffered and flushed
+ * after `run` receives the ready signal, so a spawned worker must eventually be
+ * run or buffered messages will never leave the client. Message values are
+ * passed through `postMessage`, which means callers are responsible for
+ * encoding payloads into values supported by the selected runtime's structured
+ * clone implementation. Transfer lists can avoid copies for buffers, ports, or
+ * other transferable values, but ownership moves to the worker and invalid
+ * transfer lists surface as `WorkerSendError`s. Incoming messages are handled
+ * by forking each handler invocation into the worker run's `FiberSet`, so
+ * processing is concurrent rather than serialized; use an explicit queue,
+ * semaphore, or protocol-level acknowledgement when ordering or back pressure
+ * matters.
+ *
  * @since 4.0.0
  */
 import * as Context from "../../Context.js";
@@ -9,13 +33,20 @@ import * as Layer from "../../Layer.js";
 import * as Scope from "../../Scope.js";
 import { WorkerError, WorkerSendError } from "./WorkerError.js";
 /**
- * @since 4.0.0
+ * Service that spawns effect `Worker` instances for numeric worker ids using
+ * the configured `Spawner`.
+ *
  * @category models
+ * @since 4.0.0
  */
 export class WorkerPlatform extends /*#__PURE__*/Context.Service()("effect/workers/Worker/WorkerPlatform") {}
 /**
- * @since 4.0.0
+ * Wraps platform-specific send and run functions into a `Worker`, translating
+ * platform ready/data messages and running the optional `onSpawn` effect when
+ * the worker reports readiness.
+ *
  * @category models
+ * @since 4.0.0
  */
 export const makeUnsafe = options => ({
   send: options.send,
@@ -28,16 +59,25 @@ export const makeUnsafe = options => ({
   }
 });
 /**
- * @since 4.0.0
+ * Context service tag for the worker `SpawnerFn`.
+ *
  * @category tags
+ * @since 4.0.0
  */
 export const Spawner = /*#__PURE__*/Context.Service("effect/workers/Worker/Spawner");
 /**
- * @since 4.0.0
+ * Creates a layer that provides a worker `Spawner` service from a `SpawnerFn`.
+ *
  * @category layers
+ * @since 4.0.0
  */
 export const layerSpawner = /*#__PURE__*/Layer.succeed(Spawner);
 /**
+ * Creates a `WorkerPlatform` from platform-specific setup and listen hooks,
+ * buffering sent messages until the worker is ready and scoping port cleanup to
+ * the worker run.
+ *
+ * @category constructors
  * @since 4.0.0
  */
 export const makePlatform = () => options => WorkerPlatform.of({

package/dist/unstable/workers/Worker.js.map

@@ -1 +1 @@
-{"version":3,"file":"Worker.js","names":["Context","Effect","FiberSet","Latch","Layer","Scope","WorkerError","WorkerSendError","WorkerPlatform","Service","makeUnsafe","options","send","run","handler","options_","onSpawn","void","msg","Spawner","layerSpawner","succeed","makePlatform","of","spawn","id","gen","currentPort","buffer","opts","uninterruptibleMask","restore","scopedWith","fnUntraced","scope","port","setup","worker","addFinalizer","sync","undefined","fiberSet","make","pipe","provide","runtime","ready","listen","emit","data","ensuring","open","openUnsafe","deferred","await","length","message","transfers","postMessage","join","suspend","push","cause","fail","reason"],"sources":["../../../src/unstable/workers/Worker.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Worker.js","names":["Context","Effect","FiberSet","Latch","Layer","Scope","WorkerError","WorkerSendError","WorkerPlatform","Service","makeUnsafe","options","send","run","handler","options_","onSpawn","void","msg","Spawner","layerSpawner","succeed","makePlatform","of","spawn","id","gen","currentPort","buffer","opts","uninterruptibleMask","restore","scopedWith","fnUntraced","scope","port","setup","worker","addFinalizer","sync","undefined","fiberSet","make","pipe","provide","runtime","ready","listen","emit","data","ensuring","open","openUnsafe","deferred","await","length","message","transfers","postMessage","join","suspend","push","cause","fail","reason"],"sources":["../../../src/unstable/workers/Worker.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/workers/WorkerError.d.ts

@@ -1,13 +1,17 @@
 import * as Schema from "../../Schema.ts";
 declare const TypeId: "~effect/workers/WorkerError";
 /**
- * @since 4.0.0
+ * Type-level identifier used to brand `WorkerError` values.
+ *
  * @category Symbols
+ * @since 4.0.0
  */
 export type TypeId = typeof TypeId;
 /**
+ * Returns `true` when a value is a `WorkerError`.
+ *
+ * @category guards
  * @since 4.0.0
- * @category Guards
  */
 export declare const isWorkerError: (u: unknown) => u is WorkerError;
 declare const WorkerSpawnError_base: Schema.Class<WorkerSpawnError, Schema.Struct<{
@@ -16,8 +20,10 @@ declare const WorkerSpawnError_base: Schema.Class<WorkerSpawnError, Schema.Struc
     readonly cause: Schema.optional<Schema.Defect>;
 }>, import("../../Cause.ts").YieldableError>;
 /**
+ * Worker error reason for failures while spawning or setting up a worker.
+ *
+ * @category models
  * @since 4.0.0
- * @category Models
  */
 export declare class WorkerSpawnError extends WorkerSpawnError_base {
 }
@@ -27,8 +33,10 @@ declare const WorkerSendError_base: Schema.Class<WorkerSendError, Schema.Struct<
     readonly cause: Schema.optional<Schema.Defect>;
 }>, import("../../Cause.ts").YieldableError>;
 /**
+ * Worker error reason for failures while sending a message to a worker.
+ *
+ * @category models
  * @since 4.0.0
- * @category Models
  */
 export declare class WorkerSendError extends WorkerSendError_base {
 }
@@ -38,8 +46,11 @@ declare const WorkerReceiveError_base: Schema.Class<WorkerReceiveError, Schema.S
     readonly cause: Schema.optional<Schema.Defect>;
 }>, import("../../Cause.ts").YieldableError>;
 /**
+ * Worker error reason for failures while receiving or handling a message from a
+ * worker.
+ *
+ * @category models
  * @since 4.0.0
- * @category Models
  */
 export declare class WorkerReceiveError extends WorkerReceiveError_base {
 }
@@ -49,19 +60,25 @@ declare const WorkerUnknownError_base: Schema.Class<WorkerUnknownError, Schema.S
     readonly cause: Schema.optional<Schema.Defect>;
 }>, import("../../Cause.ts").YieldableError>;
 /**
+ * Worker error reason for an unclassified worker failure.
+ *
+ * @category models
  * @since 4.0.0
- * @category Models
  */
 export declare class WorkerUnknownError extends WorkerUnknownError_base {
 }
 /**
+ * Union of the specific failure reasons that can be wrapped by a `WorkerError`.
+ *
+ * @category models
  * @since 4.0.0
- * @category Models
  */
 export type WorkerErrorReason = WorkerSpawnError | WorkerSendError | WorkerReceiveError | WorkerUnknownError;
 /**
+ * Schema for decoding and encoding all supported worker error reason variants.
+ *
+ * @category models
  * @since 4.0.0
- * @category Models
  */
 export declare const WorkerErrorReason: Schema.Union<[
     typeof WorkerSpawnError,
@@ -74,14 +91,19 @@ declare const WorkerError_base: Schema.Class<WorkerError, Schema.Struct<{
     readonly reason: Schema.Union<[typeof WorkerSpawnError, typeof WorkerSendError, typeof WorkerReceiveError, typeof WorkerUnknownError]>;
 }>, import("../../Cause.ts").YieldableError>;
 /**
+ * Error raised by worker APIs, wrapping a specific `WorkerErrorReason` and
+ * exposing its message and cause.
+ *
+ * @category models
  * @since 4.0.0
- * @category Models
  */
 export declare class WorkerError extends WorkerError_base {
     constructor(props: {
         readonly reason: WorkerErrorReason;
     });
     /**
+     * Marks this value as a worker error for runtime guards.
+     *
      * @since 4.0.0
      */
     readonly [TypeId]: TypeId;

package/dist/unstable/workers/WorkerError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkerError.d.ts","sourceRoot":"","sources":["../../../src/unstable/workers/WorkerError.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,QAAA,MAAM,MAAM,EAAG,6BAAsC,CAAA;AAErD;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAA;AAElC;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,WAAqC,CAAA;;;;;;AAErF;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,qBAMpC;CAAG;;;;;;AAEL;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,oBAMnC;CAAG;;;;;;AAEL;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,uBAMtC;CAAG;;;;;;AAEL;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,uBAMtC;CAAG;AAEL;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,kBAAkB,CAAA;AAEtB;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,KAAK,CAAC;IAC3C,OAAO,gBAAgB;IACvB,OAAO,eAAe;IACtB,OAAO,kBAAkB;IACzB,OAAO,kBAAkB;CAC1B,CAKC,CAAA;;;;;AAEF;;;GAGG;AACH,qBAAa,WAAY,SAAQ,gBAG/B;gBAEY,KAAK,EAAE;QACjB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;KACnC;IAMD;;OAEG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAS;IAElC,IAAa,OAAO,IAAI,MAAM,CAE7B;CACF"}
+{"version":3,"file":"WorkerError.d.ts","sourceRoot":"","sources":["../../../src/unstable/workers/WorkerError.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,QAAA,MAAM,MAAM,EAAG,6BAAsC,CAAA;AAErD;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAA;AAElC;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,WAAqC,CAAA;;;;;;AAErF;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,qBAMpC;CAAG;;;;;;AAEL;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,oBAMnC;CAAG;;;;;;AAEL;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,uBAMtC;CAAG;;;;;;AAEL;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,uBAMtC;CAAG;AAEL;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,kBAAkB,CAAA;AAEtB;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,KAAK,CAAC;IAC3C,OAAO,gBAAgB;IACvB,OAAO,eAAe;IACtB,OAAO,kBAAkB;IACzB,OAAO,kBAAkB;CAC1B,CAKC,CAAA;;;;;AAEF;;;;;;GAMG;AACH,qBAAa,WAAY,SAAQ,gBAG/B;gBAEY,KAAK,EAAE;QACjB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;KACnC;IAMD;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAS;IAElC,IAAa,OAAO,IAAI,MAAM,CAE7B;CACF"}

package/dist/unstable/workers/WorkerError.js

@@ -1,17 +1,40 @@
 /**
+ * Typed error definitions for the unstable worker APIs.
+ *
+ * `WorkerError` is the shared error channel for `WorkerPlatform` and
+ * `WorkerRunnerPlatform` implementations. The nested reason identifies where a
+ * platform failure happened: spawning or setting up a worker, sending through
+ * `postMessage`, receiving worker events, or handling a runtime-specific
+ * failure that does not fit the other categories. This is useful when building
+ * worker-backed RPC clients and servers, implementing a platform adapter, or
+ * recovering differently from startup, transport, and worker-exit failures.
+ *
+ * Worker transports cross browser, Node, Bun, and child-process runtimes, so the
+ * original cause is best treated as diagnostic data. Spawn failures can mean the
+ * runner is not actually executing inside a worker context, send failures often
+ * come from structured-clone or transfer-list problems, and receive failures
+ * may be reported as `messageerror`, `error`, or exit events depending on the
+ * runtime. The `WorkerErrorReason` schema supports encoding and decoding the
+ * tagged reasons, but message payloads still need to be valid for the selected
+ * worker protocol and runtime.
+ *
  * @since 4.0.0
  */
 import { hasProperty } from "../../Predicate.js";
 import * as Schema from "../../Schema.js";
 const TypeId = "~effect/workers/WorkerError";
 /**
+ * Returns `true` when a value is a `WorkerError`.
+ *
+ * @category guards
  * @since 4.0.0
- * @category Guards
  */
 export const isWorkerError = u => hasProperty(u, TypeId);
 /**
+ * Worker error reason for failures while spawning or setting up a worker.
+ *
+ * @category models
  * @since 4.0.0
- * @category Models
  */
 export class WorkerSpawnError extends /*#__PURE__*/Schema.ErrorClass("effect/workers/WorkerError/WorkerSpawnError")({
   _tag: /*#__PURE__*/Schema.tag("WorkerSpawnError"),
@@ -19,8 +42,10 @@ export class WorkerSpawnError extends /*#__PURE__*/Schema.ErrorClass("effect/wor
   cause: /*#__PURE__*/Schema.optional(Schema.Defect)
 }) {}
 /**
+ * Worker error reason for failures while sending a message to a worker.
+ *
+ * @category models
  * @since 4.0.0
- * @category Models
  */
 export class WorkerSendError extends /*#__PURE__*/Schema.ErrorClass("effect/workers/WorkerError/WorkerSendError")({
   _tag: /*#__PURE__*/Schema.tag("WorkerSendError"),
@@ -28,8 +53,11 @@ export class WorkerSendError extends /*#__PURE__*/Schema.ErrorClass("effect/work
   cause: /*#__PURE__*/Schema.optional(Schema.Defect)
 }) {}
 /**
+ * Worker error reason for failures while receiving or handling a message from a
+ * worker.
+ *
+ * @category models
  * @since 4.0.0
- * @category Models
  */
 export class WorkerReceiveError extends /*#__PURE__*/Schema.ErrorClass("effect/workers/WorkerError/WorkerReceiveError")({
   _tag: /*#__PURE__*/Schema.tag("WorkerReceiveError"),
@@ -37,8 +65,10 @@ export class WorkerReceiveError extends /*#__PURE__*/Schema.ErrorClass("effect/w
   cause: /*#__PURE__*/Schema.optional(Schema.Defect)
 }) {}
 /**
+ * Worker error reason for an unclassified worker failure.
+ *
+ * @category models
  * @since 4.0.0
- * @category Models
  */
 export class WorkerUnknownError extends /*#__PURE__*/Schema.ErrorClass("effect/workers/WorkerError/WorkerUnknownError")({
   _tag: /*#__PURE__*/Schema.tag("WorkerUnknownError"),
@@ -46,13 +76,18 @@ export class WorkerUnknownError extends /*#__PURE__*/Schema.ErrorClass("effect/w
   cause: /*#__PURE__*/Schema.optional(Schema.Defect)
 }) {}
 /**
+ * Schema for decoding and encoding all supported worker error reason variants.
+ *
+ * @category models
  * @since 4.0.0
- * @category Models
  */
 export const WorkerErrorReason = /*#__PURE__*/Schema.Union([WorkerSpawnError, WorkerSendError, WorkerReceiveError, WorkerUnknownError]);
 /**
+ * Error raised by worker APIs, wrapping a specific `WorkerErrorReason` and
+ * exposing its message and cause.
+ *
+ * @category models
  * @since 4.0.0
- * @category Models
  */
 export class WorkerError extends /*#__PURE__*/Schema.ErrorClass(TypeId)({
   _tag: /*#__PURE__*/Schema.tag("WorkerError"),
@@ -66,6 +101,8 @@ export class WorkerError extends /*#__PURE__*/Schema.ErrorClass(TypeId)({
     });
   }
   /**
+   * Marks this value as a worker error for runtime guards.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;

package/dist/unstable/workers/WorkerError.js.map

@@ -1 +1 @@
-{"version":3,"file":"WorkerError.js","names":["hasProperty","Schema","TypeId","isWorkerError","u","WorkerSpawnError","ErrorClass","_tag","tag","message","String","cause","optional","Defect","WorkerSendError","WorkerReceiveError","WorkerUnknownError","WorkerErrorReason","Union","WorkerError","reason","constructor","props"],"sources":["../../../src/unstable/workers/WorkerError.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAGA,SAASA,WAAW,QAAQ,oBAAoB;AAChD,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AAEzC,MAAMC,MAAM,GAAG,6BAAsC;AAQrD;;;;AAIA,OAAO,MAAMC,aAAa,GAAIC,CAAU,IAAuBJ,WAAW,CAACI,CAAC,EAAEF,MAAM,CAAC;AAErF;;;;AAIA,OAAM,MAAOG,gBAAiB,sBAAQJ,MAAM,CAACK,UAAU,CACrD,6CAA6C,CAC9C,CAAC;EACAC,IAAI,eAAEN,MAAM,CAACO,GAAG,CAAC,kBAAkB,CAAC;EACpCC,OAAO,EAAER,MAAM,CAACS,MAAM;EACtBC,KAAK,eAAEV,MAAM,CAACW,QAAQ,CAACX,MAAM,CAACY,MAAM;CACrC,CAAC;AAEF;;;;AAIA,OAAM,MAAOC,eAAgB,sBAAQb,MAAM,CAACK,UAAU,CACpD,4CAA4C,CAC7C,CAAC;EACAC,IAAI,eAAEN,MAAM,CAACO,GAAG,CAAC,iBAAiB,CAAC;EACnCC,OAAO,EAAER,MAAM,CAACS,MAAM;EACtBC,KAAK,eAAEV,MAAM,CAACW,QAAQ,CAACX,MAAM,CAACY,MAAM;CACrC,CAAC;AAEF;;;;AAIA,OAAM,MAAOE,kBAAmB,sBAAQd,MAAM,CAACK,UAAU,CACvD,+CAA+C,CAChD,CAAC;EACAC,IAAI,eAAEN,MAAM,CAACO,GAAG,CAAC,oBAAoB,CAAC;EACtCC,OAAO,EAAER,MAAM,CAACS,MAAM;EACtBC,KAAK,eAAEV,MAAM,CAACW,QAAQ,CAACX,MAAM,CAACY,MAAM;CACrC,CAAC;AAEF;;;;AAIA,OAAM,MAAOG,kBAAmB,sBAAQf,MAAM,CAACK,UAAU,CACvD,+CAA+C,CAChD,CAAC;EACAC,IAAI,eAAEN,MAAM,CAACO,GAAG,CAAC,oBAAoB,CAAC;EACtCC,OAAO,EAAER,MAAM,CAACS,MAAM;EACtBC,KAAK,eAAEV,MAAM,CAACW,QAAQ,CAACX,MAAM,CAACY,MAAM;CACrC,CAAC;AAYF;;;;AAIA,OAAO,MAAMI,iBAAiB,gBAKzBhB,MAAM,CAACiB,KAAK,CAAC,CAChBb,gBAAgB,EAChBS,eAAe,EACfC,kBAAkB,EAClBC,kBAAkB,CACnB,CAAC;AAEF;;;;AAIA,OAAM,MAAOG,WAAY,sBAAQlB,MAAM,CAACK,UAAU,CAAcJ,MAAM,CAAC,CAAC;EACtEK,IAAI,eAAEN,MAAM,CAACO,GAAG,CAAC,aAAa,CAAC;EAC/BY,MAAM,EAAEH;CACT,CAAC;EACA;EACAI,YAAYC,KAEX;IACC,KAAK,CAAC;MACJ,GAAGA,KAAK;MACRX,KAAK,EAAEW,KAAK,CAACF,MAAM,CAACT;KACd,CAAC;EACX;EACA;;;EAGS,CAACT,MAAM,IAAYA,MAAM;EAElC,IAAaO,OAAOA,CAAA;IAClB,OAAO,IAAI,CAACW,MAAM,CAACX,OAAO;EAC5B","ignoreList":[]}
+{"version":3,"file":"WorkerError.js","names":["hasProperty","Schema","TypeId","isWorkerError","u","WorkerSpawnError","ErrorClass","_tag","tag","message","String","cause","optional","Defect","WorkerSendError","WorkerReceiveError","WorkerUnknownError","WorkerErrorReason","Union","WorkerError","reason","constructor","props"],"sources":["../../../src/unstable/workers/WorkerError.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;AAsBA,SAASA,WAAW,QAAQ,oBAAoB;AAChD,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AAEzC,MAAMC,MAAM,GAAG,6BAAsC;AAUrD;;;;;;AAMA,OAAO,MAAMC,aAAa,GAAIC,CAAU,IAAuBJ,WAAW,CAACI,CAAC,EAAEF,MAAM,CAAC;AAErF;;;;;;AAMA,OAAM,MAAOG,gBAAiB,sBAAQJ,MAAM,CAACK,UAAU,CACrD,6CAA6C,CAC9C,CAAC;EACAC,IAAI,eAAEN,MAAM,CAACO,GAAG,CAAC,kBAAkB,CAAC;EACpCC,OAAO,EAAER,MAAM,CAACS,MAAM;EACtBC,KAAK,eAAEV,MAAM,CAACW,QAAQ,CAACX,MAAM,CAACY,MAAM;CACrC,CAAC;AAEF;;;;;;AAMA,OAAM,MAAOC,eAAgB,sBAAQb,MAAM,CAACK,UAAU,CACpD,4CAA4C,CAC7C,CAAC;EACAC,IAAI,eAAEN,MAAM,CAACO,GAAG,CAAC,iBAAiB,CAAC;EACnCC,OAAO,EAAER,MAAM,CAACS,MAAM;EACtBC,KAAK,eAAEV,MAAM,CAACW,QAAQ,CAACX,MAAM,CAACY,MAAM;CACrC,CAAC;AAEF;;;;;;;AAOA,OAAM,MAAOE,kBAAmB,sBAAQd,MAAM,CAACK,UAAU,CACvD,+CAA+C,CAChD,CAAC;EACAC,IAAI,eAAEN,MAAM,CAACO,GAAG,CAAC,oBAAoB,CAAC;EACtCC,OAAO,EAAER,MAAM,CAACS,MAAM;EACtBC,KAAK,eAAEV,MAAM,CAACW,QAAQ,CAACX,MAAM,CAACY,MAAM;CACrC,CAAC;AAEF;;;;;;AAMA,OAAM,MAAOG,kBAAmB,sBAAQf,MAAM,CAACK,UAAU,CACvD,+CAA+C,CAChD,CAAC;EACAC,IAAI,eAAEN,MAAM,CAACO,GAAG,CAAC,oBAAoB,CAAC;EACtCC,OAAO,EAAER,MAAM,CAACS,MAAM;EACtBC,KAAK,eAAEV,MAAM,CAACW,QAAQ,CAACX,MAAM,CAACY,MAAM;CACrC,CAAC;AAcF;;;;;;AAMA,OAAO,MAAMI,iBAAiB,gBAKzBhB,MAAM,CAACiB,KAAK,CAAC,CAChBb,gBAAgB,EAChBS,eAAe,EACfC,kBAAkB,EAClBC,kBAAkB,CACnB,CAAC;AAEF;;;;;;;AAOA,OAAM,MAAOG,WAAY,sBAAQlB,MAAM,CAACK,UAAU,CAAcJ,MAAM,CAAC,CAAC;EACtEK,IAAI,eAAEN,MAAM,CAACO,GAAG,CAAC,aAAa,CAAC;EAC/BY,MAAM,EAAEH;CACT,CAAC;EACA;EACAI,YAAYC,KAEX;IACC,KAAK,CAAC;MACJ,GAAGA,KAAK;MACRX,KAAK,EAAEW,KAAK,CAACF,MAAM,CAACT;KACd,CAAC;EACX;EACA;;;;;EAKS,CAACT,MAAM,IAAYA,MAAM;EAElC,IAAaO,OAAOA,CAAA;IAClB,OAAO,IAAI,CAACW,MAAM,CAACX,OAAO;EAC5B","ignoreList":[]}

package/dist/unstable/workers/WorkerRunner.d.ts

@@ -1,4 +1,25 @@
 /**
+ * Server-side worker runner primitives shared by the browser, Node, and Bun
+ * platform packages.
+ *
+ * A `WorkerRunnerPlatform` is installed in code that is already running inside
+ * a worker-like runtime. Starting it yields a `WorkerRunner`, which listens for
+ * parent or client requests, identifies each connection with a numeric port id,
+ * and sends responses back through the same transport. The main Effect use case
+ * is `RpcServer.layerProtocolWorkerRunner`, but platform adapters can also use
+ * these types to expose lower-level request handlers for dedicated workers,
+ * shared workers, worker threads, or child-process channels.
+ *
+ * The wire protocol is intentionally small: inbound messages are
+ * `PlatformMessage` values where `[0, payload]` is a request and `[1]` closes a
+ * port. Higher-level protocols are responsible for encoding request and
+ * response payloads before they cross the worker boundary. Values must still be
+ * accepted by the selected runtime's message mechanism, so structured-clone
+ * support, transfer lists, `messageerror` events, and single-port runtimes such
+ * as Node or Bun should be considered when choosing payload schemas and
+ * resource lifetimes. Handler effects run on the runtime captured by `run`, so
+ * services required by the handler must be provided to the running effect.
+ *
  * @since 4.0.0
  */
 import * as Context from "../../Context.ts";
@@ -6,8 +27,11 @@ import type * as Effect from "../../Effect.ts";
 import type * as Queue from "../../Queue.ts";
 import type { WorkerError } from "./WorkerError.ts";
 /**
- * @since 4.0.0
+ * Platform-neutral worker runner that receives inbound messages by port ID,
+ * sends outbound messages, and optionally exposes disconnect notifications.
+ *
  * @category models
+ * @since 4.0.0
  */
 export interface WorkerRunner<O = unknown, I = unknown> {
     readonly run: <A, E, R>(handler: (portId: number, message: I) => Effect.Effect<A, E, R> | void) => Effect.Effect<void, WorkerError, R>;
@@ -16,16 +40,21 @@ export interface WorkerRunner<O = unknown, I = unknown> {
     readonly disconnects?: Queue.Dequeue<number> | undefined;
 }
 /**
- * @since 4.0.0
+ * Wire protocol message used by worker platforms: a request carrying input or a
+ * close signal.
+ *
  * @category models
+ * @since 4.0.0
  */
 export type PlatformMessage<I> = readonly [request: 0, I] | readonly [close: 1];
 declare const WorkerRunnerPlatform_base: Context.ServiceClass<WorkerRunnerPlatform, "effect/workers/WorkerRunner/WorkerRunnerPlatform", {
     readonly start: <O = unknown, I = unknown>() => Effect.Effect<WorkerRunner<O, I>, WorkerError>;
 }>;
 /**
- * @since 4.0.0
+ * Context service that starts a platform-specific `WorkerRunner`.
+ *
  * @category models
+ * @since 4.0.0
  */
 export declare class WorkerRunnerPlatform extends WorkerRunnerPlatform_base {
 }

package/dist/unstable/workers/WorkerRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkerRunner.d.ts","sourceRoot":"","sources":["../../../src/unstable/workers/WorkerRunner.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACpD,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACpB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,KACnE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAA;IACxC,QAAQ,CAAC,IAAI,EAAE,CACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,EACV,SAAS,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,KAC/B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,CACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,EACV,SAAS,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,KAC/B,IAAI,CAAA;IACT,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAAA;CACzD;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;;oBAO7D,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,CAAC;;AALhG;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,yBAEc;CAAG"}
+{"version":3,"file":"WorkerRunner.d.ts","sourceRoot":"","sources":["../../../src/unstable/workers/WorkerRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACpD,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACpB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,KACnE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAA;IACxC,QAAQ,CAAC,IAAI,EAAE,CACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,EACV,SAAS,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,KAC/B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,CACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,EACV,SAAS,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,KAC/B,IAAI,CAAA;IACT,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAAA;CACzD;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;;oBAS7D,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,CAAC;;AAPhG;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,yBAEc;CAAG"}

package/dist/unstable/workers/WorkerRunner.js

@@ -1,10 +1,33 @@
 /**
+ * Server-side worker runner primitives shared by the browser, Node, and Bun
+ * platform packages.
+ *
+ * A `WorkerRunnerPlatform` is installed in code that is already running inside
+ * a worker-like runtime. Starting it yields a `WorkerRunner`, which listens for
+ * parent or client requests, identifies each connection with a numeric port id,
+ * and sends responses back through the same transport. The main Effect use case
+ * is `RpcServer.layerProtocolWorkerRunner`, but platform adapters can also use
+ * these types to expose lower-level request handlers for dedicated workers,
+ * shared workers, worker threads, or child-process channels.
+ *
+ * The wire protocol is intentionally small: inbound messages are
+ * `PlatformMessage` values where `[0, payload]` is a request and `[1]` closes a
+ * port. Higher-level protocols are responsible for encoding request and
+ * response payloads before they cross the worker boundary. Values must still be
+ * accepted by the selected runtime's message mechanism, so structured-clone
+ * support, transfer lists, `messageerror` events, and single-port runtimes such
+ * as Node or Bun should be considered when choosing payload schemas and
+ * resource lifetimes. Handler effects run on the runtime captured by `run`, so
+ * services required by the handler must be provided to the running effect.
+ *
  * @since 4.0.0
  */
 import * as Context from "../../Context.js";
 /**
- * @since 4.0.0
+ * Context service that starts a platform-specific `WorkerRunner`.
+ *
  * @category models
+ * @since 4.0.0
  */
 export class WorkerRunnerPlatform extends /*#__PURE__*/Context.Service()("effect/workers/WorkerRunner/WorkerRunnerPlatform") {}
 //# sourceMappingURL=WorkerRunner.js.map

package/dist/unstable/workers/WorkerRunner.js.map

@@ -1 +1 @@
-{"version":3,"file":"WorkerRunner.js","names":["Context","WorkerRunnerPlatform","Service"],"sources":["../../../src/unstable/workers/WorkerRunner.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAGA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAgC3C;;;;AAIA,OAAM,MAAOC,oBAAqB,sBAAQD,OAAO,CAACE,OAAO,EAErD,CAAC,kDAAkD,CAAC","ignoreList":[]}
+{"version":3,"file":"WorkerRunner.js","names":["Context","WorkerRunnerPlatform","Service"],"sources":["../../../src/unstable/workers/WorkerRunner.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAsC3C;;;;;;AAMA,OAAM,MAAOC,oBAAqB,sBAAQD,OAAO,CAACE,OAAO,EAErD,CAAC,kDAAkD,CAAC","ignoreList":[]}

package/dist/unstable/workers/index.d.ts

@@ -2,18 +2,98 @@
  * @since 4.0.0
  */
 /**
- * @since 1.0.0
+ * Utilities for marking the parts of worker messages that should be transferred
+ * through `postMessage` instead of copied by the structured clone algorithm.
+ *
+ * This module is used with worker message schemas to collect
+ * `globalThis.Transferable` values while encoding a message, so the worker
+ * platform can pass the collected list as the `postMessage` transfer list.
+ * Common cases include sending large `Uint8Array` payloads, `ImageData` pixel
+ * buffers, or `MessagePort` channels without paying for an extra copy.
+ *
+ * Transferable annotations do not make an otherwise unsupported value
+ * structured-cloneable; the encoded message still has to be valid for
+ * `postMessage`. Transferring also moves ownership to the receiver, so buffers
+ * are detached from the sender after the send completes. Be careful when a
+ * typed array view shares a backing buffer with other data, since collecting
+ * that buffer transfers ownership of the whole buffer.
+ *
+ * @since 4.0.0
  */
 export * as Transferable from "./Transferable.ts";
 /**
+ * Client-side worker primitives shared by browser, Node, and Bun platform
+ * packages.
+ *
+ * A `WorkerPlatform` turns a numeric worker id into a long-lived `Worker`
+ * client using a runtime-specific `Spawner`. This module is the low-level
+ * building block used by worker-backed RPC clients and by platform adapters
+ * that need to communicate with dedicated workers, shared workers,
+ * `MessagePort`s, worker threads, or child-process transports while keeping
+ * setup, message handling, and cleanup inside `Effect` scopes.
+ *
+ * The worker protocol separates spawning from message delivery. Calls to
+ * `send` made before the platform reports readiness are buffered and flushed
+ * after `run` receives the ready signal, so a spawned worker must eventually be
+ * run or buffered messages will never leave the client. Message values are
+ * passed through `postMessage`, which means callers are responsible for
+ * encoding payloads into values supported by the selected runtime's structured
+ * clone implementation. Transfer lists can avoid copies for buffers, ports, or
+ * other transferable values, but ownership moves to the worker and invalid
+ * transfer lists surface as `WorkerSendError`s. Incoming messages are handled
+ * by forking each handler invocation into the worker run's `FiberSet`, so
+ * processing is concurrent rather than serialized; use an explicit queue,
+ * semaphore, or protocol-level acknowledgement when ordering or back pressure
+ * matters.
+ *
  * @since 4.0.0
  */
 export * as Worker from "./Worker.ts";
 /**
+ * Typed error definitions for the unstable worker APIs.
+ *
+ * `WorkerError` is the shared error channel for `WorkerPlatform` and
+ * `WorkerRunnerPlatform` implementations. The nested reason identifies where a
+ * platform failure happened: spawning or setting up a worker, sending through
+ * `postMessage`, receiving worker events, or handling a runtime-specific
+ * failure that does not fit the other categories. This is useful when building
+ * worker-backed RPC clients and servers, implementing a platform adapter, or
+ * recovering differently from startup, transport, and worker-exit failures.
+ *
+ * Worker transports cross browser, Node, Bun, and child-process runtimes, so the
+ * original cause is best treated as diagnostic data. Spawn failures can mean the
+ * runner is not actually executing inside a worker context, send failures often
+ * come from structured-clone or transfer-list problems, and receive failures
+ * may be reported as `messageerror`, `error`, or exit events depending on the
+ * runtime. The `WorkerErrorReason` schema supports encoding and decoding the
+ * tagged reasons, but message payloads still need to be valid for the selected
+ * worker protocol and runtime.
+ *
  * @since 4.0.0
  */
 export * as WorkerError from "./WorkerError.ts";
 /**
+ * Server-side worker runner primitives shared by the browser, Node, and Bun
+ * platform packages.
+ *
+ * A `WorkerRunnerPlatform` is installed in code that is already running inside
+ * a worker-like runtime. Starting it yields a `WorkerRunner`, which listens for
+ * parent or client requests, identifies each connection with a numeric port id,
+ * and sends responses back through the same transport. The main Effect use case
+ * is `RpcServer.layerProtocolWorkerRunner`, but platform adapters can also use
+ * these types to expose lower-level request handlers for dedicated workers,
+ * shared workers, worker threads, or child-process channels.
+ *
+ * The wire protocol is intentionally small: inbound messages are
+ * `PlatformMessage` values where `[0, payload]` is a request and `[1]` closes a
+ * port. Higher-level protocols are responsible for encoding request and
+ * response payloads before they cross the worker boundary. Values must still be
+ * accepted by the selected runtime's message mechanism, so structured-clone
+ * support, transfer lists, `messageerror` events, and single-port runtimes such
+ * as Node or Bun should be considered when choosing payload schemas and
+ * resource lifetimes. Handler effects run on the runtime captured by `run`, so
+ * services required by the handler must be provided to the running effect.
+ *
  * @since 4.0.0
  */
 export * as WorkerRunner from "./WorkerRunner.ts";

package/dist/unstable/workers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/unstable/workers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AAEjD;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/unstable/workers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA"}