@prisma-next/sqlite 0.10.0-dev.26 → 0.10.0-dev.27

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";
 

package/package.json

@@ -1,27 +1,33 @@
 {
   "name": "@prisma-next/sqlite",
-  "version": "0.10.0-dev.26",
+  "version": "0.10.0-dev.27",
   "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.26",
-    "@prisma-next/contract": "0.10.0-dev.26",
-    "@prisma-next/driver-sqlite": "0.10.0-dev.26",
-    "@prisma-next/family-sql": "0.10.0-dev.26",
-    "@prisma-next/framework-components": "0.10.0-dev.26",
-    "@prisma-next/sql-builder": "0.10.0-dev.26",
-    "@prisma-next/sql-contract": "0.10.0-dev.26",
-    "@prisma-next/sql-orm-client": "0.10.0-dev.26",
-    "@prisma-next/sql-relational-core": "0.10.0-dev.26",
-    "@prisma-next/sql-runtime": "0.10.0-dev.26",
-    "@prisma-next/target-sqlite": "0.10.0-dev.26"
+    "@prisma-next/adapter-sqlite": "0.10.0-dev.27",
+    "@prisma-next/cli": "0.10.0-dev.27",
+    "@prisma-next/config": "0.10.0-dev.27",
+    "@prisma-next/contract": "0.10.0-dev.27",
+    "@prisma-next/driver-sqlite": "0.10.0-dev.27",
+    "@prisma-next/family-sql": "0.10.0-dev.27",
+    "@prisma-next/framework-components": "0.10.0-dev.27",
+    "@prisma-next/sql-builder": "0.10.0-dev.27",
+    "@prisma-next/sql-contract": "0.10.0-dev.27",
+    "@prisma-next/sql-contract-psl": "0.10.0-dev.27",
+    "@prisma-next/sql-contract-ts": "0.10.0-dev.27",
+    "@prisma-next/sql-orm-client": "0.10.0-dev.27",
+    "@prisma-next/sql-relational-core": "0.10.0-dev.27",
+    "@prisma-next/sql-runtime": "0.10.0-dev.27",
+    "@prisma-next/target-sqlite": "0.10.0-dev.27",
+    "@prisma-next/utils": "0.10.0-dev.27",
+    "pathe": "^2.0.3"
   },
   "devDependencies": {
-    "@prisma-next/test-utils": "0.10.0-dev.26",
-    "@prisma-next/tsconfig": "0.10.0-dev.26",
-    "@prisma-next/tsdown": "0.10.0-dev.26",
+    "@prisma-next/test-utils": "0.10.0-dev.27",
+    "@prisma-next/tsconfig": "0.10.0-dev.27",
+    "@prisma-next/tsdown": "0.10.0-dev.27",
     "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';