@prisma-next/sql-contract-ts 0.3.0-dev.46 → 0.3.0-dev.48

package/README.md

@@ -36,6 +36,14 @@ This package was created in Phase 1 and refactored in Phase 2. It now composes t
 - **SQL-specific types**: Provides SQL-specific contract types (`SqlContract`, `SqlStorage`, `SqlMappings`) from `@prisma-next/sql-contract/types`
 - **SQL-specific build()**: Implements SQL-specific `build()` method in `SqlContractBuilder` that constructs `SqlContract` instances with SQL-specific structure (uniques, indexes, foreignKeys arrays)
 
+```mermaid
+flowchart LR
+  builderInput[TS builder calls] --> sqlContractTs[@prisma-next/sql-contract-ts]
+  sqlContractTs --> authoringCore[@prisma-next/contract-authoring]
+  sqlContractTs --> sqlTypes[@prisma-next/sql-contract/types]
+  sqlContractTs --> contractIR[SQL ContractIR]
+```
+
 This package is part of the package layering architecture:
 - **Location**: `packages/2-sql/2-authoring/contract-ts` (SQL family namespace)
 - **Ring**: SQL family namespace (can import from core, authoring, targets, and other SQL family packages)
@@ -43,6 +51,7 @@ This package is part of the package layering architecture:
 ## Exports
 
 - `./contract-builder` - Contract builder API (`defineContract`, `ColumnBuilder`)
+- `./config-types` - TypeScript contract config helper (`typescriptContract`)
 - `./schema-sql` - SQL contract JSON schema (`data-contract-sql-v1.json`)
 
 ## Usage
@@ -124,10 +133,26 @@ import type { Contract } from './contract.d';
 const contract = validateContract<Contract>(contractJson);
 ```
 
+### Config Helper
+
+Use `typescriptContract` from this package when wiring TS-authored contracts in `prisma-next.config.ts`.
+
+```typescript
+import { defineConfig } from '@prisma-next/cli/config-types';
+import { typescriptContract } from '@prisma-next/sql-contract-ts/config-types';
+import { contract } from './src/prisma/contract';
+
+export default defineConfig({
+  // ...
+  contract: typescriptContract(contract, 'src/prisma/contract.json'),
+});
+```
+
 ## Dependencies
 
 - **`@prisma-next/contract-authoring`** - Target-agnostic builder core (builder state types, builder classes, type helpers)
 - **`@prisma-next/contract`** - Core contract types (`ContractBase`)
+- **`@prisma-next/core-control-plane`** - Contract config types used by `typescriptContract`
 - **`@prisma-next/sql-contract`** - SQL contract types (`SqlContract`, `SqlStorage`, `SqlMappings`)
 - **`arktype`** - Runtime validation
 - **`ts-toolbelt`** - Type utilities
@@ -145,4 +170,6 @@ Integration tests that depend on both `sql-contract-ts` and `sql-query` are loca
 ## See Also
 
 - `@prisma-next/contract-authoring` - Target-agnostic builder core that this package composes
+- `@prisma-next/sql-contract-psl` - PSL parser-output to SQL `ContractIR` interpreter for provider-based flows
+- `@prisma-next/sql-contract-psl/provider` - SQL PSL-first `prismaContract()` helper (read -> parse -> interpret)
 

package/dist/config-types.d.mts

@@ -0,0 +1,8 @@
+import { ContractConfig, ContractConfig as ContractConfig$1 } from "@prisma-next/core-control-plane/config-types";
+import { ContractIR } from "@prisma-next/contract/ir";
+
+//#region src/config-types.d.ts
+declare function typescriptContract(contractIR: ContractIR, output?: string): ContractConfig$1;
+//#endregion
+export { type ContractConfig, typescriptContract };
+//# sourceMappingURL=config-types.d.mts.map

package/dist/config-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-types.d.mts","names":[],"sources":["../src/config-types.ts"],"sourcesContent":[],"mappings":";;;;iBAKgB,kBAAA,aAA+B,8BAA8B"}

package/dist/config-types.mjs

@@ -0,0 +1,14 @@
+import { ifDefined } from "@prisma-next/utils/defined";
+import { ok } from "@prisma-next/utils/result";
+
+//#region src/config-types.ts
+function typescriptContract(contractIR, output) {
+	return {
+		source: async () => ok(contractIR),
+		...ifDefined("output", output)
+	};
+}
+
+//#endregion
+export { typescriptContract };
+//# sourceMappingURL=config-types.mjs.map

package/dist/config-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-types.mjs","names":[],"sources":["../src/config-types.ts"],"sourcesContent":["import type { ContractIR } from '@prisma-next/contract/ir';\nimport type { ContractConfig } from '@prisma-next/core-control-plane/config-types';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { ok } from '@prisma-next/utils/result';\n\nexport function typescriptContract(contractIR: ContractIR, output?: string): ContractConfig {\n  return {\n    source: async () => ok(contractIR),\n    ...ifDefined('output', output),\n  };\n}\n"],"mappings":";;;;AAKA,SAAgB,mBAAmB,YAAwB,QAAiC;AAC1F,QAAO;EACL,QAAQ,YAAY,GAAG,WAAW;EAClC,GAAG,UAAU,UAAU,OAAO;EAC/B"}

package/package.json

@@ -1,16 +1,17 @@
 {
   "name": "@prisma-next/sql-contract-ts",
-  "version": "0.3.0-dev.46",
+  "version": "0.3.0-dev.48",
   "type": "module",
   "sideEffects": false,
   "description": "SQL-specific TypeScript contract authoring surface for Prisma Next",
   "dependencies": {
     "arktype": "^2.1.25",
     "ts-toolbelt": "^9.6.0",
-    "@prisma-next/contract": "0.3.0-dev.46",
-    "@prisma-next/contract-authoring": "0.3.0-dev.46",
-    "@prisma-next/sql-contract": "0.3.0-dev.46",
-    "@prisma-next/utils": "0.3.0-dev.46"
+    "@prisma-next/contract": "0.3.0-dev.48",
+    "@prisma-next/contract-authoring": "0.3.0-dev.48",
+    "@prisma-next/core-control-plane": "0.3.0-dev.48",
+    "@prisma-next/sql-contract": "0.3.0-dev.48",
+    "@prisma-next/utils": "0.3.0-dev.48"
   },
   "devDependencies": {
     "@types/pg": "8.16.0",
@@ -18,9 +19,9 @@
     "tsdown": "0.18.4",
     "typescript": "5.9.3",
     "vitest": "4.0.17",
+    "@prisma-next/test-utils": "0.0.1",
     "@prisma-next/tsconfig": "0.0.0",
-    "@prisma-next/tsdown": "0.0.0",
-    "@prisma-next/test-utils": "0.0.1"
+    "@prisma-next/tsdown": "0.0.0"
   },
   "files": [
     "dist",
@@ -36,6 +37,10 @@
       "types": "./dist/contract-builder.d.mts",
       "import": "./dist/contract-builder.mjs"
     },
+    "./config-types": {
+      "types": "./dist/config-types.d.mts",
+      "import": "./dist/config-types.mjs"
+    },
     "./schema-sql": "./schemas/data-contract-sql-v1.json",
     "./package.json": "./package.json"
   },

package/src/config-types.ts

@@ -0,0 +1,11 @@
+import type { ContractIR } from '@prisma-next/contract/ir';
+import type { ContractConfig } from '@prisma-next/core-control-plane/config-types';
+import { ifDefined } from '@prisma-next/utils/defined';
+import { ok } from '@prisma-next/utils/result';
+
+export function typescriptContract(contractIR: ContractIR, output?: string): ContractConfig {
+  return {
+    source: async () => ok(contractIR),
+    ...ifDefined('output', output),
+  };
+}

package/src/exports/config-types.ts

@@ -0,0 +1,2 @@
+export type { ContractConfig } from '@prisma-next/core-control-plane/config-types';
+export { typescriptContract } from '../config-types';