@effect/sql-sqlite-bun 4.0.0-beta.67 → 4.0.0-beta.69

package/dist/SqliteClient.d.ts

@@ -9,14 +9,14 @@ import { SqlError } from "effect/unstable/sql/SqlError";
 /**
  * Runtime type identifier used to mark Bun `SqliteClient` values.
  *
- * @category type ids
+ * @category type IDs
  * @since 4.0.0
  */
 export declare const TypeId: TypeId;
 /**
  * Type-level identifier used to mark Bun `SqliteClient` values.
  *
- * @category type ids
+ * @category type IDs
  * @since 4.0.0
  */
 export type TypeId = "~@effect/sql-sqlite-bun/SqliteClient";
@@ -60,7 +60,7 @@ export interface SqliteClientConfig {
 /**
  * Creates a scoped Bun SQLite client for a database file, enabling WAL by default and serializing access. Streaming queries are not implemented.
  *
- * @category constructor
+ * @category constructors
  * @since 4.0.0
  */
 export declare const make: (options: SqliteClientConfig) => Effect.Effect<SqliteClient, never, Scope.Scope | Reactivity.Reactivity>;

package/dist/SqliteClient.js

@@ -40,7 +40,7 @@ const classifyError = (cause, message, operation) => classifySqliteError(cause,
 /**
  * Runtime type identifier used to mark Bun `SqliteClient` values.
  *
- * @category type ids
+ * @category type IDs
  * @since 4.0.0
  */
 export const TypeId = "~@effect/sql-sqlite-bun/SqliteClient";
@@ -54,7 +54,7 @@ export const SqliteClient = /*#__PURE__*/Context.Service("@effect/sql-sqlite-bun
 /**
  * Creates a scoped Bun SQLite client for a database file, enabling WAL by default and serializing access. Streaming queries are not implemented.
  *
- * @category constructor
+ * @category constructors
  * @since 4.0.0
  */
 export const make = options => Effect.gen(function* () {

package/dist/SqliteMigrator.d.ts

@@ -33,14 +33,14 @@ export * from "effect/unstable/sql/Migrator";
 /**
  * Runs SQL migrations using the configured `SqlClient`, returning the migrations that were applied.
  *
- * @category constructor
+ * @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>;
 /**
  * Creates a layer that runs the configured SQL migrations during layer construction.
  *
- * @category constructor
+ * @category constructors
  * @since 4.0.0
  */
 export declare const layer: <R>(options: Migrator.MigratorOptions<R>) => Layer.Layer<never, SqlError | Migrator.MigrationError, Client.SqlClient | R>;

package/dist/SqliteMigrator.js

@@ -7,7 +7,7 @@ export * from "effect/unstable/sql/Migrator";
 /**
  * Runs SQL migrations using the configured `SqlClient`, returning the migrations that were applied.
  *
- * @category constructor
+ * @category constructors
  * @since 4.0.0
  */
 export const run = /*#__PURE__*/Migrator.make({
@@ -56,7 +56,7 @@ export const run = /*#__PURE__*/Migrator.make({
 /**
  * Creates a layer that runs the configured SQL migrations during layer construction.
  *
- * @category constructor
+ * @category constructors
  * @since 4.0.0
  */
 export const layer = options => Layer.effectDiscard(run(options));

package/dist/index.d.ts

@@ -2,10 +2,47 @@
  * @since 4.0.0
  */
 /**
+ * Bun SQLite client implementation for Effect SQL, backed by `bun:sqlite`.
+ *
+ * This module provides constructors and layers for using a Bun-managed SQLite database as both the
+ * SQLite-specific `SqliteClient` service and the generic `SqlClient` service. It is intended for
+ * file-backed or in-memory databases in Bun applications, local development tools, migrations,
+ * integration tests, and embedded persistence use cases that need Effect SQL query compilation plus
+ * SQLite-specific helpers such as database export and native extension loading.
+ *
+ * Each client owns one scoped `bun:sqlite` `Database` handle and serializes access through it, which
+ * is important because Bun executes SQLite statements synchronously. WAL mode is enabled by default,
+ * so set `disableWAL` when opening read-only databases or when the database file or directory cannot
+ * be updated with SQLite's WAL side files. A transaction holds the serialized connection permit for
+ * the transaction scope, so concurrent fibers using the same client wait until it completes, while
+ * separate database handles or processes can still contend for SQLite write locks. Safe integer
+ * handling follows the `SqlClient` fiber-local setting, `executeStream` is not implemented, and
+ * SQLite does not support `updateValues`.
+ *
  * @since 4.0.0
  */
 export * as SqliteClient from "./SqliteClient.ts";
 /**
+ * Utilities for applying Effect SQL migrations to Bun SQLite databases.
+ *
+ * This module re-exports the shared `Migrator` loaders and error types, then
+ * provides `run` and `layer` helpers for applying ordered migrations through
+ * the current Bun-backed SQLite `SqlClient`. It is typically used at
+ * application startup, in deployment or setup scripts that prepare a local
+ * SQLite file, in integration tests with temporary database files, or in layer
+ * graphs that must install the schema before dependent services are acquired.
+ *
+ * Migrations are recorded in `effect_sql_migrations` by default and are loaded
+ * using the shared `<id>_<name>` file or record-key convention. Only migrations
+ * with an id greater than the latest recorded id are applied, so every client
+ * involved in startup should point at the same SQLite filename and use a
+ * writable Bun SQLite configuration. The Bun client enables WAL by default and
+ * serializes access through a single `bun:sqlite` database handle, but separate
+ * handles or processes can still contend for SQLite write locks. Bun's SQLite
+ * driver runs statements synchronously, so large migration sets can block the
+ * invoking runtime thread, and this adapter does not currently write SQLite
+ * schema dumps for `schemaDirectory`.
+ *
  * @since 4.0.0
  */
 export * as SqliteMigrator from "./SqliteMigrator.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AAEjD;;GAEG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AAEjD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA"}

package/dist/index.js

@@ -3,10 +3,47 @@
  */
 // @barrel: Auto-generated exports. Do not edit manually.
 /**
+ * Bun SQLite client implementation for Effect SQL, backed by `bun:sqlite`.
+ *
+ * This module provides constructors and layers for using a Bun-managed SQLite database as both the
+ * SQLite-specific `SqliteClient` service and the generic `SqlClient` service. It is intended for
+ * file-backed or in-memory databases in Bun applications, local development tools, migrations,
+ * integration tests, and embedded persistence use cases that need Effect SQL query compilation plus
+ * SQLite-specific helpers such as database export and native extension loading.
+ *
+ * Each client owns one scoped `bun:sqlite` `Database` handle and serializes access through it, which
+ * is important because Bun executes SQLite statements synchronously. WAL mode is enabled by default,
+ * so set `disableWAL` when opening read-only databases or when the database file or directory cannot
+ * be updated with SQLite's WAL side files. A transaction holds the serialized connection permit for
+ * the transaction scope, so concurrent fibers using the same client wait until it completes, while
+ * separate database handles or processes can still contend for SQLite write locks. Safe integer
+ * handling follows the `SqlClient` fiber-local setting, `executeStream` is not implemented, and
+ * SQLite does not support `updateValues`.
+ *
  * @since 4.0.0
  */
 export * as SqliteClient from "./SqliteClient.js";
 /**
+ * Utilities for applying Effect SQL migrations to Bun SQLite databases.
+ *
+ * This module re-exports the shared `Migrator` loaders and error types, then
+ * provides `run` and `layer` helpers for applying ordered migrations through
+ * the current Bun-backed SQLite `SqlClient`. It is typically used at
+ * application startup, in deployment or setup scripts that prepare a local
+ * SQLite file, in integration tests with temporary database files, or in layer
+ * graphs that must install the schema before dependent services are acquired.
+ *
+ * Migrations are recorded in `effect_sql_migrations` by default and are loaded
+ * using the shared `<id>_<name>` file or record-key convention. Only migrations
+ * with an id greater than the latest recorded id are applied, so every client
+ * involved in startup should point at the same SQLite filename and use a
+ * writable Bun SQLite configuration. The Bun client enables WAL by default and
+ * serializes access through a single `bun:sqlite` database handle, but separate
+ * handles or processes can still contend for SQLite write locks. Bun's SQLite
+ * driver runs statements synchronously, so large migration sets can block the
+ * invoking runtime thread, and this adapter does not currently write SQLite
+ * schema dumps for `schemaDirectory`.
+ *
  * @since 4.0.0
  */
 export * as SqliteMigrator from "./SqliteMigrator.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["SqliteClient","SqliteMigrator"],"sources":["../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAIA;AAEA;;;AAGA,OAAO,KAAKA,YAAY,MAAM,mBAAmB;AAEjD;;;AAGA,OAAO,KAAKC,cAAc,MAAM,qBAAqB","ignoreList":[]}
+{"version":3,"file":"index.js","names":["SqliteClient","SqliteMigrator"],"sources":["../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAIA;AAEA;;;;;;;;;;;;;;;;;;;;AAoBA,OAAO,KAAKA,YAAY,MAAM,mBAAmB;AAEjD;;;;;;;;;;;;;;;;;;;;;;;AAuBA,OAAO,KAAKC,cAAc,MAAM,qBAAqB","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@effect/sql-sqlite-bun",
-  "version": "4.0.0-beta.67",
+  "version": "4.0.0-beta.69",
   "type": "module",
   "license": "MIT",
   "description": "A SQLite toolkit for Effect",
@@ -44,11 +44,11 @@
   },
   "devDependencies": {
     "@types/bun": "^1.3.13",
-    "@effect/platform-bun": "^4.0.0-beta.67",
-    "effect": "^4.0.0-beta.67"
+    "@effect/platform-bun": "^4.0.0-beta.69",
+    "effect": "^4.0.0-beta.69"
   },
   "peerDependencies": {
-    "effect": "^4.0.0-beta.67"
+    "effect": "^4.0.0-beta.69"
   },
   "scripts": {
     "codegen": "effect-utils codegen",

package/src/SqliteClient.ts

@@ -42,7 +42,7 @@ const classifyError = (cause: unknown, message: string, operation: string) =>
 /**
  * Runtime type identifier used to mark Bun `SqliteClient` values.
  *
- * @category type ids
+ * @category type IDs
  * @since 4.0.0
  */
 export const TypeId: TypeId = "~@effect/sql-sqlite-bun/SqliteClient"
@@ -50,7 +50,7 @@ export const TypeId: TypeId = "~@effect/sql-sqlite-bun/SqliteClient"
 /**
  * Type-level identifier used to mark Bun `SqliteClient` values.
  *
- * @category type ids
+ * @category type IDs
  * @since 4.0.0
  */
 export type TypeId = "~@effect/sql-sqlite-bun/SqliteClient"
@@ -106,7 +106,7 @@ interface SqliteConnection extends Connection {
 /**
  * Creates a scoped Bun SQLite client for a database file, enabling WAL by default and serializing access. Streaming queries are not implemented.
  *
- * @category constructor
+ * @category constructors
  * @since 4.0.0
  */
 export const make = (

package/src/SqliteMigrator.ts

@@ -35,7 +35,7 @@ export * from "effect/unstable/sql/Migrator"
 /**
  * Runs SQL migrations using the configured `SqlClient`, returning the migrations that were applied.
  *
- * @category constructor
+ * @category constructors
  * @since 4.0.0
  */
 export const run: <R2 = never>(
@@ -91,7 +91,7 @@ export const run: <R2 = never>(
 /**
  * Creates a layer that runs the configured SQL migrations during layer construction.
  *
- * @category constructor
+ * @category constructors
  * @since 4.0.0
  */
 export const layer = <R>(

package/src/index.ts

@@ -5,11 +5,48 @@
 // @barrel: Auto-generated exports. Do not edit manually.
 
 /**
+ * Bun SQLite client implementation for Effect SQL, backed by `bun:sqlite`.
+ *
+ * This module provides constructors and layers for using a Bun-managed SQLite database as both the
+ * SQLite-specific `SqliteClient` service and the generic `SqlClient` service. It is intended for
+ * file-backed or in-memory databases in Bun applications, local development tools, migrations,
+ * integration tests, and embedded persistence use cases that need Effect SQL query compilation plus
+ * SQLite-specific helpers such as database export and native extension loading.
+ *
+ * Each client owns one scoped `bun:sqlite` `Database` handle and serializes access through it, which
+ * is important because Bun executes SQLite statements synchronously. WAL mode is enabled by default,
+ * so set `disableWAL` when opening read-only databases or when the database file or directory cannot
+ * be updated with SQLite's WAL side files. A transaction holds the serialized connection permit for
+ * the transaction scope, so concurrent fibers using the same client wait until it completes, while
+ * separate database handles or processes can still contend for SQLite write locks. Safe integer
+ * handling follows the `SqlClient` fiber-local setting, `executeStream` is not implemented, and
+ * SQLite does not support `updateValues`.
+ *
  * @since 4.0.0
  */
 export * as SqliteClient from "./SqliteClient.ts"
 
 /**
+ * Utilities for applying Effect SQL migrations to Bun SQLite databases.
+ *
+ * This module re-exports the shared `Migrator` loaders and error types, then
+ * provides `run` and `layer` helpers for applying ordered migrations through
+ * the current Bun-backed SQLite `SqlClient`. It is typically used at
+ * application startup, in deployment or setup scripts that prepare a local
+ * SQLite file, in integration tests with temporary database files, or in layer
+ * graphs that must install the schema before dependent services are acquired.
+ *
+ * Migrations are recorded in `effect_sql_migrations` by default and are loaded
+ * using the shared `<id>_<name>` file or record-key convention. Only migrations
+ * with an id greater than the latest recorded id are applied, so every client
+ * involved in startup should point at the same SQLite filename and use a
+ * writable Bun SQLite configuration. The Bun client enables WAL by default and
+ * serializes access through a single `bun:sqlite` database handle, but separate
+ * handles or processes can still contend for SQLite write locks. Bun's SQLite
+ * driver runs statements synchronously, so large migration sets can block the
+ * invoking runtime thread, and this adapter does not currently write SQLite
+ * schema dumps for `schemaDirectory`.
+ *
  * @since 4.0.0
  */
 export * as SqliteMigrator from "./SqliteMigrator.ts"