@forinda/kickjs-cli 8.7.9 → 8.9.0

package/dist/{builtins-DrRpYzbB.mjs → builtins-DiWfXc-D.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.7.9
+ * @forinda/kickjs-cli v8.9.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,7 +8,7 @@
  *
  * @license MIT
  */
-import{t as e}from"./rolldown-runtime-D4R0ptAp.mjs";import{c as t,i as n,l as r,o as i,p as a,r as o,s,t as c}from"./project-6r0RJYMr.mjs";import{a as l,c as u,i as d,l as f,o as p,r as m,s as h}from"./config-kVPKaftt.mjs";import{n as g,r as _}from"./plugin-C77kofvz.mjs";import{n as v,r as y,t as b}from"./fs-DeTT9ZK-.mjs";import{a as x,c as S,d as ee,f as C,i as te,l as ne,n as re,o as ie,p as ae,r as w,s as T,u as oe}from"./agent-docs-Ep7kO8om.mjs";import{t as E}from"./project-root-Cw17cNBj.mjs";import{C as se,S as ce,_ as le,a as ue,b as de,c as fe,d as pe,f as me,g as he,h as ge,i as _e,l as ve,m as ye,o as be,p as xe,r as Se,s as Ce,t as we,u as Te,v as Ee,w as De,x as D,y as Oe}from"./typegen-vfWafXuR.mjs";import{t as ke}from"./build-NKAoV4wt.mjs";import{createRequire as Ae}from"node:module";import{cpSync as je,existsSync as O,mkdirSync as Me,readFileSync as k,readdirSync as A,rmSync as Ne,statSync as Pe,writeFileSync as Fe}from"node:fs";import j,{basename as Ie,dirname as M,join as N,relative as P,resolve as F,sep as Le}from"node:path";import{fileURLToPath as Re,pathToFileURL as I}from"node:url";import{fork as ze,spawn as Be,spawnSync as Ve}from"node:child_process";import{copyFile as He,mkdir as Ue,readFile as L,readdir as We,rm as Ge,stat as Ke,writeFile as R}from"node:fs/promises";import"@forinda/kickjs-cli-kit";import{parseSync as qe}from"oxc-parser";import Je from"pluralize";import{arch as Ye,platform as Xe,release as Ze}from"node:os";import{createHash as Qe}from"node:crypto";const $e=[{value:`swagger`,label:`Swagger`,hint:`OpenAPI docs`},{value:`ws`,label:`WebSocket`,hint:`rooms, heartbeat`},{value:`queue`,label:`Queue`,hint:`BullMQ/RabbitMQ/Kafka`},{value:`devtools`,label:`DevTools`,hint:`debug dashboard`}];function et(e){e.command(`new [name]`).alias(`init`).description(`Create a new KickJS project (use "." for current directory)`).option(`-d, --directory <dir>`,`Target directory (defaults to project name)`).option(`--pm <manager>`,`Package manager: pnpm | npm | yarn | bun`).option(`--git`,`Initialize git repository`).option(`--no-git`,`Skip git initialization`).option(`--install`,`Install dependencies after scaffolding`).option(`--no-install`,`Skip dependency installation`).option(`-f, --force`,`Remove existing files without prompting`).option(`-t, --template <type>`,`Project template: rest | minimal | fullstack`).option(`--runtime <engine>`,`HTTP runtime: express | fastify | h3`).option(`-r, --repo <type>`,`Repository name (inmemory, or any DB name e.g. postgres)`).option(`-s, --schema <lib>`,`Schema library for env / DTOs: zod | valibot | yup (default: zod)`).option(`--frontend <kind>`,`Fullstack web/ scaffold: 'kick' (wired React app) or 'vite' (create-vite, unwired)`).option(`--vite-template <name>`,`create-vite TypeScript template for --frontend vite (default 'react-ts')`).option(`--packages <packages>`,`Comma-separated packages to include (e.g. swagger,ws,queue,devtools)`).option(`-y, --yes`,`Pick safe defaults for every prompt (template=minimal, repo=inmemory, no extras, git+install on)`).option(`--non-interactive`,`alias for --yes`).action(async(e,t)=>{te(`KickJS — Create a new project`);let n=!!(t.yes||t.nonInteractive);e||=n?`my-api`:await oe({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let i;if(e===`.`?(i=F(`.`),e=Ie(i)):i=F(t.directory||e),O(i)){let r=A(i);if(r.length>0){if(t.force)x.warn(`Clearing existing files in ${i}`);else if(n){x.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),T(`Aborted.`);return}else{x.warn(`Directory "${e}" is not empty:`);let t=r.slice(0,5);for(let e of t)x.message(`  - ${e}`);if(r.length>5&&x.message(`  ... and ${r.length-5} more`),!await w({message:C.red(`Remove all existing files and proceed?`),initialValue:!1})){T(`Aborted.`);return}}for(let e of r)Ne(F(i,e),{recursive:!0,force:!0})}}let a=t.template;a||=n?`minimal`:await S({message:`Project template`,options:[{value:`rest`,label:`REST API`,hint:`Express + Swagger`},{value:`minimal`,label:`Minimal`,hint:`bare Express`},{value:`fullstack`,label:`Fullstack`,hint:`server + Vite React web, typed client`}]});let o=t.runtime;o||=n?`express`:await S({message:`HTTP runtime`,options:[{value:`express`,label:`Express`,hint:`default, zero-config`},{value:`fastify`,label:`Fastify`,hint:`fastify + @fastify/middie`},{value:`h3`,label:`h3`,hint:`Nitro / Nuxt engine`}]});let s=t.pm;s||=n?await r(void 0):await S({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let l=t.repo;l||=n?`inmemory`:await oe({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),f(l);let u=t.schema;u||=n?`zod`:await S({message:`Schema library (env + DTO validation)`,options:[{value:`zod`,label:`Zod`,hint:`default — broad ecosystem`},{value:`valibot`,label:`Valibot`,hint:`smaller bundle`},{value:`yup`,label:`Yup`,hint:`classic API`}]}),[`zod`,`valibot`,`yup`].includes(u)||(x.warn(`Unknown --schema "${u}", falling back to zod.`),u=`zod`);let d;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();d=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else d=n?[]:await ie({message:`Select packages to include`,options:[...$e],required:!1});let p;p=t.git===void 0?n?!0:await w({message:`Initialize git repository?`,initialValue:!0}):t.git;let m;if(m=t.install===void 0?n?!0:await w({message:`Install dependencies?`,initialValue:!0}):t.install,t.frontend!==void 0&&t.frontend!==`kick`&&t.frontend!==`vite`){x.error(`Unknown --frontend '${String(t.frontend)}'. Use 'kick' (wired React app) or 'vite' (create-vite).`),T(`Aborted.`);return}let{VITE_TEMPLATES:h,DEFAULT_VITE_TEMPLATE:g}=await import(`./fullstack-s_aMeFzj.mjs`);if(t.viteTemplate!==void 0&&!h.some(e=>e.value===t.viteTemplate)){x.error(`Unknown --vite-template '${String(t.viteTemplate)}'. TypeScript templates only: ${h.map(e=>e.value).join(`, `)}.`),T(`Aborted.`);return}let _=t.frontend===`vite`?`vite`:`kick`,v=t.viteTemplate??g;if(a===`fullstack`&&!t.frontend&&!n&&(_=await S({message:`Frontend for web/`,options:[{value:`kick`,label:`KickJS React app`,hint:`typed client, /api proxy, route types — wired`},{value:`vite`,label:`Delegate to create-vite`,hint:`pick any framework; wiring is manual (guide printed after)`}]})),_===`vite`&&!t.viteTemplate&&!n&&(v=await S({message:`create-vite template`,options:h.map(e=>({value:e.value,label:e.label})),initialValue:g})),a===`fullstack`){let{initFullstackProject:t}=await import(`./fullstack-s_aMeFzj.mjs`);await t({name:e,directory:i,packageManager:s,initGit:p,installDeps:m,schemaLib:u,runtime:o,packages:d,frontend:_,viteTemplate:v}),T(`Done! Next steps: ${C.cyan(`cd ${e} && ${s}${s===`pnpm`?` dev`:` run dev:server`}`)}`);return}await c({name:e,directory:i,packageManager:s,initGit:p,installDeps:m,template:a,defaultRepo:l,packages:d,schemaLib:u,runtime:o}),T(`Done! Next steps: ${C.cyan(`cd ${e} && ${s} dev`)}`)})}function z(e){return e.replace(/[-_\s]+(.)?/g,(e,t)=>t?t.toUpperCase():``).replace(/^(.)/,e=>e.toUpperCase())}function B(e){let t=z(e);return t.charAt(0).toLowerCase()+t.slice(1)}function V(e){return e.replace(/([a-z])([A-Z])/g,`$1-$2`).replace(/[\s_]+/g,`-`).toLowerCase()}function H(e){return Je.plural(e)}function tt(e){return Je.plural(e)}function nt(e){return V(e).replace(/-/g,`_`)}function rt(e){let t=e.cwd??process.cwd(),n=e.projectRoot??E(t),r=e.pluralize??!0,i=z(e.name),a=B(e.name),o=V(e.name),s=nt(e.name),c={name:e.name,pascal:i,camel:a,kebab:o,snake:s,modulesDir:e.modulesDir??`src/modules`,cwd:t,projectRoot:n,args:e.args??[],flags:e.flags??{}};if(r){let e=H(o);c.pluralKebab=e,c.pluralPascal=z(e),c.pluralCamel=B(e)}return c}function it(e,t){return F(e.cwd,t)}async function at(e){return import(I(e).href)}const ot=new Map;async function st(e){let t=ot.get(e);if(t)return t;let n=ct(e);return ot.set(e,n),n}async function ct(e){let t=F(e,`package.json`);if(!O(t))return{generators:[],loaded:[],failed:[]};let n=lt(JSON.parse(await L(t,`utf-8`))),r=Ae(F(e,`package.json`)),i=[],a=[],o=[];for(let e of n){let t;try{t=r.resolve(`${e}/package.json`)}catch{continue}let n;try{n=JSON.parse(await L(t,`utf-8`))}catch(t){o.push({source:e,reason:`failed to parse package.json: ${t}`});continue}if(!n.kickjs?.generators)continue;let s=n.kickjs.generators,c=F(M(t),s);if(!O(c)){o.push({source:e,reason:`kickjs.generators points to missing file: ${s}`});continue}let l;try{l=await at(c)}catch(t){o.push({source:e,reason:`failed to import manifest: ${t}`});continue}let u=l.default;if(!Array.isArray(u)){o.push({source:e,reason:`manifest's default export is not an array of GeneratorSpec`});continue}for(let t of u){if(!ut(t)){o.push({source:e,reason:`manifest entry is not a valid GeneratorSpec (missing name/files)`});continue}i.push({source:e,spec:t})}a.push(e)}return{generators:i,loaded:a,failed:o}}function lt(e){let t=new Set;for(let n of[e.dependencies,e.devDependencies,e.peerDependencies])if(n)for(let e of Object.keys(n))t.add(e);return Array.from(t)}function ut(e){if(!e||typeof e!=`object`)return!1;let t=e;return typeof t.name==`string`&&typeof t.files==`function`}async function dt(e,t=[]){let n=e.cwd??process.cwd(),r=t.find(t=>t.spec.name===e.generatorName);if(r)return mt(r.spec,r.source,e,n);let i=pt(await st(n),e.generatorName);return i?mt(i.spec,i.source,e,n):null}async function ft(e,t=[]){let n=await st(e),r=new Set(t.map(e=>e.spec.name)),i=n.generators.filter(e=>!r.has(e.spec.name));return{generators:[...t,...i],loaded:n.loaded,failed:n.failed}}function pt(e,t){return e.generators.find(e=>e.spec.name===t)}async function mt(e,t,n,r){let i=rt({name:n.itemName,args:n.args,flags:n.flags,modulesDir:n.modulesDir,pluralize:n.pluralize,cwd:r,projectRoot:n.projectRoot}),a=await e.files(i),o=[];for(let e of a){let t=it(i,e.path);await y(t,e.content),o.push(t)}return{files:o,source:t}}function U(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}const ht={inmemory:`in-memory`,drizzle:`Drizzle`,prisma:`Prisma`};function gt(e){return e.charAt(0).toUpperCase()+e.slice(1).replace(/-([a-z])/g,(e,t)=>t.toUpperCase())}function _t(e){return ht[e]??gt(e)}function vt(e){return`create${e}Repository`}function yt(e){return e??`define`}function bt(e){let{pascal:t,kebab:n,plural:r=``,repo:i,style:a}=e,o=vt(t),s=yt(a),c=`/**
+import{t as e}from"./rolldown-runtime-Da-NDvKz.mjs";import{c as t,g as n,i as r,l as i,o as a,r as o,s,t as c}from"./project-Bp-KfBNb.mjs";import{a as l,c as u,i as d,l as f,o as p,r as m,s as h}from"./config-YvIngROH.mjs";import{n as g,r as _}from"./plugin-BfdvW6_r.mjs";import{n as v,r as y,t as b}from"./fs-Bm2St4gk.mjs";import{a as x,c as S,d as ee,f as C,i as te,l as ne,n as re,o as ie,p as ae,r as oe,s as w,u as se}from"./agent-docs-bVMPt2m5.mjs";import{t as T}from"./project-root-LYOxQHXp.mjs";import{C as ce,S as le,_ as ue,a as de,b as fe,c as pe,d as me,f as he,g as ge,h as _e,i as ve,l as ye,m as be,o as xe,p as Se,r as Ce,s as we,t as Te,u as Ee,v as De,w as Oe,x as E,y as ke}from"./typegen-up-UkaNc.mjs";import{t as Ae}from"./build-xQXbdDpw.mjs";import{createRequire as je}from"node:module";import{cpSync as Me,existsSync as D,mkdirSync as Ne,readFileSync as O,readdirSync as k,rmSync as Pe,statSync as Fe,writeFileSync as A}from"node:fs";import j,{basename as Ie,dirname as M,join as N,relative as P,resolve as F,sep as I}from"node:path";import{fileURLToPath as Le,pathToFileURL as L}from"node:url";import{fork as Re,spawn as ze,spawnSync as Be}from"node:child_process";import{copyFile as Ve,mkdir as He,readFile as R,readdir as Ue,rm as We,stat as Ge,writeFile as z}from"node:fs/promises";import"@forinda/kickjs-cli-kit";import{createHash as Ke}from"node:crypto";import{parseSync as qe}from"oxc-parser";import Je from"pluralize";import{arch as Ye,platform as Xe,release as Ze}from"node:os";const Qe=[{value:`swagger`,label:`Swagger`,hint:`OpenAPI docs`},{value:`ws`,label:`WebSocket`,hint:`rooms, heartbeat`},{value:`queue`,label:`Queue`,hint:`BullMQ/RabbitMQ/Kafka`},{value:`devtools`,label:`DevTools`,hint:`debug dashboard`}];function $e(e){e.command(`new [name]`).alias(`init`).description(`Create a new KickJS project (use "." for current directory)`).option(`-d, --directory <dir>`,`Target directory (defaults to project name)`).option(`--pm <manager>`,`Package manager: pnpm | npm | yarn | bun`).option(`--git`,`Initialize git repository`).option(`--no-git`,`Skip git initialization`).option(`--install`,`Install dependencies after scaffolding`).option(`--no-install`,`Skip dependency installation`).option(`-f, --force`,`Remove existing files without prompting`).option(`-t, --template <type>`,`Project template: rest | minimal | fullstack | inertia`).option(`--runtime <engine>`,`HTTP runtime: express | fastify | h3`).option(`-r, --repo <type>`,`Repository name (inmemory, or any DB name e.g. postgres)`).option(`-s, --schema <lib>`,`Schema library for env / DTOs: zod | valibot | yup (default: zod)`).option(`--frontend <kind>`,`Fullstack web/ scaffold: 'kick' (wired React app) or 'vite' (create-vite, unwired)`).option(`--vite-template <name>`,`create-vite TypeScript template for --frontend vite (default 'react-ts')`).option(`--packages <packages>`,`Comma-separated packages to include (e.g. swagger,ws,queue,devtools)`).option(`-y, --yes`,`Pick safe defaults for every prompt (template=minimal, repo=inmemory, no extras, git+install on)`).option(`--non-interactive`,`alias for --yes`).action(async(e,t)=>{te(`KickJS — Create a new project`);let n=!!(t.yes||t.nonInteractive);e||=n?`my-api`:await se({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let r;if(e===`.`?(r=F(`.`),e=Ie(r)):r=F(t.directory||e),D(r)){let i=k(r);if(i.length>0){if(t.force)x.warn(`Clearing existing files in ${r}`);else if(n){x.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),w(`Aborted.`);return}else{x.warn(`Directory "${e}" is not empty:`);let t=i.slice(0,5);for(let e of t)x.message(`  - ${e}`);if(i.length>5&&x.message(`  ... and ${i.length-5} more`),!await oe({message:C.red(`Remove all existing files and proceed?`),initialValue:!1})){w(`Aborted.`);return}}for(let e of i)Pe(F(r,e),{recursive:!0,force:!0})}}let a=t.template;a||=n?`minimal`:await S({message:`Project template`,options:[{value:`rest`,label:`REST API`,hint:`Express + Swagger`},{value:`minimal`,label:`Minimal`,hint:`bare Express`},{value:`fullstack`,label:`Fullstack`,hint:`server + Vite React web, typed client`},{value:`inertia`,label:`Inertia`,hint:`server-driven React pages, one app, SSR`}]});let o=t.runtime;o||=n?`express`:await S({message:`HTTP runtime`,options:[{value:`express`,label:`Express`,hint:`default, zero-config`},{value:`fastify`,label:`Fastify`,hint:`fastify + @fastify/middie`},{value:`h3`,label:`h3`,hint:`Nitro / Nuxt engine`}]});let s=t.pm;s||=n?await i(void 0):await S({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let l=t.repo;l||=n?`inmemory`:await se({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),f(l);let u=t.schema;a===`inertia`&&(u&&u!==`zod`&&x.warn(`The inertia template uses zod — ignoring --schema ${u}.`),u=`zod`),u||=n?`zod`:await S({message:`Schema library (env + DTO validation)`,options:[{value:`zod`,label:`Zod`,hint:`default — broad ecosystem`},{value:`valibot`,label:`Valibot`,hint:`smaller bundle`},{value:`yup`,label:`Yup`,hint:`classic API`}]}),[`zod`,`valibot`,`yup`].includes(u)||(x.warn(`Unknown --schema "${u}", falling back to zod.`),u=`zod`);let d;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();d=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else d=n?[]:await ie({message:`Select packages to include`,options:[...Qe],required:!1});let p;p=t.git===void 0?n?!0:await oe({message:`Initialize git repository?`,initialValue:!0}):t.git;let m;if(m=t.install===void 0?n?!0:await oe({message:`Install dependencies?`,initialValue:!0}):t.install,t.frontend!==void 0&&t.frontend!==`kick`&&t.frontend!==`vite`){x.error(`Unknown --frontend '${String(t.frontend)}'. Use 'kick' (wired React app) or 'vite' (create-vite).`),w(`Aborted.`);return}let{VITE_TEMPLATES:h,DEFAULT_VITE_TEMPLATE:g}=await import(`./fullstack-CZ9XQYk-.mjs`);if(t.viteTemplate!==void 0&&!h.some(e=>e.value===t.viteTemplate)){x.error(`Unknown --vite-template '${String(t.viteTemplate)}'. TypeScript templates only: ${h.map(e=>e.value).join(`, `)}.`),w(`Aborted.`);return}let _=t.frontend===`vite`?`vite`:`kick`,v=t.viteTemplate??g;if(a===`fullstack`&&!t.frontend&&!n&&(_=await S({message:`Frontend for web/`,options:[{value:`kick`,label:`KickJS React app`,hint:`typed client, /api proxy, route types — wired`},{value:`vite`,label:`Delegate to create-vite`,hint:`pick any framework; wiring is manual (guide printed after)`}]})),_===`vite`&&!t.viteTemplate&&!n&&(v=await S({message:`create-vite template`,options:h.map(e=>({value:e.value,label:e.label})),initialValue:g})),a===`fullstack`){let{initFullstackProject:t}=await import(`./fullstack-CZ9XQYk-.mjs`);await t({name:e,directory:r,packageManager:s,initGit:p,installDeps:m,schemaLib:u,runtime:o,packages:d,frontend:_,viteTemplate:v}),w(`Done! Next steps: ${C.cyan(`cd ${e} && ${s}${s===`pnpm`?` dev`:` run dev:server`}`)}`)}else await c({name:e,directory:r,packageManager:s,initGit:p,installDeps:m,template:a,defaultRepo:l,packages:d,schemaLib:u,runtime:o}),w(`Done! Next steps: ${C.cyan(`cd ${e} && ${s} dev`)}`)})}function B(e){return e.replace(/[-_\s]+(.)?/g,(e,t)=>t?t.toUpperCase():``).replace(/^(.)/,e=>e.toUpperCase())}function V(e){let t=B(e);return t.charAt(0).toLowerCase()+t.slice(1)}function H(e){return e.replace(/([a-z])([A-Z])/g,`$1-$2`).replace(/[\s_]+/g,`-`).toLowerCase()}function U(e){return Je.plural(e)}function et(e){return Je.plural(e)}function tt(e){return H(e).replace(/-/g,`_`)}function nt(e){let t=e.cwd??process.cwd(),n=e.projectRoot??T(t),r=e.pluralize??!0,i=B(e.name),a=V(e.name),o=H(e.name),s=tt(e.name),c={name:e.name,pascal:i,camel:a,kebab:o,snake:s,modulesDir:e.modulesDir??`src/modules`,cwd:t,projectRoot:n,args:e.args??[],flags:e.flags??{}};if(r){let e=U(o);c.pluralKebab=e,c.pluralPascal=B(e),c.pluralCamel=V(e)}return c}function rt(e,t){return F(e.cwd,t)}async function it(e){return import(L(e).href)}const at=/* @__PURE__ */ new Map;async function ot(e){let t=at.get(e);if(t)return t;let n=st(e);return at.set(e,n),n}async function st(e){let t=F(e,`package.json`);if(!D(t))return{generators:[],loaded:[],failed:[]};let n=ct(JSON.parse(await R(t,`utf-8`))),r=je(F(e,`package.json`)),i=[],a=[],o=[];for(let e of n){let t;try{t=r.resolve(`${e}/package.json`)}catch{continue}let n;try{n=JSON.parse(await R(t,`utf-8`))}catch(t){o.push({source:e,reason:`failed to parse package.json: ${t}`});continue}if(!n.kickjs?.generators)continue;let s=n.kickjs.generators,c=F(M(t),s);if(!D(c)){o.push({source:e,reason:`kickjs.generators points to missing file: ${s}`});continue}let l;try{l=await it(c)}catch(t){o.push({source:e,reason:`failed to import manifest: ${t}`});continue}let u=l.default;if(!Array.isArray(u))o.push({source:e,reason:`manifest's default export is not an array of GeneratorSpec`});else{for(let t of u)lt(t)?i.push({source:e,spec:t}):o.push({source:e,reason:`manifest entry is not a valid GeneratorSpec (missing name/files)`});a.push(e)}}return{generators:i,loaded:a,failed:o}}function ct(e){let t=/* @__PURE__ */ new Set;for(let n of[e.dependencies,e.devDependencies,e.peerDependencies])if(n)for(let e of Object.keys(n))t.add(e);return Array.from(t)}function lt(e){if(!e||typeof e!=`object`)return!1;let t=e;return typeof t.name==`string`&&typeof t.files==`function`}async function ut(e,t=[]){let n=e.cwd??process.cwd(),r=t.find(t=>t.spec.name===e.generatorName);if(r)return pt(r.spec,r.source,e,n);let i=ft(await ot(n),e.generatorName);return i?pt(i.spec,i.source,e,n):null}async function dt(e,t=[]){let n=await ot(e),r=new Set(t.map(e=>e.spec.name)),i=n.generators.filter(e=>!r.has(e.spec.name));return{generators:[...t,...i],loaded:n.loaded,failed:n.failed}}function ft(e,t){return e.generators.find(e=>e.spec.name===t)}async function pt(e,t,n,r){let i=nt({name:n.itemName,args:n.args,flags:n.flags,modulesDir:n.modulesDir,pluralize:n.pluralize,cwd:r,projectRoot:n.projectRoot}),a=await e.files(i),o=[];for(let e of a){let t=rt(i,e.path);await y(t,e.content),o.push(t)}return{files:o,source:t}}function W(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}const mt={inmemory:`in-memory`,drizzle:`Drizzle`,prisma:`Prisma`};function ht(e){return e.charAt(0).toUpperCase()+e.slice(1).replace(/-([a-z])/g,(e,t)=>t.toUpperCase())}function gt(e){return mt[e]??ht(e)}function _t(e){return`create${e}Repository`}function vt(e){return e??`define`}function yt(e){let{pascal:t,kebab:n,plural:r=``,repo:i,style:a}=e,o=_t(t),s=vt(a),c=`/**
  * ${t} Module
  *
  * REST module with a flat folder structure.
@@ -21,7 +21,7 @@ import{t as e}from"./rolldown-runtime-D4R0ptAp.mjs";import{c as t,i as n,l as r,
  *   dtos/                   — Request/response schemas
  *
  * The repository is backed by an in-memory Map so this module works as
- * generated. Swap in ${i===`inmemory`?`a database`:_t(i)} by replacing the factory body in
+ * generated. Swap in ${i===`inmemory`?`a database`:gt(i)} by replacing the factory body in
  * ${n}.repository.ts — the contract is whatever that factory returns, so
  * nothing else has to change.
  */`,l=`import { ${t.toUpperCase()}_REPOSITORY, ${o} } from './${n}.repository'
@@ -86,7 +86,7 @@ ${u}
     },
   }),
 })
-`}function xt(e){let{pascal:t,kebab:n,plural:r=``,style:i}=e,a=yt(i),o=`    /**
+`}function bt(e){let{pascal:t,kebab:n,plural:r=``,style:i}=e,a=vt(i),o=`    /**
      * Declare HTTP routes. Return value shape:
      *
      *   - \`path\`        — URL prefix for this route set.
@@ -126,7 +126,7 @@ ${o}
     },
   }),
 })
-`}function St(e){let{pascal:t,kebab:n}=e,r=e.swagger?`import { ApiTags } from '@forinda/kickjs-swagger'
+`}function xt(e){let{pascal:t,kebab:n}=e,r=e.swagger?`import { ApiTags } from '@forinda/kickjs-swagger'
 `:``,i=e.swagger?`  @ApiTags('${e.pascal}')\n`:``,a=t.charAt(0).toLowerCase()+t.slice(1);return`import {
   Controller,
   Get,
@@ -198,10 +198,10 @@ ${i}  async remove(ctx: Ctx<KickRoutes.${t}Controller['remove']>) {
     return reply.noContent()
   }
 }
-`}const Ct={zod:{import:`import { z } from 'zod'`,required:`z.string().min(1, { error: 'Name is required' }).max(200)`,optional:`z.string().min(1).max(200).optional()`,infer:e=>`z.infer<typeof ${e}>`,hint:[` *   z.string(), z.number(), z.boolean(), z.enum([...]),`,` *   z.array(), z.object(), .optional(), .default(), .transform()`].join(`
+`}const St={zod:{import:`import { z } from 'zod'`,required:`z.string().min(1, { error: 'Name is required' }).max(200)`,optional:`z.string().min(1).max(200).optional()`,infer:e=>`z.infer<typeof ${e}>`,hint:[` *   z.string(), z.number(), z.boolean(), z.enum([...]),`,` *   z.array(), z.object(), .optional(), .default(), .transform()`].join(`
 `)},valibot:{import:`import * as v from 'valibot'`,required:`v.pipe(v.string(), v.minLength(1, 'Name is required'), v.maxLength(200))`,optional:`v.optional(v.pipe(v.string(), v.minLength(1), v.maxLength(200)))`,infer:e=>`v.InferOutput<typeof ${e}>`,hint:[` *   v.string(), v.number(), v.boolean(), v.picklist([...]),`,` *   v.array(), v.object(), v.optional(), and v.pipe(...) to chain checks`].join(`
 `)},yup:{import:`import * as yup from 'yup'`,required:`yup.string().required('Name is required').min(1).max(200)`,optional:`yup.string().min(1).max(200).optional()`,infer:e=>`yup.InferType<typeof ${e}>`,hint:[` *   yup.string(), yup.number(), yup.boolean(), .oneOf([...]),`,` *   yup.array(), yup.object(), .required(), .optional(), .default()`].join(`
-`)}};function wt(e,t){return`${e===`zod`?`z.object`:e===`valibot`?`v.object`:`yup.object`}({\n  ${t},\n})`}function Tt(e){let{pascal:t}=e,n=e.schemaLib??`zod`,r=Ct[n],i=`create${t}Schema`,a=n===`zod`?`Zod`:n===`valibot`?`Valibot`:`Yup`;return`${r.import}
+`)}};function Ct(e,t){return`${e===`zod`?`z.object`:e===`valibot`?`v.object`:`yup.object`}({\n  ${t},\n})`}function wt(e){let{pascal:t}=e,n=e.schemaLib??`zod`,r=St[n],i=`create${t}Schema`,a=n===`zod`?`Zod`:n===`valibot`?`Valibot`:`Yup`;return`${r.import}
 
 /**
  * Create ${t} DTO — ${a} schema for validating POST request bodies.
@@ -211,21 +211,21 @@ ${i}  async remove(ctx: Ctx<KickRoutes.${t}Controller['remove']>) {
  * Add more fields as needed. Supported ${a} types:
 ${r.hint}
  */
-export const ${i} = ${wt(n,`name: ${r.required}`)}
+export const ${i} = ${Ct(n,`name: ${r.required}`)}
 
 export type Create${t}DTO = ${r.infer(i)}
-`}function Et(e){let{pascal:t}=e,n=e.schemaLib??`zod`,r=Ct[n],i=`update${t}Schema`;return`${r.import}
+`}function Tt(e){let{pascal:t}=e,n=e.schemaLib??`zod`,r=St[n],i=`update${t}Schema`;return`${r.import}
 
-export const ${i} = ${wt(n,`name: ${r.optional}`)}
+export const ${i} = ${Ct(n,`name: ${r.optional}`)}
 
 export type Update${t}DTO = ${r.infer(i)}
-`}function Dt(e){let{pascal:t}=e;return`export interface ${t}ResponseDTO {
+`}function Et(e){let{pascal:t}=e;return`export interface ${t}ResponseDTO {
   id: string
   name: string
   createdAt: string
   updatedAt: string
 }
-`}function Ot(e){let{pascal:t,kebab:n,repoType:r,dtoPrefix:i=`./dtos`,tokenScope:a=`app`}=e,o=r&&r!==`inmemory`?r:``,s=`create${t}Repository`,c=`  const store = new Map<string, ${t}ResponseDTO>()
+`}function Dt(e){let{pascal:t,kebab:n,repoType:r,dtoPrefix:i=`./dtos`,tokenScope:a=`app`}=e,o=r&&r!==`inmemory`?r:``,s=`create${t}Repository`,c=`  const store = new Map<string, ${t}ResponseDTO>()
 
   return {
     async findById(id: string): Promise<${t}ResponseDTO | null> {
@@ -300,7 +300,7 @@ export type ${t}Repository = ReturnType<typeof ${s}>
  * adopters must NOT use the reserved \`'kick/'\` namespace.
  */
 export const ${t.toUpperCase()}_REPOSITORY = createToken<${t}Repository>('${a}/${t}/repository')
-`}function kt(e){let{pascal:t,kebab:n,plural:r=``,style:i=`define`,testHarness:a=!1}=e,o=i===`define`?`${t}Module()`:`${t}Module`;return`${a?`import { describe, it, expect, beforeEach } from 'vitest'
+`}function Ot(e){let{pascal:t,kebab:n,plural:r=``,style:i=`define`,testHarness:a=!1}=e,o=i===`define`?`${t}Module()`:`${t}Module`;return`${a?`import { describe, it, expect, beforeEach } from 'vitest'
 import request from 'supertest'
 import { Container } from '@forinda/kickjs'
 import { createTestApp } from '@forinda/kickjs-testing'
@@ -394,7 +394,7 @@ ${a?`  /**
     it.todo('deletes a ${n}')
   })
 })
-`}function At(e){let{pascal:t,kebab:n,plural:r=``,repoPrefix:i=`../${n}.repository`}=e,a=`create${t}Repository`;return`import { describe, it, expect, beforeEach } from 'vitest'
+`}function kt(e){let{pascal:t,kebab:n,plural:r=``,repoPrefix:i=`../${n}.repository`}=e,a=`create${t}Repository`;return`import { describe, it, expect, beforeEach } from 'vitest'
 import { ${a}, type ${t}Repository } from '${i}'
 
 describe('${t} repository', () => {
@@ -456,7 +456,7 @@ describe('${t} repository', () => {
     expect(found).toBeNull()
   })
 })
-`}function jt(e){let{pascal:t,kebab:n}=e;return`import { Service, Inject, HttpException } from '@forinda/kickjs'
+`}function At(e){let{pascal:t,kebab:n}=e;return`import { Service, Inject, HttpException } from '@forinda/kickjs'
 import type { ParsedQuery } from '@forinda/kickjs'
 import { ${t.toUpperCase()}_REPOSITORY, type ${t}Repository } from './${n}.repository'
 import type { ${t}ResponseDTO } from './dtos/${n}-response.dto'
@@ -493,14 +493,14 @@ export class ${t}Service {
     await this.repo.delete(id)
   }
 }
-`}function Mt(e){let{pascal:t}=e;return`import type { QueryFieldConfig } from '@forinda/kickjs'
+`}function jt(e){let{pascal:t}=e;return`import type { QueryFieldConfig } from '@forinda/kickjs'
 
 export const ${t.toUpperCase()}_QUERY_CONFIG: QueryFieldConfig = {
   filterable: ['name'],
   sortable: ['name', 'createdAt'],
   searchable: ['name'],
 }
-`}async function Nt(e){let{pascal:t,kebab:n,plural:r,style:i,write:a}=e;await a(`${n}.module.ts`,xt({pascal:t,kebab:n,plural:r,style:i})),await a(`${n}.controller.ts`,`import { Controller, Get, Post, Put, Delete, reply, type Ctx } from '@forinda/kickjs'
+`}async function Mt(e){let{pascal:t,kebab:n,plural:r,style:i,write:a}=e;await a(`${n}.module.ts`,bt({pascal:t,kebab:n,plural:r,style:i})),await a(`${n}.controller.ts`,`import { Controller, Get, Post, Put, Delete, reply, type Ctx } from '@forinda/kickjs'
 
 // \`Ctx<KickRoutes.${t}Controller['<method>']>\` is generated by
 // \`kick typegen\` (auto-run on \`kick dev\`).
@@ -540,7 +540,7 @@ export class ${t}Controller {
     return reply.noContent()
   }
 }
-`)}async function Pt(e){let{pascal:t,kebab:n,plural:r,pluralPascal:i,repo:a,noTests:o,tokenScope:s,style:c,testHarness:l,write:u}=e,d=e.swagger??!1,f=e.schemaLib??`zod`;await u(`${n}.module.ts`,bt({pascal:t,kebab:n,plural:r,repo:a,style:c})),await u(`${n}.constants.ts`,Mt({pascal:t,kebab:n})),await u(`${n}.controller.ts`,St({pascal:t,kebab:n,plural:r,pluralPascal:i,swagger:d})),await u(`${n}.service.ts`,jt({pascal:t,kebab:n})),await u(`dtos/create-${n}.dto.ts`,Tt({pascal:t,kebab:n,schemaLib:f})),await u(`dtos/update-${n}.dto.ts`,Et({pascal:t,kebab:n,schemaLib:f})),await u(`dtos/${n}-response.dto.ts`,Dt({pascal:t,kebab:n})),await u(`${n}.repository.ts`,Ot({pascal:t,kebab:n,repoType:a,dtoPrefix:`./dtos`,tokenScope:s})),o||(await u(`__tests__/${n}.controller.test.ts`,kt({pascal:t,kebab:n,plural:r,style:c,testHarness:l})),await u(`__tests__/${n}.repository.test.ts`,At({pascal:t,kebab:n,plural:r,repoPrefix:`../${n}.repository`})))}function Ft(e){return e?typeof e==`string`?e:e.name:`inmemory`}async function It(e){let{name:t,modulesDir:n,noEntity:r,noTests:i,repo:a=`inmemory`,force:o,dryRun:s}=e,c=e.pluralize!==!1,l=e.pattern??`rest`;e.minimal&&(l=`minimal`);let u=V(t),d=z(t),f=c?H(u):u,p=c?tt(d):d,m=N(n,f),h=[],g=o??!1,_={kebab:u,pascal:d,plural:f,pluralPascal:p,moduleDir:m,repo:a,noEntity:r??!1,noTests:i??!1,tokenScope:e.tokenScope??`app`,swagger:e.swagger??!1,schemaLib:e.schemaLib??`zod`,testHarness:e.testHarness??!1,style:e.style??`define`,write:async(e,t)=>{let n=N(m,e);if(s){h.push(n);return}if(!g&&await b(n)&&!await w({message:`File exists: ${C.dim(e)}. Overwrite?`,initialValue:!1})){x.warn(`Skipped: ${e}`);return}await y(n,t),h.push(n)},files:h};switch(l){case`minimal`:await Nt(_);break;default:await Pt(_)}return s||await Lt(n,d,f,u,_.style),h}async function Lt(e,t,n,r,i=`define`){let a=N(e,`index.ts`),o=await b(a),s=`./${n}/${r}.module`,c=i===`class`?`${t}Module`:`${t}Module()`;if(!o){let e=i===`class`?`import type { AppModuleEntry } from '@forinda/kickjs'
+`)}async function Nt(e){let{pascal:t,kebab:n,plural:r,pluralPascal:i,repo:a,noTests:o,tokenScope:s,style:c,testHarness:l,write:u}=e,d=e.swagger??!1,f=e.schemaLib??`zod`;await u(`${n}.module.ts`,yt({pascal:t,kebab:n,plural:r,repo:a,style:c})),await u(`${n}.constants.ts`,jt({pascal:t,kebab:n})),await u(`${n}.controller.ts`,xt({pascal:t,kebab:n,plural:r,pluralPascal:i,swagger:d})),await u(`${n}.service.ts`,At({pascal:t,kebab:n})),await u(`dtos/create-${n}.dto.ts`,wt({pascal:t,kebab:n,schemaLib:f})),await u(`dtos/update-${n}.dto.ts`,Tt({pascal:t,kebab:n,schemaLib:f})),await u(`dtos/${n}-response.dto.ts`,Et({pascal:t,kebab:n})),await u(`${n}.repository.ts`,Dt({pascal:t,kebab:n,repoType:a,dtoPrefix:`./dtos`,tokenScope:s})),o||(await u(`__tests__/${n}.controller.test.ts`,Ot({pascal:t,kebab:n,plural:r,style:c,testHarness:l})),await u(`__tests__/${n}.repository.test.ts`,kt({pascal:t,kebab:n,plural:r,repoPrefix:`../${n}.repository`})))}function Pt(e){return e?typeof e==`string`?e:e.name:`inmemory`}async function Ft(e){let{name:t,modulesDir:n,noEntity:r,noTests:i,repo:a=`inmemory`,force:o,dryRun:s}=e,c=e.pluralize!==!1,l=e.pattern??`rest`;e.minimal&&(l=`minimal`);let u=H(t),d=B(t),f=c?U(u):u,p=c?et(d):d,m=N(n,f),h=[],g=o??!1,_={kebab:u,pascal:d,plural:f,pluralPascal:p,moduleDir:m,repo:a,noEntity:r??!1,noTests:i??!1,tokenScope:e.tokenScope??`app`,swagger:e.swagger??!1,schemaLib:e.schemaLib??`zod`,testHarness:e.testHarness??!1,style:e.style??`define`,write:async(e,t)=>{let n=N(m,e);s?h.push(n):!g&&await b(n)&&!await oe({message:`File exists: ${C.dim(e)}. Overwrite?`,initialValue:!1})?x.warn(`Skipped: ${e}`):(await y(n,t),h.push(n))},files:h};switch(l){case`minimal`:await Mt(_);break;default:await Nt(_)}return s||await It(n,d,f,u,_.style),h}async function It(e,t,n,r,i=`define`){let a=N(e,`index.ts`),o=await b(a),s=`./${n}/${r}.module`,c=i===`class`?`${t}Module`:`${t}Module()`;if(!o){let e=i===`class`?`import type { AppModuleEntry } from '@forinda/kickjs'
 import { ${t}Module } from '${s}'
 
 export const modules: AppModuleEntry[] = [${c}]
@@ -548,11 +548,11 @@ export const modules: AppModuleEntry[] = [${c}]
 import { ${t}Module } from '${s}'
 
 export const modules = defineModules().mount(${c})
-`;await y(a,e);return}let l=await L(a,`utf-8`),u=`import { ${t}Module } from '${s}'`,d=U(s);if(!RegExp(`^import\\s*\\{[^}]*\\b${U(t)}Module\\b[^}]*\\}\\s*from\\s*['"]${d}['"]`,`m`).test(l)){let e=l.lastIndexOf(`import `);if(e!==-1){let t=l.indexOf(`
+`;await y(a,e);return}let l=await R(a,`utf-8`),u=`import { ${t}Module } from '${s}'`,d=W(s);if(!RegExp(`^import\\s*\\{[^}]*\\b${W(t)}Module\\b[^}]*\\}\\s*from\\s*['"]${d}['"]`,`m`).test(l)){let e=l.lastIndexOf(`import `);if(e!==-1){let t=l.indexOf(`
 `,e);l=l.slice(0,t+1)+u+`
 `+l.slice(t+1)}else l=u+`
-`+l}let f=zt(l);if(f){let e=l.slice(f.rhsStart,f.rhsEnd+1);RegExp(`\\b${U(t)}Module\\b`).test(e)||(l=Rt(l,c))}else l=Rt(l,c);await R(a,l,`utf-8`)}function Rt(e,t){let n=zt(e);if(!n)return e;if(n.shape===`array`){let r=e.slice(n.rhsStart+1,n.rhsEnd),i=r.trim(),a;if(!i)a=`[${t}]`;else{let e=i.endsWith(`,`)?``:`,`;a=`[${r.trimEnd()}${e} ${t}]`}return e.slice(0,n.rhsStart)+a+e.slice(n.rhsEnd+1)}return`${e.slice(0,n.chainEnd)}\n  .mount(${t})${e.slice(n.chainEnd)}`}function zt(e){let t=/export\s+const\s+modules\b[^=]*=/.exec(e);if(!t)return null;let n=t.index+t[0].length;for(;n<e.length&&/\s/.test(e[n]??``);)n++;if(e[n]===`[`){let t=Ht(e,n);return t===-1?null:{shape:`array`,rhsStart:n,rhsEnd:t}}if(e.slice(n,n+13)===`defineModules`){let t=Bt(e,n);return t===-1?null:{shape:`chain`,rhsStart:n,rhsEnd:t-1,chainEnd:t}}return null}function Bt(e,t=0){let n=/defineModules\s*\(/g;n.lastIndex=t;let r=n.exec(e);if(!r)return-1;let i=r.index+r[0].length-1;if(e[i]!==`(`||(i=Ut(e,i),i===-1))return-1;for(i++;;){let t=i;for(;t<e.length&&/\s/.test(e[t]??``);)t++;if(e[t]!==`.`||e.slice(t,t+6)!==`.mount`)break;for(t+=6;t<e.length&&/\s/.test(e[t]??``);)t++;if(e[t]!==`(`)break;let n=Ut(e,t);if(n===-1)break;i=n+1}return i}function Vt(e,t){let n=e.slice(t,t+2);if(n===`//`){for(t+=2;t<e.length&&e[t]!==`
-`;)t++;return t}if(n===`/*`){for(t+=2;t+1<e.length&&(e[t]!==`*`||e[t+1]!==`/`);)t++;return t+2}return t}function Ht(e,t){if(e[t]!==`[`)return-1;let n=1,r=t+1;for(;r<e.length;){let t=e.slice(r,r+2);if(t===`//`||t===`/*`){r=Vt(e,r);continue}let i=e[r]??``;if(i===`'`||i===`"`||i==="`"){let t=i;for(r++;r<e.length&&e[r]!==t;)e[r]===`\\`&&r++,r++;r<e.length&&r++;continue}if(i===`[`)n++;else if(i===`]`&&(n--,n===0))return r;r++}return-1}function Ut(e,t){if(e[t]!==`(`)return-1;let n=1,r=t+1;for(;r<e.length;){let t=e.slice(r,r+2);if(t===`//`||t===`/*`){r=Vt(e,r);continue}let i=e[r]??``;if(i===`'`||i===`"`||i==="`"){let t=i;for(r++;r<e.length&&e[r]!==t;)e[r]===`\\`&&r++,r++;r<e.length&&r++;continue}if(i===`(`)n++;else if(i===`)`&&(n--,n===0))return r;r++}return-1}function Wt(e,t,n,r){return`/**
+`+l}let f=Rt(l);if(f){let e=l.slice(f.rhsStart,f.rhsEnd+1);RegExp(`\\b${W(t)}Module\\b`).test(e)||(l=Lt(l,c))}else l=Lt(l,c);await z(a,l,`utf-8`)}function Lt(e,t){let n=Rt(e);if(!n)return e;if(n.shape===`array`){let r=e.slice(n.rhsStart+1,n.rhsEnd),i=r.trim(),a;if(!i)a=`[${t}]`;else{let e=i.endsWith(`,`)?``:`,`;a=`[${r.trimEnd()}${e} ${t}]`}return e.slice(0,n.rhsStart)+a+e.slice(n.rhsEnd+1)}return`${e.slice(0,n.chainEnd)}\n  .mount(${t})${e.slice(n.chainEnd)}`}function Rt(e){let t=/export\s+const\s+modules\b[^=]*=/.exec(e);if(!t)return null;let n=t.index+t[0].length;for(;n<e.length&&/\s/.test(e[n]??``);)n++;if(e[n]===`[`){let t=Vt(e,n);return t===-1?null:{shape:`array`,rhsStart:n,rhsEnd:t}}if(e.slice(n,n+13)===`defineModules`){let t=zt(e,n);return t===-1?null:{shape:`chain`,rhsStart:n,rhsEnd:t-1,chainEnd:t}}return null}function zt(e,t=0){let n=/defineModules\s*\(/g;n.lastIndex=t;let r=n.exec(e);if(!r)return-1;let i=r.index+r[0].length-1;if(e[i]!==`(`||(i=Ht(e,i),i===-1))return-1;for(i++;;){let t=i;for(;t<e.length&&/\s/.test(e[t]??``);)t++;if(e[t]!==`.`||e.slice(t,t+6)!==`.mount`)break;for(t+=6;t<e.length&&/\s/.test(e[t]??``);)t++;if(e[t]!==`(`)break;let n=Ht(e,t);if(n===-1)break;i=n+1}return i}function Bt(e,t){let n=e.slice(t,t+2);if(n===`//`){for(t+=2;t<e.length&&e[t]!==`
+`;)t++;return t}if(n===`/*`){for(t+=2;t+1<e.length&&(e[t]!==`*`||e[t+1]!==`/`);)t++;return t+2}return t}function Vt(e,t){if(e[t]!==`[`)return-1;let n=1,r=t+1;for(;r<e.length;){let t=e.slice(r,r+2);if(t===`//`||t===`/*`){r=Bt(e,r);continue}let i=e[r]??``;if(i===`'`||i===`"`||i==="`"){let t=i;for(r++;r<e.length&&e[r]!==t;)e[r]===`\\`&&r++,r++;r<e.length&&r++}else{if(i===`[`)n++;else if(i===`]`&&(n--,n===0))return r;r++}}return-1}function Ht(e,t){if(e[t]!==`(`)return-1;let n=1,r=t+1;for(;r<e.length;){let t=e.slice(r,r+2);if(t===`//`||t===`/*`){r=Bt(e,r);continue}let i=e[r]??``;if(i===`'`||i===`"`||i==="`"){let t=i;for(r++;r<e.length&&e[r]!==t;)e[r]===`\\`&&r++,r++;r<e.length&&r++}else{if(i===`(`)n++;else if(i===`)`&&(n--,n===0))return r;r++}}return-1}function Ut(e,t,n,r){return`/**
  * Snapshot for the DevTools topology view (\`/_debug\`).
  *
  * Must be CHEAP — the topology endpoint polls on a short interval, so
@@ -592,7 +592,7 @@ export const modules = defineModules().mount(${c})
 //   ]
 // },`.split(`
 `).map(e=>r+e).join(`
-`)}async function Gt(e){let{name:t,outDir:n}=e,r=V(t),i=z(t),a=[],o=N(n,`${r}.adapter.ts`);return await y(o,`import {
+`)}async function Wt(e){let{name:t,outDir:n}=e,r=H(t),i=B(t),a=[],o=N(n,`${r}.adapter.ts`);return await y(o,`import {
   defineAdapter,
   type AdapterContext,
   type AdapterMiddleware,
@@ -797,11 +797,11 @@ export const ${i}Adapter = defineAdapter<${i}AdapterConfig>({
         return { name: '${r}', status: 'up' }
       },
 
-${Wt(r,i,`adapter`,`      `)}
+${Ut(r,i,`adapter`,`      `)}
     }
   },
 })
-`),a.push(o),a}async function Kt(e){let{name:t,outDir:n}=e,r=V(t),i=z(t),a=[],o=N(n,`${r}.plugin.ts`);return await y(o,`import {
+`),a.push(o),a}async function Gt(e){let{name:t,outDir:n}=e,r=H(t),i=B(t),a=[],o=N(n,`${r}.plugin.ts`);return await y(o,`import {
   definePlugin,
   type AppAdapter,
   type AppModuleEntry,
@@ -958,13 +958,13 @@ export const ${i}Plugin = definePlugin<${i}PluginConfig>({
       // Example: await this.connection?.close()
     },
 
-${Wt(r,i,`plugin`,`    `)}
+${Ut(r,i,`plugin`,`    `)}
   }),
 })
-`),a.push(o),a}const qt={controller:``,service:``,dto:`dtos`,guard:`guards`,middleware:`middleware`,contributor:`contributors`};function W(e){let{type:t,outDir:n,moduleName:r,modulesDir:i=`src/modules`,defaultDir:a,shouldPluralize:o=!0}=e;if(n)return F(n);if(r){let e=qt,n=V(r),a=o?H(n):n,s=e[t]??``,c=N(i,a);return F(s?N(c,s):c)}return F(a)}async function Jt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=e.runtime===`express`,o=e.runtime?`this project runs on ${e.runtime} and has no
-  // \`express\``:"this project declares no `runtime` in kick.config.ts, so it\n  // may have no `express`",s=W({type:`middleware`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/middleware`,pattern:i,shouldPluralize:e.pluralize??!0}),c=V(t),l=B(t),u=[],d=N(s,`${c}.middleware.ts`);return await y(d,`${a?`import type { Request, Response, NextFunction } from 'express'`:`import type { IncomingMessage, ServerResponse } from 'node:http'`}
+`),a.push(o),a}const Kt={controller:``,service:``,dto:`dtos`,guard:`guards`,middleware:`middleware`,contributor:`contributors`};function G(e){let{type:t,outDir:n,moduleName:r,modulesDir:i=`src/modules`,defaultDir:a,shouldPluralize:o=!0}=e;if(n)return F(n);if(r){let e=Kt,n=H(r),a=o?U(n):n,s=e[t]??``,c=N(i,a);return F(s?N(c,s):c)}return F(a)}async function qt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=e.runtime===`express`,o=e.runtime?`this project runs on ${e.runtime} and has no
+  // \`express\``:"this project declares no `runtime` in kick.config.ts, so it\n  // may have no `express`",s=G({type:`middleware`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/middleware`,pattern:i,shouldPluralize:e.pluralize??!0}),c=H(t),l=V(t),u=[],d=N(s,`${c}.middleware.ts`);return await y(d,`${a?`import type { Request, Response, NextFunction } from 'express'`:`import type { IncomingMessage, ServerResponse } from 'node:http'`}
 
-export interface ${z(t)}Options {
+export interface ${B(t)}Options {
   // Add configuration options here. The factory below closes over the
   // resolved options object; pass them at the call site —
   // \`${l}({ foo: 'bar' })\` — and the closure preserves them across
@@ -972,7 +972,7 @@ export interface ${z(t)}Options {
 }
 
 /**
- * ${z(t)} middleware.
+ * ${B(t)} middleware.
  *
  * Usage in bootstrap (fires on every request):
  *   middlewares: [${l}()]
@@ -1008,7 +1008,7 @@ export interface ${z(t)}Options {
  * first \`next()\` throws \`TypeError: next is not a function\`. Generate a
  * guard instead (\`kick g guard\`) for the per-route, ctx-style shape.
  */
-export function ${l}(options: ${z(t)}Options = {}) {
+export function ${l}(options: ${B(t)}Options = {}) {
 ${a?"  // Typed from `express` because that is this project's runtime\n  // (`runtime: 'express'` in kick.config.ts). Global middleware is\n  // connect-style on every engine, but only Express hands the handler its own\n  // request / response objects — so `req.originalUrl`, `req.query` and\n  // `res.json()` are all available here. Switching `runtime` later means\n  // re-typing this signature from `node:http`.\n  return (req: Request, res: Response, next: NextFunction) => {":`  // Typed from \`node:http\`, not \`express\`. Global middleware is connect-style
   // on every engine, but ${o} dependency to import types from. Under Fastify the handler
   // receives \`request.raw\` / a reply driver, and under h3 the node objects, so
@@ -1021,7 +1021,7 @@ ${a?"  // Typed from `express` because that is this project's runtime\n  // (`ru
     next()
   }
 }
-`),u.push(d),u}async function Yt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=W({type:`guard`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/guards`,pattern:i,shouldPluralize:e.pluralize??!0}),o=V(t),s=B(t),c=z(t),l=[],u=N(a,`${o}.guard.ts`);return await y(u,`import { Container, HttpException } from '@forinda/kickjs'
+`),u.push(d),u}async function Jt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=G({type:`guard`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/guards`,pattern:i,shouldPluralize:e.pluralize??!0}),o=H(t),s=V(t),c=B(t),l=[],u=N(a,`${o}.guard.ts`);return await y(u,`import { Container, HttpException } from '@forinda/kickjs'
 import type { RequestContext } from '@forinda/kickjs'
 
 /**
@@ -1061,7 +1061,7 @@ export async function ${s}Guard(ctx: RequestContext, next: () => void): Promise<
     ctx.problem.unauthorized({ detail: 'Invalid or expired token' })
   }
 }
-`),l.push(u),l}function Xt(e){return e?e.split(`,`).map(e=>e.trim()).filter(Boolean).map(e=>{let[t,n]=e.split(`:`).map(e=>e.trim());return{name:t,type:n||`string`}}).filter(e=>e.name.length>0):[]}async function Zt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=e.type??`http`,o=V(t),s=z(t),c=e.key??B(t),l=Array.isArray(e.params)?e.params:Xt(e.params),u=W({type:`contributor`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/contributors`,pattern:i,shouldPluralize:e.pluralize??!0}),d=a===`http`?`defineHttpContextDecorator`:`defineContextDecorator`,f=a===`http`?`RequestContext`:`ExecutionContext`,p=l.length>0?`\nexport type ${s}Params = {\n${l.map(e=>`  ${e.name}: ${e.type}`).join(`
+`),l.push(u),l}function Yt(e){return e?e.split(`,`).map(e=>e.trim()).filter(Boolean).map(e=>{let[t,n]=e.split(`:`).map(e=>e.trim());return{name:t,type:n||`string`}}).filter(e=>e.name.length>0):[]}async function Xt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=e.type??`http`,o=H(t),s=B(t),c=e.key??V(t),l=Array.isArray(e.params)?e.params:Yt(e.params),u=G({type:`contributor`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/contributors`,pattern:i,shouldPluralize:e.pluralize??!0}),d=a===`http`?`defineHttpContextDecorator`:`defineContextDecorator`,f=a===`http`?`RequestContext`:`ExecutionContext`,p=l.length>0?`\nexport type ${s}Params = {\n${l.map(e=>`  ${e.name}: ${e.type}`).join(`
 `)}\n}\n`:``,m=l.length>0?`${d}.withParams<${s}Params>()({`:`${d}({`,h=l.length>0?`  // Every call site must supply these — no placeholder defaults.
   // Add \`paramDefaults: { … }\` for any field whose default is
   // genuinely correct for an undecorated route, and drop it from here.
@@ -1112,7 +1112,7 @@ ${_}
     throw new Error("${s} contributor: resolve() not implemented")
   },
 })
-`,b=N(u,`${o}.contributor.ts`);return await y(b,v),[b]}async function Qt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=W({type:`service`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/services`,pattern:i,shouldPluralize:e.pluralize??!0}),o=V(t),s=z(t),c=[],l=N(a,`${o}.service.ts`);return await y(l,`import { Service } from '@forinda/kickjs'
+`,b=N(u,`${o}.contributor.ts`);return await y(b,v),[b]}async function Zt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=G({type:`service`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/services`,pattern:i,shouldPluralize:e.pluralize??!0}),o=H(t),s=B(t),c=[],l=N(a,`${o}.service.ts`);return await y(l,`import { Service } from '@forinda/kickjs'
 
 @Service()
 export class ${s}Service {
@@ -1121,7 +1121,7 @@ export class ${s}Service {
   //   @Inject(MY_REPO) private readonly repo: IMyRepository,
   // ) {}
 }
-`),c.push(l),c}async function $t(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=W({type:`controller`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/controllers`,pattern:i,shouldPluralize:e.pluralize??!0}),o=V(t),s=z(t),c=[],l=N(a,`${o}.controller.ts`);return await y(l,`import { Controller, Get, Post, Put, Delete, reply, type Ctx } from '@forinda/kickjs'
+`),c.push(l),c}async function Qt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=G({type:`controller`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/controllers`,pattern:i,shouldPluralize:e.pluralize??!0}),o=H(t),s=B(t),c=[],l=N(a,`${o}.controller.ts`);return await y(l,`import { Controller, Get, Post, Put, Delete, reply, type Ctx } from '@forinda/kickjs'
 
 // \`Ctx<KickRoutes.${s}Controller['<method>']>\` is generated by
 // \`kick typegen\` (auto-run on \`kick dev\`). After the first run, your IDE
@@ -1163,12 +1163,12 @@ export class ${s}Controller {
     return reply.noContent()
   }
 }
-`),c.push(l),c}async function en(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=W({type:`dto`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/dtos`,pattern:i,shouldPluralize:e.pluralize??!0}),o=V(t),s=z(t),c=B(t),l=e.schemaLib??`zod`,u=Ct[l],d=[],f=N(a,`${o}.dto.ts`);return await y(f,`${u.import}
+`),c.push(l),c}async function $t(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=G({type:`dto`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/dtos`,pattern:i,shouldPluralize:e.pluralize??!0}),o=H(t),s=B(t),c=V(t),l=e.schemaLib??`zod`,u=St[l],d=[],f=N(a,`${o}.dto.ts`);return await y(f,`${u.import}
 
-export const ${c}Schema = ${wt(l,`// Define your schema fields here\n  name: ${u.required}`)}
+export const ${c}Schema = ${Ct(l,`// Define your schema fields here\n  name: ${u.required}`)}
 
 export type ${s}DTO = ${u.infer(`${c}Schema`)}
-`),d.push(f),d}async function tn(e){let t=N(e.outDir,`kick.config.ts`),n=e.modulesDir??`src/modules`,r=e.defaultRepo??`inmemory`;return O(t)&&!e.force&&!await w({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
+`),d.push(f),d}async function en(e){let t=N(e.outDir,`kick.config.ts`),n=e.modulesDir??`src/modules`,r=e.defaultRepo??`inmemory`;return D(t)&&!e.force&&!await oe({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
   Skipped — existing kick.config.ts preserved.`),[]):(await y(t,`import { defineConfig } from '@forinda/kickjs-cli'
 
 export default defineConfig({
@@ -1212,18 +1212,18 @@ export default defineConfig({
     },
   ],
 })
-`),[t])}function nn(e,t){if(e[t]!==`{`)return-1;let n=1;for(let r=t+1;r<e.length;r++){let t=e[r];if(t===`{`)n++;else if(t===`}`&&(n--,n===0))return r}return-1}function G(e,t){let n=t.exec(e);if(!n)return null;let r=n.index+n[0].length-1,i=nn(e,r);return i===-1?null:e.slice(r+1,i)}function K(e,t,n){let r=` `.repeat(n);return e.split(`
+`),[t])}function tn(e,t){if(e[t]!==`{`)return-1;let n=1;for(let r=t+1;r<e.length;r++){let t=e[r];if(t===`{`)n++;else if(t===`}`&&(n--,n===0))return r}return-1}function K(e,t){let n=t.exec(e);if(!n)return null;let r=n.index+n[0].length-1,i=tn(e,r);return i===-1?null:e.slice(r+1,i)}function nn(e,t,n){let r=` `.repeat(n);return e.split(`
 `).map(e=>{if(e.trim()===``)return e;let n=RegExp(`^ {0,${t}}`),i=e.replace(n,``);return r+i}).join(`
-`)}function rn(e){return e.replaceAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*'@forinda\/kickjs'/g,(e,t)=>{let n=t.split(`,`).map(e=>e.trim()).filter(e=>e&&e!==`Container`&&e!==`type Container`&&e!==`type AppModule`&&e!==`AppModule`&&e!==`type ModuleRoutes`&&e!==`ModuleRoutes`);return n.includes(`defineModule`)||n.push(`defineModule`),`import { ${n.join(`, `)} } from '@forinda/kickjs'`})}function an(e,t){return e.replaceAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*'@forinda\/kickjs'/g,(e,n)=>{let r=n.split(`,`).map(e=>e.trim()).filter(e=>e&&e!==`defineModule`);return t.container&&!r.includes(`Container`)&&r.push(`Container`),t.appModule&&!r.some(e=>e===`AppModule`||e===`type AppModule`)&&r.push(`type AppModule`),t.moduleRoutes&&!r.some(e=>e===`ModuleRoutes`||e===`type ModuleRoutes`)&&r.push(`type ModuleRoutes`),t.contributorRegistrations&&!r.some(e=>e===`ContributorRegistrations`||e===`type ContributorRegistrations`)&&r.push(`type ContributorRegistrations`),`import { ${r.join(`, `)} } from '@forinda/kickjs'`})}function on(e){if(/\bdefineModule\s*\(/.test(e))return{migrated:null,reason:`already in target form`};let t=[...e.matchAll(/export\s+class\s+(\w+Module)\s+implements\s+AppModule\s*\{/g)];if(t.length===0)return{migrated:null,reason:`no class form detected`};if(t.length>1)return{migrated:null,reason:`multiple module classes in one file — migrate manually`};let n=t[0],r=n[1],i=n.index+n[0].length-1,a=nn(e,i);if(a===-1)return{migrated:null,reason:`unbalanced class braces`};let o=e.slice(i+1,a),s=e.slice(0,n.index),c=e.slice(a+1),l=G(o,/register\s*\(([^)]*)\)\s*:\s*void\s*\{/),u=G(o,/contributors\s*\(\s*\)\s*:\s*ContributorRegistrations\s*\{/),d=G(o,/routes\s*\(\s*\)\s*:\s*[A-Za-z|[\]\s]+\{/);if(!d)return{migrated:null,reason:`routes() method missing or signature unrecognized`};let f=rn(s),p=``;return l&&(p+=`    register(container) {${K(l,4,6)}    },\n\n`),u&&(p+=`    contributors() {${K(u,4,6)}    },\n\n`),p+=`    routes() {${K(d,4,6)}    },`,{migrated:`${f}${`export const ${r} = defineModule({
+`)}function rn(e){return e.replaceAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*'@forinda\/kickjs'/g,(e,t)=>{let n=t.split(`,`).map(e=>e.trim()).filter(e=>e&&e!==`Container`&&e!==`type Container`&&e!==`type AppModule`&&e!==`AppModule`&&e!==`type ModuleRoutes`&&e!==`ModuleRoutes`);return n.includes(`defineModule`)||n.push(`defineModule`),`import { ${n.join(`, `)} } from '@forinda/kickjs'`})}function an(e,t){return e.replaceAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*'@forinda\/kickjs'/g,(e,n)=>{let r=n.split(`,`).map(e=>e.trim()).filter(e=>e&&e!==`defineModule`);return t.container&&!r.includes(`Container`)&&r.push(`Container`),t.appModule&&!r.some(e=>e===`AppModule`||e===`type AppModule`)&&r.push(`type AppModule`),t.moduleRoutes&&!r.some(e=>e===`ModuleRoutes`||e===`type ModuleRoutes`)&&r.push(`type ModuleRoutes`),t.contributorRegistrations&&!r.some(e=>e===`ContributorRegistrations`||e===`type ContributorRegistrations`)&&r.push(`type ContributorRegistrations`),`import { ${r.join(`, `)} } from '@forinda/kickjs'`})}function on(e){if(/\bdefineModule\s*\(/.test(e))return{migrated:null,reason:`already in target form`};let t=[...e.matchAll(/export\s+class\s+(\w+Module)\s+implements\s+AppModule\s*\{/g)];if(t.length===0)return{migrated:null,reason:`no class form detected`};if(t.length>1)return{migrated:null,reason:`multiple module classes in one file — migrate manually`};let n=t[0],r=n[1],i=n.index+n[0].length-1,a=tn(e,i);if(a===-1)return{migrated:null,reason:`unbalanced class braces`};let o=e.slice(i+1,a),s=e.slice(0,n.index),c=e.slice(a+1),l=K(o,/register\s*\(([^)]*)\)\s*:\s*void\s*\{/),u=K(o,/contributors\s*\(\s*\)\s*:\s*ContributorRegistrations\s*\{/),d=K(o,/routes\s*\(\s*\)\s*:\s*[A-Za-z|[\]\s]+\{/);if(!d)return{migrated:null,reason:`routes() method missing or signature unrecognized`};let f=rn(s),p=``;return l&&(p+=`    register(container) {${nn(l,4,6)}    },\n\n`),u&&(p+=`    contributors() {${nn(u,4,6)}    },\n\n`),p+=`    routes() {${nn(d,4,6)}    },`,{migrated:`${f}${`export const ${r} = defineModule({
   name: '${r}',
   build: () => ({
 ${p}
   }),
-})`}${c}`}}function sn(e){if(/export\s+class\s+\w+Module\s+implements\s+AppModule\s*\{/.test(e))return{migrated:null,reason:`already in target form`};let t=[...e.matchAll(/export\s+const\s+(\w+Module)\s*=\s*defineModule\s*\(\s*\{/g)];if(t.length===0)return{migrated:null,reason:`no defineModule form detected`};if(t.length>1)return{migrated:null,reason:`multiple defineModule blocks in one file — migrate manually`};let n=t[0],r=n[1],i=n.index+n[0].length-1,a=nn(e,i);if(a===-1)return{migrated:null,reason:`unbalanced defineModule braces`};let o=e.indexOf(`)`,a);if(o===-1)return{migrated:null,reason:`unbalanced defineModule call parens`};let s=e.slice(i+1,a),c=e.slice(0,n.index),l=o+1;for(;l<e.length&&(e[l]===`
-`||e[l]===`\r`);)l++;let u=e.slice(l),d=/build\s*:\s*\([^)]*\)\s*=>\s*\(\s*\{/g.exec(s);if(!d)return{migrated:null,reason:`build: () => ({...}) not found in defineModule`};let f=d.index+d[0].length-1,p=nn(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=G(m,/register\s*\(([^)]*)\)\s*\{/),g=G(m,/contributors\s*\(\s*\)\s*\{/),_=G(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let v=an(c,{container:h!==null,appModule:!0,moduleRoutes:!0,contributorRegistrations:g!==null}),y=``;return h!==null&&(y+=`  register(container: Container): void {${K(h,6,4)}  }\n\n`),g!==null&&(y+=`  contributors(): ContributorRegistrations {${K(g,6,4)}  }\n\n`),y+=`  routes(): ModuleRoutes {${K(_,6,4)}  }`,{migrated:`${v}${`export class ${r} implements AppModule {
+})`}${c}`}}function sn(e){if(/export\s+class\s+\w+Module\s+implements\s+AppModule\s*\{/.test(e))return{migrated:null,reason:`already in target form`};let t=[...e.matchAll(/export\s+const\s+(\w+Module)\s*=\s*defineModule\s*\(\s*\{/g)];if(t.length===0)return{migrated:null,reason:`no defineModule form detected`};if(t.length>1)return{migrated:null,reason:`multiple defineModule blocks in one file — migrate manually`};let n=t[0],r=n[1],i=n.index+n[0].length-1,a=tn(e,i);if(a===-1)return{migrated:null,reason:`unbalanced defineModule braces`};let o=e.indexOf(`)`,a);if(o===-1)return{migrated:null,reason:`unbalanced defineModule call parens`};let s=e.slice(i+1,a),c=e.slice(0,n.index),l=o+1;for(;l<e.length&&(e[l]===`
+`||e[l]===`\r`);)l++;let u=e.slice(l),d=/build\s*:\s*\([^)]*\)\s*=>\s*\(\s*\{/g.exec(s);if(!d)return{migrated:null,reason:`build: () => ({...}) not found in defineModule`};let f=d.index+d[0].length-1,p=tn(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=K(m,/register\s*\(([^)]*)\)\s*\{/),g=K(m,/contributors\s*\(\s*\)\s*\{/),_=K(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let v=an(c,{container:h!==null,appModule:!0,moduleRoutes:!0,contributorRegistrations:g!==null}),y=``;return h!==null&&(y+=`  register(container: Container): void {${nn(h,6,4)}  }\n\n`),g!==null&&(y+=`  contributors(): ContributorRegistrations {${nn(g,6,4)}  }\n\n`),y+=`  routes(): ModuleRoutes {${nn(_,6,4)}  }`,{migrated:`${v}${`export class ${r} implements AppModule {
 ${y}
 }
-`}${u}`}}function cn(e,t){return t===`class`?sn(e):on(e)}function ln(e,t){let n=e,r=!1;if(t===`define`){/\bAppModuleClass\b/.test(n)&&(n=n.replaceAll(/\bAppModuleClass\b/g,`AppModuleEntry`),r=!0);let e=/(=\s*\[)([\s\S]*?)(])/,t=e.exec(n);if(t){let i=t[1],a=t[3],o=t[2],s=o.replaceAll(/(\b\w+Module)(?![(.])/g,`$1()`);s!==o&&(n=n.replace(e,`${i}${s}${a}`),r=!0)}}else{/\bAppModuleEntry\b/.test(n)&&(n=n.replaceAll(/\bAppModuleEntry\b/g,`AppModuleClass`),r=!0);let e=/(=\s*\[)([\s\S]*?)(])/,t=e.exec(n);if(t){let i=t[1],a=t[3],o=t[2],s=o.replaceAll(/(\b\w+Module)\s*\(\s*\)/g,`$1`);s!==o&&(n=n.replace(e,`${i}${s}${a}`),r=!0)}}return r?{migrated:n}:{migrated:null,reason:`no changes needed`}}async function un(e){let t=[];return await n(F(e),0),t;async function n(e,r){let i;try{i=await We(e)}catch{return}for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=N(e,a),o;try{o=await Ke(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function dn(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await We(e)}catch{return}await Ue(t,{recursive:!0});for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=N(e,a),o=N(t,a),s;try{s=await Ke(i)}catch{continue}s.isDirectory()?await r(i,o):(await He(i,o),n++)}}}function fn(e){let t=new Date().toISOString().replaceAll(/[:.]/g,`-`);return N(e,`.kickjs`,`codemod-backups`,`${t}-modules`)}async function pn(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await un(e),s=await L(N(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=fn(r),await dn(e,c));let l=[];for(let e of o){let t=cn(await L(e,`utf-8`),i);if(t.migrated==null){l.push({path:e,status:`skipped`,reason:t.reason});continue}n||await R(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`})}let u=N(e,`index.ts`),d=null;try{d=await L(u,`utf-8`)}catch{return{target:i,files:l,indexStatus:`not-found`,indexPath:u,backupDir:c}}let f=ln(d,i);return f.migrated==null?{target:i,files:l,indexStatus:`skipped`,indexPath:u,indexReason:f.reason,backupDir:c}:(n||await R(u,f.migrated,`utf-8`),{target:i,files:l,indexStatus:`migrated`,indexPath:u,backupDir:c})}async function mn(e,t){let n=await un(e),r=[],i=t===`define`?/export\s+class\s+\w+Module\s+implements\s+AppModule\s*\{/:/export\s+const\s+\w+Module\s*=\s*defineModule\s*\(/;for(let e of n){let t=await L(e,`utf-8`);i.test(t)&&r.push(e)}return r}const hn={string:{ts:`string`,zod:`z.string()`},text:{ts:`string`,zod:`z.string()`},number:{ts:`number`,zod:`z.number()`},int:{ts:`number`,zod:`z.number().int()`},float:{ts:`number`,zod:`z.number()`},boolean:{ts:`boolean`,zod:`z.boolean()`},date:{ts:`string`,zod:`z.iso.datetime()`},email:{ts:`string`,zod:`z.email()`},url:{ts:`string`,zod:`z.url()`},uuid:{ts:`string`,zod:`z.uuid()`},json:{ts:`any`,zod:`z.any()`}};function gn(e){let t=e.map(e=>{let t=e.indexOf(`:`);if(t===-1)throw Error(`Invalid field: "${e}". Use format: name:type (e.g. title:string)`);let n=e.slice(0,t),r=e.slice(t+1);if(!n||!r)throw Error(`Invalid field: "${e}". Use format: name:type (e.g. title:string)`);let i=!1;r.endsWith(`:optional`)&&(r=r.slice(0,-9),i=!0),n.endsWith(`?`)&&(n=n.slice(0,-1),i=!0),r.endsWith(`?`)&&(r=r.slice(0,-1),i=!0);let a=r;if(a.startsWith(`enum:`)){let e=a.slice(5).split(`,`);return{name:n,type:`enum`,tsType:e.map(e=>`'${e}'`).join(` | `),zodType:`z.enum([${e.map(e=>`'${e}'`).join(`, `)}])`,optional:i}}let o=hn[a];if(!o){let e=[...Object.keys(hn),`enum:a,b,c`].join(`, `);throw Error(`Unknown field type: "${a}". Valid types: ${e}`)}return{name:n,type:a,tsType:o.ts,zodType:o.zod,optional:i}}),n=new Set;for(let{name:e}of t){if(n.has(e))throw Error(`Duplicate field: "${e}". Each field name may appear once.`);n.add(e)}return t}async function _n(e){let{name:t,fields:n,modulesDir:r,repo:i=`inmemory`,tokenScope:a=`app`,style:o=`define`}=e,s=e.pluralize!==!1,c=V(t),l=z(t),u=s?H(c):c,d=s?tt(l):l,f=N(r,u),p=[],m=async(e,t)=>{let n=N(f,e);await y(n,t),p.push(n)};return await m(`${c}.module.ts`,bt({pascal:l,kebab:c,plural:u,repo:i,style:o})),await m(`${c}.constants.ts`,Mt({pascal:l,kebab:c})),await m(`${c}.controller.ts`,St({pascal:l,kebab:c,plural:u,pluralPascal:d,swagger:e.swagger??!1})),await m(`${c}.service.ts`,jt({pascal:l,kebab:c})),await m(`dtos/create-${c}.dto.ts`,vn(l,n)),await m(`dtos/update-${c}.dto.ts`,yn(l,n)),await m(`dtos/${c}-response.dto.ts`,bn(l,n)),await m(`${c}.repository.ts`,Ot({pascal:l,kebab:c,repoType:i,dtoPrefix:`./dtos`,tokenScope:a})),await Lt(r,l,u,c,o),p}function vn(e,t){return`import { z } from 'zod'
+`}${u}`}}function cn(e,t){return t===`class`?sn(e):on(e)}function ln(e,t){let n=e,r=!1;if(t===`define`){/\bAppModuleClass\b/.test(n)&&(n=n.replaceAll(/\bAppModuleClass\b/g,`AppModuleEntry`),r=!0);let e=/(=\s*\[)([\s\S]*?)(])/,t=e.exec(n);if(t){let i=t[1],a=t[3],o=t[2],s=o.replaceAll(/(\b\w+Module)(?![(.])/g,`$1()`);s!==o&&(n=n.replace(e,`${i}${s}${a}`),r=!0)}}else{/\bAppModuleEntry\b/.test(n)&&(n=n.replaceAll(/\bAppModuleEntry\b/g,`AppModuleClass`),r=!0);let e=/(=\s*\[)([\s\S]*?)(])/,t=e.exec(n);if(t){let i=t[1],a=t[3],o=t[2],s=o.replaceAll(/(\b\w+Module)\s*\(\s*\)/g,`$1`);s!==o&&(n=n.replace(e,`${i}${s}${a}`),r=!0)}}return r?{migrated:n}:{migrated:null,reason:`no changes needed`}}async function un(e){let t=[];return await n(F(e),0),t;async function n(e,r){let i;try{i=await Ue(e)}catch{return}for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=N(e,a),o;try{o=await Ge(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function dn(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await Ue(e)}catch{return}await He(t,{recursive:!0});for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=N(e,a),o=N(t,a),s;try{s=await Ge(i)}catch{continue}s.isDirectory()?await r(i,o):(await Ve(i,o),n++)}}}function fn(e){let t=(/* @__PURE__ */ new Date()).toISOString().replaceAll(/[:.]/g,`-`);return N(e,`.kickjs`,`codemod-backups`,`${t}-modules`)}async function pn(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await un(e),s=await R(N(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=fn(r),await dn(e,c));let l=[];for(let e of o){let t=cn(await R(e,`utf-8`),i);t.migrated==null?l.push({path:e,status:`skipped`,reason:t.reason}):(n||await z(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`}))}let u=N(e,`index.ts`),d=null;try{d=await R(u,`utf-8`)}catch{return{target:i,files:l,indexStatus:`not-found`,indexPath:u,backupDir:c}}let f=ln(d,i);return f.migrated==null?{target:i,files:l,indexStatus:`skipped`,indexPath:u,indexReason:f.reason,backupDir:c}:(n||await z(u,f.migrated,`utf-8`),{target:i,files:l,indexStatus:`migrated`,indexPath:u,backupDir:c})}async function mn(e,t){let n=await un(e),r=[],i=t===`define`?/export\s+class\s+\w+Module\s+implements\s+AppModule\s*\{/:/export\s+const\s+\w+Module\s*=\s*defineModule\s*\(/;for(let e of n){let t=await R(e,`utf-8`);i.test(t)&&r.push(e)}return r}const hn={string:{ts:`string`,zod:`z.string()`},text:{ts:`string`,zod:`z.string()`},number:{ts:`number`,zod:`z.number()`},int:{ts:`number`,zod:`z.number().int()`},float:{ts:`number`,zod:`z.number()`},boolean:{ts:`boolean`,zod:`z.boolean()`},date:{ts:`string`,zod:`z.iso.datetime()`},email:{ts:`string`,zod:`z.email()`},url:{ts:`string`,zod:`z.url()`},uuid:{ts:`string`,zod:`z.uuid()`},json:{ts:`any`,zod:`z.any()`}};function gn(e){let t=e.map(e=>{let t=e.indexOf(`:`);if(t===-1)throw Error(`Invalid field: "${e}". Use format: name:type (e.g. title:string)`);let n=e.slice(0,t),r=e.slice(t+1);if(!n||!r)throw Error(`Invalid field: "${e}". Use format: name:type (e.g. title:string)`);let i=!1;r.endsWith(`:optional`)&&(r=r.slice(0,-9),i=!0),n.endsWith(`?`)&&(n=n.slice(0,-1),i=!0),r.endsWith(`?`)&&(r=r.slice(0,-1),i=!0);let a=r;if(a.startsWith(`enum:`)){let e=a.slice(5).split(`,`);return{name:n,type:`enum`,tsType:e.map(e=>`'${e}'`).join(` | `),zodType:`z.enum([${e.map(e=>`'${e}'`).join(`, `)}])`,optional:i}}let o=hn[a];if(!o){let e=[...Object.keys(hn),`enum:a,b,c`].join(`, `);throw Error(`Unknown field type: "${a}". Valid types: ${e}`)}return{name:n,type:a,tsType:o.ts,zodType:o.zod,optional:i}}),n=/* @__PURE__ */ new Set;for(let{name:e}of t){if(n.has(e))throw Error(`Duplicate field: "${e}". Each field name may appear once.`);n.add(e)}return t}async function _n(e){let{name:t,fields:n,modulesDir:r,repo:i=`inmemory`,tokenScope:a=`app`,style:o=`define`}=e,s=e.pluralize!==!1,c=H(t),l=B(t),u=s?U(c):c,d=s?et(l):l,f=N(r,u),p=[],m=async(e,t)=>{let n=N(f,e);await y(n,t),p.push(n)};return await m(`${c}.module.ts`,yt({pascal:l,kebab:c,plural:u,repo:i,style:o})),await m(`${c}.constants.ts`,jt({pascal:l,kebab:c})),await m(`${c}.controller.ts`,xt({pascal:l,kebab:c,plural:u,pluralPascal:d,swagger:e.swagger??!1})),await m(`${c}.service.ts`,At({pascal:l,kebab:c})),await m(`dtos/create-${c}.dto.ts`,vn(l,n)),await m(`dtos/update-${c}.dto.ts`,yn(l,n)),await m(`dtos/${c}-response.dto.ts`,bn(l,n)),await m(`${c}.repository.ts`,Dt({pascal:l,kebab:c,repoType:i,dtoPrefix:`./dtos`,tokenScope:a})),await It(r,l,u,c,o),p}function vn(e,t){return`import { z } from 'zod'
 
 export const create${e}Schema = z.object({
 ${t.map(e=>{let t=e.zodType;return`  ${e.name}: ${t}${e.optional?`.optional()`:``},`}).join(`
@@ -1246,7 +1246,7 @@ ${t.map(e=>`  ${e.name}${e.optional?`?`:``}: ${e.tsType}`).join(`
   createdAt: string
   updatedAt: string
 }
-`}async function xn(e){let{name:t,moduleName:n,modulesDir:r}=e,i=e.pluralize??!0,a=V(t),o=z(t),s=[],c;if(e.outDir)c=F(e.outDir);else if(n){let e=V(n),t=i?H(e):e;c=F(N(r??`src/modules`,t,`__tests__`))}else c=F(`src/__tests__`);let l=N(c,`${a}.test.ts`);return await y(l,`import { describe, it, expect, beforeEach } from 'vitest'
+`}async function xn(e){let{name:t,moduleName:n,modulesDir:r}=e,i=e.pluralize??!0,a=H(t),o=B(t),s=[],c;if(e.outDir)c=F(e.outDir);else if(n){let e=H(n),t=i?U(e):e;c=F(N(r??`src/modules`,t,`__tests__`))}else c=F(`src/__tests__`);let l=N(c,`${a}.test.ts`);return await y(l,`import { describe, it, expect, beforeEach } from 'vitest'
 import { Container } from '@forinda/kickjs'
 
 describe('${o}', () => {
@@ -1271,22 +1271,22 @@ describe('${o}', () => {
 })
 `),s.push(l),s}function Sn(){let e=(process.env.LOG_LEVEL??process.env.KICKJS_LOG_LEVEL??``).toLowerCase();return e===`debug`||e===`trace`}var Cn=class extends Error{drifted;constructor(e){let t=e.map(e=>`    ${e.id} → ${e.outFile}`).join(`
 `);super(`kick typegen --check: ${e.length} generated file(s) are out of date:\n${t}\n  Run \`kick typegen\` and commit the result.`),this.name=`TypegenDriftError`,this.drifted=e}};const wn=[`agents`,`claude`,`skills`,`gemini`,`copilot`,`both`,`all`];function q(e){return e.parent?.opts()?.dryRun??!1}function J(e,t=!1){let n=process.cwd();console.log(`\n  ${t?`Would generate`:`Generated`} ${e.length} file${e.length===1?``:`s`}:`);for(let t of e)console.log(`    ${t.replace(n+`/`,``)}`);t&&console.log(`
-  (dry run — no files were written)`),console.log()}async function Tn(e){if(!e)try{let e=await l(process.cwd());await we({cwd:process.cwd(),allowDuplicates:!0,silent:!0,schemaValidator:e?.typegen?.schemaValidator??`zod`,envFile:e?.typegen?.envFile,srcDir:e?.typegen?.srcDir,outDir:e?.typegen?.outDir})}catch{}}const En=[{name:`module <name>`,description:`REST module (controller, service, DTOs, repo)`},{name:`scaffold <name> <fields...>`,description:`CRUD module from field definitions`},{name:`controller <name>`,description:`@Controller() class            [-m module]`},{name:`service <name>`,description:`@Service() singleton             [-m module]`},{name:`middleware <name>`,description:`Express middleware function     [-m module]`},{name:`guard <name>`,description:`Route guard (auth, roles, etc.)  [-m module]`},{name:`contributor <name>`,description:`Context contributor       [--type http|bare] [--params a:string] [-m]`},{name:`dto <name>`,description:`Zod DTO schema                  [-m module]`},{name:`adapter <name>`,description:`AppAdapter with lifecycle hooks (app-level only)`},{name:`test <name>`,description:`Vitest test scaffold            [-m module]`},{name:`config`,description:`Generate kick.config.ts`},{name:`agents`,description:`Regenerate .agents/* + root CLAUDE.md from upstream templates`}],Dn=new Map([[`job`,`Queue processors are no longer built in — their shape belongs to whichever queue you run.
-  Add your own in kick.config.ts: https://kickjs.app/guide/plugin-generators.html`]]),On=new Set([...En.map(e=>e.name.split(` `)[0]),...Dn.keys()]);async function kn(){console.log(`
+  (dry run — no files were written)`),console.log()}async function Tn(e){if(!e)try{let e=await l(process.cwd());await Te({cwd:process.cwd(),allowDuplicates:!0,silent:!0,schemaValidator:e?.typegen?.schemaValidator??`zod`,envFile:e?.typegen?.envFile,srcDir:e?.typegen?.srcDir,outDir:e?.typegen?.outDir})}catch{}}const En=[{name:`module <name>`,description:`REST module (controller, service, DTOs, repo)`},{name:`scaffold <name> <fields...>`,description:`CRUD module from field definitions`},{name:`controller <name>`,description:`@Controller() class            [-m module]`},{name:`service <name>`,description:`@Service() singleton             [-m module]`},{name:`middleware <name>`,description:`Express middleware function     [-m module]`},{name:`guard <name>`,description:`Route guard (auth, roles, etc.)  [-m module]`},{name:`contributor <name>`,description:`Context contributor       [--type http|bare] [--params a:string] [-m]`},{name:`dto <name>`,description:`Zod DTO schema                  [-m module]`},{name:`adapter <name>`,description:`AppAdapter with lifecycle hooks (app-level only)`},{name:`test <name>`,description:`Vitest test scaffold            [-m module]`},{name:`config`,description:`Generate kick.config.ts`},{name:`agents`,description:`Regenerate .agents/* + root CLAUDE.md from upstream templates`}],Dn=/* @__PURE__ */ new Map([[`job`,`Queue processors are no longer built in — their shape belongs to whichever queue you run.
+  Add your own in kick.config.ts: https://kickjs.app/guide/plugin-generators.html`]]),On=/* @__PURE__ */ new Set([...En.map(e=>e.name.split(` `)[0]),...Dn.keys()]);async function kn(){console.log(`
   Built-in generators:
-`);let e=Math.max(...En.map(e=>e.name.length));for(let t of En)console.log(`    kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await l(process.cwd()),n=g(t?.plugins??[],t?.commands??[]),r=await ft(process.cwd(),n.generators);if(r.generators.length>0){console.log(`
+`);let e=Math.max(...En.map(e=>e.name.length));for(let t of En)console.log(`    kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await l(process.cwd()),n=g(t?.plugins??[],t?.commands??[]),r=await dt(process.cwd(),n.generators);if(r.generators.length>0){console.log(`
   Plugin generators:
 `);let e=Math.max(...r.generators.map(e=>`${e.spec.name} <name>`.length));for(let{source:t,spec:n}of r.generators){let r=`${n.name} <name>`;console.log(`    kick g ${r.padEnd(e+2)} ${n.description}  [${t}]`)}}if(r.failed.length>0){console.log(`
   Failed to load:
-`);for(let{source:e,reason:t}of r.failed)console.log(`    ${e} — ${t}`)}console.log()}function An(e,t){let n=e.parent?.opts()??{},r={...e.optsWithGlobals(),...t};for(let e of[`entity`,`tests`,`pluralize`])n[e]===!1&&(r[e]=!1);return r}async function jn(e,t,n){let r=await l(process.cwd()),i=p(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??Ft(i.repo);t.repo&&f(t.repo);let s=t.pattern??r?.pattern??`rest`,c=t.pluralize===!1?!1:i.pluralize??!0,g=u(r,process.cwd()),_=d(E()),v=h(E()),y=E(),b=m(y,`@forinda/kickjs-testing`,`any`)&&m(y,`supertest`,`any`),x=i.style??`define`;if(!n&&x===`define`){let e=await mn(F(a),`define`);if(e.length>0){console.error(`\n  ${C.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n  ${C.dim(`Project setting:`)} modules.style: 'define' (default)\n\n  ${C.bold(`Files needing migration:`)}`);for(let t of e.slice(0,5))console.error(`    - ${t}`);e.length>5&&console.error(`    … and ${e.length-5} more`),console.error(`\n  ${C.bold(`Pick one:`)}\n    1. Migrate everything to defineModule:\n       ${C.dim(`$`)} kick codemod modules --experimental --apply\n    2. Keep the class form — pin it in kick.config.ts:\n       ${C.dim(`// kick.config.ts`)}\n       ${C.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let S=[];for(let r of e){let e=await It({name:r,modulesDir:F(a),noEntity:t.entity===!1,noTests:t.tests===!1,repo:o,minimal:t.minimal,force:t.force,pattern:s,testHarness:b,dryRun:n,pluralize:c,tokenScope:g,swagger:_,schemaLib:v,style:i.style});S.push(...e)}J(S,n),await Tn(n)}function Mn(e,t){let n=e.command(`generate [names...]`).alias(`g`).description("Generate code scaffolds — bare form `kick g <name>` is shorthand for `kick g module <name>`").option(`--list`,`List all available generators`).option(`--dry-run`,`Preview files that would be generated without writing them`).option(`--no-entity`,`Skip entity and value object generation (module shortcut)`).option(`--no-tests`,`Skip test file generation (module shortcut)`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name (e.g. postgres)`).option(`--pattern <pattern>`,`Override project pattern: rest | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,r,i)=>{if(r.list){await kn();return}if(!e||e.length===0){n.help();return}let a=q(i);v(a);let[o,s,...c]=e;if(o){let e=await l(process.cwd()),n=g(e?.plugins??[],e?.commands??[]),i=await dt({generatorName:o,itemName:s??``,args:c,flags:r,cwd:process.cwd(),projectRoot:t?.projectRoot},n.generators);if(i){J(i.files,a);return}if(o!==`module`&&On.has(o)){let e=Dn.get(o);e?(console.error(`\n  'kick g ${o}' has been removed.`),console.error(`  ${e}\n`)):(console.error(`\n  '${o}' is a generator, not a module name.`),console.error(`  Did you mean:  kick g ${o} ${s??`<name>`}`),console.error(`  If that errors, your @forinda/kickjs-cli is older than the '${o}' generator — upgrade it.\n`)),process.exitCode=1;return}}await jn(e,r,a)});n.command(`module <names...>`).description(`Generate one or more modules (e.g. kick g module user task project)`).option(`--no-entity`,`Skip entity and value object generation`).option(`--no-tests`,`Skip test file generation`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name (e.g. postgres)`).option(`--pattern <pattern>`,`Override project pattern: rest | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t,n)=>{let r=q(n);v(r),await jn(e,An(n,t),r)}),n.command(`adapter <name>`).description(`Generate an AppAdapter with lifecycle hooks and middleware support`).option(`-o, --out <dir>`,`Output directory`,`src/adapters`).action(async(e,t,n)=>{let r=q(n);v(r),J(await Gt({name:e,outDir:F(t.out)}),r)}),n.command(`plugin <name>`).description(`Generate a KickPlugin with DI, modules, adapters, middleware, and lifecycle hooks`).option(`-o, --out <dir>`,`Output directory`,`src/plugins`).action(async(e,t,n)=>{let r=q(n);v(r),J(await Kt({name:e,outDir:F(t.out)}),r)}),n.command(`middleware <name>`).description(`Generate a global middleware function, typed for the configured runtime
-  Use -m to scope it to a module: kick g middleware auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await Jt({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0,runtime:i?.runtime}),r)}),n.command(`guard <name>`).description(`Generate a route guard (auth, roles, etc.)
-  Use -m to scope it to a module: kick g guard admin -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await Yt({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`contributor <name>`).description(`Generate a Context Contributor (typed alternative to @Middleware for ctx.set)
+`);for(let{source:e,reason:t}of r.failed)console.log(`    ${e} — ${t}`)}console.log()}function An(e,t){let n=e.parent?.opts()??{},r={...e.optsWithGlobals(),...t};for(let e of[`entity`,`tests`,`pluralize`])n[e]===!1&&(r[e]=!1);return r}async function jn(e,t,n){let r=await l(process.cwd()),i=p(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??Pt(i.repo);t.repo&&f(t.repo);let s=t.pattern??r?.pattern??`rest`,c=t.pluralize===!1?!1:i.pluralize??!0,g=u(r,process.cwd()),_=d(T()),v=h(T()),y=T(),b=m(y,`@forinda/kickjs-testing`,`any`)&&m(y,`supertest`,`any`),x=i.style??`define`;if(!n&&x===`define`){let e=await mn(F(a),`define`);if(e.length>0){console.error(`\n  ${C.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n  ${C.dim(`Project setting:`)} modules.style: 'define' (default)\n\n  ${C.bold(`Files needing migration:`)}`);for(let t of e.slice(0,5))console.error(`    - ${t}`);e.length>5&&console.error(`    … and ${e.length-5} more`),console.error(`\n  ${C.bold(`Pick one:`)}\n    1. Migrate everything to defineModule:\n       ${C.dim(`$`)} kick codemod modules --experimental --apply\n    2. Keep the class form — pin it in kick.config.ts:\n       ${C.dim(`// kick.config.ts`)}\n       ${C.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let S=[];for(let r of e){let e=await Ft({name:r,modulesDir:F(a),noEntity:t.entity===!1,noTests:t.tests===!1,repo:o,minimal:t.minimal,force:t.force,pattern:s,testHarness:b,dryRun:n,pluralize:c,tokenScope:g,swagger:_,schemaLib:v,style:i.style});S.push(...e)}J(S,n),await Tn(n)}function Mn(e,t){let n=e.command(`generate [names...]`).alias(`g`).description("Generate code scaffolds — bare form `kick g <name>` is shorthand for `kick g module <name>`").option(`--list`,`List all available generators`).option(`--dry-run`,`Preview files that would be generated without writing them`).option(`--no-entity`,`Skip entity and value object generation (module shortcut)`).option(`--no-tests`,`Skip test file generation (module shortcut)`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name (e.g. postgres)`).option(`--pattern <pattern>`,`Override project pattern: rest | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,r,i)=>{if(r.list){await kn();return}if(!e||e.length===0){n.help();return}let a=q(i);v(a);let[o,s,...c]=e;if(o){let e=await l(process.cwd()),n=g(e?.plugins??[],e?.commands??[]),i=await ut({generatorName:o,itemName:s??``,args:c,flags:r,cwd:process.cwd(),projectRoot:t?.projectRoot},n.generators);if(i){J(i.files,a);return}if(o!==`module`&&On.has(o)){let e=Dn.get(o);e?(console.error(`\n  'kick g ${o}' has been removed.`),console.error(`  ${e}\n`)):(console.error(`\n  '${o}' is a generator, not a module name.`),console.error(`  Did you mean:  kick g ${o} ${s??`<name>`}`),console.error(`  If that errors, your @forinda/kickjs-cli is older than the '${o}' generator — upgrade it.\n`)),process.exitCode=1;return}}await jn(e,r,a)});n.command(`module <names...>`).description(`Generate one or more modules (e.g. kick g module user task project)`).option(`--no-entity`,`Skip entity and value object generation`).option(`--no-tests`,`Skip test file generation`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name (e.g. postgres)`).option(`--pattern <pattern>`,`Override project pattern: rest | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t,n)=>{let r=q(n);v(r),await jn(e,An(n,t),r)}),n.command(`adapter <name>`).description(`Generate an AppAdapter with lifecycle hooks and middleware support`).option(`-o, --out <dir>`,`Output directory`,`src/adapters`).action(async(e,t,n)=>{let r=q(n);v(r),J(await Wt({name:e,outDir:F(t.out)}),r)}),n.command(`plugin <name>`).description(`Generate a KickPlugin with DI, modules, adapters, middleware, and lifecycle hooks`).option(`-o, --out <dir>`,`Output directory`,`src/plugins`).action(async(e,t,n)=>{let r=q(n);v(r),J(await Gt({name:e,outDir:F(t.out)}),r)}),n.command(`middleware <name>`).description(`Generate a global middleware function, typed for the configured runtime
+  Use -m to scope it to a module: kick g middleware auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await qt({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0,runtime:i?.runtime}),r)}),n.command(`guard <name>`).description(`Generate a route guard (auth, roles, etc.)
+  Use -m to scope it to a module: kick g guard admin -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await Jt({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`contributor <name>`).description(`Generate a Context Contributor (typed alternative to @Middleware for ctx.set)
   --type http (default, RequestContext) | bare (ExecutionContext)
   --params "source:string,region:number" → emits the withParams<T>() form
-  Use -m to scope it to a module: kick g contributor tenant -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).option(`-t, --type <type>`,`Contributor flavour: http | bare`,`http`).option(`-k, --key <key>`,`Context key it writes (defaults to camelCase of name)`).option(`--params <fields>`,`Per-call params, e.g. "source:string,region:number"`).action(async(e,t,n)=>{let r=q(n);v(r);let i=(t.type??`http`).toLowerCase();i!==`http`&&i!==`bare`&&(console.warn(`  kick g contributor: unknown --type '${t.type}', using 'http'.`),i=`http`);let a=await l(process.cwd()),o=p(a),s=o.dir??`src/modules`;J(await Zt({name:e,type:i,key:t.key,params:t.params,outDir:t.out,moduleName:t.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),r)}),n.command(`service <name>`).description(`Generate a @Service() class
-  Use -m to scope it to a module: kick g service payment -m orders`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await Qt({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`controller <name>`).description(`Generate a @Controller() class with basic routes
-  Use -m to scope it to a module: kick g controller auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await $t({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r),await Tn(r)}),n.command(`dto <name>`).description(`Generate a DTO schema for the project’s validation library
-  Use -m to scope it to a module: kick g dto create-user -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await en({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0,schemaLib:h(E())}),r)}),n.command(`test <name>`).description(`Generate a Vitest test scaffold
+  Use -m to scope it to a module: kick g contributor tenant -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).option(`-t, --type <type>`,`Contributor flavour: http | bare`,`http`).option(`-k, --key <key>`,`Context key it writes (defaults to camelCase of name)`).option(`--params <fields>`,`Per-call params, e.g. "source:string,region:number"`).action(async(e,t,n)=>{let r=q(n);v(r);let i=(t.type??`http`).toLowerCase();i!==`http`&&i!==`bare`&&(console.warn(`  kick g contributor: unknown --type '${t.type}', using 'http'.`),i=`http`);let a=await l(process.cwd()),o=p(a),s=o.dir??`src/modules`;J(await Xt({name:e,type:i,key:t.key,params:t.params,outDir:t.out,moduleName:t.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),r)}),n.command(`service <name>`).description(`Generate a @Service() class
+  Use -m to scope it to a module: kick g service payment -m orders`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await Zt({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`controller <name>`).description(`Generate a @Controller() class with basic routes
+  Use -m to scope it to a module: kick g controller auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await Qt({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r),await Tn(r)}),n.command(`dto <name>`).description(`Generate a DTO schema for the project’s validation library
+  Use -m to scope it to a module: kick g dto create-user -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await $t({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0,schemaLib:h(T())}),r)}),n.command(`test <name>`).description(`Generate a Vitest test scaffold
   Use -m to scope it to a module: kick g test user-service -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module's __tests__/ folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await xn({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pluralize:a.pluralize??!0}),r)}),n.command(`scaffold <name> [fields...]`).description(`Generate a full CRUD module from field definitions
   Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
   Types: string, text, number, int, float, boolean, date, email, url, uuid, json, enum:a,b,c
@@ -1296,30 +1296,30 @@ describe('${o}', () => {
   Usage: kick g scaffold <name> <field:type> [field:type...]
   Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
   Optional: append :optional (shell-safe, no quoting needed)
-`),process.exit(1));let o=await l(process.cwd()),s=p(o),c=i.modulesDir??s.dir??`src/modules`,f=gn(t),m=u(o,process.cwd()),h=d(E()),g=await _n({name:e,fields:f,modulesDir:F(c),noEntity:i.entity===!1,noTests:i.tests===!1,pluralize:i.pluralize===!1?!1:s.pluralize??!0,tokenScope:m,swagger:h,style:s.style});console.log(`\n  Scaffolded ${e} with ${f.length} field(s):`);for(let e of f)console.log(`    ${e.name}: ${e.type}${e.optional?` (optional)`:``}`);J(g,a),await Tn(a)}),n.command(`config`).description(`Generate a kick.config.ts at the project root`).option(`--modules-dir <dir>`,`Modules directory path`,`src/modules`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name`,`inmemory`).option(`-f, --force`,`Overwrite existing kick.config.ts without prompting`).action(async(e,t)=>{let n=q(t);v(n),J(await tn({outDir:F(`.`),modulesDir:e.modulesDir,defaultRepo:e.repo,force:e.force}),n)}),n.command(`agents`).alias(`agent-docs`).alias(`ai-docs`).description(`Regenerate .agents/* + root CLAUDE.md (sync after framework upgrades)`).option(`--only <which>`,`Limit scope: agents | claude | skills | gemini | copilot | both (agents+claude) | all (default: all)`,`all`).option(`--name <name>`,`Project name (defaults to package.json name)`).option(`--pm <pm>`,`Package manager (defaults to package.json packageManager)`).option(`--template <template>`,`Template: rest | minimal | fullstack`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t)=>{let n=q(t);v(n);let r=e.only??`all`;if(!wn.includes(r)){console.error(`  Invalid --only value: ${r}. Expected: ${wn.join(` | `)}`),process.exitCode=1;return}J(await re({outDir:F(`.`),only:r,name:e.name,pm:e.pm,template:e.template,force:e.force}),n)});for(let e of t?.generators??[])Nn(n,e,t?.projectRoot)}function Nn(e,t,n){let{source:r,spec:i}=t,a=i.args?.[0],o=a?.name??`itemName`,s=a?.required?`<${o}>`:`[${o}]`,c=`${i.name} ${s} [extraArgs...]`,l=e.command(c).description(`${i.description}  [${r}]`);for(let e of i.flags??[]){let t=e.takesValue?`--${e.name} <value>`:`--${e.name}`,n=e.alias?`-${e.alias}, ${t}`:t;l.option(n,e.description??``)}l.action(async(e,r,a,o)=>{let s=q(o);v(s);let c=await dt({generatorName:i.name,itemName:e??``,args:r??[],flags:a,cwd:process.cwd(),projectRoot:n},[t]);c&&J(c.files,s)})}const Pn=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: `;async function Fn(e){let t=j.resolve(e.cwd,`.kickjs/types`);e.check||await Ue(t,{recursive:!0});let n=new Map,r=e.scan??ge,i=j.resolve(e.cwd,`.kickjs`,`cache`),a=e.scan?void 0:e.changedFiles,o={cwd:e.cwd,config:e.config,async importTs(e){return await import(I(e).href)},async writeFile(t,n){let r=j.resolve(e.cwd,t);await Ue(j.dirname(r),{recursive:!0}),await R(r,n,`utf8`)},getScanResult:e=>{let t=In(e),o=n.get(t);if(!o){let s={cacheDir:i,...e};o=a?he(s,a):r(s),n.set(t,o)}return o},log:console,watch:e.watch,check:e.check},s=[],c=[];for(let n of e.plugins){let r=n.outExtension??`.d.ts`,i=j.join(t,`${n.id.replace(/\//g,`__`)}${r}`),a;try{a=await n.generate(o)}catch(t){let r=t instanceof Error?t.message:String(t);if(e.check)throw Error(`kick typegen --check: ${n.id} failed to generate (${r})`,{cause:t});o.log.error(`  ${n.id}: typegen failed (${r}) — keeping previous output`),s.push({id:n.id,status:`error`,outFile:i});continue}if(a===null){s.push({id:n.id,status:`skipped`});continue}let l=`${Pn}${n.id} */\n\n`+a+`
-`,u=``;if(O(i)&&(u=await L(i,`utf8`)),u===l){s.push({id:n.id,status:`unchanged`,outFile:i});continue}if(e.check){c.push({id:n.id,outFile:i}),s.push({id:n.id,status:`drifted`,outFile:i});continue}await R(i,l,`utf8`),s.push({id:n.id,status:`written`,outFile:i})}if(c.length>0)throw new Cn(c);return s}function In(e){let t=(e.extensions??[]).slice().toSorted().join(`,`),n=(e.exclude??[]).slice().toSorted().join(`,`);return[`root=${e.root}`,`cwd=${e.cwd}`,`extensions=${t}`,`exclude=${n}`,`envFile=${e.envFile??``}`].join(`|`)}function Ln(e,t){let n=new Set(t),r=[],i=[],a=new Set;for(let t of e)n.has(t.id)?(i.push(t),a.add(t.id)):r.push(t);return{enabled:r,skipped:i,unknown:[...n].filter(e=>!a.has(e))}}var Rn=e({applyDisableFilter:()=>Ln,runAllPluginTypegens:()=>zn});async function zn(e){let t=[...fo,...e.config?.plugins??[]],{enabled:n,skipped:r,unknown:i}=Ln(g(t,e.config?.commands??[]).typegens,e.config?.typegen?.disable??[]);if(!e.silent&&r.length>0)for(let e of r)console.log(`  ${e.id}: disabled (typegen.disable)`);if(!e.silent&&i.length>0&&console.warn(`  kick typegen: disable list references unknown id(s): ${i.map(e=>`'${e}'`).join(`, `)}. Run \`kick typegen --list\` to see registered ids.`),n.length===0)return[];try{let t=await Fn({cwd:e.cwd,config:e.config??{},plugins:n,watch:e.watch,check:e.check,changedFiles:e.changedFiles});if(!e.silent&&Sn())for(let e of t)console.log(`  ${e.id}: ${e.status}`);return t}catch(t){if(t instanceof Cn||e.check)throw t;if(!e.silent){let e=t instanceof Error?t.message:String(t);console.warn(`  kick typegen plugins: skipped (${e})`)}return[]}}function Bn(e){let t=new Map;return{report(n,r){let i=r instanceof Error?r.message:String(r);t.get(n)!==i&&(t.set(n,i),e(`  kick typegen: ${n} pass failed (${i}) — types in .kickjs/types may be stale`))},clear(e){t.delete(e)}}}function Vn(e){let{cwd:t,config:n}=e,r=e.debounceMs??100,i=e.pipeline??{runTypegen:async e=>(await import(`./typegen-vfWafXuR.mjs`).then(e=>e.n)).runTypegen(e),runAllPluginTypegens:async e=>(await Promise.resolve().then(()=>Rn)).runAllPluginTypegens(e),writeTypegenArtifacts:async(e,t,n)=>(await import(`./typegen-vfWafXuR.mjs`).then(e=>e.n)).writeTypegenArtifacts(e,t,n),buildAssets:async(e,t)=>(await import(`./build-NKAoV4wt.mjs`).then(e=>e.n)).buildAssets(e,t)},a=n?.typegen?.schemaValidator??`zod`,o=n?.typegen?.envFile,s=j.resolve(t,n?.typegen?.outDir??`.kickjs/types`),c=n?.assetMap?Object.values(n.assetMap).map(e=>e?.src).filter(e=>typeof e==`string`&&e.length>0).map(e=>j.resolve(t,e)):[],l=!!n?.assetMap&&Object.keys(n.assetMap).length>0,u=e=>e.replaceAll(`\\`,`/`),d=c.map(u),f=e=>{let t=u(e);return d.some(e=>t===e||t.startsWith(`${e}/`))},p=Bn(e.emitWarning),m=null,h=!1,g=new Set,_=new Set,v=!1,y=!1;function b(r,c){i.runTypegen({cwd:t,silent:!0,allowDuplicates:!0,schemaValidator:a,envFile:o,srcDir:n?.typegen?.srcDir,outDir:n?.typegen?.outDir,assetMap:n?.assetMap,changedFiles:r,runPlugins:!1}).then(()=>p.clear(`scan`)).catch(e=>p.report(`scan`,e)),i.runAllPluginTypegens({cwd:t,config:n,silent:!0,changedFiles:r,watch:!0}).then(e=>i.writeTypegenArtifacts(s,e,!0)).then(()=>p.clear(`plugins`)).catch(e=>p.report(`plugins`,e)).finally(()=>e.onPassComplete?.()),c&&n&&i.buildAssets(n,{cwd:t,silent:!0}).catch(()=>{})}function x(){let e=v?void 0:{changed:[...g],removed:[..._]},t=y;g.clear(),_.clear(),v=!1,y=!1,b(e,t)}return{assetSrcRoots:c,handleWatchEvent(e,t){if(!h&&!u(t).includes(`/.kickjs/`)){if(e===`unlinkDir`)v=!0,l&&(y=!0);else{if(t.endsWith(`.d.ts`))return;let n=/\.(ts|tsx|mts|cts)$/.test(t),r=f(t);if(!n&&!r)return;r&&l&&(y=!0),n&&(e===`unlink`?(_.add(t),g.delete(t)):(g.add(t),_.delete(t)))}m&&clearTimeout(m),m=setTimeout(x,r)}},runOnce(){h||b(void 0,l)},dispose(){h=!0,m&&clearTimeout(m),m=null}}}function Hn(e){let t=N(e,`node_modules`,`.bin`),n=process.platform===`win32`;for(let e of[`vue-tsc`,`tsgo`,`tsc`]){let r=n?[`${e}.CMD`,`${e}.cmd`,`${e}.exe`]:[e];for(let i of r){let r=N(t,i);if(O(r))return{cmd:r,args:[`--noEmit`],shell:n,kind:e}}}return null}function Un(e){let t=e.spawnFn??Be,n=null,r=0,i=!1;return{schedule(){if(i)return;let a=++r;n&&=(n.kill(),null);let o=Date.now(),s=t(e.bin.cmd,e.bin.args,{cwd:e.cwd,shell:e.bin.shell,stdio:[`ignore`,`pipe`,`pipe`]});n=s;let c=``;s.stdout?.on(`data`,e=>{c+=e.toString()}),s.stderr?.on(`data`,e=>{c+=e.toString()}),s.on(`error`,()=>{a===r&&(n=null)}),s.on(`close`,t=>{i||a!==r||(n=null,e.onResult({ok:t===0,output:c,durationMs:Date.now()-o,kind:e.bin.kind}))})},dispose(){i=!0,n&&=(n.kill(),null)}}}function Wn(e,t=12){let n=e.trim().split(/\r?\n/);return n.length<=t?n.join(`
+`),process.exit(1));let o=await l(process.cwd()),s=p(o),c=i.modulesDir??s.dir??`src/modules`,f=gn(t),m=u(o,process.cwd()),h=d(T()),g=await _n({name:e,fields:f,modulesDir:F(c),noEntity:i.entity===!1,noTests:i.tests===!1,pluralize:i.pluralize===!1?!1:s.pluralize??!0,tokenScope:m,swagger:h,style:s.style});console.log(`\n  Scaffolded ${e} with ${f.length} field(s):`);for(let e of f)console.log(`    ${e.name}: ${e.type}${e.optional?` (optional)`:``}`);J(g,a),await Tn(a)}),n.command(`config`).description(`Generate a kick.config.ts at the project root`).option(`--modules-dir <dir>`,`Modules directory path`,`src/modules`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name`,`inmemory`).option(`-f, --force`,`Overwrite existing kick.config.ts without prompting`).action(async(e,t)=>{let n=q(t);v(n),J(await en({outDir:F(`.`),modulesDir:e.modulesDir,defaultRepo:e.repo,force:e.force}),n)}),n.command(`agents`).alias(`agent-docs`).alias(`ai-docs`).description(`Regenerate .agents/* + root CLAUDE.md (sync after framework upgrades)`).option(`--only <which>`,`Limit scope: agents | claude | skills | gemini | copilot | both (agents+claude) | all (default: all)`,`all`).option(`--name <name>`,`Project name (defaults to package.json name)`).option(`--pm <pm>`,`Package manager (defaults to package.json packageManager)`).option(`--template <template>`,`Template: rest | minimal | fullstack | inertia`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t)=>{let n=q(t);v(n);let r=e.only??`all`;wn.includes(r)?J(await re({outDir:F(`.`),only:r,name:e.name,pm:e.pm,template:e.template,force:e.force}),n):(console.error(`  Invalid --only value: ${r}. Expected: ${wn.join(` | `)}`),process.exitCode=1)});for(let e of t?.generators??[])Nn(n,e,t?.projectRoot)}function Nn(e,t,n){let{source:r,spec:i}=t,a=i.args?.[0],o=a?.name??`itemName`,s=a?.required?`<${o}>`:`[${o}]`,c=`${i.name} ${s} [extraArgs...]`,l=e.command(c).description(`${i.description}  [${r}]`);for(let e of i.flags??[]){let t=e.takesValue?`--${e.name} <value>`:`--${e.name}`,n=e.alias?`-${e.alias}, ${t}`:t;l.option(n,e.description??``)}l.action(async(e,r,a,o)=>{let s=q(o);v(s);let c=await ut({generatorName:i.name,itemName:e??``,args:r??[],flags:a,cwd:process.cwd(),projectRoot:n},[t]);c&&J(c.files,s)})}const Pn=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: `;async function Fn(e){let t=j.resolve(e.cwd,`.kickjs/types`);e.check||await He(t,{recursive:!0});let n=/* @__PURE__ */ new Map,r=e.scan??_e,i=j.resolve(e.cwd,`.kickjs`,`cache`),a=e.scan?void 0:e.changedFiles,o={cwd:e.cwd,config:e.config,async importTs(e){return await import(L(e).href)},async writeFile(t,n){let r=j.resolve(e.cwd,t);await He(j.dirname(r),{recursive:!0}),await z(r,n,`utf8`)},getScanResult:e=>{let t=In(e),o=n.get(t);if(!o){let s={cacheDir:i,...e};o=a?ge(s,a):r(s),n.set(t,o)}return o},log:console,watch:e.watch,check:e.check},s=[],c=[];for(let n of e.plugins){let r=n.outExtension??`.d.ts`,i=j.join(t,`${n.id.replace(/\//g,`__`)}${r}`),a;try{a=await n.generate(o)}catch(t){let r=t instanceof Error?t.message:String(t);if(e.check)throw Error(`kick typegen --check: ${n.id} failed to generate (${r})`,{cause:t});o.log.error(`  ${n.id}: typegen failed (${r}) — keeping previous output`),s.push({id:n.id,status:`error`,outFile:i});continue}if(a===null){s.push({id:n.id,status:`skipped`});continue}let l=`${Pn}${n.id} */\n\n`+a+`
+`,u=``;D(i)&&(u=await R(i,`utf8`)),u===l?s.push({id:n.id,status:`unchanged`,outFile:i}):e.check?(c.push({id:n.id,outFile:i}),s.push({id:n.id,status:`drifted`,outFile:i})):(await z(i,l,`utf8`),s.push({id:n.id,status:`written`,outFile:i}))}if(c.length>0)throw new Cn(c);return s}function In(e){let t=(e.extensions??[]).slice().toSorted().join(`,`),n=(e.exclude??[]).slice().toSorted().join(`,`);return[`root=${e.root}`,`cwd=${e.cwd}`,`extensions=${t}`,`exclude=${n}`,`envFile=${e.envFile??``}`].join(`|`)}function Ln(e,t){let n=new Set(t),r=[],i=[],a=/* @__PURE__ */ new Set;for(let t of e)n.has(t.id)?(i.push(t),a.add(t.id)):r.push(t);return{enabled:r,skipped:i,unknown:[...n].filter(e=>!a.has(e))}}var Rn=/* @__PURE__ */ e({applyDisableFilter:()=>Ln,runAllPluginTypegens:()=>zn});async function zn(e){let t=[...bo,...e.config?.plugins??[]],{enabled:n,skipped:r,unknown:i}=Ln(g(t,e.config?.commands??[]).typegens,e.config?.typegen?.disable??[]);if(!e.silent&&r.length>0)for(let e of r)console.log(`  ${e.id}: disabled (typegen.disable)`);if(!e.silent&&i.length>0&&console.warn(`  kick typegen: disable list references unknown id(s): ${i.map(e=>`'${e}'`).join(`, `)}. Run \`kick typegen --list\` to see registered ids.`),n.length===0)return[];try{let t=await Fn({cwd:e.cwd,config:e.config??{},plugins:n,watch:e.watch,check:e.check,changedFiles:e.changedFiles});if(!e.silent&&Sn())for(let e of t)console.log(`  ${e.id}: ${e.status}`);return t}catch(t){if(t instanceof Cn||e.check)throw t;if(!e.silent){let e=t instanceof Error?t.message:String(t);console.warn(`  kick typegen plugins: skipped (${e})`)}return[]}}function Bn(e){let t=/* @__PURE__ */ new Map;return{report(n,r){let i=r instanceof Error?r.message:String(r);t.get(n)!==i&&(t.set(n,i),e(`  kick typegen: ${n} pass failed (${i}) — types in .kickjs/types may be stale`))},clear(e){t.delete(e)}}}function Vn(e){let{cwd:t,config:n}=e,r=e.debounceMs??100,i=e.pipeline??{runTypegen:async e=>(await import(`./typegen-up-UkaNc.mjs`).then(e=>e.n)).runTypegen(e),runAllPluginTypegens:async e=>(await Promise.resolve().then(()=>Rn)).runAllPluginTypegens(e),writeTypegenArtifacts:async(e,t,n)=>(await import(`./typegen-up-UkaNc.mjs`).then(e=>e.n)).writeTypegenArtifacts(e,t,n),buildAssets:async(e,t)=>(await import(`./build-xQXbdDpw.mjs`).then(e=>e.n)).buildAssets(e,t)},a=n?.typegen?.schemaValidator??`zod`,o=n?.typegen?.envFile,s=j.resolve(t,n?.typegen?.outDir??`.kickjs/types`),c=n?.assetMap?Object.values(n.assetMap).map(e=>e?.src).filter(e=>typeof e==`string`&&e.length>0).map(e=>j.resolve(t,e)):[],l=!!n?.assetMap&&Object.keys(n.assetMap).length>0,u=e=>e.replaceAll(`\\`,`/`),d=c.map(u),f=e=>{let t=u(e);return d.some(e=>t===e||t.startsWith(`${e}/`))},p=Bn(e.emitWarning),m=null,h=!1,g=/* @__PURE__ */ new Set,_=/* @__PURE__ */ new Set,v=!1,y=!1;function b(r,c){i.runTypegen({cwd:t,silent:!0,allowDuplicates:!0,schemaValidator:a,envFile:o,srcDir:n?.typegen?.srcDir,outDir:n?.typegen?.outDir,assetMap:n?.assetMap,changedFiles:r,runPlugins:!1}).then(()=>p.clear(`scan`)).catch(e=>p.report(`scan`,e)),i.runAllPluginTypegens({cwd:t,config:n,silent:!0,changedFiles:r,watch:!0}).then(e=>i.writeTypegenArtifacts(s,e,!0)).then(()=>p.clear(`plugins`)).catch(e=>p.report(`plugins`,e)).finally(()=>e.onPassComplete?.()),c&&n&&i.buildAssets(n,{cwd:t,silent:!0}).catch(()=>{})}function x(){let e=v?void 0:{changed:[...g],removed:[..._]},t=y;g.clear(),_.clear(),v=!1,y=!1,b(e,t)}return{assetSrcRoots:c,handleWatchEvent(e,t){if(!h&&!u(t).includes(`/.kickjs/`)){if(e===`unlinkDir`)v=!0,l&&(y=!0);else{if(t.endsWith(`.d.ts`))return;let n=/\.(ts|tsx|mts|cts)$/.test(t),r=f(t);if(!n&&!r)return;r&&l&&(y=!0),n&&(e===`unlink`?(_.add(t),g.delete(t)):(g.add(t),_.delete(t)))}m&&clearTimeout(m),m=setTimeout(x,r)}},runOnce(){h||b(void 0,l)},dispose(){h=!0,m&&clearTimeout(m),m=null}}}function Hn(e){let t=N(e,`node_modules`,`.bin`),n=process.platform===`win32`;for(let e of[`vue-tsc`,`tsgo`,`tsc`]){let r=n?[`${e}.CMD`,`${e}.cmd`,`${e}.exe`]:[e];for(let i of r){let r=N(t,i);if(D(r))return{cmd:r,args:[`--noEmit`],shell:n,kind:e}}}return null}function Un(e){let t=e.spawnFn??ze,n=null,r=0,i=!1;return{schedule(){if(i)return;let a=++r;n&&=(n.kill(),null);let o=Date.now(),s=t(e.bin.cmd,e.bin.args,{cwd:e.cwd,shell:e.bin.shell,stdio:[`ignore`,`pipe`,`pipe`]});n=s;let c=``;s.stdout?.on(`data`,e=>{c+=e.toString()}),s.stderr?.on(`data`,e=>{c+=e.toString()}),s.on(`error`,()=>{a===r&&(n=null)}),s.on(`close`,t=>{i||a!==r||(n=null,e.onResult({ok:t===0,output:c,durationMs:Date.now()-o,kind:e.bin.kind}))})},dispose(){i=!0,n&&=(n.kill(),null)}}}function Wn(e,t=12){let n=e.trim().split(/\r?\n/);return n.length<=t?n.join(`
 `):`${n.slice(0,t).join(`
-`)}\n… ${n.length-t} more line(s)`}function Gn(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function Kn(e,t=`127.0.0.1`){let n=await import(`node:inspector`);n.open(e,t,!1);let r=n.url();if(!r)throw Error(`inspector.open() reported no URL`);return r}async function qn(e,t,n={}){t&&(process.env.PORT=t);let r=Gn(n.polling),i=process.cwd(),a=await l(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await we({cwd:i,allowDuplicates:!0,schemaValidator:o,envFile:s,srcDir:a?.typegen?.srcDir,outDir:a?.typegen?.outDir,assetMap:a?.assetMap,runPlugins:!1})}catch(e){console.warn(`  kick typegen: skipped (${e?.message??e})`)}let c=F(i,a?.typegen?.outDir??`.kickjs/types`);try{let e=await zn({cwd:i,config:a});await _e(c,e,!1)}catch(e){console.warn(`  kick typegen: plugin pass skipped (${e?.message??e})`)}let{createRequire:u}=await import(`node:module`),d=u(F(`package.json`)).resolve(`vite`),{createServer:f}=await import(I(d).href);globalThis.__kickjs_typegen_owner=`kick-dev`;let p=await f({configFile:F(`vite.config.ts`),server:{port:t?parseInt(t,10):void 0,...r?{watch:{usePolling:!0,interval:100}}:{}}}),m=n.typecheck??a?.dev?.typecheck??!1,h=null,g=!0;if(m){let e=Hn(i);e?h=Un({cwd:i,bin:e,onResult:e=>{p.hot.send({type:`custom`,event:`kickjs:typecheck`,data:{ok:e.ok,output:e.output,durationMs:e.durationMs}}),e.ok?g||(g=!0,console.log(`  kick typecheck: clean again (${e.kind}, ${e.durationMs}ms)`)):(g=!1,console.warn(`\n  kick typecheck (${e.kind}, ${e.durationMs}ms):`),console.warn(Wn(e.output).replace(/^/gm,`    `)))}}):console.warn(`  kick dev: --typecheck requested but neither tsgo (@typescript/native-preview) nor typescript is installed in this project — skipping type checks.`)}let _=Vn({cwd:i,config:a,emitWarning:e=>{console.warn(e),p.hot.send({type:`custom`,event:`kickjs:typegen-error`,data:{message:e,timestamp:Date.now()}})},onPassComplete:()=>h?.schedule()});p.watcher.on(`add`,e=>_.handleWatchEvent(`add`,e)),p.watcher.on(`unlink`,e=>_.handleWatchEvent(`unlink`,e)),p.watcher.on(`change`,e=>_.handleWatchEvent(`change`,e)),p.watcher.on(`unlinkDir`,e=>_.handleWatchEvent(`unlinkDir`,e)),_.assetSrcRoots.length>0&&p.watcher.add([..._.assetSrcRoots]),await p.listen(),p.printUrls(),console.log(`
+`)}\n… ${n.length-t} more line(s)`}function Gn(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function Kn(e,t=`127.0.0.1`){let n=await import(`node:inspector`);n.open(e,t,!1);let r=n.url();if(!r)throw Error(`inspector.open() reported no URL`);return r}async function qn(e,t,n={}){t&&(process.env.PORT=t);let r=Gn(n.polling),i=process.cwd(),a=await l(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await Te({cwd:i,allowDuplicates:!0,schemaValidator:o,envFile:s,srcDir:a?.typegen?.srcDir,outDir:a?.typegen?.outDir,assetMap:a?.assetMap,runPlugins:!1})}catch(e){console.warn(`  kick typegen: skipped (${e?.message??e})`)}let c=F(i,a?.typegen?.outDir??`.kickjs/types`);try{let e=await zn({cwd:i,config:a});await ve(c,e,!1)}catch(e){console.warn(`  kick typegen: plugin pass skipped (${e?.message??e})`)}let{createRequire:u}=await import(`node:module`),d=u(F(`package.json`)).resolve(`vite`),{createServer:f}=await import(L(d).href);globalThis.__kickjs_typegen_owner=`kick-dev`;let p=await f({configFile:F(`vite.config.ts`),server:{port:t?parseInt(t,10):void 0,...r?{watch:{usePolling:!0,interval:100}}:{}}}),m=n.typecheck??a?.dev?.typecheck??!1,h=null,g=!0;if(m){let e=Hn(i);e?h=Un({cwd:i,bin:e,onResult:e=>{p.hot.send({type:`custom`,event:`kickjs:typecheck`,data:{ok:e.ok,output:e.output,durationMs:e.durationMs}}),e.ok?g||(g=!0,console.log(`  kick typecheck: clean again (${e.kind}, ${e.durationMs}ms)`)):(g=!1,console.warn(`\n  kick typecheck (${e.kind}, ${e.durationMs}ms):`),console.warn(Wn(e.output).replace(/^/gm,`    `)))}}):console.warn(`  kick dev: --typecheck requested but neither tsgo (@typescript/native-preview) nor typescript is installed in this project — skipping type checks.`)}let _=Vn({cwd:i,config:a,emitWarning:e=>{console.warn(e),p.hot.send({type:`custom`,event:`kickjs:typegen-error`,data:{message:e,timestamp:Date.now()}})},onPassComplete:()=>h?.schedule()});p.watcher.on(`add`,e=>_.handleWatchEvent(`add`,e)),p.watcher.on(`unlink`,e=>_.handleWatchEvent(`unlink`,e)),p.watcher.on(`change`,e=>_.handleWatchEvent(`change`,e)),p.watcher.on(`unlinkDir`,e=>_.handleWatchEvent(`unlinkDir`,e)),_.assetSrcRoots.length>0&&p.watcher.add([..._.assetSrcRoots]),await p.listen(),p.printUrls(),console.log(`
   KickJS dev server running (Vite + @forinda/kickjs-vite)
-`),h?.schedule();let v=!1,y=async()=>{if(!v){v=!0,_.dispose(),h?.dispose();try{await globalThis.__kickjs_app_shutdown?.()}catch(e){console.error(`  app shutdown hook failed: ${e?.message??e}`)}await p.close(),process.exit(0)}};process.on(`SIGINT`,y),process.on(`SIGTERM`,y),process.on(`SIGBREAK`,y)}async function Jn(e){let t=await l(e);try{await we({cwd:e,allowDuplicates:!0,schemaValidator:t?.typegen?.schemaValidator??`zod`,envFile:t?.typegen?.envFile,srcDir:t?.typegen?.srcDir,outDir:t?.typegen?.outDir,assetMap:t?.assetMap,runPlugins:!1});let n=F(e,t?.typegen?.outDir??`.kickjs/types`),r=await zn({cwd:e,config:t});await _e(n,r,!1)}catch(e){console.warn(`  kick typegen: skipped before typecheck (${e?.message??e}).\n  Generated types may be stale — errors inside .kickjs/types are likely from that.`)}}function Yn(e){e.command(`dev`).description(`Start development server with Vite HMR (zero-downtime reload)`).option(`-e, --entry <file>`,`Entry file`,`src/index.ts`).option(`-p, --port <port>`,`Port number`).option(`--polling`,`Force chokidar to poll for file changes (Docker / WSL / NFS / older kernels)`).option(`--typecheck`,`Run the project TypeScript checker (tsgo/tsc --noEmit) after each change and report diagnostics`).action(async e=>{try{await qn(e.entry,e.port,{polling:e.polling,typecheck:e.typecheck})}catch(e){e.code===`ERR_MODULE_NOT_FOUND`&&e.message?.includes(`vite`)?console.error(`
+`),h?.schedule();let v=!1,y=async()=>{if(!v){v=!0,_.dispose(),h?.dispose();try{await globalThis.__kickjs_app_shutdown?.()}catch(e){console.error(`  app shutdown hook failed: ${e?.message??e}`)}await p.close(),process.exit(0)}};process.on(`SIGINT`,y),process.on(`SIGTERM`,y),process.on(`SIGBREAK`,y)}async function Jn(e){let t=await l(e);try{await Te({cwd:e,allowDuplicates:!0,schemaValidator:t?.typegen?.schemaValidator??`zod`,envFile:t?.typegen?.envFile,srcDir:t?.typegen?.srcDir,outDir:t?.typegen?.outDir,assetMap:t?.assetMap,runPlugins:!1});let n=F(e,t?.typegen?.outDir??`.kickjs/types`),r=await zn({cwd:e,config:t});await ve(n,r,!1)}catch(e){console.warn(`  kick typegen: skipped before typecheck (${e?.message??e}).\n  Generated types may be stale — errors inside .kickjs/types are likely from that.`)}}function Yn(e){e.command(`dev`).description(`Start development server with Vite HMR (zero-downtime reload)`).option(`-e, --entry <file>`,`Entry file`,`src/index.ts`).option(`-p, --port <port>`,`Port number`).option(`--polling`,`Force chokidar to poll for file changes (Docker / WSL / NFS / older kernels)`).option(`--typecheck`,`Run the project TypeScript checker (tsgo/tsc --noEmit) after each change and report diagnostics`).action(async e=>{try{await qn(e.entry,e.port,{polling:e.polling,typecheck:e.typecheck})}catch(e){e.code===`ERR_MODULE_NOT_FOUND`&&e.message?.includes(`vite`)?console.error(`
   Error: vite is not installed.
   Run: pnpm add -D vite unplugin-swc
 `):console.error(`
   Dev server failed:`,e.message??e),process.exit(1)}}),e.command(`build`).description(`Build for production via Vite`).action(async()=>{console.log(`
   Building for production...
-`);let{createRequire:e}=await import(`node:module`),t=e(F(`package.json`)).resolve(`vite`),{build:n}=await import(I(t).href);await n({configFile:F(`vite.config.ts`)});let r=await l(process.cwd()),i=r?.copyDirs??[];if(i.length>0){console.log(`
-  Copying directories to dist...`);for(let e of i){let t=typeof e==`string`?e:e.src,n=typeof e==`string`?N(`dist`,e):e.dest??N(`dist`,t),r=F(t),i=F(n);if(!O(r)){console.log(`    ⚠ Skipped ${t} (not found)`);continue}Me(i,{recursive:!0}),je(r,i,{recursive:!0}),console.log(`    ✓ ${t} → ${n}`)}}if(r?.assetMap&&Object.keys(r.assetMap).length>0){console.log(`
-  Building asset map...`);try{await ke(r,{cwd:process.cwd()})}catch(e){console.error(`    ✗ asset build failed: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}console.log(`
+`);let{createRequire:e}=await import(`node:module`),t=e(F(`package.json`)).resolve(`vite`),{build:n}=await import(L(t).href);await n({configFile:F(`vite.config.ts`)});let r=await l(process.cwd()),i=r?.copyDirs??[];if(i.length>0){console.log(`
+  Copying directories to dist...`);for(let e of i){let t=typeof e==`string`?e:e.src,n=typeof e==`string`?N(`dist`,e):e.dest??N(`dist`,t),r=F(t),i=F(n);D(r)?(Ne(i,{recursive:!0}),Me(r,i,{recursive:!0}),console.log(`    ✓ ${t} → ${n}`)):console.log(`    ⚠ Skipped ${t} (not found)`)}}if(r?.assetMap&&Object.keys(r.assetMap).length>0){console.log(`
+  Building asset map...`);try{await Ae(r,{cwd:process.cwd()})}catch(e){console.error(`    ✗ asset build failed: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}console.log(`
   Build complete.
-`)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await l(process.cwd());if(!e?.assetMap||Object.keys(e.assetMap).length===0){console.log(`  No assetMap entries — nothing to build.`);return}console.log(`
-  Building asset map...`);try{await ke(e,{cwd:process.cwd()}),console.log(`
+`)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await l(process.cwd());if(!e?.assetMap||Object.keys(e.assetMap).length===0)console.log(`  No assetMap entries — nothing to build.`);else{console.log(`
+  Building asset map...`);try{await Ae(e,{cwd:process.cwd()}),console.log(`
   Asset build complete.
-`)}catch(e){console.error(`  ✗ ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}),e.command(`start`).description(`Start production server`).option(`-e, --entry <file>`,`Entry file`,`dist/index.js`).option(`-p, --port <port>`,`Port number`).action(e=>{let t={NODE_ENV:`production`};e.port&&(t.PORT=String(e.port)),a(e.entry,t)}),e.command(`typecheck`).description(`Type-check the project with its own tsgo/tsc`).option(`--cwd <dir>`,`Directory to type-check`,`.`).option(`--no-typegen`,`Skip refreshing .kickjs/types first`).action(async e=>{let t=F(process.cwd(),e.cwd??`.`);e.typegen!==!1&&await Jn(t);let n=Hn(t);if(!n){console.error(`
+`)}catch(e){console.error(`  ✗ ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}}),e.command(`start`).description(`Start production server`).option(`-e, --entry <file>`,`Entry file`,`dist/index.js`).option(`-p, --port <port>`,`Port number`).action(e=>{let t={NODE_ENV:`production`};e.port&&(t.PORT=String(e.port)),n(e.entry,t)}),e.command(`typecheck`).description(`Type-check the project with its own tsgo/tsc`).option(`--cwd <dir>`,`Directory to type-check`,`.`).option(`--no-typegen`,`Skip refreshing .kickjs/types first`).action(async e=>{let t=F(process.cwd(),e.cwd??`.`);e.typegen!==!1&&await Jn(t);let n=Hn(t);if(!n){console.error(`
   No type-checker found. Install one in this project:
     pnpm add -D typescript        (tsc)
     pnpm add -D @typescript/native-preview   (tsgo, faster)
-`),process.exit(1);return}let r=Ve(n.cmd,n.args,{stdio:`inherit`,shell:n.shell,cwd:t});process.exit(r.status??1)}),e.command(`dev:debug`).description(`Start dev server with Node.js inspector attached`).option(`-e, --entry <file>`,`Entry file`,`src/index.ts`).option(`-p, --port <port>`,`Port number`).option(`--inspect-port <port>`,`Inspector port`,`9229`).option(`--inspect-host <host>`,`Inspector bind address (use 0.0.0.0 to reach it from outside a container)`,`127.0.0.1`).action(async e=>{let t=Number(e.inspectPort??`9229`),n=e.inspectHost??`127.0.0.1`;[`127.0.0.1`,`localhost`,`::1`].includes(n)||console.warn(`  WARNING: the debugger is bound to ${n}, not loopback. Anyone who can\n  reach port ${t} can run code in this process. Use it on a trusted\n  network only, and prefer publishing the port from your container instead.`);let r;try{r=await Kn(t,n)}catch(e){console.error(`\n  Could not open the inspector on ${t}: ${e.message??e}\n  Another process may already hold it — try --inspect-port <port>.`),process.exit(1);return}console.log(`  Debugger: ${r}`);try{await qn(e.entry,e.port)}catch(e){console.error(`
-  Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function Xn(){try{let e=M(Re(import.meta.url));return JSON.parse(k(N(e,`..`,`package.json`),`utf-8`)).version??`unknown`}catch{return`unknown`}}const Zn=new Set(Object.values(o).filter(e=>e.deprecated).map(e=>e.pkg));function Qn(e){let t=N(e,`package.json`);if(!O(t))return[];let n;try{n=JSON.parse(k(t,`utf-8`))}catch{return[]}let r={...n.dependencies,...n.devDependencies};return Object.keys(r).filter(e=>e===`@forinda/kickjs`||e.startsWith(`@forinda/kickjs-`)).toSorted().map(t=>{let n=null,i=N(e,`node_modules`,...t.split(`/`),`package.json`);if(O(i))try{n=JSON.parse(k(i,`utf-8`)).version??null}catch{}return{name:t,installed:n,declared:r[t]??null,deprecated:Zn.has(t)}})}function $n(e){let t=e;for(;;){if(O(N(t,`package.json`)))return t;let e=M(t);if(e===t)return null;t=e}}function er(e){e.command(`info`).description(`Print system and framework info`).action(()=>{let e=[``,`  KickJS CLI v${Xn()}`,``,`  System:`,`    OS:       ${Xe()} ${Ze()} (${Ye()})`,`    Node:     ${process.version}`],t=$n(process.cwd()),n=t?Qn(t):[];if(!t)e.push(``,`  Packages:  (not inside a project — no package.json found)`);else if(n.length===0)e.push(``,`  Packages:  (no @forinda/kickjs* dependencies in ${t})`);else{e.push(``,`  Packages:`);let t=Math.max(...n.map(e=>e.name.length));for(let r of n){let n=r.installed??`${r.declared??`?`} (declared — not installed)`,i=r.deprecated?"  [DEPRECATED — see `kick add --list --all`]":``;e.push(`    ${r.name.padEnd(t+2)} ${n}${i}`)}}e.push(``),console.log(e.join(`
+`),process.exit(1);return}let r=Be(n.cmd,n.args,{stdio:`inherit`,shell:n.shell,cwd:t});process.exit(r.status??1)}),e.command(`dev:debug`).description(`Start dev server with Node.js inspector attached`).option(`-e, --entry <file>`,`Entry file`,`src/index.ts`).option(`-p, --port <port>`,`Port number`).option(`--inspect-port <port>`,`Inspector port`,`9229`).option(`--inspect-host <host>`,`Inspector bind address (use 0.0.0.0 to reach it from outside a container)`,`127.0.0.1`).action(async e=>{let t=Number(e.inspectPort??`9229`),n=e.inspectHost??`127.0.0.1`;[`127.0.0.1`,`localhost`,`::1`].includes(n)||console.warn(`  WARNING: the debugger is bound to ${n}, not loopback. Anyone who can\n  reach port ${t} can run code in this process. Use it on a trusted\n  network only, and prefer publishing the port from your container instead.`);let r;try{r=await Kn(t,n)}catch(e){console.error(`\n  Could not open the inspector on ${t}: ${e.message??e}\n  Another process may already hold it — try --inspect-port <port>.`),process.exit(1);return}console.log(`  Debugger: ${r}`);try{await qn(e.entry,e.port)}catch(e){console.error(`
+  Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function Xn(){try{let e=M(Le(import.meta.url));return JSON.parse(O(N(e,`..`,`package.json`),`utf-8`)).version??`unknown`}catch{return`unknown`}}const Zn=new Set(Object.values(o).filter(e=>e.deprecated).map(e=>e.pkg));function Qn(e){let t=N(e,`package.json`);if(!D(t))return[];let n;try{n=JSON.parse(O(t,`utf-8`))}catch{return[]}let r={...n.dependencies,...n.devDependencies};return Object.keys(r).filter(e=>e===`@forinda/kickjs`||e.startsWith(`@forinda/kickjs-`)).toSorted().map(t=>{let n=null,i=N(e,`node_modules`,...t.split(`/`),`package.json`);if(D(i))try{n=JSON.parse(O(i,`utf-8`)).version??null}catch{}return{name:t,installed:n,declared:r[t]??null,deprecated:Zn.has(t)}})}function $n(e){let t=e;for(;;){if(D(N(t,`package.json`)))return t;let e=M(t);if(e===t)return null;t=e}}function er(e){e.command(`info`).description(`Print system and framework info`).action(()=>{let e=[``,`  KickJS CLI v${Xn()}`,``,`  System:`,`    OS:       ${Xe()} ${Ze()} (${Ye()})`,`    Node:     ${process.version}`],t=$n(process.cwd()),n=t?Qn(t):[];if(!t)e.push(``,`  Packages:  (not inside a project — no package.json found)`);else if(n.length===0)e.push(``,`  Packages:  (no @forinda/kickjs* dependencies in ${t})`);else{e.push(``,`  Packages:`);let t=Math.max(...n.map(e=>e.name.length));for(let r of n){let n=r.installed??`${r.declared??`?`} (declared — not installed)`,i=r.deprecated?"  [DEPRECATED — see `kick add --list --all`]":``;e.push(`    ${r.name.padEnd(t+2)} ${n}${i}`)}}e.push(``),console.log(e.join(`
 `))})}const{bold:Y,dim:X,green:tr,red:nr,yellow:rr,blue:ir}=C;function ar(e){let t=Math.floor(e/86400),n=Math.floor(e%86400/3600),r=Math.floor(e%3600/60),i=e%60,a=[];return t&&a.push(`${t}d`),n&&a.push(`${n}h`),r&&a.push(`${r}m`),a.push(`${i}s`),a.join(` `)}async function or(e){let t=await fetch(e,{signal:AbortSignal.timeout(5e3)});if(!t.ok)throw Error(`${t.status} ${t.statusText}`);return t.json()}async function sr(e,t){try{return await or(`${e}${t}`)}catch{return null}}async function cr(e){let[t,n,r,i,a]=await Promise.all([sr(e,`/health`),sr(e,`/metrics`),sr(e,`/routes`),sr(e,`/container`),sr(e,`/ws`)]);return{health:t,metrics:n,routes:r,container:i,ws:a}}function lr(e,t){let{health:n,metrics:r,routes:i,container:a,ws:o}=t,s=X(`─`.repeat(60));if(console.log(),console.log(Y(`  KickJS Inspector`)+X(`  →  ${e}`)),console.log(s),n){let e=n.status===`healthy`?tr(`● healthy`):nr(`● `+n.status);console.log(`  ${Y(`Health:`)}    ${e}`)}else console.log(`  ${Y(`Health:`)}    ${nr(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?nr:r.errorRate>0?rr:tr;console.log(`  ${Y(`Uptime:`)}    ${ar(r.uptimeSeconds)}`),console.log(`  ${Y(`Requests:`)}  ${r.requests}`),console.log(`  ${Y(`Errors:`)}    ${r.serverErrors} server, ${r.clientErrors??0} client  ${X(`(`)}${t(e+`%`)}${X(`)`)}`)}if(a&&console.log(`  ${Y(`DI:`)}        ${a.count} bindings`),o&&o.enabled&&console.log(`  ${Y(`WS:`)}        ${o.connections??0} connections, ${o.namespaces??0} namespaces`),i?.routes?.length){console.log(),console.log(Y(`  Routes`)),console.log(s),console.log(`  ${X(`METHOD`)}  ${X(`PATH`.padEnd(36))} ${X(`CONTROLLER`)}`);for(let e of i.routes){let t=e.path.length>36?e.path.slice(0,33)+`...`:e.path.padEnd(36);console.log(`  ${ee(e.method)} ${t} ${ir(e.controller)}.${X(e.handler)}`)}}console.log(s),console.log()}function ur(e){e.command(`inspect [url]`).description(`Connect to a running KickJS app and display debug info`).option(`-p, --port <port>`,`Override port`).option(`-w, --watch`,`Poll every 5 seconds`).option(`-j, --json`,`Output raw JSON`).action(async(e,t)=>{let n=e??`http://localhost:3000`;if(t.port)try{let e=new URL(n);e.port=t.port,n=e.origin}catch{n=`http://localhost:${t.port}`}let r=`${n.replace(/\/$/,``)}/_debug`,i=async()=>{try{let e=await cr(r);t.json?console.log(JSON.stringify(e,null,2)):lr(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(nr(`  ✖ Could not connect to ${n}`)),console.error(X(`    ${e instanceof Error?e.message:String(e)}`))),t.watch||(process.exitCode=1)}};if(t.watch){let e=async()=>{process.stdout.write(`\x1B[2J\x1B[H`),await i()};await e(),setInterval(e,5e3)}else await i()})}function Z(e,t){let n=e.toLowerCase();return t.every(e=>n.includes(e.toLowerCase()))}function Q(e,t){let n=e.toLowerCase();return t.some(e=>n.includes(e.toLowerCase()))}const dr=[{match(e,t){let n=Z(e,[`config`,`get`])&&Q(e,[`undefined`,`null`]),r=e.includes(`@Value`)&&Q(e,[`undefined`,`is not defined`]);return!n&&!r?null:Q(e,[`vitest`,`createTestApp`,`__tests__`,`.test.`,`.spec.`])?{confidence:85,diagnosis:{id:`env-schema-not-registered-in-test`,title:`ConfigService.get() returns undefined inside a test`,explanation:`The env schema is registered by a module-load side effect in
 src/config/index.ts, and src/index.ts imports it before bootstrap().
 Tests never load src/index.ts — \`createTestApp\` builds the app
@@ -1543,7 +1543,7 @@ Then re-run \`kick explain --ai "<your error>"\`.`};let r;try{r=await import(`@f
 
 Or manually:
   pnpm add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=mr(e.cwd),s=`Error or stack trace:\n\n${e.input.trim()}`;try{let e=hr((await a.chat({messages:[{role:`system`,content:o},{role:`user`,content:s}]})).content);return e?{kind:`ok`,diagnosis:e}:{kind:`error`,message:`The LLM responded but the payload was not valid JSON in the expected shape. Try again, or file an issue with the error text.`}}catch(e){return{kind:`error`,message:`LLM request failed: ${e instanceof Error?e.message:String(e)}`}}}function mr(e){return[`You are a diagnostic assistant for KickJS, a decorator-driven Node.js`,`framework built on Express 5 and TypeScript. KickJS projects use:`,`  - @Controller, @Get, @Post, @Autowired, @Service, @Value decorators`,`  - An AppModule interface with a routes() method (NOT a @Module decorator)`,`  - Zod schemas as both runtime validators and OpenAPI sources`,`  - Ctx<KickRoutes.ControllerName['method']> for typed request context`,`  - src/config/index.ts with defineEnv/loadEnv for env schema`,'  - A side-effect `import "./config"` in src/index.ts to register the schema',`  - Container.reset() in beforeEach for DI test isolation`,``,`When the user gives you an error message or stack trace, produce a`,`structured diagnosis that helps them fix the bug. You MUST respond`,`with a single JSON object (no surrounding prose, no markdown fences)`,`matching this shape:`,``,`{`,`  "id": "<kebab-case-identifier>",`,`  "title": "<one-line problem summary>",`,`  "explanation": "<multi-line explanation of what is wrong>",`,`  "fix": "<multi-line instructions for fixing the problem>",`,`  "codeBefore": "<optional: broken code snippet>",`,`  "codeAfter": "<optional: corrected code snippet>",`,`  "docs": "<optional: KickJS doc URL that discusses this topic>"`,`}`,``,`The KickJS docs live at https://kickjs.app/ — prefer`,`that domain for any doc links you suggest.`,e?`The project is located at ${e}.`:``].filter(e=>e.length>0).join(`
-`)}function hr(e){let t=[e,gr(e),_r(e)].filter(e=>e!==null);for(let e of t)try{let t=JSON.parse(e);if(vr(t))return t}catch{continue}return null}function gr(e){let t=e.match(/```(?:json)?\s*\n([\s\S]*?)```/);return t?t[1]?.trim()??null:null}function _r(e){let t=e.indexOf(`{`);if(t===-1)return null;let n=0,r=!1,i=!1;for(let a=t;a<e.length;a++){let o=e[a];if(i){i=!1;continue}if(o===`\\`&&r){i=!0;continue}if(o===`"`){r=!r;continue}if(!r&&(o===`{`&&n++,o===`}`&&(n--,n===0)))return e.slice(t,a+1)}return null}function vr(e){if(typeof e!=`object`||!e)return!1;let t=e;return typeof t.id==`string`&&typeof t.title==`string`&&typeof t.explanation==`string`&&typeof t.fix==`string`}function yr(e){e.command(`explain [message]`).description(`Explain a KickJS error and suggest a fix`).option(`-m, --message <text>`,`Error message to explain (alternative to positional arg)`).option(`--ai`,`Fall back to LLM if no known-issue matches (requires @forinda/kickjs-ai)`).option(`--model <name>`,`Model name for the --ai fallback`,`gpt-4o-mini`).option(`--json`,`Output the diagnosis as JSON for tooling integration`).action(async(e,t)=>{let n=await Sr(e,t.message);(!n||n.trim().length===0)&&(process.stderr.write(`Error: no input provided.
+`)}function hr(e){let t=[e,gr(e),_r(e)].filter(e=>e!==null);for(let e of t)try{let t=JSON.parse(e);if(vr(t))return t}catch{continue}return null}function gr(e){let t=e.match(/```(?:json)?\s*\n([\s\S]*?)```/);return t?t[1]?.trim()??null:null}function _r(e){let t=e.indexOf(`{`);if(t===-1)return null;let n=0,r=!1,i=!1;for(let a=t;a<e.length;a++){let o=e[a];if(i)i=!1;else if(o===`\\`&&r)i=!0;else if(o===`"`)r=!r;else if(!r&&(o===`{`&&n++,o===`}`&&(n--,n===0)))return e.slice(t,a+1)}return null}function vr(e){if(typeof e!=`object`||!e)return!1;let t=e;return typeof t.id==`string`&&typeof t.title==`string`&&typeof t.explanation==`string`&&typeof t.fix==`string`}function yr(e){e.command(`explain [message]`).description(`Explain a KickJS error and suggest a fix`).option(`-m, --message <text>`,`Error message to explain (alternative to positional arg)`).option(`--ai`,`Fall back to LLM if no known-issue matches (requires @forinda/kickjs-ai)`).option(`--model <name>`,`Model name for the --ai fallback`,`gpt-4o-mini`).option(`--json`,`Output the diagnosis as JSON for tooling integration`).action(async(e,t)=>{let n=await Sr(e,t.message);(!n||n.trim().length===0)&&(process.stderr.write(`Error: no input provided.
 
 Pass a message as a positional arg, --message flag, or pipe via stdin:
   kick explain "config.get returned undefined"
@@ -1551,7 +1551,7 @@ Pass a message as a positional arg, --message flag, or pipe via stdin:
 `),process.exit(1));let r=wr(),i=fr(n,r);if(t.json&&i){process.stdout.write(JSON.stringify({matched:!0,...i},null,2)+`
 `);return}if(i){Tr(n,i.diagnosis,i.confidence);return}t.ai||(t.json&&(process.stdout.write(JSON.stringify({matched:!1},null,2)+`
 `),process.exit(2)),Er(n),process.exit(2));let a=await pr({input:n,model:t.model,cwd:r.cwd});t.json&&(process.stdout.write(JSON.stringify(br(a),null,2)+`
-`),process.exit(a.kind===`ok`?0:2)),xr(n,a),process.exit(a.kind===`ok`?0:2)})}function br(e){return e.kind===`ok`?{matched:!0,source:`ai`,diagnosis:e.diagnosis}:e.kind===`unavailable`?{matched:!1,aiUnavailable:!0,reason:e.reason}:{matched:!1,aiError:!0,error:e.message}}function xr(e,t){if(t.kind===`ok`){Tr(e,t.diagnosis,-1,!0);return}if(t.kind===`unavailable`){process.stdout.write(`\n  Explaining: ${Or(e.trim(),200)}\n\n`),process.stdout.write(`  AI fallback unavailable: ${t.reason}\n\n`),process.stdout.write(`${Dr(t.suggestion,`  `)}\n\n`);return}process.stdout.write(`\n  Explaining: ${Or(e.trim(),200)}\n\n`),process.stdout.write(`  AI fallback error: ${t.message}\n\n`)}async function Sr(e,t){return e&&e.trim().length>0?e:t&&t.trim().length>0?t:process.stdin.isTTY?``:Cr()}function Cr(){return new Promise((e,t)=>{let n=``;process.stdin.setEncoding(`utf8`),process.stdin.on(`data`,e=>{n+=e}),process.stdin.on(`end`,()=>e(n)),process.stdin.on(`error`,t)})}function wr(){let e=process.cwd();return{cwd:e,hasFile:t=>O(F(e,t))}}function Tr(e,t,n,r=!1){let i=Or(e.trim(),200),a=r?`AI-generated — verify before applying`:kr(n);process.stdout.write(`\n  Explaining: ${i}\n`),process.stdout.write(`\n  Match: ${t.id}  (${a})\n`),process.stdout.write(`  Title: ${t.title}\n`),process.stdout.write(`\n  Diagnosis:\n${Dr(t.explanation,`    `)}\n`),process.stdout.write(`\n  Fix:\n${Dr(t.fix,`    `)}\n`),t.codeBefore&&process.stdout.write(`\n  Before:\n${Dr(t.codeBefore,`      `)}\n`),t.codeAfter&&process.stdout.write(`\n  After:\n${Dr(t.codeAfter,`      `)}\n`),t.docs&&process.stdout.write(`\n  Docs: ${t.docs}\n`),process.stdout.write(`
+`),process.exit(a.kind===`ok`?0:2)),xr(n,a),process.exit(a.kind===`ok`?0:2)})}function br(e){return e.kind===`ok`?{matched:!0,source:`ai`,diagnosis:e.diagnosis}:e.kind===`unavailable`?{matched:!1,aiUnavailable:!0,reason:e.reason}:{matched:!1,aiError:!0,error:e.message}}function xr(e,t){t.kind===`ok`?Tr(e,t.diagnosis,-1,!0):t.kind===`unavailable`?(process.stdout.write(`\n  Explaining: ${Or(e.trim(),200)}\n\n`),process.stdout.write(`  AI fallback unavailable: ${t.reason}\n\n`),process.stdout.write(`${Dr(t.suggestion,`  `)}\n\n`)):(process.stdout.write(`\n  Explaining: ${Or(e.trim(),200)}\n\n`),process.stdout.write(`  AI fallback error: ${t.message}\n\n`))}async function Sr(e,t){return e&&e.trim().length>0?e:t&&t.trim().length>0?t:process.stdin.isTTY?``:Cr()}function Cr(){return new Promise((e,t)=>{let n=``;process.stdin.setEncoding(`utf8`),process.stdin.on(`data`,e=>{n+=e}),process.stdin.on(`end`,()=>e(n)),process.stdin.on(`error`,t)})}function wr(){let e=process.cwd();return{cwd:e,hasFile:t=>D(F(e,t))}}function Tr(e,t,n,r=!1){let i=Or(e.trim(),200),a=r?`AI-generated — verify before applying`:kr(n);process.stdout.write(`\n  Explaining: ${i}\n`),process.stdout.write(`\n  Match: ${t.id}  (${a})\n`),process.stdout.write(`  Title: ${t.title}\n`),process.stdout.write(`\n  Diagnosis:\n${Dr(t.explanation,`    `)}\n`),process.stdout.write(`\n  Fix:\n${Dr(t.fix,`    `)}\n`),t.codeBefore&&process.stdout.write(`\n  Before:\n${Dr(t.codeBefore,`      `)}\n`),t.codeAfter&&process.stdout.write(`\n  After:\n${Dr(t.codeAfter,`      `)}\n`),t.docs&&process.stdout.write(`\n  Docs: ${t.docs}\n`),process.stdout.write(`
 `)}function Er(e){let t=Or(e.trim(),200);process.stdout.write(`\n  Explaining: ${t}\n\n`),process.stdout.write(`  No known-issue matched. Things you can try:
 
     1. Check the framework docs for the error keywords:
@@ -1566,10 +1566,10 @@ Pass a message as a positional arg, --message flag, or pipe via stdin:
 
 `)}function Dr(e,t){return e.split(`
 `).map(e=>`${t}${e}`).join(`
-`)}function Or(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function kr(e){return e>=90?`high confidence`:e>=70?`good match`:e>=50?`medium confidence`:`low confidence — verify manually`}function Ar(e){let t=e.command(`mcp`).description(`Model Context Protocol commands (start | init)`);t.command(`start`,{isDefault:!0}).description(`Run the built application as an MCP server over stdio`).option(`-e, --entry <file>`,`Entry file`,`dist/index.js`).option(`--node-arg <arg...>`,`Extra arguments to pass to node`).action(jr),t.command(`init`).description(`Generate .mcp.json for Claude Code / Cursor / Zed`).option(`-n, --name <name>`,`Server name (defaults to package.json name)`).option(`-o, --out <file>`,`Output file`,`.mcp.json`).option(`-f, --force`,`Overwrite an existing entry without prompting`).option(`--global`,`Write to ~/.mcp.json instead of the project root`).action(Mr)}function jr(e){let t=F(e.entry);O(t)||(process.stderr.write(`Error: entry file not found: ${t}\n\nBuild the app first with \`kick build\`, or pass a custom entry:\n  kick mcp -e dist/server.js\n`),process.exit(1));let n=[...e.nodeArg??[],t],r=Be(process.execPath,n,{stdio:`inherit`,env:{...process.env,KICK_MCP_STDIO:`1`,NODE_ENV:process.env.NODE_ENV??`production`}});r.on(`error`,e=>{process.stderr.write(`Failed to start MCP server: ${e.message}\n`),process.exit(1)}),r.on(`exit`,(e,t)=>{if(t){process.kill(process.pid,t);return}process.exit(e??0)});let i=e=>{r.killed||r.kill(e)};process.on(`SIGINT`,()=>i(`SIGINT`)),process.on(`SIGTERM`,()=>i(`SIGTERM`))}function Mr(e){let t=process.cwd(),n=Nr(t)??Ie(t),r=e.name??n,i=e.global?F(process.env.HOME??`.`,`.mcp.json`):F(t,e.out),a={command:`kick`,args:[`mcp`],cwd:t},o={mcpServers:{}};if(O(i))try{let e=k(i,`utf8`),t=JSON.parse(e);t&&typeof t==`object`&&t.mcpServers&&(o={mcpServers:{...t.mcpServers}})}catch(e){let t=e instanceof Error?e.message:String(e);process.stderr.write(`Error: existing ${i} is not valid JSON (${t}).\nFix the file or pass --force to overwrite the entry.\n`),process.exit(1)}o.mcpServers[r]&&!e.force&&(process.stderr.write(`Error: an entry for "${r}" already exists in ${i}.\nPass --force to overwrite it, or use --name to pick a different key.\n`),process.exit(1)),o.mcpServers[r]=a,Fe(i,JSON.stringify(o,null,2)+`
-`,`utf8`),process.stdout.write(`\n  ✓ Wrote MCP server entry "${r}" to ${i}\n\n  To activate it:\n    1. Build your app:    kick build\n    2. Restart your MCP client (Claude Code, Cursor, Zed)\n    3. The server should appear in the client's tool picker\n\n`)}function Nr(e){let t=F(e,`package.json`);if(!O(t))return null;try{let e=k(t,`utf8`),n=JSON.parse(e);return typeof n.name==`string`?n.name:null}catch{return null}}function Pr(e){e.command(`tinker`).description(`Interactive REPL with DI container and services loaded`).option(`-e, --entry <file>`,`Entry file to load`,`src/index.ts`).action(async e=>{let t=process.cwd(),n=F(t,e.entry);O(n)||(console.error(`\n  Error: ${e.entry} not found.\n`),process.exit(1));let r=Ir(t,`tsx`);r||(console.error(`
+`)}function Or(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function kr(e){return e>=90?`high confidence`:e>=70?`good match`:e>=50?`medium confidence`:`low confidence — verify manually`}function Ar(e){let t=e.command(`mcp`).description(`Model Context Protocol commands (start | init)`);t.command(`start`,{isDefault:!0}).description(`Run the built application as an MCP server over stdio`).option(`-e, --entry <file>`,`Entry file`,`dist/index.js`).option(`--node-arg <arg...>`,`Extra arguments to pass to node`).action(jr),t.command(`init`).description(`Generate .mcp.json for Claude Code / Cursor / Zed`).option(`-n, --name <name>`,`Server name (defaults to package.json name)`).option(`-o, --out <file>`,`Output file`,`.mcp.json`).option(`-f, --force`,`Overwrite an existing entry without prompting`).option(`--global`,`Write to ~/.mcp.json instead of the project root`).action(Mr)}function jr(e){let t=F(e.entry);D(t)||(process.stderr.write(`Error: entry file not found: ${t}\n\nBuild the app first with \`kick build\`, or pass a custom entry:\n  kick mcp -e dist/server.js\n`),process.exit(1));let n=[...e.nodeArg??[],t],r=ze(process.execPath,n,{stdio:`inherit`,env:{...process.env,KICK_MCP_STDIO:`1`,NODE_ENV:process.env.NODE_ENV??`production`}});r.on(`error`,e=>{process.stderr.write(`Failed to start MCP server: ${e.message}\n`),process.exit(1)}),r.on(`exit`,(e,t)=>{t?process.kill(process.pid,t):process.exit(e??0)});let i=e=>{r.killed||r.kill(e)};process.on(`SIGINT`,()=>i(`SIGINT`)),process.on(`SIGTERM`,()=>i(`SIGTERM`))}function Mr(e){let t=process.cwd(),n=Nr(t)??Ie(t),r=e.name??n,i=e.global?F(process.env.HOME??`.`,`.mcp.json`):F(t,e.out),a={command:`kick`,args:[`mcp`],cwd:t},o={mcpServers:{}};if(D(i))try{let e=O(i,`utf8`),t=JSON.parse(e);t&&typeof t==`object`&&t.mcpServers&&(o={mcpServers:{...t.mcpServers}})}catch(e){let t=e instanceof Error?e.message:String(e);process.stderr.write(`Error: existing ${i} is not valid JSON (${t}).\nFix the file or pass --force to overwrite the entry.\n`),process.exit(1)}o.mcpServers[r]&&!e.force&&(process.stderr.write(`Error: an entry for "${r}" already exists in ${i}.\nPass --force to overwrite it, or use --name to pick a different key.\n`),process.exit(1)),o.mcpServers[r]=a,A(i,JSON.stringify(o,null,2)+`
+`,`utf8`),process.stdout.write(`\n  ✓ Wrote MCP server entry "${r}" to ${i}\n\n  To activate it:\n    1. Build your app:    kick build\n    2. Restart your MCP client (Claude Code, Cursor, Zed)\n    3. The server should appear in the client's tool picker\n\n`)}function Nr(e){let t=F(e,`package.json`);if(!D(t))return null;try{let e=O(t,`utf8`),n=JSON.parse(e);return typeof n.name==`string`?n.name:null}catch{return null}}function Pr(e){e.command(`tinker`).description(`Interactive REPL with DI container and services loaded`).option(`-e, --entry <file>`,`Entry file to load`,`src/index.ts`).action(async e=>{let t=process.cwd(),n=F(t,e.entry);D(n)||(console.error(`\n  Error: ${e.entry} not found.\n`),process.exit(1));let r=Ir(t,`tsx`);r||(console.error(`
   Error: tsx not found. Install it: pnpm add -D tsx
-`),process.exit(1));let i=Fr(n,e.entry),a=N(t,`.kick-tinker.mjs`),{writeFileSync:o,unlinkSync:s}=await import(`node:fs`);o(a,i,`utf-8`);try{let e=ze(a,[],{cwd:t,execPath:r,stdio:`inherit`});await new Promise(t=>{e.on(`exit`,()=>t())})}finally{try{s(a)}catch{}}})}function Fr(e,t){return`
+`),process.exit(1));let i=Fr(n,e.entry),a=N(t,`.kick-tinker.mjs`),{writeFileSync:o,unlinkSync:s}=await import(`node:fs`);o(a,i,`utf-8`);try{let e=Re(a,[],{cwd:t,execPath:r,stdio:`inherit`});await new Promise(t=>{e.on(`exit`,()=>t())})}finally{try{s(a)}catch{}}})}function Fr(e,t){return`
 import 'reflect-metadata'
 
 // Prevent bootstrap() from starting the HTTP server
@@ -1594,7 +1594,7 @@ try {
 
 // Load entry to trigger decorator registration
 try {
-  await import('${I(e).href}')
+  await import('${L(e).href}')
 } catch (err) {
   console.warn('  Warning: ' + err.message)
   console.warn('  Container may be partially initialized.\\n')
@@ -1623,67 +1623,81 @@ server.on('exit', () => {
   console.log('\\n  Goodbye!\\n')
   process.exit(0)
 })
-`}function Ir(e,t){let n=e;for(;;){let e=N(n,`node_modules`,`.bin`,t);if(O(e))return e;let r=F(n,`..`);if(r===n)break;n=r}return null}function Lr(e,t){let n=RegExp(`^\\s*${U(t)}Module\\b`),r=!1,i=0,a=e;for(;;){let e=a.indexOf(`.mount(`,i);if(e===-1)break;let t=e+7,o=1,s=t;for(;s<a.length&&o>0;){let e=a.slice(s,s+2);if(e===`//`||e===`/*`){if(e===`//`)for(s+=2;s<a.length&&a[s]!==`
+`}function Ir(e,t){let n=e;for(;;){let e=N(n,`node_modules`,`.bin`,t);if(D(e))return e;let r=F(n,`..`);if(r===n)break;n=r}return null}function Lr(e,t){let n=RegExp(`^\\s*${W(t)}Module\\b`),r=!1,i=0,a=e;for(;;){let e=a.indexOf(`.mount(`,i);if(e===-1)break;let t=e+7,o=1,s=t;for(;s<a.length&&o>0;){let e=a.slice(s,s+2);if(e===`//`||e===`/*`){if(e===`//`)for(s+=2;s<a.length&&a[s]!==`
 `;)s++;else{for(s+=2;s+1<a.length&&(a[s]!==`*`||a[s+1]!==`/`);)s++;s+=2}continue}let t=a[s]??``;if(t===`'`||t===`"`||t==="`"){let e=t;for(s++;s<a.length&&a[s]!==e;)a[s]===`\\`&&s++,s++}else if(t===`(`)o++;else if(t===`)`&&(o--,o===0))break;s++}if(o!==0)break;let c=a.slice(t,s);if(n.test(c)){let t=e;for(;t>0&&(a[t-1]===` `||a[t-1]===`	`||a[t-1]===`
-`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t;continue}i=s+1}return{content:a,changed:r}}function Rr(e,t){let n=zt(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=Lr(a,t).content,a=a.replace(RegExp(`\\s*,?\\s*${U(t)}Module\\b(?:\\s*\\(\\s*\\))?\\s*,?`,`g`),e=>{let t=e.trimStart().startsWith(`,`),n=e.trimEnd().endsWith(`,`);return t&&n?`,`:``}),a=a.replace(/,(\s*])/,`$1`),e.slice(0,r)+a+e.slice(i)}async function zr(e){let{name:t,modulesDir:n,force:r}=e,i=e.pluralize!==!1,a=V(t),o=z(t),s=i?H(a):a;s!==a&&!await b(N(n,s))&&await b(N(n,a))&&(s=a);let c=N(n,s);if(!await b(c)){console.log(`\n  Module not found: ${c}\n`);return}if(!r&&!await w({message:C.red(`Delete module '${s}' at ${c}? This cannot be undone.`),initialValue:!1})){console.log(`
+`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t}else i=s+1}return{content:a,changed:r}}function Rr(e,t){let n=Rt(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=Lr(a,t).content,a=a.replace(RegExp(`\\s*,?\\s*${W(t)}Module\\b(?:\\s*\\(\\s*\\))?\\s*,?`,`g`),e=>{let t=e.trimStart().startsWith(`,`),n=e.trimEnd().endsWith(`,`);return t&&n?`,`:``}),a=a.replace(/,(\s*])/,`$1`),e.slice(0,r)+a+e.slice(i)}async function zr(e){let{name:t,modulesDir:n,force:r}=e,i=e.pluralize!==!1,a=H(t),o=B(t),s=i?U(a):a;s!==a&&!await b(N(n,s))&&await b(N(n,a))&&(s=a);let c=N(n,s);if(!await b(c)){console.log(`\n  Module not found: ${c}\n`);return}if(!r&&!await oe({message:C.red(`Delete module '${s}' at ${c}? This cannot be undone.`),initialValue:!1})){console.log(`
   Cancelled.
-`);return}await Ge(c,{recursive:!0,force:!0}),console.log(`  Deleted: ${c}`);let l=N(n,`index.ts`);if(await b(l)){let e=await L(l,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${U(o)}Module\\s*\\}\\s*from\\s*['"][^'"]*${U(s)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=Rr(e,o),e=e.replace(/\n{3,}/g,`
+`);return}await We(c,{recursive:!0,force:!0}),console.log(`  Deleted: ${c}`);let l=N(n,`index.ts`);if(await b(l)){let e=await R(l,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${W(o)}Module\\s*\\}\\s*from\\s*['"][^'"]*${W(s)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=Rr(e,o),e=e.replace(/\n{3,}/g,`
 
-`),e!==t&&(await R(l,e,`utf-8`),console.log(`  Unregistered: ${o}Module from ${l}`))}console.log(`\n  Module '${s}' removed.\n`)}function Br(e){e.command(`remove`).alias(`rm`).description(`Remove generated code`).command(`module <names...>`).description(`Remove one or more modules (e.g. kick rm module user task)`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular module name`).option(`-f, --force`,`Skip confirmation prompt`).action(async(e,t)=>{let n=await l(process.cwd()),r=p(n),i=t.modulesDir??r.dir??`src/modules`,a=t.pluralize===!1?!1:r.pluralize??!0;for(let n of e)await zr({name:n,modulesDir:F(i),force:t.force,pluralize:a})})}function Vr(e){if(e!==void 0){if(e===`false`||e===`off`||e===`none`)return!1;if(e===`zod`)return`zod`;if(e===`kickjs-schema`||e===`schema`)return`kickjs-schema`;console.warn(`  kick typegen: unknown --schema-validator '${e}' (supported: 'zod', 'kickjs-schema', 'false'). Falling back to project config.`)}}function Hr(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function Ur(e){e.command(`typegen`).description(`Generate type-safe DI registry and module types into .kickjs/types/`).option(`-w, --watch`,`Watch source files and regenerate on change`).option(`-s, --src <dir>`,`Source directory to scan`,`src`).option(`-o, --out <dir>`,`Output directory`,`.kickjs/types`).option(`--silent`,`Suppress output`).option(`--allow-duplicates`,`Auto-namespace duplicate class names instead of failing (use with caution)`).option(`--schema-validator <name>`,`Schema validator for body/query/params typing (currently 'zod' or 'false')`).option(`--env-file <path>`,`Path to env schema file for KickEnv typing (default 'src/env.ts'; pass 'false' to disable)`).option(`--check`,`CI gate: exit non-zero if any generated file in .kickjs/types/ is out of date (routes, env, db, assets, adopter plugins) instead of writing it`).option(`--fix`,`Patch module import.meta.glob() calls to cover decorated classes that aren't loaded by any glob (orphans)`).option(`--list`,"List every registered typegen plugin id (use to populate `typegen.disable`)").option(`--no-cache`,`Disable the persistent scan cache; re-read + re-extract every file from cold`).action(async e=>{let t=E(process.cwd()),n=await l(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-C77kofvz.mjs`).then(e=>e.t),{builtinCliPlugins:t}=await Promise.resolve().then(()=>uo),r=e([...t,...n?.plugins??[]],n?.commands??[]),i=new Set(n?.typegen?.disable??[]);if(r.typegens.length===0){console.log(`  No typegen plugins registered.`);return}let a=Math.max(...r.typegens.map(e=>e.id.length));console.log(`
+`),e!==t&&(await z(l,e,`utf-8`),console.log(`  Unregistered: ${o}Module from ${l}`))}console.log(`\n  Module '${s}' removed.\n`)}function Br(e){e.command(`remove`).alias(`rm`).description(`Remove generated code`).command(`module <names...>`).description(`Remove one or more modules (e.g. kick rm module user task)`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular module name`).option(`-f, --force`,`Skip confirmation prompt`).action(async(e,t)=>{let n=await l(process.cwd()),r=p(n),i=t.modulesDir??r.dir??`src/modules`,a=t.pluralize===!1?!1:r.pluralize??!0;for(let n of e)await zr({name:n,modulesDir:F(i),force:t.force,pluralize:a})})}function Vr(e){if(e!==void 0){if(e===`false`||e===`off`||e===`none`)return!1;if(e===`zod`)return`zod`;if(e===`kickjs-schema`||e===`schema`)return`kickjs-schema`;console.warn(`  kick typegen: unknown --schema-validator '${e}' (supported: 'zod', 'kickjs-schema', 'false'). Falling back to project config.`)}}function Hr(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function Ur(e){e.command(`typegen`).description(`Generate type-safe DI registry and module types into .kickjs/types/`).option(`-w, --watch`,`Watch source files and regenerate on change`).option(`-s, --src <dir>`,`Source directory to scan`,`src`).option(`-o, --out <dir>`,`Output directory`,`.kickjs/types`).option(`--silent`,`Suppress output`).option(`--allow-duplicates`,`Auto-namespace duplicate class names instead of failing (use with caution)`).option(`--schema-validator <name>`,`Schema validator for body/query/params typing (currently 'zod' or 'false')`).option(`--env-file <path>`,`Path to env schema file for KickEnv typing (default 'src/env.ts'; pass 'false' to disable)`).option(`--check`,`CI gate: exit non-zero if any generated file in .kickjs/types/ is out of date (routes, env, db, assets, adopter plugins) instead of writing it`).option(`--fix`,`Patch module import.meta.glob() calls to cover decorated classes that aren't loaded by any glob (orphans)`).option(`--list`,"List every registered typegen plugin id (use to populate `typegen.disable`)").option(`--no-cache`,`Disable the persistent scan cache; re-read + re-extract every file from cold`).action(async e=>{let t=T(process.cwd()),n=await l(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-BfdvW6_r.mjs`).then(e=>e.t),{builtinCliPlugins:t}=await Promise.resolve().then(()=>yo),r=e([...t,...n?.plugins??[]],n?.commands??[]),i=new Set(n?.typegen?.disable??[]);if(r.typegens.length===0){console.log(`  No typegen plugins registered.`);return}let a=Math.max(...r.typegens.map(e=>e.id.length));console.log(`
   Registered typegen plugins:
 `);for(let e of r.typegens){let t=i.has(e.id)?`  (disabled)`:``,n=`${e.id.replace(/\//g,`__`)}${e.outExtension??`.d.ts`}`;console.log(`    ${e.id.padEnd(a+2)}→ .kickjs/types/${n}${t}`),console.log(`    ${` `.repeat(a+2)}  watches: ${e.inputs.join(`, `)||`(none)`}`)}console.log(`
   Disable one in kick.config.ts:
 `),console.log(`    typegen: { disable: ['`+(r.typegens[0]?.id??`kick/x`)+`'] }
-`);return}let r=Vr(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=Hr(e.envFile)??n?.typegen?.envFile,a={cwd:t,srcDir:e.src??n?.typegen?.srcDir,outDir:e.out??n?.typegen?.outDir,silent:e.silent,fix:e.fix,allowDuplicates:e.allowDuplicates,noCache:e.cache===!1,schemaValidator:r,envFile:i,assetMap:n?.assetMap,runPlugins:!1};try{if(e.watch){let t=await Se(a);e.silent||console.log(`  kick typegen: watching for changes (Ctrl-C to exit)`);let n=()=>{t(),process.exit(0)};process.on(`SIGINT`,n),process.on(`SIGTERM`,n),await new Promise(()=>{})}else{await we(a);let r=await zn({cwd:t,config:n??null,silent:e.silent,check:e.check});if(e.check&&r.some(e=>e.status===`written`)&&process.exit(1),!e.check){let i=F(t,e.out??n?.typegen?.outDir??`.kickjs/types`);await _e(i,r,e.silent??!1)}}}catch(e){e instanceof Ce?console.error(`
+`);return}let r=Vr(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=Hr(e.envFile)??n?.typegen?.envFile,a={cwd:t,srcDir:e.src??n?.typegen?.srcDir,outDir:e.out??n?.typegen?.outDir,silent:e.silent,fix:e.fix,allowDuplicates:e.allowDuplicates,noCache:e.cache===!1,schemaValidator:r,envFile:i,assetMap:n?.assetMap,runPlugins:!1};try{if(e.watch){let t=await Ce(a);e.silent||console.log(`  kick typegen: watching for changes (Ctrl-C to exit)`);let n=()=>{t(),process.exit(0)};process.on(`SIGINT`,n),process.on(`SIGTERM`,n),await new Promise(()=>{})}else{await Te(a);let r=await zn({cwd:t,config:n??null,silent:e.silent,check:e.check});if(e.check&&r.some(e=>e.status===`written`)&&process.exit(1),!e.check){let i=F(t,e.out??n?.typegen?.outDir??`.kickjs/types`);await ve(i,r,e.silent??!1)}}}catch(e){e instanceof we?console.error(`
 `+e.message+`
 `):e instanceof Cn?console.error(`
   `+e.message+`
-`):e instanceof Error?console.error(`\n  kick typegen failed: ${e.message}`):console.error(`\n  kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}const Wr=new Set([`Service`,`Injectable`,`Component`,`Repository`]);function Gr(e,t){return typeof t==`number`?e.slice(0,t).split(`
-`).length:1}function Kr(e){let t=se(e);if(t===`singleton`||t===`transient`||t===`request`)return t;if(ce(e)&&e.type===`MemberExpression`&&D(e.object)===`Scope`){let t=D(e.property);if(t===`SINGLETON`)return`singleton`;if(t===`TRANSIENT`)return`transient`;if(t===`REQUEST`)return`request`}return`unknown`}function qr(e){let t=D(e);if(t)return{key:`id:${t}`,label:t};let n=se(e);return n===null?null:{key:`lit:${n}`,label:`'${n}'`}}function Jr(e,t){let n=(e.body?.body??[]).find(e=>e.type===`MethodDefinition`&&e.kind===`constructor`)?.value?.params??[],r=[];for(let e of n){let n=e.type===`TSParameterProperty`?e.parameter:e,i=Ee(e).map(le).find(e=>e?.name===`Inject`),a=null;if(i)a=qr(i.call.arguments?.[0]);else{let e=n?.typeAnnotation?.typeAnnotation??null;e?.type===`TSTypeReference`&&(a=qr(e.typeName))}a&&r.push({...a,line:Gr(t,e.start)})}return r}function Yr(e){let t=new Map,n=new Map,r=[],i=(e,n)=>{t.has(e)||t.set(e,new Set),t.get(e).add(n)},a=(e,t)=>{e&&(n.has(e)||n.set(e,new Set),n.get(e).add(t))};for(let{path:t,source:n}of e){let e;try{let r=qe(t,n);if(r.errors.length>0)continue;e=r.program}catch{continue}for(let n of e.body??[]){let e=(n.type===`ExportNamedDeclaration`||n.type===`ExportDefaultDeclaration`)&&ce(n.declaration)?n.declaration:n;if(e.type===`ClassDeclaration`&&a(D(e.id),t),e.type===`VariableDeclaration`)for(let n of e.declarations??[])a(D(n.id),t)}De(e,e=>{if(e.type===`ClassDeclaration`){let a=D(e.id);if(!a)return;for(let o of Ee(e)){let s=le(o);if(s){if(s.name===`Controller`){i(`id:${a}`,`singleton`),r.push({name:a,kind:`controller`,file:t,params:Jr(e,n)});return}if(Wr.has(s.name)){let o=de(Oe(s.call),`scope`),c=o?Kr(o):`singleton`;i(`id:${a}`,c),r.push({name:a,kind:`other`,file:t,params:Jr(e,n)});return}}}return}if(e.type!==`CallExpression`)return;let a=e.callee;if(!ce(a)||a.type!==`MemberExpression`)return;let o=D(a.property);if(o!==`register`&&o!==`registerFactory`)return;let s=e.arguments??[];if(s.length<2)return;let c=qr(s[0]);c&&i(c.key,s.length>=3?Kr(s[2]):`singleton`)})}let o=e=>(n.get(e)?.size??0)<=1,s=(e,n)=>{let r=t.get(e);return r?.size===1&&r.has(n)},c=[];for(let e of r)if(o(e.name)&&s(`id:${e.name}`,`singleton`))for(let t of e.params){if(t.key.startsWith(`id:`)&&!o(t.label)||!s(t.key,`request`))continue;let n=e.kind===`controller`?`@Controller() is always SINGLETON, so inject ${t.label} with @Autowired() instead of the constructor.`:`Give ${e.name} TRANSIENT or REQUEST scope, or inject ${t.label} with @Autowired() instead of the constructor.`;c.push({file:e.file,line:t.line,parent:e.name,dependency:t.label,message:`${e.name} (SINGLETON) injects REQUEST-scoped ${t.label} through its constructor — the first request that resolves it answers 500. ${n}`})}return c}function Xr(e){let t=[];if(!O(e))return t;let n=A(e,{withFileTypes:!0});for(let r of n){let n=N(e,r.name);if(r.isDirectory()){if([`node_modules`,`dist`,`.kickjs`,`.git`].includes(r.name))continue;t.push(...Xr(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function Zr(e){try{return k(e,`utf-8`)}catch{return``}}const Qr=new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function $r(e,t){let n=Zr(N(e,`.env`));if(n){let e=n.match(/^JWT_SECRET\s*=\s*['"]?([^'"\n]*)['"]?/m);if(e){let t=e[1].trim();if(Qr.has(t.toLowerCase())||t.length<32)return{severity:`CRITICAL`,message:`JWT_SECRET appears to be a default value or too short (< 32 chars) — change it`}}}for(let e of t)for(let t of[/JWT_SECRET['"]?\s*[:=]\s*['"]?(secret|changeme|password|test|default)['"]?/i,/secret\s*[:=]\s*['"]?(secret|changeme|password|test|default)['"]?/i])if(t.test(e))return{severity:`CRITICAL`,message:`JWT_SECRET appears to be a default value in source code — use an environment variable`};return null}function ei(e){for(let t of e)if(/cors\s*\(/.test(t)&&/origin\s*:\s*['"]\*['"]/.test(t))return{severity:`CRITICAL`,message:`CORS origin is '*' — restrict to your domains`};return null}function ti(e){for(let t of e)if(/rateLimit/i.test(t)||/@RateLimit/i.test(t))return null;return{severity:`WARNING`,message:`No rate limiting detected — add rateLimit() middleware or @RateLimit decorator`}}function ni(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function ri(e){let t=!1,n=!1;for(let r of e)/tokenStore/i.test(r)&&(t=!0),/MemoryTokenStore/i.test(r)&&(n=!0);return n?{severity:`WARNING`,message:`MemoryTokenStore detected — use a persistent store (Redis, DB) for production deployments`}:t?null:{severity:`WARNING`,message:`No token revocation store detected — consider adding one for auth token management`}}function ii(e){for(let t of e)if(/helmet\s*\(/.test(t))return/security\s*\.\s*helmet\s*.*false/.test(t)?{severity:`WARNING`,message:`Helmet security headers are disabled — enable them for production`}:{severity:`INFO`,message:`Helmet security headers active`};return{severity:`WARNING`,message:`Helmet not detected — add helmet() middleware for security headers`}}function ai(e){for(let t of e)if(/AuthAdapter/i.test(t))return{severity:`INFO`,message:`AuthAdapter configured`};return{severity:`INFO`,message:`No AuthAdapter detected — add one if your app requires authentication`}}function oi(e){let t=Xr(N(e,`src`)).map(e=>Zr(e)),n=[],r=$r(e,t);r&&n.push(r);let i=ei(t);i&&n.push(i);let a=ti(t);a&&n.push(a);let o=ni();o&&n.push(o);let s=ri(t);return s&&n.push(s),n.push(ii(t)),n.push(ai(t)),n}function si(e){let t=Yr(Xr(N(e,`src`)).filter(e=>!/\.(test|spec)\.tsx?$/.test(e)).map(t=>({path:P(e,t).split(`\\`).join(`/`),source:Zr(t)})));return t.length===0?[{severity:`INFO`,message:`No REQUEST-scoped dependency injected into a singleton`}]:t.map(e=>({severity:`CRITICAL`,message:`${e.file}:${e.line} ${e.message}`}))}function ci(e){e.command(`check`).description(`Audit project for common issues`).option(`--deploy`,`Run production readiness checks`).option(`--di`,`Find REQUEST-scoped dependencies injected into singletons`).action(e=>{if(!e.deploy&&!e.di){console.log(`
+`):e instanceof Error?console.error(`\n  kick typegen failed: ${e.message}`):console.error(`\n  kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}const Wr=/* @__PURE__ */ new Set([`Service`,`Injectable`,`Component`,`Repository`]);function Gr(e,t){return typeof t==`number`?e.slice(0,t).split(`
+`).length:1}function Kr(e){let t=ce(e);if(t===`singleton`||t===`transient`||t===`request`)return t;if(le(e)&&e.type===`MemberExpression`&&E(e.object)===`Scope`){let t=E(e.property);if(t===`SINGLETON`)return`singleton`;if(t===`TRANSIENT`)return`transient`;if(t===`REQUEST`)return`request`}return`unknown`}function qr(e){let t=E(e);if(t)return{key:`id:${t}`,label:t};let n=ce(e);return n===null?null:{key:`lit:${n}`,label:`'${n}'`}}function Jr(e,t){let n=(e.body?.body??[]).find(e=>e.type===`MethodDefinition`&&e.kind===`constructor`)?.value?.params??[],r=[];for(let e of n){let n=e.type===`TSParameterProperty`?e.parameter:e,i=De(e).map(ue).find(e=>e?.name===`Inject`),a=null;if(i)a=qr(i.call.arguments?.[0]);else{let e=n?.typeAnnotation?.typeAnnotation??null;e?.type===`TSTypeReference`&&(a=qr(e.typeName))}a&&r.push({...a,line:Gr(t,e.start)})}return r}function Yr(e){let t=/* @__PURE__ */ new Map,n=/* @__PURE__ */ new Map,r=[],i=(e,n)=>{t.has(e)||t.set(e,/* @__PURE__ */ new Set),t.get(e).add(n)},a=(e,t)=>{e&&(n.has(e)||n.set(e,/* @__PURE__ */ new Set),n.get(e).add(t))};for(let{path:t,source:n}of e){let e;try{let r=qe(t,n);if(r.errors.length>0)continue;e=r.program}catch{continue}for(let n of e.body??[]){let e=(n.type===`ExportNamedDeclaration`||n.type===`ExportDefaultDeclaration`)&&le(n.declaration)?n.declaration:n;if(e.type===`ClassDeclaration`&&a(E(e.id),t),e.type===`VariableDeclaration`)for(let n of e.declarations??[])a(E(n.id),t)}Oe(e,e=>{if(e.type===`ClassDeclaration`){let a=E(e.id);if(!a)return;for(let o of De(e)){let s=ue(o);if(s){if(s.name===`Controller`){i(`id:${a}`,`singleton`),r.push({name:a,kind:`controller`,file:t,params:Jr(e,n)});return}if(Wr.has(s.name)){let o=fe(ke(s.call),`scope`),c=o?Kr(o):`singleton`;i(`id:${a}`,c),r.push({name:a,kind:`other`,file:t,params:Jr(e,n)});return}}}return}if(e.type!==`CallExpression`)return;let a=e.callee;if(!le(a)||a.type!==`MemberExpression`)return;let o=E(a.property);if(o!==`register`&&o!==`registerFactory`)return;let s=e.arguments??[];if(s.length<2)return;let c=qr(s[0]);c&&i(c.key,s.length>=3?Kr(s[2]):`singleton`)})}let o=e=>(n.get(e)?.size??0)<=1,s=(e,n)=>{let r=t.get(e);return r?.size===1&&r.has(n)},c=[];for(let e of r)if(o(e.name)&&s(`id:${e.name}`,`singleton`))for(let t of e.params){if(t.key.startsWith(`id:`)&&!o(t.label)||!s(t.key,`request`))continue;let n=e.kind===`controller`?`@Controller() is always SINGLETON, so inject ${t.label} with @Autowired() instead of the constructor.`:`Give ${e.name} TRANSIENT or REQUEST scope, or inject ${t.label} with @Autowired() instead of the constructor.`;c.push({file:e.file,line:t.line,parent:e.name,dependency:t.label,message:`${e.name} (SINGLETON) injects REQUEST-scoped ${t.label} through its constructor — the first request that resolves it answers 500. ${n}`})}return c}function Xr(e){let t=[];if(!D(e))return t;let n=k(e,{withFileTypes:!0});for(let r of n){let n=N(e,r.name);if(r.isDirectory()){if([`node_modules`,`dist`,`.kickjs`,`.git`].includes(r.name))continue;t.push(...Xr(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function Zr(e){try{return O(e,`utf-8`)}catch{return``}}const Qr=/* @__PURE__ */ new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function $r(e,t){let n=Zr(N(e,`.env`));if(n){let e=n.match(/^JWT_SECRET\s*=\s*['"]?([^'"\n]*)['"]?/m);if(e){let t=e[1].trim();if(Qr.has(t.toLowerCase())||t.length<32)return{severity:`CRITICAL`,message:`JWT_SECRET appears to be a default value or too short (< 32 chars) — change it`}}}for(let e of t)for(let t of[/JWT_SECRET['"]?\s*[:=]\s*['"]?(secret|changeme|password|test|default)['"]?/i,/secret\s*[:=]\s*['"]?(secret|changeme|password|test|default)['"]?/i])if(t.test(e))return{severity:`CRITICAL`,message:`JWT_SECRET appears to be a default value in source code — use an environment variable`};return null}function ei(e){for(let t of e)if(/cors\s*\(/.test(t)&&/origin\s*:\s*['"]\*['"]/.test(t))return{severity:`CRITICAL`,message:`CORS origin is '*' — restrict to your domains`};return null}function ti(e){for(let t of e)if(/rateLimit/i.test(t)||/@RateLimit/i.test(t))return null;return{severity:`WARNING`,message:`No rate limiting detected — add rateLimit() middleware or @RateLimit decorator`}}function ni(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function ri(e){let t=!1,n=!1;for(let r of e)/tokenStore/i.test(r)&&(t=!0),/MemoryTokenStore/i.test(r)&&(n=!0);return n?{severity:`WARNING`,message:`MemoryTokenStore detected — use a persistent store (Redis, DB) for production deployments`}:t?null:{severity:`WARNING`,message:`No token revocation store detected — consider adding one for auth token management`}}function ii(e){for(let t of e)if(/helmet\s*\(/.test(t))return/security\s*\.\s*helmet\s*.*false/.test(t)?{severity:`WARNING`,message:`Helmet security headers are disabled — enable them for production`}:{severity:`INFO`,message:`Helmet security headers active`};return{severity:`WARNING`,message:`Helmet not detected — add helmet() middleware for security headers`}}function ai(e){for(let t of e)if(/AuthAdapter/i.test(t))return{severity:`INFO`,message:`AuthAdapter configured`};return{severity:`INFO`,message:`No AuthAdapter detected — add one if your app requires authentication`}}function oi(e){let t=Xr(N(e,`src`)).map(e=>Zr(e)),n=[],r=$r(e,t);r&&n.push(r);let i=ei(t);i&&n.push(i);let a=ti(t);a&&n.push(a);let o=ni();o&&n.push(o);let s=ri(t);return s&&n.push(s),n.push(ii(t)),n.push(ai(t)),n}function si(e){let t=Yr(Xr(N(e,`src`)).filter(e=>!/\.(test|spec)\.tsx?$/.test(e)).map(t=>({path:P(e,t).split(`\\`).join(`/`),source:Zr(t)})));return t.length===0?[{severity:`INFO`,message:`No REQUEST-scoped dependency injected into a singleton`}]:t.map(e=>({severity:`CRITICAL`,message:`${e.file}:${e.line} ${e.message}`}))}function ci(e){e.command(`check`).description(`Audit project for common issues`).option(`--deploy`,`Run production readiness checks`).option(`--di`,`Find REQUEST-scoped dependencies injected into singletons`).action(e=>{if(!e.deploy&&!e.di){console.log(`
   Usage: kick check [--deploy] [--di]
 
   Available checks:
     --deploy    Audit for production readiness (security, config, best practices)
     --di        Find REQUEST-scoped dependencies injected into singleton constructors
-`);return}let t=process.cwd();te(e.deploy?`KickJS Deploy Check`:`KickJS DI Check`);let n=ne();n.start(`Scanning project...`);let r=[...e.deploy?oi(t):[],...e.di?si(t):[]];n.stop(`Scan complete`);let i={CRITICAL:0,WARNING:1,INFO:2};r.sort((e,t)=>i[e.severity]-i[t.severity]);for(let e of r)x.message(`${ae(e.severity)} ${e.message}`);let a=r.filter(e=>e.severity===`CRITICAL`).length,o=r.filter(e=>e.severity===`WARNING`).length,s=r.filter(e=>e.severity===`INFO`).length,c=o===1?`warning`:`warnings`,l=[a>0?C.red(`${a} critical`):`${a} critical`,o>0?C.yellow(`${o} ${c}`):`${o} ${c}`,`${s} info`].join(`, `);a>0?(T(C.red(`${l} — fix critical issues before deploying`)),process.exit(1)):T(C.green(`${l} — looking good!`))})}function li(e){try{return JSON.parse(k(e,`utf-8`))}catch{return null}}function ui(e){try{return k(e,`utf-8`)}catch{return null}}function di(e){let t=e.replace(/\/\*[\s\S]*?\*\//g,``).replace(/(^|[^:"'\\])\/\/.*$/gm,`$1`).replace(/,(\s*[}\]])/g,`$1`);try{return JSON.parse(t)}catch{return null}}function fi(e){let t=N(e,`tsconfig.json`);if(O(t))return pi(t,new Set)}function pi(e,t){if(t.has(e)||t.size>=16)return null;t.add(e);let n=ui(e);if(n===null)return null;let r=di(n);if(typeof r!=`object`||!r)return null;let i=Array.isArray(r.extends)?r.extends:typeof r.extends==`string`?[r.extends]:[],a={};for(let n of i){if(typeof n!=`string`)continue;let r=mi(M(e),n);if(!r)continue;let i=pi(r,t);i&&Object.assign(a,i.compilerOptions)}return r.compilerOptions={...a,...r.compilerOptions},r}function mi(e,t){if(t.startsWith(`.`)||t.startsWith(`/`))return hi(F(e,t));let n=e;for(;;){let e=hi(N(n,`node_modules`,t));if(e)return e;let r=M(n);if(r===n)break;n=r}return null}function hi(e){if(O(e)){try{if(Pe(e).isDirectory()){let t=N(e,`tsconfig.json`);return O(t)?t:null}}catch{return null}return e}let t=`${e}.json`;return O(t)?t:null}function gi(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}function _i(){let e=process.version,t=Number.parseInt(e.replace(/^v/,``).split(`.`)[0],10);return Number.isNaN(t)||t<20?{name:`Node version`,status:`fail`,message:e,fix:`KickJS requires Node 20 or newer.
-Install a supported version via nvm / fnm / volta.`}:{name:`Node version`,status:`pass`,message:e}}function vi(e){if(!e.pkg)return{name:`@forinda/kickjs installed`,status:`warn`,message:`no package.json`};let t={...e.pkg.dependencies,...e.pkg.peerDependencies};return t[`@forinda/kickjs`]?{name:`@forinda/kickjs installed`,status:`pass`,message:t[`@forinda/kickjs`]}:{name:`@forinda/kickjs installed`,status:`fail`,fix:"This directory does not look like a KickJS project — `@forinda/kickjs` is not in your package.json. Run `kick doctor` from the project root, or scaffold a fresh project with `kick new <name>`."}}function yi(e){if(!e.pkg)return null;let t={...e.pkg.dependencies,...e.pkg.peerDependencies};return t[`@forinda/kickjs`]&&!t.express?{name:`express installed`,status:`fail`,fix:"`@forinda/kickjs` declares `express` as a required peer dependency, but your package.json does not include it. Install: pnpm add express"}:t.express?{name:`express installed`,status:`pass`,message:t.express}:null}const bi={express:[],fastify:[`fastify`,`@fastify/middie`],h3:[`h3`]};function xi(e){if(!e.pkg||e.runtime===`express`)return null;let t={...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies},n=bi[e.runtime].filter(e=>!t[e]),r=`runtime engine (${e.runtime})`;return n.length>0?{name:r,status:`fail`,fix:`Resolved runtime '${e.runtime}' is missing engine peer(s): ${n.join(`, `)}.\nInstall: pnpm add ${n.join(` `)}`}:{name:r,status:`pass`}}function Si(e){if(!e.pkg||!wi(e.cwd))return null;let t=n[e.runtime],r=`upload driver (${e.runtime})`;return t.prod?{...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies}[t.prod]?{name:r,status:`pass`,message:t.prod}:{name:r,status:`fail`,fix:`This project uses file uploads on the '${e.runtime}' runtime, which needs '${t.prod}'.\nInstall it: kick add upload (or pnpm add ${t.prod})`}:{name:r,status:`pass`,message:`native multipart`}}const Ci=2e3;function wi(e){let t=N(e,`src`);if(!O(t))return!1;let n=/@FileUpload\b|\bupload\.(single|array|none)\s*\(/,r=[t],i=0;for(;r.length>0&&i<Ci;){let e=r.pop(),t;try{t=A(e,{withFileTypes:!0})}catch{continue}for(let a of t){if(i>=Ci)break;let t=N(e,a.name);if(a.isDirectory()){a.name!==`node_modules`&&r.push(t);continue}if(/\.(ts|tsx|mts|cts)$/.test(a.name)&&(i++,n.test(ui(t)??``)))return!0}}return!1}function Ti(e){if(!e.pkg)return{name:`reflect-metadata installed`,status:`warn`,message:`no package.json`};let t={...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies};return t[`reflect-metadata`]?{name:`reflect-metadata installed`,status:`pass`,message:t[`reflect-metadata`]}:{name:`reflect-metadata installed`,status:`fail`,fix:`KickJS decorators require the reflect-metadata polyfill.
+`);return}let t=process.cwd();te(e.deploy?`KickJS Deploy Check`:`KickJS DI Check`);let n=ne();n.start(`Scanning project...`);let r=[...e.deploy?oi(t):[],...e.di?si(t):[]];n.stop(`Scan complete`);let i={CRITICAL:0,WARNING:1,INFO:2};r.sort((e,t)=>i[e.severity]-i[t.severity]);for(let e of r)x.message(`${ae(e.severity)} ${e.message}`);let a=r.filter(e=>e.severity===`CRITICAL`).length,o=r.filter(e=>e.severity===`WARNING`).length,s=r.filter(e=>e.severity===`INFO`).length,c=o===1?`warning`:`warnings`,l=[a>0?C.red(`${a} critical`):`${a} critical`,o>0?C.yellow(`${o} ${c}`):`${o} ${c}`,`${s} info`].join(`, `);a>0?(w(C.red(`${l} — fix critical issues before deploying`)),process.exit(1)):w(C.green(`${l} — looking good!`))})}function li(e){try{return JSON.parse(O(e,`utf-8`))}catch{return null}}function ui(e){try{return O(e,`utf-8`)}catch{return null}}function di(e){let t=e.replace(/\/\*[\s\S]*?\*\//g,``).replace(/(^|[^:"'\\])\/\/.*$/gm,`$1`).replace(/,(\s*[}\]])/g,`$1`);try{return JSON.parse(t)}catch{return null}}function fi(e){let t=N(e,`tsconfig.json`);if(D(t))return pi(t,/* @__PURE__ */ new Set)}function pi(e,t){if(t.has(e)||t.size>=16)return null;t.add(e);let n=ui(e);if(n===null)return null;let r=di(n);if(typeof r!=`object`||!r)return null;let i=Array.isArray(r.extends)?r.extends:typeof r.extends==`string`?[r.extends]:[],a={};for(let n of i){if(typeof n!=`string`)continue;let r=mi(M(e),n);if(!r)continue;let i=pi(r,t);i&&Object.assign(a,i.compilerOptions)}return r.compilerOptions={...a,...r.compilerOptions},r}function mi(e,t){if(t.startsWith(`.`)||t.startsWith(`/`))return hi(F(e,t));let n=e;for(;;){let e=hi(N(n,`node_modules`,t));if(e)return e;let r=M(n);if(r===n)break;n=r}return null}function hi(e){if(D(e)){try{if(Fe(e).isDirectory()){let t=N(e,`tsconfig.json`);return D(t)?t:null}}catch{return null}return e}let t=`${e}.json`;return D(t)?t:null}function gi(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}function _i(){let e=process.version,t=Number.parseInt(e.replace(/^v/,``).split(`.`)[0],10);return Number.isNaN(t)||t<20?{name:`Node version`,status:`fail`,message:e,fix:`KickJS requires Node 20 or newer.
+Install a supported version via nvm / fnm / volta.`}:{name:`Node version`,status:`pass`,message:e}}function vi(e){if(!e.pkg)return{name:`@forinda/kickjs installed`,status:`warn`,message:`no package.json`};let t={...e.pkg.dependencies,...e.pkg.peerDependencies};return t[`@forinda/kickjs`]?{name:`@forinda/kickjs installed`,status:`pass`,message:t[`@forinda/kickjs`]}:{name:`@forinda/kickjs installed`,status:`fail`,fix:"This directory does not look like a KickJS project — `@forinda/kickjs` is not in your package.json. Run `kick doctor` from the project root, or scaffold a fresh project with `kick new <name>`."}}function yi(e){if(!e.pkg)return null;let t={...e.pkg.dependencies,...e.pkg.peerDependencies};return t[`@forinda/kickjs`]&&!t.express?{name:`express installed`,status:`fail`,fix:"`@forinda/kickjs` declares `express` as a required peer dependency, but your package.json does not include it. Install: pnpm add express"}:t.express?{name:`express installed`,status:`pass`,message:t.express}:null}const bi={express:[],fastify:[`fastify`,`@fastify/middie`],h3:[`h3`]};function xi(e){if(!e.pkg||e.runtime===`express`)return null;let t={...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies},n=bi[e.runtime].filter(e=>!t[e]),r=`runtime engine (${e.runtime})`;return n.length>0?{name:r,status:`fail`,fix:`Resolved runtime '${e.runtime}' is missing engine peer(s): ${n.join(`, `)}.\nInstall: pnpm add ${n.join(` `)}`}:e.runtime===`h3`&&Si(e.cwd,t.h3)===1?{name:r,status:`fail`,message:`h3 v1`,fix:`This version of @forinda/kickjs runs on h3 v2 only. Upgrade: pnpm add h3@^2 — no code change for apps that only use KickJS APIs.`}:{name:r,status:`pass`}}function Si(e,t){let n=t;for(let t=F(e);;t=M(t)){try{n=JSON.parse(O(N(t,`node_modules`,`h3`,`package.json`),`utf8`)).version;break}catch{}if(M(t)===t)break}let r=/(\d+)/.exec(n)?.[1];return r===void 0?void 0:Number(r)}function Ci(e){if(!e.pkg||!Ti(e.cwd))return null;let t=r[e.runtime],n=`upload driver (${e.runtime})`;return t.prod?{...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies}[t.prod]?{name:n,status:`pass`,message:t.prod}:{name:n,status:`fail`,fix:`This project uses file uploads on the '${e.runtime}' runtime, which needs '${t.prod}'.\nInstall it: kick add upload (or pnpm add ${t.prod})`}:{name:n,status:`pass`,message:`native multipart`}}const wi=2e3;function Ti(e){let t=N(e,`src`);if(!D(t))return!1;let n=/@FileUpload\b|\bupload\.(single|array|none)\s*\(/,r=[t],i=0;for(;r.length>0&&i<wi;){let e=r.pop(),t;try{t=k(e,{withFileTypes:!0})}catch{continue}for(let a of t){if(i>=wi)break;let t=N(e,a.name);if(a.isDirectory())a.name!==`node_modules`&&r.push(t);else if(/\.(ts|tsx|mts|cts)$/.test(a.name)&&(i++,n.test(ui(t)??``)))return!0}}return!1}function Ei(e){if(!e.pkg)return{name:`reflect-metadata installed`,status:`warn`,message:`no package.json`};let t={...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies};return t[`reflect-metadata`]?{name:`reflect-metadata installed`,status:`pass`,message:t[`reflect-metadata`]}:{name:`reflect-metadata installed`,status:`fail`,fix:`KickJS decorators require the reflect-metadata polyfill.
 Install it: pnpm add reflect-metadata
 Then import it at the top of src/index.ts:
 
   import 'reflect-metadata'
-  // ... rest of bootstrap`}}function Ei(e){if(e.tsconfig===void 0)return[{name:`tsconfig.json present`,status:`fail`,fix:"Create a tsconfig.json with `experimentalDecorators: true` and `emitDecoratorMetadata: true`. `kick new` scaffolds one automatically."}];if(e.tsconfig===null)return[{name:`tsconfig.json readable`,status:`warn`,message:`could not parse tsconfig.json (or a config it extends)`,fix:"Check tsconfig.json for a syntax error, and that every path in its `extends` chain resolves. Decorator options could not be verified."}];let t=e.tsconfig.compilerOptions??{},n=[];return n.push(t.experimentalDecorators===!0?{name:`tsconfig: experimentalDecorators`,status:`pass`}:{name:`tsconfig: experimentalDecorators`,status:`fail`,fix:'Add `"experimentalDecorators": true` to compilerOptions in tsconfig.json. Without it, @Service / @Controller / @Get etc. don\'t register any metadata at compile time.'}),n.push(t.emitDecoratorMetadata===!0?{name:`tsconfig: emitDecoratorMetadata`,status:`pass`}:{name:`tsconfig: emitDecoratorMetadata`,status:`fail`,fix:'Add `"emitDecoratorMetadata": true` to compilerOptions in tsconfig.json. The DI container uses this metadata for constructor-parameter injection.'}),n}function Di(e){let t=[`src/env.ts`,`src/env/index.ts`,`src/config/env.ts`,`src/config/index.ts`].map(t=>N(e.cwd,t)).filter(e=>O(e)).filter(e=>/\bloadEnv\s*\(/.test(ui(e)??``));if(t.length===0)return null;let n=[`src/index.ts`,`src/main.ts`].map(t=>N(e.cwd,t)).find(e=>O(e));if(!n)return{name:`env wiring`,status:`warn`,message:`env-init file exists but no src/index.ts or src/main.ts found`};let r=ui(n)??``,i=M(n),a=[];for(let e of t){let t=P(i,e).replace(/\\/g,`/`).replace(/\.ts$/,``),n=t.startsWith(`.`)?t:`./`+t,r=n.replace(/\/index$/,``);a.push(n,r);let o=e.replace(/\\/g,`/`).match(/\/src\/(.+?)(?:\.ts)?$/);if(o){let e=`@/`+o[1],t=e.replace(/\/index$/,``);a.push(e,t)}}let o=-1;for(let e of new Set(a)){let t=RegExp(`^import\\s+(?:.*?from\\s+)?['"]${gi(e)}['"]`,`m`),n=r.match(t);n&&n.index!==void 0&&(o===-1||n.index<o)&&(o=n.index)}let s=r.search(/\bbootstrap\s*\(/),c=t.map(t=>P(e.cwd,t).replace(/\\/g,`/`)).join(`, `);return o===-1?{name:`env wiring`,status:`fail`,message:c,fix:`An env-init file (${c}) calls \`loadEnv(...)\` but \`${P(e.cwd,n).replace(/\\/g,`/`)}\` doesn't import it.\nWithout this, ConfigService.get('X') returns undefined while @Value('X') works via process.env fallback — a half-broken config you won't notice until something is missing.\n\nFix: add a side-effect import at the top of ${P(e.cwd,n).replace(/\\/g,`/`)} (above bootstrap()), pointing at one of the detected files. For example:\n\n  import './env'\n  // or\n  import './config'\n  // or, with the @/ alias:\n  import '@/config/env'`}:s!==-1&&o>s?{name:`env wiring`,status:`warn`,message:`env-init imported AFTER bootstrap() — should be before`,fix:`Move the env import above the bootstrap() call so the schema runs before any service reads from ConfigService.`}:{name:`env wiring`,status:`pass`}}function Oi(e,t=ki){let n=0,r=0,i=[e];for(;i.length>0&&r<t;){let e=i.pop(),a;try{a=A(e,{withFileTypes:!0})}catch{continue}for(let o of a){if(r>=t)break;r++;let a=N(e,o.name);if(o.isDirectory()){i.push(a);continue}try{let e=Pe(a).mtimeMs;e>n&&(n=e)}catch{}}}return n}const ki=2e3;function Ai(e){let t=N(e.cwd,`.kickjs`,`types`);if(!O(t))return null;let n=Oi(t);if(n===0)return null;let r=Date.now()-n,i=Math.floor(r/6e4);return i>60?{name:`typegen freshness`,status:`warn`,message:`last updated ${i} minutes ago`,fix:"Re-run `kick typegen` (or `kick dev`, which runs it on every reload) so generated types match the current code."}:{name:`typegen freshness`,status:`pass`,message:i===0?`just now`:`${i}m ago`}}const ji=[`vitest.config.ts`,`vitest.config.js`,`vitest.config.mts`,`vite.config.ts`,`jest.config.ts`,`jest.config.js`],Mi=[`.env.test`,`.env.test.local`],Ni=[`.env`,`.env.local`];function Pi(e){let t=e.pkg?.scripts;if(t&&typeof t==`object`)for(let[e,n]of Object.entries(t)){if(!e.startsWith(`test`)||typeof n!=`string`)continue;let t=/KICKJS_ENV_FILE=(\S+)/.exec(n);if(t?.[1])return t[1]}return process.env.KICKJS_ENV_FILE??null}function Fi(e){if(!ji.some(t=>O(N(e.cwd,t))))return null;let t=Ni.filter(t=>O(N(e.cwd,t)));if(t.length===0)return null;let n=Mi.filter(t=>O(N(e.cwd,t)));if(n.length>0){let t=Pi(e);return t&&t!==`off`&&t!==`none`?{name:`test env isolation`,status:`warn`,message:`${n.join(`, `)} present, but KICKJS_ENV_FILE=${t} overrides it`,fix:`KICKJS_ENV_FILE is checked before test-mode isolation, so ${n[0]} is\nignored and "${t}" is read instead. Drop the override to use the\ntest files, or set KICKJS_ENV_FILE=off if env comes from the runner.`}:{name:`test env isolation`,status:`pass`,message:`${n.join(`, `)} present`}}return{name:`test env isolation`,status:`warn`,message:`${t.join(`, `)} present, no .env.test`,fix:`Under NODE_ENV=test (or vitest's VITEST) KickJS reads .env.test / .env.test.local
+  // ... rest of bootstrap`}}function Di(e){if(e.tsconfig===void 0)return[{name:`tsconfig.json present`,status:`fail`,fix:"Create a tsconfig.json with `experimentalDecorators: true` and `emitDecoratorMetadata: true`. `kick new` scaffolds one automatically."}];if(e.tsconfig===null)return[{name:`tsconfig.json readable`,status:`warn`,message:`could not parse tsconfig.json (or a config it extends)`,fix:"Check tsconfig.json for a syntax error, and that every path in its `extends` chain resolves. Decorator options could not be verified."}];let t=e.tsconfig.compilerOptions??{},n=[];return n.push(t.experimentalDecorators===!0?{name:`tsconfig: experimentalDecorators`,status:`pass`}:{name:`tsconfig: experimentalDecorators`,status:`fail`,fix:'Add `"experimentalDecorators": true` to compilerOptions in tsconfig.json. Without it, @Service / @Controller / @Get etc. don\'t register any metadata at compile time.'}),n.push(t.emitDecoratorMetadata===!0?{name:`tsconfig: emitDecoratorMetadata`,status:`pass`}:{name:`tsconfig: emitDecoratorMetadata`,status:`fail`,fix:'Add `"emitDecoratorMetadata": true` to compilerOptions in tsconfig.json. The DI container uses this metadata for constructor-parameter injection.'}),n}function Oi(e){let t=[`src/env.ts`,`src/env/index.ts`,`src/config/env.ts`,`src/config/index.ts`].map(t=>N(e.cwd,t)).filter(e=>D(e)).filter(e=>/\bloadEnv\s*\(/.test(ui(e)??``));if(t.length===0)return null;let n=[`src/index.ts`,`src/main.ts`].map(t=>N(e.cwd,t)).find(e=>D(e));if(!n)return{name:`env wiring`,status:`warn`,message:`env-init file exists but no src/index.ts or src/main.ts found`};let r=ui(n)??``,i=M(n),a=[];for(let e of t){let t=P(i,e).replace(/\\/g,`/`).replace(/\.ts$/,``),n=t.startsWith(`.`)?t:`./`+t,r=n.replace(/\/index$/,``);a.push(n,r);let o=e.replace(/\\/g,`/`).match(/\/src\/(.+?)(?:\.ts)?$/);if(o){let e=`@/`+o[1],t=e.replace(/\/index$/,``);a.push(e,t)}}let o=-1;for(let e of new Set(a)){let t=RegExp(`^import\\s+(?:.*?from\\s+)?['"]${gi(e)}['"]`,`m`),n=r.match(t);n&&n.index!==void 0&&(o===-1||n.index<o)&&(o=n.index)}let s=r.search(/\bbootstrap\s*\(/),c=t.map(t=>P(e.cwd,t).replace(/\\/g,`/`)).join(`, `);return o===-1?{name:`env wiring`,status:`fail`,message:c,fix:`An env-init file (${c}) calls \`loadEnv(...)\` but \`${P(e.cwd,n).replace(/\\/g,`/`)}\` doesn't import it.\nWithout this, ConfigService.get('X') returns undefined while @Value('X') works via process.env fallback — a half-broken config you won't notice until something is missing.\n\nFix: add a side-effect import at the top of ${P(e.cwd,n).replace(/\\/g,`/`)} (above bootstrap()), pointing at one of the detected files. For example:\n\n  import './env'\n  // or\n  import './config'\n  // or, with the @/ alias:\n  import '@/config/env'`}:s!==-1&&o>s?{name:`env wiring`,status:`warn`,message:`env-init imported AFTER bootstrap() — should be before`,fix:`Move the env import above the bootstrap() call so the schema runs before any service reads from ConfigService.`}:{name:`env wiring`,status:`pass`}}function ki(e,t=Ai){let n=0,r=0,i=[e];for(;i.length>0&&r<t;){let e=i.pop(),a;try{a=k(e,{withFileTypes:!0})}catch{continue}for(let o of a){if(r>=t)break;r++;let a=N(e,o.name);if(o.isDirectory())i.push(a);else try{let e=Fe(a).mtimeMs;e>n&&(n=e)}catch{}}}return n}const Ai=2e3;function ji(e){let t=N(e.cwd,`.kickjs`,`types`);if(!D(t))return null;let n=ki(t);if(n===0)return null;let r=Date.now()-n,i=Math.floor(r/6e4);return i>60?{name:`typegen freshness`,status:`warn`,message:`last updated ${i} minutes ago`,fix:"Re-run `kick typegen` (or `kick dev`, which runs it on every reload) so generated types match the current code."}:{name:`typegen freshness`,status:`pass`,message:i===0?`just now`:`${i}m ago`}}const Mi=[`vitest.config.ts`,`vitest.config.js`,`vitest.config.mts`,`vite.config.ts`,`jest.config.ts`,`jest.config.js`],Ni=[`.env.test`,`.env.test.local`],Pi=[`.env`,`.env.local`];function Fi(e){let t=e.pkg?.scripts;if(t&&typeof t==`object`)for(let[e,n]of Object.entries(t)){if(!e.startsWith(`test`)||typeof n!=`string`)continue;let t=/KICKJS_ENV_FILE=(\S+)/.exec(n);if(t?.[1])return t[1]}return process.env.KICKJS_ENV_FILE??null}function Ii(e){if(!Mi.some(t=>D(N(e.cwd,t))))return null;let t=Pi.filter(t=>D(N(e.cwd,t)));if(t.length===0)return null;let n=Ni.filter(t=>D(N(e.cwd,t)));if(n.length>0){let t=Fi(e);return t&&t!==`off`&&t!==`none`?{name:`test env isolation`,status:`warn`,message:`${n.join(`, `)} present, but KICKJS_ENV_FILE=${t} overrides it`,fix:`KICKJS_ENV_FILE is checked before test-mode isolation, so ${n[0]} is\nignored and "${t}" is read instead. Drop the override to use the\ntest files, or set KICKJS_ENV_FILE=off if env comes from the runner.`}:{name:`test env isolation`,status:`pass`,message:`${n.join(`, `)} present`}}return{name:`test env isolation`,status:`warn`,message:`${t.join(`, `)} present, no .env.test`,fix:`Under NODE_ENV=test (or vitest's VITEST) KickJS reads .env.test / .env.test.local
 INSTEAD of ${t.join(` and `)} — no layering, no fallback. Without one of\nthose files, every var your test config does not pin resolves from your
 development env — including DATABASE_URL and any third-party credentials.
 
 Create .env.test (cp .env.test.example .env.test, if the project has one)
 holding the whole environment the suite should run against
 (a var you leave out is then missing, not inherited), or set KICKJS_ENV_FILE=off
-and supply env from the test runner.`}}const Ii=[()=>_i(),vi,yi,xi,Si,Ti,Ei,Di,Fi,Ai];async function Li(e,t={}){let n={cwd:e,pkg:li(N(e,`package.json`)),tsconfig:fi(e),runtime:t.runtime??`express`},r=[...Ii,...t.extraChecks??[]],i=[];for(let e of r){let t;try{t=await e(n)}catch(t){i.push({name:e.name||`doctor check`,status:`fail`,message:t instanceof Error?t.message:String(t)});continue}t!=null&&(Array.isArray(t)?i.push(...t):i.push(t))}return i}function Ri(e){switch(e){case`pass`:return C.green(`✔`);case`warn`:return C.yellow(`⚠`);case`fail`:return C.red(`✖`)}}function zi(e){let t=Ri(e.status),n=e.message?`  ${C.dim(`(${e.message})`)}`:``;return`${t}  ${e.name}${n}`}function Bi(e){return e.split(`
+and supply env from the test runner.`}}const Li=[()=>_i(),vi,yi,xi,Ci,Ei,Di,Oi,Ii,ji];async function Ri(e,t={}){let n={cwd:e,pkg:li(N(e,`package.json`)),tsconfig:fi(e),runtime:t.runtime??`express`},r=[...Li,...t.extraChecks??[]],i=[];for(let e of r){let t;try{t=await e(n)}catch(t){i.push({name:e.name||`doctor check`,status:`fail`,message:t instanceof Error?t.message:String(t)});continue}t!=null&&(Array.isArray(t)?i.push(...t):i.push(t))}return i}function zi(e){switch(e){case`pass`:return C.green(`✔`);case`warn`:return C.yellow(`⚠`);case`fail`:return C.red(`✖`)}}function Bi(e){let t=zi(e.status),n=e.message?`  ${C.dim(`(${e.message})`)}`:``;return`${t}  ${e.name}${n}`}function Vi(e){return e.split(`
 `).map(e=>`   ${C.dim(`→`)} ${e}`).join(`
-`)}function Vi(e){return e?.doctor?.checks??[]}function Hi(e){e.command(`doctor`).description(`Pre-flight checks for your KickJS project (dev environment health)`).action(async()=>{let e=process.cwd(),n=Vi(await l(e)),r=await t(e);te(`KickJS Doctor`);let i=await Li(e,{extraChecks:n,runtime:r});for(let e of i)x.message(zi(e)),e.fix&&e.status!==`pass`&&x.message(Bi(e.fix));let a=i.filter(e=>e.status===`pass`).length,o=i.filter(e=>e.status===`warn`).length,s=i.filter(e=>e.status===`fail`).length,c=[C.green(`${a} passed`),o>0?C.yellow(`${o} warning${o===1?``:`s`}`):`${o} warnings`,s>0?C.red(`${s} error${s===1?``:`s`}`):`${s} errors`].join(`, `);s>0?(T(`${c} — fix the errors above before running the app`),process.exit(1)):T(o>0?`${c} — review the warnings`:C.green(`${c} — your environment looks good`))})}function Ui(e){return e.optsWithGlobals().dryRun??!1}function Wi(e){e.command(`codemod`).description(`Codebase migration commands (AST-style rewrites — distinct from db migrate)`).command(`modules`).description(`Rewrite module declarations between class form and the defineModule factory.
+`)}function Hi(e){return e?.doctor?.checks??[]}function Ui(e){e.command(`doctor`).description(`Pre-flight checks for your KickJS project (dev environment health)`).action(async()=>{let e=process.cwd(),n=Hi(await l(e)),r=await t(e);te(`KickJS Doctor`);let i=await Ri(e,{extraChecks:n,runtime:r});for(let e of i)x.message(Bi(e)),e.fix&&e.status!==`pass`&&x.message(Vi(e.fix));let a=i.filter(e=>e.status===`pass`).length,o=i.filter(e=>e.status===`warn`).length,s=i.filter(e=>e.status===`fail`).length,c=[C.green(`${a} passed`),o>0?C.yellow(`${o} warning${o===1?``:`s`}`):`${o} warnings`,s>0?C.red(`${s} error${s===1?``:`s`}`):`${s} errors`].join(`, `);s>0?(w(`${c} — fix the errors above before running the app`),process.exit(1)):w(o>0?`${c} — review the warnings`:C.green(`${c} — your environment looks good`))})}function Wi(e){return e.optsWithGlobals().dryRun??!1}function Gi(e){e.command(`codemod`).description(`Codebase migration commands (AST-style rewrites — distinct from db migrate)`).command(`modules`).description(`Rewrite module declarations between class form and the defineModule factory.
   Direction defaults to \`modules.style\` from kick.config (or "define").
   --target define|class  Override the migration direction.
   --apply                Apply the changes (default: dry-run preview).
-  --experimental         Acknowledge that AST migration is experimental.`).option(`--modules-dir <dir>`,`Modules directory (default: src/modules from kick.config)`).option(`--apply`,`Apply the migration to disk (default: dry-run)`).option(`--experimental`,`Acknowledge that this command is experimental`).option(`--target <style>`,`Migration direction — 'define' or 'class'`).option(`--no-backup`,`Skip the .kickjs/codemod-backups/ snapshot (default: backup on)`).action(async(e,t)=>{let n=Ui(t)||!e.apply;v(n),e.experimental||(console.error(`
+  --experimental         Acknowledge that AST migration is experimental.`).option(`--modules-dir <dir>`,`Modules directory (default: src/modules from kick.config)`).option(`--apply`,`Apply the migration to disk (default: dry-run)`).option(`--experimental`,`Acknowledge that this command is experimental`).option(`--target <style>`,`Migration direction — 'define' or 'class'`).option(`--no-backup`,`Skip the .kickjs/codemod-backups/ snapshot (default: backup on)`).action(async(e,t)=>{let n=Wi(t)||!e.apply;v(n),e.experimental||(console.error(`
   `+C.red(`Error:`)+` kick codemod modules is experimental — pass --experimental to acknowledge.
   The regex-based rewrite handles the shapes our templates produce.
   Hand-rolled modules with non-standard structures may be skipped.
   Always commit before running with --apply.
-`),process.exit(1));let r=await l(process.cwd()),i=p(r),a=F(e.modulesDir??i.dir??`src/modules`),o;e.target===`define`||e.target===`class`?o=e.target:e.target===void 0?o=i.style??`define`:(console.error(`\n  ${C.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let s=C.dim(`→ ${o}`),c=n?C.dim(`(dry-run)`):C.bold(`(applying)`);console.log(`\n  ${C.bold(`kick codemod modules`)} ${s} ${c}`),console.log(`  modulesDir: ${C.dim(a)}\n`);let u=e.backup!==!1&&!n,d=await pn(a,{dryRun:n,target:o,backup:u});if(d.backupDir){let e=d.backupDir;console.log(`  ${C.green(`✓`)} backup: ${C.dim(e)}\n    ${C.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else!n&&e.backup===!1&&console.log(`  ${C.dim(`(--no-backup — skipping snapshot)`)}\n`);let f=0,m=0;for(let e of d.files)if(e.status===`migrated`)f++,console.log(`    ${C.green(`✓`)} ${e.path}`);else{m++;let t=C.dim(`(${e.reason??`skipped`})`);console.log(`    ${C.dim(`-`)} ${e.path} ${t}`)}if(console.log(),d.indexStatus===`migrated`)console.log(`    ${C.green(`✓`)} ${d.indexPath}`);else if(d.indexStatus===`skipped`){let e=C.dim(`(${d.indexReason??`skipped`})`);console.log(`    ${C.dim(`-`)} ${d.indexPath} ${e}`)}else console.log(`    ${C.dim(`-`)} ${d.indexPath} ${C.dim(`(not found)`)}`);let h=n?C.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n  ${C.bold(String(f))} migrated, ${C.bold(String(m))} skipped${h}\n`)})}function Gi(e,t=O){let n=M(e);return(t(F(n,`pnpm-workspace.yaml`))||t(F(n,`package.json`)))&&t(F(n,`web`,`package.json`))?{staticDir:`../web/dist`,siteRoot:`..`,apiPath:`/api`}:{siteRoot:`.`,apiPath:``}}function Ki(e,t,n){let r=Gi(t,n),i=e?.staticDir===!1?void 0:e?.staticDir??r.staticDir;return{entry:e?.entry??`src/serverless.ts`,outDir:e?.outDir??`dist/serverless`,staticDir:i,siteRoot:e?.siteRoot??r.siteRoot,publishDir:e?.publishDir??`dist/public`,apiPath:e?.apiPath??r.apiPath,external:e?.external??[`valibot`,`yup`],vercelRuntime:e?.vercelRuntime??`nodejs22.x`}}function qi(e,t){return`import { handler } from '${e}'
+`),process.exit(1));let r=await l(process.cwd()),i=p(r),a=F(e.modulesDir??i.dir??`src/modules`),o;e.target===`define`||e.target===`class`?o=e.target:e.target===void 0?o=i.style??`define`:(console.error(`\n  ${C.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let s=C.dim(`→ ${o}`),c=n?C.dim(`(dry-run)`):C.bold(`(applying)`);console.log(`\n  ${C.bold(`kick codemod modules`)} ${s} ${c}`),console.log(`  modulesDir: ${C.dim(a)}\n`);let u=e.backup!==!1&&!n,d=await pn(a,{dryRun:n,target:o,backup:u});if(d.backupDir){let e=d.backupDir;console.log(`  ${C.green(`✓`)} backup: ${C.dim(e)}\n    ${C.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else!n&&e.backup===!1&&console.log(`  ${C.dim(`(--no-backup — skipping snapshot)`)}\n`);let f=0,m=0;for(let e of d.files)if(e.status===`migrated`)f++,console.log(`    ${C.green(`✓`)} ${e.path}`);else{m++;let t=C.dim(`(${e.reason??`skipped`})`);console.log(`    ${C.dim(`-`)} ${e.path} ${t}`)}if(console.log(),d.indexStatus===`migrated`)console.log(`    ${C.green(`✓`)} ${d.indexPath}`);else if(d.indexStatus===`skipped`){let e=C.dim(`(${d.indexReason??`skipped`})`);console.log(`    ${C.dim(`-`)} ${d.indexPath} ${e}`)}else console.log(`    ${C.dim(`-`)} ${d.indexPath} ${C.dim(`(not found)`)}`);let h=n?C.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n  ${C.bold(String(f))} migrated, ${C.bold(String(m))} skipped${h}\n`)})}function Ki(e){try{let t=JSON.parse(O(F(e,`package.json`),`utf-8`));return{...t.dependencies,...t.devDependencies}}catch{return{}}}function qi(e,t=D,n=Ki(e)){if(n[`@forinda/kickjs-inertia`])return{staticDir:`dist/client`,siteRoot:`.`,apiPath:``,include:[`dist/client/.vite/manifest.json`,`dist/ssr`]};let r=M(e);return(t(F(r,`pnpm-workspace.yaml`))||t(F(r,`package.json`)))&&t(F(r,`web`,`package.json`))?{staticDir:`../web/dist`,siteRoot:`..`,apiPath:`/api`}:{siteRoot:`.`,apiPath:``}}function Ji(e,t,n,r){let i=qi(t,n,r),a=e?.staticDir===!1?void 0:e?.staticDir??i.staticDir;return{entry:e?.entry??`src/serverless.ts`,outDir:e?.outDir??`dist/serverless`,staticDir:a,siteRoot:e?.siteRoot??i.siteRoot,publishDir:e?.publishDir??`dist/public`,apiPath:e?.apiPath??i.apiPath,external:e?.external??[`valibot`,`yup`],vercelRuntime:e?.vercelRuntime??`nodejs22.x`,include:e?.include??i.include??[]}}function Yi(e,t,n={projectDir:`.`}){let r=[`  path: '${t}/*',`,...n.preferStatic?[`  preferStatic: true,`]:[],...n.includedFiles?.length?[`  includedFiles: ${JSON.stringify(n.includedFiles)},`]:[]];return`import { fileURLToPath } from 'node:url'
+import { handler } from '${e}'
+
+// Where the app's build files were packaged; the platform starts this
+// function in another directory.
+process.env.KICK_APP_ROOT ??= fileURLToPath(new URL('${n.projectDir}/', import.meta.url))
 
 // Netlify's context carries waitUntil, so ctx.waitUntil() work finishes after the response.
 export default (request, context) => handler.fetch(request, context)
 
 export const config = {
-  path: '${t}/*',
+${r.join(`
+`)}
 }
-`}function Ji(){return`import { handler } from './server.mjs'
+`}function Xi(){return`import { fileURLToPath } from 'node:url'
+import { handler } from './server.mjs'
+
+// The app's build files are copied into this function at their project
+// paths; the platform starts it in another directory.
+process.env.KICK_APP_ROOT ??= fileURLToPath(new URL('./', import.meta.url))
 
 const requestContext = () => globalThis[Symbol.for('@vercel/request-context')]?.get?.()
 
 export default (req, res) => handler.node(req, res, requestContext())
-`}function Yi(e){return/^\s*publish\s*=\s*["']([^"']+)["']/m.exec(e)?.[1]?.replace(/^\.\//,``).replace(/\/+$/,``)}function Xi(e,t,n=!1){let r=[{handle:`filesystem`},{src:`^${e}/(.*)$`,dest:`/api`}];return n&&e!==``&&r.push({src:`^/_kick/(.*)$`,dest:`/api`}),t&&r.push({src:`^/(.*)$`,dest:`/index.html`}),r}function Zi(e,t){let n;try{n=qe(t,e).program}catch{return[]}let r=[],i=t=>e.slice(0,t).split(`
-`).length,a=e=>{if(!e||typeof e!=`object`)return;if(Array.isArray(e))return e.forEach(a);let n=e,o=n.expression;if(n.type===`Decorator`&&o?.type===`CallExpression`&&o.callee?.type===`Identifier`&&o.callee.name===`Cron`){let[e,a]=o.arguments??[],s=e?.type===`Literal`&&typeof e.value==`string`?e.value:e?.type===`TemplateLiteral`&&e.expressions.length===0?e.quasis[0]?.value?.cooked:void 0;r.push({file:t,line:i(n.start??0),expression:s,timezone:a?.type===`ObjectExpression`&&a.properties.some(e=>(e.key?.name??e.key?.value)===`timezone`)})}for(let e in n)e!==`parent`&&a(n[e])};return a(n),r}function Qi(e){let t=F(e,`src`);return O(t)?A(t,{recursive:!0,encoding:`utf-8`}).filter(e=>/\.m?ts$/.test(e)&&!/\.(test|spec|d)\.m?ts$/.test(e)).flatMap(e=>{let n=k(F(t,e),`utf-8`);return n.includes(`@Cron`)?Zi(n,`src/${e}`):[]}):[]}function $i(e){let t=2166136261;for(let n of e.trim().replace(/\s+/g,` `))t^=n.codePointAt(0),t=Math.imul(t,16777619)>>>0;return t.toString(36)}function ea(e){let t=[],n=new Map;for(let r of e){let e=`${r.file}:${r.line}`;if(r.expression===void 0){t.push(`${e}: @Cron expression is not a string literal, so it has no Vercel cron entry`);continue}r.timezone&&t.push(`${e}: Vercel crons run in UTC — the timezone option is ignored there`);let i=r.expression.trim().replace(/\s+/g,` `);if(i.split(` `).length!==5){t.push(`${e}: Vercel crons need a five-field expression, so it has no Vercel cron entry`);continue}n.set($i(i),i)}return{crons:[...n].map(([e,t])=>({path:`/_kick/cron/${e}`,schedule:t})),warnings:t}}function ta(e){let t=e=>{if(typeof e==`string`)return e;if(!e||typeof e!=`object`)return;let n=e;for(let e of[`import`,`module`,`node`,`default`]){let r=t(n[e]);if(r)return r}},n=e.exports;return t(typeof n==`string`||Array.isArray(n)?n:n?.[`.`]??n)??e.module??e.main}async function na(e,t){let{createRequire:n}=await import(`node:module`),r=n(F(e,`package.json`)),i;try{i=r.resolve(`${t}/package.json`)}catch{i=F(e,`node_modules`,t,`package.json`)}if(!O(i))throw Error(`${t} is not installed in this project. Run: pnpm add -D vite unplugin-swc @forinda/kickjs-vite`);let a=ta(JSON.parse(k(i,`utf-8`)));if(!a)throw Error(`${t} has no importable entry point`);return import(I(F(M(i),a)).href)}async function ra(e,t,n){let r=F(e,t.entry);if(!O(r))throw Error(`${t.entry} not found. The serverless entry exports \`handler = createHandler({ modules })\` — see the Serverless guide.`);let{build:i}=await na(e,`vite`),{default:a}=await na(e,`unplugin-swc`),{devtoolsFlagPlugin:o,devtoolsStripPlugin:s}=await na(e,`@forinda/kickjs-vite`);await i({configFile:!1,root:e,logLevel:`warn`,oxc:!1,plugins:[a.vite(),o(),s()],resolve:{alias:{"@":F(e,`src`)}},ssr:{noExternal:!0,target:`node`},build:{ssr:!0,target:`node20`,outDir:F(e,t.outDir),emptyOutDir:!0,minify:!1,rollupOptions:{input:r,external:t.external.filter(t=>!O(F(e,`node_modules`,t))),output:{format:`esm`,entryFileNames:`server.mjs`,codeSplitting:!1}}}});let c=F(e,t.outDir,`server.mjs`);return n(`bundled ${P(process.cwd(),c)}`),c}function ia(e,t){let n=t.projectRoot,r=()=>Ki(t.config?.deploy,n);e.command(`build:netlify`).description(`Bundle the serverless entry and write the Netlify function`).action(async()=>{let e=r(),i=await ra(n,e,t.log),a=F(n,e.siteRoot),o=Qi(n);o.length>0&&t.log(`warning: ${o.length} @Cron job(s) found — Netlify has no cron trigger for them, so they will not run. Use Netlify scheduled functions, or deploy to Vercel or Workers.`);let s=F(a,`.netlify/v1/functions`);Me(s,{recursive:!0});let c=P(s,i).split(Le).join(`/`);Fe(F(s,`api.mjs`),qi(c,e.apiPath)),t.log(`wrote ${P(process.cwd(),F(s,`api.mjs`))}`);let l=e.staticDir??e.publishDir;e.staticDir||(Me(F(n,l),{recursive:!0}),t.log(`publish directory ready at ${P(process.cwd(),F(n,l))}`));let u=F(a,`netlify.toml`);if(O(u)){let e=Yi(k(u,`utf-8`)),r=P(a,F(n,l)).split(Le).join(`/`);e!==void 0&&e!==r&&t.log(`warning: netlify.toml publishes "${e}", but this build fills "${r}". Update netlify.toml, or set \`deploy.publishDir\` / \`deploy.staticDir\` to match.`)}}),e.command(`build:vercel`).description(`Bundle the serverless entry and write .vercel/output (Build Output API v3)`).action(async()=>{let e=r(),i=await ra(n,e,t.log),a=F(n,e.siteRoot),o=e.staticDir?F(n,e.staticDir):void 0,s=F(a,`.vercel/output`),c=F(s,`functions/api.func`);if(Ne(s,{recursive:!0,force:!0}),Me(c,{recursive:!0}),je(i,F(c,`server.mjs`)),Fe(F(c,`index.mjs`),Ji()),Fe(F(c,`.vc-config.json`),`${JSON.stringify({runtime:e.vercelRuntime,handler:`index.mjs`,launcherType:`Nodejs`,supportsResponseStreaming:!0},null,2)}\n`),o){if(!O(o))throw Error(`build:vercel: ${e.staticDir} does not exist — build the frontend first`);je(o,F(s,`static`),{recursive:!0})}let{crons:l,warnings:u}=ea(Qi(n));for(let e of u)t.log(`warning: ${e}`);let d={version:3,routes:Xi(e.apiPath,!!o,l.length>0),...l.length>0?{crons:l}:{}};Fe(F(s,`config.json`),`${JSON.stringify(d,null,2)}\n`),t.log(`wrote ${P(process.cwd(),s)}`),l.length>0&&t.log(`${l.length} cron schedule(s) written. Set CRON_SECRET in the Vercel project — the trigger is not mounted without it.`)})}const aa=()=>({id:`kick/assets`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`],async generate(e){let t=j.resolve(e.cwd,`kick.config.ts`);if(!O(t))return null;let n=await l(e.cwd);if(!n?.assetMap)return null;let r=ue(n.assetMap,e.cwd);return r.count===0?null:be(r)}}),oa="/* eslint-disable */\n// AUTO-GENERATED by `kick typegen`. DO NOT EDIT.\n// Re-run with `kick typegen` or rely on `kick dev` to refresh.\n";function sa(e,t,n,r={}){if(e.length===0)return`${oa}
+`}function Zi(e){return/^\s*publish\s*=\s*["']([^"']+)["']/m.exec(e)?.[1]?.replace(/^\.\//,``).replace(/\/+$/,``)}function Qi(e,t,n=!1){let r=[{handle:`filesystem`},{src:`^${e}/(.*)$`,dest:`/api`}];return n&&e!==``&&r.push({src:`^/_kick/(.*)$`,dest:`/api`}),t&&e!==``&&r.push({src:`^/(.*)$`,dest:`/index.html`}),r}function $i(e,t){let n;try{n=qe(t,e).program}catch{return[]}let r=[],i=t=>e.slice(0,t).split(`
+`).length,a=e=>{if(!e||typeof e!=`object`)return;if(Array.isArray(e))return e.forEach(a);let n=e,o=n.expression;if(n.type===`Decorator`&&o?.type===`CallExpression`&&o.callee?.type===`Identifier`&&o.callee.name===`Cron`){let[e,a]=o.arguments??[],s=e?.type===`Literal`&&typeof e.value==`string`?e.value:e?.type===`TemplateLiteral`&&e.expressions.length===0?e.quasis[0]?.value?.cooked:void 0;r.push({file:t,line:i(n.start??0),expression:s,timezone:a?.type===`ObjectExpression`&&a.properties.some(e=>(e.key?.name??e.key?.value)===`timezone`)})}for(let e in n)e!==`parent`&&a(n[e])};return a(n),r}function ea(e){let t=F(e,`src`);return D(t)?k(t,{recursive:!0,encoding:`utf-8`}).filter(e=>/\.m?ts$/.test(e)&&!/\.(test|spec|d)\.m?ts$/.test(e)).flatMap(e=>{let n=O(F(t,e),`utf-8`);return n.includes(`@Cron`)?$i(n,`src/${e}`):[]}):[]}function ta(e){let t=2166136261;for(let n of e.trim().replace(/\s+/g,` `))t^=n.codePointAt(0),t=Math.imul(t,16777619)>>>0;return t.toString(36)}function na(e){let t=[],n=/* @__PURE__ */ new Map;for(let r of e){let e=`${r.file}:${r.line}`;if(r.expression===void 0){t.push(`${e}: @Cron expression is not a string literal, so it has no Vercel cron entry`);continue}r.timezone&&t.push(`${e}: Vercel crons run in UTC — the timezone option is ignored there`);let i=r.expression.trim().replace(/\s+/g,` `);i.split(` `).length===5?n.set(ta(i),i):t.push(`${e}: Vercel crons need a five-field expression, so it has no Vercel cron entry`)}return{crons:[...n].map(([e,t])=>({path:`/_kick/cron/${e}`,schedule:t})),warnings:t}}function ra(e){let t=e=>{if(typeof e==`string`)return e;if(!e||typeof e!=`object`)return;let n=e;for(let e of[`import`,`module`,`node`,`default`]){let r=t(n[e]);if(r)return r}},n=e.exports;return t(typeof n==`string`||Array.isArray(n)?n:n?.[`.`]??n)??e.module??e.main}async function ia(e,t){let{createRequire:n}=await import(`node:module`),r=n(F(e,`package.json`)),i;try{i=r.resolve(`${t}/package.json`)}catch{i=F(e,`node_modules`,t,`package.json`)}if(!D(i))throw Error(`${t} is not installed in this project. Run: pnpm add -D vite unplugin-swc @forinda/kickjs-vite`);let a=ra(JSON.parse(O(i,`utf-8`)));if(!a)throw Error(`${t} has no importable entry point`);return import(L(F(M(i),a)).href)}async function aa(e,t,n){let r=F(e,t.entry);if(!D(r))throw Error(`${t.entry} not found. The serverless entry exports \`handler = createHandler({ modules })\` — see the Serverless guide.`);let{build:i}=await ia(e,`vite`),{default:a}=await ia(e,`unplugin-swc`),{devtoolsFlagPlugin:o,devtoolsStripPlugin:s}=await ia(e,`@forinda/kickjs-vite`);await i({configFile:!1,root:e,logLevel:`warn`,oxc:!1,plugins:[a.vite(),o(),s()],resolve:{alias:{"@":F(e,`src`)}},ssr:{noExternal:!0,target:`node`},build:{ssr:!0,target:`node20`,outDir:F(e,t.outDir),emptyOutDir:!0,minify:!1,rollupOptions:{input:r,external:(n,r)=>sa(n,r?M(r):e)||t.external.includes(n)&&!D(F(e,`node_modules`,n)),output:{format:`esm`,entryFileNames:`server.mjs`,codeSplitting:!1}}}});let c=F(e,t.outDir,`server.mjs`);return n(`bundled ${P(process.cwd(),c)}`),c}function oa(e){return/^((?:@[a-z0-9][\w.-]*\/)?[a-z0-9][\w.-]*)(?:\/|$)/i.exec(e)?.[1]}function sa(e,t,n=D){let r=oa(e);if(!r)return!1;for(let e=t;;e=M(e)){if(n(F(e,`node_modules`,r,`package.json`)))return!1;if(M(e)===e)return!0}}function ca(e,t){let n=P(e,t).split(I)[0];return n!==void 0&&n.startsWith(`.`)}function la(e){return e.flatMap(e=>[`/${e}  /404  404!`,`/${e}/*  /404  404!`])}function ua(e){try{return Fe(e)}catch{return}}function da(e,t){let n=t.filter(t=>!D(F(e,t)));if(n.length>0)throw Error(`${n.join(`, `)} not found — the function reads ${n.length===1?`it`:`them`} at runtime. Run the full build first (\`pnpm build\`), or fix \`deploy.include\`.`)}function fa(e,t){let n=t.projectRoot,r=()=>Ji(t.config?.deploy,n);e.command(`build:netlify`).description(`Bundle the serverless entry and write the Netlify function`).action(async()=>{let e=r();da(n,e.include);let i=await aa(n,e,t.log),a=F(n,e.siteRoot),o=ea(n);o.length>0&&t.log(`warning: ${o.length} @Cron job(s) found — Netlify has no cron trigger for them, so they will not run. Use Netlify scheduled functions, or deploy to Vercel or Workers.`);let s=F(a,`.netlify/v1/functions`);Ne(s,{recursive:!0});let c=P(s,i).split(I).join(`/`),l=e=>e.split(I).join(`/`);A(F(s,`api.mjs`),Yi(c,e.apiPath,{projectDir:l(P(s,n)),preferStatic:e.apiPath===``&&!!e.staticDir,includedFiles:e.include.flatMap(e=>{let t=l(P(s,F(n,e)));return ua(F(n,e))?.isDirectory()?[`${t}/**`]:[t]})})),t.log(`wrote ${P(process.cwd(),F(s,`api.mjs`))}`);let u=e.staticDir??e.publishDir;if(!e.staticDir)Ne(F(n,u),{recursive:!0}),t.log(`publish directory ready at ${P(process.cwd(),F(n,u))}`);else if(D(F(n,u))){let e=k(F(n,u)).filter(e=>e.startsWith(`.`));if(e.length>0){let t=F(n,u,`_redirects`),r=D(t)?O(t,`utf-8`):``,i=la(e).filter(e=>!r.includes(e));i.length>0&&A(t,`${r}${r&&!r.endsWith(`
+`)?`
+`:``}${i.join(`
+`)}\n`)}}let d=F(a,`netlify.toml`);if(D(d)){let e=Zi(O(d,`utf-8`)),r=P(a,F(n,u)).split(I).join(`/`);e!==void 0&&e!==r&&t.log(`warning: netlify.toml publishes "${e}", but this build fills "${r}". Update netlify.toml, or set \`deploy.publishDir\` / \`deploy.staticDir\` to match.`)}}),e.command(`build:vercel`).description(`Bundle the serverless entry and write .vercel/output (Build Output API v3)`).action(async()=>{let e=r();da(n,e.include);let i=await aa(n,e,t.log),a=F(n,e.siteRoot),o=e.staticDir?F(n,e.staticDir):void 0,s=F(a,`.vercel/output`),c=F(s,`functions/api.func`);Pe(s,{recursive:!0,force:!0}),Ne(c,{recursive:!0}),Me(i,F(c,`server.mjs`)),A(F(c,`index.mjs`),Xi());for(let t of e.include)Me(F(n,t),F(c,t),{recursive:!0});if(A(F(c,`.vc-config.json`),`${JSON.stringify({runtime:e.vercelRuntime,handler:`index.mjs`,launcherType:`Nodejs`,supportsResponseStreaming:!0},null,2)}\n`),o){if(!D(o))throw Error(`build:vercel: ${e.staticDir} does not exist — build the frontend first`);Me(o,F(s,`static`),{recursive:!0,filter:e=>!ca(o,e)})}let{crons:l,warnings:u}=na(ea(n));for(let e of u)t.log(`warning: ${e}`);let d={version:3,routes:Qi(e.apiPath,!!o,l.length>0),...l.length>0?{crons:l}:{}};A(F(s,`config.json`),`${JSON.stringify(d,null,2)}\n`),t.log(`wrote ${P(process.cwd(),s)}`),l.length>0&&t.log(`${l.length} cron schedule(s) written. Set CRON_SECRET in the Vercel project — the trigger is not mounted without it.`)})}const pa=()=>({id:`kick/assets`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`],async generate(e){let t=j.resolve(e.cwd,`kick.config.ts`);if(!D(t))return null;let n=await l(e.cwd);if(!n?.assetMap)return null;let r=de(n.assetMap,e.cwd);return r.count===0?null:xe(r)}}),ma="/* eslint-disable */\n// AUTO-GENERATED by `kick typegen`. DO NOT EDIT.\n// Re-run with `kick typegen` or rely on `kick dev` to refresh.\n";function ha(e,t,n,r={}){if(e.length===0)return`${ma}
 // (no routes discovered yet — annotate a controller method with
 //  @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
 declare global {
@@ -1700,14 +1714,14 @@ declare global {
 
 /** Empty until the first route exists — see kick typegen. */
 export const kickRpc = {} as const
-`;let i=new Map;for(let t of e){let e=i.get(t.controller)??[];e.push(t),i.set(t.controller,e)}let a=new Map,o=new Map,s=e=>{let t=`${e.filePath}::${e.controller}`,n=o.get(t);return n||(n=`_C${o.size}`,o.set(t,n)),n},c=(e,i,o)=>{let s=da(e,i.filePath,t,n,a);if(!s){if(e&&n!==!1){let t=o===`params`?`URL-pattern params`:o===`query`&&i.queryFilterable!==null?`the @ApiQueryParams-derived query shape`:`'unknown'`;r.onWarn?.(`route ${i.controller}.${i.method} (${i.httpMethod} ${i.path}): ${o} schema '${e.identifier}' could not be statically resolved — falling back to ${t}. Export the schema from the controller file or import it with a static specifier.`)}return null}return n===`kickjs-schema`?`import('@forinda/kickjs-schema').InferSchemaOutput<typeof ${s}>`:`import('zod').infer<typeof ${s}>`},l=[];for(let[e,t]of i){let n=[`    interface ${e} {`];for(let e of t){let t=e.pathParams.length>0?`{ ${e.pathParams.map(e=>`${e}: string`).join(`; `)} }`:`{}`,r=c(e.bodySchema,e,`body`),i=c(e.querySchema,e,`query`),a=c(e.paramsSchema,e,`params`)??t,o=r??`unknown`,l=i??la(e),u=c(e.responseSchema??null,e,`response`),d=s(e),f=u??`import('@forinda/kickjs').InferHandlerResponse<${d}['${e.method}']>`,p=ua(e);n.push(`      /**`,`       * ${e.httpMethod} ${e.path}`,...p.map(e=>`       * ${e}`),`       */`,`      ${e.method}: {`,`        params: ${a}`,`        body: ${o}`,`        query: ${l}`,`        response: ${f}`,`        contextKeys: ${ca(e)}`,`      }`)}n.push(`    }`),l.push(n.join(`
-`))}let u=[],d=new Set,f=new Set;i.has(`Api`)&&r.onWarn?.(`controller class 'Api' collides with the reserved KickRoutes.Api client map — its interface declaration-merges into the flat route map. Rename the controller.`);for(let[e,t]of i)for(let n of t){let t=`${n.httpMethod} ${n.mountedPath??n.path}`;if(d.has(t)){r.onWarn?.(`duplicate route '${t}' (${e}.${n.method}) — two handlers claim the same verb+path at runtime. KickRoutes.Api keeps the first (scan order, which may not match runtime dispatch); resolve the conflict in the modules.`);continue}d.add(t),f.add(`${e}.${n.method}`),u.push(`      '${t}': ${e}['${n.method}']`)}let p=[`    interface Api {`,...u,`    }`].join(`
-`);l.push(p);let m=[],h=new Set;for(let[e,t]of i){let n=ma(e);if(h.has(n)){r.onWarn?.(`RPC manifest: controller key '${n}' (from ${e}) collides with another controller — keeping the first; rename one class for distinct RPC namespaces.`);continue}h.add(n);let i=[];for(let n of t){if(!f.has(`${e}.${n.method}`))continue;let t=`${n.httpMethod} ${n.mountedPath??n.path}`;i.push(`    ${n.method}: '${t}',`)}i.length>0&&m.push(`  ${n}: {\n${i.join(`
+`;let i=/* @__PURE__ */ new Map;for(let t of e){let e=i.get(t.controller)??[];e.push(t),i.set(t.controller,e)}let a=/* @__PURE__ */ new Map,o=/* @__PURE__ */ new Map,s=e=>{let t=`${e.filePath}::${e.controller}`,n=o.get(t);return n||(n=`_C${o.size}`,o.set(t,n)),n},c=(e,i,o)=>{let s=ya(e,i.filePath,t,n,a);if(!s){if(e&&n!==!1){let t=o===`params`?`URL-pattern params`:o===`query`&&i.queryFilterable!==null?`the @ApiQueryParams-derived query shape`:`'unknown'`;r.onWarn?.(`route ${i.controller}.${i.method} (${i.httpMethod} ${i.path}): ${o} schema '${e.identifier}' could not be statically resolved — falling back to ${t}. Export the schema from the controller file or import it with a static specifier.`)}return null}return n===`kickjs-schema`?`import('@forinda/kickjs-schema').InferSchemaOutput<typeof ${s}>`:`import('zod').infer<typeof ${s}>`},l=[];for(let[e,t]of i){let n=[`    interface ${e} {`];for(let e of t){let t=e.pathParams.length>0?`{ ${e.pathParams.map(e=>`${e}: string`).join(`; `)} }`:`{}`,r=c(e.bodySchema,e,`body`),i=c(e.querySchema,e,`query`),a=c(e.paramsSchema,e,`params`)??t,o=r??`unknown`,l=i??_a(e),u=c(e.responseSchema??null,e,`response`),d=s(e),f=u??`import('@forinda/kickjs').InferHandlerResponse<${d}['${e.method}']>`,p=va(e);n.push(`      /**`,`       * ${e.httpMethod} ${e.path}`,...p.map(e=>`       * ${e}`),`       */`,`      ${e.method}: {`,`        params: ${a}`,`        body: ${o}`,`        query: ${l}`,`        response: ${f}`,`        contextKeys: ${ga(e)}`,`      }`)}n.push(`    }`),l.push(n.join(`
+`))}let u=[],d=/* @__PURE__ */ new Set,f=/* @__PURE__ */ new Set;i.has(`Api`)&&r.onWarn?.(`controller class 'Api' collides with the reserved KickRoutes.Api client map — its interface declaration-merges into the flat route map. Rename the controller.`);for(let[e,t]of i)for(let n of t){let t=`${n.httpMethod} ${n.mountedPath??n.path}`;d.has(t)?r.onWarn?.(`duplicate route '${t}' (${e}.${n.method}) — two handlers claim the same verb+path at runtime. KickRoutes.Api keeps the first (scan order, which may not match runtime dispatch); resolve the conflict in the modules.`):(d.add(t),f.add(`${e}.${n.method}`),u.push(`      '${t}': ${e}['${n.method}']`))}let p=[`    interface Api {`,...u,`    }`].join(`
+`);l.push(p);let m=[],h=/* @__PURE__ */ new Set;for(let[e,t]of i){let n=Sa(e);if(h.has(n)){r.onWarn?.(`RPC manifest: controller key '${n}' (from ${e}) collides with another controller — keeping the first; rename one class for distinct RPC namespaces.`);continue}h.add(n);let i=[];for(let n of t){if(!f.has(`${e}.${n.method}`))continue;let t=`${n.httpMethod} ${n.mountedPath??n.path}`;i.push(`    ${n.method}: '${t}',`)}i.length>0&&m.push(`  ${n}: {\n${i.join(`
 `)}\n  },`)}let g=[`/**`,` * Runtime route manifest for the tRPC-style sugar:`," * `createRpc(api, kickRpc)` from @forinda/kickjs-client.",` */`,`export const kickRpc = {`,...m,`} as const`].join(`
-`),_=[],v=new Map;for(let t of e)v.set(`${t.filePath}::${t.controller}`,t);for(let[e,n]of o){let r=v.get(e),i=pa(``,r.filePath,t),a=r.controllerIsDefaultExport?`default as ${n}`:`${r.controller} as ${n}`;_.push(`import type { ${a} } from '${i}'`)}let y=_.length>0?_.join(`
+`),_=[],v=/* @__PURE__ */ new Map;for(let t of e)v.set(`${t.filePath}::${t.controller}`,t);for(let[e,n]of o){let r=v.get(e),i=xa(``,r.filePath,t),a=r.controllerIsDefaultExport?`default as ${n}`:`${r.controller} as ${n}`;_.push(`import type { ${a} } from '${i}'`)}let y=_.length>0?_.join(`
 `)+`
-`:``,b=fa(a)+y,x=l.join(`
-`);return`${oa}${b}
+`:``,b=ba(a)+y,x=l.join(`
+`);return`${ma}${b}
 declare global {
   // eslint-disable-next-line @typescript-eslint/no-namespace
   namespace KickRoutes {
@@ -1719,32 +1733,32 @@ ${x}
 }
 
 ${g}
-`}function ca(e){let t=e.contextKeys;return t==null?`string`:t.length===0?`never`:t.map(e=>JSON.stringify(e)).join(` | `)}function la(e){if(e.queryFilterable===null)return`unknown`;let t=e.querySortable??[];return`{ filter?: string | string[]; sort?: ${t.length>0?t.flatMap(e=>[`'${e}'`,`'-${e}'`]).join(` | `):`string`}; q?: string; page?: string; limit?: string }`}function ua(e){let t=[];return e.queryFilterable&&e.queryFilterable.length>0&&t.push(`Filterable: ${e.queryFilterable.join(`, `)}`),e.querySortable&&e.querySortable.length>0&&t.push(`Sortable: ${e.querySortable.join(`, `)}`),e.querySearchable&&e.querySearchable.length>0&&t.push(`Searchable: ${e.querySearchable.join(`, `)}`),t}function da(e,t,n,r,i){if(!e||r===!1||e.source===null)return null;let a=pa(e.source,t,n);if(a===`unknown`)return null;let o=`${a}::${e.identifier}`,s=i.get(o)?.specifier;return s?s=i.get(o).specifier:(s=`_S${i.size}`,i.set(o,{identifier:e.identifier,specifier:s})),s}function fa(e){if(e.size===0)return``;let t=[];for(let[n,r]of e){let[e]=n.split(`::`);t.push(`import type { ${r.identifier} as ${r.specifier} } from '${e}'`)}return t.join(`
+`}function ga(e){let t=e.contextKeys;return t==null?`string`:t.length===0?`never`:t.map(e=>JSON.stringify(e)).join(` | `)}function _a(e){if(e.queryFilterable===null)return`unknown`;let t=e.querySortable??[];return`{ filter?: string | string[]; sort?: ${t.length>0?t.flatMap(e=>[`'${e}'`,`'-${e}'`]).join(` | `):`string`}; q?: string; page?: string; limit?: string }`}function va(e){let t=[];return e.queryFilterable&&e.queryFilterable.length>0&&t.push(`Filterable: ${e.queryFilterable.join(`, `)}`),e.querySortable&&e.querySortable.length>0&&t.push(`Sortable: ${e.querySortable.join(`, `)}`),e.querySearchable&&e.querySearchable.length>0&&t.push(`Searchable: ${e.querySearchable.join(`, `)}`),t}function ya(e,t,n,r,i){if(!e||r===!1||e.source===null)return null;let a=xa(e.source,t,n);if(a===`unknown`)return null;let o=`${a}::${e.identifier}`,s=i.get(o)?.specifier;return s?s=i.get(o).specifier:(s=`_S${i.size}`,i.set(o,{identifier:e.identifier,specifier:s})),s}function ba(e){if(e.size===0)return``;let t=[];for(let[n,r]of e){let[e]=n.split(`::`);t.push(`import type { ${r.identifier} as ${r.specifier} } from '${e}'`)}return t.join(`
 `)+`
-`}function pa(e,t,n){if(e===null)return`unknown`;let r=M(n);if(e===``){let e=P(r,t).split(Le).join(`/`);return e=e.replace(/\.(ts|tsx|mts|cts)$/i,``),e.startsWith(`.`)||(e=`./`+e),e}if(!e.startsWith(`.`)&&!e.startsWith(`/`))return e;let i=M(t),a=F(i,e),o=P(r,a).split(Le).join(`/`);return o=o.replace(/\.(ts|tsx|mts|cts)$/i,``),o.startsWith(`.`)||(o=`./`+o),o}function ma(e){let t=e.endsWith(`Controller`)?e.slice(0,-10):e,n=t.length>0?t:e;return n.charAt(0).toLowerCase()+n.slice(1)}const ha=()=>({id:`kick/routes`,outExtension:`.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){let t=await e.getScanResult({root:ga(e),cwd:e.cwd,envFile:_a(e)}),n=e.config?.typegen?.schemaValidator??`zod`,r=j.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return sa(t.routes,r,n,{onWarn:t=>e.log.warn(t)})}});function ga(e){return j.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function _a(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}const va=`@typescript/typescript6`;function ya(e){return typeof e?.createProgram==`function`}function ba(e){if(ya(e.typescript))return{api:e.typescript,source:`typescript`};if(ya(e.ts6))return{api:e.ts6,source:va};let t=`Install it in the project:\n    pnpm add -D ${va}`;throw e.typescript?Error(`kick typegen: the client route map needs a TypeScript compiler API.
-  TypeScript 7 does not ship a compiler API, so the compatibility package is required.\n  ${t}`):Error(`kick typegen: the client route map needs a TypeScript compiler API, and neither 'typescript' nor '${va}' resolved from this project.\n  ${t}`)}async function xa(e){let t=Ae(N(e,`package.json`)),n=async e=>{try{return await import(I(t.resolve(e)).href)}catch{return null}},[r,i]=await Promise.all([n(`typescript`),n(va)]);return ba({typescript:Sa(r),ts6:Sa(i)}).api}function Sa(e){let t=e;return t?.default&&typeof t.default==`object`?t.default:e}const Ca=Symbol(`kick/client: expansion budget exhausted`);var wa=class{ts;checker;program;opts;get printFlags(){return this.ts.TypeFormatFlags.NoTruncation}hoistedByType=new Map;inProgress=new Map;jsonInProgress=new Set;nextName=0;blocks=[];maxDepth;truncations=0;budget;constructor(e,t,n,r={}){this.ts=e,this.checker=t,this.program=n,this.opts=r,this.maxDepth=r.maxDepth??12,this.budget=r.truncationBudget??1e3}hoisted(){return this.blocks}expand(e){this.truncations=0;try{return this.render(e,0)}catch(e){if(e!==Ca)throw e;return this.opts.onWarn?.(`expansion abandoned after ${this.budget} truncations — emitting 'unknown'. This usually means a recursive type. Declare a response schema on the route for an exact type.`),`unknown`}}render(e,t){let n=this.ts.TypeFlags;if(t>this.maxDepth){if(++this.truncations>this.budget)throw Ca;return this.opts.onWarn?.(`type nesting exceeded ${this.maxDepth} levels — emitting 'unknown'. Declare a response schema on the route for an exact type.`),`unknown`}if(e.flags&(n.String|n.Number|n.Boolean|n.BigInt|n.ESSymbol)||e.flags&(n.Any|n.Unknown|n.Never|n.Void|n.Undefined|n.Null)||e.isLiteral()||e.flags&n.BooleanLiteral)return this.checker.typeToString(e,void 0,this.printFlags);if(e.isUnion()){let n=e.types.filter(e=>!this.isCallable(e));return(n.length>0?n:e.types).map(e=>this.render(e,t+1)).join(` | `)}if(e.isIntersection())return e.types.map(e=>this.render(e,t+1)).join(` & `);if(this.isTuple(e))return this.renderTuple(e,t);let r=this.arrayElement(e);if(r){let e=this.render(r.element,t+1),n=/[|&]/.test(e)?`(${e})[]`:`${e}[]`;return r.readonly?`readonly ${n}`:n}let i=this.toJsonType(e);if(i){if(this.jsonInProgress.has(e))return this.opts.onWarn?.(`'${this.checker.typeToString(e,void 0,this.printFlags)}' has a cyclic toJSON() — emitting 'unknown', since it has no serializable form.`),`unknown`;this.jsonInProgress.add(e);try{return this.render(i,t)}finally{this.jsonInProgress.delete(e)}}return this.isLibType(e)?this.renderLibType(e,t):e.flags&n.Object?this.renderObject(e,t):(this.opts.onWarn?.(`could not expand type '${this.checker.typeToString(e)}' — emitting 'unknown'`),`unknown`)}renderObject(e,t){let n=this.hoistedByType.get(e);if(n)return n;if(this.isNamed(e)){let t=this.allocName();this.hoistedByType.set(e,t);let n=this.blocks.length;return this.blocks.push(``),this.blocks[n]=`interface ${t} {\n${this.members(e,0,`  `)}\n}`,t}let r=this.inProgress.get(e);if(r)return r.name??=this.allocName();let i={name:null};this.inProgress.set(e,i);let a;try{a=this.members(e,t,``,`; `)}finally{this.inProgress.delete(e)}if(i.name){this.hoistedByType.set(e,i.name);let t=this.blocks.length;return this.blocks.push(``),this.blocks[t]=`interface ${i.name} {\n${this.members(e,0,`  `)}\n}`,i.name}return a.length>0?`{ ${a} }`:`{}`}allocName(){return`__T${this.nextName++}`}members(e,t,n,r=`
+`}function xa(e,t,n){if(e===null)return`unknown`;let r=M(n);if(e===``){let e=P(r,t).split(I).join(`/`);return e=e.replace(/\.(ts|tsx|mts|cts)$/i,``),e.startsWith(`.`)||(e=`./`+e),e}if(!e.startsWith(`.`)&&!e.startsWith(`/`))return e;let i=M(t),a=F(i,e),o=P(r,a).split(I).join(`/`);return o=o.replace(/\.(ts|tsx|mts|cts)$/i,``),o.startsWith(`.`)||(o=`./`+o),o}function Sa(e){let t=e.endsWith(`Controller`)?e.slice(0,-10):e,n=t.length>0?t:e;return n.charAt(0).toLowerCase()+n.slice(1)}const Ca=()=>({id:`kick/routes`,outExtension:`.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){let t=await e.getScanResult({root:wa(e),cwd:e.cwd,envFile:Ta(e)}),n=e.config?.typegen?.schemaValidator??`zod`,r=j.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return ha(t.routes,r,n,{onWarn:t=>e.log.warn(t)})}});function wa(e){return j.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Ta(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}const Ea=`@typescript/typescript6`;function Da(e){return typeof e?.createProgram==`function`}function Oa(e){if(Da(e.typescript))return{api:e.typescript,source:`typescript`};if(Da(e.ts6))return{api:e.ts6,source:Ea};let t=`Install it in the project:\n    pnpm add -D ${Ea}`;throw e.typescript?Error(`kick typegen: the client route map needs a TypeScript compiler API.
+  TypeScript 7 does not ship a compiler API, so the compatibility package is required.\n  ${t}`):Error(`kick typegen: the client route map needs a TypeScript compiler API, and neither 'typescript' nor '${Ea}' resolved from this project.\n  ${t}`)}async function ka(e){let t=je(N(e,`package.json`)),n=async e=>{try{return await import(L(t.resolve(e)).href)}catch{return null}},[r,i]=await Promise.all([n(`typescript`),n(Ea)]);return Oa({typescript:Aa(r),ts6:Aa(i)}).api}function Aa(e){let t=e;return t?.default&&typeof t.default==`object`?t.default:e}const ja=Symbol(`kick/client: expansion budget exhausted`);var Ma=class{ts;checker;program;opts;get printFlags(){return this.ts.TypeFormatFlags.NoTruncation}hoistedByType=/* @__PURE__ */ new Map;inProgress=/* @__PURE__ */ new Map;jsonInProgress=/* @__PURE__ */ new Set;nextName=0;blocks=[];maxDepth;truncations=0;budget;constructor(e,t,n,r={}){this.ts=e,this.checker=t,this.program=n,this.opts=r,this.maxDepth=r.maxDepth??12,this.budget=r.truncationBudget??1e3}hoisted(){return this.blocks}expand(e){this.truncations=0;let t=this.blocks.length,n=this.nextName,r=new Set(this.hoistedByType.keys());try{return this.render(e,0)}catch(e){if(e!==ja)throw e;this.blocks.length=t,this.nextName=n;for(let e of this.hoistedByType.keys())r.has(e)||this.hoistedByType.delete(e);return this.opts.onWarn?.(`expansion abandoned after ${this.budget} depth hoists — emitting 'unknown'. Either the response type never repeats (a generic that grows at every level) or it nests more distinct types than the budget allows; raising maxDepth hoists fewer of them. Declare a response schema on the route for an exact type.`),`unknown`}}render(e,t,n=!0){let r=this.ts.TypeFlags;if(n){let t=this.hoistedByType.get(e);if(t)return t}if(t>this.maxDepth&&!this.isLeaf(e))return this.hoistDeep(e);if(e.flags&(r.String|r.Number|r.Boolean|r.BigInt|r.ESSymbol)||e.flags&(r.Any|r.Unknown|r.Never|r.Void|r.Undefined|r.Null)||e.isLiteral()||e.flags&r.BooleanLiteral)return this.checker.typeToString(e,void 0,this.printFlags);if(e.isUnion()){let n=e.types.filter(e=>!this.isCallable(e));return(n.length>0?n:e.types).map(e=>this.render(e,t+1)).join(` | `)}if(e.isIntersection())return e.types.map(e=>this.render(e,t+1)).join(` & `);if(this.isTuple(e))return this.renderTuple(e,t);let i=this.arrayElement(e);if(i){let e=this.render(i.element,t+1),n=/[|&]/.test(e)?`(${e})[]`:`${e}[]`;return i.readonly?`readonly ${n}`:n}let a=this.toJsonType(e);if(a){if(this.jsonInProgress.has(e))return this.opts.onWarn?.(`'${this.checker.typeToString(e,void 0,this.printFlags)}' has a cyclic toJSON() — emitting 'unknown', since it has no serializable form.`),`unknown`;this.jsonInProgress.add(e);try{return this.render(a,t)}finally{this.jsonInProgress.delete(e)}}return this.isLibType(e)?this.renderLibType(e,t):e.flags&r.Object?this.renderObject(e,t):(this.opts.onWarn?.(`could not expand type '${this.checker.typeToString(e)}' — emitting 'unknown'`),`unknown`)}isLeaf(e){let t=this.ts.TypeFlags;return(e.flags&(t.String|t.Number|t.Boolean|t.BigInt|t.ESSymbol|t.Any|t.Unknown|t.Never|t.Void|t.Undefined|t.Null|t.BooleanLiteral))!==0||e.isLiteral()}hoistDeep(e){if(++this.truncations>this.budget)throw ja;let t=this.allocName();this.hoistedByType.set(e,t);let n=this.blocks.length;return this.blocks.push(``),this.blocks[n]=this.isPlainObject(e)?`interface ${t} {\n${this.members(e,0,`  `)}\n}`:`type ${t} = ${this.render(e,0,!1)}`,t}isPlainObject(e){return(e.flags&this.ts.TypeFlags.Object)!==0&&!e.isUnionOrIntersection()&&!this.isTuple(e)&&!this.arrayElement(e)&&!this.toJsonType(e)&&!this.isLibType(e)}renderObject(e,t){let n=this.hoistedByType.get(e);if(n)return n;if(this.isNamed(e)){let t=this.allocName();this.hoistedByType.set(e,t);let n=this.blocks.length;return this.blocks.push(``),this.blocks[n]=`interface ${t} {\n${this.members(e,0,`  `)}\n}`,t}let r=this.inProgress.get(e);if(r)return r.name??=this.allocName();let i={name:null};this.inProgress.set(e,i);let a;try{a=this.members(e,t,``,`; `)}finally{this.inProgress.delete(e)}if(i.name){this.hoistedByType.set(e,i.name);let t=this.blocks.length;return this.blocks.push(``),this.blocks[t]=`interface ${i.name} {\n${this.members(e,0,`  `)}\n}`,i.name}return a.length>0?`{ ${a} }`:`{}`}allocName(){return`__T${this.nextName++}`}members(e,t,n,r=`
 `){let i=[];for(let r of this.checker.getIndexInfosOfType(e)){let e=this.checker.typeToString(r.keyType,void 0,this.printFlags);i.push(`${n}[key: ${e}]: ${this.render(r.type,t+1)}`)}for(let r of this.checker.getPropertiesOfType(e)){let e=this.typeOfProperty(r);if(this.isCallable(e)||r.getName().startsWith(`__@`))continue;let a=(r.flags&this.ts.SymbolFlags.Optional)!==0,o=this.renderPropertyType(e,a,r,t+1),s=this.isReadonlyProp(r)?`readonly `:``;i.push(`${n}${s}${this.propName(r.getName())}${a?`?`:``}: ${o}`)}return i.join(r===`
 `?`
-`:r)}typeOfProperty(e){let t=this.checker;if(typeof t.getTypeOfSymbol==`function`)return t.getTypeOfSymbol(e);let n=e.valueDeclaration??e.declarations?.[0];return n?this.checker.getTypeOfSymbolAtLocation(e,n):this.checker.getDeclaredTypeOfSymbol(e)}renderPropertyType(e,t,n,r){if(!t||!e.isUnion()||this.declaresUndefined(n))return this.render(e,r);let i=e.types.filter(e=>!(e.flags&this.ts.TypeFlags.Undefined));return i.length===0?`undefined`:i.map(e=>this.render(e,r)).join(` | `)}isReadonlyProp(e){let t=e.valueDeclaration??e.declarations?.[0];return t?(this.ts.getCombinedModifierFlags(t)&this.ts.ModifierFlags.Readonly)!==0:!1}declaresUndefined(e){let t=e.valueDeclaration??e.declarations?.[0];if(!t||!(this.ts.isPropertySignature(t)||this.ts.isPropertyDeclaration(t))||!t.type)return!1;let n=this.checker.getTypeFromTypeNode(t.type);return(n.isUnion()?n.types:[n]).some(e=>(e.flags&this.ts.TypeFlags.Undefined)!==0)}renderTuple(e,t){let n=this.ts.ElementFlags,r=this.checker.getTypeArguments(e),i=e.target,a=i.elementFlags??[],o=r.map((e,r)=>{let i=a[r]??n.Required;return i&n.Optional?`${(e.isUnion()?e.types.filter(e=>!(e.flags&this.ts.TypeFlags.Undefined)):[e]).map(e=>this.render(e,t+1)).join(` | `)}?`:i&n.Rest?`...${this.render(e,t+1)}[]`:i&n.Variadic?`...${this.render(e,t+1)}`:this.render(e,t+1)});return`${i.readonly?`readonly `:``}[${o.join(`, `)}]`}propName(e){return/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(e)?e:JSON.stringify(e)}isLibType(e){let t=e.aliasSymbol?.declarations??e.getSymbol()?.declarations;return!t||t.length===0?!1:t.every(e=>this.program.isSourceFileDefaultLibrary(e.getSourceFile()))}renderLibType(e,t){let n=(e.aliasSymbol??e.getSymbol())?.getName(),r=e.aliasTypeArguments??this.typeArguments(e);return!n||r.length===0?this.checker.typeToString(e,void 0,this.printFlags):`${n}<${r.map(e=>this.render(e,t+1)).join(`, `)}>`}typeArguments(e){return!(e.flags&this.ts.TypeFlags.Object)||!(e.objectFlags&this.ts.ObjectFlags.Reference)?[]:this.checker.getTypeArguments(e)}toJsonType(e){if(!(e.flags&this.ts.TypeFlags.Object))return null;let t=this.checker.getPropertyOfType(e,`toJSON`);if(!t)return null;let[n]=this.checker.getSignaturesOfType(this.typeOfProperty(t),this.ts.SignatureKind.Call);if(!n)return null;let r=this.checker.getReturnTypeOfSignature(n);return r===e?null:r}isCallable(e){if(e.isUnion()){let t=e.types.filter(e=>!(e.flags&(this.ts.TypeFlags.Undefined|this.ts.TypeFlags.Null)));return t.length>0&&t.every(e=>this.isCallable(e))}return this.checker.getSignaturesOfType(e,this.ts.SignatureKind.Call).length>0||this.checker.getSignaturesOfType(e,this.ts.SignatureKind.Construct).length>0}isNamed(e){let t=e.getSymbol();if(!t)return!1;let n=t.getName();return n!==`__type`&&n!==`__object`&&n.length>0}isTuple(e){let t=this.ts.ObjectFlags;if(!(e.flags&this.ts.TypeFlags.Object)||!(e.objectFlags&t.Reference))return!1;let n=e.target;return!!(n&&n.objectFlags&t.Tuple)}arrayElement(e){let t=e.getSymbol()?.getName();if(t!==`Array`&&t!==`ReadonlyArray`)return null;let n=this.checker.getTypeArguments(e);return n.length===1?{element:n[0],readonly:t===`ReadonlyArray`}:null}};const Ta=[`pnpm-lock.yaml`,`package-lock.json`,`yarn.lock`,`bun.lock`,`bun.lockb`],Ea=/(?:^|[\\/])(?:node_modules|\.kickjs)(?:[\\/]|$)/;function Da(e){return Qe(`sha1`).update(e).digest(`hex`)}function Oa(e){let t=Qe(`sha1`);t.update(e.cliVersion),t.update(JSON.stringify(e.options??{})),t.update(e.keys.join(`
-`));for(let n of Ta){let r=N(e.projectDir,n);if(O(r))try{t.update(k(r))}catch(e){throw Error(`kick/client: cannot read lockfile ${r}`,{cause:e})}}for(let n of e.fileNames.toSorted())if(!Ea.test(n)){t.update(n);try{t.update(k(n))}catch(e){throw Error(`kick/client: cannot read project file ${n}`,{cause:e})}}return t.digest(`hex`)}async function ka(e){try{let t=await xa(e.compilerFrom??e.projectDir),n={...t.sys,onUnRecoverableConfigFileDiagnostic:()=>{}},r=t.getParsedCommandLineOfConfigFile(N(e.projectDir,`tsconfig.json`),{},n);return r?Oa({projectDir:e.projectDir,fileNames:r.fileNames,keys:e.keys,options:{...r.options,__kickMaxDepth:e.maxDepth??null},cliVersion:e.cliVersion}):null}catch{return null}}async function Aa(e){let t=await xa(e.compilerFrom??e.projectDir),n=N(M(e.routesFile),`__kick_client_probe__.ts`),r=Na(e.routesFile,e.keys),i=Ia(t,e.projectDir,n,r),a=i.getTypeChecker(),o=i.getSourceFile(n);if(!o)throw Error(`kick/client: could not add the resolution probe to the program. Check that ${e.routesFile} exists — run \`kick typegen\` first.`);ja(t,i,e.routesFile);let s=Pa(t,i,o,e.keys),c=null,l=new wa(t,a,i,{maxDepth:e.maxDepth,onWarn:t=>e.onWarn?.(c?`route '${c}': ${t}`:t)}),u=new Map;for(let[n,r]of e.keys.entries()){if(s.has(r)){e.onWarn?.(`route '${r}' is not present in KickRoutes.Api — skipped. Re-run \`kick typegen\` so the two maps agree.`);continue}let i=o.statements.find(e=>t.isTypeAliasDeclaration(e)&&e.name.text===Ma(n));if(!i){e.onWarn?.(`route '${r}' could not be resolved — skipped.`);continue}let d=a.getTypeAtLocation(i.type);if(d.flags&t.TypeFlags.Any){e.onWarn?.(`route '${r}' resolved to 'any' — skipped rather than emitted, since an 'any' entry silently accepts every call. Check that the server type-checks.`);continue}c=r,u.set(r,l.expand(d)),c=null}return{entries:u,hoisted:l.hoisted()}}function ja(e,t,n){let r=t.getSourceFile(n);if(!r)throw Error(`kick/client: ${n} is not in the TypeScript program. Run \`kick typegen\` first, and check that tsconfig.json includes .kickjs.`);let i=t.getSemanticDiagnostics(r);if(i.length===0)return;let a=i.slice(0,3).map(t=>`    ${e.flattenDiagnosticMessageText(t.messageText,` `)}`).join(`
-`);throw Error(`${n} has ${i.length} type error(s), so its route types cannot be resolved — every entry would come out as 'any'.\n${a}\n  Usually this means dependencies are not installed or the server does not type-check.`)}function Ma(e){return`_K${e}`}function Na(e,t){let n=`./`+Ie(e).replace(/\.tsx?$/,``),r=t.map((e,t)=>`type ${Ma(t)} = KickRoutes.Api[${JSON.stringify(e)}]`);return[`import ${JSON.stringify(n)}`,...r].join(`
+`:r)}typeOfProperty(e){let t=this.checker;if(typeof t.getTypeOfSymbol==`function`)return t.getTypeOfSymbol(e);let n=e.valueDeclaration??e.declarations?.[0];return n?this.checker.getTypeOfSymbolAtLocation(e,n):this.checker.getDeclaredTypeOfSymbol(e)}renderPropertyType(e,t,n,r){if(!t||!e.isUnion()||this.declaresUndefined(n))return this.render(e,r);let i=e.types.filter(e=>!(e.flags&this.ts.TypeFlags.Undefined));return i.length===0?`undefined`:i.map(e=>this.render(e,r)).join(` | `)}isReadonlyProp(e){let t=e.valueDeclaration??e.declarations?.[0];return t?(this.ts.getCombinedModifierFlags(t)&this.ts.ModifierFlags.Readonly)!==0:!1}declaresUndefined(e){let t=e.valueDeclaration??e.declarations?.[0];if(!t||!(this.ts.isPropertySignature(t)||this.ts.isPropertyDeclaration(t))||!t.type)return!1;let n=this.checker.getTypeFromTypeNode(t.type);return(n.isUnion()?n.types:[n]).some(e=>(e.flags&this.ts.TypeFlags.Undefined)!==0)}renderTuple(e,t){let n=this.ts.ElementFlags,r=this.checker.getTypeArguments(e),i=e.target,a=i.elementFlags??[],o=r.map((e,r)=>{let i=a[r]??n.Required;return i&n.Optional?`${(e.isUnion()?e.types.filter(e=>!(e.flags&this.ts.TypeFlags.Undefined)):[e]).map(e=>this.render(e,t+1)).join(` | `)}?`:i&n.Rest?`...${this.render(e,t+1)}[]`:i&n.Variadic?`...${this.render(e,t+1)}`:this.render(e,t+1)});return`${i.readonly?`readonly `:``}[${o.join(`, `)}]`}propName(e){return/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(e)?e:JSON.stringify(e)}isLibType(e){let t=e.aliasSymbol?.declarations??e.getSymbol()?.declarations;return!t||t.length===0?!1:t.every(e=>this.program.isSourceFileDefaultLibrary(e.getSourceFile()))}renderLibType(e,t){let n=(e.aliasSymbol??e.getSymbol())?.getName(),r=e.aliasTypeArguments??this.typeArguments(e);return!n||r.length===0?this.checker.typeToString(e,void 0,this.printFlags):`${n}<${r.map(e=>this.render(e,t+1)).join(`, `)}>`}typeArguments(e){return!(e.flags&this.ts.TypeFlags.Object)||!(e.objectFlags&this.ts.ObjectFlags.Reference)?[]:this.checker.getTypeArguments(e)}toJsonType(e){if(!(e.flags&this.ts.TypeFlags.Object))return null;let t=this.checker.getPropertyOfType(e,`toJSON`);if(!t)return null;let[n]=this.checker.getSignaturesOfType(this.typeOfProperty(t),this.ts.SignatureKind.Call);if(!n)return null;let r=this.checker.getReturnTypeOfSignature(n);return r===e?null:r}isCallable(e){if(e.isUnion()){let t=e.types.filter(e=>!(e.flags&(this.ts.TypeFlags.Undefined|this.ts.TypeFlags.Null)));return t.length>0&&t.every(e=>this.isCallable(e))}return this.checker.getSignaturesOfType(e,this.ts.SignatureKind.Call).length>0||this.checker.getSignaturesOfType(e,this.ts.SignatureKind.Construct).length>0}isNamed(e){let t=e.getSymbol();if(!t)return!1;let n=t.getName();return n!==`__type`&&n!==`__object`&&n.length>0}isTuple(e){let t=this.ts.ObjectFlags;if(!(e.flags&this.ts.TypeFlags.Object)||!(e.objectFlags&t.Reference))return!1;let n=e.target;return!!(n&&n.objectFlags&t.Tuple)}arrayElement(e){let t=e.getSymbol()?.getName();if(t!==`Array`&&t!==`ReadonlyArray`)return null;let n=this.checker.getTypeArguments(e);return n.length===1?{element:n[0],readonly:t===`ReadonlyArray`}:null}};const Na=[`pnpm-lock.yaml`,`package-lock.json`,`yarn.lock`,`bun.lock`,`bun.lockb`],Pa=/(?:^|[\\/])(?:node_modules|\.kickjs)(?:[\\/]|$)/;function Fa(e){return Ke(`sha1`).update(e).digest(`hex`)}function Ia(e){let t=Ke(`sha1`);t.update(e.cliVersion),t.update(JSON.stringify(e.options??{})),t.update(e.keys.join(`
+`));for(let n of Na){let r=N(e.projectDir,n);if(D(r))try{t.update(O(r))}catch(e){throw Error(`kick/client: cannot read lockfile ${r}`,{cause:e})}}for(let n of e.fileNames.toSorted())if(!Pa.test(n)){t.update(n);try{t.update(O(n))}catch(e){throw Error(`kick/client: cannot read project file ${n}`,{cause:e})}}return t.digest(`hex`)}async function La(e){try{let t=await ka(e.compilerFrom??e.projectDir),n={...t.sys,onUnRecoverableConfigFileDiagnostic:()=>{}},r=t.getParsedCommandLineOfConfigFile(N(e.projectDir,`tsconfig.json`),{},n);return r?Ia({projectDir:e.projectDir,fileNames:r.fileNames,keys:e.keys,options:{...r.options,__kickMaxDepth:e.maxDepth??null},cliVersion:e.cliVersion}):null}catch{return null}}async function Ra(e){let t=await ka(e.compilerFrom??e.projectDir),n=N(M(e.routesFile),`__kick_client_probe__.ts`),r=Va(e.routesFile,e.keys),i=Wa(t,e.projectDir,n,r),a=i.getTypeChecker(),o=i.getSourceFile(n);if(!o)throw Error(`kick/client: could not add the resolution probe to the program. Check that ${e.routesFile} exists — run \`kick typegen\` first.`);za(t,i,e.routesFile);let s=Ha(t,i,o,e.keys),c=null,l=new Ma(t,a,i,{maxDepth:e.maxDepth,onWarn:t=>e.onWarn?.(c?`route '${c}': ${t}`:t)}),u=/* @__PURE__ */ new Map;for(let[n,r]of e.keys.entries()){if(s.has(r)){e.onWarn?.(`route '${r}' is not present in KickRoutes.Api — skipped. Re-run \`kick typegen\` so the two maps agree.`);continue}let i=o.statements.find(e=>t.isTypeAliasDeclaration(e)&&e.name.text===Ba(n));if(!i){e.onWarn?.(`route '${r}' could not be resolved — skipped.`);continue}let d=a.getTypeAtLocation(i.type);d.flags&t.TypeFlags.Any?e.onWarn?.(`route '${r}' resolved to 'any' — skipped rather than emitted, since an 'any' entry silently accepts every call. Check that the server type-checks.`):(c=r,u.set(r,l.expand(d)),c=null)}return{entries:u,hoisted:l.hoisted()}}function za(e,t,n){let r=t.getSourceFile(n);if(!r)throw Error(`kick/client: ${n} is not in the TypeScript program. Run \`kick typegen\` first, and check that tsconfig.json includes .kickjs.`);let i=t.getSemanticDiagnostics(r);if(i.length===0)return;let a=i.slice(0,3).map(t=>`    ${e.flattenDiagnosticMessageText(t.messageText,` `)}`).join(`
+`);throw Error(`${n} has ${i.length} type error(s), so its route types cannot be resolved — every entry would come out as 'any'.\n${a}\n  Usually this means dependencies are not installed or the server does not type-check.`)}function Ba(e){return`_K${e}`}function Va(e,t){let n=`./`+Ie(e).replace(/\.tsx?$/,``),r=t.map((e,t)=>`type ${Ba(t)} = KickRoutes.Api[${JSON.stringify(e)}]`);return[`import ${JSON.stringify(n)}`,...r].join(`
 `)+`
-`}function Pa(e,t,n,r){let i=new Set,a=new Map;for(let t of n.statements)e.isTypeAliasDeclaration(t)&&a.set(t.name.text,t);for(let e of t.getSemanticDiagnostics(n))if(e.start!==void 0)for(let[t,o]of r.entries()){let r=a.get(Ma(t));r&&e.start>=r.getStart(n)&&e.start<r.getEnd()&&i.add(o)}return i}function Fa(e,t){let n=e.filter(e=>/\.d\.(ts|mts|cts)$/.test(e)),r=[];try{r=A(t).filter(e=>e.endsWith(`.ts`)).map(e=>N(t,e))}catch{}return[...new Set([...n,...r])]}function Ia(e,t,n,r){let i=N(t,`tsconfig.json`),a={...e.sys,onUnRecoverableConfigFileDiagnostic:t=>{throw Error(e.flattenDiagnosticMessageText(t.messageText,`
-`))}},o=e.getParsedCommandLineOfConfigFile(i,{},a);if(!o)throw Error(`kick/client: could not read ${i}`);let s=e.createCompilerHost(o.options,!0),c=s.readFile.bind(s),l=s.getSourceFile.bind(s),u=s.fileExists.bind(s);return s.readFile=e=>e===n?r:c(e),s.fileExists=e=>e===n||u(e),s.getSourceFile=(t,i,a,o)=>t===n?e.createSourceFile(t,r,i,!0):l(t,i,a,o),e.createProgram({rootNames:[...Fa(o.fileNames,M(n)),n],options:o.options,host:s})}const La=`/* eslint-disable */
+`}function Ha(e,t,n,r){let i=/* @__PURE__ */ new Set,a=/* @__PURE__ */ new Map;for(let t of n.statements)e.isTypeAliasDeclaration(t)&&a.set(t.name.text,t);for(let e of t.getSemanticDiagnostics(n))if(e.start!==void 0)for(let[t,o]of r.entries()){let r=a.get(Ba(t));r&&e.start>=r.getStart(n)&&e.start<r.getEnd()&&i.add(o)}return i}function Ua(e,t){let n=e.filter(e=>/\.d\.(ts|mts|cts)$/.test(e)),r=[];try{r=k(t).filter(e=>e.endsWith(`.ts`)).map(e=>N(t,e))}catch{}return[.../* @__PURE__ */ new Set([...n,...r])]}function Wa(e,t,n,r){let i=N(t,`tsconfig.json`),a={...e.sys,onUnRecoverableConfigFileDiagnostic:t=>{throw Error(e.flattenDiagnosticMessageText(t.messageText,`
+`))}},o=e.getParsedCommandLineOfConfigFile(i,{},a);if(!o)throw Error(`kick/client: could not read ${i}`);let s=e.createCompilerHost(o.options,!0),c=s.readFile.bind(s),l=s.getSourceFile.bind(s),u=s.fileExists.bind(s);return s.readFile=e=>e===n?r:c(e),s.fileExists=e=>e===n||u(e),s.getSourceFile=(t,i,a,o)=>t===n?e.createSourceFile(t,r,i,!0):l(t,i,a,o),e.createProgram({rootNames:[...Ua(o.fileNames,M(n)),n],options:o.options,host:s})}const Ga=`/* eslint-disable */
 // AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
 //
 // Self-contained: this file has no imports, so a frontend consumes it without
 // compiling the server, its decorators, or its path aliases.
 //
-//   // Ambient — add this file to the frontend's tsconfig "include", then:
+//   // Ambient — list this file in the frontend's tsconfig "types", then:
 //   export const api = createClient<KickClientApi.Api>({ baseUrl: '/api/v1' })
 //
 //   // Or import it explicitly, if you prefer no globals:
 //   import type { Api } from './path/to/kick__client'
 //
-// Not refreshed by \`kick dev\` — resolving these types builds a full
-// TypeScript program over the server. Re-run \`kick typegen\`.
-`;function Ra(e,t){let n=t.filter(t=>e.entries.has(t));if(n.length===0)return`${La}
+// Written when \`kick dev\` starts, not on save — resolving these types builds a
+// full TypeScript program over the server. Re-run \`kick typegen\`.
+`;function Ka(e,t){let n=t.filter(t=>e.entries.has(t));if(n.length===0)return`${Ga}
 // (no routes discovered yet — annotate a controller method with
 //  @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
 interface Api {}
@@ -1761,7 +1775,7 @@ export type { Api }
 
 `)+`
 
-`:``,i=n.map(t=>`  ${JSON.stringify(t)}: ${e.entries.get(t)}`);return`${La}
+`:``,i=n.map(t=>`  ${JSON.stringify(t)}: ${e.entries.get(t)}`);return`${Ga}
 ${r}interface Api {
 ${i.join(`
 `)}
@@ -1775,7 +1789,7 @@ declare global {
 }
 
 export type { Api }
-`}const za=`kick/client`,$=`.kickjs/types/kick__client.d.ts`,Ba=`.kickjs/cache/client-map.sha1`,Va=(()=>{try{return Ae(import.meta.url)(`../../../package.json`).version??`0.0.0`}catch{return`0.0.0`}})();function Ha(e){try{if(!O(e))return null;let[t,n]=k(e,`utf-8`).trim().split(/\s+/);return t&&n?{inputs:t,output:n}:null}catch{return null}}function Ua(e){return`${Pn}${za} */\n\n${e}\n`}function Wa(e){try{return O(e)?k(e,`utf-8`):null}catch{return null}}async function Ga(e){let t=j.resolve(e.cwd,$);if(!O(t))return!1;try{await Ge(t,{force:!0})}catch(t){return e.log.warn(`  kick/client: could not remove the stale ${$} — treat it as out of date (${t instanceof Error?t.message:String(t)})`),!0}return e.log.warn(`  kick/client: removed the previously generated ${$} rather than leave a stale one — re-run \`kick typegen\` once the cause above is fixed.`),!0}function Ka(e){let t=e?.typegen?.client;return typeof t==`object`?t.maxDepth:void 0}function qa(e){let t=e.config?.typegen?.client;return typeof t==`boolean`?t:t&&typeof t==`object`?t.enabled!==!1:(O(j.resolve(e.cwd,$))&&e.log.warn(`  kick/client: ${$} exists but typegen.client is not set, so it is NOT being refreshed.\n  Add \`typegen: { client: true }\` to kick.config.ts to keep it current, or delete the file if nothing reads it.`),!1)}const Ja=()=>({id:za,outExtension:`.d.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){if(!qa(e))return null;if(e.watch)return e.log.info?.("  kick/client: skipped under watch (builds a full TypeScript program). Run `kick typegen` to refresh the client route map."),null;let t=await e.getScanResult({root:j.resolve(e.cwd,e.config?.typegen?.srcDir??`src`),cwd:e.cwd}),n=[],r=new Set;for(let e of t.routes){let t=`${e.httpMethod} ${e.mountedPath??e.path}`;r.has(t)||(r.add(t),n.push(t))}let i=Ka(e.config),a=await ka({projectDir:e.cwd,keys:n,maxDepth:i,cliVersion:Va}),o=Ha(j.resolve(e.cwd,Ba)),s=Wa(j.resolve(e.cwd,$));if(a&&o&&s!==null&&o.inputs===a&&o.output===Da(s))return Sn()&&e.log.info?.(`  kick/client: unchanged, keeping ${$}`),null;try{let t=Ra(await Aa({projectDir:e.cwd,routesFile:j.resolve(e.cwd,`.kickjs/types/kick__routes.ts`),keys:n,maxDepth:i,onWarn:t=>e.log.warn(t)}),n);return a&&!e.check&&await e.writeFile(Ba,`${a} ${Da(Ua(t))}`),t}catch(t){let n=O(j.resolve(e.cwd,$)),r=`  kick/client: skipped — ${t instanceof Error?t.message:String(t)}`;return n?e.log.warn(r):Sn()&&e.log.info?.(r),n&&await Ga(e),null}}});function Ya(e,t,n=`zod`){if(!e)return null;let r=M(t),i=P(r,e.filePath).split(Le).join(`/`);return i=i.replace(/\.(ts|tsx|mts|cts)$/i,``),i.startsWith(`.`)||(i=`./`+i),`/* eslint-disable */
+`}const qa=`kick/client`,$=`.kickjs/types/kick__client.d.ts`,Ja=`.kickjs/cache/client-map.sha1`,Ya=(()=>{try{return je(import.meta.url)(`../../../package.json`).version??`0.0.0`}catch{return`0.0.0`}})();function Xa(e){try{if(!D(e))return null;let[t,n]=O(e,`utf-8`).trim().split(/\s+/);return t&&n?{inputs:t,output:n}:null}catch{return null}}function Za(e){return`${Pn}${qa} */\n\n${e}\n`}function Qa(e){try{return D(e)?O(e,`utf-8`):null}catch{return null}}async function $a(e){let t=j.resolve(e.cwd,$);if(!D(t))return!1;try{await We(t,{force:!0})}catch(t){return e.log.warn(`  kick/client: could not remove the stale ${$} — treat it as out of date (${t instanceof Error?t.message:String(t)})`),!0}return e.log.warn(`  kick/client: removed the previously generated ${$} rather than leave a stale one — re-run \`kick typegen\` once the cause above is fixed.`),!0}function eo(e){let t=e?.typegen?.client;return typeof t==`object`?t.maxDepth:void 0}function to(e){let t=e.config?.typegen?.client;return typeof t==`boolean`?t:t&&typeof t==`object`?t.enabled!==!1:(D(j.resolve(e.cwd,$))&&e.log.warn(`  kick/client: ${$} exists but typegen.client is not set, so it is NOT being refreshed.\n  Add \`typegen: { client: true }\` to kick.config.ts to keep it current, or delete the file if nothing reads it.`),!1)}const no=()=>({id:qa,outExtension:`.d.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){if(!to(e))return null;if(e.watch)return e.log.info?.("  kick/client: skipped under watch (builds a full TypeScript program). Run `kick typegen` to refresh the client route map."),null;let t=await e.getScanResult({root:j.resolve(e.cwd,e.config?.typegen?.srcDir??`src`),cwd:e.cwd}),n=[],r=/* @__PURE__ */ new Set;for(let e of t.routes){let t=`${e.httpMethod} ${e.mountedPath??e.path}`;r.has(t)||(r.add(t),n.push(t))}let i=eo(e.config),a=await La({projectDir:e.cwd,keys:n,maxDepth:i,cliVersion:Ya}),o=Xa(j.resolve(e.cwd,Ja)),s=Qa(j.resolve(e.cwd,$));if(a&&o&&s!==null&&o.inputs===a&&o.output===Fa(s))return Sn()&&e.log.info?.(`  kick/client: unchanged, keeping ${$}`),null;try{let t=Ka(await Ra({projectDir:e.cwd,routesFile:j.resolve(e.cwd,`.kickjs/types/kick__routes.ts`),keys:n,maxDepth:i,onWarn:t=>e.log.warn(t)}),n);return a&&!e.check&&await e.writeFile(Ja,`${a} ${Fa(Za(t))}`),t}catch(t){let n=D(j.resolve(e.cwd,$)),r=`  kick/client: skipped — ${t instanceof Error?t.message:String(t)}`;return n?e.log.warn(r):Sn()&&e.log.info?.(r),n&&await $a(e),null}}});function ro(e,t,n=`zod`){if(!e)return null;let r=M(t),i=P(r,e.filePath).split(I).join(`/`);return i=i.replace(/\.(ts|tsx|mts|cts)$/i,``),i.startsWith(`.`)||(i=`./`+i),`/* eslint-disable */
 // AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
 // Re-run with \`kick typegen\` or rely on \`kick dev\` to refresh.
 
@@ -1813,5 +1827,5 @@ declare global {
 }
 
 export {}
-`}const Xa=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=Qa(e);if(t===!1)return null;let n=await e.getScanResult({root:Za(e),cwd:e.cwd,envFile:t});if(!n.env)return null;let r=e.config?.typegen?.schemaValidator??`zod`,i=j.resolve(e.cwd,`.kickjs/types/kick__env.ts`);return Ya(n.env,i,r)}});function Za(e){return j.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Qa(e){return e.config?.typegen?.envFile}function $a(e){return j.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function eo(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function to(e){return{root:$a(e),cwd:e.cwd,envFile:eo(e)}}const no=()=>({id:`kick/registry`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(to(e)),n=j.resolve(e.cwd,`.kickjs/types/kick__registry.d.ts`),r=new Set(t.collisions.map(e=>e.className));return me(t.classes,n,r)}}),ro=()=>({id:`kick/services`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(to(e)),n=new Set(t.collisions.map(e=>e.className)),r=ve(t.classes,t.tokens,t.injects,n);return ye(`ServiceToken`,r,"(no tokens discovered — declare with createToken<T>() or `kick g service <name>`)")}}),io=()=>({id:`kick/modules`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(to(e));return ye(`ModuleToken`,fe(t.classes),"(no @Module classes discovered — `kick g module <name>` to add one)")}}),ao=()=>({id:`kick/plugins`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(to(e));return pe(t.pluginsAndAdapters)}}),oo=()=>({id:`kick/context`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(to(e));return t.contextKeys.length===0?null:Te(t.contextKeys)}}),so=()=>({id:`kick/route-flags`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(to(e));return xe(t.routeFlags)}}),co={fastify:{subpath:`@forinda/kickjs/fastify`,typeName:`FastifyRuntimeTypes`},h3:{subpath:`@forinda/kickjs/h3`,typeName:`H3RuntimeTypes`}},lo=()=>({id:`kick/runtime`,outExtension:`.ts`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`,`kick.config.json`],async generate(e){let t=e.config?.runtime;if(t!==`fastify`&&t!==`h3`)return null;let{subpath:n,typeName:r}=co[t];return[`// Runtime escape-hatch types for the '${t}' engine (kick.config runtime).`,`declare module '@forinda/kickjs' {`,`  interface KickRuntimeRegister {`,`    runtime: import('${n}').${r}`,`  }`,`}`,``,`export {}`,``].join(`
-`)}});var uo=e({builtinCliPlugins:()=>fo});const fo=[_({name:`kick/init`,register:et}),_({name:`kick/generate`,register:Mn}),_({name:`kick/run`,register:Yn}),_({name:`kick/info`,register:er}),_({name:`kick/inspect`,register:ur}),_({name:`kick/add`,register:i}),_({name:`kick/list`,register:s}),_({name:`kick/explain`,register:yr}),_({name:`kick/mcp`,register:Ar}),_({name:`kick/tinker`,register:Pr}),_({name:`kick/remove`,register:Br}),_({name:`kick/typegen`,register:Ur}),_({name:`kick/check`,register:ci}),_({name:`kick/doctor`,register:Hi}),_({name:`kick/codemod`,register:Wi}),_({name:`kick/deploy`,register:ia}),_({name:`kick/registry`,typegens:[no()]}),_({name:`kick/services`,typegens:[ro()]}),_({name:`kick/modules`,typegens:[io()]}),_({name:`kick/plugins`,typegens:[ao()]}),_({name:`kick/context`,typegens:[oo()]}),_({name:`kick/route-flags`,typegens:[so()]}),_({name:`kick/assets`,typegens:[aa()]}),_({name:`kick/routes`,typegens:[ha()]}),_({name:`kick/client`,typegens:[Ja()]}),_({name:`kick/env`,typegens:[Xa()]}),_({name:`kick/runtime`,typegens:[lo()]})];export{Rn as n,fo as t};
+`}const io=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=oo(e);if(t===!1)return null;let n=await e.getScanResult({root:ao(e),cwd:e.cwd,envFile:t});if(!n.env)return null;let r=e.config?.typegen?.schemaValidator??`zod`,i=j.resolve(e.cwd,`.kickjs/types/kick__env.ts`);return ro(n.env,i,r)}});function ao(e){return j.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function oo(e){return e.config?.typegen?.envFile}function so(e){return j.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function co(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function lo(e){return{root:so(e),cwd:e.cwd,envFile:co(e)}}const uo=()=>({id:`kick/registry`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(lo(e)),n=j.resolve(e.cwd,`.kickjs/types/kick__registry.d.ts`),r=new Set(t.collisions.map(e=>e.className));return he(t.classes,n,r)}}),fo=()=>({id:`kick/services`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(lo(e)),n=new Set(t.collisions.map(e=>e.className)),r=ye(t.classes,t.tokens,t.injects,n);return be(`ServiceToken`,r,"(no tokens discovered — declare with createToken<T>() or `kick g service <name>`)")}}),po=()=>({id:`kick/modules`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(lo(e));return be(`ModuleToken`,pe(t.classes),"(no @Module classes discovered — `kick g module <name>` to add one)")}}),mo=()=>({id:`kick/plugins`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(lo(e));return me(t.pluginsAndAdapters)}}),ho=()=>({id:`kick/context`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(lo(e));return t.contextKeys.length===0?null:Ee(t.contextKeys)}}),go=()=>({id:`kick/route-flags`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(lo(e));return Se(t.routeFlags)}}),_o={fastify:{subpath:`@forinda/kickjs/fastify`,typeName:`FastifyRuntimeTypes`},h3:{subpath:`@forinda/kickjs/h3`,typeName:`H3RuntimeTypes`}},vo=()=>({id:`kick/runtime`,outExtension:`.ts`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`,`kick.config.json`],async generate(e){let t=e.config?.runtime;if(t!==`fastify`&&t!==`h3`)return null;let{subpath:n,typeName:r}=_o[t];return[`// Runtime escape-hatch types for the '${t}' engine (kick.config runtime).`,`declare module '@forinda/kickjs' {`,`  interface KickRuntimeRegister {`,`    runtime: import('${n}').${r}`,`  }`,`}`,``,`export {}`,``].join(`
+`)}});var yo=/* @__PURE__ */ e({builtinCliPlugins:()=>bo});const bo=[_({name:`kick/init`,register:$e}),_({name:`kick/generate`,register:Mn}),_({name:`kick/run`,register:Yn}),_({name:`kick/info`,register:er}),_({name:`kick/inspect`,register:ur}),_({name:`kick/add`,register:a}),_({name:`kick/list`,register:s}),_({name:`kick/explain`,register:yr}),_({name:`kick/mcp`,register:Ar}),_({name:`kick/tinker`,register:Pr}),_({name:`kick/remove`,register:Br}),_({name:`kick/typegen`,register:Ur}),_({name:`kick/check`,register:ci}),_({name:`kick/doctor`,register:Ui}),_({name:`kick/codemod`,register:Gi}),_({name:`kick/deploy`,register:fa}),_({name:`kick/registry`,typegens:[uo()]}),_({name:`kick/services`,typegens:[fo()]}),_({name:`kick/modules`,typegens:[po()]}),_({name:`kick/plugins`,typegens:[mo()]}),_({name:`kick/context`,typegens:[ho()]}),_({name:`kick/route-flags`,typegens:[go()]}),_({name:`kick/assets`,typegens:[pa()]}),_({name:`kick/routes`,typegens:[Ca()]}),_({name:`kick/client`,typegens:[no()]}),_({name:`kick/env`,typegens:[io()]}),_({name:`kick/runtime`,typegens:[vo()]})];export{Rn as n,bo as t};