postgresdk 0.1.2-alpha.2 → 0.1.2-alpha.4

package/README.md

@@ -348,7 +348,23 @@ export default {
 ### API Key Authentication
 
 ```typescript
-// postgresdk.config.ts
+// postgresdk.config.ts - Simplified syntax
+export default {
+  connectionString: "...",
+  auth: {
+    apiKey: "your-api-key"  // Single key shorthand
+  }
+};
+
+// Or multiple keys
+export default {
+  connectionString: "...",
+  auth: {
+    apiKeys: ["key1", "key2", "key3"]
+  }
+};
+
+// Or full syntax with custom header
 export default {
   connectionString: "...",
   auth: {
@@ -373,7 +389,15 @@ const sdk = new SDK({
 ### JWT Authentication (HS256)
 
 ```typescript
-// postgresdk.config.ts
+// postgresdk.config.ts - Simplified syntax
+export default {
+  connectionString: "...",
+  auth: {
+    jwt: "your-secret-key"  // Shared secret shorthand
+  }
+};
+
+// Or full syntax with issuer/audience validation
 export default {
   connectionString: "...",
   auth: {

package/dist/cli.js

@@ -958,13 +958,116 @@ function emitClient(table) {
   const pkType = hasCompositePk ? `{ ${safePk.map((c) => `${c}: string`).join("; ")} }` : `string`;
   const pkPathExpr = hasCompositePk ? safePk.map((c) => `pk.${c}`).join(` + "/" + `) : `pk`;
   return `/* Generated. Do not edit. */
+import { BaseClient } from "./base-client";
 import type { ${Type}IncludeSpec } from "./include-spec";
 import type { Insert${Type}, Update${Type}, Select${Type} } from "./types/${table.name}";
 
-type HeaderMap = Record<string, string>;
-type AuthHeadersProvider = () => Promise<HeaderMap> | HeaderMap;
+/**
+ * Client for ${table.name} table operations
+ */
+export class ${Type}Client extends BaseClient {
+  private readonly resource = "/v1/${table.name}";
+
+  async create(data: Insert${Type}): Promise<Select${Type}> {
+    return this.post<Select${Type}>(this.resource, data);
+  }
+
+  async getByPk(pk: ${pkType}): Promise<Select${Type} | null> {
+    const path = ${pkPathExpr};
+    return this.get<Select${Type} | null>(\`\${this.resource}/\${path}\`);
+  }
+
+  async list(params?: { 
+    include?: ${Type}IncludeSpec; 
+    limit?: number; 
+    offset?: number;
+    where?: any;
+    orderBy?: string;
+    order?: "asc" | "desc";
+  }): Promise<Select${Type}[]> {
+    return this.post<Select${Type}[]>(\`\${this.resource}/list\`, params ?? {});
+  }
+
+  async update(pk: ${pkType}, patch: Update${Type}): Promise<Select${Type} | null> {
+    const path = ${pkPathExpr};
+    return this.patch<Select${Type} | null>(\`\${this.resource}/\${path}\`, patch);
+  }
+
+  async delete(pk: ${pkType}): Promise<Select${Type} | null> {
+    const path = ${pkPathExpr};
+    return this.del<Select${Type} | null>(\`\${this.resource}/\${path}\`);
+  }
+}
+`;
+}
+function emitClientIndex(tables) {
+  let out = `/* Generated. Do not edit. */
+`;
+  out += `import { BaseClient, AuthConfig } from "./base-client";
+`;
+  for (const t of tables) {
+    out += `import { ${pascal(t.name)}Client } from "./${t.name}";
+`;
+  }
+  out += `
+// Re-export auth types for convenience
+`;
+  out += `export type { AuthConfig as SDKAuth, AuthConfig, HeaderMap, AuthHeadersProvider } from "./base-client";
+
+`;
+  out += `/**
+`;
+  out += ` * Main SDK class that provides access to all table clients
+`;
+  out += ` */
+`;
+  out += `export class SDK {
+`;
+  for (const t of tables) {
+    out += `  public ${t.name}: ${pascal(t.name)}Client;
+`;
+  }
+  out += `
+  constructor(cfg: { baseUrl: string; fetch?: typeof fetch; auth?: AuthConfig }) {
+`;
+  out += `    const f = cfg.fetch ?? fetch;
+`;
+  for (const t of tables) {
+    out += `    this.${t.name} = new ${pascal(t.name)}Client(cfg.baseUrl, f, cfg.auth);
+`;
+  }
+  out += `  }
+`;
+  out += `}
+
+`;
+  out += `// Export individual table clients
+`;
+  for (const t of tables) {
+    out += `export { ${pascal(t.name)}Client } from "./${t.name}";
+`;
+  }
+  out += `
+// Export base client for custom extensions
+`;
+  out += `export { BaseClient } from "./base-client";
+`;
+  out += `
+// Export include specifications
+`;
+  out += `export * from "./include-spec";
+`;
+  return out;
+}
+
+// src/emit-base-client.ts
+function emitBaseClient() {
+  return `/* Generated. Do not edit. */
+
+export type HeaderMap = Record<string, string>;
+export type AuthHeadersProvider = () => Promise<HeaderMap> | HeaderMap;
 
-type AuthConfig =
+export type AuthConfig =
   | AuthHeadersProvider
   | {
       apiKey?: string;
@@ -976,14 +1079,18 @@ type AuthConfig =
       headers?: AuthHeadersProvider;
     };
 
-export class ${Type}Client {
+/**
+ * Base client class with shared authentication and request handling logic.
+ * All table-specific clients extend this class.
+ */
+export abstract class BaseClient {
   constructor(
-    private baseUrl: string,
-    private fetchFn: typeof fetch = fetch,
-    private auth?: AuthConfig
+    protected baseUrl: string,
+    protected fetchFn: typeof fetch = fetch,
+    protected auth?: AuthConfig
   ) {}
 
-  private async authHeaders(): Promise<HeaderMap> {
+  protected async authHeaders(): Promise<HeaderMap> {
     if (!this.auth) return {};
     if (typeof this.auth === "function") {
       const h = await this.auth();
@@ -1009,129 +1116,91 @@ export class ${Type}Client {
     return out;
   }
 
-  private async headers(json = false) {
+  protected async headers(json = false): Promise<HeaderMap> {
     const extra = await this.authHeaders();
     return json ? { "Content-Type": "application/json", ...extra } : extra;
   }
 
-  private async okOrThrow(res: Response, action: string) {
+  protected async okOrThrow(res: Response, action: string, entity: string): Promise<void> {
     if (!res.ok) {
       let detail = "";
       try { detail = await res.text(); } catch {}
-      throw new Error(\`\${action} ${table.name} failed: \${res.status} \${detail}\`);
+      throw new Error(\`\${action} \${entity} failed: \${res.status} \${detail}\`);
     }
   }
 
-  async create(data: Insert${Type}): Promise<Select${Type}> {
-    const res = await this.fetchFn(\`\${this.baseUrl}/v1/${table.name}\`, {
+  /**
+   * Make a POST request
+   */
+  protected async post<T>(path: string, body?: any): Promise<T> {
+    const res = await this.fetchFn(\`\${this.baseUrl}\${path}\`, {
       method: "POST",
       headers: await this.headers(true),
-      body: JSON.stringify(data),
+      body: JSON.stringify(body),
     });
-    await this.okOrThrow(res, "create");
-    return (await res.json()) as Select${Type};
+    
+    // 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;
   }
 
-  async getByPk(pk: ${pkType}): Promise<Select${Type} | null> {
-    const path = ${pkPathExpr};
-    const res = await this.fetchFn(\`\${this.baseUrl}/v1/${table.name}/\${path}\`, {
+  /**
+   * Make a GET request
+   */
+  protected async get<T>(path: string): Promise<T> {
+    const res = await this.fetchFn(\`\${this.baseUrl}\${path}\`, {
       headers: await this.headers(),
     });
-    if (res.status === 404) return null;
-    await this.okOrThrow(res, "get");
-    return (await res.json()) as Select${Type};
-  }
-
-  async list(params?: { include?: ${Type}IncludeSpec; limit?: number; offset?: number }): Promise<Select${Type}[]> {
-    const res = await this.fetchFn(\`\${this.baseUrl}/v1/${table.name}/list\`, {
-      method: "POST",
-      headers: await this.headers(true),
-      body: JSON.stringify(params ?? {}),
-    });
-    await this.okOrThrow(res, "list");
-    return (await res.json()) as Select${Type}[];
+    
+    if (res.status === 404) {
+      return null as T;
+    }
+    
+    await this.okOrThrow(res, "GET", path);
+    return (await res.json()) as T;
   }
 
-  async update(pk: ${pkType}, patch: Update${Type}): Promise<Select${Type} | null> {
-    const path = ${pkPathExpr};
-    const res = await this.fetchFn(\`\${this.baseUrl}/v1/${table.name}/\${path}\`, {
+  /**
+   * Make a PATCH request
+   */
+  protected async patch<T>(path: string, body?: any): Promise<T> {
+    const res = await this.fetchFn(\`\${this.baseUrl}\${path}\`, {
       method: "PATCH",
       headers: await this.headers(true),
-      body: JSON.stringify(patch),
+      body: JSON.stringify(body),
     });
-    if (res.status === 404) return null;
-    await this.okOrThrow(res, "update");
-    return (await res.json()) as Select${Type};
+    
+    if (res.status === 404) {
+      return null as T;
+    }
+    
+    await this.okOrThrow(res, "PATCH", path);
+    return (await res.json()) as T;
   }
 
-  async delete(pk: ${pkType}): Promise<Select${Type} | null> {
-    const path = ${pkPathExpr};
-    const res = await this.fetchFn(\`\${this.baseUrl}/v1/${table.name}/\${path}\`, {
+  /**
+   * Make a DELETE request
+   */
+  protected async del<T>(path: string): Promise<T> {
+    const res = await this.fetchFn(\`\${this.baseUrl}\${path}\`, {
       method: "DELETE",
       headers: await this.headers(),
     });
-    if (res.status === 404) return null;
-    await this.okOrThrow(res, "delete");
-    return (await res.json()) as Select${Type};
+    
+    if (res.status === 404) {
+      return null as T;
+    }
+    
+    await this.okOrThrow(res, "DELETE", path);
+    return (await res.json()) as T;
   }
 }
 `;
 }
-function emitClientIndex(tables) {
-  let out = `/* Generated. Do not edit. */
-`;
-  for (const t of tables) {
-    out += `import { ${pascal(t.name)}Client } from "./${t.name}";
-`;
-  }
-  out += `
-export type SDKAuthHeadersProvider = () => Promise<Record<string,string>> | Record<string,string>;
-`;
-  out += `export type SDKAuth =
-`;
-  out += `  | SDKAuthHeadersProvider
-`;
-  out += `  | {
-`;
-  out += `      apiKey?: string;
-`;
-  out += `      /** defaults to "x-api-key" */
-`;
-  out += `      apiKeyHeader?: string;
-`;
-  out += `      jwt?: string | (() => Promise<string>);
-`;
-  out += `      headers?: SDKAuthHeadersProvider;
-`;
-  out += `    };
-
-`;
-  out += `export class SDK {
-`;
-  for (const t of tables) {
-    out += `  public ${t.name}: ${pascal(t.name)}Client;
-`;
-  }
-  out += `
-  constructor(cfg: { baseUrl: string; fetch?: typeof fetch; auth?: SDKAuth }) {
-`;
-  out += `    const f = cfg.fetch ?? fetch;
-`;
-  for (const t of tables) {
-    out += `    this.${t.name} = new ${pascal(t.name)}Client(cfg.baseUrl, f, cfg.auth);
-`;
-  }
-  out += `  }
-`;
-  out += `}
-`;
-  for (const t of tables)
-    out += `export { ${pascal(t.name)}Client } from "./${t.name}";
-`;
-  out += `export * from "./include-spec";
-`;
-  return out;
-}
 
 // src/emit-include-loader.ts
 function emitIncludeLoader(graph, model, maxDepth) {
@@ -1740,11 +1809,50 @@ export * from "./include-spec";
 `;
 }
 
+// src/types.ts
+function normalizeAuthConfig(input) {
+  if (!input)
+    return;
+  if ("strategy" in input && input.strategy) {
+    return input;
+  }
+  if ("apiKey" in input && input.apiKey) {
+    return {
+      strategy: "api-key",
+      apiKeyHeader: input.apiKeyHeader,
+      apiKeys: [input.apiKey, ...input.apiKeys || []]
+    };
+  }
+  if ("apiKeys" in input && input.apiKeys?.length) {
+    return {
+      strategy: "api-key",
+      apiKeyHeader: input.apiKeyHeader,
+      apiKeys: input.apiKeys
+    };
+  }
+  if ("jwt" in input && input.jwt) {
+    if (typeof input.jwt === "string") {
+      return {
+        strategy: "jwt-hs256",
+        jwt: { sharedSecret: input.jwt }
+      };
+    } else {
+      return {
+        strategy: "jwt-hs256",
+        jwt: input.jwt
+      };
+    }
+  }
+  return { strategy: "none" };
+}
+
 // src/index.ts
 async function generate(configPath) {
   const configUrl = pathToFileURL(configPath).href;
   const module = await import(configUrl);
-  const cfg = module.default || module;
+  const rawCfg = module.default || module;
+  const normalizedAuth = normalizeAuthConfig(rawCfg.auth);
+  const cfg = { ...rawCfg, auth: normalizedAuth };
   console.log("\uD83D\uDD0D Introspecting database...");
   const model = await introspect(cfg.connectionString, cfg.schema || "public");
   console.log("\uD83D\uDD17 Building relationship graph...");
@@ -1765,6 +1873,7 @@ async function generate(configPath) {
   const includeSpec = emitIncludeSpec(graph);
   files.push({ path: join(serverDir, "include-spec.ts"), content: includeSpec });
   files.push({ path: join(clientDir, "include-spec.ts"), content: includeSpec });
+  files.push({ path: join(clientDir, "base-client.ts"), content: emitBaseClient() });
   files.push({
     path: join(serverDir, "include-builder.ts"),
     content: emitIncludeBuilder(graph, cfg.includeDepthLimit || 3)
@@ -1774,8 +1883,8 @@ async function generate(configPath) {
     content: emitIncludeLoader(graph, model, cfg.includeDepthLimit || 3)
   });
   files.push({ path: join(serverDir, "logger.ts"), content: emitLogger() });
-  if (cfg.auth?.strategy && cfg.auth.strategy !== "none") {
-    files.push({ path: join(serverDir, "auth.ts"), content: emitAuth(cfg.auth) });
+  if (normalizedAuth?.strategy && normalizedAuth.strategy !== "none") {
+    files.push({ path: join(serverDir, "auth.ts"), content: emitAuth(normalizedAuth) });
   }
   for (const table of Object.values(model.tables)) {
     const typesSrc = emitTypes(table, { dateType: normDateType, numericMode: "string" });
@@ -1790,7 +1899,7 @@ async function generate(configPath) {
       content: emitRoutes(table, graph, {
         softDeleteColumn: cfg.softDeleteColumn || null,
         includeDepthLimit: cfg.includeDepthLimit || 3,
-        authStrategy: cfg.auth?.strategy
+        authStrategy: normalizedAuth?.strategy
       })
     });
     files.push({
@@ -1804,7 +1913,7 @@ async function generate(configPath) {
   });
   files.push({
     path: join(serverDir, "router.ts"),
-    content: emitRouter(Object.values(model.tables), !!cfg.auth?.strategy && cfg.auth.strategy !== "none")
+    content: emitRouter(Object.values(model.tables), !!normalizedAuth?.strategy && normalizedAuth.strategy !== "none")
   });
   console.log("✍️  Writing files...");
   await writeFiles(files);

package/dist/emit-base-client.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Emits the BaseClient class that all table-specific clients will extend.
+ * Contains all shared logic for auth, headers, and HTTP operations.
+ */
+export declare function emitBaseClient(): string;

package/dist/index.js

@@ -957,13 +957,116 @@ function emitClient(table) {
   const pkType = hasCompositePk ? `{ ${safePk.map((c) => `${c}: string`).join("; ")} }` : `string`;
   const pkPathExpr = hasCompositePk ? safePk.map((c) => `pk.${c}`).join(` + "/" + `) : `pk`;
   return `/* Generated. Do not edit. */
+import { BaseClient } from "./base-client";
 import type { ${Type}IncludeSpec } from "./include-spec";
 import type { Insert${Type}, Update${Type}, Select${Type} } from "./types/${table.name}";
 
-type HeaderMap = Record<string, string>;
-type AuthHeadersProvider = () => Promise<HeaderMap> | HeaderMap;
+/**
+ * Client for ${table.name} table operations
+ */
+export class ${Type}Client extends BaseClient {
+  private readonly resource = "/v1/${table.name}";
+
+  async create(data: Insert${Type}): Promise<Select${Type}> {
+    return this.post<Select${Type}>(this.resource, data);
+  }
+
+  async getByPk(pk: ${pkType}): Promise<Select${Type} | null> {
+    const path = ${pkPathExpr};
+    return this.get<Select${Type} | null>(\`\${this.resource}/\${path}\`);
+  }
+
+  async list(params?: { 
+    include?: ${Type}IncludeSpec; 
+    limit?: number; 
+    offset?: number;
+    where?: any;
+    orderBy?: string;
+    order?: "asc" | "desc";
+  }): Promise<Select${Type}[]> {
+    return this.post<Select${Type}[]>(\`\${this.resource}/list\`, params ?? {});
+  }
+
+  async update(pk: ${pkType}, patch: Update${Type}): Promise<Select${Type} | null> {
+    const path = ${pkPathExpr};
+    return this.patch<Select${Type} | null>(\`\${this.resource}/\${path}\`, patch);
+  }
+
+  async delete(pk: ${pkType}): Promise<Select${Type} | null> {
+    const path = ${pkPathExpr};
+    return this.del<Select${Type} | null>(\`\${this.resource}/\${path}\`);
+  }
+}
+`;
+}
+function emitClientIndex(tables) {
+  let out = `/* Generated. Do not edit. */
+`;
+  out += `import { BaseClient, AuthConfig } from "./base-client";
+`;
+  for (const t of tables) {
+    out += `import { ${pascal(t.name)}Client } from "./${t.name}";
+`;
+  }
+  out += `
+// Re-export auth types for convenience
+`;
+  out += `export type { AuthConfig as SDKAuth, AuthConfig, HeaderMap, AuthHeadersProvider } from "./base-client";
+
+`;
+  out += `/**
+`;
+  out += ` * Main SDK class that provides access to all table clients
+`;
+  out += ` */
+`;
+  out += `export class SDK {
+`;
+  for (const t of tables) {
+    out += `  public ${t.name}: ${pascal(t.name)}Client;
+`;
+  }
+  out += `
+  constructor(cfg: { baseUrl: string; fetch?: typeof fetch; auth?: AuthConfig }) {
+`;
+  out += `    const f = cfg.fetch ?? fetch;
+`;
+  for (const t of tables) {
+    out += `    this.${t.name} = new ${pascal(t.name)}Client(cfg.baseUrl, f, cfg.auth);
+`;
+  }
+  out += `  }
+`;
+  out += `}
+
+`;
+  out += `// Export individual table clients
+`;
+  for (const t of tables) {
+    out += `export { ${pascal(t.name)}Client } from "./${t.name}";
+`;
+  }
+  out += `
+// Export base client for custom extensions
+`;
+  out += `export { BaseClient } from "./base-client";
+`;
+  out += `
+// Export include specifications
+`;
+  out += `export * from "./include-spec";
+`;
+  return out;
+}
+
+// src/emit-base-client.ts
+function emitBaseClient() {
+  return `/* Generated. Do not edit. */
+
+export type HeaderMap = Record<string, string>;
+export type AuthHeadersProvider = () => Promise<HeaderMap> | HeaderMap;
 
-type AuthConfig =
+export type AuthConfig =
   | AuthHeadersProvider
   | {
       apiKey?: string;
@@ -975,14 +1078,18 @@ type AuthConfig =
       headers?: AuthHeadersProvider;
     };
 
-export class ${Type}Client {
+/**
+ * Base client class with shared authentication and request handling logic.
+ * All table-specific clients extend this class.
+ */
+export abstract class BaseClient {
   constructor(
-    private baseUrl: string,
-    private fetchFn: typeof fetch = fetch,
-    private auth?: AuthConfig
+    protected baseUrl: string,
+    protected fetchFn: typeof fetch = fetch,
+    protected auth?: AuthConfig
   ) {}
 
-  private async authHeaders(): Promise<HeaderMap> {
+  protected async authHeaders(): Promise<HeaderMap> {
     if (!this.auth) return {};
     if (typeof this.auth === "function") {
       const h = await this.auth();
@@ -1008,129 +1115,91 @@ export class ${Type}Client {
     return out;
   }
 
-  private async headers(json = false) {
+  protected async headers(json = false): Promise<HeaderMap> {
     const extra = await this.authHeaders();
     return json ? { "Content-Type": "application/json", ...extra } : extra;
   }
 
-  private async okOrThrow(res: Response, action: string) {
+  protected async okOrThrow(res: Response, action: string, entity: string): Promise<void> {
     if (!res.ok) {
       let detail = "";
       try { detail = await res.text(); } catch {}
-      throw new Error(\`\${action} ${table.name} failed: \${res.status} \${detail}\`);
+      throw new Error(\`\${action} \${entity} failed: \${res.status} \${detail}\`);
     }
   }
 
-  async create(data: Insert${Type}): Promise<Select${Type}> {
-    const res = await this.fetchFn(\`\${this.baseUrl}/v1/${table.name}\`, {
+  /**
+   * Make a POST request
+   */
+  protected async post<T>(path: string, body?: any): Promise<T> {
+    const res = await this.fetchFn(\`\${this.baseUrl}\${path}\`, {
       method: "POST",
       headers: await this.headers(true),
-      body: JSON.stringify(data),
+      body: JSON.stringify(body),
     });
-    await this.okOrThrow(res, "create");
-    return (await res.json()) as Select${Type};
+    
+    // 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;
   }
 
-  async getByPk(pk: ${pkType}): Promise<Select${Type} | null> {
-    const path = ${pkPathExpr};
-    const res = await this.fetchFn(\`\${this.baseUrl}/v1/${table.name}/\${path}\`, {
+  /**
+   * Make a GET request
+   */
+  protected async get<T>(path: string): Promise<T> {
+    const res = await this.fetchFn(\`\${this.baseUrl}\${path}\`, {
       headers: await this.headers(),
     });
-    if (res.status === 404) return null;
-    await this.okOrThrow(res, "get");
-    return (await res.json()) as Select${Type};
-  }
-
-  async list(params?: { include?: ${Type}IncludeSpec; limit?: number; offset?: number }): Promise<Select${Type}[]> {
-    const res = await this.fetchFn(\`\${this.baseUrl}/v1/${table.name}/list\`, {
-      method: "POST",
-      headers: await this.headers(true),
-      body: JSON.stringify(params ?? {}),
-    });
-    await this.okOrThrow(res, "list");
-    return (await res.json()) as Select${Type}[];
+    
+    if (res.status === 404) {
+      return null as T;
+    }
+    
+    await this.okOrThrow(res, "GET", path);
+    return (await res.json()) as T;
   }
 
-  async update(pk: ${pkType}, patch: Update${Type}): Promise<Select${Type} | null> {
-    const path = ${pkPathExpr};
-    const res = await this.fetchFn(\`\${this.baseUrl}/v1/${table.name}/\${path}\`, {
+  /**
+   * Make a PATCH request
+   */
+  protected async patch<T>(path: string, body?: any): Promise<T> {
+    const res = await this.fetchFn(\`\${this.baseUrl}\${path}\`, {
       method: "PATCH",
       headers: await this.headers(true),
-      body: JSON.stringify(patch),
+      body: JSON.stringify(body),
     });
-    if (res.status === 404) return null;
-    await this.okOrThrow(res, "update");
-    return (await res.json()) as Select${Type};
+    
+    if (res.status === 404) {
+      return null as T;
+    }
+    
+    await this.okOrThrow(res, "PATCH", path);
+    return (await res.json()) as T;
   }
 
-  async delete(pk: ${pkType}): Promise<Select${Type} | null> {
-    const path = ${pkPathExpr};
-    const res = await this.fetchFn(\`\${this.baseUrl}/v1/${table.name}/\${path}\`, {
+  /**
+   * Make a DELETE request
+   */
+  protected async del<T>(path: string): Promise<T> {
+    const res = await this.fetchFn(\`\${this.baseUrl}\${path}\`, {
       method: "DELETE",
       headers: await this.headers(),
     });
-    if (res.status === 404) return null;
-    await this.okOrThrow(res, "delete");
-    return (await res.json()) as Select${Type};
+    
+    if (res.status === 404) {
+      return null as T;
+    }
+    
+    await this.okOrThrow(res, "DELETE", path);
+    return (await res.json()) as T;
   }
 }
 `;
 }
-function emitClientIndex(tables) {
-  let out = `/* Generated. Do not edit. */
-`;
-  for (const t of tables) {
-    out += `import { ${pascal(t.name)}Client } from "./${t.name}";
-`;
-  }
-  out += `
-export type SDKAuthHeadersProvider = () => Promise<Record<string,string>> | Record<string,string>;
-`;
-  out += `export type SDKAuth =
-`;
-  out += `  | SDKAuthHeadersProvider
-`;
-  out += `  | {
-`;
-  out += `      apiKey?: string;
-`;
-  out += `      /** defaults to "x-api-key" */
-`;
-  out += `      apiKeyHeader?: string;
-`;
-  out += `      jwt?: string | (() => Promise<string>);
-`;
-  out += `      headers?: SDKAuthHeadersProvider;
-`;
-  out += `    };
-
-`;
-  out += `export class SDK {
-`;
-  for (const t of tables) {
-    out += `  public ${t.name}: ${pascal(t.name)}Client;
-`;
-  }
-  out += `
-  constructor(cfg: { baseUrl: string; fetch?: typeof fetch; auth?: SDKAuth }) {
-`;
-  out += `    const f = cfg.fetch ?? fetch;
-`;
-  for (const t of tables) {
-    out += `    this.${t.name} = new ${pascal(t.name)}Client(cfg.baseUrl, f, cfg.auth);
-`;
-  }
-  out += `  }
-`;
-  out += `}
-`;
-  for (const t of tables)
-    out += `export { ${pascal(t.name)}Client } from "./${t.name}";
-`;
-  out += `export * from "./include-spec";
-`;
-  return out;
-}
 
 // src/emit-include-loader.ts
 function emitIncludeLoader(graph, model, maxDepth) {
@@ -1739,11 +1808,50 @@ export * from "./include-spec";
 `;
 }
 
+// src/types.ts
+function normalizeAuthConfig(input) {
+  if (!input)
+    return;
+  if ("strategy" in input && input.strategy) {
+    return input;
+  }
+  if ("apiKey" in input && input.apiKey) {
+    return {
+      strategy: "api-key",
+      apiKeyHeader: input.apiKeyHeader,
+      apiKeys: [input.apiKey, ...input.apiKeys || []]
+    };
+  }
+  if ("apiKeys" in input && input.apiKeys?.length) {
+    return {
+      strategy: "api-key",
+      apiKeyHeader: input.apiKeyHeader,
+      apiKeys: input.apiKeys
+    };
+  }
+  if ("jwt" in input && input.jwt) {
+    if (typeof input.jwt === "string") {
+      return {
+        strategy: "jwt-hs256",
+        jwt: { sharedSecret: input.jwt }
+      };
+    } else {
+      return {
+        strategy: "jwt-hs256",
+        jwt: input.jwt
+      };
+    }
+  }
+  return { strategy: "none" };
+}
+
 // src/index.ts
 async function generate(configPath) {
   const configUrl = pathToFileURL(configPath).href;
   const module = await import(configUrl);
-  const cfg = module.default || module;
+  const rawCfg = module.default || module;
+  const normalizedAuth = normalizeAuthConfig(rawCfg.auth);
+  const cfg = { ...rawCfg, auth: normalizedAuth };
   console.log("\uD83D\uDD0D Introspecting database...");
   const model = await introspect(cfg.connectionString, cfg.schema || "public");
   console.log("\uD83D\uDD17 Building relationship graph...");
@@ -1764,6 +1872,7 @@ async function generate(configPath) {
   const includeSpec = emitIncludeSpec(graph);
   files.push({ path: join(serverDir, "include-spec.ts"), content: includeSpec });
   files.push({ path: join(clientDir, "include-spec.ts"), content: includeSpec });
+  files.push({ path: join(clientDir, "base-client.ts"), content: emitBaseClient() });
   files.push({
     path: join(serverDir, "include-builder.ts"),
     content: emitIncludeBuilder(graph, cfg.includeDepthLimit || 3)
@@ -1773,8 +1882,8 @@ async function generate(configPath) {
     content: emitIncludeLoader(graph, model, cfg.includeDepthLimit || 3)
   });
   files.push({ path: join(serverDir, "logger.ts"), content: emitLogger() });
-  if (cfg.auth?.strategy && cfg.auth.strategy !== "none") {
-    files.push({ path: join(serverDir, "auth.ts"), content: emitAuth(cfg.auth) });
+  if (normalizedAuth?.strategy && normalizedAuth.strategy !== "none") {
+    files.push({ path: join(serverDir, "auth.ts"), content: emitAuth(normalizedAuth) });
   }
   for (const table of Object.values(model.tables)) {
     const typesSrc = emitTypes(table, { dateType: normDateType, numericMode: "string" });
@@ -1789,7 +1898,7 @@ async function generate(configPath) {
       content: emitRoutes(table, graph, {
         softDeleteColumn: cfg.softDeleteColumn || null,
         includeDepthLimit: cfg.includeDepthLimit || 3,
-        authStrategy: cfg.auth?.strategy
+        authStrategy: normalizedAuth?.strategy
       })
     });
     files.push({
@@ -1803,7 +1912,7 @@ async function generate(configPath) {
   });
   files.push({
     path: join(serverDir, "router.ts"),
-    content: emitRouter(Object.values(model.tables), !!cfg.auth?.strategy && cfg.auth.strategy !== "none")
+    content: emitRouter(Object.values(model.tables), !!normalizedAuth?.strategy && normalizedAuth.strategy !== "none")
   });
   console.log("✍️  Writing files...");
   await writeFiles(files);

package/dist/types.d.ts

@@ -8,6 +8,16 @@ export interface AuthConfig {
         audience?: string;
     };
 }
+export type AuthConfigInput = AuthConfig | {
+    apiKey?: string;
+    apiKeys?: string[];
+    apiKeyHeader?: string;
+    jwt?: string | {
+        sharedSecret?: string;
+        issuer?: string;
+        audience?: string;
+    };
+};
 export interface Config {
     connectionString: string;
     schema?: string;
@@ -16,5 +26,6 @@ export interface Config {
     softDeleteColumn?: string | null;
     includeDepthLimit?: number;
     dateType?: "date" | "string";
-    auth?: AuthConfig;
+    auth?: AuthConfigInput;
 }
+export declare function normalizeAuthConfig(input: AuthConfigInput | undefined): AuthConfig | undefined;

package/package.json

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