postgresdk 0.10.4 → 0.11.0

package/README.md

@@ -285,6 +285,41 @@ const pool = new Pool({ connectionString: process.env.DATABASE_URL });
 const apiRouter = createRouter({ pg: pool });
 ```
 
+### Request-Level Middleware (onRequest Hook)
+
+The `onRequest` hook executes before every endpoint operation, enabling:
+- Setting PostgreSQL session variables for audit logging
+- Configuring Row-Level Security (RLS) based on authenticated user
+- Request-level logging or monitoring
+
+```typescript
+import { createRouter } from "./api/server/router";
+
+const apiRouter = createRouter({
+  pg,
+  onRequest: async (c, pg) => {
+    // Access Hono context - fully type-safe
+    const auth = c.get('auth');
+
+    // Set PostgreSQL session variable for audit triggers
+    if (auth?.kind === 'jwt' && auth.claims?.sub) {
+      await pg.query(`SET LOCAL app.user_id = '${auth.claims.sub}'`);
+    }
+
+    // Or configure RLS policies
+    if (auth?.tenant_id) {
+      await pg.query(`SET LOCAL app.tenant_id = '${auth.tenant_id}'`);
+    }
+  }
+});
+```
+
+The hook receives:
+- `c` - Hono Context object with full type safety and IDE autocomplete
+- `pg` - PostgreSQL client for setting session variables
+
+**Note:** The router works with or without the `onRequest` hook - fully backward compatible.
+
 ## Server Integration
 
 postgresdk generates Hono-compatible routes:

package/dist/cli.js

@@ -2634,6 +2634,7 @@ function emitHonoRoutes(table, _graph, opts) {
  * To make changes, modify your schema or configuration and regenerate.
  */
 import { Hono } from "hono";
+import type { Context } from "hono";
 import { z } from "zod";
 import { Insert${Type}Schema, Update${Type}Schema } from "../zod/${fileTableName}${ext}";
 import { loadIncludes } from "../include-loader${ext}";
@@ -2648,7 +2649,7 @@ const listSchema = z.object({
   orderBy: z.any().optional()
 });
 
-export function register${Type}Routes(app: Hono, deps: { pg: { query: (text: string, params?: any[]) => Promise<{ rows: any[] }> } }) {
+export function register${Type}Routes(app: Hono, deps: { pg: { query: (text: string, params?: any[]) => Promise<{ rows: any[] }> }, onRequest?: (c: Context, pg: { query: (text: string, params?: any[]) => Promise<{ rows: any[] }> }) => Promise<void> }) {
   const base = "/v1/${fileTableName}";
   
   // Create operation context
@@ -2668,12 +2669,16 @@ ${hasAuth ? `
   app.post(base, async (c) => {
     const body = await c.req.json().catch(() => ({}));
     const parsed = Insert${Type}Schema.safeParse(body);
-    
+
     if (!parsed.success) {
       const issues = parsed.error.flatten();
       return c.json({ error: "Invalid body", issues }, 400);
     }
-    
+
+    if (deps.onRequest) {
+      await deps.onRequest(c, deps.pg);
+    }
+
     const result = await coreOps.createRecord(ctx, parsed.data);
     
     if (result.error) {
@@ -2686,6 +2691,11 @@ ${hasAuth ? `
   // GET BY PK
   app.get(\`\${base}/${pkPath}\`, async (c) => {
     ${getPkParams}
+
+    if (deps.onRequest) {
+      await deps.onRequest(c, deps.pg);
+    }
+
     const result = await coreOps.getByPk(ctx, pkValues);
     
     if (result.error) {
@@ -2698,12 +2708,16 @@ ${hasAuth ? `
   // LIST
   app.post(\`\${base}/list\`, async (c) => {
     const body = listSchema.safeParse(await c.req.json().catch(() => ({})));
-    
+
     if (!body.success) {
       const issues = body.error.flatten();
       return c.json({ error: "Invalid body", issues }, 400);
     }
-    
+
+    if (deps.onRequest) {
+      await deps.onRequest(c, deps.pg);
+    }
+
     const result = await coreOps.listRecords(ctx, body.data);
     
     if (result.error) {
@@ -2749,12 +2763,16 @@ ${hasAuth ? `
     ${getPkParams}
     const body = await c.req.json().catch(() => ({}));
     const parsed = Update${Type}Schema.safeParse(body);
-    
+
     if (!parsed.success) {
       const issues = parsed.error.flatten();
       return c.json({ error: "Invalid body", issues }, 400);
     }
-    
+
+    if (deps.onRequest) {
+      await deps.onRequest(c, deps.pg);
+    }
+
     const result = await coreOps.updateRecord(ctx, pkValues, parsed.data);
     
     if (result.error) {
@@ -2767,6 +2785,11 @@ ${hasAuth ? `
   // DELETE
   app.delete(\`\${base}/${pkPath}\`, async (c) => {
     ${getPkParams}
+
+    if (deps.onRequest) {
+      await deps.onRequest(c, deps.pg);
+    }
+
     const result = await coreOps.deleteRecord(ctx, pkValues);
     
     if (result.error) {
@@ -3777,6 +3800,7 @@ function emitHonoRouter(tables, hasAuth, useJsExtensions) {
  * To make changes, modify your schema or configuration and regenerate.
  */
 import { Hono } from "hono";
+import type { Context } from "hono";
 import { SDK_MANIFEST } from "./sdk-bundle${ext}";
 import { getContract } from "./contract${ext}";
 ${imports}
@@ -3784,32 +3808,46 @@ ${hasAuth ? `export { authMiddleware } from "./auth${ext}";` : ""}
 
 /**
  * Creates a Hono router with all generated routes that can be mounted into your existing app.
- * 
+ *
  * @example
  * import { Hono } from "hono";
  * import { createRouter } from "./generated/server/router";
- * 
+ *
  * // Using pg driver (Node.js)
  * import { Client } from "pg";
  * const pg = new Client({ connectionString: process.env.DATABASE_URL });
  * await pg.connect();
- * 
+ *
  * // OR using Neon driver (Edge-compatible)
  * import { Pool } from "@neondatabase/serverless";
  * const pool = new Pool({ connectionString: process.env.DATABASE_URL! });
  * const pg = pool; // Pool already has the compatible query method
- * 
+ *
  * // Mount all generated routes
  * const app = new Hono();
  * const apiRouter = createRouter({ pg });
  * app.route("/api", apiRouter);
- * 
+ *
  * // Or mount directly at root
  * const router = createRouter({ pg });
  * app.route("/", router);
+ *
+ * // With onRequest hook for audit logging or session variables
+ * const router = createRouter({
+ *   pg,
+ *   onRequest: async (c, pg) => {
+ *     const auth = c.get('auth'); // Type-safe! IDE autocomplete works
+ *     if (auth?.kind === 'jwt' && auth.claims?.sub) {
+ *       await pg.query(\`SET LOCAL app.user_id = '\${auth.claims.sub}'\`);
+ *     }
+ *   }
+ * });
  */
 export function createRouter(
-  deps: { pg: { query: (text: string, params?: any[]) => Promise<{ rows: any[] }> } }
+  deps: {
+    pg: { query: (text: string, params?: any[]) => Promise<{ rows: any[] }> },
+    onRequest?: (c: Context, pg: { query: (text: string, params?: any[]) => Promise<{ rows: any[] }> }) => Promise<void>
+  }
 ): Hono {
   const router = new Hono();
   
@@ -3868,22 +3906,36 @@ ${registrations}
 
 /**
  * Register all generated routes directly on an existing Hono app.
- * 
+ *
  * @example
  * import { Hono } from "hono";
  * import { registerAllRoutes } from "./generated/server/router";
- * 
+ *
  * const app = new Hono();
- * 
+ *
  * // Setup database connection (see createRouter example for both pg and Neon options)
  * const pg = yourDatabaseClient;
- * 
+ *
  * // Register all routes at once
  * registerAllRoutes(app, { pg });
+ *
+ * // With onRequest hook
+ * registerAllRoutes(app, {
+ *   pg,
+ *   onRequest: async (c, pg) => {
+ *     const auth = c.get('auth'); // Type-safe!
+ *     if (auth?.kind === 'jwt' && auth.claims?.sub) {
+ *       await pg.query(\`SET LOCAL app.user_id = '\${auth.claims.sub}'\`);
+ *     }
+ *   }
+ * });
  */
 export function registerAllRoutes(
   app: Hono,
-  deps: { pg: { query: (text: string, params?: any[]) => Promise<{ rows: any[] }> } }
+  deps: {
+    pg: { query: (text: string, params?: any[]) => Promise<{ rows: any[] }> },
+    onRequest?: (c: Context, pg: { query: (text: string, params?: any[]) => Promise<{ rows: any[] }> }) => Promise<void>
+  }
 ) {
 ${registrations.replace(/router/g, "app")}
 }

package/dist/index.js

@@ -1874,6 +1874,7 @@ function emitHonoRoutes(table, _graph, opts) {
  * To make changes, modify your schema or configuration and regenerate.
  */
 import { Hono } from "hono";
+import type { Context } from "hono";
 import { z } from "zod";
 import { Insert${Type}Schema, Update${Type}Schema } from "../zod/${fileTableName}${ext}";
 import { loadIncludes } from "../include-loader${ext}";
@@ -1888,7 +1889,7 @@ const listSchema = z.object({
   orderBy: z.any().optional()
 });
 
-export function register${Type}Routes(app: Hono, deps: { pg: { query: (text: string, params?: any[]) => Promise<{ rows: any[] }> } }) {
+export function register${Type}Routes(app: Hono, deps: { pg: { query: (text: string, params?: any[]) => Promise<{ rows: any[] }> }, onRequest?: (c: Context, pg: { query: (text: string, params?: any[]) => Promise<{ rows: any[] }> }) => Promise<void> }) {
   const base = "/v1/${fileTableName}";
   
   // Create operation context
@@ -1908,12 +1909,16 @@ ${hasAuth ? `
   app.post(base, async (c) => {
     const body = await c.req.json().catch(() => ({}));
     const parsed = Insert${Type}Schema.safeParse(body);
-    
+
     if (!parsed.success) {
       const issues = parsed.error.flatten();
       return c.json({ error: "Invalid body", issues }, 400);
     }
-    
+
+    if (deps.onRequest) {
+      await deps.onRequest(c, deps.pg);
+    }
+
     const result = await coreOps.createRecord(ctx, parsed.data);
     
     if (result.error) {
@@ -1926,6 +1931,11 @@ ${hasAuth ? `
   // GET BY PK
   app.get(\`\${base}/${pkPath}\`, async (c) => {
     ${getPkParams}
+
+    if (deps.onRequest) {
+      await deps.onRequest(c, deps.pg);
+    }
+
     const result = await coreOps.getByPk(ctx, pkValues);
     
     if (result.error) {
@@ -1938,12 +1948,16 @@ ${hasAuth ? `
   // LIST
   app.post(\`\${base}/list\`, async (c) => {
     const body = listSchema.safeParse(await c.req.json().catch(() => ({})));
-    
+
     if (!body.success) {
       const issues = body.error.flatten();
       return c.json({ error: "Invalid body", issues }, 400);
     }
-    
+
+    if (deps.onRequest) {
+      await deps.onRequest(c, deps.pg);
+    }
+
     const result = await coreOps.listRecords(ctx, body.data);
     
     if (result.error) {
@@ -1989,12 +2003,16 @@ ${hasAuth ? `
     ${getPkParams}
     const body = await c.req.json().catch(() => ({}));
     const parsed = Update${Type}Schema.safeParse(body);
-    
+
     if (!parsed.success) {
       const issues = parsed.error.flatten();
       return c.json({ error: "Invalid body", issues }, 400);
     }
-    
+
+    if (deps.onRequest) {
+      await deps.onRequest(c, deps.pg);
+    }
+
     const result = await coreOps.updateRecord(ctx, pkValues, parsed.data);
     
     if (result.error) {
@@ -2007,6 +2025,11 @@ ${hasAuth ? `
   // DELETE
   app.delete(\`\${base}/${pkPath}\`, async (c) => {
     ${getPkParams}
+
+    if (deps.onRequest) {
+      await deps.onRequest(c, deps.pg);
+    }
+
     const result = await coreOps.deleteRecord(ctx, pkValues);
     
     if (result.error) {
@@ -3017,6 +3040,7 @@ function emitHonoRouter(tables, hasAuth, useJsExtensions) {
  * To make changes, modify your schema or configuration and regenerate.
  */
 import { Hono } from "hono";
+import type { Context } from "hono";
 import { SDK_MANIFEST } from "./sdk-bundle${ext}";
 import { getContract } from "./contract${ext}";
 ${imports}
@@ -3024,32 +3048,46 @@ ${hasAuth ? `export { authMiddleware } from "./auth${ext}";` : ""}
 
 /**
  * Creates a Hono router with all generated routes that can be mounted into your existing app.
- * 
+ *
  * @example
  * import { Hono } from "hono";
  * import { createRouter } from "./generated/server/router";
- * 
+ *
  * // Using pg driver (Node.js)
  * import { Client } from "pg";
  * const pg = new Client({ connectionString: process.env.DATABASE_URL });
  * await pg.connect();
- * 
+ *
  * // OR using Neon driver (Edge-compatible)
  * import { Pool } from "@neondatabase/serverless";
  * const pool = new Pool({ connectionString: process.env.DATABASE_URL! });
  * const pg = pool; // Pool already has the compatible query method
- * 
+ *
  * // Mount all generated routes
  * const app = new Hono();
  * const apiRouter = createRouter({ pg });
  * app.route("/api", apiRouter);
- * 
+ *
  * // Or mount directly at root
  * const router = createRouter({ pg });
  * app.route("/", router);
+ *
+ * // With onRequest hook for audit logging or session variables
+ * const router = createRouter({
+ *   pg,
+ *   onRequest: async (c, pg) => {
+ *     const auth = c.get('auth'); // Type-safe! IDE autocomplete works
+ *     if (auth?.kind === 'jwt' && auth.claims?.sub) {
+ *       await pg.query(\`SET LOCAL app.user_id = '\${auth.claims.sub}'\`);
+ *     }
+ *   }
+ * });
  */
 export function createRouter(
-  deps: { pg: { query: (text: string, params?: any[]) => Promise<{ rows: any[] }> } }
+  deps: {
+    pg: { query: (text: string, params?: any[]) => Promise<{ rows: any[] }> },
+    onRequest?: (c: Context, pg: { query: (text: string, params?: any[]) => Promise<{ rows: any[] }> }) => Promise<void>
+  }
 ): Hono {
   const router = new Hono();
   
@@ -3108,22 +3146,36 @@ ${registrations}
 
 /**
  * Register all generated routes directly on an existing Hono app.
- * 
+ *
  * @example
  * import { Hono } from "hono";
  * import { registerAllRoutes } from "./generated/server/router";
- * 
+ *
  * const app = new Hono();
- * 
+ *
  * // Setup database connection (see createRouter example for both pg and Neon options)
  * const pg = yourDatabaseClient;
- * 
+ *
  * // Register all routes at once
  * registerAllRoutes(app, { pg });
+ *
+ * // With onRequest hook
+ * registerAllRoutes(app, {
+ *   pg,
+ *   onRequest: async (c, pg) => {
+ *     const auth = c.get('auth'); // Type-safe!
+ *     if (auth?.kind === 'jwt' && auth.claims?.sub) {
+ *       await pg.query(\`SET LOCAL app.user_id = '\${auth.claims.sub}'\`);
+ *     }
+ *   }
+ * });
  */
 export function registerAllRoutes(
   app: Hono,
-  deps: { pg: { query: (text: string, params?: any[]) => Promise<{ rows: any[] }> } }
+  deps: {
+    pg: { query: (text: string, params?: any[]) => Promise<{ rows: any[] }> },
+    onRequest?: (c: Context, pg: { query: (text: string, params?: any[]) => Promise<{ rows: any[] }> }) => Promise<void>
+  }
 ) {
 ${registrations.replace(/router/g, "app")}
 }

package/package.json

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