@effect/sql-libsql 4.0.0-beta.7 → 4.0.0-beta.71

package/dist/LibsqlClient.d.ts

@@ -1,51 +1,98 @@
 /**
- * @since 1.0.0
+ * libSQL adapter for Effect SQL, backed by `@libsql/client`.
+ *
+ * Use this module to provide a {@link LibsqlClient} and the generic SQL client
+ * service for Turso-hosted libSQL databases, local `file:` databases, embedded
+ * replicas, migrations, tests, and server code that wants SQLite-compatible SQL
+ * through Effect layers. The client uses Effect SQL's SQLite compiler and
+ * classifies libSQL and SQLite failures as `SqlError`s.
+ *
+ * ## Mental model
+ *
+ * {@link make} and {@link layer} either create a scoped libSQL SDK client from
+ * connection options or wrap a caller-owned client supplied with `liveClient`.
+ * The Effect client serializes access to the underlying client because a libSQL
+ * transaction is tied to that client. A top-level `withTransaction` opens a
+ * write transaction, and nested transactions use SQLite savepoints.
+ *
+ * ## Common tasks
+ *
+ * - Use {@link layer} with concrete connection options, or {@link layerConfig}
+ *   when the options should come from `Config`.
+ * - Use a `file:` URL for local SQLite-compatible storage, a remote libSQL or
+ *   Turso URL for hosted databases, and `syncUrl` for embedded replicas.
+ * - Use `liveClient` when another component owns the `@libsql/client` instance
+ *   and its lifetime.
+ * - Use `transformQueryNames` and `transformResultNames` to map between Effect
+ *   field names and database column names.
+ *
+ * ## Gotchas
+ *
+ * Direct calls made through the raw SDK client are not coordinated with Effect
+ * SQL transactions. Remote transactions should stay short because they reserve
+ * the client until commit or rollback. Row streaming is not implemented by this
+ * adapter.
+ *
+ * @since 4.0.0
  */
 import * as Libsql from "@libsql/client";
 import * as Config from "effect/Config";
+import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Redacted from "effect/Redacted";
 import * as Scope from "effect/Scope";
-import * as ServiceMap from "effect/ServiceMap";
 import * as Reactivity from "effect/unstable/reactivity/Reactivity";
 import * as Client from "effect/unstable/sql/SqlClient";
 /**
- * @category type ids
- * @since 1.0.0
+ * Runtime type identifier used to mark `LibsqlClient` values.
+ *
+ * @category type IDs
+ * @since 4.0.0
  */
 export declare const TypeId: TypeId;
 /**
- * @category type ids
- * @since 1.0.0
+ * Type-level identifier used to mark `LibsqlClient` values.
+ *
+ * @category type IDs
+ * @since 4.0.0
  */
 export type TypeId = "~@effect/sql-libsql/LibsqlClient";
 /**
+ * libSQL-backed SQL client service, extending `SqlClient` with its runtime type marker and client configuration.
+ *
  * @category models
- * @since 1.0.0
+ * @since 4.0.0
  */
 export interface LibsqlClient extends Client.SqlClient {
     readonly [TypeId]: TypeId;
     readonly config: LibsqlClientConfig;
 }
 /**
+ * Context tag used to access the `LibsqlClient` service.
+ *
  * @category tags
- * @since 1.0.0
+ * @since 4.0.0
  */
-export declare const LibsqlClient: ServiceMap.Service<LibsqlClient, LibsqlClient>;
+export declare const LibsqlClient: Context.Service<LibsqlClient, LibsqlClient>;
 /**
+ * Configuration for a libSQL client, either by supplying connection options or an existing live libSQL client.
+ *
  * @category models
- * @since 1.0.0
+ * @since 4.0.0
  */
 export type LibsqlClientConfig = LibsqlClientConfig.Full | LibsqlClientConfig.Live;
 /**
- * @category models
- * @since 1.0.0
+ * Namespace containing the configuration variants for `LibsqlClient`.
+ *
+ * @since 4.0.0
  */
 export declare namespace LibsqlClientConfig {
     /**
+     * Shared libSQL client options for span attributes and query/result name transformations.
+     *
      * @category models
-     * @since 1.0.0
+     * @since 4.0.0
      */
     interface Base {
         readonly spanAttributes?: Record<string, unknown> | undefined;
@@ -53,11 +100,16 @@ export declare namespace LibsqlClientConfig {
         readonly transformQueryNames?: ((str: string) => string) | undefined;
     }
     /**
+     * Connection-based libSQL configuration used to create a managed client, including URL, credentials, sync, integer mode, TLS, and concurrency options.
+     *
      * @category models
-     * @since 1.0.0
+     * @since 4.0.0
      */
     interface Full extends Base {
-        /** The database URL.
+        /**
+         * The database URL.
+         *
+         * **Details**
          *
          * The client supports `libsql:`, `http:`/`https:`, `ws:`/`wss:` and `file:` URL. For more infomation,
          * please refer to the project README:
@@ -73,12 +125,18 @@ export declare namespace LibsqlClientConfig {
         readonly syncUrl?: string | URL | undefined;
         /** Sync interval in seconds. */
         readonly syncInterval?: number | undefined;
-        /** Enables or disables TLS for `libsql:` URLs.
+        /**
+         * Enables or disables TLS for `libsql:` URLs.
+         *
+         * **Details**
          *
          * By default, `libsql:` URLs use TLS. You can set this option to `false` to disable TLS.
          */
         readonly tls?: boolean | undefined;
-        /** How to convert SQLite integers to JavaScript values:
+        /**
+         * How to convert SQLite integers to JavaScript values.
+         *
+         * **Details**
          *
          * - `"number"` (default): returns SQLite integers as JavaScript `number`-s (double precision floats).
          * `number` cannot precisely represent integers larger than 2^53-1 in absolute value, so attempting to read
@@ -88,7 +146,10 @@ export declare namespace LibsqlClientConfig {
          * - `"string"`: returns SQLite integers as strings.
          */
         readonly intMode?: "number" | "bigint" | "string" | undefined;
-        /** Concurrency limit.
+        /**
+         * Concurrency limit.
+         *
+         * **Details**
          *
          * By default, the client performs up to 20 concurrent requests. You can set this option to a higher
          * number to increase the concurrency limit or set it to 0 to disable concurrency limits completely.
@@ -96,26 +157,34 @@ export declare namespace LibsqlClientConfig {
         readonly concurrency?: number | undefined;
     }
     /**
+     * Configuration that uses an existing libSQL client. The supplied `liveClient` is caller-owned and is not closed by the Effect client.
+     *
      * @category models
-     * @since 1.0.0
+     * @since 4.0.0
      */
     interface Live extends Base {
         readonly liveClient: Libsql.Client;
     }
 }
 /**
- * @category constructor
- * @since 1.0.0
+ * Creates a scoped libSQL SQL client with transaction support. When given connection options it creates and closes the SDK client; when given `liveClient`, the caller retains ownership.
+ *
+ * @category constructors
+ * @since 4.0.0
  */
 export declare const make: (options: LibsqlClientConfig) => Effect.Effect<LibsqlClient, never, Scope.Scope | Reactivity.Reactivity>;
 /**
+ * Creates a layer from a `Config`-wrapped libSQL client configuration, providing both `LibsqlClient` and `SqlClient`.
+ *
  * @category layers
- * @since 1.0.0
+ * @since 4.0.0
  */
 export declare const layerConfig: (config: Config.Wrap<LibsqlClientConfig>) => Layer.Layer<LibsqlClient | Client.SqlClient, Config.ConfigError>;
 /**
+ * Creates a layer from a concrete libSQL client configuration, providing both `LibsqlClient` and `SqlClient`.
+ *
  * @category layers
- * @since 1.0.0
+ * @since 4.0.0
  */
 export declare const layer: (config: LibsqlClientConfig) => Layer.Layer<LibsqlClient | Client.SqlClient>;
 //# sourceMappingURL=LibsqlClient.d.ts.map

package/dist/LibsqlClient.d.ts.map

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

package/dist/LibsqlClient.js

@@ -1,35 +1,79 @@
 /**
- * @since 1.0.0
+ * libSQL adapter for Effect SQL, backed by `@libsql/client`.
+ *
+ * Use this module to provide a {@link LibsqlClient} and the generic SQL client
+ * service for Turso-hosted libSQL databases, local `file:` databases, embedded
+ * replicas, migrations, tests, and server code that wants SQLite-compatible SQL
+ * through Effect layers. The client uses Effect SQL's SQLite compiler and
+ * classifies libSQL and SQLite failures as `SqlError`s.
+ *
+ * ## Mental model
+ *
+ * {@link make} and {@link layer} either create a scoped libSQL SDK client from
+ * connection options or wrap a caller-owned client supplied with `liveClient`.
+ * The Effect client serializes access to the underlying client because a libSQL
+ * transaction is tied to that client. A top-level `withTransaction` opens a
+ * write transaction, and nested transactions use SQLite savepoints.
+ *
+ * ## Common tasks
+ *
+ * - Use {@link layer} with concrete connection options, or {@link layerConfig}
+ *   when the options should come from `Config`.
+ * - Use a `file:` URL for local SQLite-compatible storage, a remote libSQL or
+ *   Turso URL for hosted databases, and `syncUrl` for embedded replicas.
+ * - Use `liveClient` when another component owns the `@libsql/client` instance
+ *   and its lifetime.
+ * - Use `transformQueryNames` and `transformResultNames` to map between Effect
+ *   field names and database column names.
+ *
+ * ## Gotchas
+ *
+ * Direct calls made through the raw SDK client are not coordinated with Effect
+ * SQL transactions. Remote transactions should stay short because they reserve
+ * the client until commit or rollback. Row streaming is not implemented by this
+ * adapter.
+ *
+ * @since 4.0.0
  */
 import * as Libsql from "@libsql/client";
 import * as Config from "effect/Config";
+import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Option from "effect/Option";
 import * as Redacted from "effect/Redacted";
 import * as Scope from "effect/Scope";
 import * as Semaphore from "effect/Semaphore";
-import * as ServiceMap from "effect/ServiceMap";
 import * as Stream from "effect/Stream";
 import * as Reactivity from "effect/unstable/reactivity/Reactivity";
 import * as Client from "effect/unstable/sql/SqlClient";
-import { SqlError } from "effect/unstable/sql/SqlError";
+import { classifySqliteError, SqlError } from "effect/unstable/sql/SqlError";
 import * as Statement from "effect/unstable/sql/Statement";
 const ATTR_DB_SYSTEM_NAME = "db.system.name";
+const classifyError = (cause, message, operation) => classifySqliteError(cause, {
+  message,
+  operation
+});
 /**
- * @category type ids
- * @since 1.0.0
+ * Runtime type identifier used to mark `LibsqlClient` values.
+ *
+ * @category type IDs
+ * @since 4.0.0
  */
 export const TypeId = "~@effect/sql-libsql/LibsqlClient";
 /**
+ * Context tag used to access the `LibsqlClient` service.
+ *
  * @category tags
- * @since 1.0.0
+ * @since 4.0.0
  */
-export const LibsqlClient = /*#__PURE__*/ServiceMap.Service("@effect/sql-libsql/LibsqlClient");
-const LibsqlTransaction = /*#__PURE__*/ServiceMap.Service("@effect/sql-libsql/LibsqlClient/LibsqlTransaction");
+export const LibsqlClient = /*#__PURE__*/Context.Service("@effect/sql-libsql/LibsqlClient");
+const LibsqlTransaction = /*#__PURE__*/Context.Service("@effect/sql-libsql/LibsqlClient/LibsqlTransaction");
 /**
- * @category constructor
- * @since 1.0.0
+ * Creates a scoped libSQL SQL client with transaction support. When given connection options it creates and closes the SDK client; when given `liveClient`, the caller retains ownership.
+ *
+ * @category constructors
+ * @since 4.0.0
  */
 export const make = options => Effect.gen(function* () {
   const compiler = Statement.makeCompilerSqlite(options.transformQueryNames);
@@ -47,8 +91,7 @@ export const make = options => Effect.gen(function* () {
           args: params
         }),
         catch: cause => new SqlError({
-          cause,
-          message: "Failed to execute statement"
+          reason: classifyError(cause, "Failed to execute statement", "execute")
         })
       }), results => results.rows);
     }
@@ -59,8 +102,7 @@ export const make = options => Effect.gen(function* () {
           args: params
         }),
         catch: cause => new SqlError({
-          cause,
-          message: "Failed to execute statement"
+          reason: classifyError(cause, "Failed to execute statement", "execute")
         })
       });
     }
@@ -83,8 +125,7 @@ export const make = options => Effect.gen(function* () {
       return Effect.map(Effect.tryPromise({
         try: () => this.sdk.transaction("write"),
         catch: cause => new SqlError({
-          cause,
-          message: "Failed to begin transaction"
+          reason: classifyError(cause, "Failed to begin transaction", "beginTransaction")
         })
       }), tx => new LibsqlConnectionImpl(tx));
     }
@@ -92,8 +133,7 @@ export const make = options => Effect.gen(function* () {
       return Effect.tryPromise({
         try: () => this.sdk.commit(),
         catch: cause => new SqlError({
-          cause,
-          message: "Failed to commit transaction"
+          reason: classifyError(cause, "Failed to commit transaction", "commitTransaction")
         })
       });
     }
@@ -101,8 +141,7 @@ export const make = options => Effect.gen(function* () {
       return Effect.tryPromise({
         try: () => this.sdk.rollback(),
         catch: cause => new SqlError({
-          cause,
-          message: "Failed to rollback transaction"
+          reason: classifyError(cause, "Failed to rollback transaction", "rollbackTransaction")
         })
       });
     }
@@ -149,13 +188,17 @@ export const make = options => Effect.gen(function* () {
   });
 });
 /**
+ * Creates a layer from a `Config`-wrapped libSQL client configuration, providing both `LibsqlClient` and `SqlClient`.
+ *
  * @category layers
- * @since 1.0.0
+ * @since 4.0.0
  */
-export const layerConfig = config => Layer.effectServices(Config.unwrap(config).asEffect().pipe(Effect.flatMap(make), Effect.map(client => ServiceMap.make(LibsqlClient, client).pipe(ServiceMap.add(Client.SqlClient, client))))).pipe(Layer.provide(Reactivity.layer));
+export const layerConfig = config => Layer.effectContext(Config.unwrap(config).pipe(Effect.flatMap(make), Effect.map(client => Context.make(LibsqlClient, client).pipe(Context.add(Client.SqlClient, client))))).pipe(Layer.provide(Reactivity.layer));
 /**
+ * Creates a layer from a concrete libSQL client configuration, providing both `LibsqlClient` and `SqlClient`.
+ *
  * @category layers
- * @since 1.0.0
+ * @since 4.0.0
  */
-export const layer = config => Layer.effectServices(Effect.map(make(config), client => ServiceMap.make(LibsqlClient, client).pipe(ServiceMap.add(Client.SqlClient, client)))).pipe(Layer.provide(Reactivity.layer));
+export const layer = config => Layer.effectContext(Effect.map(make(config), client => Context.make(LibsqlClient, client).pipe(Context.add(Client.SqlClient, client)))).pipe(Layer.provide(Reactivity.layer));
 //# sourceMappingURL=LibsqlClient.js.map

package/dist/LibsqlClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"LibsqlClient.js","names":["Libsql","Config","Effect","Layer","Option","Redacted","Scope","Semaphore","ServiceMap","Stream","Reactivity","Client","SqlError","Statement","ATTR_DB_SYSTEM_NAME","TypeId","LibsqlClient","Service","LibsqlTransaction","make","options","gen","compiler","makeCompilerSqlite","transformQueryNames","transformRows","transformResultNames","defaultTransforms","array","undefined","spanAttributes","Object","entries","LibsqlConnectionImpl","sdk","constructor","run","sql","params","map","tryPromise","try","execute","args","catch","cause","message","results","rows","runRaw","executeRaw","executeValues","row","Array","from","executeUnprepared","executeStream","die","beginTransaction","transaction","tx","commit","rollback","connection","liveClient","acquireRelease","sync","createClient","authToken","isRedacted","value","encryptionKey","url","toString","syncUrl","close","semaphore","withTransaction","makeWithTransaction","transactionService","acquireConnection","uninterruptibleMask","fnUntraced","restore","scope","makeUnsafe","take","addFinalizer","release","conn","begin","void","savepoint","id","rollbackSavepoint","acquirer","flatMap","serviceOption","match","onNone","withPermits","succeed","onSome","assign","config","layerConfig","effectServices","unwrap","asEffect","pipe","client","add","SqlClient","provide","layer"],"sources":["../src/LibsqlClient.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"LibsqlClient.js","names":["Libsql","Config","Context","Effect","Layer","Option","Redacted","Scope","Semaphore","Stream","Reactivity","Client","classifySqliteError","SqlError","Statement","ATTR_DB_SYSTEM_NAME","classifyError","cause","message","operation","TypeId","LibsqlClient","Service","LibsqlTransaction","make","options","gen","compiler","makeCompilerSqlite","transformQueryNames","transformRows","transformResultNames","defaultTransforms","array","undefined","spanAttributes","Object","entries","LibsqlConnectionImpl","sdk","constructor","run","sql","params","map","tryPromise","try","execute","args","catch","reason","results","rows","runRaw","executeRaw","executeValues","row","Array","from","executeUnprepared","executeStream","die","beginTransaction","transaction","tx","commit","rollback","connection","liveClient","acquireRelease","sync","createClient","authToken","isRedacted","value","encryptionKey","url","toString","syncUrl","close","semaphore","withTransaction","makeWithTransaction","transactionService","acquireConnection","uninterruptibleMask","fnUntraced","restore","scope","makeUnsafe","take","addFinalizer","release","conn","begin","void","savepoint","id","rollbackSavepoint","acquirer","flatMap","serviceOption","match","onNone","withPermits","succeed","onSome","assign","config","layerConfig","effectContext","unwrap","pipe","client","add","SqlClient","provide","layer"],"sources":["../src/LibsqlClient.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/LibsqlMigrator.d.ts

@@ -1,5 +1,36 @@
 /**
- * @since 1.0.0
+ * libSQL migration support for Effect SQL applications.
+ *
+ * This module adapts the shared SQL migrator to libSQL and Turso databases. It
+ * re-exports the common migration loaders and errors, then provides {@link run}
+ * and {@link layer} helpers that apply pending migrations with the current
+ * libSQL-backed `SqlClient`.
+ *
+ * **Mental model**
+ *
+ * Migrations are numbered operations loaded from files, records, or bundler
+ * glob results. The runner ensures the migrations table exists, reads the
+ * latest recorded id, and runs only migrations with a greater id through the
+ * configured libSQL client.
+ *
+ * **Common tasks**
+ *
+ * Use {@link run} during application startup, deployment, or setup scripts when
+ * migrations should be executed explicitly. Use {@link layer} in a layer graph
+ * when dependent services should be acquired only after the schema is prepared.
+ * Reuse the shared loaders from this module for file-based or in-memory
+ * migration definitions.
+ *
+ * **Gotchas**
+ *
+ * libSQL uses SQLite-compatible SQL, so avoid dialect features unsupported by
+ * libSQL or the configured Turso deployment. Remote Turso databases, local
+ * `file:` databases, and embedded replicas can observe different state until
+ * replication catches up. Run schema-changing migrations against the intended
+ * writer, coordinate concurrent migrators, and do not rely on
+ * `schemaDirectory` for libSQL schema dumps.
+ *
+ * @since 4.0.0
  */
 import type * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
@@ -7,17 +38,21 @@ import * as Migrator from "effect/unstable/sql/Migrator";
 import type * as Client from "effect/unstable/sql/SqlClient";
 import type { SqlError } from "effect/unstable/sql/SqlError";
 /**
- * @since 1.0.0
+ * @since 4.0.0
  */
 export * from "effect/unstable/sql/Migrator";
 /**
- * @category constructor
- * @since 1.0.0
+ * Runs SQL migrations using the configured `SqlClient`, returning the migrations that were applied.
+ *
+ * @category constructors
+ * @since 4.0.0
  */
 export declare const run: <R2 = never>(options: Migrator.MigratorOptions<R2>) => Effect.Effect<ReadonlyArray<readonly [id: number, name: string]>, Migrator.MigrationError | SqlError, Client.SqlClient | R2>;
 /**
- * @category constructor
- * @since 1.0.0
+ * Creates a layer that runs the configured SQL migrations during layer construction.
+ *
+ * @category constructors
+ * @since 4.0.0
  */
 export declare const layer: <R>(options: Migrator.MigratorOptions<R>) => Layer.Layer<never, Migrator.MigrationError | SqlError, Client.SqlClient | R>;
 //# sourceMappingURL=LibsqlMigrator.d.ts.map

package/dist/LibsqlMigrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LibsqlMigrator.d.ts","sourceRoot":"","sources":["../src/LibsqlMigrator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAA;AACxD,OAAO,KAAK,KAAK,MAAM,MAAM,+BAA+B,CAAA;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D;;GAEG;AACH,cAAc,8BAA8B,CAAA;AAE5C;;;GAGG;AACH,eAAO,MAAM,GAAG,EAAE,CAAC,EAAE,GAAG,KAAK,EAC3B,OAAO,EAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,KAClC,MAAM,CAAC,MAAM,CAChB,aAAa,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,EAClD,QAAQ,CAAC,cAAc,GAAG,QAAQ,EAClC,MAAM,CAAC,SAAS,GAAG,EAAE,CACF,CAAA;AAErB;;;GAGG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EACrB,SAAS,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,KACnC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,GAAG,QAAQ,EAAE,MAAM,CAAC,SAAS,GAAG,CAAC,CAAsC,CAAA"}
+{"version":3,"file":"LibsqlMigrator.d.ts","sourceRoot":"","sources":["../src/LibsqlMigrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAA;AACxD,OAAO,KAAK,KAAK,MAAM,MAAM,+BAA+B,CAAA;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D;;GAEG;AACH,cAAc,8BAA8B,CAAA;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,GAAG,EAAE,CAAC,EAAE,GAAG,KAAK,EAC3B,OAAO,EAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,KAClC,MAAM,CAAC,MAAM,CAChB,aAAa,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,EAClD,QAAQ,CAAC,cAAc,GAAG,QAAQ,EAClC,MAAM,CAAC,SAAS,GAAG,EAAE,CACF,CAAA;AAErB;;;;;GAKG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EACrB,SAAS,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,KACnC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,GAAG,QAAQ,EAAE,MAAM,CAAC,SAAS,GAAG,CAAC,CAAsC,CAAA"}

package/dist/LibsqlMigrator.js

@@ -1,17 +1,21 @@
 import * as Layer from "effect/Layer";
 import * as Migrator from "effect/unstable/sql/Migrator";
 /**
- * @since 1.0.0
+ * @since 4.0.0
  */
 export * from "effect/unstable/sql/Migrator";
 /**
- * @category constructor
- * @since 1.0.0
+ * Runs SQL migrations using the configured `SqlClient`, returning the migrations that were applied.
+ *
+ * @category constructors
+ * @since 4.0.0
  */
 export const run = /*#__PURE__*/Migrator.make({});
 /**
- * @category constructor
- * @since 1.0.0
+ * Creates a layer that runs the configured SQL migrations during layer construction.
+ *
+ * @category constructors
+ * @since 4.0.0
  */
 export const layer = options => Layer.effectDiscard(run(options));
 //# sourceMappingURL=LibsqlMigrator.js.map

package/dist/LibsqlMigrator.js.map

@@ -1 +1 @@
-{"version":3,"file":"LibsqlMigrator.js","names":["Layer","Migrator","run","make","layer","options","effectDiscard"],"sources":["../src/LibsqlMigrator.ts"],"sourcesContent":[null],"mappings":"AAIA,OAAO,KAAKA,KAAK,MAAM,cAAc;AACrC,OAAO,KAAKC,QAAQ,MAAM,8BAA8B;AAIxD;;;AAGA,cAAc,8BAA8B;AAE5C;;;;AAIA,OAAO,MAAMC,GAAG,gBAMZD,QAAQ,CAACE,IAAI,CAAC,EAAE,CAAC;AAErB;;;;AAIA,OAAO,MAAMC,KAAK,GAChBC,OAAoC,IAC6CL,KAAK,CAACM,aAAa,CAACJ,GAAG,CAACG,OAAO,CAAC,CAAC","ignoreList":[]}
+{"version":3,"file":"LibsqlMigrator.js","names":["Layer","Migrator","run","make","layer","options","effectDiscard"],"sources":["../src/LibsqlMigrator.ts"],"sourcesContent":[null],"mappings":"AAmCA,OAAO,KAAKA,KAAK,MAAM,cAAc;AACrC,OAAO,KAAKC,QAAQ,MAAM,8BAA8B;AAIxD;;;AAGA,cAAc,8BAA8B;AAE5C;;;;;;AAMA,OAAO,MAAMC,GAAG,gBAMZD,QAAQ,CAACE,IAAI,CAAC,EAAE,CAAC;AAErB;;;;;;AAMA,OAAO,MAAMC,KAAK,GAChBC,OAAoC,IAC6CL,KAAK,CAACM,aAAa,CAACJ,GAAG,CAACG,OAAO,CAAC,CAAC","ignoreList":[]}

package/dist/index.d.ts

@@ -1,12 +1,12 @@
 /**
- * @since 1.0.0
+ * @since 4.0.0
  */
 /**
- * @since 1.0.0
+ * @since 4.0.0
  */
 export * as LibsqlClient from "./LibsqlClient.ts";
 /**
- * @since 1.0.0
+ * @since 4.0.0
  */
 export * as LibsqlMigrator from "./LibsqlMigrator.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,13 +1,13 @@
 /**
- * @since 1.0.0
+ * @since 4.0.0
  */
 // @barrel: Auto-generated exports. Do not edit manually.
 /**
- * @since 1.0.0
+ * @since 4.0.0
  */
 export * as LibsqlClient from "./LibsqlClient.js";
 /**
- * @since 1.0.0
+ * @since 4.0.0
  */
 export * as LibsqlMigrator from "./LibsqlMigrator.js";
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@effect/sql-libsql",
-  "version": "4.0.0-beta.7",
+  "version": "4.0.0-beta.71",
   "type": "module",
   "license": "MIT",
   "description": "A libSQL toolkit for Effect",
@@ -45,14 +45,14 @@
     "provenance": true
   },
   "devDependencies": {
-    "testcontainers": "^11.11.0",
-    "effect": "^4.0.0-beta.7"
+    "testcontainers": "^11.14.0",
+    "effect": "^4.0.0-beta.71"
   },
   "peerDependencies": {
-    "effect": "^4.0.0-beta.7"
+    "effect": "^4.0.0-beta.71"
   },
   "dependencies": {
-    "@libsql/client": "^0.17.0"
+    "@libsql/client": "^0.17.3"
   },
   "scripts": {
     "codegen": "effect-utils codegen",

package/src/LibsqlClient.ts

@@ -1,39 +1,82 @@
 /**
- * @since 1.0.0
+ * libSQL adapter for Effect SQL, backed by `@libsql/client`.
+ *
+ * Use this module to provide a {@link LibsqlClient} and the generic SQL client
+ * service for Turso-hosted libSQL databases, local `file:` databases, embedded
+ * replicas, migrations, tests, and server code that wants SQLite-compatible SQL
+ * through Effect layers. The client uses Effect SQL's SQLite compiler and
+ * classifies libSQL and SQLite failures as `SqlError`s.
+ *
+ * ## Mental model
+ *
+ * {@link make} and {@link layer} either create a scoped libSQL SDK client from
+ * connection options or wrap a caller-owned client supplied with `liveClient`.
+ * The Effect client serializes access to the underlying client because a libSQL
+ * transaction is tied to that client. A top-level `withTransaction` opens a
+ * write transaction, and nested transactions use SQLite savepoints.
+ *
+ * ## Common tasks
+ *
+ * - Use {@link layer} with concrete connection options, or {@link layerConfig}
+ *   when the options should come from `Config`.
+ * - Use a `file:` URL for local SQLite-compatible storage, a remote libSQL or
+ *   Turso URL for hosted databases, and `syncUrl` for embedded replicas.
+ * - Use `liveClient` when another component owns the `@libsql/client` instance
+ *   and its lifetime.
+ * - Use `transformQueryNames` and `transformResultNames` to map between Effect
+ *   field names and database column names.
+ *
+ * ## Gotchas
+ *
+ * Direct calls made through the raw SDK client are not coordinated with Effect
+ * SQL transactions. Remote transactions should stay short because they reserve
+ * the client until commit or rollback. Row streaming is not implemented by this
+ * adapter.
+ *
+ * @since 4.0.0
  */
 import * as Libsql from "@libsql/client"
 import * as Config from "effect/Config"
+import * as Context from "effect/Context"
 import * as Effect from "effect/Effect"
 import * as Layer from "effect/Layer"
 import * as Option from "effect/Option"
 import * as Redacted from "effect/Redacted"
 import * as Scope from "effect/Scope"
 import * as Semaphore from "effect/Semaphore"
-import * as ServiceMap from "effect/ServiceMap"
 import * as Stream from "effect/Stream"
 import * as Reactivity from "effect/unstable/reactivity/Reactivity"
 import * as Client from "effect/unstable/sql/SqlClient"
 import type { Connection } from "effect/unstable/sql/SqlConnection"
-import { SqlError } from "effect/unstable/sql/SqlError"
+import { classifySqliteError, SqlError } from "effect/unstable/sql/SqlError"
 import * as Statement from "effect/unstable/sql/Statement"
 
 const ATTR_DB_SYSTEM_NAME = "db.system.name"
 
+const classifyError = (cause: unknown, message: string, operation: string) =>
+  classifySqliteError(cause, { message, operation })
+
 /**
- * @category type ids
- * @since 1.0.0
+ * Runtime type identifier used to mark `LibsqlClient` values.
+ *
+ * @category type IDs
+ * @since 4.0.0
  */
 export const TypeId: TypeId = "~@effect/sql-libsql/LibsqlClient"
 
 /**
- * @category type ids
- * @since 1.0.0
+ * Type-level identifier used to mark `LibsqlClient` values.
+ *
+ * @category type IDs
+ * @since 4.0.0
  */
 export type TypeId = "~@effect/sql-libsql/LibsqlClient"
 
 /**
+ * libSQL-backed SQL client service, extending `SqlClient` with its runtime type marker and client configuration.
+ *
  * @category models
- * @since 1.0.0
+ * @since 4.0.0
  */
 export interface LibsqlClient extends Client.SqlClient {
   readonly [TypeId]: TypeId
@@ -41,29 +84,36 @@ export interface LibsqlClient extends Client.SqlClient {
 }
 
 /**
+ * Context tag used to access the `LibsqlClient` service.
+ *
  * @category tags
- * @since 1.0.0
+ * @since 4.0.0
  */
-export const LibsqlClient = ServiceMap.Service<LibsqlClient>("@effect/sql-libsql/LibsqlClient")
+export const LibsqlClient = Context.Service<LibsqlClient>("@effect/sql-libsql/LibsqlClient")
 
-const LibsqlTransaction = ServiceMap.Service<readonly [LibsqlConnection, counter: number]>(
+const LibsqlTransaction = Context.Service<readonly [LibsqlConnection, counter: number]>(
   "@effect/sql-libsql/LibsqlClient/LibsqlTransaction"
 )
 
 /**
+ * Configuration for a libSQL client, either by supplying connection options or an existing live libSQL client.
+ *
  * @category models
- * @since 1.0.0
+ * @since 4.0.0
  */
 export type LibsqlClientConfig = LibsqlClientConfig.Full | LibsqlClientConfig.Live
 
 /**
- * @category models
- * @since 1.0.0
+ * Namespace containing the configuration variants for `LibsqlClient`.
+ *
+ * @since 4.0.0
  */
 export declare namespace LibsqlClientConfig {
   /**
+   * Shared libSQL client options for span attributes and query/result name transformations.
+   *
    * @category models
-   * @since 1.0.0
+   * @since 4.0.0
    */
   export interface Base {
     readonly spanAttributes?: Record<string, unknown> | undefined
@@ -72,11 +122,16 @@ export declare namespace LibsqlClientConfig {
   }
 
   /**
+   * Connection-based libSQL configuration used to create a managed client, including URL, credentials, sync, integer mode, TLS, and concurrency options.
+   *
    * @category models
-   * @since 1.0.0
+   * @since 4.0.0
    */
   export interface Full extends Base {
-    /** The database URL.
+    /**
+     * The database URL.
+     *
+     * **Details**
      *
      * The client supports `libsql:`, `http:`/`https:`, `ws:`/`wss:` and `file:` URL. For more infomation,
      * please refer to the project README:
@@ -92,12 +147,18 @@ export declare namespace LibsqlClientConfig {
     readonly syncUrl?: string | URL | undefined
     /** Sync interval in seconds. */
     readonly syncInterval?: number | undefined
-    /** Enables or disables TLS for `libsql:` URLs.
+    /**
+     * Enables or disables TLS for `libsql:` URLs.
+     *
+     * **Details**
      *
      * By default, `libsql:` URLs use TLS. You can set this option to `false` to disable TLS.
      */
     readonly tls?: boolean | undefined
-    /** How to convert SQLite integers to JavaScript values:
+    /**
+     * How to convert SQLite integers to JavaScript values.
+     *
+     * **Details**
      *
      * - `"number"` (default): returns SQLite integers as JavaScript `number`-s (double precision floats).
      * `number` cannot precisely represent integers larger than 2^53-1 in absolute value, so attempting to read
@@ -107,7 +168,10 @@ export declare namespace LibsqlClientConfig {
      * - `"string"`: returns SQLite integers as strings.
      */
     readonly intMode?: "number" | "bigint" | "string" | undefined
-    /** Concurrency limit.
+    /**
+     * Concurrency limit.
+     *
+     * **Details**
      *
      * By default, the client performs up to 20 concurrent requests. You can set this option to a higher
      * number to increase the concurrency limit or set it to 0 to disable concurrency limits completely.
@@ -116,8 +180,10 @@ export declare namespace LibsqlClientConfig {
   }
 
   /**
+   * Configuration that uses an existing libSQL client. The supplied `liveClient` is caller-owned and is not closed by the Effect client.
+   *
    * @category models
-   * @since 1.0.0
+   * @since 4.0.0
    */
   export interface Live extends Base {
     readonly liveClient: Libsql.Client
@@ -131,8 +197,10 @@ interface LibsqlConnection extends Connection {
 }
 
 /**
- * @category constructor
- * @since 1.0.0
+ * Creates a scoped libSQL SQL client with transaction support. When given connection options it creates and closes the SDK client; when given `liveClient`, the caller retains ownership.
+ *
+ * @category constructors
+ * @since 4.0.0
  */
 export const make = (
   options: LibsqlClientConfig
@@ -163,7 +231,7 @@ export const make = (
         return Effect.map(
           Effect.tryPromise({
             try: () => this.sdk.execute({ sql, args: params as Array<any> }),
-            catch: (cause) => new SqlError({ cause, message: "Failed to execute statement" })
+            catch: (cause) => new SqlError({ reason: classifyError(cause, "Failed to execute statement", "execute") })
           }),
           (results) => results.rows
         )
@@ -175,7 +243,7 @@ export const make = (
       ) {
         return Effect.tryPromise({
           try: () => this.sdk.execute({ sql, args: params as Array<any> }),
-          catch: (cause) => new SqlError({ cause, message: "Failed to execute statement" })
+          catch: (cause) => new SqlError({ reason: classifyError(cause, "Failed to execute statement", "execute") })
         })
       }
 
@@ -208,7 +276,8 @@ export const make = (
         return Effect.map(
           Effect.tryPromise({
             try: () => (this.sdk as Libsql.Client).transaction("write"),
-            catch: (cause) => new SqlError({ cause, message: "Failed to begin transaction" })
+            catch: (cause) =>
+              new SqlError({ reason: classifyError(cause, "Failed to begin transaction", "beginTransaction") })
           }),
           (tx) => new LibsqlConnectionImpl(tx)
         )
@@ -216,13 +285,15 @@ export const make = (
       get commit() {
         return Effect.tryPromise({
           try: () => (this.sdk as Libsql.Transaction).commit(),
-          catch: (cause) => new SqlError({ cause, message: "Failed to commit transaction" })
+          catch: (cause) =>
+            new SqlError({ reason: classifyError(cause, "Failed to commit transaction", "commitTransaction") })
         })
       }
       get rollback() {
         return Effect.tryPromise({
           try: () => (this.sdk as Libsql.Transaction).rollback(),
-          catch: (cause) => new SqlError({ cause, message: "Failed to rollback transaction" })
+          catch: (cause) =>
+            new SqlError({ reason: classifyError(cause, "Failed to rollback transaction", "rollbackTransaction") })
         })
       }
     }
@@ -294,35 +365,39 @@ export const make = (
   })
 
 /**
+ * Creates a layer from a `Config`-wrapped libSQL client configuration, providing both `LibsqlClient` and `SqlClient`.
+ *
  * @category layers
- * @since 1.0.0
+ * @since 4.0.0
  */
 export const layerConfig: (
   config: Config.Wrap<LibsqlClientConfig>
 ) => Layer.Layer<LibsqlClient | Client.SqlClient, Config.ConfigError> = (
   config: Config.Wrap<LibsqlClientConfig>
 ): Layer.Layer<LibsqlClient | Client.SqlClient, Config.ConfigError> =>
-  Layer.effectServices(
-    Config.unwrap(config).asEffect().pipe(
+  Layer.effectContext(
+    Config.unwrap(config).pipe(
       Effect.flatMap(make),
       Effect.map((client) =>
-        ServiceMap.make(LibsqlClient, client).pipe(
-          ServiceMap.add(Client.SqlClient, client)
+        Context.make(LibsqlClient, client).pipe(
+          Context.add(Client.SqlClient, client)
         )
       )
     )
   ).pipe(Layer.provide(Reactivity.layer))
 
 /**
+ * Creates a layer from a concrete libSQL client configuration, providing both `LibsqlClient` and `SqlClient`.
+ *
  * @category layers
- * @since 1.0.0
+ * @since 4.0.0
  */
 export const layer = (
   config: LibsqlClientConfig
 ): Layer.Layer<LibsqlClient | Client.SqlClient> =>
-  Layer.effectServices(
+  Layer.effectContext(
     Effect.map(make(config), (client) =>
-      ServiceMap.make(LibsqlClient, client).pipe(
-        ServiceMap.add(Client.SqlClient, client)
+      Context.make(LibsqlClient, client).pipe(
+        Context.add(Client.SqlClient, client)
       ))
   ).pipe(Layer.provide(Reactivity.layer))

package/src/LibsqlMigrator.ts

@@ -1,5 +1,36 @@
 /**
- * @since 1.0.0
+ * libSQL migration support for Effect SQL applications.
+ *
+ * This module adapts the shared SQL migrator to libSQL and Turso databases. It
+ * re-exports the common migration loaders and errors, then provides {@link run}
+ * and {@link layer} helpers that apply pending migrations with the current
+ * libSQL-backed `SqlClient`.
+ *
+ * **Mental model**
+ *
+ * Migrations are numbered operations loaded from files, records, or bundler
+ * glob results. The runner ensures the migrations table exists, reads the
+ * latest recorded id, and runs only migrations with a greater id through the
+ * configured libSQL client.
+ *
+ * **Common tasks**
+ *
+ * Use {@link run} during application startup, deployment, or setup scripts when
+ * migrations should be executed explicitly. Use {@link layer} in a layer graph
+ * when dependent services should be acquired only after the schema is prepared.
+ * Reuse the shared loaders from this module for file-based or in-memory
+ * migration definitions.
+ *
+ * **Gotchas**
+ *
+ * libSQL uses SQLite-compatible SQL, so avoid dialect features unsupported by
+ * libSQL or the configured Turso deployment. Remote Turso databases, local
+ * `file:` databases, and embedded replicas can observe different state until
+ * replication catches up. Run schema-changing migrations against the intended
+ * writer, coordinate concurrent migrators, and do not rely on
+ * `schemaDirectory` for libSQL schema dumps.
+ *
+ * @since 4.0.0
  */
 import type * as Effect from "effect/Effect"
 import * as Layer from "effect/Layer"
@@ -8,13 +39,15 @@ import type * as Client from "effect/unstable/sql/SqlClient"
 import type { SqlError } from "effect/unstable/sql/SqlError"
 
 /**
- * @since 1.0.0
+ * @since 4.0.0
  */
 export * from "effect/unstable/sql/Migrator"
 
 /**
- * @category constructor
- * @since 1.0.0
+ * Runs SQL migrations using the configured `SqlClient`, returning the migrations that were applied.
+ *
+ * @category constructors
+ * @since 4.0.0
  */
 export const run: <R2 = never>(
   options: Migrator.MigratorOptions<R2>
@@ -25,8 +58,10 @@ export const run: <R2 = never>(
 > = Migrator.make({})
 
 /**
- * @category constructor
- * @since 1.0.0
+ * Creates a layer that runs the configured SQL migrations during layer construction.
+ *
+ * @category constructors
+ * @since 4.0.0
  */
 export const layer = <R>(
   options: Migrator.MigratorOptions<R>

package/src/index.ts

@@ -1,15 +1,15 @@
 /**
- * @since 1.0.0
+ * @since 4.0.0
  */
 
 // @barrel: Auto-generated exports. Do not edit manually.
 
 /**
- * @since 1.0.0
+ * @since 4.0.0
  */
 export * as LibsqlClient from "./LibsqlClient.ts"
 
 /**
- * @since 1.0.0
+ * @since 4.0.0
  */
 export * as LibsqlMigrator from "./LibsqlMigrator.ts"