effect 4.0.0-beta.66 → 4.0.0-beta.67

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

@@ -3,6 +3,9 @@ import { FileSystem } from "../../FileSystem.ts";
 import * as Client from "./SqlClient.ts";
 import type { SqlError } from "./SqlError.ts";
 /**
+ * Options for running SQL migrations, including the migration loader, optional
+ * schema dump directory, and migrations table name.
+ *
  * @category model
  * @since 4.0.0
  */
@@ -12,11 +15,17 @@ export interface MigratorOptions<R = never> {
     readonly table?: string;
 }
 /**
+ * Effect that resolves the available migrations for the migrator or fails with a
+ * `MigrationError`.
+ *
  * @category model
  * @since 4.0.0
  */
 export type Loader<R = never> = Effect.Effect<ReadonlyArray<ResolvedMigration>, MigrationError, R>;
 /**
+ * Tuple produced by a migration loader, containing the migration id, migration
+ * name, and an effect that loads the migration implementation.
+ *
  * @category model
  * @since 4.0.0
  */
@@ -26,6 +35,9 @@ export type ResolvedMigration = readonly [
     load: Effect.Effect<any, any, Client.SqlClient>
 ];
 /**
+ * Metadata for a migration recorded in the migrations table, including its id,
+ * name, and creation timestamp.
+ *
  * @category model
  * @since 4.0.0
  */
@@ -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,6 +63,10 @@ export declare class MigrationError extends MigrationError_base<{
 }> {
 }
 /**
+ * Creates a migrator that ensures the migrations table exists, runs pending
+ * migrations in a transaction, and optionally dumps the schema after successful
+ * migrations.
+ *
  * @category constructor
  * @since 4.0.0
  */
@@ -56,23 +74,36 @@ 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,11 +39,17 @@ 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") {}
 /**
+ * Creates a migrator that ensures the migrations table exists, runs pending
+ * migrations in a transaction, and optionally dumps the schema after successful
+ * migrations.
+ *
  * @category constructor
  * @since 4.0.0
  */
@@ -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":";;;;;;;;AAAA;;;AAGA,OAAO,KAAKA,GAAG,MAAM,gBAAgB;AACrC,OAAO,KAAKC,IAAI,MAAM,eAAe;AACrC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,SAASC,UAAU,QAAQ,qBAAqB;AAChD,SAASC,IAAI,QAAQ,mBAAmB;AACxC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,MAAM,MAAM,gBAAgB;AA2CxC;;;;AAIA,OAAM,MAAOC,cAAe,sBAAQP,IAAI,CAACQ,WAAW,CAAC,gBAAgB,CAUnE;AAEF;;;;AAIA,OAAO,MAAMC,IAAI,GAAGA,CAAa;EAC/BC,UAAU,GAAGA,CAAA,KAAMT,MAAM,CAACU;AAAI,CAM/B,KACD,CAAa;EACXC,MAAM;EACNC,eAAe;EACfC,KAAK,GAAG;AAAuB,CACX,KAKpBb,MAAM,CAACc,GAAG,CAAC,aAAS;EAClB,MAAMC,GAAG,GAAG,OAAOV,MAAM,CAACW,SAAS;EAEnC,MAAMC,qBAAqB,GAAGF,GAAG,CAACG,eAAe,CAAC;IAChDC,KAAK,EAAEA,CAAA,KACLJ,GAAG,kBAAkBA,GAAG,CAACK,OAAO,CAACP,KAAK,CAAC;iBAC9BE,GAAG,CAACF,KAAK,CAAC;;;;IAIvB;IACEQ,KAAK,EAAEA,CAAA,KACLN,GAAG,8BAA8BA,GAAG,CAACF,KAAK,CAAC;;;;;EAKjD;IACIS,EAAE,EAAEA,CAAA,KACFtB,MAAM,CAACuB,KAAK,CACVR,GAAG,UAAUF,KAAK,YAAY,EAC9B,MACEE,GAAG,gBAAgBA,GAAG,CAACF,KAAK,CAAC;;;;EAIvC,CACO;IACHW,MAAM,EAAEA,CAAA,KACNT,GAAG,8BAA8BA,GAAG,CAACF,KAAK,CAAC;;;;;GAK9C,CAAC;EAEF,MAAMY,gBAAgB,GACpBC,IAA+C,IAE/CX,GAAG,eAAeA,GAAG,CAACF,KAAK,CAAC,IAC1BE,GAAG,CAACY,MAAM,CACRD,IAAI,CAACE,GAAG,CAAC,CAAC,CAACC,YAAY,EAAEC,IAAI,CAAC,MAAM;IAAED,YAAY;IAAEC;EAAI,CAAE,CAAC,CAAC,CAEhE,EAAE,CAACC,gBAAgB;EAErB,MAAMC,eAAe,GAAGhC,MAAM,CAAC4B,GAAG,CAChCb,GAA6D,8CAC3DA,GAAG,CAACF,KAAK,CACX,6BAA6B,CAACkB,gBAAgB,EAC7CE,CAAC,IACA9B,MAAM,CAACyB,GAAG,CACRzB,MAAM,CAAC+B,aAAa,CAACD,CAAC,CAAC,CAAC,CAAQ,CAAC,EACjC,CAAC;IAAEE,UAAU;IAAEN,YAAY;IAAEC;EAAI,CAAE,MAAiB;IAClDM,EAAE,EAAEP,YAAY;IAChBC,IAAI;IACJO,SAAS,EAAEF;GACZ,CAAC,CACH,CACJ;EAED,MAAMG,aAAa,GAAGA,CAAC,CAACF,EAAE,EAAEN,IAAI,EAAES,IAAI,CAAoB,KACxDvC,MAAM,CAACwC,WAAW,CAACD,IAAI,EAAGN,CAAC,IACzBjC,MAAM,CAACyC,IAAI,CACT,IAAInC,cAAc,CAAC;IACjBoC,IAAI,EAAE,aAAa;IACnBC,OAAO,EAAE,+BAA+BP,EAAE,IAAIN,IAAI,QAAQG,CAAC;GAC5D,CAAC,CACH,CAAC,CAAC/B,IAAI,CACLF,MAAM,CAAC4C,OAAO,CAAEX,CAAC,IACfjC,MAAM,CAAC6C,QAAQ,CAACZ,CAAC,CAAC,GACdjC,MAAM,CAAC8C,OAAO,CAACb,CAAC,CAAC,GACjBA,CAAC,CAACc,OAAO,GACT/C,MAAM,CAAC8C,OAAO,CAACb,CAAC,CAACc,OAAO,EAAEA,OAAO,IAAId,CAAC,CAACc,OAAO,CAAC,GAC/C/C,MAAM,CAACyC,IAAI,CACX,IAAInC,cAAc,CAAC;IACjBoC,IAAI,EAAE,aAAa;IACnBC,OAAO,EAAE,2CAA2CP,EAAE,IAAIN,IAAI;GAC/D,CAAC,CACH,CACJ,EACD9B,MAAM,CAACgD,YAAY,CACjBhD,MAAM,CAAC6C,QAAQ,EACf,MACE,IAAIvC,cAAc,CAAC;IACjBoC,IAAI,EAAE,aAAa;IACnBC,OAAO,EAAE,mDAAmDP,EAAE,IAAIN,IAAI;GACvE,CAAC,CACL,CACF;EAEL,MAAMmB,YAAY,GAAGA,CACnBb,EAAU,EACVN,IAAY,EACZoB,MAAyD,KAEzDlD,MAAM,CAACuB,KAAK,CAAC2B,MAAM,EAAGC,KAAc,IAClCnD,MAAM,CAACoD,GAAG,CACR,IAAI9C,cAAc,CAAC;IACjB+C,KAAK,EAAEF,KAAK;IACZT,IAAI,EAAE,QAAQ;IACdC,OAAO,EAAE,cAAcP,EAAE,IAAIN,IAAI;GAClC,CAAC,CACH,CAAC;EAEN;EAEA,MAAMwB,GAAG,GAAGtD,MAAM,CAACc,GAAG,CAAC,aAAS;IAC9B,OAAOC,GAAG,CAACG,eAAe,CAAC;MACzBI,EAAE,EAAEA,CAAA,KAAMP,GAAG,cAAcA,GAAG,CAACF,KAAK,CAAC,2BAA2B;MAChEW,MAAM,EAAEA,CAAA,KAAMxB,MAAM,CAACU;KACtB,CAAC;IAEF,MAAM,CAAC6C,iBAAiB,EAAEC,OAAO,CAAC,GAAG,OAAOxD,MAAM,CAACyD,GAAG,CAAC,CACrDzD,MAAM,CAAC4B,GAAG,CACRI,eAAe,EACf7B,MAAM,CAACuD,KAAK,CAAC;MACXC,MAAM,EAAEA,CAAA,KAAM,CAAC;MACfC,MAAM,EAAG3B,CAAC,IAAKA,CAAC,CAACG;KAClB,CAAC,CACH,EACDzB,MAAM,CACP,CAAC;IAEF,IAAI,IAAIkD,GAAG,CAACL,OAAO,CAAC5B,GAAG,CAAC,CAAC,CAACQ,EAAE,CAAC,KAAKA,EAAE,CAAC,CAAC,CAAC0B,IAAI,KAAKN,OAAO,CAACO,MAAM,EAAE;MAC9D,OAAO,OAAO,IAAIzD,cAAc,CAAC;QAC/BoC,IAAI,EAAE,YAAY;QAClBC,OAAO,EAAE;OACV,CAAC;IACJ;IAEA,MAAMqB,QAAQ,GAA6B,EAAE;IAE7C,KAAK,MAAMC,QAAQ,IAAIT,OAAO,EAAE;MAC9B,MAAM,CAACU,SAAS,EAAEC,WAAW,CAAC,GAAGF,QAAQ;MACzC,IAAIC,SAAS,IAAIX,iBAAiB,EAAE;QAClC;MACF;MAEAS,QAAQ,CAACI,IAAI,CAAC,CACZF,SAAS,EACTC,WAAW,EACX,OAAO7B,aAAa,CAAC2B,QAAQ,CAAC,CAC/B,CAAC;IACJ;IAEA,IAAID,QAAQ,CAACD,MAAM,GAAG,CAAC,EAAE;MACvB,OAAO7D,IAAI,CACTuB,gBAAgB,CAACuC,QAAQ,CAACpC,GAAG,CAAC,CAAC,CAACQ,EAAE,EAAEN,IAAI,CAAC,KAAK,CAACM,EAAE,EAAEN,IAAI,CAAC,CAAC,CAAC,EAC1D9B,MAAM,CAACqE,QAAQ,CAAElB,KAAK,IACpBmB,oBAAoB,CAACnB,KAAK,CAAC,GACvB,IAAI7C,cAAc,CAAC;QACnBoC,IAAI,EAAE,QAAQ;QACdC,OAAO,EAAE;OACV,CAAC,GACAQ,KAAK,CACV,CACF;IACH;IAEA,OAAOnD,MAAM,CAACuE,OAAO,CACnBP,QAAQ,EACR,CAAC,CAAC5B,EAAE,EAAEN,IAAI,EAAEoB,MAAM,CAAC,KACjBlD,MAAM,CAACwE,QAAQ,CAAC,mBAAmB,CAAC,CAACtE,IAAI,CACvCF,MAAM,CAAC4C,OAAO,CAAC,MAAMK,YAAY,CAACb,EAAE,EAAEN,IAAI,EAAEoB,MAAM,CAAC,CAAC,EACpDlD,MAAM,CAACyE,YAAY,CAAC,cAAc,EAAEC,MAAM,CAACtC,EAAE,CAAC,CAAC,EAC/CpC,MAAM,CAACyE,YAAY,CAAC,gBAAgB,EAAE3C,IAAI,CAAC,EAC3C9B,MAAM,CAAC2E,QAAQ,CAAC,YAAYvC,EAAE,IAAIN,IAAI,EAAE,CAAC,CAC1C,EACH;MAAE8C,OAAO,EAAE;IAAI,CAAE,CAClB;IAED,OAAO1E,IAAI,CACT8B,eAAe,EACfhC,MAAM,CAAC4C,OAAO,CACZzC,MAAM,CAACuD,KAAK,CAAC;MACXC,MAAM,EAAEA,CAAA,KAAM3D,MAAM,CAACwE,QAAQ,CAAC,qBAAqB,CAAC;MACpDZ,MAAM,EAAG3B,CAAC,IACRjC,MAAM,CAACwE,QAAQ,CAAC,qBAAqB,CAAC,CAACtE,IAAI,CACzCF,MAAM,CAACyE,YAAY,CAAC,qBAAqB,EAAExC,CAAC,CAACG,EAAE,CAACyC,QAAQ,EAAE,CAAC,EAC3D7E,MAAM,CAACyE,YAAY,CAAC,uBAAuB,EAAExC,CAAC,CAACH,IAAI,CAAC;KAEzD,CAAC,CACH,CACF;IAED,OAAOkC,QAAQ,CAACpC,GAAG,CAAC,CAAC,CAACQ,EAAE,EAAEN,IAAI,CAAC,KAAK,CAACM,EAAE,EAAEN,IAAI,CAAU,CAAC;EAC1D,CAAC,CAAC;EAEF,OAAOb,qBAAqB;EAE5B,MAAM6D,SAAS,GAAG,OAAO5E,IAAI,CAC3Ba,GAAG,CAACgE,eAAe,CAACzB,GAAG,CAAC,EACxBtD,MAAM,CAACgF,QAAQ,CAAC,gBAAgB,EAAG/C,CAAC,IAClCA,CAAC,CAACS,IAAI,KAAK,QAAQ,GACf1C,MAAM,CAACiF,EAAE,CAACjF,MAAM,CAACwE,QAAQ,CAACvC,CAAC,CAACU,OAAO,CAAC,EAAE,EAAE,CAAC,GACzC3C,MAAM,CAACyC,IAAI,CAACR,CAAC,CAAC,CAAC,CACtB;EAED,IAAIrB,eAAe,IAAIkE,SAAS,CAACf,MAAM,GAAG,CAAC,EAAE;IAC3C,OAAOtD,UAAU,CAAC,GAAGG,eAAe,cAAc,EAAEC,KAAK,CAAC,CAACX,IAAI,CAC7DF,MAAM,CAACkF,UAAU,CAAE7B,KAAK,IAAKrD,MAAM,CAACmF,OAAO,CAAC,uBAAuB,EAAE9B,KAAK,CAAC,CAAC,CAC7E;EACH;EAEA,OAAOyB,SAAS;AAClB,CAAC,CAAC;AAEJ,MAAMM,cAAc,gBAAGhF,KAAK,CAACI,IAAI,CAAoB,CAAC,CAAC6E,CAAC,CAAC,EAAE,CAACC,CAAC,CAAC,KAAKlF,KAAK,CAACmF,MAAM,CAACF,CAAC,EAAEC,CAAC,CAAC,CAAC;AAEtF,MAAMhB,oBAAoB,GAAInB,KAAe,IAC3CA,KAAK,CAACqC,MAAM,CAACC,IAAI,KAAK,iBAAiB,IAAItC,KAAK,CAACqC,MAAM,CAACC,IAAI,KAAK,iBAAiB;AAEpF;;;;AAIA,OAAO,MAAMC,QAAQ,GACnBC,UAA8C,IAE9CzF,IAAI,CACF0F,MAAM,CAACC,IAAI,CAACF,UAAU,CAAC,EACvB7F,GAAG,CAACgG,gBAAgB,CAAE7D,CAAC,IAAKA,CAAC,CAACyB,KAAK,CAAC,mCAAmC,CAAC,CAAC,EACzE5D,GAAG,CAAC8B,GAAG,CACL,CAAC,CAACmE,GAAG,EAAE3D,EAAE,EAAEN,IAAI,CAAC,KAAwB,CACtCyD,MAAM,CAACnD,EAAE,CAAC,EACVN,IAAI,EACJ9B,MAAM,CAACgG,OAAO,CAAC,MAAML,UAAU,CAACI,GAAG,CAAC,EAAE,CAAC,CACxC,CACF,EACDjG,GAAG,CAACmG,IAAI,CAACb,cAAc,CAAC,EACxBpF,MAAM,CAAC8C,OAAO,CACf;AAEH;;;;AAIA,OAAO,MAAMoD,aAAa,GAAIP,UAA+B,IAC3DzF,IAAI,CACF0F,MAAM,CAACC,IAAI,CAACF,UAAU,CAAC,EACvB7F,GAAG,CAACgG,gBAAgB,CAAE7D,CAAC,IAAKA,CAAC,CAACyB,KAAK,CAAC,2BAA2B,CAAC,CAAC,EACjE5D,GAAG,CAAC8B,GAAG,CACL,CAAC,CAACmE,GAAG,EAAE3D,EAAE,EAAEN,IAAI,CAAC,KAAwB,CACtCyD,MAAM,CAACnD,EAAE,CAAC,EACVN,IAAI,EACJ9B,MAAM,CAAC8C,OAAO,CAAC6C,UAAU,CAACI,GAAG,CAAC,CAAC,CAChC,CACF,EACDjG,GAAG,CAACmG,IAAI,CAACb,cAAc,CAAC,EACxBpF,MAAM,CAAC8C,OAAO,CACf;AAEH;;;;AAIA,OAAO,MAAMqD,UAAU,GAAIR,UAA0E,IACnGzF,IAAI,CACF0F,MAAM,CAACC,IAAI,CAACF,UAAU,CAAC,EACvB7F,GAAG,CAACgG,gBAAgB,CAAE7D,CAAC,IAAKA,CAAC,CAACyB,KAAK,CAAC,cAAc,CAAC,CAAC,EACpD5D,GAAG,CAAC8B,GAAG,CACL,CAAC,CAACmE,GAAG,EAAE3D,EAAE,EAAEN,IAAI,CAAC,KAAwB,CACtCyD,MAAM,CAACnD,EAAE,CAAC,EACVN,IAAI,EACJ9B,MAAM,CAAC8C,OAAO,CAAC6C,UAAU,CAACI,GAAG,CAAC,CAAC,CAChC,CACF,EACDjG,GAAG,CAACmG,IAAI,CAACb,cAAc,CAAC,EACxBpF,MAAM,CAAC8C,OAAO,CACf;AAEH;;;;AAIA,OAAO,MAAMsD,cAAc,gBAA8CpG,MAAM,CAACqG,UAAU,CAAC,WAAUC,SAAS;EAC5G,MAAMC,EAAE,GAAG,OAAOtG,UAAU;EAC5B,MAAMuG,KAAK,GAAG,OAAOxG,MAAM,CAACqE,QAAQ,CAClCkC,EAAE,CAACE,aAAa,CAACH,SAAS,CAAC,EAC1BjD,KAAK,IACJ,IAAI/C,cAAc,CAAC;IACjBoC,IAAI,EAAE,QAAQ;IACdW,KAAK;IACLV,OAAO,EAAE;GACV,CAAC,CACL;EACD,OAAO6D,KAAK,CACT5E,GAAG,CAAE8E,IAAI,IAAKvG,MAAM,CAAC+B,aAAa,CAACwE,IAAI,CAAChD,KAAK,CAAC,mCAAmC,CAAC,CAAC,CAAC,CACpFd,OAAO,CACNzC,MAAM,CAACuD,KAAK,CAAC;IACXC,MAAM,EAAEA,CAAA,KAAM,EAAE;IAChBC,MAAM,EAAEA,CAAC,CAAC+C,QAAQ,EAAEvE,EAAE,EAAEN,IAAI,CAAC,KAC3B,CACE,CACEyD,MAAM,CAACnD,EAAE,CAAC,EACVN,IAAI,EACJ9B,MAAM,CAACgG,OAAO,CACZ,MACE,MAAM,CAAAY,gCAAA,CACJ;IACA;IACA,GAAGN,SAAS,IAAIK,QAAQ,EAAE,EAC3B,CACJ,CACF;GAEN,CAAC,CACH,CACAV,IAAI,CAAC,CAAC,CAACZ,CAAC,CAAC,EAAE,CAACC,CAAC,CAAC,KAAKD,CAAC,GAAGC,CAAC,CAAC;AAC9B,CAAC,CAAC","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":";;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,OAAO,KAAKA,GAAG,MAAM,gBAAgB;AACrC,OAAO,KAAKC,IAAI,MAAM,eAAe;AACrC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,SAASC,UAAU,QAAQ,qBAAqB;AAChD,SAASC,IAAI,QAAQ,mBAAmB;AACxC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,MAAM,MAAM,gBAAgB;AAuDxC;;;;;;AAMA,OAAM,MAAOC,cAAe,sBAAQP,IAAI,CAACQ,WAAW,CAAC,gBAAgB,CAUnE;AAEF;;;;;;;;AAQA,OAAO,MAAMC,IAAI,GAAGA,CAAa;EAC/BC,UAAU,GAAGA,CAAA,KAAMT,MAAM,CAACU;AAAI,CAM/B,KACD,CAAa;EACXC,MAAM;EACNC,eAAe;EACfC,KAAK,GAAG;AAAuB,CACX,KAKpBb,MAAM,CAACc,GAAG,CAAC,aAAS;EAClB,MAAMC,GAAG,GAAG,OAAOV,MAAM,CAACW,SAAS;EAEnC,MAAMC,qBAAqB,GAAGF,GAAG,CAACG,eAAe,CAAC;IAChDC,KAAK,EAAEA,CAAA,KACLJ,GAAG,kBAAkBA,GAAG,CAACK,OAAO,CAACP,KAAK,CAAC;iBAC9BE,GAAG,CAACF,KAAK,CAAC;;;;IAIvB;IACEQ,KAAK,EAAEA,CAAA,KACLN,GAAG,8BAA8BA,GAAG,CAACF,KAAK,CAAC;;;;;EAKjD;IACIS,EAAE,EAAEA,CAAA,KACFtB,MAAM,CAACuB,KAAK,CACVR,GAAG,UAAUF,KAAK,YAAY,EAC9B,MACEE,GAAG,gBAAgBA,GAAG,CAACF,KAAK,CAAC;;;;EAIvC,CACO;IACHW,MAAM,EAAEA,CAAA,KACNT,GAAG,8BAA8BA,GAAG,CAACF,KAAK,CAAC;;;;;GAK9C,CAAC;EAEF,MAAMY,gBAAgB,GACpBC,IAA+C,IAE/CX,GAAG,eAAeA,GAAG,CAACF,KAAK,CAAC,IAC1BE,GAAG,CAACY,MAAM,CACRD,IAAI,CAACE,GAAG,CAAC,CAAC,CAACC,YAAY,EAAEC,IAAI,CAAC,MAAM;IAAED,YAAY;IAAEC;EAAI,CAAE,CAAC,CAAC,CAEhE,EAAE,CAACC,gBAAgB;EAErB,MAAMC,eAAe,GAAGhC,MAAM,CAAC4B,GAAG,CAChCb,GAA6D,8CAC3DA,GAAG,CAACF,KAAK,CACX,6BAA6B,CAACkB,gBAAgB,EAC7CE,CAAC,IACA9B,MAAM,CAACyB,GAAG,CACRzB,MAAM,CAAC+B,aAAa,CAACD,CAAC,CAAC,CAAC,CAAQ,CAAC,EACjC,CAAC;IAAEE,UAAU;IAAEN,YAAY;IAAEC;EAAI,CAAE,MAAiB;IAClDM,EAAE,EAAEP,YAAY;IAChBC,IAAI;IACJO,SAAS,EAAEF;GACZ,CAAC,CACH,CACJ;EAED,MAAMG,aAAa,GAAGA,CAAC,CAACF,EAAE,EAAEN,IAAI,EAAES,IAAI,CAAoB,KACxDvC,MAAM,CAACwC,WAAW,CAACD,IAAI,EAAGN,CAAC,IACzBjC,MAAM,CAACyC,IAAI,CACT,IAAInC,cAAc,CAAC;IACjBoC,IAAI,EAAE,aAAa;IACnBC,OAAO,EAAE,+BAA+BP,EAAE,IAAIN,IAAI,QAAQG,CAAC;GAC5D,CAAC,CACH,CAAC,CAAC/B,IAAI,CACLF,MAAM,CAAC4C,OAAO,CAAEX,CAAC,IACfjC,MAAM,CAAC6C,QAAQ,CAACZ,CAAC,CAAC,GACdjC,MAAM,CAAC8C,OAAO,CAACb,CAAC,CAAC,GACjBA,CAAC,CAACc,OAAO,GACT/C,MAAM,CAAC8C,OAAO,CAACb,CAAC,CAACc,OAAO,EAAEA,OAAO,IAAId,CAAC,CAACc,OAAO,CAAC,GAC/C/C,MAAM,CAACyC,IAAI,CACX,IAAInC,cAAc,CAAC;IACjBoC,IAAI,EAAE,aAAa;IACnBC,OAAO,EAAE,2CAA2CP,EAAE,IAAIN,IAAI;GAC/D,CAAC,CACH,CACJ,EACD9B,MAAM,CAACgD,YAAY,CACjBhD,MAAM,CAAC6C,QAAQ,EACf,MACE,IAAIvC,cAAc,CAAC;IACjBoC,IAAI,EAAE,aAAa;IACnBC,OAAO,EAAE,mDAAmDP,EAAE,IAAIN,IAAI;GACvE,CAAC,CACL,CACF;EAEL,MAAMmB,YAAY,GAAGA,CACnBb,EAAU,EACVN,IAAY,EACZoB,MAAyD,KAEzDlD,MAAM,CAACuB,KAAK,CAAC2B,MAAM,EAAGC,KAAc,IAClCnD,MAAM,CAACoD,GAAG,CACR,IAAI9C,cAAc,CAAC;IACjB+C,KAAK,EAAEF,KAAK;IACZT,IAAI,EAAE,QAAQ;IACdC,OAAO,EAAE,cAAcP,EAAE,IAAIN,IAAI;GAClC,CAAC,CACH,CAAC;EAEN;EAEA,MAAMwB,GAAG,GAAGtD,MAAM,CAACc,GAAG,CAAC,aAAS;IAC9B,OAAOC,GAAG,CAACG,eAAe,CAAC;MACzBI,EAAE,EAAEA,CAAA,KAAMP,GAAG,cAAcA,GAAG,CAACF,KAAK,CAAC,2BAA2B;MAChEW,MAAM,EAAEA,CAAA,KAAMxB,MAAM,CAACU;KACtB,CAAC;IAEF,MAAM,CAAC6C,iBAAiB,EAAEC,OAAO,CAAC,GAAG,OAAOxD,MAAM,CAACyD,GAAG,CAAC,CACrDzD,MAAM,CAAC4B,GAAG,CACRI,eAAe,EACf7B,MAAM,CAACuD,KAAK,CAAC;MACXC,MAAM,EAAEA,CAAA,KAAM,CAAC;MACfC,MAAM,EAAG3B,CAAC,IAAKA,CAAC,CAACG;KAClB,CAAC,CACH,EACDzB,MAAM,CACP,CAAC;IAEF,IAAI,IAAIkD,GAAG,CAACL,OAAO,CAAC5B,GAAG,CAAC,CAAC,CAACQ,EAAE,CAAC,KAAKA,EAAE,CAAC,CAAC,CAAC0B,IAAI,KAAKN,OAAO,CAACO,MAAM,EAAE;MAC9D,OAAO,OAAO,IAAIzD,cAAc,CAAC;QAC/BoC,IAAI,EAAE,YAAY;QAClBC,OAAO,EAAE;OACV,CAAC;IACJ;IAEA,MAAMqB,QAAQ,GAA6B,EAAE;IAE7C,KAAK,MAAMC,QAAQ,IAAIT,OAAO,EAAE;MAC9B,MAAM,CAACU,SAAS,EAAEC,WAAW,CAAC,GAAGF,QAAQ;MACzC,IAAIC,SAAS,IAAIX,iBAAiB,EAAE;QAClC;MACF;MAEAS,QAAQ,CAACI,IAAI,CAAC,CACZF,SAAS,EACTC,WAAW,EACX,OAAO7B,aAAa,CAAC2B,QAAQ,CAAC,CAC/B,CAAC;IACJ;IAEA,IAAID,QAAQ,CAACD,MAAM,GAAG,CAAC,EAAE;MACvB,OAAO7D,IAAI,CACTuB,gBAAgB,CAACuC,QAAQ,CAACpC,GAAG,CAAC,CAAC,CAACQ,EAAE,EAAEN,IAAI,CAAC,KAAK,CAACM,EAAE,EAAEN,IAAI,CAAC,CAAC,CAAC,EAC1D9B,MAAM,CAACqE,QAAQ,CAAElB,KAAK,IACpBmB,oBAAoB,CAACnB,KAAK,CAAC,GACvB,IAAI7C,cAAc,CAAC;QACnBoC,IAAI,EAAE,QAAQ;QACdC,OAAO,EAAE;OACV,CAAC,GACAQ,KAAK,CACV,CACF;IACH;IAEA,OAAOnD,MAAM,CAACuE,OAAO,CACnBP,QAAQ,EACR,CAAC,CAAC5B,EAAE,EAAEN,IAAI,EAAEoB,MAAM,CAAC,KACjBlD,MAAM,CAACwE,QAAQ,CAAC,mBAAmB,CAAC,CAACtE,IAAI,CACvCF,MAAM,CAAC4C,OAAO,CAAC,MAAMK,YAAY,CAACb,EAAE,EAAEN,IAAI,EAAEoB,MAAM,CAAC,CAAC,EACpDlD,MAAM,CAACyE,YAAY,CAAC,cAAc,EAAEC,MAAM,CAACtC,EAAE,CAAC,CAAC,EAC/CpC,MAAM,CAACyE,YAAY,CAAC,gBAAgB,EAAE3C,IAAI,CAAC,EAC3C9B,MAAM,CAAC2E,QAAQ,CAAC,YAAYvC,EAAE,IAAIN,IAAI,EAAE,CAAC,CAC1C,EACH;MAAE8C,OAAO,EAAE;IAAI,CAAE,CAClB;IAED,OAAO1E,IAAI,CACT8B,eAAe,EACfhC,MAAM,CAAC4C,OAAO,CACZzC,MAAM,CAACuD,KAAK,CAAC;MACXC,MAAM,EAAEA,CAAA,KAAM3D,MAAM,CAACwE,QAAQ,CAAC,qBAAqB,CAAC;MACpDZ,MAAM,EAAG3B,CAAC,IACRjC,MAAM,CAACwE,QAAQ,CAAC,qBAAqB,CAAC,CAACtE,IAAI,CACzCF,MAAM,CAACyE,YAAY,CAAC,qBAAqB,EAAExC,CAAC,CAACG,EAAE,CAACyC,QAAQ,EAAE,CAAC,EAC3D7E,MAAM,CAACyE,YAAY,CAAC,uBAAuB,EAAExC,CAAC,CAACH,IAAI,CAAC;KAEzD,CAAC,CACH,CACF;IAED,OAAOkC,QAAQ,CAACpC,GAAG,CAAC,CAAC,CAACQ,EAAE,EAAEN,IAAI,CAAC,KAAK,CAACM,EAAE,EAAEN,IAAI,CAAU,CAAC;EAC1D,CAAC,CAAC;EAEF,OAAOb,qBAAqB;EAE5B,MAAM6D,SAAS,GAAG,OAAO5E,IAAI,CAC3Ba,GAAG,CAACgE,eAAe,CAACzB,GAAG,CAAC,EACxBtD,MAAM,CAACgF,QAAQ,CAAC,gBAAgB,EAAG/C,CAAC,IAClCA,CAAC,CAACS,IAAI,KAAK,QAAQ,GACf1C,MAAM,CAACiF,EAAE,CAACjF,MAAM,CAACwE,QAAQ,CAACvC,CAAC,CAACU,OAAO,CAAC,EAAE,EAAE,CAAC,GACzC3C,MAAM,CAACyC,IAAI,CAACR,CAAC,CAAC,CAAC,CACtB;EAED,IAAIrB,eAAe,IAAIkE,SAAS,CAACf,MAAM,GAAG,CAAC,EAAE;IAC3C,OAAOtD,UAAU,CAAC,GAAGG,eAAe,cAAc,EAAEC,KAAK,CAAC,CAACX,IAAI,CAC7DF,MAAM,CAACkF,UAAU,CAAE7B,KAAK,IAAKrD,MAAM,CAACmF,OAAO,CAAC,uBAAuB,EAAE9B,KAAK,CAAC,CAAC,CAC7E;EACH;EAEA,OAAOyB,SAAS;AAClB,CAAC,CAAC;AAEJ,MAAMM,cAAc,gBAAGhF,KAAK,CAACI,IAAI,CAAoB,CAAC,CAAC6E,CAAC,CAAC,EAAE,CAACC,CAAC,CAAC,KAAKlF,KAAK,CAACmF,MAAM,CAACF,CAAC,EAAEC,CAAC,CAAC,CAAC;AAEtF,MAAMhB,oBAAoB,GAAInB,KAAe,IAC3CA,KAAK,CAACqC,MAAM,CAACC,IAAI,KAAK,iBAAiB,IAAItC,KAAK,CAACqC,MAAM,CAACC,IAAI,KAAK,iBAAiB;AAEpF;;;;;;;;AAQA,OAAO,MAAMC,QAAQ,GACnBC,UAA8C,IAE9CzF,IAAI,CACF0F,MAAM,CAACC,IAAI,CAACF,UAAU,CAAC,EACvB7F,GAAG,CAACgG,gBAAgB,CAAE7D,CAAC,IAAKA,CAAC,CAACyB,KAAK,CAAC,mCAAmC,CAAC,CAAC,EACzE5D,GAAG,CAAC8B,GAAG,CACL,CAAC,CAACmE,GAAG,EAAE3D,EAAE,EAAEN,IAAI,CAAC,KAAwB,CACtCyD,MAAM,CAACnD,EAAE,CAAC,EACVN,IAAI,EACJ9B,MAAM,CAACgG,OAAO,CAAC,MAAML,UAAU,CAACI,GAAG,CAAC,EAAE,CAAC,CACxC,CACF,EACDjG,GAAG,CAACmG,IAAI,CAACb,cAAc,CAAC,EACxBpF,MAAM,CAAC8C,OAAO,CACf;AAEH;;;;;;;AAOA,OAAO,MAAMoD,aAAa,GAAIP,UAA+B,IAC3DzF,IAAI,CACF0F,MAAM,CAACC,IAAI,CAACF,UAAU,CAAC,EACvB7F,GAAG,CAACgG,gBAAgB,CAAE7D,CAAC,IAAKA,CAAC,CAACyB,KAAK,CAAC,2BAA2B,CAAC,CAAC,EACjE5D,GAAG,CAAC8B,GAAG,CACL,CAAC,CAACmE,GAAG,EAAE3D,EAAE,EAAEN,IAAI,CAAC,KAAwB,CACtCyD,MAAM,CAACnD,EAAE,CAAC,EACVN,IAAI,EACJ9B,MAAM,CAAC8C,OAAO,CAAC6C,UAAU,CAACI,GAAG,CAAC,CAAC,CAChC,CACF,EACDjG,GAAG,CAACmG,IAAI,CAACb,cAAc,CAAC,EACxBpF,MAAM,CAAC8C,OAAO,CACf;AAEH;;;;;;;AAOA,OAAO,MAAMqD,UAAU,GAAIR,UAA0E,IACnGzF,IAAI,CACF0F,MAAM,CAACC,IAAI,CAACF,UAAU,CAAC,EACvB7F,GAAG,CAACgG,gBAAgB,CAAE7D,CAAC,IAAKA,CAAC,CAACyB,KAAK,CAAC,cAAc,CAAC,CAAC,EACpD5D,GAAG,CAAC8B,GAAG,CACL,CAAC,CAACmE,GAAG,EAAE3D,EAAE,EAAEN,IAAI,CAAC,KAAwB,CACtCyD,MAAM,CAACnD,EAAE,CAAC,EACVN,IAAI,EACJ9B,MAAM,CAAC8C,OAAO,CAAC6C,UAAU,CAACI,GAAG,CAAC,CAAC,CAChC,CACF,EACDjG,GAAG,CAACmG,IAAI,CAACb,cAAc,CAAC,EACxBpF,MAAM,CAAC8C,OAAO,CACf;AAEH;;;;;;;AAOA,OAAO,MAAMsD,cAAc,gBAA8CpG,MAAM,CAACqG,UAAU,CAAC,WAAUC,SAAS;EAC5G,MAAMC,EAAE,GAAG,OAAOtG,UAAU;EAC5B,MAAMuG,KAAK,GAAG,OAAOxG,MAAM,CAACqE,QAAQ,CAClCkC,EAAE,CAACE,aAAa,CAACH,SAAS,CAAC,EAC1BjD,KAAK,IACJ,IAAI/C,cAAc,CAAC;IACjBoC,IAAI,EAAE,QAAQ;IACdW,KAAK;IACLV,OAAO,EAAE;GACV,CAAC,CACL;EACD,OAAO6D,KAAK,CACT5E,GAAG,CAAE8E,IAAI,IAAKvG,MAAM,CAAC+B,aAAa,CAACwE,IAAI,CAAChD,KAAK,CAAC,mCAAmC,CAAC,CAAC,CAAC,CACpFd,OAAO,CACNzC,MAAM,CAACuD,KAAK,CAAC;IACXC,MAAM,EAAEA,CAAA,KAAM,EAAE;IAChBC,MAAM,EAAEA,CAAC,CAAC+C,QAAQ,EAAEvE,EAAE,EAAEN,IAAI,CAAC,KAC3B,CACE,CACEyD,MAAM,CAACnD,EAAE,CAAC,EACVN,IAAI,EACJ9B,MAAM,CAACgG,OAAO,CACZ,MACE,MAAM,CAAAY,gCAAA,CACJ;IACA;IACA,GAAGN,SAAS,IAAIK,QAAQ,EAAE,EAC3B,CACJ,CACF;GAEN,CAAC,CACH,CACAV,IAAI,CAAC,CAAC,CAACZ,CAAC,CAAC,EAAE,CAACC,CAAC,CAAC,KAAKD,CAAC,GAAGC,CAAC,CAAC;AAC9B,CAAC,CAAC","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,39 @@ 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.
+ *
  * @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.
+     *
      * @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.
+ *
  * @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`.
+ *
  * @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":"AAIA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAGzC,OAAO,KAAK,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,KAAK,KAAK,UAAU,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAG3D,QAAA,MAAM,MAAM,0BAA0B,CAAA;AAEtC;;;GAGG;AACH,MAAM,WAAW,SAAU,SAAQ,WAAW;IAC5C,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,MAAM,CAAA;IAEhC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IAEnB;;OAEG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,IAAI,CAAA;IAEtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAE7E;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAChC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KACzB,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAA;IAEtC;;OAEG;IACH,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAA;IAElG;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACzB,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,EAC7E,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAE3B;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAChC,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,EAC7E,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;CAChE;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,uCAAqD,CAAA;AAE3E;;;GAGG;AACH,yBAAiB,SAAS,CAAC;IACzB;;;OAGG;IACH,UAAiB,WAAW;QAC1B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAA;QACtC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;QAC3B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAA;QAClD,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;QAClE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAA;QACnG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,CAAA;QAC3D,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,CAAA;QACnE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;QACpG,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC/B,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,EAC7E,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;KAChE;CACF;AAID;;;GAGG;AACH,eAAO,MAAM,IAAI,iFAyEf,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,EAAE,CAAC,EAAE,SAAS;IACjD,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;IAChF,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAClE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,GAAG,SAAS,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;IAC9F,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACnE,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACnF,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACpE,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACtE,QAAQ,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;CAC5F,MACA,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,CA4D1E,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,CAAC,EAAE,OAAO,MAAM,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,qBAAqB,CAAC;IAC7C;;OAEG;IACH,KAAY,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;CAC5E;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,MAAM,KACf,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,OAAO,CACI,CAAA;AAE3E;;GAEG;AACH,eAAO,MAAM,YAAY,4BAEvB,CAAA"}
+{"version":3,"file":"SqlClient.d.ts","sourceRoot":"","sources":["../../../src/unstable/sql/SqlClient.ts"],"names":[],"mappings":"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"}

package/dist/unstable/sql/SqlClient.js

@@ -1,4 +1,25 @@
 /**
+ * Defines the `SqlClient` service, the central runtime entry point for Effect's
+ * unstable SQL support.
+ *
+ * A `SqlClient` combines the tagged-template statement constructor with a
+ * scoped connection acquirer, dialect compiler, tracing attributes, optional row
+ * transforms, reactive query helpers, and transaction management. Applications
+ * typically consume it from `Context` to build parameterized queries, stream
+ * rows, run raw driver operations, reserve a connection for lower-level work, or
+ * wrap several query effects in `withTransaction`.
+ *
+ * Transactions are tracked through a per-client context service. Top-level
+ * transactions acquire the configured transaction connection and issue the
+ * dialect's begin/commit/rollback SQL; nested transactions reuse that
+ * connection and rely on dialect-provided savepoint SQL. A query only joins a
+ * transaction when it is run with the same client service, so avoid mixing
+ * clients or manually reserved connections when atomicity matters. Dialect
+ * integrations are also responsible for the compiler and transaction
+ * statements, which means placeholder syntax, identifier escaping, row
+ * transforms, savepoint support, and unprepared/raw statement behavior can
+ * differ by database.
+ *
  * @since 4.0.0
  */
 import { Clock } from "../../Clock.js";
@@ -13,12 +34,18 @@ import { Reactivity } from "../reactivity/Reactivity.js";
 import * as Statement from "./Statement.js";
 const TypeId = "~effect/sql/SqlClient";
 /**
+ * Context service tag for the `SqlClient` service.
+ *
  * @category models
  * @since 4.0.0
  */
 export const SqlClient = /*#__PURE__*/Context.Service("effect/sql/SqlClient");
 let clientIdCounter = 0;
 /**
+ * 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
  */
@@ -71,8 +98,12 @@ export const make = /*#__PURE__*/Effect.fnUntraced(function* (options) {
   return client;
 });
 /**
- * @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 const makeWithTransaction = options => effect => {
   return Effect.uninterruptibleMask(restore => Effect.useSpan("sql.transaction", {
@@ -106,10 +137,16 @@ export const makeWithTransaction = options => effect => {
   })));
 };
 /**
+ * Creates a unique context service tag for the active transaction connection of
+ * a specific SQL client.
+ *
  * @since 4.0.0
  */
 export const TransactionConnection = clientId => Context.Service(`effect/sql/SqlClient/TransactionConnection/${clientId}`);
 /**
+ * Context reference used by SQL integrations to opt in to safe integer
+ * handling; defaults to `false`.
+ *
  * @since 4.0.0
  */
 export const SafeIntegers = /*#__PURE__*/Context.Reference("effect/sql/SqlClient/SafeIntegers", {

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

@@ -1 +1 @@
-{"version":3,"file":"SqlClient.js","names":["Clock","Context","Effect","Exit","Option","Scope","Stream","Tracer","Reactivity","Statement","TypeId","SqlClient","Service","clientIdCounter","make","fnUntraced","options","transactionService","TransactionConnection","getConnection","flatMap","serviceOption","match","onNone","acquirer","onSome","conn","succeed","beginTransaction","commit","savepoint","name","rollback","rollbackSavepoint","transactionAcquirer","withTransaction","makeWithTransaction","spanAttributes","acquireConnection","scope","map","provide","begin","executeUnprepared","undefined","id","reactivity","client","Object","assign","compiler","transformRows","safe","reserve","withoutTransforms","statement","withoutTransform","reactive","reactiveQueue","keys","effect","pipe","fromQueue","unwrap","stream","reactiveMailbox","query","uninterruptibleMask","restore","useSpan","kind","span","withFiber","fiber","key","value","attribute","services","context","clock","getRef","connOption","getOption","_tag","provideContext","mutate","add","ParentSpan","exit","isSuccess","event","currentTimeNanosUnsafe","orDie","void","withScope","ensuring","close","clientId","SafeIntegers","Reference","defaultValue"],"sources":["../../../src/unstable/sql/SqlClient.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAGA,SAASA,KAAK,QAAQ,gBAAgB;AACtC,OAAO,KAAKC,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,IAAI,MAAM,eAAe;AACrC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AAGzC,OAAO,KAAKC,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AAEzC,SAASC,UAAU,QAAQ,6BAA6B;AAIxD,OAAO,KAAKC,SAAS,MAAM,gBAAgB;AAE3C,MAAMC,MAAM,GAAG,uBAAuB;AAoDtC;;;;AAIA,OAAO,MAAMC,SAAS,gBAAGV,OAAO,CAACW,OAAO,CAAY,sBAAsB,CAAC;AA8B3E,IAAIC,eAAe,GAAG,CAAC;AAEvB;;;;AAIA,OAAO,MAAMC,IAAI,gBAAGZ,MAAM,CAACa,UAAU,CAAC,WAAUC,OAA8B;EAC5E,MAAMC,kBAAkB,GAAGD,OAAO,CAACC,kBAAkB,IAAIC,qBAAqB,CAACL,eAAe,EAAE,CAAC;EACjG,MAAMM,aAAa,GAAGjB,MAAM,CAACkB,OAAO,CAClClB,MAAM,CAACmB,aAAa,CAACJ,kBAAkB,CAAC,EACxCb,MAAM,CAACkB,KAAK,CAAC;IACXC,MAAM,EAAEA,CAAA,KAAMP,OAAO,CAACQ,QAAQ;IAC9BC,MAAM,EAAEA,CAAC,CAACC,IAAI,CAAC,KAAKxB,MAAM,CAACyB,OAAO,CAACD,IAAI;GACxC,CAAC,CACH;EAED,MAAME,gBAAgB,GAAGZ,OAAO,CAACY,gBAAgB,IAAI,OAAO;EAC5D,MAAMC,MAAM,GAAGb,OAAO,CAACa,MAAM,IAAI,QAAQ;EACzC,MAAMC,SAAS,GAAGd,OAAO,CAACc,SAAS,KAAMC,IAAY,IAAK,aAAaA,IAAI,EAAE,CAAC;EAC9E,MAAMC,QAAQ,GAAGhB,OAAO,CAACgB,QAAQ,IAAI,UAAU;EAC/C,MAAMC,iBAAiB,GAAGjB,OAAO,CAACiB,iBAAiB,KAAMF,IAAY,IAAK,yBAAyBA,IAAI,EAAE,CAAC;EAC1G,MAAMG,mBAAmB,GAAGlB,OAAO,CAACkB,mBAAmB,IAAIlB,OAAO,CAACQ,QAAQ;EAC3E,MAAMW,eAAe,GAAGC,mBAAmB,CAAC;IAC1CnB,kBAAkB;IAClBoB,cAAc,EAAErB,OAAO,CAACqB,cAAc;IACtCC,iBAAiB,EAAEpC,MAAM,CAACkB,OAAO,CAC/Bf,KAAK,CAACS,IAAI,EAAE,EACXyB,KAAK,IAAKrC,MAAM,CAACsC,GAAG,CAACnC,KAAK,CAACoC,OAAO,CAACP,mBAAoB,EAAEK,KAAK,CAAC,EAAGb,IAAI,IAAK,CAACa,KAAK,EAAEb,IAAI,CAAU,CAAC,CACpG;IACDgB,KAAK,EAAGhB,IAAI,IAAKA,IAAI,CAACiB,iBAAiB,CAACf,gBAAgB,EAAE,EAAE,EAAEgB,SAAS,CAAC;IACxEd,SAAS,EAAEA,CAACJ,IAAI,EAAEmB,EAAE,KAAKnB,IAAI,CAACiB,iBAAiB,CAACb,SAAS,CAAC,cAAce,EAAE,EAAE,CAAC,EAAE,EAAE,EAAED,SAAS,CAAC;IAC7Ff,MAAM,EAAGH,IAAI,IAAKA,IAAI,CAACiB,iBAAiB,CAACd,MAAM,EAAE,EAAE,EAAEe,SAAS,CAAC;IAC/DZ,QAAQ,EAAGN,IAAI,IAAKA,IAAI,CAACiB,iBAAiB,CAACX,QAAQ,EAAE,EAAE,EAAEY,SAAS,CAAC;IACnEX,iBAAiB,EAAEA,CAACP,IAAI,EAAEmB,EAAE,KAAKnB,IAAI,CAACiB,iBAAiB,CAACV,iBAAiB,CAAC,cAAcY,EAAE,EAAE,CAAC,EAAE,EAAE,EAAED,SAAS;GAC7G,CAAC;EAEF,MAAME,UAAU,GAAG,OAAOtC,UAAU;EACpC,MAAMuC,MAAM,GAAcC,MAAM,CAACC,MAAM,CACrCxC,SAAS,CAACK,IAAI,CAACK,aAAa,EAAEH,OAAO,CAACkC,QAAQ,EAAElC,OAAO,CAACqB,cAAc,EAAErB,OAAO,CAACmC,aAAa,CAAC,EAC9F;IACE,CAACzC,MAAM,GAAGA,MAAuB;IACjC0C,IAAI,EAAER,SAAgB;IACtBT,eAAe;IACflB,kBAAkB;IAClBoC,OAAO,EAAEnB,mBAAmB;IAC5BoB,iBAAiBA,CAAA;MACf,IAAItC,OAAO,CAACmC,aAAa,KAAKP,SAAS,EAAE;QACvC,OAAO,IAAI;MACb;MACA,MAAMW,SAAS,GAAG9C,SAAS,CAACK,IAAI,CAC9BK,aAAa,EACbH,OAAO,CAACkC,QAAQ,CAACM,gBAAgB,EACjCxC,OAAO,CAACqB,cAAc,EACtBO,SAAS,CACV;MACD,MAAMG,MAAM,GAAGC,MAAM,CAACC,MAAM,CAACM,SAAS,EAAE;QACtC,GAAG,IAAI;QACP,GAAGA;OACJ,CAAC;MACAR,MAAc,CAACK,IAAI,GAAGL,MAAM;MAC5BA,MAAc,CAACO,iBAAiB,GAAG,MAAMP,MAAM;MACjD,OAAOA,MAAM;IACf,CAAC;IACDU,QAAQ,EAAEzC,OAAO,CAAC0C,aAAa,GAC7B,CACEC,IAA6E,EAC7EC,MAA8B,KAE9B5C,OAAO,CAAC0C,aAAc,CAACC,IAAI,EAAEC,MAAM,CAAC,CAACC,IAAI,CACvC3D,MAAM,CAACsC,GAAG,CAAClC,MAAM,CAACwD,SAAS,CAAC,EAC5BxD,MAAM,CAACyD,MAAM,CACd,GACHjB,UAAU,CAACkB,MAAM;IACnBC,eAAe,EAAEjD,OAAO,CAAC0C,aAAa,IAAIZ,UAAU,CAACoB;GACtD,CACF;EACCnB,MAAc,CAACK,IAAI,GAAGL,MAAM;EAE9B,OAAOA,MAAM;AACf,CAAC,CAAC;AAEF;;;;AAIA,OAAO,MAAMX,mBAAmB,GAAUpB,OASzC,IACS4C,MAA8B,IAAuC;EAC7E,OAAO1D,MAAM,CAACiE,mBAAmB,CAAEC,OAAO,IACxClE,MAAM,CAACmE,OAAO,CACZ,iBAAiB,EACjB;IAAEC,IAAI,EAAE;EAAQ,CAAE,EACjBC,IAAI,IACHrE,MAAM,CAACsE,SAAS,CAAsBC,KAAK,IAAI;IAC7C,KAAK,MAAM,CAACC,GAAG,EAAEC,KAAK,CAAC,IAAI3D,OAAO,CAACqB,cAAc,EAAE;MACjDkC,IAAI,CAACK,SAAS,CAACF,GAAG,EAAEC,KAAK,CAAC;IAC5B;IACA,MAAME,QAAQ,GAAGJ,KAAK,CAACK,OAAO;IAC9B,MAAMC,KAAK,GAAGN,KAAK,CAACO,MAAM,CAAChF,KAAK,CAAC;IACjC,MAAMiF,UAAU,GAAGhF,OAAO,CAACiF,SAAS,CAACL,QAAQ,EAAE7D,OAAO,CAACC,kBAAkB,CAAC;IAC1E,MAAMS,IAAI,GAAGuD,UAAU,CAACE,IAAI,KAAK,MAAM,GACnCjF,MAAM,CAACyB,OAAO,CAAC,CAACiB,SAAS,EAAEqC,UAAU,CAACN,KAAK,CAAC,CAAC,CAAC,CAAU,CAAC,GACzD3D,OAAO,CAACsB,iBAAiB;IAC7B,MAAMO,EAAE,GAAGoC,UAAU,CAACE,IAAI,KAAK,MAAM,GAAGF,UAAU,CAACN,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACnE,OAAOzE,MAAM,CAACkB,OAAO,CACnBM,IAAI,EACJ,CACE,CAACa,KAAK,EAAEb,IAAI,CAAC,KAEb,CAACmB,EAAE,KAAK,CAAC,GAAG7B,OAAO,CAAC0B,KAAK,CAAChB,IAAI,CAAC,GAAGV,OAAO,CAACc,SAAS,CAACJ,IAAI,EAAEmB,EAAE,CAAC,EAAEgB,IAAI,CACjE3D,MAAM,CAACkB,OAAO,CAAC,MACblB,MAAM,CAACkF,cAAc,CACnBhB,OAAO,CAACR,MAAM,CAAC,EACf3D,OAAO,CAACoF,MAAM,CAACR,QAAQ,EAAGA,QAAQ,IAChCA,QAAQ,CAAChB,IAAI,CACX5D,OAAO,CAACqF,GAAG,CAACtE,OAAO,CAACC,kBAAkB,EAAE,CAACS,IAAI,EAAEmB,EAAE,CAAC,CAAC,EACnD5C,OAAO,CAACqF,GAAG,CAAC/E,MAAM,CAACgF,UAAU,EAAEhB,IAAI,CAAC,CACrC,CAAC,CACL,CACF,EACDrE,MAAM,CAACsF,IAAI,EACXtF,MAAM,CAACkB,OAAO,CAAEoE,IAAI,IAAI;MACtB,IAAI5B,MAA2B;MAC/B,IAAIzD,IAAI,CAACsF,SAAS,CAACD,IAAI,CAAC,EAAE;QACxB,IAAI3C,EAAE,KAAK,CAAC,EAAE;UACZ0B,IAAI,CAACmB,KAAK,CAAC,uBAAuB,EAAEX,KAAK,CAACY,sBAAsB,EAAE,CAAC;UACnE/B,MAAM,GAAG1D,MAAM,CAAC0F,KAAK,CAAC5E,OAAO,CAACa,MAAM,CAACH,IAAI,CAAC,CAAC;QAC7C,CAAC,MAAM;UACL6C,IAAI,CAACmB,KAAK,CAAC,0BAA0B,EAAEX,KAAK,CAACY,sBAAsB,EAAE,CAAC;UACtE/B,MAAM,GAAG1D,MAAM,CAAC2F,IAAI;QACtB;MACF,CAAC,MAAM;QACLtB,IAAI,CAACmB,KAAK,CAAC,yBAAyB,EAAEX,KAAK,CAACY,sBAAsB,EAAE,CAAC;QACrE/B,MAAM,GAAG1D,MAAM,CAAC0F,KAAK,CACnB/C,EAAE,GAAG,CAAC,GACF7B,OAAO,CAACiB,iBAAiB,CAACP,IAAI,EAAEmB,EAAE,CAAC,GACnC7B,OAAO,CAACgB,QAAQ,CAACN,IAAI,CAAC,CAC3B;MACH;MACA,MAAMoE,SAAS,GAAGvD,KAAK,KAAKK,SAAS,GAAG1C,MAAM,CAAC6F,QAAQ,CAACnC,MAAM,EAAEvD,KAAK,CAAC2F,KAAK,CAACzD,KAAK,EAAEiD,IAAI,CAAC,CAAC,GAAG5B,MAAM;MAClG,OAAO1D,MAAM,CAACkB,OAAO,CAAC0E,SAAS,EAAE,MAAMN,IAAI,CAAC;IAC9C,CAAC,CAAC,CACH,CACJ;EACH,CAAC,CAAC,CACL,CACF;AACH,CAAC;AAmBD;;;AAGA,OAAO,MAAMtE,qBAAqB,GAChC+E,QAAgB,IAEhBhG,OAAO,CAACW,OAAO,CAAC,8CAA8CqF,QAAQ,EAAE,CAAC;AAE3E;;;AAGA,OAAO,MAAMC,YAAY,gBAAGjG,OAAO,CAACkG,SAAS,CAAU,mCAAmC,EAAE;EAC1FC,YAAY,EAAEA,CAAA,KAAM;CACrB,CAAC","ignoreList":[]}
+{"version":3,"file":"SqlClient.js","names":["Clock","Context","Effect","Exit","Option","Scope","Stream","Tracer","Reactivity","Statement","TypeId","SqlClient","Service","clientIdCounter","make","fnUntraced","options","transactionService","TransactionConnection","getConnection","flatMap","serviceOption","match","onNone","acquirer","onSome","conn","succeed","beginTransaction","commit","savepoint","name","rollback","rollbackSavepoint","transactionAcquirer","withTransaction","makeWithTransaction","spanAttributes","acquireConnection","scope","map","provide","begin","executeUnprepared","undefined","id","reactivity","client","Object","assign","compiler","transformRows","safe","reserve","withoutTransforms","statement","withoutTransform","reactive","reactiveQueue","keys","effect","pipe","fromQueue","unwrap","stream","reactiveMailbox","query","uninterruptibleMask","restore","useSpan","kind","span","withFiber","fiber","key","value","attribute","services","context","clock","getRef","connOption","getOption","_tag","provideContext","mutate","add","ParentSpan","exit","isSuccess","event","currentTimeNanosUnsafe","orDie","void","withScope","ensuring","close","clientId","SafeIntegers","Reference","defaultValue"],"sources":["../../../src/unstable/sql/SqlClient.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,SAASA,KAAK,QAAQ,gBAAgB;AACtC,OAAO,KAAKC,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,IAAI,MAAM,eAAe;AACrC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AAGzC,OAAO,KAAKC,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AAEzC,SAASC,UAAU,QAAQ,6BAA6B;AAIxD,OAAO,KAAKC,SAAS,MAAM,gBAAgB;AAE3C,MAAMC,MAAM,GAAG,uBAAuB;AAuDtC;;;;;;AAMA,OAAO,MAAMC,SAAS,gBAAGV,OAAO,CAACW,OAAO,CAAY,sBAAsB,CAAC;AAmC3E,IAAIC,eAAe,GAAG,CAAC;AAEvB;;;;;;;;AAQA,OAAO,MAAMC,IAAI,gBAAGZ,MAAM,CAACa,UAAU,CAAC,WAAUC,OAA8B;EAC5E,MAAMC,kBAAkB,GAAGD,OAAO,CAACC,kBAAkB,IAAIC,qBAAqB,CAACL,eAAe,EAAE,CAAC;EACjG,MAAMM,aAAa,GAAGjB,MAAM,CAACkB,OAAO,CAClClB,MAAM,CAACmB,aAAa,CAACJ,kBAAkB,CAAC,EACxCb,MAAM,CAACkB,KAAK,CAAC;IACXC,MAAM,EAAEA,CAAA,KAAMP,OAAO,CAACQ,QAAQ;IAC9BC,MAAM,EAAEA,CAAC,CAACC,IAAI,CAAC,KAAKxB,MAAM,CAACyB,OAAO,CAACD,IAAI;GACxC,CAAC,CACH;EAED,MAAME,gBAAgB,GAAGZ,OAAO,CAACY,gBAAgB,IAAI,OAAO;EAC5D,MAAMC,MAAM,GAAGb,OAAO,CAACa,MAAM,IAAI,QAAQ;EACzC,MAAMC,SAAS,GAAGd,OAAO,CAACc,SAAS,KAAMC,IAAY,IAAK,aAAaA,IAAI,EAAE,CAAC;EAC9E,MAAMC,QAAQ,GAAGhB,OAAO,CAACgB,QAAQ,IAAI,UAAU;EAC/C,MAAMC,iBAAiB,GAAGjB,OAAO,CAACiB,iBAAiB,KAAMF,IAAY,IAAK,yBAAyBA,IAAI,EAAE,CAAC;EAC1G,MAAMG,mBAAmB,GAAGlB,OAAO,CAACkB,mBAAmB,IAAIlB,OAAO,CAACQ,QAAQ;EAC3E,MAAMW,eAAe,GAAGC,mBAAmB,CAAC;IAC1CnB,kBAAkB;IAClBoB,cAAc,EAAErB,OAAO,CAACqB,cAAc;IACtCC,iBAAiB,EAAEpC,MAAM,CAACkB,OAAO,CAC/Bf,KAAK,CAACS,IAAI,EAAE,EACXyB,KAAK,IAAKrC,MAAM,CAACsC,GAAG,CAACnC,KAAK,CAACoC,OAAO,CAACP,mBAAoB,EAAEK,KAAK,CAAC,EAAGb,IAAI,IAAK,CAACa,KAAK,EAAEb,IAAI,CAAU,CAAC,CACpG;IACDgB,KAAK,EAAGhB,IAAI,IAAKA,IAAI,CAACiB,iBAAiB,CAACf,gBAAgB,EAAE,EAAE,EAAEgB,SAAS,CAAC;IACxEd,SAAS,EAAEA,CAACJ,IAAI,EAAEmB,EAAE,KAAKnB,IAAI,CAACiB,iBAAiB,CAACb,SAAS,CAAC,cAAce,EAAE,EAAE,CAAC,EAAE,EAAE,EAAED,SAAS,CAAC;IAC7Ff,MAAM,EAAGH,IAAI,IAAKA,IAAI,CAACiB,iBAAiB,CAACd,MAAM,EAAE,EAAE,EAAEe,SAAS,CAAC;IAC/DZ,QAAQ,EAAGN,IAAI,IAAKA,IAAI,CAACiB,iBAAiB,CAACX,QAAQ,EAAE,EAAE,EAAEY,SAAS,CAAC;IACnEX,iBAAiB,EAAEA,CAACP,IAAI,EAAEmB,EAAE,KAAKnB,IAAI,CAACiB,iBAAiB,CAACV,iBAAiB,CAAC,cAAcY,EAAE,EAAE,CAAC,EAAE,EAAE,EAAED,SAAS;GAC7G,CAAC;EAEF,MAAME,UAAU,GAAG,OAAOtC,UAAU;EACpC,MAAMuC,MAAM,GAAcC,MAAM,CAACC,MAAM,CACrCxC,SAAS,CAACK,IAAI,CAACK,aAAa,EAAEH,OAAO,CAACkC,QAAQ,EAAElC,OAAO,CAACqB,cAAc,EAAErB,OAAO,CAACmC,aAAa,CAAC,EAC9F;IACE,CAACzC,MAAM,GAAGA,MAAuB;IACjC0C,IAAI,EAAER,SAAgB;IACtBT,eAAe;IACflB,kBAAkB;IAClBoC,OAAO,EAAEnB,mBAAmB;IAC5BoB,iBAAiBA,CAAA;MACf,IAAItC,OAAO,CAACmC,aAAa,KAAKP,SAAS,EAAE;QACvC,OAAO,IAAI;MACb;MACA,MAAMW,SAAS,GAAG9C,SAAS,CAACK,IAAI,CAC9BK,aAAa,EACbH,OAAO,CAACkC,QAAQ,CAACM,gBAAgB,EACjCxC,OAAO,CAACqB,cAAc,EACtBO,SAAS,CACV;MACD,MAAMG,MAAM,GAAGC,MAAM,CAACC,MAAM,CAACM,SAAS,EAAE;QACtC,GAAG,IAAI;QACP,GAAGA;OACJ,CAAC;MACAR,MAAc,CAACK,IAAI,GAAGL,MAAM;MAC5BA,MAAc,CAACO,iBAAiB,GAAG,MAAMP,MAAM;MACjD,OAAOA,MAAM;IACf,CAAC;IACDU,QAAQ,EAAEzC,OAAO,CAAC0C,aAAa,GAC7B,CACEC,IAA6E,EAC7EC,MAA8B,KAE9B5C,OAAO,CAAC0C,aAAc,CAACC,IAAI,EAAEC,MAAM,CAAC,CAACC,IAAI,CACvC3D,MAAM,CAACsC,GAAG,CAAClC,MAAM,CAACwD,SAAS,CAAC,EAC5BxD,MAAM,CAACyD,MAAM,CACd,GACHjB,UAAU,CAACkB,MAAM;IACnBC,eAAe,EAAEjD,OAAO,CAAC0C,aAAa,IAAIZ,UAAU,CAACoB;GACtD,CACF;EACCnB,MAAc,CAACK,IAAI,GAAGL,MAAM;EAE9B,OAAOA,MAAM;AACf,CAAC,CAAC;AAEF;;;;;;;;AAQA,OAAO,MAAMX,mBAAmB,GAAUpB,OASzC,IACS4C,MAA8B,IAAuC;EAC7E,OAAO1D,MAAM,CAACiE,mBAAmB,CAAEC,OAAO,IACxClE,MAAM,CAACmE,OAAO,CACZ,iBAAiB,EACjB;IAAEC,IAAI,EAAE;EAAQ,CAAE,EACjBC,IAAI,IACHrE,MAAM,CAACsE,SAAS,CAAsBC,KAAK,IAAI;IAC7C,KAAK,MAAM,CAACC,GAAG,EAAEC,KAAK,CAAC,IAAI3D,OAAO,CAACqB,cAAc,EAAE;MACjDkC,IAAI,CAACK,SAAS,CAACF,GAAG,EAAEC,KAAK,CAAC;IAC5B;IACA,MAAME,QAAQ,GAAGJ,KAAK,CAACK,OAAO;IAC9B,MAAMC,KAAK,GAAGN,KAAK,CAACO,MAAM,CAAChF,KAAK,CAAC;IACjC,MAAMiF,UAAU,GAAGhF,OAAO,CAACiF,SAAS,CAACL,QAAQ,EAAE7D,OAAO,CAACC,kBAAkB,CAAC;IAC1E,MAAMS,IAAI,GAAGuD,UAAU,CAACE,IAAI,KAAK,MAAM,GACnCjF,MAAM,CAACyB,OAAO,CAAC,CAACiB,SAAS,EAAEqC,UAAU,CAACN,KAAK,CAAC,CAAC,CAAC,CAAU,CAAC,GACzD3D,OAAO,CAACsB,iBAAiB;IAC7B,MAAMO,EAAE,GAAGoC,UAAU,CAACE,IAAI,KAAK,MAAM,GAAGF,UAAU,CAACN,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACnE,OAAOzE,MAAM,CAACkB,OAAO,CACnBM,IAAI,EACJ,CACE,CAACa,KAAK,EAAEb,IAAI,CAAC,KAEb,CAACmB,EAAE,KAAK,CAAC,GAAG7B,OAAO,CAAC0B,KAAK,CAAChB,IAAI,CAAC,GAAGV,OAAO,CAACc,SAAS,CAACJ,IAAI,EAAEmB,EAAE,CAAC,EAAEgB,IAAI,CACjE3D,MAAM,CAACkB,OAAO,CAAC,MACblB,MAAM,CAACkF,cAAc,CACnBhB,OAAO,CAACR,MAAM,CAAC,EACf3D,OAAO,CAACoF,MAAM,CAACR,QAAQ,EAAGA,QAAQ,IAChCA,QAAQ,CAAChB,IAAI,CACX5D,OAAO,CAACqF,GAAG,CAACtE,OAAO,CAACC,kBAAkB,EAAE,CAACS,IAAI,EAAEmB,EAAE,CAAC,CAAC,EACnD5C,OAAO,CAACqF,GAAG,CAAC/E,MAAM,CAACgF,UAAU,EAAEhB,IAAI,CAAC,CACrC,CAAC,CACL,CACF,EACDrE,MAAM,CAACsF,IAAI,EACXtF,MAAM,CAACkB,OAAO,CAAEoE,IAAI,IAAI;MACtB,IAAI5B,MAA2B;MAC/B,IAAIzD,IAAI,CAACsF,SAAS,CAACD,IAAI,CAAC,EAAE;QACxB,IAAI3C,EAAE,KAAK,CAAC,EAAE;UACZ0B,IAAI,CAACmB,KAAK,CAAC,uBAAuB,EAAEX,KAAK,CAACY,sBAAsB,EAAE,CAAC;UACnE/B,MAAM,GAAG1D,MAAM,CAAC0F,KAAK,CAAC5E,OAAO,CAACa,MAAM,CAACH,IAAI,CAAC,CAAC;QAC7C,CAAC,MAAM;UACL6C,IAAI,CAACmB,KAAK,CAAC,0BAA0B,EAAEX,KAAK,CAACY,sBAAsB,EAAE,CAAC;UACtE/B,MAAM,GAAG1D,MAAM,CAAC2F,IAAI;QACtB;MACF,CAAC,MAAM;QACLtB,IAAI,CAACmB,KAAK,CAAC,yBAAyB,EAAEX,KAAK,CAACY,sBAAsB,EAAE,CAAC;QACrE/B,MAAM,GAAG1D,MAAM,CAAC0F,KAAK,CACnB/C,EAAE,GAAG,CAAC,GACF7B,OAAO,CAACiB,iBAAiB,CAACP,IAAI,EAAEmB,EAAE,CAAC,GACnC7B,OAAO,CAACgB,QAAQ,CAACN,IAAI,CAAC,CAC3B;MACH;MACA,MAAMoE,SAAS,GAAGvD,KAAK,KAAKK,SAAS,GAAG1C,MAAM,CAAC6F,QAAQ,CAACnC,MAAM,EAAEvD,KAAK,CAAC2F,KAAK,CAACzD,KAAK,EAAEiD,IAAI,CAAC,CAAC,GAAG5B,MAAM;MAClG,OAAO1D,MAAM,CAACkB,OAAO,CAAC0E,SAAS,EAAE,MAAMN,IAAI,CAAC;IAC9C,CAAC,CAAC,CACH,CACJ;EACH,CAAC,CAAC,CACL,CACF;AACH,CAAC;AA2BD;;;;;;AAMA,OAAO,MAAMtE,qBAAqB,GAChC+E,QAAgB,IAEhBhG,OAAO,CAACW,OAAO,CAAC,8CAA8CqF,QAAQ,EAAE,CAAC;AAE3E;;;;;;AAMA,OAAO,MAAMC,YAAY,gBAAGjG,OAAO,CAACkG,SAAS,CAAU,mCAAmC,EAAE;EAC1FC,YAAY,EAAEA,CAAA,KAAM;CACrB,CAAC","ignoreList":[]}

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

@@ -1,4 +1,24 @@
 /**
+ * Defines the low-level SQL connection service and shared row/acquirer types
+ * used by Effect's unstable SQL driver integrations.
+ *
+ * A `Connection` is the driver-facing layer underneath `SqlClient`: it executes
+ * already-compiled SQL with positional parameters and exposes transformed row
+ * results, raw driver results, streams, value arrays, and unprepared statement
+ * execution. Most applications should work through `SqlClient`, while driver
+ * integrations and advanced code use this module to provide scoped connection
+ * acquisition, implement pooling, reserve a connection for a workflow, or adapt
+ * a dialect-specific client into Effect.
+ *
+ * Connections are resources and should be acquired through an `Acquirer` in a
+ * `Scope` so pool checkout, transaction pinning, and release semantics are
+ * preserved. Transaction coordination lives at the `SqlClient` layer, so mixing
+ * manually reserved connections with transactional client queries can bypass the
+ * expected atomic boundary. Raw, unprepared, streaming, parameter, and row
+ * transformation behavior ultimately comes from the driver and dialect; check
+ * each integration for differences in placeholders, prepared statement support,
+ * cursor lifetime, and result shapes.
+ *
  * @since 4.0.0
  */
 import * as Context from "../../Context.ts";
@@ -7,6 +27,10 @@ import type { Scope } from "../../Scope.ts";
 import type { Stream } from "../../Stream.ts";
 import type { SqlError } from "./SqlError.ts";
 /**
+ * Low-level SQL driver connection capable of executing compiled SQL as
+ * transformed rows, raw results, streams, value arrays, or unprepared
+ * statements.
+ *
  * @category model
  * @since 4.0.0
  */
@@ -22,16 +46,23 @@ export interface Connection {
     readonly executeUnprepared: (sql: string, params: ReadonlyArray<unknown>, transformRows: (<A extends object>(row: ReadonlyArray<A>) => ReadonlyArray<A>) | undefined) => Effect<ReadonlyArray<any>, SqlError>;
 }
 /**
+ * Scoped effect that acquires a `Connection`, may fail with `SqlError`, and
+ * requires a `Scope` for release.
+ *
  * @category model
  * @since 4.0.0
  */
 export type Acquirer = Effect<Connection, SqlError, Scope>;
 /**
+ * Context service tag for a low-level SQL `Connection`.
+ *
  * @category tag
  * @since 4.0.0
  */
 export declare const Connection: Context.Service<Connection, Connection>;
 /**
+ * Generic SQL row shape mapping column names to unknown values.
+ *
  * @category model
  * @since 4.0.0
  */