postgresdk 0.19.0 → 0.19.2

package/README.md

@@ -594,7 +594,7 @@ const [order, updatedUser] = await sdk.$transaction([
 // TypeScript infers: [SelectOrders, SelectUsers | null]
 ```
 
-- `$create`, `$update`, `$delete`, `$upsert` are **lazy builders** — nothing executes until `$transaction` is called
+- `$create`, `$update`, `$softDelete`, `$hardDelete`, `$upsert` are **lazy builders** — nothing executes until `$transaction` is called
 - All ops are Zod-validated **before** `BEGIN` is issued (fail-fast, no partial state)
 - On any failure the transaction rolls back; an error is thrown with a `.failedAt` index
 

package/dist/cli.js

@@ -2823,7 +2823,7 @@ function emitZod(table, opts, enums) {
       return `z.enum([${values}])`;
     }
     if (t === "uuid")
-      return `z.string()`;
+      return `z.string().uuid()`;
     if (t === "bool" || t === "boolean")
       return `z.boolean()`;
     if (t === "int2" || t === "int4" || t === "int8") {
@@ -3662,6 +3662,20 @@ function emitClient(table, graph, opts, model) {
     deleteMethodParts.push(buildDeleteMethod("hardDelete", hasSoftDelete));
   const deleteMethodsCode = deleteMethodParts.join(`
 
+`);
+  const txDeleteParts = [];
+  if (hasSoftDelete)
+    txDeleteParts.push(`  /** Build a lazy soft-DELETE descriptor for use with sdk.$transaction([...]) */
+` + `  $softDelete(pk: ${pkType}): TxOp<Select${Type} | null> {
+` + `    return { _table: "${table.name}", _op: "softDelete", _pk: ${hasCompositePk ? "pk as Record<string, unknown>" : "pk"} };
+` + `  }`);
+  if (exposeHard)
+    txDeleteParts.push(`  /** Build a lazy hard-DELETE descriptor for use with sdk.$transaction([...]) */
+` + `  $hardDelete(pk: ${pkType}): TxOp<Select${Type} | null> {
+` + `    return { _table: "${table.name}", _op: "hardDelete", _pk: ${hasCompositePk ? "pk as Record<string, unknown>" : "pk"} };
+` + `  }`);
+  const txDeleteMethodsCode = txDeleteParts.join(`
+
 `);
   return `/**
  * AUTO-GENERATED FILE - DO NOT EDIT
@@ -4178,10 +4192,7 @@ ${deleteMethodsCode}
     return { _table: "${table.name}", _op: "update", _pk: ${hasCompositePk ? "pk as Record<string, unknown>" : "pk"}, _data: data as Record<string, unknown> };
   }
 
-  /** Build a lazy DELETE descriptor for use with sdk.$transaction([...]) */
-  $delete(pk: ${pkType}): TxOp<Select${Type} | null> {
-    return { _table: "${table.name}", _op: "delete", _pk: ${hasCompositePk ? "pk as Record<string, unknown>" : "pk"} };
-  }
+${txDeleteMethodsCode}
 
   /** Build a lazy UPSERT descriptor for use with sdk.$transaction([...]) */
   $upsert(args: { where: Update${Type}; create: Insert${Type}; update: Update${Type} }): TxOp<Select${Type}> {
@@ -4535,13 +4546,13 @@ export abstract class BaseClient {
 }
 
 /**
- * Lazy operation descriptor returned by $create/$update/$delete.
+ * Lazy operation descriptor returned by $create/$update/$softDelete/$hardDelete/$upsert.
  * \`__resultType\` is a phantom field — never assigned at runtime, exists only
  * so TypeScript can infer the correct tuple element type inside \`$transaction\`.
  */
 export type TxOp<T = unknown> = {
   readonly _table: string;
-  readonly _op: "create" | "update" | "delete" | "upsert";
+  readonly _op: "create" | "update" | "softDelete" | "hardDelete" | "upsert";
   readonly _data?: Record<string, unknown>;
   readonly _pk?: string | Record<string, unknown>;
   /** @internal */
@@ -5619,11 +5630,16 @@ function emitHonoRouter(tables, hasAuth, useJsExtensions, pullToken, opts) {
           return c.json({ error: \`Missing pk at index \${i}\`, failedAt: i }, 400);
         }
         validatedOps.push({ op: "update", table: item.table, pk: item.pk, data: parsed.data });
-      } else if (item.op === "delete") {
+      } else if (item.op === "softDelete") {
         if (item.pk == null) {
           return c.json({ error: \`Missing pk at index \${i}\`, failedAt: i }, 400);
         }
-        validatedOps.push({ op: "delete", table: item.table, pk: item.pk });
+        validatedOps.push({ op: "softDelete", table: item.table, pk: item.pk });
+      } else if (item.op === "hardDelete") {
+        if (item.pk == null) {
+          return c.json({ error: \`Missing pk at index \${i}\`, failedAt: i }, 400);
+        }
+        validatedOps.push({ op: "hardDelete", table: item.table, pk: item.pk });
       } else {
         return c.json({ error: \`Unknown op "\${item?.op}" at index \${i}\`, failedAt: i }, 400);
       }
@@ -5935,6 +5951,18 @@ const log = {
   error: (...args: any[]) => console.error("[sdk]", ...args),
 };
 
+/**
+ * Checks if a Postgres error is a client input error (invalid syntax, out of range, etc.)
+ * PG error class 22 = "data exception" — covers invalid input syntax for uuid, int, json, etc.
+ * PG error code 23502 = "not_null_violation", 23505 = "unique_violation", 23503 = "foreign_key_violation"
+ */
+function pgErrorStatus(e: any): number {
+  const code = e?.code;
+  if (typeof code === "string" && code.startsWith("22")) return 400;
+  if (code === "23502" || code === "23505" || code === "23503") return 409;
+  return 500;
+}
+
 /**
  * Builds SQL column list from select/exclude parameters
  * @param select - Columns to include (mutually exclusive with exclude)
@@ -6035,22 +6063,13 @@ export async function createRecord(
 
     return { data: parsedRows[0] ?? null, status: parsedRows[0] ? 201 : 500 };
   } catch (e: any) {
-    // Enhanced logging for JSON validation errors
-    const errorMsg = e?.message ?? "";
-    const isJsonError = errorMsg.includes("invalid input syntax for type json");
-
-    if (isJsonError) {
-      log.error(\`POST \${ctx.table} - Invalid JSON input detected!\`);
-      log.error("Input data that caused error:", JSON.stringify(data, null, 2));
-      log.error("PostgreSQL error:", errorMsg);
-    } else {
-      log.error(\`POST \${ctx.table} error:\`, e?.stack ?? e);
-    }
+    const status = pgErrorStatus(e);
+    log.error(\`POST \${ctx.table} error:\`, e?.stack ?? e);
 
     return {
       error: e?.message ?? "Internal error",
       ...(DEBUG ? { stack: e?.stack } : {}),
-      status: 500
+      status
     };
   }
 }
@@ -6125,22 +6144,12 @@ export async function upsertRecord(
 
     return { data: parsedRows[0], status: 200 };
   } catch (e: any) {
-    const errorMsg = e?.message ?? "";
-    const isJsonError = errorMsg.includes("invalid input syntax for type json");
-    if (isJsonError) {
-      log.error(\`UPSERT \${ctx.table} - Invalid JSON input detected!\`);
-      log.error("Input args that caused error:", JSON.stringify(args, null, 2));
-      log.error("Filtered update data (sent to DB):", JSON.stringify(Object.fromEntries(
-        Object.entries(args.update).filter(([k]) => !ctx.pkColumns.includes(k))
-      ), null, 2));
-      log.error("PostgreSQL error:", errorMsg);
-    } else {
-      log.error(\`UPSERT \${ctx.table} error:\`, e?.stack ?? e);
-    }
+    const status = pgErrorStatus(e);
+    log.error(\`UPSERT \${ctx.table} error:\`, e?.stack ?? e);
     return {
       error: e?.message ?? "Internal error",
       ...(DEBUG ? { stack: e?.stack } : {}),
-      status: 500
+      status
     };
   }
 }
@@ -6173,11 +6182,12 @@ export async function getByPk(
 
     return { data: parsedRows[0], status: 200 };
   } catch (e: any) {
+    const status = pgErrorStatus(e);
     log.error(\`GET \${ctx.table} error:\`, e?.stack ?? e);
-    return { 
-      error: e?.message ?? "Internal error", 
+    return {
+      error: e?.message ?? "Internal error",
       ...(DEBUG ? { stack: e?.stack } : {}),
-      status: 500 
+      status
     };
   }
 }
@@ -6726,22 +6736,13 @@ export async function listRecords(
     log.debug(\`LIST \${ctx.table} result: \${rows.length} rows, \${total} total, hasMore=\${hasMore}\`);
     return metadata;
   } catch (e: any) {
-    // Enhanced logging for JSON validation errors
-    const errorMsg = e?.message ?? "";
-    const isJsonError = errorMsg.includes("invalid input syntax for type json");
-
-    if (isJsonError) {
-      log.error(\`LIST \${ctx.table} - Invalid JSON input detected in query!\`);
-      log.error("WHERE clause:", JSON.stringify(params.where, null, 2));
-      log.error("PostgreSQL error:", errorMsg);
-    } else {
-      log.error(\`LIST \${ctx.table} error:\`, e?.stack ?? e);
-    }
+    const status = pgErrorStatus(e);
+    log.error(\`LIST \${ctx.table} error:\`, e?.stack ?? e);
 
     return {
       error: e?.message ?? "Internal error",
       ...(DEBUG ? { stack: e?.stack } : {}),
-      status: 500
+      status
     };
   }
 }
@@ -6793,25 +6794,13 @@ export async function updateRecord(
 
     return { data: parsedRows[0], status: 200 };
   } catch (e: any) {
-    // Enhanced logging for JSON validation errors
-    const errorMsg = e?.message ?? "";
-    const isJsonError = errorMsg.includes("invalid input syntax for type json");
-
-    if (isJsonError) {
-      log.error(\`PATCH \${ctx.table} - Invalid JSON input detected!\`);
-      log.error("Input data that caused error:", JSON.stringify(updateData, null, 2));
-      log.error("Filtered data (sent to DB):", JSON.stringify(Object.fromEntries(
-        Object.entries(updateData).filter(([k]) => !ctx.pkColumns.includes(k))
-      ), null, 2));
-      log.error("PostgreSQL error:", errorMsg);
-    } else {
-      log.error(\`PATCH \${ctx.table} error:\`, e?.stack ?? e);
-    }
+    const status = pgErrorStatus(e);
+    log.error(\`PATCH \${ctx.table} error:\`, e?.stack ?? e);
 
     return {
       error: e?.message ?? "Internal error",
       ...(DEBUG ? { stack: e?.stack } : {}),
-      status: 500
+      status
     };
   }
 }
@@ -6846,11 +6835,12 @@ export async function deleteRecord(
 
     return { data: parsedRows[0], status: 200 };
   } catch (e: any) {
+    const status = pgErrorStatus(e);
     log.error(\`DELETE \${ctx.table} error:\`, e?.stack ?? e);
     return {
       error: e?.message ?? "Internal error",
       ...(DEBUG ? { stack: e?.stack } : {}),
-      status: 500
+      status
     };
   }
 }
@@ -6873,7 +6863,8 @@ export interface TransactionTableMetadata {
 export type TransactionOperation =
   | { op: "create"; table: string; data: Record<string, unknown> }
   | { op: "update"; table: string; pk: string | Record<string, unknown>; data: Record<string, unknown> }
-  | { op: "delete"; table: string; pk: string | Record<string, unknown> }
+  | { op: "softDelete"; table: string; pk: string | Record<string, unknown> }
+  | { op: "hardDelete"; table: string; pk: string | Record<string, unknown> }
   | { op: "upsert"; table: string; data: { where: Record<string, unknown>; create: Record<string, unknown>; update: Record<string, unknown> } };
 
 /**
@@ -6941,6 +6932,8 @@ export async function executeTransaction(
           : [op.pk];
         result = op.op === "update"
           ? await updateRecord(ctx, pkValues as string[], op.data)
+          : op.op === "hardDelete"
+          ? await deleteRecord(ctx, pkValues as string[], { hard: true })
           : await deleteRecord(ctx, pkValues as string[]);
       }
 

package/dist/index.js

@@ -1863,7 +1863,7 @@ function emitZod(table, opts, enums) {
       return `z.enum([${values}])`;
     }
     if (t === "uuid")
-      return `z.string()`;
+      return `z.string().uuid()`;
     if (t === "bool" || t === "boolean")
       return `z.boolean()`;
     if (t === "int2" || t === "int4" || t === "int8") {
@@ -2702,6 +2702,20 @@ function emitClient(table, graph, opts, model) {
     deleteMethodParts.push(buildDeleteMethod("hardDelete", hasSoftDelete));
   const deleteMethodsCode = deleteMethodParts.join(`
 
+`);
+  const txDeleteParts = [];
+  if (hasSoftDelete)
+    txDeleteParts.push(`  /** Build a lazy soft-DELETE descriptor for use with sdk.$transaction([...]) */
+` + `  $softDelete(pk: ${pkType}): TxOp<Select${Type} | null> {
+` + `    return { _table: "${table.name}", _op: "softDelete", _pk: ${hasCompositePk ? "pk as Record<string, unknown>" : "pk"} };
+` + `  }`);
+  if (exposeHard)
+    txDeleteParts.push(`  /** Build a lazy hard-DELETE descriptor for use with sdk.$transaction([...]) */
+` + `  $hardDelete(pk: ${pkType}): TxOp<Select${Type} | null> {
+` + `    return { _table: "${table.name}", _op: "hardDelete", _pk: ${hasCompositePk ? "pk as Record<string, unknown>" : "pk"} };
+` + `  }`);
+  const txDeleteMethodsCode = txDeleteParts.join(`
+
 `);
   return `/**
  * AUTO-GENERATED FILE - DO NOT EDIT
@@ -3218,10 +3232,7 @@ ${deleteMethodsCode}
     return { _table: "${table.name}", _op: "update", _pk: ${hasCompositePk ? "pk as Record<string, unknown>" : "pk"}, _data: data as Record<string, unknown> };
   }
 
-  /** Build a lazy DELETE descriptor for use with sdk.$transaction([...]) */
-  $delete(pk: ${pkType}): TxOp<Select${Type} | null> {
-    return { _table: "${table.name}", _op: "delete", _pk: ${hasCompositePk ? "pk as Record<string, unknown>" : "pk"} };
-  }
+${txDeleteMethodsCode}
 
   /** Build a lazy UPSERT descriptor for use with sdk.$transaction([...]) */
   $upsert(args: { where: Update${Type}; create: Insert${Type}; update: Update${Type} }): TxOp<Select${Type}> {
@@ -3575,13 +3586,13 @@ export abstract class BaseClient {
 }
 
 /**
- * Lazy operation descriptor returned by $create/$update/$delete.
+ * Lazy operation descriptor returned by $create/$update/$softDelete/$hardDelete/$upsert.
  * \`__resultType\` is a phantom field — never assigned at runtime, exists only
  * so TypeScript can infer the correct tuple element type inside \`$transaction\`.
  */
 export type TxOp<T = unknown> = {
   readonly _table: string;
-  readonly _op: "create" | "update" | "delete" | "upsert";
+  readonly _op: "create" | "update" | "softDelete" | "hardDelete" | "upsert";
   readonly _data?: Record<string, unknown>;
   readonly _pk?: string | Record<string, unknown>;
   /** @internal */
@@ -4659,11 +4670,16 @@ function emitHonoRouter(tables, hasAuth, useJsExtensions, pullToken, opts) {
           return c.json({ error: \`Missing pk at index \${i}\`, failedAt: i }, 400);
         }
         validatedOps.push({ op: "update", table: item.table, pk: item.pk, data: parsed.data });
-      } else if (item.op === "delete") {
+      } else if (item.op === "softDelete") {
         if (item.pk == null) {
           return c.json({ error: \`Missing pk at index \${i}\`, failedAt: i }, 400);
         }
-        validatedOps.push({ op: "delete", table: item.table, pk: item.pk });
+        validatedOps.push({ op: "softDelete", table: item.table, pk: item.pk });
+      } else if (item.op === "hardDelete") {
+        if (item.pk == null) {
+          return c.json({ error: \`Missing pk at index \${i}\`, failedAt: i }, 400);
+        }
+        validatedOps.push({ op: "hardDelete", table: item.table, pk: item.pk });
       } else {
         return c.json({ error: \`Unknown op "\${item?.op}" at index \${i}\`, failedAt: i }, 400);
       }
@@ -4975,6 +4991,18 @@ const log = {
   error: (...args: any[]) => console.error("[sdk]", ...args),
 };
 
+/**
+ * Checks if a Postgres error is a client input error (invalid syntax, out of range, etc.)
+ * PG error class 22 = "data exception" — covers invalid input syntax for uuid, int, json, etc.
+ * PG error code 23502 = "not_null_violation", 23505 = "unique_violation", 23503 = "foreign_key_violation"
+ */
+function pgErrorStatus(e: any): number {
+  const code = e?.code;
+  if (typeof code === "string" && code.startsWith("22")) return 400;
+  if (code === "23502" || code === "23505" || code === "23503") return 409;
+  return 500;
+}
+
 /**
  * Builds SQL column list from select/exclude parameters
  * @param select - Columns to include (mutually exclusive with exclude)
@@ -5075,22 +5103,13 @@ export async function createRecord(
 
     return { data: parsedRows[0] ?? null, status: parsedRows[0] ? 201 : 500 };
   } catch (e: any) {
-    // Enhanced logging for JSON validation errors
-    const errorMsg = e?.message ?? "";
-    const isJsonError = errorMsg.includes("invalid input syntax for type json");
-
-    if (isJsonError) {
-      log.error(\`POST \${ctx.table} - Invalid JSON input detected!\`);
-      log.error("Input data that caused error:", JSON.stringify(data, null, 2));
-      log.error("PostgreSQL error:", errorMsg);
-    } else {
-      log.error(\`POST \${ctx.table} error:\`, e?.stack ?? e);
-    }
+    const status = pgErrorStatus(e);
+    log.error(\`POST \${ctx.table} error:\`, e?.stack ?? e);
 
     return {
       error: e?.message ?? "Internal error",
       ...(DEBUG ? { stack: e?.stack } : {}),
-      status: 500
+      status
     };
   }
 }
@@ -5165,22 +5184,12 @@ export async function upsertRecord(
 
     return { data: parsedRows[0], status: 200 };
   } catch (e: any) {
-    const errorMsg = e?.message ?? "";
-    const isJsonError = errorMsg.includes("invalid input syntax for type json");
-    if (isJsonError) {
-      log.error(\`UPSERT \${ctx.table} - Invalid JSON input detected!\`);
-      log.error("Input args that caused error:", JSON.stringify(args, null, 2));
-      log.error("Filtered update data (sent to DB):", JSON.stringify(Object.fromEntries(
-        Object.entries(args.update).filter(([k]) => !ctx.pkColumns.includes(k))
-      ), null, 2));
-      log.error("PostgreSQL error:", errorMsg);
-    } else {
-      log.error(\`UPSERT \${ctx.table} error:\`, e?.stack ?? e);
-    }
+    const status = pgErrorStatus(e);
+    log.error(\`UPSERT \${ctx.table} error:\`, e?.stack ?? e);
     return {
       error: e?.message ?? "Internal error",
       ...(DEBUG ? { stack: e?.stack } : {}),
-      status: 500
+      status
     };
   }
 }
@@ -5213,11 +5222,12 @@ export async function getByPk(
 
     return { data: parsedRows[0], status: 200 };
   } catch (e: any) {
+    const status = pgErrorStatus(e);
     log.error(\`GET \${ctx.table} error:\`, e?.stack ?? e);
-    return { 
-      error: e?.message ?? "Internal error", 
+    return {
+      error: e?.message ?? "Internal error",
       ...(DEBUG ? { stack: e?.stack } : {}),
-      status: 500 
+      status
     };
   }
 }
@@ -5766,22 +5776,13 @@ export async function listRecords(
     log.debug(\`LIST \${ctx.table} result: \${rows.length} rows, \${total} total, hasMore=\${hasMore}\`);
     return metadata;
   } catch (e: any) {
-    // Enhanced logging for JSON validation errors
-    const errorMsg = e?.message ?? "";
-    const isJsonError = errorMsg.includes("invalid input syntax for type json");
-
-    if (isJsonError) {
-      log.error(\`LIST \${ctx.table} - Invalid JSON input detected in query!\`);
-      log.error("WHERE clause:", JSON.stringify(params.where, null, 2));
-      log.error("PostgreSQL error:", errorMsg);
-    } else {
-      log.error(\`LIST \${ctx.table} error:\`, e?.stack ?? e);
-    }
+    const status = pgErrorStatus(e);
+    log.error(\`LIST \${ctx.table} error:\`, e?.stack ?? e);
 
     return {
       error: e?.message ?? "Internal error",
       ...(DEBUG ? { stack: e?.stack } : {}),
-      status: 500
+      status
     };
   }
 }
@@ -5833,25 +5834,13 @@ export async function updateRecord(
 
     return { data: parsedRows[0], status: 200 };
   } catch (e: any) {
-    // Enhanced logging for JSON validation errors
-    const errorMsg = e?.message ?? "";
-    const isJsonError = errorMsg.includes("invalid input syntax for type json");
-
-    if (isJsonError) {
-      log.error(\`PATCH \${ctx.table} - Invalid JSON input detected!\`);
-      log.error("Input data that caused error:", JSON.stringify(updateData, null, 2));
-      log.error("Filtered data (sent to DB):", JSON.stringify(Object.fromEntries(
-        Object.entries(updateData).filter(([k]) => !ctx.pkColumns.includes(k))
-      ), null, 2));
-      log.error("PostgreSQL error:", errorMsg);
-    } else {
-      log.error(\`PATCH \${ctx.table} error:\`, e?.stack ?? e);
-    }
+    const status = pgErrorStatus(e);
+    log.error(\`PATCH \${ctx.table} error:\`, e?.stack ?? e);
 
     return {
       error: e?.message ?? "Internal error",
       ...(DEBUG ? { stack: e?.stack } : {}),
-      status: 500
+      status
     };
   }
 }
@@ -5886,11 +5875,12 @@ export async function deleteRecord(
 
     return { data: parsedRows[0], status: 200 };
   } catch (e: any) {
+    const status = pgErrorStatus(e);
     log.error(\`DELETE \${ctx.table} error:\`, e?.stack ?? e);
     return {
       error: e?.message ?? "Internal error",
       ...(DEBUG ? { stack: e?.stack } : {}),
-      status: 500
+      status
     };
   }
 }
@@ -5913,7 +5903,8 @@ export interface TransactionTableMetadata {
 export type TransactionOperation =
   | { op: "create"; table: string; data: Record<string, unknown> }
   | { op: "update"; table: string; pk: string | Record<string, unknown>; data: Record<string, unknown> }
-  | { op: "delete"; table: string; pk: string | Record<string, unknown> }
+  | { op: "softDelete"; table: string; pk: string | Record<string, unknown> }
+  | { op: "hardDelete"; table: string; pk: string | Record<string, unknown> }
   | { op: "upsert"; table: string; data: { where: Record<string, unknown>; create: Record<string, unknown>; update: Record<string, unknown> } };
 
 /**
@@ -5981,6 +5972,8 @@ export async function executeTransaction(
           : [op.pk];
         result = op.op === "update"
           ? await updateRecord(ctx, pkValues as string[], op.data)
+          : op.op === "hardDelete"
+          ? await deleteRecord(ctx, pkValues as string[], { hard: true })
           : await deleteRecord(ctx, pkValues as string[]);
       }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postgresdk",
-  "version": "0.19.0",
+  "version": "0.19.2",
   "description": "Generate a typed server/client SDK from a Postgres schema (includes, Zod, Hono).",
   "type": "module",
   "bin": {