@prisma-next/sqlite 0.12.0-dev.72 → 0.12.0-dev.73

package/dist/runtime.d.mts

@@ -1,6 +1,6 @@
 import { orm } from "@prisma-next/sql-orm-client";
 import { CodecTypesBase, RawSqlTag } from "@prisma-next/sql-relational-core/expression";
-import { BindSiteParams, Declaration, ExecutionContext, ParamsFromDeclaration, PreparedStatement, Runtime, SqlExecutionStackWithDriver, SqlMiddleware, SqlRuntimeExtensionDescriptor, VerifyMarkerOption } from "@prisma-next/sql-runtime";
+import { BindSiteParams, Declaration, ExecutionContext, ParamsFromDeclaration, PreparedStatement, Runtime, SqlExecutionStackWithDriver, SqlMiddleware, SqlRuntimeExtensionDescriptor, TransactionContext, VerifyMarkerOption } from "@prisma-next/sql-runtime";
 import { ExtractCodecTypes, SqlStorage } from "@prisma-next/sql-contract/types";
 import { Contract } from "@prisma-next/contract/types";
 import { Db } from "@prisma-next/sql-builder/types";
@@ -14,6 +14,10 @@ type SqliteBindingInput = {
 //#region src/runtime/sqlite.d.ts
 type SqliteTargetId = 'sqlite';
 type OrmClient<TContract extends Contract<SqlStorage>> = ReturnType<typeof orm<TContract>>;
+interface SqliteTransactionContext<TContract extends Contract<SqlStorage>> extends TransactionContext {
+  readonly sql: Db<TContract>;
+  readonly orm: OrmClient<TContract>;
+}
 interface SqliteClient<TContract extends Contract<SqlStorage>> {
   readonly sql: Db<TContract>;
   readonly orm: OrmClient<TContract>;
@@ -25,6 +29,7 @@ interface SqliteClient<TContract extends Contract<SqlStorage>> {
   }): Promise<Runtime>;
   runtime(): Runtime;
   prepare<D extends Declaration<CT>, Row, CT extends CodecTypesBase = ExtractCodecTypes<TContract> & CodecTypesBase>(declaration: D, callback: (sql: Db<TContract>, params: BindSiteParams<D>) => SqlQueryPlan<Row>): Promise<PreparedStatement<ParamsFromDeclaration<D, CT>, Row>>;
+  transaction<R>(fn: (tx: SqliteTransactionContext<TContract>) => PromiseLike<R>): Promise<R>;
   close(): Promise<void>;
   [Symbol.asyncDispose](): Promise<void>;
 }

package/dist/runtime.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.mts","names":[],"sources":["../src/runtime/binding.ts","../src/runtime/sqlite.ts"],"mappings":";;;;;;;;;KAEY,kBAAA;EAAA,SAAgC,IAAI;AAAA;;;KCgCpC,cAAA;AAAA,KACP,SAAA,mBAA4B,QAAA,CAAS,UAAA,KAAe,UAAA,QAAkB,GAAA,CAAW,SAAA;AAAA,UAErE,YAAA,mBAA+B,QAAA,CAAS,UAAA;EAAA,SAC9C,GAAA,EAAK,EAAA,CAAG,SAAA;EAAA,SACR,GAAA,EAAK,SAAA,CAAU,SAAA;EAAA,SACf,GAAA,EAAK,SAAA;EAAA,SACL,OAAA,EAAS,gBAAA,CAAiB,SAAA;EAAA,SAC1B,KAAA,EAAO,2BAAA,CAA4B,cAAA;EAC5C,OAAA,CAAQ,YAAA;IAAA,SAA0B,IAAA;EAAA,IAAiB,OAAA,CAAQ,OAAA;EAC3D,OAAA,IAAW,OAAA;EACX,OAAA,WACY,WAAA,CAAY,EAAA,mBAEX,cAAA,GAAiB,iBAAA,CAAkB,SAAA,IAAa,cAAA,EAE3D,WAAA,EAAa,CAAA,EACb,QAAA,GAAW,GAAA,EAAK,EAAA,CAAG,SAAA,GAAY,MAAA,EAAQ,cAAA,CAAe,CAAA,MAAO,YAAA,CAAa,GAAA,IACzE,OAAA,CAAQ,iBAAA,CAAkB,qBAAA,CAAsB,CAAA,EAAG,EAAA,GAAK,GAAA;EAC3D,KAAA,IAAS,OAAA;EAAA,CACR,MAAA,CAAO,YAAA,KAAiB,OAAA;AAAA;AAAA,UAGV,iBAAA;EAAA,SACN,UAAA,YAAsB,6BAAA,CAA8B,cAAA;EAAA,SACpD,UAAA,YAAsB,aAAA;EAAA,SACtB,YAAA,GAAe,kBAAA;AAAA;AAAA,KAGd,yBAAA,mBAA4C,QAAA,CAAS,UAAA;EAAA,SACtD,IAAA;AAAA,IACP,iBAAA;EAAA,SACS,QAAA,EAAU,SAAA;EAAA,SACV,YAAA;AAAA;AAAA,KAGD,6BAAA,mBAAgD,QAAA,CAAS,UAAA;EAAA,SAC1D,IAAA;EAAA,SACA,SAAA,GAAY,SAAA;AAAA,IACnB,iBAAA;EAAA,SACS,YAAA;EAAA,SACA,QAAA;AAAA;AAAA,KAGD,aAAA,mBAAgC,QAAA,CAAS,UAAA,KACjD,yBAAA,CAA0B,SAAA,IAC1B,6BAAA,CAA8B,SAAA;AAAA,iBAYV,MAAA,mBAAyB,QAAA,CAAS,UAAA,GACxD,OAAA,EAAS,yBAAA,CAA0B,SAAA,IAClC,YAAA,CAAa,SAAA;AAAA,iBACQ,MAAA,mBAAyB,QAAA,CAAS,UAAA,GACxD,OAAA,EAAS,6BAAA,CAA8B,SAAA,IACtC,YAAA,CAAa,SAAA"}
+{"version":3,"file":"runtime.d.mts","names":[],"sources":["../src/runtime/binding.ts","../src/runtime/sqlite.ts"],"mappings":";;;;;;;;;KAEY,kBAAA;EAAA,SAAgC,IAAI;AAAA;;;KCmCpC,cAAA;AAAA,KACP,SAAA,mBAA4B,QAAA,CAAS,UAAA,KAAe,UAAA,QAAkB,GAAA,CAAW,SAAA;AAAA,UAErE,wBAAA,mBAA2C,QAAA,CAAS,UAAA,WAC3D,kBAAA;EAAA,SACC,GAAA,EAAK,EAAA,CAAG,SAAA;EAAA,SACR,GAAA,EAAK,SAAA,CAAU,SAAA;AAAA;AAAA,UAGT,YAAA,mBAA+B,QAAA,CAAS,UAAA;EAAA,SAC9C,GAAA,EAAK,EAAA,CAAG,SAAA;EAAA,SACR,GAAA,EAAK,SAAA,CAAU,SAAA;EAAA,SACf,GAAA,EAAK,SAAA;EAAA,SACL,OAAA,EAAS,gBAAA,CAAiB,SAAA;EAAA,SAC1B,KAAA,EAAO,2BAAA,CAA4B,cAAA;EAC5C,OAAA,CAAQ,YAAA;IAAA,SAA0B,IAAA;EAAA,IAAiB,OAAA,CAAQ,OAAA;EAC3D,OAAA,IAAW,OAAA;EACX,OAAA,WACY,WAAA,CAAY,EAAA,mBAEX,cAAA,GAAiB,iBAAA,CAAkB,SAAA,IAAa,cAAA,EAE3D,WAAA,EAAa,CAAA,EACb,QAAA,GAAW,GAAA,EAAK,EAAA,CAAG,SAAA,GAAY,MAAA,EAAQ,cAAA,CAAe,CAAA,MAAO,YAAA,CAAa,GAAA,IACzE,OAAA,CAAQ,iBAAA,CAAkB,qBAAA,CAAsB,CAAA,EAAG,EAAA,GAAK,GAAA;EAC3D,WAAA,IAAe,EAAA,GAAK,EAAA,EAAI,wBAAA,CAAyB,SAAA,MAAe,WAAA,CAAY,CAAA,IAAK,OAAA,CAAQ,CAAA;EACzF,KAAA,IAAS,OAAA;EAAA,CACR,MAAA,CAAO,YAAA,KAAiB,OAAA;AAAA;AAAA,UAGV,iBAAA;EAAA,SACN,UAAA,YAAsB,6BAAA,CAA8B,cAAA;EAAA,SACpD,UAAA,YAAsB,aAAA;EAAA,SACtB,YAAA,GAAe,kBAAA;AAAA;AAAA,KAGd,yBAAA,mBAA4C,QAAA,CAAS,UAAA;EAAA,SACtD,IAAA;AAAA,IACP,iBAAA;EAAA,SACS,QAAA,EAAU,SAAA;EAAA,SACV,YAAA;AAAA;AAAA,KAGD,6BAAA,mBAAgD,QAAA,CAAS,UAAA;EAAA,SAC1D,IAAA;EAAA,SACA,SAAA,GAAY,SAAA;AAAA,IACnB,iBAAA;EAAA,SACS,YAAA;EAAA,SACA,QAAA;AAAA;AAAA,KAGD,aAAA,mBAAgC,QAAA,CAAS,UAAA,KACjD,yBAAA,CAA0B,SAAA,IAC1B,6BAAA,CAA8B,SAAA;AAAA,iBAYV,MAAA,mBAAyB,QAAA,CAAS,UAAA,GACxD,OAAA,EAAS,yBAAA,CAA0B,SAAA,IAClC,YAAA,CAAa,SAAA;AAAA,iBACQ,MAAA,mBAAyB,QAAA,CAAS,UAAA,GACxD,OAAA,EAAS,6BAAA,CAA8B,SAAA,IACtC,YAAA,CAAa,SAAA"}

package/dist/runtime.mjs

@@ -6,8 +6,9 @@ import { instantiateExecutionStack } from "@prisma-next/framework-components/exe
 import { sql } from "@prisma-next/sql-builder/runtime";
 import { orm } from "@prisma-next/sql-orm-client";
 import { createRawSql } from "@prisma-next/sql-relational-core/expression";
-import { createExecutionContext, createRuntime, createSqlExecutionStack } from "@prisma-next/sql-runtime";
+import { createExecutionContext, createRuntime, createSqlExecutionStack, withTransaction } from "@prisma-next/sql-runtime";
 import sqliteTarget from "@prisma-next/target-sqlite/runtime";
+import { castAs } from "@prisma-next/utils/casts";
 //#region src/runtime/binding.ts
 function resolveSqliteBinding(input) {
 	return {
@@ -121,6 +122,30 @@ function sqlite(options) {
 		prepare(declaration, callback) {
 			return getRuntime().prepare(declaration, (params) => callback(sql$1, params));
 		},
+		transaction(fn) {
+			let runtime;
+			try {
+				runtime = getRuntime();
+			} catch (err) {
+				return Promise.reject(err);
+			}
+			return withTransaction(runtime, (txCtx) => {
+				const txSql = sql({
+					context,
+					rawCodecInferer
+				});
+				const txOrm = orm({
+					runtime: { execute(plan) {
+						return txCtx.execute(plan);
+					} },
+					context
+				});
+				return fn(Object.assign(castAs(Object.create(txCtx)), {
+					sql: txSql,
+					orm: txOrm
+				}));
+			});
+		},
 		close() {
 			if (closePromise) return closePromise;
 			closed = true;

package/dist/runtime.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.mjs","names":["sql","sqlBuilder","ormBuilder"],"sources":["../src/runtime/binding.ts","../src/runtime/sqlite.ts"],"sourcesContent":["import type { SqliteBinding } from '@prisma-next/driver-sqlite/runtime';\n\nexport type SqliteBindingInput = { readonly path: string };\n\nexport function resolveSqliteBinding(input: SqliteBindingInput): SqliteBinding {\n  return { kind: 'path', path: input.path };\n}\n\nexport function resolveOptionalSqliteBinding(options: {\n  readonly path?: string;\n}): SqliteBinding | undefined {\n  if (options.path === undefined) {\n    return undefined;\n  }\n  return { kind: 'path', path: options.path };\n}\n","import sqliteAdapter from '@prisma-next/adapter-sqlite/runtime';\nimport type { Contract } from '@prisma-next/contract/types';\nimport type { SqliteBinding } from '@prisma-next/driver-sqlite/runtime';\nimport sqliteDriver from '@prisma-next/driver-sqlite/runtime';\nimport { SqlContractSerializer } from '@prisma-next/family-sql/ir';\nimport { instantiateExecutionStack } from '@prisma-next/framework-components/execution';\nimport { sql as sqlBuilder } from '@prisma-next/sql-builder/runtime';\nimport type { Db } from '@prisma-next/sql-builder/types';\nimport type { ExtractCodecTypes, SqlStorage } from '@prisma-next/sql-contract/types';\nimport { orm as ormBuilder } from '@prisma-next/sql-orm-client';\nimport type { CodecTypesBase, RawSqlTag } from '@prisma-next/sql-relational-core/expression';\nimport { createRawSql } from '@prisma-next/sql-relational-core/expression';\nimport type { SqlQueryPlan } from '@prisma-next/sql-relational-core/plan';\nimport type {\n  BindSiteParams,\n  Declaration,\n  ExecutionContext,\n  ParamsFromDeclaration,\n  PreparedStatement,\n  Runtime,\n  SqlExecutionStackWithDriver,\n  SqlMiddleware,\n  SqlRuntimeExtensionDescriptor,\n  VerifyMarkerOption,\n} from '@prisma-next/sql-runtime';\nimport {\n  createExecutionContext,\n  createRuntime,\n  createSqlExecutionStack,\n} from '@prisma-next/sql-runtime';\nimport sqliteTarget from '@prisma-next/target-sqlite/runtime';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { resolveOptionalSqliteBinding, resolveSqliteBinding } from './binding';\n\nexport type SqliteTargetId = 'sqlite';\ntype OrmClient<TContract extends Contract<SqlStorage>> = ReturnType<typeof ormBuilder<TContract>>;\n\nexport interface SqliteClient<TContract extends Contract<SqlStorage>> {\n  readonly sql: Db<TContract>;\n  readonly orm: OrmClient<TContract>;\n  readonly raw: RawSqlTag;\n  readonly context: ExecutionContext<TContract>;\n  readonly stack: SqlExecutionStackWithDriver<SqliteTargetId>;\n  connect(bindingInput?: { readonly path: string }): Promise<Runtime>;\n  runtime(): Runtime;\n  prepare<\n    D extends Declaration<CT>,\n    Row,\n    CT extends CodecTypesBase = ExtractCodecTypes<TContract> & CodecTypesBase,\n  >(\n    declaration: D,\n    callback: (sql: Db<TContract>, params: BindSiteParams<D>) => SqlQueryPlan<Row>,\n  ): Promise<PreparedStatement<ParamsFromDeclaration<D, CT>, Row>>;\n  close(): Promise<void>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n\nexport interface SqliteOptionsBase {\n  readonly extensions?: readonly SqlRuntimeExtensionDescriptor<SqliteTargetId>[];\n  readonly middleware?: readonly SqlMiddleware[];\n  readonly verifyMarker?: VerifyMarkerOption;\n}\n\nexport type SqliteOptionsWithContract<TContract extends Contract<SqlStorage>> = {\n  readonly path?: string;\n} & SqliteOptionsBase & {\n    readonly contract: TContract;\n    readonly contractJson?: never;\n  };\n\nexport type SqliteOptionsWithContractJson<TContract extends Contract<SqlStorage>> = {\n  readonly path?: string;\n  readonly _contract?: TContract;\n} & SqliteOptionsBase & {\n    readonly contractJson: unknown;\n    readonly contract?: never;\n  };\n\nexport type SqliteOptions<TContract extends Contract<SqlStorage>> =\n  | SqliteOptionsWithContract<TContract>\n  | SqliteOptionsWithContractJson<TContract>;\n\nfunction resolveContract<TContract extends Contract<SqlStorage>>(\n  options: SqliteOptions<TContract>,\n): TContract {\n  const contractInput =\n    'contractJson' in options && options.contractJson !== undefined\n      ? options.contractJson\n      : (options as SqliteOptionsWithContract<TContract>).contract;\n  return new SqlContractSerializer().deserializeContract(contractInput) as TContract;\n}\n\nexport default function sqlite<TContract extends Contract<SqlStorage>>(\n  options: SqliteOptionsWithContract<TContract>,\n): SqliteClient<TContract>;\nexport default function sqlite<TContract extends Contract<SqlStorage>>(\n  options: SqliteOptionsWithContractJson<TContract>,\n): SqliteClient<TContract>;\nexport default function sqlite<TContract extends Contract<SqlStorage>>(\n  options: SqliteOptions<TContract>,\n): SqliteClient<TContract> {\n  const contract = resolveContract(options);\n  let binding = resolveOptionalSqliteBinding(options);\n  const stack = createSqlExecutionStack({\n    target: sqliteTarget,\n    adapter: sqliteAdapter,\n    driver: sqliteDriver,\n    extensionPacks: options.extensions ?? [],\n  });\n\n  const context = createExecutionContext({\n    contract,\n    stack,\n  });\n\n  const rawCodecInferer = stack.adapter.rawCodecInferer;\n  const rawSqlTag: RawSqlTag = createRawSql(rawCodecInferer);\n\n  const sql: Db<TContract> = sqlBuilder<TContract>({ context, rawCodecInferer });\n  let runtimeInstance: Runtime | undefined;\n  let runtimeDriver: { connect(binding: unknown): Promise<void> } | undefined;\n  let driverConnected = false;\n  let connectPromise: Promise<void> | undefined;\n  let closePromise: Promise<void> | undefined;\n  let backgroundConnectError: unknown;\n  let closed = false;\n  let ownedDispose: (() => Promise<void>) | undefined;\n\n  const connectDriver = async (resolvedBinding: SqliteBinding): Promise<void> => {\n    if (driverConnected) return;\n    if (!runtimeDriver) throw new Error('SQLite runtime driver missing');\n    if (connectPromise) return connectPromise;\n    connectPromise = runtimeDriver\n      .connect(resolvedBinding)\n      .then(() => {\n        driverConnected = true;\n      })\n      .catch((err) => {\n        backgroundConnectError = err;\n        connectPromise = undefined;\n        throw err;\n      });\n    return connectPromise;\n  };\n\n  const getRuntime = (): Runtime => {\n    if (closed) {\n      throw new Error('SQLite client is closed');\n    }\n\n    if (backgroundConnectError !== undefined) {\n      throw backgroundConnectError;\n    }\n\n    if (runtimeInstance) {\n      return runtimeInstance;\n    }\n\n    const stackInstance = instantiateExecutionStack(stack);\n    const driverDescriptor = stack.driver;\n    if (!driverDescriptor) {\n      throw new Error('Driver descriptor missing from execution stack');\n    }\n\n    const driver = driverDescriptor.create();\n    ownedDispose = () => driver.close();\n    runtimeDriver = driver;\n    if (binding !== undefined) {\n      void connectDriver(binding).catch(() => undefined);\n    }\n\n    runtimeInstance = createRuntime({\n      stackInstance,\n      context,\n      driver,\n      ...ifDefined('verifyMarker', options.verifyMarker),\n      ...(options.middleware ? { middleware: options.middleware } : {}),\n    });\n\n    return runtimeInstance;\n  };\n\n  const orm: OrmClient<TContract> = ormBuilder({\n    context,\n    runtime: {\n      execute(plan) {\n        return getRuntime().execute(plan);\n      },\n      connection() {\n        return getRuntime().connection();\n      },\n    },\n  });\n\n  return {\n    sql,\n    orm,\n    raw: rawSqlTag,\n    context,\n    stack,\n    async connect(bindingInput) {\n      if (closed) {\n        throw new Error('SQLite client is closed');\n      }\n\n      if (driverConnected || connectPromise) {\n        throw new Error('SQLite client already connected');\n      }\n\n      backgroundConnectError = undefined;\n\n      if (bindingInput !== undefined) {\n        binding = resolveSqliteBinding(bindingInput);\n      }\n\n      if (binding === undefined) {\n        throw new Error(\n          'SQLite binding not configured. Pass path to sqlite(...) or call db.connect({ path }).',\n        );\n      }\n\n      const runtime = getRuntime();\n      if (driverConnected) {\n        return runtime;\n      }\n\n      await connectDriver(binding);\n      return runtime;\n    },\n    runtime() {\n      return getRuntime();\n    },\n    prepare<\n      D extends Declaration<CT>,\n      Row,\n      CT extends CodecTypesBase = ExtractCodecTypes<TContract> & CodecTypesBase,\n    >(\n      declaration: D,\n      callback: (sql: Db<TContract>, params: BindSiteParams<D>) => SqlQueryPlan<Row>,\n    ): Promise<PreparedStatement<ParamsFromDeclaration<D, CT>, Row>> {\n      return getRuntime().prepare<D, Row, CT>(declaration, (params) => callback(sql, params));\n    },\n\n    close(): Promise<void> {\n      if (closePromise) return closePromise;\n      closed = true;\n      closePromise = (async () => {\n        await connectPromise?.catch(() => undefined);\n        await ownedDispose?.();\n      })();\n      return closePromise;\n    },\n\n    [Symbol.asyncDispose](): Promise<void> {\n      return this.close();\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"runtime.mjs","names":["sql","sqlBuilder","ormBuilder"],"sources":["../src/runtime/binding.ts","../src/runtime/sqlite.ts"],"sourcesContent":["import type { SqliteBinding } from '@prisma-next/driver-sqlite/runtime';\n\nexport type SqliteBindingInput = { readonly path: string };\n\nexport function resolveSqliteBinding(input: SqliteBindingInput): SqliteBinding {\n  return { kind: 'path', path: input.path };\n}\n\nexport function resolveOptionalSqliteBinding(options: {\n  readonly path?: string;\n}): SqliteBinding | undefined {\n  if (options.path === undefined) {\n    return undefined;\n  }\n  return { kind: 'path', path: options.path };\n}\n","import sqliteAdapter from '@prisma-next/adapter-sqlite/runtime';\nimport type { Contract } from '@prisma-next/contract/types';\nimport type { SqliteBinding } from '@prisma-next/driver-sqlite/runtime';\nimport sqliteDriver from '@prisma-next/driver-sqlite/runtime';\nimport { SqlContractSerializer } from '@prisma-next/family-sql/ir';\nimport { instantiateExecutionStack } from '@prisma-next/framework-components/execution';\nimport { sql as sqlBuilder } from '@prisma-next/sql-builder/runtime';\nimport type { Db } from '@prisma-next/sql-builder/types';\nimport type { ExtractCodecTypes, SqlStorage } from '@prisma-next/sql-contract/types';\nimport { orm as ormBuilder } from '@prisma-next/sql-orm-client';\nimport type { CodecTypesBase, RawSqlTag } from '@prisma-next/sql-relational-core/expression';\nimport { createRawSql } from '@prisma-next/sql-relational-core/expression';\nimport type { SqlQueryPlan } from '@prisma-next/sql-relational-core/plan';\nimport type {\n  BindSiteParams,\n  Declaration,\n  ExecutionContext,\n  ParamsFromDeclaration,\n  PreparedStatement,\n  Runtime,\n  SqlExecutionStackWithDriver,\n  SqlMiddleware,\n  SqlRuntimeExtensionDescriptor,\n  TransactionContext,\n  VerifyMarkerOption,\n} from '@prisma-next/sql-runtime';\nimport {\n  createExecutionContext,\n  createRuntime,\n  createSqlExecutionStack,\n  withTransaction,\n} from '@prisma-next/sql-runtime';\nimport sqliteTarget from '@prisma-next/target-sqlite/runtime';\nimport { castAs } from '@prisma-next/utils/casts';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { resolveOptionalSqliteBinding, resolveSqliteBinding } from './binding';\n\nexport type SqliteTargetId = 'sqlite';\ntype OrmClient<TContract extends Contract<SqlStorage>> = ReturnType<typeof ormBuilder<TContract>>;\n\nexport interface SqliteTransactionContext<TContract extends Contract<SqlStorage>>\n  extends TransactionContext {\n  readonly sql: Db<TContract>;\n  readonly orm: OrmClient<TContract>;\n}\n\nexport interface SqliteClient<TContract extends Contract<SqlStorage>> {\n  readonly sql: Db<TContract>;\n  readonly orm: OrmClient<TContract>;\n  readonly raw: RawSqlTag;\n  readonly context: ExecutionContext<TContract>;\n  readonly stack: SqlExecutionStackWithDriver<SqliteTargetId>;\n  connect(bindingInput?: { readonly path: string }): Promise<Runtime>;\n  runtime(): Runtime;\n  prepare<\n    D extends Declaration<CT>,\n    Row,\n    CT extends CodecTypesBase = ExtractCodecTypes<TContract> & CodecTypesBase,\n  >(\n    declaration: D,\n    callback: (sql: Db<TContract>, params: BindSiteParams<D>) => SqlQueryPlan<Row>,\n  ): Promise<PreparedStatement<ParamsFromDeclaration<D, CT>, Row>>;\n  transaction<R>(fn: (tx: SqliteTransactionContext<TContract>) => PromiseLike<R>): Promise<R>;\n  close(): Promise<void>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n\nexport interface SqliteOptionsBase {\n  readonly extensions?: readonly SqlRuntimeExtensionDescriptor<SqliteTargetId>[];\n  readonly middleware?: readonly SqlMiddleware[];\n  readonly verifyMarker?: VerifyMarkerOption;\n}\n\nexport type SqliteOptionsWithContract<TContract extends Contract<SqlStorage>> = {\n  readonly path?: string;\n} & SqliteOptionsBase & {\n    readonly contract: TContract;\n    readonly contractJson?: never;\n  };\n\nexport type SqliteOptionsWithContractJson<TContract extends Contract<SqlStorage>> = {\n  readonly path?: string;\n  readonly _contract?: TContract;\n} & SqliteOptionsBase & {\n    readonly contractJson: unknown;\n    readonly contract?: never;\n  };\n\nexport type SqliteOptions<TContract extends Contract<SqlStorage>> =\n  | SqliteOptionsWithContract<TContract>\n  | SqliteOptionsWithContractJson<TContract>;\n\nfunction resolveContract<TContract extends Contract<SqlStorage>>(\n  options: SqliteOptions<TContract>,\n): TContract {\n  const contractInput =\n    'contractJson' in options && options.contractJson !== undefined\n      ? options.contractJson\n      : (options as SqliteOptionsWithContract<TContract>).contract;\n  return new SqlContractSerializer().deserializeContract(contractInput) as TContract;\n}\n\nexport default function sqlite<TContract extends Contract<SqlStorage>>(\n  options: SqliteOptionsWithContract<TContract>,\n): SqliteClient<TContract>;\nexport default function sqlite<TContract extends Contract<SqlStorage>>(\n  options: SqliteOptionsWithContractJson<TContract>,\n): SqliteClient<TContract>;\nexport default function sqlite<TContract extends Contract<SqlStorage>>(\n  options: SqliteOptions<TContract>,\n): SqliteClient<TContract> {\n  const contract = resolveContract(options);\n  let binding = resolveOptionalSqliteBinding(options);\n  const stack = createSqlExecutionStack({\n    target: sqliteTarget,\n    adapter: sqliteAdapter,\n    driver: sqliteDriver,\n    extensionPacks: options.extensions ?? [],\n  });\n\n  const context = createExecutionContext({\n    contract,\n    stack,\n  });\n\n  const rawCodecInferer = stack.adapter.rawCodecInferer;\n  const rawSqlTag: RawSqlTag = createRawSql(rawCodecInferer);\n\n  const sql: Db<TContract> = sqlBuilder<TContract>({ context, rawCodecInferer });\n  let runtimeInstance: Runtime | undefined;\n  let runtimeDriver: { connect(binding: unknown): Promise<void> } | undefined;\n  let driverConnected = false;\n  let connectPromise: Promise<void> | undefined;\n  let closePromise: Promise<void> | undefined;\n  let backgroundConnectError: unknown;\n  let closed = false;\n  let ownedDispose: (() => Promise<void>) | undefined;\n\n  const connectDriver = async (resolvedBinding: SqliteBinding): Promise<void> => {\n    if (driverConnected) return;\n    if (!runtimeDriver) throw new Error('SQLite runtime driver missing');\n    if (connectPromise) return connectPromise;\n    connectPromise = runtimeDriver\n      .connect(resolvedBinding)\n      .then(() => {\n        driverConnected = true;\n      })\n      .catch((err) => {\n        backgroundConnectError = err;\n        connectPromise = undefined;\n        throw err;\n      });\n    return connectPromise;\n  };\n\n  const getRuntime = (): Runtime => {\n    if (closed) {\n      throw new Error('SQLite client is closed');\n    }\n\n    if (backgroundConnectError !== undefined) {\n      throw backgroundConnectError;\n    }\n\n    if (runtimeInstance) {\n      return runtimeInstance;\n    }\n\n    const stackInstance = instantiateExecutionStack(stack);\n    const driverDescriptor = stack.driver;\n    if (!driverDescriptor) {\n      throw new Error('Driver descriptor missing from execution stack');\n    }\n\n    const driver = driverDescriptor.create();\n    ownedDispose = () => driver.close();\n    runtimeDriver = driver;\n    if (binding !== undefined) {\n      void connectDriver(binding).catch(() => undefined);\n    }\n\n    runtimeInstance = createRuntime({\n      stackInstance,\n      context,\n      driver,\n      ...ifDefined('verifyMarker', options.verifyMarker),\n      ...(options.middleware ? { middleware: options.middleware } : {}),\n    });\n\n    return runtimeInstance;\n  };\n\n  const orm: OrmClient<TContract> = ormBuilder({\n    context,\n    runtime: {\n      execute(plan) {\n        return getRuntime().execute(plan);\n      },\n      connection() {\n        return getRuntime().connection();\n      },\n    },\n  });\n\n  return {\n    sql,\n    orm,\n    raw: rawSqlTag,\n    context,\n    stack,\n    async connect(bindingInput) {\n      if (closed) {\n        throw new Error('SQLite client is closed');\n      }\n\n      if (driverConnected || connectPromise) {\n        throw new Error('SQLite client already connected');\n      }\n\n      backgroundConnectError = undefined;\n\n      if (bindingInput !== undefined) {\n        binding = resolveSqliteBinding(bindingInput);\n      }\n\n      if (binding === undefined) {\n        throw new Error(\n          'SQLite binding not configured. Pass path to sqlite(...) or call db.connect({ path }).',\n        );\n      }\n\n      const runtime = getRuntime();\n      if (driverConnected) {\n        return runtime;\n      }\n\n      await connectDriver(binding);\n      return runtime;\n    },\n    runtime() {\n      return getRuntime();\n    },\n    prepare<\n      D extends Declaration<CT>,\n      Row,\n      CT extends CodecTypesBase = ExtractCodecTypes<TContract> & CodecTypesBase,\n    >(\n      declaration: D,\n      callback: (sql: Db<TContract>, params: BindSiteParams<D>) => SqlQueryPlan<Row>,\n    ): Promise<PreparedStatement<ParamsFromDeclaration<D, CT>, Row>> {\n      return getRuntime().prepare<D, Row, CT>(declaration, (params) => callback(sql, params));\n    },\n\n    transaction<R>(fn: (tx: SqliteTransactionContext<TContract>) => PromiseLike<R>): Promise<R> {\n      let runtime: ReturnType<typeof getRuntime>;\n      try {\n        runtime = getRuntime();\n      } catch (err) {\n        return Promise.reject(err);\n      }\n      return withTransaction(runtime, (txCtx) => {\n        const txSql: Db<TContract> = sqlBuilder<TContract>({\n          context,\n          rawCodecInferer,\n        });\n\n        const txOrm: OrmClient<TContract> = ormBuilder({\n          runtime: {\n            execute(plan) {\n              return txCtx.execute(plan);\n            },\n          },\n          context,\n        });\n\n        // Use `txCtx` as the prototype instead of spreading it so that live\n        // accessors (notably the `invalidated` getter, which reads a closure\n        // variable in `withTransaction`) remain wired to the original object.\n        // Spreading would evaluate the getter once and freeze its value.\n        const tx: SqliteTransactionContext<TContract> = Object.assign(\n          castAs<TransactionContext>(Object.create(txCtx)),\n          { sql: txSql, orm: txOrm },\n        );\n\n        return fn(tx);\n      });\n    },\n\n    close(): Promise<void> {\n      if (closePromise) return closePromise;\n      closed = true;\n      closePromise = (async () => {\n        await connectPromise?.catch(() => undefined);\n        await ownedDispose?.();\n      })();\n      return closePromise;\n    },\n\n    [Symbol.asyncDispose](): Promise<void> {\n      return this.close();\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;AAIA,SAAgB,qBAAqB,OAA0C;CAC7E,OAAO;EAAE,MAAM;EAAQ,MAAM,MAAM;CAAK;AAC1C;AAEA,SAAgB,6BAA6B,SAEf;CAC5B,IAAI,QAAQ,SAAS,KAAA,GACnB;CAEF,OAAO;EAAE,MAAM;EAAQ,MAAM,QAAQ;CAAK;AAC5C;;;AC6EA,SAAS,gBACP,SACW;CACX,MAAM,gBACJ,kBAAkB,WAAW,QAAQ,iBAAiB,KAAA,IAClD,QAAQ,eACP,QAAiD;CACxD,OAAO,IAAI,sBAAsB,CAAC,CAAC,oBAAoB,aAAa;AACtE;AAQA,SAAwB,OACtB,SACyB;CACzB,MAAM,WAAW,gBAAgB,OAAO;CACxC,IAAI,UAAU,6BAA6B,OAAO;CAClD,MAAM,QAAQ,wBAAwB;EACpC,QAAQ;EACR,SAAS;EACT,QAAQ;EACR,gBAAgB,QAAQ,cAAc,CAAC;CACzC,CAAC;CAED,MAAM,UAAU,uBAAuB;EACrC;EACA;CACF,CAAC;CAED,MAAM,kBAAkB,MAAM,QAAQ;CACtC,MAAM,YAAuB,aAAa,eAAe;CAEzD,MAAMA,QAAqBC,IAAsB;EAAE;EAAS;CAAgB,CAAC;CAC7E,IAAI;CACJ,IAAI;CACJ,IAAI,kBAAkB;CACtB,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI,SAAS;CACb,IAAI;CAEJ,MAAM,gBAAgB,OAAO,oBAAkD;EAC7E,IAAI,iBAAiB;EACrB,IAAI,CAAC,eAAe,MAAM,IAAI,MAAM,+BAA+B;EACnE,IAAI,gBAAgB,OAAO;EAC3B,iBAAiB,cACd,QAAQ,eAAe,CAAC,CACxB,WAAW;GACV,kBAAkB;EACpB,CAAC,CAAC,CACD,OAAO,QAAQ;GACd,yBAAyB;GACzB,iBAAiB,KAAA;GACjB,MAAM;EACR,CAAC;EACH,OAAO;CACT;CAEA,MAAM,mBAA4B;EAChC,IAAI,QACF,MAAM,IAAI,MAAM,yBAAyB;EAG3C,IAAI,2BAA2B,KAAA,GAC7B,MAAM;EAGR,IAAI,iBACF,OAAO;EAGT,MAAM,gBAAgB,0BAA0B,KAAK;EACrD,MAAM,mBAAmB,MAAM;EAC/B,IAAI,CAAC,kBACH,MAAM,IAAI,MAAM,gDAAgD;EAGlE,MAAM,SAAS,iBAAiB,OAAO;EACvC,qBAAqB,OAAO,MAAM;EAClC,gBAAgB;EAChB,IAAI,YAAY,KAAA,GACd,cAAmB,OAAO,CAAC,CAAC,YAAY,KAAA,CAAS;EAGnD,kBAAkB,cAAc;GAC9B;GACA;GACA;GACA,GAAG,UAAU,gBAAgB,QAAQ,YAAY;GACjD,GAAI,QAAQ,aAAa,EAAE,YAAY,QAAQ,WAAW,IAAI,CAAC;EACjE,CAAC;EAED,OAAO;CACT;CAcA,OAAO;EACL,KAAA;EACA,KAdgCC,IAAW;GAC3C;GACA,SAAS;IACP,QAAQ,MAAM;KACZ,OAAO,WAAW,CAAC,CAAC,QAAQ,IAAI;IAClC;IACA,aAAa;KACX,OAAO,WAAW,CAAC,CAAC,WAAW;IACjC;GACF;EACF,CAII;EACF,KAAK;EACL;EACA;EACA,MAAM,QAAQ,cAAc;GAC1B,IAAI,QACF,MAAM,IAAI,MAAM,yBAAyB;GAG3C,IAAI,mBAAmB,gBACrB,MAAM,IAAI,MAAM,iCAAiC;GAGnD,yBAAyB,KAAA;GAEzB,IAAI,iBAAiB,KAAA,GACnB,UAAU,qBAAqB,YAAY;GAG7C,IAAI,YAAY,KAAA,GACd,MAAM,IAAI,MACR,uFACF;GAGF,MAAM,UAAU,WAAW;GAC3B,IAAI,iBACF,OAAO;GAGT,MAAM,cAAc,OAAO;GAC3B,OAAO;EACT;EACA,UAAU;GACR,OAAO,WAAW;EACpB;EACA,QAKE,aACA,UAC+D;GAC/D,OAAO,WAAW,CAAC,CAAC,QAAoB,cAAc,WAAW,SAASF,OAAK,MAAM,CAAC;EACxF;EAEA,YAAe,IAA6E;GAC1F,IAAI;GACJ,IAAI;IACF,UAAU,WAAW;GACvB,SAAS,KAAK;IACZ,OAAO,QAAQ,OAAO,GAAG;GAC3B;GACA,OAAO,gBAAgB,UAAU,UAAU;IACzC,MAAM,QAAuBC,IAAsB;KACjD;KACA;IACF,CAAC;IAED,MAAM,QAA8BC,IAAW;KAC7C,SAAS,EACP,QAAQ,MAAM;MACZ,OAAO,MAAM,QAAQ,IAAI;KAC3B,EACF;KACA;IACF,CAAC;IAWD,OAAO,GALyC,OAAO,OACrD,OAA2B,OAAO,OAAO,KAAK,CAAC,GAC/C;KAAE,KAAK;KAAO,KAAK;IAAM,CAGhB,CAAC;GACd,CAAC;EACH;EAEA,QAAuB;GACrB,IAAI,cAAc,OAAO;GACzB,SAAS;GACT,gBAAgB,YAAY;IAC1B,MAAM,gBAAgB,YAAY,KAAA,CAAS;IAC3C,MAAM,eAAe;GACvB,EAAA,CAAG;GACH,OAAO;EACT;EAEA,CAAC,OAAO,gBAA+B;GACrC,OAAO,KAAK,MAAM;EACpB;CACF;AACF"}

package/package.json

@@ -1,33 +1,33 @@
 {
   "name": "@prisma-next/sqlite",
-  "version": "0.12.0-dev.72",
+  "version": "0.12.0-dev.73",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
   "description": "One-liner lazy SQLite client composition for Prisma Next",
   "dependencies": {
-    "@prisma-next/adapter-sqlite": "0.12.0-dev.72",
-    "@prisma-next/cli": "0.12.0-dev.72",
-    "@prisma-next/config": "0.12.0-dev.72",
-    "@prisma-next/contract": "0.12.0-dev.72",
-    "@prisma-next/driver-sqlite": "0.12.0-dev.72",
-    "@prisma-next/family-sql": "0.12.0-dev.72",
-    "@prisma-next/framework-components": "0.12.0-dev.72",
-    "@prisma-next/sql-builder": "0.12.0-dev.72",
-    "@prisma-next/sql-contract": "0.12.0-dev.72",
-    "@prisma-next/sql-contract-psl": "0.12.0-dev.72",
-    "@prisma-next/sql-contract-ts": "0.12.0-dev.72",
-    "@prisma-next/sql-orm-client": "0.12.0-dev.72",
-    "@prisma-next/sql-relational-core": "0.12.0-dev.72",
-    "@prisma-next/sql-runtime": "0.12.0-dev.72",
-    "@prisma-next/target-sqlite": "0.12.0-dev.72",
-    "@prisma-next/utils": "0.12.0-dev.72",
+    "@prisma-next/adapter-sqlite": "0.12.0-dev.73",
+    "@prisma-next/cli": "0.12.0-dev.73",
+    "@prisma-next/config": "0.12.0-dev.73",
+    "@prisma-next/contract": "0.12.0-dev.73",
+    "@prisma-next/driver-sqlite": "0.12.0-dev.73",
+    "@prisma-next/family-sql": "0.12.0-dev.73",
+    "@prisma-next/framework-components": "0.12.0-dev.73",
+    "@prisma-next/sql-builder": "0.12.0-dev.73",
+    "@prisma-next/sql-contract": "0.12.0-dev.73",
+    "@prisma-next/sql-contract-psl": "0.12.0-dev.73",
+    "@prisma-next/sql-contract-ts": "0.12.0-dev.73",
+    "@prisma-next/sql-orm-client": "0.12.0-dev.73",
+    "@prisma-next/sql-relational-core": "0.12.0-dev.73",
+    "@prisma-next/sql-runtime": "0.12.0-dev.73",
+    "@prisma-next/target-sqlite": "0.12.0-dev.73",
+    "@prisma-next/utils": "0.12.0-dev.73",
     "pathe": "^2.0.3"
   },
   "devDependencies": {
-    "@prisma-next/test-utils": "0.12.0-dev.72",
-    "@prisma-next/tsconfig": "0.12.0-dev.72",
-    "@prisma-next/tsdown": "0.12.0-dev.72",
+    "@prisma-next/test-utils": "0.12.0-dev.73",
+    "@prisma-next/tsconfig": "0.12.0-dev.73",
+    "@prisma-next/tsdown": "0.12.0-dev.73",
     "tsdown": "0.22.1",
     "typescript": "5.9.3",
     "vitest": "4.1.8"

package/src/runtime/sqlite.ts

@@ -21,20 +21,29 @@ import type {
   SqlExecutionStackWithDriver,
   SqlMiddleware,
   SqlRuntimeExtensionDescriptor,
+  TransactionContext,
   VerifyMarkerOption,
 } from '@prisma-next/sql-runtime';
 import {
   createExecutionContext,
   createRuntime,
   createSqlExecutionStack,
+  withTransaction,
 } from '@prisma-next/sql-runtime';
 import sqliteTarget from '@prisma-next/target-sqlite/runtime';
+import { castAs } from '@prisma-next/utils/casts';
 import { ifDefined } from '@prisma-next/utils/defined';
 import { resolveOptionalSqliteBinding, resolveSqliteBinding } from './binding';
 
 export type SqliteTargetId = 'sqlite';
 type OrmClient<TContract extends Contract<SqlStorage>> = ReturnType<typeof ormBuilder<TContract>>;
 
+export interface SqliteTransactionContext<TContract extends Contract<SqlStorage>>
+  extends TransactionContext {
+  readonly sql: Db<TContract>;
+  readonly orm: OrmClient<TContract>;
+}
+
 export interface SqliteClient<TContract extends Contract<SqlStorage>> {
   readonly sql: Db<TContract>;
   readonly orm: OrmClient<TContract>;
@@ -51,6 +60,7 @@ export interface SqliteClient<TContract extends Contract<SqlStorage>> {
     declaration: D,
     callback: (sql: Db<TContract>, params: BindSiteParams<D>) => SqlQueryPlan<Row>,
   ): Promise<PreparedStatement<ParamsFromDeclaration<D, CT>, Row>>;
+  transaction<R>(fn: (tx: SqliteTransactionContext<TContract>) => PromiseLike<R>): Promise<R>;
   close(): Promise<void>;
   [Symbol.asyncDispose](): Promise<void>;
 }
@@ -241,6 +251,41 @@ export default function sqlite<TContract extends Contract<SqlStorage>>(
       return getRuntime().prepare<D, Row, CT>(declaration, (params) => callback(sql, params));
     },
 
+    transaction<R>(fn: (tx: SqliteTransactionContext<TContract>) => PromiseLike<R>): Promise<R> {
+      let runtime: ReturnType<typeof getRuntime>;
+      try {
+        runtime = getRuntime();
+      } catch (err) {
+        return Promise.reject(err);
+      }
+      return withTransaction(runtime, (txCtx) => {
+        const txSql: Db<TContract> = sqlBuilder<TContract>({
+          context,
+          rawCodecInferer,
+        });
+
+        const txOrm: OrmClient<TContract> = ormBuilder({
+          runtime: {
+            execute(plan) {
+              return txCtx.execute(plan);
+            },
+          },
+          context,
+        });
+
+        // Use `txCtx` as the prototype instead of spreading it so that live
+        // accessors (notably the `invalidated` getter, which reads a closure
+        // variable in `withTransaction`) remain wired to the original object.
+        // Spreading would evaluate the getter once and freeze its value.
+        const tx: SqliteTransactionContext<TContract> = Object.assign(
+          castAs<TransactionContext>(Object.create(txCtx)),
+          { sql: txSql, orm: txOrm },
+        );
+
+        return fn(tx);
+      });
+    },
+
     close(): Promise<void> {
       if (closePromise) return closePromise;
       closed = true;