@ingram-tech/nk-db 0.6.0 → 0.8.0

package/README.md

@@ -54,6 +54,11 @@ same pool: `betterAuth({ database: pool, … })`.
 - **`configureTimestampsAsStrings()`** — opt-in, for legacy row types that expect
   `timestamptz` as ISO strings (on the golden path, prefer Drizzle's
   `timestamp(..., { mode: "string" })` per column).
+- **`pgTimestampToIso(value)` / `pgNumericToNumber(value)`** — response-boundary
+  coercions for schemas written against supabase-js. `pg`/Drizzle return
+  `numeric` as a string and `timestamp(..., { mode: "string" })` as Postgres'
+  text form; these convert to the `z.number()` / strict `z.iso.datetime()` shapes
+  those schemas expect. Presentation only — keep money math on the decimal value.
 
 ## Keeping RLS on a direct connection (`withRls` / `withRlsTransaction`)
 

package/dist/coerce.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Normalize a Postgres timestamp string to a strict ISO-8601 UTC string
+ * ("2026-06-21T18:22:08.331Z"), the form `z.iso.datetime()` (no offset) accepts.
+ *
+ * `Date` parses both Postgres' space-separated form and supabase-js's `+00:00`
+ * offset form to the same instant, and `.toISOString()` emits the canonical
+ * `T…Z`. `null` passes through.
+ */
+export declare function pgTimestampToIso(value: string): string;
+export declare function pgTimestampToIso(value: null): null;
+export declare function pgTimestampToIso(value: string | null): string | null;
+/**
+ * Coerce a Postgres `numeric` value (which `pg`/Drizzle return as a string to
+ * preserve arbitrary precision) to a JS number, for schemas that expect
+ * `z.number()`. `null` passes through.
+ *
+ * Lossy for values outside `Number`'s safe range — only use at the response
+ * boundary, never for money math (keep that on the string/decimal value).
+ */
+export declare function pgNumericToNumber(value: string): number;
+export declare function pgNumericToNumber(value: null): null;
+export declare function pgNumericToNumber(value: string | null): number | null;
+//# sourceMappingURL=coerce.d.ts.map

package/dist/coerce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce.d.ts","sourceRoot":"","sources":["../src/coerce.ts"],"names":[],"mappings":"AAcA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;AACxD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC;AACpD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;AAKtE;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;AACzD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC;AACrD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC"}

package/dist/coerce.js

@@ -0,0 +1,20 @@
+// Coerce Postgres value representations back to the JS types app code expects.
+//
+// Why these exist: response/validation schemas in nextkit sites are typically
+// written against supabase-js / PostgREST, which parsed `timestamptz` into ISO
+// strings and `numeric` into JS numbers. Direct `pg` (and Drizzle on top of it)
+// surfaces those columns differently — `numeric` as a string (to avoid losing
+// precision), and `timestamp(..., { mode: "string" })` as Postgres' own text
+// form ("2026-06-21 18:22:08.331494+00", space separator, short offset). Neither
+// satisfies a schema expecting `z.number()` / strict `z.iso.datetime()`.
+//
+// Use these at the read/response boundary when handing Drizzle/`pg` rows to such
+// a schema. They are presentation coercions, not domain math — keep money
+// arithmetic on the string/decimal value, and only convert for output.
+export function pgTimestampToIso(value) {
+    return value === null ? null : new Date(value).toISOString();
+}
+export function pgNumericToNumber(value) {
+    return value === null ? null : Number(value);
+}
+//# sourceMappingURL=coerce.js.map

package/dist/coerce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce.js","sourceRoot":"","sources":["../src/coerce.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,gFAAgF;AAChF,8EAA8E;AAC9E,6EAA6E;AAC7E,iFAAiF;AACjF,yEAAyE;AACzE,EAAE;AACF,iFAAiF;AACjF,0EAA0E;AAC1E,uEAAuE;AAavE,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACpD,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AAC9D,CAAC;AAaD,MAAM,UAAU,iBAAiB,CAAC,KAAoB;IACrD,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export { pgNumericToNumber, pgTimestampToIso } from "./coerce.js";
 export { createDb, withRlsTransaction } from "./drizzle.js";
 export { type DbEnv, dbEnv, getDatabaseUrl, isConfigured } from "./keys.js";
 export { type CreatePoolConfig, createPool } from "./pool.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,KAAK,gBAAgB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,gBAAgB,EAChB,WAAW,GACX,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,KAAK,gBAAgB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,gBAAgB,EAChB,WAAW,GACX,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,6 +1,7 @@
 // The Ingram Postgres data layer. The PGlite dev/test harness lives behind the
 // "@ingram-tech/nk-db/pglite" subpath so its WASM/dev-only deps never reach a
 // production bundle.
+export { pgNumericToNumber, pgTimestampToIso } from "./coerce.js";
 export { createDb, withRlsTransaction } from "./drizzle.js";
 export { dbEnv, getDatabaseUrl, isConfigured } from "./keys.js";
 export { createPool } from "./pool.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,8EAA8E;AAC9E,qBAAqB;AAErB,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAc,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAyB,UAAU,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAkC,MAAM,cAAc,CAAC;AAC7E,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAIhB,gBAAgB,EAChB,WAAW,GACX,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,8EAA8E;AAC9E,qBAAqB;AAErB,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAc,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAyB,UAAU,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAkC,MAAM,cAAc,CAAC;AAC7E,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAIhB,gBAAgB,EAChB,WAAW,GACX,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ingram-tech/nk-db",
-	"version": "0.6.0",
+	"version": "0.8.0",
 	"description": "The Ingram Postgres data layer: one TLS-aware pg pool, raw-SQL helpers, Drizzle wiring, and a PGlite (no-Docker) dev/test harness for Next.js sites.",
 	"license": "MIT",
 	"type": "module",