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

package/dist/unstable/socket/SocketServer.js

@@ -1,21 +1,50 @@
 /**
+ * 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
  */
 import * as Context from "../../Context.js";
 import * as Data from "../../Data.js";
 /**
- * @since 4.0.0
+ * Context service for a socket server, exposing its bound address and a run
+ * loop that handles each accepted `Socket`.
+ *
  * @category tags
+ * @since 4.0.0
  */
 export class SocketServer extends /*#__PURE__*/Context.Service()("@effect/platform/SocketServer") {}
 /**
- * @since 4.0.0
+ * Runtime type identifier attached to `SocketServerError` values.
+ *
  * @category errors
+ * @since 4.0.0
  */
 export const ErrorTypeId = "@effect/platform/SocketServer/SocketServerError";
 /**
- * @since 4.0.0
+ * Error reason for failures that occur while opening a socket server.
+ *
  * @category errors
+ * @since 4.0.0
  */
 export class SocketServerOpenError extends /*#__PURE__*/Data.TaggedError("SocketServerOpenError") {
   get message() {
@@ -23,8 +52,10 @@ export class SocketServerOpenError extends /*#__PURE__*/Data.TaggedError("Socket
   }
 }
 /**
- * @since 4.0.0
+ * Error reason for uncategorized socket server failures.
+ *
  * @category errors
+ * @since 4.0.0
  */
 export class SocketServerUnknownError extends /*#__PURE__*/Data.TaggedError("SocketServerUnknownError") {
   get message() {
@@ -32,8 +63,11 @@ export class SocketServerUnknownError extends /*#__PURE__*/Data.TaggedError("Soc
   }
 }
 /**
- * @since 4.0.0
+ * Tagged socket server error that wraps a server error reason and exposes its
+ * cause.
+ *
  * @category errors
+ * @since 4.0.0
  */
 export class SocketServerError extends /*#__PURE__*/Data.TaggedError("SocketServerError") {
   constructor(props) {
@@ -43,10 +77,14 @@ export class SocketServerError extends /*#__PURE__*/Data.TaggedError("SocketServ
     });
   }
   /**
+   * Marks this value as a socket server error for runtime guards.
+   *
    * @since 4.0.0
    */
   [ErrorTypeId] = ErrorTypeId;
   /**
+   * Delegates the public message to the underlying socket server error reason.
+   *
    * @since 4.0.0
    */
   get message() {

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

@@ -1 +1 @@
-{"version":3,"file":"SocketServer.js","names":["Context","Data","SocketServer","Service","ErrorTypeId","SocketServerOpenError","TaggedError","message","SocketServerUnknownError","SocketServerError","constructor","props","cause","reason"],"sources":["../../../src/unstable/socket/SocketServer.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAGA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,IAAI,MAAM,eAAe;AAIrC;;;;AAIA,OAAM,MAAOC,YAAa,sBAAQF,OAAO,CAACG,OAAO,EAK7C,CAAC,+BAA+B,CAAC;AAErC;;;;AAIA,OAAO,MAAMC,WAAW,GAAgB,iDAAiD;AAQzF;;;;AAIA,OAAM,MAAOC,qBAAsB,sBAAQJ,IAAI,CAACK,WAAW,CAAC,uBAAuB,CAEjF;EACA,IAAaC,OAAOA,CAAA;IAClB,OAAO,MAAM;EACf;;AAGF;;;;AAIA,OAAM,MAAOC,wBAAyB,sBAAQP,IAAI,CAACK,WAAW,CAAC,0BAA0B,CAEvF;EACA,IAAaC,OAAOA,CAAA;IAClB,OAAO,SAAS;EAClB;;AASF;;;;AAIA,OAAM,MAAOE,iBAAkB,sBAAQR,IAAI,CAACK,WAAW,CAAC,mBAAmB,CAEzE;EACAI,YAAYC,KAEX;IACC,KAAK,CAAC;MACJ,GAAGA,KAAK;MACRC,KAAK,EAAED,KAAK,CAACE,MAAM,CAACD;KACd,CAAC;EACX;EACA;;;EAGS,CAACR,WAAW,IAAiBA,WAAW;EAEjD;;;EAGA,IAAaG,OAAOA,CAAA;IAClB,OAAO,IAAI,CAACM,MAAM,CAACN,OAAO;EAC5B","ignoreList":[]}
+{"version":3,"file":"SocketServer.js","names":["Context","Data","SocketServer","Service","ErrorTypeId","SocketServerOpenError","TaggedError","message","SocketServerUnknownError","SocketServerError","constructor","props","cause","reason"],"sources":["../../../src/unstable/socket/SocketServer.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,IAAI,MAAM,eAAe;AAIrC;;;;;;;AAOA,OAAM,MAAOC,YAAa,sBAAQF,OAAO,CAACG,OAAO,EAK7C,CAAC,+BAA+B,CAAC;AAErC;;;;;;AAMA,OAAO,MAAMC,WAAW,GAAgB,iDAAiD;AAUzF;;;;;;AAMA,OAAM,MAAOC,qBAAsB,sBAAQJ,IAAI,CAACK,WAAW,CAAC,uBAAuB,CAEjF;EACA,IAAaC,OAAOA,CAAA;IAClB,OAAO,MAAM;EACf;;AAGF;;;;;;AAMA,OAAM,MAAOC,wBAAyB,sBAAQP,IAAI,CAACK,WAAW,CAAC,0BAA0B,CAEvF;EACA,IAAaC,OAAOA,CAAA;IAClB,OAAO,SAAS;EAClB;;AAWF;;;;;;;AAOA,OAAM,MAAOE,iBAAkB,sBAAQR,IAAI,CAACK,WAAW,CAAC,mBAAmB,CAEzE;EACAI,YAAYC,KAEX;IACC,KAAK,CAAC;MACJ,GAAGA,KAAK;MACRC,KAAK,EAAED,KAAK,CAACE,MAAM,CAACD;KACd,CAAC;EACX;EACA;;;;;EAKS,CAACR,WAAW,IAAiBA,WAAW;EAEjD;;;;;EAKA,IAAaG,OAAOA,CAAA;IAClB,OAAO,IAAI,CAACM,MAAM,CAACN,OAAO;EAC5B","ignoreList":[]}

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

@@ -2,10 +2,54 @@
  * @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;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;GAEG;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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA"}

package/dist/unstable/socket/index.js

@@ -3,10 +3,54 @@
  */
 // @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;;;AAGA,OAAO,KAAKA,MAAM,MAAM,aAAa;AAErC;;;AAGA,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;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,OAAO,KAAKA,MAAM,MAAM,aAAa;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,OAAO,KAAKC,YAAY,MAAM,mBAAmB","ignoreList":[]}

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

@@ -3,7 +3,10 @@ import { FileSystem } from "../../FileSystem.ts";
 import * as Client from "./SqlClient.ts";
 import type { SqlError } from "./SqlError.ts";
 /**
- * @category model
+ * Options for running SQL migrations, including the migration loader, optional
+ * schema dump directory, and migrations table name.
+ *
+ * @category models
  * @since 4.0.0
  */
 export interface MigratorOptions<R = never> {
@@ -12,12 +15,18 @@ export interface MigratorOptions<R = never> {
     readonly table?: string;
 }
 /**
- * @category model
+ * Effect that resolves the available migrations for the migrator or fails with a
+ * `MigrationError`.
+ *
+ * @category models
  * @since 4.0.0
  */
 export type Loader<R = never> = Effect.Effect<ReadonlyArray<ResolvedMigration>, MigrationError, R>;
 /**
- * @category model
+ * Tuple produced by a migration loader, containing the migration id, migration
+ * name, and an effect that loads the migration implementation.
+ *
+ * @category models
  * @since 4.0.0
  */
 export type ResolvedMigration = readonly [
@@ -26,7 +35,10 @@ export type ResolvedMigration = readonly [
     load: Effect.Effect<any, any, Client.SqlClient>
 ];
 /**
- * @category model
+ * Metadata for a migration recorded in the migrations table, including its id,
+ * name, and creation timestamp.
+ *
+ * @category models
  * @since 4.0.0
  */
 export interface Migration {
@@ -38,6 +50,8 @@ declare const MigrationError_base: new <A extends Record<string, any> = {}>(args
     readonly _tag: "MigrationError";
 } & Readonly<A>;
 /**
+ * Error raised while loading, validating, locking, or running SQL migrations.
+ *
  * @category errors
  * @since 4.0.0
  */
@@ -49,30 +63,47 @@ export declare class MigrationError extends MigrationError_base<{
 }> {
 }
 /**
- * @category constructor
+ * Creates a migrator that ensures the migrations table exists, runs pending
+ * migrations in a transaction, and optionally dumps the schema after successful
+ * migrations.
+ *
+ * @category constructors
  * @since 4.0.0
  */
 export declare const make: <RD = never>({ dumpSchema }: {
     dumpSchema?: (path: string, migrationsTable: string) => Effect.Effect<void, MigrationError, RD>;
 }) => <R2 = never>({ loader, schemaDirectory, table }: MigratorOptions<R2>) => Effect.Effect<ReadonlyArray<readonly [id: number, name: string]>, MigrationError | SqlError, Client.SqlClient | RD | R2>;
 /**
- * @since 4.0.0
+ * Creates a migration loader from a glob record of dynamic import functions,
+ * parsing files named `<id>_<name>.js` or `<id>_<name>.ts` and sorting
+ * migrations by id.
+ *
  * @category loaders
+ * @since 4.0.0
  */
 export declare const fromGlob: (migrations: Record<string, () => Promise<any>>) => Loader;
 /**
- * @since 4.0.0
+ * Creates a migration loader from a Babel-style glob record, parsing keys such
+ * as `_<id>_<name>Js` or `_<id>_<name>Ts` and sorting migrations by id.
+ *
  * @category loaders
+ * @since 4.0.0
  */
 export declare const fromBabelGlob: (migrations: Record<string, any>) => Loader;
 /**
- * @since 4.0.0
+ * Creates a migration loader from a record of migration effects keyed by
+ * `<id>_<name>`, sorted by migration id.
+ *
  * @category loaders
+ * @since 4.0.0
  */
 export declare const fromRecord: (migrations: Record<string, Effect.Effect<void, unknown, Client.SqlClient>>) => Loader;
 /**
- * @since 4.0.0
+ * Creates a migration loader that reads a directory with `FileSystem`, imports
+ * files named `<id>_<name>.js` or `<id>_<name>.ts`, and sorts migrations by id.
+ *
  * @category loaders
+ * @since 4.0.0
  */
 export declare const fromFileSystem: (directory: string) => Loader<FileSystem>;
 export {};

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":"AAKA,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;;;GAGG;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;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,CAC3C,aAAa,CAAC,iBAAiB,CAAC,EAChC,cAAc,EACd,CAAC,CACF,CAAA;AAED;;;GAGG;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;;;GAGG;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;;;GAGG;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;;;GAGG;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;;;GAGG;AACH,eAAO,MAAM,QAAQ,GACnB,YAAY,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,KAC7C,MAaA,CAAA;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,YAAY,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAG,MAa7D,CAAA;AAEH;;;GAGG;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;;;GAGG;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":"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;;;;;;GAMG;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;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,UAAU,CAkCnE,CAAA"}

package/dist/unstable/sql/Migrator.js

@@ -7,6 +7,27 @@ var __rewriteRelativeImportExtension = this && this.__rewriteRelativeImportExten
   return path;
 };
 /**
+ * Effect SQL migration helpers for loading, ordering, and running schema
+ * changes against a `SqlClient`.
+ *
+ * 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.
+ *
+ * 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.
+ *
  * @since 4.0.0
  */
 import * as Arr from "../../Array.js";
@@ -18,12 +39,18 @@ import * as Option from "../../Option.js";
 import * as Order from "../../Order.js";
 import * as Client from "./SqlClient.js";
 /**
+ * Error raised while loading, validating, locking, or running SQL migrations.
+ *
  * @category errors
  * @since 4.0.0
  */
 export class MigrationError extends /*#__PURE__*/Data.TaggedError("MigrationError") {}
 /**
- * @category constructor
+ * Creates a migrator that ensures the migrations table exists, runs pending
+ * migrations in a transaction, and optionally dumps the schema after successful
+ * migrations.
+ *
+ * @category constructors
  * @since 4.0.0
  */
 export const make = ({
@@ -135,23 +162,36 @@ export const make = ({
 const migrationOrder = /*#__PURE__*/Order.make(([a], [b]) => Order.Number(a, b));
 const isConstraintConflict = error => error.reason._tag === "ConstraintError" || error.reason._tag === "UniqueViolation";
 /**
- * @since 4.0.0
+ * Creates a migration loader from a glob record of dynamic import functions,
+ * parsing files named `<id>_<name>.js` or `<id>_<name>.ts` and sorting
+ * migrations by id.
+ *
  * @category loaders
+ * @since 4.0.0
  */
 export const fromGlob = migrations => pipe(Object.keys(migrations), Arr.flatMapNullishOr(_ => _.match(/^(?:.*\/)?(\d+)_([^.]+)\.(js|ts)$/)), Arr.map(([key, id, name]) => [Number(id), name, Effect.promise(() => migrations[key]())]), Arr.sort(migrationOrder), Effect.succeed);
 /**
- * @since 4.0.0
+ * Creates a migration loader from a Babel-style glob record, parsing keys such
+ * as `_<id>_<name>Js` or `_<id>_<name>Ts` and sorting migrations by id.
+ *
  * @category loaders
+ * @since 4.0.0
  */
 export const fromBabelGlob = migrations => pipe(Object.keys(migrations), Arr.flatMapNullishOr(_ => _.match(/^_(\d+)_([^.]+?)(Js|Ts)?$/)), Arr.map(([key, id, name]) => [Number(id), name, Effect.succeed(migrations[key])]), Arr.sort(migrationOrder), Effect.succeed);
 /**
- * @since 4.0.0
+ * Creates a migration loader from a record of migration effects keyed by
+ * `<id>_<name>`, sorted by migration id.
+ *
  * @category loaders
+ * @since 4.0.0
  */
 export const fromRecord = migrations => pipe(Object.keys(migrations), Arr.flatMapNullishOr(_ => _.match(/^(\d+)_(.+)$/)), Arr.map(([key, id, name]) => [Number(id), name, Effect.succeed(migrations[key])]), Arr.sort(migrationOrder), Effect.succeed);
 /**
- * @since 4.0.0
+ * Creates a migration loader that reads a directory with `FileSystem`, imports
+ * files named `<id>_<name>.js` or `<id>_<name>.ts`, and sorts migrations by id.
+ *
  * @category loaders
+ * @since 4.0.0
  */
 export const fromFileSystem = /*#__PURE__*/Effect.fnUntraced(function* (directory) {
   const Fs = yield* FileSystem;

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/SqlClient.d.ts

@@ -11,6 +11,9 @@ import type { SqlError } from "./SqlError.ts";
 import type { Compiler, Constructor } from "./Statement.ts";
 declare const TypeId = "~effect/sql/SqlClient";
 /**
+ * SQL client service interface, combining the statement constructor API with
+ * connection reservation, transaction handling, and reactive query helpers.
+ *
  * @category models
  * @since 4.0.0
  */
@@ -45,16 +48,23 @@ export interface SqlClient extends Constructor {
     readonly reactiveMailbox: <A, E, R>(keys: ReadonlyArray<unknown> | ReadonlyRecord<string, ReadonlyArray<unknown>>, effect: Effect.Effect<A, E, R>) => Effect.Effect<Queue.Dequeue<A, E>, never, R | Scope.Scope>;
 }
 /**
+ * Context service tag for the `SqlClient` service.
+ *
  * @category models
  * @since 4.0.0
  */
 export declare const SqlClient: Context.Service<SqlClient, SqlClient>;
 /**
- * @category models
+ * Namespace containing types associated with the `SqlClient` service.
+ *
  * @since 4.0.0
  */
 export declare namespace SqlClient {
     /**
+     * Options used to construct a `SqlClient`, including connection acquirers,
+     * the SQL compiler, transaction SQL, row transformation, tracing attributes,
+     * and optional reactive query integration.
+     *
      * @category models
      * @since 4.0.0
      */
@@ -74,13 +84,21 @@ export declare namespace SqlClient {
     }
 }
 /**
+ * Constructs a `SqlClient` from connection acquirers, a compiler, transaction
+ * commands, tracing attributes, optional row transforms, and reactive query
+ * integration.
+ *
  * @category constructors
  * @since 4.0.0
  */
 export declare const make: (options: SqlClient.MakeOptions) => Effect.Effect<SqlClient, never, Reactivity>;
 /**
- * @since 4.0.0
+ * Builds a transaction wrapper that begins top-level transactions, uses
+ * savepoints for nested transactions, commits on success, and rolls back on
+ * failure or interruption.
+ *
  * @category transactions
+ * @since 4.0.0
  */
 export declare const makeWithTransaction: <I, S>(options: {
     readonly transactionService: Context.Key<I, readonly [conn: S, counter: number]>;
@@ -93,25 +111,43 @@ export declare const makeWithTransaction: <I, S>(options: {
     readonly rollbackSavepoint: (conn: NoInfer<S>, id: number) => Effect.Effect<void, SqlError>;
 }) => <R, E, A>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E | SqlError, R>;
 /**
+ * Phantom identifier for the scoped transaction connection service associated
+ * with a SQL client.
+ *
+ * @category models
  * @since 4.0.0
  */
 export interface TransactionConnection {
     readonly _: unique symbol;
 }
 /**
+ * Namespace containing types associated with transaction connection services.
+ *
  * @since 4.0.0
  */
 export declare namespace TransactionConnection {
     /**
+     * Service payload stored during a transaction, containing the active
+     * connection and nested transaction depth.
+     *
+     * @category services
      * @since 4.0.0
      */
     type Service = readonly [conn: Connection.Connection, depth: number];
 }
 /**
+ * Creates a unique context service tag for the active transaction connection of
+ * a specific SQL client.
+ *
+ * @category tags
  * @since 4.0.0
  */
 export declare const TransactionConnection: (clientId: number) => Context.Service<TransactionConnection, TransactionConnection.Service>;
 /**
+ * Context reference used by SQL integrations to opt in to safe integer
+ * handling; defaults to `false`.
+ *
+ * @category references
  * @since 4.0.0
  */
 export declare const SafeIntegers: Context.Reference<boolean>;

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

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