@shivaedev/effect-prisma 0.4.0 → 0.4.2

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 ## Unreleased
 
+## 0.4.2 - 2026-08-03
+
+### Fixed
+
+- Provide a contract-normalization command that corrects Prisma Next's
+  PostgreSQL timestamp declarations without recursively expanding large client
+  types.
+
+## 0.4.1 - 2026-08-03
+
+### Fixed
+
+- Expose PostgreSQL timestamp and timestamp-with-time-zone fields as `Date`,
+  matching Prisma Next's runtime codecs even when its generated contract renders
+  those fields as branded strings.
+
 ## 0.4.0 - 2026-08-03
 
 ### Added

package/README.md

@@ -15,6 +15,16 @@ pnpm add @shivaedev/effect-prisma effect
 Generate a Prisma Next contract in the application, then create its database
 service:
 
+```sh
+prisma-next contract emit
+effect-prisma-normalize path/to/generated/contract.d.ts
+```
+
+The normalization step is idempotent and currently required because Prisma
+Next's generated PostgreSQL timestamp output declarations do not match its
+runtime `Date` codecs. It fails when Prisma emits an unfamiliar timestamp shape
+instead of silently producing weakened types.
+
 ```ts
 import { makeDatabase } from "@shivaedev/effect-prisma"
 import { contractJson, type Contract } from "./generated/contract.js"
@@ -95,6 +105,10 @@ ordering, pagination, distinct queries, aggregates, grouping, and
 create/update/delete terminals. Model variants are deliberately deferred rather
 than exposed with weakened types.
 
+PostgreSQL timestamp and timestamp-with-time-zone fields use JavaScript `Date`
+values for reads, writes, filters, selections, includes, and Streams after the
+generated contract is normalized.
+
 ## Transactions
 
 Transactions keep the same database API and are implicitly scoped:

package/dist/bin/normalize-contract.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=normalize-contract.d.ts.map

package/dist/bin/normalize-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-contract.d.ts","sourceRoot":"","sources":["../../src/bin/normalize-contract.ts"],"names":[],"mappings":""}

package/dist/bin/normalize-contract.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { readFile, writeFile } from "node:fs/promises";
+import { normalizePrismaNextContractTypes } from "../internal/contract-normalization.js";
+const arguments_ = process.argv.slice(2);
+if (arguments_.length !== 1 || arguments_[0] === undefined) {
+    throw new Error("Usage: effect-prisma-normalize <generated-contract.d.ts>");
+}
+const contractPath = arguments_[0];
+const source = await readFile(contractPath, "utf8");
+const normalized = normalizePrismaNextContractTypes(source);
+if (normalized !== source) {
+    await writeFile(contractPath, normalized);
+}
+//# sourceMappingURL=normalize-contract.js.map

package/dist/bin/normalize-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-contract.js","sourceRoot":"","sources":["../../src/bin/normalize-contract.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AAEzF,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACzC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;IAC5D,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;AACpD,MAAM,UAAU,GAAG,gCAAgC,CAAC,MAAM,CAAC,CAAC;AAE5D,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;IAC3B,MAAM,SAAS,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;AAC3C,CAAC"}

package/dist/internal/contract-normalization.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Align Prisma Next's generated PostgreSQL timestamp declarations with the
+ * JavaScript Dates accepted and returned by its runtime codecs.
+ */
+export declare const normalizePrismaNextContractTypes: (source: string) => string;
+//# sourceMappingURL=contract-normalization.d.ts.map

package/dist/internal/contract-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-normalization.d.ts","sourceRoot":"","sources":["../../src/internal/contract-normalization.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,eAAO,MAAM,gCAAgC,GAAI,QAAQ,MAAM,KAAG,MAUjE,CAAC"}

package/dist/internal/contract-normalization.js

@@ -0,0 +1,14 @@
+const timestampReference = /\b(?:Timestamp|Timestamptz)<(?:\d+|undefined)>/g;
+const unsupportedTimestampReference = /\b(?:Timestamp|Timestamptz)\s*</;
+/**
+ * Align Prisma Next's generated PostgreSQL timestamp declarations with the
+ * JavaScript Dates accepted and returned by its runtime codecs.
+ */
+export const normalizePrismaNextContractTypes = (source) => {
+    const normalized = source.replaceAll(timestampReference, "Date");
+    if (unsupportedTimestampReference.test(normalized)) {
+        throw new Error("Unsupported Prisma Next timestamp declaration; update effect-prisma before using this generated contract");
+    }
+    return normalized;
+};
+//# sourceMappingURL=contract-normalization.js.map

package/dist/internal/contract-normalization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-normalization.js","sourceRoot":"","sources":["../../src/internal/contract-normalization.ts"],"names":[],"mappings":"AAAA,MAAM,kBAAkB,GAAG,iDAAiD,CAAC;AAC7E,MAAM,6BAA6B,GAAG,iCAAiC,CAAC;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,MAAc,EAAU,EAAE;IAC1E,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;IAEjE,IAAI,6BAA6B,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CACd,0GAA0G,CAC1G,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACnB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/effect-prisma",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Effect-native PostgreSQL queries and transactions for Prisma Next",
   "type": "module",
   "license": "MIT",
@@ -17,6 +17,9 @@
     "node": ">=24"
   },
   "sideEffects": false,
+  "bin": {
+    "effect-prisma-normalize": "./dist/bin/normalize-contract.js"
+  },
   "files": [
     "dist",
     "src",

package/src/bin/normalize-contract.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+
+import { readFile, writeFile } from "node:fs/promises";
+import { normalizePrismaNextContractTypes } from "../internal/contract-normalization.js";
+
+const arguments_ = process.argv.slice(2);
+if (arguments_.length !== 1 || arguments_[0] === undefined) {
+	throw new Error("Usage: effect-prisma-normalize <generated-contract.d.ts>");
+}
+
+const contractPath = arguments_[0];
+const source = await readFile(contractPath, "utf8");
+const normalized = normalizePrismaNextContractTypes(source);
+
+if (normalized !== source) {
+	await writeFile(contractPath, normalized);
+}

package/src/internal/contract-normalization.ts

@@ -0,0 +1,18 @@
+const timestampReference = /\b(?:Timestamp|Timestamptz)<(?:\d+|undefined)>/g;
+const unsupportedTimestampReference = /\b(?:Timestamp|Timestamptz)\s*</;
+
+/**
+ * Align Prisma Next's generated PostgreSQL timestamp declarations with the
+ * JavaScript Dates accepted and returned by its runtime codecs.
+ */
+export const normalizePrismaNextContractTypes = (source: string): string => {
+	const normalized = source.replaceAll(timestampReference, "Date");
+
+	if (unsupportedTimestampReference.test(normalized)) {
+		throw new Error(
+			"Unsupported Prisma Next timestamp declaration; update effect-prisma before using this generated contract",
+		);
+	}
+
+	return normalized;
+};