@prisma-next/target-sqlite 0.0.1

package/README.md

@@ -0,0 +1,69 @@
+# @prisma-next/target-sqlite
+
+SQLite target pack for Prisma Next.
+
+## Package Classification
+
+- **Domain**: targets
+- **Layer**: targets
+- **Plane**: multi-plane (runtime, authoring)
+
+## Purpose
+
+Provides the SQLite target descriptor for runtime use and pack refs for contract authoring. The control-plane entry point (migration planner/runner) is not yet implemented.
+
+## Responsibilities
+
+- **Runtime Target Descriptor**: Exports `SqlRuntimeTargetDescriptor<'sqlite'>` with codec registry and factory
+- **Pack Ref Export**: Exports `TargetPackRef<'sql', 'sqlite'>` for `defineContract().target(sqlitePack)` contract authoring
+- **Descriptor Metadata**: Defines target identity (`familyId: 'sql'`, `targetId: 'sqlite'`, `id: 'sqlite'`) and version
+
+**Non-goals:**
+- Migration planner/runner (future milestone)
+- Schema introspection (future milestone)
+- Control-plane target descriptor (future milestone)
+
+This package spans multiple planes:
+- **Runtime plane** (`src/exports/runtime.ts`): Runtime entry point for target-specific runtime code
+- **Authoring pack ref** (`src/exports/pack.ts`): Pure data surface for contract builder workflows
+
+## Usage
+
+### Pack refs for TypeScript contract authoring
+
+```typescript
+import sqlitePack from '@prisma-next/target-sqlite/pack';
+import { defineContract } from '@prisma-next/sql-contract-ts/contract-builder';
+
+export const contract = defineContract()
+  .target(sqlitePack)
+  .build();
+```
+
+Pack refs are pure JSON-friendly objects that make TypeScript contract authoring work in both emit and no-emit workflows without requiring separate manifest files.
+
+## Architecture
+
+This package provides a runtime entry point for the SQLite target. All declarative fields (version, capabilities) are defined directly on the descriptor. The `./pack` entry point provides a pure pack ref for contract authoring.
+
+## Dependencies
+
+- **`@prisma-next/framework-components`**: Descriptor types (`RuntimeTargetInstance`)
+- **`@prisma-next/sql-relational-core`**: Codec registry factory
+- **`@prisma-next/sql-runtime`**: `SqlRuntimeTargetDescriptor` type
+- **`@prisma-next/sql-contract`**: Pack ref types (`TargetPackRef`)
+- **`@prisma-next/adapter-sqlite`** *(dev)*: Codec types for pack ref `__codecTypes`
+
+## Related Subsystems
+
+- **[Adapters & Targets](../../../../docs/architecture%20docs/subsystems/5.%20Adapters%20&%20Targets.md)**: Target specification
+
+## Related ADRs
+
+- [ADR 005 -- Thin Core Fat Targets](../../../../docs/architecture%20docs/adrs/ADR%20005%20-%20Thin%20Core%20Fat%20Targets.md)
+- [ADR 112 -- Target Extension Packs](../../../../docs/architecture%20docs/adrs/ADR%20112%20-%20Target%20Extension%20Packs.md)
+
+## Exports
+
+- `./runtime`: Runtime entry point for `SqlRuntimeTargetDescriptor<'sqlite'>`
+- `./pack`: Pure pack ref for `defineContract().target(sqlitePack)`

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@prisma-next/target-sqlite",
+  "version": "0.0.1",
+  "type": "module",
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run --passWithNoTests",
+    "test:coverage": "vitest run --coverage --passWithNoTests",
+    "typecheck": "tsc --project tsconfig.json --noEmit",
+    "lint": "biome check . --error-on-warnings",
+    "lint:fix": "biome check --write .",
+    "lint:fix:unsafe": "biome check --write --unsafe .",
+    "clean": "rm -rf dist dist-tsc dist-tsc-prod coverage .tmp-output"
+  },
+  "dependencies": {
+    "@prisma-next/contract": "workspace:*",
+    "@prisma-next/framework-components": "workspace:*",
+    "@prisma-next/sql-contract": "workspace:*",
+    "@prisma-next/sql-relational-core": "workspace:*",
+    "@prisma-next/sql-runtime": "workspace:*"
+  },
+  "devDependencies": {
+    "@prisma-next/adapter-sqlite": "workspace:*",
+    "@prisma-next/test-utils": "workspace:*",
+    "@prisma-next/tsconfig": "workspace:*",
+    "@prisma-next/tsdown": "workspace:*",
+    "tsdown": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "exports": {
+    "./control": "./dist/control.mjs",
+    "./pack": "./dist/pack.mjs",
+    "./runtime": "./dist/runtime.mjs",
+    "./package.json": "./package.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/prisma/prisma-next.git",
+    "directory": "packages/3-targets/3-targets/sqlite"
+  }
+}

package/src/core/control-target.ts

@@ -0,0 +1,18 @@
+import type {
+  ControlTargetDescriptor,
+  ControlTargetInstance,
+} from '@prisma-next/framework-components/control';
+import { sqliteTargetDescriptorMeta } from './descriptor-meta';
+
+const sqliteControlTargetDescriptor: ControlTargetDescriptor<
+  'sql',
+  'sqlite',
+  ControlTargetInstance<'sql', 'sqlite'>
+> = {
+  ...sqliteTargetDescriptorMeta,
+  create(): ControlTargetInstance<'sql', 'sqlite'> {
+    return { familyId: 'sql', targetId: 'sqlite' };
+  },
+};
+
+export default sqliteControlTargetDescriptor;

package/src/core/descriptor-meta.ts

@@ -0,0 +1,8 @@
+export const sqliteTargetDescriptorMeta = {
+  kind: 'target',
+  familyId: 'sql',
+  targetId: 'sqlite',
+  id: 'sqlite',
+  version: '0.0.1',
+  capabilities: {},
+} as const;

package/src/core/runtime-target.ts

@@ -0,0 +1,23 @@
+import type { RuntimeTargetInstance } from '@prisma-next/framework-components/execution';
+import { createCodecRegistry } from '@prisma-next/sql-relational-core/ast';
+import type { SqlRuntimeTargetDescriptor } from '@prisma-next/sql-runtime';
+import { sqliteTargetDescriptorMeta } from './descriptor-meta';
+
+export interface SqliteRuntimeTargetInstance extends RuntimeTargetInstance<'sql', 'sqlite'> {}
+
+const sqliteRuntimeTargetDescriptor: SqlRuntimeTargetDescriptor<
+  'sqlite',
+  SqliteRuntimeTargetInstance
+> = {
+  ...sqliteTargetDescriptorMeta,
+  codecs: () => createCodecRegistry(),
+  parameterizedCodecs: () => [],
+  create(): SqliteRuntimeTargetInstance {
+    return {
+      familyId: 'sql',
+      targetId: 'sqlite',
+    };
+  },
+};
+
+export default sqliteRuntimeTargetDescriptor;

package/src/exports/control.ts

@@ -0,0 +1 @@
+export { default } from '../core/control-target';

package/src/exports/pack.ts

@@ -0,0 +1,9 @@
+import type { CodecTypes } from '@prisma-next/adapter-sqlite/codec-types';
+import type { TargetPackRef } from '@prisma-next/framework-components/components';
+import { sqliteTargetDescriptorMeta } from '../core/descriptor-meta';
+
+const sqlitePack = sqliteTargetDescriptorMeta;
+
+export default sqlitePack as TargetPackRef<'sql', 'sqlite'> & {
+  readonly __codecTypes?: CodecTypes;
+};

package/src/exports/runtime.ts

@@ -0,0 +1,2 @@
+export type { SqliteRuntimeTargetInstance } from '../core/runtime-target';
+export { default } from '../core/runtime-target';