@forinda/kickjs-cli 8.11.0 → 8.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/dist/{agent-docs-DGE_9641.mjs → agent-docs-DZJSoa_5.mjs} +3 -3
  2. package/dist/{agent-docs-DGE_9641.mjs.map → agent-docs-DZJSoa_5.mjs.map} +1 -1
  3. package/dist/{agent-docs-DUxCvCBc.mjs → agent-docs-GBEi-4ZM.mjs} +2 -2
  4. package/dist/{build-BQiF63pu.mjs → build-DZtpU_3Z.mjs} +3 -3
  5. package/dist/{build-BQiF63pu.mjs.map → build-DZtpU_3Z.mjs.map} +1 -1
  6. package/dist/{build-BUFgk6Ss.mjs → build-DkjrK7QX.mjs} +2 -2
  7. package/dist/{builtins-d9YrHyb1.mjs → builtins-BMZz5lPx.mjs} +121 -110
  8. package/dist/{builtins-CaOnJmm8.mjs → builtins-h-f_jNxU.mjs} +2 -2
  9. package/dist/cli.mjs +2 -2
  10. package/dist/config-B7d6wm08.mjs +12 -0
  11. package/dist/config-aEXDfmSS.mjs +13 -0
  12. package/dist/config-aEXDfmSS.mjs.map +1 -0
  13. package/dist/{doctor-CYnItgYt.mjs → doctor-DKtiOCf2.mjs} +35 -24
  14. package/dist/doctor-DKtiOCf2.mjs.map +1 -0
  15. package/dist/{fullstack--utMEADY.mjs → fullstack-B6ZY4jGe.mjs} +4 -4
  16. package/dist/{fullstack--utMEADY.mjs.map → fullstack-B6ZY4jGe.mjs.map} +1 -1
  17. package/dist/{fullstack-D6ikgPKw.mjs → fullstack-DBLIBX52.mjs} +3 -3
  18. package/dist/index.d.mts +8 -2
  19. package/dist/index.d.mts.map +1 -1
  20. package/dist/index.mjs +2 -2
  21. package/dist/package-manager-2OKBz8KC.mjs +11 -0
  22. package/dist/package-manager-C9253oKe.mjs +12 -0
  23. package/dist/package-manager-C9253oKe.mjs.map +1 -0
  24. package/dist/{plugin-C7ybMh21.mjs → plugin-BqNQkm01.mjs} +2 -2
  25. package/dist/{plugin-DS5g6A5U.mjs → plugin-Dc9DwVlE.mjs} +2 -2
  26. package/dist/{project-CGCAZsQV.mjs → project-BktC0yLE.mjs} +5 -5
  27. package/dist/{project-CGCAZsQV.mjs.map → project-BktC0yLE.mjs.map} +1 -1
  28. package/dist/{project-CDUJMeIr.mjs → project-Cr8KrIZg.mjs} +4 -4
  29. package/dist/{project-root-Da2aMneY.mjs → project-root-By-1PuaD.mjs} +2 -2
  30. package/dist/{project-root-ThZdP1t_.mjs → project-root-C_H7sWTH.mjs} +3 -3
  31. package/dist/{project-root-ThZdP1t_.mjs.map → project-root-C_H7sWTH.mjs.map} +1 -1
  32. package/dist/{prompts-Pzk_Seut.mjs → prompts-iLmIrMD4.mjs} +2 -2
  33. package/dist/{prompts-Pzk_Seut.mjs.map → prompts-iLmIrMD4.mjs.map} +1 -1
  34. package/dist/{rolldown-runtime-DAPeToCs.mjs → rolldown-runtime-De7_Z3h7.mjs} +1 -1
  35. package/dist/{run-plugins-Du6FlB7_.mjs → run-plugins-DY4qiPTu.mjs} +80 -80
  36. package/dist/run-plugins-DY4qiPTu.mjs.map +1 -0
  37. package/dist/{typegen-9tepCLIZ.mjs → typegen-C13eMf8Q.mjs} +5 -5
  38. package/dist/{typegen-9tepCLIZ.mjs.map → typegen-C13eMf8Q.mjs.map} +1 -1
  39. package/dist/{typegen-BkpCnSQ3.mjs → typegen-ajfH3dB8.mjs} +4 -4
  40. package/dist/{types-DJXxhn43.mjs → types-m-1iCFmy.mjs} +1 -1
  41. package/package.json +4 -4
  42. package/templates/base/files/tsconfig.json +3 -1
  43. package/templates/template-inertia/feature.json +1 -1
  44. package/templates/template-inertia/files/tsconfig.json +3 -1
  45. package/templates/template-inertia/files/vite.config.ts +3 -2
  46. package/dist/config-CcsYA02N.mjs +0 -13
  47. package/dist/config-CcsYA02N.mjs.map +0 -1
  48. package/dist/config-DhzyaY1S.mjs +0 -12
  49. package/dist/doctor-CYnItgYt.mjs.map +0 -1
  50. package/dist/package-manager-BaXE6gY_.mjs +0 -12
  51. package/dist/package-manager-BaXE6gY_.mjs.map +0 -1
  52. package/dist/package-manager-Ogog_AHE.mjs +0 -11
  53. package/dist/run-plugins-Du6FlB7_.mjs.map +0 -1
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs-cli v8.11.0
2
+ * @forinda/kickjs-cli v8.12.1
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,7 +8,7 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import{t as e}from"./rolldown-runtime-DAPeToCs.mjs";import{a as t,i as n,n as r,o as i,t as a}from"./package-manager-BaXE6gY_.mjs";import{a as o,c as s,d as c,i as l,l as u,n as d,o as f,r as p,s as m,t as h,u as g}from"./prompts-Pzk_Seut.mjs";import{A as _,C as v,D as y,E as b,F as x,M as ee,N as te,O as ne,P as S,S as re,T as ie,_ as ae,a as oe,b as se,c as ce,f as le,g as ue,h as de,i as fe,j as pe,k as me,l as he,m as ge,p as _e,r as ve,u as ye,v as be,w as xe,x as Se,y as Ce}from"./doctor-CYnItgYt.mjs";import{a as we,c as C,d as Te,f as Ee,l as w,m as De,o as Oe,p as ke,s as T,u as Ae}from"./config-CcsYA02N.mjs";import{o as je,r as Me,s as Ne,t as Pe,u as Fe}from"./project-CGCAZsQV.mjs";import{t as E}from"./project-root-ThZdP1t_.mjs";import{n as D,t as Ie}from"./types-DJXxhn43.mjs";import{t as Le}from"./build-BQiF63pu.mjs";import{n as Re}from"./agent-docs-DGE_9641.mjs";import{C as ze,S as Be,_ as Ve,a as He,b as Ue,c as We,d as Ge,f as Ke,g as qe,h as Je,i as Ye,l as Xe,m as Ze,o as Qe,p as $e,r as et,s as tt,t as nt,u as rt,v as it,w as at,x as O,y as ot}from"./typegen-9tepCLIZ.mjs";import{createRequire as st}from"node:module";import k,{basename as ct,dirname as A,join as j,relative as M,resolve as N,sep as P}from"node:path";import{cpSync as lt,existsSync as F,mkdirSync as ut,readFileSync as I,readdirSync as L,rmSync as dt,statSync as ft,writeFileSync as R}from"node:fs";import{copyFile as pt,mkdir as mt,readFile as z,readdir as ht,rm as gt,stat as _t,writeFile as vt}from"node:fs/promises";import{fork as yt,spawn as bt,spawnSync as xt}from"node:child_process";import{createHash as St}from"node:crypto";import{fileURLToPath as Ct,pathToFileURL as B}from"node:url";import{parseSync as wt}from"oxc-parser";import{arch as Tt,platform as Et,release as Dt}from"node:os";const Ot=[{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`},{value:`storage`,label:`Storage`,hint:`disk, S3 / R2 / MinIO`}];function kt(e){e.command(`new [name]`).alias(`init`).description(`Create a new KickJS project (use "." for current directory)`).option(`-d, --directory <dir>`,`Target directory (defaults to project name)`).option(`--pm <manager>`,`Package manager: pnpm | npm | yarn | bun`).option(`--git`,`Initialize git repository`).option(`--no-git`,`Skip git initialization`).option(`--install`,`Install dependencies after scaffolding`).option(`--no-install`,`Skip dependency installation`).option(`-f, --force`,`Remove existing files without prompting`).option(`-t, --template <type>`,`Project template: rest | minimal | fullstack | inertia`).option(`--runtime <engine>`,`HTTP runtime: express | fastify | h3`).option(`-r, --repo <type>`,`Repository name (inmemory, or any DB name e.g. postgres)`).option(`-s, --schema <lib>`,`Schema library for env / DTOs: zod | valibot | yup (default: zod)`).option(`--frontend <kind>`,`Fullstack web/ scaffold: 'kick' (wired React app) or 'vite' (create-vite, unwired)`).option(`--vite-template <name>`,`create-vite TypeScript template for --frontend vite (default 'react-ts')`).option(`--packages <packages>`,`Comma-separated packages to include (e.g. swagger,ws,queue,devtools)`).option(`-y, --yes`,`Pick safe defaults for every prompt (template=minimal, repo=inmemory, no extras, git+install on)`).option(`--non-interactive`,`alias for --yes`).action(async(e,t)=>{d(`KickJS — Create a new project`);let n=!!(t.yes||t.nonInteractive);e||=n?`my-api`:await s({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let i;if(e===`.`?(i=N(`.`),e=ct(i)):i=N(t.directory||e),F(i)){let r=L(i);if(r.length>0){if(t.force)p.warn(`Clearing existing files in ${i}`);else if(n){p.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),o(`Aborted.`);return}else{p.warn(`Directory "${e}" is not empty:`);let t=r.slice(0,5);for(let e of t)p.message(` - ${e}`);if(r.length>5&&p.message(` ... and ${r.length-5} more`),!await h({message:g.red(`Remove all existing files and proceed?`),initialValue:!1})){o(`Aborted.`);return}}for(let e of r)dt(N(i,e),{recursive:!0,force:!0})}}let a=t.template;a||=n?`minimal`:await f({message:`Project template`,options:[{value:`rest`,label:`REST API`,hint:`Express + Swagger`},{value:`minimal`,label:`Minimal`,hint:`bare Express`},{value:`fullstack`,label:`Fullstack`,hint:`server + Vite React web, typed client`},{value:`inertia`,label:`Inertia`,hint:`server-driven React pages, one app, SSR`}]});let c=t.runtime;c||=n?`express`:await f({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 u=t.pm;u||=n?await r(void 0):await f({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let m=t.repo;m||=n?`inmemory`:await s({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),De(m);let _=t.schema;a===`inertia`&&(_&&_!==`zod`&&p.warn(`The inertia template uses zod — ignoring --schema ${_}.`),_=`zod`),_||=n?`zod`:await f({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(_)||(p.warn(`Unknown --schema "${_}", falling back to zod.`),_=`zod`);let v;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();v=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else v=n?[]:await l({message:`Select packages to include`,options:[...Ot],required:!1});let y;y=t.git===void 0?n?!0:await h({message:`Initialize git repository?`,initialValue:!0}):t.git;let b;if(b=t.install===void 0?n?!0:await h({message:`Install dependencies?`,initialValue:!0}):t.install,t.frontend!==void 0&&t.frontend!==`kick`&&t.frontend!==`vite`){p.error(`Unknown --frontend '${String(t.frontend)}'. Use 'kick' (wired React app) or 'vite' (create-vite).`),o(`Aborted.`);return}let{VITE_TEMPLATES:x,DEFAULT_VITE_TEMPLATE:ee}=await import(`./fullstack--utMEADY.mjs`);if(t.viteTemplate!==void 0&&!x.some(e=>e.value===t.viteTemplate)){p.error(`Unknown --vite-template '${String(t.viteTemplate)}'. TypeScript templates only: ${x.map(e=>e.value).join(`, `)}.`),o(`Aborted.`);return}let te=t.frontend===`vite`?`vite`:`kick`,ne=t.viteTemplate??ee;if(a===`fullstack`&&!t.frontend&&!n&&(te=await f({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)`}]})),te===`vite`&&!t.viteTemplate&&!n&&(ne=await f({message:`create-vite template`,options:x.map(e=>({value:e.value,label:e.label})),initialValue:ee})),a===`fullstack`){let{initFullstackProject:t}=await import(`./fullstack--utMEADY.mjs`);await t({name:e,directory:i,packageManager:u,initGit:y,installDeps:b,schemaLib:_,runtime:c,packages:v,frontend:te,viteTemplate:ne}),o(`Done! Next steps: ${g.cyan(`cd ${e} && ${u}${u===`pnpm`?` dev`:` run dev:server`}`)}`)}else await Pe({name:e,directory:i,packageManager:u,initGit:y,installDeps:b,template:a,defaultRepo:m,packages:v,schemaLib:_,runtime:c}),o(`Done! Next steps: ${g.cyan(`cd ${e} && ${ke(u,`dev`)}`)}`)})}function At(e,t=[]){let n=/* @__PURE__ */ 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 Ie(`plugin`,t.name,[t.name,t.name])}let r=/* @__PURE__ */ new Map,i=[];for(let t of e)for(let e of t.commands??[]){let n=r.get(e.name);if(n)throw new Ie(`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=/* @__PURE__ */ new Map,c=[];for(let t of e)for(let e of t.typegens??[]){let n=s.get(e.id);if(n)throw new Ie(`typegen`,e.id,[n,t.name]);s.set(e.id,t.name),c.push(e)}let l=/* @__PURE__ */ new Map,u=[];for(let t of e)for(let e of t.generators??[]){let n=l.get(e.name);if(n)throw new Ie(`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-ThZdP1t_.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 jt(e){let{name:t,outDir:n}=e,r=S(t),a=x(t),o=[],s=j(n,`${r}.plugin.ts`);return await i(s,`import {
11
+ import{t as e}from"./rolldown-runtime-De7_Z3h7.mjs";import{a as t,i as n,n as r,o as i,t as a}from"./package-manager-C9253oKe.mjs";import{a as o,c as s,d as c,i as l,l as u,n as d,o as f,r as p,s as m,t as h,u as g}from"./prompts-iLmIrMD4.mjs";import{A as _,C as v,D as y,E as b,F as x,M as ee,N as te,O as ne,P as S,S as re,T as ie,_ as ae,a as oe,b as se,c as ce,f as le,g as ue,h as de,i as fe,j as pe,k as me,l as he,m as ge,p as _e,r as ve,u as ye,v as be,w as xe,x as Se,y as Ce}from"./doctor-DKtiOCf2.mjs";import{a as we,c as C,d as Te,f as Ee,h as De,l as w,m as Oe,o as ke,p as Ae,s as T,u as je}from"./config-aEXDfmSS.mjs";import{o as Me,r as Ne,s as Pe,t as Fe,u as Ie}from"./project-BktC0yLE.mjs";import{t as E}from"./project-root-C_H7sWTH.mjs";import{n as D,t as Le}from"./types-m-1iCFmy.mjs";import{t as Re}from"./build-DZtpU_3Z.mjs";import{n as ze}from"./agent-docs-DZJSoa_5.mjs";import{C as Be,S as Ve,_ as He,a as Ue,b as We,c as Ge,d as Ke,f as qe,g as Je,h as Ye,i as Xe,l as Ze,m as Qe,o as $e,p as et,r as tt,s as nt,t as rt,u as it,v as at,w as ot,x as O,y as st}from"./typegen-C13eMf8Q.mjs";import{createRequire as ct}from"node:module";import k,{basename as lt,dirname as A,join as j,relative as M,resolve as N,sep as P}from"node:path";import{cpSync as ut,existsSync as F,mkdirSync as dt,readFileSync as I,readdirSync as L,rmSync as ft,statSync as pt,writeFileSync as R}from"node:fs";import{copyFile as mt,mkdir as ht,readFile as z,readdir as gt,rm as _t,stat as vt,writeFile as yt}from"node:fs/promises";import{fork as bt,spawn as xt,spawnSync as St}from"node:child_process";import{createHash as Ct}from"node:crypto";import{fileURLToPath as wt,pathToFileURL as B}from"node:url";import{parseSync as Tt}from"oxc-parser";import{arch as Et,platform as Dt,release as Ot}from"node:os";const kt=[{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`},{value:`storage`,label:`Storage`,hint:`disk, S3 / R2 / MinIO`}];function At(e){e.command(`new [name]`).alias(`init`).description(`Create a new KickJS project (use "." for current directory)`).option(`-d, --directory <dir>`,`Target directory (defaults to project name)`).option(`--pm <manager>`,`Package manager: pnpm | npm | yarn | bun`).option(`--git`,`Initialize git repository`).option(`--no-git`,`Skip git initialization`).option(`--install`,`Install dependencies after scaffolding`).option(`--no-install`,`Skip dependency installation`).option(`-f, --force`,`Remove existing files without prompting`).option(`-t, --template <type>`,`Project template: rest | minimal | fullstack | inertia`).option(`--runtime <engine>`,`HTTP runtime: express | fastify | h3`).option(`-r, --repo <type>`,`Repository name (inmemory, or any DB name e.g. postgres)`).option(`-s, --schema <lib>`,`Schema library for env / DTOs: zod | valibot | yup (default: zod)`).option(`--frontend <kind>`,`Fullstack web/ scaffold: 'kick' (wired React app) or 'vite' (create-vite, unwired)`).option(`--vite-template <name>`,`create-vite TypeScript template for --frontend vite (default 'react-ts')`).option(`--packages <packages>`,`Comma-separated packages to include (e.g. swagger,ws,queue,devtools)`).option(`-y, --yes`,`Pick safe defaults for every prompt (template=minimal, repo=inmemory, no extras, git+install on)`).option(`--non-interactive`,`alias for --yes`).action(async(e,t)=>{d(`KickJS — Create a new project`);let n=!!(t.yes||t.nonInteractive);e||=n?`my-api`:await s({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let i;if(e===`.`?(i=N(`.`),e=lt(i)):i=N(t.directory||e),F(i)){let r=L(i);if(r.length>0){if(t.force)p.warn(`Clearing existing files in ${i}`);else if(n){p.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),o(`Aborted.`);return}else{p.warn(`Directory "${e}" is not empty:`);let t=r.slice(0,5);for(let e of t)p.message(` - ${e}`);if(r.length>5&&p.message(` ... and ${r.length-5} more`),!await h({message:g.red(`Remove all existing files and proceed?`),initialValue:!1})){o(`Aborted.`);return}}for(let e of r)ft(N(i,e),{recursive:!0,force:!0})}}let a=t.template;a||=n?`minimal`:await f({message:`Project template`,options:[{value:`rest`,label:`REST API`,hint:`Express + Swagger`},{value:`minimal`,label:`Minimal`,hint:`bare Express`},{value:`fullstack`,label:`Fullstack`,hint:`server + Vite React web, typed client`},{value:`inertia`,label:`Inertia`,hint:`server-driven React pages, one app, SSR`}]});let c=t.runtime;c||=n?`express`:await f({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 u=t.pm;u||=n?await r(void 0):await f({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let m=t.repo;m||=n?`inmemory`:await s({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),De(m);let _=t.schema;a===`inertia`&&(_&&_!==`zod`&&p.warn(`The inertia template uses zod — ignoring --schema ${_}.`),_=`zod`),_||=n?`zod`:await f({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(_)||(p.warn(`Unknown --schema "${_}", falling back to zod.`),_=`zod`);let v;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();v=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else v=n?[]:await l({message:`Select packages to include`,options:[...kt],required:!1});let y;y=t.git===void 0?n?!0:await h({message:`Initialize git repository?`,initialValue:!0}):t.git;let b;if(b=t.install===void 0?n?!0:await h({message:`Install dependencies?`,initialValue:!0}):t.install,t.frontend!==void 0&&t.frontend!==`kick`&&t.frontend!==`vite`){p.error(`Unknown --frontend '${String(t.frontend)}'. Use 'kick' (wired React app) or 'vite' (create-vite).`),o(`Aborted.`);return}let{VITE_TEMPLATES:x,DEFAULT_VITE_TEMPLATE:ee}=await import(`./fullstack-B6ZY4jGe.mjs`);if(t.viteTemplate!==void 0&&!x.some(e=>e.value===t.viteTemplate)){p.error(`Unknown --vite-template '${String(t.viteTemplate)}'. TypeScript templates only: ${x.map(e=>e.value).join(`, `)}.`),o(`Aborted.`);return}let te=t.frontend===`vite`?`vite`:`kick`,ne=t.viteTemplate??ee;if(a===`fullstack`&&!t.frontend&&!n&&(te=await f({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)`}]})),te===`vite`&&!t.viteTemplate&&!n&&(ne=await f({message:`create-vite template`,options:x.map(e=>({value:e.value,label:e.label})),initialValue:ee})),a===`fullstack`){let{initFullstackProject:t}=await import(`./fullstack-B6ZY4jGe.mjs`);await t({name:e,directory:i,packageManager:u,initGit:y,installDeps:b,schemaLib:_,runtime:c,packages:v,frontend:te,viteTemplate:ne}),o(`Done! Next steps: ${g.cyan(`cd ${e} && ${u}${u===`pnpm`?` dev`:` run dev:server`}`)}`)}else await Fe({name:e,directory:i,packageManager:u,initGit:y,installDeps:b,template:a,defaultRepo:m,packages:v,schemaLib:_,runtime:c}),o(`Done! Next steps: ${g.cyan(`cd ${e} && ${Ae(u,`dev`)}`)}`)})}function jt(e,t=[]){let n=/* @__PURE__ */ 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 Le(`plugin`,t.name,[t.name,t.name])}let r=/* @__PURE__ */ new Map,i=[];for(let t of e)for(let e of t.commands??[]){let n=r.get(e.name);if(n)throw new Le(`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=/* @__PURE__ */ new Map,c=[];for(let t of e)for(let e of t.typegens??[]){let n=s.get(e.id);if(n)throw new Le(`typegen`,e.id,[n,t.name]);s.set(e.id,t.name),c.push(e)}let l=/* @__PURE__ */ new Map,u=[];for(let t of e)for(let e of t.generators??[]){let n=l.get(e.name);if(n)throw new Le(`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-C_H7sWTH.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 Mt(e){let{name:t,outDir:n}=e,r=S(t),a=x(t),o=[],s=j(n,`${r}.plugin.ts`);return await i(s,`import {
12
12
  definePlugin,
13
13
  type AppAdapter,
14
14
  type AppModuleEntry,
@@ -168,7 +168,7 @@ export const ${a}Plugin = definePlugin<${a}PluginConfig>({
168
168
  ${se(r,a,`plugin`,` `)}
169
169
  }),
170
170
  })
171
- `),o.push(s),o}function Mt(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 Nt(e){let{name:t,moduleName:n,modulesDir:r,pattern:a}=e,o=e.type??`http`,s=S(t),c=x(t),l=e.key??te(t),u=Array.isArray(e.params)?e.params:Mt(e.params),d=be({type:`contributor`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/contributors`,pattern:a,shouldPluralize:e.pluralize??!1}),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(`
171
+ `),o.push(s),o}function Nt(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 Pt(e){let{name:t,moduleName:n,modulesDir:r,pattern:a}=e,o=e.type??`http`,s=S(t),c=x(t),l=e.key??te(t),u=Array.isArray(e.params)?e.params:Nt(e.params),d=be({type:`contributor`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/contributors`,pattern:a,shouldPluralize:e.pluralize??!1}),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(`
172
172
  `)}\n}\n`:``,h=u.length>0?`${f}.withParams<${c}Params>()({`:`${f}({`,g=u.length>0?` // Every call site must supply these — no placeholder defaults.
173
173
  // Add \`paramDefaults: { … }\` for any field whose default is
174
174
  // genuinely correct for an undecorated route, and drop it from here.
@@ -219,7 +219,7 @@ ${v}
219
219
  throw new Error("${c} contributor: resolve() not implemented")
220
220
  },
221
221
  })
222
- `,b=j(d,`${s}.contributor.ts`);return await i(b,y),[b]}async function Pt(e){let t=j(e.outDir,`kick.config.ts`),n=e.modulesDir??`src/modules`,r=e.defaultRepo??`inmemory`;return F(t)&&!e.force&&!await h({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
222
+ `,b=j(d,`${s}.contributor.ts`);return await i(b,y),[b]}async function Ft(e){let t=j(e.outDir,`kick.config.ts`),n=e.modulesDir??`src/modules`,r=e.defaultRepo??`inmemory`;return F(t)&&!e.force&&!await h({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
223
223
  Skipped — existing kick.config.ts preserved.`),[]):(await i(t,`import { defineConfig } from '@forinda/kickjs-cli'
224
224
 
225
225
  export default defineConfig({
@@ -263,18 +263,18 @@ export default defineConfig({
263
263
  },
264
264
  ],
265
265
  })
266
- `),[t])}function Ft(e,t){if(e[t]!==`{`)return-1;let n=1;for(let r=t+1;r<e.length;r++){let t=e[r];if(t===`{`)n++;else if(t===`}`&&(n--,n===0))return r}return-1}function V(e,t){let n=t.exec(e);if(!n)return null;let r=n.index+n[0].length-1,i=Ft(e,r);return i===-1?null:e.slice(r+1,i)}function H(e,t,n){let r=` `.repeat(n);return e.split(`
266
+ `),[t])}function It(e,t){if(e[t]!==`{`)return-1;let n=1;for(let r=t+1;r<e.length;r++){let t=e[r];if(t===`{`)n++;else if(t===`}`&&(n--,n===0))return r}return-1}function V(e,t){let n=t.exec(e);if(!n)return null;let r=n.index+n[0].length-1,i=It(e,r);return i===-1?null:e.slice(r+1,i)}function H(e,t,n){let r=` `.repeat(n);return e.split(`
267
267
  `).map(e=>{if(e.trim()===``)return e;let n=RegExp(`^ {0,${t}}`),i=e.replace(n,``);return r+i}).join(`
268
- `)}function It(e){return e.replaceAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*'@forinda\/kickjs'/g,(e,t)=>{let n=t.split(`,`).map(e=>e.trim()).filter(e=>e&&e!==`Container`&&e!==`type Container`&&e!==`type AppModule`&&e!==`AppModule`&&e!==`type ModuleRoutes`&&e!==`ModuleRoutes`);return n.includes(`defineModule`)||n.push(`defineModule`),`import { ${n.join(`, `)} } from '@forinda/kickjs'`})}function Lt(e,t){return e.replaceAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*'@forinda\/kickjs'/g,(e,n)=>{let r=n.split(`,`).map(e=>e.trim()).filter(e=>e&&e!==`defineModule`);return t.container&&!r.includes(`Container`)&&r.push(`Container`),t.appModule&&!r.some(e=>e===`AppModule`||e===`type AppModule`)&&r.push(`type AppModule`),t.moduleRoutes&&!r.some(e=>e===`ModuleRoutes`||e===`type ModuleRoutes`)&&r.push(`type ModuleRoutes`),t.contributorRegistrations&&!r.some(e=>e===`ContributorRegistrations`||e===`type ContributorRegistrations`)&&r.push(`type ContributorRegistrations`),`import { ${r.join(`, `)} } from '@forinda/kickjs'`})}function Rt(e){if(/\bdefineModule\s*\(/.test(e))return{migrated:null,reason:`already in target form`};let t=[...e.matchAll(/export\s+class\s+(\w+Module)\s+implements\s+AppModule\s*\{/g)];if(t.length===0)return{migrated:null,reason:`no class form detected`};if(t.length>1)return{migrated:null,reason:`multiple module classes in one file — migrate manually`};let n=t[0],r=n[1],i=n.index+n[0].length-1,a=Ft(e,i);if(a===-1)return{migrated:null,reason:`unbalanced class braces`};let o=e.slice(i+1,a),s=e.slice(0,n.index),c=e.slice(a+1),l=V(o,/register\s*\(([^)]*)\)\s*:\s*void\s*\{/),u=V(o,/contributors\s*\(\s*\)\s*:\s*ContributorRegistrations\s*\{/),d=V(o,/routes\s*\(\s*\)\s*:\s*[A-Za-z|[\]\s]+\{/);if(!d)return{migrated:null,reason:`routes() method missing or signature unrecognized`};let f=It(s),p=``;return l&&(p+=` register(container) {${H(l,4,6)} },\n\n`),u&&(p+=` contributors() {${H(u,4,6)} },\n\n`),p+=` routes() {${H(d,4,6)} },`,{migrated:`${f}${`export const ${r} = defineModule({
268
+ `)}function Lt(e){return e.replaceAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*'@forinda\/kickjs'/g,(e,t)=>{let n=t.split(`,`).map(e=>e.trim()).filter(e=>e&&e!==`Container`&&e!==`type Container`&&e!==`type AppModule`&&e!==`AppModule`&&e!==`type ModuleRoutes`&&e!==`ModuleRoutes`);return n.includes(`defineModule`)||n.push(`defineModule`),`import { ${n.join(`, `)} } from '@forinda/kickjs'`})}function Rt(e,t){return e.replaceAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*'@forinda\/kickjs'/g,(e,n)=>{let r=n.split(`,`).map(e=>e.trim()).filter(e=>e&&e!==`defineModule`);return t.container&&!r.includes(`Container`)&&r.push(`Container`),t.appModule&&!r.some(e=>e===`AppModule`||e===`type AppModule`)&&r.push(`type AppModule`),t.moduleRoutes&&!r.some(e=>e===`ModuleRoutes`||e===`type ModuleRoutes`)&&r.push(`type ModuleRoutes`),t.contributorRegistrations&&!r.some(e=>e===`ContributorRegistrations`||e===`type ContributorRegistrations`)&&r.push(`type ContributorRegistrations`),`import { ${r.join(`, `)} } from '@forinda/kickjs'`})}function zt(e){if(/\bdefineModule\s*\(/.test(e))return{migrated:null,reason:`already in target form`};let t=[...e.matchAll(/export\s+class\s+(\w+Module)\s+implements\s+AppModule\s*\{/g)];if(t.length===0)return{migrated:null,reason:`no class form detected`};if(t.length>1)return{migrated:null,reason:`multiple module classes in one file — migrate manually`};let n=t[0],r=n[1],i=n.index+n[0].length-1,a=It(e,i);if(a===-1)return{migrated:null,reason:`unbalanced class braces`};let o=e.slice(i+1,a),s=e.slice(0,n.index),c=e.slice(a+1),l=V(o,/register\s*\(([^)]*)\)\s*:\s*void\s*\{/),u=V(o,/contributors\s*\(\s*\)\s*:\s*ContributorRegistrations\s*\{/),d=V(o,/routes\s*\(\s*\)\s*:\s*[A-Za-z|[\]\s]+\{/);if(!d)return{migrated:null,reason:`routes() method missing or signature unrecognized`};let f=Lt(s),p=``;return l&&(p+=` register(container) {${H(l,4,6)} },\n\n`),u&&(p+=` contributors() {${H(u,4,6)} },\n\n`),p+=` routes() {${H(d,4,6)} },`,{migrated:`${f}${`export const ${r} = defineModule({
269
269
  name: '${r}',
270
270
  build: () => ({
271
271
  ${p}
272
272
  }),
273
- })`}${c}`}}function zt(e){if(/export\s+class\s+\w+Module\s+implements\s+AppModule\s*\{/.test(e))return{migrated:null,reason:`already in target form`};let t=[...e.matchAll(/export\s+const\s+(\w+Module)\s*=\s*defineModule\s*\(\s*\{/g)];if(t.length===0)return{migrated:null,reason:`no defineModule form detected`};if(t.length>1)return{migrated:null,reason:`multiple defineModule blocks in one file — migrate manually`};let n=t[0],r=n[1],i=n.index+n[0].length-1,a=Ft(e,i);if(a===-1)return{migrated:null,reason:`unbalanced defineModule braces`};let o=e.indexOf(`)`,a);if(o===-1)return{migrated:null,reason:`unbalanced defineModule call parens`};let s=e.slice(i+1,a),c=e.slice(0,n.index),l=o+1;for(;l<e.length&&(e[l]===`
274
- `||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=Ft(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=Lt(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 {
273
+ })`}${c}`}}function Bt(e){if(/export\s+class\s+\w+Module\s+implements\s+AppModule\s*\{/.test(e))return{migrated:null,reason:`already in target form`};let t=[...e.matchAll(/export\s+const\s+(\w+Module)\s*=\s*defineModule\s*\(\s*\{/g)];if(t.length===0)return{migrated:null,reason:`no defineModule form detected`};if(t.length>1)return{migrated:null,reason:`multiple defineModule blocks in one file — migrate manually`};let n=t[0],r=n[1],i=n.index+n[0].length-1,a=It(e,i);if(a===-1)return{migrated:null,reason:`unbalanced defineModule braces`};let o=e.indexOf(`)`,a);if(o===-1)return{migrated:null,reason:`unbalanced defineModule call parens`};let s=e.slice(i+1,a),c=e.slice(0,n.index),l=o+1;for(;l<e.length&&(e[l]===`
274
+ `||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=It(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=Rt(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 {
275
275
  ${y}
276
276
  }
277
- `}${u}`}}function Bt(e,t){return t===`class`?zt(e):Rt(e)}function Vt(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 Ht(e){let t=[];return await n(N(e),0),t;async function n(e,r){let i;try{i=await ht(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 _t(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function Ut(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await ht(e)}catch{return}await mt(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 _t(i)}catch{continue}s.isDirectory()?await r(i,o):(await pt(i,o),n++)}}}function Wt(e){let t=(/* @__PURE__ */ new Date()).toISOString().replaceAll(/[:.]/g,`-`);return j(e,`.kickjs`,`codemod-backups`,`${t}-modules`)}async function Gt(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await Ht(e),s=await z(j(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=Wt(r),await Ut(e,c));let l=[];for(let e of o){let t=Bt(await z(e,`utf-8`),i);t.migrated==null?l.push({path:e,status:`skipped`,reason:t.reason}):(n||await vt(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`}))}let u=j(e,`index.ts`),d=null;try{d=await z(u,`utf-8`)}catch{return{target:i,files:l,indexStatus:`not-found`,indexPath:u,backupDir:c}}let f=Vt(d,i);return f.migrated==null?{target:i,files:l,indexStatus:`skipped`,indexPath:u,indexReason:f.reason,backupDir:c}:(n||await vt(u,f.migrated,`utf-8`),{target:i,files:l,indexStatus:`migrated`,indexPath:u,backupDir:c})}async function Kt(e,t){let n=await Ht(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 z(e,`utf-8`);i.test(t)&&r.push(e)}return r}const qt={string:{ts:`string`,zod:`z.string().min(1).max(200)`},text:{ts:`string`,zod:`z.string().min(1)`},number:{ts:`number`,zod:`z.number()`},int:{ts:`number`,zod:`z.number().int()`},float:{ts:`number`,zod:`z.number()`},boolean:{ts:`boolean`,zod:`z.boolean()`},date:{ts:`string`,zod:`z.iso.datetime()`},email:{ts:`string`,zod:`z.email()`},url:{ts:`string`,zod:`z.url()`},uuid:{ts:`string`,zod:`z.uuid()`},json:{ts:`any`,zod:`z.any()`}};function Jt(e){let t=e.map(e=>{let t=e.indexOf(`:`);if(t===-1)throw Error(`Invalid field: "${e}". Use format: name:type (e.g. title:string)`);let n=e.slice(0,t),r=e.slice(t+1);if(!n||!r)throw Error(`Invalid field: "${e}". Use format: name:type (e.g. title:string)`);let i=!1;r.endsWith(`:optional`)&&(r=r.slice(0,-9),i=!0),n.endsWith(`?`)&&(n=n.slice(0,-1),i=!0),r.endsWith(`?`)&&(r=r.slice(0,-1),i=!0);let a=r;if(a.startsWith(`enum:`)){let e=a.slice(5).split(`,`);return{name:n,type:`enum`,tsType:e.map(e=>`'${e}'`).join(` | `),zodType:`z.enum([${e.map(e=>`'${e}'`).join(`, `)}])`,optional:i}}let o=qt[a];if(!o){let e=[...Object.keys(qt),`enum:a,b,c`].join(`, `);throw Error(`Unknown field type: "${a}". Valid types: ${e}`)}return{name:n,type:a,tsType:o.ts,zodType:o.zod,optional:i}}),n=/* @__PURE__ */ new Set;for(let{name:e}of t){if(n.has(e))throw Error(`Duplicate field: "${e}". Each field name may appear once.`);n.add(e)}return t}async function Yt(e){let{name:t,fields:n,modulesDir:r,repo:a=`inmemory`,tokenScope:o=`app`,style:s=`define`}=e,c=e.pluralize===!0,l=S(t),u=x(t),d=c?pe(l):l,f=c?ee(u):u,p=e.pluralizeRoutes===!1?l:pe(l),m=j(r,d),h=[],g=async(e,t)=>{let n=j(m,e);await i(n,t),h.push(n)};return await g(`${l}.module.ts`,me({pascal:u,kebab:l,plural:d,routePath:p,repo:a,style:s})),await g(`${l}.constants.ts`,ie({pascal:u,kebab:l,fields:n})),await g(`${l}.controller.ts`,ne({pascal:u,kebab:l,plural:d,pluralPascal:f,swagger:e.swagger??!1})),await g(`${l}.service.ts`,b({pascal:u,kebab:l})),await g(`dtos/create-${l}.dto.ts`,Xt(u,n)),await g(`dtos/update-${l}.dto.ts`,Zt(u,n)),await g(`dtos/${l}-response.dto.ts`,Qt(u,n)),await g(`${l}.repository.ts`,y({pascal:u,kebab:l,repoType:a,dtoPrefix:`./dtos`,tokenScope:o})),await Se(r,u,d,l,s),h}function Xt(e,t){return`import { z } from 'zod'
277
+ `}${u}`}}function Vt(e,t){return t===`class`?Bt(e):zt(e)}function Ht(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 Ut(e){let t=[];return await n(N(e),0),t;async function n(e,r){let i;try{i=await gt(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 vt(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function Wt(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await gt(e)}catch{return}await ht(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 vt(i)}catch{continue}s.isDirectory()?await r(i,o):(await mt(i,o),n++)}}}function Gt(e){let t=(/* @__PURE__ */ new Date()).toISOString().replaceAll(/[:.]/g,`-`);return j(e,`.kickjs`,`codemod-backups`,`${t}-modules`)}async function Kt(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await Ut(e),s=await z(j(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=Gt(r),await Wt(e,c));let l=[];for(let e of o){let t=Vt(await z(e,`utf-8`),i);t.migrated==null?l.push({path:e,status:`skipped`,reason:t.reason}):(n||await yt(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`}))}let u=j(e,`index.ts`),d=null;try{d=await z(u,`utf-8`)}catch{return{target:i,files:l,indexStatus:`not-found`,indexPath:u,backupDir:c}}let f=Ht(d,i);return f.migrated==null?{target:i,files:l,indexStatus:`skipped`,indexPath:u,indexReason:f.reason,backupDir:c}:(n||await yt(u,f.migrated,`utf-8`),{target:i,files:l,indexStatus:`migrated`,indexPath:u,backupDir:c})}async function qt(e,t){let n=await Ut(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 z(e,`utf-8`);i.test(t)&&r.push(e)}return r}const Jt={string:{ts:`string`,zod:`z.string().min(1).max(200)`},text:{ts:`string`,zod:`z.string().min(1)`},number:{ts:`number`,zod:`z.number()`},int:{ts:`number`,zod:`z.number().int()`},float:{ts:`number`,zod:`z.number()`},boolean:{ts:`boolean`,zod:`z.boolean()`},date:{ts:`string`,zod:`z.iso.datetime()`},email:{ts:`string`,zod:`z.email()`},url:{ts:`string`,zod:`z.url()`},uuid:{ts:`string`,zod:`z.uuid()`},json:{ts:`any`,zod:`z.any()`}};function Yt(e){let t=e.map(e=>{let t=e.indexOf(`:`);if(t===-1)throw Error(`Invalid field: "${e}". Use format: name:type (e.g. title:string)`);let n=e.slice(0,t),r=e.slice(t+1);if(!n||!r)throw Error(`Invalid field: "${e}". Use format: name:type (e.g. title:string)`);let i=!1;r.endsWith(`:optional`)&&(r=r.slice(0,-9),i=!0),n.endsWith(`?`)&&(n=n.slice(0,-1),i=!0),r.endsWith(`?`)&&(r=r.slice(0,-1),i=!0);let a=r;if(a.startsWith(`enum:`)){let e=a.slice(5).split(`,`);return{name:n,type:`enum`,tsType:e.map(e=>`'${e}'`).join(` | `),zodType:`z.enum([${e.map(e=>`'${e}'`).join(`, `)}])`,optional:i}}let o=Jt[a];if(!o){let e=[...Object.keys(Jt),`enum:a,b,c`].join(`, `);throw Error(`Unknown field type: "${a}". Valid types: ${e}`)}return{name:n,type:a,tsType:o.ts,zodType:o.zod,optional:i}}),n=/* @__PURE__ */ new Set;for(let{name:e}of t){if(n.has(e))throw Error(`Duplicate field: "${e}". Each field name may appear once.`);n.add(e)}return t}async function Xt(e){let{name:t,fields:n,modulesDir:r,repo:a=`inmemory`,tokenScope:o=`app`,style:s=`define`}=e,c=e.pluralize===!0,l=S(t),u=x(t),d=c?pe(l):l,f=c?ee(u):u,p=e.pluralizeRoutes===!1?l:pe(l),m=j(r,d),h=[],g=async(e,t)=>{let n=j(m,e);await i(n,t),h.push(n)};return await g(`${l}.module.ts`,me({pascal:u,kebab:l,plural:d,routePath:p,repo:a,style:s})),await g(`${l}.constants.ts`,ie({pascal:u,kebab:l,fields:n})),await g(`${l}.controller.ts`,ne({pascal:u,kebab:l,plural:d,pluralPascal:f,swagger:e.swagger??!1})),await g(`${l}.service.ts`,b({pascal:u,kebab:l})),await g(`dtos/create-${l}.dto.ts`,Zt(u,n)),await g(`dtos/update-${l}.dto.ts`,Qt(u,n)),await g(`dtos/${l}-response.dto.ts`,$t(u,n)),await g(`${l}.repository.ts`,y({pascal:u,kebab:l,repoType:a,dtoPrefix:`./dtos`,tokenScope:o})),await Se(r,u,d,l,s),h}function Zt(e,t){return`import { z } from 'zod'
278
278
 
279
279
  export const create${e}Schema = z.object({
280
280
  ${t.map(e=>{let t=e.zodType;return` ${e.name}: ${t}${e.optional?`.optional()`:``},`}).join(`
@@ -282,7 +282,7 @@ ${t.map(e=>{let t=e.zodType;return` ${e.name}: ${t}${e.optional?`.optional()`:`
282
282
  })
283
283
 
284
284
  export type Create${e}DTO = z.infer<typeof create${e}Schema>
285
- `}function Zt(e,t){return`import { z } from 'zod'
285
+ `}function Qt(e,t){return`import { z } from 'zod'
286
286
 
287
287
  export const update${e}Schema = z.object({
288
288
  ${t.map(e=>` ${e.name}: ${e.zodType}.optional(),`).join(`
@@ -290,17 +290,17 @@ ${t.map(e=>` ${e.name}: ${e.zodType}.optional(),`).join(`
290
290
  })
291
291
 
292
292
  export type Update${e}DTO = z.infer<typeof update${e}Schema>
293
- `}function Qt(e,t){return`export interface ${e}ResponseDTO {
293
+ `}function $t(e,t){return`export interface ${e}ResponseDTO {
294
294
  id: string
295
295
  ${t.map(e=>` ${e.name}${e.optional?`?`:``}: ${e.tsType}`).join(`
296
296
  `)}
297
297
  createdAt: string
298
298
  updatedAt: string
299
299
  }
300
- `}async function $t(e){let{name:t,moduleName:n,modulesDir:r}=e,a=e.pluralize??!1,o=S(t),s=x(t),c=[],l;if(e.outDir)l=N(e.outDir);else if(n){let e=S(n),t=a?pe(e):e;l=N(j(r??`src/modules`,t,`__tests__`))}else l=N(`src/__tests__`);let u=j(l,`${o}.test.ts`);return await i(u,`import { describe, it, expect, beforeEach } from 'vitest'
300
+ `}async function en(e){let{name:t,moduleName:n,modulesDir:r,testImport:a=`vitest`}=e,o=e.pluralize??!1,s=S(t),c=x(t),l=[],u;if(e.outDir)u=N(e.outDir);else if(n){let e=S(n),t=o?pe(e):e;u=N(j(r??`src/modules`,t,`__tests__`))}else u=N(`src/__tests__`);let d=j(u,`${s}.test.ts`);return await i(d,`import { describe, it, expect, beforeEach } from '${a}'
301
301
  import { Container } from '@forinda/kickjs'
302
302
 
303
- describe('${s}', () => {
303
+ describe('${c}', () => {
304
304
  beforeEach(() => {
305
305
  Container.reset()
306
306
  })
@@ -320,52 +320,52 @@ describe('${s}', () => {
320
320
  expect(true).toBe(true)
321
321
  })
322
322
  })
323
- `),c.push(u),c}const en=[`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(`
324
- (dry run — no files were written)`),console.log()}async function tn(e){if(!e)try{let e=await T(process.cwd());await nt({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 nn=[{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`}],rn=/* @__PURE__ */ new Map([[`job`,`Queue processors are no longer built in — their shape belongs to whichever queue you run.
325
- Add your own in kick.config.ts: https://kickjs.app/guide/plugin-generators.html`]]),an=/* @__PURE__ */ new Set([...nn.map(e=>e.name.split(` `)[0]),...rn.keys()]);async function on(){console.log(`
323
+ `),l.push(d),l}const tn=[`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(`
324
+ (dry run — no files were written)`),console.log()}async function nn(e){if(!e)try{let e=await T(process.cwd());await rt({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 rn=[{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`}],an=/* @__PURE__ */ new Map([[`job`,`Queue processors are no longer built in — their shape belongs to whichever queue you run.
325
+ Add your own in kick.config.ts: https://kickjs.app/guide/plugin-generators.html`]]),on=/* @__PURE__ */ new Set([...rn.map(e=>e.name.split(` `)[0]),...an.keys()]);async function sn(){console.log(`
326
326
  Built-in generators:
327
- `);let e=Math.max(...nn.map(e=>e.name.length));for(let t of nn)console.log(` kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await T(process.cwd()),n=At(t?.plugins??[],t?.commands??[]),r=await fe(process.cwd(),n.generators);if(r.generators.length>0){console.log(`
327
+ `);let e=Math.max(...rn.map(e=>e.name.length));for(let t of rn)console.log(` kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await T(process.cwd()),n=jt(t?.plugins??[],t?.commands??[]),r=await fe(process.cwd(),n.generators);if(r.generators.length>0){console.log(`
328
328
  Plugin generators:
329
329
  `);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(`
330
330
  Failed to load:
331
- `);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}function sn(e,t){let n=e.parent?.opts()??{},r={...e.optsWithGlobals(),...t};for(let e of[`entity`,`tests`])n[e]===!1&&(r[e]=!1);for(let e of[`pluralize`,`pluralizeRoutes`])r[e]===void 0&&n[e]!==void 0&&(r[e]=n[e]);return r}async function cn(e,t,n){let r=await T(process.cwd()),i=C(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??xe(i.repo);t.repo&&De(t.repo);let s=t.pattern??r?.pattern??`rest`,c=w(t.pluralize,i),l=Ae(t.pluralizeRoutes,i),u=Ee(r,process.cwd()),d=Oe(E()),f=Te(E()),p=E(),m=we(p,`@forinda/kickjs-testing`,`any`)&&we(p,`supertest`,`any`),h=i.style??`define`;if(!n&&h===`define`){let e=await Kt(N(a),`define`);if(e.length>0){console.error(`\n ${g.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n ${g.dim(`Project setting:`)} modules.style: 'define' (default)\n\n ${g.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 ${g.bold(`Pick one:`)}\n 1. Migrate everything to defineModule:\n ${g.dim(`$`)} kick codemod modules --experimental --apply\n 2. Keep the class form — pin it in kick.config.ts:\n ${g.dim(`// kick.config.ts`)}\n ${g.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let _=[];for(let r of e){let e=await v({name:r,modulesDir:N(a),noEntity:t.entity===!1,noTests:t.tests===!1,repo:o,minimal:t.minimal,force:t.force,pattern:s,testHarness:m,dryRun:n,pluralize:c,pluralizeRoutes:l,tokenScope:u,swagger:d,schemaLib:f,style:i.style});_.push(...e)}W(_,n),await tn(n)}function ln(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(`--pluralize`,`Pluralize module folders and names (users/ for user)`).option(`--no-pluralize`,`Use names as typed (the default)`).option(`--pluralize-routes`,`Mount at the plural of the name (/users for user, the default)`).option(`--no-pluralize-routes`,`Mount at the name as typed (/user)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,i,a)=>{if(i.list){await on();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 T(process.cwd()),t=At(e?.plugins??[],e?.commands??[]),r=await oe({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`&&an.has(s)){let e=rn.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 cn(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(`--pluralize`,`Pluralize module folders and names (users/ for user)`).option(`--no-pluralize`,`Use names as typed (the default)`).option(`--pluralize-routes`,`Mount at the plural of the name (/users for user, the default)`).option(`--no-pluralize-routes`,`Mount at the name as typed (/user)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,n,r)=>{let i=U(r);t(i),await cn(e,sn(r,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 Ce({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 jt({name:e,outDir:N(n.out)}),i)}),r.command(`middleware <name>`).description(`Generate a global middleware function, typed for the configured runtime
331
+ `);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}function cn(e,t){let n=e.parent?.opts()??{},r={...e.optsWithGlobals(),...t};for(let e of[`entity`,`tests`])n[e]===!1&&(r[e]=!1);for(let e of[`pluralize`,`pluralizeRoutes`])r[e]===void 0&&n[e]!==void 0&&(r[e]=n[e]);return r}async function ln(e,t,n){let r=await T(process.cwd()),i=C(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??xe(i.repo);t.repo&&De(t.repo);let s=t.pattern??r?.pattern??`rest`,c=w(t.pluralize,i),l=je(t.pluralizeRoutes,i),u=Ee(r,process.cwd()),d=ke(E()),f=Te(E()),p=E(),m=we(p,`@forinda/kickjs-testing`,`any`)&&we(p,`supertest`,`any`),h=i.style??`define`;if(!n&&h===`define`){let e=await qt(N(a),`define`);if(e.length>0){console.error(`\n ${g.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n ${g.dim(`Project setting:`)} modules.style: 'define' (default)\n\n ${g.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 ${g.bold(`Pick one:`)}\n 1. Migrate everything to defineModule:\n ${g.dim(`$`)} kick codemod modules --experimental --apply\n 2. Keep the class form — pin it in kick.config.ts:\n ${g.dim(`// kick.config.ts`)}\n ${g.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let _=[];for(let r of e){let e=await v({name:r,modulesDir:N(a),noEntity:t.entity===!1,noTests:t.tests===!1,repo:o,minimal:t.minimal,force:t.force,pattern:s,testHarness:m,testImport:Oe(p),dryRun:n,pluralize:c,pluralizeRoutes:l,tokenScope:u,swagger:d,schemaLib:f,style:i.style});_.push(...e)}W(_,n),await nn(n)}function un(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(`--pluralize`,`Pluralize module folders and names (users/ for user)`).option(`--no-pluralize`,`Use names as typed (the default)`).option(`--pluralize-routes`,`Mount at the plural of the name (/users for user, the default)`).option(`--no-pluralize-routes`,`Mount at the name as typed (/user)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,i,a)=>{if(i.list){await sn();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 T(process.cwd()),t=jt(e?.plugins??[],e?.commands??[]),r=await oe({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`&&on.has(s)){let e=an.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 ln(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(`--pluralize`,`Pluralize module folders and names (users/ for user)`).option(`--no-pluralize`,`Use names as typed (the default)`).option(`--pluralize-routes`,`Mount at the plural of the name (/users for user, the default)`).option(`--no-pluralize-routes`,`Mount at the name as typed (/user)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,n,r)=>{let i=U(r);t(i),await ln(e,cn(r,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 Ce({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 Mt({name:e,outDir:N(n.out)}),i)}),r.command(`middleware <name>`).description(`Generate a global middleware function, typed for the configured runtime
332
332
  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 T(process.cwd()),o=C(a),s=o.dir??`src/modules`;W(await ae({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:w(void 0,o),runtime:a?.runtime}),i)}),r.command(`guard <name>`).description(`Generate a route guard (auth, roles, etc.)
333
333
  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 T(process.cwd()),o=C(a),s=o.dir??`src/modules`;W(await ue({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:w(void 0,o)}),i)}),r.command(`contributor <name>`).description(`Generate a Context Contributor (typed alternative to @Middleware for ctx.set)
334
334
  --type http (default, RequestContext) | bare (ExecutionContext)
335
335
  --params "source:string,region:number" → emits the withParams<T>() form
336
- 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 T(process.cwd()),s=C(o),c=s.dir??`src/modules`;W(await Nt({name:e,type:a,key:n.key,params:n.params,outDir:n.out,moduleName:n.module,modulesDir:c,pattern:o?.pattern,pluralize:w(void 0,s)}),i)}),r.command(`service <name>`).description(`Generate a @Service() class
336
+ 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 T(process.cwd()),s=C(o),c=s.dir??`src/modules`;W(await Pt({name:e,type:a,key:n.key,params:n.params,outDir:n.out,moduleName:n.module,modulesDir:c,pattern:o?.pattern,pluralize:w(void 0,s)}),i)}),r.command(`service <name>`).description(`Generate a @Service() class
337
337
  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 T(process.cwd()),o=C(a),s=o.dir??`src/modules`;W(await de({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:w(void 0,o)}),i)}),r.command(`controller <name>`).description(`Generate a @Controller() class with basic routes
338
- 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 T(process.cwd()),o=C(a),s=o.dir??`src/modules`;W(await ge({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:w(void 0,o)}),i),await tn(i)}),r.command(`dto <name>`).description(`Generate a DTO schema for the project’s validation library
338
+ 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 T(process.cwd()),o=C(a),s=o.dir??`src/modules`;W(await ge({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:w(void 0,o)}),i),await nn(i)}),r.command(`dto <name>`).description(`Generate a DTO schema for the project’s validation library
339
339
  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 T(process.cwd()),o=C(a),s=o.dir??`src/modules`;W(await _e({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:w(void 0,o),schemaLib:Te(E())}),i)}),r.command(`test <name>`).description(`Generate a Vitest test scaffold
340
- 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 T(process.cwd()),o=C(a),s=o.dir??`src/modules`;W(await $t({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pluralize:w(void 0,o)}),i)}),r.command(`scaffold <name> [fields...]`).description(`Generate a full CRUD module from field definitions
340
+ 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 T(process.cwd()),o=C(a),s=o.dir??`src/modules`;W(await en({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pluralize:w(void 0,o),testImport:Oe(E())}),i)}),r.command(`scaffold <name> [fields...]`).description(`Generate a full CRUD module from field definitions
341
341
  Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
342
342
  Types: string, text, number, int, float, boolean, date, email, url, uuid, json, enum:a,b,c
343
343
  Optional: append :optional (shell-safe): description:text:optional
344
- or use ? with quoting: "description:text?" or "description?:text"`).option(`--no-entity`,`Skip entity and value object generation`).option(`--no-tests`,`Skip test file generation`).option(`--pluralize`,`Pluralize module folders and names (users/ for user)`).option(`--no-pluralize`,`Use names as typed (the default)`).option(`--pluralize-routes`,`Mount at the plural of the name (/users for user, the default)`).option(`--no-pluralize-routes`,`Mount at the name as typed (/user)`).option(`--modules-dir <dir>`,`Modules directory`).action(async(e,n,r,i)=>{let a=sn(i,r),o=U(i);t(o),n.length===0&&(console.error(`
344
+ or use ? with quoting: "description:text?" or "description?:text"`).option(`--no-entity`,`Skip entity and value object generation`).option(`--no-tests`,`Skip test file generation`).option(`--pluralize`,`Pluralize module folders and names (users/ for user)`).option(`--no-pluralize`,`Use names as typed (the default)`).option(`--pluralize-routes`,`Mount at the plural of the name (/users for user, the default)`).option(`--no-pluralize-routes`,`Mount at the name as typed (/user)`).option(`--modules-dir <dir>`,`Modules directory`).action(async(e,n,r,i)=>{let a=cn(i,r),o=U(i);t(o),n.length===0&&(console.error(`
345
345
  Error: At least one field is required.
346
346
  Usage: kick g scaffold <name> <field:type> [field:type...]
347
347
  Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
348
348
  Optional: append :optional (shell-safe, no quoting needed)
349
- `),process.exit(1));let s=await T(process.cwd()),c=C(s),l=a.modulesDir??c.dir??`src/modules`,u=Jt(n),d=Ee(s,process.cwd()),f=Oe(E()),p=await Yt({name:e,fields:u,modulesDir:N(l),noEntity:a.entity===!1,noTests:a.tests===!1,pluralize:w(a.pluralize,c),pluralizeRoutes:Ae(a.pluralizeRoutes,c),tokenScope:d,swagger:f,style:c.style});console.log(`\n Scaffolded ${e} with ${u.length} field(s):`);for(let e of u)console.log(` ${e.name}: ${e.type}${e.optional?` (optional)`:``}`);W(p,o),await tn(o)}),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 Pt({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 (default: detected from kick.config, packageManager, or the lockfile)`).option(`--template <template>`,`Template: rest | minimal | fullstack | inertia`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,n)=>{let r=U(n);t(r);let i=e.only??`all`;en.includes(i)?W(await Re({outDir:N(`.`),only:i,name:e.name,pm:e.pm,template:e.template,force:e.force}),r):(console.error(` Invalid --only value: ${i}. Expected: ${en.join(` | `)}`),process.exitCode=1)});for(let e of n?.generators??[])un(r,e,n?.projectRoot)}function un(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 oe({generatorName:a.name,itemName:e??``,args:i??[],flags:o,cwd:process.cwd(),projectRoot:r},[n]);l&&W(l.files,c)})}const dn=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: `;async function fn(e){let t=k.resolve(e.cwd,`.kickjs/types`);e.check||await mt(t,{recursive:!0});let n=/* @__PURE__ */ new Map,r=e.scan??Je,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 mt(k.dirname(r),{recursive:!0}),await vt(r,n,`utf8`)},getScanResult:e=>{let t=pn(e),o=n.get(t);if(!o){let s={cacheDir:i,...e};o=a?qe(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=`${dn}${n.id} */\n\n`+a+`
350
- `,u=``;F(i)&&(u=await z(i,`utf8`)),u===l?s.push({id:n.id,status:`unchanged`,outFile:i}):e.check?(c.push({id:n.id,outFile:i}),s.push({id:n.id,status:`drifted`,outFile:i})):(await vt(i,l,`utf8`),s.push({id:n.id,status:`written`,outFile:i}))}if(c.length>0)throw new ye(c);return s}function pn(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 mn(e,t){let n=new Set(t),r=[],i=[],a=/* @__PURE__ */ new Set;for(let t of e)n.has(t.id)?(i.push(t),a.add(t.id)):r.push(t);return{enabled:r,skipped:i,unknown:[...n].filter(e=>!a.has(e))}}var hn=/* @__PURE__ */ e({applyDisableFilter:()=>mn,runAllPluginTypegens:()=>G});async function G(e){let{enabled:t,skipped:n,unknown:r}=mn(At([...va,...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 fn({cwd:e.cwd,config:e.config??{},plugins:t,watch:e.watch,check:e.check,changedFiles:e.changedFiles});if(!e.silent&&le())for(let e of n)console.log(` ${e.id}: ${e.status}`);return n}catch(t){if(t instanceof ye||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 gn(e){let t=process.platform===`win32`;for(let n of _n(e))for(let e of[`vue-tsc`,`tsgo`,`tsc`]){let r=t?[`${e}.CMD`,`${e}.cmd`,`${e}.exe`]:[e];for(let i of r){let r=j(n,i);if(F(r))return{cmd:r,args:[`--noEmit`],shell:t,kind:e}}}return null}function _n(e){let t=N(e),n=vn(t);return(n?[t,n]:[t]).map(e=>j(e,`node_modules`,`.bin`))}function vn(e){for(let t=A(e);t!==A(t);t=A(t)){let n=j(t,`pnpm-workspace.yaml`),r=j(t,`package.json`);if(F(n)||F(r))return yn(n,r).some(n=>bn(n,M(t,e)))?t:void 0}}function yn(e,t){try{if(F(e)){let t=I(e,`utf-8`).split(/^packages:\s*$/m)[1]??``,n=[];for(let e of t.split(`
351
- `)){if(!e.trim()||e.trim().startsWith(`#`))continue;let t=/^\s+-\s*['"]?([^'"#]+?)['"]?\s*$/.exec(e);if(!t)break;n.push(t[1])}return n}let{workspaces:n}=JSON.parse(I(t,`utf-8`)),r=Array.isArray(n)?n:n?.packages;return Array.isArray(r)?r.filter(e=>typeof e==`string`):[]}catch{return[]}}function bn(e,t){let n=e.replace(/^\.\//,``).replace(/\/+$/,``).split(`/`).map(e=>e===`**`?`.*`:e.replace(/[.+^${}()|[\]\\]/g,`\\$&`).replace(/\*/g,`[^/]*`)).join(`/`);return RegExp(`^${n}$`).test(t.split(P).join(`/`))}function xn(e){let t=e.spawnFn??bt,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 Sn(e,t=12){let n=e.trim().split(/\r?\n/);return n.length<=t?n.join(`
349
+ `),process.exit(1));let s=await T(process.cwd()),c=C(s),l=a.modulesDir??c.dir??`src/modules`,u=Yt(n),d=Ee(s,process.cwd()),f=ke(E()),p=await Xt({name:e,fields:u,modulesDir:N(l),noEntity:a.entity===!1,noTests:a.tests===!1,pluralize:w(a.pluralize,c),pluralizeRoutes:je(a.pluralizeRoutes,c),tokenScope:d,swagger:f,style:c.style});console.log(`\n Scaffolded ${e} with ${u.length} field(s):`);for(let e of u)console.log(` ${e.name}: ${e.type}${e.optional?` (optional)`:``}`);W(p,o),await nn(o)}),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 Ft({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 (default: detected from kick.config, packageManager, or the lockfile)`).option(`--template <template>`,`Template: rest | minimal | fullstack | inertia`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,n)=>{let r=U(n);t(r);let i=e.only??`all`;tn.includes(i)?W(await ze({outDir:N(`.`),only:i,name:e.name,pm:e.pm,template:e.template,force:e.force}),r):(console.error(` Invalid --only value: ${i}. Expected: ${tn.join(` | `)}`),process.exitCode=1)});for(let e of n?.generators??[])dn(r,e,n?.projectRoot)}function dn(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 oe({generatorName:a.name,itemName:e??``,args:i??[],flags:o,cwd:process.cwd(),projectRoot:r},[n]);l&&W(l.files,c)})}const fn=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: `;async function pn(e){let t=k.resolve(e.cwd,`.kickjs/types`);e.check||await ht(t,{recursive:!0});let n=/* @__PURE__ */ new Map,r=e.scan??Ye,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 ht(k.dirname(r),{recursive:!0}),await yt(r,n,`utf8`)},getScanResult:e=>{let t=mn(e),o=n.get(t);if(!o){let s={cacheDir:i,...e};o=a?Je(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=`${fn}${n.id} */\n\n`+a+`
350
+ `,u=``;F(i)&&(u=await z(i,`utf8`)),u===l?s.push({id:n.id,status:`unchanged`,outFile:i}):e.check?(c.push({id:n.id,outFile:i}),s.push({id:n.id,status:`drifted`,outFile:i})):(await yt(i,l,`utf8`),s.push({id:n.id,status:`written`,outFile:i}))}if(c.length>0)throw new ye(c);return s}function mn(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 hn(e,t){let n=new Set(t),r=[],i=[],a=/* @__PURE__ */ new Set;for(let t of e)n.has(t.id)?(i.push(t),a.add(t.id)):r.push(t);return{enabled:r,skipped:i,unknown:[...n].filter(e=>!a.has(e))}}var gn=/* @__PURE__ */ e({applyDisableFilter:()=>hn,runAllPluginTypegens:()=>G});async function G(e){let{enabled:t,skipped:n,unknown:r}=hn(jt([...ya,...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 pn({cwd:e.cwd,config:e.config??{},plugins:t,watch:e.watch,check:e.check,changedFiles:e.changedFiles});if(!e.silent&&le())for(let e of n)console.log(` ${e.id}: ${e.status}`);return n}catch(t){if(t instanceof ye||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 _n(e){let t=process.platform===`win32`;for(let n of vn(e))for(let e of[`vue-tsc`,`tsgo`,`tsc`]){let r=t?[`${e}.CMD`,`${e}.cmd`,`${e}.exe`]:[e];for(let i of r){let r=j(n,i);if(F(r))return{cmd:r,args:[`--noEmit`],shell:t,kind:e}}}return null}function vn(e){let t=N(e),n=yn(t);return(n?[t,n]:[t]).map(e=>j(e,`node_modules`,`.bin`))}function yn(e){for(let t=A(e);t!==A(t);t=A(t)){let n=j(t,`pnpm-workspace.yaml`),r=j(t,`package.json`);if(F(n)||F(r))return bn(n,r).some(n=>xn(n,M(t,e)))?t:void 0}}function bn(e,t){try{if(F(e)){let t=I(e,`utf-8`).split(/^packages:\s*$/m)[1]??``,n=[];for(let e of t.split(`
351
+ `)){if(!e.trim()||e.trim().startsWith(`#`))continue;let t=/^\s+-\s*['"]?([^'"#]+?)['"]?\s*$/.exec(e);if(!t)break;n.push(t[1])}return n}let{workspaces:n}=JSON.parse(I(t,`utf-8`)),r=Array.isArray(n)?n:n?.packages;return Array.isArray(r)?r.filter(e=>typeof e==`string`):[]}catch{return[]}}function xn(e,t){let n=e.replace(/^\.\//,``).replace(/\/+$/,``).split(`/`).map(e=>e===`**`?`.*`:e.replace(/[.+^${}()|[\]\\]/g,`\\$&`).replace(/\*/g,`[^/]*`)).join(`/`);return RegExp(`^${n}$`).test(t.split(P).join(`/`))}function Sn(e){let t=e.spawnFn??xt,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 Cn(e,t=12){let n=e.trim().split(/\r?\n/);return n.length<=t?n.join(`
352
352
  `):`${n.slice(0,t).join(`
353
- `)}\n… ${n.length-t} more line(s)`}function Cn(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function wn(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 Tn(e,t,n={}){t&&(process.env.PORT=t);let r=Cn(n.polling),i=process.cwd(),a=await T(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await nt({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 Ye(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[ce]=`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=gn(i);e?m=xn({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(Sn(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=he({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(`
353
+ `)}\n… ${n.length-t} more line(s)`}function wn(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function Tn(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 En(e,t,n={}){t&&(process.env.PORT=t);let r=wn(n.polling),i=process.cwd(),a=await T(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await rt({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 Xe(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[ce]=`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=_n(i);e?m=Sn({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(Cn(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=he({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(`
354
354
  KickJS dev server running (Vite + @forinda/kickjs-vite)
355
- `),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 En(e){let t=await T(e);try{await nt({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 Ye(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 Dn(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 Tn(e.entry,e.port,{polling:e.polling,typecheck:e.typecheck})}catch(e){e.code===`ERR_MODULE_NOT_FOUND`&&e.message?.includes(`vite`)?console.error(`\n Error: vite is not installed.\n Run: ${a()} add -D vite unplugin-swc\n`):console.error(`
355
+ `),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 Dn(e){let t=await T(e);try{await rt({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 Xe(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 On(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 En(e.entry,e.port,{polling:e.polling,typecheck:e.typecheck})}catch(e){e.code===`ERR_MODULE_NOT_FOUND`&&e.message?.includes(`vite`)?console.error(`\n Error: vite is not installed.\n Run: ${a()} add -D vite unplugin-swc\n`):console.error(`
356
356
  Dev server failed:`,e.message??e),process.exit(1)}}),e.command(`build`).description(`Build for production via Vite`).action(async()=>{console.log(`
357
357
  Building for production...
358
358
  `);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 T(process.cwd()),i=r?.copyDirs??[];if(i.length>0){console.log(`
359
- 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);F(r)?(ut(i,{recursive:!0}),lt(r,i,{recursive:!0}),console.log(` ✓ ${t} → ${n}`)):console.log(` ⚠ Skipped ${t} (not found)`)}}if(r?.assetMap&&Object.keys(r.assetMap).length>0){console.log(`
360
- Building asset map...`);try{await Le(r,{cwd:process.cwd()})}catch(e){console.error(` ✗ asset build failed: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}console.log(`
359
+ 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);F(r)?(dt(i,{recursive:!0}),ut(r,i,{recursive:!0}),console.log(` ✓ ${t} → ${n}`)):console.log(` ⚠ Skipped ${t} (not found)`)}}if(r?.assetMap&&Object.keys(r.assetMap).length>0){console.log(`
360
+ Building asset map...`);try{await Re(r,{cwd:process.cwd()})}catch(e){console.error(` ✗ asset build failed: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}console.log(`
361
361
  Build complete.
362
362
  `)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await T(process.cwd());if(!e?.assetMap||Object.keys(e.assetMap).length===0)console.log(` No assetMap entries — nothing to build.`);else{console.log(`
363
- Building asset map...`);try{await Le(e,{cwd:process.cwd()}),console.log(`
363
+ Building asset map...`);try{await Re(e,{cwd:process.cwd()}),console.log(`
364
364
  Asset build complete.
365
- `)}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)),Fe(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 En(t);let n=gn(t);if(!n){console.error(`
366
- No type-checker found. Install one in this project:\n ${a(t)} add -D typescript (tsc)\n ${a(t)} add -D @typescript/native-preview (tsgo, faster)\n`),process.exit(1);return}let r=xt(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 wn(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 Tn(e.entry,e.port)}catch(e){console.error(`
367
- Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function On(){try{let e=A(Ct(import.meta.url));return JSON.parse(I(j(e,`..`,`package.json`),`utf-8`)).version??`unknown`}catch{return`unknown`}}const kn=new Set(Object.values(Me).filter(e=>e.deprecated).map(e=>e.pkg));function An(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:kn.has(t)}})}function jn(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 Mn(e){e.command(`info`).description(`Print system and framework info`).action(()=>{let e=[``,` KickJS CLI v${On()}`,``,` System:`,` OS: ${Et()} ${Dt()} (${Tt()})`,` Node: ${process.version}`],t=jn(process.cwd()),n=t?An(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(`
368
- `))})}const{bold:K,dim:q,green:Nn,red:Pn,yellow:Fn,blue:In}=g;function Ln(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 Rn(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 Rn(`${e}${t}`)}catch{return null}}async function zn(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 Bn(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`?Nn(`● healthy`):Pn(`● `+n.status);console.log(` ${K(`Health:`)} ${e}`)}else console.log(` ${K(`Health:`)} ${Pn(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?Pn:r.errorRate>0?Fn:Nn;console.log(` ${K(`Uptime:`)} ${Ln(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(` ${u(e.method)} ${t} ${In(e.controller)}.${q(e.handler)}`)}}console.log(s),console.log()}function Vn(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 zn(r);t.json?console.log(JSON.stringify(e,null,2)):Bn(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(Pn(` ✖ 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 Hn=[{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
365
+ `)}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)),Ie(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 Dn(t);let n=_n(t);if(!n){console.error(`
366
+ No type-checker found. Install one in this project:\n ${a(t)} add -D typescript (tsc)\n ${a(t)} add -D @typescript/native-preview (tsgo, faster)\n`),process.exit(1);return}let r=St(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 Tn(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 En(e.entry,e.port)}catch(e){console.error(`
367
+ Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function kn(){try{let e=A(wt(import.meta.url));return JSON.parse(I(j(e,`..`,`package.json`),`utf-8`)).version??`unknown`}catch{return`unknown`}}const An=new Set(Object.values(Ne).filter(e=>e.deprecated).map(e=>e.pkg));function jn(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:An.has(t)}})}function Mn(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 Nn(e){e.command(`info`).description(`Print system and framework info`).action(()=>{let e=[``,` KickJS CLI v${kn()}`,``,` System:`,` OS: ${Dt()} ${Ot()} (${Et()})`,` Node: ${process.version}`],t=Mn(process.cwd()),n=t?jn(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(`
368
+ `))})}const{bold:K,dim:q,green:Pn,red:Fn,yellow:In,blue:Ln}=g;function Rn(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 zn(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 zn(`${e}${t}`)}catch{return null}}async function Bn(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 Vn(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`?Pn(`● healthy`):Fn(`● `+n.status);console.log(` ${K(`Health:`)} ${e}`)}else console.log(` ${K(`Health:`)} ${Fn(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?Fn:r.errorRate>0?In:Pn;console.log(` ${K(`Uptime:`)} ${Rn(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(` ${u(e.method)} ${t} ${Ln(e.controller)}.${q(e.handler)}`)}}console.log(s),console.log()}function Hn(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 Bn(r);t.json?console.log(JSON.stringify(e,null,2)):Vn(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(Fn(` ✖ 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 Un=[{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
369
369
  src/config/index.ts, and src/index.ts imports it before bootstrap().
370
370
  Tests never load src/index.ts — \`createTestApp\` builds the app
371
371
  directly — so that import does not run and ConfigService falls back to
@@ -580,23 +580,23 @@ import { bootstrap } from '@forinda/kickjs'
580
580
  await bootstrap({ modules }) // ← nothing for the dev server to read`,codeAfter:`import './env'
581
581
  import { bootstrap } from '@forinda/kickjs'
582
582
 
583
- export const app = await bootstrap({ modules })`,docs:`https://kickjs.app/guide/project-structure.html`}}}}];function Un(e,t){let n=null;for(let r of Hn){let i=null;try{i=r.match(e,t)}catch{continue}!i||i.confidence<40||(!n||i.confidence>n.confidence)&&(n=i)}return n}async function Wn(e){let t=e.provider??`openai`,n=process.env.OPENAI_API_KEY;if(t===`openai`&&!n)return{kind:`unavailable`,reason:`OPENAI_API_KEY environment variable is not set`,suggestion:`Set OPENAI_API_KEY in your shell, e.g.
583
+ export const app = await bootstrap({ modules })`,docs:`https://kickjs.app/guide/project-structure.html`}}}}];function Wn(e,t){let n=null;for(let r of Un){let i=null;try{i=r.match(e,t)}catch{continue}!i||i.confidence<40||(!n||i.confidence>n.confidence)&&(n=i)}return n}async function Gn(e){let t=e.provider??`openai`,n=process.env.OPENAI_API_KEY;if(t===`openai`&&!n)return{kind:`unavailable`,reason:`OPENAI_API_KEY environment variable is not set`,suggestion:`Set OPENAI_API_KEY in your shell, e.g.
584
584
  export OPENAI_API_KEY="sk-..."
585
585
 
586
586
  Then re-run \`kick explain --ai "<your error>"\`.`};let r;try{r=await import(`@forinda/kickjs-ai`)}catch{return{kind:`unavailable`,reason:`@forinda/kickjs-ai is not installed`,suggestion:`Install the AI package to enable the LLM fallback:
587
587
  kick add ai
588
588
 
589
589
  Or manually:
590
- ${a()} add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,o=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),s=Gn(e.cwd),c=`Error or stack trace:\n\n${e.input.trim()}`;try{let e=Kn((await o.chat({messages:[{role:`system`,content:s},{role:`user`,content:c}]})).content);return e?{kind:`ok`,diagnosis:e}:{kind:`error`,message:`The LLM responded but the payload was not valid JSON in the expected shape. Try again, or file an issue with the error text.`}}catch(e){return{kind:`error`,message:`LLM request failed: ${e instanceof Error?e.message:String(e)}`}}}function Gn(e){return[`You are a diagnostic assistant for KickJS, a decorator-driven Node.js`,`framework built on Express 5 and TypeScript. KickJS projects use:`,` - @Controller, @Get, @Post, @Autowired, @Service, @Value decorators`,` - An AppModule interface with a routes() method (NOT a @Module decorator)`,` - Zod schemas as both runtime validators and OpenAPI sources`,` - Ctx<KickRoutes.ControllerName['method']> for typed request context`,` - src/config/index.ts with defineEnv/loadEnv for env schema`,' - A side-effect `import "./config"` in src/index.ts to register the schema',` - Container.reset() in beforeEach for DI test isolation`,``,`When the user gives you an error message or stack trace, produce a`,`structured diagnosis that helps them fix the bug. You MUST respond`,`with a single JSON object (no surrounding prose, no markdown fences)`,`matching this shape:`,``,`{`,` "id": "<kebab-case-identifier>",`,` "title": "<one-line problem summary>",`,` "explanation": "<multi-line explanation of what is wrong>",`,` "fix": "<multi-line instructions for fixing the problem>",`,` "codeBefore": "<optional: broken code snippet>",`,` "codeAfter": "<optional: corrected code snippet>",`,` "docs": "<optional: KickJS doc URL that discusses this topic>"`,`}`,``,`The KickJS docs live at https://kickjs.app/ — prefer`,`that domain for any doc links you suggest.`,e?`The project is located at ${e}.`:``].filter(e=>e.length>0).join(`
591
- `)}function Kn(e){let t=[e,qn(e),Jn(e)].filter(e=>e!==null);for(let e of t)try{let t=JSON.parse(e);if(Yn(t))return t}catch{continue}return null}function qn(e){let t=e.match(/```(?:json)?\s*\n([\s\S]*?)```/);return t?t[1]?.trim()??null:null}function Jn(e){let t=e.indexOf(`{`);if(t===-1)return null;let n=0,r=!1,i=!1;for(let a=t;a<e.length;a++){let o=e[a];if(i)i=!1;else if(o===`\\`&&r)i=!0;else if(o===`"`)r=!r;else if(!r&&(o===`{`&&n++,o===`}`&&(n--,n===0)))return e.slice(t,a+1)}return null}function Yn(e){if(typeof e!=`object`||!e)return!1;let t=e;return typeof t.id==`string`&&typeof t.title==`string`&&typeof t.explanation==`string`&&typeof t.fix==`string`}function Xn(e){e.command(`explain [message]`).description(`Explain a KickJS error and suggest a fix`).option(`-m, --message <text>`,`Error message to explain (alternative to positional arg)`).option(`--ai`,`Fall back to LLM if no known-issue matches (requires @forinda/kickjs-ai)`).option(`--model <name>`,`Model name for the --ai fallback`,`gpt-4o-mini`).option(`--json`,`Output the diagnosis as JSON for tooling integration`).action(async(e,t)=>{let n=await $n(e,t.message);(!n||n.trim().length===0)&&(process.stderr.write(`Error: no input provided.
590
+ ${a()} add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,o=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),s=Kn(e.cwd),c=`Error or stack trace:\n\n${e.input.trim()}`;try{let e=qn((await o.chat({messages:[{role:`system`,content:s},{role:`user`,content:c}]})).content);return e?{kind:`ok`,diagnosis:e}:{kind:`error`,message:`The LLM responded but the payload was not valid JSON in the expected shape. Try again, or file an issue with the error text.`}}catch(e){return{kind:`error`,message:`LLM request failed: ${e instanceof Error?e.message:String(e)}`}}}function Kn(e){return[`You are a diagnostic assistant for KickJS, a decorator-driven Node.js`,`framework built on Express 5 and TypeScript. KickJS projects use:`,` - @Controller, @Get, @Post, @Autowired, @Service, @Value decorators`,` - An AppModule interface with a routes() method (NOT a @Module decorator)`,` - Zod schemas as both runtime validators and OpenAPI sources`,` - Ctx<KickRoutes.ControllerName['method']> for typed request context`,` - src/config/index.ts with defineEnv/loadEnv for env schema`,' - A side-effect `import "./config"` in src/index.ts to register the schema',` - Container.reset() in beforeEach for DI test isolation`,``,`When the user gives you an error message or stack trace, produce a`,`structured diagnosis that helps them fix the bug. You MUST respond`,`with a single JSON object (no surrounding prose, no markdown fences)`,`matching this shape:`,``,`{`,` "id": "<kebab-case-identifier>",`,` "title": "<one-line problem summary>",`,` "explanation": "<multi-line explanation of what is wrong>",`,` "fix": "<multi-line instructions for fixing the problem>",`,` "codeBefore": "<optional: broken code snippet>",`,` "codeAfter": "<optional: corrected code snippet>",`,` "docs": "<optional: KickJS doc URL that discusses this topic>"`,`}`,``,`The KickJS docs live at https://kickjs.app/ — prefer`,`that domain for any doc links you suggest.`,e?`The project is located at ${e}.`:``].filter(e=>e.length>0).join(`
591
+ `)}function qn(e){let t=[e,Jn(e),Yn(e)].filter(e=>e!==null);for(let e of t)try{let t=JSON.parse(e);if(Xn(t))return t}catch{continue}return null}function Jn(e){let t=e.match(/```(?:json)?\s*\n([\s\S]*?)```/);return t?t[1]?.trim()??null:null}function Yn(e){let t=e.indexOf(`{`);if(t===-1)return null;let n=0,r=!1,i=!1;for(let a=t;a<e.length;a++){let o=e[a];if(i)i=!1;else if(o===`\\`&&r)i=!0;else if(o===`"`)r=!r;else if(!r&&(o===`{`&&n++,o===`}`&&(n--,n===0)))return e.slice(t,a+1)}return null}function Xn(e){if(typeof e!=`object`||!e)return!1;let t=e;return typeof t.id==`string`&&typeof t.title==`string`&&typeof t.explanation==`string`&&typeof t.fix==`string`}function Zn(e){e.command(`explain [message]`).description(`Explain a KickJS error and suggest a fix`).option(`-m, --message <text>`,`Error message to explain (alternative to positional arg)`).option(`--ai`,`Fall back to LLM if no known-issue matches (requires @forinda/kickjs-ai)`).option(`--model <name>`,`Model name for the --ai fallback`,`gpt-4o-mini`).option(`--json`,`Output the diagnosis as JSON for tooling integration`).action(async(e,t)=>{let n=await er(e,t.message);(!n||n.trim().length===0)&&(process.stderr.write(`Error: no input provided.
592
592
 
593
593
  Pass a message as a positional arg, --message flag, or pipe via stdin:
594
594
  kick explain "config.get returned undefined"
595
- ${ke(a(),`test`)} 2>&1 | kick explain\n`),process.exit(1));let r=tr(),i=Un(n,r);if(t.json&&i){process.stdout.write(JSON.stringify({matched:!0,...i},null,2)+`
596
- `);return}if(i){nr(n,i.diagnosis,i.confidence);return}t.ai||(t.json&&(process.stdout.write(JSON.stringify({matched:!1},null,2)+`
597
- `),process.exit(2)),rr(n),process.exit(2));let o=await Wn({input:n,model:t.model,cwd:r.cwd});t.json&&(process.stdout.write(JSON.stringify(Zn(o),null,2)+`
598
- `),process.exit(o.kind===`ok`?0:2)),Qn(n,o),process.exit(o.kind===`ok`?0:2)})}function Zn(e){return e.kind===`ok`?{matched:!0,source:`ai`,diagnosis:e.diagnosis}:e.kind===`unavailable`?{matched:!1,aiUnavailable:!0,reason:e.reason}:{matched:!1,aiError:!0,error:e.message}}function Qn(e,t){t.kind===`ok`?nr(e,t.diagnosis,-1,!0):t.kind===`unavailable`?(process.stdout.write(`\n Explaining: ${ir(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback unavailable: ${t.reason}\n\n`),process.stdout.write(`${Z(t.suggestion,` `)}\n\n`)):(process.stdout.write(`\n Explaining: ${ir(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback error: ${t.message}\n\n`))}async function $n(e,t){return e&&e.trim().length>0?e:t&&t.trim().length>0?t:process.stdin.isTTY?``:er()}function er(){return new Promise((e,t)=>{let n=``;process.stdin.setEncoding(`utf8`),process.stdin.on(`data`,e=>{n+=e}),process.stdin.on(`end`,()=>e(n)),process.stdin.on(`error`,t)})}function tr(){let e=process.cwd();return{cwd:e,hasFile:t=>F(N(e,t))}}function nr(e,t,n,r=!1){let i=ir(e.trim(),200),a=r?`AI-generated — verify before applying`:ar(n);process.stdout.write(`\n Explaining: ${i}\n`),process.stdout.write(`\n Match: ${t.id} (${a})\n`),process.stdout.write(` Title: ${t.title}\n`),process.stdout.write(`\n Diagnosis:\n${Z(t.explanation,` `)}\n`),process.stdout.write(`\n Fix:\n${Z(t.fix,` `)}\n`),t.codeBefore&&process.stdout.write(`\n Before:\n${Z(t.codeBefore,` `)}\n`),t.codeAfter&&process.stdout.write(`\n After:\n${Z(t.codeAfter,` `)}\n`),t.docs&&process.stdout.write(`\n Docs: ${t.docs}\n`),process.stdout.write(`
599
- `)}function rr(e){let t=ir(e.trim(),200);process.stdout.write(`\n Explaining: ${t}\n\n`),process.stdout.write(` No known-issue matched. Things you can try:
595
+ ${Ae(a(),`test`)} 2>&1 | kick explain\n`),process.exit(1));let r=nr(),i=Wn(n,r);if(t.json&&i){process.stdout.write(JSON.stringify({matched:!0,...i},null,2)+`
596
+ `);return}if(i){rr(n,i.diagnosis,i.confidence);return}t.ai||(t.json&&(process.stdout.write(JSON.stringify({matched:!1},null,2)+`
597
+ `),process.exit(2)),ir(n),process.exit(2));let o=await Gn({input:n,model:t.model,cwd:r.cwd});t.json&&(process.stdout.write(JSON.stringify(Qn(o),null,2)+`
598
+ `),process.exit(o.kind===`ok`?0:2)),$n(n,o),process.exit(o.kind===`ok`?0:2)})}function Qn(e){return e.kind===`ok`?{matched:!0,source:`ai`,diagnosis:e.diagnosis}:e.kind===`unavailable`?{matched:!1,aiUnavailable:!0,reason:e.reason}:{matched:!1,aiError:!0,error:e.message}}function $n(e,t){t.kind===`ok`?rr(e,t.diagnosis,-1,!0):t.kind===`unavailable`?(process.stdout.write(`\n Explaining: ${ar(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback unavailable: ${t.reason}\n\n`),process.stdout.write(`${Z(t.suggestion,` `)}\n\n`)):(process.stdout.write(`\n Explaining: ${ar(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback error: ${t.message}\n\n`))}async function er(e,t){return e&&e.trim().length>0?e:t&&t.trim().length>0?t:process.stdin.isTTY?``:tr()}function tr(){return new Promise((e,t)=>{let n=``;process.stdin.setEncoding(`utf8`),process.stdin.on(`data`,e=>{n+=e}),process.stdin.on(`end`,()=>e(n)),process.stdin.on(`error`,t)})}function nr(){let e=process.cwd();return{cwd:e,hasFile:t=>F(N(e,t))}}function rr(e,t,n,r=!1){let i=ar(e.trim(),200),a=r?`AI-generated — verify before applying`:or(n);process.stdout.write(`\n Explaining: ${i}\n`),process.stdout.write(`\n Match: ${t.id} (${a})\n`),process.stdout.write(` Title: ${t.title}\n`),process.stdout.write(`\n Diagnosis:\n${Z(t.explanation,` `)}\n`),process.stdout.write(`\n Fix:\n${Z(t.fix,` `)}\n`),t.codeBefore&&process.stdout.write(`\n Before:\n${Z(t.codeBefore,` `)}\n`),t.codeAfter&&process.stdout.write(`\n After:\n${Z(t.codeAfter,` `)}\n`),t.docs&&process.stdout.write(`\n Docs: ${t.docs}\n`),process.stdout.write(`
599
+ `)}function ir(e){let t=ar(e.trim(),200);process.stdout.write(`\n Explaining: ${t}\n\n`),process.stdout.write(` No known-issue matched. Things you can try:
600
600
 
601
601
  1. Check the framework docs for the error keywords:
602
602
  https://kickjs.app/
@@ -610,8 +610,8 @@ Pass a message as a positional arg, --message flag, or pipe via stdin:
610
610
 
611
611
  `)}function Z(e,t){return e.split(`
612
612
  `).map(e=>`${t}${e}`).join(`
613
- `)}function ir(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function ar(e){return e>=90?`high confidence`:e>=70?`good match`:e>=50?`medium confidence`:`low confidence — verify manually`}function or(e){let t=e.command(`mcp`).description(`Model Context Protocol commands (start | init)`);t.command(`start`,{isDefault:!0}).description(`Run the built application as an MCP server over stdio`).option(`-e, --entry <file>`,`Entry file`,`dist/index.js`).option(`--node-arg <arg...>`,`Extra arguments to pass to node`).action(sr),t.command(`init`).description(`Generate .mcp.json for Claude Code / Cursor / Zed`).option(`-n, --name <name>`,`Server name (defaults to package.json name)`).option(`-o, --out <file>`,`Output file`,`.mcp.json`).option(`-f, --force`,`Overwrite an existing entry without prompting`).option(`--global`,`Write to ~/.mcp.json instead of the project root`).action(cr)}function sr(e){let t=N(e.entry);F(t)||(process.stderr.write(`Error: entry file not found: ${t}\n\nBuild the app first with \`kick build\`, or pass a custom entry:\n kick mcp -e dist/server.js\n`),process.exit(1));let n=[...e.nodeArg??[],t],r=bt(process.execPath,n,{stdio:`inherit`,env:{...process.env,KICK_MCP_STDIO:`1`,NODE_ENV:process.env.NODE_ENV??`production`}});r.on(`error`,e=>{process.stderr.write(`Failed to start MCP server: ${e.message}\n`),process.exit(1)}),r.on(`exit`,(e,t)=>{t?process.kill(process.pid,t):process.exit(e??0)});let i=e=>{r.killed||r.kill(e)};process.on(`SIGINT`,()=>i(`SIGINT`)),process.on(`SIGTERM`,()=>i(`SIGTERM`))}function cr(e){let t=process.cwd(),n=lr(t)??ct(t),r=e.name??n,i=e.global?N(process.env.HOME??`.`,`.mcp.json`):N(t,e.out),a={command:`kick`,args:[`mcp`],cwd:t},o={mcpServers:{}};if(F(i))try{let e=I(i,`utf8`),t=JSON.parse(e);t&&typeof t==`object`&&t.mcpServers&&(o={mcpServers:{...t.mcpServers}})}catch(e){let t=e instanceof Error?e.message:String(e);process.stderr.write(`Error: existing ${i} is not valid JSON (${t}).\nFix the file or pass --force to overwrite the entry.\n`),process.exit(1)}o.mcpServers[r]&&!e.force&&(process.stderr.write(`Error: an entry for "${r}" already exists in ${i}.\nPass --force to overwrite it, or use --name to pick a different key.\n`),process.exit(1)),o.mcpServers[r]=a,R(i,JSON.stringify(o,null,2)+`
614
- `,`utf8`),process.stdout.write(`\n ✓ Wrote MCP server entry "${r}" to ${i}\n\n To activate it:\n 1. Build your app: kick build\n 2. Restart your MCP client (Claude Code, Cursor, Zed)\n 3. The server should appear in the client's tool picker\n\n`)}function lr(e){let t=N(e,`package.json`);if(!F(t))return null;try{let e=I(t,`utf8`),n=JSON.parse(e);return typeof n.name==`string`?n.name:null}catch{return null}}function ur(e){e.command(`tinker`).description(`Interactive REPL with DI container and services loaded`).option(`-e, --entry <file>`,`Entry file to load`,`src/index.ts`).action(async e=>{let t=process.cwd(),n=N(t,e.entry);F(n)||(console.error(`\n Error: ${e.entry} not found.\n`),process.exit(1));let r=fr(t,`tsx`);r||(console.error(`\n Error: tsx not found. Install it: ${a(t)} add -D tsx\n`),process.exit(1));let i=dr(n,e.entry),o=j(t,`.kick-tinker.mjs`),{writeFileSync:s,unlinkSync:c}=await import(`node:fs`);s(o,i,`utf-8`);try{let e=yt(o,[],{cwd:t,execPath:r,stdio:`inherit`});await new Promise(t=>{e.on(`exit`,()=>t())})}finally{try{c(o)}catch{}}})}function dr(e,t){return`
613
+ `)}function ar(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function or(e){return e>=90?`high confidence`:e>=70?`good match`:e>=50?`medium confidence`:`low confidence — verify manually`}function sr(e){let t=e.command(`mcp`).description(`Model Context Protocol commands (start | init)`);t.command(`start`,{isDefault:!0}).description(`Run the built application as an MCP server over stdio`).option(`-e, --entry <file>`,`Entry file`,`dist/index.js`).option(`--node-arg <arg...>`,`Extra arguments to pass to node`).action(cr),t.command(`init`).description(`Generate .mcp.json for Claude Code / Cursor / Zed`).option(`-n, --name <name>`,`Server name (defaults to package.json name)`).option(`-o, --out <file>`,`Output file`,`.mcp.json`).option(`-f, --force`,`Overwrite an existing entry without prompting`).option(`--global`,`Write to ~/.mcp.json instead of the project root`).action(lr)}function cr(e){let t=N(e.entry);F(t)||(process.stderr.write(`Error: entry file not found: ${t}\n\nBuild the app first with \`kick build\`, or pass a custom entry:\n kick mcp -e dist/server.js\n`),process.exit(1));let n=[...e.nodeArg??[],t],r=xt(process.execPath,n,{stdio:`inherit`,env:{...process.env,KICK_MCP_STDIO:`1`,NODE_ENV:process.env.NODE_ENV??`production`}});r.on(`error`,e=>{process.stderr.write(`Failed to start MCP server: ${e.message}\n`),process.exit(1)}),r.on(`exit`,(e,t)=>{t?process.kill(process.pid,t):process.exit(e??0)});let i=e=>{r.killed||r.kill(e)};process.on(`SIGINT`,()=>i(`SIGINT`)),process.on(`SIGTERM`,()=>i(`SIGTERM`))}function lr(e){let t=process.cwd(),n=ur(t)??lt(t),r=e.name??n,i=e.global?N(process.env.HOME??`.`,`.mcp.json`):N(t,e.out),a={command:`kick`,args:[`mcp`],cwd:t},o={mcpServers:{}};if(F(i))try{let e=I(i,`utf8`),t=JSON.parse(e);t&&typeof t==`object`&&t.mcpServers&&(o={mcpServers:{...t.mcpServers}})}catch(e){let t=e instanceof Error?e.message:String(e);process.stderr.write(`Error: existing ${i} is not valid JSON (${t}).\nFix the file or pass --force to overwrite the entry.\n`),process.exit(1)}o.mcpServers[r]&&!e.force&&(process.stderr.write(`Error: an entry for "${r}" already exists in ${i}.\nPass --force to overwrite it, or use --name to pick a different key.\n`),process.exit(1)),o.mcpServers[r]=a,R(i,JSON.stringify(o,null,2)+`
614
+ `,`utf8`),process.stdout.write(`\n ✓ Wrote MCP server entry "${r}" to ${i}\n\n To activate it:\n 1. Build your app: kick build\n 2. Restart your MCP client (Claude Code, Cursor, Zed)\n 3. The server should appear in the client's tool picker\n\n`)}function ur(e){let t=N(e,`package.json`);if(!F(t))return null;try{let e=I(t,`utf8`),n=JSON.parse(e);return typeof n.name==`string`?n.name:null}catch{return null}}function dr(e){e.command(`tinker`).description(`Interactive REPL with DI container and services loaded`).option(`-e, --entry <file>`,`Entry file to load`,`src/index.ts`).action(async e=>{let t=process.cwd(),n=N(t,e.entry);F(n)||(console.error(`\n Error: ${e.entry} not found.\n`),process.exit(1));let r=pr(t,`tsx`);r||(console.error(`\n Error: tsx not found. Install it: ${a(t)} add -D tsx\n`),process.exit(1));let i=fr(n,e.entry),o=j(t,`.kick-tinker.mjs`),{writeFileSync:s,unlinkSync:c}=await import(`node:fs`);s(o,i,`utf-8`);try{let e=bt(o,[],{cwd:t,execPath:r,stdio:`inherit`});await new Promise(t=>{e.on(`exit`,()=>t())})}finally{try{c(o)}catch{}}})}function fr(e,t){return`
615
615
  import 'reflect-metadata'
616
616
 
617
617
  // Prevent bootstrap() from starting the HTTP server
@@ -665,46 +665,46 @@ server.on('exit', () => {
665
665
  console.log('\\n Goodbye!\\n')
666
666
  process.exit(0)
667
667
  })
668
- `}function fr(e,t){for(let n of _n(e)){let e=j(n,t);if(F(e))return e}return null}function pr(e,t){let n=RegExp(`^\\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]!==`
668
+ `}function pr(e,t){for(let n of vn(e)){let e=j(n,t);if(F(e))return e}return null}function mr(e,t){let n=RegExp(`^\\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]!==`
669
669
  `;)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]===`
670
- `);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t}else i=s+1}return{content:a,changed:r}}function mr(e,t){let n=re(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=pr(a,t).content,a=a.replace(RegExp(`\\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 hr(e){let{name:t,modulesDir:r,force:a}=e,o=e.pluralize===!0,s=S(t),c=x(t),l=o?pe(s):s;l!==s&&!await n(j(r,l))&&await n(j(r,s))&&(l=s);let u=j(r,l);if(!await n(u)){console.log(`\n Module not found: ${u}\n`);return}if(!a&&!await h({message:g.red(`Delete module '${l}' at ${u}? This cannot be undone.`),initialValue:!1})){console.log(`
670
+ `);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t}else i=s+1}return{content:a,changed:r}}function hr(e,t){let n=re(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=mr(a,t).content,a=a.replace(RegExp(`\\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 gr(e){let{name:t,modulesDir:r,force:a}=e,o=e.pluralize===!0,s=S(t),c=x(t),l=o?pe(s):s;l!==s&&!await n(j(r,l))&&await n(j(r,s))&&(l=s);let u=j(r,l);if(!await n(u)){console.log(`\n Module not found: ${u}\n`);return}if(!a&&!await h({message:g.red(`Delete module '${l}' at ${u}? This cannot be undone.`),initialValue:!1})){console.log(`
671
671
  Cancelled.
672
- `);return}await gt(u,{recursive:!0,force:!0}),console.log(` Deleted: ${u}`);let d=j(r,`index.ts`);if(await n(d)){let e=await z(d,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${_(c)}Module\\s*\\}\\s*from\\s*['"][^'"]*${_(l)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=mr(e,c),e=e.replace(/\n{3,}/g,`
672
+ `);return}await _t(u,{recursive:!0,force:!0}),console.log(` Deleted: ${u}`);let d=j(r,`index.ts`);if(await n(d)){let e=await z(d,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${_(c)}Module\\s*\\}\\s*from\\s*['"][^'"]*${_(l)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=hr(e,c),e=e.replace(/\n{3,}/g,`
673
673
 
674
- `),e!==t&&(await i(d,e),console.log(` Unregistered: ${c}Module from ${d}`))}console.log(`\n Module '${l}' removed.\n`)}function gr(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(`--pluralize`,`The module folder is pluralized (users/ for user)`).option(`--no-pluralize`,`The module folder is the name as typed (the default)`).option(`-f, --force`,`Skip confirmation prompt`).action(async(e,t)=>{let n=await T(process.cwd()),r=C(n),i=t.modulesDir??r.dir??`src/modules`,a=w(t.pluralize,r);for(let n of e)await hr({name:n,modulesDir:N(i),force:t.force,pluralize:a})})}function _r(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 vr(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function yr(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 T(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-C7ybMh21.mjs`),{builtinCliPlugins:t}=await import(`./builtins-CaOnJmm8.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(`
674
+ `),e!==t&&(await i(d,e),console.log(` Unregistered: ${c}Module from ${d}`))}console.log(`\n Module '${l}' removed.\n`)}function _r(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(`--pluralize`,`The module folder is pluralized (users/ for user)`).option(`--no-pluralize`,`The module folder is the name as typed (the default)`).option(`-f, --force`,`Skip confirmation prompt`).action(async(e,t)=>{let n=await T(process.cwd()),r=C(n),i=t.modulesDir??r.dir??`src/modules`,a=w(t.pluralize,r);for(let n of e)await gr({name:n,modulesDir:N(i),force:t.force,pluralize:a})})}function vr(e){if(e!==void 0){if(e===`false`||e===`off`||e===`none`)return!1;if(e===`zod`)return`zod`;if(e===`kickjs-schema`||e===`schema`)return`kickjs-schema`;console.warn(` kick typegen: unknown --schema-validator '${e}' (supported: 'zod', 'kickjs-schema', 'false'). Falling back to project config.`)}}function yr(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function br(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 T(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-BqNQkm01.mjs`),{builtinCliPlugins:t}=await import(`./builtins-h-f_jNxU.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(`
675
675
  Registered typegen plugins:
676
676
  `);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(`
677
677
  Disable one in kick.config.ts:
678
678
  `),console.log(` typegen: { disable: ['`+(r.typegens[0]?.id??`kick/x`)+`'] }
679
- `);return}let r=_r(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=vr(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 et(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 nt(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 Ye(i,r,e.silent??!1)}}}catch(e){e instanceof tt?console.error(`
679
+ `);return}let r=vr(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=yr(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 tt(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 rt(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 Xe(i,r,e.silent??!1)}}}catch(e){e instanceof nt?console.error(`
680
680
  `+e.message+`
681
681
  `):e instanceof ye?console.error(`
682
682
  `+e.message+`
683
- `):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}const br=/* @__PURE__ */ new Set([`Service`,`Injectable`,`Component`,`Repository`]);function xr(e,t){return typeof t==`number`?e.slice(0,t).split(`
684
- `).length:1}function Sr(e){let t=ze(e);if(t===`singleton`||t===`transient`||t===`request`)return t;if(Be(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 Cr(e){let t=O(e);if(t)return{key:`id:${t}`,label:t};let n=ze(e);return n===null?null:{key:`lit:${n}`,label:`'${n}'`}}function wr(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=it(e).map(Ve).find(e=>e?.name===`Inject`),a=null;if(i)a=Cr(i.call.arguments?.[0]);else{let e=n?.typeAnnotation?.typeAnnotation??null;e?.type===`TSTypeReference`&&(a=Cr(e.typeName))}a&&r.push({...a,line:xr(t,e.start)})}return r}function Tr(e){let t=/* @__PURE__ */ new Map,n=/* @__PURE__ */ new Map,r=[],i=(e,n)=>{t.has(e)||t.set(e,/* @__PURE__ */ new Set),t.get(e).add(n)},a=(e,t)=>{e&&(n.has(e)||n.set(e,/* @__PURE__ */ new Set),n.get(e).add(t))};for(let{path:t,source:n}of e){let e;try{let r=wt(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`)&&Be(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)}at(e,e=>{if(e.type===`ClassDeclaration`){let a=O(e.id);if(!a)return;for(let o of it(e)){let s=Ve(o);if(s){if(s.name===`Controller`){i(`id:${a}`,`singleton`),r.push({name:a,kind:`controller`,file:t,params:wr(e,n)});return}if(br.has(s.name)){let o=Ue(ot(s.call),`scope`),c=o?Sr(o):`singleton`;i(`id:${a}`,c),r.push({name:a,kind:`other`,file:t,params:wr(e,n)});return}}}return}if(e.type!==`CallExpression`)return;let a=e.callee;if(!Be(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=Cr(s[0]);c&&i(c.key,s.length>=3?Sr(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 Er(e){let t=[];if(!F(e))return t;let n=L(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(...Er(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function Dr(e){try{return I(e,`utf-8`)}catch{return``}}const Or=/* @__PURE__ */ new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function kr(e,t){let n=Dr(j(e,`.env`));if(n){let e=n.match(/^JWT_SECRET\s*=\s*['"]?([^'"\n]*)['"]?/m);if(e){let t=e[1].trim();if(Or.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 Ar(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 jr(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 Mr(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function Nr(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 Pr(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 Fr(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 Ir(e){let t=Er(j(e,`src`)).map(e=>Dr(e)),n=[],r=kr(e,t);r&&n.push(r);let i=Ar(t);i&&n.push(i);let a=jr(t);a&&n.push(a);let o=Mr();o&&n.push(o);let s=Nr(t);return s&&n.push(s),n.push(Pr(t)),n.push(Fr(t)),n}function Lr(e){let t=Tr(Er(j(e,`src`)).filter(e=>!/\.(test|spec)\.tsx?$/.test(e)).map(t=>({path:M(e,t).split(`\\`).join(`/`),source:Dr(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 Rr(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(`
683
+ `):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}const xr=/* @__PURE__ */ new Set([`Service`,`Injectable`,`Component`,`Repository`]);function Sr(e,t){return typeof t==`number`?e.slice(0,t).split(`
684
+ `).length:1}function Cr(e){let t=Be(e);if(t===`singleton`||t===`transient`||t===`request`)return t;if(Ve(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 wr(e){let t=O(e);if(t)return{key:`id:${t}`,label:t};let n=Be(e);return n===null?null:{key:`lit:${n}`,label:`'${n}'`}}function Tr(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=at(e).map(He).find(e=>e?.name===`Inject`),a=null;if(i)a=wr(i.call.arguments?.[0]);else{let e=n?.typeAnnotation?.typeAnnotation??null;e?.type===`TSTypeReference`&&(a=wr(e.typeName))}a&&r.push({...a,line:Sr(t,e.start)})}return r}function Er(e){let t=/* @__PURE__ */ new Map,n=/* @__PURE__ */ new Map,r=[],i=(e,n)=>{t.has(e)||t.set(e,/* @__PURE__ */ new Set),t.get(e).add(n)},a=(e,t)=>{e&&(n.has(e)||n.set(e,/* @__PURE__ */ new Set),n.get(e).add(t))};for(let{path:t,source:n}of e){let e;try{let r=Tt(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`)&&Ve(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)}ot(e,e=>{if(e.type===`ClassDeclaration`){let a=O(e.id);if(!a)return;for(let o of at(e)){let s=He(o);if(s){if(s.name===`Controller`){i(`id:${a}`,`singleton`),r.push({name:a,kind:`controller`,file:t,params:Tr(e,n)});return}if(xr.has(s.name)){let o=We(st(s.call),`scope`),c=o?Cr(o):`singleton`;i(`id:${a}`,c),r.push({name:a,kind:`other`,file:t,params:Tr(e,n)});return}}}return}if(e.type!==`CallExpression`)return;let a=e.callee;if(!Ve(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=wr(s[0]);c&&i(c.key,s.length>=3?Cr(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 Dr(e){let t=[];if(!F(e))return t;let n=L(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(...Dr(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function Or(e){try{return I(e,`utf-8`)}catch{return``}}const kr=/* @__PURE__ */ new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function Ar(e,t){let n=Or(j(e,`.env`));if(n){let e=n.match(/^JWT_SECRET\s*=\s*['"]?([^'"\n]*)['"]?/m);if(e){let t=e[1].trim();if(kr.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 jr(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 Mr(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 Nr(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function Pr(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 Fr(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 Ir(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 Lr(e){let t=Dr(j(e,`src`)).map(e=>Or(e)),n=[],r=Ar(e,t);r&&n.push(r);let i=jr(t);i&&n.push(i);let a=Mr(t);a&&n.push(a);let o=Nr();o&&n.push(o);let s=Pr(t);return s&&n.push(s),n.push(Fr(t)),n.push(Ir(t)),n}function Rr(e){let t=Er(Dr(j(e,`src`)).filter(e=>!/\.(test|spec)\.tsx?$/.test(e)).map(t=>({path:M(e,t).split(`\\`).join(`/`),source:Or(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 zr(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(`
685
685
  Usage: kick check [--deploy] [--di]
686
686
 
687
687
  Available checks:
688
688
  --deploy Audit for production readiness (security, config, best practices)
689
689
  --di Find REQUEST-scoped dependencies injected into singleton constructors
690
- `);return}let t=process.cwd();d(e.deploy?`KickJS Deploy Check`:`KickJS DI Check`);let n=m();n.start(`Scanning project...`);let r=[...e.deploy?Ir(t):[],...e.di?Lr(t):[]];n.stop(`Scan complete`);let i={CRITICAL:0,WARNING:1,INFO:2};r.sort((e,t)=>i[e.severity]-i[t.severity]);for(let e of r)p.message(`${c(e.severity)} ${e.message}`);let a=r.filter(e=>e.severity===`CRITICAL`).length,s=r.filter(e=>e.severity===`WARNING`).length,l=r.filter(e=>e.severity===`INFO`).length,u=s===1?`warning`:`warnings`,f=[a>0?g.red(`${a} critical`):`${a} critical`,s>0?g.yellow(`${s} ${u}`):`${s} ${u}`,`${l} info`].join(`, `);a>0?(o(g.red(`${f} — fix critical issues before deploying`)),process.exit(1)):o(g.green(`${f} — looking good!`))})}const zr=Symbol.for(`kickjs.handler.entryCapture`),Br=Symbol.for(`kickjs.config.describe`);function Vr(e){return Array.isArray(e)?e.join(`,`):typeof e==`object`&&e||typeof e==`string`&&/[\r\n]/.test(e)?JSON.stringify(e):String(e)}function Hr(e){let t=[];for(let n of e){let e=[n.description,n.list?`comma-separated list`:void 0].filter(Boolean);for(let n of e.length>0?e.join(` — `).split(/\r?\n/):[])t.push(`# ${n}`);n.required?t.push(`${n.name}=`):t.push(`# ${n.name}=${n.default===void 0?``:Vr(n.default)}`)}return t}function Ur(e){let t=[`# Generated by \`kick env example\` from the env schema and the declared settings
690
+ `);return}let t=process.cwd();d(e.deploy?`KickJS Deploy Check`:`KickJS DI Check`);let n=m();n.start(`Scanning project...`);let r=[...e.deploy?Lr(t):[],...e.di?Rr(t):[]];n.stop(`Scan complete`);let i={CRITICAL:0,WARNING:1,INFO:2};r.sort((e,t)=>i[e.severity]-i[t.severity]);for(let e of r)p.message(`${c(e.severity)} ${e.message}`);let a=r.filter(e=>e.severity===`CRITICAL`).length,s=r.filter(e=>e.severity===`WARNING`).length,l=r.filter(e=>e.severity===`INFO`).length,u=s===1?`warning`:`warnings`,f=[a>0?g.red(`${a} critical`):`${a} critical`,s>0?g.yellow(`${s} ${u}`):`${s} ${u}`,`${l} info`].join(`, `);a>0?(o(g.red(`${f} — fix critical issues before deploying`)),process.exit(1)):o(g.green(`${f} — looking good!`))})}const Br=Symbol.for(`kickjs.handler.entryCapture`),Vr=Symbol.for(`kickjs.config.describe`);function Hr(e){return Array.isArray(e)?e.join(`,`):typeof e==`object`&&e||typeof e==`string`&&/[\r\n]/.test(e)?JSON.stringify(e):String(e)}function Ur(e){let t=[];for(let n of e){let e=[n.description,n.list?`comma-separated list`:void 0].filter(Boolean);for(let n of e.length>0?e.join(` — `).split(/\r?\n/):[])t.push(`# ${n}`);n.required?t.push(`${n.name}=`):t.push(`# ${n.name}=${n.default===void 0?``:Hr(n.default)}`)}return t}function Wr(e){let t=[`# Generated by \`kick env example\` from the env schema and the declared settings
691
691
  # sections. Re-run it after changing them; \`kick env example --check\` fails when stale.
692
692
  #
693
693
  # Uncommented variables are required. Commented ones are optional; the value shown
694
- # is the default. Any variable can come from a file instead: NAME_FILE=/run/secrets/name`];e.env.length>0&&t.push([`# ── App env schema ──`,...Hr(e.env)].join(`
695
- `));for(let n of e.sections)t.push([`# ── ${n.prefix} settings (declared by ${n.declaredBy}) ──`,...Hr(n.vars)].join(`
694
+ # is the default. Any variable can come from a file instead: NAME_FILE=/run/secrets/name`];e.env.length>0&&t.push([`# ── App env schema ──`,...Ur(e.env)].join(`
695
+ `));for(let n of e.sections)t.push([`# ── ${n.prefix} settings (declared by ${n.declaredBy}) ──`,...Ur(n.vars)].join(`
696
696
  `));return`${t.join(`
697
697
 
698
- `)}\n`}async function Wr(e,t){let n=N(e,t);if(!F(n))throw Error(`${t} not found`);let r=N(e,`vite.config.ts`);if(!F(r))throw Error(`vite.config.ts not found — kick env example loads the app through it`);let{createRequire:i}=await import(`node:module`),a=i(N(e,`package.json`)),{createServer:o}=await import(B(a.resolve(`vite`)).href),s=globalThis,c;s[zr]=e=>{c??=e},s[Br]=!0,s[ce]=`kick-env`;let l=await o({configFile:r,root:e,logLevel:`error`,appType:`custom`,server:{middlewareMode:!0,hmr:!1,watch:null}});try{await l.ssrLoadModule(n)}finally{delete s[zr],delete s[Br],delete s[ce],await l.close()}if(!c)throw Error(`${t} finished loading without calling bootstrap()`);return c.describeConfig()}function Gr(e){e.command(`env`).description(`Work with the environment the app reads`).command(`example`).description(`Write .env.example from the env schema and declared settings sections`).option(`-e, --entry <file>`,`App entry that calls bootstrap()`,`src/index.ts`).option(`-o, --out <file>`,`File to write`,`.env.example`).option(`--check`,`Exit 1 if the file is missing or out of date, instead of writing it`).action(async e=>{let t=process.cwd(),n=N(t,e.out),r;try{r=Ur(await Wr(t,e.entry))}catch(e){console.error(`\n kick env example: ${e.message}\n`),process.exit(1)}e.check?((F(n)?I(n,`utf8`):void 0)!==r&&(console.error(`\n ${e.out} is out of date — run \`kick env example\`.\n`),process.exit(1)),console.log(` ${e.out} is up to date.`)):(R(n,r),console.log(` Wrote ${e.out}`))})}function Kr(e){return e.optsWithGlobals().dryRun??!1}function qr(e){e.command(`codemod`).description(`Codebase migration commands (AST-style rewrites — distinct from db migrate)`).command(`modules`).description(`Rewrite module declarations between class form and the defineModule factory.
698
+ `)}\n`}async function Gr(e,t){let n=N(e,t);if(!F(n))throw Error(`${t} not found`);let r=N(e,`vite.config.ts`);if(!F(r))throw Error(`vite.config.ts not found — kick env example loads the app through it`);let{createRequire:i}=await import(`node:module`),a=i(N(e,`package.json`)),{createServer:o}=await import(B(a.resolve(`vite`)).href),s=globalThis,c;s[Br]=e=>{c??=e},s[Vr]=!0,s[ce]=`kick-env`;let l=await o({configFile:r,root:e,logLevel:`error`,appType:`custom`,server:{middlewareMode:!0,hmr:!1,watch:null}});try{await l.ssrLoadModule(n)}finally{delete s[Br],delete s[Vr],delete s[ce],await l.close()}if(!c)throw Error(`${t} finished loading without calling bootstrap()`);return c.describeConfig()}function Kr(e){e.command(`env`).description(`Work with the environment the app reads`).command(`example`).description(`Write .env.example from the env schema and declared settings sections`).option(`-e, --entry <file>`,`App entry that calls bootstrap()`,`src/index.ts`).option(`-o, --out <file>`,`File to write`,`.env.example`).option(`--check`,`Exit 1 if the file is missing or out of date, instead of writing it`).action(async e=>{let t=process.cwd(),n=N(t,e.out),r;try{r=Wr(await Gr(t,e.entry))}catch(e){console.error(`\n kick env example: ${e.message}\n`),process.exit(1)}e.check?((F(n)?I(n,`utf8`):void 0)!==r&&(console.error(`\n ${e.out} is out of date — run \`kick env example\`.\n`),process.exit(1)),console.log(` ${e.out} is up to date.`)):(R(n,r),console.log(` Wrote ${e.out}`))})}function qr(e){return e.optsWithGlobals().dryRun??!1}function Jr(e){e.command(`codemod`).description(`Codebase migration commands (AST-style rewrites — distinct from db migrate)`).command(`modules`).description(`Rewrite module declarations between class form and the defineModule factory.
699
699
  Direction defaults to \`modules.style\` from kick.config (or "define").
700
700
  --target define|class Override the migration direction.
701
701
  --apply Apply the changes (default: dry-run preview).
702
- --experimental Acknowledge that AST migration is experimental.`).option(`--modules-dir <dir>`,`Modules directory (default: src/modules from kick.config)`).option(`--apply`,`Apply the migration to disk (default: dry-run)`).option(`--experimental`,`Acknowledge that this command is experimental`).option(`--target <style>`,`Migration direction — 'define' or 'class'`).option(`--no-backup`,`Skip the .kickjs/codemod-backups/ snapshot (default: backup on)`).action(async(e,n)=>{let r=Kr(n)||!e.apply;t(r),e.experimental||(console.error(`
702
+ --experimental Acknowledge that AST migration is experimental.`).option(`--modules-dir <dir>`,`Modules directory (default: src/modules from kick.config)`).option(`--apply`,`Apply the migration to disk (default: dry-run)`).option(`--experimental`,`Acknowledge that this command is experimental`).option(`--target <style>`,`Migration direction — 'define' or 'class'`).option(`--no-backup`,`Skip the .kickjs/codemod-backups/ snapshot (default: backup on)`).action(async(e,n)=>{let r=qr(n)||!e.apply;t(r),e.experimental||(console.error(`
703
703
  `+g.red(`Error:`)+` kick codemod modules is experimental — pass --experimental to acknowledge.
704
704
  The regex-based rewrite handles the shapes our templates produce.
705
705
  Hand-rolled modules with non-standard structures may be skipped.
706
706
  Always commit before running with --apply.
707
- `),process.exit(1));let i=await T(process.cwd()),a=C(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 ${g.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let c=g.dim(`→ ${s}`),l=r?g.dim(`(dry-run)`):g.bold(`(applying)`);console.log(`\n ${g.bold(`kick codemod modules`)} ${c} ${l}`),console.log(` modulesDir: ${g.dim(o)}\n`);let u=e.backup!==!1&&!r,d=await Gt(o,{dryRun:r,target:s,backup:u});if(d.backupDir){let e=d.backupDir;console.log(` ${g.green(`✓`)} backup: ${g.dim(e)}\n ${g.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else!r&&e.backup===!1&&console.log(` ${g.dim(`(--no-backup — skipping snapshot)`)}\n`);let f=0,p=0;for(let e of d.files)if(e.status===`migrated`)f++,console.log(` ${g.green(`✓`)} ${e.path}`);else{p++;let t=g.dim(`(${e.reason??`skipped`})`);console.log(` ${g.dim(`-`)} ${e.path} ${t}`)}if(console.log(),d.indexStatus===`migrated`)console.log(` ${g.green(`✓`)} ${d.indexPath}`);else if(d.indexStatus===`skipped`){let e=g.dim(`(${d.indexReason??`skipped`})`);console.log(` ${g.dim(`-`)} ${d.indexPath} ${e}`)}else console.log(` ${g.dim(`-`)} ${d.indexPath} ${g.dim(`(not found)`)}`);let m=r?g.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n ${g.bold(String(f))} migrated, ${g.bold(String(p))} skipped${m}\n`)})}function Jr(e){try{let t=JSON.parse(I(N(e,`package.json`),`utf-8`));return{...t.dependencies,...t.devDependencies}}catch{return{}}}function Yr(e,t=F,n=Jr(e)){if(n[`@forinda/kickjs-inertia`])return{staticDir:`dist/client`,siteRoot:`.`,apiPath:``,include:[`dist/client/.vite/manifest.json`,`dist/ssr`]};let r=A(e);return(t(N(r,`pnpm-workspace.yaml`))||t(N(r,`package.json`)))&&t(N(r,`web`,`package.json`))?{staticDir:`../web/dist`,siteRoot:`..`,apiPath:`/api`}:{siteRoot:`.`,apiPath:``}}function Xr(e,t,n,r){let i=Yr(t,n,r),a=e?.staticDir===!1?void 0:e?.staticDir??i.staticDir;return{entry:e?.entry??`src/serverless.ts`,outDir:e?.outDir??`dist/serverless`,staticDir:a,siteRoot:e?.siteRoot??i.siteRoot,publishDir:e?.publishDir??`dist/public`,apiPath:e?.apiPath??i.apiPath,external:e?.external??[`valibot`,`yup`],vercelRuntime:e?.vercelRuntime??`nodejs22.x`,include:e?.include??i.include??[]}}function Zr(e,t,n={projectDir:`.`}){let r=[` path: '${t}/*',`,...n.preferStatic?[` preferStatic: true,`]:[],...n.includedFiles?.length?[` includedFiles: ${JSON.stringify(n.includedFiles)},`]:[]];return`import { fileURLToPath } from 'node:url'
707
+ `),process.exit(1));let i=await T(process.cwd()),a=C(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 ${g.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let c=g.dim(`→ ${s}`),l=r?g.dim(`(dry-run)`):g.bold(`(applying)`);console.log(`\n ${g.bold(`kick codemod modules`)} ${c} ${l}`),console.log(` modulesDir: ${g.dim(o)}\n`);let u=e.backup!==!1&&!r,d=await Kt(o,{dryRun:r,target:s,backup:u});if(d.backupDir){let e=d.backupDir;console.log(` ${g.green(`✓`)} backup: ${g.dim(e)}\n ${g.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else!r&&e.backup===!1&&console.log(` ${g.dim(`(--no-backup — skipping snapshot)`)}\n`);let f=0,p=0;for(let e of d.files)if(e.status===`migrated`)f++,console.log(` ${g.green(`✓`)} ${e.path}`);else{p++;let t=g.dim(`(${e.reason??`skipped`})`);console.log(` ${g.dim(`-`)} ${e.path} ${t}`)}if(console.log(),d.indexStatus===`migrated`)console.log(` ${g.green(`✓`)} ${d.indexPath}`);else if(d.indexStatus===`skipped`){let e=g.dim(`(${d.indexReason??`skipped`})`);console.log(` ${g.dim(`-`)} ${d.indexPath} ${e}`)}else console.log(` ${g.dim(`-`)} ${d.indexPath} ${g.dim(`(not found)`)}`);let m=r?g.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n ${g.bold(String(f))} migrated, ${g.bold(String(p))} skipped${m}\n`)})}function Yr(e){try{let t=JSON.parse(I(N(e,`package.json`),`utf-8`));return{...t.dependencies,...t.devDependencies}}catch{return{}}}function Xr(e,t=F,n=Yr(e)){if(n[`@forinda/kickjs-inertia`])return{staticDir:`dist/client`,siteRoot:`.`,apiPath:``,include:[`dist/client/.vite/manifest.json`,`dist/ssr`]};let r=A(e);return(t(N(r,`pnpm-workspace.yaml`))||t(N(r,`package.json`)))&&t(N(r,`web`,`package.json`))?{staticDir:`../web/dist`,siteRoot:`..`,apiPath:`/api`}:{siteRoot:`.`,apiPath:``}}function Zr(e,t,n,r){let i=Xr(t,n,r),a=e?.staticDir===!1?void 0:e?.staticDir??i.staticDir;return{entry:e?.entry??`src/serverless.ts`,outDir:e?.outDir??`dist/serverless`,staticDir:a,siteRoot:e?.siteRoot??i.siteRoot,publishDir:e?.publishDir??`dist/public`,apiPath:e?.apiPath??i.apiPath,external:e?.external??[`valibot`,`yup`],vercelRuntime:e?.vercelRuntime??`nodejs22.x`,include:e?.include??i.include??[]}}function Qr(e,t,n={projectDir:`.`}){let r=[` path: '${t}/*',`,...n.preferStatic?[` preferStatic: true,`]:[],...n.includedFiles?.length?[` includedFiles: ${JSON.stringify(n.includedFiles)},`]:[]];return`import { fileURLToPath } from 'node:url'
708
708
  import { handler } from '${e}'
709
709
 
710
710
  // Where the app's build files were packaged; the platform starts this
@@ -718,7 +718,7 @@ export const config = {
718
718
  ${r.join(`
719
719
  `)}
720
720
  }
721
- `}function Qr(){return`import { fileURLToPath } from 'node:url'
721
+ `}function $r(){return`import { fileURLToPath } from 'node:url'
722
722
  import { handler } from './server.mjs'
723
723
 
724
724
  // The app's build files are copied into this function at their project
@@ -728,11 +728,11 @@ process.env.KICK_APP_ROOT ??= fileURLToPath(new URL('./', import.meta.url))
728
728
  const requestContext = () => globalThis[Symbol.for('@vercel/request-context')]?.get?.()
729
729
 
730
730
  export default (req, res) => handler.node(req, res, requestContext())
731
- `}function $r(e){return/^\s*publish\s*=\s*["']([^"']+)["']/m.exec(e)?.[1]?.replace(/^\.\//,``).replace(/\/+$/,``)}function ei(e,t,n=!1){let r=[{handle:`filesystem`},{src:`^${e}/(.*)$`,dest:`/api`}];return n&&e!==``&&r.push({src:`^/_kick/(.*)$`,dest:`/api`}),t&&e!==``&&r.push({src:`^/(.*)$`,dest:`/index.html`}),r}function ti(e,t){let n;try{n=wt(t,e).program}catch{return[]}let r=[],i=t=>e.slice(0,t).split(`
732
- `).length,a=e=>{if(!e||typeof e!=`object`)return;if(Array.isArray(e))return e.forEach(a);let n=e,o=n.expression;if(n.type===`Decorator`&&o?.type===`CallExpression`&&o.callee?.type===`Identifier`&&o.callee.name===`Cron`){let[e,a]=o.arguments??[],s=e?.type===`Literal`&&typeof e.value==`string`?e.value:e?.type===`TemplateLiteral`&&e.expressions.length===0?e.quasis[0]?.value?.cooked:void 0;r.push({file:t,line:i(n.start??0),expression:s,timezone:a?.type===`ObjectExpression`&&a.properties.some(e=>(e.key?.name??e.key?.value)===`timezone`)})}for(let e in n)e!==`parent`&&a(n[e])};return a(n),r}function ni(e){let t=N(e,`src`);return F(t)?L(t,{recursive:!0,encoding:`utf-8`}).filter(e=>/\.m?ts$/.test(e)&&!/\.(test|spec|d)\.m?ts$/.test(e)).flatMap(e=>{let n=I(N(t,e),`utf-8`);return n.includes(`@Cron`)?ti(n,`src/${e}`):[]}):[]}function ri(e){let t=2166136261;for(let n of e.trim().replace(/\s+/g,` `))t^=n.codePointAt(0),t=Math.imul(t,16777619)>>>0;return t.toString(36)}function ii(e){let t=[],n=/* @__PURE__ */ new Map;for(let r of e){let e=`${r.file}:${r.line}`;if(r.expression===void 0){t.push(`${e}: @Cron expression is not a string literal, so it has no Vercel cron entry`);continue}r.timezone&&t.push(`${e}: Vercel crons run in UTC — the timezone option is ignored there`);let i=r.expression.trim().replace(/\s+/g,` `);i.split(` `).length===5?n.set(ri(i),i):t.push(`${e}: Vercel crons need a five-field expression, so it has no Vercel cron entry`)}return{crons:[...n].map(([e,t])=>({path:`/_kick/cron/${e}`,schedule:t})),warnings:t}}function ai(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 oi(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: ${a(e)} add -D vite unplugin-swc @forinda/kickjs-vite`);let o=ai(JSON.parse(I(i,`utf-8`)));if(!o)throw Error(`${t} has no importable entry point`);return import(B(N(A(i),o)).href)}async function si(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 oi(e,`vite`),{default:a}=await oi(e,`unplugin-swc`),{devtoolsFlagPlugin:o,devtoolsStripPlugin:s}=await oi(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:(n,r)=>li(n,r?A(r):e)||t.external.includes(n)&&li(n,e),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 ci(e){return/^((?:@[a-z0-9][\w.-]*\/)?[a-z0-9][\w.-]*)(?:\/|$)/i.exec(e)?.[1]}function li(e,t,n=F){let r=ci(e);if(!r)return!1;for(let e=t;;e=A(e)){if(n(N(e,`node_modules`,r,`package.json`)))return!1;if(A(e)===e)return!0}}function ui(e,t){let n=M(e,t).split(P)[0];return n!==void 0&&n.startsWith(`.`)}function di(e){return e.flatMap(e=>[`/${e} /404 404!`,`/${e}/* /404 404!`])}function fi(e){try{return ft(e)}catch{return}}function pi(e,t){let n=t.filter(t=>!F(N(e,t)));if(n.length>0)throw Error(`${n.join(`, `)} not found — the function reads ${n.length===1?`it`:`them`} at runtime. Run the full build first (\`${ke(a(e),`build`)}\`), or fix \`deploy.include\`.`)}function mi(e,t){let n=t.projectRoot,r=()=>Xr(t.config?.deploy,n);e.command(`build:netlify`).description(`Bundle the serverless entry and write the Netlify function`).action(async()=>{let e=r();pi(n,e.include);let i=await si(n,e,t.log),a=N(n,e.siteRoot),o=ni(n);o.length>0&&t.log(`warning: ${o.length} @Cron job(s) found — Netlify has no cron trigger for them, so they will not run. Use Netlify scheduled functions, or deploy to Vercel or Workers.`);let s=N(a,`.netlify/v1/functions`);ut(s,{recursive:!0});let c=M(s,i).split(P).join(`/`),l=e=>e.split(P).join(`/`);R(N(s,`api.mjs`),Zr(c,e.apiPath,{projectDir:l(M(s,n)),preferStatic:e.apiPath===``&&!!e.staticDir,includedFiles:e.include.flatMap(e=>{let t=l(M(s,N(n,e)));return fi(N(n,e))?.isDirectory()?[`${t}/**`]:[t]})})),t.log(`wrote ${M(process.cwd(),N(s,`api.mjs`))}`);let u=e.staticDir??e.publishDir;if(!e.staticDir)ut(N(n,u),{recursive:!0}),t.log(`publish directory ready at ${M(process.cwd(),N(n,u))}`);else if(F(N(n,u))){let e=L(N(n,u)).filter(e=>e.startsWith(`.`));if(e.length>0){let t=N(n,u,`_redirects`),r=F(t)?I(t,`utf-8`):``,i=di(e).filter(e=>!r.includes(e));i.length>0&&R(t,`${r}${r&&!r.endsWith(`
731
+ `}function ei(e){return/^\s*publish\s*=\s*["']([^"']+)["']/m.exec(e)?.[1]?.replace(/^\.\//,``).replace(/\/+$/,``)}function ti(e,t,n=!1){let r=[{handle:`filesystem`},{src:`^${e}/(.*)$`,dest:`/api`}];return n&&e!==``&&r.push({src:`^/_kick/(.*)$`,dest:`/api`}),t&&e!==``&&r.push({src:`^/(.*)$`,dest:`/index.html`}),r}function ni(e,t){let n;try{n=Tt(t,e).program}catch{return[]}let r=[],i=t=>e.slice(0,t).split(`
732
+ `).length,a=e=>{if(!e||typeof e!=`object`)return;if(Array.isArray(e))return e.forEach(a);let n=e,o=n.expression;if(n.type===`Decorator`&&o?.type===`CallExpression`&&o.callee?.type===`Identifier`&&o.callee.name===`Cron`){let[e,a]=o.arguments??[],s=e?.type===`Literal`&&typeof e.value==`string`?e.value:e?.type===`TemplateLiteral`&&e.expressions.length===0?e.quasis[0]?.value?.cooked:void 0;r.push({file:t,line:i(n.start??0),expression:s,timezone:a?.type===`ObjectExpression`&&a.properties.some(e=>(e.key?.name??e.key?.value)===`timezone`)})}for(let e in n)e!==`parent`&&a(n[e])};return a(n),r}function ri(e){let t=N(e,`src`);return F(t)?L(t,{recursive:!0,encoding:`utf-8`}).filter(e=>/\.m?ts$/.test(e)&&!/\.(test|spec|d)\.m?ts$/.test(e)).flatMap(e=>{let n=I(N(t,e),`utf-8`);return n.includes(`@Cron`)?ni(n,`src/${e}`):[]}):[]}function ii(e){let t=2166136261;for(let n of e.trim().replace(/\s+/g,` `))t^=n.codePointAt(0),t=Math.imul(t,16777619)>>>0;return t.toString(36)}function ai(e){let t=[],n=/* @__PURE__ */ new Map;for(let r of e){let e=`${r.file}:${r.line}`;if(r.expression===void 0){t.push(`${e}: @Cron expression is not a string literal, so it has no Vercel cron entry`);continue}r.timezone&&t.push(`${e}: Vercel crons run in UTC — the timezone option is ignored there`);let i=r.expression.trim().replace(/\s+/g,` `);i.split(` `).length===5?n.set(ii(i),i):t.push(`${e}: Vercel crons need a five-field expression, so it has no Vercel cron entry`)}return{crons:[...n].map(([e,t])=>({path:`/_kick/cron/${e}`,schedule:t})),warnings:t}}function oi(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 si(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: ${a(e)} add -D vite unplugin-swc @forinda/kickjs-vite`);let o=oi(JSON.parse(I(i,`utf-8`)));if(!o)throw Error(`${t} has no importable entry point`);return import(B(N(A(i),o)).href)}async function ci(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 si(e,`vite`),{default:a}=await si(e,`unplugin-swc`),{devtoolsFlagPlugin:o,devtoolsStripPlugin:s}=await si(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:(n,r)=>ui(n,r?A(r):e)||t.external.includes(n)&&ui(n,e),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 li(e){return/^((?:@[a-z0-9][\w.-]*\/)?[a-z0-9][\w.-]*)(?:\/|$)/i.exec(e)?.[1]}function ui(e,t,n=F){let r=li(e);if(!r)return!1;for(let e=t;;e=A(e)){if(n(N(e,`node_modules`,r,`package.json`)))return!1;if(A(e)===e)return!0}}function di(e,t){let n=M(e,t).split(P)[0];return n!==void 0&&n.startsWith(`.`)}function fi(e){return e.flatMap(e=>[`/${e} /404 404!`,`/${e}/* /404 404!`])}function pi(e){try{return pt(e)}catch{return}}function mi(e,t){let n=t.filter(t=>!F(N(e,t)));if(n.length>0)throw Error(`${n.join(`, `)} not found — the function reads ${n.length===1?`it`:`them`} at runtime. Run the full build first (\`${Ae(a(e),`build`)}\`), or fix \`deploy.include\`.`)}function hi(e,t){let n=t.projectRoot,r=()=>Zr(t.config?.deploy,n);e.command(`build:netlify`).description(`Bundle the serverless entry and write the Netlify function`).action(async()=>{let e=r();mi(n,e.include);let i=await ci(n,e,t.log),a=N(n,e.siteRoot),o=ri(n);o.length>0&&t.log(`warning: ${o.length} @Cron job(s) found — Netlify has no cron trigger for them, so they will not run. Use Netlify scheduled functions, or deploy to Vercel or Workers.`);let s=N(a,`.netlify/v1/functions`);dt(s,{recursive:!0});let c=M(s,i).split(P).join(`/`),l=e=>e.split(P).join(`/`);R(N(s,`api.mjs`),Qr(c,e.apiPath,{projectDir:l(M(s,n)),preferStatic:e.apiPath===``&&!!e.staticDir,includedFiles:e.include.flatMap(e=>{let t=l(M(s,N(n,e)));return pi(N(n,e))?.isDirectory()?[`${t}/**`]:[t]})})),t.log(`wrote ${M(process.cwd(),N(s,`api.mjs`))}`);let u=e.staticDir??e.publishDir;if(!e.staticDir)dt(N(n,u),{recursive:!0}),t.log(`publish directory ready at ${M(process.cwd(),N(n,u))}`);else if(F(N(n,u))){let e=L(N(n,u)).filter(e=>e.startsWith(`.`));if(e.length>0){let t=N(n,u,`_redirects`),r=F(t)?I(t,`utf-8`):``,i=fi(e).filter(e=>!r.includes(e));i.length>0&&R(t,`${r}${r&&!r.endsWith(`
733
733
  `)?`
734
734
  `:``}${i.join(`
735
- `)}\n`)}}let d=N(a,`netlify.toml`);if(F(d)){let e=$r(I(d,`utf-8`)),r=M(a,N(n,u)).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();pi(n,e.include);let i=await si(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`);dt(s,{recursive:!0,force:!0}),ut(c,{recursive:!0}),lt(i,N(c,`server.mjs`)),R(N(c,`index.mjs`),Qr());for(let t of e.include)lt(N(n,t),N(c,t),{recursive:!0});if(R(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`);lt(o,N(s,`static`),{recursive:!0,filter:e=>!ui(o,e)})}let{crons:l,warnings:u}=ii(ni(n));for(let e of u)t.log(`warning: ${e}`);let d={version:3,routes:ei(e.apiPath,!!o,l.length>0),...l.length>0?{crons:l}:{}};R(N(s,`config.json`),`${JSON.stringify(d,null,2)}\n`),t.log(`wrote ${M(process.cwd(),s)}`),l.length>0&&t.log(`${l.length} cron schedule(s) written. Set CRON_SECRET in the Vercel project — the trigger is not mounted without it.`)})}const hi=()=>({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 T(e.cwd);if(!n?.assetMap)return null;let r=He(n.assetMap,e.cwd);return r.count===0?null:Qe(r)}}),gi="/* 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 _i(e,t,n,r={}){if(e.length===0)return`${gi}
735
+ `)}\n`)}}let d=N(a,`netlify.toml`);if(F(d)){let e=ei(I(d,`utf-8`)),r=M(a,N(n,u)).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();mi(n,e.include);let i=await ci(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`);ft(s,{recursive:!0,force:!0}),dt(c,{recursive:!0}),ut(i,N(c,`server.mjs`)),R(N(c,`index.mjs`),$r());for(let t of e.include)ut(N(n,t),N(c,t),{recursive:!0});if(R(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`);ut(o,N(s,`static`),{recursive:!0,filter:e=>!di(o,e)})}let{crons:l,warnings:u}=ai(ri(n));for(let e of u)t.log(`warning: ${e}`);let d={version:3,routes:ti(e.apiPath,!!o,l.length>0),...l.length>0?{crons:l}:{}};R(N(s,`config.json`),`${JSON.stringify(d,null,2)}\n`),t.log(`wrote ${M(process.cwd(),s)}`),l.length>0&&t.log(`${l.length} cron schedule(s) written. Set CRON_SECRET in the Vercel project — the trigger is not mounted without it.`)})}const gi=()=>({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 T(e.cwd);if(!n?.assetMap)return null;let r=Ue(n.assetMap,e.cwd);return r.count===0?null:$e(r)}}),_i="/* 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 vi(e,t,n,r={}){if(e.length===0)return`${_i}
736
736
  // (no routes discovered yet — annotate a controller method with
737
737
  // @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
738
738
  declare global {
@@ -749,15 +749,15 @@ declare global {
749
749
 
750
750
  /** Empty until the first route exists — see kick typegen. */
751
751
  export const kickRpc = {} as const
752
- `;let i=/* @__PURE__ */ new Map;for(let t of e){let e=i.get(t.controller)??[];e.push(t),i.set(t.controller,e)}let a=/* @__PURE__ */ new Map,o=/* @__PURE__ */ new Map,s=e=>{let t=`${e.filePath}::${e.controller}`,n=o.get(t);return n||(n=`_C${o.size}`,o.set(t,n)),n},c=(e,i,o)=>{let s=xi(e,i.filePath,t,n,a);if(!s){if(e&&n!==!1){let t=o===`params`?`URL-pattern params`:o===`query`&&i.queryFilterable!==null?`the @ApiQueryParams-derived query shape`:`'unknown'`,n=`route ${i.controller}.${i.method} (${i.httpMethod} ${i.path})`;r.onWarn?.(e.unexported?`${n}: ${o} schema '${e.identifier}' is declared in ${M(process.cwd(),i.filePath)} but not exported, so the generated types can't import it — ${o} is typed as ${t}. Export it (\`export const ${e.identifier} = ...\`) to type ctx.${o}.`:`${n}: ${o} schema '${e.identifier}' could not be statically resolved — falling back to ${t}. Export the schema from the controller file or import it with a static specifier.`)}return null}return n===`kickjs-schema`?`import('@forinda/kickjs-schema').InferSchemaOutput<typeof ${s}>`:`import('zod').infer<typeof ${s}>`},l=[];for(let[e,t]of i){let n=[` interface ${e} {`];for(let e of t){let t=e.pathParams.length>0?`{ ${e.pathParams.map(e=>`${e}: string`).join(`; `)} }`:`{}`,r=c(e.bodySchema,e,`body`),i=c(e.querySchema,e,`query`),a=c(e.paramsSchema,e,`params`)??t,o=r??`unknown`,l=i??yi(e),u=c(e.responseSchema??null,e,`response`),d=s(e),f=u??`import('@forinda/kickjs').InferHandlerResponse<${d}['${e.method}']>`,p=bi(e);n.push(` /**`,` * ${e.httpMethod} ${e.path}`,...p.map(e=>` * ${e}`),` */`,` ${e.method}: {`,` params: ${a}`,` body: ${o}`,` query: ${l}`,` response: ${f}`,` contextKeys: ${vi(e)}`,` }`)}n.push(` }`),l.push(n.join(`
752
+ `;let i=/* @__PURE__ */ new Map;for(let t of e){let e=i.get(t.controller)??[];e.push(t),i.set(t.controller,e)}let a=/* @__PURE__ */ new Map,o=/* @__PURE__ */ new Map,s=e=>{let t=`${e.filePath}::${e.controller}`,n=o.get(t);return n||(n=`_C${o.size}`,o.set(t,n)),n},c=(e,i,o)=>{let s=Si(e,i.filePath,t,n,a);if(!s){if(e&&n!==!1){let t=o===`params`?`URL-pattern params`:o===`query`&&i.queryFilterable!==null?`the @ApiQueryParams-derived query shape`:`'unknown'`,n=`route ${i.controller}.${i.method} (${i.httpMethod} ${i.path})`;r.onWarn?.(e.unexported?`${n}: ${o} schema '${e.identifier}' is declared in ${M(process.cwd(),i.filePath)} but not exported, so the generated types can't import it — ${o} is typed as ${t}. Export it (\`export const ${e.identifier} = ...\`) to type ctx.${o}.`:`${n}: ${o} schema '${e.identifier}' could not be statically resolved — falling back to ${t}. Export the schema from the controller file or import it with a static specifier.`)}return null}return n===`kickjs-schema`?`import('@forinda/kickjs-schema').InferSchemaOutput<typeof ${s}>`:`import('zod').infer<typeof ${s}>`},l=[];for(let[e,t]of i){let n=[` interface ${e} {`];for(let e of t){let t=e.pathParams.length>0?`{ ${e.pathParams.map(e=>`${e}: string`).join(`; `)} }`:`{}`,r=c(e.bodySchema,e,`body`),i=c(e.querySchema,e,`query`),a=c(e.paramsSchema,e,`params`)??t,o=r??`unknown`,l=i??bi(e),u=c(e.responseSchema??null,e,`response`),d=s(e),f=u??`import('@forinda/kickjs').InferHandlerResponse<${d}['${e.method}']>`,p=xi(e);n.push(` /**`,` * ${e.httpMethod} ${e.path}`,...p.map(e=>` * ${e}`),` */`,` ${e.method}: {`,` params: ${a}`,` body: ${o}`,` query: ${l}`,` response: ${f}`,` contextKeys: ${yi(e)}`,` }`)}n.push(` }`),l.push(n.join(`
753
753
  `))}let u=[],d=/* @__PURE__ */ new Set,f=/* @__PURE__ */ new Set;i.has(`Named`)&&r.onWarn?.(`controller class 'Named' collides with the reserved KickRoutes.Named route-name map — its interface declaration-merges into it. Rename the controller.`),i.has(`Api`)&&r.onWarn?.(`controller class 'Api' collides with the reserved KickRoutes.Api client map — its interface declaration-merges into the flat route map. Rename the controller.`);for(let[e,t]of i)for(let n of t){let t=`${n.httpMethod} ${n.mountedPath??n.path}`;d.has(t)?r.onWarn?.(`duplicate route '${t}' (${e}.${n.method}) — two handlers claim the same verb+path at runtime. KickRoutes.Api keeps the first (scan order, which may not match runtime dispatch); resolve the conflict in the modules.`):(d.add(t),f.add(`${e}.${n.method}`),u.push(` '${t}': ${e}['${n.method}']`))}let p=[` interface Api {`,...u,` }`].join(`
754
754
  `);l.push(p);let m=[];for(let[e,t]of i)for(let n of t)f.has(`${e}.${n.method}`)&&m.push(` '${e}.${n.method}': ${e}['${n.method}']`);l.push([` interface Named {`,...m,` }`].join(`
755
- `));let h=[],g=/* @__PURE__ */ new Set;for(let[e,t]of i){let n=wi(e);if(g.has(n)){r.onWarn?.(`RPC manifest: controller key '${n}' (from ${e}) collides with another controller — keeping the first; rename one class for distinct RPC namespaces.`);continue}g.add(n);let i=[];for(let n of t){if(!f.has(`${e}.${n.method}`))continue;let t=`${n.httpMethod} ${n.mountedPath??n.path}`;i.push(` ${n.method}: '${t}',`)}i.length>0&&h.push(` ${n}: {\n${i.join(`
755
+ `));let h=[],g=/* @__PURE__ */ new Set;for(let[e,t]of i){let n=Ti(e);if(g.has(n)){r.onWarn?.(`RPC manifest: controller key '${n}' (from ${e}) collides with another controller — keeping the first; rename one class for distinct RPC namespaces.`);continue}g.add(n);let i=[];for(let n of t){if(!f.has(`${e}.${n.method}`))continue;let t=`${n.httpMethod} ${n.mountedPath??n.path}`;i.push(` ${n.method}: '${t}',`)}i.length>0&&h.push(` ${n}: {\n${i.join(`
756
756
  `)}\n },`)}let _=[`/**`,` * Runtime route manifest for the tRPC-style sugar:`," * `createRpc(api, kickRpc)` from @forinda/kickjs-client.",` */`,`export const kickRpc = {`,...h,`} as const`].join(`
757
- `),v=[],y=/* @__PURE__ */ new Map;for(let t of e)y.set(`${t.filePath}::${t.controller}`,t);for(let[e,n]of o){let r=y.get(e),i=Ci(``,r.filePath,t),a=r.controllerIsDefaultExport?`default as ${n}`:`${r.controller} as ${n}`;v.push(`import type { ${a} } from '${i}'`)}let b=v.length>0?v.join(`
757
+ `),v=[],y=/* @__PURE__ */ new Map;for(let t of e)y.set(`${t.filePath}::${t.controller}`,t);for(let[e,n]of o){let r=y.get(e),i=wi(``,r.filePath,t),a=r.controllerIsDefaultExport?`default as ${n}`:`${r.controller} as ${n}`;v.push(`import type { ${a} } from '${i}'`)}let b=v.length>0?v.join(`
758
758
  `)+`
759
- `:``,x=Si(a)+b,ee=l.join(`
760
- `);return`${gi}${x}
759
+ `:``,x=Ci(a)+b,ee=l.join(`
760
+ `);return`${_i}${x}
761
761
  declare global {
762
762
  // eslint-disable-next-line @typescript-eslint/no-namespace
763
763
  namespace KickRoutes {
@@ -769,18 +769,18 @@ ${ee}
769
769
  }
770
770
 
771
771
  ${_}
772
- `}function vi(e){let t=e.contextKeys;return t==null?`string`:t.length===0?`never`:t.map(e=>JSON.stringify(e)).join(` | `)}function yi(e){if(e.queryFilterable===null)return`unknown`;let t=e.querySortable??[];return`{ filter?: string | string[]; sort?: ${t.length>0?t.flatMap(e=>[`'${e}'`,`'-${e}'`]).join(` | `):`string`}; q?: string; page?: string; limit?: string; cursor?: string }`}function bi(e){let t=[];return e.queryFilterable&&e.queryFilterable.length>0&&t.push(`Filterable: ${e.queryFilterable.join(`, `)}`),e.querySortable&&e.querySortable.length>0&&t.push(`Sortable: ${e.querySortable.join(`, `)}`),e.querySearchable&&e.querySearchable.length>0&&t.push(`Searchable: ${e.querySearchable.join(`, `)}`),t}function xi(e,t,n,r,i){if(!e||r===!1||e.source===null)return null;let a=Ci(e.source,t,n);if(a===`unknown`)return null;let o=`${a}::${e.identifier}`,s=i.get(o)?.specifier;return s?s=i.get(o).specifier:(s=`_S${i.size}`,i.set(o,{identifier:e.identifier,specifier:s})),s}function Si(e){if(e.size===0)return``;let t=[];for(let[n,r]of e){let[e]=n.split(`::`);t.push(`import type { ${r.identifier} as ${r.specifier} } from '${e}'`)}return t.join(`
772
+ `}function yi(e){let t=e.contextKeys;return t==null?`string`:t.length===0?`never`:t.map(e=>JSON.stringify(e)).join(` | `)}function bi(e){if(e.queryFilterable===null)return`unknown`;let t=e.querySortable??[];return`{ filter?: string | string[]; sort?: ${t.length>0?t.flatMap(e=>[`'${e}'`,`'-${e}'`]).join(` | `):`string`}; q?: string; page?: string; limit?: string; cursor?: string }`}function xi(e){let t=[];return e.queryFilterable&&e.queryFilterable.length>0&&t.push(`Filterable: ${e.queryFilterable.join(`, `)}`),e.querySortable&&e.querySortable.length>0&&t.push(`Sortable: ${e.querySortable.join(`, `)}`),e.querySearchable&&e.querySearchable.length>0&&t.push(`Searchable: ${e.querySearchable.join(`, `)}`),t}function Si(e,t,n,r,i){if(!e||r===!1||e.source===null)return null;let a=wi(e.source,t,n);if(a===`unknown`)return null;let o=`${a}::${e.identifier}`,s=i.get(o)?.specifier;return s?s=i.get(o).specifier:(s=`_S${i.size}`,i.set(o,{identifier:e.identifier,specifier:s})),s}function Ci(e){if(e.size===0)return``;let t=[];for(let[n,r]of e){let[e]=n.split(`::`);t.push(`import type { ${r.identifier} as ${r.specifier} } from '${e}'`)}return t.join(`
773
773
  `)+`
774
- `}function Ci(e,t,n){if(e===null)return`unknown`;let r=A(n);if(e===``){let e=M(r,t).split(P).join(`/`);return e=e.replace(/\.(ts|tsx|mts|cts)$/i,``),e.startsWith(`.`)||(e=`./`+e),e}if(!e.startsWith(`.`)&&!e.startsWith(`/`))return e;let i=A(t),a=N(i,e),o=M(r,a).split(P).join(`/`);return o=o.replace(/\.(ts|tsx|mts|cts)$/i,``),o.startsWith(`.`)||(o=`./`+o),o}function wi(e){let t=e.endsWith(`Controller`)?e.slice(0,-10):e,n=t.length>0?t:e;return n.charAt(0).toLowerCase()+n.slice(1)}const Ti=()=>({id:`kick/routes`,outExtension:`.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){let t=await e.getScanResult({root:Ei(e),cwd:e.cwd,envFile:Di(e)}),n=e.config?.typegen?.schemaValidator??`zod`,r=k.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return _i(t.routes,r,n,{onWarn:t=>e.log.warn(t)})}});function Ei(e){return k.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Di(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}const Oi=`@typescript/typescript6`;function ki(e){return typeof e?.createProgram==`function`}function Ai(e){if(ki(e.typescript))return{api:e.typescript,source:`typescript`};if(ki(e.ts6))return{api:e.ts6,source:Oi};let t=`Install it in the project:\n ${a()} add -D ${Oi}`;throw e.typescript?Error(`kick typegen: the client route map needs a TypeScript compiler API.
775
- TypeScript 7 does not ship a compiler API, so the compatibility package is required.\n ${t}`):Error(`kick typegen: the client route map needs a TypeScript compiler API, and neither 'typescript' nor '${Oi}' resolved from this project.\n ${t}`)}async function ji(e){let t=st(j(e,`package.json`)),n=async e=>{try{return await import(B(t.resolve(e)).href)}catch{return null}},[r,i]=await Promise.all([n(`typescript`),n(Oi)]);return Ai({typescript:Mi(r),ts6:Mi(i)}).api}function Mi(e){let t=e;return t?.default&&typeof t.default==`object`?t.default:e}const Ni=Symbol(`kick/client: expansion budget exhausted`);var Pi=class{ts;checker;program;opts;get printFlags(){return this.ts.TypeFormatFlags.NoTruncation}hoistedByType=/* @__PURE__ */ new Map;inProgress=/* @__PURE__ */ new Map;jsonInProgress=/* @__PURE__ */ new Set;nextName=0;blocks=[];maxDepth;truncations=0;budget;constructor(e,t,n,r={}){this.ts=e,this.checker=t,this.program=n,this.opts=r,this.maxDepth=r.maxDepth??12,this.budget=r.truncationBudget??1e3}hoisted(){return this.blocks}expand(e){this.truncations=0;let t=this.blocks.length,n=this.nextName,r=new Set(this.hoistedByType.keys());try{return this.render(e,0)}catch(e){if(e!==Ni)throw e;this.blocks.length=t,this.nextName=n;for(let e of this.hoistedByType.keys())r.has(e)||this.hoistedByType.delete(e);return this.opts.onWarn?.(`expansion abandoned after ${this.budget} depth hoists — emitting 'unknown'. Either the response type never repeats (a generic that grows at every level) or it nests more distinct types than the budget allows; raising maxDepth hoists fewer of them. Declare a response schema on the route for an exact type.`),`unknown`}}render(e,t,n=!0){let r=this.ts.TypeFlags;if(n){let t=this.hoistedByType.get(e);if(t)return t}if(t>this.maxDepth&&!this.isLeaf(e))return this.hoistDeep(e);if(e.flags&(r.String|r.Number|r.Boolean|r.BigInt|r.ESSymbol)||e.flags&(r.Any|r.Unknown|r.Never|r.Void|r.Undefined|r.Null)||e.isLiteral()||e.flags&r.BooleanLiteral)return this.checker.typeToString(e,void 0,this.printFlags);if(e.isUnion()){let n=e.types.filter(e=>!this.isCallable(e));return(n.length>0?n:e.types).map(e=>this.render(e,t+1)).join(` | `)}if(e.isIntersection())return e.types.map(e=>this.render(e,t+1)).join(` & `);if(this.isTuple(e))return this.renderTuple(e,t);let i=this.arrayElement(e);if(i){let e=this.render(i.element,t+1),n=/[|&]/.test(e)?`(${e})[]`:`${e}[]`;return i.readonly?`readonly ${n}`:n}let a=this.toJsonType(e);if(a){if(this.jsonInProgress.has(e))return this.opts.onWarn?.(`'${this.checker.typeToString(e,void 0,this.printFlags)}' has a cyclic toJSON() — emitting 'unknown', since it has no serializable form.`),`unknown`;this.jsonInProgress.add(e);try{return this.render(a,t)}finally{this.jsonInProgress.delete(e)}}return this.isLibType(e)?this.renderLibType(e,t):e.flags&r.Object?this.renderObject(e,t):(this.opts.onWarn?.(`could not expand type '${this.checker.typeToString(e)}' — emitting 'unknown'`),`unknown`)}isLeaf(e){let t=this.ts.TypeFlags;return(e.flags&(t.String|t.Number|t.Boolean|t.BigInt|t.ESSymbol|t.Any|t.Unknown|t.Never|t.Void|t.Undefined|t.Null|t.BooleanLiteral))!==0||e.isLiteral()}hoistDeep(e){if(++this.truncations>this.budget)throw Ni;let t=this.allocName();this.hoistedByType.set(e,t);let n=this.blocks.length;return this.blocks.push(``),this.blocks[n]=this.isPlainObject(e)?`interface ${t} {\n${this.members(e,0,` `)}\n}`:`type ${t} = ${this.render(e,0,!1)}`,t}isPlainObject(e){return(e.flags&this.ts.TypeFlags.Object)!==0&&!e.isUnionOrIntersection()&&!this.isTuple(e)&&!this.arrayElement(e)&&!this.toJsonType(e)&&!this.isLibType(e)}renderObject(e,t){let n=this.hoistedByType.get(e);if(n)return n;if(this.isNamed(e)){let t=this.allocName();this.hoistedByType.set(e,t);let n=this.blocks.length;return this.blocks.push(``),this.blocks[n]=`interface ${t} {\n${this.members(e,0,` `)}\n}`,t}let r=this.inProgress.get(e);if(r)return r.name??=this.allocName();let i={name:null};this.inProgress.set(e,i);let a;try{a=this.members(e,t,``,`; `)}finally{this.inProgress.delete(e)}if(i.name){this.hoistedByType.set(e,i.name);let t=this.blocks.length;return this.blocks.push(``),this.blocks[t]=`interface ${i.name} {\n${this.members(e,0,` `)}\n}`,i.name}return a.length>0?`{ ${a} }`:`{}`}allocName(){return`__T${this.nextName++}`}members(e,t,n,r=`
774
+ `}function wi(e,t,n){if(e===null)return`unknown`;let r=A(n);if(e===``){let e=M(r,t).split(P).join(`/`);return e=e.replace(/\.(ts|tsx|mts|cts)$/i,``),e.startsWith(`.`)||(e=`./`+e),e}if(!e.startsWith(`.`)&&!e.startsWith(`/`))return e;let i=A(t),a=N(i,e),o=M(r,a).split(P).join(`/`);return o=o.replace(/\.(ts|tsx|mts|cts)$/i,``),o.startsWith(`.`)||(o=`./`+o),o}function Ti(e){let t=e.endsWith(`Controller`)?e.slice(0,-10):e,n=t.length>0?t:e;return n.charAt(0).toLowerCase()+n.slice(1)}const Ei=()=>({id:`kick/routes`,outExtension:`.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){let t=await e.getScanResult({root:Di(e),cwd:e.cwd,envFile:Oi(e)}),n=e.config?.typegen?.schemaValidator??`zod`,r=k.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return vi(t.routes,r,n,{onWarn:t=>e.log.warn(t)})}});function Di(e){return k.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Oi(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}const ki=`@typescript/typescript6`;function Ai(e){return typeof e?.createProgram==`function`}function ji(e){if(Ai(e.typescript))return{api:e.typescript,source:`typescript`};if(Ai(e.ts6))return{api:e.ts6,source:ki};let t=`Install it in the project:\n ${a()} add -D ${ki}`;throw e.typescript?Error(`kick typegen: the client route map needs a TypeScript compiler API.
775
+ TypeScript 7 does not ship a compiler API, so the compatibility package is required.\n ${t}`):Error(`kick typegen: the client route map needs a TypeScript compiler API, and neither 'typescript' nor '${ki}' resolved from this project.\n ${t}`)}async function Mi(e){let t=ct(j(e,`package.json`)),n=async e=>{try{return await import(B(t.resolve(e)).href)}catch{return null}},[r,i]=await Promise.all([n(`typescript`),n(ki)]);return ji({typescript:Ni(r),ts6:Ni(i)}).api}function Ni(e){let t=e;return t?.default&&typeof t.default==`object`?t.default:e}const Pi=Symbol(`kick/client: expansion budget exhausted`);var Fi=class{ts;checker;program;opts;get printFlags(){return this.ts.TypeFormatFlags.NoTruncation}hoistedByType=/* @__PURE__ */ new Map;inProgress=/* @__PURE__ */ new Map;jsonInProgress=/* @__PURE__ */ new Set;nextName=0;blocks=[];maxDepth;truncations=0;budget;constructor(e,t,n,r={}){this.ts=e,this.checker=t,this.program=n,this.opts=r,this.maxDepth=r.maxDepth??12,this.budget=r.truncationBudget??1e3}hoisted(){return this.blocks}expand(e){this.truncations=0;let t=this.blocks.length,n=this.nextName,r=new Set(this.hoistedByType.keys());try{return this.render(e,0)}catch(e){if(e!==Pi)throw e;this.blocks.length=t,this.nextName=n;for(let e of this.hoistedByType.keys())r.has(e)||this.hoistedByType.delete(e);return this.opts.onWarn?.(`expansion abandoned after ${this.budget} depth hoists — emitting 'unknown'. Either the response type never repeats (a generic that grows at every level) or it nests more distinct types than the budget allows; raising maxDepth hoists fewer of them. Declare a response schema on the route for an exact type.`),`unknown`}}render(e,t,n=!0){let r=this.ts.TypeFlags;if(n){let t=this.hoistedByType.get(e);if(t)return t}if(t>this.maxDepth&&!this.isLeaf(e))return this.hoistDeep(e);if(e.flags&(r.String|r.Number|r.Boolean|r.BigInt|r.ESSymbol)||e.flags&(r.Any|r.Unknown|r.Never|r.Void|r.Undefined|r.Null)||e.isLiteral()||e.flags&r.BooleanLiteral)return this.checker.typeToString(e,void 0,this.printFlags);if(e.isUnion()){let n=e.types.filter(e=>!this.isCallable(e));return(n.length>0?n:e.types).map(e=>this.render(e,t+1)).join(` | `)}if(e.isIntersection())return e.types.map(e=>this.render(e,t+1)).join(` & `);if(this.isTuple(e))return this.renderTuple(e,t);let i=this.arrayElement(e);if(i){let e=this.render(i.element,t+1),n=/[|&]/.test(e)?`(${e})[]`:`${e}[]`;return i.readonly?`readonly ${n}`:n}let a=this.toJsonType(e);if(a){if(this.jsonInProgress.has(e))return this.opts.onWarn?.(`'${this.checker.typeToString(e,void 0,this.printFlags)}' has a cyclic toJSON() — emitting 'unknown', since it has no serializable form.`),`unknown`;this.jsonInProgress.add(e);try{return this.render(a,t)}finally{this.jsonInProgress.delete(e)}}return this.isLibType(e)?this.renderLibType(e,t):e.flags&r.Object?this.renderObject(e,t):(this.opts.onWarn?.(`could not expand type '${this.checker.typeToString(e)}' — emitting 'unknown'`),`unknown`)}isLeaf(e){let t=this.ts.TypeFlags;return(e.flags&(t.String|t.Number|t.Boolean|t.BigInt|t.ESSymbol|t.Any|t.Unknown|t.Never|t.Void|t.Undefined|t.Null|t.BooleanLiteral))!==0||e.isLiteral()}hoistDeep(e){if(++this.truncations>this.budget)throw Pi;let t=this.allocName();this.hoistedByType.set(e,t);let n=this.blocks.length;return this.blocks.push(``),this.blocks[n]=this.isPlainObject(e)?`interface ${t} {\n${this.members(e,0,` `)}\n}`:`type ${t} = ${this.render(e,0,!1)}`,t}isPlainObject(e){return(e.flags&this.ts.TypeFlags.Object)!==0&&!e.isUnionOrIntersection()&&!this.isTuple(e)&&!this.arrayElement(e)&&!this.toJsonType(e)&&!this.isLibType(e)}renderObject(e,t){let n=this.hoistedByType.get(e);if(n)return n;if(this.isNamed(e)){let t=this.allocName();this.hoistedByType.set(e,t);let n=this.blocks.length;return this.blocks.push(``),this.blocks[n]=`interface ${t} {\n${this.members(e,0,` `)}\n}`,t}let r=this.inProgress.get(e);if(r)return r.name??=this.allocName();let i={name:null};this.inProgress.set(e,i);let a;try{a=this.members(e,t,``,`; `)}finally{this.inProgress.delete(e)}if(i.name){this.hoistedByType.set(e,i.name);let t=this.blocks.length;return this.blocks.push(``),this.blocks[t]=`interface ${i.name} {\n${this.members(e,0,` `)}\n}`,i.name}return a.length>0?`{ ${a} }`:`{}`}allocName(){return`__T${this.nextName++}`}members(e,t,n,r=`
776
776
  `){let i=[];for(let r of this.checker.getIndexInfosOfType(e)){let e=this.checker.typeToString(r.keyType,void 0,this.printFlags);i.push(`${n}[key: ${e}]: ${this.render(r.type,t+1)}`)}for(let r of this.checker.getPropertiesOfType(e)){let e=this.typeOfProperty(r);if(this.isCallable(e)||r.getName().startsWith(`__@`))continue;let a=(r.flags&this.ts.SymbolFlags.Optional)!==0,o=this.renderPropertyType(e,a,r,t+1),s=this.isReadonlyProp(r)?`readonly `:``;i.push(`${n}${s}${this.propName(r.getName())}${a?`?`:``}: ${o}`)}return i.join(r===`
777
777
  `?`
778
- `:r)}typeOfProperty(e){let t=this.checker;if(typeof t.getTypeOfSymbol==`function`)return t.getTypeOfSymbol(e);let n=e.valueDeclaration??e.declarations?.[0];return n?this.checker.getTypeOfSymbolAtLocation(e,n):this.checker.getDeclaredTypeOfSymbol(e)}renderPropertyType(e,t,n,r){if(!t||!e.isUnion()||this.declaresUndefined(n))return this.render(e,r);let i=e.types.filter(e=>!(e.flags&this.ts.TypeFlags.Undefined));return i.length===0?`undefined`:i.map(e=>this.render(e,r)).join(` | `)}isReadonlyProp(e){let t=e.valueDeclaration??e.declarations?.[0];return t?(this.ts.getCombinedModifierFlags(t)&this.ts.ModifierFlags.Readonly)!==0:!1}declaresUndefined(e){let t=e.valueDeclaration??e.declarations?.[0];if(!t||!(this.ts.isPropertySignature(t)||this.ts.isPropertyDeclaration(t))||!t.type)return!1;let n=this.checker.getTypeFromTypeNode(t.type);return(n.isUnion()?n.types:[n]).some(e=>(e.flags&this.ts.TypeFlags.Undefined)!==0)}renderTuple(e,t){let n=this.ts.ElementFlags,r=this.checker.getTypeArguments(e),i=e.target,a=i.elementFlags??[],o=r.map((e,r)=>{let i=a[r]??n.Required;return i&n.Optional?`${(e.isUnion()?e.types.filter(e=>!(e.flags&this.ts.TypeFlags.Undefined)):[e]).map(e=>this.render(e,t+1)).join(` | `)}?`:i&n.Rest?`...${this.render(e,t+1)}[]`:i&n.Variadic?`...${this.render(e,t+1)}`:this.render(e,t+1)});return`${i.readonly?`readonly `:``}[${o.join(`, `)}]`}propName(e){return/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(e)?e:JSON.stringify(e)}isLibType(e){let t=e.aliasSymbol?.declarations??e.getSymbol()?.declarations;return!t||t.length===0?!1:t.every(e=>this.program.isSourceFileDefaultLibrary(e.getSourceFile()))}renderLibType(e,t){let n=(e.aliasSymbol??e.getSymbol())?.getName(),r=e.aliasTypeArguments??this.typeArguments(e);return!n||r.length===0?this.checker.typeToString(e,void 0,this.printFlags):`${n}<${r.map(e=>this.render(e,t+1)).join(`, `)}>`}typeArguments(e){return!(e.flags&this.ts.TypeFlags.Object)||!(e.objectFlags&this.ts.ObjectFlags.Reference)?[]:this.checker.getTypeArguments(e)}toJsonType(e){if(!(e.flags&this.ts.TypeFlags.Object))return null;let t=this.checker.getPropertyOfType(e,`toJSON`);if(!t)return null;let[n]=this.checker.getSignaturesOfType(this.typeOfProperty(t),this.ts.SignatureKind.Call);if(!n)return null;let r=this.checker.getReturnTypeOfSignature(n);return r===e?null:r}isCallable(e){if(e.isUnion()){let t=e.types.filter(e=>!(e.flags&(this.ts.TypeFlags.Undefined|this.ts.TypeFlags.Null)));return t.length>0&&t.every(e=>this.isCallable(e))}return this.checker.getSignaturesOfType(e,this.ts.SignatureKind.Call).length>0||this.checker.getSignaturesOfType(e,this.ts.SignatureKind.Construct).length>0}isNamed(e){let t=e.getSymbol();if(!t)return!1;let n=t.getName();return n!==`__type`&&n!==`__object`&&n.length>0}isTuple(e){let t=this.ts.ObjectFlags;if(!(e.flags&this.ts.TypeFlags.Object)||!(e.objectFlags&t.Reference))return!1;let n=e.target;return!!(n&&n.objectFlags&t.Tuple)}arrayElement(e){let t=e.getSymbol()?.getName();if(t!==`Array`&&t!==`ReadonlyArray`)return null;let n=this.checker.getTypeArguments(e);return n.length===1?{element:n[0],readonly:t===`ReadonlyArray`}:null}};const Fi=[`pnpm-lock.yaml`,`package-lock.json`,`yarn.lock`,`bun.lock`,`bun.lockb`],Ii=/(?:^|[\\/])(?:node_modules|\.kickjs)(?:[\\/]|$)/;function Li(e){return St(`sha1`).update(e).digest(`hex`)}function Ri(e){let t=St(`sha1`);t.update(e.cliVersion),t.update(JSON.stringify(e.options??{})),t.update(e.keys.join(`
779
- `));for(let n of Fi){let r=j(e.projectDir,n);if(F(r))try{t.update(I(r))}catch(e){throw Error(`kick/client: cannot read lockfile ${r}`,{cause:e})}}for(let n of e.fileNames.toSorted())if(!Ii.test(n)){t.update(n);try{t.update(I(n))}catch(e){throw Error(`kick/client: cannot read project file ${n}`,{cause:e})}}return t.digest(`hex`)}async function zi(e){try{let t=await ji(e.compilerFrom??e.projectDir),n={...t.sys,onUnRecoverableConfigFileDiagnostic:()=>{}},r=t.getParsedCommandLineOfConfigFile(j(e.projectDir,`tsconfig.json`),{},n);return r?Ri({projectDir:e.projectDir,fileNames:r.fileNames,keys:e.keys,options:{...r.options,__kickMaxDepth:e.maxDepth??null},cliVersion:e.cliVersion}):null}catch{return null}}async function Bi(e){let t=await ji(e.compilerFrom??e.projectDir),n=j(A(e.routesFile),`__kick_client_probe__.ts`),r=Ui(e.routesFile,e.keys),i=Ki(t,e.projectDir,n,r),a=i.getTypeChecker(),o=i.getSourceFile(n);if(!o)throw Error(`kick/client: could not add the resolution probe to the program. Check that ${e.routesFile} exists — run \`kick typegen\` first.`);Vi(t,i,e.routesFile);let s=Wi(t,i,o,e.keys),c=null,l=new Pi(t,a,i,{maxDepth:e.maxDepth,onWarn:t=>e.onWarn?.(c?`route '${c}': ${t}`:t)}),u=/* @__PURE__ */ new Map;for(let[n,r]of e.keys.entries()){if(s.has(r)){e.onWarn?.(`route '${r}' is not present in KickRoutes.Api — skipped. Re-run \`kick typegen\` so the two maps agree.`);continue}let i=o.statements.find(e=>t.isTypeAliasDeclaration(e)&&e.name.text===Hi(n));if(!i){e.onWarn?.(`route '${r}' could not be resolved — skipped.`);continue}let d=a.getTypeAtLocation(i.type);d.flags&t.TypeFlags.Any?e.onWarn?.(`route '${r}' resolved to 'any' — skipped rather than emitted, since an 'any' entry silently accepts every call. Check that the server type-checks.`):(c=r,u.set(r,l.expand(d)),c=null)}return{entries:u,hoisted:l.hoisted()}}function Vi(e,t,n){let r=t.getSourceFile(n);if(!r)throw Error(`kick/client: ${n} is not in the TypeScript program. Run \`kick typegen\` first, and check that tsconfig.json includes .kickjs.`);let i=t.getSemanticDiagnostics(r);if(i.length===0)return;let a=i.slice(0,3).map(t=>` ${e.flattenDiagnosticMessageText(t.messageText,` `)}`).join(`
780
- `);throw Error(`${n} has ${i.length} type error(s), so its route types cannot be resolved — every entry would come out as 'any'.\n${a}\n Usually this means dependencies are not installed or the server does not type-check.`)}function Hi(e){return`_K${e}`}function Ui(e,t){let n=`./`+ct(e).replace(/\.tsx?$/,``),r=t.map((e,t)=>`type ${Hi(t)} = KickRoutes.Api[${JSON.stringify(e)}]`);return[`import ${JSON.stringify(n)}`,...r].join(`
778
+ `:r)}typeOfProperty(e){let t=this.checker;if(typeof t.getTypeOfSymbol==`function`)return t.getTypeOfSymbol(e);let n=e.valueDeclaration??e.declarations?.[0];return n?this.checker.getTypeOfSymbolAtLocation(e,n):this.checker.getDeclaredTypeOfSymbol(e)}renderPropertyType(e,t,n,r){if(!t||!e.isUnion()||this.declaresUndefined(n))return this.render(e,r);let i=e.types.filter(e=>!(e.flags&this.ts.TypeFlags.Undefined));return i.length===0?`undefined`:i.map(e=>this.render(e,r)).join(` | `)}isReadonlyProp(e){let t=e.valueDeclaration??e.declarations?.[0];return t?(this.ts.getCombinedModifierFlags(t)&this.ts.ModifierFlags.Readonly)!==0:!1}declaresUndefined(e){let t=e.valueDeclaration??e.declarations?.[0];if(!t||!(this.ts.isPropertySignature(t)||this.ts.isPropertyDeclaration(t))||!t.type)return!1;let n=this.checker.getTypeFromTypeNode(t.type);return(n.isUnion()?n.types:[n]).some(e=>(e.flags&this.ts.TypeFlags.Undefined)!==0)}renderTuple(e,t){let n=this.ts.ElementFlags,r=this.checker.getTypeArguments(e),i=e.target,a=i.elementFlags??[],o=r.map((e,r)=>{let i=a[r]??n.Required;return i&n.Optional?`${(e.isUnion()?e.types.filter(e=>!(e.flags&this.ts.TypeFlags.Undefined)):[e]).map(e=>this.render(e,t+1)).join(` | `)}?`:i&n.Rest?`...${this.render(e,t+1)}[]`:i&n.Variadic?`...${this.render(e,t+1)}`:this.render(e,t+1)});return`${i.readonly?`readonly `:``}[${o.join(`, `)}]`}propName(e){return/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(e)?e:JSON.stringify(e)}isLibType(e){let t=e.aliasSymbol?.declarations??e.getSymbol()?.declarations;return!t||t.length===0?!1:t.every(e=>this.program.isSourceFileDefaultLibrary(e.getSourceFile()))}renderLibType(e,t){let n=(e.aliasSymbol??e.getSymbol())?.getName(),r=e.aliasTypeArguments??this.typeArguments(e);return!n||r.length===0?this.checker.typeToString(e,void 0,this.printFlags):`${n}<${r.map(e=>this.render(e,t+1)).join(`, `)}>`}typeArguments(e){return!(e.flags&this.ts.TypeFlags.Object)||!(e.objectFlags&this.ts.ObjectFlags.Reference)?[]:this.checker.getTypeArguments(e)}toJsonType(e){if(!(e.flags&this.ts.TypeFlags.Object))return null;let t=this.checker.getPropertyOfType(e,`toJSON`);if(!t)return null;let[n]=this.checker.getSignaturesOfType(this.typeOfProperty(t),this.ts.SignatureKind.Call);if(!n)return null;let r=this.checker.getReturnTypeOfSignature(n);return r===e?null:r}isCallable(e){if(e.isUnion()){let t=e.types.filter(e=>!(e.flags&(this.ts.TypeFlags.Undefined|this.ts.TypeFlags.Null)));return t.length>0&&t.every(e=>this.isCallable(e))}return this.checker.getSignaturesOfType(e,this.ts.SignatureKind.Call).length>0||this.checker.getSignaturesOfType(e,this.ts.SignatureKind.Construct).length>0}isNamed(e){let t=e.getSymbol();if(!t)return!1;let n=t.getName();return n!==`__type`&&n!==`__object`&&n.length>0}isTuple(e){let t=this.ts.ObjectFlags;if(!(e.flags&this.ts.TypeFlags.Object)||!(e.objectFlags&t.Reference))return!1;let n=e.target;return!!(n&&n.objectFlags&t.Tuple)}arrayElement(e){let t=e.getSymbol()?.getName();if(t!==`Array`&&t!==`ReadonlyArray`)return null;let n=this.checker.getTypeArguments(e);return n.length===1?{element:n[0],readonly:t===`ReadonlyArray`}:null}};const Ii=[`pnpm-lock.yaml`,`package-lock.json`,`yarn.lock`,`bun.lock`,`bun.lockb`],Li=/(?:^|[\\/])(?:node_modules|\.kickjs)(?:[\\/]|$)/;function Ri(e){return Ct(`sha1`).update(e).digest(`hex`)}function zi(e){let t=Ct(`sha1`);t.update(e.cliVersion),t.update(JSON.stringify(e.options??{})),t.update(e.keys.join(`
779
+ `));for(let n of Ii){let r=j(e.projectDir,n);if(F(r))try{t.update(I(r))}catch(e){throw Error(`kick/client: cannot read lockfile ${r}`,{cause:e})}}for(let n of e.fileNames.toSorted())if(!Li.test(n)){t.update(n);try{t.update(I(n))}catch(e){throw Error(`kick/client: cannot read project file ${n}`,{cause:e})}}return t.digest(`hex`)}async function Bi(e){try{let t=await Mi(e.compilerFrom??e.projectDir),n={...t.sys,onUnRecoverableConfigFileDiagnostic:()=>{}},r=t.getParsedCommandLineOfConfigFile(j(e.projectDir,`tsconfig.json`),{},n);return r?zi({projectDir:e.projectDir,fileNames:r.fileNames,keys:e.keys,options:{...r.options,__kickMaxDepth:e.maxDepth??null},cliVersion:e.cliVersion}):null}catch{return null}}async function Vi(e){let t=await Mi(e.compilerFrom??e.projectDir),n=j(A(e.routesFile),`__kick_client_probe__.ts`),r=Wi(e.routesFile,e.keys),i=qi(t,e.projectDir,n,r),a=i.getTypeChecker(),o=i.getSourceFile(n);if(!o)throw Error(`kick/client: could not add the resolution probe to the program. Check that ${e.routesFile} exists — run \`kick typegen\` first.`);Hi(t,i,e.routesFile);let s=Gi(t,i,o,e.keys),c=null,l=new Fi(t,a,i,{maxDepth:e.maxDepth,onWarn:t=>e.onWarn?.(c?`route '${c}': ${t}`:t)}),u=/* @__PURE__ */ new Map;for(let[n,r]of e.keys.entries()){if(s.has(r)){e.onWarn?.(`route '${r}' is not present in KickRoutes.Api — skipped. Re-run \`kick typegen\` so the two maps agree.`);continue}let i=o.statements.find(e=>t.isTypeAliasDeclaration(e)&&e.name.text===Ui(n));if(!i){e.onWarn?.(`route '${r}' could not be resolved — skipped.`);continue}let d=a.getTypeAtLocation(i.type);d.flags&t.TypeFlags.Any?e.onWarn?.(`route '${r}' resolved to 'any' — skipped rather than emitted, since an 'any' entry silently accepts every call. Check that the server type-checks.`):(c=r,u.set(r,l.expand(d)),c=null)}return{entries:u,hoisted:l.hoisted()}}function Hi(e,t,n){let r=t.getSourceFile(n);if(!r)throw Error(`kick/client: ${n} is not in the TypeScript program. Run \`kick typegen\` first, and check that tsconfig.json includes .kickjs.`);let i=t.getSemanticDiagnostics(r);if(i.length===0)return;let a=i.slice(0,3).map(t=>` ${e.flattenDiagnosticMessageText(t.messageText,` `)}`).join(`
780
+ `);throw Error(`${n} has ${i.length} type error(s), so its route types cannot be resolved — every entry would come out as 'any'.\n${a}\n Usually this means dependencies are not installed or the server does not type-check.`)}function Ui(e){return`_K${e}`}function Wi(e,t){let n=`./`+lt(e).replace(/\.tsx?$/,``),r=t.map((e,t)=>`type ${Ui(t)} = KickRoutes.Api[${JSON.stringify(e)}]`);return[`import ${JSON.stringify(n)}`,...r].join(`
781
781
  `)+`
782
- `}function Wi(e,t,n,r){let i=/* @__PURE__ */ new Set,a=/* @__PURE__ */ new Map;for(let t of n.statements)e.isTypeAliasDeclaration(t)&&a.set(t.name.text,t);for(let e of t.getSemanticDiagnostics(n))if(e.start!==void 0)for(let[t,o]of r.entries()){let r=a.get(Hi(t));r&&e.start>=r.getStart(n)&&e.start<r.getEnd()&&i.add(o)}return i}function Gi(e,t){let n=e.filter(e=>/\.d\.(ts|mts|cts)$/.test(e)),r=[];try{r=L(t).filter(e=>e.endsWith(`.ts`)).map(e=>j(t,e))}catch{}return[.../* @__PURE__ */ new Set([...n,...r])]}function Ki(e,t,n,r){let i=j(t,`tsconfig.json`),a={...e.sys,onUnRecoverableConfigFileDiagnostic:t=>{throw Error(e.flattenDiagnosticMessageText(t.messageText,`
783
- `))}},o=e.getParsedCommandLineOfConfigFile(i,{},a);if(!o)throw Error(`kick/client: could not read ${i}`);let s=e.createCompilerHost(o.options,!0),c=s.readFile.bind(s),l=s.getSourceFile.bind(s),u=s.fileExists.bind(s);return s.readFile=e=>e===n?r:c(e),s.fileExists=e=>e===n||u(e),s.getSourceFile=(t,i,a,o)=>t===n?e.createSourceFile(t,r,i,!0):l(t,i,a,o),e.createProgram({rootNames:[...Gi(o.fileNames,A(n)),n],options:o.options,host:s})}const qi=`/* eslint-disable */
782
+ `}function Gi(e,t,n,r){let i=/* @__PURE__ */ new Set,a=/* @__PURE__ */ new Map;for(let t of n.statements)e.isTypeAliasDeclaration(t)&&a.set(t.name.text,t);for(let e of t.getSemanticDiagnostics(n))if(e.start!==void 0)for(let[t,o]of r.entries()){let r=a.get(Ui(t));r&&e.start>=r.getStart(n)&&e.start<r.getEnd()&&i.add(o)}return i}function Ki(e,t){let n=e.filter(e=>/\.d\.(ts|mts|cts)$/.test(e)),r=[];try{r=L(t).filter(e=>e.endsWith(`.ts`)).map(e=>j(t,e))}catch{}return[.../* @__PURE__ */ new Set([...n,...r])]}function qi(e,t,n,r){let i=j(t,`tsconfig.json`),a={...e.sys,onUnRecoverableConfigFileDiagnostic:t=>{throw Error(e.flattenDiagnosticMessageText(t.messageText,`
783
+ `))}},o=e.getParsedCommandLineOfConfigFile(i,{},a);if(!o)throw Error(`kick/client: could not read ${i}`);let s=e.createCompilerHost(o.options,!0),c=s.readFile.bind(s),l=s.getSourceFile.bind(s),u=s.fileExists.bind(s);return s.readFile=e=>e===n?r:c(e),s.fileExists=e=>e===n||u(e),s.getSourceFile=(t,i,a,o)=>t===n?e.createSourceFile(t,r,i,!0):l(t,i,a,o),e.createProgram({rootNames:[...Ki(o.fileNames,A(n)),n],options:o.options,host:s})}const Ji=`/* eslint-disable */
784
784
  // AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
785
785
  //
786
786
  // Self-contained: this file has no imports, so a frontend consumes it without
@@ -794,7 +794,7 @@ ${_}
794
794
  //
795
795
  // Written when \`kick dev\` starts, not on save — resolving these types builds a
796
796
  // full TypeScript program over the server. Re-run \`kick typegen\`.
797
- `;function Ji(e,t){let n=t.filter(t=>e.entries.has(t));if(n.length===0)return`${qi}
797
+ `;function Yi(e,t){let n=t.filter(t=>e.entries.has(t));if(n.length===0)return`${Ji}
798
798
  // (no routes discovered yet — annotate a controller method with
799
799
  // @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
800
800
  interface Api {}
@@ -811,7 +811,7 @@ export type { Api }
811
811
 
812
812
  `)+`
813
813
 
814
- `:``,i=n.map(t=>` ${JSON.stringify(t)}: ${e.entries.get(t)}`);return`${qi}
814
+ `:``,i=n.map(t=>` ${JSON.stringify(t)}: ${e.entries.get(t)}`);return`${Ji}
815
815
  ${r}interface Api {
816
816
  ${i.join(`
817
817
  `)}
@@ -825,7 +825,7 @@ declare global {
825
825
  }
826
826
 
827
827
  export type { Api }
828
- `}const Yi=`kick/client`,Q=`.kickjs/types/kick__client.d.ts`,Xi=`.kickjs/cache/client-map.sha1`,Zi=(()=>{try{return st(import.meta.url)(`../../../package.json`).version??`0.0.0`}catch{return`0.0.0`}})();function Qi(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 $i(e){return`${dn}${Yi} */\n\n${e}\n`}function ea(e){try{return F(e)?I(e,`utf-8`):null}catch{return null}}async function ta(e){let t=k.resolve(e.cwd,Q);if(!F(t))return!1;try{await gt(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 na(e){let t=e?.typegen?.client;return typeof t==`object`?t.maxDepth:void 0}function ra(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 ia=()=>({id:Yi,outExtension:`.d.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){if(!ra(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=/* @__PURE__ */ new Set;for(let e of t.routes){let t=`${e.httpMethod} ${e.mountedPath??e.path}`;r.has(t)||(r.add(t),n.push(t))}let i=na(e.config),a=await zi({projectDir:e.cwd,keys:n,maxDepth:i,cliVersion:Zi}),o=Qi(k.resolve(e.cwd,Xi)),s=ea(k.resolve(e.cwd,Q));if(a&&o&&s!==null&&o.inputs===a&&o.output===Li(s))return le()&&e.log.info?.(` kick/client: unchanged, keeping ${Q}`),null;try{let t=Ji(await Bi({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} ${Li($i(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):le()&&e.log.info?.(r),n&&await ta(e),null}}});function aa(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 */
828
+ `}const Xi=`kick/client`,Q=`.kickjs/types/kick__client.d.ts`,Zi=`.kickjs/cache/client-map.sha1`,Qi=(()=>{try{return ct(import.meta.url)(`../../../package.json`).version??`0.0.0`}catch{return`0.0.0`}})();function $i(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 ea(e){return`${fn}${Xi} */\n\n${e}\n`}function ta(e){try{return F(e)?I(e,`utf-8`):null}catch{return null}}async function na(e){let t=k.resolve(e.cwd,Q);if(!F(t))return!1;try{await _t(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 ra(e){let t=e?.typegen?.client;return typeof t==`object`?t.maxDepth:void 0}function ia(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 aa=()=>({id:Xi,outExtension:`.d.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){if(!ia(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=/* @__PURE__ */ new Set;for(let e of t.routes){let t=`${e.httpMethod} ${e.mountedPath??e.path}`;r.has(t)||(r.add(t),n.push(t))}let i=ra(e.config),a=await Bi({projectDir:e.cwd,keys:n,maxDepth:i,cliVersion:Qi}),o=$i(k.resolve(e.cwd,Zi)),s=ta(k.resolve(e.cwd,Q));if(a&&o&&s!==null&&o.inputs===a&&o.output===Ri(s))return le()&&e.log.info?.(` kick/client: unchanged, keeping ${Q}`),null;try{let t=Yi(await Vi({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(Zi,`${a} ${Ri(ea(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):le()&&e.log.info?.(r),n&&await na(e),null}}});function oa(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 */
829
829
  // AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
830
830
  // Re-run with \`kick typegen\` or rely on \`kick dev\` to refresh.
831
831
 
@@ -863,6 +863,6 @@ declare global {
863
863
  }
864
864
 
865
865
  export {}
866
- `}const oa=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=ca(e);if(t===!1)return null;let n=await e.getScanResult({root:sa(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 aa(n.env,i,r)}});function sa(e){return k.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function ca(e){return e.config?.typegen?.envFile}function la(e){return k.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function ua(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function $(e){return{root:la(e),cwd:e.cwd,envFile:ua(e)}}const da=()=>({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 Ke(t.classes,n,r)}}),fa=()=>({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=Xe(t.classes,t.tokens,t.injects,n);return Ze(`ServiceToken`,r,"(no tokens discovered — declare with createToken<T>() or `kick g service <name>`)")}}),pa=()=>({id:`kick/modules`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return Ze(`ModuleToken`,We(t.classes),"(no @Module classes discovered — `kick g module <name>` to add one)")}}),ma=()=>({id:`kick/plugins`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return Ge(t.pluginsAndAdapters)}}),ha=()=>({id:`kick/context`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return t.contextKeys.length===0?null:rt(t.contextKeys)}}),ga=()=>({id:`kick/route-flags`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return $e(t.routeFlags)}}),_a={fastify:{subpath:`@forinda/kickjs/fastify`,typeName:`FastifyRuntimeTypes`},h3:{subpath:`@forinda/kickjs/h3`,typeName:`H3RuntimeTypes`}},va=[D({name:`kick/init`,register:kt}),D({name:`kick/generate`,register:ln}),D({name:`kick/run`,register:Dn}),D({name:`kick/info`,register:Mn}),D({name:`kick/inspect`,register:Vn}),D({name:`kick/add`,register:je}),D({name:`kick/list`,register:Ne}),D({name:`kick/explain`,register:Xn}),D({name:`kick/mcp`,register:or}),D({name:`kick/tinker`,register:ur}),D({name:`kick/remove`,register:gr}),D({name:`kick/typegen`,register:yr}),D({name:`kick/check`,register:Rr}),D({name:`kick/doctor`,register:ve}),D({name:`kick/env-command`,register:Gr}),D({name:`kick/codemod`,register:qr}),D({name:`kick/deploy`,register:mi}),D({name:`kick/registry`,typegens:[da()]}),D({name:`kick/services`,typegens:[fa()]}),D({name:`kick/modules`,typegens:[pa()]}),D({name:`kick/plugins`,typegens:[ma()]}),D({name:`kick/context`,typegens:[ha()]}),D({name:`kick/route-flags`,typegens:[ga()]}),D({name:`kick/assets`,typegens:[hi()]}),D({name:`kick/routes`,typegens:[Ti()]}),D({name:`kick/client`,typegens:[ia()]}),D({name:`kick/env`,typegens:[oa()]}),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}=_a[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(`
867
- `)}}]})];export{mn as applyDisableFilter,hn as n,At as r,G as runAllPluginTypegens,va as t};
868
- //# sourceMappingURL=run-plugins-Du6FlB7_.mjs.map
866
+ `}const sa=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=la(e);if(t===!1)return null;let n=await e.getScanResult({root:ca(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 oa(n.env,i,r)}});function ca(e){return k.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function la(e){return e.config?.typegen?.envFile}function ua(e){return k.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function da(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function $(e){return{root:ua(e),cwd:e.cwd,envFile:da(e)}}const fa=()=>({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 qe(t.classes,n,r)}}),pa=()=>({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=Ze(t.classes,t.tokens,t.injects,n);return Qe(`ServiceToken`,r,"(no tokens discovered — declare with createToken<T>() or `kick g service <name>`)")}}),ma=()=>({id:`kick/modules`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return Qe(`ModuleToken`,Ge(t.classes),"(no @Module classes discovered — `kick g module <name>` to add one)")}}),ha=()=>({id:`kick/plugins`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return Ke(t.pluginsAndAdapters)}}),ga=()=>({id:`kick/context`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return t.contextKeys.length===0?null:it(t.contextKeys)}}),_a=()=>({id:`kick/route-flags`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return et(t.routeFlags)}}),va={fastify:{subpath:`@forinda/kickjs/fastify`,typeName:`FastifyRuntimeTypes`},h3:{subpath:`@forinda/kickjs/h3`,typeName:`H3RuntimeTypes`}},ya=[D({name:`kick/init`,register:At}),D({name:`kick/generate`,register:un}),D({name:`kick/run`,register:On}),D({name:`kick/info`,register:Nn}),D({name:`kick/inspect`,register:Hn}),D({name:`kick/add`,register:Me}),D({name:`kick/list`,register:Pe}),D({name:`kick/explain`,register:Zn}),D({name:`kick/mcp`,register:sr}),D({name:`kick/tinker`,register:dr}),D({name:`kick/remove`,register:_r}),D({name:`kick/typegen`,register:br}),D({name:`kick/check`,register:zr}),D({name:`kick/doctor`,register:ve}),D({name:`kick/env-command`,register:Kr}),D({name:`kick/codemod`,register:Jr}),D({name:`kick/deploy`,register:hi}),D({name:`kick/registry`,typegens:[fa()]}),D({name:`kick/services`,typegens:[pa()]}),D({name:`kick/modules`,typegens:[ma()]}),D({name:`kick/plugins`,typegens:[ha()]}),D({name:`kick/context`,typegens:[ga()]}),D({name:`kick/route-flags`,typegens:[_a()]}),D({name:`kick/assets`,typegens:[gi()]}),D({name:`kick/routes`,typegens:[Ei()]}),D({name:`kick/client`,typegens:[aa()]}),D({name:`kick/env`,typegens:[sa()]}),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}=va[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(`
867
+ `)}}]})];export{hn as applyDisableFilter,gn as n,jt as r,G as runAllPluginTypegens,ya as t};
868
+ //# sourceMappingURL=run-plugins-DY4qiPTu.mjs.map