@effect/sql-sqlite-bun 4.0.0-beta.99 → 4.0.0-rc.108

package/ai-docs/src/71_ai/30_chat.ts

@@ -0,0 +1,158 @@
+/**
+ * @title Stateful chat sessions
+ *
+ * The AI `Chat` module maintains conversation history automatically. Build
+ * AI agents or chat assistants.
+ */
+import { OpenAiClient, OpenAiLanguageModel } from "@effect/ai-openai"
+import { Config, Context, DateTime, Effect, Layer, Ref, Schema } from "effect"
+import { AiError, Chat, Prompt, Tool, Toolkit } from "effect/unstable/ai"
+import { FetchHttpClient } from "effect/unstable/http"
+
+// ---------------------------------------------------------------------------
+// Provider setup
+// ---------------------------------------------------------------------------
+
+const OpenAiClientLayer = OpenAiClient.layerConfig({
+  apiKey: Config.redacted("OPENAI_API_KEY")
+}).pipe(Layer.provide(FetchHttpClient.layer))
+
+// ---------------------------------------------------------------------------
+// Tools for the agentic loop
+// ---------------------------------------------------------------------------
+
+const Tools = Toolkit.make(Tool.make("getCurrentTime", {
+  description: "Get the current time in ISO format",
+  parameters: Schema.Struct({
+    id: Schema.String
+  }),
+  success: Schema.String
+}))
+
+const ToolsLayer = Tools.toLayer(Effect.gen(function*() {
+  yield* Effect.logDebug("Initializing tools...")
+  return Tools.of({
+    getCurrentTime: Effect.fn("Tools.getCurrentTime")(function*(_) {
+      const now = yield* DateTime.now
+      return DateTime.formatIso(now)
+    })
+  })
+}))
+
+// ---------------------------------------------------------------------------
+// Service that wraps Chat for a domain use-case
+// ---------------------------------------------------------------------------
+
+export class AiAssistantError extends Schema.TaggedError<AiAssistantError>()("AiAssistantError", {
+  reason: AiError.AiErrorReason
+}) {
+  static fromAiError(error: AiError.AiError) {
+    return new AiAssistantError({ reason: error.reason })
+  }
+}
+
+export class AiAssistant extends Context.Service<AiAssistant, {
+  // Send a message while maintaining conversation history across turns.
+  chat(message: string): Effect.Effect<string, AiAssistantError>
+  // Ask a question and use an agentic loop with tool calls to answer it.
+  agent(question: string): Effect.Effect<string, AiAssistantError>
+}>()("acme/AiAssistant") {
+  static readonly layer = Layer.effect(
+    AiAssistant,
+    Effect.gen(function*() {
+      // Choose the model you want to use for the chat sessions.
+      const modelLayer = yield* OpenAiLanguageModel.model("gpt-5.2").captureRequirements
+
+      // ---------------------------------------------------------------------------
+      // 1. Chat.empty — basic multi-turn conversation
+      // ---------------------------------------------------------------------------
+
+      // Create a new chat session with `Chat.empty` or `Chat.fromPrompt`. The
+      // session maintains conversation history automatically, so you can focus on
+      // the current turn without having to manage context.
+      const newSession = yield* Chat.fromPrompt(Prompt.empty.pipe(
+        Prompt.setSystem("You are a helpful assistant that answers questions.")
+      ))
+
+      // You can also create a chat using a json export.
+      const json = yield* newSession.exportJson
+      const session = yield* Chat.fromJson(json)
+
+      const chat = Effect.fn("AiAssistant.chat")(
+        function*(message: string) {
+          // Create a new turn in the conversation by passing the user's message
+          // to `session.generateText`.
+          const response = yield* session.generateText({ prompt: message }).pipe(
+            // Provide the model layer to use.
+            // You could potentially use different models for different turns,
+            // or even switch models in the middle of a conversation.
+            Effect.provide(modelLayer)
+          )
+
+          // You can inspect the accumulated history at any point through the
+          // `history` ref on the chat instance.
+          const history = yield* Ref.get(session.history)
+          yield* Effect.logInfo(
+            `Conversation has ${history.content.length} messages`
+          )
+
+          return response.text
+        },
+        Effect.mapError((error) => AiAssistantError.fromAiError(error))
+      )
+
+      // ---------------------------------------------------------------------------
+      // 2. Create agentic loops with tools
+      // ---------------------------------------------------------------------------
+
+      const tools = yield* Tools
+      const agent = Effect.fn("AiAssistant.agent")(
+        function*(question: string) {
+          // We start the agent with a system prompt and the user question. The
+          // agent can then call tools in a loop until it decides to return a
+          // final answer.
+          const session = yield* Chat.fromPrompt([
+            { role: "system", content: "You are an assistant that can use tools to answer questions." },
+            { role: "user", content: question }
+          ])
+
+          while (true) {
+            const response = yield* session.generateText({
+              prompt: [], // No additional prompt — the model has full access to the conversation history
+              toolkit: tools // Provide the tools to the model
+            }).pipe(
+              // Provide the model layer to use.
+              // You could potentially use different models for different turns,
+              // or even switch models in the middle of a conversation.
+              Effect.provide(modelLayer)
+            )
+            if (response.toolCalls.length > 0) {
+              // If the model called any tools, execute them and the Chat module
+              // will automatically add the tool results to the conversation
+              // history before the next turn.
+              continue
+            }
+            // If there are no tool calls, the model has returned a final answer
+            // and we can exit the loop.
+            return response.text
+          }
+        },
+        // Remap AI errors to our domain-specific error type, but die on
+        // unexpected errors.
+        Effect.catchTag(
+          "AiError",
+          (error) => Effect.fail(AiAssistantError.fromAiError(error)),
+          (e) => Effect.die(e)
+        )
+      )
+
+      return AiAssistant.of({
+        chat,
+        agent
+      })
+    })
+  ).pipe(
+    // Provide the OpenAI client and tools layers to the AiAssistant service.
+    Layer.provide([OpenAiClientLayer, ToolsLayer])
+  )
+}

package/ai-docs/src/71_ai/fixtures/domain/LaunchPlan.ts

@@ -0,0 +1,9 @@
+import { Schema } from "effect"
+
+export class LaunchPlan extends Schema.Class<LaunchPlan>("LaunchPlan")({
+  audience: Schema.Literals(["developers", "operators", "platform teams"]),
+  channels: Schema.Array(Schema.String),
+  launchDate: Schema.String,
+  summary: Schema.String,
+  keyRisks: Schema.Array(Schema.String)
+}) {}

package/ai-docs/src/71_ai/index.md

@@ -0,0 +1,5 @@
+## Working with AI modules
+
+Effect's AI modules provide a provider-agnostic interface for language models.
+You can generate text, decode structured objects with `Schema` and stream partial
+responses.

package/ai-docs/src/80_cluster/10_entities.ts

@@ -0,0 +1,97 @@
+/**
+ * @title Defining cluster entities
+ *
+ * Define distributed entity RPCs and run them in a cluster.
+ */
+import { NodeClusterSocket, NodeRuntime } from "@effect/platform-node"
+import { Effect, Layer, Ref, Schema } from "effect"
+import { ClusterSchema, Entity, TestRunner } from "effect/unstable/cluster"
+import { Rpc } from "effect/unstable/rpc"
+import type { SqlClient } from "effect/unstable/sql"
+
+export const Increment = Rpc.make("Increment", {
+  payload: { amount: Schema.Int },
+  success: Schema.Int
+})
+
+export const GetCount = Rpc.make("GetCount", {
+  success: Schema.Int
+})
+  // If you want GetCount messages to be persisted, you can annotate the RPC
+  // schema with `ClusterSchema.Persisted`.
+  //
+  // By default, messages are volatile and only sent over a network.
+  .annotate(ClusterSchema.Persisted, true)
+
+// `Entity.make` takes an array of Rpc definitions
+export const Counter = Entity.make("Counter", [Increment, GetCount])
+
+// Entity handlers can keep in-memory state while the entity is active.
+// `maxIdleTime` controls passivation: if the entity is idle long enough, it is
+// stopped and later recreated on demand.
+export const CounterEntityLayer = Counter.toLayer(
+  Effect.gen(function*() {
+    const count = yield* Ref.make(0)
+
+    return Counter.of({
+      Increment: ({ payload }) => Ref.updateAndGet(count, (current) => current + payload.amount),
+      GetCount: () =>
+        Ref.get(count).pipe(
+          // Add Rpc.fork to allow the GetCount handler to run concurrently with
+          // Increment handlers.
+          //
+          // This opts-out of the default behavior where all handlers for a
+          // given entity run sequentially.
+          Rpc.fork
+        )
+    })
+  }),
+  { maxIdleTime: "5 minutes" }
+)
+
+// If you ever need to access an entity client, you can use the `client`
+// property on the entity definition.
+export const useCounter = Effect.gen(function*() {
+  const clientFor = yield* Counter.client
+  const counter = clientFor("counter-123")
+
+  const afterIncrement = yield* counter.Increment({ amount: 1 })
+  const currentCount = yield* counter.GetCount()
+
+  console.log(`Count after increment: ${afterIncrement}, current count: ${currentCount}`)
+})
+
+// `SingleRunner.layer` is useful for local development / tests where you still
+// want the cluster entity runtime model.
+declare const SqlClientLayer: Layer.Layer<SqlClient.SqlClient>
+
+// Create the cluster layer using `NodeClusterSocket.layer`
+const ClusterLayer = NodeClusterSocket.layer().pipe(
+  Layer.provide(SqlClientLayer)
+)
+
+// You can also use `TestRunner.layer` to run your entities in a single process,
+// without any network communication and in-memory storage. This is useful for testing and
+// development.
+const ClusterLayerTest = TestRunner.layer
+
+// Merge all your entity layers together and provide the cluster layer to run
+// them in a cluster.
+const EntitiesLayer = Layer.mergeAll(
+  CounterEntityLayer
+)
+
+const ProductionLayer = EntitiesLayer.pipe(
+  Layer.provide(ClusterLayer)
+)
+
+export const TestLayer = EntitiesLayer.pipe(
+  // For testing, we can use `Layer.provideMerge` to tests can access storage
+  // and other cluster services directly.
+  Layer.provideMerge(ClusterLayerTest)
+)
+
+// Finally, run your app with the entities layer.
+Layer.launch(ProductionLayer).pipe(
+  NodeRuntime.runMain
+)

package/ai-docs/src/80_cluster/index.md

@@ -0,0 +1,4 @@
+## Building distributed applications with cluster
+
+The cluster modules let you model stateful services as entities and distribute
+them across multiple machines.

package/ai-docs/src/index.md

@@ -0,0 +1,10 @@
+# Effect library documentation
+
+This documentation covers the Effect library and its related packages.
+
+When you need to find information about Effect, use this documentation and the
+Effect source code available in your environment. Avoid unrelated copies of
+Effect or external documentation, as they may be outdated or incorrect.
+
+**Note**: The examples in this documentation contain comments for illustration
+purposes. In practice, you would not include these comments in your code.

package/ai-docs/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "../tsconfig.base.json",
+  "include": ["src/**/*.ts", "src/**/*.tsx"],
+  "compilerOptions": {
+    "rootDir": ".",
+    "noEmit": true,
+    "declaration": false,
+    "declarationMap": false,
+    "composite": false,
+    "incremental": false,
+    "types": ["node"],
+    "plugins": [
+      {
+        "name": "@effect/language-service",
+        "namespaceImportPackages": [],
+        "diagnosticSeverity": {
+          "floatingEffect": "off",
+          "preferSchemaOverJson": "off"
+        }
+      }
+    ]
+  }
+}

package/dist/SqliteClient.d.ts

@@ -1,5 +1,6 @@
 import * as Config from "effect/Config";
 import * as Context from "effect/Context";
+import * as Duration from "effect/Duration";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Scope from "effect/Scope";
@@ -23,7 +24,7 @@ export type TypeId = "~@effect/sql-sqlite-bun/SqliteClient";
 /**
  * Bun SQLite client service, extending `SqlClient` with database export and extension loading helpers. `updateValues` is not supported.
  *
- * @category models
+ * @category services
  * @since 4.0.0
  */
 export interface SqliteClient extends Client.SqlClient {
@@ -46,7 +47,7 @@ export interface SqliteClient extends Client.SqlClient {
  */
 export declare const SqliteClient: Context.Service<SqliteClient, SqliteClient>;
 /**
- * Configuration for a Bun SQLite client, including filename, open mode flags, WAL behavior, span attributes, and query/result name transforms.
+ * Configuration for a Bun SQLite client, including filename, open mode flags, WAL and busy timeout behavior, span attributes, and query/result name transforms.
  *
  * @category models
  * @since 4.0.0
@@ -57,12 +58,18 @@ export interface SqliteClientConfig {
     readonly create?: boolean | undefined;
     readonly readwrite?: boolean | undefined;
     readonly disableWAL?: boolean | undefined;
+    /**
+     * How long SQLite waits when the database is busy. Defaults to 5 seconds.
+     * `Duration.infinity` is clamped to SQLite's maximum timeout.
+     * Waiting blocks the event loop because `bun:sqlite` is synchronous.
+     */
+    readonly busyTimeout?: Duration.Input | undefined;
     readonly spanAttributes?: Record<string, unknown> | undefined;
     readonly transformResultNames?: ((str: string) => string) | undefined;
     readonly transformQueryNames?: ((str: string) => string) | undefined;
 }
 /**
- * Creates a scoped Bun SQLite client for a database file, enabling WAL by default and serializing access. Streaming queries are not implemented.
+ * Creates a scoped Bun SQLite client for a database file, enabling WAL and a 5-second busy timeout by default. Explicit transactions on writable connections take the write lock for their duration, even when they only read; clients opened with `readonly: true` are unaffected. Streaming queries are not implemented.
  *
  * @category constructors
  * @since 4.0.0

package/dist/SqliteClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SqliteClient.d.ts","sourceRoot":"","sources":["../src/SqliteClient.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAGrC,OAAO,KAAK,UAAU,MAAM,uCAAuC,CAAA;AACnE,OAAO,KAAK,MAAM,MAAM,+BAA+B,CAAA;AAEvD,OAAO,EAAuB,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAQ5E;;;;;GAKG;AACH,eAAO,MAAM,MAAM,EAAE,MAA+C,CAAA;AAEpE;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG,sCAAsC,CAAA;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,YAAa,SAAQ,MAAM,CAAC,SAAS;IACpD,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;IACpD,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAEvE,8BAA8B;IAC9B,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAA;CAC7B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,6CAAiE,CAAA;AAE1F;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAEzC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IAE7D,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,CAAA;IACrE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,CAAA;CACrE;AAOD;;;;;GAKG;AACH,eAAO,MAAM,IAAI,YACN,kBAAkB,KAC1B,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,UAAU,CA4HrE,CAAA;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,WAAW,WACd,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,KACtC,KAAK,CAAC,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAUzB,CAAA;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,KAAK,WACR,kBAAkB,KACzB,KAAK,CAAC,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,SAAS,CAML,CAAA"}
+{"version":3,"file":"SqliteClient.d.ts","sourceRoot":"","sources":["../src/SqliteClient.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAGrC,OAAO,KAAK,UAAU,MAAM,uCAAuC,CAAA;AACnE,OAAO,KAAK,MAAM,MAAM,+BAA+B,CAAA;AAEvD,OAAO,EAAuB,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAS5E;;;;;GAKG;AACH,eAAO,MAAM,MAAM,EAAE,MAA+C,CAAA;AAEpE;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG,sCAAsC,CAAA;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,YAAa,SAAQ,MAAM,CAAC,SAAS;IACpD,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;IACpD,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAEvE,8BAA8B;IAC9B,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAA;CAC7B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,6CAAiE,CAAA;AAE1F;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACzC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAA;IAEjD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IAE7D,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,CAAA;IACrE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,CAAA;CACrE;AAOD;;;;;GAKG;AACH,eAAO,MAAM,IAAI,YACN,kBAAkB,KAC1B,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,UAAU,CAmIrE,CAAA;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,WAAW,WACd,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,KACtC,KAAK,CAAC,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAUzB,CAAA;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,KAAK,WACR,kBAAkB,KACzB,KAAK,CAAC,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,SAAS,CAML,CAAA"}

package/dist/SqliteClient.js

@@ -3,14 +3,20 @@
  *
  * This module opens a SQLite database and exposes it as both `SqliteClient` and
  * the generic Effect SQL client. It serializes access to the database, enables
- * WAL mode unless disabled, and supports database export and extension loading.
- * Streaming queries and `updateValues` are not supported by this driver.
+ * WAL mode unless disabled, and waits up to five seconds for busy databases by
+ * default. Explicit transactions on writable connections use `BEGIN IMMEDIATE`
+ * to avoid read-to-write lock upgrades, which serializes them behind other
+ * writers even when they only read. Clients opened with `readonly: true` are
+ * unaffected. Busy waits block the event loop because `bun:sqlite` is
+ * synchronous. Database export and extension loading are supported; streaming
+ * queries and `updateValues` are not.
  *
  * @since 4.0.0
  */
 import { Database } from "bun:sqlite";
 import * as Config from "effect/Config";
 import * as Context from "effect/Context";
+import * as Duration from "effect/Duration";
 import * as Effect from "effect/Effect";
 import * as Fiber from "effect/Fiber";
 import { identity } from "effect/Function";
@@ -23,6 +29,7 @@ import * as Client from "effect/unstable/sql/SqlClient";
 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 MAX_BUSY_TIMEOUT = 2_147_483_647;
 const classifyError = (cause, message, operation) => classifySqliteError(cause, {
   message,
   operation
@@ -46,7 +53,7 @@ export const TypeId = "~@effect/sql-sqlite-bun/SqliteClient";
  */
 export const SqliteClient = /*#__PURE__*/Context.Service("@effect/sql-sqlite-bun/Client");
 /**
- * Creates a scoped Bun SQLite client for a database file, enabling WAL by default and serializing access. Streaming queries are not implemented.
+ * Creates a scoped Bun SQLite client for a database file, enabling WAL and a 5-second busy timeout by default. Explicit transactions on writable connections take the write lock for their duration, even when they only read; clients opened with `readonly: true` are unaffected. Streaming queries are not implemented.
  *
  * @category constructors
  * @since 4.0.0
@@ -55,13 +62,16 @@ export const make = options => Effect.gen(function* () {
   const compiler = Statement.makeCompilerSqlite(options.transformQueryNames);
   const transformRows = options.transformResultNames ? Statement.defaultTransforms(options.transformResultNames).array : undefined;
   const makeConnection = Effect.gen(function* () {
+    const readonly = options.readonly === true;
     const db = new Database(options.filename, {
-      readonly: options.readonly,
-      readwrite: options.readwrite ?? true,
-      create: options.create ?? true
+      readonly,
+      readwrite: readonly ? false : options.readwrite ?? true,
+      create: readonly ? false : options.create ?? true
     });
     yield* Effect.addFinalizer(() => Effect.sync(() => db.close()));
-    if (options.disableWAL !== true) {
+    const busyTimeout = Math.min(MAX_BUSY_TIMEOUT, Math.max(0, Math.round(Duration.toMillis(options.busyTimeout ?? Duration.seconds(5)))));
+    db.run(`PRAGMA busy_timeout = ${busyTimeout};`);
+    if (options.disableWAL !== true && !readonly) {
       db.run("PRAGMA journal_mode = WAL;");
     }
     const prepare = (sql, useSafeIntegers) => {
@@ -135,6 +145,7 @@ export const make = options => Effect.gen(function* () {
     acquirer,
     compiler,
     transactionAcquirer,
+    beginTransaction: "BEGIN IMMEDIATE",
     spanAttributes: [...(options.spanAttributes ? Object.entries(options.spanAttributes) : []), [ATTR_DB_SYSTEM_NAME, "sqlite"]],
     transformRows
   }), {

package/dist/SqliteClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"SqliteClient.js","names":["Database","Config","Context","Effect","Fiber","identity","Layer","Scope","Semaphore","Stream","Reactivity","Client","classifySqliteError","SqlError","Statement","ATTR_DB_SYSTEM_NAME","classifyError","cause","message","operation","TypeId","SqliteClient","Service","make","options","gen","compiler","makeCompilerSqlite","transformQueryNames","transformRows","transformResultNames","defaultTransforms","array","undefined","makeConnection","db","filename","readonly","readwrite","create","addFinalizer","sync","close","disableWAL","run","prepare","sql","useSafeIntegers","statement","query","safeIntegers","params","withFiber","fiber","get","context","SafeIntegers","succeed","all","fail","reason","runValues","values","execute","map","executeRaw","executeValues","executeValuesUnprepared","executeUnprepared","executeStream","_sql","_params","die","export","try","serialize","catch","loadExtension","path","semaphore","connection","acquirer","withPermits","transactionAcquirer","uninterruptibleMask","restore","getCurrent","scope","getUnsafe","as","tap","take","release","Object","assign","spanAttributes","entries","config","flatMap","_","layerConfig","effectContext","unwrap","pipe","client","add","SqlClient","provide","layer"],"sources":["../src/SqliteClient.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"SqliteClient.js","names":[],"sources":["../src/SqliteClient.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/SqliteMigrator.d.ts

@@ -20,14 +20,14 @@ export * from "effect/unstable/sql/Migrator";
 /**
  * Runs SQL migrations using the configured `SqlClient`, returning the migrations that were applied.
  *
- * @category constructors
+ * @category running
  * @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 constructors
+ * @category layers
  * @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 constructors
+ * @category running
  * @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 constructors
+ * @category layers
  * @since 4.0.0
  */
 export const layer = options => Layer.effectDiscard(run(options));

package/dist/SqliteMigrator.js.map

@@ -1 +1 @@
-{"version":3,"file":"SqliteMigrator.js","names":["Layer","Migrator","run","make","layer","options","effectDiscard"],"sources":["../src/SqliteMigrator.ts"],"sourcesContent":[null],"mappings":"AAWA,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;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;AAAA,CACD,CAAC;AAEF;;;;;;AAMA,OAAO,MAAMC,KAAK,GAChBC,OAAoC,IAKjCL,KAAK,CAACM,aAAa,CAACJ,GAAG,CAACG,OAAO,CAAC,CAAC","ignoreList":[]}
+{"version":3,"file":"SqliteMigrator.js","names":[],"sources":["../src/SqliteMigrator.ts"],"sourcesContent":[null],"mappings":"AAWA,OAAO,KAAK,KAAK,MAAM,cAAc;AACrC,OAAO,KAAK,QAAQ,MAAM,8BAA8B;AAIxD;;;AAGA,cAAc,8BAA8B;AAE5C;;;;;;AAMA,OAAO,MAAM,GAAG,gBAMZ,QAAQ,CAAC,IAAI,CAAC;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;AAAA,CACD,CAAC;AAEF;;;;;;AAMA,OAAO,MAAM,KAAK,GAChB,OAAoC,IAKjC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC","ignoreList":[]}

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":[],"sources":["../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAIA;AAEA;;;AAGA,OAAO,KAAK,YAAY,MAAM,mBAAmB;AAEjD;;;AAGA,OAAO,KAAK,cAAc,MAAM,qBAAqB","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@effect/sql-sqlite-bun",
-  "version": "4.0.0-beta.99",
+  "version": "4.0.0-rc.108",
   "type": "module",
   "license": "MIT",
   "description": "A SQLite toolkit for Effect",
@@ -29,6 +29,7 @@
     ".": "./dist/index.js",
     "./*": "./dist/*.js",
     "./internal/*": null,
+    "./index": null,
     "./*/index": null
   },
   "files": [
@@ -36,7 +37,10 @@
     "dist/**/*.js",
     "dist/**/*.js.map",
     "dist/**/*.d.ts",
-    "dist/**/*.d.ts.map"
+    "dist/**/*.d.ts.map",
+    "AGENTS.md",
+    "CLAUDE.md",
+    "ai-docs/**/*"
   ],
   "publishConfig": {
     "access": "public",
@@ -44,18 +48,16 @@
   },
   "devDependencies": {
     "@types/bun": "^1.3.14",
-    "@effect/platform-bun": "^4.0.0-beta.99",
-    "effect": "^4.0.0-beta.99"
+    "@effect/platform-bun": "^4.0.0-rc.108",
+    "effect": "^4.0.0-rc.108"
   },
   "peerDependencies": {
-    "effect": "^4.0.0-beta.99"
+    "effect": "^4.0.0-rc.108"
   },
   "scripts": {
     "codegen": "effect-utils codegen",
     "build": "tsc -b tsconfig.json && pnpm babel",
     "babel": "babel dist --plugins annotate-pure-calls --out-dir dist --source-maps",
-    "check": "tsc -b tsconfig.json",
-    "test": "vitest",
-    "coverage": "vitest --coverage"
+    "check": "tsc -b tsconfig.json"
   }
 }