effect 4.0.0-beta.70 → 4.0.0-beta.72

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

@@ -2,76 +2,18 @@
  * @since 4.0.0
  */
 /**
- * Utilities for wiring an Effect application to the Effect devtools runtime
- * tracer.
- *
- * This module is the high-level entry point for installing the devtools tracer
- * as a `Layer`. Use it when an application should stream spans, span events,
- * span completions, and metrics snapshots to a devtools process for local
- * inspection. The default `layer` and `layerWebSocket` helpers connect over a
- * WebSocket to `ws://localhost:34437`, while `layerSocket` lets integrations
- * provide their own `Socket` transport.
- *
- * These layers install tracing for the scoped runtime they are provided to;
- * they do not start a devtools server, and a compatible devtools endpoint must
- * be reachable separately. Because this API lives under `unstable`, its
- * protocol and surface may change between releases.
- *
  * @since 4.0.0
  */
 export * as DevTools from "./DevTools.ts";
 /**
- * Provides the low-level client used by the unstable devtools integration to
- * exchange telemetry with an Effect devtools server over the current `Socket`.
- *
- * The client speaks the devtools NDJSON protocol, publishes span starts, span
- * events, span completions, and metric snapshots, and exposes layers for
- * installing a tracer that mirrors the current tracer while forwarding data to
- * devtools. Most applications should use the higher-level devtools layers
- * instead of constructing this service directly. When using this module
- * directly, provide a live `Socket`, keep the layer scoped so the background
- * ping and stream fibers are finalized, and prefer `layerTracer` when the goal
- * is to observe an application's Effect traces.
- *
  * @since 4.0.0
  */
 export * as DevToolsClient from "./DevToolsClient.ts";
 /**
- * Schemas and TypeScript types for the Effect devtools protocol.
- *
- * This module defines the wire format used by devtools clients and servers to
- * exchange telemetry, including spans, span events, metric snapshots, fiber
- * dumps, heartbeat messages, and request/response payloads. Use these schemas
- * when encoding or decoding messages at the devtools boundary, validating
- * custom transports, or building integrations that need to inspect the same
- * protocol data as the built-in devtools implementation.
- *
- * The exported values describe serialized protocol payloads rather than the
- * full in-memory runtime data structures. Some fields intentionally normalize
- * runtime values for transport, for example ended span exits are encoded with
- * successful values erased via `Exit.asVoid`, timestamps are represented as
- * `bigint`s, and arbitrary attributes are accepted as unknown schema values.
- * The module lives under `unstable`, so consumers should treat the protocol
- * shape as experimental.
- *
  * @since 4.0.0
  */
 export * as DevToolsSchema from "./DevToolsSchema.ts";
 /**
- * Server-side helpers for exposing the Effect devtools protocol over a socket.
- *
- * This module is used by runtime integrations that want to accept devtools
- * clients, decode newline-delimited JSON protocol messages, and hand each
- * connected client to application-specific handling logic. It is most useful
- * for building a devtools endpoint that can inspect running fibers, spans, and
- * other telemetry described by `DevToolsSchema`.
- *
- * The server automatically responds to protocol `Ping` requests with `Pong`
- * responses. All other requests are delivered through the connected `Client`
- * queue, while responses should be written with `Client.send`. The queue is
- * shut down when the socket processing fiber terminates, so handlers should
- * treat it as connection-scoped state rather than a long-lived global channel.
- *
  * @since 4.0.0
  */
 export * as DevToolsServer from "./DevToolsServer.ts";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/unstable/devtools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/unstable/devtools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;GAEG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;GAEG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;GAEG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA"}

package/dist/unstable/devtools/index.js

@@ -3,76 +3,18 @@
  */
 // @barrel: Auto-generated exports. Do not edit manually.
 /**
- * Utilities for wiring an Effect application to the Effect devtools runtime
- * tracer.
- *
- * This module is the high-level entry point for installing the devtools tracer
- * as a `Layer`. Use it when an application should stream spans, span events,
- * span completions, and metrics snapshots to a devtools process for local
- * inspection. The default `layer` and `layerWebSocket` helpers connect over a
- * WebSocket to `ws://localhost:34437`, while `layerSocket` lets integrations
- * provide their own `Socket` transport.
- *
- * These layers install tracing for the scoped runtime they are provided to;
- * they do not start a devtools server, and a compatible devtools endpoint must
- * be reachable separately. Because this API lives under `unstable`, its
- * protocol and surface may change between releases.
- *
  * @since 4.0.0
  */
 export * as DevTools from "./DevTools.js";
 /**
- * Provides the low-level client used by the unstable devtools integration to
- * exchange telemetry with an Effect devtools server over the current `Socket`.
- *
- * The client speaks the devtools NDJSON protocol, publishes span starts, span
- * events, span completions, and metric snapshots, and exposes layers for
- * installing a tracer that mirrors the current tracer while forwarding data to
- * devtools. Most applications should use the higher-level devtools layers
- * instead of constructing this service directly. When using this module
- * directly, provide a live `Socket`, keep the layer scoped so the background
- * ping and stream fibers are finalized, and prefer `layerTracer` when the goal
- * is to observe an application's Effect traces.
- *
  * @since 4.0.0
  */
 export * as DevToolsClient from "./DevToolsClient.js";
 /**
- * Schemas and TypeScript types for the Effect devtools protocol.
- *
- * This module defines the wire format used by devtools clients and servers to
- * exchange telemetry, including spans, span events, metric snapshots, fiber
- * dumps, heartbeat messages, and request/response payloads. Use these schemas
- * when encoding or decoding messages at the devtools boundary, validating
- * custom transports, or building integrations that need to inspect the same
- * protocol data as the built-in devtools implementation.
- *
- * The exported values describe serialized protocol payloads rather than the
- * full in-memory runtime data structures. Some fields intentionally normalize
- * runtime values for transport, for example ended span exits are encoded with
- * successful values erased via `Exit.asVoid`, timestamps are represented as
- * `bigint`s, and arbitrary attributes are accepted as unknown schema values.
- * The module lives under `unstable`, so consumers should treat the protocol
- * shape as experimental.
- *
  * @since 4.0.0
  */
 export * as DevToolsSchema from "./DevToolsSchema.js";
 /**
- * Server-side helpers for exposing the Effect devtools protocol over a socket.
- *
- * This module is used by runtime integrations that want to accept devtools
- * clients, decode newline-delimited JSON protocol messages, and hand each
- * connected client to application-specific handling logic. It is most useful
- * for building a devtools endpoint that can inspect running fibers, spans, and
- * other telemetry described by `DevToolsSchema`.
- *
- * The server automatically responds to protocol `Ping` requests with `Pong`
- * responses. All other requests are delivered through the connected `Client`
- * queue, while responses should be written with `Client.send`. The queue is
- * shut down when the socket processing fiber terminates, so handlers should
- * treat it as connection-scoped state rather than a long-lived global channel.
- *
  * @since 4.0.0
  */
 export * as DevToolsServer from "./DevToolsServer.js";

package/dist/unstable/devtools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["DevTools","DevToolsClient","DevToolsSchema","DevToolsServer"],"sources":["../../../src/unstable/devtools/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAIA;AAEA;;;;;;;;;;;;;;;;;;AAkBA,OAAO,KAAKA,QAAQ,MAAM,eAAe;AAEzC;;;;;;;;;;;;;;;AAeA,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AAErD;;;;;;;;;;;;;;;;;;;;AAoBA,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AAErD;;;;;;;;;;;;;;;;;AAiBA,OAAO,KAAKC,cAAc,MAAM,qBAAqB","ignoreList":[]}
+{"version":3,"file":"index.js","names":["DevTools","DevToolsClient","DevToolsSchema","DevToolsServer"],"sources":["../../../src/unstable/devtools/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAIA;AAEA;;;AAGA,OAAO,KAAKA,QAAQ,MAAM,eAAe;AAEzC;;;AAGA,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AAErD;;;AAGA,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AAErD;;;AAGA,OAAO,KAAKC,cAAc,MAAM,qBAAqB","ignoreList":[]}

package/dist/unstable/encoding/Msgpack.d.ts

@@ -157,7 +157,8 @@ export declare const duplexSchema: {
 export interface schema<S extends Schema.Top> extends Schema.decodeTo<S, Schema.instanceOf<Uint8Array<ArrayBuffer>>> {
 }
 /**
- * Schema transformation between MessagePack bytes and decoded values.
+ * Schema for decoding MessagePack bytes into values and encoding values back to
+ * MessagePack bytes.
  *
  * **Details**
  *

package/dist/unstable/encoding/Msgpack.d.ts.map

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

package/dist/unstable/encoding/Msgpack.js

@@ -1,19 +1,34 @@
 /**
- * Utilities for encoding Effect channel payloads and schema values as
- * MessagePack bytes.
+ * Encode and decode MessagePack frames in Effect channels.
+ *
+ * MessagePack is a compact binary serialization format for protocols and
+ * storage layers that expect bytes rather than JSON text, such as RPC
+ * transports, socket streams, caches, or database columns. This module provides
+ * raw channel helpers for already-agreed value shapes and schema helpers for
+ * validating, transforming, or decoding domain values at the boundary.
+ *
+ * **Mental model**
+ *
+ * - Each input value passed to {@link encode} becomes one MessagePack byte array
+ * - {@link decode} can receive arbitrary byte chunks; incomplete frames are
+ *   buffered until enough bytes arrive
+ * - Schema helpers run Effect schema encoding before packing and schema decoding
+ *   after unpacking
  *
- * This module is useful when a protocol or storage layer expects compact binary
- * frames instead of JSON text, such as RPC transports, socket streams, caches,
- * or database columns that carry typed Effect data. Use the raw channel helpers
- * when both sides already agree on the MessagePack value shape, and use the
- * schema-aware helpers when values should be validated, transformed, or decoded
- * into domain types at the boundary.
+ * **Common tasks**
  *
- * MessagePack preserves binary data and common JavaScript collection shapes, but
- * it is still a data format rather than an Effect schema. Schema encoders run
- * before packing and schema decoders run after unpacking, so unsupported runtime
- * values, lossy schema encodings, or mismatched schemas surface as either
- * `MsgPackError` or `SchemaError` depending on where the failure occurs.
+ * - Pack values into bytes: {@link encode}
+ * - Unpack byte chunks into values: {@link decode}
+ * - Encode or decode domain values with schemas: {@link encodeSchema}, {@link decodeSchema}
+ *
+ * **Gotchas**
+ *
+ * - MessagePack preserves binary data better than JSON, but it is not a schema;
+ *   use schema helpers when runtime validation matters
+ * - Packing failures surface as {@link MsgPackError}; schema failures surface as
+ *   `SchemaError` before or after the binary boundary
+ * - Decoding expects complete MessagePack documents over time, not arbitrary
+ *   byte payloads with out-of-band framing
  *
  * @since 4.0.0
  */
@@ -178,7 +193,8 @@ export const duplex = self => encode().pipe(Channel.pipeTo(self), Channel.pipeTo
  */
 export const duplexSchema = /*#__PURE__*/dual(2, (self, options) => ChannelSchema.duplexUnknown(duplex(self), options));
 /**
- * Schema transformation between MessagePack bytes and decoded values.
+ * Schema for decoding MessagePack bytes into values and encoding values back to
+ * MessagePack bytes.
  *
  * **Details**
  *

package/dist/unstable/encoding/Msgpack.js.map

@@ -1 +1 @@
-{"version":3,"file":"Msgpack.js","names":["Packr","Unpackr","Msgpackr","Arr","Channel","ChannelSchema","Data","Effect","dual","Option","Predicate","Schema","Issue","Transformation","MsgPackErrorTypeId","MsgPackError","TaggedError","message","kind","encode","fromTransform","upstream","_scope","sync","packr","flatMap","chunk","succeed","map","item","pack","cause","fail","encodeSchema","schema","pipeTo","decode","unpackr","incomplete","undefined","loop","out","empty","i","length","buf","prev","Uint8Array","set","push","unpackMultiple","error","subarray","lastPosition","values","isReadonlyArrayNonEmpty","decodeSchema","decodeUnknown","duplex","self","pipe","duplexSchema","options","duplexUnknown","transformation","transformOrFail","e","_options","InvalidValue","some","hasProperty","String","t","decodeTo"],"sources":["../../../src/unstable/encoding/Msgpack.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;AAmBA,SAASA,KAAK,EAAEC,OAAO,QAAQ,UAAU;AACzC,OAAO,KAAKC,QAAQ,MAAM,UAAU;AACpC,OAAO,KAAKC,GAAG,MAAM,gBAAgB;AACrC,OAAO,KAAKC,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,aAAa,MAAM,wBAAwB;AACvD,OAAO,KAAKC,IAAI,MAAM,eAAe;AACrC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,SAASC,IAAI,QAAQ,mBAAmB;AACxC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,SAAS,MAAM,oBAAoB;AAE/C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,KAAK,MAAM,sBAAsB;AAC7C,OAAO,KAAKC,cAAc,MAAM,+BAA+B;AAE/D,MAAMC,kBAAkB,GAAG,uCAAuC;AAElE;;;;;;;;;;;AAWA,OAAM,MAAOC,YAAa,sBAAQT,IAAI,CAACU,WAAW,CAAC,cAAc,CAG/D;EACA;;;;;EAKS,CAACF,kBAAkB,IAAIA,kBAAkB;EAElD;;;;;EAKA,IAAaG,OAAOA,CAAA;IAClB,OAAO,IAAI,CAACC,IAAI;EAClB;;AAGF;;;;;;;;;;;AAWA,OAAO,MAAMC,MAAM,GAAGA,CAAA,KAQpBf,OAAO,CAACgB,aAAa,CAAC,CAACC,QAAQ,EAAEC,MAAM,KACrCf,MAAM,CAACgB,IAAI,CAAC,MAAK;EACf,MAAMC,KAAK,GAAG,IAAIxB,KAAK,EAAE;EACzB,OAAOO,MAAM,CAACkB,OAAO,CAACJ,QAAQ,EAAGK,KAAK,IAAI;IACxC,IAAI;MACF,OAAOnB,MAAM,CAACoB,OAAO,CAACxB,GAAG,CAACyB,GAAG,CAACF,KAAK,EAAGG,IAAI,IAAKL,KAAK,CAACM,IAAI,CAACD,IAAI,CAA4B,CAAC,CAAC;IAC9F,CAAC,CAAC,OAAOE,KAAK,EAAE;MACd,OAAOxB,MAAM,CAACyB,IAAI,CAAC,IAAIjB,YAAY,CAAC;QAAEG,IAAI,EAAE,MAAM;QAAEa;MAAK,CAAE,CAAC,CAAC;IAC/D;EACF,CAAC,CAAC;AACJ,CAAC,CAAC,CACH;AAEH;;;;;;;;;;;AAWA,OAAO,MAAME,YAAY,GACvBC,MAAS,IAEX,MAQK9B,OAAO,CAAC+B,MAAM,CAAC9B,aAAa,CAACc,MAAM,CAACe,MAAM,CAAC,EAAE,EAAEf,MAAM,EAAE,CAAC;AAE7D;;;;;;;;;;;AAWA,OAAO,MAAMiB,MAAM,GAAGA,CAAA,KAQpBhC,OAAO,CAACgB,aAAa,CAAC,CAACC,QAAQ,EAAEC,MAAM,KACrCf,MAAM,CAACgB,IAAI,CAAC,MAAK;EACf,MAAMc,OAAO,GAAG,IAAIpC,OAAO,EAAE;EAC7B,IAAIqC,UAAU,GAAwCC,SAAS;EAC/D,OAAOhC,MAAM,CAACkB,OAAO,CACnBJ,QAAQ,EACR,SAASmB,IAAIA,CAACd,KAAK;IACjB,MAAMe,GAAG,GAAGtC,GAAG,CAACuC,KAAK,EAAW;IAChC,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGjB,KAAK,CAACkB,MAAM,EAAED,CAAC,EAAE,EAAE;MACrC,IAAIE,GAAG,GAAGnB,KAAK,CAACiB,CAAC,CAAC;MAClB,IAAIL,UAAU,KAAKC,SAAS,EAAE;QAC5B,MAAMO,IAAI,GAAGD,GAAG;QAChBA,GAAG,GAAG,IAAIE,UAAU,CAACT,UAAU,CAACM,MAAM,GAAGC,GAAG,CAACD,MAAM,CAAC;QACpDC,GAAG,CAACG,GAAG,CAACV,UAAU,CAAC;QACnBO,GAAG,CAACG,GAAG,CAACF,IAAI,EAAER,UAAU,CAACM,MAAM,CAAC;QAChCN,UAAU,GAAGC,SAAS;MACxB;MACA,IAAI;QACFE,GAAG,CAACQ,IAAI,CAAC,GAAGZ,OAAO,CAACa,cAAc,CAACL,GAAG,CAAC,CAAC;MAC1C,CAAC,CAAC,OAAOd,KAAK,EAAE;QACd,MAAMoB,KAAK,GAAQpB,KAAK;QACxB,IAAIoB,KAAK,CAACb,UAAU,EAAE;UACpBA,UAAU,GAAGO,GAAG,CAACO,QAAQ,CAACD,KAAK,CAACE,YAAY,CAAC;UAC7C,IAAIF,KAAK,CAACG,MAAM,EAAE;YAChBb,GAAG,CAACQ,IAAI,CAAC,GAAGE,KAAK,CAACG,MAAM,CAAC;UAC3B;QACF,CAAC,MAAM;UACL,OAAO/C,MAAM,CAACyB,IAAI,CAAC,IAAIjB,YAAY,CAAC;YAAEG,IAAI,EAAE,QAAQ;YAAEa;UAAK,CAAE,CAAC,CAAC;QACjE;MACF;IACF;IACA,OAAO5B,GAAG,CAACoD,uBAAuB,CAACd,GAAG,CAAC,GAAGlC,MAAM,CAACoB,OAAO,CAACc,GAAG,CAAC,GAAGlC,MAAM,CAACkB,OAAO,CAACJ,QAAQ,EAAEmB,IAAI,CAAC;EAChG,CAAC,CACF;AACH,CAAC,CAAC,CACH;AAEH;;;;;;;;;;;AAWA,OAAO,MAAMgB,YAAY,GACvBtB,MAAS,IAEX,MAQK9B,OAAO,CAAC+B,MAAM,CAACC,MAAM,EAAY,EAAE/B,aAAa,CAACoD,aAAa,CAACvB,MAAM,CAAC,EAAE,CAAC;AAE9E;;;;;;;;;;;AAWA,OAAO,MAAMwB,MAAM,GACjBC,IAQC,IAUDxC,MAAM,EAAc,CAACyC,IAAI,CACvBxD,OAAO,CAAC+B,MAAM,CAACwB,IAAI,CAAC,EACpBvD,OAAO,CAAC+B,MAAM,CAACC,MAAM,EAAE,CAAC,CACzB;AAEH;;;;;;;;;;;;;AAaA,OAAO,MAAMyB,YAAY,gBA0ErBrD,IAAI,CAAC,CAAC,EAAE,CACVmD,IAQC,EACDG,OAGC,KASEzD,aAAa,CAAC0D,aAAa,CAACL,MAAM,CAACC,IAAI,CAAC,EAAEG,OAAO,CAAC,CAAC;AAexD;;;;;;;;;;AAUA,OAAO,MAAME,cAAc,gBAGvBnD,cAAc,CAACoD,eAAe,CAAC;EACjC7B,MAAMA,CAAC8B,CAAC,EAAEC,QAAQ;IAChB,IAAI;MACF,OAAO5D,MAAM,CAACoB,OAAO,CAACzB,QAAQ,CAACkC,MAAM,CAAC8B,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,OAAOnC,KAAK,EAAE;MACd,OAAOxB,MAAM,CAACyB,IAAI,CAChB,IAAIpB,KAAK,CAACwD,YAAY,CAAC3D,MAAM,CAAC4D,IAAI,CAACH,CAAC,CAAC,EAAE;QACrCjD,OAAO,EAAEP,SAAS,CAAC4D,WAAW,CAACvC,KAAK,EAAE,SAAS,CAAC,GAAGwC,MAAM,CAACxC,KAAK,CAACd,OAAO,CAAC,GAAGsD,MAAM,CAACxC,KAAK;OACxF,CAAC,CACH;IACH;EACF,CAAC;EACDZ,MAAMA,CAACqD,CAAC,EAAEL,QAAQ;IAChB,IAAI;MACF,OAAO5D,MAAM,CAACoB,OAAO,CAACzB,QAAQ,CAACiB,MAAM,CAACqD,CAAC,CAA4B,CAAC;IACtE,CAAC,CAAC,OAAOzC,KAAK,EAAE;MACd,OAAOxB,MAAM,CAACyB,IAAI,CAChB,IAAIpB,KAAK,CAACwD,YAAY,CAAC3D,MAAM,CAAC4D,IAAI,CAACG,CAAC,CAAC,EAAE;QACrCvD,OAAO,EAAEP,SAAS,CAAC4D,WAAW,CAACvC,KAAK,EAAE,SAAS,CAAC,GAAGwC,MAAM,CAACxC,KAAK,CAACd,OAAO,CAAC,GAAGsD,MAAM,CAACxC,KAAK;OACxF,CAAC,CACH;IACH;EACF;CACD,CAAC;AAEF;;;;;;;;;;;AAWA,OAAO,MAAMG,MAAM,GAA0BA,MAAS,IACnDvB,MAAM,CAACoC,UAAyD,CAACa,IAAI,CACpEjD,MAAM,CAAC8D,QAAQ,CAACvC,MAAM,EAAE8B,cAAc,CAAC,CACxC","ignoreList":[]}
+{"version":3,"file":"Msgpack.js","names":["Packr","Unpackr","Msgpackr","Arr","Channel","ChannelSchema","Data","Effect","dual","Option","Predicate","Schema","Issue","Transformation","MsgPackErrorTypeId","MsgPackError","TaggedError","message","kind","encode","fromTransform","upstream","_scope","sync","packr","flatMap","chunk","succeed","map","item","pack","cause","fail","encodeSchema","schema","pipeTo","decode","unpackr","incomplete","undefined","loop","out","empty","i","length","buf","prev","Uint8Array","set","push","unpackMultiple","error","subarray","lastPosition","values","isReadonlyArrayNonEmpty","decodeSchema","decodeUnknown","duplex","self","pipe","duplexSchema","options","duplexUnknown","transformation","transformOrFail","e","_options","InvalidValue","some","hasProperty","String","t","decodeTo"],"sources":["../../../src/unstable/encoding/Msgpack.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/encoding/Ndjson.d.ts

@@ -1,19 +1,33 @@
 /**
- * Utilities for encoding Effect channel payloads and schema values as
- * newline-delimited JSON.
+ * Encode and decode newline-delimited JSON streams in Effect channels.
+ *
+ * NDJSON represents a stream as one complete JSON value per line. This module
+ * keeps that framing explicit for streaming boundaries: byte helpers handle
+ * UTF-8 transport chunks, string helpers handle already-decoded text, and
+ * schema helpers validate or transform each record at the edge of the pipeline.
+ *
+ * **Mental model**
+ *
+ * - Encoders receive non-empty chunks of values and emit one NDJSON chunk ending
+ *   with a newline
+ * - Decoders accumulate partial lines across input chunks and emit parsed JSON
+ *   records as soon as complete lines are available
+ * - Schema helpers compose channel encoding and decoding with the plain NDJSON
+ *   framing helpers
+ *
+ * **Common tasks**
+ *
+ * - Encode values to UTF-8 bytes: {@link encode}
+ * - Encode values to strings: {@link encodeString}
+ * - Decode UTF-8 bytes or strings: {@link decode}, {@link decodeString}
+ * - Add schema validation at the boundary: {@link encodeSchema}, {@link decodeSchema}
+ *
+ * **Gotchas**
  *
- * NDJSON represents a stream as one complete JSON value per line, making this
- * module useful for log pipelines, long-lived HTTP responses, socket protocols,
- * and file formats where records should be processed incrementally instead of
- * buffering a whole JSON array. Use the byte helpers at transport boundaries
- * that speak UTF-8, the string helpers when text framing is already handled,
- * and the schema-aware helpers when each record should be validated or
- * transformed at the boundary.
- *
- * Encoders append a trailing newline after each emitted chunk, and decoders
- * tolerate records split across input chunks. Empty lines are only skipped when
- * `ignoreEmptyLines` is enabled; otherwise they are passed to `JSON.parse` and
- * fail like any other invalid JSON record.
+ * - Records must be valid JSON values, not JavaScript expressions
+ * - Empty lines are ignored only when `ignoreEmptyLines` is enabled
+ * - Encoders append a trailing newline, so downstream consumers should treat it
+ *   as record framing rather than as an extra record
  *
  * @since 4.0.0
  */

package/dist/unstable/encoding/Ndjson.d.ts.map

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

package/dist/unstable/encoding/Ndjson.js

@@ -1,19 +1,33 @@
 /**
- * Utilities for encoding Effect channel payloads and schema values as
- * newline-delimited JSON.
+ * Encode and decode newline-delimited JSON streams in Effect channels.
+ *
+ * NDJSON represents a stream as one complete JSON value per line. This module
+ * keeps that framing explicit for streaming boundaries: byte helpers handle
+ * UTF-8 transport chunks, string helpers handle already-decoded text, and
+ * schema helpers validate or transform each record at the edge of the pipeline.
+ *
+ * **Mental model**
+ *
+ * - Encoders receive non-empty chunks of values and emit one NDJSON chunk ending
+ *   with a newline
+ * - Decoders accumulate partial lines across input chunks and emit parsed JSON
+ *   records as soon as complete lines are available
+ * - Schema helpers compose channel encoding and decoding with the plain NDJSON
+ *   framing helpers
+ *
+ * **Common tasks**
+ *
+ * - Encode values to UTF-8 bytes: {@link encode}
+ * - Encode values to strings: {@link encodeString}
+ * - Decode UTF-8 bytes or strings: {@link decode}, {@link decodeString}
+ * - Add schema validation at the boundary: {@link encodeSchema}, {@link decodeSchema}
+ *
+ * **Gotchas**
  *
- * NDJSON represents a stream as one complete JSON value per line, making this
- * module useful for log pipelines, long-lived HTTP responses, socket protocols,
- * and file formats where records should be processed incrementally instead of
- * buffering a whole JSON array. Use the byte helpers at transport boundaries
- * that speak UTF-8, the string helpers when text framing is already handled,
- * and the schema-aware helpers when each record should be validated or
- * transformed at the boundary.
- *
- * Encoders append a trailing newline after each emitted chunk, and decoders
- * tolerate records split across input chunks. Empty lines are only skipped when
- * `ignoreEmptyLines` is enabled; otherwise they are passed to `JSON.parse` and
- * fail like any other invalid JSON record.
+ * - Records must be valid JSON values, not JavaScript expressions
+ * - Empty lines are ignored only when `ignoreEmptyLines` is enabled
+ * - Encoders append a trailing newline, so downstream consumers should treat it
+ *   as record framing rather than as an extra record
  *
  * @since 4.0.0
  */

package/dist/unstable/encoding/Ndjson.js.map

@@ -1 +1 @@
-{"version":3,"file":"Ndjson.js","names":["Arr","Channel","ChannelSchema","Data","Effect","dual","identity","NdjsonErrorTypeId","encoder","TextEncoder","NdjsonError","TaggedError","message","kind","encodeString","fromTransform","upstream","_scope","succeed","flatMap","input","of","map","item","JSON","stringify","join","cause","fail","encode","_","encodeSchema","schema","pipeTo","encodeSchemaString","decodeString","options","lines","splitLines","pipe","ignoreEmptyLines","filterArray","line","length","mapEffect","chunk","parse","decode","decodeText","decodeSchema","decodeUnknown","decodeSchemaString","duplex","args","isChannel","self","duplexString","duplexSchema","duplexUnknown","duplexSchemaString"],"sources":["../../../src/unstable/encoding/Ndjson.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Ndjson.js","names":["Arr","Channel","ChannelSchema","Data","Effect","dual","identity","NdjsonErrorTypeId","encoder","TextEncoder","NdjsonError","TaggedError","message","kind","encodeString","fromTransform","upstream","_scope","succeed","flatMap","input","of","map","item","JSON","stringify","join","cause","fail","encode","_","encodeSchema","schema","pipeTo","encodeSchemaString","decodeString","options","lines","splitLines","pipe","ignoreEmptyLines","filterArray","line","length","mapEffect","chunk","parse","decode","decodeText","decodeSchema","decodeUnknown","decodeSchemaString","duplex","args","isChannel","self","duplexString","duplexSchema","duplexUnknown","duplexSchemaString"],"sources":["../../../src/unstable/encoding/Ndjson.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,OAAO,KAAKA,GAAG,MAAM,gBAAgB;AACrC,OAAO,KAAKC,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,aAAa,MAAM,wBAAwB;AACvD,OAAO,KAAKC,IAAI,MAAM,eAAe;AACrC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,SAASC,IAAI,EAAEC,QAAQ,QAAQ,mBAAmB;AAGlD,MAAMC,iBAAiB,GAAG,qCAAqC;AAE/D,MAAMC,OAAO,gBAAG,IAAIC,WAAW,EAAE;AAEjC;;;;;;;;;;;AAWA,OAAM,MAAOC,WAAY,sBAAQP,IAAI,CAACQ,WAAW,CAAC,aAAa,CAG7D;EACA;;;;;EAKS,CAACJ,iBAAiB,IAAIA,iBAAiB;EAEhD;;;;;EAKA,IAAaK,OAAOA,CAAA;IAClB,OAAO,IAAI,CAACC,IAAI;EAClB;;AAGF;;;;;;;;;;;AAWA,OAAO,MAAMC,YAAY,GAAGA,CAAA,KAQ1Bb,OAAO,CAACc,aAAa,CAAC,CAACC,QAAQ,EAAEC,MAAM,KACrCb,MAAM,CAACc,OAAO,CAACd,MAAM,CAACe,OAAO,CAACH,QAAQ,EAAGI,KAAK,IAAI;EAChD,IAAI;IACF,OAAOhB,MAAM,CAACc,OAAO,CAAClB,GAAG,CAACqB,EAAE,CAACD,KAAK,CAACE,GAAG,CAAEC,IAAI,IAAKC,IAAI,CAACC,SAAS,CAACF,IAAI,CAAC,CAAC,CAACG,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;EAC5F,CAAC,CAAC,OAAOC,KAAK,EAAE;IACd,OAAOvB,MAAM,CAACwB,IAAI,CAAC,IAAIlB,WAAW,CAAC;MAAEG,IAAI,EAAE,MAAM;MAAEc;IAAK,CAAE,CAAC,CAAC;EAC9D;AACF,CAAC,CAAC,CAAC,CACJ;AAEH;;;;;;AAMA,OAAO,MAAME,MAAM,GAAGA,CAAA,KAOjB5B,OAAO,CAACqB,GAAG,CAACR,YAAY,EAAE,EAAEd,GAAG,CAACsB,GAAG,CAAEQ,CAAC,IAAKtB,OAAO,CAACqB,MAAM,CAACC,CAAC,CAAC,CAAC,CAAC;AAEnE;;;;;;;;;;;AAWA,OAAO,MAAMC,YAAY,GACvBC,MAAS,IAEX,MAQK/B,OAAO,CAACgC,MAAM,CAAC/B,aAAa,CAAC2B,MAAM,CAACG,MAAM,CAAC,EAAE,EAAEH,MAAM,EAAE,CAAC;AAE7D;;;;;;;;;;;AAWA,OAAO,MAAMK,kBAAkB,GAC7BF,MAAS,IAEX,MAQK/B,OAAO,CAACgC,MAAM,CAAC/B,aAAa,CAAC2B,MAAM,CAACG,MAAM,CAAC,EAAE,EAAElB,YAAY,EAAE,CAAC;AAEnE;;;;;;;;;;;;;;;AAeA,OAAO,MAAMqB,YAAY,GAAgCC,OAExD,IAOG;EACF,MAAMC,KAAK,GAAGpC,OAAO,CAACqC,UAAU,EAAY,CAACC,IAAI,CAC/CH,OAAO,EAAEI,gBAAgB,KAAK,IAAI,GAChCvC,OAAO,CAACwC,WAAW,CAAEC,IAAI,IAAKA,IAAI,CAACC,MAAM,GAAG,CAAC,CAAC,GAC9CrC,QAAQ,CACX;EACD,OAAOL,OAAO,CAAC2C,SAAS,CAACP,KAAK,EAAGQ,KAAK,IAAI;IACxC,IAAI;MACF,OAAOzC,MAAM,CAACc,OAAO,CAAClB,GAAG,CAACsB,GAAG,CAACuB,KAAK,EAAGH,IAAI,IAAKlB,IAAI,CAACsB,KAAK,CAACJ,IAAI,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC,OAAOf,KAAK,EAAE;MACd,OAAOvB,MAAM,CAACwB,IAAI,CAAC,IAAIlB,WAAW,CAAC;QAAEG,IAAI,EAAE,QAAQ;QAAEc;MAAK,CAAE,CAAC,CAAC;IAChE;EACF,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;AAWA,OAAO,MAAMoB,MAAM,GAAgCX,OAElD,IAOG;EACF,OAAOnC,OAAO,CAACgC,MAAM,CAAChC,OAAO,CAAC+C,UAAU,EAAE,EAAEb,YAAY,CAACC,OAAO,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;;;;;AAWA,OAAO,MAAMa,YAAY,GACvBjB,MAAS,IAEkBI,OAE5B,IAQInC,OAAO,CAACgC,MAAM,CAACc,MAAM,CAACX,OAAO,CAAC,EAAElC,aAAa,CAACgD,aAAa,CAAClB,MAAM,CAAC,EAAE,CAAC;AAE3E;;;;;;;;;;;AAWA,OAAO,MAAMmB,kBAAkB,GAC7BnB,MAAS,IAEkBI,OAE5B,IAQInC,OAAO,CAACgC,MAAM,CAACE,YAAY,CAACC,OAAO,CAAC,EAAElC,aAAa,CAACgD,aAAa,CAAClB,MAAM,CAAC,EAAE,CAAC;AAEjF;;;;;;;;;;;AAWA,OAAO,MAAMoB,MAAM,gBAoEf/C,IAAI,CAAEgD,IAAI,IAAKpD,OAAO,CAACqD,SAAS,CAACD,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAC7CE,IAQC,EACDnB,OAEC,KAUDnC,OAAO,CAACgC,MAAM,CACZhC,OAAO,CAACgC,MAAM,CAACJ,MAAM,EAAE,EAAE0B,IAAI,CAAC,EAC9BR,MAAM,CAACX,OAAO,CAAC,CAChB,CAAC;AAEJ;;;;;;;;;;;AAWA,OAAO,MAAMoB,YAAY,gBAoErBnD,IAAI,CAAEgD,IAAI,IAAKpD,OAAO,CAACqD,SAAS,CAACD,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAC7CE,IAQC,EACDnB,OAEC,KAUDnC,OAAO,CAACgC,MAAM,CACZhC,OAAO,CAACgC,MAAM,CAACnB,YAAY,EAAE,EAAEyC,IAAI,CAAC,EACpCpB,YAAY,CAACC,OAAO,CAAC,CACtB,CAAC;AAEJ;;;;;;;;;;;;AAYA,OAAO,MAAMqB,YAAY,gBA0ErBpD,IAAI,CAAC,CAAC,EAAE,CACVkD,IAQC,EACDnB,OAIC,KASElC,aAAa,CAACwD,aAAa,CAACN,MAAM,CAACG,IAAI,EAAEnB,OAAO,CAAC,EAAEA,OAAO,CAAC,CAAC;AAEjE;;;;;;;;;;;;AAYA,OAAO,MAAMuB,kBAAkB,gBA0E3BtD,IAAI,CAAC,CAAC,EAAE,CACVkD,IAQC,EACDnB,OAIC,KASElC,aAAa,CAACwD,aAAa,CAACF,YAAY,CAACD,IAAI,EAAEnB,OAAO,CAAC,EAAEA,OAAO,CAAC,CAAC","ignoreList":[]}

package/dist/unstable/encoding/Sse.d.ts

@@ -1,20 +1,41 @@
 /**
  * Utilities for parsing and rendering Server-Sent Events text streams.
  *
- * This module is useful at HTTP streaming boundaries that speak the EventSource
- * wire format, such as live updates, notifications, progress feeds, and other
- * unidirectional server-to-client event streams. It provides low-level parser
- * and encoder primitives, channel combinators for streaming chunks through
- * Effect pipelines, and schema-aware helpers for validating or transforming the
- * `id`, `event`, and string `data` fields at the edge of an application.
- *
- * SSE is line-oriented text rather than a framed binary protocol. Incoming
- * chunks may split fields across arbitrary boundaries, events are dispatched by
- * a blank line, repeated `data:` lines are joined with newlines, and `retry:`
- * directives are control messages rather than regular events. The decoder
- * handles UTF-8 byte order marks, CRLF and LF line endings, default `message`
- * events, and retry directives so callers can reconnect with the requested
- * delay while preserving the last event ID when available.
+ * SSE is the EventSource wire format used by live updates, notifications,
+ * progress feeds, and other unidirectional server-to-client HTTP streams. This
+ * module provides low-level parser and encoder primitives, channel combinators
+ * for streaming text chunks through Effect pipelines, and schema-aware helpers
+ * for validating or transforming the `id`, `event`, and string `data` fields
+ * at the edge of an application.
+ *
+ * **Mental model**
+ *
+ * - SSE is line-oriented text, not a framed binary protocol.
+ * - Incoming chunks may split fields across arbitrary boundaries, so decoders
+ *   buffer incomplete lines until a full event is available.
+ * - A blank line dispatches an event; repeated `data:` lines are joined with
+ *   newlines.
+ * - `retry:` directives are control messages. Decoders surface them as
+ *   {@link Retry} failures so callers can reconnect with the requested delay.
+ *
+ * **Common tasks**
+ *
+ * - Parse string chunks into {@link Event} values: {@link decode}
+ * - Decode events with a schema: {@link decodeSchema}
+ * - JSON-decode each event `data` field with a schema:
+ *   {@link decodeDataSchema}
+ * - Feed a stateful parser manually: {@link makeParser}
+ * - Encode {@link Event} values as SSE text: {@link encode}, {@link encoder}
+ * - Schema-encode domain values before writing SSE text: {@link encodeSchema}
+ *
+ * **Gotchas**
+ *
+ * - Event `data` is text. Use {@link decodeDataSchema} when the data field
+ *   contains JSON that should be decoded into a domain value.
+ * - The default event name is `message`; the encoder omits the `event:` line
+ *   for that default.
+ * - The decoder handles UTF-8 byte order marks, CRLF and LF line endings, and
+ *   retry directives while preserving the last event ID when available.
  *
  * @since 4.0.0
  */
@@ -168,8 +189,8 @@ export declare const Event: Schema.Struct<{
     readonly data: Schema.String;
 }>;
 /**
- * Schema transformation between the untagged SSE event shape and the tagged
- * `Event` model.
+ * Schema for transforming untagged SSE event payloads into tagged `Event`
+ * models.
  *
  * @category models
  * @since 4.0.0
@@ -200,7 +221,7 @@ declare const Retry_base: new <A extends Record<string, any> = {}>(args: import(
     readonly _tag: "Retry";
 } & import("../../Pipeable.ts").Pipeable;
 /**
- * Server-Sent Events retry directive.
+ * Represents a Server-Sent Events retry directive.
  *
  * **Details**
  *

package/dist/unstable/encoding/Sse.d.ts.map

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

package/dist/unstable/encoding/Sse.js

@@ -280,8 +280,8 @@ export const Event = /*#__PURE__*/Schema.Struct({
   data: Schema.String
 });
 /**
- * Schema transformation between the untagged SSE event shape and the tagged
- * `Event` model.
+ * Schema for transforming untagged SSE event payloads into tagged `Event`
+ * models.
  *
  * @category models
  * @since 4.0.0
@@ -297,7 +297,7 @@ export const transformEvent = /*#__PURE__*/Transformation.transform({
 });
 const RetryTypeId = "~effect/encoding/Sse/Retry";
 /**
- * Server-Sent Events retry directive.
+ * Represents a Server-Sent Events retry directive.
  *
  * **Details**
  *