@lpdjs/firestore-repo-service 2.4.1 → 2.5.2-beta.0

package/README.md

@@ -102,20 +102,23 @@ if (post) {
 }
 
 // Update
-const updated = await repos.users.update("user123", { name: "New name", age: 31 });
+const updated = await repos.users.update("user123", {
+  name: "New name",
+  age: 31,
+});
 ```
 
 ## API reference
 
 ### `createRepositoryConfig()`
 
-| Option        | Description                                             |
-| ------------- | ------------------------------------------------------- |
-| `path`        | Collection path in Firestore                            |
-| `isGroup`     | `true` for collection group, `false` for simple         |
-| `foreignKeys` | Keys for `get.by*` methods (single document lookup)     |
-| `queryKeys`   | Keys for `query.by*` methods (multi-document query)     |
-| `refCb`       | Function that returns the document reference            |
+| Option        | Description                                         |
+| ------------- | --------------------------------------------------- |
+| `path`        | Collection path in Firestore                        |
+| `isGroup`     | `true` for collection group, `false` for simple     |
+| `foreignKeys` | Keys for `get.by*` methods (single document lookup) |
+| `queryKeys`   | Keys for `query.by*` methods (multi-document query) |
+| `refCb`       | Function that returns the document reference        |
 
 **Sub-collection example:**
 
@@ -134,8 +137,8 @@ comments: createRepositoryConfig<CommentModel>()({
 
 ```typescript
 interface QueryOptions<T> {
-  where?: [keyof T, WhereFilterOp, any][];      // AND conditions
-  orWhere?: [keyof T, WhereFilterOp, any][][];  // OR conditions
+  where?: [keyof T, WhereFilterOp, any][]; // AND conditions
+  orWhere?: [keyof T, WhereFilterOp, any][][]; // OR conditions
   orderBy?: { field: keyof T; direction?: "asc" | "desc" }[];
   limit?: number;
   offset?: number;
@@ -226,7 +229,9 @@ const page = await repos.posts.query.paginate({
 ```typescript
 import { count, sum, average } from "@lpdjs/firestore-repo-service";
 
-const activeCount = await repos.users.aggregate.count({ where: [["isActive", "==", true]] });
+const activeCount = await repos.users.aggregate.count({
+  where: [["isActive", "==", true]],
+});
 const totalViews = await repos.posts.aggregate.sum("views");
 const avgAge = await repos.users.aggregate.average("age");
 ```
@@ -237,7 +242,9 @@ const avgAge = await repos.users.aggregate.average("age");
 const result = await repos.users.transaction.run(async (txn) => {
   const user = await txn.get(repos.users.documentRef("user123"));
   if (user.exists()) {
-    txn.update(repos.users.documentRef("user123"), { age: user.data().age + 1 });
+    txn.update(repos.users.documentRef("user123"), {
+      age: user.data().age + 1,
+    });
   }
   return { success: true };
 });
@@ -249,8 +256,14 @@ const result = await repos.users.transaction.run(async (txn) => {
 // (status = 'active' AND age >= 18) OR (status = 'pending' AND verified = true)
 const users = await repos.users.query.by({
   orWhere: [
-    [["status", "==", "active"], ["age", ">=", 18]],
-    [["status", "==", "pending"], ["verified", "==", true]],
+    [
+      ["status", "==", "active"],
+      ["age", ">=", 18],
+    ],
+    [
+      ["status", "==", "pending"],
+      ["verified", "==", true],
+    ],
   ],
 });
 ```
@@ -304,9 +317,9 @@ npm i -D @asteasolutions/zod-to-openapi
 ### Bootstrap
 
 ```bash
-npx frs-hono init          # interactive — creates apis.ts + manifest stub
-npx frs-hono new createPost --domain posts --method post --api v1
-npx frs-hono gen --root src/domains   # refresh manifest (run before each build)
+npx frs init          # interactive — creates apis.ts + manifest stub
+npx frs new createPost --domain posts --method post --api v1
+npx frs gen --root src/domains   # refresh manifest (run before each build)
 ```
 
 ### Configure your APIs (`apis.ts`)
@@ -337,7 +350,7 @@ import { z } from "zod";
 import { defineRoute } from "../../../../apis.js";
 
 export default defineRoute({
-  api: "v1",           // typed: only registered tags accepted
+  api: "v1", // typed: only registered tags accepted
   method: "post",
   input: z.object({ title: z.string() }),
   output: z.object({ id: z.string() }),
@@ -365,16 +378,16 @@ export const { v1 } = apis.toFunctions(routes, onRequest, {
 
 ### Key features
 
-| Feature | Details |
-| --- | --- |
-| **File-based routing** | `routes.ts` next to each useCase, scanned at build time |
-| **Multi-API registry** | One Cloud Function per tag, typed `api` field |
-| **Zod validation** | Body / query / path params + optional response validation |
-| **OpenAPI 3.1** | Auto-generated from Zod schemas; Scalar UI at `/docs` |
-| **Interceptor** | Around-style hook for envelopes, error mapping, tracing |
-| **Middlewares** | Per-API and per-route Hono middlewares |
-| **Typed context** | Augment `ContextVariableMap` once, `c.get("user")` typed everywhere |
-| **CLI** | `init` / `new` (interactive) / `gen` |
+| Feature                | Details                                                             |
+| ---------------------- | ------------------------------------------------------------------- |
+| **File-based routing** | `routes.ts` next to each useCase, scanned at build time             |
+| **Multi-API registry** | One Cloud Function per tag, typed `api` field                       |
+| **Zod validation**     | Body / query / path params + optional response validation           |
+| **OpenAPI 3.1**        | Auto-generated from Zod schemas; Scalar UI at `/docs`               |
+| **Interceptor**        | Around-style hook for envelopes, error mapping, tracing             |
+| **Middlewares**        | Per-API and per-route Hono middlewares                              |
+| **Typed context**      | Augment `ContextVariableMap` once, `c.get("user")` typed everywhere |
+| **CLI**                | `init` / `new` (interactive) / `gen`                                |
 
 Full documentation: [frs.lpdjs.fr/guide/hono](https://frs.lpdjs.fr/guide/hono)
 
@@ -446,9 +459,18 @@ export const { functions } = servers.sync({
 
 // Spread Cloud Functions into your exports
 export const {
-  users_onCreate, users_onUpdate, users_onDelete, sync_users,
-  posts_onCreate, posts_onUpdate, posts_onDelete, sync_posts,
-  comments_onCreate, comments_onUpdate, comments_onDelete, sync_comments,
+  users_onCreate,
+  users_onUpdate,
+  users_onDelete,
+  sync_users,
+  posts_onCreate,
+  posts_onUpdate,
+  posts_onDelete,
+  sync_posts,
+  comments_onCreate,
+  comments_onUpdate,
+  comments_onDelete,
+  sync_comments,
   adminsync,
 } = functions;
 ```
@@ -488,7 +510,6 @@ Firestore emulator runs on `localhost:8080`, UI on `http://localhost:4000`.
 
 MIT
 
-
 ## Installation
 
 ```bash
@@ -579,20 +600,23 @@ if (post) {
 }
 
 // Update
-const updated = await repos.users.update("user123", { name: "New name", age: 31 });
+const updated = await repos.users.update("user123", {
+  name: "New name",
+  age: 31,
+});
 ```
 
 ## API reference
 
 ### `createRepositoryConfig()`
 
-| Option        | Description                                             |
-| ------------- | ------------------------------------------------------- |
-| `path`        | Collection path in Firestore                            |
-| `isGroup`     | `true` for collection group, `false` for simple         |
-| `foreignKeys` | Keys for `get.by*` methods (single document lookup)     |
-| `queryKeys`   | Keys for `query.by*` methods (multi-document query)     |
-| `refCb`       | Function that returns the document reference            |
+| Option        | Description                                         |
+| ------------- | --------------------------------------------------- |
+| `path`        | Collection path in Firestore                        |
+| `isGroup`     | `true` for collection group, `false` for simple     |
+| `foreignKeys` | Keys for `get.by*` methods (single document lookup) |
+| `queryKeys`   | Keys for `query.by*` methods (multi-document query) |
+| `refCb`       | Function that returns the document reference        |
 
 **Sub-collection example:**
 
@@ -611,8 +635,8 @@ comments: createRepositoryConfig<CommentModel>()({
 
 ```typescript
 interface QueryOptions<T> {
-  where?: [keyof T, WhereFilterOp, any][];      // AND conditions
-  orWhere?: [keyof T, WhereFilterOp, any][][];  // OR conditions
+  where?: [keyof T, WhereFilterOp, any][]; // AND conditions
+  orWhere?: [keyof T, WhereFilterOp, any][][]; // OR conditions
   orderBy?: { field: keyof T; direction?: "asc" | "desc" }[];
   limit?: number;
   offset?: number;
@@ -703,7 +727,9 @@ const page = await repos.posts.query.paginate({
 ```typescript
 import { count, sum, average } from "@lpdjs/firestore-repo-service";
 
-const activeCount = await repos.users.aggregate.count({ where: [["isActive", "==", true]] });
+const activeCount = await repos.users.aggregate.count({
+  where: [["isActive", "==", true]],
+});
 const totalViews = await repos.posts.aggregate.sum("views");
 const avgAge = await repos.users.aggregate.average("age");
 ```
@@ -714,7 +740,9 @@ const avgAge = await repos.users.aggregate.average("age");
 const result = await repos.users.transaction.run(async (txn) => {
   const user = await txn.get(repos.users.documentRef("user123"));
   if (user.exists()) {
-    txn.update(repos.users.documentRef("user123"), { age: user.data().age + 1 });
+    txn.update(repos.users.documentRef("user123"), {
+      age: user.data().age + 1,
+    });
   }
   return { success: true };
 });
@@ -726,8 +754,14 @@ const result = await repos.users.transaction.run(async (txn) => {
 // (status = 'active' AND age >= 18) OR (status = 'pending' AND verified = true)
 const users = await repos.users.query.by({
   orWhere: [
-    [["status", "==", "active"], ["age", ">=", 18]],
-    [["status", "==", "pending"], ["verified", "==", true]],
+    [
+      ["status", "==", "active"],
+      ["age", ">=", 18],
+    ],
+    [
+      ["status", "==", "pending"],
+      ["verified", "==", true],
+    ],
   ],
 });
 ```
@@ -798,9 +832,18 @@ export const { functions } = servers.sync({
 
 // Spread Cloud Functions into your exports
 export const {
-  users_onCreate, users_onUpdate, users_onDelete, sync_users,
-  posts_onCreate, posts_onUpdate, posts_onDelete, sync_posts,
-  comments_onCreate, comments_onUpdate, comments_onDelete, sync_comments,
+  users_onCreate,
+  users_onUpdate,
+  users_onDelete,
+  sync_users,
+  posts_onCreate,
+  posts_onUpdate,
+  posts_onDelete,
+  sync_posts,
+  comments_onCreate,
+  comments_onUpdate,
+  comments_onDelete,
+  sync_comments,
   adminsync,
 } = functions;
 ```
@@ -837,4 +880,3 @@ Firestore emulator runs on `localhost:8080`, UI on `http://localhost:4000`.
 ## License
 
 MIT
-

package/dist/servers/hono/cli.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-'use strict';var path=require('path'),fs=require('fs'),promises=require('readline/promises'),process$1=require('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=fs.readdirSync(s);}catch{return}for(let i of o){if(t.excludeSegments.includes(i))continue;let a=path.join(s,i),n;try{n=fs.statSync(a);}catch{continue}if(n.isDirectory())q(e,a,t,r);else if(n.isFile()&&i===t.routesFile){let l=path.relative(e,a).split(path.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=path.dirname(s.outFile);fs.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"}.
+'use strict';var fs=require('fs'),path=require('path'),process$1=require('process'),promises=require('readline/promises');var _={skipSegments:["useCases","useCase","use-cases","use-case"],casing:"preserve"};function L(e,s=_){let t=new Set(s.skipSegments.map(r=>r.toLowerCase()));return "/"+e.split("/").filter(Boolean).filter(r=>!t.has(r.toLowerCase())).map(r=>s.casing==="kebab"?Y(r):r).join("/")}function Y(e){return e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/[\s_]+/g,"-").toLowerCase()}function U(e,s,t){let o=N(e),r=N(s),n=0;for(;n<o.length&&n<r.length&&o[n]===r[n];)n++;let a=o.length-n,i=r.slice(n),u=(i[i.length-1]??"").replace(/\.[mc]?[tj]sx?$/i,""),d=t===""?u:`${u}${t}`;return i[i.length-1]=d,(a===0?"./":"../".repeat(a))+i.join("/")}function N(e){return e.replace(/\\/g,"/").replace(/\/+$/,"").split("/").filter((t,o)=>!(o===0&&t===""))}var ee="/**\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 B(e,s){let t=path.dirname(s.outFile);fs.mkdirSync(t,{recursive:true});let o=s.banner??ee,r=(s.now??new Date).toISOString(),n=s.importExtension,a=[],i=[],c=[];e.forEach((d,f)=>{let h=U(t,d.absPath,n),v=L(d.relDir,s.derive);a.push(`import mod${f} from ${JSON.stringify(h)};`),i.push(`  { __derivedPath: ${JSON.stringify(v)}, mod: mod${f} },`),c.push({source:d.relPath,url:v});});let u=`${o}// Generated at ${r} \u2014 ${e.length} route file${e.length===1?"":"s"}.
 
 import type { AnyRouteDef, RouteModuleDefault } from "@lpdjs/firestore-repo-service/servers/hono";
 
@@ -8,25 +8,29 @@ import type { AnyRouteDef, RouteModuleDefault } from "@lpdjs/firestore-repo-serv
 
 `:`
 `)+`const __defs: { __derivedPath: string; mod: RouteModuleDefault }[] = [
-`+n.join(`
-`)+(n.length?`
+`+i.join(`
+`)+(i.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(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 fs.writeFileSync(s.outFile,u,"utf8"),{outFile:s.outFile,routeCount:e.length,derivedPaths:c}}var A={routesFile:"routes.ts",excludeSegments:["node_modules","__generated__","tests","__tests__",".turbo","dist","build",".next"]};function G(e,s=A){let t=[];return z(e,e,s,t),t.sort((o,r)=>o.relPath.localeCompare(r.relPath)),t}function z(e,s,t,o){let r;try{r=fs.readdirSync(s);}catch{return}for(let n of r){if(t.excludeSegments.includes(n))continue;let a=path.join(s,n),i;try{i=fs.statSync(a);}catch{continue}if(i.isDirectory())z(e,a,t,o);else if(i.isFile()&&n===t.routesFile){let c=path.relative(e,a).split(path.sep).join("/"),u=c.replace(/\/?[^/]+$/,"");o.push({absPath:a,relPath:c,relDir:u});}}}function pe(e){let[s,...t]=e,o={};for(let r=0;r<t.length;r++){let n=t[r];if(!n.startsWith("--"))continue;let a=n.slice(2),i=t[r+1];i&&!i.startsWith("--")?(o[a]=i,r++):o[a]=true;}return {command:s??"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 +65,189 @@ 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||!process$1.stdin.isTTY)return {ask:async(t,r)=>r??"",askChoice:async(t,r,o)=>o??"",askBool:async(t,r)=>r,close:()=>{}};let s=promises.createInterface({input:process$1.stdin,output:process$1.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=path.resolve(process.cwd(),s);fs.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:path.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=path.resolve(process.cwd(),a),$=path.resolve(y,i,d,o),P=path.resolve($,"routes.ts"),A=path.resolve($,"useCase.ts"),k=path.resolve($,"useCase.test.ts");fs.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(s=>s.trim()).filter(Boolean)}function l(e){return typeof e=="string"?e:void 0}function K(e){if(e||!process$1.stdin.isTTY)return {ask:async(t,o)=>o??"",askChoice:async(t,o,r)=>r??"",askBool:async(t,o)=>o,close:()=>{}};let s=promises.createInterface({input:process$1.stdin,output:process$1.stdout});return {async ask(t,o){let r=o?` (${o})`:"";return (await s.question(`? ${t}${r} \u203A `)).trim()||o||""},async askChoice(t,o,r){let n=` [${o.join("/")}${r?`, default: ${r}`:""}]`;for(;;){let a=(await s.question(`? ${t}${n} \u203A `)).trim().toLowerCase();if(!a&&r)return r;if(o.includes(a))return a;console.log(`  invalid choice \u2014 pick one of: ${o.join(", ")}`);}},async askBool(t,o){let r=` (${o?"Y/n":"y/N"})`,n=(await s.question(`? ${t}${r} \u203A `)).trim().toLowerCase();return n?n==="y"||n==="yes"||n==="true":o},close:()=>s.close()}}async function ue(e){let s=l(e.root);s||(console.error("[frs] --root is required"),process.exit(2));let t=path.resolve(process.cwd(),s);fs.existsSync(t)||(console.error(`[frs] root not found: ${t}`),process.exit(2));let o=l(e.out)??"__generated__/routes.ts",r=W(e.skip)??_.skipSegments,n=l(e.casing)==="kebab"?"kebab":_.casing,a={skipSegments:r,casing:n},i=l(e.ext)??".js",c=W(e.exclude)??A.excludeSegments,u=l(e["routes-file"])??A.routesFile,f=G(t,{routesFile:u,excludeSegments:c});f.length===0&&console.warn(`[frs] no "${u}" files found under ${t} \u2014 generated an empty manifest.`);let h=B(f,{outFile:path.resolve(t,o),derive:a,importExtension:i});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 le(e,s){let t=s.yes===true,o=K(t);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 n=l(s.domain);n||(n=(await o.ask("Domain name (e.g. posts)")).trim(),n||(console.error("[frs] --domain is required"),process.exit(2)));let a=l(s.root)??"src/domains",i=l(s.method)?.toLowerCase();i||(i=await o.askChoice("HTTP method",["get","post","put","patch","delete"],"post")),["get","post","put","patch","delete"].includes(i)||(console.error(`[frs] invalid --method: ${i}`),process.exit(2));let c=l(s.api);c||(c=(await o.ask("API tag","v1")).trim()||"v1");let u=l(s["usecase-folder"])??"useCases",d=s["with-usecase"]===void 0?t?!0:await o.askBool("Scaffold useCase.ts?",!0):s["with-usecase"]!==!1,f=s["with-test"]===void 0?t||!d?d:await o.askBool("Scaffold useCase.test.ts (Vitest)?",!0):s["with-test"]!==!1,h=s.force===!0,v=path.resolve(process.cwd(),a),y=path.resolve(v,n,u,r),$=path.resolve(y,"routes.ts"),b=path.resolve(y,"useCase.ts"),x=path.resolve(y,"useCase.test.ts");fs.mkdirSync(y,{recursive:!0});let m=`${r.charAt(0).toUpperCase()}${r.slice(1)}UseCase`,k=`/**
+ * ${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({
+`,D=i==="get"?`z.object({
     // GET \u2192 lu depuis les query params
     example: z.string(),
   })`:`z.object({
-    // ${n.toUpperCase()} \u2192 lu depuis le body JSON
+    // ${i.toUpperCase()} \u2192 lu depuis le body JSON
     example: z.string(),
-  })`,D=c?`    const useCase = new ${f}();
+  })`,S=d?`    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 };`,j=d?`import { ${m} } from "./useCase.js";
+`:"",I=`import { z } from "zod";
+import { defineRoute } from "${l(s["apis-import"])??me(v,y)}";
+${j}
 export default defineRoute({
-  api: "${l}",
-  method: "${n}",
+  api: "${c}",
+  method: "${i}",
 
-  input: ${C},
+  input: ${D},
 
   output: z.object({
     id: z.string(),
   }),
 
-  summary: "TODO: ${o}",
-  tags: ["${i}"],
+  summary: "TODO: ${r}",
+  tags: ["${n}"],
 
   handler: async ({ input }) => {
-${D}
+${S}
   },
 });
-`,j=[],F=[],O=(v,Y)=>{if(fs.existsSync(v)&&!g){F.push(v);return}fs.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";
+`,p=[],C=[],E=(w,V)=>{if(fs.existsSync(w)&&!h){C.push(w);return}fs.writeFileSync(w,V,"utf8"),p.push(w);};if(E($,I),d&&E(b,k),d&&f){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=path.resolve(process.cwd(),o),c=path.resolve(process.cwd(),i),h=path.resolve(d,"__generated__"),g=path.resolve(h,"routes.ts"),y=[],$=[],P=(u,x)=>{if(fs.mkdirSync(path.dirname(u),{recursive:!0}),fs.existsSync(u)&&!r){$.push(u);return}fs.writeFileSync(u,x,"utf8"),y.push(u);},k=`import { createApiRegistry } from "@lpdjs/firestore-repo-service/servers/hono";
+`;E(x,w);}for(let w of p)console.log(`[frs] wrote   ${w}`);for(let w of C)console.log(`[frs] skipped ${w} (use --force to overwrite)`);console.log(`
+[frs] reminder: run "frs gen --root ${a}" to refresh the manifest.`);}finally{o.close();}}async function de(e){let s=e.yes===true,t=K(s);try{let o=e.force===!0,r=l(e.root);r||(r=(await t.ask("Domain root","src/domains")).trim()||"src/domains");let n=l(e["apis-file"]);n||(n=(await t.ask("apis.ts location","src/apis.ts")).trim()||"src/apis.ts");let a=l(e["services-file"]);if(!a){let p=n.replace(/apis\.ts$/,"services.ts")||"src/services.ts";a=(await t.ask("services.ts location",p)).trim()||p;}let i=l(e.apis);i||(i=(await t.ask("API tags (comma-separated)","v1")).trim()||"v1");let c=i.split(",").map(p=>p.trim()).filter(Boolean);c.length===0&&(console.error("[frs] at least one API tag is required"),process.exit(2));let u=l(e["base-path"]),d=path.resolve(process.cwd(),r),f=path.resolve(process.cwd(),n),h=path.resolve(process.cwd(),a),v=path.resolve(d,"__generated__"),y=path.resolve(v,"routes.ts"),$=[],b=[],x=(p,C)=>{if(fs.mkdirSync(path.dirname(p),{recursive:!0}),fs.existsSync(p)&&!o){b.push(p);return}fs.writeFileSync(p,C,"utf8"),$.push(p);},m=c.map(p=>{let C=u??`/${p}`;return `    ${p}: {
+      basePath: "${C}",
+      openapi: {
+        info: { title: "${p.toUpperCase()} API", version: "1.0.0", description: "" },
+      },
+      verbose: process.env["NODE_ENV"] !== "production",
+    },`}).join(`
+`),k=`import { createApiRegistry } from "@lpdjs/firestore-repo-service/servers/hono";
+import { services } from "${O(path.dirname(f),h)}";
 
 /**
  * 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(f,k),x(h,`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.
+ *
+ * @example
+ * \`\`\`ts
+ * postRepo: () => new PostRepo(),
+ * createPostUseCase: ({ ctx, postRepo }) =>
+ *   new CreatePostUseCase(ctx, postRepo),
+ * \`\`\`
+ */
+export const services = createServices({
+  // TODO: declare your services here.
+  // Example:
+  //   db: () => getFirestore(),
+  //   postRepo: ({ db }) => new PostRepo(db),
+});
+
+/** Convenience type \u2014 \`function fn(svc: Services) { ... }\`. */
+export type Services = typeof services;
+`);let S=`// 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(path.dirname(c),c),C=z(path.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(y,S);let j=O(path.dirname(f),f),q=O(path.dirname(f),y),I=c.length===1?`export const { ${c[0]} } = apis.toFunctions(routes, onRequest, {`:`export const { ${c.join(", ")} } = apis.toFunctions(routes, onRequest, {`;for(let p of $)console.log(`[frs] wrote   ${p}`);for(let p of b)console.log(`[frs] skipped ${p} (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 "${j}";
+   import { routes } from "${q}";
 
-   ${D}
+   ${I}
      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 ${c[0]}
 
 3. Refresh the manifest before each build:
 
-   frs-hono gen --root ${o}
-`);}finally{t.close();}}function z(e,s){let t=path.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,path.dirname(e),path.dirname(path.dirname(e))];for(let o of r)for(let i of t){let a=path.resolve(o,i);if(fs.existsSync(a)){let n=path.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.cjs.map
+   frs gen --root ${r}
+`);}finally{t.close();}}function O(e,s){let t=path.relative(e,s).replace(/\\/g,"/");return t=t.replace(/\.ts$/,".js"),t.startsWith(".")||(t=`./${t}`),t}async function fe(e,s,t){e!=="service"&&(console.error(`[frs] unknown "add" target: ${e??"(missing)"} \u2014 supported: service`),process.exit(2)),s||(console.error("[frs] service name is required: frs add service <name>"),process.exit(2));let o=t.force===true,r=l(t["services-file"])??"src/services.ts",n=path.resolve(process.cwd(),r),a=l(t["services-dir"])??path.resolve(path.dirname(n),"services"),i=path.resolve(process.cwd(),a);fs.existsSync(n)||(console.error(`[frs] services file not found: ${n}
+      Run \`frs init\` first or pass --services-file <path>.`),process.exit(2)),fs.mkdirSync(i,{recursive:true});let c=`${s.charAt(0).toUpperCase()}${s.slice(1)}Service`,u=path.resolve(i,`${s}.ts`),d=`/**
+ * ${c} \u2014 generated by \`frs add service ${s}\`.
+ *
+ * Singleton instantiated lazily on first access. Async resources (DB
+ * connections, SDK clients) should be lazy-loaded inside the class:
+ *
+ * @example
+ * \`\`\`ts
+ * private _client: SomeClient | undefined;
+ * get client(): SomeClient {
+ *   return (this._client ??= new SomeClient({...}));
+ * }
+ * \`\`\`
+ */
+export class ${c} {
+  // TODO: add fields, methods, dependencies.
+  hello(): string {
+    return "hello from ${s}";
+  }
+}
+`;fs.existsSync(u)&&!o?console.log(`[frs] skipped ${u} (use --force to overwrite)`):(fs.writeFileSync(u,d,"utf8"),console.log(`[frs] wrote   ${u}`));let f=fs.readFileSync(n,"utf8"),h=O(path.dirname(n),u),v=`import { ${c} } from "${h}";`,y=`  ${s}: () => new ${c}(),`;if(f.includes(v)){console.log(`[frs] services.ts already registers "${s}" \u2014 skipping.`);return}let $=f.split(`
+`),b=-1;for(let S=0;S<$.length;S++)/^import\s/.test($[S])&&(b=S);b>=0?$.splice(b+1,0,v):$.unshift(v);let x=$.join(`
+`),m=x.match(/createServices\s*\(\s*\{/);if(!m){console.error(`[frs] could not find \`createServices({\` in ${n} \u2014 register "${s}" manually.`);return}let k=m.index+m[0].length,D=x.slice(0,k)+`
+`+y+x.slice(k);fs.writeFileSync(n,D,"utf8"),console.log(`[frs] updated ${n}  (+ ${s})`);}function me(e,s){let t=["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 n of t){let a=path.resolve(r,n);if(fs.existsSync(a)){let i=path.relative(s,a).replace(/\\/g,"/");return i=i.replace(/\.ts$/,".js").replace(/\.js$/,".js"),i.startsWith(".")||(i=`./${i}`),i}}return "../../../../apis.js"}async function ge(){let e=process.argv.slice(2),{command:s,flags:t}=pe(e);switch(s){case "init":await de(t);return;case "gen":await ue(t);return;case "new":await le(e[1],t);return;case "add":await fe(e[1],e[2],t);return;case "help":case "--help":case "-h":H();return;default:console.error(`[frs] unknown command: ${s}
+`),H(),process.exit(2);}}ge().catch(e=>{console.error(e),process.exit(1);});//# sourceMappingURL=cli.cjs.map
 //# sourceMappingURL=cli.cjs.map