@prisma-next/family-sql 0.2.0 → 0.3.0-dev.1

package/README.md

@@ -15,7 +15,7 @@ Provides the SQL family descriptor (`ControlFamilyDescriptor`) that includes:
 - **Planner & Runner SPI**: Owns the `MigrationPlanner` / `MigrationRunner` interfaces plus the `SqlControlTargetDescriptor` helper so targets can expose planners and runners (e.g., Postgres init planner/runner)
 - **Family Hook Integration**: Integrates the SQL target family hook (`sqlTargetFamilyHook`) from `@prisma-next/sql-contract-emitter`
 - **Control Plane Entry Point**: Serves as the control plane entry point for the SQL family, enabling the CLI to select the family hook and create family instances
-- **Component Database Dependencies**: Consumes database dependencies declared by framework components (target/adapter/extensions). Callers pass the active `frameworkComponents` list into planning/execution/verification; SQL layers structurally narrow to components that declare `databaseDependencies` and use their pure verification hooks (no fuzzy matching against `contract.extensionPacks`).
+- **Component Database Dependencies**: Consumes database dependencies declared by framework components (target/adapter/extension packs). Callers pass the active `frameworkComponents` list into planning/execution/verification; SQL layers structurally narrow to components that declare `databaseDependencies` and use their pure verification hooks (no fuzzy matching against `contract.extensionPacks`).
 
 ## Usage
 
@@ -43,7 +43,7 @@ const verifyResult = await familyInstance.verify({ driver, contractIR, ... });
 const emitResult = await familyInstance.emitContract({ contractIR: rawContract }); // Handles stripping mappings and validation internally
 
 // Targets that implement SqlControlTargetDescriptor can build planners
-const planner = postgresTargetDescriptor.createPlanner(familyInstance);
+const planner = postgresTargetDescriptor.migrations.createPlanner(familyInstance);
 // frameworkComponents should include the active target, adapter, and any extension descriptors so
 // planner/runner can resolve database dependencies declared by those components.
 const planResult = planner.plan({
@@ -54,7 +54,7 @@ const planResult = planner.plan({
 });
 
 // Targets also provide runners for executing plans
-const runner = postgresTargetDescriptor.createRunner(familyInstance);
+const runner = postgresTargetDescriptor.migrations.createRunner(familyInstance);
 const executeResult = await runner.execute({
   plan: planResult.plan,
   driver,
@@ -131,3 +131,15 @@ The runner returns structured errors with the following codes:
 **Dependents:**
 - CLI configuration files import this package to register the SQL family
 
+## How to debug `db init`
+
+- **CLI orchestration**: `packages/1-framework/3-tooling/cli/src/commands/db-init.ts`
+- **Planner/runner SPI types**: `packages/2-sql/3-tooling/family/src/core/migrations/types.ts`
+- **Pure schema verifier (used by planner + runner)**: `@prisma-next/family-sql/schema-verify` (source: `packages/2-sql/3-tooling/family/src/core/schema-verify/`)
+- **Postgres implementation**:
+  - Planner: `packages/3-targets/3-targets/postgres/src/core/migrations/planner.ts`
+  - Runner: `packages/3-targets/3-targets/postgres/src/core/migrations/runner.ts`
+- **Tests**:
+  - CLI integration: `test/integration/test/cli.db-init.e2e.test.ts`
+  - Target unit/integration: `packages/3-targets/3-targets/postgres/test/migrations/*`
+

package/package.json

@@ -1,25 +1,25 @@
 {
   "name": "@prisma-next/family-sql",
-  "version": "0.2.0",
+  "version": "0.3.0-dev.1",
   "type": "module",
   "sideEffects": false,
   "description": "SQL family descriptor for Prisma Next",
   "dependencies": {
     "arktype": "^2.0.0",
-    "@prisma-next/cli": "0.2.0",
-    "@prisma-next/contract": "0.2.0",
-    "@prisma-next/core-control-plane": "0.2.0",
-    "@prisma-next/core-execution-plane": "0.2.0",
-    "@prisma-next/runtime-executor": "0.2.0",
-    "@prisma-next/operations": "0.2.0",
-    "@prisma-next/sql-contract-emitter": "0.2.0",
-    "@prisma-next/sql-contract-ts": "0.2.0",
-    "@prisma-next/sql-contract": "0.2.0",
-    "@prisma-next/sql-relational-core": "0.2.0",
-    "@prisma-next/sql-runtime": "0.2.0",
-    "@prisma-next/sql-schema-ir": "0.2.0",
-    "@prisma-next/utils": "0.2.0",
-    "@prisma-next/sql-operations": "0.2.0"
+    "@prisma-next/cli": "0.3.0-dev.1",
+    "@prisma-next/contract": "0.3.0-dev.1",
+    "@prisma-next/core-control-plane": "0.3.0-dev.1",
+    "@prisma-next/core-execution-plane": "0.3.0-dev.1",
+    "@prisma-next/operations": "0.3.0-dev.1",
+    "@prisma-next/runtime-executor": "0.3.0-dev.1",
+    "@prisma-next/sql-contract": "0.3.0-dev.1",
+    "@prisma-next/sql-operations": "0.3.0-dev.1",
+    "@prisma-next/sql-relational-core": "0.3.0-dev.1",
+    "@prisma-next/sql-runtime": "0.3.0-dev.1",
+    "@prisma-next/sql-schema-ir": "0.3.0-dev.1",
+    "@prisma-next/sql-contract-emitter": "0.3.0-dev.1",
+    "@prisma-next/utils": "0.3.0-dev.1",
+    "@prisma-next/sql-contract-ts": "0.3.0-dev.1"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.0",
@@ -27,7 +27,7 @@
     "typescript": "^5.9.3",
     "vite-tsconfig-paths": "^5.1.4",
     "vitest": "^4.0.16",
-    "@prisma-next/driver-postgres": "0.2.0",
+    "@prisma-next/driver-postgres": "0.3.0-dev.1",
     "@prisma-next/test-utils": "0.0.1"
   },
   "files": [