postgresdk 0.18.22 → 0.18.23

package/README.md

@@ -146,6 +146,10 @@ 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")
+  softDeleteColumnOverrides: {         // Per-table overrides (null = disable soft delete for that table)
+    // captures: "hidden_at",          //   different column name for a specific table
+    // audit_logs: null,               //   hard deletes only for this table
+  },
   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
@@ -738,6 +742,11 @@ const nested = await sdk.users.list({
   }
 });
 
+// Soft deletes — when softDeleteColumn is configured, deleted records are hidden by default.
+// Pass includeSoftDeleted: true to opt into seeing them (e.g., for admin/recovery UIs).
+const allUsers = await sdk.users.list({ includeSoftDeleted: true });
+const deletedUser = await sdk.users.getByPk("123", { includeSoftDeleted: true });
+
 // Pagination with filtered results
 let allResults = [];
 let offset = 0;

package/dist/cli.js

@@ -3273,7 +3273,8 @@ const deleteSchema = z.object({
 
 const getByPkQuerySchema = z.object({
   select: z.array(z.string()).min(1).optional(),
-  exclude: z.array(z.string()).min(1).optional()
+  exclude: z.array(z.string()).min(1).optional(),
+  includeSoftDeleted: z.boolean().optional()
 }).strict().refine(
   (data) => !(data.select && data.exclude),
   { message: "Cannot specify both 'select' and 'exclude' parameters" }
@@ -3288,7 +3289,8 @@ const listSchema = z.object({
   offset: z.number().int().min(0).optional(),
   orderBy: z.union([columnEnum, z.array(columnEnum)]).optional(),
   order: z.union([z.enum(["asc", "desc"]), z.array(z.enum(["asc", "desc"]))]).optional(),
-  distinctOn: z.union([columnEnum, z.array(columnEnum)]).optional(),${hasVectorColumns ? `
+  distinctOn: z.union([columnEnum, z.array(columnEnum)]).optional(),
+  includeSoftDeleted: z.boolean().optional(),${hasVectorColumns ? `
   vector: z.object({
     field: z.string(),
     query: z.array(z.number()),
@@ -3385,12 +3387,15 @@ ${hasAuth ? `
   app.get(\`\${base}/${pkPath}\`, async (c) => {
     ${getPkParams}
 
-    // Parse query params for select/exclude
+    // Parse query params — coerce includeSoftDeleted string to boolean before Zod validation
+    // (avoids Boolean("false")=true pitfall while keeping schema as single source of truth)
     const selectParam = c.req.query("select");
     const excludeParam = c.req.query("exclude");
+    const includeSoftDeletedParam = c.req.query("includeSoftDeleted");
     const queryData: any = {};
     if (selectParam) queryData.select = selectParam.split(",");
     if (excludeParam) queryData.exclude = excludeParam.split(",");
+    if (includeSoftDeletedParam !== undefined) queryData.includeSoftDeleted = includeSoftDeletedParam === "true";
 
     const queryParsed = getByPkQuerySchema.safeParse(queryData);
     if (!queryParsed.success) {
@@ -3403,7 +3408,7 @@ ${hasAuth ? `
     }
 
     const ctx = { ...baseCtx, select: queryParsed.data.select, exclude: queryParsed.data.exclude };
-    const result = await coreOps.getByPk(ctx, pkValues);
+    const result = await coreOps.getByPk(ctx, pkValues, { includeSoftDeleted: queryParsed.data.includeSoftDeleted });
 
     if (result.error) {
       return c.json({ error: result.error }, result.status as any);
@@ -3909,14 +3914,14 @@ ${hasJsonbColumns ? `  /**
    * @param options - Select specific fields to return
    * @returns The record with only selected fields if found, null otherwise
    */
-  async getByPk<TJsonb extends Partial<Select${Type}> = {}>(pk: ${pkType}, options: { select: string[] }): Promise<Partial<Select${Type}<TJsonb>> | null>;
+  async getByPk<TJsonb extends Partial<Select${Type}> = {}>(pk: ${pkType}, options: { select: string[]; includeSoftDeleted?: boolean }): Promise<Partial<Select${Type}<TJsonb>> | null>;
   /**
    * Get a ${table.name} record by primary key with field exclusion
    * @param pk - The primary key value${hasCompositePk ? "s" : ""}
    * @param options - Exclude specific fields from return
    * @returns The record without excluded fields if found, null otherwise
    */
-  async getByPk<TJsonb extends Partial<Select${Type}> = {}>(pk: ${pkType}, options: { exclude: string[] }): Promise<Partial<Select${Type}<TJsonb>> | null>;
+  async getByPk<TJsonb extends Partial<Select${Type}> = {}>(pk: ${pkType}, options: { exclude: string[]; includeSoftDeleted?: boolean }): Promise<Partial<Select${Type}<TJsonb>> | null>;
   /**
    * Get a ${table.name} record by primary key
    * @param pk - The primary key value${hasCompositePk ? "s" : ""}
@@ -3925,15 +3930,16 @@ ${hasJsonbColumns ? `  /**
    * // With JSONB type override:
    * const user = await client.getByPk<{ metadata: Metadata }>('user-id');
    */
-  async getByPk<TJsonb extends Partial<Select${Type}> = {}>(pk: ${pkType}, options?: Omit<{ select?: string[]; exclude?: string[] }, 'select' | 'exclude'>): Promise<Select${Type}<TJsonb> | null>;
+  async getByPk<TJsonb extends Partial<Select${Type}> = {}>(pk: ${pkType}, options?: { includeSoftDeleted?: boolean }): Promise<Select${Type}<TJsonb> | null>;
   async getByPk<TJsonb extends Partial<Select${Type}> = {}>(
     pk: ${pkType},
-    options?: { select?: string[]; exclude?: string[] }
+    options?: { select?: string[]; exclude?: string[]; includeSoftDeleted?: boolean }
   ): Promise<Select${Type}<TJsonb> | Partial<Select${Type}<TJsonb>> | null> {
     const path = ${pkPathExpr};
     const queryParams = new URLSearchParams();
     if (options?.select) queryParams.set('select', options.select.join(','));
     if (options?.exclude) queryParams.set('exclude', options.exclude.join(','));
+    if (options?.includeSoftDeleted) queryParams.set('includeSoftDeleted', 'true');
     const query = queryParams.toString();
     const url = query ? \`\${this.resource}/\${path}?\${query}\` : \`\${this.resource}/\${path}\`;
     return this.get<Select${Type}<TJsonb> | null>(url);
@@ -3943,28 +3949,29 @@ ${hasJsonbColumns ? `  /**
    * @param options - Select specific fields to return
    * @returns The record with only selected fields if found, null otherwise
    */
-  async getByPk(pk: ${pkType}, options: { select: string[] }): Promise<Partial<Select${Type}> | null>;
+  async getByPk(pk: ${pkType}, options: { select: string[]; includeSoftDeleted?: boolean }): Promise<Partial<Select${Type}> | null>;
   /**
    * Get a ${table.name} record by primary key with field exclusion
    * @param pk - The primary key value${hasCompositePk ? "s" : ""}
    * @param options - Exclude specific fields from return
    * @returns The record without excluded fields if found, null otherwise
    */
-  async getByPk(pk: ${pkType}, options: { exclude: string[] }): Promise<Partial<Select${Type}> | null>;
+  async getByPk(pk: ${pkType}, options: { exclude: string[]; includeSoftDeleted?: boolean }): Promise<Partial<Select${Type}> | null>;
   /**
    * Get a ${table.name} record by primary key
    * @param pk - The primary key value${hasCompositePk ? "s" : ""}
    * @returns The record with all fields if found, null otherwise
    */
-  async getByPk(pk: ${pkType}, options?: Omit<{ select?: string[]; exclude?: string[] }, 'select' | 'exclude'>): Promise<Select${Type} | null>;
+  async getByPk(pk: ${pkType}, options?: { includeSoftDeleted?: boolean }): Promise<Select${Type} | null>;
   async getByPk(
     pk: ${pkType},
-    options?: { select?: string[]; exclude?: string[] }
+    options?: { select?: string[]; exclude?: string[]; includeSoftDeleted?: boolean }
   ): Promise<Select${Type} | Partial<Select${Type}> | null> {
     const path = ${pkPathExpr};
     const queryParams = new URLSearchParams();
     if (options?.select) queryParams.set('select', options.select.join(','));
     if (options?.exclude) queryParams.set('exclude', options.exclude.join(','));
+    if (options?.includeSoftDeleted) queryParams.set('includeSoftDeleted', 'true');
     const query = queryParams.toString();
     const url = query ? \`\${this.resource}/\${path}?\${query}\` : \`\${this.resource}/\${path}\`;
     return this.get<Select${Type} | null>(url);
@@ -3991,6 +3998,7 @@ ${hasJsonbColumns ? `  /**
     orderBy?: string | string[];
     order?: "asc" | "desc" | ("asc" | "desc")[];
     distinctOn?: string | string[];
+    includeSoftDeleted?: boolean;
   }): Promise<PaginatedResponse<Partial<Select${Type}<TJsonb>> & { _similarity?: number }${hasVectorColumns ? " & { _distance?: number }" : ""}>>;
   /**
    * List ${table.name} records with field exclusion
@@ -4013,6 +4021,7 @@ ${hasJsonbColumns ? `  /**
     orderBy?: string | string[];
     order?: "asc" | "desc" | ("asc" | "desc")[];
     distinctOn?: string | string[];
+    includeSoftDeleted?: boolean;
   }): Promise<PaginatedResponse<Partial<Select${Type}<TJsonb>> & { _similarity?: number }${hasVectorColumns ? " & { _distance?: number }" : ""}>>;
   /**
    * List ${table.name} records with pagination and filtering
@@ -4046,6 +4055,7 @@ ${hasJsonbColumns ? `  /**
     orderBy?: string | string[];
     order?: "asc" | "desc" | ("asc" | "desc")[];
     distinctOn?: string | string[];
+    includeSoftDeleted?: boolean;
   }): Promise<PaginatedResponse<${Type}WithIncludes<TInclude> & { _similarity?: number }${hasVectorColumns ? " & { _distance?: number }" : ""}>>;
   async list<TJsonb extends Partial<Select${Type}> = {}>(params?: {
     include?: ${Type}IncludeSpec;
@@ -4064,6 +4074,7 @@ ${hasJsonbColumns ? `  /**
     orderBy?: string | string[];
     order?: "asc" | "desc" | ("asc" | "desc")[];
     distinctOn?: string | string[];
+    includeSoftDeleted?: boolean;
   }): Promise<PaginatedResponse<Select${Type}<TJsonb> | Partial<Select${Type}<TJsonb>>>> {
     return this.post<PaginatedResponse<Select${Type}<TJsonb> & { _similarity?: number }${hasVectorColumns ? " & { _distance?: number }" : ""}>>(\`\${this.resource}/list\`, params ?? {});
   }` : `  /**
@@ -4087,6 +4098,7 @@ ${hasJsonbColumns ? `  /**
     orderBy?: string | string[];
     order?: "asc" | "desc" | ("asc" | "desc")[];
     distinctOn?: string | string[];
+    includeSoftDeleted?: boolean;
   }): Promise<PaginatedResponse<Partial<Select${Type}> & { _similarity?: number }${hasVectorColumns ? " & { _distance?: number }" : ""}>>;
   /**
    * List ${table.name} records with field exclusion
@@ -4109,6 +4121,7 @@ ${hasJsonbColumns ? `  /**
     orderBy?: string | string[];
     order?: "asc" | "desc" | ("asc" | "desc")[];
     distinctOn?: string | string[];
+    includeSoftDeleted?: boolean;
   }): Promise<PaginatedResponse<Partial<Select${Type}> & { _similarity?: number }${hasVectorColumns ? " & { _distance?: number }" : ""}>>;
   /**
    * List ${table.name} records with pagination and filtering
@@ -4136,6 +4149,7 @@ ${hasJsonbColumns ? `  /**
     orderBy?: string | string[];
     order?: "asc" | "desc" | ("asc" | "desc")[];
     distinctOn?: string | string[];
+    includeSoftDeleted?: boolean;
   }): Promise<PaginatedResponse<${Type}WithIncludes<TInclude> & { _similarity?: number }${hasVectorColumns ? " & { _distance?: number }" : ""}>>;
   async list(params?: {
     include?: ${Type}IncludeSpec;
@@ -4154,6 +4168,7 @@ ${hasJsonbColumns ? `  /**
     orderBy?: string | string[];
     order?: "asc" | "desc" | ("asc" | "desc")[];
     distinctOn?: string | string[];
+    includeSoftDeleted?: boolean;
   }): Promise<PaginatedResponse<Select${Type} | Partial<Select${Type}>>> {
     return this.post<PaginatedResponse<Select${Type} & { _similarity?: number }${hasVectorColumns ? " & { _distance?: number }" : ""}>>(\`\${this.resource}/list\`, params ?? {});
   }`}
@@ -5980,7 +5995,8 @@ export async function createRecord(
  */
 export async function getByPk(
   ctx: OperationContext,
-  pkValues: any[]
+  pkValues: any[],
+  opts?: { includeSoftDeleted?: boolean }
 ): Promise<{ data?: any; error?: string; status: number }> {
   try {
     const hasCompositePk = ctx.pkColumns.length > 1;
@@ -5989,7 +6005,8 @@ export async function getByPk(
       : \`"\${ctx.pkColumns[0]}" = $1\`;
 
     const columns = buildColumnList(ctx.select, ctx.exclude, ctx.allColumnNames);
-    const text = \`SELECT \${columns} FROM "\${ctx.table}" WHERE \${wherePkSql} LIMIT 1\`;
+    const softDeleteFilter = ctx.softDeleteColumn && !opts?.includeSoftDeleted ? \` AND "\${ctx.softDeleteColumn}" IS NULL\` : "";
+    const text = \`SELECT \${columns} FROM "\${ctx.table}" WHERE \${wherePkSql}\${softDeleteFilter} LIMIT 1\`;
     log.debug(\`GET \${ctx.table} by PK:\`, pkValues, "SQL:", text);
 
     const { rows } = await ctx.pg.query(text, pkValues);
@@ -6362,6 +6379,7 @@ export async function listRecords(
     orderBy?: string | string[];
     order?: "asc" | "desc" | ("asc" | "desc")[];
     distinctOn?: string | string[];
+    includeSoftDeleted?: boolean;
     vector?: {
       field: string;
       query: number[];
@@ -6372,7 +6390,7 @@ export async function listRecords(
   }
 ): Promise<{ data?: any; total?: number; limit?: number; offset?: number; hasMore?: boolean; error?: string; issues?: any; needsIncludes?: boolean; includeSpec?: any; status: number }> {
   try {
-    const { where: whereClause, limit = 50, offset = 0, include, orderBy, order, vector, trigram, distinctOn } = params;
+    const { where: whereClause, limit = 50, offset = 0, include, orderBy, order, vector, trigram, distinctOn, includeSoftDeleted } = params;
 
     // DISTINCT ON support
     const distinctCols: string[] | null = distinctOn ? (Array.isArray(distinctOn) ? distinctOn : [distinctOn]) : null;
@@ -6408,8 +6426,8 @@ export async function listRecords(
     const whereParts: string[] = [];
     let whereParams: any[] = [];
 
-    // Add soft delete filter if applicable
-    if (ctx.softDeleteColumn) {
+    // Add soft delete filter if applicable (skip if caller opts into seeing soft-deleted records)
+    if (ctx.softDeleteColumn && !includeSoftDeleted) {
       whereParts.push(\`"\${ctx.softDeleteColumn}" IS NULL\`);
     }
 
@@ -6447,7 +6465,7 @@ export async function listRecords(
 
     if (hasQueryParam && !hasThreshold && whereParams.length > 0) {
       const countWhereParts: string[] = [];
-      if (ctx.softDeleteColumn) {
+      if (ctx.softDeleteColumn && !includeSoftDeleted) {
         countWhereParts.push(\`"\${ctx.softDeleteColumn}" IS NULL\`);
       }
       if (whereClause) {
@@ -7418,6 +7436,12 @@ init_utils();
 var __filename2 = fileURLToPath(import.meta.url);
 var __dirname2 = dirname2(__filename2);
 var { version: CLI_VERSION } = JSON.parse(readFileSync(join2(__dirname2, "../package.json"), "utf-8"));
+function resolveSoftDeleteColumn(cfg, tableName) {
+  const overrides = cfg.softDeleteColumnOverrides;
+  if (overrides && tableName in overrides)
+    return overrides[tableName] ?? null;
+  return cfg.softDeleteColumn ?? null;
+}
 async function generate(configPath) {
   if (!existsSync2(configPath)) {
     throw new Error(`Config file not found: ${configPath}
@@ -7517,7 +7541,7 @@ async function generate(configPath) {
     let routeContent;
     if (serverFramework === "hono") {
       routeContent = emitHonoRoutes(table, graph, {
-        softDeleteColumn: cfg.softDeleteColumn || null,
+        softDeleteColumn: resolveSoftDeleteColumn(cfg, table.name),
         includeMethodsDepth: cfg.includeMethodsDepth || 2,
         authStrategy: getAuthStrategy(normalizedAuth),
         useJsExtensions: cfg.useJsExtensions,

package/dist/index.d.ts

@@ -1,2 +1,5 @@
 import "dotenv/config";
+import type { Config } from "./types";
+/** Resolves the effective soft delete column for a given table, respecting per-table overrides. */
+export declare function resolveSoftDeleteColumn(cfg: Pick<Config, "softDeleteColumn" | "softDeleteColumnOverrides">, tableName: string): string | null;
 export declare function generate(configPath: string): Promise<void>;

package/dist/index.js

@@ -2312,7 +2312,8 @@ const deleteSchema = z.object({
 
 const getByPkQuerySchema = z.object({
   select: z.array(z.string()).min(1).optional(),
-  exclude: z.array(z.string()).min(1).optional()
+  exclude: z.array(z.string()).min(1).optional(),
+  includeSoftDeleted: z.boolean().optional()
 }).strict().refine(
   (data) => !(data.select && data.exclude),
   { message: "Cannot specify both 'select' and 'exclude' parameters" }
@@ -2327,7 +2328,8 @@ const listSchema = z.object({
   offset: z.number().int().min(0).optional(),
   orderBy: z.union([columnEnum, z.array(columnEnum)]).optional(),
   order: z.union([z.enum(["asc", "desc"]), z.array(z.enum(["asc", "desc"]))]).optional(),
-  distinctOn: z.union([columnEnum, z.array(columnEnum)]).optional(),${hasVectorColumns ? `
+  distinctOn: z.union([columnEnum, z.array(columnEnum)]).optional(),
+  includeSoftDeleted: z.boolean().optional(),${hasVectorColumns ? `
   vector: z.object({
     field: z.string(),
     query: z.array(z.number()),
@@ -2424,12 +2426,15 @@ ${hasAuth ? `
   app.get(\`\${base}/${pkPath}\`, async (c) => {
     ${getPkParams}
 
-    // Parse query params for select/exclude
+    // Parse query params — coerce includeSoftDeleted string to boolean before Zod validation
+    // (avoids Boolean("false")=true pitfall while keeping schema as single source of truth)
     const selectParam = c.req.query("select");
     const excludeParam = c.req.query("exclude");
+    const includeSoftDeletedParam = c.req.query("includeSoftDeleted");
     const queryData: any = {};
     if (selectParam) queryData.select = selectParam.split(",");
     if (excludeParam) queryData.exclude = excludeParam.split(",");
+    if (includeSoftDeletedParam !== undefined) queryData.includeSoftDeleted = includeSoftDeletedParam === "true";
 
     const queryParsed = getByPkQuerySchema.safeParse(queryData);
     if (!queryParsed.success) {
@@ -2442,7 +2447,7 @@ ${hasAuth ? `
     }
 
     const ctx = { ...baseCtx, select: queryParsed.data.select, exclude: queryParsed.data.exclude };
-    const result = await coreOps.getByPk(ctx, pkValues);
+    const result = await coreOps.getByPk(ctx, pkValues, { includeSoftDeleted: queryParsed.data.includeSoftDeleted });
 
     if (result.error) {
       return c.json({ error: result.error }, result.status as any);
@@ -2948,14 +2953,14 @@ ${hasJsonbColumns ? `  /**
    * @param options - Select specific fields to return
    * @returns The record with only selected fields if found, null otherwise
    */
-  async getByPk<TJsonb extends Partial<Select${Type}> = {}>(pk: ${pkType}, options: { select: string[] }): Promise<Partial<Select${Type}<TJsonb>> | null>;
+  async getByPk<TJsonb extends Partial<Select${Type}> = {}>(pk: ${pkType}, options: { select: string[]; includeSoftDeleted?: boolean }): Promise<Partial<Select${Type}<TJsonb>> | null>;
   /**
    * Get a ${table.name} record by primary key with field exclusion
    * @param pk - The primary key value${hasCompositePk ? "s" : ""}
    * @param options - Exclude specific fields from return
    * @returns The record without excluded fields if found, null otherwise
    */
-  async getByPk<TJsonb extends Partial<Select${Type}> = {}>(pk: ${pkType}, options: { exclude: string[] }): Promise<Partial<Select${Type}<TJsonb>> | null>;
+  async getByPk<TJsonb extends Partial<Select${Type}> = {}>(pk: ${pkType}, options: { exclude: string[]; includeSoftDeleted?: boolean }): Promise<Partial<Select${Type}<TJsonb>> | null>;
   /**
    * Get a ${table.name} record by primary key
    * @param pk - The primary key value${hasCompositePk ? "s" : ""}
@@ -2964,15 +2969,16 @@ ${hasJsonbColumns ? `  /**
    * // With JSONB type override:
    * const user = await client.getByPk<{ metadata: Metadata }>('user-id');
    */
-  async getByPk<TJsonb extends Partial<Select${Type}> = {}>(pk: ${pkType}, options?: Omit<{ select?: string[]; exclude?: string[] }, 'select' | 'exclude'>): Promise<Select${Type}<TJsonb> | null>;
+  async getByPk<TJsonb extends Partial<Select${Type}> = {}>(pk: ${pkType}, options?: { includeSoftDeleted?: boolean }): Promise<Select${Type}<TJsonb> | null>;
   async getByPk<TJsonb extends Partial<Select${Type}> = {}>(
     pk: ${pkType},
-    options?: { select?: string[]; exclude?: string[] }
+    options?: { select?: string[]; exclude?: string[]; includeSoftDeleted?: boolean }
   ): Promise<Select${Type}<TJsonb> | Partial<Select${Type}<TJsonb>> | null> {
     const path = ${pkPathExpr};
     const queryParams = new URLSearchParams();
     if (options?.select) queryParams.set('select', options.select.join(','));
     if (options?.exclude) queryParams.set('exclude', options.exclude.join(','));
+    if (options?.includeSoftDeleted) queryParams.set('includeSoftDeleted', 'true');
     const query = queryParams.toString();
     const url = query ? \`\${this.resource}/\${path}?\${query}\` : \`\${this.resource}/\${path}\`;
     return this.get<Select${Type}<TJsonb> | null>(url);
@@ -2982,28 +2988,29 @@ ${hasJsonbColumns ? `  /**
    * @param options - Select specific fields to return
    * @returns The record with only selected fields if found, null otherwise
    */
-  async getByPk(pk: ${pkType}, options: { select: string[] }): Promise<Partial<Select${Type}> | null>;
+  async getByPk(pk: ${pkType}, options: { select: string[]; includeSoftDeleted?: boolean }): Promise<Partial<Select${Type}> | null>;
   /**
    * Get a ${table.name} record by primary key with field exclusion
    * @param pk - The primary key value${hasCompositePk ? "s" : ""}
    * @param options - Exclude specific fields from return
    * @returns The record without excluded fields if found, null otherwise
    */
-  async getByPk(pk: ${pkType}, options: { exclude: string[] }): Promise<Partial<Select${Type}> | null>;
+  async getByPk(pk: ${pkType}, options: { exclude: string[]; includeSoftDeleted?: boolean }): Promise<Partial<Select${Type}> | null>;
   /**
    * Get a ${table.name} record by primary key
    * @param pk - The primary key value${hasCompositePk ? "s" : ""}
    * @returns The record with all fields if found, null otherwise
    */
-  async getByPk(pk: ${pkType}, options?: Omit<{ select?: string[]; exclude?: string[] }, 'select' | 'exclude'>): Promise<Select${Type} | null>;
+  async getByPk(pk: ${pkType}, options?: { includeSoftDeleted?: boolean }): Promise<Select${Type} | null>;
   async getByPk(
     pk: ${pkType},
-    options?: { select?: string[]; exclude?: string[] }
+    options?: { select?: string[]; exclude?: string[]; includeSoftDeleted?: boolean }
   ): Promise<Select${Type} | Partial<Select${Type}> | null> {
     const path = ${pkPathExpr};
     const queryParams = new URLSearchParams();
     if (options?.select) queryParams.set('select', options.select.join(','));
     if (options?.exclude) queryParams.set('exclude', options.exclude.join(','));
+    if (options?.includeSoftDeleted) queryParams.set('includeSoftDeleted', 'true');
     const query = queryParams.toString();
     const url = query ? \`\${this.resource}/\${path}?\${query}\` : \`\${this.resource}/\${path}\`;
     return this.get<Select${Type} | null>(url);
@@ -3030,6 +3037,7 @@ ${hasJsonbColumns ? `  /**
     orderBy?: string | string[];
     order?: "asc" | "desc" | ("asc" | "desc")[];
     distinctOn?: string | string[];
+    includeSoftDeleted?: boolean;
   }): Promise<PaginatedResponse<Partial<Select${Type}<TJsonb>> & { _similarity?: number }${hasVectorColumns ? " & { _distance?: number }" : ""}>>;
   /**
    * List ${table.name} records with field exclusion
@@ -3052,6 +3060,7 @@ ${hasJsonbColumns ? `  /**
     orderBy?: string | string[];
     order?: "asc" | "desc" | ("asc" | "desc")[];
     distinctOn?: string | string[];
+    includeSoftDeleted?: boolean;
   }): Promise<PaginatedResponse<Partial<Select${Type}<TJsonb>> & { _similarity?: number }${hasVectorColumns ? " & { _distance?: number }" : ""}>>;
   /**
    * List ${table.name} records with pagination and filtering
@@ -3085,6 +3094,7 @@ ${hasJsonbColumns ? `  /**
     orderBy?: string | string[];
     order?: "asc" | "desc" | ("asc" | "desc")[];
     distinctOn?: string | string[];
+    includeSoftDeleted?: boolean;
   }): Promise<PaginatedResponse<${Type}WithIncludes<TInclude> & { _similarity?: number }${hasVectorColumns ? " & { _distance?: number }" : ""}>>;
   async list<TJsonb extends Partial<Select${Type}> = {}>(params?: {
     include?: ${Type}IncludeSpec;
@@ -3103,6 +3113,7 @@ ${hasJsonbColumns ? `  /**
     orderBy?: string | string[];
     order?: "asc" | "desc" | ("asc" | "desc")[];
     distinctOn?: string | string[];
+    includeSoftDeleted?: boolean;
   }): Promise<PaginatedResponse<Select${Type}<TJsonb> | Partial<Select${Type}<TJsonb>>>> {
     return this.post<PaginatedResponse<Select${Type}<TJsonb> & { _similarity?: number }${hasVectorColumns ? " & { _distance?: number }" : ""}>>(\`\${this.resource}/list\`, params ?? {});
   }` : `  /**
@@ -3126,6 +3137,7 @@ ${hasJsonbColumns ? `  /**
     orderBy?: string | string[];
     order?: "asc" | "desc" | ("asc" | "desc")[];
     distinctOn?: string | string[];
+    includeSoftDeleted?: boolean;
   }): Promise<PaginatedResponse<Partial<Select${Type}> & { _similarity?: number }${hasVectorColumns ? " & { _distance?: number }" : ""}>>;
   /**
    * List ${table.name} records with field exclusion
@@ -3148,6 +3160,7 @@ ${hasJsonbColumns ? `  /**
     orderBy?: string | string[];
     order?: "asc" | "desc" | ("asc" | "desc")[];
     distinctOn?: string | string[];
+    includeSoftDeleted?: boolean;
   }): Promise<PaginatedResponse<Partial<Select${Type}> & { _similarity?: number }${hasVectorColumns ? " & { _distance?: number }" : ""}>>;
   /**
    * List ${table.name} records with pagination and filtering
@@ -3175,6 +3188,7 @@ ${hasJsonbColumns ? `  /**
     orderBy?: string | string[];
     order?: "asc" | "desc" | ("asc" | "desc")[];
     distinctOn?: string | string[];
+    includeSoftDeleted?: boolean;
   }): Promise<PaginatedResponse<${Type}WithIncludes<TInclude> & { _similarity?: number }${hasVectorColumns ? " & { _distance?: number }" : ""}>>;
   async list(params?: {
     include?: ${Type}IncludeSpec;
@@ -3193,6 +3207,7 @@ ${hasJsonbColumns ? `  /**
     orderBy?: string | string[];
     order?: "asc" | "desc" | ("asc" | "desc")[];
     distinctOn?: string | string[];
+    includeSoftDeleted?: boolean;
   }): Promise<PaginatedResponse<Select${Type} | Partial<Select${Type}>>> {
     return this.post<PaginatedResponse<Select${Type} & { _similarity?: number }${hasVectorColumns ? " & { _distance?: number }" : ""}>>(\`\${this.resource}/list\`, params ?? {});
   }`}
@@ -5019,7 +5034,8 @@ export async function createRecord(
  */
 export async function getByPk(
   ctx: OperationContext,
-  pkValues: any[]
+  pkValues: any[],
+  opts?: { includeSoftDeleted?: boolean }
 ): Promise<{ data?: any; error?: string; status: number }> {
   try {
     const hasCompositePk = ctx.pkColumns.length > 1;
@@ -5028,7 +5044,8 @@ export async function getByPk(
       : \`"\${ctx.pkColumns[0]}" = $1\`;
 
     const columns = buildColumnList(ctx.select, ctx.exclude, ctx.allColumnNames);
-    const text = \`SELECT \${columns} FROM "\${ctx.table}" WHERE \${wherePkSql} LIMIT 1\`;
+    const softDeleteFilter = ctx.softDeleteColumn && !opts?.includeSoftDeleted ? \` AND "\${ctx.softDeleteColumn}" IS NULL\` : "";
+    const text = \`SELECT \${columns} FROM "\${ctx.table}" WHERE \${wherePkSql}\${softDeleteFilter} LIMIT 1\`;
     log.debug(\`GET \${ctx.table} by PK:\`, pkValues, "SQL:", text);
 
     const { rows } = await ctx.pg.query(text, pkValues);
@@ -5401,6 +5418,7 @@ export async function listRecords(
     orderBy?: string | string[];
     order?: "asc" | "desc" | ("asc" | "desc")[];
     distinctOn?: string | string[];
+    includeSoftDeleted?: boolean;
     vector?: {
       field: string;
       query: number[];
@@ -5411,7 +5429,7 @@ export async function listRecords(
   }
 ): Promise<{ data?: any; total?: number; limit?: number; offset?: number; hasMore?: boolean; error?: string; issues?: any; needsIncludes?: boolean; includeSpec?: any; status: number }> {
   try {
-    const { where: whereClause, limit = 50, offset = 0, include, orderBy, order, vector, trigram, distinctOn } = params;
+    const { where: whereClause, limit = 50, offset = 0, include, orderBy, order, vector, trigram, distinctOn, includeSoftDeleted } = params;
 
     // DISTINCT ON support
     const distinctCols: string[] | null = distinctOn ? (Array.isArray(distinctOn) ? distinctOn : [distinctOn]) : null;
@@ -5447,8 +5465,8 @@ export async function listRecords(
     const whereParts: string[] = [];
     let whereParams: any[] = [];
 
-    // Add soft delete filter if applicable
-    if (ctx.softDeleteColumn) {
+    // Add soft delete filter if applicable (skip if caller opts into seeing soft-deleted records)
+    if (ctx.softDeleteColumn && !includeSoftDeleted) {
       whereParts.push(\`"\${ctx.softDeleteColumn}" IS NULL\`);
     }
 
@@ -5486,7 +5504,7 @@ export async function listRecords(
 
     if (hasQueryParam && !hasThreshold && whereParams.length > 0) {
       const countWhereParts: string[] = [];
-      if (ctx.softDeleteColumn) {
+      if (ctx.softDeleteColumn && !includeSoftDeleted) {
         countWhereParts.push(\`"\${ctx.softDeleteColumn}" IS NULL\`);
       }
       if (whereClause) {
@@ -6457,6 +6475,12 @@ init_utils();
 var __filename2 = fileURLToPath(import.meta.url);
 var __dirname2 = dirname2(__filename2);
 var { version: CLI_VERSION } = JSON.parse(readFileSync(join2(__dirname2, "../package.json"), "utf-8"));
+function resolveSoftDeleteColumn(cfg, tableName) {
+  const overrides = cfg.softDeleteColumnOverrides;
+  if (overrides && tableName in overrides)
+    return overrides[tableName] ?? null;
+  return cfg.softDeleteColumn ?? null;
+}
 async function generate(configPath) {
   if (!existsSync2(configPath)) {
     throw new Error(`Config file not found: ${configPath}
@@ -6556,7 +6580,7 @@ async function generate(configPath) {
     let routeContent;
     if (serverFramework === "hono") {
       routeContent = emitHonoRoutes(table, graph, {
-        softDeleteColumn: cfg.softDeleteColumn || null,
+        softDeleteColumn: resolveSoftDeleteColumn(cfg, table.name),
         includeMethodsDepth: cfg.includeMethodsDepth || 2,
         authStrategy: getAuthStrategy(normalizedAuth),
         useJsExtensions: cfg.useJsExtensions,
@@ -6709,5 +6733,6 @@ async function generate(configPath) {
   console.log(`    Then run: postgresdk pull`);
 }
 export {
+  resolveSoftDeleteColumn,
   generate
 };

package/dist/types.d.ts

@@ -23,6 +23,8 @@ export interface Config {
         server: string;
     };
     softDeleteColumn?: string | null;
+    /** Per-table overrides for soft delete column. Use `null` to disable soft deletes for a specific table. */
+    softDeleteColumnOverrides?: Record<string, string | null>;
     dateType?: "date" | "string";
     numericMode?: "string" | "number" | "auto";
     includeMethodsDepth?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postgresdk",
-  "version": "0.18.22",
+  "version": "0.18.23",
   "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:write-files && 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 && bun test test/test-jsonb-array-serialization.test.ts && bun test test/test-trigram-search.test.ts",
+    "test": "bun test:write-files && 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 && bun test test/test-jsonb-array-serialization.test.ts && bun test test/test-trigram-search.test.ts && bun test test/test-soft-delete-config.test.ts",
     "test:write-files": "bun test/test-write-files-if-changed.ts",
     "test:init": "bun test/test-init.ts",
     "test:gen": "bun test/test-gen.ts",