@forinda/kickjs-cli 8.3.0 → 8.4.0

package/dist/{run-plugins-lLfcDAbT.mjs → run-plugins-DSYGn4AC.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.3.0
+ * @forinda/kickjs-cli v8.4.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,7 +8,7 @@
  *
  * @license MIT
  */
-import{t as e}from"./rolldown-runtime-BeIFeoWC.mjs";import{c as t,l as n,s as r}from"./project-docs-B6XKHBMO.mjs";import{a as i,c as a,d as o,i as s,l as c,n as l,o as u,r as d,s as f,t as p,u as m}from"./prompts-BtUBi1ob.mjs";import{A as h,C as g,D as _,E as v,M as y,N as b,O as ee,P as x,S as te,T as ne,_ as re,a as ie,b as ae,c as oe,f as se,g as ce,h as le,i as ue,j as de,k as S,l as fe,m as pe,p as me,r as he,u as ge,v as _e,w as ve,x as ye,y as be}from"./doctor-3-n9AElz.mjs";import{c as xe,m as Se,r as Ce,s as we,t as Te,u as Ee}from"./project-D-8rOQYi.mjs";import{a as De,c as Oe,i as ke,l as Ae,o as C,s as w,u as je}from"./config-LkaeajTr.mjs";import{t as T}from"./project-root-6mdsMXwA.mjs";import{n as E,t as Me}from"./types-HQhLYWkB.mjs";import{t as Ne}from"./build-BKNvIOBh.mjs";import{n as Pe}from"./agent-docs-CpoUa3NG.mjs";import{C as Fe,S as D,T as Ie,_ as Le,a as Re,b as ze,c as Be,d as Ve,f as He,g as Ue,h as We,i as Ge,l as Ke,m as qe,o as Je,p as Ye,r as Xe,s as Ze,t as O,u as Qe,v as $e,w as et,x as tt,y as nt}from"./typegen-yk3CJH18.mjs";import{createRequire as rt}from"node:module";import k,{basename as it,dirname as A,join as j,relative as M,resolve as N,sep as P}from"node:path";import{cpSync as at,existsSync as F,mkdirSync as ot,readFileSync as I,readdirSync as st,rmSync as ct,writeFileSync as L}from"node:fs";import{copyFile as lt,mkdir as ut,readFile as R,readdir as dt,rm as ft,stat as pt,writeFile as z}from"node:fs/promises";import{fork as mt,spawn as ht,spawnSync as gt}from"node:child_process";import{fileURLToPath as _t,pathToFileURL as B}from"node:url";import{parseSync as vt}from"oxc-parser";import{arch as yt,platform as bt,release as xt}from"node:os";import{createHash as St}from"node:crypto";const Ct=[{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 wt(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(`--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)=>{l(`KickJS — Create a new project`);let n=!!(t.yes||t.nonInteractive);e||=n?`my-api`:await a({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let r;if(e===`.`?(r=N(`.`),e=it(r)):r=N(t.directory||e),F(r)){let a=st(r);if(a.length>0){if(t.force)d.warn(`Clearing existing files in ${r}`);else if(n){d.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),i(`Aborted.`);return}else{d.warn(`Directory "${e}" is not empty:`);let t=a.slice(0,5);for(let e of t)d.message(`  - ${e}`);if(a.length>5&&d.message(`  ... and ${a.length-5} more`),!await p({message:m.red(`Remove all existing files and proceed?`),initialValue:!1})){i(`Aborted.`);return}}for(let e of a)ct(N(r,e),{recursive:!0,force:!0})}}let o=t.template;o||=n?`minimal`:await u({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 c=t.runtime;c||=n?`express`:await u({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 f=t.pm;f||=n?await Ee(void 0):await u({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let h=t.repo;h||=n?`inmemory`:await a({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),je(h);let g=t.schema;g||=n?`zod`:await u({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(g)||(d.warn(`Unknown --schema "${g}", falling back to zod.`),g=`zod`);let _;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();_=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else _=n?[]:await s({message:`Select packages to include`,options:[...Ct],required:!1});let v;v=t.git===void 0?n?!0:await p({message:`Initialize git repository?`,initialValue:!0}):t.git;let y;if(y=t.install===void 0?n?!0:await p({message:`Install dependencies?`,initialValue:!0}):t.install,o===`fullstack`){let{initFullstackProject:t}=await import(`./fullstack-D_OHhyZX.mjs`);await t({name:e,directory:r,packageManager:f,initGit:v,installDeps:y,schemaLib:g,runtime:c}),i(`Done! Next steps: ${m.cyan(`cd ${e} && ${f}${f===`pnpm`?` dev`:` run dev:server`}`)}`);return}await Te({name:e,directory:r,packageManager:f,initGit:v,installDeps:y,template:o,defaultRepo:h,packages:_,schemaLib:g,runtime:c}),i(`Done! Next steps: ${m.cyan(`cd ${e} && ${f} dev`)}`)})}function Tt(e,t=[]){let n=new Map;for(let t of e){let e=(n.get(t.name)??0)+1;if(n.set(t.name,e),e===2)throw new Me(`plugin`,t.name,[t.name,t.name])}let r=new Map,i=[];for(let t of e)for(let e of t.commands??[]){let n=r.get(e.name);if(n)throw new Me(`command`,e.name,[n,t.name]);r.set(e.name,t.name),i.push(e)}let a=new Set(t.map(e=>e.name)),o=[...i.filter(e=>!a.has(e.name)),...t],s=new Map,c=[];for(let t of e)for(let e of t.typegens??[]){let n=s.get(e.id);if(n)throw new Me(`typegen`,e.id,[n,t.name]);s.set(e.id,t.name),c.push(e)}let l=new Map,u=[];for(let t of e)for(let e of t.generators??[]){let n=l.get(e.name);if(n)throw new Me(`generator`,e.name,[n,t.name]);l.set(e.name,t.name),u.push({source:t.name,spec:e})}return{commands:o,typegens:c,generators:u,register:async(t,n)=>{let r;if(n)r={generators:u,...n};else{let{findProjectRoot:e}=await import(`./project-root-6mdsMXwA.mjs`).then(e=>e.n),t=process.cwd();r={cwd:t,projectRoot:e(t),config:null,log:()=>{},generators:u}}for(let n of e)n.register&&await n.register(t,r)}}}async function Et(e){let{name:t,outDir:r}=e,i=b(t),a=x(t),o=[],s=j(r,`${i}.plugin.ts`);return await n(s,`import {
+import{t as e}from"./rolldown-runtime-LCdccCoI.mjs";import{c as t,l as n,s as r}from"./project-docs-8d5GNDIw.mjs";import{a as i,c as a,d as o,i as s,l as c,n as l,o as u,r as d,s as f,t as p,u as m}from"./prompts-DHHDYxLL.mjs";import{A as h,C as g,D as _,E as v,M as y,N as b,O as x,P as S,S as C,T as ee,_ as te,a as ne,b as re,c as ie,f as ae,g as oe,h as se,i as ce,j as le,k as ue,l as de,m as fe,p as pe,r as me,u as he,v as ge,w as _e,x as ve,y as ye}from"./doctor-DzqvC6jF.mjs";import{c as be,m as xe,r as Se,s as Ce,t as we,u as Te}from"./project-JoccwqS2.mjs";import{a as Ee,c as De,i as Oe,l as ke,o as w,s as T,u as Ae}from"./config-B6LRxtE1.mjs";import{t as E}from"./project-root-DORRVmte.mjs";import{n as D,t as je}from"./types-CW4qiwB1.mjs";import{t as Me}from"./build-Bw_SFnBG.mjs";import{n as Ne}from"./agent-docs-DWRW_0cn.mjs";import{C as Pe,S as O,T as Fe,_ as Ie,a as Le,b as Re,c as ze,d as Be,f as Ve,g as He,h as Ue,i as We,l as Ge,m as Ke,o as qe,p as Je,r as Ye,s as Xe,t as Ze,u as Qe,v as $e,w as et,x as tt,y as nt}from"./typegen-COTKpuqW.mjs";import{createRequire as rt}from"node:module";import k,{basename as it,dirname as A,join as j,relative as M,resolve as N,sep as P}from"node:path";import{cpSync as at,existsSync as F,mkdirSync as ot,readFileSync as I,readdirSync as st,rmSync as ct,writeFileSync as L}from"node:fs";import{copyFile as lt,mkdir as ut,readFile as R,readdir as dt,rm as ft,stat as pt,writeFile as z}from"node:fs/promises";import{fork as mt,spawn as ht,spawnSync as gt}from"node:child_process";import{fileURLToPath as _t,pathToFileURL as B}from"node:url";import{parseSync as vt}from"oxc-parser";import{arch as yt,platform as bt,release as xt}from"node:os";import{createHash as St}from"node:crypto";const Ct=[{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 wt(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)=>{l(`KickJS — Create a new project`);let n=!!(t.yes||t.nonInteractive);e||=n?`my-api`:await a({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let r;if(e===`.`?(r=N(`.`),e=it(r)):r=N(t.directory||e),F(r)){let a=st(r);if(a.length>0){if(t.force)d.warn(`Clearing existing files in ${r}`);else if(n){d.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),i(`Aborted.`);return}else{d.warn(`Directory "${e}" is not empty:`);let t=a.slice(0,5);for(let e of t)d.message(`  - ${e}`);if(a.length>5&&d.message(`  ... and ${a.length-5} more`),!await p({message:m.red(`Remove all existing files and proceed?`),initialValue:!1})){i(`Aborted.`);return}}for(let e of a)ct(N(r,e),{recursive:!0,force:!0})}}let o=t.template;o||=n?`minimal`:await u({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 c=t.runtime;c||=n?`express`:await u({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 f=t.pm;f||=n?await Te(void 0):await u({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let h=t.repo;h||=n?`inmemory`:await a({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),Ae(h);let g=t.schema;g||=n?`zod`:await u({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(g)||(d.warn(`Unknown --schema "${g}", falling back to zod.`),g=`zod`);let _;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();_=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else _=n?[]:await s({message:`Select packages to include`,options:[...Ct],required:!1});let v;v=t.git===void 0?n?!0:await p({message:`Initialize git repository?`,initialValue:!0}):t.git;let y;if(y=t.install===void 0?n?!0:await p({message:`Install dependencies?`,initialValue:!0}):t.install,t.frontend!==void 0&&t.frontend!==`kick`&&t.frontend!==`vite`){d.error(`Unknown --frontend '${String(t.frontend)}'. Use 'kick' (wired React app) or 'vite' (create-vite).`),i(`Aborted.`);return}let{VITE_TEMPLATES:b,DEFAULT_VITE_TEMPLATE:x}=await import(`./fullstack-BwdcyVD3.mjs`);if(t.viteTemplate!==void 0&&!b.some(e=>e.value===t.viteTemplate)){d.error(`Unknown --vite-template '${String(t.viteTemplate)}'. TypeScript templates only: ${b.map(e=>e.value).join(`, `)}.`),i(`Aborted.`);return}let S=t.frontend===`vite`?`vite`:`kick`,C=t.viteTemplate??x;if(o===`fullstack`&&!t.frontend&&!n&&(S=await u({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)`}]})),S===`vite`&&!t.viteTemplate&&!n&&(C=await u({message:`create-vite template`,options:b.map(e=>({value:e.value,label:e.label})),initialValue:x})),o===`fullstack`){let{initFullstackProject:t}=await import(`./fullstack-BwdcyVD3.mjs`);await t({name:e,directory:r,packageManager:f,initGit:v,installDeps:y,schemaLib:g,runtime:c,frontend:S,viteTemplate:C}),i(`Done! Next steps: ${m.cyan(`cd ${e} && ${f}${f===`pnpm`?` dev`:` run dev:server`}`)}`);return}await we({name:e,directory:r,packageManager:f,initGit:v,installDeps:y,template:o,defaultRepo:h,packages:_,schemaLib:g,runtime:c}),i(`Done! Next steps: ${m.cyan(`cd ${e} && ${f} dev`)}`)})}function Tt(e,t=[]){let n=new Map;for(let t of e){let e=(n.get(t.name)??0)+1;if(n.set(t.name,e),e===2)throw new je(`plugin`,t.name,[t.name,t.name])}let r=new Map,i=[];for(let t of e)for(let e of t.commands??[]){let n=r.get(e.name);if(n)throw new je(`command`,e.name,[n,t.name]);r.set(e.name,t.name),i.push(e)}let a=new Set(t.map(e=>e.name)),o=[...i.filter(e=>!a.has(e.name)),...t],s=new Map,c=[];for(let t of e)for(let e of t.typegens??[]){let n=s.get(e.id);if(n)throw new je(`typegen`,e.id,[n,t.name]);s.set(e.id,t.name),c.push(e)}let l=new Map,u=[];for(let t of e)for(let e of t.generators??[]){let n=l.get(e.name);if(n)throw new je(`generator`,e.name,[n,t.name]);l.set(e.name,t.name),u.push({source:t.name,spec:e})}return{commands:o,typegens:c,generators:u,register:async(t,n)=>{let r;if(n)r={generators:u,...n};else{let{findProjectRoot:e}=await import(`./project-root-DORRVmte.mjs`).then(e=>e.n),t=process.cwd();r={cwd:t,projectRoot:e(t),config:null,log:()=>{},generators:u}}for(let n of e)n.register&&await n.register(t,r)}}}async function Et(e){let{name:t,outDir:r}=e,i=b(t),a=S(t),o=[],s=j(r,`${i}.plugin.ts`);return await n(s,`import {
   definePlugin,
   type AppAdapter,
   type AppModuleEntry,
@@ -166,11 +166,11 @@ export const ${a}Plugin = definePlugin<${a}PluginConfig>({
     },
   }),
 })
-`),o.push(s),o}function Dt(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 Ot(e){let{name:t,moduleName:r,modulesDir:i,pattern:a}=e,o=e.type??`http`,s=b(t),c=x(t),l=e.key??y(t),u=Array.isArray(e.params)?e.params:Dt(e.params),d=_e({type:`contributor`,outDir:e.outDir,moduleName:r,modulesDir:i,defaultDir:`src/contributors`,pattern:a,shouldPluralize:e.pluralize??!0}),f=o===`http`?`defineHttpContextDecorator`:`defineContextDecorator`,p=o===`http`?`RequestContext`:`ExecutionContext`,m=u.length>0?`\nexport type ${c}Params = {\n${u.map(e=>`  ${e.name}: ${e.type}`).join(`
+`),o.push(s),o}function Dt(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 Ot(e){let{name:t,moduleName:r,modulesDir:i,pattern:a}=e,o=e.type??`http`,s=b(t),c=S(t),l=e.key??y(t),u=Array.isArray(e.params)?e.params:Dt(e.params),d=ge({type:`contributor`,outDir:e.outDir,moduleName:r,modulesDir:i,defaultDir:`src/contributors`,pattern:a,shouldPluralize:e.pluralize??!0}),f=o===`http`?`defineHttpContextDecorator`:`defineContextDecorator`,p=o===`http`?`RequestContext`:`ExecutionContext`,m=u.length>0?`\nexport type ${c}Params = {\n${u.map(e=>`  ${e.name}: ${e.type}`).join(`
 `)}\n}\n`:``,h=u.length>0?`${f}.withParams<${c}Params>()({`:`${f}({`,g=u.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.
-  requiredParams: [${u.map(e=>`'${e.name}'`).join(`, `)}],\n`:``,_=u.length>0?`(ctx, _deps, params)`:`(ctx)`,v=u.length>0?`    // \`params\` is typed as ${c}Params (call-site params merged onto any paramDefaults).`:`    // \`ctx\` is a ${p} — read ctx.req / ctx.headers / ctx.params (http) or ctx.get (bare).`,ee=`import { ${f} } from '@forinda/kickjs'
+  requiredParams: [${u.map(e=>`'${e.name}'`).join(`, `)}],\n`:``,_=u.length>0?`(ctx, _deps, params)`:`(ctx)`,v=u.length>0?`    // \`params\` is typed as ${c}Params (call-site params merged onto any paramDefaults).`:`    // \`ctx\` is a ${p} — read ctx.req / ctx.headers / ctx.params (http) or ctx.get (bare).`,x=`import { ${f} } from '@forinda/kickjs'
 import type { ${p} } from '@forinda/kickjs'
 
 /**
@@ -217,7 +217,7 @@ ${v}
     throw new Error("${c} contributor: resolve() not implemented")
   },
 })
-`,te=j(d,`${s}.contributor.ts`);return await n(te,ee),[te]}async function kt(e){let t=j(e.outDir,`kick.config.ts`),r=e.modulesDir??`src/modules`,i=e.defaultRepo??`inmemory`;return F(t)&&!e.force&&!await p({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
+`,C=j(d,`${s}.contributor.ts`);return await n(C,x),[C]}async function kt(e){let t=j(e.outDir,`kick.config.ts`),r=e.modulesDir??`src/modules`,i=e.defaultRepo??`inmemory`;return F(t)&&!e.force&&!await p({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
   Skipped — existing kick.config.ts preserved.`),[]):(await n(t,`import { defineConfig } from '@forinda/kickjs-cli'
 
 export default defineConfig({
@@ -271,7 +271,7 @@ ${p}
 `||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=At(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=V(m,/register\s*\(([^)]*)\)\s*\{/),g=V(m,/contributors\s*\(\s*\)\s*\{/),_=V(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let v=Mt(c,{container:h!==null,appModule:!0,moduleRoutes:!0,contributorRegistrations:g!==null}),y=``;return h!==null&&(y+=`  register(container: Container): void {${H(h,6,4)}  }\n\n`),g!==null&&(y+=`  contributors(): ContributorRegistrations {${H(g,6,4)}  }\n\n`),y+=`  routes(): ModuleRoutes {${H(_,6,4)}  }`,{migrated:`${v}${`export class ${r} implements AppModule {
 ${y}
 }
-`}${u}`}}function Ft(e,t){return t===`class`?Pt(e):Nt(e)}function It(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 Lt(e){let t=[];return await n(N(e),0),t;async function n(e,r){let i;try{i=await dt(e)}catch{return}for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=j(e,a),o;try{o=await pt(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function Rt(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await dt(e)}catch{return}await ut(t,{recursive:!0});for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=j(e,a),o=j(t,a),s;try{s=await pt(i)}catch{continue}s.isDirectory()?await r(i,o):(await lt(i,o),n++)}}}function zt(e){let t=new Date().toISOString().replaceAll(/[:.]/g,`-`);return j(e,`.kickjs`,`codemod-backups`,`${t}-modules`)}async function Bt(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await Lt(e),s=await R(j(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=zt(r),await Rt(e,c));let l=[];for(let e of o){let t=Ft(await R(e,`utf-8`),i);if(t.migrated==null){l.push({path:e,status:`skipped`,reason:t.reason});continue}n||await z(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`})}let u=j(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=It(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 Vt(e,t){let n=await Lt(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 Ht={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.string().datetime()`},email:{ts:`string`,zod:`z.string().email()`},url:{ts:`string`,zod:`z.string().url()`},uuid:{ts:`string`,zod:`z.string().uuid()`},json:{ts:`any`,zod:`z.any()`}};function Ut(e){return 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=Ht[a];if(!o){let e=[...Object.keys(Ht),`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}})}async function Wt(e){let{name:t,fields:r,modulesDir:i,repo:a=`inmemory`,tokenScope:o=`app`,style:s=`define`}=e,c=e.pluralize!==!1,l=b(t),u=x(t),d=c?h(l):l,f=c?de(u):u,p=j(i,d),m=[],g=async(e,t)=>{let r=j(p,e);await n(r,t),m.push(r)};return await g(`${l}.module.ts`,ee({pascal:u,kebab:l,plural:d,repo:a,style:s})),await g(`${l}.constants.ts`,ve({pascal:u,kebab:l})),await g(`${l}.controller.ts`,_({pascal:u,kebab:l,plural:d,pluralPascal:f,swagger:e.swagger??!1})),await g(`${l}.service.ts`,ne({pascal:u,kebab:l})),await g(`dtos/create-${l}.dto.ts`,Gt(u,r)),await g(`dtos/update-${l}.dto.ts`,Kt(u,r)),await g(`dtos/${l}-response.dto.ts`,qt(u,r)),await g(`${l}.repository.ts`,v({pascal:u,kebab:l,repoType:a,dtoPrefix:`./dtos`,tokenScope:o})),await ae(i,u,d,l,s),m}function Gt(e,t){return`import { z } from 'zod'
+`}${u}`}}function Ft(e,t){return t===`class`?Pt(e):Nt(e)}function It(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 Lt(e){let t=[];return await n(N(e),0),t;async function n(e,r){let i;try{i=await dt(e)}catch{return}for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=j(e,a),o;try{o=await pt(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function Rt(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await dt(e)}catch{return}await ut(t,{recursive:!0});for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=j(e,a),o=j(t,a),s;try{s=await pt(i)}catch{continue}s.isDirectory()?await r(i,o):(await lt(i,o),n++)}}}function zt(e){let t=new Date().toISOString().replaceAll(/[:.]/g,`-`);return j(e,`.kickjs`,`codemod-backups`,`${t}-modules`)}async function Bt(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await Lt(e),s=await R(j(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=zt(r),await Rt(e,c));let l=[];for(let e of o){let t=Ft(await R(e,`utf-8`),i);if(t.migrated==null){l.push({path:e,status:`skipped`,reason:t.reason});continue}n||await z(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`})}let u=j(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=It(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 Vt(e,t){let n=await Lt(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 Ht={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.string().datetime()`},email:{ts:`string`,zod:`z.string().email()`},url:{ts:`string`,zod:`z.string().url()`},uuid:{ts:`string`,zod:`z.string().uuid()`},json:{ts:`any`,zod:`z.any()`}};function Ut(e){return 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=Ht[a];if(!o){let e=[...Object.keys(Ht),`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}})}async function Wt(e){let{name:t,fields:r,modulesDir:i,repo:a=`inmemory`,tokenScope:o=`app`,style:s=`define`}=e,c=e.pluralize!==!1,l=b(t),u=S(t),d=c?h(l):l,f=c?le(u):u,p=j(i,d),m=[],g=async(e,t)=>{let r=j(p,e);await n(r,t),m.push(r)};return await g(`${l}.module.ts`,x({pascal:u,kebab:l,plural:d,repo:a,style:s})),await g(`${l}.constants.ts`,_e({pascal:u,kebab:l})),await g(`${l}.controller.ts`,_({pascal:u,kebab:l,plural:d,pluralPascal:f,swagger:e.swagger??!1})),await g(`${l}.service.ts`,ee({pascal:u,kebab:l})),await g(`dtos/create-${l}.dto.ts`,Gt(u,r)),await g(`dtos/update-${l}.dto.ts`,Kt(u,r)),await g(`dtos/${l}-response.dto.ts`,qt(u,r)),await g(`${l}.repository.ts`,v({pascal:u,kebab:l,repoType:a,dtoPrefix:`./dtos`,tokenScope:o})),await re(i,u,d,l,s),m}function Gt(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(`
@@ -294,7 +294,7 @@ ${t.map(e=>`  ${e.name}${e.optional?`?`:``}: ${e.tsType}`).join(`
   createdAt: string
   updatedAt: string
 }
-`}async function Jt(e){let{name:t,moduleName:r,modulesDir:i}=e,a=e.pluralize??!0,o=b(t),s=x(t),c=[],l;if(e.outDir)l=N(e.outDir);else if(r){let e=b(r),t=a?h(e):e;l=N(j(i??`src/modules`,t,`__tests__`))}else l=N(`src/__tests__`);let u=j(l,`${o}.test.ts`);return await n(u,`import { describe, it, expect, beforeEach } from 'vitest'
+`}async function Jt(e){let{name:t,moduleName:r,modulesDir:i}=e,a=e.pluralize??!0,o=b(t),s=S(t),c=[],l;if(e.outDir)l=N(e.outDir);else if(r){let e=b(r),t=a?h(e):e;l=N(j(i??`src/modules`,t,`__tests__`))}else l=N(`src/__tests__`);let u=j(l,`${o}.test.ts`);return await n(u,`import { describe, it, expect, beforeEach } from 'vitest'
 import { Container } from '@forinda/kickjs'
 
 describe('${s}', () => {
@@ -318,23 +318,23 @@ describe('${s}', () => {
   })
 })
 `),c.push(u),c}const Yt=[`agents`,`claude`,`skills`,`gemini`,`copilot`,`both`,`all`];function U(e){return e.parent?.opts()?.dryRun??!1}function W(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 Xt(e){if(!e)try{let e=await C(process.cwd());await O({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 Zt=[{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`}],Qt=new Map([[`job`,`Queue processors are no longer built in — their shape belongs to whichever queue you run.
+  (dry run — no files were written)`),console.log()}async function Xt(e){if(!e)try{let e=await w(process.cwd());await Ze({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 Zt=[{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`}],Qt=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`]]),$t=new Set([...Zt.map(e=>e.name.split(` `)[0]),...Qt.keys()]);async function en(){console.log(`
   Built-in generators:
-`);let e=Math.max(...Zt.map(e=>e.name.length));for(let t of Zt)console.log(`    kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await C(process.cwd()),n=Tt(t?.plugins??[],t?.commands??[]),r=await ue(process.cwd(),n.generators);if(r.generators.length>0){console.log(`
+`);let e=Math.max(...Zt.map(e=>e.name.length));for(let t of Zt)console.log(`    kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await w(process.cwd()),n=Tt(t?.plugins??[],t?.commands??[]),r=await ce(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()}async function tn(e,t,n){let r=await C(process.cwd()),i=w(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??g(i.repo);t.repo&&je(t.repo);let s=t.pattern??r?.pattern??`rest`,c=t.pluralize===!1?!1:i.pluralize??!0,l=Ae(r,process.cwd()),u=De(T()),d=Oe(T()),f=T(),p=ke(f,`@forinda/kickjs-testing`,`any`)&&ke(f,`supertest`,`any`),h=i.style??`define`;if(!n&&h===`define`){let e=await Vt(N(a),`define`);if(e.length>0){console.error(`\n  ${m.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n  ${m.dim(`Project setting:`)} modules.style: 'define' (default)\n\n  ${m.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  ${m.bold(`Pick one:`)}\n    1. Migrate everything to defineModule:\n       ${m.dim(`$`)} kick codemod modules --experimental --apply\n    2. Keep the class form — pin it in kick.config.ts:\n       ${m.dim(`// kick.config.ts`)}\n       ${m.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let _=[];for(let r of e){let e=await te({name:r,modulesDir:N(a),noEntity:t.entity===!1,noTests:t.tests===!1,repo:o,minimal:t.minimal,force:t.force,pattern:s,testHarness:p,dryRun:n,pluralize:c,tokenScope:l,swagger:u,schemaLib:d,style:i.style});_.push(...e)}W(_,n),await Xt(n)}function nn(e,n){let r=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,i,a)=>{if(i.list){await en();return}if(!e||e.length===0){r.help();return}let o=U(a);t(o);let[s,c,...l]=e;if(s){let e=await C(process.cwd()),t=Tt(e?.plugins??[],e?.commands??[]),r=await ie({generatorName:s,itemName:c??``,args:l,flags:i,cwd:process.cwd(),projectRoot:n?.projectRoot},t.generators);if(r){W(r.files,o);return}if(s!==`module`&&$t.has(s)){let e=Qt.get(s);e?(console.error(`\n  'kick g ${s}' has been removed.`),console.error(`  ${e}\n`)):(console.error(`\n  '${s}' is a generator, not a module name.`),console.error(`  Did you mean:  kick g ${s} ${c??`<name>`}`),console.error(`  If that errors, your @forinda/kickjs-cli is older than the '${s}' generator — upgrade it.\n`)),process.exitCode=1;return}}await tn(e,i,o)});r.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,n,r)=>{let i=U(r);t(i),await tn(e,{...r.optsWithGlobals(),...n},i)}),r.command(`adapter <name>`).description(`Generate an AppAdapter with lifecycle hooks and middleware support`).option(`-o, --out <dir>`,`Output directory`,`src/adapters`).action(async(e,n,r)=>{let i=U(r);t(i),W(await be({name:e,outDir:N(n.out)}),i)}),r.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,n,r)=>{let i=U(r);t(i),W(await Et({name:e,outDir:N(n.out)}),i)}),r.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,n,r)=>{let i=U(r);t(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;W(await re({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0,runtime:a?.runtime}),i)}),r.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,n,r)=>{let i=U(r);t(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;W(await ce({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),i)}),r.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()}async function tn(e,t,n){let r=await w(process.cwd()),i=T(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??g(i.repo);t.repo&&Ae(t.repo);let s=t.pattern??r?.pattern??`rest`,c=t.pluralize===!1?!1:i.pluralize??!0,l=ke(r,process.cwd()),u=Ee(E()),d=De(E()),f=E(),p=Oe(f,`@forinda/kickjs-testing`,`any`)&&Oe(f,`supertest`,`any`),h=i.style??`define`;if(!n&&h===`define`){let e=await Vt(N(a),`define`);if(e.length>0){console.error(`\n  ${m.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n  ${m.dim(`Project setting:`)} modules.style: 'define' (default)\n\n  ${m.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  ${m.bold(`Pick one:`)}\n    1. Migrate everything to defineModule:\n       ${m.dim(`$`)} kick codemod modules --experimental --apply\n    2. Keep the class form — pin it in kick.config.ts:\n       ${m.dim(`// kick.config.ts`)}\n       ${m.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let _=[];for(let r of e){let e=await C({name:r,modulesDir:N(a),noEntity:t.entity===!1,noTests:t.tests===!1,repo:o,minimal:t.minimal,force:t.force,pattern:s,testHarness:p,dryRun:n,pluralize:c,tokenScope:l,swagger:u,schemaLib:d,style:i.style});_.push(...e)}W(_,n),await Xt(n)}function nn(e,n){let r=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,i,a)=>{if(i.list){await en();return}if(!e||e.length===0){r.help();return}let o=U(a);t(o);let[s,c,...l]=e;if(s){let e=await w(process.cwd()),t=Tt(e?.plugins??[],e?.commands??[]),r=await ne({generatorName:s,itemName:c??``,args:l,flags:i,cwd:process.cwd(),projectRoot:n?.projectRoot},t.generators);if(r){W(r.files,o);return}if(s!==`module`&&$t.has(s)){let e=Qt.get(s);e?(console.error(`\n  'kick g ${s}' has been removed.`),console.error(`  ${e}\n`)):(console.error(`\n  '${s}' is a generator, not a module name.`),console.error(`  Did you mean:  kick g ${s} ${c??`<name>`}`),console.error(`  If that errors, your @forinda/kickjs-cli is older than the '${s}' generator — upgrade it.\n`)),process.exitCode=1;return}}await tn(e,i,o)});r.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,n,r)=>{let i=U(r);t(i),await tn(e,{...r.optsWithGlobals(),...n},i)}),r.command(`adapter <name>`).description(`Generate an AppAdapter with lifecycle hooks and middleware support`).option(`-o, --out <dir>`,`Output directory`,`src/adapters`).action(async(e,n,r)=>{let i=U(r);t(i),W(await ye({name:e,outDir:N(n.out)}),i)}),r.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,n,r)=>{let i=U(r);t(i),W(await Et({name:e,outDir:N(n.out)}),i)}),r.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,n,r)=>{let i=U(r);t(i);let a=await w(process.cwd()),o=T(a),s=o.dir??`src/modules`;W(await te({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0,runtime:a?.runtime}),i)}),r.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,n,r)=>{let i=U(r);t(i);let a=await w(process.cwd()),o=T(a),s=o.dir??`src/modules`;W(await oe({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),i)}),r.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,n,r)=>{let i=U(r);t(i);let a=(n.type??`http`).toLowerCase();a!==`http`&&a!==`bare`&&(console.warn(`  kick g contributor: unknown --type '${n.type}', using 'http'.`),a=`http`);let o=await C(process.cwd()),s=w(o),c=s.dir??`src/modules`;W(await Ot({name:e,type:a,key:n.key,params:n.params,outDir:n.out,moduleName:n.module,modulesDir:c,pattern:o?.pattern,pluralize:s.pluralize??!0}),i)}),r.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,n,r)=>{let i=U(r);t(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;W(await le({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),i)}),r.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,n,r)=>{let i=U(r);t(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;W(await pe({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),i),await Xt(i)}),r.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,n,r)=>{let i=U(r);t(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;W(await me({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0,schemaLib:Oe(T())}),i)}),r.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,n,r)=>{let i=U(r);t(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;W(await Jt({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pluralize:o.pluralize??!0}),i)}),r.command(`scaffold <name> [fields...]`).description(`Generate a full CRUD module from field definitions
+  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,n,r)=>{let i=U(r);t(i);let a=(n.type??`http`).toLowerCase();a!==`http`&&a!==`bare`&&(console.warn(`  kick g contributor: unknown --type '${n.type}', using 'http'.`),a=`http`);let o=await w(process.cwd()),s=T(o),c=s.dir??`src/modules`;W(await Ot({name:e,type:a,key:n.key,params:n.params,outDir:n.out,moduleName:n.module,modulesDir:c,pattern:o?.pattern,pluralize:s.pluralize??!0}),i)}),r.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,n,r)=>{let i=U(r);t(i);let a=await w(process.cwd()),o=T(a),s=o.dir??`src/modules`;W(await se({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),i)}),r.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,n,r)=>{let i=U(r);t(i);let a=await w(process.cwd()),o=T(a),s=o.dir??`src/modules`;W(await fe({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),i),await Xt(i)}),r.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,n,r)=>{let i=U(r);t(i);let a=await w(process.cwd()),o=T(a),s=o.dir??`src/modules`;W(await pe({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0,schemaLib:De(E())}),i)}),r.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,n,r)=>{let i=U(r);t(i);let a=await w(process.cwd()),o=T(a),s=o.dir??`src/modules`;W(await Jt({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pluralize:o.pluralize??!0}),i)}),r.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
   Optional: append :optional (shell-safe):  description:text:optional
@@ -343,30 +343,30 @@ describe('${s}', () => {
   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 C(process.cwd()),s=w(o),c=r.modulesDir??s.dir??`src/modules`,l=Ut(n),u=Ae(o,process.cwd()),d=De(T()),f=await Wt({name:e,fields:l,modulesDir:N(c),noEntity:r.entity===!1,noTests:r.tests===!1,pluralize:r.pluralize===!1?!1:s.pluralize??!0,tokenScope:u,swagger:d,style:s.style});console.log(`\n  Scaffolded ${e} with ${l.length} field(s):`);for(let e of l)console.log(`    ${e.name}: ${e.type}${e.optional?` (optional)`:``}`);W(f,a),await Xt(a)}),r.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,n)=>{let r=U(n);t(r),W(await kt({outDir:N(`.`),modulesDir:e.modulesDir,defaultRepo:e.repo,force:e.force}),r)}),r.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,n)=>{let r=U(n);t(r);let i=e.only??`all`;if(!Yt.includes(i)){console.error(`  Invalid --only value: ${i}. Expected: ${Yt.join(` | `)}`),process.exitCode=1;return}W(await Pe({outDir:N(`.`),only:i,name:e.name,pm:e.pm,template:e.template,force:e.force}),r)});for(let e of n?.generators??[])rn(r,e,n?.projectRoot)}function rn(e,n,r){let{source:i,spec:a}=n,o=a.args?.[0],s=o?.name??`itemName`,c=o?.required?`<${s}>`:`[${s}]`,l=`${a.name} ${c} [extraArgs...]`,u=e.command(l).description(`${a.description}  [${i}]`);for(let e of a.flags??[]){let t=e.takesValue?`--${e.name} <value>`:`--${e.name}`,n=e.alias?`-${e.alias}, ${t}`:t;u.option(n,e.description??``)}u.action(async(e,i,o,s)=>{let c=U(s);t(c);let l=await ie({generatorName:a.name,itemName:e??``,args:i??[],flags:o,cwd:process.cwd(),projectRoot:r},[n]);l&&W(l.files,c)})}const an=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: `;async function on(e){let t=k.resolve(e.cwd,`.kickjs/types`);e.check||await ut(t,{recursive:!0});let n=new Map,r=e.scan??Ue,i=k.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(B(e).href)},async writeFile(t,n){let r=k.resolve(e.cwd,t);await ut(k.dirname(r),{recursive:!0}),await z(r,n,`utf8`)},getScanResult:e=>{let t=sn(e),o=n.get(t);if(!o){let s={cacheDir:i,...e};o=a?Le(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=k.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=`${an}${n.id} */\n\n`+a+`
-`,u=``;if(F(i)&&(u=await R(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 z(i,l,`utf8`),s.push({id:n.id,status:`written`,outFile:i})}if(c.length>0)throw new ge(c);return s}function sn(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 cn(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 ln=e({applyDisableFilter:()=>cn,runAllPluginTypegens:()=>G});async function G(e){let{enabled:t,skipped:n,unknown:r}=cn(Tt([...Wi,...e.config?.plugins??[]],e.config?.commands??[]).typegens,e.config?.typegen?.disable??[]);if(!e.silent&&n.length>0)for(let e of n)console.log(`  ${e.id}: disabled (typegen.disable)`);if(!e.silent&&r.length>0&&console.warn(`  kick typegen: disable list references unknown id(s): ${r.map(e=>`'${e}'`).join(`, `)}. Run \`kick typegen --list\` to see registered ids.`),t.length===0)return[];try{let n=await on({cwd:e.cwd,config:e.config??{},plugins:t,watch:e.watch,check:e.check,changedFiles:e.changedFiles});if(!e.silent&&se())for(let e of n)console.log(`  ${e.id}: ${e.status}`);return n}catch(t){if(t instanceof ge||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 un(e){let t=j(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=j(t,i);if(F(r))return{cmd:r,args:[`--noEmit`],shell:n,kind:e}}}return null}function dn(e){let t=e.spawnFn??ht,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 fn(e,t=12){let n=e.trim().split(/\r?\n/);return n.length<=t?n.join(`
+`),process.exit(1));let o=await w(process.cwd()),s=T(o),c=r.modulesDir??s.dir??`src/modules`,l=Ut(n),u=ke(o,process.cwd()),d=Ee(E()),f=await Wt({name:e,fields:l,modulesDir:N(c),noEntity:r.entity===!1,noTests:r.tests===!1,pluralize:r.pluralize===!1?!1:s.pluralize??!0,tokenScope:u,swagger:d,style:s.style});console.log(`\n  Scaffolded ${e} with ${l.length} field(s):`);for(let e of l)console.log(`    ${e.name}: ${e.type}${e.optional?` (optional)`:``}`);W(f,a),await Xt(a)}),r.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,n)=>{let r=U(n);t(r),W(await kt({outDir:N(`.`),modulesDir:e.modulesDir,defaultRepo:e.repo,force:e.force}),r)}),r.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,n)=>{let r=U(n);t(r);let i=e.only??`all`;if(!Yt.includes(i)){console.error(`  Invalid --only value: ${i}. Expected: ${Yt.join(` | `)}`),process.exitCode=1;return}W(await Ne({outDir:N(`.`),only:i,name:e.name,pm:e.pm,template:e.template,force:e.force}),r)});for(let e of n?.generators??[])rn(r,e,n?.projectRoot)}function rn(e,n,r){let{source:i,spec:a}=n,o=a.args?.[0],s=o?.name??`itemName`,c=o?.required?`<${s}>`:`[${s}]`,l=`${a.name} ${c} [extraArgs...]`,u=e.command(l).description(`${a.description}  [${i}]`);for(let e of a.flags??[]){let t=e.takesValue?`--${e.name} <value>`:`--${e.name}`,n=e.alias?`-${e.alias}, ${t}`:t;u.option(n,e.description??``)}u.action(async(e,i,o,s)=>{let c=U(s);t(c);let l=await ne({generatorName:a.name,itemName:e??``,args:i??[],flags:o,cwd:process.cwd(),projectRoot:r},[n]);l&&W(l.files,c)})}const an=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: `;async function on(e){let t=k.resolve(e.cwd,`.kickjs/types`);e.check||await ut(t,{recursive:!0});let n=new Map,r=e.scan??He,i=k.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(B(e).href)},async writeFile(t,n){let r=k.resolve(e.cwd,t);await ut(k.dirname(r),{recursive:!0}),await z(r,n,`utf8`)},getScanResult:e=>{let t=sn(e),o=n.get(t);if(!o){let s={cacheDir:i,...e};o=a?Ie(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=k.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=`${an}${n.id} */\n\n`+a+`
+`,u=``;if(F(i)&&(u=await R(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 z(i,l,`utf8`),s.push({id:n.id,status:`written`,outFile:i})}if(c.length>0)throw new he(c);return s}function sn(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 cn(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 ln=e({applyDisableFilter:()=>cn,runAllPluginTypegens:()=>G});async function G(e){let{enabled:t,skipped:n,unknown:r}=cn(Tt([...Wi,...e.config?.plugins??[]],e.config?.commands??[]).typegens,e.config?.typegen?.disable??[]);if(!e.silent&&n.length>0)for(let e of n)console.log(`  ${e.id}: disabled (typegen.disable)`);if(!e.silent&&r.length>0&&console.warn(`  kick typegen: disable list references unknown id(s): ${r.map(e=>`'${e}'`).join(`, `)}. Run \`kick typegen --list\` to see registered ids.`),t.length===0)return[];try{let n=await on({cwd:e.cwd,config:e.config??{},plugins:t,watch:e.watch,check:e.check,changedFiles:e.changedFiles});if(!e.silent&&ae())for(let e of n)console.log(`  ${e.id}: ${e.status}`);return n}catch(t){if(t instanceof he||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 un(e){let t=j(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=j(t,i);if(F(r))return{cmd:r,args:[`--noEmit`],shell:n,kind:e}}}return null}function dn(e){let t=e.spawnFn??ht,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 fn(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 pn(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function mn(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 hn(e,t,n={}){t&&(process.env.PORT=t);let r=pn(n.polling),i=process.cwd(),a=await C(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await O({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=N(i,a?.typegen?.outDir??`.kickjs/types`);try{let e=await G({cwd:i,config:a});await Ge(c,e,!1)}catch(e){console.warn(`  kick typegen: plugin pass skipped (${e?.message??e})`)}let{createRequire:l}=await import(`node:module`),u=l(N(`package.json`)).resolve(`vite`),{createServer:d}=await import(B(u).href);globalThis[oe]=`kick-dev`;let f=await d({configFile:N(`vite.config.ts`),server:{port:t?parseInt(t,10):void 0,...r?{watch:{usePolling:!0,interval:100}}:{}}}),p=n.typecheck??a?.dev?.typecheck??!1,m=null,h=!0;if(p){let e=un(i);e?m=dn({cwd:i,bin:e,onResult:e=>{f.hot.send({type:`custom`,event:`kickjs:typecheck`,data:{ok:e.ok,output:e.output,durationMs:e.durationMs}}),e.ok?h||(h=!0,console.log(`  kick typecheck: clean again (${e.kind}, ${e.durationMs}ms)`)):(h=!1,console.warn(`\n  kick typecheck (${e.kind}, ${e.durationMs}ms):`),console.warn(fn(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 g=fe({cwd:i,config:a,emitWarning:e=>{console.warn(e),f.hot.send({type:`custom`,event:`kickjs:typegen-error`,data:{message:e,timestamp:Date.now()}})},onPassComplete:()=>m?.schedule()});f.watcher.on(`add`,e=>g.handleWatchEvent(`add`,e)),f.watcher.on(`unlink`,e=>g.handleWatchEvent(`unlink`,e)),f.watcher.on(`change`,e=>g.handleWatchEvent(`change`,e)),f.watcher.on(`unlinkDir`,e=>g.handleWatchEvent(`unlinkDir`,e)),g.assetSrcRoots.length>0&&f.watcher.add([...g.assetSrcRoots]),await f.listen(),f.printUrls(),console.log(`
+`)}\n… ${n.length-t} more line(s)`}function pn(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function mn(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 hn(e,t,n={}){t&&(process.env.PORT=t);let r=pn(n.polling),i=process.cwd(),a=await w(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await Ze({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=N(i,a?.typegen?.outDir??`.kickjs/types`);try{let e=await G({cwd:i,config:a});await We(c,e,!1)}catch(e){console.warn(`  kick typegen: plugin pass skipped (${e?.message??e})`)}let{createRequire:l}=await import(`node:module`),u=l(N(`package.json`)).resolve(`vite`),{createServer:d}=await import(B(u).href);globalThis[ie]=`kick-dev`;let f=await d({configFile:N(`vite.config.ts`),server:{port:t?parseInt(t,10):void 0,...r?{watch:{usePolling:!0,interval:100}}:{}}}),p=n.typecheck??a?.dev?.typecheck??!1,m=null,h=!0;if(p){let e=un(i);e?m=dn({cwd:i,bin:e,onResult:e=>{f.hot.send({type:`custom`,event:`kickjs:typecheck`,data:{ok:e.ok,output:e.output,durationMs:e.durationMs}}),e.ok?h||(h=!0,console.log(`  kick typecheck: clean again (${e.kind}, ${e.durationMs}ms)`)):(h=!1,console.warn(`\n  kick typecheck (${e.kind}, ${e.durationMs}ms):`),console.warn(fn(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 g=de({cwd:i,config:a,emitWarning:e=>{console.warn(e),f.hot.send({type:`custom`,event:`kickjs:typegen-error`,data:{message:e,timestamp:Date.now()}})},onPassComplete:()=>m?.schedule()});f.watcher.on(`add`,e=>g.handleWatchEvent(`add`,e)),f.watcher.on(`unlink`,e=>g.handleWatchEvent(`unlink`,e)),f.watcher.on(`change`,e=>g.handleWatchEvent(`change`,e)),f.watcher.on(`unlinkDir`,e=>g.handleWatchEvent(`unlinkDir`,e)),g.assetSrcRoots.length>0&&f.watcher.add([...g.assetSrcRoots]),await f.listen(),f.printUrls(),console.log(`
   KickJS dev server running (Vite + @forinda/kickjs-vite)
-`),m?.schedule();let _=!1,v=async()=>{if(!_){_=!0,g.dispose(),m?.dispose();try{await globalThis.__kickjs_app_shutdown?.()}catch(e){console.error(`  app shutdown hook failed: ${e?.message??e}`)}await f.close(),process.exit(0)}};process.on(`SIGINT`,v),process.on(`SIGTERM`,v),process.on(`SIGBREAK`,v)}async function gn(e){let t=await C(e);try{await O({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=N(e,t?.typegen?.outDir??`.kickjs/types`),r=await G({cwd:e,config:t});await Ge(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 _n(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 hn(e.entry,e.port,{polling:e.polling,typecheck:e.typecheck})}catch(e){e.code===`ERR_MODULE_NOT_FOUND`&&e.message?.includes(`vite`)?console.error(`
+`),m?.schedule();let _=!1,v=async()=>{if(!_){_=!0,g.dispose(),m?.dispose();try{await globalThis.__kickjs_app_shutdown?.()}catch(e){console.error(`  app shutdown hook failed: ${e?.message??e}`)}await f.close(),process.exit(0)}};process.on(`SIGINT`,v),process.on(`SIGTERM`,v),process.on(`SIGBREAK`,v)}async function gn(e){let t=await w(e);try{await Ze({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=N(e,t?.typegen?.outDir??`.kickjs/types`),r=await G({cwd:e,config:t});await We(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 _n(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 hn(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(N(`package.json`)).resolve(`vite`),{build:n}=await import(B(t).href);await n({configFile:N(`vite.config.ts`)});let r=await C(process.cwd()),i=r?.copyDirs??[];if(i.length>0){console.log(`
+`);let{createRequire:e}=await import(`node:module`),t=e(N(`package.json`)).resolve(`vite`),{build:n}=await import(B(t).href);await n({configFile:N(`vite.config.ts`)});let r=await w(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`?j(`dist`,e):e.dest??j(`dist`,t),r=N(t),i=N(n);if(!F(r)){console.log(`    ⚠ Skipped ${t} (not found)`);continue}ot(i,{recursive:!0}),at(r,i,{recursive:!0}),console.log(`    ✓ ${t} → ${n}`)}}if(r?.assetMap&&Object.keys(r.assetMap).length>0){console.log(`
-  Building asset map...`);try{await Ne(r,{cwd:process.cwd()})}catch(e){console.error(`    ✗ asset build failed: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}console.log(`
+  Building asset map...`);try{await Me(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 C(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 Ne(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 w(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 Me(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)),Se(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=N(process.cwd(),e.cwd??`.`);e.typegen!==!1&&await gn(t);let n=un(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)),xe(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=N(process.cwd(),e.cwd??`.`);e.typegen!==!1&&await gn(t);let n=un(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=gt(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 mn(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 hn(e.entry,e.port)}catch(e){console.error(`
-  Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function vn(){try{let e=A(_t(import.meta.url));return JSON.parse(I(j(e,`..`,`package.json`),`utf-8`)).version??`unknown`}catch{return`unknown`}}const yn=new Set(Object.values(Ce).filter(e=>e.deprecated).map(e=>e.pkg));function bn(e){let t=j(e,`package.json`);if(!F(t))return[];let n;try{n=JSON.parse(I(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=j(e,`node_modules`,...t.split(`/`),`package.json`);if(F(i))try{n=JSON.parse(I(i,`utf-8`)).version??null}catch{}return{name:t,installed:n,declared:r[t]??null,deprecated:yn.has(t)}})}function xn(e){let t=e;for(;;){if(F(j(t,`package.json`)))return t;let e=A(t);if(e===t)return null;t=e}}function Sn(e){e.command(`info`).description(`Print system and framework info`).action(()=>{let e=[``,`  KickJS CLI v${vn()}`,``,`  System:`,`    OS:       ${bt()} ${xt()} (${yt()})`,`    Node:     ${process.version}`],t=xn(process.cwd()),n=t?bn(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(`
+  Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function vn(){try{let e=A(_t(import.meta.url));return JSON.parse(I(j(e,`..`,`package.json`),`utf-8`)).version??`unknown`}catch{return`unknown`}}const yn=new Set(Object.values(Se).filter(e=>e.deprecated).map(e=>e.pkg));function bn(e){let t=j(e,`package.json`);if(!F(t))return[];let n;try{n=JSON.parse(I(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=j(e,`node_modules`,...t.split(`/`),`package.json`);if(F(i))try{n=JSON.parse(I(i,`utf-8`)).version??null}catch{}return{name:t,installed:n,declared:r[t]??null,deprecated:yn.has(t)}})}function xn(e){let t=e;for(;;){if(F(j(t,`package.json`)))return t;let e=A(t);if(e===t)return null;t=e}}function Sn(e){e.command(`info`).description(`Print system and framework info`).action(()=>{let e=[``,`  KickJS CLI v${vn()}`,``,`  System:`,`    OS:       ${bt()} ${xt()} (${yt()})`,`    Node:     ${process.version}`],t=xn(process.cwd()),n=t?bn(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:K,dim:q,green:Cn,red:wn,yellow:Tn,blue:En}=m;function Dn(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 On(e){let t=await fetch(e,{signal:AbortSignal.timeout(5e3)});if(!t.ok)throw Error(`${t.status} ${t.statusText}`);return t.json()}async function J(e,t){try{return await On(`${e}${t}`)}catch{return null}}async function kn(e){let[t,n,r,i,a]=await Promise.all([J(e,`/health`),J(e,`/metrics`),J(e,`/routes`),J(e,`/container`),J(e,`/ws`)]);return{health:t,metrics:n,routes:r,container:i,ws:a}}function An(e,t){let{health:n,metrics:r,routes:i,container:a,ws:o}=t,s=q(`─`.repeat(60));if(console.log(),console.log(K(`  KickJS Inspector`)+q(`  →  ${e}`)),console.log(s),n){let e=n.status===`healthy`?Cn(`● healthy`):wn(`● `+n.status);console.log(`  ${K(`Health:`)}    ${e}`)}else console.log(`  ${K(`Health:`)}    ${wn(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?wn:r.errorRate>0?Tn:Cn;console.log(`  ${K(`Uptime:`)}    ${Dn(r.uptimeSeconds)}`),console.log(`  ${K(`Requests:`)}  ${r.requests}`),console.log(`  ${K(`Errors:`)}    ${r.serverErrors} server, ${r.clientErrors??0} client  ${q(`(`)}${t(e+`%`)}${q(`)`)}`)}if(a&&console.log(`  ${K(`DI:`)}        ${a.count} bindings`),o&&o.enabled&&console.log(`  ${K(`WS:`)}        ${o.connections??0} connections, ${o.namespaces??0} namespaces`),i?.routes?.length){console.log(),console.log(K(`  Routes`)),console.log(s),console.log(`  ${q(`METHOD`)}  ${q(`PATH`.padEnd(36))} ${q(`CONTROLLER`)}`);for(let e of i.routes){let t=e.path.length>36?e.path.slice(0,33)+`...`:e.path.padEnd(36);console.log(`  ${c(e.method)} ${t} ${En(e.controller)}.${q(e.handler)}`)}}console.log(s),console.log()}function jn(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 kn(r);t.json?console.log(JSON.stringify(e,null,2)):An(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(wn(`  ✖ Could not connect to ${n}`)),console.error(q(`    ${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 Y(e,t){let n=e.toLowerCase();return t.every(e=>n.includes(e.toLowerCase()))}function X(e,t){let n=e.toLowerCase();return t.some(e=>n.includes(e.toLowerCase()))}const Mn=[{match(e,t){let n=Y(e,[`config`,`get`])&&X(e,[`undefined`,`null`]),r=e.includes(`@Value`)&&X(e,[`undefined`,`is not defined`]);return!n&&!r?null:X(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
@@ -670,23 +670,23 @@ server.on('exit', () => {
   console.log('\\n  Goodbye!\\n')
   process.exit(0)
 })
-`}function nr(e,t){let n=e;for(;;){let e=j(n,`node_modules`,`.bin`,t);if(F(e))return e;let r=N(n,`..`);if(r===n)break;n=r}return null}function rr(e,t){let n=RegExp(`^\\s*${S(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 nr(e,t){let n=e;for(;;){let e=j(n,`node_modules`,`.bin`,t);if(F(e))return e;let r=N(n,`..`);if(r===n)break;n=r}return null}function rr(e,t){let n=RegExp(`^\\s*${ue(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 ir(e,t){let n=ye(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=rr(a,t).content,a=a.replace(RegExp(`\\s*,?\\s*${S(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 ar(e){let{name:t,modulesDir:n,force:i}=e,a=e.pluralize!==!1,o=b(t),s=x(t),c=a?h(o):o,l=j(n,c);if(!await r(l)){console.log(`\n  Module not found: ${l}\n`);return}if(!i&&!await p({message:m.red(`Delete module '${c}' at ${l}? This cannot be undone.`),initialValue:!1})){console.log(`
+`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t;continue}i=s+1}return{content:a,changed:r}}function ir(e,t){let n=ve(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=rr(a,t).content,a=a.replace(RegExp(`\\s*,?\\s*${ue(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 ar(e){let{name:t,modulesDir:n,force:i}=e,a=e.pluralize!==!1,o=b(t),s=S(t),c=a?h(o):o,l=j(n,c);if(!await r(l)){console.log(`\n  Module not found: ${l}\n`);return}if(!i&&!await p({message:m.red(`Delete module '${c}' at ${l}? This cannot be undone.`),initialValue:!1})){console.log(`
   Cancelled.
-`);return}await ft(l,{recursive:!0,force:!0}),console.log(`  Deleted: ${l}`);let u=j(n,`index.ts`);if(await r(u)){let e=await R(u,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${S(s)}Module\\s*\\}\\s*from\\s*['"][^'"]*${S(c)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=ir(e,s),e=e.replace(/\n{3,}/g,`
+`);return}await ft(l,{recursive:!0,force:!0}),console.log(`  Deleted: ${l}`);let u=j(n,`index.ts`);if(await r(u)){let e=await R(u,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${ue(s)}Module\\s*\\}\\s*from\\s*['"][^'"]*${ue(c)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=ir(e,s),e=e.replace(/\n{3,}/g,`
 
-`),e!==t&&(await z(u,e,`utf-8`),console.log(`  Unregistered: ${s}Module from ${u}`))}console.log(`\n  Module '${c}' removed.\n`)}function or(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 C(process.cwd()),r=w(n),i=t.modulesDir??r.dir??`src/modules`,a=t.pluralize===!1?!1:r.pluralize??!0;for(let n of e)await ar({name:n,modulesDir:N(i),force:t.force,pluralize:a})})}function sr(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 cr(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function lr(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 C(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-3V8ZP2h3.mjs`),{builtinCliPlugins:t}=await import(`./builtins-BvdsVFXh.mjs`),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(u,e,`utf-8`),console.log(`  Unregistered: ${s}Module from ${u}`))}console.log(`\n  Module '${c}' removed.\n`)}function or(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 w(process.cwd()),r=T(n),i=t.modulesDir??r.dir??`src/modules`,a=t.pluralize===!1?!1:r.pluralize??!0;for(let n of e)await ar({name:n,modulesDir:N(i),force:t.force,pluralize:a})})}function sr(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 cr(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function lr(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 w(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-C11bSFtE.mjs`),{builtinCliPlugins:t}=await import(`./builtins-DHjV84lv.mjs`),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=sr(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=cr(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 Xe(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 O(a);let r=await G({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=N(t,e.out??n?.typegen?.outDir??`.kickjs/types`);await Ge(i,r,e.silent??!1)}}}catch(e){e instanceof Ze?console.error(`
+`);return}let r=sr(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=cr(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 Ye(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 Ze(a);let r=await G({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=N(t,e.out??n?.typegen?.outDir??`.kickjs/types`);await We(i,r,e.silent??!1)}}}catch(e){e instanceof Xe?console.error(`
 `+e.message+`
-`):e instanceof ge?console.error(`
+`):e instanceof he?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 ur=new Set([`Service`,`Injectable`,`Component`,`Repository`]);function dr(e,t){return typeof t==`number`?e.slice(0,t).split(`
-`).length:1}function fr(e){let t=et(e);if(t===`singleton`||t===`transient`||t===`request`)return t;if(Fe(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 pr(e){let t=D(e);if(t)return{key:`id:${t}`,label:t};let n=et(e);return n===null?null:{key:`lit:${n}`,label:`'${n}'`}}function mr(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=nt(e).map($e).find(e=>e?.name===`Inject`),a=null;if(i)a=pr(i.call.arguments?.[0]);else{let e=n?.typeAnnotation?.typeAnnotation??null;e?.type===`TSTypeReference`&&(a=pr(e.typeName))}a&&r.push({...a,line:dr(t,e.start)})}return r}function hr(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=vt(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`)&&Fe(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)}Ie(e,e=>{if(e.type===`ClassDeclaration`){let a=D(e.id);if(!a)return;for(let o of nt(e)){let s=$e(o);if(s){if(s.name===`Controller`){i(`id:${a}`,`singleton`),r.push({name:a,kind:`controller`,file:t,params:mr(e,n)});return}if(ur.has(s.name)){let o=tt(ze(s.call),`scope`),c=o?fr(o):`singleton`;i(`id:${a}`,c),r.push({name:a,kind:`other`,file:t,params:mr(e,n)});return}}}return}if(e.type!==`CallExpression`)return;let a=e.callee;if(!Fe(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=pr(s[0]);c&&i(c.key,s.length>=3?fr(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 gr(e){let t=[];if(!F(e))return t;let n=st(e,{withFileTypes:!0});for(let r of n){let n=j(e,r.name);if(r.isDirectory()){if([`node_modules`,`dist`,`.kickjs`,`.git`].includes(r.name))continue;t.push(...gr(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function _r(e){try{return I(e,`utf-8`)}catch{return``}}const vr=new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function yr(e,t){let n=_r(j(e,`.env`));if(n){let e=n.match(/^JWT_SECRET\s*=\s*['"]?([^'"\n]*)['"]?/m);if(e){let t=e[1].trim();if(vr.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 br(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 xr(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 Sr(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function Cr(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 wr(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 Tr(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 Er(e){let t=gr(j(e,`src`)).map(e=>_r(e)),n=[],r=yr(e,t);r&&n.push(r);let i=br(t);i&&n.push(i);let a=xr(t);a&&n.push(a);let o=Sr();o&&n.push(o);let s=Cr(t);return s&&n.push(s),n.push(wr(t)),n.push(Tr(t)),n}function Dr(e){let t=hr(gr(j(e,`src`)).filter(e=>!/\.(test|spec)\.tsx?$/.test(e)).map(t=>({path:M(e,t).split(`\\`).join(`/`),source:_r(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 Or(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(`
+`).length:1}function fr(e){let t=et(e);if(t===`singleton`||t===`transient`||t===`request`)return t;if(Pe(e)&&e.type===`MemberExpression`&&O(e.object)===`Scope`){let t=O(e.property);if(t===`SINGLETON`)return`singleton`;if(t===`TRANSIENT`)return`transient`;if(t===`REQUEST`)return`request`}return`unknown`}function pr(e){let t=O(e);if(t)return{key:`id:${t}`,label:t};let n=et(e);return n===null?null:{key:`lit:${n}`,label:`'${n}'`}}function mr(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=nt(e).map($e).find(e=>e?.name===`Inject`),a=null;if(i)a=pr(i.call.arguments?.[0]);else{let e=n?.typeAnnotation?.typeAnnotation??null;e?.type===`TSTypeReference`&&(a=pr(e.typeName))}a&&r.push({...a,line:dr(t,e.start)})}return r}function hr(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=vt(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`)&&Pe(n.declaration)?n.declaration:n;if(e.type===`ClassDeclaration`&&a(O(e.id),t),e.type===`VariableDeclaration`)for(let n of e.declarations??[])a(O(n.id),t)}Fe(e,e=>{if(e.type===`ClassDeclaration`){let a=O(e.id);if(!a)return;for(let o of nt(e)){let s=$e(o);if(s){if(s.name===`Controller`){i(`id:${a}`,`singleton`),r.push({name:a,kind:`controller`,file:t,params:mr(e,n)});return}if(ur.has(s.name)){let o=tt(Re(s.call),`scope`),c=o?fr(o):`singleton`;i(`id:${a}`,c),r.push({name:a,kind:`other`,file:t,params:mr(e,n)});return}}}return}if(e.type!==`CallExpression`)return;let a=e.callee;if(!Pe(a)||a.type!==`MemberExpression`)return;let o=O(a.property);if(o!==`register`&&o!==`registerFactory`)return;let s=e.arguments??[];if(s.length<2)return;let c=pr(s[0]);c&&i(c.key,s.length>=3?fr(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 gr(e){let t=[];if(!F(e))return t;let n=st(e,{withFileTypes:!0});for(let r of n){let n=j(e,r.name);if(r.isDirectory()){if([`node_modules`,`dist`,`.kickjs`,`.git`].includes(r.name))continue;t.push(...gr(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function _r(e){try{return I(e,`utf-8`)}catch{return``}}const vr=new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function yr(e,t){let n=_r(j(e,`.env`));if(n){let e=n.match(/^JWT_SECRET\s*=\s*['"]?([^'"\n]*)['"]?/m);if(e){let t=e[1].trim();if(vr.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 br(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 xr(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 Sr(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function Cr(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 wr(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 Tr(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 Er(e){let t=gr(j(e,`src`)).map(e=>_r(e)),n=[],r=yr(e,t);r&&n.push(r);let i=br(t);i&&n.push(i);let a=xr(t);a&&n.push(a);let o=Sr();o&&n.push(o);let s=Cr(t);return s&&n.push(s),n.push(wr(t)),n.push(Tr(t)),n}function Dr(e){let t=hr(gr(j(e,`src`)).filter(e=>!/\.(test|spec)\.tsx?$/.test(e)).map(t=>({path:M(e,t).split(`\\`).join(`/`),source:_r(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 Or(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:
@@ -701,7 +701,7 @@ server.on('exit', () => {
   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 i=await C(process.cwd()),a=w(i),o=N(e.modulesDir??a.dir??`src/modules`),s;e.target===`define`||e.target===`class`?s=e.target:e.target===void 0?s=a.style??`define`:(console.error(`\n  ${m.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let c=m.dim(`→ ${s}`),l=r?m.dim(`(dry-run)`):m.bold(`(applying)`);console.log(`\n  ${m.bold(`kick codemod modules`)} ${c} ${l}`),console.log(`  modulesDir: ${m.dim(o)}\n`);let u=e.backup!==!1&&!r,d=await Bt(o,{dryRun:r,target:s,backup:u});if(d.backupDir){let e=d.backupDir;console.log(`  ${m.green(`✓`)} backup: ${m.dim(e)}\n    ${m.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else!r&&e.backup===!1&&console.log(`  ${m.dim(`(--no-backup — skipping snapshot)`)}\n`);let f=0,p=0;for(let e of d.files)if(e.status===`migrated`)f++,console.log(`    ${m.green(`✓`)} ${e.path}`);else{p++;let t=m.dim(`(${e.reason??`skipped`})`);console.log(`    ${m.dim(`-`)} ${e.path} ${t}`)}if(console.log(),d.indexStatus===`migrated`)console.log(`    ${m.green(`✓`)} ${d.indexPath}`);else if(d.indexStatus===`skipped`){let e=m.dim(`(${d.indexReason??`skipped`})`);console.log(`    ${m.dim(`-`)} ${d.indexPath} ${e}`)}else console.log(`    ${m.dim(`-`)} ${d.indexPath} ${m.dim(`(not found)`)}`);let h=r?m.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n  ${m.bold(String(f))} migrated, ${m.bold(String(p))} skipped${h}\n`)})}function jr(e,t=F){let n=A(e);return(t(N(n,`pnpm-workspace.yaml`))||t(N(n,`package.json`)))&&t(N(n,`web`,`package.json`))?{staticDir:`../web/dist`,siteRoot:`..`,apiPath:`/api`}:{siteRoot:`.`,apiPath:``}}function Mr(e,t,n){let r=jr(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 Nr(e,t){return`import { handler } from '${e}'
+`),process.exit(1));let i=await w(process.cwd()),a=T(i),o=N(e.modulesDir??a.dir??`src/modules`),s;e.target===`define`||e.target===`class`?s=e.target:e.target===void 0?s=a.style??`define`:(console.error(`\n  ${m.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let c=m.dim(`→ ${s}`),l=r?m.dim(`(dry-run)`):m.bold(`(applying)`);console.log(`\n  ${m.bold(`kick codemod modules`)} ${c} ${l}`),console.log(`  modulesDir: ${m.dim(o)}\n`);let u=e.backup!==!1&&!r,d=await Bt(o,{dryRun:r,target:s,backup:u});if(d.backupDir){let e=d.backupDir;console.log(`  ${m.green(`✓`)} backup: ${m.dim(e)}\n    ${m.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else!r&&e.backup===!1&&console.log(`  ${m.dim(`(--no-backup — skipping snapshot)`)}\n`);let f=0,p=0;for(let e of d.files)if(e.status===`migrated`)f++,console.log(`    ${m.green(`✓`)} ${e.path}`);else{p++;let t=m.dim(`(${e.reason??`skipped`})`);console.log(`    ${m.dim(`-`)} ${e.path} ${t}`)}if(console.log(),d.indexStatus===`migrated`)console.log(`    ${m.green(`✓`)} ${d.indexPath}`);else if(d.indexStatus===`skipped`){let e=m.dim(`(${d.indexReason??`skipped`})`);console.log(`    ${m.dim(`-`)} ${d.indexPath} ${e}`)}else console.log(`    ${m.dim(`-`)} ${d.indexPath} ${m.dim(`(not found)`)}`);let h=r?m.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n  ${m.bold(String(f))} migrated, ${m.bold(String(p))} skipped${h}\n`)})}function jr(e,t=F){let n=A(e);return(t(N(n,`pnpm-workspace.yaml`))||t(N(n,`package.json`)))&&t(N(n,`web`,`package.json`))?{staticDir:`../web/dist`,siteRoot:`..`,apiPath:`/api`}:{siteRoot:`.`,apiPath:``}}function Mr(e,t,n){let r=jr(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 Nr(e,t){return`import { handler } from '${e}'
 
 export default (request) => handler.fetch(request)
 
@@ -710,7 +710,7 @@ export const config = {
 }
 `}function Pr(e){return/^\s*publish\s*=\s*["']([^"']+)["']/m.exec(e)?.[1]?.replace(/^\.\//,``).replace(/\/+$/,``)}function Fr(e,t){let n=[{handle:`filesystem`},{src:`^${e}/(.*)$`,dest:`/api`}];return t&&n.push({src:`^/(.*)$`,dest:`/index.html`}),n}function Ir(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 Lr(e,t){let{createRequire:n}=await import(`node:module`),r=n(N(e,`package.json`)),i;try{i=r.resolve(`${t}/package.json`)}catch{i=N(e,`node_modules`,t,`package.json`)}if(!F(i))throw Error(`${t} is not installed in this project. Run: pnpm add -D vite unplugin-swc @forinda/kickjs-vite`);let a=Ir(JSON.parse(I(i,`utf-8`)));if(!a)throw Error(`${t} has no importable entry point`);return import(B(N(A(i),a)).href)}async function Rr(e,t,n){let r=N(e,t.entry);if(!F(r))throw Error(`${t.entry} not found. The serverless entry exports \`handler = createHandler({ modules })\` — see the Serverless guide.`);let{build:i}=await Lr(e,`vite`),{default:a}=await Lr(e,`unplugin-swc`),{devtoolsFlagPlugin:o,devtoolsStripPlugin:s}=await Lr(e,`@forinda/kickjs-vite`);await i({configFile:!1,root:e,logLevel:`warn`,oxc:!1,plugins:[a.vite(),o(),s()],resolve:{alias:{"@":N(e,`src`)}},ssr:{noExternal:!0,target:`node`},build:{ssr:!0,target:`node20`,outDir:N(e,t.outDir),emptyOutDir:!0,minify:!1,rollupOptions:{input:r,external:t.external.filter(t=>!F(N(e,`node_modules`,t))),output:{format:`esm`,entryFileNames:`server.mjs`,codeSplitting:!1}}}});let c=N(e,t.outDir,`server.mjs`);return n(`bundled ${M(process.cwd(),c)}`),c}function zr(e,t){let n=t.projectRoot,r=()=>Mr(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 Rr(n,e,t.log),a=N(n,e.siteRoot),o=N(a,`.netlify/v1/functions`);ot(o,{recursive:!0});let s=M(o,i).split(P).join(`/`);L(N(o,`api.mjs`),Nr(s,e.apiPath)),t.log(`wrote ${M(process.cwd(),N(o,`api.mjs`))}`);let c=e.staticDir??e.publishDir;e.staticDir||(ot(N(n,c),{recursive:!0}),t.log(`publish directory ready at ${M(process.cwd(),N(n,c))}`));let l=N(a,`netlify.toml`);if(F(l)){let e=Pr(I(l,`utf-8`)),r=M(a,N(n,c)).split(P).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 Rr(n,e,t.log),a=N(n,e.siteRoot),o=e.staticDir?N(n,e.staticDir):void 0,s=N(a,`.vercel/output`),c=N(s,`functions/api.func`);if(ct(s,{recursive:!0,force:!0}),ot(c,{recursive:!0}),at(i,N(c,`server.mjs`)),L(N(c,`index.mjs`),`import { handler } from './server.mjs'
 export default handler.node
-`),L(N(c,`.vc-config.json`),`${JSON.stringify({runtime:e.vercelRuntime,handler:`index.mjs`,launcherType:`Nodejs`,supportsResponseStreaming:!0},null,2)}\n`),o){if(!F(o))throw Error(`build:vercel: ${e.staticDir} does not exist — build the frontend first`);at(o,N(s,`static`),{recursive:!0})}L(N(s,`config.json`),`${JSON.stringify({version:3,routes:Fr(e.apiPath,!!o)},null,2)}\n`),t.log(`wrote ${M(process.cwd(),s)}`)})}const Br=()=>({id:`kick/assets`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`],async generate(e){let t=k.resolve(e.cwd,`kick.config.ts`);if(!F(t))return null;let n=await C(e.cwd);if(!n?.assetMap)return null;let r=Re(n.assetMap,e.cwd);return r.count===0?null:Je(r)}}),Vr="/* 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 Hr(e,t,n,r={}){if(e.length===0)return`${Vr}
+`),L(N(c,`.vc-config.json`),`${JSON.stringify({runtime:e.vercelRuntime,handler:`index.mjs`,launcherType:`Nodejs`,supportsResponseStreaming:!0},null,2)}\n`),o){if(!F(o))throw Error(`build:vercel: ${e.staticDir} does not exist — build the frontend first`);at(o,N(s,`static`),{recursive:!0})}L(N(s,`config.json`),`${JSON.stringify({version:3,routes:Fr(e.apiPath,!!o)},null,2)}\n`),t.log(`wrote ${M(process.cwd(),s)}`)})}const Br=()=>({id:`kick/assets`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`],async generate(e){let t=k.resolve(e.cwd,`kick.config.ts`);if(!F(t))return null;let n=await w(e.cwd);if(!n?.assetMap)return null;let r=Le(n.assetMap,e.cwd);return r.count===0?null:qe(r)}}),Vr="/* 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 Hr(e,t,n,r={}){if(e.length===0)return`${Vr}
 // (no routes discovered yet — annotate a controller method with
 //  @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
 declare global {
@@ -733,12 +733,12 @@ export const kickRpc = {} as const
 `)}\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=Jr(``,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=qr(a)+y,ee=l.join(`
+`:``,b=qr(a)+y,x=l.join(`
 `);return`${Vr}${b}
 declare global {
   // eslint-disable-next-line @typescript-eslint/no-namespace
   namespace KickRoutes {
-${ee}
+${x}
   }
 
   /** Short alias for \`KickRoutes.Api\` — \`createClient<KickApi>(...)\`. */
@@ -802,7 +802,7 @@ declare global {
 }
 
 export type { Api }
-`}const bi=`kick/client`,Q=`.kickjs/types/kick__client.d.ts`,xi=`.kickjs/cache/client-map.sha1`,Si=(()=>{try{return rt(import.meta.url)(`../../../package.json`).version??`0.0.0`}catch{return`0.0.0`}})();function Ci(e){try{if(!F(e))return null;let[t,n]=I(e,`utf-8`).trim().split(/\s+/);return t&&n?{inputs:t,output:n}:null}catch{return null}}function wi(e){return`${an}${bi} */\n\n${e}\n`}function Ti(e){try{return F(e)?I(e,`utf-8`):null}catch{return null}}async function Ei(e){let t=k.resolve(e.cwd,Q);if(!F(t))return!1;try{await ft(t,{force:!0})}catch(t){return e.log.warn(`  kick/client: could not remove the stale ${Q} — treat it as out of date (${t instanceof Error?t.message:String(t)})`),!0}return e.log.warn(`  kick/client: removed the previously generated ${Q} rather than leave a stale one — re-run \`kick typegen\` once the cause above is fixed.`),!0}function Di(e){let t=e?.typegen?.client;return typeof t==`object`?t.maxDepth:void 0}function Oi(e){let t=e.config?.typegen?.client;return typeof t==`boolean`?t:t&&typeof t==`object`?t.enabled!==!1:(F(k.resolve(e.cwd,Q))&&e.log.warn(`  kick/client: ${Q} 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 ki=()=>({id:bi,outExtension:`.d.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){if(!Oi(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:k.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=Di(e.config),a=await ui({projectDir:e.cwd,keys:n,maxDepth:i,cliVersion:Si}),o=Ci(k.resolve(e.cwd,xi)),s=Ti(k.resolve(e.cwd,Q));if(a&&o&&s!==null&&o.inputs===a&&o.output===ci(s))return se()&&e.log.info?.(`  kick/client: unchanged, keeping ${Q}`),null;try{let t=yi(await di({projectDir:e.cwd,routesFile:k.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(xi,`${a} ${ci(wi(t))}`),t}catch(t){let n=F(k.resolve(e.cwd,Q)),r=`  kick/client: skipped — ${t instanceof Error?t.message:String(t)}`;return n?e.log.warn(r):se()&&e.log.info?.(r),n&&await Ei(e),null}}});function Ai(e,t,n=`zod`){if(!e)return null;let r=A(t),i=M(r,e.filePath).split(P).join(`/`);return i=i.replace(/\.(ts|tsx|mts|cts)$/i,``),i.startsWith(`.`)||(i=`./`+i),`/* eslint-disable */
+`}const bi=`kick/client`,Q=`.kickjs/types/kick__client.d.ts`,xi=`.kickjs/cache/client-map.sha1`,Si=(()=>{try{return rt(import.meta.url)(`../../../package.json`).version??`0.0.0`}catch{return`0.0.0`}})();function Ci(e){try{if(!F(e))return null;let[t,n]=I(e,`utf-8`).trim().split(/\s+/);return t&&n?{inputs:t,output:n}:null}catch{return null}}function wi(e){return`${an}${bi} */\n\n${e}\n`}function Ti(e){try{return F(e)?I(e,`utf-8`):null}catch{return null}}async function Ei(e){let t=k.resolve(e.cwd,Q);if(!F(t))return!1;try{await ft(t,{force:!0})}catch(t){return e.log.warn(`  kick/client: could not remove the stale ${Q} — treat it as out of date (${t instanceof Error?t.message:String(t)})`),!0}return e.log.warn(`  kick/client: removed the previously generated ${Q} rather than leave a stale one — re-run \`kick typegen\` once the cause above is fixed.`),!0}function Di(e){let t=e?.typegen?.client;return typeof t==`object`?t.maxDepth:void 0}function Oi(e){let t=e.config?.typegen?.client;return typeof t==`boolean`?t:t&&typeof t==`object`?t.enabled!==!1:(F(k.resolve(e.cwd,Q))&&e.log.warn(`  kick/client: ${Q} 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 ki=()=>({id:bi,outExtension:`.d.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){if(!Oi(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:k.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=Di(e.config),a=await ui({projectDir:e.cwd,keys:n,maxDepth:i,cliVersion:Si}),o=Ci(k.resolve(e.cwd,xi)),s=Ti(k.resolve(e.cwd,Q));if(a&&o&&s!==null&&o.inputs===a&&o.output===ci(s))return ae()&&e.log.info?.(`  kick/client: unchanged, keeping ${Q}`),null;try{let t=yi(await di({projectDir:e.cwd,routesFile:k.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(xi,`${a} ${ci(wi(t))}`),t}catch(t){let n=F(k.resolve(e.cwd,Q)),r=`  kick/client: skipped — ${t instanceof Error?t.message:String(t)}`;return n?e.log.warn(r):ae()&&e.log.info?.(r),n&&await Ei(e),null}}});function Ai(e,t,n=`zod`){if(!e)return null;let r=A(t),i=M(r,e.filePath).split(P).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.
 
@@ -840,6 +840,6 @@ declare global {
 }
 
 export {}
-`}const ji=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=Ni(e);if(t===!1)return null;let n=await e.getScanResult({root:Mi(e),cwd:e.cwd,envFile:t});if(!n.env)return null;let r=e.config?.typegen?.schemaValidator??`zod`,i=k.resolve(e.cwd,`.kickjs/types/kick__env.ts`);return Ai(n.env,i,r)}});function Mi(e){return k.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Ni(e){return e.config?.typegen?.envFile}function Pi(e){return k.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Fi(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function $(e){return{root:Pi(e),cwd:e.cwd,envFile:Fi(e)}}const Ii=()=>({id:`kick/registry`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e)),n=k.resolve(e.cwd,`.kickjs/types/kick__registry.d.ts`),r=new Set(t.collisions.map(e=>e.className));return Ye(t.classes,n,r)}}),Li=()=>({id:`kick/services`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e)),n=new Set(t.collisions.map(e=>e.className)),r=Ke(t.classes,t.tokens,t.injects,n);return We(`ServiceToken`,r,"(no tokens discovered — declare with createToken<T>() or `kick g service <name>`)")}}),Ri=()=>({id:`kick/modules`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return We(`ModuleToken`,Be(t.classes),"(no @Module classes discovered — `kick g module <name>` to add one)")}}),zi=()=>({id:`kick/plugins`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return He(t.pluginsAndAdapters)}}),Bi=()=>({id:`kick/augmentations`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return Qe(t.augmentations)}}),Vi=()=>({id:`kick/context`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return t.contextKeys.length===0?null:Ve(t.contextKeys)}}),Hi=()=>({id:`kick/route-flags`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return qe(t.routeFlags)}}),Ui={fastify:{subpath:`@forinda/kickjs/fastify`,typeName:`FastifyRuntimeTypes`},h3:{subpath:`@forinda/kickjs/h3`,typeName:`H3RuntimeTypes`}},Wi=[E({name:`kick/init`,register:wt}),E({name:`kick/generate`,register:nn}),E({name:`kick/run`,register:_n}),E({name:`kick/info`,register:Sn}),E({name:`kick/inspect`,register:jn}),E({name:`kick/add`,register:we}),E({name:`kick/list`,register:xe}),E({name:`kick/explain`,register:Bn}),E({name:`kick/mcp`,register:Xn}),E({name:`kick/tinker`,register:er}),E({name:`kick/remove`,register:or}),E({name:`kick/typegen`,register:lr}),E({name:`kick/check`,register:Or}),E({name:`kick/doctor`,register:he}),E({name:`kick/codemod`,register:Ar}),E({name:`kick/deploy`,register:zr}),E({name:`kick/registry`,typegens:[Ii()]}),E({name:`kick/services`,typegens:[Li()]}),E({name:`kick/modules`,typegens:[Ri()]}),E({name:`kick/plugins`,typegens:[zi()]}),E({name:`kick/augmentations`,typegens:[Bi()]}),E({name:`kick/context`,typegens:[Vi()]}),E({name:`kick/route-flags`,typegens:[Hi()]}),E({name:`kick/assets`,typegens:[Br()]}),E({name:`kick/routes`,typegens:[Xr()]}),E({name:`kick/client`,typegens:[ki()]}),E({name:`kick/env`,typegens:[ji()]}),E({name:`kick/runtime`,typegens:[{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}=Ui[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(`
+`}const ji=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=Ni(e);if(t===!1)return null;let n=await e.getScanResult({root:Mi(e),cwd:e.cwd,envFile:t});if(!n.env)return null;let r=e.config?.typegen?.schemaValidator??`zod`,i=k.resolve(e.cwd,`.kickjs/types/kick__env.ts`);return Ai(n.env,i,r)}});function Mi(e){return k.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Ni(e){return e.config?.typegen?.envFile}function Pi(e){return k.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Fi(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function $(e){return{root:Pi(e),cwd:e.cwd,envFile:Fi(e)}}const Ii=()=>({id:`kick/registry`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e)),n=k.resolve(e.cwd,`.kickjs/types/kick__registry.d.ts`),r=new Set(t.collisions.map(e=>e.className));return Je(t.classes,n,r)}}),Li=()=>({id:`kick/services`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e)),n=new Set(t.collisions.map(e=>e.className)),r=Ge(t.classes,t.tokens,t.injects,n);return Ue(`ServiceToken`,r,"(no tokens discovered — declare with createToken<T>() or `kick g service <name>`)")}}),Ri=()=>({id:`kick/modules`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return Ue(`ModuleToken`,ze(t.classes),"(no @Module classes discovered — `kick g module <name>` to add one)")}}),zi=()=>({id:`kick/plugins`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return Ve(t.pluginsAndAdapters)}}),Bi=()=>({id:`kick/augmentations`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return Qe(t.augmentations)}}),Vi=()=>({id:`kick/context`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return t.contextKeys.length===0?null:Be(t.contextKeys)}}),Hi=()=>({id:`kick/route-flags`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return Ke(t.routeFlags)}}),Ui={fastify:{subpath:`@forinda/kickjs/fastify`,typeName:`FastifyRuntimeTypes`},h3:{subpath:`@forinda/kickjs/h3`,typeName:`H3RuntimeTypes`}},Wi=[D({name:`kick/init`,register:wt}),D({name:`kick/generate`,register:nn}),D({name:`kick/run`,register:_n}),D({name:`kick/info`,register:Sn}),D({name:`kick/inspect`,register:jn}),D({name:`kick/add`,register:Ce}),D({name:`kick/list`,register:be}),D({name:`kick/explain`,register:Bn}),D({name:`kick/mcp`,register:Xn}),D({name:`kick/tinker`,register:er}),D({name:`kick/remove`,register:or}),D({name:`kick/typegen`,register:lr}),D({name:`kick/check`,register:Or}),D({name:`kick/doctor`,register:me}),D({name:`kick/codemod`,register:Ar}),D({name:`kick/deploy`,register:zr}),D({name:`kick/registry`,typegens:[Ii()]}),D({name:`kick/services`,typegens:[Li()]}),D({name:`kick/modules`,typegens:[Ri()]}),D({name:`kick/plugins`,typegens:[zi()]}),D({name:`kick/augmentations`,typegens:[Bi()]}),D({name:`kick/context`,typegens:[Vi()]}),D({name:`kick/route-flags`,typegens:[Hi()]}),D({name:`kick/assets`,typegens:[Br()]}),D({name:`kick/routes`,typegens:[Xr()]}),D({name:`kick/client`,typegens:[ki()]}),D({name:`kick/env`,typegens:[ji()]}),D({name:`kick/runtime`,typegens:[{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}=Ui[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(`
 `)}}]})];export{cn as applyDisableFilter,ln as n,Tt as r,G as runAllPluginTypegens,Wi as t};
-//# sourceMappingURL=run-plugins-lLfcDAbT.mjs.map
+//# sourceMappingURL=run-plugins-DSYGn4AC.mjs.map