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

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,24 @@ 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.
+ *
  * @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;
 /**
- * @since 4.0.0
+ * Returns `true` when a value is a `WorkerError`.
+ *
  * @category Guards
+ * @since 4.0.0
  */
 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>;
 /**
- * @since 4.0.0
+ * Worker error reason for failures while spawning or setting up a worker.
+ *
  * @category Models
+ * @since 4.0.0
  */
 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>;
 /**
- * @since 4.0.0
+ * Worker error reason for failures while sending a message to a worker.
+ *
  * @category Models
+ * @since 4.0.0
  */
 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>;
 /**
- * @since 4.0.0
+ * Worker error reason for failures while receiving or handling a message from a
+ * worker.
+ *
  * @category Models
+ * @since 4.0.0
  */
 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>;
 /**
- * @since 4.0.0
+ * Worker error reason for an unclassified worker failure.
+ *
  * @category Models
+ * @since 4.0.0
  */
 export declare class WorkerUnknownError extends WorkerUnknownError_base {
 }
 /**
- * @since 4.0.0
+ * Union of the specific failure reasons that can be wrapped by a `WorkerError`.
+ *
  * @category Models
+ * @since 4.0.0
  */
 export type WorkerErrorReason = WorkerSpawnError | WorkerSendError | WorkerReceiveError | WorkerUnknownError;
 /**
- * @since 4.0.0
+ * Schema for decoding and encoding all supported worker error reason variants.
+ *
  * @category Models
+ * @since 4.0.0
  */
 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>;
 /**
- * @since 4.0.0
+ * Error raised by worker APIs, wrapping a specific `WorkerErrorReason` and
+ * exposing its message and cause.
+ *
  * @category Models
+ * @since 4.0.0
  */
 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";
 /**
- * @since 4.0.0
+ * Returns `true` when a value is a `WorkerError`.
+ *
  * @category Guards
+ * @since 4.0.0
  */
 export const isWorkerError = u => hasProperty(u, TypeId);
 /**
- * @since 4.0.0
+ * Worker error reason for failures while spawning or setting up a worker.
+ *
  * @category Models
+ * @since 4.0.0
  */
 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)
 }) {}
 /**
- * @since 4.0.0
+ * Worker error reason for failures while sending a message to a worker.
+ *
  * @category Models
+ * @since 4.0.0
  */
 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)
 }) {}
 /**
- * @since 4.0.0
+ * Worker error reason for failures while receiving or handling a message from a
+ * worker.
+ *
  * @category Models
+ * @since 4.0.0
  */
 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)
 }) {}
 /**
- * @since 4.0.0
+ * Worker error reason for an unclassified worker failure.
+ *
  * @category Models
+ * @since 4.0.0
  */
 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)
 }) {}
 /**
- * @since 4.0.0
+ * Schema for decoding and encoding all supported worker error reason variants.
+ *
  * @category Models
+ * @since 4.0.0
  */
 export const WorkerErrorReason = /*#__PURE__*/Schema.Union([WorkerSpawnError, WorkerSendError, WorkerReceiveError, WorkerUnknownError]);
 /**
- * @since 4.0.0
+ * Error raised by worker APIs, wrapping a specific `WorkerErrorReason` and
+ * exposing its message and cause.
+ *
  * @category Models
+ * @since 4.0.0
  */
 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,7 +2,7 @@
  * @since 4.0.0
  */
 /**
- * @since 1.0.0
+ * @since 4.0.0
  */
 export * as Transferable from "./Transferable.ts";
 /**

package/dist/unstable/workers/index.js

@@ -3,7 +3,7 @@
  */
 // @barrel: Auto-generated exports. Do not edit manually.
 /**
- * @since 1.0.0
+ * @since 4.0.0
  */
 export * as Transferable from "./Transferable.js";
 /**

package/dist/unstable/workflow/Activity.d.ts

@@ -1,4 +1,24 @@
 /**
+ * The `Activity` module defines named, schema-backed effects that run at the
+ * side-effect boundary of a durable workflow. Activities are executed through a
+ * `WorkflowEngine`, encode their success and failure values with the provided
+ * schemas, and can be replayed from persisted results instead of rerunning the
+ * underlying effect.
+ *
+ * Use activities for work that should not be embedded directly in workflow
+ * control flow, such as calling external services, writing to databases,
+ * enqueueing durable jobs, short sleeps delegated by `DurableClock`, or racing
+ * multiple external operations with `raceAll`. Keep activity names and schemas
+ * stable because engines use them, together with the workflow execution and
+ * retry attempt, to identify stored results.
+ *
+ * Activities can be interrupted and retried, and workflow resumes may observe a
+ * completed encoded result or run the activity again depending on what the
+ * engine has persisted. Make external side effects idempotent, use
+ * `idempotencyKey` for stable request keys derived from the workflow execution,
+ * and include the current attempt only when each retry must address a distinct
+ * external operation.
+ *
  * @since 4.0.0
  */
 import type { NonEmptyReadonlyArray } from "../../Array.ts";
@@ -12,8 +32,12 @@ import type * as Types from "../../Types.ts";
 import type { WorkflowEngine, WorkflowInstance } from "./WorkflowEngine.ts";
 declare const TypeId = "~effect/workflow/Activity";
 /**
- * @since 4.0.0
+ * Durable workflow activity that behaves as an `Effect` and records its name,
+ * result schemas, annotations, and encoded execution form for the workflow
+ * engine.
+ *
  * @category Models
+ * @since 4.0.0
  */
 export interface Activity<Success extends Schema.Top = Schema.Void, Error extends Schema.Top = Schema.Never, R = never> extends Effect.Effect<Success["Type"], Error["Type"], Success["DecodingServices"] | Error["DecodingServices"] | R | WorkflowEngine | WorkflowInstance> {
     readonly [TypeId]: typeof TypeId;
@@ -28,8 +52,11 @@ export interface Activity<Success extends Schema.Top = Schema.Void, Error extend
     readonly executeEncoded: Effect.Effect<unknown, unknown, Success["DecodingServices"] | Success["EncodingServices"] | Error["DecodingServices"] | Error["EncodingServices"] | R | Scope | WorkflowEngine | WorkflowInstance>;
 }
 /**
- * @since 4.0.0
+ * Type-erased activity shape for APIs that only need the activity identity,
+ * name, annotations, and encoded execution.
+ *
  * @category Models
+ * @since 4.0.0
  */
 export interface Any {
     readonly [TypeId]: typeof TypeId;
@@ -38,8 +65,11 @@ export interface Any {
     readonly annotations: Context.Context<never>;
 }
 /**
- * @since 4.0.0
+ * Type-erased activity shape that also exposes success and error schemas for
+ * derived workflow APIs.
+ *
  * @category Models
+ * @since 4.0.0
  */
 export interface AnyWithProps {
     readonly [TypeId]: typeof TypeId;
@@ -49,8 +79,11 @@ export interface AnyWithProps {
     readonly executeEncoded: Effect.Effect<any, any, any>;
 }
 /**
- * @since 4.0.0
+ * Creates a workflow activity from an effect, using the provided schemas to
+ * encode successes and failures for durable execution.
+ *
  * @category Constructors
+ * @since 4.0.0
  */
 export declare const make: <R, Success extends Schema.Top = Schema.Void, Error extends Schema.Top = Schema.Never>(options: {
     readonly name: string;
@@ -61,36 +94,54 @@ export declare const make: <R, Success extends Schema.Top = Schema.Void, Error e
     readonly annotations?: Context.Context<never> | undefined;
 }) => Activity<Success, Error, Exclude<R, WorkflowInstance | WorkflowEngine | Scope>>;
 /**
- * @since 4.0.0
+ * Retries an effect with `Effect.retry` while updating `CurrentAttempt` for
+ * each attempt.
+ *
  * @category Error handling
+ * @since 4.0.0
  */
 export declare const retry: {
     /**
-     * @since 4.0.0
+     * Retries an effect with `Effect.retry` while updating `CurrentAttempt` for
+     * each attempt.
+     *
      * @category Error handling
+     * @since 4.0.0
      */
     <E, O extends Types.NoExcessProperties<Omit<Effect.Retry.Options<E>, "schedule">, O>>(options: O): <A, R>(self: Effect.Effect<A, E, R>) => Effect.Retry.Return<R, E, A, O>;
     /**
-     * @since 4.0.0
+     * Retries an effect with `Effect.retry` while updating `CurrentAttempt` for
+     * each attempt.
+     *
      * @category Error handling
+     * @since 4.0.0
      */
     <A, E, R, O extends Types.NoExcessProperties<Omit<Effect.Retry.Options<E>, "schedule">, O>>(self: Effect.Effect<A, E, R>, options: O): Effect.Retry.Return<R, E, A, O>;
 };
 /**
- * @since 4.0.0
+ * Context reference containing the current activity retry attempt, defaulting
+ * to `1`.
+ *
  * @category Attempts
+ * @since 4.0.0
  */
 export declare const CurrentAttempt: Context.Reference<number>;
 /**
- * @since 4.0.0
+ * Computes a deterministic activity idempotency key from the current workflow
+ * execution ID, the supplied name, and optionally the current attempt.
+ *
  * @category Idempotency
+ * @since 4.0.0
  */
 export declare const idempotencyKey: (name: string, options?: {
     readonly includeAttempt?: boolean | undefined;
 } | undefined) => Effect.Effect<string, never, WorkflowInstance>;
 /**
- * @since 4.0.0
+ * Runs a non-empty collection of activities as a durable race and returns the
+ * first completed success or failure using unioned success and error schemas.
+ *
  * @category Racing
+ * @since 4.0.0
  */
 export declare const raceAll: <const Activities extends NonEmptyReadonlyArray<Any>>(name: string, activities: Activities) => Effect.Effect<Activities[number] extends Activity<infer _A, infer _E, infer _R> ? _A["Type"] : never, Activities[number] extends Activity<infer _A, infer _E_1, infer _R_1> ? _E_1["Type"] : never, (Activities[number] extends Activity<infer Success, infer Error, infer R> ? Success["DecodingServices"] | Error["DecodingServices"] | R : never) | WorkflowEngine | WorkflowInstance>;
 export {};

package/dist/unstable/workflow/Activity.d.ts.map

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