@lpdjs/firestore-repo-service 2.6.12 → 2.6.13

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 I={skipSegments:["useCases","useCase","use-cases","use-case"],casing:"preserve"};function J(e,r=I){let s=new Set(r.skipSegments.map(o=>o.toLowerCase()));return "/"+e.split("/").filter(Boolean).filter(o=>!s.has(o.toLowerCase())).map(o=>r.casing==="kebab"?ne(o):o).join("/")}function ne(e){return e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/[\s_]+/g,"-").toLowerCase()}function Z(e,r,s){let t=W(e),o=W(r),i=0;for(;i<t.length&&i<o.length&&t[i]===o[i];)i++;let a=t.length-i,n=o.slice(i),f=(n[n.length-1]??"").replace(/\.[mc]?[tj]sx?$/i,""),g=s===""?f:`${f}${s}`;return n[n.length-1]=g,(a===0?"./":"../".repeat(a))+n.join("/")}function W(e){return e.replace(/\\/g,"/").replace(/\/+$/,"").split("/").filter((s,t)=>!(t===0&&s===""))}var pe="/**\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 K(e,r){let s=dirname(r.outFile);mkdirSync(s,{recursive:true});let t=r.banner??pe,o=(r.now??new Date).toISOString(),i=r.importExtension,a=[],n=[],c=[];e.forEach((g,p)=>{let b=Z(s,g.absPath,i),h=J(g.relDir,r.derive);a.push(`import mod${p} from ${JSON.stringify(b)};`),n.push(`  { __derivedPath: ${JSON.stringify(h)}, mod: mod${p} },`),c.push({source:g.relPath,url:h});});let f=`${t}// 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 _={skipSegments:["useCases","useCase","use-cases","use-case"],casing:"preserve"};function J(e,r=_){let s=new Set(r.skipSegments.map(o=>o.toLowerCase()));return "/"+e.split("/").filter(Boolean).filter(o=>!s.has(o.toLowerCase())).map(o=>r.casing==="kebab"?ne(o):o).join("/")}function ne(e){return e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/[\s_]+/g,"-").toLowerCase()}function Z(e,r,s){let t=W(e),o=W(r),i=0;for(;i<t.length&&i<o.length&&t[i]===o[i];)i++;let a=t.length-i,n=o.slice(i),f=(n[n.length-1]??"").replace(/\.[mc]?[tj]sx?$/i,""),g=s===""?f:`${f}${s}`;return n[n.length-1]=g,(a===0?"./":"../".repeat(a))+n.join("/")}function W(e){return e.replace(/\\/g,"/").replace(/\/+$/,"").split("/").filter((s,t)=>!(t===0&&s===""))}var pe="/**\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 K(e,r){let s=dirname(r.outFile);mkdirSync(s,{recursive:true});let t=r.banner??pe,o=(r.now??new Date).toISOString(),i=r.importExtension,a=[],n=[],c=[];e.forEach((g,p)=>{let b=Z(s,g.absPath,i),h=J(g.relDir,r.derive);a.push(`import mod${p} from ${JSON.stringify(b)};`),n.push(`  { __derivedPath: ${JSON.stringify(h)}, mod: mod${p} },`),c.push({source:g.relPath,url:h});});let f=`${t}// Generated at ${o} \u2014 ${e.length} route file${e.length===1?"":"s"}.
 
 import type { AnyRouteDef, RouteModuleDefault } from "@lpdjs/firestore-repo-service/servers/hono";
 
@@ -16,7 +16,7 @@ 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(r.outFile,f,"utf8"),{outFile:r.outFile,routeCount:e.length,derivedPaths:c}}var L={routesFile:"routes.ts",excludeSegments:["node_modules","__generated__","tests","__tests__",".turbo","dist","build",".next"]};function V(e,r=L){let s=[];return Y(e,e,r,s),s.sort((t,o)=>t.relPath.localeCompare(o.relPath)),s}function Y(e,r,s,t){let o;try{o=readdirSync(r);}catch{return}for(let i of o){if(s.excludeSegments.includes(i))continue;let a=join(r,i),n;try{n=statSync(a);}catch{continue}if(n.isDirectory())Y(e,a,s,t);else if(n.isFile()&&i===s.routesFile){let c=relative(e,a).split(sep).join("/"),f=c.replace(/\/?[^/]+$/,"");t.push({absPath:a,relPath:c,relDir:f});}}}var se=".frsrc.json";function U(e=process.cwd()){let r=resolve(e,se);if(!existsSync(r))return {};try{return JSON.parse(readFileSync(r,"utf8"))}catch{return {}}}function ve(e,r=process.cwd()){let s=resolve(r,se),o={...U(r),...e};return writeFileSync(s,`${JSON.stringify(o,null,2)}
+`;return writeFileSync(r.outFile,f,"utf8"),{outFile:r.outFile,routeCount:e.length,derivedPaths:c}}var I={routesFile:"routes.ts",excludeSegments:["node_modules","__generated__","tests","__tests__",".turbo","dist","build",".next"]};function V(e,r=I){let s=[];return Y(e,e,r,s),s.sort((t,o)=>t.relPath.localeCompare(o.relPath)),s}function Y(e,r,s,t){let o;try{o=readdirSync(r);}catch{return}for(let i of o){if(s.excludeSegments.includes(i))continue;let a=join(r,i),n;try{n=statSync(a);}catch{continue}if(n.isDirectory())Y(e,a,s,t);else if(n.isFile()&&i===s.routesFile){let c=relative(e,a).split(sep).join("/"),f=c.replace(/\/?[^/]+$/,"");t.push({absPath:a,relPath:c,relDir:f});}}}var se=".frsrc.json";function z(e=process.cwd()){let r=resolve(e,se);if(!existsSync(r))return {};try{return JSON.parse(readFileSync(r,"utf8"))}catch{return {}}}function ve(e,r=process.cwd()){let s=resolve(r,se),o={...z(r),...e};return writeFileSync(s,`${JSON.stringify(o,null,2)}
 `,"utf8"),s}function ye(e){let[r,...s]=e,t={};for(let o=0;o<s.length;o++){let i=s[o];if(!i.startsWith("--"))continue;let a=i.slice(2),n=s[o+1];n&&!n.startsWith("--")?(t[a]=n,o++):t[a]=true;}return {command:r??"help",flags:t}}function X(){console.log(`frs \u2014 Hono file-based codegen
 
 Usage:
@@ -83,7 +83,7 @@ Examples:
   frs new createPost --domain posts --method post
   frs new listPosts  --domain posts --method get --api v1
   frs add service postRepo
-`);}function ee(e){if(typeof e=="string")return e.split(",").map(r=>r.trim()).filter(Boolean)}function m(e){return typeof e=="string"?e:void 0}function te(e){if(e||!stdin.isTTY)return {ask:async(s,t)=>t??"",askChoice:async(s,t,o)=>o??"",askBool:async(s,t)=>t,close:()=>{}};let r=createInterface({input:stdin,output:stdout});return {async ask(s,t){let o=t?` (${t})`:"";return (await r.question(`? ${s}${o} \u203A `)).trim()||t||""},async askChoice(s,t,o){let i=` [${t.join("/")}${o?`, default: ${o}`:""}]`;for(;;){let a=(await r.question(`? ${s}${i} \u203A `)).trim().toLowerCase();if(!a&&o)return o;if(t.includes(a))return a;console.log(`  invalid choice \u2014 pick one of: ${t.join(", ")}`);}},async askBool(s,t){let o=` (${t?"Y/n":"y/N"})`,i=(await r.question(`? ${s}${o} \u203A `)).trim().toLowerCase();return i?i==="y"||i==="yes"||i==="true":t},close:()=>r.close()}}async function xe(e){let r=U(),s=m(e.root)??r.root;s||(console.error("[frs] --root is required (or run `frs init` to write it to .frsrc.json)"),process.exit(2));let t=resolve(process.cwd(),s);existsSync(t)||(console.error(`[frs] root not found: ${t}`),process.exit(2));let o=m(e.out)??r.out??"__generated__/routes.ts",i=ee(e.skip)??I.skipSegments,a=m(e.casing)==="kebab"?"kebab":I.casing,n={skipSegments:i,casing:a},c=m(e.ext)??".js",f=ee(e.exclude)??L.excludeSegments,g=m(e["routes-file"])??L.routesFile,b=V(t,{routesFile:g,excludeSegments:f});b.length===0&&console.warn(`[frs] no "${g}" files found under ${t} \u2014 generated an empty manifest.`);let h=K(b,{outFile:resolve(t,o),derive:n,importExtension:c});if(!e.silent){console.log(`[frs] wrote ${h.outFile}  (${h.routeCount} route${h.routeCount===1?"":"s"})`);for(let{source:P,url:y}of h.derivedPaths)console.log(`  ${y.padEnd(48)}  \u2190  ${P}`);}}async function we(e,r){let s=r.yes===true,t=te(s),o=U();try{let i=e&&!e.startsWith("--")?e:void 0;i||(i=(await t.ask("Route name (e.g. createPost)")).trim(),i||(console.error("[frs] route name is required"),process.exit(2)));let a=m(r.domain);a||(a=(await t.ask("Domain name (e.g. posts)")).trim(),a||(console.error("[frs] --domain is required"),process.exit(2)));let n=m(r.root)??o.root??"src/domains",c=m(r.method)?.toLowerCase();c||(c=await t.askChoice("HTTP method",["get","post","put","patch","delete"],"post")),["get","post","put","patch","delete"].includes(c)||(console.error(`[frs] invalid --method: ${c}`),process.exit(2));let f=m(r.api);if(!f){let v=o.apis?.[0]??"v1";f=(await t.ask("API tag",v)).trim()||v;}let g=m(r["usecase-folder"])??o.useCaseFolder??"useCases",p=r["with-usecase"]===void 0?s?!0:await t.askBool("Scaffold useCase.ts?",!0):r["with-usecase"]!==!1,b=r["with-test"]===void 0?s||!p?p:await t.askBool("Scaffold useCase.test.ts (Vitest)?",!0):r["with-test"]!==!1,h=r.force===!0,P=resolve(process.cwd(),n),y=resolve(P,a,g,i),F=resolve(y,"routes.ts"),x=`${a}.${i}.useCase`,A=resolve(y,`${x}.ts`),C=resolve(y,`${x}.test.ts`);mkdirSync(y,{recursive:!0});let R=v=>v.charAt(0).toUpperCase()+v.slice(1),$=`${R(a)}${R(i)}UseCase`,D="@lpdjs/firestore-repo-service/servers/hono",w=Ce(P,y),E=Se(P,y),_=c==="get"?"// GET \u2192 lu depuis les query params":`// ${c.toUpperCase()} \u2192 lu depuis le body JSON`,q=`/**
+`);}function ee(e){if(typeof e=="string")return e.split(",").map(r=>r.trim()).filter(Boolean)}function m(e){return typeof e=="string"?e:void 0}function te(e){if(e||!stdin.isTTY)return {ask:async(s,t)=>t??"",askChoice:async(s,t,o)=>o??"",askBool:async(s,t)=>t,close:()=>{}};let r=createInterface({input:stdin,output:stdout});return {async ask(s,t){let o=t?` (${t})`:"";return (await r.question(`? ${s}${o} \u203A `)).trim()||t||""},async askChoice(s,t,o){let i=` [${t.join("/")}${o?`, default: ${o}`:""}]`;for(;;){let a=(await r.question(`? ${s}${i} \u203A `)).trim().toLowerCase();if(!a&&o)return o;if(t.includes(a))return a;console.log(`  invalid choice \u2014 pick one of: ${t.join(", ")}`);}},async askBool(s,t){let o=` (${t?"Y/n":"y/N"})`,i=(await r.question(`? ${s}${o} \u203A `)).trim().toLowerCase();return i?i==="y"||i==="yes"||i==="true":t},close:()=>r.close()}}async function xe(e){let r=z(),s=m(e.root)??r.root;s||(console.error("[frs] --root is required (or run `frs init` to write it to .frsrc.json)"),process.exit(2));let t=resolve(process.cwd(),s);existsSync(t)||(console.error(`[frs] root not found: ${t}`),process.exit(2));let o=m(e.out)??r.out??"__generated__/routes.ts",i=ee(e.skip)??_.skipSegments,a=m(e.casing)==="kebab"?"kebab":_.casing,n={skipSegments:i,casing:a},c=m(e.ext)??".js",f=ee(e.exclude)??I.excludeSegments,g=m(e["routes-file"])??I.routesFile,b=V(t,{routesFile:g,excludeSegments:f});b.length===0&&console.warn(`[frs] no "${g}" files found under ${t} \u2014 generated an empty manifest.`);let h=K(b,{outFile:resolve(t,o),derive:n,importExtension:c});if(!e.silent){console.log(`[frs] wrote ${h.outFile}  (${h.routeCount} route${h.routeCount===1?"":"s"})`);for(let{source:P,url:y}of h.derivedPaths)console.log(`  ${y.padEnd(48)}  \u2190  ${P}`);}}async function we(e,r){let s=r.yes===true,t=te(s),o=z();try{let i=e&&!e.startsWith("--")?e:void 0;i||(i=(await t.ask("Route name (e.g. createPost)")).trim(),i||(console.error("[frs] route name is required"),process.exit(2)));let a=m(r.domain);a||(a=(await t.ask("Domain name (e.g. posts)")).trim(),a||(console.error("[frs] --domain is required"),process.exit(2)));let n=m(r.root)??o.root??"src/domains",c=m(r.method)?.toLowerCase();c||(c=await t.askChoice("HTTP method",["get","post","put","patch","delete"],"post")),["get","post","put","patch","delete"].includes(c)||(console.error(`[frs] invalid --method: ${c}`),process.exit(2));let f=m(r.api);if(!f){let v=o.apis?.[0]??"v1";f=(await t.ask("API tag",v)).trim()||v;}let g=m(r["usecase-folder"])??o.useCaseFolder??"useCases",p=r["with-usecase"]===void 0?s?!0:await t.askBool("Scaffold useCase.ts?",!0):r["with-usecase"]!==!1,b=r["with-test"]===void 0?s||!p?p:await t.askBool("Scaffold useCase.test.ts (Vitest)?",!0):r["with-test"]!==!1,h=r.force===!0,P=resolve(process.cwd(),n),y=resolve(P,a,g,i),F=resolve(y,"routes.ts"),x=`${a}.${i}.useCase`,A=resolve(y,`${x}.ts`),C=resolve(y,`${x}.test.ts`);mkdirSync(y,{recursive:!0});let k=v=>v.charAt(0).toUpperCase()+v.slice(1),$=`${k(a)}${k(i)}UseCase`,D="@lpdjs/firestore-repo-service/servers/hono",w=Ce(P,y),E=Se(P,y),L=c==="get"?"// GET \u2192 lu depuis les query params":`// ${c.toUpperCase()} \u2192 lu depuis le body JSON`,U=`/**
  * ${$} \u2014 pure business logic, no HTTP awareness.
  *
  * Owns its Zod \`input\` / \`output\` schemas (declared as \`static\` members, the
@@ -96,7 +96,7 @@ import { z } from "zod";
 import { AppUseCase } from "${E}";
 
 const input = z.object({
-  ${_}
+  ${L}
   example: z.string(),
 });
 
@@ -119,15 +119,15 @@ export class ${$} extends AppUseCase<typeof input, typeof output> {
     return { id: payload.example };
   }
 }
-`,N=c==="get"?`
-    source: "query",`:"",z=p?`import { ${$} } from "./${x}.js";
+`,H=c==="get"?`
+    source: "query",`:"",N=p?`import { ${$} } from "./${x}.js";
 `:"",O=m(r["apis-import"])??Pe(P,y),u=p?`import { defineRoutes } from "${D}";
 import { useCaseRoute } from "${O}";
-${z}
+${N}
 export default defineRoutes([
   useCaseRoute(${$}, {
     api: "${f}",
-    method: "${c}",${N}
+    method: "${c}",${H}
     summary: "TODO: ${i}",
     tags: ["${a}"],
   }),
@@ -142,7 +142,7 @@ export default defineRoutes([
     method: "${c}",
 
     input: z.object({
-      ${_}
+      ${L}
       example: z.string(),
     }),
 
@@ -159,7 +159,7 @@ export default defineRoutes([
     },
   }),
 ]);
-`,j=[],M=[],B=(v,oe)=>{if(existsSync(v)&&!h){M.push(v);return}writeFileSync(v,oe,"utf8"),j.push(v);};if(B(F,u),p&&B(A,q),p&&b){let v=`import { describe, it, expect } from "vitest";
+`,j=[],G=[],M=(v,oe)=>{if(existsSync(v)&&!h){G.push(v);return}writeFileSync(v,oe,"utf8"),j.push(v);};if(M(F,u),p&&M(A,U),p&&b){let v=`import { describe, it, expect } from "vitest";
 import type { Services } from "${w}";
 import { ${$} } from "./${x}.js";
 
@@ -175,8 +175,8 @@ describe("${$}", () => {
 
   // TODO: add error-path tests, repository mocks, etc.
 });
-`;B(C,v);}for(let v of j)console.log(`[frs] wrote   ${v}`);for(let v of M)console.log(`[frs] skipped ${v} (use --force to overwrite)`);console.log(`
-[frs] reminder: run "frs gen --root ${n}" to refresh the manifest.`);}finally{t.close();}}async function $e(e){let r=e.yes===true,s=te(r);try{let t=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 a=m(e["services-file"]);if(!a){let u=i.replace(/apis\.ts$/,"services.ts")||"src/services.ts";a=(await s.ask("services.ts location",u)).trim()||u;}let n=m(e.apis);n||(n=(await s.ask("API tags (comma-separated)","v1")).trim()||"v1");let c=n.split(",").map(u=>u.trim()).filter(Boolean);c.length===0&&(console.error("[frs] at least one API tag is required"),process.exit(2));let f=m(e["base-path"]),g=resolve(process.cwd(),o),p=resolve(process.cwd(),i),b=resolve(process.cwd(),a),h=resolve(dirname(p),"app-error.ts"),P=resolve(dirname(p),"base-usecase.ts"),y=resolve(g,"__generated__"),F=resolve(y,"routes.ts"),x=[],A=[],C=(u,j)=>{if(mkdirSync(dirname(u),{recursive:!0}),existsSync(u)&&!t){A.push(u);return}writeFileSync(u,j,"utf8"),x.push(u);},R=c.map(u=>{let j=f??`/${u}`;return `    ${u}: {
+`;M(C,v);}for(let v of j)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{t.close();}}async function $e(e){let r=e.yes===true,s=te(r);try{let t=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 a=m(e["services-file"]);if(!a){let u=i.replace(/apis\.ts$/,"services.ts")||"src/services.ts";a=(await s.ask("services.ts location",u)).trim()||u;}let n=m(e.apis);n||(n=(await s.ask("API tags (comma-separated)","v1")).trim()||"v1");let c=n.split(",").map(u=>u.trim()).filter(Boolean);c.length===0&&(console.error("[frs] at least one API tag is required"),process.exit(2));let f=m(e["base-path"]),g=resolve(process.cwd(),o),p=resolve(process.cwd(),i),b=resolve(process.cwd(),a),h=resolve(dirname(p),"app-error.ts"),P=resolve(dirname(p),"base-usecase.ts"),y=resolve(g,"__generated__"),F=resolve(y,"routes.ts"),x=[],A=[],C=(u,j)=>{if(mkdirSync(dirname(u),{recursive:!0}),existsSync(u)&&!t){A.push(u);return}writeFileSync(u,j,"utf8"),x.push(u);},k=c.map(u=>{let j=f??`/${u}`;return `    ${u}: {
       basePath: "${j}",
       openapi: {
         info: { title: "${u.toUpperCase()} API", version: "1.0.0", description: "" },
@@ -191,8 +191,8 @@ describe("${$}", () => {
       verbose: process.env["NODE_ENV"] !== "production",
     },`}).join(`
 `),$=`import { createApiRegistry } from "@lpdjs/firestore-repo-service/servers/hono";
-import { AppErrorHandler, appLogger } from "${k(dirname(p),h)}";
-import { services } from "${k(dirname(p),b)}";
+import { AppErrorHandler, appLogger } from "${R(dirname(p),h)}";
+import { services } from "${R(dirname(p),b)}";
 
 /**
  * Single source of truth for every API exposed by this project.
@@ -206,7 +206,7 @@ import { services } from "${k(dirname(p),b)}";
  */
 export const apis = createApiRegistry(
   {
-${R}
+${k}
   },
   { services },
 );
@@ -254,36 +254,103 @@ export type Services = typeof services;
   type LogSeverity,
 } from "@lpdjs/firestore-repo-service/servers/hono";
 
+/** Supported locales \u2014 the single source of truth (runtime + type). */
+export const LOCALES = ["en", "fr"] as const;
+
+/** A supported locale, derived from {@link LOCALES}. */
+export type Locale = (typeof LOCALES)[number];
+
+/** Localized message \u2014 one string per supported locale. */
+export type LocalizedMessage = Record<Locale, string>;
+
 /**
  * Domain error \u2014 pure business semantics, zero HTTP awareness. Thrown anywhere
  * in useCases / handlers; the \`AppErrorHandler\` below maps it to an HTTP
- * response. Add your own factory methods as your domain grows.
+ * response. Carries a localized message; add your own factory methods as your
+ * domain grows.
  */
 export class AppError extends Error {
   readonly statusCode: number;
   readonly userFacing: boolean;
   readonly errorId: string;
-
-  private constructor(message: string, statusCode: number, userFacing = false) {
-    super(message);
+  readonly localizedMessage: LocalizedMessage;
+
+  private constructor(
+    localizedMessage: LocalizedMessage,
+    statusCode: number,
+    userFacing = false,
+  ) {
+    super(localizedMessage.en);
     this.name = "AppError";
     this.statusCode = statusCode;
     this.userFacing = userFacing;
+    this.localizedMessage = localizedMessage;
     this.errorId = Math.random().toString(36).slice(2, 12);
   }
 
   /** Business message shown directly to the user \u2014 HTTP 412. */
-  static userMessage(message: string): AppError {
+  static userMessage(message: LocalizedMessage): AppError {
     return new AppError(message, 412, true);
   }
+
   /** Resource not found \u2014 HTTP 404. */
-  static notFound(resource = "Resource"): AppError {
-    return new AppError(\`\${resource} not found\`, 404);
+  static notFound(resource?: string): AppError {
+    return new AppError(
+      {
+        en: \`\${resource ?? "Resource"} not found\`,
+        fr: \`\${resource ?? "Ressource"} introuvable\`,
+      },
+      404,
+    );
   }
+
   /** Malformed request / invalid data \u2014 HTTP 400. */
-  static badRequest(detail = "invalid parameters"): AppError {
-    return new AppError(\`Bad request: \${detail}\`, 400);
+  static badRequest(detail?: string): AppError {
+    return new AppError(
+      {
+        en: \`Bad request: \${detail ?? "invalid parameters"}\`,
+        fr: \`Requ\xEAte invalide : \${detail ?? "param\xE8tres incorrects"}\`,
+      },
+      400,
+    );
   }
+
+  /** Generic fallback message for non-user-facing errors. */
+  static default(locale: Locale): string {
+    return locale === "fr" ? "Une erreur est survenue" : "An error occurred";
+  }
+}
+
+/**
+ * Pick the response locale from the \`Accept-Language\` header.
+ *
+ * Parses the comma-separated, q-weighted list (e.g.
+ * \`fr-FR,fr;q=0.9,en;q=0.8\`), keeps the supported locales, and returns the one
+ * with the highest quality. Falls back to \`"en"\`.
+ */
+function pickLocale(c: {
+  req: { header(name: string): string | undefined };
+}): Locale {
+  const header = c.req.header("accept-language");
+  if (!header) return "en";
+
+  const ranked = header
+    .split(",")
+    .map((part) => {
+      const [tag = "", ...params] = part.trim().split(";");
+      const qParam = params.find((p) => p.trim().startsWith("q="));
+      const q = qParam ? Number.parseFloat(qParam.split("=")[1] ?? "") : 1;
+      return {
+        lang: tag.trim().toLowerCase().split("-")[0] ?? "",
+        quality: Number.isFinite(q) ? q : 1,
+      };
+    })
+    .filter((x): x is { lang: Locale; quality: number } =>
+      (LOCALES as readonly string[]).includes(x.lang),
+    )
+    .sort((a, b) => b.quality - a.quality);
+
+  return ranked[0]?.lang ?? "en";
 }
 
 /**
@@ -304,10 +371,10 @@ export class AppLogger extends BaseLogger {
 export const appLogger = new AppLogger();
 
 /**
- * Project error strategy \u2014 extends \`BaseErrorHandler\`: \`mapError\` handles our
- * \`AppError\` (with an optional GCP logs deep link), \`logError\` routes through
- * the logger, and unmatched errors fall back to the built-in mapping via
- * \`super\`. Wired per API in apis.ts.
+ * Project error strategy \u2014 extends \`BaseErrorHandler\`: \`mapError\` localizes our
+ * \`AppError\` (user-facing aware, with an optional GCP logs deep link),
+ * \`logError\` routes through the logger, and unmatched errors fall back to the
+ * built-in mapping via \`super\`. Wired per API in apis.ts.
  */
 export class AppErrorHandler extends BaseErrorHandler {
   protected override mapError({
@@ -316,11 +383,14 @@ export class AppErrorHandler extends BaseErrorHandler {
   }: ErrorHandlerContext): Response | null {
     if (!(error instanceof AppError)) return null; // \u2192 built-in mapping
 
+    const locale = pickLocale(c);
     const logsUrl = this.gcpLogsUrl(error.errorId); // undefined when disabled
     return c.json(
       {
-        // expose the message only when it is meant for the user
-        error: error.userFacing ? error.message : "An error occurred",
+        // expose the localized message only when it is meant for the user
+        error: error.userFacing
+          ? error.localizedMessage[locale]
+          : AppError.default(locale),
         errorId: error.errorId,
         ...(logsUrl ? { logsUrl } : {}),
       },
@@ -340,8 +410,8 @@ export class AppErrorHandler extends BaseErrorHandler {
 }
 `);let E=`import { UseCase } from "@lpdjs/firestore-repo-service/servers/hono";
 import type { z } from "zod";
-import { AppError, appLogger } from "${k(dirname(P),h)}";
-import type { Services } from "${k(dirname(P),b)}";
+import { AppError, appLogger } from "${R(dirname(P),h)}";
+import type { Services } from "${R(dirname(P),b)}";
 
 /**
  * Project base class for every useCase \u2014 extends the package's {@link UseCase}
@@ -364,20 +434,20 @@ export abstract class AppUseCase<
    */
   protected readonly error = AppError;
 }
-`;C(P,E);let _=`// AUTO-GENERATED by frs \u2014 do not edit.
+`;C(P,E);let L=`// 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[] = [];
-`;C(F,_);let q=ve({root:o,apisFile:i,servicesFile:a,apis:c});x.push(q);let N=k(dirname(p),p),z=k(dirname(p),F),O=c.length===1?`export const { ${c[0]} } = apis.toFunctions(routes, onRequest, {`:`export const { ${c.join(", ")} } = apis.toFunctions(routes, onRequest, {`;for(let u of x)console.log(`[frs] wrote   ${u}`);for(let u of A)console.log(`[frs] skipped ${u} (use --force to overwrite)`);console.log(`
+`;C(F,L);let U=ve({root:o,apisFile:i,servicesFile:a,apis:c});x.push(U);let H=R(dirname(p),p),N=R(dirname(p),F),O=c.length===1?`export const { ${c[0]} } = apis.toFunctions(routes, onRequest, {`:`export const { ${c.join(", ")} } = apis.toFunctions(routes, onRequest, {`;for(let u of x)console.log(`[frs] wrote   ${u}`);for(let u of A)console.log(`[frs] skipped ${u} (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 "${N}";
-   import { routes } from "${z}";
+   import { apis } from "${H}";
+   import { routes } from "${N}";
 
    ${O}
      defaults: { region: "us-central1", invoker: "public" },
@@ -390,7 +460,7 @@ Next steps:
 3. Refresh the manifest before each build:
 
    frs gen --root ${o}
-`);}finally{s.close();}}function k(e,r){let s=relative(e,r).replace(/\\/g,"/");return s=s.replace(/\.ts$/,".js"),s.startsWith(".")||(s=`./${s}`),s}async function be(e,r,s){e!=="service"&&(console.error(`[frs] unknown "add" target: ${e??"(missing)"} \u2014 supported: service`),process.exit(2)),r||(console.error("[frs] service name is required: frs add service <name>"),process.exit(2));let t=s.force===true,o=U(),a=[m(s["services-file"]),o.servicesFile,"src/services.ts","services.ts"].filter(w=>typeof w=="string"&&w.length>0),n;for(let w of a){let E=resolve(process.cwd(),w);if(existsSync(E)){n=E;break}}if(!n){let w=a.map(E=>resolve(process.cwd(),E)).join(`
+`);}finally{s.close();}}function R(e,r){let s=relative(e,r).replace(/\\/g,"/");return s=s.replace(/\.ts$/,".js"),s.startsWith(".")||(s=`./${s}`),s}async function be(e,r,s){e!=="service"&&(console.error(`[frs] unknown "add" target: ${e??"(missing)"} \u2014 supported: service`),process.exit(2)),r||(console.error("[frs] service name is required: frs add service <name>"),process.exit(2));let t=s.force===true,o=z(),a=[m(s["services-file"]),o.servicesFile,"src/services.ts","services.ts"].filter(w=>typeof w=="string"&&w.length>0),n;for(let w of a){let E=resolve(process.cwd(),w);if(existsSync(E)){n=E;break}}if(!n){let w=a.map(E=>resolve(process.cwd(),E)).join(`
         `);console.error(`[frs] services file not found. Tried:
         ${w}
       Run \`frs init\` first or pass --services-file <path>.`),process.exit(2);}let c=m(s["services-dir"])??o.servicesDir??resolve(dirname(n),"services"),f=resolve(process.cwd(),c);mkdirSync(f,{recursive:true});let g=`${r.charAt(0).toUpperCase()}${r.slice(1)}Service`,p=resolve(f,`${r}.ts`),b=`import type { RequestContext } from "@lpdjs/firestore-repo-service/servers/hono";
@@ -422,9 +492,9 @@ export class ${g} {
     return \`hello from ${r} \u2014 user=\${this.ctx.maybeC?.get("user")?.id ?? "anonymous"}\`;
   }
 }
-`;existsSync(p)&&!t?console.log(`[frs] skipped ${p} (use --force to overwrite)`):(writeFileSync(p,b,"utf8"),console.log(`[frs] wrote   ${p}`));let h=readFileSync(n,"utf8"),P=k(dirname(n),p),y=`import { ${g} } from "${P}";`,F=`  ${r}: ({ ctx }) => new ${g}(ctx),`;if(h.includes(y)){console.log(`[frs] services.ts already registers "${r}" \u2014 skipping.`);return}let x=h.split(`
+`;existsSync(p)&&!t?console.log(`[frs] skipped ${p} (use --force to overwrite)`):(writeFileSync(p,b,"utf8"),console.log(`[frs] wrote   ${p}`));let h=readFileSync(n,"utf8"),P=R(dirname(n),p),y=`import { ${g} } from "${P}";`,F=`  ${r}: ({ ctx }) => new ${g}(ctx),`;if(h.includes(y)){console.log(`[frs] services.ts already registers "${r}" \u2014 skipping.`);return}let x=h.split(`
 `),A=-1;for(let w=0;w<x.length;w++)/^import\s/.test(x[w])&&(A=w);A>=0?x.splice(A+1,0,y):x.unshift(y);let C=x.join(`
-`),R=C.match(/createServices\s*\(\s*\{/);if(!R){console.error(`[frs] could not find \`createServices({\` in ${n} \u2014 register "${r}" manually.`);return}let $=R.index+R[0].length,D=C.slice(0,$)+`
+`),k=C.match(/createServices\s*\(\s*\{/);if(!k){console.error(`[frs] could not find \`createServices({\` in ${n} \u2014 register "${r}" manually.`);return}let $=k.index+k[0].length,D=C.slice(0,$)+`
 `+F+C.slice($);writeFileSync(n,D,"utf8"),console.log(`[frs] updated ${n}  (+ ${r})`);}function Pe(e,r){let s=["apis.ts","apis.js","api.ts","api.js"],t=[e,dirname(e),dirname(dirname(e))];for(let o of t)for(let i of s){let a=resolve(o,i);if(existsSync(a)){let n=relative(r,a).replace(/\\/g,"/");return n=n.replace(/\.ts$/,".js").replace(/\.js$/,".js"),n.startsWith(".")||(n=`./${n}`),n}}return "../../../../apis.js"}function Ce(e,r){let s=["services.ts","services.js"],t=[e,dirname(e),dirname(dirname(e))];for(let o of t)for(let i of s){let a=resolve(o,i);if(existsSync(a)){let n=relative(r,a).replace(/\\/g,"/");return n=n.replace(/\.ts$/,".js"),n.startsWith(".")||(n=`./${n}`),n}}return "../../../../services.js"}function Se(e,r){let s=["base-usecase.ts","base-usecase.js"],t=[e,dirname(e),dirname(dirname(e))];for(let o of t)for(let i of s){let a=resolve(o,i);if(existsSync(a)){let n=relative(r,a).replace(/\\/g,"/");return n=n.replace(/\.ts$/,".js"),n.startsWith(".")||(n=`./${n}`),n}}return "../../../../base-usecase.js"}async function Ae(){let e=process.argv.slice(2),{command:r,flags:s}=ye(e);switch(r){case "init":await $e(s);return;case "gen":await xe(s);return;case "new":await we(e[1],s);return;case "add":await be(e[1],e[2],s);return;case "help":case "--help":case "-h":X();return;default:console.error(`[frs] unknown command: ${r}
 `),X(),process.exit(2);}}Ae().catch(e=>{console.error(e),process.exit(1);});//# sourceMappingURL=cli.js.map
 //# sourceMappingURL=cli.js.map