@lpdjs/firestore-repo-service 2.2.9-beta.8 → 2.2.9

package/dist/servers/hono/index.d.ts

@@ -1,4 +1,4 @@
-import { MiddlewareHandler, Context, Hono } from 'hono';
+import { Env, MiddlewareHandler, Context, Hono } from 'hono';
 import { IncomingMessage, ServerResponse } from 'node:http';
 import { z, ZodError } from 'zod';
 
@@ -16,20 +16,24 @@ type HttpMethod = "get" | "post" | "put" | "patch" | "delete";
 /** Where the validated payload comes from. */
 type PayloadSource = "json" | "query" | "form" | "param";
 /** Handler signature — receives a single typed context object. */
-type RouteHandler<TIn, TOut> = (ctx: {
+type RouteHandler<TIn, TOut, TEnv extends Env = Env> = (ctx: {
     /** Validated (and typed) request payload. `void` when no `input` schema is defined. */
     input: TIn;
     /** Raw Hono `Context` for headers, set status, redirect, etc. */
-    c: Context;
+    c: Context<TEnv>;
 }) => Promise<TOut | Response> | TOut | Response;
 /**
  * One route declaration. Default-exported by every `routes.ts` file inside the
  * domain tree. Use {@link defineRoute} for full type inference.
  */
-interface RouteDef<TIn extends z.ZodTypeAny | undefined = z.ZodTypeAny | undefined, TOut extends z.ZodTypeAny | undefined = z.ZodTypeAny | undefined> {
+interface RouteDef<TIn extends z.ZodTypeAny | undefined = z.ZodTypeAny | undefined, TOut extends z.ZodTypeAny | undefined = z.ZodTypeAny | undefined, TEnv extends Env = Env> {
     /**
      * Logical API tag — routes sharing the same `api` are mounted on the same
      * `HonoServer` (typically one Cloud Function per `api`).
+     *
+     * To expose the **same logic** under several APIs with different
+     * inputs/outputs, export multiple `defineRoute({...})` from the same file
+     * (default + named exports are both picked up by the codegen).
      */
     api: string;
     /** HTTP method. */
@@ -56,7 +60,7 @@ interface RouteDef<TIn extends z.ZodTypeAny | undefined = z.ZodTypeAny | undefin
     /** Status code for the success response. Default: 200. */
     status?: number;
     /** Hono middlewares applied to this route only (after global middlewares). */
-    middlewares?: MiddlewareHandler[];
+    middlewares?: MiddlewareHandler<TEnv>[];
     summary?: string;
     description?: string;
     tags?: string[];
@@ -65,7 +69,7 @@ interface RouteDef<TIn extends z.ZodTypeAny | undefined = z.ZodTypeAny | undefin
     /** Security requirements (operationId-level override). */
     security?: Array<Record<string, string[]>>;
     /** The request handler. */
-    handler: RouteHandler<TIn extends z.ZodTypeAny ? z.infer<TIn> : void, TOut extends z.ZodTypeAny ? z.infer<TOut> : unknown>;
+    handler: RouteHandler<TIn extends z.ZodTypeAny ? z.infer<TIn> : void, TOut extends z.ZodTypeAny ? z.infer<TOut> : unknown, TEnv>;
 }
 /** Erased `RouteDef` used by registry/codegen — handler signature is opaque. */
 type AnyRouteDef = RouteDef<any, any>;
@@ -119,7 +123,7 @@ declare class ValidationError extends Error {
  * }
  * ```
  */
-type RouteInterceptor = (ctx: {
+type RouteInterceptor<TEnv extends Env = Env> = (ctx: {
     /**
      * Calls validation + handler and returns the raw value.
      * Throws {@link ValidationError} on Zod failure or any error thrown by the handler.
@@ -128,7 +132,7 @@ type RouteInterceptor = (ctx: {
     /** Route metadata (read-only). */
     route: AnyRouteDef;
     /** Hono request context. */
-    c: Context;
+    c: Context<TEnv>;
 }) => Promise<Response | unknown> | Response | unknown;
 /** OpenAPI document info (subset of the spec used by the helper). */
 interface OpenAPIInfo {
@@ -155,7 +159,7 @@ interface OpenAPIConfig {
     security?: Array<Record<string, string[]>>;
 }
 /** Options consumed by the {@link HonoServer} constructor. */
-interface HonoServerOptions {
+interface HonoServerOptions<TEnv extends Env = Env> {
     /**
      * API tag — only routes whose `api` matches this value are mounted.
      * If omitted, every route in the registry is mounted.
@@ -166,12 +170,12 @@ interface HonoServerOptions {
     /** URL prefix mounted before every route path. Default: `""`. */
     basePath?: string;
     /** Hono middlewares applied to every route (after the built-ins). */
-    middlewares?: MiddlewareHandler[];
+    middlewares?: MiddlewareHandler<TEnv>[];
     /**
      * Alias for `middlewares` — global middlewares applied to every route.
      * If both are provided, `globalMiddlewares` is appended after `middlewares`.
      */
-    globalMiddlewares?: MiddlewareHandler[];
+    globalMiddlewares?: MiddlewareHandler<TEnv>[];
     /**
      * If `true`, the server validates the value returned by every handler
      * against the route's `output` schema and rejects mismatches with a 500
@@ -183,15 +187,15 @@ interface HonoServerOptions {
     /** OpenAPI configuration. Omit to disable. */
     openapi?: OpenAPIConfig;
     /** Custom 404 handler. */
-    notFound?: (c: Context) => Response | Promise<Response>;
+    notFound?: (c: Context<TEnv>) => Response | Promise<Response>;
     /** Custom error handler. */
-    onError?: (err: unknown, c: Context) => Response | Promise<Response>;
+    onError?: (err: unknown, c: Context<TEnv>) => Response | Promise<Response>;
     /**
      * Cross-cutting interceptor wrapping every handler call.
      * Ideal for response envelopes, business-error mapping, tracing.
      * See {@link RouteInterceptor}.
      */
-    interceptor?: RouteInterceptor;
+    interceptor?: RouteInterceptor<TEnv>;
 }
 
 /**
@@ -212,15 +216,15 @@ interface HonoServerOptions {
  * stays decoupled from a specific firebase-functions version. We import the
  * real type only when users pass `onRequest` to `toFunction(...)`.
  */
-type OnRequestFn = (...args: any[]) => any;
-declare class HonoServer {
+type OnRequestFn$1 = (...args: any[]) => any;
+declare class HonoServer<TEnv extends Env = Env> {
     private readonly app;
     private readonly options;
     private readonly mountedRoutes;
     private cachedSpec;
-    constructor(options: HonoServerOptions);
+    constructor(options: HonoServerOptions<TEnv>);
     /** Underlying Hono instance — useful for advanced composition / tests. */
-    get hono(): Hono;
+    get hono(): Hono<TEnv>;
     /** Raw `(req, res)` handler suitable for `onRequest()` / `http.createServer`. */
     get nodeHandler(): (req: IncomingMessage, res: ServerResponse) => void;
     /**
@@ -231,7 +235,7 @@ declare class HonoServer {
      * @param httpsOptions  Options forwarded as the first argument to
      *                      `onRequest()` (region, memory, invoker, etc.).
      */
-    toFunction(onRequest: OnRequestFn, httpsOptions?: Record<string, unknown>): any;
+    toFunction(onRequest: OnRequestFn$1, httpsOptions?: Record<string, unknown>): any;
     /** Generate (and cache) the OpenAPI 3.1 spec for the mounted routes. */
     buildOpenApiSpec(): Record<string, unknown>;
     private mountRoutes;
@@ -239,32 +243,101 @@ declare class HonoServer {
 }
 
 /**
- * Type-safe route factory. Use as the **default export** of every
- * `routes.ts` file under your `domains/` tree.
+ * Typed multi-API registry.
+ *
+ * Lets you declare every API tag (= every Cloud Function) in **one place**,
+ * with full TypeScript safety: the `api` field of {@link defineRoute} is
+ * narrowed to the registered tags, and {@link toFunctions} returns one
+ * `onRequest` Cloud Function per tag, named after its key.
  *
  * @example
  * ```ts
- * import { defineRoute } from "@lpdjs/firestore-repo-service/servers/hono";
- * import { execute as input }  from "./input.js";
- * import { execute as output } from "./output.js";
+ * // apis.ts
+ * import { createApiRegistry } from "@lpdjs/firestore-repo-service/servers/hono";
+ * import { enrichUser } from "./middlewares/enrich-user.js";
  *
- * export default defineRoute({
- *   api: "v1",
- *   method: "post",
- *   input,
- *   output,
- *   summary: "Create or update a custom activity",
- *   tags: ["activities"],
- *   handler: async (_c, payload) => {
- *     // payload is typed as z.infer<typeof input>
- *     const useCase = new ActivitiesCreateOrUpdateCustomUseCase(new RepositoryActivities());
- *     return useCase.execute(payload);
+ * export const apis = createApiRegistry({
+ *   v1: {
+ *     basePath: "/v1",
+ *     middlewares: [enrichUser],
+ *     openapi: { info: { title: "Public API", version: "1.0.0" } },
+ *   },
+ *   webhooks: {
+ *     basePath: "/hooks",
+ *     openapi: { info: { title: "Webhooks", version: "1.0.0" } },
  *   },
  * });
+ *
+ * // Use in routes — `api` is now typed "v1" | "webhooks".
+ * export const defineRoute = apis.defineRoute;
+ *
+ * // index.ts (Cloud Functions entrypoint)
+ * import { onRequest } from "firebase-functions/v2/https";
+ * import { apis } from "./apis.js";
+ * import { routes } from "./domains/__generated__/routes.js";
+ *
+ * export const { v1, webhooks } = apis.toFunctions(routes, onRequest, {
+ *   defaults: { region: "us-central1", invoker: "public" },
+ *   per: { v1: { memory: "512MiB" } },
+ * });
+ * // → URLs:  https://<region>-<project>.cloudfunctions.net/v1/posts
+ * //          https://<region>-<project>.cloudfunctions.net/webhooks/...
  * ```
  */
 
-declare function defineRoute<TIn extends z.ZodTypeAny | undefined = undefined, TOut extends z.ZodTypeAny | undefined = undefined>(def: RouteDef<TIn, TOut>): RouteDef<TIn, TOut>;
+type OnRequestFn = (...args: any[]) => any;
+/**
+ * Per-API configuration. Same shape as {@link HonoServerOptions} minus the
+ * `routes` (resolved by the registry) and `api` (the registry key).
+ */
+type ApiConfig<TEnv extends Env = Env> = Omit<HonoServerOptions<TEnv>, "routes" | "api">;
+/** Map of API tag → its config. */
+type ApiConfigMap = Record<string, ApiConfig>;
+interface ApiRegistry<TMap extends ApiConfigMap> {
+    /** The registered configs (read-only). */
+    readonly configs: TMap;
+    /**
+     * Typed `defineRoute` — the `api` field is constrained to `keyof TMap`.
+     *
+     * To expose the same logical endpoint under several APIs with different
+     * `input` / `output` schemas, call `defineRoute` once per route and wrap
+     * them in an array — per-call inference is preserved:
+     *
+     * ```ts
+     * export default [
+     *   defineRoute({ api: "v1", input: V1Input, handler: ({ input }) => ... }),
+     *   defineRoute({ api: "v2", input: V2Input, handler: ({ input }) => ... }),
+     * ];
+     * ```
+     */
+    defineRoute<TIn extends z.ZodTypeAny | undefined = undefined, TOut extends z.ZodTypeAny | undefined = undefined>(def: Omit<RouteDef<TIn, TOut>, "api"> & {
+        api: keyof TMap & string;
+    }): RouteDef<TIn, TOut> & {
+        api: keyof TMap & string;
+    };
+    /**
+     * Build one Cloud Function per registered API and return them as a map
+     * keyed by API tag — spread it directly into your `index.ts` exports.
+     *
+     * @param routes Pre-resolved route registry (typically the codegen output).
+     * @param onRequest The `onRequest` factory imported from
+     *                  `firebase-functions/v2/https`.
+     * @param opts Optional defaults and per-API overrides for `httpsOptions`.
+     */
+    toFunctions(routes: AnyRouteDef[], onRequest: OnRequestFn, opts?: {
+        defaults?: Record<string, unknown>;
+        per?: Partial<Record<keyof TMap & string, Record<string, unknown>>>;
+    }): {
+        [K in keyof TMap & string]: ReturnType<OnRequestFn>;
+    };
+    /** Build the underlying {@link HonoServer} for a given API (escape hatch). */
+    serverFor<K extends keyof TMap & string>(api: K, routes: AnyRouteDef[]): HonoServer;
+}
+/**
+ * Factory — declare every API tag once and get back a typed `defineRoute`
+ * + `toFunctions`. See the file-level example.
+ */
+declare function createApiRegistry<const TMap extends ApiConfigMap>(configs: TMap): ApiRegistry<TMap>;
 
 /**
  * OpenAPI 3.1 spec generator from {@link RouteDef} entries.
@@ -379,4 +452,4 @@ declare function generateRoutesManifest(routes: ScannedRoute[], opts: GeneratorO
 /** Convenience helper used by the CLI — combines scan + generate in one call. */
 declare function generateFromRoot(rootAbs: string, outFileRel: string, derive: PathDeriveOptions, importExtension: string, scan: (root: string) => ScannedRoute[]): GenerationResult;
 
-export { type AnyRouteDef, DEFAULT_DERIVE, DEFAULT_GENERATOR_BANNER, DEFAULT_SCANNER, type GenerationResult, type GeneratorOptions, HonoServer, type HonoServerOptions, type HttpMethod, type OpenAPIConfig, type OpenAPIInfo, type PathDeriveOptions, type PayloadSource, type RouteDef, type RouteHandler, type RouteInterceptor, type RouteModuleDefault, type ScannedRoute, type ScannerOptions, ValidationError, buildOpenApiDocument, defineRoute, derivePath, generateFromRoot, generateRoutesManifest, renderDocsHtml, scanRoutes, toImportSpecifier };
+export { type AnyRouteDef, type ApiConfig, type ApiConfigMap, type ApiRegistry, DEFAULT_DERIVE, DEFAULT_GENERATOR_BANNER, DEFAULT_SCANNER, type GenerationResult, type GeneratorOptions, HonoServer, type HonoServerOptions, type HttpMethod, type OpenAPIConfig, type OpenAPIInfo, type PathDeriveOptions, type PayloadSource, type RouteDef, type RouteHandler, type RouteInterceptor, type RouteModuleDefault, type ScannedRoute, type ScannerOptions, ValidationError, buildOpenApiDocument, createApiRegistry, derivePath, generateFromRoot, generateRoutesManifest, renderDocsHtml, scanRoutes, toImportSpecifier };

package/dist/servers/hono/index.js

@@ -1,4 +1,4 @@
-import {Hono}from'hono';import {getRequestListener}from'@hono/node-server';import {OpenAPIRegistry,OpenApiGeneratorV31}from'@asteasolutions/zod-to-openapi';import {readdirSync,statSync,mkdirSync,writeFileSync}from'fs';import {join,relative,sep,dirname}from'path';var m=class extends Error{constructor(n,o){super("Request validation failed");this.zodError=n;this.source=o;this.statusCode=400;this.name="ValidationError";}};var O="Successful response";function z(t){return t==="get"?"query":"json"}function R(t,e,n){let o=new OpenAPIRegistry;if(n.securitySchemes)for(let[s,i]of Object.entries(n.securitySchemes))o.registerComponent("securitySchemes",s,i);for(let s of t){let i=s.method,p=s.source??z(i),u=F(e,s.path??"/"),c=s.status??200,d=C(i,p,s.input),l=v(p,s.input,"query"),f=v(p,s.input,"param"),h=q(i,u);o.registerPath({method:i,path:j(u),operationId:h,summary:s.summary,description:s.description,tags:s.tags,deprecated:s.deprecated,security:s.security,request:{...l?{query:l}:{},...f?{params:f}:{},...d?{body:d}:{}},responses:s.output?{[c]:{description:O,content:{"application/json":{schema:s.output}}}}:{[c]:{description:O}}});}return new OpenApiGeneratorV31(o.definitions).generateDocument({openapi:"3.1.0",info:n.info,servers:n.servers,security:n.security})}function C(t,e,n){return !n||t==="get"?null:e==="json"?{content:{"application/json":{schema:n}}}:e==="form"?{content:{"application/x-www-form-urlencoded":{schema:n}}}:null}function v(t,e,n){if(e&&(n==="query"&&t==="query"||n==="param"&&t==="param"))return e}function j(t){return t.replace(/:([A-Za-z0-9_]+)/g,"{$1}")}function F(t,e){let n=t.endsWith("/")?t.slice(0,-1):t,o=e.startsWith("/")?e:`/${e}`,r=`${n}${o}`;return r===""?"/":r}function q(t,e){let n=e.replace(/[{}]/g,"").replace(/\/+/g,"_").replace(/[^A-Za-z0-9_]/g,"").replace(/^_+|_+$/g,"");return `${t}_${n||"root"}`}function P(t,e){let n=t.replace(/"/g,"&quot;");return `<!doctype html>
+import {Hono}from'hono';import {getRequestListener}from'@hono/node-server';import {extendZodWithOpenApi,OpenAPIRegistry,OpenApiGeneratorV31}from'@asteasolutions/zod-to-openapi';import {z as z$1}from'zod';import {readdirSync,statSync,mkdirSync,writeFileSync}from'fs';import {join,relative,sep,dirname}from'path';var m=class extends Error{constructor(n,o){super("Request validation failed");this.zodError=n;this.source=o;this.statusCode=400;this.name="ValidationError";}};extendZodWithOpenApi(z$1);var S="Successful response";function j(t){return t==="get"?"query":"json"}function v(t,e,n){let o=new OpenAPIRegistry;if(n.securitySchemes)for(let[s,a]of Object.entries(n.securitySchemes))o.registerComponent("securitySchemes",s,a);for(let s of t){let a=s.method,u=s.source??j(a),p=z(e,s.path??"/"),c=s.status??200,d=$(a,u,s.input),l=w(u,s.input,"query"),f=w(u,s.input,"param"),g=Z(a,p);o.registerPath({method:a,path:q(p),operationId:g,summary:s.summary,description:s.description,tags:s.tags,deprecated:s.deprecated,security:s.security,request:{...l?{query:l}:{},...f?{params:f}:{},...d?{body:d}:{}},responses:s.output?{[c]:{description:S,content:{"application/json":{schema:s.output}}}}:{[c]:{description:S}}});}return new OpenApiGeneratorV31(o.definitions).generateDocument({openapi:"3.1.0",info:n.info,servers:n.servers,security:n.security})}function $(t,e,n){return !n||t==="get"?null:e==="json"?{content:{"application/json":{schema:n}}}:e==="form"?{content:{"application/x-www-form-urlencoded":{schema:n}}}:null}function w(t,e,n){if(e&&(n==="query"&&t==="query"||n==="param"&&t==="param"))return e}function q(t){return t.replace(/:([A-Za-z0-9_]+)/g,"{$1}")}function z(t,e){let n=t.endsWith("/")?t.slice(0,-1):t,o=e.startsWith("/")?e:`/${e}`,r=`${n}${o}`;return r===""?"/":r}function Z(t,e){let n=e.replace(/[{}]/g,"").replace(/\/+/g,"_").replace(/[^A-Za-z0-9_]/g,"").replace(/^_+|_+$/g,"");return `${t}_${n||"root"}`}function E(t,e){let n=t.replace(/"/g,"&quot;");return `<!doctype html>
 <html lang="en">
 <head>
 <meta charset="utf-8" />
@@ -9,7 +9,7 @@ import {Hono}from'hono';import {getRequestListener}from'@hono/node-server';impor
 <script id="api-reference" data-url="${n}"></script>
 <script src="https://cdn.jsdelivr.net/npm/@scalar/api-reference"></script>
 </body>
-</html>`}var w=class{constructor(e){this.cachedSpec=null;this.options=e,this.app=new Hono,this.mountedRoutes=N(e.routes,e.api);let n=[...e.middlewares??[],...e.globalMiddlewares??[]];for(let o of n)this.app.use("*",o);this.mountRoutes(),this.mountOpenApi(),e.notFound&&this.app.notFound(e.notFound),e.onError&&this.app.onError(e.onError);}get hono(){return this.app}get nodeHandler(){return getRequestListener(this.app.fetch,{overrideGlobalObjects:false})}toFunction(e,n){let o=this.nodeHandler;return n?e(n,o):e(o)}buildOpenApiSpec(){if(this.cachedSpec)return this.cachedSpec;if(!this.options.openapi)throw new Error("[HonoServer] openapi config not set");return this.cachedSpec=R(this.mountedRoutes,this.options.basePath??"",this.options.openapi),this.cachedSpec}mountRoutes(){let e=this.options.basePath??"",n=this.options.validateOutput??false,o=this.options.verbose??false;for(let r of this.mountedRoutes){if(!r.path)throw new Error(`[HonoServer] route "${r.method.toUpperCase()} (no path)" \u2014 missing \`path\`. Run the codegen so the path is derived from the file location, or set it explicitly.`);let a=S(e,r.path),s=r.middlewares??[],i=r.source??(r.method==="get"?"query":"json"),p=G(r,i,n,this.options.interceptor),u=r.method.toUpperCase();this.app.on(u,[a],...s,p),o&&console.log(`[HonoServer] ${r.method.toUpperCase().padEnd(6)} ${a}`);}}mountOpenApi(){let e=this.options.openapi;if(!e)return;let n=e.path??"/openapi.json",o=e.docsPath===void 0?"/docs":e.docsPath,r=S(this.options.basePath??"",n),a=o===false?null:S(this.options.basePath??"",o);this.app.get(r,s=>s.json(this.buildOpenApiSpec())),a&&this.app.get(a,s=>s.html(P(r,e.info.title)));}};function N(t,e){return e?t.filter(n=>n.api===e):t.slice()}function S(t,e){let n=t.endsWith("/")?t.slice(0,-1):t,o=e.startsWith("/")?e:`/${e}`,r=`${n}${o}`;return r===""?"/":r}function G(t,e,n,o){let r=t.input,a=t.output,s=t.status??200;return async i=>{let p=async()=>{let c;if(r){let l;try{l=await U(i,e,t.method);}catch(h){throw new g(h instanceof Error?h.message:String(h))}let f=r.safeParse(l);if(!f.success)throw new m(f.error,e);c=f.data;}let d=await t.handler({input:c,c:i});if(n&&a&&!(d instanceof Response)){let l=a.safeParse(d);if(!l.success)throw new y(l.error);return l.data}return d},u;if(o)u=await o({next:p,route:t,c:i});else try{u=await p();}catch(c){let d=L(i,c);if(d)return d;throw c}return u instanceof Response?u:i.json(u,s)}}var g=class extends Error{constructor(n){super(n);this.statusCode=400;this.name="BadRequestError";}},y=class extends Error{constructor(n){super("Output validation failed");this.zodError=n;this.statusCode=500;this.name="OutputValidationError";}};function L(t,e){return e instanceof m?t.json({success:false,error:"Validation failed",issues:D(e.zodError)},400):e instanceof g?t.json({success:false,error:"Bad Request",message:e.message},400):e instanceof y?t.json({success:false,error:"Output validation failed",issues:D(e.zodError)},500):null}async function U(t,e,n){switch(e){case "json":{if(n==="get")return t.req.query();let o=await t.req.text();if(!o)return {};try{return JSON.parse(o)}catch(r){throw new Error(`Invalid JSON body: ${r instanceof Error?r.message:String(r)}`)}}case "query":return t.req.query();case "form":return await t.req.parseBody();case "param":return t.req.param();default:return {}}}function D(t){return t.issues.map(e=>({path:e.path.join("."),code:e.code,message:e.message}))}function B(t){return t}var T={skipSegments:["useCases","useCase","use-cases","use-case"],casing:"preserve"};function x(t,e=T){let n=new Set(e.skipSegments.map(r=>r.toLowerCase()));return "/"+t.split("/").filter(Boolean).filter(r=>!n.has(r.toLowerCase())).map(r=>e.casing==="kebab"?V(r):r).join("/")}function V(t){return t.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/[\s_]+/g,"-").toLowerCase()}function A(t,e,n){let o=E(t),r=E(e),a=0;for(;a<o.length&&a<r.length&&o[a]===r[a];)a++;let s=o.length-a,i=r.slice(a),u=(i[i.length-1]??"").replace(/\.[mc]?[tj]sx?$/i,""),c=n===""?u:`${u}${n}`;return i[i.length-1]=c,(s===0?"./":"../".repeat(s))+i.join("/")}function E(t){return t.replace(/\\/g,"/").replace(/\/+$/,"").split("/").filter((n,o)=>!(o===0&&n===""))}var b={routesFile:"routes.ts",excludeSegments:["node_modules","__generated__","tests","__tests__",".turbo","dist","build",".next"]};function Y(t,e=b){let n=[];return I(t,t,e,n),n.sort((o,r)=>o.relPath.localeCompare(r.relPath)),n}function I(t,e,n,o){let r;try{r=readdirSync(e);}catch{return}for(let a of r){if(n.excludeSegments.includes(a))continue;let s=join(e,a),i;try{i=statSync(s);}catch{continue}if(i.isDirectory())I(t,s,n,o);else if(i.isFile()&&a===n.routesFile){let p=relative(t,s).split(sep).join("/"),u=p.replace(/\/?[^/]+$/,"");o.push({absPath:s,relPath:p,relDir:u});}}}var _="/**\n * AUTO-GENERATED by `@lpdjs/firestore-repo-service` Hono codegen.\n * Do not edit by hand \u2014 re-run `hono:gen` after adding / removing route files.\n */\n";function H(t,e){let n=dirname(e.outFile);mkdirSync(n,{recursive:true});let o=e.banner??_,r=(e.now??new Date).toISOString(),a=e.importExtension,s=[],i=[],p=[];t.forEach((c,d)=>{let l=A(n,c.absPath,a),f=x(c.relDir,e.derive);s.push(`import mod${d} from ${JSON.stringify(l)};`),i.push(`  { __derivedPath: ${JSON.stringify(f)}, mod: mod${d} },`),p.push({source:c.relPath,url:f});});let u=`${o}// Generated at ${r} \u2014 ${t.length} route file${t.length===1?"":"s"}.
+</html>`}var y=class{constructor(e){this.cachedSpec=null;this.options=e,this.app=new Hono,this.mountedRoutes=L(e.routes,e.api);let n=[...e.middlewares??[],...e.globalMiddlewares??[]];for(let o of n)this.app.use("*",o);this.mountRoutes(),this.mountOpenApi(),e.notFound&&this.app.notFound(e.notFound),e.onError&&this.app.onError(e.onError);}get hono(){return this.app}get nodeHandler(){return getRequestListener(this.app.fetch,{overrideGlobalObjects:false})}toFunction(e,n){let o=this.nodeHandler;return n?e(n,o):e(o)}buildOpenApiSpec(){if(this.cachedSpec)return this.cachedSpec;if(!this.options.openapi)throw new Error("[HonoServer] openapi config not set");return this.cachedSpec=v(this.mountedRoutes,this.options.basePath??"",this.options.openapi),this.cachedSpec}mountRoutes(){let e=this.options.basePath??"",n=this.options.validateOutput??false,o=this.options.verbose??false;for(let r of this.mountedRoutes){if(!r.path)throw new Error(`[HonoServer] route "${r.method.toUpperCase()} (no path)" \u2014 missing \`path\`. Run the codegen so the path is derived from the file location, or set it explicitly.`);let i=A(e,r.path),s=r.middlewares??[],a=r.source??(r.method==="get"?"query":"json"),u=B(r,a,n,this.options.interceptor),p=r.method.toUpperCase();this.app.on(p,[i],...s,u),o&&console.log(`[HonoServer] ${r.method.toUpperCase().padEnd(6)} ${i}`);}}mountOpenApi(){let e=this.options.openapi;if(!e)return;let n=e.path??"/openapi.json",o=e.docsPath===void 0?"/docs":e.docsPath,r=A(this.options.basePath??"",n),i=o===false?null:A(this.options.basePath??"",o);if(this.app.get(r,s=>s.json(this.buildOpenApiSpec())),i){let s=U(i,r);this.app.get(i,a=>a.html(E(s,e.info.title)));}}};function L(t,e){return e?t.filter(n=>Array.isArray(n.api)?n.api.includes(e):n.api===e):t.slice()}function A(t,e){let n=t.endsWith("/")?t.slice(0,-1):t,o=e.startsWith("/")?e:`/${e}`,r=`${n}${o}`;return r===""?"/":r}function U(t,e){let n=t.split("/").filter(Boolean),o=e.split("/").filter(Boolean);n.pop();let r=0;for(;r<n.length&&r<o.length&&n[r]===o[r];)r++;let i=n.length-r;return [...Array(i).fill(".."),...o.slice(r)].join("/")||"./"}function B(t,e,n,o){let r=t.input,i=t.output,s=t.status??200;return async a=>{let u=async()=>{let c;if(r){let l;try{l=await W(a,e,t.method);}catch(g){throw new h(g instanceof Error?g.message:String(g))}let f=r.safeParse(l);if(!f.success)throw new m(f.error,e);c=f.data;}let d=await t.handler({input:c,c:a});if(n&&i&&!(d instanceof Response)){let l=i.safeParse(d);if(!l.success)throw new R(l.error);return l.data}return d},p;if(o)p=await o({next:u,route:t,c:a});else try{p=await u();}catch(c){let d=V(a,c);if(d)return d;throw c}return p instanceof Response?p:a.json(p,s)}}var h=class extends Error{constructor(n){super(n);this.statusCode=400;this.name="BadRequestError";}},R=class extends Error{constructor(n){super("Output validation failed");this.zodError=n;this.statusCode=500;this.name="OutputValidationError";}};function V(t,e){return e instanceof m?t.json({success:false,error:"Validation failed",issues:x(e.zodError)},400):e instanceof h?t.json({success:false,error:"Bad Request",message:e.message},400):e instanceof R?t.json({success:false,error:"Output validation failed",issues:x(e.zodError)},500):null}async function W(t,e,n){switch(e){case "json":{if(n==="get")return t.req.query();let o=await t.req.text();if(!o)return {};try{return JSON.parse(o)}catch(r){throw new Error(`Invalid JSON body: ${r instanceof Error?r.message:String(r)}`)}}case "query":return t.req.query();case "form":return await t.req.parseBody();case "param":return t.req.param();default:return {}}}function x(t){return t.issues.map(e=>({path:e.path.join("."),code:e.code,message:e.message}))}function J(t){return {configs:t,defineRoute(e){return e},serverFor(e,n){let o=t[e];if(!o)throw new Error(`[ApiRegistry] unknown api "${e}". Registered: ${Object.keys(t).join(", ")}`);return new y({...o,api:e,routes:n})},toFunctions(e,n,o){let r={};for(let i of Object.keys(t)){let s={...o?.defaults??{},...o?.per?.[i]??{}},a=new y({...t[i],api:i,routes:e});r[i]=Object.keys(s).length?a.toFunction(n,s):a.toFunction(n);}return r}}}var D={skipSegments:["useCases","useCase","use-cases","use-case"],casing:"preserve"};function P(t,e=D){let n=new Set(e.skipSegments.map(r=>r.toLowerCase()));return "/"+t.split("/").filter(Boolean).filter(r=>!n.has(r.toLowerCase())).map(r=>e.casing==="kebab"?K(r):r).join("/")}function K(t){return t.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/[\s_]+/g,"-").toLowerCase()}function T(t,e,n){let o=O(t),r=O(e),i=0;for(;i<o.length&&i<r.length&&o[i]===r[i];)i++;let s=o.length-i,a=r.slice(i),p=(a[a.length-1]??"").replace(/\.[mc]?[tj]sx?$/i,""),c=n===""?p:`${p}${n}`;return a[a.length-1]=c,(s===0?"./":"../".repeat(s))+a.join("/")}function O(t){return t.replace(/\\/g,"/").replace(/\/+$/,"").split("/").filter((n,o)=>!(o===0&&n===""))}var b={routesFile:"routes.ts",excludeSegments:["node_modules","__generated__","tests","__tests__",".turbo","dist","build",".next"]};function ne(t,e=b){let n=[];return k(t,t,e,n),n.sort((o,r)=>o.relPath.localeCompare(r.relPath)),n}function k(t,e,n,o){let r;try{r=readdirSync(e);}catch{return}for(let i of r){if(n.excludeSegments.includes(i))continue;let s=join(e,i),a;try{a=statSync(s);}catch{continue}if(a.isDirectory())k(t,s,n,o);else if(a.isFile()&&i===n.routesFile){let u=relative(t,s).split(sep).join("/"),p=u.replace(/\/?[^/]+$/,"");o.push({absPath:s,relPath:u,relDir:p});}}}var M="/**\n * AUTO-GENERATED by `@lpdjs/firestore-repo-service` Hono codegen.\n * Do not edit by hand \u2014 re-run `hono:gen` after adding / removing route files.\n */\n";function I(t,e){let n=dirname(e.outFile);mkdirSync(n,{recursive:true});let o=e.banner??M,r=(e.now??new Date).toISOString(),i=e.importExtension,s=[],a=[],u=[];t.forEach((c,d)=>{let l=T(n,c.absPath,i),f=P(c.relDir,e.derive);s.push(`import mod${d} from ${JSON.stringify(l)};`),a.push(`  { __derivedPath: ${JSON.stringify(f)}, mod: mod${d} },`),u.push({source:c.relPath,url:f});});let p=`${o}// Generated at ${r} \u2014 ${t.length} route file${t.length===1?"":"s"}.
 
 import type { AnyRouteDef, RouteModuleDefault } from "@lpdjs/firestore-repo-service/servers/hono";
 
@@ -18,13 +18,13 @@ import type { AnyRouteDef, RouteModuleDefault } from "@lpdjs/firestore-repo-serv
 
 `:`
 `)+`const __defs: { __derivedPath: string; mod: RouteModuleDefault }[] = [
-`+i.join(`
-`)+(i.length?`
+`+a.join(`
+`)+(a.length?`
 `:"")+`];
 
 export const routes: AnyRouteDef[] = __defs.flatMap(({ __derivedPath, mod }) => {
   const list = Array.isArray(mod) ? mod : [mod];
   return list.map((route) => ({ ...route, path: route.path ?? __derivedPath }));
 });
-`;return writeFileSync(e.outFile,u,"utf8"),{outFile:e.outFile,routeCount:t.length,derivedPaths:p}}function oe(t,e,n,o,r){let a=r(t),s=join(t,e);return H(a,{outFile:s,derive:n,importExtension:o})}export{T as DEFAULT_DERIVE,_ as DEFAULT_GENERATOR_BANNER,b as DEFAULT_SCANNER,w as HonoServer,m as ValidationError,R as buildOpenApiDocument,B as defineRoute,x as derivePath,oe as generateFromRoot,H as generateRoutesManifest,P as renderDocsHtml,Y as scanRoutes,A as toImportSpecifier};//# sourceMappingURL=index.js.map
+`;return writeFileSync(e.outFile,p,"utf8"),{outFile:e.outFile,routeCount:t.length,derivedPaths:u}}function ae(t,e,n,o,r){let i=r(t),s=join(t,e);return I(i,{outFile:s,derive:n,importExtension:o})}export{D as DEFAULT_DERIVE,M as DEFAULT_GENERATOR_BANNER,b as DEFAULT_SCANNER,y as HonoServer,m as ValidationError,v as buildOpenApiDocument,J as createApiRegistry,P as derivePath,ae as generateFromRoot,I as generateRoutesManifest,E as renderDocsHtml,ne as scanRoutes,T as toImportSpecifier};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map