postgresdk 0.16.12 → 0.16.13

package/README.md

@@ -146,6 +146,7 @@ export default {
   schema: "public",                    // Database schema to introspect
   outDir: "./api",                     // Output directory (or { client: "./sdk", server: "./api" })
   softDeleteColumn: null,              // Column name for soft deletes (e.g., "deleted_at")
+  numericMode: "auto",                 // "auto" | "number" | "string" - How to type numeric columns
   includeMethodsDepth: 2,              // Max depth for nested includes
   dateType: "date",                    // "date" | "string" - How to handle timestamps
   serverFramework: "hono",             // Currently only hono is supported
@@ -175,6 +176,14 @@ export default {
 };
 ```
 
+#### Type Mapping (numericMode)
+
+Controls how PostgreSQL numeric types map to TypeScript:
+
+- **`"auto"` (default)**: `int2`/`int4`/floats → `number`, `int8`/`numeric` → `string`
+- **`"number"`**: All numeric → `number` (⚠️ unsafe for bigint - JS can't handle values > 2^53)
+- **`"string"`**: All numeric → `string` (safe but requires parsing)
+
 ### Database Drivers
 
 The generated code works with any PostgreSQL client that implements a simple `query` interface:

package/dist/cli.js

@@ -1751,6 +1751,15 @@ function extractConfigFields(configContent) {
       isCommented: !!depthMatch[1]
     });
   }
+  const numericModeMatch = configContent.match(/^\s*(\/\/)?\s*numericMode:\s*"(.+)"/m);
+  if (numericModeMatch) {
+    fields.push({
+      key: "numericMode",
+      value: numericModeMatch[2],
+      description: "How to type numeric columns in TypeScript",
+      isCommented: !!numericModeMatch[1]
+    });
+  }
   const frameworkMatch = configContent.match(/^\s*(\/\/)?\s*serverFramework:\s*"(.+)"/m);
   if (frameworkMatch) {
     fields.push({
@@ -1918,7 +1927,16 @@ export default {
    * @example "deleted_at"
    */
   ${getFieldLine("softDeleteColumn", existingFields, mergeStrategy, "null", userChoices)}
-  
+
+  /**
+   * How to type numeric columns in TypeScript
+   * - "auto": int2/int4/float → number, int8/numeric → string (recommended)
+   * - "number": All numeric types become TypeScript number (unsafe for bigint)
+   * - "string": All numeric types become TypeScript string (legacy)
+   * @default "auto"
+   */
+  ${getFieldLine("numericMode", existingFields, mergeStrategy, '"auto"', userChoices)}
+
   /**
    * Maximum depth for nested relationship includes to prevent infinite loops
    * @default 2
@@ -2347,6 +2365,20 @@ export default {
    */
   // softDeleteColumn: null,
 
+  /**
+   * How to type numeric columns in TypeScript
+   * Options:
+   *   - "auto": int2/int4/float → number, int8/numeric → string (recommended, default)
+   *   - "number": All numeric types become TypeScript number (unsafe for bigint)
+   *   - "string": All numeric types become TypeScript string (legacy behavior)
+   *
+   * Auto mode is safest - keeps JavaScript-safe integers as numbers,
+   * but preserves precision for bigint/numeric by using strings.
+   *
+   * Default: "auto"
+   */
+  // numericMode: "auto",
+
   /**
    * Maximum depth for nested relationship includes to prevent infinite loops
    * Default: 2
@@ -2879,10 +2911,20 @@ function emitZod(table, opts, enums) {
       return `z.string()`;
     if (t === "bool" || t === "boolean")
       return `z.boolean()`;
-    if (t === "int2" || t === "int4" || t === "int8")
-      return opts.numericMode === "number" ? `z.number()` : `z.string()`;
-    if (t === "numeric" || t === "float4" || t === "float8")
-      return opts.numericMode === "number" ? `z.number()` : `z.string()`;
+    if (t === "int2" || t === "int4" || t === "int8") {
+      if (opts.numericMode === "number")
+        return `z.number()`;
+      if (opts.numericMode === "string")
+        return `z.string()`;
+      return t === "int2" || t === "int4" ? `z.number()` : `z.string()`;
+    }
+    if (t === "numeric" || t === "float4" || t === "float8") {
+      if (opts.numericMode === "number")
+        return `z.number()`;
+      if (opts.numericMode === "string")
+        return `z.string()`;
+      return t === "float4" || t === "float8" ? `z.number()` : `z.string()`;
+    }
     if (t === "jsonb" || t === "json")
       return `z.unknown()`;
     if (t === "date" || t.startsWith("timestamp"))
@@ -4346,7 +4388,11 @@ function tsTypeFor(pgType, opts, enums) {
   if (t === "bool" || t === "boolean")
     return "boolean";
   if (t === "int2" || t === "int4" || t === "int8" || t === "float4" || t === "float8" || t === "numeric") {
-    return opts.numericMode === "number" ? "number" : "string";
+    if (opts.numericMode === "number")
+      return "number";
+    if (opts.numericMode === "string")
+      return "string";
+    return t === "int2" || t === "int4" || t === "float4" || t === "float8" ? "number" : "string";
   }
   if (t === "date" || t.startsWith("timestamp"))
     return "string";
@@ -6551,10 +6597,11 @@ async function generate(configPath) {
     console.log(`[Index] About to process ${Object.keys(model.tables || {}).length} tables for generation`);
   }
   for (const table of Object.values(model.tables)) {
-    const typesSrc = emitTypes(table, { numericMode: "string" }, model.enums);
+    const numericMode = cfg.numericMode ?? "auto";
+    const typesSrc = emitTypes(table, { numericMode }, model.enums);
     files.push({ path: join(serverDir, "types", `${table.name}.ts`), content: typesSrc });
     files.push({ path: join(clientDir, "types", `${table.name}.ts`), content: typesSrc });
-    const zodSrc = emitZod(table, { numericMode: "string" }, model.enums);
+    const zodSrc = emitZod(table, { numericMode }, model.enums);
     files.push({ path: join(serverDir, "zod", `${table.name}.ts`), content: zodSrc });
     files.push({ path: join(clientDir, "zod", `${table.name}.ts`), content: zodSrc });
     const paramsZodSrc = emitParamsZod(table, graph);

package/dist/emit-types.d.ts

@@ -1,4 +1,4 @@
 import type { Table } from "./introspect";
 export declare function emitTypes(table: Table, opts: {
-    numericMode: "string" | "number";
+    numericMode: "string" | "number" | "auto";
 }, enums: Record<string, string[]>): string;

package/dist/emit-zod.d.ts

@@ -1,4 +1,4 @@
 import type { Table } from "./introspect";
 export declare function emitZod(table: Table, opts: {
-    numericMode: "string" | "number";
+    numericMode: "string" | "number" | "auto";
 }, enums: Record<string, string[]>): string;

package/dist/index.js

@@ -1978,10 +1978,20 @@ function emitZod(table, opts, enums) {
       return `z.string()`;
     if (t === "bool" || t === "boolean")
       return `z.boolean()`;
-    if (t === "int2" || t === "int4" || t === "int8")
-      return opts.numericMode === "number" ? `z.number()` : `z.string()`;
-    if (t === "numeric" || t === "float4" || t === "float8")
-      return opts.numericMode === "number" ? `z.number()` : `z.string()`;
+    if (t === "int2" || t === "int4" || t === "int8") {
+      if (opts.numericMode === "number")
+        return `z.number()`;
+      if (opts.numericMode === "string")
+        return `z.string()`;
+      return t === "int2" || t === "int4" ? `z.number()` : `z.string()`;
+    }
+    if (t === "numeric" || t === "float4" || t === "float8") {
+      if (opts.numericMode === "number")
+        return `z.number()`;
+      if (opts.numericMode === "string")
+        return `z.string()`;
+      return t === "float4" || t === "float8" ? `z.number()` : `z.string()`;
+    }
     if (t === "jsonb" || t === "json")
       return `z.unknown()`;
     if (t === "date" || t.startsWith("timestamp"))
@@ -3445,7 +3455,11 @@ function tsTypeFor(pgType, opts, enums) {
   if (t === "bool" || t === "boolean")
     return "boolean";
   if (t === "int2" || t === "int4" || t === "int8" || t === "float4" || t === "float8" || t === "numeric") {
-    return opts.numericMode === "number" ? "number" : "string";
+    if (opts.numericMode === "number")
+      return "number";
+    if (opts.numericMode === "string")
+      return "string";
+    return t === "int2" || t === "int4" || t === "float4" || t === "float8" ? "number" : "string";
   }
   if (t === "date" || t.startsWith("timestamp"))
     return "string";
@@ -5650,10 +5664,11 @@ async function generate(configPath) {
     console.log(`[Index] About to process ${Object.keys(model.tables || {}).length} tables for generation`);
   }
   for (const table of Object.values(model.tables)) {
-    const typesSrc = emitTypes(table, { numericMode: "string" }, model.enums);
+    const numericMode = cfg.numericMode ?? "auto";
+    const typesSrc = emitTypes(table, { numericMode }, model.enums);
     files.push({ path: join(serverDir, "types", `${table.name}.ts`), content: typesSrc });
     files.push({ path: join(clientDir, "types", `${table.name}.ts`), content: typesSrc });
-    const zodSrc = emitZod(table, { numericMode: "string" }, model.enums);
+    const zodSrc = emitZod(table, { numericMode }, model.enums);
     files.push({ path: join(serverDir, "zod", `${table.name}.ts`), content: zodSrc });
     files.push({ path: join(clientDir, "zod", `${table.name}.ts`), content: zodSrc });
     const paramsZodSrc = emitParamsZod(table, graph);

package/dist/types.d.ts

@@ -24,6 +24,7 @@ export interface Config {
     };
     softDeleteColumn?: string | null;
     dateType?: "date" | "string";
+    numericMode?: "string" | "number" | "auto";
     includeMethodsDepth?: number;
     skipJunctionTables?: boolean;
     serverFramework?: "hono" | "express" | "fastify";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postgresdk",
-  "version": "0.16.12",
+  "version": "0.16.13",
   "description": "Generate a typed server/client SDK from a Postgres schema (includes, Zod, Hono).",
   "type": "module",
   "bin": {
@@ -22,7 +22,7 @@
   },
   "scripts": {
     "build": "bun build src/cli.ts src/index.ts --outdir dist --target node --format esm --external=pg --external=zod --external=hono --external=prompts --external=node:* && tsc -p tsconfig.build.json --emitDeclarationOnly",
-    "test": "bun test:init && bun test:gen && bun test test/test-where-clause.test.ts && bun test test/test-where-or-and.test.ts && bun test test/test-nested-include-options.test.ts && bun test test/test-include-methods-with-options.test.ts && bun test:gen-with-tests && bun test:pull && bun test:enums && bun test:typecheck && bun test:drizzle-e2e",
+    "test": "bun test:init && bun test:gen && bun test test/test-where-clause.test.ts && bun test test/test-where-or-and.test.ts && bun test test/test-nested-include-options.test.ts && bun test test/test-include-methods-with-options.test.ts && bun test:gen-with-tests && bun test:pull && bun test:enums && bun test:typecheck && bun test:drizzle-e2e && bun test test/test-numeric-mode-integration.test.ts",
     "test:init": "bun test/test-init.ts",
     "test:gen": "bun test/test-gen.ts",
     "test:gen-with-tests": "bun test/test-gen-with-tests.ts",