@lpdjs/firestore-repo-service 2.6.7 → 2.6.9

package/dist/servers/hono/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import {existsSync,mkdirSync,writeFileSync,readFileSync,readdirSync,statSync}from'fs';import {resolve,dirname,relative,join,sep}from'path';import {stdin,stdout}from'process';import {createInterface}from'readline/promises';var O={skipSegments:["useCases","useCase","use-cases","use-case"],casing:"preserve"};function M(e,t=O){let s=new Set(t.skipSegments.map(o=>o.toLowerCase()));return "/"+e.split("/").filter(Boolean).filter(o=>!s.has(o.toLowerCase())).map(o=>t.casing==="kebab"?se(o):o).join("/")}function se(e){return e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/[\s_]+/g,"-").toLowerCase()}function H(e,t,s){let r=B(e),o=B(t),n=0;for(;n<r.length&&n<o.length&&r[n]===o[n];)n++;let c=r.length-n,i=o.slice(n),d=(i[i.length-1]??"").replace(/\.[mc]?[tj]sx?$/i,""),f=s===""?d:`${d}${s}`;return i[i.length-1]=f,(c===0?"./":"../".repeat(c))+i.join("/")}function B(e){return e.replace(/\\/g,"/").replace(/\/+$/,"").split("/").filter((s,r)=>!(r===0&&s===""))}var ne="/**\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 W(e,t){let s=dirname(t.outFile);mkdirSync(s,{recursive:true});let r=t.banner??ne,o=(t.now??new Date).toISOString(),n=t.importExtension,c=[],i=[],a=[];e.forEach((f,u)=>{let x=H(s,f.absPath,n),v=M(f.relDir,t.derive);c.push(`import mod${u} from ${JSON.stringify(x)};`),i.push(`  { __derivedPath: ${JSON.stringify(v)}, mod: mod${u} },`),a.push({source:f.relPath,url:v});});let d=`${r}// Generated at ${o} \u2014 ${e.length} route file${e.length===1?"":"s"}.
+import {existsSync,mkdirSync,writeFileSync,readFileSync,readdirSync,statSync}from'fs';import {resolve,dirname,relative,join,sep}from'path';import {stdin,stdout}from'process';import {createInterface}from'readline/promises';var O={skipSegments:["useCases","useCase","use-cases","use-case"],casing:"preserve"};function M(e,t=O){let s=new Set(t.skipSegments.map(o=>o.toLowerCase()));return "/"+e.split("/").filter(Boolean).filter(o=>!s.has(o.toLowerCase())).map(o=>t.casing==="kebab"?oe(o):o).join("/")}function oe(e){return e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/[\s_]+/g,"-").toLowerCase()}function W(e,t,s){let r=H(e),o=H(t),i=0;for(;i<r.length&&i<o.length&&r[i]===o[i];)i++;let c=r.length-i,n=o.slice(i),d=(n[n.length-1]??"").replace(/\.[mc]?[tj]sx?$/i,""),f=s===""?d:`${d}${s}`;return n[n.length-1]=f,(c===0?"./":"../".repeat(c))+n.join("/")}function H(e){return e.replace(/\\/g,"/").replace(/\/+$/,"").split("/").filter((s,r)=>!(r===0&&s===""))}var ae="/**\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 J(e,t){let s=dirname(t.outFile);mkdirSync(s,{recursive:true});let r=t.banner??ae,o=(t.now??new Date).toISOString(),i=t.importExtension,c=[],n=[],a=[];e.forEach((f,p)=>{let P=W(s,f.absPath,i),y=M(f.relDir,t.derive);c.push(`import mod${p} from ${JSON.stringify(P)};`),n.push(`  { __derivedPath: ${JSON.stringify(y)}, mod: mod${p} },`),a.push({source:f.relPath,url:y});});let d=`${r}// Generated at ${o} \u2014 ${e.length} route file${e.length===1?"":"s"}.
 
 import type { AnyRouteDef, RouteModuleDefault } from "@lpdjs/firestore-repo-service/servers/hono";
 
@@ -8,16 +8,16 @@ import type { AnyRouteDef, RouteModuleDefault } from "@lpdjs/firestore-repo-serv
 
 `:`
 `)+`const __defs: { __derivedPath: string; mod: RouteModuleDefault }[] = [
-`+i.join(`
-`)+(i.length?`
+`+n.join(`
+`)+(n.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(t.outFile,d,"utf8"),{outFile:t.outFile,routeCount:e.length,derivedPaths:a}}var I={routesFile:"routes.ts",excludeSegments:["node_modules","__generated__","tests","__tests__",".turbo","dist","build",".next"]};function J(e,t=I){let s=[];return K(e,e,t,s),s.sort((r,o)=>r.relPath.localeCompare(o.relPath)),s}function K(e,t,s,r){let o;try{o=readdirSync(t);}catch{return}for(let n of o){if(s.excludeSegments.includes(n))continue;let c=join(t,n),i;try{i=statSync(c);}catch{continue}if(i.isDirectory())K(e,c,s,r);else if(i.isFile()&&n===s.routesFile){let a=relative(e,c).split(sep).join("/"),d=a.replace(/\/?[^/]+$/,"");r.push({absPath:c,relPath:a,relDir:d});}}}var X=".frsrc.json";function T(e=process.cwd()){let t=resolve(e,X);if(!existsSync(t))return {};try{return JSON.parse(readFileSync(t,"utf8"))}catch{return {}}}function me(e,t=process.cwd()){let s=resolve(t,X),o={...T(t),...e};return writeFileSync(s,`${JSON.stringify(o,null,2)}
-`,"utf8"),s}function ge(e){let[t,...s]=e,r={};for(let o=0;o<s.length;o++){let n=s[o];if(!n.startsWith("--"))continue;let c=n.slice(2),i=s[o+1];i&&!i.startsWith("--")?(r[c]=i,o++):r[c]=true;}return {command:t??"help",flags:r}}function Y(){console.log(`frs \u2014 Hono file-based codegen
+`;return writeFileSync(t.outFile,d,"utf8"),{outFile:t.outFile,routeCount:e.length,derivedPaths:a}}var E={routesFile:"routes.ts",excludeSegments:["node_modules","__generated__","tests","__tests__",".turbo","dist","build",".next"]};function K(e,t=E){let s=[];return V(e,e,t,s),s.sort((r,o)=>r.relPath.localeCompare(o.relPath)),s}function V(e,t,s,r){let o;try{o=readdirSync(t);}catch{return}for(let i of o){if(s.excludeSegments.includes(i))continue;let c=join(t,i),n;try{n=statSync(c);}catch{continue}if(n.isDirectory())V(e,c,s,r);else if(n.isFile()&&i===s.routesFile){let a=relative(e,c).split(sep).join("/"),d=a.replace(/\/?[^/]+$/,"");r.push({absPath:c,relPath:a,relDir:d});}}}var ee=".frsrc.json";function T(e=process.cwd()){let t=resolve(e,ee);if(!existsSync(t))return {};try{return JSON.parse(readFileSync(t,"utf8"))}catch{return {}}}function he(e,t=process.cwd()){let s=resolve(t,ee),o={...T(t),...e};return writeFileSync(s,`${JSON.stringify(o,null,2)}
+`,"utf8"),s}function ve(e){let[t,...s]=e,r={};for(let o=0;o<s.length;o++){let i=s[o];if(!i.startsWith("--"))continue;let c=i.slice(2),n=s[o+1];n&&!n.startsWith("--")?(r[c]=n,o++):r[c]=true;}return {command:t??"help",flags:r}}function Z(){console.log(`frs \u2014 Hono file-based codegen
 
 Usage:
   frs init [flags]
@@ -62,8 +62,10 @@ Flags (new <name>):
   --usecase-folder <name>
                         Parent folder under <domain>.
                         Default: .frsrc.json "useCaseFolder" or useCases
-  --with-usecase        Also scaffold a sibling useCase.ts file (default: true)
-  --with-test           Also scaffold a sibling useCase.test.ts (Vitest, default: true)
+  --with-usecase        Also scaffold a sibling <domain>.<name>.useCase.ts file
+                        (default: true)
+  --with-test           Also scaffold a sibling <domain>.<name>.useCase.test.ts
+                        (Vitest, default: true)
   --apis-import <path>  Import path for the registry (default: auto-detect
                         ../../../../apis.js \u2014 adjust if your layout differs)
   --force               Overwrite if files already exist
@@ -81,8 +83,8 @@ Examples:
   frs new createPost --domain posts --method post
   frs new listPosts  --domain posts --method get --api v1
   frs add service postRepo
-`);}function Z(e){if(typeof e=="string")return e.split(",").map(t=>t.trim()).filter(Boolean)}function m(e){return typeof e=="string"?e:void 0}function ee(e){if(e||!stdin.isTTY)return {ask:async(s,r)=>r??"",askChoice:async(s,r,o)=>o??"",askBool:async(s,r)=>r,close:()=>{}};let t=createInterface({input:stdin,output:stdout});return {async ask(s,r){let o=r?` (${r})`:"";return (await t.question(`? ${s}${o} \u203A `)).trim()||r||""},async askChoice(s,r,o){let n=` [${r.join("/")}${o?`, default: ${o}`:""}]`;for(;;){let c=(await t.question(`? ${s}${n} \u203A `)).trim().toLowerCase();if(!c&&o)return o;if(r.includes(c))return c;console.log(`  invalid choice \u2014 pick one of: ${r.join(", ")}`);}},async askBool(s,r){let o=` (${r?"Y/n":"y/N"})`,n=(await t.question(`? ${s}${o} \u203A `)).trim().toLowerCase();return n?n==="y"||n==="yes"||n==="true":r},close:()=>t.close()}}async function he(e){let t=T(),s=m(e.root)??t.root;s||(console.error("[frs] --root is required (or run `frs init` to write it to .frsrc.json)"),process.exit(2));let r=resolve(process.cwd(),s);existsSync(r)||(console.error(`[frs] root not found: ${r}`),process.exit(2));let o=m(e.out)??t.out??"__generated__/routes.ts",n=Z(e.skip)??O.skipSegments,c=m(e.casing)==="kebab"?"kebab":O.casing,i={skipSegments:n,casing:c},a=m(e.ext)??".js",d=Z(e.exclude)??I.excludeSegments,f=m(e["routes-file"])??I.routesFile,x=J(r,{routesFile:f,excludeSegments:d});x.length===0&&console.warn(`[frs] no "${f}" files found under ${r} \u2014 generated an empty manifest.`);let v=W(x,{outFile:resolve(r,o),derive:i,importExtension:a});if(!e.silent){console.log(`[frs] wrote ${v.outFile}  (${v.routeCount} route${v.routeCount===1?"":"s"})`);for(let{source:S,url:g}of v.derivedPaths)console.log(`  ${g.padEnd(48)}  \u2190  ${S}`);}}async function ve(e,t){let s=t.yes===true,r=ee(s),o=T();try{let n=e&&!e.startsWith("--")?e:void 0;n||(n=(await r.ask("Route name (e.g. createPost)")).trim(),n||(console.error("[frs] route name is required"),process.exit(2)));let c=m(t.domain);c||(c=(await r.ask("Domain name (e.g. posts)")).trim(),c||(console.error("[frs] --domain is required"),process.exit(2)));let i=m(t.root)??o.root??"src/domains",a=m(t.method)?.toLowerCase();a||(a=await r.askChoice("HTTP method",["get","post","put","patch","delete"],"post")),["get","post","put","patch","delete"].includes(a)||(console.error(`[frs] invalid --method: ${a}`),process.exit(2));let d=m(t.api);if(!d){let $=o.apis?.[0]??"v1";d=(await r.ask("API tag",$)).trim()||$;}let f=m(t["usecase-folder"])??o.useCaseFolder??"useCases",u=t["with-usecase"]===void 0?s?!0:await r.askBool("Scaffold useCase.ts?",!0):t["with-usecase"]!==!1,x=t["with-test"]===void 0?s||!u?u:await r.askBool("Scaffold useCase.test.ts (Vitest)?",!0):t["with-test"]!==!1,v=t.force===!0,S=resolve(process.cwd(),i),g=resolve(S,c,f,n),D=resolve(g,"routes.ts"),b=resolve(g,"useCase.ts"),k=resolve(g,"useCase.test.ts");mkdirSync(g,{recursive:!0});let y=`${n.charAt(0).toUpperCase()}${n.slice(1)}UseCase`,P="@lpdjs/firestore-repo-service/servers/hono",F=xe(S,g),_=a==="get"?"// GET \u2192 lu depuis les query params":`// ${a.toUpperCase()} \u2192 lu depuis le body JSON`,h=`/**
- * ${y} \u2014 pure business logic, no HTTP awareness.
+`);}function Q(e){if(typeof e=="string")return e.split(",").map(t=>t.trim()).filter(Boolean)}function m(e){return typeof e=="string"?e:void 0}function te(e){if(e||!stdin.isTTY)return {ask:async(s,r)=>r??"",askChoice:async(s,r,o)=>o??"",askBool:async(s,r)=>r,close:()=>{}};let t=createInterface({input:stdin,output:stdout});return {async ask(s,r){let o=r?` (${r})`:"";return (await t.question(`? ${s}${o} \u203A `)).trim()||r||""},async askChoice(s,r,o){let i=` [${r.join("/")}${o?`, default: ${o}`:""}]`;for(;;){let c=(await t.question(`? ${s}${i} \u203A `)).trim().toLowerCase();if(!c&&o)return o;if(r.includes(c))return c;console.log(`  invalid choice \u2014 pick one of: ${r.join(", ")}`);}},async askBool(s,r){let o=` (${r?"Y/n":"y/N"})`,i=(await t.question(`? ${s}${o} \u203A `)).trim().toLowerCase();return i?i==="y"||i==="yes"||i==="true":r},close:()=>t.close()}}async function ye(e){let t=T(),s=m(e.root)??t.root;s||(console.error("[frs] --root is required (or run `frs init` to write it to .frsrc.json)"),process.exit(2));let r=resolve(process.cwd(),s);existsSync(r)||(console.error(`[frs] root not found: ${r}`),process.exit(2));let o=m(e.out)??t.out??"__generated__/routes.ts",i=Q(e.skip)??O.skipSegments,c=m(e.casing)==="kebab"?"kebab":O.casing,n={skipSegments:i,casing:c},a=m(e.ext)??".js",d=Q(e.exclude)??E.excludeSegments,f=m(e["routes-file"])??E.routesFile,P=K(r,{routesFile:f,excludeSegments:d});P.length===0&&console.warn(`[frs] no "${f}" files found under ${r} \u2014 generated an empty manifest.`);let y=J(P,{outFile:resolve(r,o),derive:n,importExtension:a});if(!e.silent){console.log(`[frs] wrote ${y.outFile}  (${y.routeCount} route${y.routeCount===1?"":"s"})`);for(let{source:S,url:g}of y.derivedPaths)console.log(`  ${g.padEnd(48)}  \u2190  ${S}`);}}async function $e(e,t){let s=t.yes===true,r=te(s),o=T();try{let i=e&&!e.startsWith("--")?e:void 0;i||(i=(await r.ask("Route name (e.g. createPost)")).trim(),i||(console.error("[frs] route name is required"),process.exit(2)));let c=m(t.domain);c||(c=(await r.ask("Domain name (e.g. posts)")).trim(),c||(console.error("[frs] --domain is required"),process.exit(2)));let n=m(t.root)??o.root??"src/domains",a=m(t.method)?.toLowerCase();a||(a=await r.askChoice("HTTP method",["get","post","put","patch","delete"],"post")),["get","post","put","patch","delete"].includes(a)||(console.error(`[frs] invalid --method: ${a}`),process.exit(2));let d=m(t.api);if(!d){let v=o.apis?.[0]??"v1";d=(await r.ask("API tag",v)).trim()||v;}let f=m(t["usecase-folder"])??o.useCaseFolder??"useCases",p=t["with-usecase"]===void 0?s?!0:await r.askBool("Scaffold useCase.ts?",!0):t["with-usecase"]!==!1,P=t["with-test"]===void 0?s||!p?p:await r.askBool("Scaffold useCase.test.ts (Vitest)?",!0):t["with-test"]!==!1,y=t.force===!0,S=resolve(process.cwd(),n),g=resolve(S,c,f,i),A=resolve(g,"routes.ts"),$=`${c}.${i}.useCase`,R=resolve(g,`${$}.ts`),k=resolve(g,`${$}.test.ts`);mkdirSync(g,{recursive:!0});let F=v=>v.charAt(0).toUpperCase()+v.slice(1),w=`${F(c)}${F(i)}UseCase`,D="@lpdjs/firestore-repo-service/servers/hono",h=Se(S,g),b=a==="get"?"// GET \u2192 lu depuis les query params":`// ${a.toUpperCase()} \u2192 lu depuis le body JSON`,L=`/**
+ * ${w} \u2014 pure business logic, no HTTP awareness.
  *
  * Owns its Zod \`input\` / \`output\` schemas (declared as \`static\` members, the
  * single source of truth shared with \`routes.ts\`) and runs the logic in
@@ -91,11 +93,11 @@ Examples:
  */
 
 import { z } from "zod";
-import { UseCase } from "${P}";
-import type { Services } from "${F}";
+import { UseCase } from "${D}";
+import type { Services } from "${h}";
 
 const input = z.object({
-  ${_}
+  ${b}
   example: z.string(),
 });
 
@@ -103,7 +105,7 @@ const output = z.object({
   id: z.string(),
 });
 
-export class ${y} extends UseCase<typeof input, typeof output, Services> {
+export class ${w} extends UseCase<typeof input, typeof output, Services> {
   static readonly input = input;
   static readonly output = output;
 
@@ -114,22 +116,22 @@ export class ${y} extends UseCase<typeof input, typeof output, Services> {
     return { id: payload.example };
   }
 }
-`,C=a==="get"?`
-    source: "query",`:"",N=u?`import { ${y} } from "./useCase.js";
-`:"",p=m(t["apis-import"])??we(S,g),j=u?`import { defineRoutes } from "${P}";
-import { useCaseRoute } from "${p}";
-${N}
+`,l=a==="get"?`
+    source: "query",`:"",_=p?`import { ${w} } from "./${$}.js";
+`:"",U=m(t["apis-import"])??Pe(S,g),se=p?`import { defineRoutes } from "${D}";
+import { useCaseRoute } from "${U}";
+${_}
 export default defineRoutes([
-  useCaseRoute(${y}, {
+  useCaseRoute(${w}, {
     api: "${d}",
-    method: "${a}",${C}
-    summary: "TODO: ${n}",
+    method: "${a}",${l}
+    summary: "TODO: ${i}",
     tags: ["${c}"],
   }),
 ]);
 `:`import { z } from "zod";
-import { defineRoutes } from "${P}";
-import { defineRoute } from "${p}";
+import { defineRoutes } from "${D}";
+import { defineRoute } from "${U}";
 
 export default defineRoutes([
   defineRoute({
@@ -137,7 +139,7 @@ export default defineRoutes([
     method: "${a}",
 
     input: z.object({
-      ${_}
+      ${b}
       example: z.string(),
     }),
 
@@ -145,7 +147,7 @@ export default defineRoutes([
       id: z.string(),
     }),
 
-    summary: "TODO: ${n}",
+    summary: "TODO: ${i}",
     tags: ["${c}"],
 
     handler: async ({ input }) => {
@@ -154,44 +156,52 @@ export default defineRoutes([
     },
   }),
 ]);
-`,z=[],G=[],q=($,te)=>{if(existsSync($)&&!v){G.push($);return}writeFileSync($,te,"utf8"),z.push($);};if(q(D,j),u&&q(b,h),u&&x){let $=`import { describe, it, expect } from "vitest";
-import type { Services } from "${F}";
-import { ${y} } from "./useCase.js";
+`,z=[],G=[],N=(v,re)=>{if(existsSync(v)&&!y){G.push(v);return}writeFileSync(v,re,"utf8"),z.push(v);};if(N(A,se),p&&N(R,L),p&&P){let v=`import { describe, it, expect } from "vitest";
+import type { Services } from "${h}";
+import { ${w} } from "./${$}.js";
 
-describe("${y}", () => {
+describe("${w}", () => {
   it("returns a response shaped like the output schema", async () => {
     // TODO: replace with real mocks for the services the useCase consumes.
     const services = {} as unknown as Services;
 
-    const useCase = new ${y}(services);
+    const useCase = new ${w}(services);
     const result = await useCase.execute({ example: "hello" });
     expect(result).toMatchObject({ id: expect.any(String) });
   });
 
   // TODO: add error-path tests, repository mocks, etc.
 });
-`;q(k,$);}for(let $ of z)console.log(`[frs] wrote   ${$}`);for(let $ of G)console.log(`[frs] skipped ${$} (use --force to overwrite)`);console.log(`
-[frs] reminder: run "frs gen --root ${i}" to refresh the manifest.`);}finally{r.close();}}async function ye(e){let t=e.yes===true,s=ee(t);try{let r=e.force===!0,o=m(e.root);o||(o=(await s.ask("Domain root","src/domains")).trim()||"src/domains");let n=m(e["apis-file"]);n||(n=(await s.ask("apis.ts location","src/apis.ts")).trim()||"src/apis.ts");let c=m(e["services-file"]);if(!c){let p=n.replace(/apis\.ts$/,"services.ts")||"src/services.ts";c=(await s.ask("services.ts location",p)).trim()||p;}let i=m(e.apis);i||(i=(await s.ask("API tags (comma-separated)","v1")).trim()||"v1");let a=i.split(",").map(p=>p.trim()).filter(Boolean);a.length===0&&(console.error("[frs] at least one API tag is required"),process.exit(2));let d=m(e["base-path"]),f=resolve(process.cwd(),o),u=resolve(process.cwd(),n),x=resolve(process.cwd(),c),v=resolve(f,"__generated__"),S=resolve(v,"routes.ts"),g=[],D=[],b=(p,j)=>{if(mkdirSync(dirname(p),{recursive:!0}),existsSync(p)&&!r){D.push(p);return}writeFileSync(p,j,"utf8"),g.push(p);},k=a.map(p=>{let j=d??`/${p}`;return `    ${p}: {
-      basePath: "${j}",
+`;N(k,v);}for(let v of z)console.log(`[frs] wrote   ${v}`);for(let v of G)console.log(`[frs] skipped ${v} (use --force to overwrite)`);console.log(`
+[frs] reminder: run "frs gen --root ${n}" to refresh the manifest.`);}finally{r.close();}}async function we(e){let t=e.yes===true,s=te(t);try{let r=e.force===!0,o=m(e.root);o||(o=(await s.ask("Domain root","src/domains")).trim()||"src/domains");let i=m(e["apis-file"]);i||(i=(await s.ask("apis.ts location","src/apis.ts")).trim()||"src/apis.ts");let c=m(e["services-file"]);if(!c){let l=i.replace(/apis\.ts$/,"services.ts")||"src/services.ts";c=(await s.ask("services.ts location",l)).trim()||l;}let n=m(e.apis);n||(n=(await s.ask("API tags (comma-separated)","v1")).trim()||"v1");let a=n.split(",").map(l=>l.trim()).filter(Boolean);a.length===0&&(console.error("[frs] at least one API tag is required"),process.exit(2));let d=m(e["base-path"]),f=resolve(process.cwd(),o),p=resolve(process.cwd(),i),P=resolve(process.cwd(),c),y=resolve(f,"__generated__"),S=resolve(y,"routes.ts"),g=[],A=[],$=(l,_)=>{if(mkdirSync(dirname(l),{recursive:!0}),existsSync(l)&&!r){A.push(l);return}writeFileSync(l,_,"utf8"),g.push(l);},R=a.map(l=>{let _=d??`/${l}`;return `    ${l}: {
+      basePath: "${_}",
       openapi: {
-        info: { title: "${p.toUpperCase()} API", version: "1.0.0", description: "" },
+        info: { title: "${l.toUpperCase()} API", version: "1.0.0", description: "" },
       },
+      // Built-in error mapping. Extend BaseErrorHandler to map your own
+      // domain errors, then swap it in here (per API).
+      errorHandler: new BaseErrorHandler(),
+      // Structured console logger. Extend BaseLogger (override \`write\`) to
+      // route to your sink, then swap it in here (per API).
+      logger: new BaseLogger(),
       verbose: process.env["NODE_ENV"] !== "production",
     },`}).join(`
-`),y=`import { createApiRegistry } from "@lpdjs/firestore-repo-service/servers/hono";
-import { services } from "${E(dirname(u),x)}";
+`),k=`import { BaseErrorHandler, BaseLogger, createApiRegistry } from "@lpdjs/firestore-repo-service/servers/hono";
+import { services } from "${I(dirname(p),P)}";
 
 /**
  * Single source of truth for every API exposed by this project.
  * Add per-API middlewares, interceptors, OpenAPI metadata here.
  *
- * The shared \`services\` container is injected into every HonoServer the
- * registry builds \u2014 handlers / interceptors receive it via \`{ services }\`
- * and the built-in \`services.ctx.c\` resolves to the current request.
+ * Per-API resources injected into every handler / interceptor / error-handler
+ * context (override them per API above):
+ *   - \`services\`     \u2014 shared DI container (\`services.ctx.c\` = current request);
+ *   - \`errorHandler\` \u2014 maps thrown errors \u2192 HTTP (extend \`BaseErrorHandler\`);
+ *   - \`logger\`       \u2014 structured logging (extend \`BaseLogger\`).
  */
 export const apis = createApiRegistry(
   {
-${k}
+${R}
   },
   { services },
 );
@@ -199,7 +209,7 @@ ${k}
 /** Typed helpers used inside every route file. */
 export const defineRoute = apis.defineRoute;
 export const useCaseRoute = apis.useCaseRoute;
-`;b(u,y),b(x,`import { createServices } from "@lpdjs/firestore-repo-service/servers/hono";
+`;$(p,k),$(P,`import { createServices } from "@lpdjs/firestore-repo-service/servers/hono";
 
 /**
  * Global DI container \u2014 declare every singleton (repositories, SDK
@@ -232,22 +242,22 @@ export const services = createServices({
 
 /** Convenience type \u2014 \`function fn(svc: Services) { ... }\`. */
 export type Services = typeof services;
-`);let F=`// AUTO-GENERATED by frs \u2014 do not edit.
+`);let w=`// AUTO-GENERATED by frs \u2014 do not edit.
 // Run \`frs gen --root ${o}\` to refresh.
 
 import type { AnyRouteDef } from "@lpdjs/firestore-repo-service/servers/hono";
 
 export const routes: AnyRouteDef[] = [];
-`;b(S,F);let _=me({root:o,apisFile:n,servicesFile:c,apis:a});g.push(_);let h=E(dirname(u),u),C=E(dirname(u),S),N=a.length===1?`export const { ${a[0]} } = apis.toFunctions(routes, onRequest, {`:`export const { ${a.join(", ")} } = apis.toFunctions(routes, onRequest, {`;for(let p of g)console.log(`[frs] wrote   ${p}`);for(let p of D)console.log(`[frs] skipped ${p} (use --force to overwrite)`);console.log(`
+`;$(S,w);let D=he({root:o,apisFile:i,servicesFile:c,apis:a});g.push(D);let h=I(dirname(p),p),b=I(dirname(p),S),L=a.length===1?`export const { ${a[0]} } = apis.toFunctions(routes, onRequest, {`:`export const { ${a.join(", ")} } = apis.toFunctions(routes, onRequest, {`;for(let l of g)console.log(`[frs] wrote   ${l}`);for(let l of A)console.log(`[frs] skipped ${l} (use --force to overwrite)`);console.log(`
 Next steps:
 
 1. Wire the registry in your Functions entrypoint (e.g. src/index.ts):
 
    import { onRequest } from "firebase-functions/v2/https";
    import { apis } from "${h}";
-   import { routes } from "${C}";
+   import { routes } from "${b}";
 
-   ${N}
+   ${L}
      defaults: { region: "us-central1", invoker: "public" },
    });
 
@@ -258,10 +268,10 @@ Next steps:
 3. Refresh the manifest before each build:
 
    frs gen --root ${o}
-`);}finally{s.close();}}function E(e,t){let s=relative(e,t).replace(/\\/g,"/");return s=s.replace(/\.ts$/,".js"),s.startsWith(".")||(s=`./${s}`),s}async function $e(e,t,s){e!=="service"&&(console.error(`[frs] unknown "add" target: ${e??"(missing)"} \u2014 supported: service`),process.exit(2)),t||(console.error("[frs] service name is required: frs add service <name>"),process.exit(2));let r=s.force===true,o=T(),c=[m(s["services-file"]),o.servicesFile,"src/services.ts","services.ts"].filter(h=>typeof h=="string"&&h.length>0),i;for(let h of c){let C=resolve(process.cwd(),h);if(existsSync(C)){i=C;break}}if(!i){let h=c.map(C=>resolve(process.cwd(),C)).join(`
+`);}finally{s.close();}}function I(e,t){let s=relative(e,t).replace(/\\/g,"/");return s=s.replace(/\.ts$/,".js"),s.startsWith(".")||(s=`./${s}`),s}async function xe(e,t,s){e!=="service"&&(console.error(`[frs] unknown "add" target: ${e??"(missing)"} \u2014 supported: service`),process.exit(2)),t||(console.error("[frs] service name is required: frs add service <name>"),process.exit(2));let r=s.force===true,o=T(),c=[m(s["services-file"]),o.servicesFile,"src/services.ts","services.ts"].filter(h=>typeof h=="string"&&h.length>0),n;for(let h of c){let b=resolve(process.cwd(),h);if(existsSync(b)){n=b;break}}if(!n){let h=c.map(b=>resolve(process.cwd(),b)).join(`
         `);console.error(`[frs] services file not found. Tried:
         ${h}
-      Run \`frs init\` first or pass --services-file <path>.`),process.exit(2);}let a=m(s["services-dir"])??o.servicesDir??resolve(dirname(i),"services"),d=resolve(process.cwd(),a);mkdirSync(d,{recursive:true});let f=`${t.charAt(0).toUpperCase()}${t.slice(1)}Service`,u=resolve(d,`${t}.ts`),x=`import type { RequestContext } from "@lpdjs/firestore-repo-service/servers/hono";
+      Run \`frs init\` first or pass --services-file <path>.`),process.exit(2);}let a=m(s["services-dir"])??o.servicesDir??resolve(dirname(n),"services"),d=resolve(process.cwd(),a);mkdirSync(d,{recursive:true});let f=`${t.charAt(0).toUpperCase()}${t.slice(1)}Service`,p=resolve(d,`${t}.ts`),P=`import type { RequestContext } from "@lpdjs/firestore-repo-service/servers/hono";
 
 /**
  * ${f} \u2014 generated by \`frs add service ${t}\`.
@@ -290,9 +300,9 @@ export class ${f} {
     return \`hello from ${t} \u2014 user=\${this.ctx.maybeC?.get("user")?.id ?? "anonymous"}\`;
   }
 }
-`;existsSync(u)&&!r?console.log(`[frs] skipped ${u} (use --force to overwrite)`):(writeFileSync(u,x,"utf8"),console.log(`[frs] wrote   ${u}`));let v=readFileSync(i,"utf8"),S=E(dirname(i),u),g=`import { ${f} } from "${S}";`,D=`  ${t}: ({ ctx }) => new ${f}(ctx),`;if(v.includes(g)){console.log(`[frs] services.ts already registers "${t}" \u2014 skipping.`);return}let b=v.split(`
-`),k=-1;for(let h=0;h<b.length;h++)/^import\s/.test(b[h])&&(k=h);k>=0?b.splice(k+1,0,g):b.unshift(g);let y=b.join(`
-`),P=y.match(/createServices\s*\(\s*\{/);if(!P){console.error(`[frs] could not find \`createServices({\` in ${i} \u2014 register "${t}" manually.`);return}let F=P.index+P[0].length,_=y.slice(0,F)+`
-`+D+y.slice(F);writeFileSync(i,_,"utf8"),console.log(`[frs] updated ${i}  (+ ${t})`);}function we(e,t){let s=["apis.ts","apis.js","api.ts","api.js"],r=[e,dirname(e),dirname(dirname(e))];for(let o of r)for(let n of s){let c=resolve(o,n);if(existsSync(c)){let i=relative(t,c).replace(/\\/g,"/");return i=i.replace(/\.ts$/,".js").replace(/\.js$/,".js"),i.startsWith(".")||(i=`./${i}`),i}}return "../../../../apis.js"}function xe(e,t){let s=["services.ts","services.js"],r=[e,dirname(e),dirname(dirname(e))];for(let o of r)for(let n of s){let c=resolve(o,n);if(existsSync(c)){let i=relative(t,c).replace(/\\/g,"/");return i=i.replace(/\.ts$/,".js"),i.startsWith(".")||(i=`./${i}`),i}}return "../../../../services.js"}async function be(){let e=process.argv.slice(2),{command:t,flags:s}=ge(e);switch(t){case "init":await ye(s);return;case "gen":await he(s);return;case "new":await ve(e[1],s);return;case "add":await $e(e[1],e[2],s);return;case "help":case "--help":case "-h":Y();return;default:console.error(`[frs] unknown command: ${t}
-`),Y(),process.exit(2);}}be().catch(e=>{console.error(e),process.exit(1);});//# sourceMappingURL=cli.js.map
+`;existsSync(p)&&!r?console.log(`[frs] skipped ${p} (use --force to overwrite)`):(writeFileSync(p,P,"utf8"),console.log(`[frs] wrote   ${p}`));let y=readFileSync(n,"utf8"),S=I(dirname(n),p),g=`import { ${f} } from "${S}";`,A=`  ${t}: ({ ctx }) => new ${f}(ctx),`;if(y.includes(g)){console.log(`[frs] services.ts already registers "${t}" \u2014 skipping.`);return}let $=y.split(`
+`),R=-1;for(let h=0;h<$.length;h++)/^import\s/.test($[h])&&(R=h);R>=0?$.splice(R+1,0,g):$.unshift(g);let k=$.join(`
+`),F=k.match(/createServices\s*\(\s*\{/);if(!F){console.error(`[frs] could not find \`createServices({\` in ${n} \u2014 register "${t}" manually.`);return}let w=F.index+F[0].length,D=k.slice(0,w)+`
+`+A+k.slice(w);writeFileSync(n,D,"utf8"),console.log(`[frs] updated ${n}  (+ ${t})`);}function Pe(e,t){let s=["apis.ts","apis.js","api.ts","api.js"],r=[e,dirname(e),dirname(dirname(e))];for(let o of r)for(let i of s){let c=resolve(o,i);if(existsSync(c)){let n=relative(t,c).replace(/\\/g,"/");return n=n.replace(/\.ts$/,".js").replace(/\.js$/,".js"),n.startsWith(".")||(n=`./${n}`),n}}return "../../../../apis.js"}function Se(e,t){let s=["services.ts","services.js"],r=[e,dirname(e),dirname(dirname(e))];for(let o of r)for(let i of s){let c=resolve(o,i);if(existsSync(c)){let n=relative(t,c).replace(/\\/g,"/");return n=n.replace(/\.ts$/,".js"),n.startsWith(".")||(n=`./${n}`),n}}return "../../../../services.js"}async function be(){let e=process.argv.slice(2),{command:t,flags:s}=ve(e);switch(t){case "init":await we(s);return;case "gen":await ye(s);return;case "new":await $e(e[1],s);return;case "add":await xe(e[1],e[2],s);return;case "help":case "--help":case "-h":Z();return;default:console.error(`[frs] unknown command: ${t}
+`),Z(),process.exit(2);}}be().catch(e=>{console.error(e),process.exit(1);});//# sourceMappingURL=cli.js.map
 //# sourceMappingURL=cli.js.map