effect 4.0.0-beta.70 → 4.0.0-beta.71

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

@@ -2,47 +2,10 @@
  * @since 4.0.0
  */
 /**
- * Utilities for defining schema-backed domain models that need different shapes
- * for database access and JSON APIs.
- *
- * A model defined with this module keeps one field declaration as the source of
- * truth and derives the `select`, `insert`, `update`, `json`, `jsonCreate`, and
- * `jsonUpdate` variants from it. This is useful for persistence models whose
- * database representation differs from the public API, for example generated
- * columns, application-generated identifiers, sensitive fields that must not be
- * serialized to JSON, nullable database columns exposed as `Option`, SQLite
- * booleans, JSON stored as text, date-time audit columns, and generated UUIDs.
- *
- * Each variant is a schema in its own right, so choose the variant that matches
- * the boundary you are validating or encoding. Plain schemas are included in all
- * variants, while `Field` helpers opt a property into only the variants they
- * declare. Overrideable defaults such as timestamp helpers can still be provided
- * explicitly with `Override`, and JSON variants may differ from database variants
- * in both optionality and encoded representation.
- *
  * @since 4.0.0
  */
 export * as Model from "./Model.ts";
 /**
- * Build families of related struct schemas from one field definition.
- *
- * `VariantSchema` is useful when the same domain object needs several schema
- * views, such as database select / insert / update shapes, JSON read / write
- * shapes, public versus private API views, or constructor schemas with
- * generated defaults. {@link make} fixes a closed set of variant names and a
- * default variant, then returns helpers for defining shared `Struct` values,
- * per-variant `Field` values, schema classes, unions, and extracted
- * `Schema.Struct` projections.
- *
- * A plain schema in a variant struct is present in every variant, a `Field`
- * contributes a property only to the variants named in its config, and nested
- * variant structs are extracted recursively. Variants are projections, not
- * discriminated alternatives: this module does not add a tag field, so include
- * an explicit literal tag when a decoded union needs runtime discrimination.
- * Also remember that the default variant is the schema used by generated
- * classes and ordinary variant unions; per-variant schemas are exposed
- * separately on those generated values.
- *
  * @since 4.0.0
  */
 export * as VariantSchema from "./VariantSchema.ts";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/unstable/schema/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAEnC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/unstable/schema/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAEnC;;GAEG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA"}

package/dist/unstable/schema/index.js

@@ -3,47 +3,10 @@
  */
 // @barrel: Auto-generated exports. Do not edit manually.
 /**
- * Utilities for defining schema-backed domain models that need different shapes
- * for database access and JSON APIs.
- *
- * A model defined with this module keeps one field declaration as the source of
- * truth and derives the `select`, `insert`, `update`, `json`, `jsonCreate`, and
- * `jsonUpdate` variants from it. This is useful for persistence models whose
- * database representation differs from the public API, for example generated
- * columns, application-generated identifiers, sensitive fields that must not be
- * serialized to JSON, nullable database columns exposed as `Option`, SQLite
- * booleans, JSON stored as text, date-time audit columns, and generated UUIDs.
- *
- * Each variant is a schema in its own right, so choose the variant that matches
- * the boundary you are validating or encoding. Plain schemas are included in all
- * variants, while `Field` helpers opt a property into only the variants they
- * declare. Overrideable defaults such as timestamp helpers can still be provided
- * explicitly with `Override`, and JSON variants may differ from database variants
- * in both optionality and encoded representation.
- *
  * @since 4.0.0
  */
 export * as Model from "./Model.js";
 /**
- * Build families of related struct schemas from one field definition.
- *
- * `VariantSchema` is useful when the same domain object needs several schema
- * views, such as database select / insert / update shapes, JSON read / write
- * shapes, public versus private API views, or constructor schemas with
- * generated defaults. {@link make} fixes a closed set of variant names and a
- * default variant, then returns helpers for defining shared `Struct` values,
- * per-variant `Field` values, schema classes, unions, and extracted
- * `Schema.Struct` projections.
- *
- * A plain schema in a variant struct is present in every variant, a `Field`
- * contributes a property only to the variants named in its config, and nested
- * variant structs are extracted recursively. Variants are projections, not
- * discriminated alternatives: this module does not add a tag field, so include
- * an explicit literal tag when a decoded union needs runtime discrimination.
- * Also remember that the default variant is the schema used by generated
- * classes and ordinary variant unions; per-variant schemas are exposed
- * separately on those generated values.
- *
  * @since 4.0.0
  */
 export * as VariantSchema from "./VariantSchema.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["Model","VariantSchema"],"sources":["../../../src/unstable/schema/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAIA;AAEA;;;;;;;;;;;;;;;;;;;;;AAqBA,OAAO,KAAKA,KAAK,MAAM,YAAY;AAEnC;;;;;;;;;;;;;;;;;;;;;;AAsBA,OAAO,KAAKC,aAAa,MAAM,oBAAoB","ignoreList":[]}
+{"version":3,"file":"index.js","names":["Model","VariantSchema"],"sources":["../../../src/unstable/schema/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAIA;AAEA;;;AAGA,OAAO,KAAKA,KAAK,MAAM,YAAY;AAEnC;;;AAGA,OAAO,KAAKC,aAAa,MAAM,oBAAoB","ignoreList":[]}

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

@@ -2,54 +2,10 @@
  * @since 4.0.0
  */
 /**
- * Effect-based socket abstractions for bidirectional connections that exchange
- * text frames, binary frames, and close events.
- *
- * This module defines the `Socket` service, constructors for WebSocket-backed
- * and transform-stream-backed sockets, typed socket errors, and adapters that
- * expose a socket as a bidirectional `Channel`. It is intended for WebSocket
- * clients, HTTP server upgrades, protocol clients and servers, and tests or
- * adapters that need a scoped duplex transport inside Effect programs.
- *
- * Incoming data can be consumed as raw frames, binary bytes, or strings.
- * `runRaw` preserves whether the transport delivered a string or `Uint8Array`,
- * while `run` encodes string frames as UTF-8 bytes and `runString` decodes
- * binary frames with `TextDecoder`. Use the raw or mapping APIs when preserving
- * frame boundaries, binary payloads, or text encodings matters.
- *
- * Writers are scoped to an active run and are gated until the underlying
- * connection is open; use `onOpen` when startup writes must wait for that
- * point. Outgoing strings and bytes are sent as data frames, while `CloseEvent`
- * values request a close. Close events are modeled as `SocketCloseError` by
- * default, and `closeCodeIsError` controls which close codes should fail a run
- * versus complete cleanly.
- *
  * @since 4.0.0
  */
 export * as Socket from "./Socket.ts";
 /**
- * Effect service model for servers that accept socket connections and hand each
- * accepted connection to an Effect handler as a `Socket.Socket`.
- *
- * This module contains the shared, platform-independent contract for socket
- * servers: a bound `address`, a long-running `run` accept loop, the TCP and
- * Unix socket address models, and the server-level errors reported while
- * opening or running a server. Concrete transports, such as Node TCP servers or
- * WebSocket servers, provide this service through platform-specific layers.
- *
- * `SocketServer` is commonly used as the server transport for RPC protocols,
- * cluster runners, developer tools, and tests that need an ephemeral TCP port or
- * Unix-domain socket. A server address may differ from the requested listen
- * options after binding, for example when listening on port `0`, so consumers
- * should read the provided `address` from the service.
- *
- * The `run` effect represents the server accept loop and is expected to remain
- * alive until interrupted or until the providing scope is closed. Protocol
- * framing is intentionally outside this module: handlers receive a generic
- * `Socket.Socket`, so callers are responsible for choosing byte, string, raw
- * frame, or higher-level protocol adapters and for treating connection-level
- * failures separately from `SocketServerError` values.
- *
  * @since 4.0.0
  */
 export * as SocketServer from "./SocketServer.ts";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/unstable/socket/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/unstable/socket/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;GAEG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA"}

package/dist/unstable/socket/index.js

@@ -3,54 +3,10 @@
  */
 // @barrel: Auto-generated exports. Do not edit manually.
 /**
- * Effect-based socket abstractions for bidirectional connections that exchange
- * text frames, binary frames, and close events.
- *
- * This module defines the `Socket` service, constructors for WebSocket-backed
- * and transform-stream-backed sockets, typed socket errors, and adapters that
- * expose a socket as a bidirectional `Channel`. It is intended for WebSocket
- * clients, HTTP server upgrades, protocol clients and servers, and tests or
- * adapters that need a scoped duplex transport inside Effect programs.
- *
- * Incoming data can be consumed as raw frames, binary bytes, or strings.
- * `runRaw` preserves whether the transport delivered a string or `Uint8Array`,
- * while `run` encodes string frames as UTF-8 bytes and `runString` decodes
- * binary frames with `TextDecoder`. Use the raw or mapping APIs when preserving
- * frame boundaries, binary payloads, or text encodings matters.
- *
- * Writers are scoped to an active run and are gated until the underlying
- * connection is open; use `onOpen` when startup writes must wait for that
- * point. Outgoing strings and bytes are sent as data frames, while `CloseEvent`
- * values request a close. Close events are modeled as `SocketCloseError` by
- * default, and `closeCodeIsError` controls which close codes should fail a run
- * versus complete cleanly.
- *
  * @since 4.0.0
  */
 export * as Socket from "./Socket.js";
 /**
- * Effect service model for servers that accept socket connections and hand each
- * accepted connection to an Effect handler as a `Socket.Socket`.
- *
- * This module contains the shared, platform-independent contract for socket
- * servers: a bound `address`, a long-running `run` accept loop, the TCP and
- * Unix socket address models, and the server-level errors reported while
- * opening or running a server. Concrete transports, such as Node TCP servers or
- * WebSocket servers, provide this service through platform-specific layers.
- *
- * `SocketServer` is commonly used as the server transport for RPC protocols,
- * cluster runners, developer tools, and tests that need an ephemeral TCP port or
- * Unix-domain socket. A server address may differ from the requested listen
- * options after binding, for example when listening on port `0`, so consumers
- * should read the provided `address` from the service.
- *
- * The `run` effect represents the server accept loop and is expected to remain
- * alive until interrupted or until the providing scope is closed. Protocol
- * framing is intentionally outside this module: handlers receive a generic
- * `Socket.Socket`, so callers are responsible for choosing byte, string, raw
- * frame, or higher-level protocol adapters and for treating connection-level
- * failures separately from `SocketServerError` values.
- *
  * @since 4.0.0
  */
 export * as SocketServer from "./SocketServer.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["Socket","SocketServer"],"sources":["../../../src/unstable/socket/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAIA;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,OAAO,KAAKA,MAAM,MAAM,aAAa;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,OAAO,KAAKC,YAAY,MAAM,mBAAmB","ignoreList":[]}
+{"version":3,"file":"index.js","names":["Socket","SocketServer"],"sources":["../../../src/unstable/socket/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAIA;AAEA;;;AAGA,OAAO,KAAKA,MAAM,MAAM,aAAa;AAErC;;;AAGA,OAAO,KAAKC,YAAY,MAAM,mBAAmB","ignoreList":[]}

package/dist/unstable/sql/Migrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Migrator.d.ts","sourceRoot":"","sources":["../../../src/unstable/sql/Migrator.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAIhD,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAA;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C;;;;;;GAMG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,KAAK;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,CAC3C,aAAa,CAAC,iBAAiB,CAAC,EAChC,cAAc,EACd,CAAC,CACF,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS;IACvC,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC;CAChD,CAAA;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;CACzB;;;;AAED;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,oBAAmC;IACrE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,IAAI,EACT,UAAU,GACV,aAAa,GACb,QAAQ,GACR,YAAY,GACZ,QAAQ,CAAA;IACZ,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,CAAC;CAAG;AAEL;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,GAAI,EAAE,GAAG,KAAK,EAAE,gBAE9B;IACD,UAAU,CAAC,EAAE,CACX,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,KACpB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,CAAC,CAAA;CAC7C,MACA,EAAE,GAAG,KAAK,EAAE,oCAIV,eAAe,CAAC,EAAE,CAAC,KAAG,MAAM,CAAC,MAAM,CACpC,aAAa,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,EAClD,cAAc,GAAG,QAAQ,EACzB,MAAM,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,CA+MxB,CAAA;AAOJ;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GACnB,YAAY,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,KAC7C,MAaA,CAAA;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,YAAY,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAG,MAa7D,CAAA;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,YAAY,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,KAAG,MAarG,CAAA;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,UAAU,CAkCnE,CAAA"}
+{"version":3,"file":"Migrator.d.ts","sourceRoot":"","sources":["../../../src/unstable/sql/Migrator.ts"],"names":[],"mappings":"AA+CA,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAIhD,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAA;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C;;;;;;GAMG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,KAAK;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,CAC3C,aAAa,CAAC,iBAAiB,CAAC,EAChC,cAAc,EACd,CAAC,CACF,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS;IACvC,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC;CAChD,CAAA;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;CACzB;;;;AAED;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,oBAAmC;IACrE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,IAAI,EACT,UAAU,GACV,aAAa,GACb,QAAQ,GACR,YAAY,GACZ,QAAQ,CAAA;IACZ,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,CAAC;CAAG;AAEL;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,GAAI,EAAE,GAAG,KAAK,EAAE,gBAE9B;IACD,UAAU,CAAC,EAAE,CACX,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,KACpB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,CAAC,CAAA;CAC7C,MACA,EAAE,GAAG,KAAK,EAAE,oCAIV,eAAe,CAAC,EAAE,CAAC,KAAG,MAAM,CAAC,MAAM,CACpC,aAAa,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,EAClD,cAAc,GAAG,QAAQ,EACzB,MAAM,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,CA+MxB,CAAA;AAOJ;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GACnB,YAAY,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,KAC7C,MAaA,CAAA;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,YAAY,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAG,MAa7D,CAAA;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,YAAY,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,KAAG,MAarG,CAAA;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,UAAU,CAkCnE,CAAA"}

package/dist/unstable/sql/Migrator.js

@@ -7,26 +7,47 @@ var __rewriteRelativeImportExtension = this && this.__rewriteRelativeImportExten
   return path;
 };
 /**
- * Effect SQL migration helpers for loading, ordering, and running schema
- * changes against a `SqlClient`.
+ * SQL migration runner for Effect applications.
  *
- * This module provides a migrator constructor plus loaders for common migration
- * layouts, including dynamic glob imports, Babel-style glob records, in-memory
- * records, and filesystem directories. It is intended for applications and
- * libraries that need to apply numbered SQL migrations on startup, in tests, or
- * as part of deployment tooling while keeping migration effects inside the
- * Effect environment.
+ * A migrator loads numbered migration effects, records which ids have already
+ * run in a migrations table, and executes only the pending migrations through a
+ * `SqlClient`. The helpers in this module cover the common ways migrations are
+ * discovered: dynamic glob imports, Babel-style glob records, in-memory
+ * records, and filesystem directories.
  *
- * The migrator tracks applied migrations in a configurable table, defaults that
- * table to `effect_sql_migrations`, rejects duplicate migration ids, and only
- * runs migrations with an id greater than the latest recorded id. Pending
- * migrations are recorded and executed inside a `SqlClient` transaction; on
- * PostgreSQL the migrations table is explicitly locked, while other dialects
- * rely on the table's primary key or unique constraint to detect concurrent
- * runners. Migration effects should therefore be written to be transaction-aware,
- * and callers should account for dialect-specific DDL transaction behavior and
- * custom table names when coordinating schema dumps or external migration
- * tooling.
+ * **Mental model**
+ *
+ * - A {@link Loader} resolves an ordered list of {@link ResolvedMigration}
+ *   values
+ * - {@link make} creates a runner that ensures the migrations table exists,
+ *   reads the latest recorded id, loads pending migration effects, records
+ *   them, and runs them in a transaction
+ * - The default migrations table is `effect_sql_migrations`; pass `table` when
+ *   a database needs a different name
+ * - On PostgreSQL the migrations table is explicitly locked; other dialects use
+ *   the table constraint to detect concurrent runners
+ * - `schemaDirectory` runs the `dumpSchema` hook after successful migrations
+ *
+ * **Common tasks**
+ *
+ * - Load bundler migration modules with {@link fromGlob} or
+ *   {@link fromBabelGlob}
+ * - Load test or programmatic migrations with {@link fromRecord}
+ * - Load migration files from a directory with {@link fromFileSystem}
+ * - Customize schema dumps by passing `dumpSchema` to {@link make}
+ *
+ * **Gotchas**
+ *
+ * - Migration ids must be unique numbers; duplicate ids fail before any pending
+ *   migration is run
+ * - Only ids greater than the latest recorded id are considered pending, so
+ *   editing or inserting an older migration does not make it run again
+ * - File-based migrations must match `<id>_<name>.js`, `<id>_<name>.ts`,
+ *   `<id>_<name>.mjs`, or `<id>_<name>.mts`
+ * - File-based migration modules should default-export an `Effect` value that
+ *   uses the current `SqlClient`; records can supply effects directly
+ * - DDL transaction behavior is dialect-specific; coordinate custom table
+ *   names, schema dumps, and external migration tooling accordingly
  *
  * @since 4.0.0
  */

package/dist/unstable/sql/Migrator.js.map

@@ -1 +1 @@
-{"version":3,"file":"Migrator.js","names":["Arr","Data","Effect","FileSystem","pipe","Option","Order","Client","MigrationError","TaggedError","make","dumpSchema","void","loader","schemaDirectory","table","gen","sql","SqlClient","ensureMigrationsTable","onDialectOrElse","mssql","literal","mysql","pg","catch","orElse","insertMigrations","rows","insert","map","migration_id","name","withoutTransform","latestMigration","_","fromNullishOr","created_at","id","createdAt","loadMigration","load","catchDefect","fail","kind","message","flatMap","isEffect","succeed","default","filterOrFail","runMigration","effect","error","die","cause","run","latestMigrationId","current","all","match","onNone","onSome","Set","size","length","required","resolved","currentId","currentName","push","mapError","isConstraintConflict","forEach","logDebug","annotateLogs","String","withSpan","discard","toString","completed","withTransaction","catchTag","as","catchCause","logInfo","migrationOrder","a","b","Number","reason","_tag","fromGlob","migrations","Object","keys","flatMapNullishOr","key","promise","sort","fromBabelGlob","fromRecord","fromFileSystem","fnUntraced","directory","Fs","files","readDirectory","file","basename","__rewriteRelativeImportExtension"],"sources":["../../../src/unstable/sql/Migrator.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Migrator.js","names":["Arr","Data","Effect","FileSystem","pipe","Option","Order","Client","MigrationError","TaggedError","make","dumpSchema","void","loader","schemaDirectory","table","gen","sql","SqlClient","ensureMigrationsTable","onDialectOrElse","mssql","literal","mysql","pg","catch","orElse","insertMigrations","rows","insert","map","migration_id","name","withoutTransform","latestMigration","_","fromNullishOr","created_at","id","createdAt","loadMigration","load","catchDefect","fail","kind","message","flatMap","isEffect","succeed","default","filterOrFail","runMigration","effect","error","die","cause","run","latestMigrationId","current","all","match","onNone","onSome","Set","size","length","required","resolved","currentId","currentName","push","mapError","isConstraintConflict","forEach","logDebug","annotateLogs","String","withSpan","discard","toString","completed","withTransaction","catchTag","as","catchCause","logInfo","migrationOrder","a","b","Number","reason","_tag","fromGlob","migrations","Object","keys","flatMapNullishOr","key","promise","sort","fromBabelGlob","fromRecord","fromFileSystem","fnUntraced","directory","Fs","files","readDirectory","file","basename","__rewriteRelativeImportExtension"],"sources":["../../../src/unstable/sql/Migrator.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/sql/SqlError.d.ts.map

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

package/dist/unstable/sql/SqlError.js

@@ -1,21 +1,37 @@
 /**
- * Structured SQL errors used by the unstable SQL APIs.
+ * Structured SQL failures for unstable SQL clients and driver integrations.
  *
- * This module defines the top-level `SqlError` wrapper, the concrete
- * `SqlErrorReason` variants used by drivers and adapters, and helpers for
- * recognizing and classifying database failures. It is useful when turning
- * native driver errors into typed Effect failures, choosing retry policies from
- * `isRetryable`, or distinguishing user-facing query problems such as syntax
- * and constraint failures from infrastructure problems such as connection,
- * lock, statement timeout, deadlock, and serialization failures.
+ * This module provides the top-level `SqlError` wrapper, the concrete
+ * `SqlErrorReason` variants used by adapters, schemas for encoding or decoding
+ * those errors, guards for recognizing them, and a SQLite classifier for native
+ * driver causes. The model keeps query mistakes, authentication and
+ * authorization failures, constraint violations, connection failures, lock
+ * waits, deadlocks, serialization conflicts, statement timeouts, and unknown
+ * failures distinguishable in the Effect error channel.
  *
- * Query, connection, and migration code should preserve the original cause and
- * operation metadata when constructing these errors. Retrying can be appropriate
- * for transient connection and concurrency failures, but syntax, authorization,
- * authentication, and constraint failures generally require changing the query,
- * credentials, permissions, or migration data. When classifying SQLite errors,
- * the helpers inspect `code` and `errno` values and extract unique constraint
- * names when available.
+ * **Mental model**
+ *
+ * `SqlError` wraps exactly one reason. Its `message`, `cause`, and
+ * `isRetryable` values are delegated to that reason, so recovery code can branch
+ * on either the reason tag or the retryability flag without losing the original
+ * native cause. Reasons are intentionally driver-neutral; adapters translate
+ * database-specific error codes into this shared vocabulary.
+ *
+ * **Common tasks**
+ *
+ * Construct a reason when adapting a driver failure, wrap it in `SqlError` for
+ * client APIs, use `isSqlError` or `isSqlErrorReason` at boundaries that receive
+ * unknown failures, and use `classifySqliteError` when mapping SQLite `code` or
+ * `errno` values.
+ *
+ * **Gotchas**
+ *
+ * Preserve the native `cause` and `operation` metadata when constructing these
+ * errors; they are often the only way to diagnose dialect-specific failures.
+ * Retryable reasons represent transient infrastructure or concurrency problems,
+ * while syntax, credential, permission, and constraint failures generally need a
+ * changed query, configuration, or data set. SQLite unique violations include a
+ * best-effort constraint name when one can be extracted.
  *
  * @since 4.0.0
  */

package/dist/unstable/sql/SqlError.js.map

@@ -1 +1 @@
-{"version":3,"file":"SqlError.js","names":["Predicate","Schema","TypeId","ReasonTypeId","ReasonFields","cause","Defect","message","optional","String","operation","ConnectionError","TaggedErrorClass","isRetryable","AuthenticationError","AuthorizationError","SqlSyntaxError","UniqueViolationFields","constraint","UniqueViolation","ConstraintError","DeadlockError","SerializationError","LockTimeoutError","StatementTimeoutError","UnknownError","SqlErrorReason","Union","SqlError","reason","_tag","isSqlError","u","hasProperty","isSqlErrorReason","sqliteCodeFromCause","undefined","code","sqliteNumericCodeFromCause","errno","matchesSqliteNumericCode","expected","matchesSqliteCode","startsWith","UNKNOWN_CONSTRAINT","SQLITE_CONSTRAINT_UNIQUE","SQLITE_CONSTRAINT_UNIQUE_CODE","normalizeConstraintIdentifier","identifier","trimmed","trim","length","sqliteUniqueConstraintFromCause","prefix","index","indexOf","slice","classifySqliteError","props","numericCode","ResultLengthMismatch","Number","actual"],"sources":["../../../src/unstable/sql/SqlError.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"SqlError.js","names":["Predicate","Schema","TypeId","ReasonTypeId","ReasonFields","cause","Defect","message","optional","String","operation","ConnectionError","TaggedErrorClass","isRetryable","AuthenticationError","AuthorizationError","SqlSyntaxError","UniqueViolationFields","constraint","UniqueViolation","ConstraintError","DeadlockError","SerializationError","LockTimeoutError","StatementTimeoutError","UnknownError","SqlErrorReason","Union","SqlError","reason","_tag","isSqlError","u","hasProperty","isSqlErrorReason","sqliteCodeFromCause","undefined","code","sqliteNumericCodeFromCause","errno","matchesSqliteNumericCode","expected","matchesSqliteCode","startsWith","UNKNOWN_CONSTRAINT","SQLITE_CONSTRAINT_UNIQUE","SQLITE_CONSTRAINT_UNIQUE_CODE","normalizeConstraintIdentifier","identifier","trimmed","trim","length","sqliteUniqueConstraintFromCause","prefix","index","indexOf","slice","classifySqliteError","props","numericCode","ResultLengthMismatch","Number","actual"],"sources":["../../../src/unstable/sql/SqlError.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/sql/SqlSchema.d.ts

@@ -1,21 +1,36 @@
 /**
- * Schema-driven helpers for wrapping SQL executions in typed query functions.
+ * Wraps SQL execution callbacks with request encoding and result decoding.
  *
- * This module connects `Schema` request and result definitions to an `execute`
- * callback that runs the actual SQL statement. The returned functions accept
- * the request schema's decoded `Type`, encode it to the SQL-facing `Encoded`
- * shape, run the callback, and then decode unknown driver rows through the
- * result schema. This is useful for repository methods, CRUD helpers, request
- * resolvers, and write operations where callers should work with domain values
- * instead of raw SQL parameters or rows.
+ * `SqlSchema` is a small adapter between Effect Schema and SQL statements. Each
+ * helper builds a function that accepts the decoded request type used by
+ * application code, encodes it before calling `execute`, and decodes unknown
+ * driver rows into the result schema. The helpers differ only in how many rows
+ * they expect and how they represent an empty result set.
  *
- * The `execute` callback always receives `Req["Encoded"]`, so schema
- * transformations, required encoding services, and database representations
- * such as nullable columns, JSON values, dates, and bigints must line up with
- * the statement builder and dialect in use. Result schemas decode the rows
- * returned by the driver after any SQL client row transforms; `findOne` and
- * `findOneOption` only inspect the first row, `findNonEmpty` requires at least
- * one row, and `void` discards any driver result after request encoding.
+ * **Mental model**
+ *
+ * The request schema protects the boundary going into SQL, and the result
+ * schema protects the boundary coming back out. `execute` still owns statement
+ * construction and database execution; this module only shapes the values that
+ * cross that boundary.
+ *
+ * **Common tasks**
+ *
+ * - Use {@link findAll} for queries that may return any number of rows.
+ * - Use {@link findNonEmpty} when an empty result is a failure.
+ * - Use {@link findOne} when the first row is required.
+ * - Use {@link findOneOption} when the first row is optional.
+ * - Use `void` for writes where the encoded request matters but the driver
+ *   result should be discarded.
+ *
+ * **Gotchas**
+ *
+ * `execute` receives `Req["Encoded"]`, not `Req["Type"]`. Any schema
+ * transformations, encoding services, nullable columns, JSON values, dates, and
+ * bigint representations must match the SQL builder and dialect in use. Result
+ * schemas decode rows after SQL client row transforms have run. {@link findOne}
+ * and {@link findOneOption} only inspect the first returned row; they do not
+ * assert that the query returned exactly one row.
  *
  * @since 4.0.0
  */

package/dist/unstable/sql/SqlSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SqlSchema.d.ts","sourceRoot":"","sources":["../../../src/unstable/sql/SqlSchema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAAI,GAAG,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,SAAS,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAC1E,SAAS;IACP,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;CAC3F,MAKC,SAAS,GAAG,CAAC,MAAM,CAAC,KACnB,MAAM,CAAC,MAAM,CACd,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAClB,CAAC,GAAG,MAAM,CAAC,WAAW,EACtB,GAAG,CAAC,kBAAkB,CAAC,GAAG,GAAG,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAExD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,GAAG,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,SAAS,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAC/E,SAAS;IACP,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;CAC3F,MAIC,SAAS,GAAG,CAAC,MAAM,CAAC,KACnB,MAAM,CAAC,MAAM,CACd,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAC9B,CAAC,GAAG,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,kBAAkB,EACjD,GAAG,CAAC,kBAAkB,CAAC,GAAG,GAAG,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAMxD,CAAA;AAED,QAAA,MAAM,KAAK,GAAI,GAAG,SAAS,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EACzC,SAAS;IACP,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;CAC5E,MAGO,SAAS,GAAG,CAAC,MAAM,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,GAAG,GAAG,CAAC,kBAAkB,CAAC,CAIvG,CAAA;AACD,OAAO;AACL;;;;;GAKG;AACH,KAAK,IAAI,IAAI,EACd,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAAI,GAAG,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,SAAS,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAC1E,SAAS;IACP,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;CAC3F,MAKC,SAAS,GAAG,CAAC,MAAM,CAAC,KACnB,MAAM,CAAC,MAAM,CACd,GAAG,CAAC,MAAM,CAAC,EACX,CAAC,GAAG,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,kBAAkB,EACjD,CAAC,GAAG,GAAG,CAAC,kBAAkB,CAAC,GAAG,GAAG,CAAC,kBAAkB,CAAC,CAUxD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,GAAG,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,SAAS,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAChF,SAAS;IACP,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;CAC3F,MAKC,SAAS,GAAG,CAAC,MAAM,CAAC,KACnB,MAAM,CAAC,MAAM,CACd,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAC1B,CAAC,GAAG,MAAM,CAAC,WAAW,EACtB,CAAC,GAAG,GAAG,CAAC,kBAAkB,CAAC,GAAG,GAAG,CAAC,kBAAkB,CAAC,CAUxD,CAAA"}
+{"version":3,"file":"SqlSchema.d.ts","sourceRoot":"","sources":["../../../src/unstable/sql/SqlSchema.ts"],"names":[],"mappings":"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"}

package/dist/unstable/sql/SqlSchema.js

@@ -1,21 +1,36 @@
 /**
- * Schema-driven helpers for wrapping SQL executions in typed query functions.
+ * Wraps SQL execution callbacks with request encoding and result decoding.
  *
- * This module connects `Schema` request and result definitions to an `execute`
- * callback that runs the actual SQL statement. The returned functions accept
- * the request schema's decoded `Type`, encode it to the SQL-facing `Encoded`
- * shape, run the callback, and then decode unknown driver rows through the
- * result schema. This is useful for repository methods, CRUD helpers, request
- * resolvers, and write operations where callers should work with domain values
- * instead of raw SQL parameters or rows.
+ * `SqlSchema` is a small adapter between Effect Schema and SQL statements. Each
+ * helper builds a function that accepts the decoded request type used by
+ * application code, encodes it before calling `execute`, and decodes unknown
+ * driver rows into the result schema. The helpers differ only in how many rows
+ * they expect and how they represent an empty result set.
  *
- * The `execute` callback always receives `Req["Encoded"]`, so schema
- * transformations, required encoding services, and database representations
- * such as nullable columns, JSON values, dates, and bigints must line up with
- * the statement builder and dialect in use. Result schemas decode the rows
- * returned by the driver after any SQL client row transforms; `findOne` and
- * `findOneOption` only inspect the first row, `findNonEmpty` requires at least
- * one row, and `void` discards any driver result after request encoding.
+ * **Mental model**
+ *
+ * The request schema protects the boundary going into SQL, and the result
+ * schema protects the boundary coming back out. `execute` still owns statement
+ * construction and database execution; this module only shapes the values that
+ * cross that boundary.
+ *
+ * **Common tasks**
+ *
+ * - Use {@link findAll} for queries that may return any number of rows.
+ * - Use {@link findNonEmpty} when an empty result is a failure.
+ * - Use {@link findOne} when the first row is required.
+ * - Use {@link findOneOption} when the first row is optional.
+ * - Use `void` for writes where the encoded request matters but the driver
+ *   result should be discarded.
+ *
+ * **Gotchas**
+ *
+ * `execute` receives `Req["Encoded"]`, not `Req["Type"]`. Any schema
+ * transformations, encoding services, nullable columns, JSON values, dates, and
+ * bigint representations must match the SQL builder and dialect in use. Result
+ * schemas decode rows after SQL client row transforms have run. {@link findOne}
+ * and {@link findOneOption} only inspect the first returned row; they do not
+ * assert that the query returned exactly one row.
  *
  * @since 4.0.0
  */