@voyantjs/hono 0.63.0 → 0.64.0

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAS3B,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AA2BlF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB,CAAC,SAAS,GAAG,OAAO;IACtD;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3C;AAED,wBAAgB,SAAS,CAAC,SAAS,SAAS,cAAc,EACxD,MAAM,EAAE,eAAe,CAAC,SAAS,CAAC,GACjC,IAAI,CAAC;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,eAAe,CAAA;CAAE,CAAC,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAuP5F"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAS3B,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AA2BlF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB,CAAC,SAAS,GAAG,OAAO;IACtD;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3C;AAED,wBAAgB,SAAS,CAAC,SAAS,SAAS,cAAc,EACxD,MAAM,EAAE,eAAe,CAAC,SAAS,CAAC,GACjC,IAAI,CAAC;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,eAAe,CAAA;CAAE,CAAC,GAAG,mBAAmB,CAAC,SAAS,CAAC,CA6P5F"}

package/dist/app.js

@@ -191,8 +191,14 @@ export function createApp(config) {
     }
     // Auth middleware for all other routes
     app.use("*", requireAuth(config.db, { publicPaths: config.publicPaths, auth: config.auth }));
-    // DB middleware — sets c.var.db for all downstream handlers
-    app.use("*", db(config.db));
+    // DB middleware — sets c.var.db for all downstream handlers.
+    // Pass the list of modules that need interactive transactions so the
+    // middleware can throw a clear startup-style error on first request if
+    // the wired adapter is neon-http (which doesn't support db.transaction).
+    const txRequiringModules = allModules
+        .filter((m) => m.module.requiresTransactionalDb)
+        .map((m) => m.module.name);
+    app.use("*", db(config.db, { requiresTransactionalDb: txRequiringModules }));
     // Actor guards for the two API surfaces
     app.use("/v1/admin/*", requireActor("staff"));
     app.use("/v1/public/*", requireActor("customer", "partner", "supplier"));

package/dist/middleware/db.d.ts

@@ -1,5 +1,18 @@
 import type { MiddlewareHandler } from "hono";
 import { type DbFactory, type VoyantBindings, type VoyantDb } from "../types.js";
+export interface DbMiddlewareOptions {
+    /**
+     * Names of modules that require a transaction-capable db adapter
+     * (those that set `Module.requiresTransactionalDb`). If non-empty
+     * and the first resolved db reports
+     * `dbSupportsTransactions(db) === false`, the middleware throws a
+     * clear error naming the offending modules. A capability of
+     * `undefined` (untagged drivers like raw `drizzle-orm/node-postgres`)
+     * is treated as "assume capable" — only an explicit `false`
+     * (neon-http) trips the assertion.
+     */
+    requiresTransactionalDb?: readonly string[];
+}
 /**
  * Resolves the per-request db client and stores it on Hono context.
  *
@@ -14,7 +27,7 @@ import { type DbFactory, type VoyantBindings, type VoyantDb } from "../types.js"
  * postgres-js client cached at the module level) are wired up as
  * before with no cleanup hook.
  */
-export declare function db<TBindings extends VoyantBindings>(factory: DbFactory<TBindings>): MiddlewareHandler<{
+export declare function db<TBindings extends VoyantBindings>(factory: DbFactory<TBindings>, options?: DbMiddlewareOptions): MiddlewareHandler<{
     Bindings: TBindings;
     Variables: {
         db: VoyantDb;

package/dist/middleware/db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/middleware/db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAA;AAE7C,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,cAAc,EACnB,KAAK,QAAQ,EACd,MAAM,aAAa,CAAA;AAYpB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,EAAE,CAAC,SAAS,SAAS,cAAc,EACjD,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,GAC5B,iBAAiB,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAA;IACnB,SAAS,EAAE;QAAE,EAAE,EAAE,QAAQ,CAAA;KAAE,CAAA;CAC5B,CAAC,CAwBD"}
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/middleware/db.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAA;AAE7C,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,cAAc,EACnB,KAAK,QAAQ,EACd,MAAM,aAAa,CAAA;AAEpB,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;OASG;IACH,uBAAuB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC5C;AAwBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,EAAE,CAAC,SAAS,SAAS,cAAc,EACjD,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,EAC7B,OAAO,GAAE,mBAAwB,GAChC,iBAAiB,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAA;IACnB,SAAS,EAAE;QAAE,EAAE,EAAE,QAAQ,CAAA;KAAE,CAAA;CAC5B,CAAC,CA4CD"}

package/dist/middleware/db.js

@@ -1,4 +1,14 @@
+import { dbSupportsTransactions } from "@voyantjs/db/transaction-capability";
 import { resolveDbFactoryResult, } from "../types.js";
+function buildIncapableDbError(modules) {
+    const list = [...modules].sort().join(", ");
+    return new Error(`[voyant] db adapter does not support interactive transactions, but the ` +
+        `following modules require it: ${list}. ` +
+        `Use createServerlessDbClient (neon-serverless / WebSocket) for ` +
+        `Cloudflare Workers, or createDbClient(url, { adapter: "node" }) for ` +
+        `Node deployments. The "edge" adapter (neon-http) is read-mostly ` +
+        `and cannot run db.transaction(async (tx) => …).`);
+}
 /**
  * Resolves the per-request db client and stores it on Hono context.
  *
@@ -13,10 +23,31 @@ import { resolveDbFactoryResult, } from "../types.js";
  * postgres-js client cached at the module level) are wired up as
  * before with no cleanup hook.
  */
-export function db(factory) {
+export function db(factory, options = {}) {
+    const requiresTx = options.requiresTransactionalDb ?? [];
+    // Stays `false` until a request resolves a db whose capability tag is
+    // anything other than an explicit `false`. As long as the adapter is
+    // wired wrong, every request keeps surfacing the actionable error —
+    // we don't want the first failing request to silence subsequent
+    // checks and let later writes crash with the deep transaction error.
+    let txCapabilityVerified = false;
     return async (c, next) => {
         const result = factory(c.env);
         const { db, dispose } = resolveDbFactoryResult(result);
+        if (!txCapabilityVerified && requiresTx.length > 0) {
+            if (dbSupportsTransactions(db) === false) {
+                if (dispose) {
+                    try {
+                        await dispose();
+                    }
+                    catch {
+                        // swallow dispose errors — the original throw is the actionable one
+                    }
+                }
+                throw buildIncapableDbError(requiresTx);
+            }
+            txCapabilityVerified = true;
+        }
         if (dispose) {
             c.set("db", db);
             try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/hono",
-  "version": "0.63.0",
+  "version": "0.64.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -94,18 +94,18 @@
     "drizzle-orm": "^0.45.2",
     "hono": "^4.12.10",
     "zod": "^4.3.6",
-    "@voyantjs/core": "0.63.0",
-    "@voyantjs/db": "0.63.0",
-    "@voyantjs/types": "0.63.0",
-    "@voyantjs/utils": "0.63.0",
-    "@voyantjs/workflows": "0.63.0"
+    "@voyantjs/core": "0.64.0",
+    "@voyantjs/db": "0.64.0",
+    "@voyantjs/types": "0.64.0",
+    "@voyantjs/utils": "0.64.0",
+    "@voyantjs/workflows": "0.64.0"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^4.20260426.1",
     "typescript": "^6.0.2",
     "vitest": "^4.1.2",
     "@voyantjs/voyant-typescript-config": "0.1.0",
-    "@voyantjs/workflows-orchestrator": "0.63.0"
+    "@voyantjs/workflows-orchestrator": "0.64.0"
   },
   "files": [
     "dist"