@lpdjs/firestore-repo-service 2.6.2-beta.1 → 2.6.3

package/README.md

@@ -340,28 +340,52 @@ export const apis = createApiRegistry({
 });
 
 export const defineRoute = apis.defineRoute;
+export const useCaseRoute = apis.useCaseRoute;
 ```
 
 ### Write a route
 
+A useCase owns its Zod `input` / `output` schemas (as `static` members) and the
+business logic; `useCaseRoute` wires it into an endpoint in one line.
+
 ```typescript
-// src/domains/posts/useCases/createPost/routes.ts
+// src/domains/posts/useCases/createPost/useCase.ts
 import { z } from "zod";
-import { defineRoute } from "../../../../apis.js";
-
-export default defineRoute({
-  api: "v1", // typed: only registered tags accepted
-  method: "post",
-  input: z.object({ title: z.string() }),
-  output: z.object({ id: z.string() }),
-  summary: "Create a post",
-  tags: ["posts"],
-  handler: async ({ input }) => ({ id: input.title }),
-});
+import { UseCase } from "@lpdjs/firestore-repo-service/servers/hono";
+import type { Services } from "../../../../services.js";
+
+const input = z.object({ title: z.string() });
+const output = z.object({ id: z.string() });
+
+export class CreatePostUseCase extends UseCase<typeof input, typeof output, Services> {
+  static readonly input = input;
+  static readonly output = output;
+
+  async execute(payload: z.infer<typeof input>): Promise<z.infer<typeof output>> {
+    return { id: payload.title };
+  }
+}
+```
+
+```typescript
+// src/domains/posts/useCases/createPost/routes.ts
+import { defineRoutes } from "@lpdjs/firestore-repo-service/servers/hono";
+import { useCaseRoute } from "../../../../apis.js";
+import { CreatePostUseCase } from "./useCase.js";
+
+export default defineRoutes([
+  useCaseRoute(CreatePostUseCase, {
+    api: "v1", // typed: only registered tags accepted
+    method: "post",
+    summary: "Create a post",
+    tags: ["posts"],
+  }),
+]);
 ```
 
-Export an **array** of `defineRoute(...)` to expose the same logic under
-multiple APIs with different schemas — each call infers `input` independently.
+Need full control (no useCase)? Use `defineRoute({...})` with an inline
+`handler` instead. Expose the same useCase under several APIs by adding more
+`useCaseRoute(...)` entries to the `defineRoutes([...])` array.
 
 ### Wire Cloud Functions
 

package/dist/servers/hono/cli.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-'use strict';var fs=require('fs'),path=require('path'),process$1=require('process'),promises=require('readline/promises');var I={skipSegments:["useCases","useCase","use-cases","use-case"],casing:"preserve"};function L(e,t=I){let s=new Set(t.skipSegments.map(r=>r.toLowerCase()));return "/"+e.split("/").filter(Boolean).filter(r=>!s.has(r.toLowerCase())).map(r=>t.casing==="kebab"?X(r):r).join("/")}function X(e){return e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/[\s_]+/g,"-").toLowerCase()}function U(e,t,s){let o=q(e),r=q(t),i=0;for(;i<o.length&&i<r.length&&o[i]===r[i];)i++;let c=o.length-i,n=r.slice(i),g=(n[n.length-1]??"").replace(/\.[mc]?[tj]sx?$/i,""),p=s===""?g:`${g}${s}`;return n[n.length-1]=p,(c===0?"./":"../".repeat(c))+n.join("/")}function q(e){return e.replace(/\\/g,"/").replace(/\/+$/,"").split("/").filter((s,o)=>!(o===0&&s===""))}var re="/**\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 G(e,t){let s=path.dirname(t.outFile);fs.mkdirSync(s,{recursive:true});let o=t.banner??re,r=(t.now??new Date).toISOString(),i=t.importExtension,c=[],n=[],a=[];e.forEach((p,l)=>{let v=U(s,p.absPath,i),y=L(p.relDir,t.derive);c.push(`import mod${l} from ${JSON.stringify(v)};`),n.push(`  { __derivedPath: ${JSON.stringify(y)}, mod: mod${l} },`),a.push({source:p.relPath,url:y});});let g=`${o}// Generated at ${r} \u2014 ${e.length} route file${e.length===1?"":"s"}.
+'use strict';var fs=require('fs'),path=require('path'),process$1=require('process'),promises=require('readline/promises');var I={skipSegments:["useCases","useCase","use-cases","use-case"],casing:"preserve"};function G(e,t=I){let s=new Set(t.skipSegments.map(r=>r.toLowerCase()));return "/"+e.split("/").filter(Boolean).filter(r=>!s.has(r.toLowerCase())).map(r=>t.casing==="kebab"?te(r):r).join("/")}function te(e){return e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/[\s_]+/g,"-").toLowerCase()}function B(e,t,s){let i=z(e),r=z(t),n=0;for(;n<i.length&&n<r.length&&i[n]===r[n];)n++;let c=i.length-n,o=r.slice(n),m=(o[o.length-1]??"").replace(/\.[mc]?[tj]sx?$/i,""),u=s===""?m:`${m}${s}`;return o[o.length-1]=u,(c===0?"./":"../".repeat(c))+o.join("/")}function z(e){return e.replace(/\\/g,"/").replace(/\/+$/,"").split("/").filter((s,i)=>!(i===0&&s===""))}var ie="/**\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 M(e,t){let s=path.dirname(t.outFile);fs.mkdirSync(s,{recursive:true});let i=t.banner??ie,r=(t.now??new Date).toISOString(),n=t.importExtension,c=[],o=[],a=[];e.forEach((u,l)=>{let h=B(s,u.absPath,n),v=G(u.relDir,t.derive);c.push(`import mod${l} from ${JSON.stringify(h)};`),o.push(`  { __derivedPath: ${JSON.stringify(v)}, mod: mod${l} },`),a.push({source:u.relPath,url:v});});let m=`${i}// Generated at ${r} \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 }[] = [
-`+n.join(`
-`)+(n.length?`
+`+o.join(`
+`)+(o.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 fs.writeFileSync(t.outFile,g,"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 B(e,t=E){let s=[];return z(e,e,t,s),s.sort((o,r)=>o.relPath.localeCompare(r.relPath)),s}function z(e,t,s,o){let r;try{r=fs.readdirSync(t);}catch{return}for(let i of r){if(s.excludeSegments.includes(i))continue;let c=path.join(t,i),n;try{n=fs.statSync(c);}catch{continue}if(n.isDirectory())z(e,c,s,o);else if(n.isFile()&&i===s.routesFile){let a=path.relative(e,c).split(path.sep).join("/"),g=a.replace(/\/?[^/]+$/,"");o.push({absPath:c,relPath:a,relDir:g});}}}var V=".frsrc.json";function Y(e=process.cwd()){let t=path.resolve(e,V);if(!fs.existsSync(t))return {};try{return JSON.parse(fs.readFileSync(t,"utf8"))}catch{return {}}}function le(e,t=process.cwd()){let s=path.resolve(t,V),r={...Y(t),...e};return fs.writeFileSync(s,`${JSON.stringify(r,null,2)}
-`,"utf8"),s}function de(e){let[t,...s]=e,o={};for(let r=0;r<s.length;r++){let i=s[r];if(!i.startsWith("--"))continue;let c=i.slice(2),n=s[r+1];n&&!n.startsWith("--")?(o[c]=n,r++):o[c]=true;}return {command:t??"help",flags:o}}function H(){console.log(`frs \u2014 Hono file-based codegen
+`;return fs.writeFileSync(t.outFile,m,"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 H(e,t=E){let s=[];return W(e,e,t,s),s.sort((i,r)=>i.relPath.localeCompare(r.relPath)),s}function W(e,t,s,i){let r;try{r=fs.readdirSync(t);}catch{return}for(let n of r){if(s.excludeSegments.includes(n))continue;let c=path.join(t,n),o;try{o=fs.statSync(c);}catch{continue}if(o.isDirectory())W(e,c,s,i);else if(o.isFile()&&n===s.routesFile){let a=path.relative(e,c).split(path.sep).join("/"),m=a.replace(/\/?[^/]+$/,"");i.push({absPath:c,relPath:a,relDir:m});}}}var Z=".frsrc.json";function Q(e=process.cwd()){let t=path.resolve(e,Z);if(!fs.existsSync(t))return {};try{return JSON.parse(fs.readFileSync(t,"utf8"))}catch{return {}}}function fe(e,t=process.cwd()){let s=path.resolve(t,Z),r={...Q(t),...e};return fs.writeFileSync(s,`${JSON.stringify(r,null,2)}
+`,"utf8"),s}function me(e){let[t,...s]=e,i={};for(let r=0;r<s.length;r++){let n=s[r];if(!n.startsWith("--"))continue;let c=n.slice(2),o=s[r+1];o&&!o.startsWith("--")?(i[c]=o,r++):i[c]=true;}return {command:t??"help",flags:i}}function K(){console.log(`frs \u2014 Hono file-based codegen
 
 Usage:
   frs init [flags]
@@ -78,82 +78,105 @@ Examples:
   frs new createPost --domain posts --method post
   frs new listPosts  --domain posts --method get --api v1
   frs add service postRepo
-`);}function W(e){if(typeof e=="string")return e.split(",").map(t=>t.trim()).filter(Boolean)}function f(e){return typeof e=="string"?e:void 0}function Z(e){if(e||!process$1.stdin.isTTY)return {ask:async(s,o)=>o??"",askChoice:async(s,o,r)=>r??"",askBool:async(s,o)=>o,close:()=>{}};let t=promises.createInterface({input:process$1.stdin,output:process$1.stdout});return {async ask(s,o){let r=o?` (${o})`:"";return (await t.question(`? ${s}${r} \u203A `)).trim()||o||""},async askChoice(s,o,r){let i=` [${o.join("/")}${r?`, default: ${r}`:""}]`;for(;;){let c=(await t.question(`? ${s}${i} \u203A `)).trim().toLowerCase();if(!c&&r)return r;if(o.includes(c))return c;console.log(`  invalid choice \u2014 pick one of: ${o.join(", ")}`);}},async askBool(s,o){let r=` (${o?"Y/n":"y/N"})`,i=(await t.question(`? ${s}${r} \u203A `)).trim().toLowerCase();return i?i==="y"||i==="yes"||i==="true":o},close:()=>t.close()}}async function fe(e){let t=f(e.root);t||(console.error("[frs] --root is required"),process.exit(2));let s=path.resolve(process.cwd(),t);fs.existsSync(s)||(console.error(`[frs] root not found: ${s}`),process.exit(2));let o=f(e.out)??"__generated__/routes.ts",r=W(e.skip)??I.skipSegments,i=f(e.casing)==="kebab"?"kebab":I.casing,c={skipSegments:r,casing:i},n=f(e.ext)??".js",a=W(e.exclude)??E.excludeSegments,g=f(e["routes-file"])??E.routesFile,l=B(s,{routesFile:g,excludeSegments:a});l.length===0&&console.warn(`[frs] no "${g}" files found under ${s} \u2014 generated an empty manifest.`);let v=G(l,{outFile:path.resolve(s,o),derive:c,importExtension:n});if(!e.silent){console.log(`[frs] wrote ${v.outFile}  (${v.routeCount} route${v.routeCount===1?"":"s"})`);for(let{source:y,url:$}of v.derivedPaths)console.log(`  ${$.padEnd(48)}  \u2190  ${y}`);}}async function me(e,t){let s=t.yes===true,o=Z(s);try{let r=e&&!e.startsWith("--")?e:void 0;r||(r=(await o.ask("Route name (e.g. createPost)")).trim(),r||(console.error("[frs] route name is required"),process.exit(2)));let i=f(t.domain);i||(i=(await o.ask("Domain name (e.g. posts)")).trim(),i||(console.error("[frs] --domain is required"),process.exit(2)));let c=f(t.root)??"src/domains",n=f(t.method)?.toLowerCase();n||(n=await o.askChoice("HTTP method",["get","post","put","patch","delete"],"post")),["get","post","put","patch","delete"].includes(n)||(console.error(`[frs] invalid --method: ${n}`),process.exit(2));let a=f(t.api);a||(a=(await o.ask("API tag","v1")).trim()||"v1");let g=f(t["usecase-folder"])??"useCases",p=t["with-usecase"]===void 0?s?!0:await o.askBool("Scaffold useCase.ts?",!0):t["with-usecase"]!==!1,l=t["with-test"]===void 0?s||!p?p:await o.askBool("Scaffold useCase.test.ts (Vitest)?",!0):t["with-test"]!==!1,v=t.force===!0,y=path.resolve(process.cwd(),c),$=path.resolve(y,i,g,r),b=path.resolve($,"routes.ts"),D=path.resolve($,"useCase.ts"),x=path.resolve($,"useCase.test.ts");fs.mkdirSync($,{recursive:!0});let m=`${r.charAt(0).toUpperCase()}${r.slice(1)}UseCase`,C=`/**
- * ${m} \u2014 pure business logic, no HTTP awareness.
- * Reusable across multiple routes / cron jobs / triggers.
+`);}function V(e){if(typeof e=="string")return e.split(",").map(t=>t.trim()).filter(Boolean)}function f(e){return typeof e=="string"?e:void 0}function X(e){if(e||!process$1.stdin.isTTY)return {ask:async(s,i)=>i??"",askChoice:async(s,i,r)=>r??"",askBool:async(s,i)=>i,close:()=>{}};let t=promises.createInterface({input:process$1.stdin,output:process$1.stdout});return {async ask(s,i){let r=i?` (${i})`:"";return (await t.question(`? ${s}${r} \u203A `)).trim()||i||""},async askChoice(s,i,r){let n=` [${i.join("/")}${r?`, default: ${r}`:""}]`;for(;;){let c=(await t.question(`? ${s}${n} \u203A `)).trim().toLowerCase();if(!c&&r)return r;if(i.includes(c))return c;console.log(`  invalid choice \u2014 pick one of: ${i.join(", ")}`);}},async askBool(s,i){let r=` (${i?"Y/n":"y/N"})`,n=(await t.question(`? ${s}${r} \u203A `)).trim().toLowerCase();return n?n==="y"||n==="yes"||n==="true":i},close:()=>t.close()}}async function ge(e){let t=f(e.root);t||(console.error("[frs] --root is required"),process.exit(2));let s=path.resolve(process.cwd(),t);fs.existsSync(s)||(console.error(`[frs] root not found: ${s}`),process.exit(2));let i=f(e.out)??"__generated__/routes.ts",r=V(e.skip)??I.skipSegments,n=f(e.casing)==="kebab"?"kebab":I.casing,c={skipSegments:r,casing:n},o=f(e.ext)??".js",a=V(e.exclude)??E.excludeSegments,m=f(e["routes-file"])??E.routesFile,l=H(s,{routesFile:m,excludeSegments:a});l.length===0&&console.warn(`[frs] no "${m}" files found under ${s} \u2014 generated an empty manifest.`);let h=M(l,{outFile:path.resolve(s,i),derive:c,importExtension:o});if(!e.silent){console.log(`[frs] wrote ${h.outFile}  (${h.routeCount} route${h.routeCount===1?"":"s"})`);for(let{source:v,url:y}of h.derivedPaths)console.log(`  ${y.padEnd(48)}  \u2190  ${v}`);}}async function he(e,t){let s=t.yes===true,i=X(s);try{let r=e&&!e.startsWith("--")?e:void 0;r||(r=(await i.ask("Route name (e.g. createPost)")).trim(),r||(console.error("[frs] route name is required"),process.exit(2)));let n=f(t.domain);n||(n=(await i.ask("Domain name (e.g. posts)")).trim(),n||(console.error("[frs] --domain is required"),process.exit(2)));let c=f(t.root)??"src/domains",o=f(t.method)?.toLowerCase();o||(o=await i.askChoice("HTTP method",["get","post","put","patch","delete"],"post")),["get","post","put","patch","delete"].includes(o)||(console.error(`[frs] invalid --method: ${o}`),process.exit(2));let a=f(t.api);a||(a=(await i.ask("API tag","v1")).trim()||"v1");let m=f(t["usecase-folder"])??"useCases",u=t["with-usecase"]===void 0?s?!0:await i.askBool("Scaffold useCase.ts?",!0):t["with-usecase"]!==!1,l=t["with-test"]===void 0?s||!u?u:await i.askBool("Scaffold useCase.test.ts (Vitest)?",!0):t["with-test"]!==!1,h=t.force===!0,v=path.resolve(process.cwd(),c),y=path.resolve(v,n,m,r),b=path.resolve(y,"routes.ts"),F=path.resolve(y,"useCase.ts"),x=path.resolve(y,"useCase.test.ts");fs.mkdirSync(y,{recursive:!0});let $=`${r.charAt(0).toUpperCase()}${r.slice(1)}UseCase`,P="@lpdjs/firestore-repo-service/servers/hono",k=we(v,y),D=o==="get"?"// GET \u2192 lu depuis les query params":`// ${o.toUpperCase()} \u2192 lu depuis le body JSON`,A=`/**
+ * ${$} \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
+ * \`execute\`. The shared \`services\` container is injected by the \`UseCase\` base
+ * class via the constructor.
  */
 
-export interface ${m}Input {
-  // TODO: define the input shape
-  example: string;
-}
+import { z } from "zod";
+import { UseCase } from "${P}";
+import type { Services } from "${k}";
 
-export interface ${m}Output {
-  // TODO: define the output shape
-  id: string;
-}
+const input = z.object({
+  ${D}
+  example: z.string(),
+});
+
+const output = z.object({
+  id: z.string(),
+});
 
-export class ${m} {
-  // TODO: inject repositories / services via the constructor.
-  // constructor(private readonly repo: SomeRepository) {}
+export class ${$} extends UseCase<typeof input, typeof output, Services> {
+  static readonly input = input;
+  static readonly output = output;
 
-  async execute(input: ${m}Input): Promise<${m}Output> {
-    // TODO: implement
-    return { id: input.example };
+  async execute(
+    payload: z.infer<typeof input>,
+  ): Promise<z.infer<typeof output>> {
+    // TODO: implement using \`this.services\`
+    return { id: payload.example };
   }
 }
-`,F=n==="get"?`z.object({
-    // GET \u2192 lu depuis les query params
-    example: z.string(),
-  })`:`z.object({
-    // ${n.toUpperCase()} \u2192 lu depuis le body JSON
-    example: z.string(),
-  })`,_=p?`    const useCase = new ${m}();
-    const data = await useCase.execute(input);
-    return data;`:`    // TODO: business logic
-    return { id: input.example };`,A=p?`import { ${m} } from "./useCase.js";
-`:"",S=`import { z } from "zod";
-import { defineRoute } from "${f(t["apis-import"])??ve(y,$)}";
-${A}
-export default defineRoute({
-  api: "${a}",
-  method: "${n}",
-
-  input: ${F},
-
-  output: z.object({
-    id: z.string(),
+`,g=o==="get"?`
+    source: "query",`:"",C=u?`import { ${$} } from "./useCase.js";
+`:"",j=f(t["apis-import"])??$e(v,y),d=u?`import { defineRoutes } from "${P}";
+import { useCaseRoute } from "${j}";
+${C}
+export default defineRoutes([
+  useCaseRoute(${$}, {
+    api: "${a}",
+    method: "${o}",${g}
+    summary: "TODO: ${r}",
+    tags: ["${n}"],
   }),
+]);
+`:`import { z } from "zod";
+import { defineRoutes } from "${P}";
+import { defineRoute } from "${j}";
+
+export default defineRoutes([
+  defineRoute({
+    api: "${a}",
+    method: "${o}",
+
+    input: z.object({
+      ${D}
+      example: z.string(),
+    }),
+
+    output: z.object({
+      id: z.string(),
+    }),
+
+    summary: "TODO: ${r}",
+    tags: ["${n}"],
+
+    handler: async ({ input }) => {
+      // TODO: business logic
+      return { id: input.example };
+    },
+  }),
+]);
+`,_=[],U=[],q=(S,ee)=>{if(fs.existsSync(S)&&!h){U.push(S);return}fs.writeFileSync(S,ee,"utf8"),_.push(S);};if(q(b,d),u&&q(F,A),u&&l){let S=`import { describe, it, expect } from "vitest";
+import type { Services } from "${k}";
+import { ${$} } from "./useCase.js";
 
-  summary: "TODO: ${r}",
-  tags: ["${i}"],
-
-  handler: async ({ input }) => {
-${_}
-  },
-});
-`,j=[],u=[],R=(w,Q)=>{if(fs.existsSync(w)&&!v){u.push(w);return}fs.writeFileSync(w,Q,"utf8"),j.push(w);};if(R(b,S),p&&R(D,C),p&&l){let w=`import { describe, it, expect } from "vitest";
-import { ${m} } from "./useCase.js";
-
-describe("${m}", () => {
+describe("${$}", () => {
   it("returns a response shaped like the output schema", async () => {
-    const useCase = new ${m}();
+    // TODO: replace with real mocks for the services the useCase consumes.
+    const services = {} as unknown as Services;
+
+    const useCase = new ${$}(services);
     const result = await useCase.execute({ example: "hello" });
     expect(result).toMatchObject({ id: expect.any(String) });
   });
 
   // TODO: add error-path tests, repository mocks, etc.
 });
-`;R(x,w);}for(let w of j)console.log(`[frs] wrote   ${w}`);for(let w of u)console.log(`[frs] skipped ${w} (use --force to overwrite)`);console.log(`
-[frs] reminder: run "frs gen --root ${c}" to refresh the manifest.`);}finally{o.close();}}async function ge(e){let t=e.yes===true,s=Z(t);try{let o=e.force===!0,r=f(e.root);r||(r=(await s.ask("Domain root","src/domains")).trim()||"src/domains");let i=f(e["apis-file"]);i||(i=(await s.ask("apis.ts location","src/apis.ts")).trim()||"src/apis.ts");let c=f(e["services-file"]);if(!c){let u=i.replace(/apis\.ts$/,"services.ts")||"src/services.ts";c=(await s.ask("services.ts location",u)).trim()||u;}let n=f(e.apis);n||(n=(await s.ask("API tags (comma-separated)","v1")).trim()||"v1");let a=n.split(",").map(u=>u.trim()).filter(Boolean);a.length===0&&(console.error("[frs] at least one API tag is required"),process.exit(2));let g=f(e["base-path"]),p=path.resolve(process.cwd(),r),l=path.resolve(process.cwd(),i),v=path.resolve(process.cwd(),c),y=path.resolve(p,"__generated__"),$=path.resolve(y,"routes.ts"),b=[],D=[],x=(u,R)=>{if(fs.mkdirSync(path.dirname(u),{recursive:!0}),fs.existsSync(u)&&!o){D.push(u);return}fs.writeFileSync(u,R,"utf8"),b.push(u);},m=a.map(u=>{let R=g??`/${u}`;return `    ${u}: {
-      basePath: "${R}",
+`;q(x,S);}for(let S of _)console.log(`[frs] wrote   ${S}`);for(let S of U)console.log(`[frs] skipped ${S} (use --force to overwrite)`);console.log(`
+[frs] reminder: run "frs gen --root ${c}" to refresh the manifest.`);}finally{i.close();}}async function ve(e){let t=e.yes===true,s=X(t);try{let i=e.force===!0,r=f(e.root);r||(r=(await s.ask("Domain root","src/domains")).trim()||"src/domains");let n=f(e["apis-file"]);n||(n=(await s.ask("apis.ts location","src/apis.ts")).trim()||"src/apis.ts");let c=f(e["services-file"]);if(!c){let d=n.replace(/apis\.ts$/,"services.ts")||"src/services.ts";c=(await s.ask("services.ts location",d)).trim()||d;}let o=f(e.apis);o||(o=(await s.ask("API tags (comma-separated)","v1")).trim()||"v1");let a=o.split(",").map(d=>d.trim()).filter(Boolean);a.length===0&&(console.error("[frs] at least one API tag is required"),process.exit(2));let m=f(e["base-path"]),u=path.resolve(process.cwd(),r),l=path.resolve(process.cwd(),n),h=path.resolve(process.cwd(),c),v=path.resolve(u,"__generated__"),y=path.resolve(v,"routes.ts"),b=[],F=[],x=(d,_)=>{if(fs.mkdirSync(path.dirname(d),{recursive:!0}),fs.existsSync(d)&&!i){F.push(d);return}fs.writeFileSync(d,_,"utf8"),b.push(d);},$=a.map(d=>{let _=m??`/${d}`;return `    ${d}: {
+      basePath: "${_}",
       openapi: {
-        info: { title: "${u.toUpperCase()} API", version: "1.0.0", description: "" },
+        info: { title: "${d.toUpperCase()} API", version: "1.0.0", description: "" },
       },
       verbose: process.env["NODE_ENV"] !== "production",
     },`}).join(`
-`),C=`import { createApiRegistry } from "@lpdjs/firestore-repo-service/servers/hono";
-import { services } from "${T(path.dirname(l),v)}";
+`),P=`import { createApiRegistry } from "@lpdjs/firestore-repo-service/servers/hono";
+import { services } from "${T(path.dirname(l),h)}";
 
 /**
  * Single source of truth for every API exposed by this project.
@@ -165,14 +188,15 @@ import { services } from "${T(path.dirname(l),v)}";
  */
 export const apis = createApiRegistry(
   {
-${m}
+${$}
   },
   { services },
 );
 
-/** Typed helper used inside every route file. */
+/** Typed helpers used inside every route file. */
 export const defineRoute = apis.defineRoute;
-`;x(l,C),x(v,`import { createServices } from "@lpdjs/firestore-repo-service/servers/hono";
+export const useCaseRoute = apis.useCaseRoute;
+`;x(l,P),x(h,`import { createServices } from "@lpdjs/firestore-repo-service/servers/hono";
 
 /**
  * Global DI container \u2014 declare every singleton (repositories, SDK
@@ -205,20 +229,20 @@ export const services = createServices({
 
 /** Convenience type \u2014 \`function fn(svc: Services) { ... }\`. */
 export type Services = typeof services;
-`);let _=`// AUTO-GENERATED by frs \u2014 do not edit.
+`);let D=`// AUTO-GENERATED by frs \u2014 do not edit.
 // Run \`frs gen --root ${r}\` to refresh.
 
 import type { AnyRouteDef } from "@lpdjs/firestore-repo-service/servers/hono";
 
 export const routes: AnyRouteDef[] = [];
-`;x($,_);let A=le({root:r,apisFile:i,servicesFile:c});b.push(A);let h=T(path.dirname(l),l),S=T(path.dirname(l),$),j=a.length===1?`export const { ${a[0]} } = apis.toFunctions(routes, onRequest, {`:`export const { ${a.join(", ")} } = apis.toFunctions(routes, onRequest, {`;for(let u of b)console.log(`[frs] wrote   ${u}`);for(let u of D)console.log(`[frs] skipped ${u} (use --force to overwrite)`);console.log(`
+`;x(y,D);let A=fe({root:r,apisFile:n,servicesFile:c});b.push(A);let g=T(path.dirname(l),l),C=T(path.dirname(l),y),j=a.length===1?`export const { ${a[0]} } = apis.toFunctions(routes, onRequest, {`:`export const { ${a.join(", ")} } = apis.toFunctions(routes, onRequest, {`;for(let d of b)console.log(`[frs] wrote   ${d}`);for(let d of F)console.log(`[frs] skipped ${d} (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 "${S}";
+   import { apis } from "${g}";
+   import { routes } from "${C}";
 
    ${j}
      defaults: { region: "us-central1", invoker: "public" },
@@ -231,17 +255,17 @@ Next steps:
 3. Refresh the manifest before each build:
 
    frs gen --root ${r}
-`);}finally{s.close();}}function T(e,t){let s=path.relative(e,t).replace(/\\/g,"/");return s=s.replace(/\.ts$/,".js"),s.startsWith(".")||(s=`./${s}`),s}async function he(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 o=s.force===true,r=Y(),c=[f(s["services-file"]),r.servicesFile,"src/services.ts","services.ts"].filter(h=>typeof h=="string"&&h.length>0),n;for(let h of c){let S=path.resolve(process.cwd(),h);if(fs.existsSync(S)){n=S;break}}if(!n){let h=c.map(S=>path.resolve(process.cwd(),S)).join(`
+`);}finally{s.close();}}function T(e,t){let s=path.relative(e,t).replace(/\\/g,"/");return s=s.replace(/\.ts$/,".js"),s.startsWith(".")||(s=`./${s}`),s}async function ye(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 i=s.force===true,r=Q(),c=[f(s["services-file"]),r.servicesFile,"src/services.ts","services.ts"].filter(g=>typeof g=="string"&&g.length>0),o;for(let g of c){let C=path.resolve(process.cwd(),g);if(fs.existsSync(C)){o=C;break}}if(!o){let g=c.map(C=>path.resolve(process.cwd(),C)).join(`
         `);console.error(`[frs] services file not found. Tried:
-        ${h}
-      Run \`frs init\` first or pass --services-file <path>.`),process.exit(2);}let a=f(s["services-dir"])??r.servicesDir??path.resolve(path.dirname(n),"services"),g=path.resolve(process.cwd(),a);fs.mkdirSync(g,{recursive:true});let p=`${t.charAt(0).toUpperCase()}${t.slice(1)}Service`,l=path.resolve(g,`${t}.ts`),v=`import type { RequestContext } from "@lpdjs/firestore-repo-service/servers/hono";
+        ${g}
+      Run \`frs init\` first or pass --services-file <path>.`),process.exit(2);}let a=f(s["services-dir"])??r.servicesDir??path.resolve(path.dirname(o),"services"),m=path.resolve(process.cwd(),a);fs.mkdirSync(m,{recursive:true});let u=`${t.charAt(0).toUpperCase()}${t.slice(1)}Service`,l=path.resolve(m,`${t}.ts`),h=`import type { RequestContext } from "@lpdjs/firestore-repo-service/servers/hono";
 
 /**
- * ${p} \u2014 generated by \`frs add service ${t}\`.
+ * ${u} \u2014 generated by \`frs add service ${t}\`.
  *
  * Registered with a **factory** in \`services.ts\` so dependencies are
  * destructured at registration time. Add new constructor parameters here
- * and update the factory line (\`({ ctx, otherSvc }) => new ${p}(ctx, otherSvc)\`)
+ * and update the factory line (\`({ ctx, otherSvc }) => new ${u}(ctx, otherSvc)\`)
  * \u2014 TypeScript will tell you when something is missing.
  *
  * Async resources (DB connections, SDK clients) should stay lazy-loaded
@@ -255,7 +279,7 @@ Next steps:
  * }
  * \`\`\`
  */
-export class ${p} {
+export class ${u} {
   // eslint-disable-next-line @typescript-eslint/no-useless-constructor
   constructor(private readonly ctx: RequestContext) {}
 
@@ -263,9 +287,9 @@ export class ${p} {
     return \`hello from ${t} \u2014 user=\${this.ctx.maybeC?.get("user")?.id ?? "anonymous"}\`;
   }
 }
-`;fs.existsSync(l)&&!o?console.log(`[frs] skipped ${l} (use --force to overwrite)`):(fs.writeFileSync(l,v,"utf8"),console.log(`[frs] wrote   ${l}`));let y=fs.readFileSync(n,"utf8"),$=T(path.dirname(n),l),b=`import { ${p} } from "${$}";`,D=`  ${t}: ({ ctx }) => new ${p}(ctx),`;if(y.includes(b)){console.log(`[frs] services.ts already registers "${t}" \u2014 skipping.`);return}let x=y.split(`
-`),m=-1;for(let h=0;h<x.length;h++)/^import\s/.test(x[h])&&(m=h);m>=0?x.splice(m+1,0,b):x.unshift(b);let C=x.join(`
-`),F=C.match(/createServices\s*\(\s*\{/);if(!F){console.error(`[frs] could not find \`createServices({\` in ${n} \u2014 register "${t}" manually.`);return}let _=F.index+F[0].length,A=C.slice(0,_)+`
-`+D+C.slice(_);fs.writeFileSync(n,A,"utf8"),console.log(`[frs] updated ${n}  (+ ${t})`);}function ve(e,t){let s=["apis.ts","apis.js","api.ts","api.js"],o=[e,path.dirname(e),path.dirname(path.dirname(e))];for(let r of o)for(let i of s){let c=path.resolve(r,i);if(fs.existsSync(c)){let n=path.relative(t,c).replace(/\\/g,"/");return n=n.replace(/\.ts$/,".js").replace(/\.js$/,".js"),n.startsWith(".")||(n=`./${n}`),n}}return "../../../../apis.js"}async function ye(){let e=process.argv.slice(2),{command:t,flags:s}=de(e);switch(t){case "init":await ge(s);return;case "gen":await fe(s);return;case "new":await me(e[1],s);return;case "add":await he(e[1],e[2],s);return;case "help":case "--help":case "-h":H();return;default:console.error(`[frs] unknown command: ${t}
-`),H(),process.exit(2);}}ye().catch(e=>{console.error(e),process.exit(1);});//# sourceMappingURL=cli.cjs.map
+`;fs.existsSync(l)&&!i?console.log(`[frs] skipped ${l} (use --force to overwrite)`):(fs.writeFileSync(l,h,"utf8"),console.log(`[frs] wrote   ${l}`));let v=fs.readFileSync(o,"utf8"),y=T(path.dirname(o),l),b=`import { ${u} } from "${y}";`,F=`  ${t}: ({ ctx }) => new ${u}(ctx),`;if(v.includes(b)){console.log(`[frs] services.ts already registers "${t}" \u2014 skipping.`);return}let x=v.split(`
+`),$=-1;for(let g=0;g<x.length;g++)/^import\s/.test(x[g])&&($=g);$>=0?x.splice($+1,0,b):x.unshift(b);let P=x.join(`
+`),k=P.match(/createServices\s*\(\s*\{/);if(!k){console.error(`[frs] could not find \`createServices({\` in ${o} \u2014 register "${t}" manually.`);return}let D=k.index+k[0].length,A=P.slice(0,D)+`
+`+F+P.slice(D);fs.writeFileSync(o,A,"utf8"),console.log(`[frs] updated ${o}  (+ ${t})`);}function $e(e,t){let s=["apis.ts","apis.js","api.ts","api.js"],i=[e,path.dirname(e),path.dirname(path.dirname(e))];for(let r of i)for(let n of s){let c=path.resolve(r,n);if(fs.existsSync(c)){let o=path.relative(t,c).replace(/\\/g,"/");return o=o.replace(/\.ts$/,".js").replace(/\.js$/,".js"),o.startsWith(".")||(o=`./${o}`),o}}return "../../../../apis.js"}function we(e,t){let s=["services.ts","services.js"],i=[e,path.dirname(e),path.dirname(path.dirname(e))];for(let r of i)for(let n of s){let c=path.resolve(r,n);if(fs.existsSync(c)){let o=path.relative(t,c).replace(/\\/g,"/");return o=o.replace(/\.ts$/,".js"),o.startsWith(".")||(o=`./${o}`),o}}return "../../../../services.js"}async function xe(){let e=process.argv.slice(2),{command:t,flags:s}=me(e);switch(t){case "init":await ve(s);return;case "gen":await ge(s);return;case "new":await he(e[1],s);return;case "add":await ye(e[1],e[2],s);return;case "help":case "--help":case "-h":K();return;default:console.error(`[frs] unknown command: ${t}
+`),K(),process.exit(2);}}xe().catch(e=>{console.error(e),process.exit(1);});//# sourceMappingURL=cli.cjs.map
 //# sourceMappingURL=cli.cjs.map