@lpdjs/firestore-repo-service 2.4.3 → 2.6.2-beta.0

package/dist/servers/hono/cli.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import {resolve,dirname,relative,join,sep}from'path';import {mkdirSync,existsSync,writeFileSync,readdirSync,statSync}from'fs';import {createInterface}from'readline/promises';import {stdin,stdout}from'process';var b={skipSegments:["useCases","useCase","use-cases","use-case"],casing:"preserve"};function I(e,s=b){let t=new Set(s.skipSegments.map(o=>o.toLowerCase()));return "/"+e.split("/").filter(Boolean).filter(o=>!t.has(o.toLowerCase())).map(o=>s.casing==="kebab"?Z(o):o).join("/")}function Z(e){return e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/[\s_]+/g,"-").toLowerCase()}function T(e,s,t){let r=E(e),o=E(s),i=0;for(;i<r.length&&i<o.length&&r[i]===o[i];)i++;let a=r.length-i,n=o.slice(i),d=(n[n.length-1]??"").replace(/\.[mc]?[tj]sx?$/i,""),c=t===""?d:`${d}${t}`;return n[n.length-1]=c,(a===0?"./":"../".repeat(a))+n.join("/")}function E(e){return e.replace(/\\/g,"/").replace(/\/+$/,"").split("/").filter((t,r)=>!(r===0&&t===""))}var S={routesFile:"routes.ts",excludeSegments:["node_modules","__generated__","tests","__tests__",".turbo","dist","build",".next"]};function N(e,s=S){let t=[];return q(e,e,s,t),t.sort((r,o)=>r.relPath.localeCompare(o.relPath)),t}function q(e,s,t,r){let o;try{o=readdirSync(s);}catch{return}for(let i of o){if(t.excludeSegments.includes(i))continue;let a=join(s,i),n;try{n=statSync(a);}catch{continue}if(n.isDirectory())q(e,a,t,r);else if(n.isFile()&&i===t.routesFile){let l=relative(e,a).split(sep).join("/"),d=l.replace(/\/?[^/]+$/,"");r.push({absPath:a,relPath:l,relDir:d});}}}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 L(e,s){let t=dirname(s.outFile);mkdirSync(t,{recursive:true});let r=s.banner??ne,o=(s.now??new Date).toISOString(),i=s.importExtension,a=[],n=[],l=[];e.forEach((c,h)=>{let g=T(t,c.absPath,i),y=I(c.relDir,s.derive);a.push(`import mod${h} from ${JSON.stringify(g)};`),n.push(`  { __derivedPath: ${JSON.stringify(y)}, mod: mod${h} },`),l.push({source:c.relPath,url:y});});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 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=dirname(t.outFile);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"}.
 
 import type { AnyRouteDef, RouteModuleDefault } from "@lpdjs/firestore-repo-service/servers/hono";
 
-`+a.join(`
-`)+(a.length?`
+`+c.join(`
+`)+(c.length?`
 
 `:`
 `)+`const __defs: { __derivedPath: string; mod: RouteModuleDefault }[] = [
@@ -16,17 +16,22 @@ 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(s.outFile,d,"utf8"),{outFile:s.outFile,routeCount:e.length,derivedPaths:l}}function ce(e){let[s,...t]=e,r={};for(let o=0;o<t.length;o++){let i=t[o];if(!i.startsWith("--"))continue;let a=i.slice(2),n=t[o+1];n&&!n.startsWith("--")?(r[a]=n,o++):r[a]=true;}return {command:s??"help",flags:r}}function B(){console.log(`frs-hono \u2014 Hono file-based codegen
+`;return 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=readdirSync(t);}catch{return}for(let i of r){if(s.excludeSegments.includes(i))continue;let c=join(t,i),n;try{n=statSync(c);}catch{continue}if(n.isDirectory())z(e,c,s,o);else if(n.isFile()&&i===s.routesFile){let a=relative(e,c).split(sep).join("/"),g=a.replace(/\/?[^/]+$/,"");o.push({absPath:c,relPath:a,relDir:g});}}}var V=".frsrc.json";function Y(e=process.cwd()){let t=resolve(e,V);if(!existsSync(t))return {};try{return JSON.parse(readFileSync(t,"utf8"))}catch{return {}}}function le(e,t=process.cwd()){let s=resolve(t,V),r={...Y(t),...e};return 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
 
 Usage:
-  frs-hono init [flags]
-  frs-hono gen  [flags]
-  frs-hono new  <name> [flags]
-  frs-hono help
+  frs init [flags]
+  frs gen  [flags]
+  frs new  <name> [flags]
+  frs add  service <name> [flags]
+  frs help
 
 Flags (init):
   --root <dir>          Domain root to create (default: src/domains)
   --apis-file <path>    Path to the apis.ts file to create (default: src/apis.ts)
+  --services-file <path>
+                        Path to the services.ts file to create
+                        (default: src/services.ts)
   --apis <list>         Comma-separated API tags to register (default: v1)
   --base-path <prefix>  basePath shared by all APIs (default: derived from tag)
   --force               Overwrite existing files
@@ -61,122 +66,206 @@ Flags (new <name>):
   --force               Overwrite if files already exist
   --yes                 Skip prompts, use defaults / flag values
 
+Flags (add service <name>):
+  --services-file <path>
+                        Path to the services.ts file (default: src/services.ts)
+  --services-dir <dir>  Directory hosting individual service files
+                        (default: <dir-of-services-file>/services)
+  --force               Overwrite existing files
+
 Examples:
-  frs-hono init
-  frs-hono new createPost --domain posts --method post
-  frs-hono new listPosts  --domain posts --method get --api v1
-`);}function G(e){if(typeof e=="string")return e.split(",").map(s=>s.trim()).filter(Boolean)}function p(e){return typeof e=="string"?e:void 0}function J(e){if(e||!stdin.isTTY)return {ask:async(t,r)=>r??"",askChoice:async(t,r,o)=>o??"",askBool:async(t,r)=>r,close:()=>{}};let s=createInterface({input:stdin,output:stdout});return {async ask(t,r){let o=r?` (${r})`:"";return (await s.question(`? ${t}${o} \u203A `)).trim()||r||""},async askChoice(t,r,o){let i=` [${r.join("/")}${o?`, default: ${o}`:""}]`;for(;;){let a=(await s.question(`? ${t}${i} \u203A `)).trim().toLowerCase();if(!a&&o)return o;if(r.includes(a))return a;console.log(`  invalid choice \u2014 pick one of: ${r.join(", ")}`);}},async askBool(t,r){let o=` (${r?"Y/n":"y/N"})`,i=(await s.question(`? ${t}${o} \u203A `)).trim().toLowerCase();return i?i==="y"||i==="yes"||i==="true":r},close:()=>s.close()}}async function ue(e){let s=p(e.root);s||(console.error("[frs-hono] --root is required"),process.exit(2));let t=resolve(process.cwd(),s);existsSync(t)||(console.error(`[frs-hono] root not found: ${t}`),process.exit(2));let r=p(e.out)??"__generated__/routes.ts",o=G(e.skip)??b.skipSegments,i=p(e.casing)==="kebab"?"kebab":b.casing,a={skipSegments:o,casing:i},n=p(e.ext)??".js",l=G(e.exclude)??S.excludeSegments,d=p(e["routes-file"])??S.routesFile,h=N(t,{routesFile:d,excludeSegments:l});h.length===0&&console.warn(`[frs-hono] no "${d}" files found under ${t} \u2014 generated an empty manifest.`);let g=L(h,{outFile:resolve(t,r),derive:a,importExtension:n});if(!e.silent){console.log(`[frs-hono] wrote ${g.outFile}  (${g.routeCount} route${g.routeCount===1?"":"s"})`);for(let{source:y,url:$}of g.derivedPaths)console.log(`  ${$.padEnd(48)}  \u2190  ${y}`);}}async function pe(e,s){let t=s.yes===true,r=J(t);try{let o=e&&!e.startsWith("--")?e:void 0;o||(o=(await r.ask("Route name (e.g. createPost)")).trim(),o||(console.error("[frs-hono] route name is required"),process.exit(2)));let i=p(s.domain);i||(i=(await r.ask("Domain name (e.g. posts)")).trim(),i||(console.error("[frs-hono] --domain is required"),process.exit(2)));let a=p(s.root)??"src/domains",n=p(s.method)?.toLowerCase();n||(n=await r.askChoice("HTTP method",["get","post","put","patch","delete"],"post")),["get","post","put","patch","delete"].includes(n)||(console.error(`[frs-hono] invalid --method: ${n}`),process.exit(2));let l=p(s.api);l||(l=(await r.ask("API tag","v1")).trim()||"v1");let d=p(s["usecase-folder"])??"useCases",c=s["with-usecase"]===void 0?t?!0:await r.askBool("Scaffold useCase.ts?",!0):s["with-usecase"]!==!1,h=s["with-test"]===void 0?t||!c?c:await r.askBool("Scaffold useCase.test.ts (Vitest)?",!0):s["with-test"]!==!1,g=s.force===!0,y=resolve(process.cwd(),a),$=resolve(y,i,d,o),P=resolve($,"routes.ts"),A=resolve($,"useCase.ts"),k=resolve($,"useCase.test.ts");mkdirSync($,{recursive:!0});let f=`${o.charAt(0).toUpperCase()}${o.slice(1)}UseCase`,R=`/**
- * ${f} \u2014 pure business logic, no HTTP awareness.
+  frs init
+  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||!stdin.isTTY)return {ask:async(s,o)=>o??"",askChoice:async(s,o,r)=>r??"",askBool:async(s,o)=>o,close:()=>{}};let t=createInterface({input:stdin,output: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=resolve(process.cwd(),t);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: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=resolve(process.cwd(),c),$=resolve(y,i,g,r),b=resolve($,"routes.ts"),D=resolve($,"useCase.ts"),x=resolve($,"useCase.test.ts");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.
  */
 
-export interface ${f}Input {
+export interface ${m}Input {
   // TODO: define the input shape
   example: string;
 }
 
-export interface ${f}Output {
+export interface ${m}Output {
   // TODO: define the output shape
   id: string;
 }
 
-export class ${f} {
+export class ${m} {
   // TODO: inject repositories / services via the constructor.
   // constructor(private readonly repo: SomeRepository) {}
 
-  async execute(input: ${f}Input): Promise<${f}Output> {
+  async execute(input: ${m}Input): Promise<${m}Output> {
     // TODO: implement
     return { id: input.example };
   }
 }
-`,C=n==="get"?`z.object({
+`,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(),
-  })`,D=c?`    const useCase = new ${f}();
+  })`,_=p?`    const useCase = new ${m}();
     const data = await useCase.execute(input);
     return data;`:`    // TODO: business logic
-    return { id: input.example };`,u=c?`import { ${f} } from "./useCase.js";
-`:"",V=`import { z } from "zod";
-import { defineRoute } from "${p(s["apis-import"])??de(y,$)}";
-${u}
+    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: "${l}",
+  api: "${a}",
   method: "${n}",
 
-  input: ${C},
+  input: ${F},
 
   output: z.object({
     id: z.string(),
   }),
 
-  summary: "TODO: ${o}",
+  summary: "TODO: ${r}",
   tags: ["${i}"],
 
   handler: async ({ input }) => {
-${D}
+${_}
   },
 });
-`,j=[],F=[],O=(v,Y)=>{if(existsSync(v)&&!g){F.push(v);return}writeFileSync(v,Y,"utf8"),j.push(v);};if(O(P,V),c&&O(A,R),c&&h){let v=`import { describe, it, expect } from "vitest";
-import { ${f} } from "./useCase.js";
+`,j=[],u=[],R=(w,Q)=>{if(existsSync(w)&&!v){u.push(w);return}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("${f}", () => {
+describe("${m}", () => {
   it("returns a response shaped like the output schema", async () => {
-    const useCase = new ${f}();
+    const useCase = new ${m}();
     const result = await useCase.execute({ example: "hello" });
     expect(result).toMatchObject({ id: expect.any(String) });
   });
 
   // TODO: add error-path tests, repository mocks, etc.
 });
-`;O(k,v);}for(let v of j)console.log(`[frs-hono] wrote   ${v}`);for(let v of F)console.log(`[frs-hono] skipped ${v} (use --force to overwrite)`);console.log(`
-[frs-hono] reminder: run "frs-hono gen --root ${a}" to refresh the manifest.`);}finally{r.close();}}async function le(e){let s=e.yes===true,t=J(s);try{let r=e.force===!0,o=p(e.root);o||(o=(await t.ask("Domain root","src/domains")).trim()||"src/domains");let i=p(e["apis-file"]);i||(i=(await t.ask("apis.ts location","src/apis.ts")).trim()||"src/apis.ts");let a=p(e.apis);a||(a=(await t.ask("API tags (comma-separated)","v1")).trim()||"v1");let n=a.split(",").map(u=>u.trim()).filter(Boolean);n.length===0&&(console.error("[frs-hono] at least one API tag is required"),process.exit(2));let l=p(e["base-path"]),d=resolve(process.cwd(),o),c=resolve(process.cwd(),i),h=resolve(d,"__generated__"),g=resolve(h,"routes.ts"),y=[],$=[],P=(u,x)=>{if(mkdirSync(dirname(u),{recursive:!0}),existsSync(u)&&!r){$.push(u);return}writeFileSync(u,x,"utf8"),y.push(u);},k=`import { createApiRegistry } from "@lpdjs/firestore-repo-service/servers/hono";
+`;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=resolve(process.cwd(),r),l=resolve(process.cwd(),i),v=resolve(process.cwd(),c),y=resolve(p,"__generated__"),$=resolve(y,"routes.ts"),b=[],D=[],x=(u,R)=>{if(mkdirSync(dirname(u),{recursive:!0}),existsSync(u)&&!o){D.push(u);return}writeFileSync(u,R,"utf8"),b.push(u);},m=a.map(u=>{let R=g??`/${u}`;return `    ${u}: {
+      basePath: "${R}",
+      openapi: {
+        info: { title: "${u.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(dirname(l),v)}";
 
 /**
  * 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.
  */
-export const apis = createApiRegistry({
-${n.map(u=>{let x=l??`/${u}`;return `  ${u}: {
-    basePath: "${x}",
-    openapi: {
-      info: { title: "${u.toUpperCase()} API", version: "1.0.0", description: "" },
-    },
-    verbose: process.env["NODE_ENV"] !== "production",
-  },`}).join(`
-`)}
-});
+export const apis = createApiRegistry(
+  {
+${m}
+  },
+  { services },
+);
 
 /** Typed helper used inside every route file. */
 export const defineRoute = apis.defineRoute;
-`;P(c,k);let f=`// AUTO-GENERATED by frs-hono \u2014 do not edit.
-// Run \`frs-hono gen --root ${o}\` to refresh.
+`;x(l,C),x(v,`import { createServices } from "@lpdjs/firestore-repo-service/servers/hono";
+
+/**
+ * Global DI container \u2014 declare every singleton (repositories, SDK
+ * clients, loggers, useCases) here. Each factory is invoked once on first
+ * access and the instance is cached for the process lifetime.
+ *
+ * Factories receive a typed proxy of every other service plus the
+ * built-in \`ctx\` (current request \`Context\` via AsyncLocalStorage).
+ * Destructure what you need \u2014 TypeScript will infer everything.
+ *
+ * NOTE: prefer **factory form with destructured deps** for anything that
+ * needs to reference its dependencies inside its own class \u2014 typing a
+ * field as the full \`Services\` would create a circular type alias.
+ * Classes can be passed directly only when they don't reference
+ * \`Services\` themselves (e.g. plain SDK wrappers).
+ *
+ * @example
+ * \`\`\`ts
+ * postRepo: ({ ctx }) => new PostRepo(ctx),
+ * createPostUseCase: ({ ctx, postRepo }) =>
+ *   new CreatePostUseCase(ctx, postRepo),
+ * \`\`\`
+ */
+export const services = createServices({
+  // TODO: declare your services here.
+  // Example:
+  //   db: () => getFirestore(),
+  //   postRepo: ({ ctx, db }) => new PostRepo(ctx, db),
+});
+
+/** Convenience type \u2014 \`function fn(svc: Services) { ... }\`. */
+export type Services = typeof services;
+`);let _=`// 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[] = [];
-`;P(g,f);let R=z(dirname(c),c),C=z(dirname(c),g),D=n.length===1?`export const { ${n[0]} } = apis.toFunctions(routes, onRequest, {`:`export const { ${n.join(", ")} } = apis.toFunctions(routes, onRequest, {`;for(let u of y)console.log(`[frs-hono] wrote   ${u}`);for(let u of $)console.log(`[frs-hono] skipped ${u} (use --force to overwrite)`);console.log(`
+`;x($,_);let A=le({root:r,apisFile:i,servicesFile:c});b.push(A);let h=T(dirname(l),l),S=T(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(`
 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 "${R}";
-   import { routes } from "${C}";
+   import { apis } from "${h}";
+   import { routes } from "${S}";
 
-   ${D}
+   ${j}
      defaults: { region: "us-central1", invoker: "public" },
    });
 
 2. Scaffold a first route:
 
-   frs-hono new createPost --domain posts --method post --api ${n[0]}
+   frs new createPost --domain posts --method post --api ${a[0]}
 
 3. Refresh the manifest before each build:
 
-   frs-hono gen --root ${o}
-`);}finally{t.close();}}function z(e,s){let t=relative(e,s).replace(/\\/g,"/");return t=t.replace(/\.ts$/,".js"),t.startsWith(".")||(t=`./${t}`),t}function de(e,s){let t=["apis.ts","apis.js","api.ts","api.js"],r=[e,dirname(e),dirname(dirname(e))];for(let o of r)for(let i of t){let a=resolve(o,i);if(existsSync(a)){let n=relative(s,a).replace(/\\/g,"/");return n=n.replace(/\.ts$/,".js").replace(/\.js$/,".js"),n.startsWith(".")||(n=`./${n}`),n}}return "../../../../apis.js"}async function fe(){let e=process.argv.slice(2),{command:s,flags:t}=ce(e);switch(s){case "init":await le(t);return;case "gen":await ue(t);return;case "new":await pe(e[1],t);return;case "help":case "--help":case "-h":B();return;default:console.error(`[frs-hono] unknown command: ${s}
-`),B(),process.exit(2);}}fe().catch(e=>{console.error(e),process.exit(1);});//# sourceMappingURL=cli.js.map
+   frs gen --root ${r}
+`);}finally{s.close();}}function T(e,t){let s=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=resolve(process.cwd(),h);if(existsSync(S)){n=S;break}}if(!n){let h=c.map(S=>resolve(process.cwd(),S)).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??resolve(dirname(n),"services"),g=resolve(process.cwd(),a);mkdirSync(g,{recursive:true});let p=`${t.charAt(0).toUpperCase()}${t.slice(1)}Service`,l=resolve(g,`${t}.ts`),v=`import type { RequestContext } from "@lpdjs/firestore-repo-service/servers/hono";
+
+/**
+ * ${p} \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)\`)
+ * \u2014 TypeScript will tell you when something is missing.
+ *
+ * Async resources (DB connections, SDK clients) should stay lazy-loaded
+ * inside the class to keep cold-starts fast:
+ *
+ * @example
+ * \`\`\`ts
+ * private _client: SomeClient | undefined;
+ * get client(): SomeClient {
+ *   return (this._client ??= new SomeClient({...}));
+ * }
+ * \`\`\`
+ */
+export class ${p} {
+  // eslint-disable-next-line @typescript-eslint/no-useless-constructor
+  constructor(private readonly ctx: RequestContext) {}
+
+  hello(): string {
+    return \`hello from ${t} \u2014 user=\${this.ctx.maybeC?.get("user")?.id ?? "anonymous"}\`;
+  }
+}
+`;existsSync(l)&&!o?console.log(`[frs] skipped ${l} (use --force to overwrite)`):(writeFileSync(l,v,"utf8"),console.log(`[frs] wrote   ${l}`));let y=readFileSync(n,"utf8"),$=T(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(_);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,dirname(e),dirname(dirname(e))];for(let r of o)for(let i of s){let c=resolve(r,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"}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.js.map
 //# sourceMappingURL=cli.js.map