@forinda/kickjs-cli 8.17.3 → 8.17.4

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 (40) hide show
  1. package/dist/{agent-docs-BkQx62G6.mjs → agent-docs-BKbdsDUQ.mjs} +16 -16
  2. package/dist/{agent-docs-BkQx62G6.mjs.map → agent-docs-BKbdsDUQ.mjs.map} +1 -1
  3. package/dist/{agent-docs-BxHRHi1r.mjs → agent-docs-sMPVd5vN.mjs} +11 -11
  4. package/dist/build-DWbnilcJ.mjs +12 -0
  5. package/dist/build-NyFTqWDy.mjs +13 -0
  6. package/dist/{build-CARdsp9F.mjs.map → build-NyFTqWDy.mjs.map} +1 -1
  7. package/dist/{builtins-Cb02IU36.mjs → builtins-DaPdtAiN.mjs} +2 -2
  8. package/dist/{builtins-BOWp16P2.mjs → builtins-MVDZcuck.mjs} +9 -9
  9. package/dist/cli.mjs +2 -2
  10. package/dist/{config-CadmyiYh.mjs → config-BVw4TFDJ.mjs} +2 -2
  11. package/dist/{config-DoZ1J2Kh.mjs → config-kPWo_HS4.mjs} +3 -3
  12. package/dist/{config-DoZ1J2Kh.mjs.map → config-kPWo_HS4.mjs.map} +1 -1
  13. package/dist/{doctor-C4bdYrM6.mjs → doctor-Bmm7jTXk.mjs} +8 -8
  14. package/dist/{doctor-C4bdYrM6.mjs.map → doctor-Bmm7jTXk.mjs.map} +1 -1
  15. package/dist/{fullstack-DjV35qtY.mjs → fullstack-Dj6nndJI.mjs} +4 -4
  16. package/dist/{fullstack-DjV35qtY.mjs.map → fullstack-Dj6nndJI.mjs.map} +1 -1
  17. package/dist/{fullstack-CiPh1wb_.mjs → fullstack-HXrTvDQS.mjs} +10 -10
  18. package/dist/index.d.mts +0 -50
  19. package/dist/index.d.mts.map +1 -1
  20. package/dist/index.mjs +2 -2
  21. package/dist/{plugin-D8VpKAVP.mjs → plugin-CEIikRk4.mjs} +2 -2
  22. package/dist/{plugin-BAlAQlkw.mjs → plugin-DxBBBZKs.mjs} +2 -2
  23. package/dist/{project-Bjk2dJc2.mjs → project--dWQ_c8m.mjs} +31 -18
  24. package/dist/{project-CzMPptXL.mjs → project-BFGUN5KK.mjs} +20 -7
  25. package/dist/{project-CzMPptXL.mjs.map → project-BFGUN5KK.mjs.map} +1 -1
  26. package/dist/{project-root-BHqLKyr9.mjs → project-root-CKK8LRzQ.mjs} +3 -3
  27. package/dist/{project-root-BHqLKyr9.mjs.map → project-root-CKK8LRzQ.mjs.map} +1 -1
  28. package/dist/{project-root-Ck8UKRHG.mjs → project-root-tvtMzer4.mjs} +2 -2
  29. package/dist/{rolldown-runtime-BjnQdm0J.mjs → rolldown-runtime-BxKUidhj.mjs} +1 -1
  30. package/dist/{run-plugins-BrI7b2Y5.mjs → run-plugins-CisH0EMY.mjs} +147 -147
  31. package/dist/{run-plugins-BrI7b2Y5.mjs.map → run-plugins-CisH0EMY.mjs.map} +1 -1
  32. package/dist/{typegen-D17TQ6Uy.mjs → typegen-_fQVGRr8.mjs} +5 -5
  33. package/dist/{typegen-D17TQ6Uy.mjs.map → typegen-_fQVGRr8.mjs.map} +1 -1
  34. package/dist/{typegen-0Ffq-YuL.mjs → typegen-dZuP30n-.mjs} +4 -4
  35. package/dist/{types-Bp0MoCVq.mjs → types-DNpeagtq.mjs} +1 -1
  36. package/package.json +8 -8
  37. package/templates/feature-storage/files/_dot_env.example.append +6 -0
  38. package/templates/feature-storage/files/src/adapters/storage.ts +2 -2
  39. package/dist/build-CARdsp9F.mjs +0 -13
  40. package/dist/build-I3pY30S2.mjs +0 -12
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs-cli v8.17.3
2
+ * @forinda/kickjs-cli v8.17.4
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-BjnQdm0J.mjs";import{C as t,S as n,_ as r,a as i,b as a,d as o,f as s,g as c,h as l,i as u,m as d,n as f,o as p,p as m,u as h,v as g,x as _,y as v}from"./agent-docs-BkQx62G6.mjs";import{A as y,C as b,D as x,E as ee,F as S,M as te,N as ne,O as re,P as C,S as ie,T as ae,_ as oe,a as se,b as ce,c as le,f as ue,g as de,h as fe,i as pe,j as me,k as he,l as ge,m as _e,p as ve,r as ye,u as be,v as xe,w as Se,x as Ce,y as we}from"./doctor-C4bdYrM6.mjs";import{a as Te,c as w,d as Ee,f as De,h as Oe,l as T,m as ke,o as Ae,p as je,s as E,u as Me}from"./config-DoZ1J2Kh.mjs";import{_ as Ne,a as Pe,b as Fe,d as Ie,g as Le,h as Re,l as ze,m as Be,n as Ve,o as He,p as Ue,r as We,s as D,t as Ge,u as Ke,v as qe,x as Je,y as Ye}from"./project-CzMPptXL.mjs";import{t as O}from"./project-root-BHqLKyr9.mjs";import{n as k,t as Xe}from"./types-Bp0MoCVq.mjs";import{t as Ze}from"./build-CARdsp9F.mjs";import{C as Qe,S as $e,_ as et,a as tt,b as nt,c as rt,d as it,f as at,g as ot,h as st,i as ct,l as lt,m as ut,o as dt,p as ft,r as pt,s as mt,t as ht,u as gt,v as _t,w as vt,x as A,y as yt}from"./typegen-D17TQ6Uy.mjs";import{createRequire as bt}from"node:module";import j,{basename as xt,dirname as M,join as N,relative as P,resolve as F,sep as I}from"node:path";import{cpSync as St,existsSync as L,mkdirSync as Ct,readFileSync as R,readdirSync as z,rmSync as wt,statSync as Tt,writeFileSync as B}from"node:fs";import{copyFile as Et,mkdir as Dt,readFile as V,readdir as Ot,rm as kt,stat as At,writeFile as jt}from"node:fs/promises";import{fork as Mt,spawn as Nt,spawnSync as Pt}from"node:child_process";import{createHash as Ft}from"node:crypto";import{fileURLToPath as It,pathToFileURL as H}from"node:url";import{parseSync as Lt}from"oxc-parser";import{arch as Rt,platform as zt,release as Bt}from"node:os";const Vt=[{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`},{value:`views`,label:`Views`,hint:`server-rendered .kick templates`}];function Ht(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(`--deploy <targets>`,`Comma-separated deploy targets to write files for: netlify, vercel, docker (later: kick g deploy)`).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)=>{o(`KickJS — Create a new project`);let n=We(),a=e=>{e&&s.warn(`kick ${Ge} is behind the latest release, ${e} — templates and options added since are missing. Upgrade: npm i -g @forinda/kickjs-cli@latest`)},c=[];try{c=t.deploy?Je(t.deploy):[]}catch(e){s.error(e.message),d(`Aborted.`),process.exitCode=1;return}let u=!!(t.yes||t.nonInteractive);e||=u?`my-api`:await r({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let f;if(e===`.`?(f=F(`.`),e=xt(f)):f=F(t.directory||e),L(f)){let n=z(f);if(n.length>0){if(t.force)s.warn(`Clearing existing files in ${f}`);else if(u){s.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),d(`Aborted.`);return}else{s.warn(`Directory "${e}" is not empty:`);let t=n.slice(0,5);for(let e of t)s.message(` - ${e}`);if(n.length>5&&s.message(` ... and ${n.length-5} more`),!await h({message:v.red(`Remove all existing files and proceed?`),initialValue:!1})){d(`Aborted.`);return}}for(let e of n)wt(F(f,e),{recursive:!0,force:!0})}}u||a(await Promise.race([n,new Promise(e=>setTimeout(e,3e3,null).unref())]));let p=t.template;p||=u?`minimal`:await l({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 g=t.runtime;g||=u?`express`:await l({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 _=t.pm;_||=u?await i(void 0):await l({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let y=t.repo;y||=u?`inmemory`:await r({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),Oe(y);let b=t.schema;p===`inertia`&&(b&&b!==`zod`&&s.warn(`The inertia template uses zod — ignoring --schema ${b}.`),b=`zod`),b||=u?`zod`:await l({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(b)||(s.warn(`Unknown --schema "${b}", falling back to zod.`),b=`zod`);let x;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();x=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else x=u?[]:await m({message:`Select packages to include`,options:[...Vt],required:!1});let ee;ee=t.git===void 0?u?!0:await h({message:`Initialize git repository?`,initialValue:!0}):t.git;let S;if(S=t.install===void 0?u?!0:await h({message:`Install dependencies?`,initialValue:!0}):t.install,t.frontend!==void 0&&t.frontend!==`kick`&&t.frontend!==`vite`){s.error(`Unknown --frontend '${String(t.frontend)}'. Use 'kick' (wired React app) or 'vite' (create-vite).`),d(`Aborted.`);return}let{VITE_TEMPLATES:te,DEFAULT_VITE_TEMPLATE:ne}=await import(`./fullstack-DjV35qtY.mjs`);if(t.viteTemplate!==void 0&&!te.some(e=>e.value===t.viteTemplate)){s.error(`Unknown --vite-template '${String(t.viteTemplate)}'. TypeScript templates only: ${te.map(e=>e.value).join(`, `)}.`),d(`Aborted.`);return}let re=t.frontend===`vite`?`vite`:`kick`,C=t.viteTemplate??ne;if(p===`fullstack`&&!t.frontend&&!u&&(re=await l({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)`}]})),re===`vite`&&!t.viteTemplate&&!u&&(C=await l({message:`create-vite template`,options:te.map(e=>({value:e.value,label:e.label})),initialValue:ne})),p===`fullstack`){let{initFullstackProject:t}=await import(`./fullstack-DjV35qtY.mjs`);await t({name:e,directory:f,packageManager:_,initGit:ee,installDeps:S,schemaLib:b,runtime:g,packages:x,frontend:re,viteTemplate:C,deploy:c}),u&&a(await n),d(`Done! Next steps: ${v.cyan(`cd ${e} && ${_}${_===`pnpm`?` dev`:` run dev:server`}`)}`)}else await Ve({name:e,directory:f,packageManager:_,initGit:ee,installDeps:S,template:p,defaultRepo:y,packages:x,schemaLib:b,runtime:g,deploy:c}),u&&a(await n),d(`Done! Next steps: ${v.cyan(`cd ${e} && ${je(_,`dev`)}`)}`)})}function Ut(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 Xe(`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 Xe(`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 Xe(`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 Xe(`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-BHqLKyr9.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 Wt(e){let{name:n,outDir:r}=e,i=C(n),a=S(n),o=[],s=N(r,`${i}.plugin.ts`);return await t(s,`import {
11
+ import{t as e}from"./rolldown-runtime-BxKUidhj.mjs";import{n as t,t as n}from"./types-DNpeagtq.mjs";import{_ as r,a as i,b as a,d as o,g as s,h as c,l,m as u,n as d,o as f,p,r as m,s as h,t as g,u as _,v,x as y,y as b}from"./project-BFGUN5KK.mjs";import{C as x,S,_ as ee,a as te,b as ne,d as re,f as C,g as ie,h as w,i as T,m as E,n as ae,o as oe,p as se,u as ce,v as le,x as ue,y as D}from"./agent-docs-BKbdsDUQ.mjs";import{a as de,c as O,d as fe,f as pe,h as me,l as k,m as he,o as ge,p as _e,s as A,u as ve}from"./config-kPWo_HS4.mjs";import{A as ye,C as be,D as xe,E as Se,F as Ce,M as we,N as Te,O as Ee,P as De,S as Oe,T as ke,_ as Ae,a as je,b as Me,c as Ne,f as Pe,g as Fe,h as Ie,i as Le,j as Re,k as ze,l as Be,m as Ve,p as He,r as Ue,u as We,v as Ge,w as Ke,x as qe,y as Je}from"./doctor-Bmm7jTXk.mjs";import{t as j}from"./project-root-CKK8LRzQ.mjs";import{C as Ye,S as Xe,_ as Ze,a as Qe,b as $e,c as et,d as tt,f as nt,g as rt,h as it,i as at,l as ot,m as st,o as ct,p as lt,r as ut,s as dt,t as ft,u as pt,v as mt,w as ht,x as M,y as gt}from"./typegen-_fQVGRr8.mjs";import{t as _t}from"./build-NyFTqWDy.mjs";import{createRequire as vt}from"node:module";import N,{basename as yt,dirname as P,join as F,relative as I,resolve as L,sep as R}from"node:path";import{cpSync as bt,existsSync as z,mkdirSync as xt,readFileSync as B,readdirSync as V,rmSync as St,statSync as Ct,writeFileSync as H}from"node:fs";import{copyFile as wt,mkdir as Tt,readFile as U,readdir as Et,rm as Dt,stat as Ot,writeFile as kt}from"node:fs/promises";import{fork as At,spawn as jt,spawnSync as Mt}from"node:child_process";import{createHash as Nt}from"node:crypto";import{fileURLToPath as Pt,pathToFileURL as W}from"node:url";import{parseSync as Ft}from"oxc-parser";import{arch as It,platform as Lt,release as Rt}from"node:os";const zt=[{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`},{value:`views`,label:`Views`,hint:`server-rendered .kick templates`}];function Bt(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(`--deploy <targets>`,`Comma-separated deploy targets to write files for: netlify, vercel, docker (later: kick g deploy)`).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)=>{re(`KickJS — Create a new project`);let n=m(),r=e=>{e&&C.warn(`kick ${g} is behind the latest release, ${e} — templates and options added since are missing. Upgrade: npm i -g @forinda/kickjs-cli@latest`)},i=[];try{i=t.deploy?y(t.deploy):[]}catch(e){C.error(e.message),E(`Aborted.`),process.exitCode=1;return}let a=!!(t.yes||t.nonInteractive);e||=a?`my-api`:await ee({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let o;if(e===`.`?(o=L(`.`),e=yt(o)):o=L(t.directory||e),z(o)){let n=V(o);if(n.length>0){if(t.force)C.warn(`Clearing existing files in ${o}`);else if(a){C.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),E(`Aborted.`);return}else{C.warn(`Directory "${e}" is not empty:`);let t=n.slice(0,5);for(let e of t)C.message(` - ${e}`);if(n.length>5&&C.message(` ... and ${n.length-5} more`),!await ce({message:D.red(`Remove all existing files and proceed?`),initialValue:!1})){E(`Aborted.`);return}}for(let e of n)St(L(o,e),{recursive:!0,force:!0})}}a||r(await Promise.race([n,new Promise(e=>setTimeout(e,3e3,null).unref())]));let s=t.template;s||=a?`minimal`:await w({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||=a?`express`:await w({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 l=t.pm;l||=a?await te(void 0):await w({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let u=t.repo;u||=a?`inmemory`:await ee({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),me(u);let f=t.schema;s===`inertia`&&(f&&f!==`zod`&&C.warn(`The inertia template uses zod — ignoring --schema ${f}.`),f=`zod`),f||=a?`zod`:await w({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(f)||(C.warn(`Unknown --schema "${f}", falling back to zod.`),f=`zod`);let p;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();p=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else p=a?[]:await se({message:`Select packages to include`,options:[...zt],required:!1});let h;h=t.git===void 0?a?!0:await ce({message:`Initialize git repository?`,initialValue:!0}):t.git;let _;if(_=t.install===void 0?a?!0:await ce({message:`Install dependencies?`,initialValue:!0}):t.install,t.frontend!==void 0&&t.frontend!==`kick`&&t.frontend!==`vite`){C.error(`Unknown --frontend '${String(t.frontend)}'. Use 'kick' (wired React app) or 'vite' (create-vite).`),E(`Aborted.`);return}let{VITE_TEMPLATES:v,DEFAULT_VITE_TEMPLATE:b}=await import(`./fullstack-Dj6nndJI.mjs`);if(t.viteTemplate!==void 0&&!v.some(e=>e.value===t.viteTemplate)){C.error(`Unknown --vite-template '${String(t.viteTemplate)}'. TypeScript templates only: ${v.map(e=>e.value).join(`, `)}.`),E(`Aborted.`);return}let x=t.frontend===`vite`?`vite`:`kick`,S=t.viteTemplate??b;if(s===`fullstack`&&!t.frontend&&!a&&(x=await w({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)`}]})),x===`vite`&&!t.viteTemplate&&!a&&(S=await w({message:`create-vite template`,options:v.map(e=>({value:e.value,label:e.label})),initialValue:b})),s===`fullstack`){let{initFullstackProject:t}=await import(`./fullstack-Dj6nndJI.mjs`);await t({name:e,directory:o,packageManager:l,initGit:h,installDeps:_,schemaLib:f,runtime:c,packages:p,frontend:x,viteTemplate:S,deploy:i}),a&&r(await n),E(`Done! Next steps: ${D.cyan(`cd ${e} && ${l}${l===`pnpm`?` dev`:` run dev:server`}`)}`)}else await d({name:e,directory:o,packageManager:l,initGit:h,installDeps:_,template:s,defaultRepo:u,packages:p,schemaLib:f,runtime:c,deploy:i}),a&&r(await n),E(`Done! Next steps: ${D.cyan(`cd ${e} && ${_e(l,`dev`)}`)}`)})}function Vt(e,t=[]){let r=/* @__PURE__ */ new Map;for(let t of e){let e=(r.get(t.name)??0)+1;if(r.set(t.name,e),e===2)throw new n(`plugin`,t.name,[t.name,t.name])}let i=/* @__PURE__ */ new Map,a=[];for(let t of e)for(let e of t.commands??[]){let r=i.get(e.name);if(r)throw new n(`command`,e.name,[r,t.name]);i.set(e.name,t.name),a.push(e)}let o=new Set(t.map(e=>e.name)),s=[...a.filter(e=>!o.has(e.name)),...t],c=/* @__PURE__ */ new Map,l=[];for(let t of e)for(let e of t.typegens??[]){let r=c.get(e.id);if(r)throw new n(`typegen`,e.id,[r,t.name]);c.set(e.id,t.name),l.push(e)}let u=/* @__PURE__ */ new Map,d=[];for(let t of e)for(let e of t.generators??[]){let r=u.get(e.name);if(r)throw new n(`generator`,e.name,[r,t.name]);u.set(e.name,t.name),d.push({source:t.name,spec:e})}return{commands:s,typegens:l,generators:d,register:async(t,n)=>{let r;if(n)r={generators:d,...n};else{let{findProjectRoot:e}=await import(`./project-root-CKK8LRzQ.mjs`).then(e=>e.n),t=process.cwd();r={cwd:t,projectRoot:e(t),config:null,log:()=>{},generators:d}}for(let n of e)n.register&&await n.register(t,r)}}}async function Ht(e){let{name:t,outDir:n}=e,r=De(t),i=Ce(t),a=[],o=F(n,`${r}.plugin.ts`);return await x(o,`import {
12
12
  definePlugin,
13
13
  type AppAdapter,
14
14
  type AppModuleEntry,
@@ -17,21 +17,21 @@ import{t as e}from"./rolldown-runtime-BjnQdm0J.mjs";import{C as t,S as n,_ as r,
17
17
  } from '@forinda/kickjs'
18
18
 
19
19
  /**
20
- * Configuration for the ${a} plugin.
20
+ * Configuration for the ${i} plugin.
21
21
  *
22
22
  * Plugins typically take a small config object so callers can tune
23
23
  * behaviour at bootstrap time. Keep the shape narrow — anything
24
24
  * derived from the environment should be read inside the build
25
25
  * function via getEnv(), not forced onto the caller.
26
26
  */
27
- export interface ${a}PluginConfig {
27
+ export interface ${i}PluginConfig {
28
28
  // Add your plugin config here, e.g.:
29
29
  // enabled?: boolean
30
30
  // apiKey?: string
31
31
  }
32
32
 
33
33
  /**
34
- * ${a} plugin — built via \`definePlugin()\` so callers get the
34
+ * ${i} plugin — built via \`definePlugin()\` so callers get the
35
35
  * factory's call / \`.scoped()\` / \`.async()\` surfaces for free.
36
36
  *
37
37
  * A plugin bundles DI bindings, modules, adapters, and middleware
@@ -61,16 +61,16 @@ export interface ${a}PluginConfig {
61
61
  * @example
62
62
  * \`\`\`ts
63
63
  * import { bootstrap } from '@forinda/kickjs'
64
- * import { ${a}Plugin } from './plugins/${i}.plugin'
64
+ * import { ${i}Plugin } from './plugins/${r}.plugin'
65
65
  *
66
66
  * export const app = await bootstrap({
67
67
  * modules,
68
- * plugins: [${a}Plugin({ /* config overrides *\\/ })],
68
+ * plugins: [${i}Plugin({ /* config overrides *\\/ })],
69
69
  * })
70
70
  * \`\`\`
71
71
  */
72
- export const ${a}Plugin = definePlugin<${a}PluginConfig>({
73
- name: '${a}Plugin',
72
+ export const ${i}Plugin = definePlugin<${i}PluginConfig>({
73
+ name: '${i}Plugin',
74
74
  defaults: {
75
75
  // Default config values go here
76
76
  },
@@ -136,12 +136,12 @@ export const ${a}Plugin = definePlugin<${a}PluginConfig>({
136
136
  return [
137
137
  // Example:
138
138
  // import { defineHttpContextDecorator } from '@forinda/kickjs'
139
- // declare module '@forinda/kickjs' { interface ContextMeta { ${i}: { foo: string } } }
140
- // const Load${a} = defineHttpContextDecorator({
141
- // key: '${i}',
142
- // resolve: (ctx) => ({ foo: ctx.req.headers['x-${i}'] as string }),
139
+ // declare module '@forinda/kickjs' { interface ContextMeta { ${r}: { foo: string } } }
140
+ // const Load${i} = defineHttpContextDecorator({
141
+ // key: '${r}',
142
+ // resolve: (ctx) => ({ foo: ctx.req.headers['x-${r}'] as string }),
143
143
  // })
144
- // return [Load${a}.registration]
144
+ // return [Load${i}.registration]
145
145
  ]
146
146
  },
147
147
 
@@ -152,7 +152,7 @@ export const ${a}Plugin = definePlugin<${a}PluginConfig>({
152
152
  */
153
153
  async onReady(_container: Container): Promise<void> {
154
154
  // const log = _container.resolve(Logger)
155
- // log.info('${a} plugin ready')
155
+ // log.info('${i} plugin ready')
156
156
  },
157
157
 
158
158
  /**
@@ -165,67 +165,67 @@ export const ${a}Plugin = definePlugin<${a}PluginConfig>({
165
165
  // Example: await this.connection?.close()
166
166
  },
167
167
 
168
- ${ce(i,a,`plugin`,` `)}
168
+ ${Me(r,i,`plugin`,` `)}
169
169
  }),
170
170
  })
171
- `),o.push(s),o}function Gt(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 Kt(e){let{name:n,moduleName:r,modulesDir:i,pattern:a}=e,o=e.type??`http`,s=C(n),c=S(n),l=e.key??ne(n),u=Array.isArray(e.params)?e.params:Gt(e.params),d=xe({type:`contributor`,outDir:e.outDir,moduleName:r,modulesDir:i,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
- `)}\n}\n`:``,h=u.length>0?`${f}.withParams<${c}Params>()({`:`${f}({`,g=u.length>0?` // Every call site must supply these — no placeholder defaults.
171
+ `),a.push(o),a}function Ut(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 Wt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=e.type??`http`,o=De(t),s=Ce(t),c=e.key??Te(t),l=Array.isArray(e.params)?e.params:Ut(e.params),u=Ge({type:`contributor`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/contributors`,pattern:i,shouldPluralize:e.pluralize??!1}),d=a===`http`?`defineHttpContextDecorator`:`defineContextDecorator`,f=a===`http`?`RequestContext`:`ExecutionContext`,p=l.length>0?`\nexport type ${s}Params = {\n${l.map(e=>` ${e.name}: ${e.type}`).join(`
172
+ `)}\n}\n`:``,m=l.length>0?`${d}.withParams<${s}Params>()({`:`${d}({`,h=l.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.
175
- requiredParams: [${u.map(e=>`'${e.name}'`).join(`, `)}],\n`:``,_=u.length>0?`(ctx, _deps, params)`:`(ctx)`,v=u.length>0?` // \`params\` is typed as ${c}Params (call-site params merged onto any paramDefaults).`:` // \`ctx\` is a ${p} — read ctx.req / ctx.headers / ctx.params (http) or ctx.get (bare).`,y=`import { ${f} } from '@forinda/kickjs'
176
- import type { ${p} } from '@forinda/kickjs'
175
+ requiredParams: [${l.map(e=>`'${e.name}'`).join(`, `)}],\n`:``,g=l.length>0?`(ctx, _deps, params)`:`(ctx)`,_=l.length>0?` // \`params\` is typed as ${s}Params (call-site params merged onto any paramDefaults).`:` // \`ctx\` is a ${f} — read ctx.req / ctx.headers / ctx.params (http) or ctx.get (bare).`,v=`import { ${d} } from '@forinda/kickjs'
176
+ import type { ${f} } from '@forinda/kickjs'
177
177
 
178
178
  /**
179
- * ${c} context contributor (${o}).
179
+ * ${s} context contributor (${a}).
180
180
  *
181
- * Computes a value and writes it to \`ctx.set('${l}', …)\` before a
181
+ * Computes a value and writes it to \`ctx.set('${c}', …)\` before a
182
182
  * matched handler runs — the typed, ordered alternative to
183
183
  * \`@Middleware()\` when the only job is to populate \`ctx\`.
184
184
  *
185
185
  * Apply per method/class:
186
186
  *
187
- ${o===`http`?` * @${c}${u.length>0?`({ ${u[0]?.name}: … })`:``}
187
+ ${a===`http`?` * @${s}${l.length>0?`({ ${l[0]?.name}: … })`:``}
188
188
  * @Get('/')
189
- * handler(ctx: ${p}) {
190
- * return ctx.require('${l}')
189
+ * handler(ctx: ${f}) {
190
+ * return ctx.require('${c}')
191
191
  * }`:` * // Any transport whose handler receives an ExecutionContext
192
192
  * // (WebSocket, queue, cron). Attach via that transport's decorator,
193
193
  * // or register the contributor at a module / bootstrap site below.
194
- * handler(ctx: ${p}) {
195
- * const value = ctx.require('${l}')
194
+ * handler(ctx: ${f}) {
195
+ * const value = ctx.require('${c}')
196
196
  * }`}
197
197
  *
198
198
  * Or register at a module / adapter / bootstrap site — those take a
199
199
  * \`ContributorRegistration\`, not the decorator itself:
200
200
  *
201
- * bootstrap({ contributors: [${c}${u.length>0?`.with({ ${u[0]?.name}: … })`:``}.registration] })
201
+ * bootstrap({ contributors: [${s}${l.length>0?`.with({ ${l[0]?.name}: … })`:``}.registration] })
202
202
  */
203
203
 
204
- // Register '${l}' so \`ctx.require('${l}')\` is typed and \`dependsOn: ['${l}']\`
204
+ // Register '${c}' so \`ctx.require('${c}')\` is typed and \`dependsOn: ['${c}']\`
205
205
  // is checked. Replace \`unknown\` with the resolved value's real type.
206
206
  // (For a key you only depend on — no value type needed — declare it in
207
207
  // \`interface ContextKeys\` instead.)
208
208
  declare module '@forinda/kickjs' {
209
209
  interface ContextMeta {
210
- '${l}': unknown
210
+ '${c}': unknown
211
211
  }
212
212
  }
213
- ${m}
214
- export const ${c} = ${h}
215
- key: '${l}',
216
- ${g} resolve: ${_} => {
217
- ${v}
218
- // TODO: compute and return the value written to ctx.set('${l}', …)
219
- throw new Error("${c} contributor: resolve() not implemented")
213
+ ${p}
214
+ export const ${s} = ${m}
215
+ key: '${c}',
216
+ ${h} resolve: ${g} => {
217
+ ${_}
218
+ // TODO: compute and return the value written to ctx.set('${c}', …)
219
+ throw new Error("${s} contributor: resolve() not implemented")
220
220
  },
221
221
  })
222
- `,b=N(d,`${s}.contributor.ts`);return await t(b,y),[b]}async function qt(e){let n=N(e.outDir,`kick.config.ts`),r=e.modulesDir??`src/modules`,i=e.defaultRepo??`inmemory`;return L(n)&&!e.force&&!await h({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
223
- Skipped — existing kick.config.ts preserved.`),[]):(await t(n,`import { defineConfig } from '@forinda/kickjs-cli'
222
+ `,y=F(u,`${o}.contributor.ts`);return await x(y,v),[y]}async function Gt(e){let t=F(e.outDir,`kick.config.ts`),n=e.modulesDir??`src/modules`,r=e.defaultRepo??`inmemory`;return z(t)&&!e.force&&!await ce({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
223
+ Skipped — existing kick.config.ts preserved.`),[]):(await x(t,`import { defineConfig } from '@forinda/kickjs-cli'
224
224
 
225
225
  export default defineConfig({
226
226
  modules: {
227
- dir: '${r}',
228
- repo: '${i}',
227
+ dir: '${n}',
228
+ repo: '${r}',
229
229
  pluralize: false,
230
230
  },
231
231
 
@@ -263,18 +263,18 @@ export default defineConfig({
263
263
  },
264
264
  ],
265
265
  })
266
- `),[n])}function Jt(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 U(e,t){let n=t.exec(e);if(!n)return null;let r=n.index+n[0].length-1,i=Jt(e,r);return i===-1?null:e.slice(r+1,i)}function W(e,t,n){let r=` `.repeat(n);return e.split(`
266
+ `),[t])}function Kt(e,t){if(e[t]!==`{`)return-1;let n=1;for(let r=t+1;r<e.length;r++){let t=e[r];if(t===`{`)n++;else if(t===`}`&&(n--,n===0))return r}return-1}function G(e,t){let n=t.exec(e);if(!n)return null;let r=n.index+n[0].length-1,i=Kt(e,r);return i===-1?null:e.slice(r+1,i)}function K(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 Yt(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 Xt(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=Jt(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=U(o,/register\s*\(([^)]*)\)\s*:\s*void\s*\{/),u=U(o,/contributors\s*\(\s*\)\s*:\s*ContributorRegistrations\s*\{/),d=U(o,/routes\s*\(\s*\)\s*:\s*[A-Za-z|[\]\s]+\{/);if(!d)return{migrated:null,reason:`routes() method missing or signature unrecognized`};let f=Yt(s),p=``;return l&&(p+=` register(container) {${W(l,4,6)} },\n\n`),u&&(p+=` contributors() {${W(u,4,6)} },\n\n`),p+=` routes() {${W(d,4,6)} },`,{migrated:`${f}${`export const ${r} = defineModule({
268
+ `)}function qt(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 Jt(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 Yt(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=Kt(e,i);if(a===-1)return{migrated:null,reason:`unbalanced class braces`};let o=e.slice(i+1,a),s=e.slice(0,n.index),c=e.slice(a+1),l=G(o,/register\s*\(([^)]*)\)\s*:\s*void\s*\{/),u=G(o,/contributors\s*\(\s*\)\s*:\s*ContributorRegistrations\s*\{/),d=G(o,/routes\s*\(\s*\)\s*:\s*[A-Za-z|[\]\s]+\{/);if(!d)return{migrated:null,reason:`routes() method missing or signature unrecognized`};let f=qt(s),p=``;return l&&(p+=` register(container) {${K(l,4,6)} },\n\n`),u&&(p+=` contributors() {${K(u,4,6)} },\n\n`),p+=` routes() {${K(d,4,6)} },`,{migrated:`${f}${`export const ${r} = defineModule({
269
269
  name: '${r}',
270
270
  build: () => ({
271
271
  ${p}
272
272
  }),
273
- })`}${c}`}}function Qt(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=Jt(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=Jt(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=U(m,/register\s*\(([^)]*)\)\s*\{/),g=U(m,/contributors\s*\(\s*\)\s*\{/),_=U(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let v=Xt(c,{container:h!==null,appModule:!0,moduleRoutes:!0,contributorRegistrations:g!==null}),y=``;return h!==null&&(y+=` register(container: Container): void {${W(h,6,4)} }\n\n`),g!==null&&(y+=` contributors(): ContributorRegistrations {${W(g,6,4)} }\n\n`),y+=` routes(): ModuleRoutes {${W(_,6,4)} }`,{migrated:`${v}${`export class ${r} implements AppModule {
273
+ })`}${c}`}}function Xt(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=Kt(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=Kt(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=G(m,/register\s*\(([^)]*)\)\s*\{/),g=G(m,/contributors\s*\(\s*\)\s*\{/),_=G(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let v=Jt(c,{container:h!==null,appModule:!0,moduleRoutes:!0,contributorRegistrations:g!==null}),y=``;return h!==null&&(y+=` register(container: Container): void {${K(h,6,4)} }\n\n`),g!==null&&(y+=` contributors(): ContributorRegistrations {${K(g,6,4)} }\n\n`),y+=` routes(): ModuleRoutes {${K(_,6,4)} }`,{migrated:`${v}${`export class ${r} implements AppModule {
275
275
  ${y}
276
276
  }
277
- `}${u}`}}function $t(e,t){return t===`class`?Qt(e):Zt(e)}function en(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 tn(e){let t=[];return await n(F(e),0),t;async function n(e,r){let i;try{i=await Ot(e)}catch{return}for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=N(e,a),o;try{o=await At(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function nn(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await Ot(e)}catch{return}await Dt(t,{recursive:!0});for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=N(e,a),o=N(t,a),s;try{s=await At(i)}catch{continue}s.isDirectory()?await r(i,o):(await Et(i,o),n++)}}}function rn(e){let t=(/* @__PURE__ */ new Date()).toISOString().replaceAll(/[:.]/g,`-`);return N(e,`.kickjs`,`codemod-backups`,`${t}-modules`)}async function an(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await tn(e),s=await V(N(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=rn(r),await nn(e,c));let l=[];for(let e of o){let t=$t(await V(e,`utf-8`),i);t.migrated==null?l.push({path:e,status:`skipped`,reason:t.reason}):(n||await jt(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`}))}let u=N(e,`index.ts`),d=null;try{d=await V(u,`utf-8`)}catch{return{target:i,files:l,indexStatus:`not-found`,indexPath:u,backupDir:c}}let f=en(d,i);return f.migrated==null?{target:i,files:l,indexStatus:`skipped`,indexPath:u,indexReason:f.reason,backupDir:c}:(n||await jt(u,f.migrated,`utf-8`),{target:i,files:l,indexStatus:`migrated`,indexPath:u,backupDir:c})}async function on(e,t){let n=await tn(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 V(e,`utf-8`);i.test(t)&&r.push(e)}return r}const sn={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 cn(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=sn[a];if(!o){let e=[...Object.keys(sn),`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 ln(e){let{name:n,fields:r,modulesDir:i,repo:a=`inmemory`,tokenScope:o=`app`,style:s=`define`}=e,c=e.pluralize===!0,l=C(n),u=S(n),d=c?me(l):l,f=c?te(u):u,p=e.pluralizeRoutes===!1?l:me(l),m=N(i,d),h=[],g=async(e,n)=>{let r=N(m,e);await t(r,n),h.push(r)};return await g(`${l}.module.ts`,he({pascal:u,kebab:l,plural:d,routePath:p,repo:a,style:s})),await g(`${l}.constants.ts`,ae({pascal:u,kebab:l,fields:r})),await g(`${l}.controller.ts`,re({pascal:u,kebab:l,plural:d,pluralPascal:f,swagger:e.swagger??!1})),await g(`${l}.service.ts`,ee({pascal:u,kebab:l})),await g(`dtos/create-${l}.dto.ts`,un(u,r)),await g(`dtos/update-${l}.dto.ts`,dn(u,r)),await g(`dtos/${l}-response.dto.ts`,fn(u,r)),await g(`${l}.repository.ts`,x({pascal:u,kebab:l,repoType:a,dtoPrefix:`./dtos`,tokenScope:o})),await Ce(i,u,d,l,s),h}function un(e,t){return`import { z } from 'zod'
277
+ `}${u}`}}function Zt(e,t){return t===`class`?Xt(e):Yt(e)}function Qt(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 $t(e){let t=[];return await n(L(e),0),t;async function n(e,r){let i;try{i=await Et(e)}catch{return}for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=F(e,a),o;try{o=await Ot(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function en(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await Et(e)}catch{return}await Tt(t,{recursive:!0});for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=F(e,a),o=F(t,a),s;try{s=await Ot(i)}catch{continue}s.isDirectory()?await r(i,o):(await wt(i,o),n++)}}}function tn(e){let t=(/* @__PURE__ */ new Date()).toISOString().replaceAll(/[:.]/g,`-`);return F(e,`.kickjs`,`codemod-backups`,`${t}-modules`)}async function nn(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await $t(e),s=await U(F(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=tn(r),await en(e,c));let l=[];for(let e of o){let t=Zt(await U(e,`utf-8`),i);t.migrated==null?l.push({path:e,status:`skipped`,reason:t.reason}):(n||await kt(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`}))}let u=F(e,`index.ts`),d=null;try{d=await U(u,`utf-8`)}catch{return{target:i,files:l,indexStatus:`not-found`,indexPath:u,backupDir:c}}let f=Qt(d,i);return f.migrated==null?{target:i,files:l,indexStatus:`skipped`,indexPath:u,indexReason:f.reason,backupDir:c}:(n||await kt(u,f.migrated,`utf-8`),{target:i,files:l,indexStatus:`migrated`,indexPath:u,backupDir:c})}async function rn(e,t){let n=await $t(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 U(e,`utf-8`);i.test(t)&&r.push(e)}return r}const an={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 on(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=an[a];if(!o){let e=[...Object.keys(an),`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 sn(e){let{name:t,fields:n,modulesDir:r,repo:i=`inmemory`,tokenScope:a=`app`,style:o=`define`}=e,s=e.pluralize===!0,c=De(t),l=Ce(t),u=s?Re(c):c,d=s?we(l):l,f=e.pluralizeRoutes===!1?c:Re(c),p=F(r,u),m=[],h=async(e,t)=>{let n=F(p,e);await x(n,t),m.push(n)};return await h(`${c}.module.ts`,ze({pascal:l,kebab:c,plural:u,routePath:f,repo:i,style:o})),await h(`${c}.constants.ts`,ke({pascal:l,kebab:c,fields:n})),await h(`${c}.controller.ts`,Ee({pascal:l,kebab:c,plural:u,pluralPascal:d,swagger:e.swagger??!1})),await h(`${c}.service.ts`,Se({pascal:l,kebab:c})),await h(`dtos/create-${c}.dto.ts`,cn(l,n)),await h(`dtos/update-${c}.dto.ts`,ln(l,n)),await h(`dtos/${c}-response.dto.ts`,un(l,n)),await h(`${c}.repository.ts`,xe({pascal:l,kebab:c,repoType:i,dtoPrefix:`./dtos`,tokenScope:a})),await qe(r,l,u,c,o),m}function cn(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 dn(e,t){return`import { z } from 'zod'
285
+ `}function ln(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 fn(e,t){return`export interface ${e}ResponseDTO {
293
+ `}function un(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 pn(e){let{name:n,moduleName:r,modulesDir:i,testImport:a=`vitest`}=e,o=e.pluralize??!1,s=C(n),c=S(n),l=[],u;if(e.outDir)u=F(e.outDir);else if(r){let e=C(r),t=o?me(e):e;u=F(N(i??`src/modules`,t,`__tests__`))}else u=F(`src/__tests__`);let d=N(u,`${s}.test.ts`);return await t(d,`import { describe, it, expect, beforeEach } from '${a}'
300
+ `}async function dn(e){let{name:t,moduleName:n,modulesDir:r,testImport:i=`vitest`}=e,a=e.pluralize??!1,o=De(t),s=Ce(t),c=[],l;if(e.outDir)l=L(e.outDir);else if(n){let e=De(n),t=a?Re(e):e;l=L(F(r??`src/modules`,t,`__tests__`))}else l=L(`src/__tests__`);let u=F(l,`${o}.test.ts`);return await x(u,`import { describe, it, expect, beforeEach } from '${i}'
301
301
  import { Container } from '@forinda/kickjs'
302
302
 
303
- describe('${c}', () => {
303
+ describe('${s}', () => {
304
304
  beforeEach(() => {
305
305
  Container.reset()
306
306
  })
@@ -320,63 +320,63 @@ describe('${c}', () => {
320
320
  expect(true).toBe(true)
321
321
  })
322
322
  })
323
- `),l.push(d),l}const mn=[`agents`,`claude`,`skills`,`gemini`,`copilot`,`both`,`all`];function G(e){return e.parent?.opts()?.dryRun??!1}function K(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 hn(e){if(!e)try{let e=await E(process.cwd());await ht({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 gn=[{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`},{name:`deploy <targets...>`,description:`Deploy files: netlify | vercel | docker (config, entry, build script)`}],_n=/* @__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`]]),vn=/* @__PURE__ */ new Set([...gn.map(e=>e.name.split(` `)[0]),..._n.keys()]);async function yn(){console.log(`
323
+ `),c.push(u),c}const fn=[`agents`,`claude`,`skills`,`gemini`,`copilot`,`both`,`all`];function q(e){return e.parent?.opts()?.dryRun??!1}function J(e,t=!1){let n=process.cwd();console.log(`\n ${t?`Would generate`:`Generated`} ${e.length} file${e.length===1?``:`s`}:`);for(let t of e)console.log(` ${t.replace(n+`/`,``)}`);t&&console.log(`
324
+ (dry run — no files were written)`),console.log()}async function pn(e){if(!e)try{let e=await A(process.cwd());await ft({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 mn=[{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`},{name:`deploy <targets...>`,description:`Deploy files: netlify | vercel | docker (config, entry, build script)`}],hn=/* @__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`]]),gn=/* @__PURE__ */ new Set([...mn.map(e=>e.name.split(` `)[0]),...hn.keys()]);async function _n(){console.log(`
326
326
  Built-in generators:
327
- `);let e=Math.max(...gn.map(e=>e.name.length));for(let t of gn)console.log(` kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await E(process.cwd()),n=Ut(t?.plugins??[],t?.commands??[]),r=await pe(process.cwd(),n.generators);if(r.generators.length>0){console.log(`
327
+ `);let e=Math.max(...mn.map(e=>e.name.length));for(let t of mn)console.log(` kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await A(process.cwd()),n=Vt(t?.plugins??[],t?.commands??[]),r=await Le(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 bn(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 xn(e,t,n){let r=await E(process.cwd()),i=w(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??Se(i.repo);t.repo&&Oe(t.repo);let s=t.pattern??r?.pattern??`rest`,c=T(t.pluralize,i),l=Me(t.pluralizeRoutes,i),u=De(r,process.cwd()),d=Ae(O()),f=Ee(O()),p=O(),m=Te(p,`@forinda/kickjs-testing`,`any`)&&Te(p,`supertest`,`any`),h=i.style??`define`;if(!n&&h===`define`){let e=await on(F(a),`define`);if(e.length>0){console.error(`\n ${v.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n ${v.dim(`Project setting:`)} modules.style: 'define' (default)\n\n ${v.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 ${v.bold(`Pick one:`)}\n 1. Migrate everything to defineModule:\n ${v.dim(`$`)} kick codemod modules --experimental --apply\n 2. Keep the class form — pin it in kick.config.ts:\n ${v.dim(`// kick.config.ts`)}\n ${v.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let g=[];for(let r of e){let e=await b({name:r,modulesDir:F(a),noEntity:t.entity===!1,noTests:t.tests===!1,repo:o,minimal:t.minimal,force:t.force,pattern:s,testHarness:m,testImport:ke(p),dryRun:n,pluralize:c,pluralizeRoutes:l,tokenScope:u,swagger:d,schemaLib:f,style:i.style});g.push(...e)}K(g,n),await hn(n)}function Sn(e,t){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 yn();return}if(!e||e.length===0){r.help();return}let o=G(a);n(o);let[s,c,...l]=e;if(s){let e=await E(process.cwd()),n=Ut(e?.plugins??[],e?.commands??[]),r=await se({generatorName:s,itemName:c??``,args:l,flags:i,cwd:process.cwd(),projectRoot:t?.projectRoot},n.generators);if(r){K(r.files,o);return}if(s!==`module`&&vn.has(s)){let e=_n.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 xn(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,t,r)=>{let i=G(r);n(i),await xn(e,bn(r,t),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,t,r)=>{let i=G(r);n(i),K(await we({name:e,outDir:F(t.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,t,r)=>{let i=G(r);n(i),K(await Wt({name:e,outDir:F(t.out)}),i)}),r.command(`middleware <name>`).description(`Generate a global middleware function, typed for the configured runtime
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,t,r)=>{let i=G(r);n(i);let a=await E(process.cwd()),o=w(a),s=o.dir??`src/modules`;K(await oe({name:e,outDir:t.out,moduleName:t.module,modulesDir:s,pattern:a?.pattern,pluralize:T(void 0,o),runtime:a?.runtime}),i)}),r.command(`guard <name>`).description(`Generate a route guard (auth, roles, etc.)
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,t,r)=>{let i=G(r);n(i);let a=await E(process.cwd()),o=w(a),s=o.dir??`src/modules`;K(await de({name:e,outDir:t.out,moduleName:t.module,modulesDir:s,pattern:a?.pattern,pluralize:T(void 0,o)}),i)}),r.command(`contributor <name>`).description(`Generate a Context Contributor (typed alternative to @Middleware for ctx.set)
331
+ `);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}function vn(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 yn(e,t,n){let r=await A(process.cwd()),i=O(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??Ke(i.repo);t.repo&&me(t.repo);let s=t.pattern??r?.pattern??`rest`,c=k(t.pluralize,i),l=ve(t.pluralizeRoutes,i),u=pe(r,process.cwd()),d=ge(j()),f=fe(j()),p=j(),m=de(p,`@forinda/kickjs-testing`,`any`)&&de(p,`supertest`,`any`),h=i.style??`define`;if(!n&&h===`define`){let e=await rn(L(a),`define`);if(e.length>0){console.error(`\n ${D.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n ${D.dim(`Project setting:`)} modules.style: 'define' (default)\n\n ${D.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 ${D.bold(`Pick one:`)}\n 1. Migrate everything to defineModule:\n ${D.dim(`$`)} kick codemod modules --experimental --apply\n 2. Keep the class form — pin it in kick.config.ts:\n ${D.dim(`// kick.config.ts`)}\n ${D.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let g=[];for(let r of e){let e=await be({name:r,modulesDir:L(a),noEntity:t.entity===!1,noTests:t.tests===!1,repo:o,minimal:t.minimal,force:t.force,pattern:s,testHarness:m,testImport:he(p),dryRun:n,pluralize:c,pluralizeRoutes:l,tokenScope:u,swagger:d,schemaLib:f,style:i.style});g.push(...e)}J(g,n),await pn(n)}function bn(e,t){let n=e.command(`generate [names...]`).alias(`g`).description("Generate code scaffolds — bare form `kick g <name>` is shorthand for `kick g module <name>`").option(`--list`,`List all available generators`).option(`--dry-run`,`Preview files that would be generated without writing them`).option(`--no-entity`,`Skip entity and value object generation (module shortcut)`).option(`--no-tests`,`Skip test file generation (module shortcut)`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name (e.g. postgres)`).option(`--pattern <pattern>`,`Override project pattern: rest | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--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,r,i)=>{if(r.list){await _n();return}if(!e||e.length===0){n.help();return}let a=q(i);S(a);let[o,s,...c]=e;if(o){let e=await A(process.cwd()),n=Vt(e?.plugins??[],e?.commands??[]),i=await je({generatorName:o,itemName:s??``,args:c,flags:r,cwd:process.cwd(),projectRoot:t?.projectRoot},n.generators);if(i){J(i.files,a);return}if(o!==`module`&&gn.has(o)){let e=hn.get(o);e?(console.error(`\n 'kick g ${o}' has been removed.`),console.error(` ${e}\n`)):(console.error(`\n '${o}' is a generator, not a module name.`),console.error(` Did you mean: kick g ${o} ${s??`<name>`}`),console.error(` If that errors, your @forinda/kickjs-cli is older than the '${o}' generator — upgrade it.\n`)),process.exitCode=1;return}}await yn(e,r,a)});n.command(`module <names...>`).description(`Generate one or more modules (e.g. kick g module user task project)`).option(`--no-entity`,`Skip entity and value object generation`).option(`--no-tests`,`Skip test file generation`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name (e.g. postgres)`).option(`--pattern <pattern>`,`Override project pattern: rest | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--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,t,n)=>{let r=q(n);S(r),await yn(e,vn(n,t),r)}),n.command(`adapter <name>`).description(`Generate an AppAdapter with lifecycle hooks and middleware support`).option(`-o, --out <dir>`,`Output directory`,`src/adapters`).action(async(e,t,n)=>{let r=q(n);S(r),J(await Je({name:e,outDir:L(t.out)}),r)}),n.command(`plugin <name>`).description(`Generate a KickPlugin with DI, modules, adapters, middleware, and lifecycle hooks`).option(`-o, --out <dir>`,`Output directory`,`src/plugins`).action(async(e,t,n)=>{let r=q(n);S(r),J(await Ht({name:e,outDir:L(t.out)}),r)}),n.command(`middleware <name>`).description(`Generate a global middleware function, typed for the configured runtime
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,t,n)=>{let r=q(n);S(r);let i=await A(process.cwd()),a=O(i),o=a.dir??`src/modules`;J(await Ae({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:k(void 0,a),runtime:i?.runtime}),r)}),n.command(`guard <name>`).description(`Generate a route guard (auth, roles, etc.)
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,t,n)=>{let r=q(n);S(r);let i=await A(process.cwd()),a=O(i),o=a.dir??`src/modules`;J(await Fe({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:k(void 0,a)}),r)}),n.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,t,r)=>{let i=G(r);n(i);let a=(t.type??`http`).toLowerCase();a!==`http`&&a!==`bare`&&(console.warn(` kick g contributor: unknown --type '${t.type}', using 'http'.`),a=`http`);let o=await E(process.cwd()),s=w(o),c=s.dir??`src/modules`;K(await Kt({name:e,type:a,key:t.key,params:t.params,outDir:t.out,moduleName:t.module,modulesDir:c,pattern:o?.pattern,pluralize:T(void 0,s)}),i)}),r.command(`service <name>`).description(`Generate a @Service() class
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,t,r)=>{let i=G(r);n(i);let a=await E(process.cwd()),o=w(a),s=o.dir??`src/modules`;K(await fe({name:e,outDir:t.out,moduleName:t.module,modulesDir:s,pattern:a?.pattern,pluralize:T(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,t,r)=>{let i=G(r);n(i);let a=await E(process.cwd()),o=w(a),s=o.dir??`src/modules`;K(await _e({name:e,outDir:t.out,moduleName:t.module,modulesDir:s,pattern:a?.pattern,pluralize:T(void 0,o)}),i),await hn(i)}),r.command(`dto <name>`).description(`Generate a DTO schema for the project’s validation library
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,t,r)=>{let i=G(r);n(i);let a=await E(process.cwd()),o=w(a),s=o.dir??`src/modules`;K(await ve({name:e,outDir:t.out,moduleName:t.module,modulesDir:s,pattern:a?.pattern,pluralize:T(void 0,o),schemaLib:Ee(O())}),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,t,r)=>{let i=G(r);n(i);let a=await E(process.cwd()),o=w(a),s=o.dir??`src/modules`;K(await pn({name:e,outDir:t.out,moduleName:t.module,modulesDir:s,pluralize:T(void 0,o),testImport:ke(O())}),i)}),r.command(`scaffold <name> [fields...]`).description(`Generate a full CRUD module from field definitions
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,t,n)=>{let r=q(n);S(r);let i=(t.type??`http`).toLowerCase();i!==`http`&&i!==`bare`&&(console.warn(` kick g contributor: unknown --type '${t.type}', using 'http'.`),i=`http`);let a=await A(process.cwd()),o=O(a),s=o.dir??`src/modules`;J(await Wt({name:e,type:i,key:t.key,params:t.params,outDir:t.out,moduleName:t.module,modulesDir:s,pattern:a?.pattern,pluralize:k(void 0,o)}),r)}),n.command(`service <name>`).description(`Generate a @Service() class
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,t,n)=>{let r=q(n);S(r);let i=await A(process.cwd()),a=O(i),o=a.dir??`src/modules`;J(await Ie({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:k(void 0,a)}),r)}),n.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,t,n)=>{let r=q(n);S(r);let i=await A(process.cwd()),a=O(i),o=a.dir??`src/modules`;J(await Ve({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:k(void 0,a)}),r),await pn(r)}),n.command(`dto <name>`).description(`Generate a DTO schema for the project’s validation library
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,t,n)=>{let r=q(n);S(r);let i=await A(process.cwd()),a=O(i),o=a.dir??`src/modules`;J(await He({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:k(void 0,a),schemaLib:fe(j())}),r)}),n.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,t,n)=>{let r=q(n);S(r);let i=await A(process.cwd()),a=O(i),o=a.dir??`src/modules`;J(await dn({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pluralize:k(void 0,a),testImport:he(j())}),r)}),n.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,t,r,i)=>{let a=bn(i,r),o=G(i);n(o),t.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,t,n,r)=>{let i=vn(r,n),a=q(r);S(a),t.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 E(process.cwd()),c=w(s),l=a.modulesDir??c.dir??`src/modules`,u=cn(t),d=De(s,process.cwd()),f=Ae(O()),p=await ln({name:e,fields:u,modulesDir:F(l),noEntity:a.entity===!1,noTests:a.tests===!1,pluralize:T(a.pluralize,c),pluralizeRoutes:Me(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)`:``}`);K(p,o),await hn(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,t)=>{let r=G(t);n(r),K(await qt({outDir:F(`.`),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,t)=>{let r=G(t);n(r);let i=e.only??`all`;mn.includes(i)?K(await f({outDir:F(`.`),only:i,name:e.name,pm:e.pm,template:e.template,force:e.force}),r):(console.error(` Invalid --only value: ${i}. Expected: ${mn.join(` | `)}`),process.exitCode=1)}),r.command(`deploy <targets...>`).description(`Add deploy files: netlify | vercel | docker (config, serverless entry, build script)`).option(`--pm <pm>`,`Package manager (default: detected)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t,r)=>{let i=G(r);n(i);let a;try{a=Je(e.flatMap(e=>e.split(`,`))),K(await Fe({dir:F(`.`),targets:a,pm:t.pm,force:t.force}),i)}catch(e){console.error(` ${e.message}`),process.exitCode=1}});for(let e of t?.generators??[])Cn(r,e,t?.projectRoot)}function Cn(e,t,r){let{source:i,spec:a}=t,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=G(s);n(c);let l=await se({generatorName:a.name,itemName:e??``,args:i??[],flags:o,cwd:process.cwd(),projectRoot:r},[t]);l&&K(l.files,c)})}const wn=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: `;async function Tn(e){let t=j.resolve(e.cwd,`.kickjs/types`);e.check||await Dt(t,{recursive:!0});let n=/* @__PURE__ */ new Map,r=e.scan??st,i=j.resolve(e.cwd,`.kickjs`,`cache`),a=e.scan?void 0:e.changedFiles,o={cwd:e.cwd,config:e.config,async importTs(e){return await import(H(e).href)},async writeFile(t,n){let r=j.resolve(e.cwd,t);await Dt(j.dirname(r),{recursive:!0}),await jt(r,n,`utf8`)},getScanResult:e=>{let t=En(e),o=n.get(t);if(!o){let s={cacheDir:i,...e};o=a?ot(s,a):r(s),n.set(t,o)}return o},log:console,watch:e.watch,check:e.check},s=[],c=[];for(let n of e.plugins){let r=n.outExtension??`.d.ts`,i=j.join(t,`${n.id.replace(/\//g,`__`)}${r}`),a;try{a=await n.generate(o)}catch(t){let r=t instanceof Error?t.message:String(t);if(e.check)throw Error(`kick typegen --check: ${n.id} failed to generate (${r})`,{cause:t});o.log.error(` ${n.id}: typegen failed (${r}) — keeping previous output`),s.push({id:n.id,status:`error`,outFile:i});continue}if(a===null){s.push({id:n.id,status:`skipped`});continue}let l=`${wn}${n.id} */\n\n`+a+`
350
- `,u=``;L(i)&&(u=await V(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 jt(i,l,`utf8`),s.push({id:n.id,status:`written`,outFile:i}))}if(c.length>0)throw new be(c);return s}function En(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 Dn(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 On=/* @__PURE__ */ e({applyDisableFilter:()=>Dn,runAllPluginTypegens:()=>kn});async function kn(e){let{enabled:t,skipped:n,unknown:r}=Dn(Ut([...io,...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 Tn({cwd:e.cwd,config:e.config??{},plugins:t,watch:e.watch,check:e.check,changedFiles:e.changedFiles});if(!e.silent&&ue())for(let e of n)console.log(` ${e.id}: ${e.status}`);return n}catch(t){if(t instanceof be||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 An(e){let t=process.platform===`win32`;for(let n of jn(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=N(n,i);if(L(r))return{cmd:r,args:[`--noEmit`],shell:t,kind:e}}}return null}function jn(e){let t=F(e),n=Mn(t);return(n?[t,n]:[t]).map(e=>N(e,`node_modules`,`.bin`))}function Mn(e){for(let t=M(e);t!==M(t);t=M(t)){let n=N(t,`pnpm-workspace.yaml`),r=N(t,`package.json`);if(L(n)||L(r))return Nn(n,r).some(n=>Pn(n,P(t,e)))?t:void 0}}function Nn(e,t){try{if(L(e)){let t=R(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(R(t,`utf-8`)),r=Array.isArray(n)?n:n?.packages;return Array.isArray(r)?r.filter(e=>typeof e==`string`):[]}catch{return[]}}function Pn(e,t){let n=e.replace(/^\.\//,``).replace(/\/+$/,``).split(`/`).map(e=>e===`**`?`.*`:e.replace(/[.+^${}()|[\]\\]/g,`\\$&`).replace(/\*/g,`[^/]*`)).join(`/`);return RegExp(`^${n}$`).test(t.split(I).join(`/`))}function Fn(e){let t=e.spawnFn??Nt,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 In(e,t=12){let n=e.trim().split(/\r?\n/);return n.length<=t?n.join(`
349
+ `),process.exit(1));let o=await A(process.cwd()),s=O(o),c=i.modulesDir??s.dir??`src/modules`,l=on(t),u=pe(o,process.cwd()),d=ge(j()),f=await sn({name:e,fields:l,modulesDir:L(c),noEntity:i.entity===!1,noTests:i.tests===!1,pluralize:k(i.pluralize,s),pluralizeRoutes:ve(i.pluralizeRoutes,s),tokenScope:u,swagger:d,style:s.style});console.log(`\n Scaffolded ${e} with ${l.length} field(s):`);for(let e of l)console.log(` ${e.name}: ${e.type}${e.optional?` (optional)`:``}`);J(f,a),await pn(a)}),n.command(`config`).description(`Generate a kick.config.ts at the project root`).option(`--modules-dir <dir>`,`Modules directory path`,`src/modules`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name`,`inmemory`).option(`-f, --force`,`Overwrite existing kick.config.ts without prompting`).action(async(e,t)=>{let n=q(t);S(n),J(await Gt({outDir:L(`.`),modulesDir:e.modulesDir,defaultRepo:e.repo,force:e.force}),n)}),n.command(`agents`).alias(`agent-docs`).alias(`ai-docs`).description(`Regenerate .agents/* + root CLAUDE.md (sync after framework upgrades)`).option(`--only <which>`,`Limit scope: agents | claude | skills | gemini | copilot | both (agents+claude) | all (default: all)`,`all`).option(`--name <name>`,`Project name (defaults to package.json name)`).option(`--pm <pm>`,`Package manager (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,t)=>{let n=q(t);S(n);let r=e.only??`all`;fn.includes(r)?J(await ae({outDir:L(`.`),only:r,name:e.name,pm:e.pm,template:e.template,force:e.force}),n):(console.error(` Invalid --only value: ${r}. Expected: ${fn.join(` | `)}`),process.exitCode=1)}),n.command(`deploy <targets...>`).description(`Add deploy files: netlify | vercel | docker (config, serverless entry, build script)`).option(`--pm <pm>`,`Package manager (default: detected)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t,n)=>{let r=q(n);S(r);let i;try{i=y(e.flatMap(e=>e.split(`,`))),J(await a({dir:L(`.`),targets:i,pm:t.pm,force:t.force}),r)}catch(e){console.error(` ${e.message}`),process.exitCode=1}});for(let e of t?.generators??[])xn(n,e,t?.projectRoot)}function xn(e,t,n){let{source:r,spec:i}=t,a=i.args?.[0],o=a?.name??`itemName`,s=a?.required?`<${o}>`:`[${o}]`,c=`${i.name} ${s} [extraArgs...]`,l=e.command(c).description(`${i.description} [${r}]`);for(let e of i.flags??[]){let t=e.takesValue?`--${e.name} <value>`:`--${e.name}`,n=e.alias?`-${e.alias}, ${t}`:t;l.option(n,e.description??``)}l.action(async(e,r,a,o)=>{let s=q(o);S(s);let c=await je({generatorName:i.name,itemName:e??``,args:r??[],flags:a,cwd:process.cwd(),projectRoot:n},[t]);c&&J(c.files,s)})}const Sn=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: `;async function Cn(e){let t=N.resolve(e.cwd,`.kickjs/types`);e.check||await Tt(t,{recursive:!0});let n=/* @__PURE__ */ new Map,r=e.scan??it,i=N.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(W(e).href)},async writeFile(t,n){let r=N.resolve(e.cwd,t);await Tt(N.dirname(r),{recursive:!0}),await kt(r,n,`utf8`)},getScanResult:e=>{let t=wn(e),o=n.get(t);if(!o){let s={cacheDir:i,...e};o=a?rt(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=N.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=`${Sn}${n.id} */\n\n`+a+`
350
+ `,u=``;z(i)&&(u=await U(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 kt(i,l,`utf8`),s.push({id:n.id,status:`written`,outFile:i}))}if(c.length>0)throw new We(c);return s}function wn(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 Tn(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 En=/* @__PURE__ */ e({applyDisableFilter:()=>Tn,runAllPluginTypegens:()=>Dn});async function Dn(e){let{enabled:t,skipped:n,unknown:r}=Tn(Vt([...io,...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 Cn({cwd:e.cwd,config:e.config??{},plugins:t,watch:e.watch,check:e.check,changedFiles:e.changedFiles});if(!e.silent&&Pe())for(let e of n)console.log(` ${e.id}: ${e.status}`);return n}catch(t){if(t instanceof We||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 On(e){let t=process.platform===`win32`;for(let n of kn(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=F(n,i);if(z(r))return{cmd:r,args:[`--noEmit`],shell:t,kind:e}}}return null}function kn(e){let t=L(e),n=An(t);return(n?[t,n]:[t]).map(e=>F(e,`node_modules`,`.bin`))}function An(e){for(let t=P(e);t!==P(t);t=P(t)){let n=F(t,`pnpm-workspace.yaml`),r=F(t,`package.json`);if(z(n)||z(r))return jn(n,r).some(n=>Mn(n,I(t,e)))?t:void 0}}function jn(e,t){try{if(z(e)){let t=B(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(B(t,`utf-8`)),r=Array.isArray(n)?n:n?.packages;return Array.isArray(r)?r.filter(e=>typeof e==`string`):[]}catch{return[]}}function Mn(e,t){let n=e.replace(/^\.\//,``).replace(/\/+$/,``).split(`/`).map(e=>e===`**`?`.*`:e.replace(/[.+^${}()|[\]\\]/g,`\\$&`).replace(/\*/g,`[^/]*`)).join(`/`);return RegExp(`^${n}$`).test(t.split(R).join(`/`))}function Nn(e){let t=e.spawnFn??jt,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 Pn(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 Ln(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function Rn(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 zn(e,t,n={}){t&&(process.env.PORT=t);let r=Ln(n.polling),i=process.cwd(),a=await E(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await ht({cwd:i,allowDuplicates:!0,schemaValidator:o,envFile:s,srcDir:a?.typegen?.srcDir,outDir:a?.typegen?.outDir,assetMap:a?.assetMap,runPlugins:!1})}catch(e){console.warn(` kick typegen: skipped (${e?.message??e})`)}let c=F(i,a?.typegen?.outDir??`.kickjs/types`);try{let e=await kn({cwd:i,config:a});await ct(c,e,!1)}catch(e){console.warn(` kick typegen: plugin pass skipped (${e?.message??e})`)}let{createRequire:l}=await import(`node:module`),u=l(F(`package.json`)).resolve(`vite`),{createServer:d}=await import(H(u).href);globalThis[le]=`kick-dev`;let f=await d({configFile:F(`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=An(i);e?m=Fn({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(In(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=ge({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 Fn(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function In(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 Ln(e,t,n={}){t&&(process.env.PORT=t);let r=Fn(n.polling),i=process.cwd(),a=await A(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await ft({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=L(i,a?.typegen?.outDir??`.kickjs/types`);try{let e=await Dn({cwd:i,config:a});await at(c,e,!1)}catch(e){console.warn(` kick typegen: plugin pass skipped (${e?.message??e})`)}let{createRequire:l}=await import(`node:module`),u=l(L(`package.json`)).resolve(`vite`),{createServer:d}=await import(W(u).href);globalThis[Ne]=`kick-dev`;let f=await d({configFile:L(`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=On(i);e?m=Nn({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(Pn(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=Be({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 Bn(e){let t=await E(e);try{await ht({cwd:e,allowDuplicates:!0,schemaValidator:t?.typegen?.schemaValidator??`zod`,envFile:t?.typegen?.envFile,srcDir:t?.typegen?.srcDir,outDir:t?.typegen?.outDir,assetMap:t?.assetMap,runPlugins:!1});let n=F(e,t?.typegen?.outDir??`.kickjs/types`),r=await kn({cwd:e,config:t});await ct(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 Vn(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 zn(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: ${u()} 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 Rn(e){let t=await A(e);try{await ft({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=L(e,t?.typegen?.outDir??`.kickjs/types`),r=await Dn({cwd:e,config:t});await at(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 zn(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 Ln(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: ${T()} 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
- `);let{createRequire:e}=await import(`node:module`),t=e(F(`package.json`)).resolve(`vite`),{build:n}=await import(H(t).href);await n({configFile:F(`vite.config.ts`)});let r=await E(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`?N(`dist`,e):e.dest??N(`dist`,t),r=F(t),i=F(n);L(r)?(Ct(i,{recursive:!0}),St(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 Ze(r,{cwd:process.cwd()})}catch(e){console.error(` ✗ asset build failed: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}console.log(`
358
+ `);let{createRequire:e}=await import(`node:module`),t=e(L(`package.json`)).resolve(`vite`),{build:n}=await import(W(t).href);await n({configFile:L(`vite.config.ts`)});let r=await A(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`?F(`dist`,e):e.dest??F(`dist`,t),r=L(t),i=L(n);z(r)?(xt(i,{recursive:!0}),bt(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 _t(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
- `)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await E(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 Ze(e,{cwd:process.cwd()}),console.log(`
362
+ `)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await A(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 _t(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)),Ye(e.entry,t)}),e.command(`typecheck`).description(`Type-check the project with its own tsgo/tsc`).option(`--cwd <dir>`,`Directory to type-check`,`.`).option(`--no-typegen`,`Skip refreshing .kickjs/types first`).action(async e=>{let t=F(process.cwd(),e.cwd??`.`);e.typegen!==!1&&await Bn(t);let n=An(t);if(!n){console.error(`
366
- No type-checker found. Install one in this project:\n ${u(t)} add -D typescript (tsc)\n ${u(t)} add -D @typescript/native-preview (tsgo, faster)\n`),process.exit(1);return}let r=Pt(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 Rn(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 zn(e.entry,e.port)}catch(e){console.error(`
367
- Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function Hn(){try{let e=M(It(import.meta.url));return JSON.parse(R(N(e,`..`,`package.json`),`utf-8`)).version??`unknown`}catch{return`unknown`}}const Un=new Set(Object.values(He).filter(e=>e.deprecated).map(e=>e.pkg));function Wn(e){let t=N(e,`package.json`);if(!L(t))return[];let n;try{n=JSON.parse(R(t,`utf-8`))}catch{return[]}let r={...n.dependencies,...n.devDependencies};return Object.keys(r).filter(e=>e===`@forinda/kickjs`||e.startsWith(`@forinda/kickjs-`)).toSorted().map(t=>{let n=null,i=N(e,`node_modules`,...t.split(`/`),`package.json`);if(L(i))try{n=JSON.parse(R(i,`utf-8`)).version??null}catch{}return{name:t,installed:n,declared:r[t]??null,deprecated:Un.has(t)}})}function Gn(e){let t=e;for(;;){if(L(N(t,`package.json`)))return t;let e=M(t);if(e===t)return null;t=e}}function Kn(e){e.command(`info`).description(`Print system and framework info`).action(()=>{let e=[``,` KickJS CLI v${Hn()}`,``,` System:`,` OS: ${zt()} ${Bt()} (${Rt()})`,` Node: ${process.version}`],t=Gn(process.cwd()),n=t?Wn(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:q,dim:J,green:qn,red:Jn,yellow:Yn,blue:Xn}=v;function Zn(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 Qn(e){let t=await fetch(e,{signal:AbortSignal.timeout(5e3)});if(!t.ok)throw Error(`${t.status} ${t.statusText}`);return t.json()}async function $n(e,t){try{return await Qn(`${e}${t}`)}catch{return null}}async function er(e){let[t,n,r,i,a]=await Promise.all([$n(e,`/health`),$n(e,`/metrics`),$n(e,`/routes`),$n(e,`/container`),$n(e,`/ws`)]);return{health:t,metrics:n,routes:r,container:i,ws:a}}function tr(e,t){let{health:n,metrics:r,routes:i,container:a,ws:o}=t,s=J(`─`.repeat(60));if(console.log(),console.log(q(` KickJS Inspector`)+J(` → ${e}`)),console.log(s),n){let e=n.status===`healthy`?qn(`● healthy`):Jn(`● `+n.status);console.log(` ${q(`Health:`)} ${e}`)}else console.log(` ${q(`Health:`)} ${Jn(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?Jn:r.errorRate>0?Yn:qn;console.log(` ${q(`Uptime:`)} ${Zn(r.uptimeSeconds)}`),console.log(` ${q(`Requests:`)} ${r.requests}`),console.log(` ${q(`Errors:`)} ${r.serverErrors} server, ${r.clientErrors??0} client ${J(`(`)}${t(e+`%`)}${J(`)`)}`)}if(a&&console.log(` ${q(`DI:`)} ${a.count} bindings`),o&&o.enabled&&console.log(` ${q(`WS:`)} ${o.connections??0} connections, ${o.namespaces??0} namespaces`),i?.routes?.length){console.log(),console.log(q(` Routes`)),console.log(s),console.log(` ${J(`METHOD`)} ${J(`PATH`.padEnd(36))} ${J(`CONTROLLER`)}`);for(let e of i.routes){let t=e.path.length>36?e.path.slice(0,33)+`...`:e.path.padEnd(36);console.log(` ${g(e.method)} ${t} ${Xn(e.controller)}.${J(e.handler)}`)}}console.log(s),console.log()}function nr(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 er(r);t.json?console.log(JSON.stringify(e,null,2)):tr(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(Jn(` ✖ Could not connect to ${n}`)),console.error(J(` ${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()})}const rr={express:{name:`expressRuntime`,from:`@forinda/kickjs`},fastify:{name:`fastifyRuntime`,from:`@forinda/kickjs/fastify`},h3:{name:`h3Runtime`,from:`@forinda/kickjs/h3`}},ir=`// Express needs a body parser; Fastify and h3 parse bodies natively.`;function ar(e,t,n,r=`src/index.ts`){let i={source:e,changes:[],manual:[],blocked:!1},a=rr[t],o=rr[n],s=sr(Y(r,i.source));if(!s)return i.manual.push(`No bootstrap({ ... }) call in ${r}: set \`runtime: ${o.name}()\` (import { ${o.name} } from '${o.from}') yourself.`),i;let c=cr(s,`runtime`),l=`${o.name}()`;if(c){let e=c.value,s=dr(Y(r,i.source),a.from,a.name);if(c.shorthand||e.type!==`CallExpression`||e.callee?.type!==`Identifier`||s===void 0||e.callee.name!==s){let e=i.source.slice(c.start,c.end);return i.manual.push(`\`${e}\` in ${r} isn't a call to ${a.name}(): set it to ${l} (import { ${o.name} } from '${o.from}') yourself.`),i.blocked=!0,i}let u=e.arguments;if(u.length>0){let e=i.source.slice(u[0].start,u.at(-1).end);i.manual.push(`The ${t} runtime had options (${e}); ${n} takes its own — see guide/http-runtimes.`)}i.source=i.source.slice(0,e.start)+l+i.source.slice(e.end)}else i.source=lr(i.source,s,`runtime: ${l}`);if(i.changes.push(`runtime: ${l}`),i.source=Le(i.source,{from:o.from,names:[o.name]},r),i.source=fr(i.source,a.from,a.name,r),t===`express`&&n!==`express`){let e=ur(i.source,r);e!==i.source&&(i.source=pr(e,`express`,r),i.changes.push(`removed express.json() — ${n} parses bodies itself`))}else if(n===`express`&&t!==`express`){let e=Ne(i.source,[{import:{from:`express`,default:`express`},slot:`middleware`,code:`${ir}\nexpress.json()`}],void 0,r);i.source=e.source,e.added.length>0&&i.changes.push(`added express.json() to middlewares`),e.manual.length>0&&i.manual.push(`Add express.json() to bootstrap({ middlewares }) yourself.`)}return i}function or(e,t,n=`kick.config.ts`){let r=Y(n,e).body.find(e=>e.type===`ExportDefaultDeclaration`)?.declaration;for(;r&&(r.type===`TSSatisfiesExpression`||r.type===`TSAsExpression`);)r=r.expression;if(r?.type===`CallExpression`&&(r=r.arguments?.[0]),r?.type!==`ObjectExpression`)return null;let i=cr(r,`runtime`);if(!i)return lr(e,r,`runtime: '${t}'`);let a=i.value;if(a.type!==`Literal`||typeof a.value!=`string`)return null;let o=e[a.start]===`"`?`"`:`'`;return`${e.slice(0,a.start)}${o}${t}${o}${e.slice(a.end)}`}function Y(e,t){return Lt(e,t).program}function sr(e){let t,n=e=>{if(t||!e||typeof e!=`object`)return;if(Array.isArray(e))return e.forEach(n);let r=e;if(r.type===`CallExpression`&&r.callee?.type===`Identifier`&&r.callee.name===`bootstrap`&&r.arguments?.[0]?.type===`ObjectExpression`)t=r.arguments[0];else for(let e in r)n(r[e])};return n(e),t}function cr(e,t){return e.properties.find(e=>e.type===`Property`&&(e.key?.name??e.key?.value)===t)}function lr(e,t,n){let r=t.properties[0];if(!r)return`${e.slice(0,t.start)}{ ${n} }${e.slice(t.end)}`;let i=e.lastIndexOf(`
369
- `,r.start)+1,a=e.slice(i,r.start);return/^\s*$/.test(a)?`${e.slice(0,r.start)}${n},\n${a}${e.slice(r.start)}`:`${e.slice(0,r.start)}${n}, ${e.slice(r.start)}`}function ur(e,t){let n=sr(Y(t,e)),r=n&&cr(n,`middlewares`);if(!r||r.value.type!==`ArrayExpression`)return e;let i=r.value.elements.find(e=>e?.type===`CallExpression`&&e.callee?.type===`MemberExpression`&&e.callee.object?.name===`express`&&e.callee.property?.name===`json`);if(!i)return e;let a=i.start,o=i.end,s=e.slice(o).match(/^\s*,/);s&&(o+=s[0].length);let c=e.lastIndexOf(`
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)),b(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=L(process.cwd(),e.cwd??`.`);e.typegen!==!1&&await Rn(t);let n=On(t);if(!n){console.error(`
366
+ No type-checker found. Install one in this project:\n ${T(t)} add -D typescript (tsc)\n ${T(t)} add -D @typescript/native-preview (tsgo, faster)\n`),process.exit(1);return}let r=Mt(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 In(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 Ln(e.entry,e.port)}catch(e){console.error(`
367
+ Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function Bn(){try{let e=P(Pt(import.meta.url));return JSON.parse(B(F(e,`..`,`package.json`),`utf-8`)).version??`unknown`}catch{return`unknown`}}const Vn=new Set(Object.values(f).filter(e=>e.deprecated).map(e=>e.pkg));function Hn(e){let t=F(e,`package.json`);if(!z(t))return[];let n;try{n=JSON.parse(B(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=F(e,`node_modules`,...t.split(`/`),`package.json`);if(z(i))try{n=JSON.parse(B(i,`utf-8`)).version??null}catch{}return{name:t,installed:n,declared:r[t]??null,deprecated:Vn.has(t)}})}function Un(e){let t=e;for(;;){if(z(F(t,`package.json`)))return t;let e=P(t);if(e===t)return null;t=e}}function Wn(e){e.command(`info`).description(`Print system and framework info`).action(()=>{let e=[``,` KickJS CLI v${Bn()}`,``,` System:`,` OS: ${Lt()} ${Rt()} (${It()})`,` Node: ${process.version}`],t=Un(process.cwd()),n=t?Hn(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:Y,dim:X,green:Gn,red:Kn,yellow:qn,blue:Jn}=D;function Yn(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 Xn(e){let t=await fetch(e,{signal:AbortSignal.timeout(5e3)});if(!t.ok)throw Error(`${t.status} ${t.statusText}`);return t.json()}async function Zn(e,t){try{return await Xn(`${e}${t}`)}catch{return null}}async function Qn(e){let[t,n,r,i,a]=await Promise.all([Zn(e,`/health`),Zn(e,`/metrics`),Zn(e,`/routes`),Zn(e,`/container`),Zn(e,`/ws`)]);return{health:t,metrics:n,routes:r,container:i,ws:a}}function $n(e,t){let{health:n,metrics:r,routes:i,container:a,ws:o}=t,s=X(`─`.repeat(60));if(console.log(),console.log(Y(` KickJS Inspector`)+X(` → ${e}`)),console.log(s),n){let e=n.status===`healthy`?Gn(`● healthy`):Kn(`● `+n.status);console.log(` ${Y(`Health:`)} ${e}`)}else console.log(` ${Y(`Health:`)} ${Kn(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?Kn:r.errorRate>0?qn:Gn;console.log(` ${Y(`Uptime:`)} ${Yn(r.uptimeSeconds)}`),console.log(` ${Y(`Requests:`)} ${r.requests}`),console.log(` ${Y(`Errors:`)} ${r.serverErrors} server, ${r.clientErrors??0} client ${X(`(`)}${t(e+`%`)}${X(`)`)}`)}if(a&&console.log(` ${Y(`DI:`)} ${a.count} bindings`),o&&o.enabled&&console.log(` ${Y(`WS:`)} ${o.connections??0} connections, ${o.namespaces??0} namespaces`),i?.routes?.length){console.log(),console.log(Y(` Routes`)),console.log(s),console.log(` ${X(`METHOD`)} ${X(`PATH`.padEnd(36))} ${X(`CONTROLLER`)}`);for(let e of i.routes){let t=e.path.length>36?e.path.slice(0,33)+`...`:e.path.padEnd(36);console.log(` ${le(e.method)} ${t} ${Jn(e.controller)}.${X(e.handler)}`)}}console.log(s),console.log()}function er(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 Qn(r);t.json?console.log(JSON.stringify(e,null,2)):$n(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(Kn(` ✖ Could not connect to ${n}`)),console.error(X(` ${e instanceof Error?e.message:String(e)}`))),t.watch||(process.exitCode=1)}};if(t.watch){let e=async()=>{process.stdout.write(`\x1B[2J\x1B[H`),await i()};await e(),setInterval(e,5e3)}else await i()})}const tr={express:{name:`expressRuntime`,from:`@forinda/kickjs`},fastify:{name:`fastifyRuntime`,from:`@forinda/kickjs/fastify`},h3:{name:`h3Runtime`,from:`@forinda/kickjs/h3`}},nr=`// Express needs a body parser; Fastify and h3 parse bodies natively.`;function rr(e,t,n,i=`src/index.ts`){let a={source:e,changes:[],manual:[],blocked:!1},o=tr[t],c=tr[n],l=or(ar(i,a.source));if(!l)return a.manual.push(`No bootstrap({ ... }) call in ${i}: set \`runtime: ${c.name}()\` (import { ${c.name} } from '${c.from}') yourself.`),a;let u=sr(l,`runtime`),d=`${c.name}()`;if(u){let e=u.value,r=ur(ar(i,a.source),o.from,o.name);if(u.shorthand||e.type!==`CallExpression`||e.callee?.type!==`Identifier`||r===void 0||e.callee.name!==r){let e=a.source.slice(u.start,u.end);return a.manual.push(`\`${e}\` in ${i} isn't a call to ${o.name}(): set it to ${d} (import { ${c.name} } from '${c.from}') yourself.`),a.blocked=!0,a}let s=e.arguments;if(s.length>0){let e=a.source.slice(s[0].start,s.at(-1).end);a.manual.push(`The ${t} runtime had options (${e}); ${n} takes its own — see guide/http-runtimes.`)}a.source=a.source.slice(0,e.start)+d+a.source.slice(e.end)}else a.source=cr(a.source,l,`runtime: ${d}`);if(a.changes.push(`runtime: ${d}`),a.source=s(a.source,{from:c.from,names:[c.name]},i),a.source=dr(a.source,o.from,o.name,i),t===`express`&&n!==`express`){let e=lr(a.source,i);e!==a.source&&(a.source=fr(e,`express`,i),a.changes.push(`removed express.json() — ${n} parses bodies itself`))}else if(n===`express`&&t!==`express`){let e=r(a.source,[{import:{from:`express`,default:`express`},slot:`middleware`,code:`${nr}\nexpress.json()`}],void 0,i);a.source=e.source,e.added.length>0&&a.changes.push(`added express.json() to middlewares`),e.manual.length>0&&a.manual.push(`Add express.json() to bootstrap({ middlewares }) yourself.`)}return a}function ir(e,t,n=`kick.config.ts`){let r=ar(n,e).body.find(e=>e.type===`ExportDefaultDeclaration`)?.declaration;for(;r&&(r.type===`TSSatisfiesExpression`||r.type===`TSAsExpression`);)r=r.expression;if(r?.type===`CallExpression`&&(r=r.arguments?.[0]),r?.type!==`ObjectExpression`)return null;let i=sr(r,`runtime`);if(!i)return cr(e,r,`runtime: '${t}'`);let a=i.value;if(a.type!==`Literal`||typeof a.value!=`string`)return null;let o=e[a.start]===`"`?`"`:`'`;return`${e.slice(0,a.start)}${o}${t}${o}${e.slice(a.end)}`}function ar(e,t){return Ft(e,t).program}function or(e){let t,n=e=>{if(t||!e||typeof e!=`object`)return;if(Array.isArray(e))return e.forEach(n);let r=e;if(r.type===`CallExpression`&&r.callee?.type===`Identifier`&&r.callee.name===`bootstrap`&&r.arguments?.[0]?.type===`ObjectExpression`)t=r.arguments[0];else for(let e in r)n(r[e])};return n(e),t}function sr(e,t){return e.properties.find(e=>e.type===`Property`&&(e.key?.name??e.key?.value)===t)}function cr(e,t,n){let r=t.properties[0];if(!r)return`${e.slice(0,t.start)}{ ${n} }${e.slice(t.end)}`;let i=e.lastIndexOf(`
369
+ `,r.start)+1,a=e.slice(i,r.start);return/^\s*$/.test(a)?`${e.slice(0,r.start)}${n},\n${a}${e.slice(r.start)}`:`${e.slice(0,r.start)}${n}, ${e.slice(r.start)}`}function lr(e,t){let n=or(ar(t,e)),r=n&&sr(n,`middlewares`);if(!r||r.value.type!==`ArrayExpression`)return e;let i=r.value.elements.find(e=>e?.type===`CallExpression`&&e.callee?.type===`MemberExpression`&&e.callee.object?.name===`express`&&e.callee.property?.name===`json`);if(!i)return e;let a=i.start,o=i.end,s=e.slice(o).match(/^\s*,/);s&&(o+=s[0].length);let c=e.lastIndexOf(`
370
370
  `,a)+1;if(/^\s*$/.test(e.slice(c,a))){a=c;let t=e.lastIndexOf(`
371
- `,a-2)+1;e.slice(t,a-1).trim()===ir&&(a=t);let n=e.indexOf(`
372
- `,o);n!==-1&&/^\s*$/.test(e.slice(o,n))&&(o=n+1)}return e.slice(0,a)+e.slice(o)}function dr(e,t,n){for(let r of e.body)if(r.type===`ImportDeclaration`&&r.source.value===t)for(let e of r.specifiers){let t=e.imported?.name??e.imported?.value;if(e.type===`ImportSpecifier`&&t===n)return e.local.name}}function fr(e,t,n,r){let i=Y(r,e);for(let r of i.body){if(r.type!==`ImportDeclaration`||r.source.value!==t)continue;let a=r.specifiers.find(e=>e.type===`ImportSpecifier`&&(e.imported?.name??e.imported?.value)===n);if(a)return mr(i,a.local.name)?e:hr(e,r,a)}return e}function pr(e,t,n){let r=Y(n,e);for(let n of r.body){if(n.type!==`ImportDeclaration`||n.source.value!==t)continue;let i=n.specifiers.find(e=>e.type===`ImportDefaultSpecifier`);if(i)return mr(r,i.local.name)?e:hr(e,n,i)}return e}function mr(e,t){let n=!1,r=e=>{if(n||!e||typeof e!=`object`)return;if(Array.isArray(e))return e.forEach(r);let i=e;if(i.type!==`ImportDeclaration`){if((i.type===`Identifier`||i.type===`IdentifierReference`)&&i.name===t)n=!0;else for(let e in i)e!==`parent`&&r(i[e])}};return r(e.body),n}function hr(e,t,n){let r=t.specifiers;if(r.length===1){let n=e[t.end]===`
373
- `?t.end+1:t.end;return e.slice(0,t.start)+e.slice(n)}let i=r.filter(e=>e.type===`ImportSpecifier`);if(n.type===`ImportSpecifier`&&i.length===1){let t=e.lastIndexOf(`,`,n.start),r=e.indexOf(`}`,n.end)+1;return e.slice(0,t)+e.slice(r)}if(n.type===`ImportDefaultSpecifier`){let t=e.indexOf(`,`,n.end)+1,r=e.slice(t).match(/^\s*/)[0].length;return e.slice(0,n.start)+e.slice(t+r)}let a=i.indexOf(n),o=a===0?n.start:i[a-1].end,s=a===0?i[1].start:n.end;return e.slice(0,o)+e.slice(s)}const gr={express:/from ['"](express|@types\/express)['"]/,fastify:/from ['"](fastify|@fastify\/[^'"]+)['"]/,h3:/from ['"]h3['"]/},_r=e=>e.replace(/(?<=.)@[^/]*$/,``);function vr(e){e.command(`runtime [engine]`).description(`Show the HTTP engine, or move the app to another: express | fastify | h3`).option(`--dry-run`,`Print what would change, and change nothing`).option(`--no-install`,`Edit the files only; leave packages to you`).option(`--pm <manager>`,`Package manager override`).option(`--entry <file>`,`Entry file (default: src/index.ts, then src/main.ts)`).option(`-f, --force`,`Edit files with uncommitted changes`).action(async(e,t)=>{let n=process.cwd(),r=await Ue(n);if(!e){let e=r.fromConfig?`kick.config.ts`:`guessed from package.json`;console.log(`\n HTTP runtime: ${r.runtime} (${e})`),r.ambiguous&&console.log(` Several engines are installed: ${r.candidates.join(`, `)}.`),console.log(` Move to another with: kick runtime <express|fastify|h3>
374
- `);return}let i;try{i=ze(e)}catch{console.error(`\n Unknown engine '${e}'. Expected express, fastify or h3.\n`),process.exitCode=1;return}if(r.ambiguous&&!r.fromConfig){console.error(`\n Cannot tell which engine this app boots on now: found ${r.candidates.join(`, `)} in package.json.\n Set \`runtime: '<engine>'\` in kick.config.ts, then rerun.\n`),process.exitCode=1;return}let a=r.runtime;if(a===i){console.log(`\n Already on ${i}.\n`);return}let o=Re(n,t.entry);if(!o){console.error(`\n No entry file (${t.entry??`src/index.ts or src/main.ts`}).\n`),process.exitCode=1;return}let s=[`kick.config.ts`,`kick.config.mts`,`kick.config.js`].find(e=>L(N(n,e))),c=Be(n,[o,...s?[s]:[]]);if(c.length>0&&!t.force&&!t.dryRun){console.error(`\n ${c.join(`, `)} ${c.length===1?`has`:`have`} uncommitted changes. Commit or stage them first, so this change is its own diff, or rerun with --force.
375
- `),process.exitCode=1;return}let l=ar(R(N(n,o),`utf-8`),a,i,o);if(l.blocked){for(let e of l.manual)console.error(`\n ${e}`);console.error(`\n Nothing changed. Fix that, then rerun kick runtime ${i}.\n`),process.exitCode=1;return}let u=s?R(N(n,s),`utf-8`):void 0,d=u===void 0?null:or(u,i,s);d===null&&l.manual.push(`Set \`runtime: '${i}'\` in ${s??`kick.config.ts`} so kick commands know the engine.`);let f=Sr(N(n,`src`)).map(e=>({file:e,text:e===N(n,o)?l.source:R(e,`utf-8`)})),m=f.some(({text:e})=>/@FileUpload\(|upload\.(single|array|none)\(/.test(e)),h=xr(n),{toAdd:g,toAddDev:_,toRemove:v,stillImported:y}=yr({from:a,to:i,installed:/* @__PURE__ */ new Set([...Object.keys(h.dependencies),...Object.keys(h.devDependencies)]),uploads:m,imported:e=>f.some(({text:t})=>RegExp(`from ['"]${e}(/[^'"]*)?['"]`).test(t))}),b=[];for(let{file:e,text:t}of f)t.split(`
376
- `).forEach((t,r)=>{(gr[a].test(t)||/\bctx\.res\./.test(t))&&b.push(`${P(n,e)}:${r+1} ${t.trim()}`)});console.log(`\n ${a} → ${i}\n`);for(let e of l.changes)console.log(` ${o}: ${e}`);if(d&&console.log(` ${s}: runtime: '${i}'`),g.length&&console.log(` + ${g.join(`, `)}`),_.length&&console.log(` + ${_.join(`, `)} (dev)`),v.length&&console.log(` - ${v.join(`, `)}`),y.length&&console.log(` kept ${y.join(`, `)}: still imported in src/`),t.dryRun){console.log(`
371
+ `,a-2)+1;e.slice(t,a-1).trim()===nr&&(a=t);let n=e.indexOf(`
372
+ `,o);n!==-1&&/^\s*$/.test(e.slice(o,n))&&(o=n+1)}return e.slice(0,a)+e.slice(o)}function ur(e,t,n){for(let r of e.body)if(r.type===`ImportDeclaration`&&r.source.value===t)for(let e of r.specifiers){let t=e.imported?.name??e.imported?.value;if(e.type===`ImportSpecifier`&&t===n)return e.local.name}}function dr(e,t,n,r){let i=ar(r,e);for(let r of i.body){if(r.type!==`ImportDeclaration`||r.source.value!==t)continue;let a=r.specifiers.find(e=>e.type===`ImportSpecifier`&&(e.imported?.name??e.imported?.value)===n);if(a)return pr(i,a.local.name)?e:mr(e,r,a)}return e}function fr(e,t,n){let r=ar(n,e);for(let n of r.body){if(n.type!==`ImportDeclaration`||n.source.value!==t)continue;let i=n.specifiers.find(e=>e.type===`ImportDefaultSpecifier`);if(i)return pr(r,i.local.name)?e:mr(e,n,i)}return e}function pr(e,t){let n=!1,r=e=>{if(n||!e||typeof e!=`object`)return;if(Array.isArray(e))return e.forEach(r);let i=e;if(i.type!==`ImportDeclaration`){if((i.type===`Identifier`||i.type===`IdentifierReference`)&&i.name===t)n=!0;else for(let e in i)e!==`parent`&&r(i[e])}};return r(e.body),n}function mr(e,t,n){let r=t.specifiers;if(r.length===1){let n=e[t.end]===`
373
+ `?t.end+1:t.end;return e.slice(0,t.start)+e.slice(n)}let i=r.filter(e=>e.type===`ImportSpecifier`);if(n.type===`ImportSpecifier`&&i.length===1){let t=e.lastIndexOf(`,`,n.start),r=e.indexOf(`}`,n.end)+1;return e.slice(0,t)+e.slice(r)}if(n.type===`ImportDefaultSpecifier`){let t=e.indexOf(`,`,n.end)+1,r=e.slice(t).match(/^\s*/)[0].length;return e.slice(0,n.start)+e.slice(t+r)}let a=i.indexOf(n),o=a===0?n.start:i[a-1].end,s=a===0?i[1].start:n.end;return e.slice(0,o)+e.slice(s)}const hr={express:/from ['"](express|@types\/express)['"]/,fastify:/from ['"](fastify|@fastify\/[^'"]+)['"]/,h3:/from ['"]h3['"]/},gr=e=>e.replace(/(?<=.)@[^/]*$/,``);function _r(e){e.command(`runtime [engine]`).description(`Show the HTTP engine, or move the app to another: express | fastify | h3`).option(`--dry-run`,`Print what would change, and change nothing`).option(`--no-install`,`Edit the files only; leave packages to you`).option(`--pm <manager>`,`Package manager override`).option(`--entry <file>`,`Entry file (default: src/index.ts, then src/main.ts)`).option(`-f, --force`,`Edit files with uncommitted changes`).action(async(e,t)=>{let n=process.cwd(),r=await p(n);if(!e){let e=r.fromConfig?`kick.config.ts`:`guessed from package.json`;console.log(`\n HTTP runtime: ${r.runtime} (${e})`),r.ambiguous&&console.log(` Several engines are installed: ${r.candidates.join(`, `)}.`),console.log(` Move to another with: kick runtime <express|fastify|h3>
374
+ `);return}let i;try{i=l(e)}catch{console.error(`\n Unknown engine '${e}'. Expected express, fastify or h3.\n`),process.exitCode=1;return}if(r.ambiguous&&!r.fromConfig){console.error(`\n Cannot tell which engine this app boots on now: found ${r.candidates.join(`, `)} in package.json.\n Set \`runtime: '<engine>'\` in kick.config.ts, then rerun.\n`),process.exitCode=1;return}let a=r.runtime;if(a===i){console.log(`\n Already on ${i}.\n`);return}let o=c(n,t.entry);if(!o){console.error(`\n No entry file (${t.entry??`src/index.ts or src/main.ts`}).\n`),process.exitCode=1;return}let s=[`kick.config.ts`,`kick.config.mts`,`kick.config.js`].find(e=>z(F(n,e))),d=u(n,[o,...s?[s]:[]]);if(d.length>0&&!t.force&&!t.dryRun){console.error(`\n ${d.join(`, `)} ${d.length===1?`has`:`have`} uncommitted changes. Commit or stage them first, so this change is its own diff, or rerun with --force.
375
+ `),process.exitCode=1;return}let f=rr(B(F(n,o),`utf-8`),a,i,o);if(f.blocked){for(let e of f.manual)console.error(`\n ${e}`);console.error(`\n Nothing changed. Fix that, then rerun kick runtime ${i}.\n`),process.exitCode=1;return}let m=s?B(F(n,s),`utf-8`):void 0,h=m===void 0?null:ir(m,i,s);h===null&&f.manual.push(`Set \`runtime: '${i}'\` in ${s??`kick.config.ts`} so kick commands know the engine.`);let g=xr(F(n,`src`)).map(e=>({file:e,text:e===F(n,o)?f.source:B(e,`utf-8`)})),_=g.some(({text:e})=>/@FileUpload\(|upload\.(single|array|none)\(/.test(e)),y=br(n),{toAdd:b,toAddDev:x,toRemove:S,stillImported:ee}=vr({from:a,to:i,installed:/* @__PURE__ */ new Set([...Object.keys(y.dependencies),...Object.keys(y.devDependencies)]),uploads:_,imported:e=>g.some(({text:t})=>RegExp(`from ['"]${e}(/[^'"]*)?['"]`).test(t))}),te=[];for(let{file:e,text:t}of g)t.split(`
376
+ `).forEach((t,r)=>{(hr[a].test(t)||/\bctx\.res\./.test(t))&&te.push(`${I(n,e)}:${r+1} ${t.trim()}`)});console.log(`\n ${a} → ${i}\n`);for(let e of f.changes)console.log(` ${o}: ${e}`);if(h&&console.log(` ${s}: runtime: '${i}'`),b.length&&console.log(` + ${b.join(`, `)}`),x.length&&console.log(` + ${x.join(`, `)} (dev)`),S.length&&console.log(` - ${S.join(`, `)}`),ee.length&&console.log(` kept ${ee.join(`, `)}: still imported in src/`),t.dryRun){console.log(`
377
377
  Dry run: nothing changed.
378
- `),br(l.manual,b,a);return}B(N(n,o),l.source),d!==null&&B(N(n,s),d);let x=!0;if(t.install!==!1){let{pm:e}=await p(t.pm),r=t=>{let r=[e,...t].join(` `);console.log(`\n ${r}`);try{qe(e,t,{cwd:n})}catch{x=!1,console.log(` Failed. Run it yourself:\n ${r}`)}};g.length&&r([`add`,...g]),_.length&&r([`add`,`-D`,..._]),v.length&&r([e===`npm`?`uninstall`:`remove`,...v])}br(l.manual,b,a),console.log(x?" Done. Run `kick typegen` and your typecheck to see the rest.\n":` Files changed; the package step above did not finish.
379
- `),x||(process.exitCode=1)})}function yr(e){let{from:t,to:n,installed:r,uploads:i,imported:a}=e,o=[...Pe[n],...i&&D[n].prod?[D[n].prod]:[]],s=[...n===`express`?[`@types/express`]:[],...i&&D[n].dev?[D[n].dev]:[]],c=new Set([...o,...s].map(_r)),l=[...Pe[t],...t===`express`?[`@types/express`]:[],...D[t].prod?[D[t].prod]:[],...D[t].dev?[D[t].dev]:[]].map(_r).filter(e=>r.has(e)&&!c.has(e)),u=l.filter(e=>a(e.replace(/^@types\//,``)));return{toAdd:o.filter(e=>!r.has(_r(e))),toAddDev:s.filter(e=>!r.has(_r(e))),toRemove:l.filter(e=>!u.includes(e)),stillImported:u}}function br(e,t,n){for(let t of e)console.log(`\n ! ${t}`);if(t.length>0){console.log(`\n Review — code that uses ${n} or the engine's response (ctx.res) directly:`);for(let e of t)console.log(` ${e}`)}console.log()}function xr(e){try{let t=JSON.parse(R(N(e,`package.json`),`utf-8`));return{dependencies:t.dependencies??{},devDependencies:t.devDependencies??{}}}catch{return{dependencies:{},devDependencies:{}}}}function Sr(e){return L(e)?z(e,{withFileTypes:!0,recursive:!0}).filter(e=>e.isFile()&&/\.(ts|tsx|mts)$/.test(e.name)).map(e=>N(e.parentPath,e.name)):[]}function X(e,t){let n=e.toLowerCase();return t.every(e=>n.includes(e.toLowerCase()))}function Z(e,t){let n=e.toLowerCase();return t.some(e=>n.includes(e.toLowerCase()))}const Cr=[{match(e,t){let n=X(e,[`config`,`get`])&&Z(e,[`undefined`,`null`]),r=e.includes(`@Value`)&&Z(e,[`undefined`,`is not defined`]);return!n&&!r?null:Z(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
378
+ `),yr(f.manual,te,a);return}H(F(n,o),f.source),h!==null&&H(F(n,s),h);let ne=!0;if(t.install!==!1){let{pm:e}=await oe(t.pm),r=t=>{let r=[e,...t].join(` `);console.log(`\n ${r}`);try{v(e,t,{cwd:n})}catch{ne=!1,console.log(` Failed. Run it yourself:\n ${r}`)}};b.length&&r([`add`,...b]),x.length&&r([`add`,`-D`,...x]),S.length&&r([e===`npm`?`uninstall`:`remove`,...S])}yr(f.manual,te,a),console.log(ne?" Done. Run `kick typegen` and your typecheck to see the rest.\n":` Files changed; the package step above did not finish.
379
+ `),ne||(process.exitCode=1)})}function vr(e){let{from:t,to:n,installed:r,uploads:a,imported:o}=e,s=[...i[n],...a&&h[n].prod?[h[n].prod]:[]],c=[...n===`express`?[`@types/express`]:[],...a&&h[n].dev?[h[n].dev]:[]],l=new Set([...s,...c].map(gr)),u=[...i[t],...t===`express`?[`@types/express`]:[],...h[t].prod?[h[t].prod]:[],...h[t].dev?[h[t].dev]:[]].map(gr).filter(e=>r.has(e)&&!l.has(e)),d=u.filter(e=>o(e.replace(/^@types\//,``)));return{toAdd:s.filter(e=>!r.has(gr(e))),toAddDev:c.filter(e=>!r.has(gr(e))),toRemove:u.filter(e=>!d.includes(e)),stillImported:d}}function yr(e,t,n){for(let t of e)console.log(`\n ! ${t}`);if(t.length>0){console.log(`\n Review — code that uses ${n} or the engine's response (ctx.res) directly:`);for(let e of t)console.log(` ${e}`)}console.log()}function br(e){try{let t=JSON.parse(B(F(e,`package.json`),`utf-8`));return{dependencies:t.dependencies??{},devDependencies:t.devDependencies??{}}}catch{return{dependencies:{},devDependencies:{}}}}function xr(e){return z(e)?V(e,{withFileTypes:!0,recursive:!0}).filter(e=>e.isFile()&&/\.(ts|tsx|mts)$/.test(e.name)).map(e=>F(e.parentPath,e.name)):[]}function Z(e,t){let n=e.toLowerCase();return t.every(e=>n.includes(e.toLowerCase()))}function Q(e,t){let n=e.toLowerCase();return t.some(e=>n.includes(e.toLowerCase()))}const Sr=[{match(e,t){let n=Z(e,[`config`,`get`])&&Q(e,[`undefined`,`null`]),r=e.includes(`@Value`)&&Q(e,[`undefined`,`is not defined`]);return!n&&!r?null:Q(e,[`vitest`,`createTestApp`,`__tests__`,`.test.`,`.spec.`])?{confidence:85,diagnosis:{id:`env-schema-not-registered-in-test`,title:`ConfigService.get() returns undefined inside a test`,explanation:`The env schema is registered by a module-load side effect in
380
380
  src/config/index.ts, and src/index.ts imports it before bootstrap().
381
381
  Tests never load src/index.ts — \`createTestApp\` builds the app
382
382
  directly — so that import does not run and ConfigService falls back to
@@ -400,7 +400,7 @@ import { modules } from './modules'
400
400
  import './config' // ← add this — registers env schema
401
401
  import { bootstrap } from '@forinda/kickjs'
402
402
  import { modules } from './modules'
403
- `,docs:`https://kickjs.app/guide/configuration.html#wiring-the-schema-at-startup`}}}},{match(e,t){let n=Z(e,[`vitest`,`createTestApp`,`__tests__`,`.test.`,`.spec.`]);return Z(e,[`already registered`,`already exists`,`duplicate`,`has been registered`])?{confidence:n?85:60,diagnosis:{id:`container-not-reset-in-tests`,title:`DI container leaks between test cases`,explanation:`KickJS decorators register classes on the global Container at import time.
403
+ `,docs:`https://kickjs.app/guide/configuration.html#wiring-the-schema-at-startup`}}}},{match(e,t){let n=Q(e,[`vitest`,`createTestApp`,`__tests__`,`.test.`,`.spec.`]);return Q(e,[`already registered`,`already exists`,`duplicate`,`has been registered`])?{confidence:n?85:60,diagnosis:{id:`container-not-reset-in-tests`,title:`DI container leaks between test cases`,explanation:`KickJS decorators register classes on the global Container at import time.
404
404
  When vitest re-imports your modules across tests, the same class can be
405
405
  registered twice and the container throws. The fix is to wipe the
406
406
  container between tests so each case starts fresh.`,fix:`Add Container.reset() to a beforeEach hook in the failing test file:`,codeAfter:`import { describe, it, beforeEach } from 'vitest'
@@ -410,7 +410,7 @@ describe('UserController', () => {
410
410
  beforeEach(() => Container.reset())
411
411
 
412
412
  it('does the thing', async () => { /* ... */ })
413
- })`,docs:`https://kickjs.app/guide/testing.html`}}:null}},{match(e,t){return e.includes(`@Module`)||X(e,[`Module`,`is not a function`])||X(e,[`Module`,`no exported member`])?{confidence:80,diagnosis:{id:`module-decorator-not-found`,title:`KickJS does not have a @Module decorator (different pattern from NestJS)`,explanation:`NestJS uses @Module({ controllers, providers }). KickJS uses an interface
413
+ })`,docs:`https://kickjs.app/guide/testing.html`}}:null}},{match(e,t){return e.includes(`@Module`)||Z(e,[`Module`,`is not a function`])||Z(e,[`Module`,`no exported member`])?{confidence:80,diagnosis:{id:`module-decorator-not-found`,title:`KickJS does not have a @Module decorator (different pattern from NestJS)`,explanation:`NestJS uses @Module({ controllers, providers }). KickJS uses an interface
414
414
  pattern instead: a class implements AppModule and exposes routes() that
415
415
  returns the controller wiring. This was a deliberate choice — modules
416
416
  become explicit values rather than metadata, which makes them easier to
@@ -437,7 +437,7 @@ KickRoutes["POST /users"]. The new form is per-controller, per-method,
437
437
  and matches the actual class names so refactors propagate via
438
438
  rename-symbol instead of grep.`,fix:`Update the Ctx<...> type parameter to use the namespace form:`,codeBefore:`@Post('/', { body: createUserSchema })
439
439
  create(ctx: Ctx<KickRoutes['POST /users']>) { /* ... */ }`,codeAfter:`@Post('/', { body: createUserSchema, name: 'CreateUser' })
440
- create(ctx: Ctx<KickRoutes.UserController['create']>) { /* ... */ }`,docs:`https://kickjs.app/guide/typegen.html`}}:null}},{match(e,t){let n=Z(e,[`cluster`,`workers`,`two ports`,`duplicate server`]),r=Z(e,[`kick dev`,`vite`,`eaddrinuse`,`5173`,`5174`,`two servers`]);return!n||!r?null:{confidence:85,diagnosis:{id:`cluster-in-vite-dev`,title:"Cluster mode is incompatible with `kick dev` (Vite owns the server)",explanation:`In dev mode, Vite owns the HTTP server. If your bootstrap passes
440
+ create(ctx: Ctx<KickRoutes.UserController['create']>) { /* ... */ }`,docs:`https://kickjs.app/guide/typegen.html`}}:null}},{match(e,t){let n=Q(e,[`cluster`,`workers`,`two ports`,`duplicate server`]),r=Q(e,[`kick dev`,`vite`,`eaddrinuse`,`5173`,`5174`,`two servers`]);return!n||!r?null:{confidence:85,diagnosis:{id:`cluster-in-vite-dev`,title:"Cluster mode is incompatible with `kick dev` (Vite owns the server)",explanation:`In dev mode, Vite owns the HTTP server. If your bootstrap passes
441
441
  cluster: { workers: N }, the framework forks N workers, each of which
442
442
  spins up its own Vite instance on a separate port. The fix landed in
443
443
  v2.2.5: McpAdapter (and bootstrap()) now detects Vite dev mode and
@@ -445,7 +445,7 @@ silently skips cluster, with a warning. If you see this on an older
445
445
  version, upgrade or guard the cluster option behind NODE_ENV.`,fix:`Either upgrade to v2.2.5+ or gate cluster mode on production:`,codeAfter:`export const app = await bootstrap({
446
446
  modules,
447
447
  cluster: process.env.NODE_ENV === 'production' ? { workers: 4 } : false,
448
- })`,docs:`https://kickjs.app/guide/cluster.html`}}}},{match(e,t){return Z(e,[`reflect-metadata`,`Reflect.getMetadata is not a function`,`Reflect.defineMetadata`,`design:type`,`design:paramtypes`])?{confidence:90,diagnosis:{id:`reflect-metadata-missing`,title:`reflect-metadata is not loaded — DI cannot read decorator types`,explanation:`The DI container reads constructor parameter types via the
448
+ })`,docs:`https://kickjs.app/guide/cluster.html`}}}},{match(e,t){return Q(e,[`reflect-metadata`,`Reflect.getMetadata is not a function`,`Reflect.defineMetadata`,`design:type`,`design:paramtypes`])?{confidence:90,diagnosis:{id:`reflect-metadata-missing`,title:`reflect-metadata is not loaded — DI cannot read decorator types`,explanation:`The DI container reads constructor parameter types via the
449
449
  reflect-metadata polyfill. The polyfill must be imported once,
450
450
  before any decorator runs. Most projects do this at the top of
451
451
  src/index.ts; missing the import causes obscure "design:paramtypes"
@@ -454,7 +454,7 @@ import './config'
454
454
  import { bootstrap } from '@forinda/kickjs'
455
455
  import { modules } from './modules'
456
456
 
457
- export const app = await bootstrap({ modules })`,docs:`https://kickjs.app/guide/dependency-injection.html`}}:null}},{match(e,t){return Z(e,[`404`,`cannot get`,`cannot post`,`no route`])?{confidence:50,diagnosis:{id:`module-not-registered`,title:`A 404 may indicate a module is not in the modules array`,explanation:`KickJS only mounts modules listed in \`src/modules/index.ts\`. If you
457
+ export const app = await bootstrap({ modules })`,docs:`https://kickjs.app/guide/dependency-injection.html`}}:null}},{match(e,t){return Q(e,[`404`,`cannot get`,`cannot post`,`no route`])?{confidence:50,diagnosis:{id:`module-not-registered`,title:`A 404 may indicate a module is not in the modules array`,explanation:`KickJS only mounts modules listed in \`src/modules/index.ts\`. If you
458
458
  generated a module via \`kick g module foo\` but the routes don't appear,
459
459
  the most likely cause is that the module is missing from the exported
460
460
  array. The CLI usually wires this automatically, but a hand-edit can
@@ -462,7 +462,7 @@ drop the entry.`,fix:`Open src/modules/index.ts and verify the module is in the
462
462
  import { UserModule } from './users/user.module'
463
463
  import { TaskModule } from './tasks/task.module' // ← was this missing?
464
464
 
465
- export const modules: AppModuleEntry[] = [UserModule(), TaskModule()]`,docs:`https://kickjs.app/guide/project-structure.html`}}:null}},{match(e,t){if(!Z(e,[`vitest`,`test`,`spec`,`__tests__`,`.test.`,`jest`]))return null;let n=Z(e,[`wrong database`,`dev database`,`development database`,`production database`,`wrong db`,`dev db`,`connected to the wrong`,`wiped`,`truncated`,`deleted rows`,`sent a real email`,`real email`,`live api`]),r=Z(e,[`stubenv`,`process.env`,`setupfiles`,`test.env`,`env override`])&&Z(e,[`no effect`,`not applied`,`ignored`,`still`,`undefined`,`does nothing`,`doesn't work`,`not working`]);if(!n&&!r)return null;let i=t?.hasFile?.(`.env`)===!0||t?.hasFile?.(`.env.local`)===!0,a=t?.hasFile?.(`.env.test`)===!0||t?.hasFile?.(`.env.test.local`)===!0,o=i&&!a,s=n&&r?85:n?75:65;return o&&(s=Math.min(95,s+10)),{confidence:s,diagnosis:{id:`test-env-leaked-from-dotenv`,title:`Test run inherited env vars from your development .env`,explanation:`KickJS loads dotenv as an import-time side effect, with \`override: false\`.
465
+ export const modules: AppModuleEntry[] = [UserModule(), TaskModule()]`,docs:`https://kickjs.app/guide/project-structure.html`}}:null}},{match(e,t){if(!Q(e,[`vitest`,`test`,`spec`,`__tests__`,`.test.`,`jest`]))return null;let n=Q(e,[`wrong database`,`dev database`,`development database`,`production database`,`wrong db`,`dev db`,`connected to the wrong`,`wiped`,`truncated`,`deleted rows`,`sent a real email`,`real email`,`live api`]),r=Q(e,[`stubenv`,`process.env`,`setupfiles`,`test.env`,`env override`])&&Q(e,[`no effect`,`not applied`,`ignored`,`still`,`undefined`,`does nothing`,`doesn't work`,`not working`]);if(!n&&!r)return null;let i=t?.hasFile?.(`.env`)===!0||t?.hasFile?.(`.env.local`)===!0,a=t?.hasFile?.(`.env.test`)===!0||t?.hasFile?.(`.env.test.local`)===!0,o=i&&!a,s=n&&r?85:n?75:65;return o&&(s=Math.min(95,s+10)),{confidence:s,diagnosis:{id:`test-env-leaked-from-dotenv`,title:`Test run inherited env vars from your development .env`,explanation:`KickJS loads dotenv as an import-time side effect, with \`override: false\`.
466
466
  That protects the vars your test runner pinned — but every var it did NOT
467
467
  pin is silently backfilled from your \`.env\`. So a suite can pin its database
468
468
  URL and still reach live development services through the vars it forgot,
@@ -496,7 +496,7 @@ beforeAll(() => {
496
496
  vi.stubEnv('JWT_SECRET', 'x'.repeat(32))
497
497
  resetEnvCache()
498
498
  loadEnv(envSchema)
499
- })`,docs:`https://kickjs.app/guide/testing.html#environment-isolation`}}}},{match(e,t){let n=X(e,[`cannot inject`,`request-scoped`,`singleton`]),r=X(e,[`request-scoped`,`singleton`]);return!n&&!r?null:{confidence:n?100:70,diagnosis:{id:`di-request-scope-into-singleton`,title:`A SINGLETON cannot hold a REQUEST-scoped dependency`,explanation:`Controllers are SINGLETON by default: one instance for the process, built
499
+ })`,docs:`https://kickjs.app/guide/testing.html#environment-isolation`}}}},{match(e,t){let n=Z(e,[`cannot inject`,`request-scoped`,`singleton`]),r=Z(e,[`request-scoped`,`singleton`]);return!n&&!r?null:{confidence:n?100:70,diagnosis:{id:`di-request-scope-into-singleton`,title:`A SINGLETON cannot hold a REQUEST-scoped dependency`,explanation:`Controllers are SINGLETON by default: one instance for the process, built
500
500
  the first time the container resolves it. A REQUEST-scoped binding is the
501
501
  opposite — one instance per request, discarded when the response ends.
502
502
 
@@ -517,7 +517,7 @@ and the singleton never captures one.
517
517
 
518
518
  If the dependency did not need request scope in the first place, the
519
519
  other direction also works — make it SINGLETON and pass the per-request
520
- values in as method arguments.`,docs:`https://kickjs.app/guide/dependency-injection.html#scopes`}}}},{match(e,t){let n=e.toLowerCase().includes(`circular dependency detected`),r=X(e,[`circular`,`dependency`]);return!n&&!r?null:{confidence:n?100:65,diagnosis:{id:`di-circular-dependency`,title:`Two services depend on each other, directly or through a chain`,explanation:`The container resolves constructor dependencies depth-first. When a token
520
+ values in as method arguments.`,docs:`https://kickjs.app/guide/dependency-injection.html#scopes`}}}},{match(e,t){let n=e.toLowerCase().includes(`circular dependency detected`),r=Z(e,[`circular`,`dependency`]);return!n&&!r?null:{confidence:n?100:65,diagnosis:{id:`di-circular-dependency`,title:`Two services depend on each other, directly or through a chain`,explanation:`The container resolves constructor dependencies depth-first. When a token
521
521
  is requested while it is already being resolved further up the stack, the
522
522
  graph has a cycle and there is no order that satisfies both ends.
523
523
 
@@ -549,7 +549,7 @@ export class OrderService {
549
549
  @Service()
550
550
  export class BillingService {
551
551
  @Autowired() private readonly orders!: OrderService // ← resolved after construction
552
- }`,docs:`https://kickjs.app/guide/dependency-injection.html#circular-dependency-detection`}}}},{match(e,t){let n=e.includes(`KICK001`),r=Z(e,[`no provider for`,`no provider found for`,`no binding is registered`]);return!n&&!r?null:{confidence:n?100:85,diagnosis:{id:`di-no-provider-for-token`,title:`A token was requested but nothing registers it`,explanation:`Decorators register bindings as a side effect of the class being LOADED —
552
+ }`,docs:`https://kickjs.app/guide/dependency-injection.html#circular-dependency-detection`}}}},{match(e,t){let n=e.includes(`KICK001`),r=Q(e,[`no provider for`,`no provider found for`,`no binding is registered`]);return!n&&!r?null:{confidence:n?100:85,diagnosis:{id:`di-no-provider-for-token`,title:`A token was requested but nothing registers it`,explanation:`Decorators register bindings as a side effect of the class being LOADED —
553
553
  and a class is only loaded if something imports it. A module that is not
554
554
  in the bootstrap array is never imported, so none of its @Service /
555
555
  @Repository / @Controller classes ever register, and the first thing that
@@ -575,7 +575,7 @@ export const TenantModule = defineModule({
575
575
  },
576
576
  routes: () => null,
577
577
  }),
578
- })`,docs:`https://kickjs.app/guide/dependency-injection.html#registering-services`}}}},{match(e,t){if(!Z(e,[`vite`,`kick dev`,`dev server`,`localhost:5173`,`:5173`])||!Z(e,[`404`,`not found`,`cannot get`,`cannot post`,`no route`]))return null;let n=X(e,[`app`,`export`]),r=Z(e,[`every route`,`all routes`,`every endpoint`,`all endpoints`,`none of the routes`]);return!n&&!r?null:{confidence:n&&r?85:n?80:70,diagnosis:{id:`vite-dev-app-not-exported`,title:"Every route 404s in dev because the entry file exports no `app`",explanation:`The Vite plugin does not start your server. It imports the entry module
578
+ })`,docs:`https://kickjs.app/guide/dependency-injection.html#registering-services`}}}},{match(e,t){if(!Q(e,[`vite`,`kick dev`,`dev server`,`localhost:5173`,`:5173`])||!Q(e,[`404`,`not found`,`cannot get`,`cannot post`,`no route`]))return null;let n=Z(e,[`app`,`export`]),r=Q(e,[`every route`,`all routes`,`every endpoint`,`all endpoints`,`none of the routes`]);return!n&&!r?null:{confidence:n&&r?85:n?80:70,diagnosis:{id:`vite-dev-app-not-exported`,title:"Every route 404s in dev because the entry file exports no `app`",explanation:`The Vite plugin does not start your server. It imports the entry module
579
579
  and reads \`app\` off it, then hands each request to that instance.
580
580
 
581
581
  When the entry runs \`await bootstrap(...)\` without assigning the result to
@@ -591,23 +591,23 @@ import { bootstrap } from '@forinda/kickjs'
591
591
  await bootstrap({ modules }) // ← nothing for the dev server to read`,codeAfter:`import './env'
592
592
  import { bootstrap } from '@forinda/kickjs'
593
593
 
594
- export const app = await bootstrap({ modules })`,docs:`https://kickjs.app/guide/project-structure.html`}}}}];function wr(e,t){let n=null;for(let r of Cr){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 Tr(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.
594
+ export const app = await bootstrap({ modules })`,docs:`https://kickjs.app/guide/project-structure.html`}}}}];function Cr(e,t){let n=null;for(let r of Sr){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 wr(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.
595
595
  export OPENAI_API_KEY="sk-..."
596
596
 
597
597
  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:
598
598
  kick add ai
599
599
 
600
600
  Or manually:
601
- ${u()} add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=Er(e.cwd),s=`Error or stack trace:\n\n${e.input.trim()}`;try{let e=Dr((await a.chat({messages:[{role:`system`,content:o},{role:`user`,content:s}]})).content);return e?{kind:`ok`,diagnosis:e}:{kind:`error`,message:`The LLM responded but the payload was not valid JSON in the expected shape. Try again, or file an issue with the error text.`}}catch(e){return{kind:`error`,message:`LLM request failed: ${e instanceof Error?e.message:String(e)}`}}}function Er(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(`
602
- `)}function Dr(e){let t=[e,Or(e),kr(e)].filter(e=>e!==null);for(let e of t)try{let t=JSON.parse(e);if(Ar(t))return t}catch{continue}return null}function Or(e){let t=e.match(/```(?:json)?\s*\n([\s\S]*?)```/);return t?t[1]?.trim()??null:null}function kr(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 Ar(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 jr(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 Pr(e,t.message);(!n||n.trim().length===0)&&(process.stderr.write(`Error: no input provided.
601
+ ${T()} add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=Tr(e.cwd),s=`Error or stack trace:\n\n${e.input.trim()}`;try{let e=Er((await a.chat({messages:[{role:`system`,content:o},{role:`user`,content:s}]})).content);return e?{kind:`ok`,diagnosis:e}:{kind:`error`,message:`The LLM responded but the payload was not valid JSON in the expected shape. Try again, or file an issue with the error text.`}}catch(e){return{kind:`error`,message:`LLM request failed: ${e instanceof Error?e.message:String(e)}`}}}function Tr(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(`
602
+ `)}function Er(e){let t=[e,Dr(e),Or(e)].filter(e=>e!==null);for(let e of t)try{let t=JSON.parse(e);if(kr(t))return t}catch{continue}return null}function Dr(e){let t=e.match(/```(?:json)?\s*\n([\s\S]*?)```/);return t?t[1]?.trim()??null:null}function Or(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 kr(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 Ar(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 Nr(e,t.message);n&&n.trim().length!==0||(process.stderr.write(`Error: no input provided.
603
603
 
604
604
  Pass a message as a positional arg, --message flag, or pipe via stdin:
605
605
  kick explain "config.get returned undefined"
606
- ${je(u(),`test`)} 2>&1 | kick explain\n`),process.exit(1));let r=Ir(),i=wr(n,r);if(t.json&&i){process.stdout.write(JSON.stringify({matched:!0,...i},null,2)+`
607
- `);return}if(i){Lr(n,i.diagnosis,i.confidence);return}t.ai||(t.json&&(process.stdout.write(JSON.stringify({matched:!1},null,2)+`
608
- `),process.exit(2)),Rr(n),process.exit(2));let a=await Tr({input:n,model:t.model,cwd:r.cwd});t.json&&(process.stdout.write(JSON.stringify(Mr(a),null,2)+`
609
- `),process.exit(a.kind===`ok`?0:2)),Nr(n,a),process.exit(a.kind===`ok`?0:2)})}function Mr(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 Nr(e,t){t.kind===`ok`?Lr(e,t.diagnosis,-1,!0):t.kind===`unavailable`?(process.stdout.write(`\n Explaining: ${Br(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback unavailable: ${t.reason}\n\n`),process.stdout.write(`${zr(t.suggestion,` `)}\n\n`)):(process.stdout.write(`\n Explaining: ${Br(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback error: ${t.message}\n\n`))}async function Pr(e,t){return e&&e.trim().length>0?e:t&&t.trim().length>0?t:process.stdin.isTTY?``:Fr()}function Fr(){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 Ir(){let e=process.cwd();return{cwd:e,hasFile:t=>L(F(e,t))}}function Lr(e,t,n,r=!1){let i=Br(e.trim(),200),a=r?`AI-generated — verify before applying`:Vr(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${zr(t.explanation,` `)}\n`),process.stdout.write(`\n Fix:\n${zr(t.fix,` `)}\n`),t.codeBefore&&process.stdout.write(`\n Before:\n${zr(t.codeBefore,` `)}\n`),t.codeAfter&&process.stdout.write(`\n After:\n${zr(t.codeAfter,` `)}\n`),t.docs&&process.stdout.write(`\n Docs: ${t.docs}\n`),process.stdout.write(`
610
- `)}function Rr(e){let t=Br(e.trim(),200);process.stdout.write(`\n Explaining: ${t}\n\n`),process.stdout.write(` No known-issue matched. Things you can try:
606
+ ${_e(T(),`test`)} 2>&1 | kick explain\n`),process.exit(1));let r=Fr(),i=Cr(n,r);if(t.json&&i){process.stdout.write(JSON.stringify({matched:!0,...i},null,2)+`
607
+ `);return}if(i){Ir(n,i.diagnosis,i.confidence);return}t.ai||(t.json&&(process.stdout.write(JSON.stringify({matched:!1},null,2)+`
608
+ `),process.exit(2)),Lr(n),process.exit(2));let a=await wr({input:n,model:t.model,cwd:r.cwd});t.json&&(process.stdout.write(JSON.stringify(jr(a),null,2)+`
609
+ `),process.exit(a.kind===`ok`?0:2)),Mr(n,a),process.exit(a.kind===`ok`?0:2)})}function jr(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 Mr(e,t){t.kind===`ok`?Ir(e,t.diagnosis,-1,!0):t.kind===`unavailable`?(process.stdout.write(`\n Explaining: ${zr(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback unavailable: ${t.reason}\n\n`),process.stdout.write(`${Rr(t.suggestion,` `)}\n\n`)):(process.stdout.write(`\n Explaining: ${zr(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback error: ${t.message}\n\n`))}async function Nr(e,t){return e&&e.trim().length>0?e:t&&t.trim().length>0?t:process.stdin.isTTY?``:Pr()}function Pr(){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 Fr(){let e=process.cwd();return{cwd:e,hasFile:t=>z(L(e,t))}}function Ir(e,t,n,r=!1){let i=zr(e.trim(),200),a=r?`AI-generated — verify before applying`:Br(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${Rr(t.explanation,` `)}\n`),process.stdout.write(`\n Fix:\n${Rr(t.fix,` `)}\n`),t.codeBefore&&process.stdout.write(`\n Before:\n${Rr(t.codeBefore,` `)}\n`),t.codeAfter&&process.stdout.write(`\n After:\n${Rr(t.codeAfter,` `)}\n`),t.docs&&process.stdout.write(`\n Docs: ${t.docs}\n`),process.stdout.write(`
610
+ `)}function Lr(e){let t=zr(e.trim(),200);process.stdout.write(`\n Explaining: ${t}\n\n`),process.stdout.write(` No known-issue matched. Things you can try:
611
611
 
612
612
  1. Check the framework docs for the error keywords:
613
613
  https://kickjs.app/
@@ -619,10 +619,10 @@ Pass a message as a positional arg, --message flag, or pipe via stdin:
619
619
  3. File an issue with the error text:
620
620
  https://github.com/forinda/kick-js/issues/new
621
621
 
622
- `)}function zr(e,t){return e.split(`
622
+ `)}function Rr(e,t){return e.split(`
623
623
  `).map(e=>`${t}${e}`).join(`
624
- `)}function Br(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function Vr(e){return e>=90?`high confidence`:e>=70?`good match`:e>=50?`medium confidence`:`low confidence — verify manually`}function Hr(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(Ur),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(Wr)}function Ur(e){let t=F(e.entry);L(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=Nt(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 Wr(e){let t=process.cwd(),n=Gr(t)??xt(t),r=e.name??n,i=e.global?F(process.env.HOME??`.`,`.mcp.json`):F(t,e.out),a={command:`kick`,args:[`mcp`],cwd:t},o={mcpServers:{}};if(L(i))try{let e=R(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,B(i,JSON.stringify(o,null,2)+`
625
- `,`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 Gr(e){let t=F(e,`package.json`);if(!L(t))return null;try{let e=R(t,`utf8`),n=JSON.parse(e);return typeof n.name==`string`?n.name:null}catch{return null}}function Kr(e){e.command(`tinker`).description(`Interactive REPL with DI container and services loaded`).option(`-e, --entry <file>`,`Entry file to load`,`src/index.ts`).action(async e=>{let t=process.cwd(),n=F(t,e.entry);L(n)||(console.error(`\n Error: ${e.entry} not found.\n`),process.exit(1));let r=Jr(t,`tsx`);r||(console.error(`\n Error: tsx not found. Install it: ${u(t)} add -D tsx\n`),process.exit(1));let i=qr(n,e.entry),a=N(t,`.kick-tinker.mjs`),{writeFileSync:o,unlinkSync:s}=await import(`node:fs`);o(a,i,`utf-8`);try{let e=Mt(a,[],{cwd:t,execPath:r,stdio:`inherit`});await new Promise(t=>{e.on(`exit`,()=>t())})}finally{try{s(a)}catch{}}})}function qr(e,t){return`
624
+ `)}function zr(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function Br(e){return e>=90?`high confidence`:e>=70?`good match`:e>=50?`medium confidence`:`low confidence — verify manually`}function Vr(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(Hr),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(Ur)}function Hr(e){let t=L(e.entry);z(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=jt(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 Ur(e){let t=process.cwd(),n=Wr(t)??yt(t),r=e.name??n,i=e.global?L(process.env.HOME??`.`,`.mcp.json`):L(t,e.out),a={command:`kick`,args:[`mcp`],cwd:t},o={mcpServers:{}};if(z(i))try{let e=B(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,H(i,JSON.stringify(o,null,2)+`
625
+ `,`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 Wr(e){let t=L(e,`package.json`);if(!z(t))return null;try{let e=B(t,`utf8`),n=JSON.parse(e);return typeof n.name==`string`?n.name:null}catch{return null}}function Gr(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=L(t,e.entry);z(n)||(console.error(`\n Error: ${e.entry} not found.\n`),process.exit(1));let r=qr(t,`tsx`);r||(console.error(`\n Error: tsx not found. Install it: ${T(t)} add -D tsx\n`),process.exit(1));let i=Kr(n,e.entry),a=F(t,`.kick-tinker.mjs`),{writeFileSync:o,unlinkSync:s}=await import(`node:fs`);o(a,i,`utf-8`);try{let e=At(a,[],{cwd:t,execPath:r,stdio:`inherit`});await new Promise(t=>{e.on(`exit`,()=>t())})}finally{try{s(a)}catch{}}})}function Kr(e,t){return`
626
626
  import 'reflect-metadata'
627
627
 
628
628
  // Prevent bootstrap() from starting the HTTP server
@@ -647,7 +647,7 @@ try {
647
647
 
648
648
  // Load entry to trigger decorator registration
649
649
  try {
650
- await import('${H(e).href}')
650
+ await import('${W(e).href}')
651
651
  } catch (err) {
652
652
  console.warn(' Warning: ' + err.message)
653
653
  console.warn(' Container may be partially initialized.\\n')
@@ -676,46 +676,46 @@ server.on('exit', () => {
676
676
  console.log('\\n Goodbye!\\n')
677
677
  process.exit(0)
678
678
  })
679
- `}function Jr(e,t){for(let n of jn(e)){let e=N(n,t);if(L(e))return e}return null}function Yr(e,t){let n=RegExp(`^\\s*${y(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]!==`
679
+ `}function qr(e,t){for(let n of kn(e)){let e=F(n,t);if(z(e))return e}return null}function Jr(e,t){let n=RegExp(`^\\s*${ye(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]!==`
680
680
  `;)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]===`
681
- `);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t}else i=s+1}return{content:a,changed:r}}function Xr(e,t){let n=ie(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=Yr(a,t).content,a=a.replace(RegExp(`\\s*,?\\s*${y(t)}Module\\b(?:\\s*\\(\\s*\\))?\\s*,?`,`g`),e=>{let t=e.trimStart().startsWith(`,`),n=e.trimEnd().endsWith(`,`);return t&&n?`,`:``}),a=a.replace(/,(\s*])/,`$1`),e.slice(0,r)+a+e.slice(i)}async function Zr(e){let{name:n,modulesDir:r,force:i}=e,a=e.pluralize===!0,o=C(n),s=S(n),c=a?me(o):o;c!==o&&!await _(N(r,c))&&await _(N(r,o))&&(c=o);let l=N(r,c);if(!await _(l)){console.log(`\n Module not found: ${l}\n`);return}if(!i&&!await h({message:v.red(`Delete module '${c}' at ${l}? This cannot be undone.`),initialValue:!1})){console.log(`
681
+ `);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t}else i=s+1}return{content:a,changed:r}}function Yr(e,t){let n=Oe(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=Jr(a,t).content,a=a.replace(RegExp(`\\s*,?\\s*${ye(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 Xr(e){let{name:t,modulesDir:n,force:r}=e,i=e.pluralize===!0,a=De(t),o=Ce(t),s=i?Re(a):a;s!==a&&!await ue(F(n,s))&&await ue(F(n,a))&&(s=a);let c=F(n,s);if(!await ue(c)){console.log(`\n Module not found: ${c}\n`);return}if(!r&&!await ce({message:D.red(`Delete module '${s}' at ${c}? This cannot be undone.`),initialValue:!1})){console.log(`
682
682
  Cancelled.
683
- `);return}await kt(l,{recursive:!0,force:!0}),console.log(` Deleted: ${l}`);let u=N(r,`index.ts`);if(await _(u)){let e=await V(u,`utf-8`),n=e,r=RegExp(`^import\\s*\\{\\s*${y(s)}Module\\s*\\}\\s*from\\s*['"][^'"]*${y(c)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(r,``),e=Xr(e,s),e=e.replace(/\n{3,}/g,`
683
+ `);return}await Dt(c,{recursive:!0,force:!0}),console.log(` Deleted: ${c}`);let l=F(n,`index.ts`);if(await ue(l)){let e=await U(l,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${ye(o)}Module\\s*\\}\\s*from\\s*['"][^'"]*${ye(s)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=Yr(e,o),e=e.replace(/\n{3,}/g,`
684
684
 
685
- `),e!==n&&(await t(u,e),console.log(` Unregistered: ${s}Module from ${u}`))}console.log(`\n Module '${c}' removed.\n`)}function Qr(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 E(process.cwd()),r=w(n),i=t.modulesDir??r.dir??`src/modules`,a=T(t.pluralize,r);for(let n of e)await Zr({name:n,modulesDir:F(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 ei(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function ti(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=O(process.cwd()),n=await E(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-BAlAQlkw.mjs`),{builtinCliPlugins:t}=await import(`./builtins-Cb02IU36.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(`
685
+ `),e!==t&&(await x(l,e),console.log(` Unregistered: ${o}Module from ${l}`))}console.log(`\n Module '${s}' removed.\n`)}function Zr(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 A(process.cwd()),r=O(n),i=t.modulesDir??r.dir??`src/modules`,a=k(t.pluralize,r);for(let n of e)await Xr({name:n,modulesDir:L(i),force:t.force,pluralize:a})})}function Qr(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 $r(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function ei(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=j(process.cwd()),n=await A(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-DxBBBZKs.mjs`),{builtinCliPlugins:t}=await import(`./builtins-DaPdtAiN.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(`
686
686
  Registered typegen plugins:
687
687
  `);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(`
688
688
  Disable one in kick.config.ts:
689
689
  `),console.log(` typegen: { disable: ['`+(r.typegens[0]?.id??`kick/x`)+`'] }
690
- `);return}let r=$r(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=ei(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 pt(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 ht(a);let r=await kn({cwd:t,config:n??null,silent:e.silent,check:e.check});if(e.check&&r.some(e=>e.status===`written`)&&process.exit(1),!e.check){let i=F(t,e.out??n?.typegen?.outDir??`.kickjs/types`);await ct(i,r,e.silent??!1)}}}catch(e){e instanceof mt?console.error(`
690
+ `);return}let r=Qr(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=$r(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 ut(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 ft(a);let r=await Dn({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=L(t,e.out??n?.typegen?.outDir??`.kickjs/types`);await at(i,r,e.silent??!1)}}}catch(e){e instanceof dt?console.error(`
691
691
  `+e.message+`
692
- `):e instanceof be?console.error(`
692
+ `):e instanceof We?console.error(`
693
693
  `+e.message+`
694
- `):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}const ni=/* @__PURE__ */ new Set([`Service`,`Injectable`,`Component`,`Repository`]);function ri(e,t){return typeof t==`number`?e.slice(0,t).split(`
695
- `).length:1}function ii(e){let t=Qe(e);if(t===`singleton`||t===`transient`||t===`request`)return t;if($e(e)&&e.type===`MemberExpression`&&A(e.object)===`Scope`){let t=A(e.property);if(t===`SINGLETON`)return`singleton`;if(t===`TRANSIENT`)return`transient`;if(t===`REQUEST`)return`request`}return`unknown`}function ai(e){let t=A(e);if(t)return{key:`id:${t}`,label:t};let n=Qe(e);return n===null?null:{key:`lit:${n}`,label:`'${n}'`}}function oi(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=_t(e).map(et).find(e=>e?.name===`Inject`),a=null;if(i)a=ai(i.call.arguments?.[0]);else{let e=n?.typeAnnotation?.typeAnnotation??null;e?.type===`TSTypeReference`&&(a=ai(e.typeName))}a&&r.push({...a,line:ri(t,e.start)})}return r}function si(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=Lt(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`)&&$e(n.declaration)?n.declaration:n;if(e.type===`ClassDeclaration`&&a(A(e.id),t),e.type===`VariableDeclaration`)for(let n of e.declarations??[])a(A(n.id),t)}vt(e,e=>{if(e.type===`ClassDeclaration`){let a=A(e.id);if(!a)return;for(let o of _t(e)){let s=et(o);if(s){if(s.name===`Controller`){i(`id:${a}`,`singleton`),r.push({name:a,kind:`controller`,file:t,params:oi(e,n)});return}if(ni.has(s.name)){let o=nt(yt(s.call),`scope`),c=o?ii(o):`singleton`;i(`id:${a}`,c),r.push({name:a,kind:`other`,file:t,params:oi(e,n)});return}}}return}if(e.type!==`CallExpression`)return;let a=e.callee;if(!$e(a)||a.type!==`MemberExpression`)return;let o=A(a.property);if(o!==`register`&&o!==`registerFactory`)return;let s=e.arguments??[];if(s.length<2)return;let c=ai(s[0]);c&&i(c.key,s.length>=3?ii(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 ci(e){let t=[];if(!L(e))return t;let n=z(e,{withFileTypes:!0});for(let r of n){let n=N(e,r.name);if(r.isDirectory()){if([`node_modules`,`dist`,`.kickjs`,`.git`].includes(r.name))continue;t.push(...ci(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function li(e){try{return R(e,`utf-8`)}catch{return``}}const ui=/* @__PURE__ */ new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function di(e,t){let n=li(N(e,`.env`));if(n){let e=n.match(/^JWT_SECRET\s*=\s*['"]?([^'"\n]*)['"]?/m);if(e){let t=e[1].trim();if(ui.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 fi(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 pi(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 mi(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function hi(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 gi(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 _i(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 vi(e){let t=ci(N(e,`src`)).map(e=>li(e)),n=[],r=di(e,t);r&&n.push(r);let i=fi(t);i&&n.push(i);let a=pi(t);a&&n.push(a);let o=mi();o&&n.push(o);let s=hi(t);return s&&n.push(s),n.push(gi(t)),n.push(_i(t)),n}function yi(e){let t=si(ci(N(e,`src`)).filter(e=>!/\.(test|spec)\.tsx?$/.test(e)).map(t=>({path:P(e,t).split(`\\`).join(`/`),source:li(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 bi(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(`
694
+ `):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}const ti=/* @__PURE__ */ new Set([`Service`,`Injectable`,`Component`,`Repository`]);function ni(e,t){return typeof t==`number`?e.slice(0,t).split(`
695
+ `).length:1}function ri(e){let t=Ye(e);if(t===`singleton`||t===`transient`||t===`request`)return t;if(Xe(e)&&e.type===`MemberExpression`&&M(e.object)===`Scope`){let t=M(e.property);if(t===`SINGLETON`)return`singleton`;if(t===`TRANSIENT`)return`transient`;if(t===`REQUEST`)return`request`}return`unknown`}function ii(e){let t=M(e);if(t)return{key:`id:${t}`,label:t};let n=Ye(e);return n===null?null:{key:`lit:${n}`,label:`'${n}'`}}function ai(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=mt(e).map(Ze).find(e=>e?.name===`Inject`),a=null;if(i)a=ii(i.call.arguments?.[0]);else{let e=n?.typeAnnotation?.typeAnnotation??null;e?.type===`TSTypeReference`&&(a=ii(e.typeName))}a&&r.push({...a,line:ni(t,e.start)})}return r}function oi(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=Ft(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`)&&Xe(n.declaration)?n.declaration:n;if(e.type===`ClassDeclaration`&&a(M(e.id),t),e.type===`VariableDeclaration`)for(let n of e.declarations??[])a(M(n.id),t)}ht(e,e=>{if(e.type===`ClassDeclaration`){let a=M(e.id);if(!a)return;for(let o of mt(e)){let s=Ze(o);if(s){if(s.name===`Controller`){i(`id:${a}`,`singleton`),r.push({name:a,kind:`controller`,file:t,params:ai(e,n)});return}if(ti.has(s.name)){let o=$e(gt(s.call),`scope`),c=o?ri(o):`singleton`;i(`id:${a}`,c),r.push({name:a,kind:`other`,file:t,params:ai(e,n)});return}}}return}if(e.type!==`CallExpression`)return;let a=e.callee;if(!Xe(a)||a.type!==`MemberExpression`)return;let o=M(a.property);if(o!==`register`&&o!==`registerFactory`)return;let s=e.arguments??[];if(s.length<2)return;let c=ii(s[0]);c&&i(c.key,s.length>=3?ri(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 si(e){let t=[];if(!z(e))return t;let n=V(e,{withFileTypes:!0});for(let r of n){let n=F(e,r.name);if(r.isDirectory()){if([`node_modules`,`dist`,`.kickjs`,`.git`].includes(r.name))continue;t.push(...si(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function ci(e){try{return B(e,`utf-8`)}catch{return``}}const li=/* @__PURE__ */ new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function ui(e,t){let n=ci(F(e,`.env`));if(n){let e=n.match(/^JWT_SECRET\s*=\s*['"]?([^'"\n]*)['"]?/m);if(e){let t=e[1].trim();if(li.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 di(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 fi(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 pi(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function mi(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 hi(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 gi(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 _i(e){let t=si(F(e,`src`)).map(e=>ci(e)),n=[],r=ui(e,t);r&&n.push(r);let i=di(t);i&&n.push(i);let a=fi(t);a&&n.push(a);let o=pi();o&&n.push(o);let s=mi(t);return s&&n.push(s),n.push(hi(t)),n.push(gi(t)),n}function vi(e){let t=oi(si(F(e,`src`)).filter(e=>!/\.(test|spec)\.tsx?$/.test(e)).map(t=>({path:I(e,t).split(`\\`).join(`/`),source:ci(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 yi(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(`
696
696
  Usage: kick check [--deploy] [--di]
697
697
 
698
698
  Available checks:
699
699
  --deploy Audit for production readiness (security, config, best practices)
700
700
  --di Find REQUEST-scoped dependencies injected into singleton constructors
701
- `);return}let t=process.cwd();o(e.deploy?`KickJS Deploy Check`:`KickJS DI Check`);let n=c();n.start(`Scanning project...`);let r=[...e.deploy?vi(t):[],...e.di?yi(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)s.message(`${a(e.severity)} ${e.message}`);let l=r.filter(e=>e.severity===`CRITICAL`).length,u=r.filter(e=>e.severity===`WARNING`).length,f=r.filter(e=>e.severity===`INFO`).length,p=u===1?`warning`:`warnings`,m=[l>0?v.red(`${l} critical`):`${l} critical`,u>0?v.yellow(`${u} ${p}`):`${u} ${p}`,`${f} info`].join(`, `);l>0?(d(v.red(`${m} — fix critical issues before deploying`)),process.exit(1)):d(v.green(`${m} — looking good!`))})}const xi=Symbol.for(`kickjs.handler.entryCapture`),Si=Symbol.for(`kickjs.config.describe`);function Ci(e){return Array.isArray(e)?e.join(`,`):typeof e==`object`&&e||typeof e==`string`&&/[\r\n]/.test(e)?JSON.stringify(e):String(e)}const wi=e=>e.split(/\r?\n/).map(e=>`# ${e}`);function Ti(e,t=!1){let n=[];for(let r of e){let e=[r.description,r.list?`comma-separated list`:void 0,t&&r.required?`required when used`:void 0].filter(Boolean);e.length>0&&n.push(...wi(e.join(` — `))),r.required&&!t?n.push(`${r.name}=`):n.push(`# ${r.name}=${r.default===void 0?``:Ci(r.default)}`)}return n}function Ei(e){let t=[`# Generated by \`kick env example\` from the env schema and the declared settings
701
+ `);return}let t=process.cwd();re(e.deploy?`KickJS Deploy Check`:`KickJS DI Check`);let n=ie();n.start(`Scanning project...`);let r=[...e.deploy?_i(t):[],...e.di?vi(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)C.message(`${ne(e.severity)} ${e.message}`);let a=r.filter(e=>e.severity===`CRITICAL`).length,o=r.filter(e=>e.severity===`WARNING`).length,s=r.filter(e=>e.severity===`INFO`).length,c=o===1?`warning`:`warnings`,l=[a>0?D.red(`${a} critical`):`${a} critical`,o>0?D.yellow(`${o} ${c}`):`${o} ${c}`,`${s} info`].join(`, `);a>0?(E(D.red(`${l} — fix critical issues before deploying`)),process.exit(1)):E(D.green(`${l} — looking good!`))})}const bi=Symbol.for(`kickjs.handler.entryCapture`),xi=Symbol.for(`kickjs.config.describe`);function Si(e){return Array.isArray(e)?e.join(`,`):typeof e==`object`&&e||typeof e==`string`&&/[\r\n]/.test(e)?JSON.stringify(e):String(e)}const Ci=e=>e.split(/\r?\n/).map(e=>`# ${e}`);function wi(e,t=!1){let n=[];for(let r of e){let e=[r.description,r.list?`comma-separated list`:void 0,t&&r.required?`required when used`:void 0].filter(Boolean);e.length>0&&n.push(...Ci(e.join(` — `))),r.required&&!t?n.push(`${r.name}=`):n.push(`# ${r.name}=${r.default===void 0?``:Si(r.default)}`)}return n}function Ti(e){let t=[`# Generated by \`kick env example\` from the env schema and the declared settings
702
702
  # sections. Re-run it after changing them; \`kick env example --check\` fails when stale.
703
703
  #
704
704
  # Uncommented variables are required. Commented ones are optional; the value shown
705
- # 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 ──`,...Ti(e.env)].join(`
706
- `));for(let n of e.sections)t.push([`# ── ${n.prefix} settings (${n.optional?`optional, `:``}declared by ${n.declaredBy}) ──`,...n.description?wi(n.description):[],...Ti(n.vars,n.optional)].join(`
705
+ # 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 ──`,...wi(e.env)].join(`
706
+ `));for(let n of e.sections)t.push([`# ── ${n.prefix} settings (${n.optional?`optional, `:``}declared by ${n.declaredBy}) ──`,...n.description?Ci(n.description):[],...wi(n.vars,n.optional)].join(`
707
707
  `));return`${t.join(`
708
708
 
709
- `)}\n`}async function Di(e,t){let n=F(e,t);if(!L(n))throw Error(`${t} not found`);let r=F(e,`vite.config.ts`);if(!L(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(F(e,`package.json`)),{createServer:o}=await import(H(a.resolve(`vite`)).href),s=globalThis,c;s[xi]=e=>{c??=e},s[Si]=!0,s[le]=`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[xi],delete s[Si],delete s[le],await l.close()}if(!c)throw Error(`${t} finished loading without calling bootstrap()`);return c.describeConfig()}function Oi(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=F(t,e.out),r;try{r=Ei(await Di(t,e.entry))}catch(e){console.error(`\n kick env example: ${e.message}\n`),process.exit(1)}e.check?((L(n)?R(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.`)):(B(n,r),console.log(` Wrote ${e.out}`))})}function ki(e){return e.optsWithGlobals().dryRun??!1}function Ai(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.
709
+ `)}\n`}async function Ei(e,t){let n=L(e,t);if(!z(n))throw Error(`${t} not found`);let r=L(e,`vite.config.ts`);if(!z(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(L(e,`package.json`)),{createServer:o}=await import(W(a.resolve(`vite`)).href),s=globalThis,c;s[bi]=e=>{c??=e},s[xi]=!0,s[Ne]=`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[bi],delete s[xi],delete s[Ne],await l.close()}if(!c)throw Error(`${t} finished loading without calling bootstrap()`);return c.describeConfig()}function Di(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=L(t,e.out),r;try{r=Ti(await Ei(t,e.entry))}catch(e){console.error(`\n kick env example: ${e.message}\n`),process.exit(1)}e.check?((z(n)?B(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.`)):(H(n,r),console.log(` Wrote ${e.out}`))})}function Oi(e){return e.optsWithGlobals().dryRun??!1}function ki(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.
710
710
  Direction defaults to \`modules.style\` from kick.config (or "define").
711
711
  --target define|class Override the migration direction.
712
712
  --apply Apply the changes (default: dry-run preview).
713
- --experimental Acknowledge that AST migration is experimental.`).option(`--modules-dir <dir>`,`Modules directory (default: src/modules from kick.config)`).option(`--apply`,`Apply the migration to disk (default: dry-run)`).option(`--experimental`,`Acknowledge that this command is experimental`).option(`--target <style>`,`Migration direction — 'define' or 'class'`).option(`--no-backup`,`Skip the .kickjs/codemod-backups/ snapshot (default: backup on)`).action(async(e,t)=>{let r=ki(t)||!e.apply;n(r),e.experimental||(console.error(`
714
- `+v.red(`Error:`)+` kick codemod modules is experimental — pass --experimental to acknowledge.
713
+ --experimental Acknowledge that AST migration is experimental.`).option(`--modules-dir <dir>`,`Modules directory (default: src/modules from kick.config)`).option(`--apply`,`Apply the migration to disk (default: dry-run)`).option(`--experimental`,`Acknowledge that this command is experimental`).option(`--target <style>`,`Migration direction — 'define' or 'class'`).option(`--no-backup`,`Skip the .kickjs/codemod-backups/ snapshot (default: backup on)`).action(async(e,t)=>{let n=Oi(t)||!e.apply;S(n),e.experimental||(console.error(`
714
+ `+D.red(`Error:`)+` kick codemod modules is experimental — pass --experimental to acknowledge.
715
715
  The regex-based rewrite handles the shapes our templates produce.
716
716
  Hand-rolled modules with non-standard structures may be skipped.
717
717
  Always commit before running with --apply.
718
- `),process.exit(1));let i=await E(process.cwd()),a=w(i),o=F(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 ${v.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let c=v.dim(`→ ${s}`),l=r?v.dim(`(dry-run)`):v.bold(`(applying)`);console.log(`\n ${v.bold(`kick codemod modules`)} ${c} ${l}`),console.log(` modulesDir: ${v.dim(o)}\n`);let u=e.backup!==!1&&!r,d=await an(o,{dryRun:r,target:s,backup:u});if(d.backupDir){let e=d.backupDir;console.log(` ${v.green(`✓`)} backup: ${v.dim(e)}\n ${v.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else!r&&e.backup===!1&&console.log(` ${v.dim(`(--no-backup — skipping snapshot)`)}\n`);let f=0,p=0;for(let e of d.files)if(e.status===`migrated`)f++,console.log(` ${v.green(`✓`)} ${e.path}`);else{p++;let t=v.dim(`(${e.reason??`skipped`})`);console.log(` ${v.dim(`-`)} ${e.path} ${t}`)}if(console.log(),d.indexStatus===`migrated`)console.log(` ${v.green(`✓`)} ${d.indexPath}`);else if(d.indexStatus===`skipped`){let e=v.dim(`(${d.indexReason??`skipped`})`);console.log(` ${v.dim(`-`)} ${d.indexPath} ${e}`)}else console.log(` ${v.dim(`-`)} ${d.indexPath} ${v.dim(`(not found)`)}`);let m=r?v.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n ${v.bold(String(f))} migrated, ${v.bold(String(p))} skipped${m}\n`)})}function ji(e){try{let t=JSON.parse(R(F(e,`package.json`),`utf-8`));return{...t.dependencies,...t.devDependencies}}catch{return{}}}function Mi(e,t=L,n=ji(e)){if(n[`@forinda/kickjs-inertia`])return{staticDir:`dist/client`,siteRoot:`.`,apiPath:``,include:[`dist/client/.vite/manifest.json`,`dist/ssr`]};let r=M(e);return(t(F(r,`pnpm-workspace.yaml`))||t(F(r,`package.json`)))&&t(F(r,`web`,`package.json`))?{staticDir:`../web/dist`,siteRoot:`..`,apiPath:`/api`}:n[`@forinda/kickjs-view`]?{staticDir:`dist/public`,siteRoot:`.`,apiPath:``}:{siteRoot:`.`,apiPath:``}}function Ni(e,t,n,r){let i=Mi(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 Pi(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'
718
+ `),process.exit(1));let r=await A(process.cwd()),i=O(r),a=L(e.modulesDir??i.dir??`src/modules`),o;e.target===`define`||e.target===`class`?o=e.target:e.target===void 0?o=i.style??`define`:(console.error(`\n ${D.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let s=D.dim(`→ ${o}`),c=n?D.dim(`(dry-run)`):D.bold(`(applying)`);console.log(`\n ${D.bold(`kick codemod modules`)} ${s} ${c}`),console.log(` modulesDir: ${D.dim(a)}\n`);let l=e.backup!==!1&&!n,u=await nn(a,{dryRun:n,target:o,backup:l});if(u.backupDir){let e=u.backupDir;console.log(` ${D.green(`✓`)} backup: ${D.dim(e)}\n ${D.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else!n&&e.backup===!1&&console.log(` ${D.dim(`(--no-backup — skipping snapshot)`)}\n`);let d=0,f=0;for(let e of u.files)if(e.status===`migrated`)d++,console.log(` ${D.green(`✓`)} ${e.path}`);else{f++;let t=D.dim(`(${e.reason??`skipped`})`);console.log(` ${D.dim(`-`)} ${e.path} ${t}`)}if(console.log(),u.indexStatus===`migrated`)console.log(` ${D.green(`✓`)} ${u.indexPath}`);else if(u.indexStatus===`skipped`){let e=D.dim(`(${u.indexReason??`skipped`})`);console.log(` ${D.dim(`-`)} ${u.indexPath} ${e}`)}else console.log(` ${D.dim(`-`)} ${u.indexPath} ${D.dim(`(not found)`)}`);let p=n?D.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n ${D.bold(String(d))} migrated, ${D.bold(String(f))} skipped${p}\n`)})}function Ai(e){try{let t=JSON.parse(B(L(e,`package.json`),`utf-8`));return{...t.dependencies,...t.devDependencies}}catch{return{}}}function ji(e,t=z,n=Ai(e)){if(n[`@forinda/kickjs-inertia`])return{staticDir:`dist/client`,siteRoot:`.`,apiPath:``,include:[`dist/client/.vite/manifest.json`,`dist/ssr`]};let r=P(e);return(t(L(r,`pnpm-workspace.yaml`))||t(L(r,`package.json`)))&&t(L(r,`web`,`package.json`))?{staticDir:`../web/dist`,siteRoot:`..`,apiPath:`/api`}:n[`@forinda/kickjs-view`]?{staticDir:`dist/public`,siteRoot:`.`,apiPath:``}:{siteRoot:`.`,apiPath:``}}function Mi(e,t,n,r){let i=ji(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 Ni(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'
719
719
  import { handler } from '${e}'
720
720
 
721
721
  // Where the app's build files were packaged; the platform starts this
@@ -729,7 +729,7 @@ export const config = {
729
729
  ${r.join(`
730
730
  `)}
731
731
  }
732
- `}function Fi(){return`import { fileURLToPath } from 'node:url'
732
+ `}function Pi(){return`import { fileURLToPath } from 'node:url'
733
733
  import { handler } from './server.mjs'
734
734
 
735
735
  // The app's build files are copied into this function at their project
@@ -739,11 +739,11 @@ process.env.KICK_APP_ROOT ??= fileURLToPath(new URL('./', import.meta.url))
739
739
  const requestContext = () => globalThis[Symbol.for('@vercel/request-context')]?.get?.()
740
740
 
741
741
  export default (req, res) => handler.node(req, res, requestContext())
742
- `}function Ii(e){return/^\s*publish\s*=\s*["']([^"']+)["']/m.exec(e)?.[1]?.replace(/^\.\//,``).replace(/\/+$/,``)}function Li(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 Ri(e,t){let n;try{n=Lt(t,e).program}catch{return[]}let r=[],i=t=>e.slice(0,t).split(`
743
- `).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 zi(e){let t=F(e,`src`);return L(t)?z(t,{recursive:!0,encoding:`utf-8`}).filter(e=>/\.m?ts$/.test(e)&&!/\.(test|spec|d)\.m?ts$/.test(e)).flatMap(e=>{let n=R(F(t,e),`utf-8`);return n.includes(`@Cron`)?Ri(n,`src/${e}`):[]}):[]}function Bi(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 Vi(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(Bi(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 Hi(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 Ui(e,t){let{createRequire:n}=await import(`node:module`),r=n(F(e,`package.json`)),i;try{i=r.resolve(`${t}/package.json`)}catch{i=F(e,`node_modules`,t,`package.json`)}if(!L(i))throw Error(`${t} is not installed in this project. Run: ${u(e)} add -D vite unplugin-swc @forinda/kickjs-vite`);let a=Hi(JSON.parse(R(i,`utf-8`)));if(!a)throw Error(`${t} has no importable entry point`);return import(H(F(M(i),a)).href)}function Wi(e,t){if(!t.staticDir)return{clientFiles:`bundle`};let n=F(e,t.outDir);return{publicDir:P(n,F(e,t.staticDir)).split(I).join(`/`)}}function Gi(e,t){let n=t?.resolve?.alias,r=Array.isArray(n)?n:Object.entries(n??{}).map(([e,t])=>({find:e,replacement:t}));return{define:t?.define??{},resolve:{alias:[...r,{find:`@`,replacement:F(e,`src`)}]}}}async function Ki(e,t){return(await t({command:`build`,mode:`production`,isSsrBuild:!0},void 0,e))?.config}async function qi(e,t,n){let r=F(e,t.entry);if(!L(r))throw Error(`${t.entry} not found. The serverless entry exports \`handler = createHandler({ modules })\` — see the Serverless guide.`);let{build:i,loadConfigFromFile:a}=await Ui(e,`vite`),o=await Ki(e,(e,t,n)=>a(e,t,n,`silent`)),{default:s}=await Ui(e,`unplugin-swc`),{devtoolsFlagPlugin:c,devtoolsStripPlugin:l,kickViewsPlugin:u}=await Ui(e,`@forinda/kickjs-vite`),d=ji(e)[`@forinda/kickjs-view`]?[u(Wi(e,t))]:[];await i({configFile:!1,root:e,logLevel:`warn`,oxc:!1,plugins:[s.vite(),c(),l(),...d],...Gi(e,o),ssr:{noExternal:!0,target:`node`},build:{ssr:!0,target:`node20`,outDir:F(e,t.outDir),emptyOutDir:!0,minify:!1,rollupOptions:{input:r,external:(n,r)=>Yi(n,r?M(r):e)||t.external.includes(n)&&Yi(n,e),output:{format:`esm`,entryFileNames:`server.mjs`,codeSplitting:!1}}}}),d.length&&t.staticDir&&Ct(F(e,t.staticDir),{recursive:!0});let f=F(e,t.outDir,`server.mjs`);return n(`bundled ${P(process.cwd(),f)}`),f}function Ji(e){return/^((?:@[a-z0-9][\w.-]*\/)?[a-z0-9][\w.-]*)(?:\/|$)/i.exec(e)?.[1]}function Yi(e,t,n=L){let r=Ji(e);if(!r)return!1;for(let e=t;;e=M(e)){if(n(F(e,`node_modules`,r,`package.json`)))return!1;if(M(e)===e)return!0}}function Xi(e,t){let n=P(e,t).split(I)[0];return n!==void 0&&n.startsWith(`.`)}function Zi(e){return e.flatMap(e=>[`/${e} /404 404!`,`/${e}/* /404 404!`])}function Qi(e){try{return Tt(e)}catch{return}}function $i(e,t){let n=t.filter(t=>!L(F(e,t)));if(n.length>0)throw Error(`${n.join(`, `)} not found — the function reads ${n.length===1?`it`:`them`} at runtime. Run the full build first (\`${je(u(e),`build`)}\`), or fix \`deploy.include\`.`)}function ea(e,t){let n=t.projectRoot,r=()=>Ni(t.config?.deploy,n);e.command(`build:netlify`).description(`Bundle the serverless entry and write the Netlify function`).action(async()=>{let e=r();$i(n,e.include);let i=await qi(n,e,t.log),a=F(n,e.siteRoot),o=zi(n);o.length>0&&t.log(`warning: ${o.length} @Cron job(s) found — Netlify has no cron trigger for them, so they will not run. Use Netlify scheduled functions, or deploy to Vercel or Workers.`);let s=F(a,`.netlify/v1/functions`);Ct(s,{recursive:!0});let c=P(s,i).split(I).join(`/`),l=e=>e.split(I).join(`/`);B(F(s,`api.mjs`),Pi(c,e.apiPath,{projectDir:l(P(s,n)),preferStatic:e.apiPath===``&&!!e.staticDir,includedFiles:e.include.flatMap(e=>{let t=l(P(s,F(n,e)));return Qi(F(n,e))?.isDirectory()?[`${t}/**`]:[t]})})),t.log(`wrote ${P(process.cwd(),F(s,`api.mjs`))}`);let u=e.staticDir??e.publishDir;if(!e.staticDir)Ct(F(n,u),{recursive:!0}),t.log(`publish directory ready at ${P(process.cwd(),F(n,u))}`);else if(L(F(n,u))){let e=z(F(n,u)).filter(e=>e.startsWith(`.`));if(e.length>0){let t=F(n,u,`_redirects`),r=L(t)?R(t,`utf-8`):``,i=Zi(e).filter(e=>!r.includes(e));i.length>0&&B(t,`${r}${r&&!r.endsWith(`
742
+ `}function Fi(e){return/^\s*publish\s*=\s*["']([^"']+)["']/m.exec(e)?.[1]?.replace(/^\.\//,``).replace(/\/+$/,``)}function Ii(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 Li(e,t){let n;try{n=Ft(t,e).program}catch{return[]}let r=[],i=t=>e.slice(0,t).split(`
743
+ `).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=L(e,`src`);return z(t)?V(t,{recursive:!0,encoding:`utf-8`}).filter(e=>/\.m?ts$/.test(e)&&!/\.(test|spec|d)\.m?ts$/.test(e)).flatMap(e=>{let n=B(L(t,e),`utf-8`);return n.includes(`@Cron`)?Li(n,`src/${e}`):[]}):[]}function zi(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 Bi(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(zi(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 Vi(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 Hi(e,t){let{createRequire:n}=await import(`node:module`),r=n(L(e,`package.json`)),i;try{i=r.resolve(`${t}/package.json`)}catch{i=L(e,`node_modules`,t,`package.json`)}if(!z(i))throw Error(`${t} is not installed in this project. Run: ${T(e)} add -D vite unplugin-swc @forinda/kickjs-vite`);let a=Vi(JSON.parse(B(i,`utf-8`)));if(!a)throw Error(`${t} has no importable entry point`);return import(W(L(P(i),a)).href)}function Ui(e,t){if(!t.staticDir)return{clientFiles:`bundle`};let n=L(e,t.outDir);return{publicDir:I(n,L(e,t.staticDir)).split(R).join(`/`)}}function Wi(e,t){let n=t?.resolve?.alias,r=Array.isArray(n)?n:Object.entries(n??{}).map(([e,t])=>({find:e,replacement:t}));return{define:t?.define??{},resolve:{alias:[...r,{find:`@`,replacement:L(e,`src`)}]}}}async function Gi(e,t){return(await t({command:`build`,mode:`production`,isSsrBuild:!0},void 0,e))?.config}async function Ki(e,t,n){let r=L(e,t.entry);if(!z(r))throw Error(`${t.entry} not found. The serverless entry exports \`handler = createHandler({ modules })\` — see the Serverless guide.`);let{build:i,loadConfigFromFile:a}=await Hi(e,`vite`),o=await Gi(e,(e,t,n)=>a(e,t,n,`silent`)),{default:s}=await Hi(e,`unplugin-swc`),{devtoolsFlagPlugin:c,devtoolsStripPlugin:l,kickViewsPlugin:u}=await Hi(e,`@forinda/kickjs-vite`),d=Ai(e)[`@forinda/kickjs-view`]?[u(Ui(e,t))]:[];await i({configFile:!1,root:e,logLevel:`warn`,oxc:!1,plugins:[s.vite(),c(),l(),...d],...Wi(e,o),ssr:{noExternal:!0,target:`node`},build:{ssr:!0,target:`node20`,outDir:L(e,t.outDir),emptyOutDir:!0,minify:!1,rollupOptions:{input:r,external:(n,r)=>Ji(n,r?P(r):e)||t.external.includes(n)&&Ji(n,e),output:{format:`esm`,entryFileNames:`server.mjs`,codeSplitting:!1}}}}),d.length&&t.staticDir&&xt(L(e,t.staticDir),{recursive:!0});let f=L(e,t.outDir,`server.mjs`);return n(`bundled ${I(process.cwd(),f)}`),f}function qi(e){return/^((?:@[a-z0-9][\w.-]*\/)?[a-z0-9][\w.-]*)(?:\/|$)/i.exec(e)?.[1]}function Ji(e,t,n=z){let r=qi(e);if(!r)return!1;for(let e=t;;e=P(e)){if(n(L(e,`node_modules`,r,`package.json`)))return!1;if(P(e)===e)return!0}}function Yi(e,t){let n=I(e,t).split(R)[0];return n!==void 0&&n.startsWith(`.`)}function Xi(e){return e.flatMap(e=>[`/${e} /404 404!`,`/${e}/* /404 404!`])}function Zi(e){try{return Ct(e)}catch{return}}function Qi(e,t){let n=t.filter(t=>!z(L(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 (\`${_e(T(e),`build`)}\`), or fix \`deploy.include\`.`)}function $i(e,t){let n=t.projectRoot,r=()=>Mi(t.config?.deploy,n);e.command(`build:netlify`).description(`Bundle the serverless entry and write the Netlify function`).action(async()=>{let e=r();Qi(n,e.include);let i=await Ki(n,e,t.log),a=L(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=L(a,`.netlify/v1/functions`);xt(s,{recursive:!0});let c=I(s,i).split(R).join(`/`),l=e=>e.split(R).join(`/`);H(L(s,`api.mjs`),Ni(c,e.apiPath,{projectDir:l(I(s,n)),preferStatic:e.apiPath===``&&!!e.staticDir,includedFiles:e.include.flatMap(e=>{let t=l(I(s,L(n,e)));return Zi(L(n,e))?.isDirectory()?[`${t}/**`]:[t]})})),t.log(`wrote ${I(process.cwd(),L(s,`api.mjs`))}`);let u=e.staticDir??e.publishDir;if(!e.staticDir)xt(L(n,u),{recursive:!0}),t.log(`publish directory ready at ${I(process.cwd(),L(n,u))}`);else if(z(L(n,u))){let e=V(L(n,u)).filter(e=>e.startsWith(`.`));if(e.length>0){let t=L(n,u,`_redirects`),r=z(t)?B(t,`utf-8`):``,i=Xi(e).filter(e=>!r.includes(e));i.length>0&&H(t,`${r}${r&&!r.endsWith(`
744
744
  `)?`
745
745
  `:``}${i.join(`
746
- `)}\n`)}}let d=F(a,`netlify.toml`);if(L(d)){let e=Ii(R(d,`utf-8`)),r=P(a,F(n,u)).split(I).join(`/`);e!==void 0&&e!==r&&t.log(`warning: netlify.toml publishes "${e}", but this build fills "${r}". Update netlify.toml, or set \`deploy.publishDir\` / \`deploy.staticDir\` to match.`)}}),e.command(`build:vercel`).description(`Bundle the serverless entry and write .vercel/output (Build Output API v3)`).action(async()=>{let e=r();$i(n,e.include);let i=await qi(n,e,t.log),a=F(n,e.siteRoot),o=e.staticDir?F(n,e.staticDir):void 0,s=F(a,`.vercel/output`),c=F(s,`functions/api.func`);wt(s,{recursive:!0,force:!0}),Ct(c,{recursive:!0}),St(i,F(c,`server.mjs`)),B(F(c,`index.mjs`),Fi());for(let t of e.include)St(F(n,t),F(c,t),{recursive:!0});if(B(F(c,`.vc-config.json`),`${JSON.stringify({runtime:e.vercelRuntime,handler:`index.mjs`,launcherType:`Nodejs`,supportsResponseStreaming:!0},null,2)}\n`),o){if(!L(o))throw Error(`build:vercel: ${e.staticDir} does not exist — build the frontend first`);St(o,F(s,`static`),{recursive:!0,filter:e=>!Xi(o,e)})}let{crons:l,warnings:u}=Vi(zi(n));for(let e of u)t.log(`warning: ${e}`);let d={version:3,routes:Li(e.apiPath,!!o,l.length>0),...l.length>0?{crons:l}:{}};B(F(s,`config.json`),`${JSON.stringify(d,null,2)}\n`),t.log(`wrote ${P(process.cwd(),s)}`),l.length>0&&t.log(`${l.length} cron schedule(s) written. Set CRON_SECRET in the Vercel project — the trigger is not mounted without it.`)})}const ta=()=>({id:`kick/assets`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`],async generate(e){let t=j.resolve(e.cwd,`kick.config.ts`);if(!L(t))return null;let n=await E(e.cwd);if(!n?.assetMap)return null;let r=tt(n.assetMap,e.cwd);return r.count===0?null:dt(r)}}),na="/* 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 ra(e,t,n,r={}){if(e.length===0)return`${na}
746
+ `)}\n`)}}let d=L(a,`netlify.toml`);if(z(d)){let e=Fi(B(d,`utf-8`)),r=I(a,L(n,u)).split(R).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();Qi(n,e.include);let i=await Ki(n,e,t.log),a=L(n,e.siteRoot),o=e.staticDir?L(n,e.staticDir):void 0,s=L(a,`.vercel/output`),c=L(s,`functions/api.func`);St(s,{recursive:!0,force:!0}),xt(c,{recursive:!0}),bt(i,L(c,`server.mjs`)),H(L(c,`index.mjs`),Pi());for(let t of e.include)bt(L(n,t),L(c,t),{recursive:!0});if(H(L(c,`.vc-config.json`),`${JSON.stringify({runtime:e.vercelRuntime,handler:`index.mjs`,launcherType:`Nodejs`,supportsResponseStreaming:!0},null,2)}\n`),o){if(!z(o))throw Error(`build:vercel: ${e.staticDir} does not exist — build the frontend first`);bt(o,L(s,`static`),{recursive:!0,filter:e=>!Yi(o,e)})}let{crons:l,warnings:u}=Bi(Ri(n));for(let e of u)t.log(`warning: ${e}`);let d={version:3,routes:Ii(e.apiPath,!!o,l.length>0),...l.length>0?{crons:l}:{}};H(L(s,`config.json`),`${JSON.stringify(d,null,2)}\n`),t.log(`wrote ${I(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 ea=()=>({id:`kick/assets`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`],async generate(e){let t=N.resolve(e.cwd,`kick.config.ts`);if(!z(t))return null;let n=await A(e.cwd);if(!n?.assetMap)return null;let r=Qe(n.assetMap,e.cwd);return r.count===0?null:ct(r)}}),ta="/* 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 na(e,t,n,r={}){if(e.length===0)return`${ta}
747
747
  // (no routes discovered yet — annotate a controller method with
748
748
  // @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
749
749
  declare global {
@@ -760,19 +760,19 @@ declare global {
760
760
 
761
761
  /** Empty until the first route exists — see kick typegen. */
762
762
  export const kickRpc = {} as const
763
- `;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=sa(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 ${P(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??aa(e),u=c(e.responseSchema??null,e,`response`),d=s(e),f=u??`import('@forinda/kickjs').InferHandlerResponse<${d}['${e.method}']>`,p=oa(e);n.push(` /**`,` * ${e.httpMethod} ${e.path}`,...p.map(e=>` * ${e}`),` */`,` ${e.method}: {`,` params: ${a}`,` body: ${o}`,` query: ${l}`,` response: ${f}`,` contextKeys: ${ia(e)}`,` }`)}n.push(` }`),l.push(n.join(`
763
+ `;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=oa(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 ${I(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??ia(e),u=c(e.responseSchema??null,e,`response`),d=s(e),f=u??`import('@forinda/kickjs').InferHandlerResponse<${d}['${e.method}']>`,p=aa(e);n.push(` /**`,` * ${e.httpMethod} ${e.path}`,...p.map(e=>` * ${e}`),` */`,` ${e.method}: {`,` params: ${a}`,` body: ${o}`,` query: ${l}`,` response: ${f}`,` contextKeys: ${ra(e)}`,` }`)}n.push(` }`),l.push(n.join(`
764
764
  `))}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(`
765
765
  `);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(`
766
- `));let h=[],g=/* @__PURE__ */ new Set;for(let[e,t]of i){let n=ua(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(`
766
+ `));let h=[],g=/* @__PURE__ */ new Set;for(let[e,t]of i){let n=la(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(`
767
767
  `)}\n },`)}let _=[`/**`,` * Runtime route manifest for the tRPC-style sugar:`," * `createRpc(api, kickRpc)` from @forinda/kickjs-client.",` */`,`export const kickRpc = {`,...h,`} as const`].join(`
768
- `),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=la(``,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(`
768
+ `),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=ca(``,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(`
769
769
  `)+`
770
- `:``,x=ca(a)+b,ee=l.join(`
771
- `);return`${na}${x}
770
+ `:``,x=sa(a)+b,S=l.join(`
771
+ `);return`${ta}${x}
772
772
  declare global {
773
773
  // eslint-disable-next-line @typescript-eslint/no-namespace
774
774
  namespace KickRoutes {
775
- ${ee}
775
+ ${S}
776
776
  }
777
777
 
778
778
  /** Short alias for \`KickRoutes.Api\` — \`createClient<KickApi>(...)\`. */
@@ -780,18 +780,18 @@ ${ee}
780
780
  }
781
781
 
782
782
  ${_}
783
- `}function ia(e){let t=e.contextKeys;return t==null?`string`:t.length===0?`never`:t.map(e=>JSON.stringify(e)).join(` | `)}function aa(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 oa(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 sa(e,t,n,r,i){if(!e||r===!1||e.source===null)return null;let a=la(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 ca(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(`
783
+ `}function ra(e){let t=e.contextKeys;return t==null?`string`:t.length===0?`never`:t.map(e=>JSON.stringify(e)).join(` | `)}function ia(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 aa(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 oa(e,t,n,r,i){if(!e||r===!1||e.source===null)return null;let a=ca(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 sa(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(`
784
784
  `)+`
785
- `}function la(e,t,n){if(e===null)return`unknown`;let r=M(n);if(e===``){let e=P(r,t).split(I).join(`/`);return e=e.replace(/\.(ts|tsx|mts|cts)$/i,``),e.startsWith(`.`)||(e=`./`+e),e}if(!e.startsWith(`.`)&&!e.startsWith(`/`))return e;let i=M(t),a=F(i,e),o=P(r,a).split(I).join(`/`);return o=o.replace(/\.(ts|tsx|mts|cts)$/i,``),o.startsWith(`.`)||(o=`./`+o),o}function ua(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 da=()=>({id:`kick/routes`,outExtension:`.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){let t=await e.getScanResult({root:fa(e),cwd:e.cwd,envFile:pa(e)}),n=e.config?.typegen?.schemaValidator??`zod`,r=j.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return ra(t.routes,r,n,{onWarn:t=>e.log.warn(t)})}});function fa(e){return j.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function pa(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}const ma=`@typescript/typescript6`;function ha(e){return typeof e?.createProgram==`function`}function ga(e){if(ha(e.typescript))return{api:e.typescript,source:`typescript`};if(ha(e.ts6))return{api:e.ts6,source:ma};let t=`Install it in the project:\n ${u()} add -D ${ma}`;throw e.typescript?Error(`kick typegen: the client route map needs a TypeScript compiler API.
786
- 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 '${ma}' resolved from this project.\n ${t}`)}async function _a(e){let t=bt(N(e,`package.json`)),n=async e=>{try{return await import(H(t.resolve(e)).href)}catch{return null}},[r,i]=await Promise.all([n(`typescript`),n(ma)]);return ga({typescript:va(r),ts6:va(i)}).api}function va(e){let t=e;return t?.default&&typeof t.default==`object`?t.default:e}const ya=Symbol(`kick/client: expansion budget exhausted`);var ba=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!==ya)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 ya;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=`
785
+ `}function ca(e,t,n){if(e===null)return`unknown`;let r=P(n);if(e===``){let e=I(r,t).split(R).join(`/`);return e=e.replace(/\.(ts|tsx|mts|cts)$/i,``),e.startsWith(`.`)||(e=`./`+e),e}if(!e.startsWith(`.`)&&!e.startsWith(`/`))return e;let i=P(t),a=L(i,e),o=I(r,a).split(R).join(`/`);return o=o.replace(/\.(ts|tsx|mts|cts)$/i,``),o.startsWith(`.`)||(o=`./`+o),o}function la(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 ua=()=>({id:`kick/routes`,outExtension:`.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){let t=await e.getScanResult({root:da(e),cwd:e.cwd,envFile:fa(e)}),n=e.config?.typegen?.schemaValidator??`zod`,r=N.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return na(t.routes,r,n,{onWarn:t=>e.log.warn(t)})}});function da(e){return N.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function fa(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}const pa=`@typescript/typescript6`;function ma(e){return typeof e?.createProgram==`function`}function ha(e){if(ma(e.typescript))return{api:e.typescript,source:`typescript`};if(ma(e.ts6))return{api:e.ts6,source:pa};let t=`Install it in the project:\n ${T()} add -D ${pa}`;throw e.typescript?Error(`kick typegen: the client route map needs a TypeScript compiler API.
786
+ 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 '${pa}' resolved from this project.\n ${t}`)}async function ga(e){let t=vt(F(e,`package.json`)),n=async e=>{try{return await import(W(t.resolve(e)).href)}catch{return null}},[r,i]=await Promise.all([n(`typescript`),n(pa)]);return ha({typescript:_a(r),ts6:_a(i)}).api}function _a(e){let t=e;return t?.default&&typeof t.default==`object`?t.default:e}const va=Symbol(`kick/client: expansion budget exhausted`);var ya=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!==va)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 va;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=`
787
787
  `){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===`
788
788
  `?`
789
- `: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 xa=[`pnpm-lock.yaml`,`package-lock.json`,`yarn.lock`,`bun.lock`,`bun.lockb`],Sa=/(?:^|[\\/])(?:node_modules|\.kickjs)(?:[\\/]|$)/;function Ca(e){return Ft(`sha1`).update(e).digest(`hex`)}function wa(e){let t=Ft(`sha1`);t.update(e.cliVersion),t.update(JSON.stringify(e.options??{})),t.update(e.keys.join(`
790
- `));for(let n of xa){let r=N(e.projectDir,n);if(L(r))try{t.update(R(r))}catch(e){throw Error(`kick/client: cannot read lockfile ${r}`,{cause:e})}}for(let n of e.fileNames.toSorted())if(!Sa.test(n)){t.update(n);try{t.update(R(n))}catch(e){throw Error(`kick/client: cannot read project file ${n}`,{cause:e})}}return t.digest(`hex`)}async function Ta(e){try{let t=await _a(e.compilerFrom??e.projectDir),n={...t.sys,onUnRecoverableConfigFileDiagnostic:()=>{}},r=t.getParsedCommandLineOfConfigFile(N(e.projectDir,`tsconfig.json`),{},n);return r?wa({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 Ea(e){let t=await _a(e.compilerFrom??e.projectDir),n=N(M(e.routesFile),`__kick_client_probe__.ts`),r=ka(e.routesFile,e.keys),i=Ma(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.`);Da(t,i,e.routesFile);let s=Aa(t,i,o,e.keys),c=null,l=new ba(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===Oa(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 Da(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(`
791
- `);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 Oa(e){return`_K${e}`}function ka(e,t){let n=`./`+xt(e).replace(/\.tsx?$/,``),r=t.map((e,t)=>`type ${Oa(t)} = KickRoutes.Api[${JSON.stringify(e)}]`);return[`import ${JSON.stringify(n)}`,...r].join(`
789
+ `: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 ba=[`pnpm-lock.yaml`,`package-lock.json`,`yarn.lock`,`bun.lock`,`bun.lockb`],xa=/(?:^|[\\/])(?:node_modules|\.kickjs)(?:[\\/]|$)/;function Sa(e){return Nt(`sha1`).update(e).digest(`hex`)}function Ca(e){let t=Nt(`sha1`);t.update(e.cliVersion),t.update(JSON.stringify(e.options??{})),t.update(e.keys.join(`
790
+ `));for(let n of ba){let r=F(e.projectDir,n);if(z(r))try{t.update(B(r))}catch(e){throw Error(`kick/client: cannot read lockfile ${r}`,{cause:e})}}for(let n of e.fileNames.toSorted())if(!xa.test(n)){t.update(n);try{t.update(B(n))}catch(e){throw Error(`kick/client: cannot read project file ${n}`,{cause:e})}}return t.digest(`hex`)}async function wa(e){try{let t=await ga(e.compilerFrom??e.projectDir),n={...t.sys,onUnRecoverableConfigFileDiagnostic:()=>{}},r=t.getParsedCommandLineOfConfigFile(F(e.projectDir,`tsconfig.json`),{},n);return r?Ca({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 Ta(e){let t=await ga(e.compilerFrom??e.projectDir),n=F(P(e.routesFile),`__kick_client_probe__.ts`),r=Oa(e.routesFile,e.keys),i=ja(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.`);Ea(t,i,e.routesFile);let s=ka(t,i,o,e.keys),c=null,l=new ya(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===Da(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 Ea(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(`
791
+ `);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 Da(e){return`_K${e}`}function Oa(e,t){let n=`./`+yt(e).replace(/\.tsx?$/,``),r=t.map((e,t)=>`type ${Da(t)} = KickRoutes.Api[${JSON.stringify(e)}]`);return[`import ${JSON.stringify(n)}`,...r].join(`
792
792
  `)+`
793
- `}function Aa(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(Oa(t));r&&e.start>=r.getStart(n)&&e.start<r.getEnd()&&i.add(o)}return i}function ja(e,t){let n=e.filter(e=>/\.d\.(ts|mts|cts)$/.test(e)),r=[];try{r=z(t).filter(e=>e.endsWith(`.ts`)).map(e=>N(t,e))}catch{}return[.../* @__PURE__ */ new Set([...n,...r])]}function Ma(e,t,n,r){let i=N(t,`tsconfig.json`),a={...e.sys,onUnRecoverableConfigFileDiagnostic:t=>{throw Error(e.flattenDiagnosticMessageText(t.messageText,`
794
- `))}},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:[...ja(o.fileNames,M(n)),n],options:o.options,host:s})}const Na=`/* eslint-disable */
793
+ `}function ka(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(Da(t));r&&e.start>=r.getStart(n)&&e.start<r.getEnd()&&i.add(o)}return i}function Aa(e,t){let n=e.filter(e=>/\.d\.(ts|mts|cts)$/.test(e)),r=[];try{r=V(t).filter(e=>e.endsWith(`.ts`)).map(e=>F(t,e))}catch{}return[.../* @__PURE__ */ new Set([...n,...r])]}function ja(e,t,n,r){let i=F(t,`tsconfig.json`),a={...e.sys,onUnRecoverableConfigFileDiagnostic:t=>{throw Error(e.flattenDiagnosticMessageText(t.messageText,`
794
+ `))}},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:[...Aa(o.fileNames,P(n)),n],options:o.options,host:s})}const Ma=`/* eslint-disable */
795
795
  // AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
796
796
  //
797
797
  // Self-contained: this file has no imports, so a frontend consumes it without
@@ -805,7 +805,7 @@ ${_}
805
805
  //
806
806
  // Written when \`kick dev\` starts, not on save — resolving these types builds a
807
807
  // full TypeScript program over the server. Re-run \`kick typegen\`.
808
- `;function Pa(e,t){let n=t.filter(t=>e.entries.has(t));if(n.length===0)return`${Na}
808
+ `;function Na(e,t){let n=t.filter(t=>e.entries.has(t));if(n.length===0)return`${Ma}
809
809
  // (no routes discovered yet — annotate a controller method with
810
810
  // @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
811
811
  interface Api {}
@@ -822,7 +822,7 @@ export type { Api }
822
822
 
823
823
  `)+`
824
824
 
825
- `:``,i=n.map(t=>` ${JSON.stringify(t)}: ${e.entries.get(t)}`);return`${Na}
825
+ `:``,i=n.map(t=>` ${JSON.stringify(t)}: ${e.entries.get(t)}`);return`${Ma}
826
826
  ${r}interface Api {
827
827
  ${i.join(`
828
828
  `)}
@@ -836,7 +836,7 @@ declare global {
836
836
  }
837
837
 
838
838
  export type { Api }
839
- `}const Fa=`kick/client`,Q=`.kickjs/types/kick__client.d.ts`,Ia=`.kickjs/cache/client-map.sha1`,La=(()=>{try{return bt(import.meta.url)(`../../../package.json`).version??`0.0.0`}catch{return`0.0.0`}})();function Ra(e){try{if(!L(e))return null;let[t,n]=R(e,`utf-8`).trim().split(/\s+/);return t&&n?{inputs:t,output:n}:null}catch{return null}}function za(e){return`${wn}${Fa} */\n\n${e}\n`}function Ba(e){try{return L(e)?R(e,`utf-8`):null}catch{return null}}async function Va(e){let t=j.resolve(e.cwd,Q);if(!L(t))return!1;try{await kt(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 Ha(e){let t=e?.typegen?.client;return typeof t==`object`?t.maxDepth:void 0}function Ua(e){let t=e.config?.typegen?.client;return typeof t==`boolean`?t:t&&typeof t==`object`?t.enabled!==!1:(L(j.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 Wa=()=>({id:Fa,outExtension:`.d.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){if(!Ua(e))return null;if(e.watch)return e.log.info?.(" kick/client: skipped under watch (builds a full TypeScript program). Run `kick typegen` to refresh the client route map."),null;let t=await e.getScanResult({root:j.resolve(e.cwd,e.config?.typegen?.srcDir??`src`),cwd:e.cwd}),n=[],r=/* @__PURE__ */ new Set;for(let e of t.routes){let t=`${e.httpMethod} ${e.mountedPath??e.path}`;r.has(t)||(r.add(t),n.push(t))}let i=Ha(e.config),a=await Ta({projectDir:e.cwd,keys:n,maxDepth:i,cliVersion:La}),o=Ra(j.resolve(e.cwd,Ia)),s=Ba(j.resolve(e.cwd,Q));if(a&&o&&s!==null&&o.inputs===a&&o.output===Ca(s))return ue()&&e.log.info?.(` kick/client: unchanged, keeping ${Q}`),null;try{let t=Pa(await Ea({projectDir:e.cwd,routesFile:j.resolve(e.cwd,`.kickjs/types/kick__routes.ts`),keys:n,maxDepth:i,onWarn:t=>e.log.warn(t)}),n);return a&&!e.check&&await e.writeFile(Ia,`${a} ${Ca(za(t))}`),t}catch(t){let n=L(j.resolve(e.cwd,Q)),r=` kick/client: skipped — ${t instanceof Error?t.message:String(t)}`;return n?e.log.warn(r):ue()&&e.log.info?.(r),n&&await Va(e),null}}});function Ga(e,t,n=`zod`){if(!e)return null;let r=M(t),i=P(r,e.filePath).split(I).join(`/`);return i=i.replace(/\.(ts|tsx|mts|cts)$/i,``),i.startsWith(`.`)||(i=`./`+i),`/* eslint-disable */
839
+ `}const Pa=`kick/client`,$=`.kickjs/types/kick__client.d.ts`,Fa=`.kickjs/cache/client-map.sha1`,Ia=(()=>{try{return vt(import.meta.url)(`../../../package.json`).version??`0.0.0`}catch{return`0.0.0`}})();function La(e){try{if(!z(e))return null;let[t,n]=B(e,`utf-8`).trim().split(/\s+/);return t&&n?{inputs:t,output:n}:null}catch{return null}}function Ra(e){return`${Sn}${Pa} */\n\n${e}\n`}function za(e){try{return z(e)?B(e,`utf-8`):null}catch{return null}}async function Ba(e){let t=N.resolve(e.cwd,$);if(!z(t))return!1;try{await Dt(t,{force:!0})}catch(t){return e.log.warn(` kick/client: could not remove the stale ${$} — treat it as out of date (${t instanceof Error?t.message:String(t)})`),!0}return e.log.warn(` kick/client: removed the previously generated ${$} rather than leave a stale one — re-run \`kick typegen\` once the cause above is fixed.`),!0}function Va(e){let t=e?.typegen?.client;return typeof t==`object`?t.maxDepth:void 0}function Ha(e){let t=e.config?.typegen?.client;return typeof t==`boolean`?t:t&&typeof t==`object`?t.enabled!==!1:(z(N.resolve(e.cwd,$))&&e.log.warn(` kick/client: ${$} exists but typegen.client is not set, so it is NOT being refreshed.\n Add \`typegen: { client: true }\` to kick.config.ts to keep it current, or delete the file if nothing reads it.`),!1)}const Ua=()=>({id:Pa,outExtension:`.d.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){if(!Ha(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:N.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=Va(e.config),a=await wa({projectDir:e.cwd,keys:n,maxDepth:i,cliVersion:Ia}),o=La(N.resolve(e.cwd,Fa)),s=za(N.resolve(e.cwd,$));if(a&&o&&s!==null&&o.inputs===a&&o.output===Sa(s))return Pe()&&e.log.info?.(` kick/client: unchanged, keeping ${$}`),null;try{let t=Na(await Ta({projectDir:e.cwd,routesFile:N.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(Fa,`${a} ${Sa(Ra(t))}`),t}catch(t){let n=z(N.resolve(e.cwd,$)),r=` kick/client: skipped — ${t instanceof Error?t.message:String(t)}`;return n?e.log.warn(r):Pe()&&e.log.info?.(r),n&&await Ba(e),null}}});function Wa(e,t,n=`zod`){if(!e)return null;let r=P(t),i=I(r,e.filePath).split(R).join(`/`);return i=i.replace(/\.(ts|tsx|mts|cts)$/i,``),i.startsWith(`.`)||(i=`./`+i),`/* eslint-disable */
840
840
  // AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
841
841
  // Re-run with \`kick typegen\` or rely on \`kick dev\` to refresh.
842
842
 
@@ -874,6 +874,6 @@ declare global {
874
874
  }
875
875
 
876
876
  export {}
877
- `}const Ka=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=Ja(e);if(t===!1)return null;let n=await e.getScanResult({root:qa(e),cwd:e.cwd,envFile:t});if(!n.env)return null;let r=e.config?.typegen?.schemaValidator??`zod`,i=j.resolve(e.cwd,`.kickjs/types/kick__env.ts`);return Ga(n.env,i,r)}});function qa(e){return j.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Ja(e){return e.config?.typegen?.envFile}function Ya(e){return j.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Xa(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function $(e){return{root:Ya(e),cwd:e.cwd,envFile:Xa(e)}}const Za=()=>({id:`kick/registry`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e)),n=j.resolve(e.cwd,`.kickjs/types/kick__registry.d.ts`),r=new Set(t.collisions.map(e=>e.className));return at(t.classes,n,r)}}),Qa=()=>({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=lt(t.classes,t.tokens,t.injects,n);return ut(`ServiceToken`,r,"(no tokens discovered — declare with createToken<T>() or `kick g service <name>`)")}}),$a=()=>({id:`kick/modules`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return ut(`ModuleToken`,rt(t.classes),"(no @Module classes discovered — `kick g module <name>` to add one)")}}),eo=()=>({id:`kick/plugins`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return it(t.pluginsAndAdapters)}}),to=()=>({id:`kick/context`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return t.contextKeys.length===0?null:gt(t.contextKeys)}}),no=()=>({id:`kick/route-flags`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return ft(t.routeFlags)}}),ro={express:{subpath:`@forinda/kickjs/express`,typeName:`ExpressRuntimeTypes`},fastify:{subpath:`@forinda/kickjs/fastify`,typeName:`FastifyRuntimeTypes`},h3:{subpath:`@forinda/kickjs/h3`,typeName:`H3RuntimeTypes`}},io=[k({name:`kick/init`,register:Ht}),k({name:`kick/generate`,register:Sn}),k({name:`kick/run`,register:Vn}),k({name:`kick/info`,register:Kn}),k({name:`kick/inspect`,register:nr}),k({name:`kick/add`,register:Ke}),k({name:`kick/runtime-swap`,register:vr}),k({name:`kick/list`,register:Ie}),k({name:`kick/explain`,register:jr}),k({name:`kick/mcp`,register:Hr}),k({name:`kick/tinker`,register:Kr}),k({name:`kick/remove`,register:Qr}),k({name:`kick/typegen`,register:ti}),k({name:`kick/check`,register:bi}),k({name:`kick/doctor`,register:ye}),k({name:`kick/env-command`,register:Oi}),k({name:`kick/codemod`,register:Ai}),k({name:`kick/deploy`,register:ea}),k({name:`kick/registry`,typegens:[Za()]}),k({name:`kick/services`,typegens:[Qa()]}),k({name:`kick/modules`,typegens:[$a()]}),k({name:`kick/plugins`,typegens:[eo()]}),k({name:`kick/context`,typegens:[to()]}),k({name:`kick/route-flags`,typegens:[no()]}),k({name:`kick/assets`,typegens:[ta()]}),k({name:`kick/routes`,typegens:[da()]}),k({name:`kick/client`,typegens:[Wa()]}),k({name:`kick/env`,typegens:[Ka()]}),k({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??`express`;if(t!==`express`&&t!==`fastify`&&t!==`h3`)return null;let{subpath:n,typeName:r}=ro[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(`
878
- `)}}]})];export{Dn as applyDisableFilter,On as n,Ut as r,kn as runAllPluginTypegens,io as t};
879
- //# sourceMappingURL=run-plugins-BrI7b2Y5.mjs.map
877
+ `}const Ga=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=qa(e);if(t===!1)return null;let n=await e.getScanResult({root:Ka(e),cwd:e.cwd,envFile:t});if(!n.env)return null;let r=e.config?.typegen?.schemaValidator??`zod`,i=N.resolve(e.cwd,`.kickjs/types/kick__env.ts`);return Wa(n.env,i,r)}});function Ka(e){return N.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function qa(e){return e.config?.typegen?.envFile}function Ja(e){return N.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Ya(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function Xa(e){return{root:Ja(e),cwd:e.cwd,envFile:Ya(e)}}const Za=()=>({id:`kick/registry`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(Xa(e)),n=N.resolve(e.cwd,`.kickjs/types/kick__registry.d.ts`),r=new Set(t.collisions.map(e=>e.className));return nt(t.classes,n,r)}}),Qa=()=>({id:`kick/services`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(Xa(e)),n=new Set(t.collisions.map(e=>e.className)),r=ot(t.classes,t.tokens,t.injects,n);return st(`ServiceToken`,r,"(no tokens discovered — declare with createToken<T>() or `kick g service <name>`)")}}),$a=()=>({id:`kick/modules`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(Xa(e));return st(`ModuleToken`,et(t.classes),"(no @Module classes discovered — `kick g module <name>` to add one)")}}),eo=()=>({id:`kick/plugins`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(Xa(e));return tt(t.pluginsAndAdapters)}}),to=()=>({id:`kick/context`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(Xa(e));return t.contextKeys.length===0?null:pt(t.contextKeys)}}),no=()=>({id:`kick/route-flags`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(Xa(e));return lt(t.routeFlags)}}),ro={express:{subpath:`@forinda/kickjs/express`,typeName:`ExpressRuntimeTypes`},fastify:{subpath:`@forinda/kickjs/fastify`,typeName:`FastifyRuntimeTypes`},h3:{subpath:`@forinda/kickjs/h3`,typeName:`H3RuntimeTypes`}},io=[t({name:`kick/init`,register:Bt}),t({name:`kick/generate`,register:bn}),t({name:`kick/run`,register:zn}),t({name:`kick/info`,register:Wn}),t({name:`kick/inspect`,register:er}),t({name:`kick/add`,register:_}),t({name:`kick/runtime-swap`,register:_r}),t({name:`kick/list`,register:o}),t({name:`kick/explain`,register:Ar}),t({name:`kick/mcp`,register:Vr}),t({name:`kick/tinker`,register:Gr}),t({name:`kick/remove`,register:Zr}),t({name:`kick/typegen`,register:ei}),t({name:`kick/check`,register:yi}),t({name:`kick/doctor`,register:Ue}),t({name:`kick/env-command`,register:Di}),t({name:`kick/codemod`,register:ki}),t({name:`kick/deploy`,register:$i}),t({name:`kick/registry`,typegens:[Za()]}),t({name:`kick/services`,typegens:[Qa()]}),t({name:`kick/modules`,typegens:[$a()]}),t({name:`kick/plugins`,typegens:[eo()]}),t({name:`kick/context`,typegens:[to()]}),t({name:`kick/route-flags`,typegens:[no()]}),t({name:`kick/assets`,typegens:[ea()]}),t({name:`kick/routes`,typegens:[ua()]}),t({name:`kick/client`,typegens:[Ua()]}),t({name:`kick/env`,typegens:[Ga()]}),t({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??`express`;if(t!==`express`&&t!==`fastify`&&t!==`h3`)return null;let{subpath:n,typeName:r}=ro[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(`
878
+ `)}}]})];export{Tn as applyDisableFilter,En as n,Vt as r,Dn as runAllPluginTypegens,io as t};
879
+ //# sourceMappingURL=run-plugins-CisH0EMY.mjs.map