postgresdk 0.19.0 → 0.19.1

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

@@ -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: "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: "delete", table: item.table, pk: item.pk });
+        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);
       }
@@ -6873,7 +6889,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 +6958,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

@@ -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: "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: "delete", table: item.table, pk: item.pk });
+        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);
       }
@@ -5913,7 +5929,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 +5998,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.1",
   "description": "Generate a typed server/client SDK from a Postgres schema (includes, Zod, Hono).",
   "type": "module",
   "bin": {