postgresdk 0.16.12 → 0.16.14

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"))
@@ -3497,7 +3539,7 @@ ${hasJsonbColumns ? `  /**
    * const user = await client.create<{ metadata: Metadata }>({ name: 'Alice', metadata: { tags: [], prefs: { theme: 'light' } } });
    */
   async create<TJsonb extends Partial<Select${Type}> = {}>(
-    data: Insert${Type}<TJsonb>
+    data: NoInfer<Insert${Type}<TJsonb>>
   ): Promise<Select${Type}<TJsonb>> {
     return this.post<Select${Type}<TJsonb>>(this.resource, data);
   }` : `  /**
@@ -3600,7 +3642,7 @@ ${hasJsonbColumns ? `  /**
    */
   async update<TJsonb extends Partial<Select${Type}> = {}>(
     pk: ${pkType},
-    patch: Update${Type}<TJsonb>
+    patch: NoInfer<Update${Type}<TJsonb>>
   ): Promise<Select${Type}<TJsonb> | null> {
     const path = ${pkPathExpr};
     return this.patch<Select${Type}<TJsonb> | null>(\`\${this.resource}/\${path}\`, patch);
@@ -3812,18 +3854,18 @@ export abstract class BaseClient {
   /**
    * Make a POST request
    */
-  protected async post<T>(path: string, body?: any): Promise<T> {
+  protected async post<T>(path: string, body?: unknown): Promise<T> {
     const res = await this.fetchFn(\`\${this.baseUrl}\${path}\`, {
       method: "POST",
       headers: await this.headers(true),
       body: JSON.stringify(body),
     });
-    
+
     // Handle 404 specially for operations that might return null
     if (res.status === 404) {
       return null as T;
     }
-    
+
     await this.okOrThrow(res, "POST", path);
     return (await res.json()) as T;
   }
@@ -3847,17 +3889,17 @@ export abstract class BaseClient {
   /**
    * Make a PATCH request
    */
-  protected async patch<T>(path: string, body?: any): Promise<T> {
+  protected async patch<T>(path: string, body?: unknown): Promise<T> {
     const res = await this.fetchFn(\`\${this.baseUrl}\${path}\`, {
       method: "PATCH",
       headers: await this.headers(true),
       body: JSON.stringify(body),
     });
-    
+
     if (res.status === 404) {
       return null as T;
     }
-    
+
     await this.okOrThrow(res, "PATCH", path);
     return (await res.json()) as T;
   }
@@ -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"))
@@ -2596,7 +2606,7 @@ ${hasJsonbColumns ? `  /**
    * const user = await client.create<{ metadata: Metadata }>({ name: 'Alice', metadata: { tags: [], prefs: { theme: 'light' } } });
    */
   async create<TJsonb extends Partial<Select${Type}> = {}>(
-    data: Insert${Type}<TJsonb>
+    data: NoInfer<Insert${Type}<TJsonb>>
   ): Promise<Select${Type}<TJsonb>> {
     return this.post<Select${Type}<TJsonb>>(this.resource, data);
   }` : `  /**
@@ -2699,7 +2709,7 @@ ${hasJsonbColumns ? `  /**
    */
   async update<TJsonb extends Partial<Select${Type}> = {}>(
     pk: ${pkType},
-    patch: Update${Type}<TJsonb>
+    patch: NoInfer<Update${Type}<TJsonb>>
   ): Promise<Select${Type}<TJsonb> | null> {
     const path = ${pkPathExpr};
     return this.patch<Select${Type}<TJsonb> | null>(\`\${this.resource}/\${path}\`, patch);
@@ -2911,18 +2921,18 @@ export abstract class BaseClient {
   /**
    * Make a POST request
    */
-  protected async post<T>(path: string, body?: any): Promise<T> {
+  protected async post<T>(path: string, body?: unknown): Promise<T> {
     const res = await this.fetchFn(\`\${this.baseUrl}\${path}\`, {
       method: "POST",
       headers: await this.headers(true),
       body: JSON.stringify(body),
     });
-    
+
     // Handle 404 specially for operations that might return null
     if (res.status === 404) {
       return null as T;
     }
-    
+
     await this.okOrThrow(res, "POST", path);
     return (await res.json()) as T;
   }
@@ -2946,17 +2956,17 @@ export abstract class BaseClient {
   /**
    * Make a PATCH request
    */
-  protected async patch<T>(path: string, body?: any): Promise<T> {
+  protected async patch<T>(path: string, body?: unknown): Promise<T> {
     const res = await this.fetchFn(\`\${this.baseUrl}\${path}\`, {
       method: "PATCH",
       headers: await this.headers(true),
       body: JSON.stringify(body),
     });
-    
+
     if (res.status === 404) {
       return null as T;
     }
-    
+
     await this.okOrThrow(res, "PATCH", path);
     return (await res.json()) as T;
   }
@@ -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.14",
   "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",