@dxos/sql-sqlite 0.0.0 → 0.8.4-main.1068cf700f

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "@dxos/sql-sqlite",
-  "version": "0.0.0",
+  "version": "0.8.4-main.1068cf700f",
   "description": "Sqlite client",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dxos/dxos"
+  },
   "license": "MIT",
   "author": "info@dxos.org",
   "sideEffects": true,
@@ -39,6 +43,11 @@
       "types": "./dist/types/src/SqlExport.d.ts",
       "browser": "./dist/lib/browser/SqlExport.mjs",
       "node": "./dist/lib/node-esm/SqlExport.mjs"
+    },
+    "./SqlTransaction": {
+      "types": "./dist/types/src/SqlTransaction.d.ts",
+      "browser": "./dist/lib/browser/SqlTransaction.mjs",
+      "node": "./dist/lib/node-esm/SqlTransaction.mjs"
     }
   },
   "files": [
@@ -47,15 +56,15 @@
   ],
   "dependencies": {
     "@dxos/wa-sqlite": "^0.2.1",
-    "@effect/experimental": "0.57.11",
-    "@effect/platform": "0.93.6",
-    "@effect/sql": "0.48.6",
-    "@effect/sql-sqlite-bun": "0.49.0",
-    "@effect/sql-sqlite-node": "0.49.1",
-    "effect": "3.19.11"
+    "@effect/experimental": "0.58.0",
+    "@effect/platform": "0.94.4",
+    "@effect/sql": "0.49.0",
+    "@effect/sql-sqlite-bun": "0.50.2",
+    "@effect/sql-sqlite-node": "0.50.1",
+    "effect": "3.19.16"
   },
   "devDependencies": {
-    "@effect/sql-sqlite-wasm": "0.49.0",
+    "@effect/sql-sqlite-wasm": "0.50.0",
     "@effect/wa-sqlite": "^0.1.2"
   },
   "publishConfig": {

package/src/SqlTransaction.ts

@@ -0,0 +1,44 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as SqlClient from '@effect/sql/SqlClient';
+import type * as SqlError from '@effect/sql/SqlError';
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+
+export interface Service {
+  withTransaction: <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E | SqlError.SqlError, R>;
+}
+
+/**
+ * Provide a SQL transaction context.
+ *
+ * Should be used instead of SqlClient.withTransaction() or SQL native transaction syntaxes (e.g. `BEGIN; COMMIT;`).
+ *
+ * Platform runtimes (e.g. edge, Durable Objects) can provide alternative implementations by supplying a custom
+ * `SqlTransaction` layer.
+ *
+ * @example
+ * ```typescript
+ * const transaction = yield* SqlTransaction;
+ * yield* transaction.withTransaction(Effect.gen(function* () {
+ *   yield* sql.execute('SELECT * FROM users');
+ * }));
+ * ```
+ */
+export class SqlTransaction extends Context.Tag('@dxos/sql-sqlite/SqlTransaction')<SqlTransaction, Service>() {}
+
+/**
+ * Default `SqlTransaction` layer backed by `SqlClient.withTransaction`.
+ */
+export const layer: Layer.Layer<SqlTransaction, never, SqlClient.SqlClient> = Layer.effect(
+  SqlTransaction,
+  Effect.map(
+    SqlClient.SqlClient,
+    (sql: SqlClient.SqlClient): Context.Tag.Service<SqlTransaction> => ({
+      withTransaction: (self) => sql.withTransaction(self),
+    }),
+  ),
+);

package/src/index.ts

@@ -6,3 +6,4 @@ export * from '@effect/sql-sqlite-wasm';
 export * as OpfsWorker from '@effect/sql-sqlite-wasm/OpfsWorker';
 export * as SqliteClient from '@effect/sql-sqlite-wasm/SqliteClient';
 export * as SqliteMigrator from '@effect/sql-sqlite-wasm/SqliteMigrator';
+export * as SqlTransaction from './SqlTransaction';

package/src/platform/browser.ts

@@ -11,17 +11,29 @@ import * as Layer from 'effect/Layer';
 
 import * as SqlExport from '../SqlExport';
 
-const sqlExportBrowser: Layer.Layer<SqlExport.SqlExport, SqlError.SqlError, SqliteClient.SqliteClient> = Layer.effect(
-  SqlExport.SqlExport,
-  Effect.gen(function* () {
-    const sql = yield* SqliteClient.SqliteClient;
-    return {
-      export: sql.export,
-    } satisfies SqlExport.Service;
-  }),
-);
+export const sqlExportLayer: Layer.Layer<SqlExport.SqlExport, SqlError.SqlError, SqliteClient.SqliteClient> =
+  Layer.effect(
+    SqlExport.SqlExport,
+    Effect.gen(function* () {
+      const sql = yield* SqliteClient.SqliteClient;
+      return {
+        export: sql.export,
+      } satisfies SqlExport.Service;
+    }),
+  );
 
 export const layerMemory: Layer.Layer<
   SqlClient.SqlClient | SqlExport.SqlExport,
   ConfigError.ConfigError | SqlError.SqlError
-> = sqlExportBrowser.pipe(Layer.provideMerge(SqliteClient.layerMemory({})));
+> = sqlExportLayer.pipe(Layer.provideMerge(SqliteClient.layerMemory({})));
+
+/**
+ * File-based SQLite is not available in browser.
+ * Use OPFS worker for persistent storage in browser environments.
+ * @throws Always throws - use OPFS worker instead.
+ */
+export const layerFile = (
+  _filename: string,
+): Layer.Layer<SqlClient.SqlClient | SqlExport.SqlExport, ConfigError.ConfigError | SqlError.SqlError> => {
+  throw new Error('layerFile is not available in browser. Use OPFS worker for persistent storage.');
+};

package/src/platform/bun.ts

@@ -11,23 +11,42 @@ import * as Layer from 'effect/Layer';
 
 import * as SqlExport from '../SqlExport';
 
-const sqlExportBun: Layer.Layer<SqlExport.SqlExport, SqlError.SqlError, SqliteClient.SqliteClient> = Layer.effect(
-  SqlExport.SqlExport,
-  Effect.gen(function* () {
-    const sql = yield* SqliteClient.SqliteClient;
-    return {
-      export: sql.export,
-    } satisfies SqlExport.Service;
-  }),
-);
+export const sqlExportLayer: Layer.Layer<SqlExport.SqlExport, SqlError.SqlError, SqliteClient.SqliteClient> =
+  Layer.effect(
+    SqlExport.SqlExport,
+    Effect.gen(function* () {
+      const sql = yield* SqliteClient.SqliteClient;
+      return {
+        export: sql.export,
+      } satisfies SqlExport.Service;
+    }),
+  );
 
 export const layerMemory: Layer.Layer<
   SqlClient.SqlClient | SqliteClient.SqliteClient | SqlExport.SqlExport,
   ConfigError.ConfigError | SqlError.SqlError
-> = sqlExportBun.pipe(
+> = sqlExportLayer.pipe(
   Layer.provideMerge(
     SqliteClient.layer({
       filename: ':memory:',
     }),
   ),
 );
+
+/**
+ * Creates a file-based SQLite layer for Bun.
+ * Unlike layerMemory, this persists data across runtime restarts.
+ */
+export const layerFile = (
+  filename: string,
+): Layer.Layer<
+  SqlClient.SqlClient | SqliteClient.SqliteClient | SqlExport.SqlExport,
+  ConfigError.ConfigError | SqlError.SqlError
+> =>
+  sqlExportLayer.pipe(
+    Layer.provideMerge(
+      SqliteClient.layer({
+        filename,
+      }),
+    ),
+  );

package/src/platform/node.ts

@@ -11,23 +11,42 @@ import * as Layer from 'effect/Layer';
 
 import * as SqlExport from '../SqlExport';
 
-const sqlExportNode: Layer.Layer<SqlExport.SqlExport, SqlError.SqlError, SqliteClient.SqliteClient> = Layer.effect(
-  SqlExport.SqlExport,
-  Effect.gen(function* () {
-    const sql = yield* SqliteClient.SqliteClient;
-    return {
-      export: sql.export,
-    } satisfies SqlExport.Service;
-  }),
-);
+export const sqlExportLayer: Layer.Layer<SqlExport.SqlExport, SqlError.SqlError, SqliteClient.SqliteClient> =
+  Layer.effect(
+    SqlExport.SqlExport,
+    Effect.gen(function* () {
+      const sql = yield* SqliteClient.SqliteClient;
+      return {
+        export: sql.export,
+      } satisfies SqlExport.Service;
+    }),
+  );
 
 export const layerMemory: Layer.Layer<
-  SqlClient.SqlClient | SqliteClient.SqliteClient,
+  SqlClient.SqlClient | SqliteClient.SqliteClient | SqlExport.SqlExport,
   ConfigError.ConfigError | SqlError.SqlError
-> = sqlExportNode.pipe(
+> = sqlExportLayer.pipe(
   Layer.provideMerge(
     SqliteClient.layer({
       filename: ':memory:',
     }),
   ),
 );
+
+/**
+ * Creates a file-based SQLite layer for Node.js.
+ * Unlike layerMemory, this persists data across runtime restarts.
+ */
+export const layerFile = (
+  filename: string,
+): Layer.Layer<
+  SqlClient.SqlClient | SqliteClient.SqliteClient | SqlExport.SqlExport,
+  ConfigError.ConfigError | SqlError.SqlError
+> =>
+  sqlExportLayer.pipe(
+    Layer.provideMerge(
+      SqliteClient.layer({
+        filename,
+      }),
+    ),
+  );