@voyant-travel/hono 0.111.0 → 0.112.0

package/dist/app.d.ts

@@ -36,7 +36,14 @@ export interface VoyantAppExtensions<TBindings = unknown> {
      */
     eventBus: import("@voyant-travel/core").EventBus;
 }
-export declare function createApp<TBindings extends VoyantBindings>(config: VoyantAppConfig<TBindings>): Hono<{
+/**
+ * Low-level app factory: given an already-resolved `modules`/`extensions` set
+ * (plus middleware config), build the Hono app. Most deployments use the
+ * config-driven `createApp` (see `create-app.ts`), which derives the modules
+ * from a manifest + registry + capabilities and delegates here. Use `mountApp`
+ * directly only when you have the resolved set in hand (tests, advanced hosts).
+ */
+export declare function mountApp<TBindings extends VoyantBindings>(config: VoyantAppConfig<TBindings>): Hono<{
     Bindings: TBindings;
     Variables: VoyantVariables;
 }> & VoyantAppExtensions<TBindings>;

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AA6B3B,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAY,eAAe,EAAE,MAAM,YAAY,CAAA;AA2C5F;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB,CAAC,SAAS,GAAG,OAAO;IACtD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1C;;;;;;;;OAQG;IACH,QAAQ,EAAE,OAAO,qBAAqB,EAAE,QAAQ,CAAA;CACjD;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,CA6a5F"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AA6B3B,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAY,eAAe,EAAE,MAAM,YAAY,CAAA;AA2C5F;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB,CAAC,SAAS,GAAG,OAAO;IACtD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1C;;;;;;;;OAQG;IACH,QAAQ,EAAE,OAAO,qBAAqB,EAAE,QAAQ,CAAA;CACjD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,SAAS,SAAS,cAAc,EACvD,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,CA6a5F"}

package/dist/app.js

@@ -42,7 +42,14 @@ function buildRateLimitPolicy(config, env, bucket, defaults) {
         store: resolveConfiguredRateLimitStore(config, env) ?? resolveRateLimitStore({ env }),
     };
 }
-export function createApp(config) {
+/**
+ * Low-level app factory: given an already-resolved `modules`/`extensions` set
+ * (plus middleware config), build the Hono app. Most deployments use the
+ * config-driven `createApp` (see `create-app.ts`), which derives the modules
+ * from a manifest + registry + capabilities and delegates here. Use `mountApp`
+ * directly only when you have the resolved set in hand (tests, advanced hosts).
+ */
+export function mountApp(config) {
     const app = new Hono();
     app.onError(handleApiError);
     // Expand plugins into their constituent modules/extensions before mounting

package/dist/create-app.d.ts

@@ -0,0 +1,36 @@
+import { type CompositionManifest, type CompositionRegistry } from "./composition.js";
+import type { VoyantAppConfig, VoyantBindings } from "./types.js";
+/**
+ * Config-driven app config: the manifest + registry + capabilities replace the
+ * resolved `modules`/`extensions` of {@link VoyantAppConfig}. Everything else
+ * (db surfaces, auth, plugins, publicPaths, …) is unchanged.
+ */
+export interface CreateAppConfig<TBindings extends VoyantBindings, TCapabilities> extends Omit<VoyantAppConfig<TBindings>, "modules" | "extensions"> {
+    /** Ordered module/extension manifest. */
+    manifest: CompositionManifest;
+    /** Maps each manifest entry to its factory. */
+    registry: CompositionRegistry<TCapabilities>;
+    /** Deployment capabilities passed to every registry factory. */
+    capabilities: TCapabilities;
+}
+/**
+ * The low-level config-driven front door. Derives the module/extension set from
+ * an explicit manifest + registry + capabilities, then mounts the app — instead
+ * of `composeFromManifest(...)` followed by `mountApp(...)`:
+ *
+ *     export const app = createApp<CloudflareBindings, Providers>({
+ *       manifest: runtimeManifest,
+ *       registry: composition,
+ *       capabilities: buildProviders(),
+ *       db, auth, plugins, ...
+ *     })
+ *
+ * Standard deployments usually call `@voyant-travel/framework`'s higher-level
+ * `createVoyantApp({ providers, modules })` (which assembles the framework-owned
+ * manifest + registry for you and delegates here) rather than this directly.
+ */
+export declare function createApp<TBindings extends VoyantBindings, TCapabilities>(config: CreateAppConfig<TBindings, TCapabilities>): import("hono").Hono<{
+    Bindings: TBindings;
+    Variables: import("./types.js").VoyantVariables;
+}, import("hono/types").BlankSchema, "/"> & import("./app.js").VoyantAppExtensions<TBindings>;
+//# sourceMappingURL=create-app.d.ts.map

package/dist/create-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-app.d.ts","sourceRoot":"","sources":["../src/create-app.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EAEzB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEjE;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,SAAS,SAAS,cAAc,EAAE,aAAa,CAC9E,SAAQ,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IAClE,yCAAyC;IACzC,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,+CAA+C;IAC/C,QAAQ,EAAE,mBAAmB,CAAC,aAAa,CAAC,CAAA;IAC5C,gEAAgE;IAChE,YAAY,EAAE,aAAa,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,SAAS,SAAS,cAAc,EAAE,aAAa,EACvE,MAAM,EAAE,eAAe,CAAC,SAAS,EAAE,aAAa,CAAC;;;8FAKlD"}

package/dist/create-app.js

@@ -0,0 +1,23 @@
+import { mountApp } from "./app.js";
+import { composeFromManifest, } from "./composition.js";
+/**
+ * The low-level config-driven front door. Derives the module/extension set from
+ * an explicit manifest + registry + capabilities, then mounts the app — instead
+ * of `composeFromManifest(...)` followed by `mountApp(...)`:
+ *
+ *     export const app = createApp<CloudflareBindings, Providers>({
+ *       manifest: runtimeManifest,
+ *       registry: composition,
+ *       capabilities: buildProviders(),
+ *       db, auth, plugins, ...
+ *     })
+ *
+ * Standard deployments usually call `@voyant-travel/framework`'s higher-level
+ * `createVoyantApp({ providers, modules })` (which assembles the framework-owned
+ * manifest + registry for you and delegates here) rather than this directly.
+ */
+export function createApp(config) {
+    const { manifest, registry, capabilities, ...rest } = config;
+    const { modules, extensions } = composeFromManifest(manifest, registry, capabilities);
+    return mountApp({ ...rest, modules, extensions });
+}

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 export type { VoyantPermission } from "@voyant-travel/core";
-export { createApp } from "./app.js";
+export { mountApp } from "./app.js";
 export type { SessionAuthContext } from "./auth/index.js";
 export { constantTimeEqual, extractBearerToken, generateNumericCode, randomBytesHex, requireUserId, sha256Base64Url, sha256Hex, unsignCookie, verifySession, } from "./auth/index.js";
+export { type CreateAppConfig, createApp } from "./create-app.js";
 export type { DocumentDownloadEnvelope, DocumentDownloadResolution, DocumentDownloadResolver, DocumentDownloadResolverResult, StoredDocumentReference, } from "./document-download.js";
 export { resolveStoredDocumentDownload } from "./document-download.js";
 export { createLazyRouteHandler, type LazyHonoRoutes, type LazyRoutesLoader, mountLazyRoutePaths, mountLazyRoutesAt, } from "./lazy-routes.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,eAAe,EACf,SAAS,EACT,YAAY,EACZ,aAAa,GACd,MAAM,iBAAiB,CAAA;AACxB,YAAY,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAA;AACtE,OAAO,EACL,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACvF,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,IAAI,EACJ,0BAA0B,EAC1B,EAAE,EACF,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,KAAK,qBAAqB,EAC1B,cAAc,EACd,WAAW,EACX,MAAM,EACN,2BAA2B,EAC3B,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,iBAAiB,GAClB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC5D,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,UAAU,GACX,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,6BAA6B,EAC7B,6BAA6B,EAC7B,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,KAAK,iCAAiC,EACtC,6CAA6C,EAC7C,iCAAiC,EACjC,sCAAsC,EACtC,kCAAkC,EAClC,KAAK,mCAAmC,EACxC,KAAK,8BAA8B,EACnC,KAAK,2BAA2B,EAChC,KAAK,gCAAgC,EACrC,KAAK,gCAAgC,EACrC,KAAK,kCAAkC,EACvC,KAAK,4BAA4B,EACjC,KAAK,sCAAsC,EAC3C,kCAAkC,EAClC,iCAAiC,GAClC,MAAM,+BAA+B,CAAA;AACtC,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,kBAAkB,EAClB,QAAQ,EACR,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,QAAQ,EACR,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,GAChB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,EACxB,aAAa,EACb,qBAAqB,EACrB,UAAU,EACV,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACnC,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,eAAe,EACf,SAAS,EACT,YAAY,EACZ,aAAa,GACd,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,KAAK,eAAe,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AACjE,YAAY,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAA;AACtE,OAAO,EACL,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACvF,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,IAAI,EACJ,0BAA0B,EAC1B,EAAE,EACF,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,KAAK,qBAAqB,EAC1B,cAAc,EACd,WAAW,EACX,MAAM,EACN,2BAA2B,EAC3B,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,iBAAiB,GAClB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC5D,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,UAAU,GACX,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,6BAA6B,EAC7B,6BAA6B,EAC7B,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,KAAK,iCAAiC,EACtC,6CAA6C,EAC7C,iCAAiC,EACjC,sCAAsC,EACtC,kCAAkC,EAClC,KAAK,mCAAmC,EACxC,KAAK,8BAA8B,EACnC,KAAK,2BAA2B,EAChC,KAAK,gCAAgC,EACrC,KAAK,gCAAgC,EACrC,KAAK,kCAAkC,EACvC,KAAK,4BAA4B,EACjC,KAAK,sCAAsC,EAC3C,kCAAkC,EAClC,iCAAiC,GAClC,MAAM,+BAA+B,CAAA;AACtC,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,kBAAkB,EAClB,QAAQ,EACR,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,QAAQ,EACR,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,GAChB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,EACxB,aAAa,EACb,qBAAqB,EACrB,UAAU,EACV,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -1,5 +1,6 @@
-export { createApp } from "./app.js";
+export { mountApp } from "./app.js";
 export { constantTimeEqual, extractBearerToken, generateNumericCode, randomBytesHex, requireUserId, sha256Base64Url, sha256Hex, unsignCookie, verifySession, } from "./auth/index.js";
+export { createApp } from "./create-app.js";
 export { resolveStoredDocumentDownload } from "./document-download.js";
 export { createLazyRouteHandler, mountLazyRoutePaths, mountLazyRoutesAt, } from "./lazy-routes.js";
 export { createPathDbSelector } from "./lib/db-selector.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/hono",
-  "version": "0.111.0",
+  "version": "0.112.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -119,19 +119,19 @@
     "drizzle-orm": "^0.45.2",
     "hono": "^4.12.10",
     "zod": "^4.3.6",
-    "@voyant-travel/core": "^0.109.0",
-    "@voyant-travel/db": "^0.108.1",
+    "@voyant-travel/core": "^0.110.0",
+    "@voyant-travel/db": "^0.108.2",
     "@voyant-travel/storage": "^0.105.0",
     "@voyant-travel/types": "^0.104.5",
     "@voyant-travel/utils": "^0.105.2",
-    "@voyant-travel/workflows": "^0.109.2"
+    "@voyant-travel/workflows": "^0.109.4"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^4.20260426.1",
     "typescript": "^6.0.2",
     "vitest": "^4.1.2",
     "@voyant-travel/voyant-typescript-config": "^0.1.0",
-    "@voyant-travel/workflows-orchestrator": "^0.109.2"
+    "@voyant-travel/workflows-orchestrator": "^0.109.4"
   },
   "files": [
     "dist"