@prisma-next/sqlite 0.10.0-dev.9 → 0.11.0

package/README.md

@@ -1,67 +1,97 @@
 # @prisma-next/sqlite
 
-Composition-root SQLite helper that builds a Prisma Next runtime client and exposes SQL, ORM, and schema query access.
+One-package SQLite setup for Prisma Next. Install this single package to get config, runtime, contract authoring, control-plane access, and migration helpers — no reach-ins to internal packages required.
 
 ## Package Classification
 
 - **Domain**: extensions
 - **Layer**: adapters
-- **Plane**: runtime
+- **Planes**: shared (config, contract-builder), migration (control, migration), runtime (runtime)
 
-## Overview
+## Quick Start
 
-`@prisma-next/sqlite/runtime` exposes a single `sqlite(...)` helper that composes the SQLite execution stack and returns query/runtime roots:
+```typescript
+// prisma-next.config.ts
+import { defineConfig } from '@prisma-next/sqlite/config';
 
-- `db.sql`
-- `db.orm`
-- `db.context`
-- `db.stack`
+export default defineConfig({
+  contract: './prisma/contract.prisma',
+  db: { connection: 'path/to/app.db' },
+});
+```
 
-Runtime resources are deferred until `db.runtime()` or `db.connect(...)` is called.
-Connection binding can be provided up front (`path`) or deferred via `db.connect(...)`.
+```typescript
+// prisma/contract.ts
+import { defineContract, field, model } from '@prisma-next/sqlite/contract-builder';
 
-## Responsibilities
+export default defineContract({
+  models: {
+    User: model('User', { fields: { id: field.id.uuidv4() } }),
+  },
+});
+```
 
-- Build a static SQLite execution stack from target, adapter, and driver descriptors
-- Build typed SQL surface from the execution context via `sql-query-builder-new`
-- Build ORM surface from the execution context
-- Normalize runtime binding input (file path or `:memory:`)
-- Lazily instantiate runtime resources on first `db.runtime()` or `db.connect(...)` call
-- Connect the internal SQLite driver through `db.connect(...)` or from initial binding options
-- Memoize runtime so repeated `db.runtime()` calls return one instance
+## Exports
 
-## Dependencies
+### `@prisma-next/sqlite/config`
+
+Simplified `defineConfig` that pre-wires all SQLite internals (family, target, adapter, driver, contract providers). Accepts `contract`, `db.connection`, `extensions`, and `migrations.dir`.
+
+```typescript
+import { defineConfig } from '@prisma-next/sqlite/config';
+
+export default defineConfig({
+  contract: './prisma/contract.prisma',
+  db: { connection: 'path/to/app.db' },
+  migrations: { dir: 'migrations/app' },
+});
+```
+
+### `@prisma-next/sqlite/contract-builder`
+
+TypeScript contract authoring DSL (`defineContract`, `field`, `model`, `rel`, …). The `defineContract` facade pre-binds `family` and `target` — callers do not pass those fields.
 
-- **`@prisma-next/sql-runtime`** for stack/context/runtime primitives
-- **`@prisma-next/framework-components`** for stack instantiation
-- **`@prisma-next/target-sqlite`** for target descriptor
-- **`@prisma-next/adapter-sqlite`** for adapter descriptor
-- **`@prisma-next/driver-sqlite`** for driver descriptor
-- **`@prisma-next/sql-builder`** for `sql(...)` query builder
-- **`@prisma-next/sql-relational-core`** for `schema(...)`
-- **`@prisma-next/sql-orm-client`** for `orm(...)`
-- **`@prisma-next/sql-contract`** for contract types (contract validation flows through the `ContractSerializer` SPI on the SQL family target descriptor; the `sqlite<Contract>(...)` facade wraps it)
-
-## Architecture
-
-```mermaid
-flowchart TD
-    App[App Code] --> Client["sqlite(...)"]
-    Client --> Static["Roots: sql orm context stack"]
-    Client --> Lazy["runtime()"]
-
-    Lazy --> Instantiate[instantiateExecutionStack]
-    Lazy --> Bind["Resolve binding: path or :memory:"]
-    Bind --> DB["DatabaseSync via node:sqlite"]
-    Lazy --> Runtime[createRuntime]
-
-    Runtime --> Target["@prisma-next/target-sqlite"]
-    Runtime --> Adapter["@prisma-next/adapter-sqlite"]
-    Runtime --> Driver["@prisma-next/driver-sqlite"]
-    Runtime --> SqlRuntime["@prisma-next/sql-runtime"]
-    Runtime --> ExecPlane["@prisma-next/framework-components/execution"]
+```typescript
+import { defineContract, field, model } from '@prisma-next/sqlite/contract-builder';
+
+export default defineContract({
+  models: {
+    User: model('User', { fields: { id: field.id.uuidv4() } }),
+  },
+});
 ```
 
+### `@prisma-next/sqlite/control`
+
+Control-plane client factory. Collapses the family + target + adapter + driver wiring into a single call.
+
+```typescript
+import { createSqliteControlClient } from '@prisma-next/sqlite/control';
+
+const control = createSqliteControlClient({
+  connection: 'path/to/app.db',
+});
+await control.dbUpdate({ migrations: { dir: 'migrations/app' } });
+```
+
+### `@prisma-next/sqlite/migration`
+
+Re-exports all migration operation helpers from `@prisma-next/target-sqlite/migration` (`Migration`, `MigrationCLI`, `createTable`, `addColumn`, `dropTable`, `createIndex`, `dropIndex`, `dropColumn`, `recreateTable`, `dataTransform`, `placeholder`, `rawSql`).
+
+### `@prisma-next/sqlite/runtime`
+
+Composes the SQLite execution stack and returns typed query roots (`db.sql`, `db.orm`, `db.context`, `db.stack`).
+
+## Dependencies
+
+This package bundles all the transitive dependencies needed for a SQLite Prisma Next project:
+
+- `@prisma-next/target-sqlite` (target descriptor + migration surface)
+- `@prisma-next/adapter-sqlite` (adapter descriptor)
+- `@prisma-next/driver-sqlite` (driver descriptor)
+- `@prisma-next/sql-contract-ts` (TypeScript contract authoring)
+- `@prisma-next/sql-contract` (contract type definitions)
+
 ## Related Docs
 
 - Architecture: `docs/Architecture Overview.md`

package/dist/config.d.mts

@@ -0,0 +1,18 @@
+import { PrismaNextConfig } from "@prisma-next/config/config-types";
+import { ControlExtensionDescriptor } from "@prisma-next/framework-components/control";
+
+//#region src/config/define-config.d.ts
+interface SqliteConfigOptions {
+  readonly contract: string;
+  readonly db?: {
+    readonly connection?: string;
+  };
+  readonly extensions?: readonly ControlExtensionDescriptor<'sql', 'sqlite'>[];
+  readonly migrations?: {
+    readonly dir?: string;
+  };
+}
+declare function defineConfig(options: SqliteConfigOptions): PrismaNextConfig<'sql', 'sqlite'>;
+//#endregion
+export { type SqliteConfigOptions, defineConfig };
+//# sourceMappingURL=config.d.mts.map

package/dist/config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.mts","names":[],"sources":["../src/config/define-config.ts"],"mappings":";;;;UAYiB,mBAAA;EAAA,SACN,QAAA;EAAA,SACA,EAAA;IAAA,SACE,UAAA;EAAA;EAAA,SAEF,UAAA,YAAsB,0BAAA;EAAA,SACtB,UAAA;IAAA,SACE,GAAA;EAAA;AAAA;AAAA,iBAYG,YAAA,CAAa,OAAA,EAAS,mBAAA,GAAsB,gBAAA"}

package/dist/config.mjs

@@ -0,0 +1,36 @@
+import sqliteAdapter from "@prisma-next/adapter-sqlite/control";
+import { defineConfig as defineConfig$1 } from "@prisma-next/config/config-types";
+import sqliteDriver from "@prisma-next/driver-sqlite/control";
+import sql from "@prisma-next/family-sql/control";
+import { prismaContract } from "@prisma-next/sql-contract-psl/provider";
+import { typescriptContractFromPath } from "@prisma-next/sql-contract-ts/config-types";
+import sqlite from "@prisma-next/target-sqlite/control";
+import { ifDefined } from "@prisma-next/utils/defined";
+import { extname } from "pathe";
+//#region src/config/define-config.ts
+function deriveOutputPath(contractPath) {
+	const ext = extname(contractPath);
+	if (ext.length === 0) return `${contractPath}.json`;
+	return `${contractPath.slice(0, -ext.length)}.json`;
+}
+function defineConfig(options) {
+	const extensions = options.extensions ?? [];
+	const output = deriveOutputPath(options.contract);
+	return defineConfig$1({
+		family: sql,
+		target: sqlite,
+		adapter: sqliteAdapter,
+		driver: sqliteDriver,
+		extensionPacks: extensions,
+		contract: extname(options.contract) === ".ts" ? typescriptContractFromPath(options.contract, output) : prismaContract(options.contract, {
+			output,
+			target: sqlite
+		}),
+		...ifDefined("db", options.db),
+		...ifDefined("migrations", options.migrations)
+	});
+}
+//#endregion
+export { defineConfig };
+
+//# sourceMappingURL=config.mjs.map

package/dist/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mjs","names":["coreDefineConfig"],"sources":["../src/config/define-config.ts"],"sourcesContent":["import sqliteAdapter from '@prisma-next/adapter-sqlite/control';\nimport type { PrismaNextConfig } from '@prisma-next/config/config-types';\nimport { defineConfig as coreDefineConfig } from '@prisma-next/config/config-types';\nimport sqliteDriver from '@prisma-next/driver-sqlite/control';\nimport sql from '@prisma-next/family-sql/control';\nimport type { ControlExtensionDescriptor } from '@prisma-next/framework-components/control';\nimport { prismaContract } from '@prisma-next/sql-contract-psl/provider';\nimport { typescriptContractFromPath } from '@prisma-next/sql-contract-ts/config-types';\nimport sqlite from '@prisma-next/target-sqlite/control';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { extname } from 'pathe';\n\nexport interface SqliteConfigOptions {\n  readonly contract: string;\n  readonly db?: {\n    readonly connection?: string;\n  };\n  readonly extensions?: readonly ControlExtensionDescriptor<'sql', 'sqlite'>[];\n  readonly migrations?: {\n    readonly dir?: string;\n  };\n}\n\nfunction deriveOutputPath(contractPath: string): string {\n  const ext = extname(contractPath);\n  if (ext.length === 0) {\n    return `${contractPath}.json`;\n  }\n  return `${contractPath.slice(0, -ext.length)}.json`;\n}\n\nexport function defineConfig(options: SqliteConfigOptions): PrismaNextConfig<'sql', 'sqlite'> {\n  const extensions = options.extensions ?? [];\n  const output = deriveOutputPath(options.contract);\n  const ext = extname(options.contract);\n\n  const contractConfig =\n    ext === '.ts'\n      ? typescriptContractFromPath(options.contract, output)\n      : prismaContract(options.contract, {\n          output,\n          target: sqlite,\n        });\n\n  return coreDefineConfig({\n    family: sql,\n    target: sqlite,\n    adapter: sqliteAdapter,\n    driver: sqliteDriver,\n    extensionPacks: extensions,\n    contract: contractConfig,\n    ...ifDefined('db', options.db),\n    ...ifDefined('migrations', options.migrations),\n  });\n}\n"],"mappings":";;;;;;;;;;AAuBA,SAAS,iBAAiB,cAA8B;CACtD,MAAM,MAAM,QAAQ,aAAa;CACjC,IAAI,IAAI,WAAW,GACjB,OAAO,GAAG,aAAa;CAEzB,OAAO,GAAG,aAAa,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC;;AAG/C,SAAgB,aAAa,SAAiE;CAC5F,MAAM,aAAa,QAAQ,cAAc,EAAE;CAC3C,MAAM,SAAS,iBAAiB,QAAQ,SAAS;CAWjD,OAAOA,eAAiB;EACtB,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,QAAQ;EACR,gBAAgB;EAChB,UAhBU,QAAQ,QAAQ,SAGvB,KAAK,QACJ,2BAA2B,QAAQ,UAAU,OAAO,GACpD,eAAe,QAAQ,UAAU;GAC/B;GACA,QAAQ;GACT,CAAC;EASN,GAAG,UAAU,MAAM,QAAQ,GAAG;EAC9B,GAAG,UAAU,cAAc,QAAQ,WAAW;EAC/C,CAAC"}

package/dist/contract-builder.d.mts

@@ -0,0 +1,29 @@
+import { ComposedAuthoringHelpers, ComposedAuthoringHelpers as ComposedAuthoringHelpers$1, ContractDefinition, ContractInput, ContractInput as ContractInput$1, ContractModelBuilder, FieldNode, ForeignKeyNode, IndexNode, ModelLike, ModelLike as ModelLike$1, ModelNode, PrimaryKeyNode, RelationNode, ScalarFieldBuilder, UniqueConstraintNode, defineContract as defineContract$1, field, model, rel } from "@prisma-next/sql-contract-ts/contract-builder";
+import sqlFamilyPack from "@prisma-next/family-sql/pack";
+import sqlitePack from "@prisma-next/target-sqlite/pack";
+import { ExtensionPackRef } from "@prisma-next/framework-components/components";
+import { StorageTypeInstance } from "@prisma-next/sql-contract/types";
+
+//#region src/contract/define-contract.d.ts
+type SqlFamily = typeof sqlFamilyPack;
+type SqlitePack = typeof sqlitePack;
+type TypesConstraint = Record<string, StorageTypeInstance>;
+type ModelsConstraint = Record<string, ModelLike$1>;
+type SqliteResult<Types extends TypesConstraint, Models extends ModelsConstraint, ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined, Capabilities extends Record<string, Record<string, boolean>> | undefined> = Omit<ReturnType<typeof defineContract$1<SqlFamily, SqlitePack, Types, Models, ExtensionPacks, Capabilities>>, 'target' | 'targetFamily'> & {
+  readonly target: SqlitePack['targetId'];
+  readonly targetFamily: SqlFamily['familyId'];
+};
+type SqliteBaseScaffold<ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined, Capabilities extends Record<string, Record<string, boolean>> | undefined> = Omit<ContractInput$1<SqlFamily, SqlitePack, Record<never, never>, Record<never, never>, ExtensionPacks, Capabilities>, 'family' | 'target' | 'types' | 'models'>;
+type SqliteDefinition<Types extends TypesConstraint, Models extends ModelsConstraint, ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined, Capabilities extends Record<string, Record<string, boolean>> | undefined> = SqliteBaseScaffold<ExtensionPacks, Capabilities> & {
+  readonly types?: Types;
+  readonly models?: Models;
+};
+type SqliteScaffold<ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined, Capabilities extends Record<string, Record<string, boolean>> | undefined> = SqliteBaseScaffold<ExtensionPacks, Capabilities>;
+declare function defineContract<const Types extends TypesConstraint = Record<never, never>, const Models extends ModelsConstraint = Record<never, never>, const ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined = undefined, const Capabilities extends Record<string, Record<string, boolean>> | undefined = undefined>(definition: SqliteDefinition<Types, Models, ExtensionPacks, Capabilities>): SqliteResult<Types, Models, ExtensionPacks, Capabilities>;
+declare function defineContract<const Types extends TypesConstraint = Record<never, never>, const Models extends ModelsConstraint = Record<never, never>, const ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined = undefined, const Capabilities extends Record<string, Record<string, boolean>> | undefined = undefined>(scaffold: SqliteScaffold<ExtensionPacks, Capabilities>, factory: (helpers: ComposedAuthoringHelpers$1<SqlFamily, SqlitePack, ExtensionPacks>) => {
+  readonly types?: Types;
+  readonly models?: Models;
+}): SqliteResult<Types, Models, ExtensionPacks, Capabilities>;
+//#endregion
+export { type ComposedAuthoringHelpers, type ContractDefinition, type ContractInput, type ContractModelBuilder, type FieldNode, type ForeignKeyNode, type IndexNode, type ModelLike, type ModelNode, type PrimaryKeyNode, type RelationNode, type ScalarFieldBuilder, type UniqueConstraintNode, defineContract, field, model, rel };
+//# sourceMappingURL=contract-builder.d.mts.map

package/dist/contract-builder.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-builder.d.mts","names":[],"sources":["../src/contract/define-contract.ts"],"mappings":";;;;;;;KAWK,SAAA,UAAmB,aAAA;AAAA,KACnB,UAAA,UAAoB,UAAA;AAAA,KAEpB,eAAA,GAAkB,MAAA,SAAe,mBAAA;AAAA,KACjC,gBAAA,GAAmB,MAAA,SAAe,WAAA;AAAA,KAMlC,YAAA,eACW,eAAA,iBACC,gBAAA,yBACQ,MAAA,SAAe,gBAAA,mDACjB,MAAA,SAAe,MAAA,kCAClC,IAAA,CACF,UAAA,QACS,gBAAA,CAAmB,SAAA,EAAW,UAAA,EAAY,KAAA,EAAO,MAAA,EAAQ,cAAA,EAAgB,YAAA;EAAA,SAIzE,MAAA,EAAQ,UAAA;EAAA,SACR,YAAA,EAAc,SAAA;AAAA;AAAA,KAMpB,kBAAA,wBACoB,MAAA,SAAe,gBAAA,mDACjB,MAAA,SAAe,MAAA,kCAClC,IAAA,CACF,eAAA,CACE,SAAA,EACA,UAAA,EACA,MAAA,gBACA,MAAA,gBACA,cAAA,EACA,YAAA;AAAA,KAMC,gBAAA,eACW,eAAA,iBACC,gBAAA,yBACQ,MAAA,SAAe,gBAAA,mDACjB,MAAA,SAAe,MAAA,kCAClC,kBAAA,CAAmB,cAAA,EAAgB,YAAA;EAAA,SAC5B,KAAA,GAAQ,KAAA;EAAA,SACR,MAAA,GAAS,MAAA;AAAA;AAAA,KAIf,cAAA,wBACoB,MAAA,SAAe,gBAAA,mDACjB,MAAA,SAAe,MAAA,kCAClC,kBAAA,CAAmB,cAAA,EAAgB,YAAA;AAAA,iBAGvB,cAAA,qBACM,eAAA,GAAkB,MAAA,qCACjB,gBAAA,GAAmB,MAAA,6CAEpC,MAAA,SAAe,gBAAA,qEAEQ,MAAA,SAAe,MAAA,2CAAA,CAE1C,UAAA,EAAY,gBAAA,CAAiB,KAAA,EAAO,MAAA,EAAQ,cAAA,EAAgB,YAAA,IAC3D,YAAA,CAAa,KAAA,EAAO,MAAA,EAAQ,cAAA,EAAgB,YAAA;AAAA,iBAG/B,cAAA,qBACM,eAAA,GAAkB,MAAA,qCACjB,gBAAA,GAAmB,MAAA,6CAEpC,MAAA,SAAe,gBAAA,qEAEQ,MAAA,SAAe,MAAA,2CAAA,CAE1C,QAAA,EAAU,cAAA,CAAe,cAAA,EAAgB,YAAA,GACzC,OAAA,GAAU,OAAA,EAAS,0BAAA,CAAyB,SAAA,EAAW,UAAA,EAAY,cAAA;EAAA,SACxD,KAAA,GAAQ,KAAA;EAAA,SACR,MAAA,GAAS,MAAA;AAAA,IAEnB,YAAA,CAAa,KAAA,EAAO,MAAA,EAAQ,cAAA,EAAgB,YAAA"}

package/dist/contract-builder.mjs

@@ -0,0 +1,17 @@
+import { defineContract as defineContract$1, field, model, rel } from "@prisma-next/sql-contract-ts/contract-builder";
+import sqlFamilyPack from "@prisma-next/family-sql/pack";
+import sqlitePack from "@prisma-next/target-sqlite/pack";
+//#region src/contract/define-contract.ts
+function defineContract(scaffold, factory) {
+	const full = {
+		...scaffold,
+		family: sqlFamilyPack,
+		target: sqlitePack
+	};
+	if (factory !== void 0) return defineContract$1(full, factory);
+	return defineContract$1(full);
+}
+//#endregion
+export { defineContract, field, model, rel };
+
+//# sourceMappingURL=contract-builder.mjs.map

package/dist/contract-builder.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-builder.mjs","names":["baseDefineContract"],"sources":["../src/contract/define-contract.ts"],"sourcesContent":["import sqlFamilyPack from '@prisma-next/family-sql/pack';\nimport type { ExtensionPackRef } from '@prisma-next/framework-components/components';\nimport type { StorageTypeInstance } from '@prisma-next/sql-contract/types';\nimport type {\n  ComposedAuthoringHelpers,\n  ContractInput,\n  ModelLike,\n} from '@prisma-next/sql-contract-ts/contract-builder';\nimport { defineContract as baseDefineContract } from '@prisma-next/sql-contract-ts/contract-builder';\nimport sqlitePack from '@prisma-next/target-sqlite/pack';\n\ntype SqlFamily = typeof sqlFamilyPack;\ntype SqlitePack = typeof sqlitePack;\n\ntype TypesConstraint = Record<string, StorageTypeInstance>;\ntype ModelsConstraint = Record<string, ModelLike>;\n\n// Return type threaded with all inferred type params.\n// We override target/targetFamily via intersection to preserve the literal values\n// ('sqlite', 'sql') even when TypeScript defers conditional-type evaluation on\n// unresolved generic params.\ntype SqliteResult<\n  Types extends TypesConstraint,\n  Models extends ModelsConstraint,\n  ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined,\n  Capabilities extends Record<string, Record<string, boolean>> | undefined,\n> = Omit<\n  ReturnType<\n    typeof baseDefineContract<SqlFamily, SqlitePack, Types, Models, ExtensionPacks, Capabilities>\n  >,\n  'target' | 'targetFamily'\n> & {\n  readonly target: SqlitePack['targetId'];\n  readonly targetFamily: SqlFamily['familyId'];\n};\n\n// Scaffold that carries all ContractInput fields EXCEPT family, target, types, models.\n// Built from ContractInput with concrete Record<never, never> defaults to avoid\n// the ContractInput Models constraint (which requires ContractModelBuilder, not ModelLike).\ntype SqliteBaseScaffold<\n  ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined,\n  Capabilities extends Record<string, Record<string, boolean>> | undefined,\n> = Omit<\n  ContractInput<\n    SqlFamily,\n    SqlitePack,\n    Record<never, never>,\n    Record<never, never>,\n    ExtensionPacks,\n    Capabilities\n  >,\n  'family' | 'target' | 'types' | 'models'\n>;\n\n// Definition form: inline types + models (uses ModelLike for models, not ContractModelBuilder)\ntype SqliteDefinition<\n  Types extends TypesConstraint,\n  Models extends ModelsConstraint,\n  ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined,\n  Capabilities extends Record<string, Record<string, boolean>> | undefined,\n> = SqliteBaseScaffold<ExtensionPacks, Capabilities> & {\n  readonly types?: Types;\n  readonly models?: Models;\n};\n\n// Factory form: scaffold without types/models (factory provides them)\ntype SqliteScaffold<\n  ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined,\n  Capabilities extends Record<string, Record<string, boolean>> | undefined,\n> = SqliteBaseScaffold<ExtensionPacks, Capabilities>;\n\n// Overload 1: definition form (models/types inline in scaffold)\nexport function defineContract<\n  const Types extends TypesConstraint = Record<never, never>,\n  const Models extends ModelsConstraint = Record<never, never>,\n  const ExtensionPacks extends\n    | Record<string, ExtensionPackRef<'sql', string>>\n    | undefined = undefined,\n  const Capabilities extends Record<string, Record<string, boolean>> | undefined = undefined,\n>(\n  definition: SqliteDefinition<Types, Models, ExtensionPacks, Capabilities>,\n): SqliteResult<Types, Models, ExtensionPacks, Capabilities>;\n\n// Overload 2: factory form (scaffold without models/types; factory provides them)\nexport function defineContract<\n  const Types extends TypesConstraint = Record<never, never>,\n  const Models extends ModelsConstraint = Record<never, never>,\n  const ExtensionPacks extends\n    | Record<string, ExtensionPackRef<'sql', string>>\n    | undefined = undefined,\n  const Capabilities extends Record<string, Record<string, boolean>> | undefined = undefined,\n>(\n  scaffold: SqliteScaffold<ExtensionPacks, Capabilities>,\n  factory: (helpers: ComposedAuthoringHelpers<SqlFamily, SqlitePack, ExtensionPacks>) => {\n    readonly types?: Types;\n    readonly models?: Models;\n  },\n): SqliteResult<Types, Models, ExtensionPacks, Capabilities>;\n\n// Implementation — the runtime type is richer than the wide impl signature;\n// as unknown is safe because every declared overload produces a SqliteResult.\nexport function defineContract(\n  scaffold: Omit<ContractInput, 'family' | 'target'>,\n  factory?: (helpers: ComposedAuthoringHelpers<SqlFamily, SqlitePack, undefined>) => {\n    readonly types?: TypesConstraint;\n    readonly models?: ModelsConstraint;\n  },\n): SqliteResult<TypesConstraint, ModelsConstraint, undefined, undefined> {\n  const full = {\n    ...scaffold,\n    family: sqlFamilyPack,\n    target: sqlitePack,\n  } as ContractInput;\n  if (factory !== undefined) {\n    return baseDefineContract(\n      full,\n      factory as Parameters<typeof baseDefineContract>[1],\n    ) as unknown as SqliteResult<TypesConstraint, ModelsConstraint, undefined, undefined>;\n  }\n  return baseDefineContract(full) as unknown as SqliteResult<\n    TypesConstraint,\n    ModelsConstraint,\n    undefined,\n    undefined\n  >;\n}\n"],"mappings":";;;;AAqGA,SAAgB,eACd,UACA,SAIuE;CACvE,MAAM,OAAO;EACX,GAAG;EACH,QAAQ;EACR,QAAQ;EACT;CACD,IAAI,YAAY,KAAA,GACd,OAAOA,iBACL,MACA,QACD;CAEH,OAAOA,iBAAmB,KAAK"}

package/dist/control.d.mts

@@ -0,0 +1,11 @@
+import { ControlClient, ControlClientOptions } from "@prisma-next/cli/control-api";
+
+//#region src/exports/control.d.ts
+interface SqliteControlClientOptions {
+  readonly connection?: string;
+  readonly extensionPacks?: ControlClientOptions['extensionPacks'];
+}
+declare function createSqliteControlClient(options?: SqliteControlClientOptions): ControlClient;
+//#endregion
+export { type ControlClient, SqliteControlClientOptions, createSqliteControlClient };
+//# sourceMappingURL=control.d.mts.map

package/dist/control.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.mts","names":[],"sources":["../src/exports/control.ts"],"mappings":";;;UAWiB,0BAAA;EAAA,SACN,UAAA;EAAA,SACA,cAAA,GAAiB,oBAAA;AAAA;AAAA,iBAGZ,yBAAA,CAA0B,OAAA,GAAS,0BAAA,GAAkC,aAAA"}

package/dist/control.mjs

@@ -0,0 +1,21 @@
+import sqliteAdapter from "@prisma-next/adapter-sqlite/control";
+import sqliteDriver from "@prisma-next/driver-sqlite/control";
+import sql from "@prisma-next/family-sql/control";
+import sqlite from "@prisma-next/target-sqlite/control";
+import { ifDefined } from "@prisma-next/utils/defined";
+import { createControlClient } from "@prisma-next/cli/control-api";
+//#region src/exports/control.ts
+function createSqliteControlClient(options = {}) {
+	return createControlClient({
+		family: sql,
+		target: sqlite,
+		adapter: sqliteAdapter,
+		driver: sqliteDriver,
+		...ifDefined("connection", options.connection),
+		...ifDefined("extensionPacks", options.extensionPacks)
+	});
+}
+//#endregion
+export { createSqliteControlClient };
+
+//# sourceMappingURL=control.mjs.map

package/dist/control.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.mjs","names":[],"sources":["../src/exports/control.ts"],"sourcesContent":["import sqliteAdapter from '@prisma-next/adapter-sqlite/control';\nimport {\n  type ControlClient,\n  type ControlClientOptions,\n  createControlClient,\n} from '@prisma-next/cli/control-api';\nimport sqliteDriver from '@prisma-next/driver-sqlite/control';\nimport sql from '@prisma-next/family-sql/control';\nimport sqlite from '@prisma-next/target-sqlite/control';\nimport { ifDefined } from '@prisma-next/utils/defined';\n\nexport interface SqliteControlClientOptions {\n  readonly connection?: string;\n  readonly extensionPacks?: ControlClientOptions['extensionPacks'];\n}\n\nexport function createSqliteControlClient(options: SqliteControlClientOptions = {}): ControlClient {\n  const clientOptions: ControlClientOptions = {\n    family: sql,\n    target: sqlite,\n    adapter: sqliteAdapter,\n    driver: sqliteDriver,\n    ...ifDefined('connection', options.connection),\n    ...ifDefined('extensionPacks', options.extensionPacks),\n  };\n  return createControlClient(clientOptions);\n}\n\nexport type { ControlClient };\n"],"mappings":";;;;;;;AAgBA,SAAgB,0BAA0B,UAAsC,EAAE,EAAiB;CASjG,OAAO,oBAAoB;EAPzB,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,QAAQ;EACR,GAAG,UAAU,cAAc,QAAQ,WAAW;EAC9C,GAAG,UAAU,kBAAkB,QAAQ,eAAe;EAEhB,CAAC"}

package/dist/migration.d.mts

@@ -0,0 +1 @@
+export * from "@prisma-next/target-sqlite/migration";

package/dist/migration.mjs

@@ -0,0 +1,2 @@
+export * from "@prisma-next/target-sqlite/migration";
+export {};

package/dist/runtime.d.mts

@@ -1,8 +1,8 @@
 import { orm } from "@prisma-next/sql-orm-client";
 import { BindSiteParams, Declaration, ExecutionContext, ParamsFromDeclaration, PreparedStatement, Runtime, RuntimeVerifyOptions, SqlExecutionStackWithDriver, SqlMiddleware, SqlRuntimeExtensionDescriptor } 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";
-import { ExtractCodecTypes, SqlStorage } from "@prisma-next/sql-contract/types";
 import { CodecTypesBase } from "@prisma-next/sql-relational-core/expression";
 import { SqlQueryPlan } from "@prisma-next/sql-relational-core/plan";
 
@@ -24,6 +24,8 @@ 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>>;
+  close(): Promise<void>;
+  [Symbol.asyncDispose](): Promise<void>;
 }
 interface SqliteOptionsBase {
   readonly extensions?: readonly SqlRuntimeExtensionDescriptor<SqliteTargetId>[];

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,IAAA;AAAA;;;KC8BhC,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,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;AAAA;AAAA,UAG5C,iBAAA;EAAA,SACN,UAAA,YAAsB,6BAAA,CAA8B,cAAA;EAAA,SACpD,UAAA,YAAsB,aAAA;EAAA,SACtB,MAAA,GAAS,oBAAA;AAAA;AAAA,KAGR,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,EAAA,CACxD,OAAA,EAAS,yBAAA,CAA0B,SAAA,IAClC,YAAA,CAAa,SAAA;AAAA,iBACQ,MAAA,mBAAyB,QAAA,CAAS,UAAA,EAAA,CACxD,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,IAAA;AAAA;;;KC8BhC,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,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,YAAP,KAAwB,OAAA;AAAA;AAAA,UAGV,iBAAA;EAAA,SACN,UAAA,YAAsB,6BAAA,CAA8B,cAAA;EAAA,SACpD,UAAA,YAAsB,aAAA;EAAA,SACtB,MAAA,GAAS,oBAAA;AAAA;AAAA,KAGR,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,EAAA,CACxD,OAAA,EAAS,yBAAA,CAA0B,SAAA,IAClC,YAAA,CAAa,SAAA;AAAA,iBACQ,MAAA,mBAAyB,QAAA,CAAS,UAAA,EAAA,CACxD,OAAA,EAAS,6BAAA,CAA8B,SAAA,IACtC,YAAA,CAAa,SAAA"}

package/dist/runtime.mjs

@@ -44,7 +44,10 @@ function sqlite(options) {
 	let runtimeDriver;
 	let driverConnected = false;
 	let connectPromise;
+	let closePromise;
 	let backgroundConnectError;
+	let closed = false;
+	let ownedDispose;
 	const connectDriver = async (resolvedBinding) => {
 		if (driverConnected) return;
 		if (!runtimeDriver) throw new Error("SQLite runtime driver missing");
@@ -59,12 +62,14 @@ function sqlite(options) {
 		return connectPromise;
 	};
 	const getRuntime = () => {
+		if (closed) throw new Error("SQLite client is closed");
 		if (backgroundConnectError !== void 0) throw backgroundConnectError;
 		if (runtimeInstance) return runtimeInstance;
 		const stackInstance = instantiateExecutionStack(stack);
 		const driverDescriptor = stack.driver;
 		if (!driverDescriptor) throw new Error("Driver descriptor missing from execution stack");
 		const driver = driverDescriptor.create();
+		ownedDispose = () => driver.close();
 		runtimeDriver = driver;
 		if (binding !== void 0) connectDriver(binding).catch(() => void 0);
 		runtimeInstance = createRuntime({
@@ -95,6 +100,7 @@ function sqlite(options) {
 		context,
 		stack,
 		async connect(bindingInput) {
+			if (closed) throw new Error("SQLite client is closed");
 			if (driverConnected || connectPromise) throw new Error("SQLite client already connected");
 			backgroundConnectError = void 0;
 			if (bindingInput !== void 0) binding = resolveSqliteBinding(bindingInput);
@@ -109,6 +115,18 @@ function sqlite(options) {
 		},
 		prepare(declaration, callback) {
 			return getRuntime().prepare(declaration, (params) => callback(sql$1, params));
+		},
+		close() {
+			if (closePromise) return closePromise;
+			closed = true;
+			closePromise = (async () => {
+				await connectPromise?.catch(() => void 0);
+				await ownedDispose?.();
+			})();
+			return closePromise;
+		},
+		[Symbol.asyncDispose]() {
+			return this.close();
 		}
 	};
 }

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 } 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  RuntimeVerifyOptions,\n  SqlExecutionStackWithDriver,\n  SqlMiddleware,\n  SqlRuntimeExtensionDescriptor,\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 { 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 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}\n\nexport interface SqliteOptionsBase {\n  readonly extensions?: readonly SqlRuntimeExtensionDescriptor<SqliteTargetId>[];\n  readonly middleware?: readonly SqlMiddleware[];\n  readonly verify?: RuntimeVerifyOptions;\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 sql: Db<TContract> = sqlBuilder<TContract>({ context });\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 backgroundConnectError: unknown;\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 (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    runtimeDriver = driver;\n    if (binding !== undefined) {\n      void connectDriver(binding).catch(() => undefined);\n    }\n\n    runtimeInstance = createRuntime({\n      stackInstance,\n      context,\n      driver,\n      verify: options.verify ?? { mode: 'onFirstUse', requireMarker: false },\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    context,\n    stack,\n    async connect(bindingInput) {\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}\n"],"mappings":";;;;;;;;;AAIA,SAAgB,qBAAqB,OAA0C;CAC7E,OAAO;EAAE,MAAM;EAAQ,MAAM,MAAM;EAAM;;AAG3C,SAAgB,6BAA6B,SAEf;CAC5B,IAAI,QAAQ,SAAS,KAAA,GACnB;CAEF,OAAO;EAAE,MAAM;EAAQ,MAAM,QAAQ;EAAM;;;;AC+D7C,SAAS,gBACP,SACW;CACX,MAAM,gBACJ,kBAAkB,WAAW,QAAQ,iBAAiB,KAAA,IAClD,QAAQ,eACP,QAAiD;CACxD,OAAO,IAAI,uBAAuB,CAAC,oBAAoB,cAAc;;AASvE,SAAwB,OACtB,SACyB;CACzB,MAAM,WAAW,gBAAgB,QAAQ;CACzC,IAAI,UAAU,6BAA6B,QAAQ;CACnD,MAAM,QAAQ,wBAAwB;EACpC,QAAQ;EACR,SAAS;EACT,QAAQ;EACR,gBAAgB,QAAQ,cAAc,EAAE;EACzC,CAAC;CAEF,MAAM,UAAU,uBAAuB;EACrC;EACA;EACD,CAAC;CAEF,MAAMA,QAAqBC,IAAsB,EAAE,SAAS,CAAC;CAC7D,IAAI;CACJ,IAAI;CACJ,IAAI,kBAAkB;CACtB,IAAI;CACJ,IAAI;CAEJ,MAAM,gBAAgB,OAAO,oBAAkD;EAC7E,IAAI,iBAAiB;EACrB,IAAI,CAAC,eAAe,MAAM,IAAI,MAAM,gCAAgC;EACpE,IAAI,gBAAgB,OAAO;EAC3B,iBAAiB,cACd,QAAQ,gBAAgB,CACxB,WAAW;GACV,kBAAkB;IAClB,CACD,OAAO,QAAQ;GACd,yBAAyB;GACzB,iBAAiB,KAAA;GACjB,MAAM;IACN;EACJ,OAAO;;CAGT,MAAM,mBAA4B;EAChC,IAAI,2BAA2B,KAAA,GAC7B,MAAM;EAGR,IAAI,iBACF,OAAO;EAGT,MAAM,gBAAgB,0BAA0B,MAAM;EACtD,MAAM,mBAAmB,MAAM;EAC/B,IAAI,CAAC,kBACH,MAAM,IAAI,MAAM,iDAAiD;EAGnE,MAAM,SAAS,iBAAiB,QAAQ;EACxC,gBAAgB;EAChB,IAAI,YAAY,KAAA,GACd,cAAmB,QAAQ,CAAC,YAAY,KAAA,EAAU;EAGpD,kBAAkB,cAAc;GAC9B;GACA;GACA;GACA,QAAQ,QAAQ,UAAU;IAAE,MAAM;IAAc,eAAe;IAAO;GACtE,GAAI,QAAQ,aAAa,EAAE,YAAY,QAAQ,YAAY,GAAG,EAAE;GACjE,CAAC;EAEF,OAAO;;CAeT,OAAO;EACL,KAAA;EACA,KAdgCC,IAAW;GAC3C;GACA,SAAS;IACP,QAAQ,MAAM;KACZ,OAAO,YAAY,CAAC,QAAQ,KAAK;;IAEnC,aAAa;KACX,OAAO,YAAY,CAAC,YAAY;;IAEnC;GACF,CAII;EACH;EACA;EACA,MAAM,QAAQ,cAAc;GAC1B,IAAI,mBAAmB,gBACrB,MAAM,IAAI,MAAM,kCAAkC;GAGpD,yBAAyB,KAAA;GAEzB,IAAI,iBAAiB,KAAA,GACnB,UAAU,qBAAqB,aAAa;GAG9C,IAAI,YAAY,KAAA,GACd,MAAM,IAAI,MACR,wFACD;GAGH,MAAM,UAAU,YAAY;GAC5B,IAAI,iBACF,OAAO;GAGT,MAAM,cAAc,QAAQ;GAC5B,OAAO;;EAET,UAAU;GACR,OAAO,YAAY;;EAErB,QAKE,aACA,UAC+D;GAC/D,OAAO,YAAY,CAAC,QAAoB,cAAc,WAAW,SAASF,OAAK,OAAO,CAAC;;EAE1F"}
+{"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 } 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  RuntimeVerifyOptions,\n  SqlExecutionStackWithDriver,\n  SqlMiddleware,\n  SqlRuntimeExtensionDescriptor,\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 { 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 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 verify?: RuntimeVerifyOptions;\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 sql: Db<TContract> = sqlBuilder<TContract>({ context });\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      verify: options.verify ?? { mode: 'onFirstUse', requireMarker: false },\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    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":";;;;;;;;;AAIA,SAAgB,qBAAqB,OAA0C;CAC7E,OAAO;EAAE,MAAM;EAAQ,MAAM,MAAM;EAAM;;AAG3C,SAAgB,6BAA6B,SAEf;CAC5B,IAAI,QAAQ,SAAS,KAAA,GACnB;CAEF,OAAO;EAAE,MAAM;EAAQ,MAAM,QAAQ;EAAM;;;;ACiE7C,SAAS,gBACP,SACW;CACX,MAAM,gBACJ,kBAAkB,WAAW,QAAQ,iBAAiB,KAAA,IAClD,QAAQ,eACP,QAAiD;CACxD,OAAO,IAAI,uBAAuB,CAAC,oBAAoB,cAAc;;AASvE,SAAwB,OACtB,SACyB;CACzB,MAAM,WAAW,gBAAgB,QAAQ;CACzC,IAAI,UAAU,6BAA6B,QAAQ;CACnD,MAAM,QAAQ,wBAAwB;EACpC,QAAQ;EACR,SAAS;EACT,QAAQ;EACR,gBAAgB,QAAQ,cAAc,EAAE;EACzC,CAAC;CAEF,MAAM,UAAU,uBAAuB;EACrC;EACA;EACD,CAAC;CAEF,MAAMA,QAAqBC,IAAsB,EAAE,SAAS,CAAC;CAC7D,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,gCAAgC;EACpE,IAAI,gBAAgB,OAAO;EAC3B,iBAAiB,cACd,QAAQ,gBAAgB,CACxB,WAAW;GACV,kBAAkB;IAClB,CACD,OAAO,QAAQ;GACd,yBAAyB;GACzB,iBAAiB,KAAA;GACjB,MAAM;IACN;EACJ,OAAO;;CAGT,MAAM,mBAA4B;EAChC,IAAI,QACF,MAAM,IAAI,MAAM,0BAA0B;EAG5C,IAAI,2BAA2B,KAAA,GAC7B,MAAM;EAGR,IAAI,iBACF,OAAO;EAGT,MAAM,gBAAgB,0BAA0B,MAAM;EACtD,MAAM,mBAAmB,MAAM;EAC/B,IAAI,CAAC,kBACH,MAAM,IAAI,MAAM,iDAAiD;EAGnE,MAAM,SAAS,iBAAiB,QAAQ;EACxC,qBAAqB,OAAO,OAAO;EACnC,gBAAgB;EAChB,IAAI,YAAY,KAAA,GACd,cAAmB,QAAQ,CAAC,YAAY,KAAA,EAAU;EAGpD,kBAAkB,cAAc;GAC9B;GACA;GACA;GACA,QAAQ,QAAQ,UAAU;IAAE,MAAM;IAAc,eAAe;IAAO;GACtE,GAAI,QAAQ,aAAa,EAAE,YAAY,QAAQ,YAAY,GAAG,EAAE;GACjE,CAAC;EAEF,OAAO;;CAeT,OAAO;EACL,KAAA;EACA,KAdgCC,IAAW;GAC3C;GACA,SAAS;IACP,QAAQ,MAAM;KACZ,OAAO,YAAY,CAAC,QAAQ,KAAK;;IAEnC,aAAa;KACX,OAAO,YAAY,CAAC,YAAY;;IAEnC;GACF,CAII;EACH;EACA;EACA,MAAM,QAAQ,cAAc;GAC1B,IAAI,QACF,MAAM,IAAI,MAAM,0BAA0B;GAG5C,IAAI,mBAAmB,gBACrB,MAAM,IAAI,MAAM,kCAAkC;GAGpD,yBAAyB,KAAA;GAEzB,IAAI,iBAAiB,KAAA,GACnB,UAAU,qBAAqB,aAAa;GAG9C,IAAI,YAAY,KAAA,GACd,MAAM,IAAI,MACR,wFACD;GAGH,MAAM,UAAU,YAAY;GAC5B,IAAI,iBACF,OAAO;GAGT,MAAM,cAAc,QAAQ;GAC5B,OAAO;;EAET,UAAU;GACR,OAAO,YAAY;;EAErB,QAKE,aACA,UAC+D;GAC/D,OAAO,YAAY,CAAC,QAAoB,cAAc,WAAW,SAASF,OAAK,OAAO,CAAC;;EAGzF,QAAuB;GACrB,IAAI,cAAc,OAAO;GACzB,SAAS;GACT,gBAAgB,YAAY;IAC1B,MAAM,gBAAgB,YAAY,KAAA,EAAU;IAC5C,MAAM,gBAAgB;OACpB;GACJ,OAAO;;EAGT,CAAC,OAAO,gBAA+B;GACrC,OAAO,KAAK,OAAO;;EAEtB"}

package/package.json

@@ -1,27 +1,33 @@
 {
   "name": "@prisma-next/sqlite",
-  "version": "0.10.0-dev.9",
+  "version": "0.11.0",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
   "description": "One-liner lazy SQLite client composition for Prisma Next",
   "dependencies": {
-    "@prisma-next/adapter-sqlite": "0.10.0-dev.9",
-    "@prisma-next/contract": "0.10.0-dev.9",
-    "@prisma-next/driver-sqlite": "0.10.0-dev.9",
-    "@prisma-next/family-sql": "0.10.0-dev.9",
-    "@prisma-next/framework-components": "0.10.0-dev.9",
-    "@prisma-next/sql-builder": "0.10.0-dev.9",
-    "@prisma-next/sql-contract": "0.10.0-dev.9",
-    "@prisma-next/sql-orm-client": "0.10.0-dev.9",
-    "@prisma-next/sql-relational-core": "0.10.0-dev.9",
-    "@prisma-next/sql-runtime": "0.10.0-dev.9",
-    "@prisma-next/target-sqlite": "0.10.0-dev.9"
+    "@prisma-next/adapter-sqlite": "0.11.0",
+    "@prisma-next/cli": "0.11.0",
+    "@prisma-next/config": "0.11.0",
+    "@prisma-next/contract": "0.11.0",
+    "@prisma-next/driver-sqlite": "0.11.0",
+    "@prisma-next/family-sql": "0.11.0",
+    "@prisma-next/framework-components": "0.11.0",
+    "@prisma-next/sql-builder": "0.11.0",
+    "@prisma-next/sql-contract": "0.11.0",
+    "@prisma-next/sql-contract-psl": "0.11.0",
+    "@prisma-next/sql-contract-ts": "0.11.0",
+    "@prisma-next/sql-orm-client": "0.11.0",
+    "@prisma-next/sql-relational-core": "0.11.0",
+    "@prisma-next/sql-runtime": "0.11.0",
+    "@prisma-next/target-sqlite": "0.11.0",
+    "@prisma-next/utils": "0.11.0",
+    "pathe": "^2.0.3"
   },
   "devDependencies": {
-    "@prisma-next/test-utils": "0.10.0-dev.9",
-    "@prisma-next/tsconfig": "0.10.0-dev.9",
-    "@prisma-next/tsdown": "0.10.0-dev.9",
+    "@prisma-next/test-utils": "0.11.0",
+    "@prisma-next/tsconfig": "0.11.0",
+    "@prisma-next/tsdown": "0.11.0",
     "tsdown": "0.22.0",
     "typescript": "5.9.3",
     "vitest": "4.1.6"
@@ -36,6 +42,10 @@
     "directory": "packages/3-extensions/sqlite"
   },
   "exports": {
+    "./config": "./dist/config.mjs",
+    "./contract-builder": "./dist/contract-builder.mjs",
+    "./control": "./dist/control.mjs",
+    "./migration": "./dist/migration.mjs",
     "./runtime": "./dist/runtime.mjs",
     "./package.json": "./package.json"
   },

package/src/config/define-config.ts

@@ -0,0 +1,55 @@
+import sqliteAdapter from '@prisma-next/adapter-sqlite/control';
+import type { PrismaNextConfig } from '@prisma-next/config/config-types';
+import { defineConfig as coreDefineConfig } from '@prisma-next/config/config-types';
+import sqliteDriver from '@prisma-next/driver-sqlite/control';
+import sql from '@prisma-next/family-sql/control';
+import type { ControlExtensionDescriptor } from '@prisma-next/framework-components/control';
+import { prismaContract } from '@prisma-next/sql-contract-psl/provider';
+import { typescriptContractFromPath } from '@prisma-next/sql-contract-ts/config-types';
+import sqlite from '@prisma-next/target-sqlite/control';
+import { ifDefined } from '@prisma-next/utils/defined';
+import { extname } from 'pathe';
+
+export interface SqliteConfigOptions {
+  readonly contract: string;
+  readonly db?: {
+    readonly connection?: string;
+  };
+  readonly extensions?: readonly ControlExtensionDescriptor<'sql', 'sqlite'>[];
+  readonly migrations?: {
+    readonly dir?: string;
+  };
+}
+
+function deriveOutputPath(contractPath: string): string {
+  const ext = extname(contractPath);
+  if (ext.length === 0) {
+    return `${contractPath}.json`;
+  }
+  return `${contractPath.slice(0, -ext.length)}.json`;
+}
+
+export function defineConfig(options: SqliteConfigOptions): PrismaNextConfig<'sql', 'sqlite'> {
+  const extensions = options.extensions ?? [];
+  const output = deriveOutputPath(options.contract);
+  const ext = extname(options.contract);
+
+  const contractConfig =
+    ext === '.ts'
+      ? typescriptContractFromPath(options.contract, output)
+      : prismaContract(options.contract, {
+          output,
+          target: sqlite,
+        });
+
+  return coreDefineConfig({
+    family: sql,
+    target: sqlite,
+    adapter: sqliteAdapter,
+    driver: sqliteDriver,
+    extensionPacks: extensions,
+    contract: contractConfig,
+    ...ifDefined('db', options.db),
+    ...ifDefined('migrations', options.migrations),
+  });
+}

package/src/contract/define-contract.ts

@@ -0,0 +1,126 @@
+import sqlFamilyPack from '@prisma-next/family-sql/pack';
+import type { ExtensionPackRef } from '@prisma-next/framework-components/components';
+import type { StorageTypeInstance } from '@prisma-next/sql-contract/types';
+import type {
+  ComposedAuthoringHelpers,
+  ContractInput,
+  ModelLike,
+} from '@prisma-next/sql-contract-ts/contract-builder';
+import { defineContract as baseDefineContract } from '@prisma-next/sql-contract-ts/contract-builder';
+import sqlitePack from '@prisma-next/target-sqlite/pack';
+
+type SqlFamily = typeof sqlFamilyPack;
+type SqlitePack = typeof sqlitePack;
+
+type TypesConstraint = Record<string, StorageTypeInstance>;
+type ModelsConstraint = Record<string, ModelLike>;
+
+// Return type threaded with all inferred type params.
+// We override target/targetFamily via intersection to preserve the literal values
+// ('sqlite', 'sql') even when TypeScript defers conditional-type evaluation on
+// unresolved generic params.
+type SqliteResult<
+  Types extends TypesConstraint,
+  Models extends ModelsConstraint,
+  ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined,
+  Capabilities extends Record<string, Record<string, boolean>> | undefined,
+> = Omit<
+  ReturnType<
+    typeof baseDefineContract<SqlFamily, SqlitePack, Types, Models, ExtensionPacks, Capabilities>
+  >,
+  'target' | 'targetFamily'
+> & {
+  readonly target: SqlitePack['targetId'];
+  readonly targetFamily: SqlFamily['familyId'];
+};
+
+// Scaffold that carries all ContractInput fields EXCEPT family, target, types, models.
+// Built from ContractInput with concrete Record<never, never> defaults to avoid
+// the ContractInput Models constraint (which requires ContractModelBuilder, not ModelLike).
+type SqliteBaseScaffold<
+  ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined,
+  Capabilities extends Record<string, Record<string, boolean>> | undefined,
+> = Omit<
+  ContractInput<
+    SqlFamily,
+    SqlitePack,
+    Record<never, never>,
+    Record<never, never>,
+    ExtensionPacks,
+    Capabilities
+  >,
+  'family' | 'target' | 'types' | 'models'
+>;
+
+// Definition form: inline types + models (uses ModelLike for models, not ContractModelBuilder)
+type SqliteDefinition<
+  Types extends TypesConstraint,
+  Models extends ModelsConstraint,
+  ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined,
+  Capabilities extends Record<string, Record<string, boolean>> | undefined,
+> = SqliteBaseScaffold<ExtensionPacks, Capabilities> & {
+  readonly types?: Types;
+  readonly models?: Models;
+};
+
+// Factory form: scaffold without types/models (factory provides them)
+type SqliteScaffold<
+  ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined,
+  Capabilities extends Record<string, Record<string, boolean>> | undefined,
+> = SqliteBaseScaffold<ExtensionPacks, Capabilities>;
+
+// Overload 1: definition form (models/types inline in scaffold)
+export function defineContract<
+  const Types extends TypesConstraint = Record<never, never>,
+  const Models extends ModelsConstraint = Record<never, never>,
+  const ExtensionPacks extends
+    | Record<string, ExtensionPackRef<'sql', string>>
+    | undefined = undefined,
+  const Capabilities extends Record<string, Record<string, boolean>> | undefined = undefined,
+>(
+  definition: SqliteDefinition<Types, Models, ExtensionPacks, Capabilities>,
+): SqliteResult<Types, Models, ExtensionPacks, Capabilities>;
+
+// Overload 2: factory form (scaffold without models/types; factory provides them)
+export function defineContract<
+  const Types extends TypesConstraint = Record<never, never>,
+  const Models extends ModelsConstraint = Record<never, never>,
+  const ExtensionPacks extends
+    | Record<string, ExtensionPackRef<'sql', string>>
+    | undefined = undefined,
+  const Capabilities extends Record<string, Record<string, boolean>> | undefined = undefined,
+>(
+  scaffold: SqliteScaffold<ExtensionPacks, Capabilities>,
+  factory: (helpers: ComposedAuthoringHelpers<SqlFamily, SqlitePack, ExtensionPacks>) => {
+    readonly types?: Types;
+    readonly models?: Models;
+  },
+): SqliteResult<Types, Models, ExtensionPacks, Capabilities>;
+
+// Implementation — the runtime type is richer than the wide impl signature;
+// as unknown is safe because every declared overload produces a SqliteResult.
+export function defineContract(
+  scaffold: Omit<ContractInput, 'family' | 'target'>,
+  factory?: (helpers: ComposedAuthoringHelpers<SqlFamily, SqlitePack, undefined>) => {
+    readonly types?: TypesConstraint;
+    readonly models?: ModelsConstraint;
+  },
+): SqliteResult<TypesConstraint, ModelsConstraint, undefined, undefined> {
+  const full = {
+    ...scaffold,
+    family: sqlFamilyPack,
+    target: sqlitePack,
+  } as ContractInput;
+  if (factory !== undefined) {
+    return baseDefineContract(
+      full,
+      factory as Parameters<typeof baseDefineContract>[1],
+    ) as unknown as SqliteResult<TypesConstraint, ModelsConstraint, undefined, undefined>;
+  }
+  return baseDefineContract(full) as unknown as SqliteResult<
+    TypesConstraint,
+    ModelsConstraint,
+    undefined,
+    undefined
+  >;
+}

package/src/exports/config.ts

@@ -0,0 +1,2 @@
+export type { SqliteConfigOptions } from '../config/define-config';
+export { defineConfig } from '../config/define-config';

package/src/exports/contract-builder.ts

@@ -0,0 +1,17 @@
+export type {
+  ComposedAuthoringHelpers,
+  ContractDefinition,
+  ContractInput,
+  ContractModelBuilder,
+  FieldNode,
+  ForeignKeyNode,
+  IndexNode,
+  ModelLike,
+  ModelNode,
+  PrimaryKeyNode,
+  RelationNode,
+  ScalarFieldBuilder,
+  UniqueConstraintNode,
+} from '@prisma-next/sql-contract-ts/contract-builder';
+export { field, model, rel } from '@prisma-next/sql-contract-ts/contract-builder';
+export { defineContract } from '../contract/define-contract';

package/src/exports/control.ts

@@ -0,0 +1,29 @@
+import sqliteAdapter from '@prisma-next/adapter-sqlite/control';
+import {
+  type ControlClient,
+  type ControlClientOptions,
+  createControlClient,
+} from '@prisma-next/cli/control-api';
+import sqliteDriver from '@prisma-next/driver-sqlite/control';
+import sql from '@prisma-next/family-sql/control';
+import sqlite from '@prisma-next/target-sqlite/control';
+import { ifDefined } from '@prisma-next/utils/defined';
+
+export interface SqliteControlClientOptions {
+  readonly connection?: string;
+  readonly extensionPacks?: ControlClientOptions['extensionPacks'];
+}
+
+export function createSqliteControlClient(options: SqliteControlClientOptions = {}): ControlClient {
+  const clientOptions: ControlClientOptions = {
+    family: sql,
+    target: sqlite,
+    adapter: sqliteAdapter,
+    driver: sqliteDriver,
+    ...ifDefined('connection', options.connection),
+    ...ifDefined('extensionPacks', options.extensionPacks),
+  };
+  return createControlClient(clientOptions);
+}
+
+export type { ControlClient };

package/src/exports/migration.ts

@@ -0,0 +1 @@
+export * from '@prisma-next/target-sqlite/migration';

package/src/runtime/sqlite.ts

@@ -48,6 +48,8 @@ export interface SqliteClient<TContract extends Contract<SqlStorage>> {
     declaration: D,
     callback: (sql: Db<TContract>, params: BindSiteParams<D>) => SqlQueryPlan<Row>,
   ): Promise<PreparedStatement<ParamsFromDeclaration<D, CT>, Row>>;
+  close(): Promise<void>;
+  [Symbol.asyncDispose](): Promise<void>;
 }
 
 export interface SqliteOptionsBase {
@@ -113,7 +115,10 @@ export default function sqlite<TContract extends Contract<SqlStorage>>(
   let runtimeDriver: { connect(binding: unknown): Promise<void> } | undefined;
   let driverConnected = false;
   let connectPromise: Promise<void> | undefined;
+  let closePromise: Promise<void> | undefined;
   let backgroundConnectError: unknown;
+  let closed = false;
+  let ownedDispose: (() => Promise<void>) | undefined;
 
   const connectDriver = async (resolvedBinding: SqliteBinding): Promise<void> => {
     if (driverConnected) return;
@@ -133,6 +138,10 @@ export default function sqlite<TContract extends Contract<SqlStorage>>(
   };
 
   const getRuntime = (): Runtime => {
+    if (closed) {
+      throw new Error('SQLite client is closed');
+    }
+
     if (backgroundConnectError !== undefined) {
       throw backgroundConnectError;
     }
@@ -148,6 +157,7 @@ export default function sqlite<TContract extends Contract<SqlStorage>>(
     }
 
     const driver = driverDescriptor.create();
+    ownedDispose = () => driver.close();
     runtimeDriver = driver;
     if (binding !== undefined) {
       void connectDriver(binding).catch(() => undefined);
@@ -182,6 +192,10 @@ export default function sqlite<TContract extends Contract<SqlStorage>>(
     context,
     stack,
     async connect(bindingInput) {
+      if (closed) {
+        throw new Error('SQLite client is closed');
+      }
+
       if (driverConnected || connectPromise) {
         throw new Error('SQLite client already connected');
       }
@@ -219,5 +233,19 @@ export default function sqlite<TContract extends Contract<SqlStorage>>(
     ): Promise<PreparedStatement<ParamsFromDeclaration<D, CT>, Row>> {
       return getRuntime().prepare<D, Row, CT>(declaration, (params) => callback(sql, params));
     },
+
+    close(): Promise<void> {
+      if (closePromise) return closePromise;
+      closed = true;
+      closePromise = (async () => {
+        await connectPromise?.catch(() => undefined);
+        await ownedDispose?.();
+      })();
+      return closePromise;
+    },
+
+    [Symbol.asyncDispose](): Promise<void> {
+      return this.close();
+    },
   };
 }