postgresdk 0.1.2-alpha.1 → 0.1.2-alpha.3

package/README.md

@@ -89,7 +89,7 @@ const recentBooks = await sdk.books.list({
 ```typescript
 import { Hono } from "hono";
 import { Client } from "pg";
-import { createRouter } from "./generated/server";
+import { createRouter } from "./generated/server/router";
 
 const app = new Hono();
 const pg = new Client({ connectionString: process.env.DATABASE_URL });
@@ -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: {
@@ -479,7 +503,7 @@ postgresdk generates a `createRouter` function that returns a Hono router with a
 import { Hono } from "hono";
 import { serve } from "@hono/node-server";
 import { Client } from "pg";
-import { createRouter } from "./generated/server";
+import { createRouter } from "./generated/server/router";
 
 const app = new Hono();
 
@@ -502,7 +526,7 @@ The `createRouter` function returns a Hono router that can be mounted anywhere:
 
 ```typescript
 import { Hono } from "hono";
-import { createRouter } from "./generated/server";
+import { createRouter } from "./generated/server/router";
 
 const app = new Hono();
 
@@ -523,7 +547,7 @@ app.route("/v2", apiRouter);   // Routes will be at /v2/v1/users, /v2/v1/posts,
 If you prefer to register routes directly on your app without a sub-router:
 
 ```typescript
-import { registerAllRoutes } from "./generated/server";
+import { registerAllRoutes } from "./generated/server/router";
 
 const app = new Hono();
 const pg = new Client({ connectionString: process.env.DATABASE_URL });
@@ -538,7 +562,7 @@ registerAllRoutes(app, { pg });
 You can also import and register individual routes:
 
 ```typescript
-import { registerUsersRoutes, registerPostsRoutes } from "./generated/server";
+import { registerUsersRoutes, registerPostsRoutes } from "./generated/server/router";
 
 const app = new Hono();
 

package/dist/cli.js

@@ -1659,8 +1659,8 @@ export async function authMiddleware(c: Context, next: Next) {
 `;
 }
 
-// src/emit-server-index.ts
-function emitServerIndex(tables, hasAuth) {
+// src/emit-router.ts
+function emitRouter(tables, hasAuth) {
   const tableNames = tables.map((t) => t.name).sort();
   const imports = tableNames.map((name) => {
     const Type = pascal(name);
@@ -1688,7 +1688,7 @@ ${hasAuth ? `export { authMiddleware } from "./auth";` : ""}
  * @example
  * import { Hono } from "hono";
  * import { Client } from "pg";
- * import { createRouter } from "./generated/server";
+ * import { createRouter } from "./generated/server/router";
  * 
  * const app = new Hono();
  * const pg = new Client({ connectionString: process.env.DATABASE_URL });
@@ -1716,7 +1716,7 @@ ${registrations}
  * @example
  * import { Hono } from "hono";
  * import { Client } from "pg";
- * import { registerAllRoutes } from "./generated/server";
+ * import { registerAllRoutes } from "./generated/server/router";
  * 
  * const app = new Hono();
  * const pg = new Client({ connectionString: process.env.DATABASE_URL });
@@ -1740,11 +1740,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...");
@@ -1774,8 +1813,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 +1829,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,8 +1842,8 @@ async function generate(configPath) {
     content: emitClientIndex(Object.values(model.tables))
   });
   files.push({
-    path: join(serverDir, "index.ts"),
-    content: emitServerIndex(Object.values(model.tables), !!cfg.auth?.strategy && cfg.auth.strategy !== "none")
+    path: join(serverDir, "router.ts"),
+    content: emitRouter(Object.values(model.tables), !!normalizedAuth?.strategy && normalizedAuth.strategy !== "none")
   });
   console.log("✍️  Writing files...");
   await writeFiles(files);

package/dist/emit-router.d.ts

@@ -0,0 +1,5 @@
+import type { Table } from "./introspect";
+/**
+ * Emits the server router file that exports helper functions for route registration
+ */
+export declare function emitRouter(tables: Table[], hasAuth: boolean): string;

package/dist/index.js

@@ -1658,8 +1658,8 @@ export async function authMiddleware(c: Context, next: Next) {
 `;
 }
 
-// src/emit-server-index.ts
-function emitServerIndex(tables, hasAuth) {
+// src/emit-router.ts
+function emitRouter(tables, hasAuth) {
   const tableNames = tables.map((t) => t.name).sort();
   const imports = tableNames.map((name) => {
     const Type = pascal(name);
@@ -1687,7 +1687,7 @@ ${hasAuth ? `export { authMiddleware } from "./auth";` : ""}
  * @example
  * import { Hono } from "hono";
  * import { Client } from "pg";
- * import { createRouter } from "./generated/server";
+ * import { createRouter } from "./generated/server/router";
  * 
  * const app = new Hono();
  * const pg = new Client({ connectionString: process.env.DATABASE_URL });
@@ -1715,7 +1715,7 @@ ${registrations}
  * @example
  * import { Hono } from "hono";
  * import { Client } from "pg";
- * import { registerAllRoutes } from "./generated/server";
+ * import { registerAllRoutes } from "./generated/server/router";
  * 
  * const app = new Hono();
  * const pg = new Client({ connectionString: process.env.DATABASE_URL });
@@ -1739,11 +1739,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...");
@@ -1773,8 +1812,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 +1828,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({
@@ -1802,8 +1841,8 @@ async function generate(configPath) {
     content: emitClientIndex(Object.values(model.tables))
   });
   files.push({
-    path: join(serverDir, "index.ts"),
-    content: emitServerIndex(Object.values(model.tables), !!cfg.auth?.strategy && cfg.auth.strategy !== "none")
+    path: join(serverDir, "router.ts"),
+    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.1",
+  "version": "0.1.2-alpha.3",
   "description": "Generate a typed server/client SDK from a Postgres schema (includes, Zod, Hono).",
   "type": "module",
   "bin": {