@forinda/kickjs-cli 8.18.0 → 8.19.0

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 (46) hide show
  1. package/dist/{agent-docs-xZISEduq.mjs → agent-docs-D10r5OEG.mjs} +3 -3
  2. package/dist/agent-docs-D10r5OEG.mjs.map +1 -0
  3. package/dist/{agent-docs-CbVUB2eN.mjs → agent-docs-D_L3RIUM.mjs} +2 -2
  4. package/dist/{build-BLQQMQtM.mjs → build-BkfEhRpx.mjs} +3 -3
  5. package/dist/{build-BLQQMQtM.mjs.map → build-BkfEhRpx.mjs.map} +1 -1
  6. package/dist/{build-CKmAKaJ1.mjs → build-CChfKQA_.mjs} +2 -2
  7. package/dist/{builtins-4IV5eliu.mjs → builtins-C1mgGr8D.mjs} +141 -141
  8. package/dist/{builtins-4OFjCWYj.mjs → builtins-cZC3AQMK.mjs} +2 -2
  9. package/dist/cli.mjs +2 -2
  10. package/dist/{config-B3kSZiSh.mjs → config-Bb-FdTKY.mjs} +3 -3
  11. package/dist/config-Bb-FdTKY.mjs.map +1 -0
  12. package/dist/{config-v0mtdiYe.mjs → config-xN3ZYiN-.mjs} +2 -2
  13. package/dist/{doctor-DJxEocJ5.mjs → doctor-CDdF_pWU.mjs} +4 -4
  14. package/dist/doctor-CDdF_pWU.mjs.map +1 -0
  15. package/dist/{fullstack-iWO7BFX6.mjs → fullstack-CHNFDgBX.mjs} +3 -3
  16. package/dist/{fullstack-DM0a3A8G.mjs → fullstack-D0Yim7JS.mjs} +4 -4
  17. package/dist/fullstack-D0Yim7JS.mjs.map +1 -0
  18. package/dist/index.d.mts +95 -1
  19. package/dist/index.d.mts.map +1 -1
  20. package/dist/index.mjs +2 -2
  21. package/dist/{plugin-BCMbxzi5.mjs → plugin-CFT_4ept.mjs} +2 -2
  22. package/dist/{plugin-P1F0k7kH.mjs → plugin-DxXeitAU.mjs} +2 -2
  23. package/dist/{project-6h_j0VK0.mjs → project-B9sWWiFy.mjs} +5 -5
  24. package/dist/project-B9sWWiFy.mjs.map +1 -0
  25. package/dist/{project-9QfIRkON.mjs → project-DDQFJyNi.mjs} +4 -4
  26. package/dist/{project-root-rs5vJCt5.mjs → project-root-ClOtJ6MM.mjs} +2 -2
  27. package/dist/{project-root-DcfsBtCw.mjs → project-root-DNQ4RQHQ.mjs} +3 -3
  28. package/dist/{project-root-DcfsBtCw.mjs.map → project-root-DNQ4RQHQ.mjs.map} +1 -1
  29. package/dist/rolldown-runtime-SDDZy9Be.mjs +11 -0
  30. package/dist/{run-plugins-BONtomzM.mjs → run-plugins-lJqFqRny.mjs} +5 -5
  31. package/dist/run-plugins-lJqFqRny.mjs.map +1 -0
  32. package/dist/{typegen-FLvIFR3i.mjs → typegen-Bkikzy45.mjs} +5 -5
  33. package/dist/typegen-Bkikzy45.mjs.map +1 -0
  34. package/dist/{typegen-ZG4nzOUN.mjs → typegen-DlnhNbzD.mjs} +4 -4
  35. package/dist/{types-Doudtd8d.mjs → types-ew1loX4G.mjs} +1 -1
  36. package/package.json +10 -10
  37. package/templates/feature-views/files/src/views/shared.ts +19 -0
  38. package/templates/feature-views/skills/views-forms.txt +1 -1
  39. package/dist/agent-docs-xZISEduq.mjs.map +0 -1
  40. package/dist/config-B3kSZiSh.mjs.map +0 -1
  41. package/dist/doctor-DJxEocJ5.mjs.map +0 -1
  42. package/dist/fullstack-DM0a3A8G.mjs.map +0 -1
  43. package/dist/project-6h_j0VK0.mjs.map +0 -1
  44. package/dist/rolldown-runtime-CQE1JsWD.mjs +0 -11
  45. package/dist/run-plugins-BONtomzM.mjs.map +0 -1
  46. package/dist/typegen-FLvIFR3i.mjs.map +0 -1
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs-cli v8.18.0
2
+ * @forinda/kickjs-cli v8.19.0
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-CQE1JsWD.mjs";import{C as t,S as n,_ as r,a as i,d as a,f 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,y}from"./project-9QfIRkON.mjs";import{a as b,c as x,d as S,f as ee,i as C,l as te,m as ne,o as w,p as re,s as T,u as ie}from"./config-v0mtdiYe.mjs";import{n as ae,r as E}from"./plugin-P1F0k7kH.mjs";import{C as D,S as O,_ as oe,a as se,c as ce,d as k,f as le,g as A,h as ue,i as j,l as M,m as de,n as fe,o as pe,p as me,s as he,u as ge,x as _e}from"./agent-docs-CbVUB2eN.mjs";import{t as N}from"./project-root-rs5vJCt5.mjs";import{C as ve,S as ye,_ as be,a as xe,b as Se,c as Ce,d as we,f as Te,g as Ee,h as De,i as Oe,l as ke,m as Ae,o as je,p as Me,r as Ne,s as Pe,t as Fe,u as Ie,v as Le,w as Re,x as ze,y as Be}from"./typegen-ZG4nzOUN.mjs";import{t as Ve}from"./build-CKmAKaJ1.mjs";import{createRequire as He}from"node:module";import{cpSync as Ue,existsSync as P,mkdirSync as We,readFileSync as F,readdirSync as Ge,rmSync as Ke,statSync as qe,writeFileSync as I}from"node:fs";import L,{basename as Je,dirname as R,join as z,relative as B,resolve as V,sep as H}from"node:path";import{fileURLToPath as Ye,pathToFileURL as U}from"node:url";import{fork as Xe,spawn as Ze,spawnSync as Qe}from"node:child_process";import{copyFile as $e,mkdir as et,readFile as W,readdir as tt,rm as nt,stat as rt,writeFile as it}from"node:fs/promises";import"@forinda/kickjs-cli-kit";import{createHash as at}from"node:crypto";import{parseSync as ot}from"oxc-parser";import st from"pluralize";import{arch as ct,platform as lt,release as ut}from"node:os";const dt=[{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 ft(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(`--client <framework>`,`Inertia template pages: react | vue | svelte (default react)`).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)=>{ce(`KickJS — Create a new project`);let n=m(),r=e=>{e&&M.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){M.error(e.message),k(`Aborted.`),process.exitCode=1;return}let a=[`react`,`vue`,`svelte`],o=t.client;if(o!==void 0&&!a.includes(o)){M.error(`Unknown --client '${String(o)}'. Use ${a.join(`, `)}.`),k(`Aborted.`),process.exitCode=1;return}let s=!!(t.yes||t.nonInteractive);e||=s?`my-api`:await de({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let c;if(e===`.`?(c=V(`.`),e=Je(c)):c=V(t.directory||e),P(c)){let n=Ge(c);if(n.length>0){if(t.force)M.warn(`Clearing existing files in ${c}`);else if(s){M.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),k(`Aborted.`);return}else{M.warn(`Directory "${e}" is not empty:`);let t=n.slice(0,5);for(let e of t)M.message(` - ${e}`);if(n.length>5&&M.message(` ... and ${n.length-5} more`),!await he({message:A.red(`Remove all existing files and proceed?`),initialValue:!1})){k(`Aborted.`);return}}for(let e of n)Ke(V(c,e),{recursive:!0,force:!0})}}s||r(await Promise.race([n,new Promise(e=>setTimeout(e,3e3,null).unref())]));let l=t.template;l||=s?`minimal`:await le({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, Vue or Svelte pages, one app, SSR`}]}),l===`inertia`&&o===void 0?o=s?`react`:await le({message:`Pages written in`,options:[{value:`react`,label:`React`},{value:`vue`,label:`Vue`},{value:`svelte`,label:`Svelte`}]}):l!==`inertia`&&o!==void 0&&M.warn(`--client applies to the inertia template only; ignoring it.`);let u=t.runtime;u||=s?`express`:await le({message:`HTTP runtime`,options:[{value:`express`,label:`Express`,hint:`default, zero-config`},{value:`fastify`,label:`Fastify`,hint:`fastify + @fastify/middie`},{value:`h3`,label:`h3`,hint:`Nitro / Nuxt engine`}]});let f=t.pm;f||=s?await se(void 0):await le({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let p=t.repo;p||=s?`inmemory`:await de({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),ne(p);let h=t.schema;l===`inertia`&&(h&&h!==`zod`&&M.warn(`The inertia template uses zod — ignoring --schema ${h}.`),h=`zod`),h||=s?`zod`:await le({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(h)||(M.warn(`Unknown --schema "${h}", falling back to zod.`),h=`zod`);let _;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();_=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else _=s?[]:await ge({message:`Select packages to include`,options:[...dt],required:!1});let v;v=t.git===void 0?s?!0:await he({message:`Initialize git repository?`,initialValue:!0}):t.git;let b;if(b=t.install===void 0?s?!0:await he({message:`Install dependencies?`,initialValue:!0}):t.install,t.frontend!==void 0&&t.frontend!==`kick`&&t.frontend!==`vite`){M.error(`Unknown --frontend '${String(t.frontend)}'. Use 'kick' (wired React app) or 'vite' (create-vite).`),k(`Aborted.`);return}let{VITE_TEMPLATES:x,DEFAULT_VITE_TEMPLATE:S}=await import(`./fullstack-iWO7BFX6.mjs`);if(t.viteTemplate!==void 0&&!x.some(e=>e.value===t.viteTemplate)){M.error(`Unknown --vite-template '${String(t.viteTemplate)}'. TypeScript templates only: ${x.map(e=>e.value).join(`, `)}.`),k(`Aborted.`);return}let C=t.frontend===`vite`?`vite`:`kick`,te=t.viteTemplate??S;if(l===`fullstack`&&!t.frontend&&!s&&(C=await le({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)`}]})),C===`vite`&&!t.viteTemplate&&!s&&(te=await le({message:`create-vite template`,options:x.map(e=>({value:e.value,label:e.label})),initialValue:S})),l===`fullstack`){let{initFullstackProject:t}=await import(`./fullstack-iWO7BFX6.mjs`);await t({name:e,directory:c,packageManager:f,initGit:v,installDeps:b,schemaLib:h,runtime:u,packages:_,frontend:C,viteTemplate:te,deploy:i}),s&&r(await n),k(`Done! Next steps: ${A.cyan(`cd ${e} && ${f}${f===`pnpm`?` dev`:` run dev:server`}`)}`)}else await d({name:e,directory:c,packageManager:f,initGit:v,installDeps:b,template:l,client:o,defaultRepo:p,packages:_,schemaLib:h,runtime:u,deploy:i}),s&&r(await n),k(`Done! Next steps: ${A.cyan(`cd ${e} && ${ee(f,`dev`)}`)}`)})}st.addUncountableRule(`auth`);function G(e){return e.replace(/[-_\s]+(.)?/g,(e,t)=>t?t.toUpperCase():``).replace(/^(.)/,e=>e.toUpperCase())}function pt(e){let t=G(e);return t.charAt(0).toLowerCase()+t.slice(1)}function K(e){return e.replace(/([a-z])([A-Z])/g,`$1-$2`).replace(/[\s_]+/g,`-`).toLowerCase()}function q(e){return st.plural(e)}function mt(e){return st.plural(e)}function ht(e){return K(e).replace(/-/g,`_`)}function gt(e){let t=e.cwd??process.cwd(),n=e.projectRoot??N(t),r=e.pluralize??!1,i=G(e.name),a=pt(e.name),o=K(e.name),s=ht(e.name),c={name:e.name,pascal:i,camel:a,kebab:o,snake:s,modulesDir:e.modulesDir??`src/modules`,cwd:t,projectRoot:n,args:e.args??[],flags:e.flags??{}};if(r){let e=q(o);c.pluralKebab=e,c.pluralPascal=G(e),c.pluralCamel=pt(e)}return c}function _t(e,t){return V(e.cwd,t)}async function vt(e){return import(U(e).href)}const yt=/* @__PURE__ */ new Map;async function bt(e){let t=yt.get(e);if(t)return t;let n=xt(e);return yt.set(e,n),n}async function xt(e){let t=V(e,`package.json`);if(!P(t))return{generators:[],loaded:[],failed:[]};let n=St(JSON.parse(await W(t,`utf-8`))),r=He(V(e,`package.json`)),i=[],a=[],o=[];for(let e of n){let t;try{t=r.resolve(`${e}/package.json`)}catch{continue}let n;try{n=JSON.parse(await W(t,`utf-8`))}catch(t){o.push({source:e,reason:`failed to parse package.json: ${t}`});continue}if(!n.kickjs?.generators)continue;let s=n.kickjs.generators,c=V(R(t),s);if(!P(c)){o.push({source:e,reason:`kickjs.generators points to missing file: ${s}`});continue}let l;try{l=await vt(c)}catch(t){o.push({source:e,reason:`failed to import manifest: ${t}`});continue}let u=l.default;if(!Array.isArray(u))o.push({source:e,reason:`manifest's default export is not an array of GeneratorSpec`});else{for(let t of u)Ct(t)?i.push({source:e,spec:t}):o.push({source:e,reason:`manifest entry is not a valid GeneratorSpec (missing name/files)`});a.push(e)}}return{generators:i,loaded:a,failed:o}}function St(e){let t=/* @__PURE__ */ new Set;for(let n of[e.dependencies,e.devDependencies,e.peerDependencies])if(n)for(let e of Object.keys(n))t.add(e);return Array.from(t)}function Ct(e){if(!e||typeof e!=`object`)return!1;let t=e;return typeof t.name==`string`&&typeof t.files==`function`}async function wt(e,t=[]){let n=e.cwd??process.cwd(),r=t.find(t=>t.spec.name===e.generatorName);if(r)return Dt(r.spec,r.source,e,n);let i=Et(await bt(n),e.generatorName);return i?Dt(i.spec,i.source,e,n):null}async function Tt(e,t=[]){let n=await bt(e),r=new Set(t.map(e=>e.spec.name)),i=n.generators.filter(e=>!r.has(e.spec.name));return{generators:[...t,...i],loaded:n.loaded,failed:n.failed}}function Et(e,t){return e.generators.find(e=>e.spec.name===t)}async function Dt(e,t,n,r){let i=gt({name:n.itemName,args:n.args,flags:n.flags,modulesDir:n.modulesDir,pluralize:n.pluralize,cwd:r,projectRoot:n.projectRoot}),a=await e.files(i),o=[];for(let e of a){let t=_t(i,e.path);await D(t,e.content),o.push(t)}return{files:o,source:t}}function Ot(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}const kt={inmemory:`in-memory`,drizzle:`Drizzle`,prisma:`Prisma`};function At(e){return e.charAt(0).toUpperCase()+e.slice(1).replace(/-([a-z])/g,(e,t)=>t.toUpperCase())}function jt(e){return kt[e]??At(e)}function Mt(e){return`create${e}Repository`}function Nt(e){return e??`define`}function Pt(e){let{pascal:t,kebab:n,plural:r=``,repo:i,style:a}=e,o=e.routePath??r,s=Mt(t),c=Nt(a),l=`/**
11
+ import{t as e}from"./rolldown-runtime-SDDZy9Be.mjs";import{C as t,S as n,_ as r,a as i,d as a,f 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,y}from"./project-DDQFJyNi.mjs";import{a as b,c as x,d as S,f as ee,i as C,l as te,m as ne,o as w,p as re,s as T,u as ie}from"./config-xN3ZYiN-.mjs";import{n as ae,r as E}from"./plugin-DxXeitAU.mjs";import{C as D,S as O,_ as oe,a as se,c as ce,d as k,f as le,g as A,h as ue,i as j,l as M,m as de,n as fe,o as pe,p as me,s as he,u as ge,x as _e}from"./agent-docs-D_L3RIUM.mjs";import{t as N}from"./project-root-ClOtJ6MM.mjs";import{C as ve,S as ye,_ as be,a as xe,b as Se,c as Ce,d as we,f as Te,g as Ee,h as De,i as Oe,l as ke,m as Ae,o as je,p as Me,r as Ne,s as Pe,t as Fe,u as Ie,v as Le,w as Re,x as ze,y as Be}from"./typegen-DlnhNbzD.mjs";import{t as Ve}from"./build-CChfKQA_.mjs";import{createRequire as He}from"node:module";import{cpSync as Ue,existsSync as P,mkdirSync as We,readFileSync as F,readdirSync as I,rmSync as Ge,statSync as Ke,writeFileSync as L}from"node:fs";import R,{basename as qe,dirname as z,join as B,relative as V,resolve as H,sep as U}from"node:path";import{fileURLToPath as Je,pathToFileURL as W}from"node:url";import{fork as Ye,spawn as Xe,spawnSync as Ze}from"node:child_process";import{copyFile as Qe,mkdir as $e,readFile as G,readdir as et,rm as tt,stat as nt,writeFile as rt}from"node:fs/promises";import"@forinda/kickjs-cli-kit";import{createHash as it}from"node:crypto";import{parseSync as at}from"oxc-parser";import ot from"pluralize";import{arch as st,platform as ct,release as lt}from"node:os";const ut=[{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 dt(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(`--client <framework>`,`Inertia template pages: react | vue | svelte (default react)`).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)=>{ce(`KickJS — Create a new project`);let n=m(),r=e=>{e&&M.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){M.error(e.message),k(`Aborted.`),process.exitCode=1;return}let a=[`react`,`vue`,`svelte`],o=t.client;if(o!==void 0&&!a.includes(o)){M.error(`Unknown --client '${String(o)}'. Use ${a.join(`, `)}.`),k(`Aborted.`),process.exitCode=1;return}let s=!!(t.yes||t.nonInteractive);e||=s?`my-api`:await de({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let c;if(e===`.`?(c=H(`.`),e=qe(c)):c=H(t.directory||e),P(c)){let n=I(c);if(n.length>0){if(t.force)M.warn(`Clearing existing files in ${c}`);else if(s){M.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),k(`Aborted.`);return}else{M.warn(`Directory "${e}" is not empty:`);let t=n.slice(0,5);for(let e of t)M.message(` - ${e}`);if(n.length>5&&M.message(` ... and ${n.length-5} more`),!await he({message:A.red(`Remove all existing files and proceed?`),initialValue:!1})){k(`Aborted.`);return}}for(let e of n)Ge(H(c,e),{recursive:!0,force:!0})}}s||r(await Promise.race([n,new Promise(e=>setTimeout(e,3e3,null).unref())]));let l=t.template;l||=s?`minimal`:await le({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, Vue or Svelte pages, one app, SSR`}]}),l===`inertia`&&o===void 0?o=s?`react`:await le({message:`Pages written in`,options:[{value:`react`,label:`React`},{value:`vue`,label:`Vue`},{value:`svelte`,label:`Svelte`}]}):l!==`inertia`&&o!==void 0&&M.warn(`--client applies to the inertia template only; ignoring it.`);let u=t.runtime;u||=s?`express`:await le({message:`HTTP runtime`,options:[{value:`express`,label:`Express`,hint:`default, zero-config`},{value:`fastify`,label:`Fastify`,hint:`fastify + @fastify/middie`},{value:`h3`,label:`h3`,hint:`Nitro / Nuxt engine`}]});let f=t.pm;f||=s?await se(void 0):await le({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let p=t.repo;p||=s?`inmemory`:await de({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),ne(p);let h=t.schema;l===`inertia`&&(h&&h!==`zod`&&M.warn(`The inertia template uses zod — ignoring --schema ${h}.`),h=`zod`),h||=s?`zod`:await le({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(h)||(M.warn(`Unknown --schema "${h}", falling back to zod.`),h=`zod`);let _;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();_=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else _=s?[]:await ge({message:`Select packages to include`,options:[...ut],required:!1});let v;v=t.git===void 0?s?!0:await he({message:`Initialize git repository?`,initialValue:!0}):t.git;let b;if(b=t.install===void 0?s?!0:await he({message:`Install dependencies?`,initialValue:!0}):t.install,t.frontend!==void 0&&t.frontend!==`kick`&&t.frontend!==`vite`){M.error(`Unknown --frontend '${String(t.frontend)}'. Use 'kick' (wired React app) or 'vite' (create-vite).`),k(`Aborted.`);return}let{VITE_TEMPLATES:x,DEFAULT_VITE_TEMPLATE:S}=await import(`./fullstack-CHNFDgBX.mjs`);if(t.viteTemplate!==void 0&&!x.some(e=>e.value===t.viteTemplate)){M.error(`Unknown --vite-template '${String(t.viteTemplate)}'. TypeScript templates only: ${x.map(e=>e.value).join(`, `)}.`),k(`Aborted.`);return}let C=t.frontend===`vite`?`vite`:`kick`,te=t.viteTemplate??S;if(l===`fullstack`&&!t.frontend&&!s&&(C=await le({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)`}]})),C===`vite`&&!t.viteTemplate&&!s&&(te=await le({message:`create-vite template`,options:x.map(e=>({value:e.value,label:e.label})),initialValue:S})),l===`fullstack`){let{initFullstackProject:t}=await import(`./fullstack-CHNFDgBX.mjs`);await t({name:e,directory:c,packageManager:f,initGit:v,installDeps:b,schemaLib:h,runtime:u,packages:_,frontend:C,viteTemplate:te,deploy:i}),s&&r(await n),k(`Done! Next steps: ${A.cyan(`cd ${e} && ${f}${f===`pnpm`?` dev`:` run dev:server`}`)}`)}else await d({name:e,directory:c,packageManager:f,initGit:v,installDeps:b,template:l,client:o,defaultRepo:p,packages:_,schemaLib:h,runtime:u,deploy:i}),s&&r(await n),k(`Done! Next steps: ${A.cyan(`cd ${e} && ${ee(f,`dev`)}`)}`)})}ot.addUncountableRule(`auth`);function K(e){return e.replace(/[-_\s]+(.)?/g,(e,t)=>t?t.toUpperCase():``).replace(/^(.)/,e=>e.toUpperCase())}function ft(e){let t=K(e);return t.charAt(0).toLowerCase()+t.slice(1)}function q(e){return e.replace(/([a-z])([A-Z])/g,`$1-$2`).replace(/[\s_]+/g,`-`).toLowerCase()}function J(e){return ot.plural(e)}function pt(e){return ot.plural(e)}function mt(e){return q(e).replace(/-/g,`_`)}function ht(e){let t=e.cwd??process.cwd(),n=e.projectRoot??N(t),r=e.pluralize??!1,i=K(e.name),a=ft(e.name),o=q(e.name),s=mt(e.name),c={name:e.name,pascal:i,camel:a,kebab:o,snake:s,modulesDir:e.modulesDir??`src/modules`,cwd:t,projectRoot:n,args:e.args??[],flags:e.flags??{}};if(r){let e=J(o);c.pluralKebab=e,c.pluralPascal=K(e),c.pluralCamel=ft(e)}return c}function gt(e,t){return H(e.cwd,t)}async function _t(e){return import(W(e).href)}const vt=/* @__PURE__ */ new Map;async function yt(e){let t=vt.get(e);if(t)return t;let n=bt(e);return vt.set(e,n),n}async function bt(e){let t=H(e,`package.json`);if(!P(t))return{generators:[],loaded:[],failed:[]};let n=xt(JSON.parse(await G(t,`utf-8`))),r=He(H(e,`package.json`)),i=[],a=[],o=[];for(let e of n){let t;try{t=r.resolve(`${e}/package.json`)}catch{continue}let n;try{n=JSON.parse(await G(t,`utf-8`))}catch(t){o.push({source:e,reason:`failed to parse package.json: ${t}`});continue}if(!n.kickjs?.generators)continue;let s=n.kickjs.generators,c=H(z(t),s);if(!P(c)){o.push({source:e,reason:`kickjs.generators points to missing file: ${s}`});continue}let l;try{l=await _t(c)}catch(t){o.push({source:e,reason:`failed to import manifest: ${t}`});continue}let u=l.default;if(!Array.isArray(u))o.push({source:e,reason:`manifest's default export is not an array of GeneratorSpec`});else{for(let t of u)St(t)?i.push({source:e,spec:t}):o.push({source:e,reason:`manifest entry is not a valid GeneratorSpec (missing name/files)`});a.push(e)}}return{generators:i,loaded:a,failed:o}}function xt(e){let t=/* @__PURE__ */ new Set;for(let n of[e.dependencies,e.devDependencies,e.peerDependencies])if(n)for(let e of Object.keys(n))t.add(e);return Array.from(t)}function St(e){if(!e||typeof e!=`object`)return!1;let t=e;return typeof t.name==`string`&&typeof t.files==`function`}async function Ct(e,t=[]){let n=e.cwd??process.cwd(),r=t.find(t=>t.spec.name===e.generatorName);if(r)return Et(r.spec,r.source,e,n);let i=Tt(await yt(n),e.generatorName);return i?Et(i.spec,i.source,e,n):null}async function wt(e,t=[]){let n=await yt(e),r=new Set(t.map(e=>e.spec.name)),i=n.generators.filter(e=>!r.has(e.spec.name));return{generators:[...t,...i],loaded:n.loaded,failed:n.failed}}function Tt(e,t){return e.generators.find(e=>e.spec.name===t)}async function Et(e,t,n,r){let i=ht({name:n.itemName,args:n.args,flags:n.flags,modulesDir:n.modulesDir,pluralize:n.pluralize,cwd:r,projectRoot:n.projectRoot}),a=await e.files(i),o=[];for(let e of a){let t=gt(i,e.path);await D(t,e.content),o.push(t)}return{files:o,source:t}}function Dt(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}const Ot={inmemory:`in-memory`,drizzle:`Drizzle`,prisma:`Prisma`};function kt(e){return e.charAt(0).toUpperCase()+e.slice(1).replace(/-([a-z])/g,(e,t)=>t.toUpperCase())}function At(e){return Ot[e]??kt(e)}function jt(e){return`create${e}Repository`}function Mt(e){return e??`define`}function Nt(e){let{pascal:t,kebab:n,plural:r=``,repo:i,style:a}=e,o=e.routePath??r,s=jt(t),c=Mt(a),l=`/**
12
12
  * ${t} Module
13
13
  *
14
14
  * REST module with a flat folder structure.
@@ -21,7 +21,7 @@ import{t as e}from"./rolldown-runtime-CQE1JsWD.mjs";import{C as t,S as n,_ as r,
21
21
  * dtos/ — Request/response schemas
22
22
  *
23
23
  * The repository is backed by an in-memory Map so this module works as
24
- * generated. Swap in ${i===`inmemory`?`a database`:jt(i)} by replacing the factory body in
24
+ * generated. Swap in ${i===`inmemory`?`a database`:At(i)} by replacing the factory body in
25
25
  * ${n}.repository.ts — the contract is whatever that factory returns, so
26
26
  * nothing else has to change.
27
27
  */`,u=`import { ${t.toUpperCase()}_REPOSITORY, ${s} } from './${n}.repository'
@@ -86,7 +86,7 @@ ${d}
86
86
  },
87
87
  }),
88
88
  })
89
- `}function Ft(e){let{pascal:t,kebab:n,plural:r=``,style:i}=e,a=e.routePath??r,o=Nt(i),s=` /**
89
+ `}function Pt(e){let{pascal:t,kebab:n,plural:r=``,style:i}=e,a=e.routePath??r,o=Mt(i),s=` /**
90
90
  * Declare HTTP routes. Return value shape:
91
91
  *
92
92
  * - \`path\` — URL prefix for this route set.
@@ -126,7 +126,7 @@ ${s}
126
126
  },
127
127
  }),
128
128
  })
129
- `}function It(e){let{pascal:t,kebab:n}=e,r=e.swagger?`import { ApiTags } from '@forinda/kickjs-swagger'
129
+ `}function Ft(e){let{pascal:t,kebab:n}=e,r=e.swagger?`import { ApiTags } from '@forinda/kickjs-swagger'
130
130
  `:``,i=e.swagger?` @ApiTags('${e.pascal}')\n`:``,a=t.charAt(0).toLowerCase()+t.slice(1);return`import {
131
131
  Controller,
132
132
  Get,
@@ -210,10 +210,10 @@ ${i} async remove(ctx: Ctx<KickRoutes.${t}Controller['remove']>) {
210
210
  return reply.noContent()
211
211
  }
212
212
  }
213
- `}const Lt={zod:{import:`import { z } from 'zod'`,required:`z.string().min(1, { error: 'Name is required' }).max(200)`,optional:`z.string().min(1).max(200).optional()`,infer:e=>`z.infer<typeof ${e}>`,hint:` * z.string(), z.number(), z.boolean(), z.enum([...]),
213
+ `}const It={zod:{import:`import { z } from 'zod'`,required:`z.string().min(1, { error: 'Name is required' }).max(200)`,optional:`z.string().min(1).max(200).optional()`,infer:e=>`z.infer<typeof ${e}>`,hint:` * z.string(), z.number(), z.boolean(), z.enum([...]),
214
214
  * z.array(), z.object(), .optional(), .default(), .transform()`},valibot:{import:`import * as v from 'valibot'`,required:`v.pipe(v.string(), v.minLength(1, 'Name is required'), v.maxLength(200))`,optional:`v.optional(v.pipe(v.string(), v.minLength(1), v.maxLength(200)))`,infer:e=>`v.InferOutput<typeof ${e}>`,hint:` * v.string(), v.number(), v.boolean(), v.picklist([...]),
215
215
  * v.array(), v.object(), v.optional(), and v.pipe(...) to chain checks`},yup:{import:`import * as yup from 'yup'`,required:`yup.string().required('Name is required').min(1).max(200)`,optional:`yup.string().min(1).max(200).optional()`,infer:e=>`yup.InferType<typeof ${e}>`,hint:` * yup.string(), yup.number(), yup.boolean(), .oneOf([...]),
216
- * yup.array(), yup.object(), .required(), .optional(), .default()`}};function Rt(e,t){return`${e===`zod`?`z.object`:e===`valibot`?`v.object`:`yup.object`}({\n ${t},\n})`}function zt(e){let{pascal:t}=e,n=e.schemaLib??`zod`,r=Lt[n],i=`create${t}Schema`,a=n===`zod`?`Zod`:n===`valibot`?`Valibot`:`Yup`;return`${r.import}
216
+ * yup.array(), yup.object(), .required(), .optional(), .default()`}};function Lt(e,t){return`${e===`zod`?`z.object`:e===`valibot`?`v.object`:`yup.object`}({\n ${t},\n})`}function Rt(e){let{pascal:t}=e,n=e.schemaLib??`zod`,r=It[n],i=`create${t}Schema`,a=n===`zod`?`Zod`:n===`valibot`?`Valibot`:`Yup`;return`${r.import}
217
217
 
218
218
  /**
219
219
  * Create ${t} DTO — ${a} schema for validating POST request bodies.
@@ -223,21 +223,21 @@ ${i} async remove(ctx: Ctx<KickRoutes.${t}Controller['remove']>) {
223
223
  * Add more fields as needed. Supported ${a} types:
224
224
  ${r.hint}
225
225
  */
226
- export const ${i} = ${Rt(n,`name: ${r.required}`)}
226
+ export const ${i} = ${Lt(n,`name: ${r.required}`)}
227
227
 
228
228
  export type Create${t}DTO = ${r.infer(i)}
229
- `}function Bt(e){let{pascal:t}=e,n=e.schemaLib??`zod`,r=Lt[n],i=`update${t}Schema`;return`${r.import}
229
+ `}function zt(e){let{pascal:t}=e,n=e.schemaLib??`zod`,r=It[n],i=`update${t}Schema`;return`${r.import}
230
230
 
231
- export const ${i} = ${Rt(n,`name: ${r.optional}`)}
231
+ export const ${i} = ${Lt(n,`name: ${r.optional}`)}
232
232
 
233
233
  export type Update${t}DTO = ${r.infer(i)}
234
- `}function Vt(e){let{pascal:t}=e;return`export interface ${t}ResponseDTO {
234
+ `}function Bt(e){let{pascal:t}=e;return`export interface ${t}ResponseDTO {
235
235
  id: string
236
236
  name: string
237
237
  createdAt: string
238
238
  updatedAt: string
239
239
  }
240
- `}function Ht(e){let{pascal:t,kebab:n,repoType:r,dtoPrefix:i=`./dtos`,tokenScope:a=`app`}=e,o=r&&r!==`inmemory`?r:``,s=`create${t}Repository`,c=` const store = new Map<string, ${t}ResponseDTO>()
240
+ `}function Vt(e){let{pascal:t,kebab:n,repoType:r,dtoPrefix:i=`./dtos`,tokenScope:a=`app`}=e,o=r&&r!==`inmemory`?r:``,s=`create${t}Repository`,c=` const store = new Map<string, ${t}ResponseDTO>()
241
241
 
242
242
  /**
243
243
  * Filtered, searched and sorted. \`byId\` breaks sort-key ties by id — what a
@@ -418,7 +418,7 @@ export type ${t}Repository = ReturnType<typeof ${s}>
418
418
  * adopters must NOT use the reserved \`'kick/'\` namespace.
419
419
  */
420
420
  export const ${t.toUpperCase()}_REPOSITORY = createToken<${t}Repository>('${a}/${t}/repository')
421
- `}function Ut(e){let{pascal:t,kebab:n,plural:r=``,style:i=`define`,testHarness:a=!1,testImport:o=`vitest`}=e,s=e.routePath??r,c=i===`define`?`${t}Module()`:`${t}Module`;return`${a?`import { describe, it, expect, beforeEach } from '${o}'
421
+ `}function Ht(e){let{pascal:t,kebab:n,plural:r=``,style:i=`define`,testHarness:a=!1,testImport:o=`vitest`}=e,s=e.routePath??r,c=i===`define`?`${t}Module()`:`${t}Module`;return`${a?`import { describe, it, expect, beforeEach } from '${o}'
422
422
  import request from 'supertest'
423
423
  import { Container } from '@forinda/kickjs'
424
424
  import { createTestApp } from '@forinda/kickjs-testing'
@@ -529,7 +529,7 @@ ${a?` it('creates a ${n} and points Location at it', async () => {
529
529
  it.todo('deletes a ${n}')
530
530
  })
531
531
  })
532
- `}function Wt(e){let{pascal:t,kebab:n,plural:r=``,repoPrefix:i=`../${n}.repository`,testImport:a=`vitest`}=e,o=`create${t}Repository`;return`import { describe, it, expect, beforeEach } from '${a}'
532
+ `}function Ut(e){let{pascal:t,kebab:n,plural:r=``,repoPrefix:i=`../${n}.repository`,testImport:a=`vitest`}=e,o=`create${t}Repository`;return`import { describe, it, expect, beforeEach } from '${a}'
533
533
  import { ${o}, type ${t}Repository } from '${i}'
534
534
 
535
535
  describe('${t} repository', () => {
@@ -668,7 +668,7 @@ describe('${t} repository', () => {
668
668
  expect(found).toBeNull()
669
669
  })
670
670
  })
671
- `}function Gt(e){let{pascal:t,kebab:n}=e;return`import { Service, Inject } from '@forinda/kickjs'
671
+ `}function Wt(e){let{pascal:t,kebab:n}=e;return`import { Service, Inject } from '@forinda/kickjs'
672
672
  import type { ParsedQuery } from '@forinda/kickjs'
673
673
  import { ${t.toUpperCase()}_REPOSITORY, type ${t}Repository } from './${n}.repository'
674
674
  import type { ${t}ResponseDTO } from './dtos/${n}-response.dto'
@@ -709,14 +709,14 @@ export class ${t}Service {
709
709
  await this.repo.delete(id)
710
710
  }
711
711
  }
712
- `}const Kt=/* @__PURE__ */ new Set([`string`,`text`,`email`,`url`]),qt=/* @__PURE__ */ new Set([`json`]);function Jt(e){let{pascal:t,fields:n=[{name:`name`,type:`string`}]}=e,r=n.filter(e=>!qt.has(e.type)).map(e=>e.name),i=n.filter(e=>Kt.has(e.type)).map(e=>e.name),a=e=>`[${e.map(e=>`'${e}'`).join(`, `)}]`;return`import type { QueryFieldConfig } from '@forinda/kickjs'
712
+ `}const Gt=/* @__PURE__ */ new Set([`string`,`text`,`email`,`url`]),Kt=/* @__PURE__ */ new Set([`json`]);function qt(e){let{pascal:t,fields:n=[{name:`name`,type:`string`}]}=e,r=n.filter(e=>!Kt.has(e.type)).map(e=>e.name),i=n.filter(e=>Gt.has(e.type)).map(e=>e.name),a=e=>`[${e.map(e=>`'${e}'`).join(`, `)}]`;return`import type { QueryFieldConfig } from '@forinda/kickjs'
713
713
 
714
714
  export const ${t.toUpperCase()}_QUERY_CONFIG: QueryFieldConfig = {
715
715
  filterable: ${a(r)},
716
716
  sortable: ${a([...r.filter(e=>e!==`createdAt`),`createdAt`])},
717
717
  searchable: ${a(i)},
718
718
  }
719
- `}async function Yt(e){let{pascal:t,kebab:n,plural:r,routePath:i,style:a,write:o}=e;await o(`${n}.module.ts`,Ft({pascal:t,kebab:n,plural:r,routePath:i,style:a})),await o(`${n}.controller.ts`,`import { Controller, Get, Post, Patch, Delete, reply, type Ctx } from '@forinda/kickjs'
719
+ `}async function Jt(e){let{pascal:t,kebab:n,plural:r,routePath:i,style:a,write:o}=e;await o(`${n}.module.ts`,Pt({pascal:t,kebab:n,plural:r,routePath:i,style:a})),await o(`${n}.controller.ts`,`import { Controller, Get, Post, Patch, Delete, reply, type Ctx } from '@forinda/kickjs'
720
720
 
721
721
  // \`Ctx<KickRoutes.${t}Controller['<method>']>\` is generated by
722
722
  // \`kick typegen\` (auto-run on \`kick dev\`).
@@ -757,7 +757,7 @@ export class ${t}Controller {
757
757
  return reply.noContent()
758
758
  }
759
759
  }
760
- `)}async function Xt(e){let{pascal:t,kebab:n,plural:r,pluralPascal:i,routePath:a,repo:o,noTests:s,tokenScope:c,style:l,testHarness:u,testImport:d,write:f}=e,p=e.swagger??!1,m=e.schemaLib??`zod`;await f(`${n}.module.ts`,Pt({pascal:t,kebab:n,plural:r,routePath:a,repo:o,style:l})),await f(`${n}.constants.ts`,Jt({pascal:t,kebab:n})),await f(`${n}.controller.ts`,It({pascal:t,kebab:n,plural:r,pluralPascal:i,swagger:p})),await f(`${n}.service.ts`,Gt({pascal:t,kebab:n})),await f(`dtos/create-${n}.dto.ts`,zt({pascal:t,kebab:n,schemaLib:m})),await f(`dtos/update-${n}.dto.ts`,Bt({pascal:t,kebab:n,schemaLib:m})),await f(`dtos/${n}-response.dto.ts`,Vt({pascal:t,kebab:n})),await f(`${n}.repository.ts`,Ht({pascal:t,kebab:n,repoType:o,dtoPrefix:`./dtos`,tokenScope:c})),s||(await f(`__tests__/${n}.controller.test.ts`,Ut({pascal:t,kebab:n,plural:r,routePath:a,style:l,testHarness:u,testImport:d})),await f(`__tests__/${n}.repository.test.ts`,Wt({pascal:t,kebab:n,plural:r,repoPrefix:`../${n}.repository`,testImport:d})))}function Zt(e){return e?typeof e==`string`?e:e.name:`inmemory`}async function Qt(e){let{name:t,modulesDir:n,noEntity:r,noTests:i,repo:a=`inmemory`,force:o,dryRun:s}=e,c=e.pluralize===!0,l=e.pattern??`rest`;e.minimal&&(l=`minimal`);let u=K(t),d=G(t),f=c?q(u):u,p=c?mt(d):d,m=e.pluralizeRoutes===!1?u:q(u),h=z(n,f),g=[],_=o??!1,v={kebab:u,pascal:d,plural:f,pluralPascal:p,routePath:m,moduleDir:h,repo:a,noEntity:r??!1,noTests:i??!1,tokenScope:e.tokenScope??`app`,swagger:e.swagger??!1,schemaLib:e.schemaLib??`zod`,testHarness:e.testHarness??!1,testImport:e.testImport,style:e.style??`define`,write:async(e,t)=>{let n=z(h,e);s?g.push(n):!_&&await _e(n)&&!await he({message:`File exists: ${A.dim(e)}. Overwrite?`,initialValue:!1})?M.warn(`Skipped: ${e}`):(await D(n,t),g.push(n))},files:g};switch(l){case`minimal`:await Yt(v);break;default:await Xt(v)}return s||await $t(n,d,f,u,v.style),g}async function $t(e,t,n,r,i=`define`){let a=z(e,`index.ts`),o=await _e(a),s=`./${n}/${r}.module`,c=i===`class`?`${t}Module`:`${t}Module()`;if(!o){let e=i===`class`?`import type { AppModuleEntry } from '@forinda/kickjs'
760
+ `)}async function Yt(e){let{pascal:t,kebab:n,plural:r,pluralPascal:i,routePath:a,repo:o,noTests:s,tokenScope:c,style:l,testHarness:u,testImport:d,write:f}=e,p=e.swagger??!1,m=e.schemaLib??`zod`;await f(`${n}.module.ts`,Nt({pascal:t,kebab:n,plural:r,routePath:a,repo:o,style:l})),await f(`${n}.constants.ts`,qt({pascal:t,kebab:n})),await f(`${n}.controller.ts`,Ft({pascal:t,kebab:n,plural:r,pluralPascal:i,swagger:p})),await f(`${n}.service.ts`,Wt({pascal:t,kebab:n})),await f(`dtos/create-${n}.dto.ts`,Rt({pascal:t,kebab:n,schemaLib:m})),await f(`dtos/update-${n}.dto.ts`,zt({pascal:t,kebab:n,schemaLib:m})),await f(`dtos/${n}-response.dto.ts`,Bt({pascal:t,kebab:n})),await f(`${n}.repository.ts`,Vt({pascal:t,kebab:n,repoType:o,dtoPrefix:`./dtos`,tokenScope:c})),s||(await f(`__tests__/${n}.controller.test.ts`,Ht({pascal:t,kebab:n,plural:r,routePath:a,style:l,testHarness:u,testImport:d})),await f(`__tests__/${n}.repository.test.ts`,Ut({pascal:t,kebab:n,plural:r,repoPrefix:`../${n}.repository`,testImport:d})))}function Xt(e){return e?typeof e==`string`?e:e.name:`inmemory`}async function Zt(e){let{name:t,modulesDir:n,noEntity:r,noTests:i,repo:a=`inmemory`,force:o,dryRun:s}=e,c=e.pluralize===!0,l=e.pattern??`rest`;e.minimal&&(l=`minimal`);let u=q(t),d=K(t),f=c?J(u):u,p=c?pt(d):d,m=e.pluralizeRoutes===!1?u:J(u),h=B(n,f),g=[],_=o??!1,v={kebab:u,pascal:d,plural:f,pluralPascal:p,routePath:m,moduleDir:h,repo:a,noEntity:r??!1,noTests:i??!1,tokenScope:e.tokenScope??`app`,swagger:e.swagger??!1,schemaLib:e.schemaLib??`zod`,testHarness:e.testHarness??!1,testImport:e.testImport,style:e.style??`define`,write:async(e,t)=>{let n=B(h,e);s?g.push(n):!_&&await _e(n)&&!await he({message:`File exists: ${A.dim(e)}. Overwrite?`,initialValue:!1})?M.warn(`Skipped: ${e}`):(await D(n,t),g.push(n))},files:g};switch(l){case`minimal`:await Jt(v);break;default:await Yt(v)}return s||await Qt(n,d,f,u,v.style),g}async function Qt(e,t,n,r,i=`define`){let a=B(e,`index.ts`),o=await _e(a),s=`./${n}/${r}.module`,c=i===`class`?`${t}Module`:`${t}Module()`;if(!o){let e=i===`class`?`import type { AppModuleEntry } from '@forinda/kickjs'
761
761
  import { ${t}Module } from '${s}'
762
762
 
763
763
  export const modules: AppModuleEntry[] = [${c}]
@@ -765,11 +765,11 @@ export const modules: AppModuleEntry[] = [${c}]
765
765
  import { ${t}Module } from '${s}'
766
766
 
767
767
  export const modules = defineModules().mount(${c})
768
- `;await D(a,e);return}let l=await W(a,`utf-8`),u=`import { ${t}Module } from '${s}'`,d=Ot(s);if(!RegExp(`^import\\s*\\{[^}]*\\b${Ot(t)}Module\\b[^}]*\\}\\s*from\\s*['"]${d}['"]`,`m`).test(l)){let e=l.lastIndexOf(`import `);if(e!==-1){let t=l.indexOf(`
768
+ `;await D(a,e);return}let l=await G(a,`utf-8`),u=`import { ${t}Module } from '${s}'`,d=Dt(s);if(!RegExp(`^import\\s*\\{[^}]*\\b${Dt(t)}Module\\b[^}]*\\}\\s*from\\s*['"]${d}['"]`,`m`).test(l)){let e=l.lastIndexOf(`import `);if(e!==-1){let t=l.indexOf(`
769
769
  `,e);l=l.slice(0,t+1)+u+`
770
770
  `+l.slice(t+1)}else l=u+`
771
- `+l}let f=tn(l);if(f){let e=l.slice(f.rhsStart,f.rhsEnd+1);RegExp(`\\b${Ot(t)}Module\\b`).test(e)||(l=en(l,c))}else l=en(l,c);await D(a,l)}function en(e,t){let n=tn(e);if(!n)return e;if(n.shape===`array`){let r=e.slice(n.rhsStart+1,n.rhsEnd),i=r.trim(),a;if(!i)a=`[${t}]`;else{let e=i.endsWith(`,`)?``:`,`;a=`[${r.trimEnd()}${e} ${t}]`}return e.slice(0,n.rhsStart)+a+e.slice(n.rhsEnd+1)}return`${e.slice(0,n.chainEnd)}\n .mount(${t})${e.slice(n.chainEnd)}`}function tn(e){let t=/export\s+const\s+modules\b[^=]*=/.exec(e);if(!t)return null;let n=t.index+t[0].length;for(;n<e.length&&/\s/.test(e[n]??``);)n++;if(e[n]===`[`){let t=an(e,n);return t===-1?null:{shape:`array`,rhsStart:n,rhsEnd:t}}if(e.slice(n,n+13)===`defineModules`){let t=nn(e,n);return t===-1?null:{shape:`chain`,rhsStart:n,rhsEnd:t-1,chainEnd:t}}return null}function nn(e,t=0){let n=/defineModules\s*\(/g;n.lastIndex=t;let r=n.exec(e);if(!r)return-1;let i=r.index+r[0].length-1;if(e[i]!==`(`||(i=on(e,i),i===-1))return-1;for(i++;;){let t=i;for(;t<e.length&&/\s/.test(e[t]??``);)t++;if(e[t]!==`.`||e.slice(t,t+6)!==`.mount`)break;for(t+=6;t<e.length&&/\s/.test(e[t]??``);)t++;if(e[t]!==`(`)break;let n=on(e,t);if(n===-1)break;i=n+1}return i}function rn(e,t){let n=e.slice(t,t+2);if(n===`//`){for(t+=2;t<e.length&&e[t]!==`
772
- `;)t++;return t}if(n===`/*`){for(t+=2;t+1<e.length&&(e[t]!==`*`||e[t+1]!==`/`);)t++;return t+2}return t}function an(e,t){if(e[t]!==`[`)return-1;let n=1,r=t+1;for(;r<e.length;){let t=e.slice(r,r+2);if(t===`//`||t===`/*`){r=rn(e,r);continue}let i=e[r]??``;if(i===`'`||i===`"`||i==="`"){let t=i;for(r++;r<e.length&&e[r]!==t;)e[r]===`\\`&&r++,r++;r<e.length&&r++}else{if(i===`[`)n++;else if(i===`]`&&(n--,n===0))return r;r++}}return-1}function on(e,t){if(e[t]!==`(`)return-1;let n=1,r=t+1;for(;r<e.length;){let t=e.slice(r,r+2);if(t===`//`||t===`/*`){r=rn(e,r);continue}let i=e[r]??``;if(i===`'`||i===`"`||i==="`"){let t=i;for(r++;r<e.length&&e[r]!==t;)e[r]===`\\`&&r++,r++;r<e.length&&r++}else{if(i===`(`)n++;else if(i===`)`&&(n--,n===0))return r;r++}}return-1}function sn(e,t,n,r){return`/**
771
+ `+l}let f=en(l);if(f){let e=l.slice(f.rhsStart,f.rhsEnd+1);RegExp(`\\b${Dt(t)}Module\\b`).test(e)||(l=$t(l,c))}else l=$t(l,c);await D(a,l)}function $t(e,t){let n=en(e);if(!n)return e;if(n.shape===`array`){let r=e.slice(n.rhsStart+1,n.rhsEnd),i=r.trim(),a;if(!i)a=`[${t}]`;else{let e=i.endsWith(`,`)?``:`,`;a=`[${r.trimEnd()}${e} ${t}]`}return e.slice(0,n.rhsStart)+a+e.slice(n.rhsEnd+1)}return`${e.slice(0,n.chainEnd)}\n .mount(${t})${e.slice(n.chainEnd)}`}function en(e){let t=/export\s+const\s+modules\b[^=]*=/.exec(e);if(!t)return null;let n=t.index+t[0].length;for(;n<e.length&&/\s/.test(e[n]??``);)n++;if(e[n]===`[`){let t=rn(e,n);return t===-1?null:{shape:`array`,rhsStart:n,rhsEnd:t}}if(e.slice(n,n+13)===`defineModules`){let t=tn(e,n);return t===-1?null:{shape:`chain`,rhsStart:n,rhsEnd:t-1,chainEnd:t}}return null}function tn(e,t=0){let n=/defineModules\s*\(/g;n.lastIndex=t;let r=n.exec(e);if(!r)return-1;let i=r.index+r[0].length-1;if(e[i]!==`(`||(i=an(e,i),i===-1))return-1;for(i++;;){let t=i;for(;t<e.length&&/\s/.test(e[t]??``);)t++;if(e[t]!==`.`||e.slice(t,t+6)!==`.mount`)break;for(t+=6;t<e.length&&/\s/.test(e[t]??``);)t++;if(e[t]!==`(`)break;let n=an(e,t);if(n===-1)break;i=n+1}return i}function nn(e,t){let n=e.slice(t,t+2);if(n===`//`){for(t+=2;t<e.length&&e[t]!==`
772
+ `;)t++;return t}if(n===`/*`){for(t+=2;t+1<e.length&&(e[t]!==`*`||e[t+1]!==`/`);)t++;return t+2}return t}function rn(e,t){if(e[t]!==`[`)return-1;let n=1,r=t+1;for(;r<e.length;){let t=e.slice(r,r+2);if(t===`//`||t===`/*`){r=nn(e,r);continue}let i=e[r]??``;if(i===`'`||i===`"`||i==="`"){let t=i;for(r++;r<e.length&&e[r]!==t;)e[r]===`\\`&&r++,r++;r<e.length&&r++}else{if(i===`[`)n++;else if(i===`]`&&(n--,n===0))return r;r++}}return-1}function an(e,t){if(e[t]!==`(`)return-1;let n=1,r=t+1;for(;r<e.length;){let t=e.slice(r,r+2);if(t===`//`||t===`/*`){r=nn(e,r);continue}let i=e[r]??``;if(i===`'`||i===`"`||i==="`"){let t=i;for(r++;r<e.length&&e[r]!==t;)e[r]===`\\`&&r++,r++;r<e.length&&r++}else{if(i===`(`)n++;else if(i===`)`&&(n--,n===0))return r;r++}}return-1}function on(e,t,n,r){return`/**
773
773
  * Snapshot for the DevTools topology view (\`/_debug\`).
774
774
  *
775
775
  * Must be CHEAP — the topology endpoint polls on a short interval, so
@@ -809,7 +809,7 @@ export const modules = defineModules().mount(${c})
809
809
  // ]
810
810
  // },`.split(`
811
811
  `).map(e=>r+e).join(`
812
- `)}async function cn(e){let{name:t,outDir:n}=e,r=K(t),i=G(t),a=[],o=z(n,`${r}.adapter.ts`);return await D(o,`import {
812
+ `)}async function sn(e){let{name:t,outDir:n}=e,r=q(t),i=K(t),a=[],o=B(n,`${r}.adapter.ts`);return await D(o,`import {
813
813
  defineAdapter,
814
814
  type AdapterContext,
815
815
  type AdapterMiddleware,
@@ -1014,11 +1014,11 @@ export const ${i}Adapter = defineAdapter<${i}AdapterConfig>({
1014
1014
  return { name: '${r}', status: 'up' }
1015
1015
  },
1016
1016
 
1017
- ${sn(r,i,`adapter`,` `)}
1017
+ ${on(r,i,`adapter`,` `)}
1018
1018
  }
1019
1019
  },
1020
1020
  })
1021
- `),a.push(o),a}async function ln(e){let{name:t,outDir:n}=e,r=K(t),i=G(t),a=[],o=z(n,`${r}.plugin.ts`);return await D(o,`import {
1021
+ `),a.push(o),a}async function cn(e){let{name:t,outDir:n}=e,r=q(t),i=K(t),a=[],o=B(n,`${r}.plugin.ts`);return await D(o,`import {
1022
1022
  definePlugin,
1023
1023
  type AppAdapter,
1024
1024
  type AppModuleEntry,
@@ -1175,13 +1175,13 @@ export const ${i}Plugin = definePlugin<${i}PluginConfig>({
1175
1175
  // Example: await this.connection?.close()
1176
1176
  },
1177
1177
 
1178
- ${sn(r,i,`plugin`,` `)}
1178
+ ${on(r,i,`plugin`,` `)}
1179
1179
  }),
1180
1180
  })
1181
- `),a.push(o),a}const un={controller:``,service:``,dto:`dtos`,guard:`guards`,middleware:`middleware`,contributor:`contributors`};function dn(e){let{type:t,outDir:n,moduleName:r,modulesDir:i=`src/modules`,defaultDir:a,shouldPluralize:o=!1}=e;if(n)return V(n);if(r){let e=un,n=K(r),a=o?q(n):n,s=e[t]??``,c=z(i,a);return V(s?z(c,s):c)}return V(a)}async function fn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=e.runtime===`express`,o=e.runtime?`this project runs on ${e.runtime} and has no
1182
- // \`express\``:"this project declares no `runtime` in kick.config.ts, so it\n // may have no `express`",s=dn({type:`middleware`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/middleware`,pattern:i,shouldPluralize:e.pluralize??!1}),c=K(t),l=pt(t),u=[],d=z(s,`${c}.middleware.ts`);return await D(d,`${a?`import type { Request, Response, NextFunction } from 'express'`:`import type { IncomingMessage, ServerResponse } from 'node:http'`}
1181
+ `),a.push(o),a}const ln={controller:``,service:``,dto:`dtos`,guard:`guards`,middleware:`middleware`,contributor:`contributors`};function un(e){let{type:t,outDir:n,moduleName:r,modulesDir:i=`src/modules`,defaultDir:a,shouldPluralize:o=!1}=e;if(n)return H(n);if(r){let e=ln,n=q(r),a=o?J(n):n,s=e[t]??``,c=B(i,a);return H(s?B(c,s):c)}return H(a)}async function dn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=e.runtime===`express`,o=e.runtime?`this project runs on ${e.runtime} and has no
1182
+ // \`express\``:"this project declares no `runtime` in kick.config.ts, so it\n // may have no `express`",s=un({type:`middleware`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/middleware`,pattern:i,shouldPluralize:e.pluralize??!1}),c=q(t),l=ft(t),u=[],d=B(s,`${c}.middleware.ts`);return await D(d,`${a?`import type { Request, Response, NextFunction } from 'express'`:`import type { IncomingMessage, ServerResponse } from 'node:http'`}
1183
1183
 
1184
- export interface ${G(t)}Options {
1184
+ export interface ${K(t)}Options {
1185
1185
  // Add configuration options here. The factory below closes over the
1186
1186
  // resolved options object; pass them at the call site —
1187
1187
  // \`${l}({ foo: 'bar' })\` — and the closure preserves them across
@@ -1189,7 +1189,7 @@ export interface ${G(t)}Options {
1189
1189
  }
1190
1190
 
1191
1191
  /**
1192
- * ${G(t)} middleware.
1192
+ * ${K(t)} middleware.
1193
1193
  *
1194
1194
  * Usage in bootstrap (fires on every request):
1195
1195
  * middlewares: [${l}()]
@@ -1225,7 +1225,7 @@ export interface ${G(t)}Options {
1225
1225
  * first \`next()\` throws \`TypeError: next is not a function\`. Generate a
1226
1226
  * guard instead (\`kick g guard\`) for the per-route, ctx-style shape.
1227
1227
  */
1228
- export function ${l}(options: ${G(t)}Options = {}) {
1228
+ export function ${l}(options: ${K(t)}Options = {}) {
1229
1229
  ${a?" // Typed from `express` because that is this project's runtime\n // (`runtime: 'express'` in kick.config.ts). Global middleware is\n // connect-style on every engine, but only Express hands the handler its own\n // request / response objects — so `req.originalUrl`, `req.query` and\n // `res.json()` are all available here. Switching `runtime` later means\n // re-typing this signature from `node:http`.\n return (req: Request, res: Response, next: NextFunction) => {":` // Typed from \`node:http\`, not \`express\`. Global middleware is connect-style
1230
1230
  // on every engine, but ${o} dependency to import types from. Under Fastify the handler
1231
1231
  // receives \`request.raw\` / a reply driver, and under h3 the node objects, so
@@ -1238,7 +1238,7 @@ ${a?" // Typed from `express` because that is this project's runtime\n // (`ru
1238
1238
  next()
1239
1239
  }
1240
1240
  }
1241
- `),u.push(d),u}async function pn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=dn({type:`guard`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/guards`,pattern:i,shouldPluralize:e.pluralize??!1}),o=K(t),s=pt(t),c=G(t),l=[],u=z(a,`${o}.guard.ts`);return await D(u,`import { Container, HttpException } from '@forinda/kickjs'
1241
+ `),u.push(d),u}async function fn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=un({type:`guard`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/guards`,pattern:i,shouldPluralize:e.pluralize??!1}),o=q(t),s=ft(t),c=K(t),l=[],u=B(a,`${o}.guard.ts`);return await D(u,`import { Container, HttpException } from '@forinda/kickjs'
1242
1242
  import type { RequestContext } from '@forinda/kickjs'
1243
1243
 
1244
1244
  /**
@@ -1278,7 +1278,7 @@ export async function ${s}Guard(ctx: RequestContext, next: () => void): Promise<
1278
1278
  ctx.problem.unauthorized({ detail: 'Invalid or expired token' })
1279
1279
  }
1280
1280
  }
1281
- `),l.push(u),l}function mn(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 hn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=e.type??`http`,o=K(t),s=G(t),c=e.key??pt(t),l=Array.isArray(e.params)?e.params:mn(e.params),u=dn({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(`
1281
+ `),l.push(u),l}function pn(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 mn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=e.type??`http`,o=q(t),s=K(t),c=e.key??ft(t),l=Array.isArray(e.params)?e.params:pn(e.params),u=un({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(`
1282
1282
  `)}\n}\n`:``,m=l.length>0?`${d}.withParams<${s}Params>()({`:`${d}({`,h=l.length>0?` // Every call site must supply these — no placeholder defaults.
1283
1283
  // Add \`paramDefaults: { … }\` for any field whose default is
1284
1284
  // genuinely correct for an undecorated route, and drop it from here.
@@ -1329,7 +1329,7 @@ ${_}
1329
1329
  throw new Error("${s} contributor: resolve() not implemented")
1330
1330
  },
1331
1331
  })
1332
- `,y=z(u,`${o}.contributor.ts`);return await D(y,v),[y]}async function gn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=dn({type:`service`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/services`,pattern:i,shouldPluralize:e.pluralize??!1}),o=K(t),s=G(t),c=[],l=z(a,`${o}.service.ts`);return await D(l,`import { Service } from '@forinda/kickjs'
1332
+ `,y=B(u,`${o}.contributor.ts`);return await D(y,v),[y]}async function hn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=un({type:`service`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/services`,pattern:i,shouldPluralize:e.pluralize??!1}),o=q(t),s=K(t),c=[],l=B(a,`${o}.service.ts`);return await D(l,`import { Service } from '@forinda/kickjs'
1333
1333
 
1334
1334
  @Service()
1335
1335
  export class ${s}Service {
@@ -1338,7 +1338,7 @@ export class ${s}Service {
1338
1338
  // @Inject(MY_REPO) private readonly repo: IMyRepository,
1339
1339
  // ) {}
1340
1340
  }
1341
- `),c.push(l),c}async function _n(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=dn({type:`controller`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/controllers`,pattern:i,shouldPluralize:e.pluralize??!1}),o=K(t),s=G(t),c=[],l=z(a,`${o}.controller.ts`);return await D(l,`import { Controller, Get, Post, Patch, Delete, reply, type Ctx } from '@forinda/kickjs'
1341
+ `),c.push(l),c}async function gn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=un({type:`controller`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/controllers`,pattern:i,shouldPluralize:e.pluralize??!1}),o=q(t),s=K(t),c=[],l=B(a,`${o}.controller.ts`);return await D(l,`import { Controller, Get, Post, Patch, Delete, reply, type Ctx } from '@forinda/kickjs'
1342
1342
 
1343
1343
  // \`Ctx<KickRoutes.${s}Controller['<method>']>\` is generated by
1344
1344
  // \`kick typegen\` (auto-run on \`kick dev\`). After the first run, your IDE
@@ -1381,12 +1381,12 @@ export class ${s}Controller {
1381
1381
  return reply.noContent()
1382
1382
  }
1383
1383
  }
1384
- `),c.push(l),c}async function vn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=dn({type:`dto`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/dtos`,pattern:i,shouldPluralize:e.pluralize??!1}),o=K(t),s=G(t),c=pt(t),l=e.schemaLib??`zod`,u=Lt[l],d=[],f=z(a,`${o}.dto.ts`);return await D(f,`${u.import}
1384
+ `),c.push(l),c}async function _n(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=un({type:`dto`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/dtos`,pattern:i,shouldPluralize:e.pluralize??!1}),o=q(t),s=K(t),c=ft(t),l=e.schemaLib??`zod`,u=It[l],d=[],f=B(a,`${o}.dto.ts`);return await D(f,`${u.import}
1385
1385
 
1386
- export const ${c}Schema = ${Rt(l,`// Define your schema fields here\n name: ${u.required}`)}
1386
+ export const ${c}Schema = ${Lt(l,`// Define your schema fields here\n name: ${u.required}`)}
1387
1387
 
1388
1388
  export type ${s}DTO = ${u.infer(`${c}Schema`)}
1389
- `),d.push(f),d}async function yn(e){let t=z(e.outDir,`kick.config.ts`),n=e.modulesDir??`src/modules`,r=e.defaultRepo??`inmemory`;return P(t)&&!e.force&&!await he({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
1389
+ `),d.push(f),d}async function vn(e){let t=B(e.outDir,`kick.config.ts`),n=e.modulesDir??`src/modules`,r=e.defaultRepo??`inmemory`;return P(t)&&!e.force&&!await he({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
1390
1390
  Skipped — existing kick.config.ts preserved.`),[]):(await D(t,`import { defineConfig } from '@forinda/kickjs-cli'
1391
1391
 
1392
1392
  export default defineConfig({
@@ -1430,18 +1430,18 @@ export default defineConfig({
1430
1430
  },
1431
1431
  ],
1432
1432
  })
1433
- `),[t])}function bn(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 xn(e,t){let n=t.exec(e);if(!n)return null;let r=n.index+n[0].length-1,i=bn(e,r);return i===-1?null:e.slice(r+1,i)}function Sn(e,t,n){let r=` `.repeat(n);return e.split(`
1433
+ `),[t])}function yn(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 bn(e,t){let n=t.exec(e);if(!n)return null;let r=n.index+n[0].length-1,i=yn(e,r);return i===-1?null:e.slice(r+1,i)}function xn(e,t,n){let r=` `.repeat(n);return e.split(`
1434
1434
  `).map(e=>{if(e.trim()===``)return e;let n=RegExp(`^ {0,${t}}`),i=e.replace(n,``);return r+i}).join(`
1435
- `)}function Cn(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 wn(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 Tn(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=bn(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=xn(o,/register\s*\(([^)]*)\)\s*:\s*void\s*\{/),u=xn(o,/contributors\s*\(\s*\)\s*:\s*ContributorRegistrations\s*\{/),d=xn(o,/routes\s*\(\s*\)\s*:\s*[A-Za-z|[\]\s]+\{/);if(!d)return{migrated:null,reason:`routes() method missing or signature unrecognized`};let f=Cn(s),p=``;return l&&(p+=` register(container) {${Sn(l,4,6)} },\n\n`),u&&(p+=` contributors() {${Sn(u,4,6)} },\n\n`),p+=` routes() {${Sn(d,4,6)} },`,{migrated:`${f}${`export const ${r} = defineModule({
1435
+ `)}function Sn(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 Cn(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 wn(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=yn(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=bn(o,/register\s*\(([^)]*)\)\s*:\s*void\s*\{/),u=bn(o,/contributors\s*\(\s*\)\s*:\s*ContributorRegistrations\s*\{/),d=bn(o,/routes\s*\(\s*\)\s*:\s*[A-Za-z|[\]\s]+\{/);if(!d)return{migrated:null,reason:`routes() method missing or signature unrecognized`};let f=Sn(s),p=``;return l&&(p+=` register(container) {${xn(l,4,6)} },\n\n`),u&&(p+=` contributors() {${xn(u,4,6)} },\n\n`),p+=` routes() {${xn(d,4,6)} },`,{migrated:`${f}${`export const ${r} = defineModule({
1436
1436
  name: '${r}',
1437
1437
  build: () => ({
1438
1438
  ${p}
1439
1439
  }),
1440
- })`}${c}`}}function En(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=bn(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]===`
1441
- `||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=bn(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=xn(m,/register\s*\(([^)]*)\)\s*\{/),g=xn(m,/contributors\s*\(\s*\)\s*\{/),_=xn(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let v=wn(c,{container:h!==null,appModule:!0,moduleRoutes:!0,contributorRegistrations:g!==null}),y=``;return h!==null&&(y+=` register(container: Container): void {${Sn(h,6,4)} }\n\n`),g!==null&&(y+=` contributors(): ContributorRegistrations {${Sn(g,6,4)} }\n\n`),y+=` routes(): ModuleRoutes {${Sn(_,6,4)} }`,{migrated:`${v}${`export class ${r} implements AppModule {
1440
+ })`}${c}`}}function Tn(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=yn(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]===`
1441
+ `||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=yn(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=bn(m,/register\s*\(([^)]*)\)\s*\{/),g=bn(m,/contributors\s*\(\s*\)\s*\{/),_=bn(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let v=Cn(c,{container:h!==null,appModule:!0,moduleRoutes:!0,contributorRegistrations:g!==null}),y=``;return h!==null&&(y+=` register(container: Container): void {${xn(h,6,4)} }\n\n`),g!==null&&(y+=` contributors(): ContributorRegistrations {${xn(g,6,4)} }\n\n`),y+=` routes(): ModuleRoutes {${xn(_,6,4)} }`,{migrated:`${v}${`export class ${r} implements AppModule {
1442
1442
  ${y}
1443
1443
  }
1444
- `}${u}`}}function Dn(e,t){return t===`class`?En(e):Tn(e)}function On(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 kn(e){let t=[];return await n(V(e),0),t;async function n(e,r){let i;try{i=await tt(e)}catch{return}for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=z(e,a),o;try{o=await rt(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function An(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await tt(e)}catch{return}await et(t,{recursive:!0});for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=z(e,a),o=z(t,a),s;try{s=await rt(i)}catch{continue}s.isDirectory()?await r(i,o):(await $e(i,o),n++)}}}function jn(e){let t=(/* @__PURE__ */ new Date()).toISOString().replaceAll(/[:.]/g,`-`);return z(e,`.kickjs`,`codemod-backups`,`${t}-modules`)}async function Mn(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await kn(e),s=await W(z(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=jn(r),await An(e,c));let l=[];for(let e of o){let t=Dn(await W(e,`utf-8`),i);t.migrated==null?l.push({path:e,status:`skipped`,reason:t.reason}):(n||await it(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`}))}let u=z(e,`index.ts`),d=null;try{d=await W(u,`utf-8`)}catch{return{target:i,files:l,indexStatus:`not-found`,indexPath:u,backupDir:c}}let f=On(d,i);return f.migrated==null?{target:i,files:l,indexStatus:`skipped`,indexPath:u,indexReason:f.reason,backupDir:c}:(n||await it(u,f.migrated,`utf-8`),{target:i,files:l,indexStatus:`migrated`,indexPath:u,backupDir:c})}async function Nn(e,t){let n=await kn(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 W(e,`utf-8`);i.test(t)&&r.push(e)}return r}const Pn={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 Fn(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=Pn[a];if(!o){let e=[...Object.keys(Pn),`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 In(e){let{name:t,fields:n,modulesDir:r,repo:i=`inmemory`,tokenScope:a=`app`,style:o=`define`}=e,s=e.pluralize===!0,c=K(t),l=G(t),u=s?q(c):c,d=s?mt(l):l,f=e.pluralizeRoutes===!1?c:q(c),p=z(r,u),m=[],h=async(e,t)=>{let n=z(p,e);await D(n,t),m.push(n)};return await h(`${c}.module.ts`,Pt({pascal:l,kebab:c,plural:u,routePath:f,repo:i,style:o})),await h(`${c}.constants.ts`,Jt({pascal:l,kebab:c,fields:n})),await h(`${c}.controller.ts`,It({pascal:l,kebab:c,plural:u,pluralPascal:d,swagger:e.swagger??!1})),await h(`${c}.service.ts`,Gt({pascal:l,kebab:c})),await h(`dtos/create-${c}.dto.ts`,Ln(l,n)),await h(`dtos/update-${c}.dto.ts`,Rn(l,n)),await h(`dtos/${c}-response.dto.ts`,zn(l,n)),await h(`${c}.repository.ts`,Ht({pascal:l,kebab:c,repoType:i,dtoPrefix:`./dtos`,tokenScope:a})),await $t(r,l,u,c,o),m}function Ln(e,t){return`import { z } from 'zod'
1444
+ `}${u}`}}function En(e,t){return t===`class`?Tn(e):wn(e)}function Dn(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 On(e){let t=[];return await n(H(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=B(e,a),o;try{o=await nt(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function kn(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 $e(t,{recursive:!0});for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=B(e,a),o=B(t,a),s;try{s=await nt(i)}catch{continue}s.isDirectory()?await r(i,o):(await Qe(i,o),n++)}}}function An(e){let t=(/* @__PURE__ */ new Date()).toISOString().replaceAll(/[:.]/g,`-`);return B(e,`.kickjs`,`codemod-backups`,`${t}-modules`)}async function jn(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await On(e),s=await G(B(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=An(r),await kn(e,c));let l=[];for(let e of o){let t=En(await G(e,`utf-8`),i);t.migrated==null?l.push({path:e,status:`skipped`,reason:t.reason}):(n||await rt(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`}))}let u=B(e,`index.ts`),d=null;try{d=await G(u,`utf-8`)}catch{return{target:i,files:l,indexStatus:`not-found`,indexPath:u,backupDir:c}}let f=Dn(d,i);return f.migrated==null?{target:i,files:l,indexStatus:`skipped`,indexPath:u,indexReason:f.reason,backupDir:c}:(n||await rt(u,f.migrated,`utf-8`),{target:i,files:l,indexStatus:`migrated`,indexPath:u,backupDir:c})}async function Mn(e,t){let n=await On(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 G(e,`utf-8`);i.test(t)&&r.push(e)}return r}const Nn={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 Pn(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=Nn[a];if(!o){let e=[...Object.keys(Nn),`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 Fn(e){let{name:t,fields:n,modulesDir:r,repo:i=`inmemory`,tokenScope:a=`app`,style:o=`define`}=e,s=e.pluralize===!0,c=q(t),l=K(t),u=s?J(c):c,d=s?pt(l):l,f=e.pluralizeRoutes===!1?c:J(c),p=B(r,u),m=[],h=async(e,t)=>{let n=B(p,e);await D(n,t),m.push(n)};return await h(`${c}.module.ts`,Nt({pascal:l,kebab:c,plural:u,routePath:f,repo:i,style:o})),await h(`${c}.constants.ts`,qt({pascal:l,kebab:c,fields:n})),await h(`${c}.controller.ts`,Ft({pascal:l,kebab:c,plural:u,pluralPascal:d,swagger:e.swagger??!1})),await h(`${c}.service.ts`,Wt({pascal:l,kebab:c})),await h(`dtos/create-${c}.dto.ts`,In(l,n)),await h(`dtos/update-${c}.dto.ts`,Ln(l,n)),await h(`dtos/${c}-response.dto.ts`,Rn(l,n)),await h(`${c}.repository.ts`,Vt({pascal:l,kebab:c,repoType:i,dtoPrefix:`./dtos`,tokenScope:a})),await Qt(r,l,u,c,o),m}function In(e,t){return`import { z } from 'zod'
1445
1445
 
1446
1446
  export const create${e}Schema = z.object({
1447
1447
  ${t.map(e=>{let t=e.zodType;return` ${e.name}: ${t}${e.optional?`.optional()`:``},`}).join(`
@@ -1449,7 +1449,7 @@ ${t.map(e=>{let t=e.zodType;return` ${e.name}: ${t}${e.optional?`.optional()`:`
1449
1449
  })
1450
1450
 
1451
1451
  export type Create${e}DTO = z.infer<typeof create${e}Schema>
1452
- `}function Rn(e,t){return`import { z } from 'zod'
1452
+ `}function Ln(e,t){return`import { z } from 'zod'
1453
1453
 
1454
1454
  export const update${e}Schema = z.object({
1455
1455
  ${t.map(e=>` ${e.name}: ${e.zodType}.optional(),`).join(`
@@ -1457,14 +1457,14 @@ ${t.map(e=>` ${e.name}: ${e.zodType}.optional(),`).join(`
1457
1457
  })
1458
1458
 
1459
1459
  export type Update${e}DTO = z.infer<typeof update${e}Schema>
1460
- `}function zn(e,t){return`export interface ${e}ResponseDTO {
1460
+ `}function Rn(e,t){return`export interface ${e}ResponseDTO {
1461
1461
  id: string
1462
1462
  ${t.map(e=>` ${e.name}${e.optional?`?`:``}: ${e.tsType}`).join(`
1463
1463
  `)}
1464
1464
  createdAt: string
1465
1465
  updatedAt: string
1466
1466
  }
1467
- `}async function Bn(e){let{name:t,moduleName:n,modulesDir:r,testImport:i=`vitest`}=e,a=e.pluralize??!1,o=K(t),s=G(t),c=[],l;if(e.outDir)l=V(e.outDir);else if(n){let e=K(n),t=a?q(e):e;l=V(z(r??`src/modules`,t,`__tests__`))}else l=V(`src/__tests__`);let u=z(l,`${o}.test.ts`);return await D(u,`import { describe, it, expect, beforeEach } from '${i}'
1467
+ `}async function zn(e){let{name:t,moduleName:n,modulesDir:r,testImport:i=`vitest`}=e,a=e.pluralize??!1,o=q(t),s=K(t),c=[],l;if(e.outDir)l=H(e.outDir);else if(n){let e=q(n),t=a?J(e):e;l=H(B(r??`src/modules`,t,`__tests__`))}else l=H(`src/__tests__`);let u=B(l,`${o}.test.ts`);return await D(u,`import { describe, it, expect, beforeEach } from '${i}'
1468
1468
  import { Container } from '@forinda/kickjs'
1469
1469
 
1470
1470
  describe('${s}', () => {
@@ -1487,64 +1487,64 @@ describe('${s}', () => {
1487
1487
  expect(true).toBe(true)
1488
1488
  })
1489
1489
  })
1490
- `),c.push(u),c}function Vn(){let e=(process.env.LOG_LEVEL??process.env.KICKJS_LOG_LEVEL??``).toLowerCase();return e===`debug`||e===`trace`}var Hn=class extends Error{drifted;constructor(e){let t=e.map(e=>` ${e.id} → ${e.outFile}`).join(`
1491
- `);super(`kick typegen --check: ${e.length} generated file(s) are out of date:\n${t}\n Run \`kick typegen\` and commit the result.`),this.name=`TypegenDriftError`,this.drifted=e}};const Un=[`agents`,`claude`,`skills`,`gemini`,`copilot`,`both`,`all`];function J(e){return e.parent?.opts()?.dryRun??!1}function Y(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(`
1492
- (dry run — no files were written)`),console.log()}async function Wn(e){if(!e)try{let e=await w(process.cwd());await Fe({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)`}],Kn=/* @__PURE__ */ new Map([[`job`,`Queue processors are no longer built in — their shape belongs to whichever queue you run.
1493
- Add your own in kick.config.ts: https://kickjs.app/guide/plugin-generators.html`]]),qn=/* @__PURE__ */ new Set([...Gn.map(e=>e.name.split(` `)[0]),...Kn.keys()]);async function Jn(){console.log(`
1490
+ `),c.push(u),c}function Bn(){let e=(process.env.LOG_LEVEL??process.env.KICKJS_LOG_LEVEL??``).toLowerCase();return e===`debug`||e===`trace`}var Vn=class extends Error{drifted;constructor(e){let t=e.map(e=>` ${e.id} → ${e.outFile}`).join(`
1491
+ `);super(`kick typegen --check: ${e.length} generated file(s) are out of date:\n${t}\n Run \`kick typegen\` and commit the result.`),this.name=`TypegenDriftError`,this.drifted=e}};const Hn=[`agents`,`claude`,`skills`,`gemini`,`copilot`,`both`,`all`];function Y(e){return e.parent?.opts()?.dryRun??!1}function X(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(`
1492
+ (dry run — no files were written)`),console.log()}async function Un(e){if(!e)try{let e=await w(process.cwd());await Fe({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 Wn=[{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)`}],Gn=/* @__PURE__ */ new Map([[`job`,`Queue processors are no longer built in — their shape belongs to whichever queue you run.
1493
+ Add your own in kick.config.ts: https://kickjs.app/guide/plugin-generators.html`]]),Kn=/* @__PURE__ */ new Set([...Wn.map(e=>e.name.split(` `)[0]),...Gn.keys()]);async function qn(){console.log(`
1494
1494
  Built-in generators:
1495
- `);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 w(process.cwd()),n=ae(t?.plugins??[],t?.commands??[]),r=await Tt(process.cwd(),n.generators);if(r.generators.length>0){console.log(`
1495
+ `);let e=Math.max(...Wn.map(e=>e.name.length));for(let t of Wn)console.log(` kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await w(process.cwd()),n=ae(t?.plugins??[],t?.commands??[]),r=await wt(process.cwd(),n.generators);if(r.generators.length>0){console.log(`
1496
1496
  Plugin generators:
1497
1497
  `);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(`
1498
1498
  Failed to load:
1499
- `);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}function Yn(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 w(process.cwd()),i=T(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??Zt(i.repo);t.repo&&ne(t.repo);let s=t.pattern??r?.pattern??`rest`,c=x(t.pluralize,i),l=te(t.pluralizeRoutes,i),u=S(r,process.cwd()),d=b(N()),f=ie(N()),p=N(),m=C(p,`@forinda/kickjs-testing`,`any`)&&C(p,`supertest`,`any`),h=i.style??`define`;if(!n&&h===`define`){let e=await Nn(V(a),`define`);if(e.length>0){console.error(`\n ${A.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n ${A.dim(`Project setting:`)} modules.style: 'define' (default)\n\n ${A.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 ${A.bold(`Pick one:`)}\n 1. Migrate everything to defineModule:\n ${A.dim(`$`)} kick codemod modules --experimental --apply\n 2. Keep the class form — pin it in kick.config.ts:\n ${A.dim(`// kick.config.ts`)}\n ${A.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let g=[];for(let r of e){let e=await Qt({name:r,modulesDir:V(a),noEntity:t.entity===!1,noTests:t.tests===!1,repo:o,minimal:t.minimal,force:t.force,pattern:s,testHarness:m,testImport:re(p),dryRun:n,pluralize:c,pluralizeRoutes:l,tokenScope:u,swagger:d,schemaLib:f,style:i.style});g.push(...e)}Y(g,n),await Wn(n)}function Zn(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 Jn();return}if(!e||e.length===0){n.help();return}let a=J(i);O(a);let[o,s,...c]=e;if(o){let e=await w(process.cwd()),n=ae(e?.plugins??[],e?.commands??[]),i=await wt({generatorName:o,itemName:s??``,args:c,flags:r,cwd:process.cwd(),projectRoot:t?.projectRoot},n.generators);if(i){Y(i.files,a);return}if(o!==`module`&&qn.has(o)){let e=Kn.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 Xn(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=J(n);O(r),await Xn(e,Yn(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=J(n);O(r),Y(await cn({name:e,outDir:V(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=J(n);O(r),Y(await ln({name:e,outDir:V(t.out)}),r)}),n.command(`middleware <name>`).description(`Generate a global middleware function, typed for the configured runtime
1500
- 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=J(n);O(r);let i=await w(process.cwd()),a=T(i),o=a.dir??`src/modules`;Y(await fn({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:x(void 0,a),runtime:i?.runtime}),r)}),n.command(`guard <name>`).description(`Generate a route guard (auth, roles, etc.)
1501
- 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=J(n);O(r);let i=await w(process.cwd()),a=T(i),o=a.dir??`src/modules`;Y(await pn({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:x(void 0,a)}),r)}),n.command(`contributor <name>`).description(`Generate a Context Contributor (typed alternative to @Middleware for ctx.set)
1499
+ `);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}function Jn(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 w(process.cwd()),i=T(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??Xt(i.repo);t.repo&&ne(t.repo);let s=t.pattern??r?.pattern??`rest`,c=x(t.pluralize,i),l=te(t.pluralizeRoutes,i),u=S(r,process.cwd()),d=b(N()),f=ie(N()),p=N(),m=C(p,`@forinda/kickjs-testing`,`any`)&&C(p,`supertest`,`any`),h=i.style??`define`;if(!n&&h===`define`){let e=await Mn(H(a),`define`);if(e.length>0){console.error(`\n ${A.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n ${A.dim(`Project setting:`)} modules.style: 'define' (default)\n\n ${A.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 ${A.bold(`Pick one:`)}\n 1. Migrate everything to defineModule:\n ${A.dim(`$`)} kick codemod modules --experimental --apply\n 2. Keep the class form — pin it in kick.config.ts:\n ${A.dim(`// kick.config.ts`)}\n ${A.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let g=[];for(let r of e){let e=await Zt({name:r,modulesDir:H(a),noEntity:t.entity===!1,noTests:t.tests===!1,repo:o,minimal:t.minimal,force:t.force,pattern:s,testHarness:m,testImport:re(p),dryRun:n,pluralize:c,pluralizeRoutes:l,tokenScope:u,swagger:d,schemaLib:f,style:i.style});g.push(...e)}X(g,n),await Un(n)}function Xn(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 qn();return}if(!e||e.length===0){n.help();return}let a=Y(i);O(a);let[o,s,...c]=e;if(o){let e=await w(process.cwd()),n=ae(e?.plugins??[],e?.commands??[]),i=await Ct({generatorName:o,itemName:s??``,args:c,flags:r,cwd:process.cwd(),projectRoot:t?.projectRoot},n.generators);if(i){X(i.files,a);return}if(o!==`module`&&Kn.has(o)){let e=Gn.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=Y(n);O(r),await Yn(e,Jn(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=Y(n);O(r),X(await sn({name:e,outDir:H(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=Y(n);O(r),X(await cn({name:e,outDir:H(t.out)}),r)}),n.command(`middleware <name>`).description(`Generate a global middleware function, typed for the configured runtime
1500
+ 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=Y(n);O(r);let i=await w(process.cwd()),a=T(i),o=a.dir??`src/modules`;X(await dn({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:x(void 0,a),runtime:i?.runtime}),r)}),n.command(`guard <name>`).description(`Generate a route guard (auth, roles, etc.)
1501
+ 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=Y(n);O(r);let i=await w(process.cwd()),a=T(i),o=a.dir??`src/modules`;X(await fn({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:x(void 0,a)}),r)}),n.command(`contributor <name>`).description(`Generate a Context Contributor (typed alternative to @Middleware for ctx.set)
1502
1502
  --type http (default, RequestContext) | bare (ExecutionContext)
1503
1503
  --params "source:string,region:number" → emits the withParams<T>() form
1504
- 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=J(n);O(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 w(process.cwd()),o=T(a),s=o.dir??`src/modules`;Y(await hn({name:e,type:i,key:t.key,params:t.params,outDir:t.out,moduleName:t.module,modulesDir:s,pattern:a?.pattern,pluralize:x(void 0,o)}),r)}),n.command(`service <name>`).description(`Generate a @Service() class
1505
- 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=J(n);O(r);let i=await w(process.cwd()),a=T(i),o=a.dir??`src/modules`;Y(await gn({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:x(void 0,a)}),r)}),n.command(`controller <name>`).description(`Generate a @Controller() class with basic routes
1506
- 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=J(n);O(r);let i=await w(process.cwd()),a=T(i),o=a.dir??`src/modules`;Y(await _n({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:x(void 0,a)}),r),await Wn(r)}),n.command(`dto <name>`).description(`Generate a DTO schema for the project’s validation library
1507
- 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=J(n);O(r);let i=await w(process.cwd()),a=T(i),o=a.dir??`src/modules`;Y(await vn({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:x(void 0,a),schemaLib:ie(N())}),r)}),n.command(`test <name>`).description(`Generate a Vitest test scaffold
1508
- 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=J(n);O(r);let i=await w(process.cwd()),a=T(i),o=a.dir??`src/modules`;Y(await Bn({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pluralize:x(void 0,a),testImport:re(N())}),r)}),n.command(`scaffold <name> [fields...]`).description(`Generate a full CRUD module from field definitions
1504
+ 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=Y(n);O(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 w(process.cwd()),o=T(a),s=o.dir??`src/modules`;X(await mn({name:e,type:i,key:t.key,params:t.params,outDir:t.out,moduleName:t.module,modulesDir:s,pattern:a?.pattern,pluralize:x(void 0,o)}),r)}),n.command(`service <name>`).description(`Generate a @Service() class
1505
+ 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=Y(n);O(r);let i=await w(process.cwd()),a=T(i),o=a.dir??`src/modules`;X(await hn({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:x(void 0,a)}),r)}),n.command(`controller <name>`).description(`Generate a @Controller() class with basic routes
1506
+ 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=Y(n);O(r);let i=await w(process.cwd()),a=T(i),o=a.dir??`src/modules`;X(await gn({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:x(void 0,a)}),r),await Un(r)}),n.command(`dto <name>`).description(`Generate a DTO schema for the project’s validation library
1507
+ 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=Y(n);O(r);let i=await w(process.cwd()),a=T(i),o=a.dir??`src/modules`;X(await _n({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:x(void 0,a),schemaLib:ie(N())}),r)}),n.command(`test <name>`).description(`Generate a Vitest test scaffold
1508
+ 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=Y(n);O(r);let i=await w(process.cwd()),a=T(i),o=a.dir??`src/modules`;X(await zn({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pluralize:x(void 0,a),testImport:re(N())}),r)}),n.command(`scaffold <name> [fields...]`).description(`Generate a full CRUD module from field definitions
1509
1509
  Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
1510
1510
  Types: string, text, number, int, float, boolean, date, email, url, uuid, json, enum:a,b,c
1511
1511
  Optional: append :optional (shell-safe): description:text:optional
1512
- 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=Yn(r,n),a=J(r);O(a),t.length===0&&(console.error(`
1512
+ 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=Jn(r,n),a=Y(r);O(a),t.length===0&&(console.error(`
1513
1513
  Error: At least one field is required.
1514
1514
  Usage: kick g scaffold <name> <field:type> [field:type...]
1515
1515
  Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
1516
1516
  Optional: append :optional (shell-safe, no quoting needed)
1517
- `),process.exit(1));let o=await w(process.cwd()),s=T(o),c=i.modulesDir??s.dir??`src/modules`,l=Fn(t),u=S(o,process.cwd()),d=b(N()),f=await In({name:e,fields:l,modulesDir:V(c),noEntity:i.entity===!1,noTests:i.tests===!1,pluralize:x(i.pluralize,s),pluralizeRoutes:te(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)`:``}`);Y(f,a),await Wn(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=J(t);O(n),Y(await yn({outDir:V(`.`),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=J(t);O(n);let r=e.only??`all`;Un.includes(r)?Y(await fe({outDir:V(`.`),only:r,name:e.name,pm:e.pm,template:e.template,force:e.force}),n):(console.error(` Invalid --only value: ${r}. Expected: ${Un.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=J(n);O(r);let i;try{i=y(e.flatMap(e=>e.split(`,`))),Y(await v({dir:V(`.`),targets:i,pm:t.pm,force:t.force}),r)}catch(e){console.error(` ${e.message}`),process.exitCode=1}});for(let e of t?.generators??[])Qn(n,e,t?.projectRoot)}function Qn(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=J(o);O(s);let c=await wt({generatorName:i.name,itemName:e??``,args:r??[],flags:a,cwd:process.cwd(),projectRoot:n},[t]);c&&Y(c.files,s)})}const $n=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: `;async function er(e){let t=L.resolve(e.cwd,`.kickjs/types`);e.check||await et(t,{recursive:!0});let n=/* @__PURE__ */ new Map,r=e.scan??De,i=L.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(U(e).href)},async writeFile(t,n){let r=L.resolve(e.cwd,t);await et(L.dirname(r),{recursive:!0}),await it(r,n,`utf8`)},getScanResult:e=>{let t=tr(e),o=n.get(t);if(!o){let s={cacheDir:i,...e};o=a?Ee(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=L.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=`${$n}${n.id} */\n\n`+a+`
1518
- `,u=``;P(i)&&(u=await W(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 it(i,l,`utf8`),s.push({id:n.id,status:`written`,outFile:i}))}if(c.length>0)throw new Hn(c);return s}function tr(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 nr(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 rr=/* @__PURE__ */ e({applyDisableFilter:()=>nr,runAllPluginTypegens:()=>ir});async function ir(e){let t=[...Es,...e.config?.plugins??[]],{enabled:n,skipped:r,unknown:i}=nr(ae(t,e.config?.commands??[]).typegens,e.config?.typegen?.disable??[]);if(!e.silent&&r.length>0)for(let e of r)console.log(` ${e.id}: disabled (typegen.disable)`);if(!e.silent&&i.length>0&&console.warn(` kick typegen: disable list references unknown id(s): ${i.map(e=>`'${e}'`).join(`, `)}. Run \`kick typegen --list\` to see registered ids.`),n.length===0)return[];try{let t=await er({cwd:e.cwd,config:e.config??{},plugins:n,watch:e.watch,check:e.check,changedFiles:e.changedFiles});if(!e.silent&&Vn())for(let e of t)console.log(` ${e.id}: ${e.status}`);return t}catch(t){if(t instanceof Hn||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 ar(e){let t=/* @__PURE__ */ new Map;return{report(n,r){let i=r instanceof Error?r.message:String(r);t.get(n)!==i&&(t.set(n,i),e(` kick typegen: ${n} pass failed (${i}) — types in .kickjs/types may be stale`))},clear(e){t.delete(e)}}}const or=`__kickjs_typegen_owner`;function sr(e){let{cwd:t,config:n}=e,r=e.debounceMs??100,i=e.pipeline??{runTypegen:async e=>(await import(`./typegen-ZG4nzOUN.mjs`).then(e=>e.n)).runTypegen(e),runAllPluginTypegens:async e=>(await Promise.resolve().then(()=>rr)).runAllPluginTypegens(e),writeTypegenArtifacts:async(e,t,n)=>(await import(`./typegen-ZG4nzOUN.mjs`).then(e=>e.n)).writeTypegenArtifacts(e,t,n),buildAssets:async(e,t)=>(await import(`./build-CKmAKaJ1.mjs`).then(e=>e.n)).buildAssets(e,t)},a=n?.typegen?.schemaValidator??`zod`,o=n?.typegen?.envFile,s=L.resolve(t,n?.typegen?.outDir??`.kickjs/types`),c=n?.assetMap?Object.values(n.assetMap).map(e=>e?.src).filter(e=>typeof e==`string`&&e.length>0).map(e=>L.resolve(t,e)):[],l=!!n?.assetMap&&Object.keys(n.assetMap).length>0,u=e=>e.replaceAll(`\\`,`/`),d=c.map(u),f=e=>{let t=u(e);return d.some(e=>t===e||t.startsWith(`${e}/`))},p=ar(e.emitWarning),m=null,h=!1,g=/* @__PURE__ */ new Set,_=/* @__PURE__ */ new Set,v=!1,y=!1;function b(r,c){i.runTypegen({cwd:t,silent:!0,allowDuplicates:!0,schemaValidator:a,envFile:o,srcDir:n?.typegen?.srcDir,outDir:n?.typegen?.outDir,assetMap:n?.assetMap,changedFiles:r,runPlugins:!1}).then(()=>p.clear(`scan`)).catch(e=>p.report(`scan`,e)),i.runAllPluginTypegens({cwd:t,config:n,silent:!0,changedFiles:r,watch:!0}).then(e=>i.writeTypegenArtifacts(s,e,!0)).then(()=>p.clear(`plugins`)).catch(e=>p.report(`plugins`,e)).finally(()=>e.onPassComplete?.()),c&&n&&i.buildAssets(n,{cwd:t,silent:!0}).catch(()=>{})}function x(){let e=v?void 0:{changed:[...g],removed:[..._]},t=y;g.clear(),_.clear(),v=!1,y=!1,b(e,t)}return{assetSrcRoots:c,handleWatchEvent(e,t){if(!h&&!u(t).includes(`/.kickjs/`)){if(e===`unlinkDir`)v=!0,l&&(y=!0);else{if(t.endsWith(`.d.ts`))return;let n=/\.(ts|tsx|mts|cts)$/.test(t),r=f(t);if(!n&&!r)return;r&&l&&(y=!0),n&&(e===`unlink`?(_.add(t),g.delete(t)):(g.add(t),_.delete(t)))}m&&clearTimeout(m),m=setTimeout(x,r)}},runOnce(){h||b(void 0,l)},dispose(){h=!0,m&&clearTimeout(m),m=null}}}function cr(e){let t=process.platform===`win32`;for(let n of lr(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=z(n,i);if(P(r))return{cmd:r,args:[`--noEmit`],shell:t,kind:e}}}return null}function lr(e){let t=V(e),n=ur(t);return(n?[t,n]:[t]).map(e=>z(e,`node_modules`,`.bin`))}function ur(e){for(let t=R(e);t!==R(t);t=R(t)){let n=z(t,`pnpm-workspace.yaml`),r=z(t,`package.json`);if(P(n)||P(r))return dr(n,r).some(n=>fr(n,B(t,e)))?t:void 0}}function dr(e,t){try{if(P(e)){let t=F(e,`utf-8`).split(/^packages:\s*$/m)[1]??``,n=[];for(let e of t.split(`
1519
- `)){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(F(t,`utf-8`)),r=Array.isArray(n)?n:n?.packages;return Array.isArray(r)?r.filter(e=>typeof e==`string`):[]}catch{return[]}}function fr(e,t){let n=e.replace(/^\.\//,``).replace(/\/+$/,``).split(`/`).map(e=>e===`**`?`.*`:e.replace(/[.+^${}()|[\]\\]/g,`\\$&`).replace(/\*/g,`[^/]*`)).join(`/`);return RegExp(`^${n}$`).test(t.split(H).join(`/`))}function pr(e){let t=e.spawnFn??Ze,n=null,r=0,i=!1;return{schedule(){if(i)return;let a=++r;n&&=(n.kill(),null);let o=Date.now(),s=t(e.bin.cmd,e.bin.args,{cwd:e.cwd,shell:e.bin.shell,stdio:[`ignore`,`pipe`,`pipe`]});n=s;let c=``;s.stdout?.on(`data`,e=>{c+=e.toString()}),s.stderr?.on(`data`,e=>{c+=e.toString()}),s.on(`error`,()=>{a===r&&(n=null)}),s.on(`close`,t=>{i||a!==r||(n=null,e.onResult({ok:t===0,output:c,durationMs:Date.now()-o,kind:e.bin.kind}))})},dispose(){i=!0,n&&=(n.kill(),null)}}}function mr(e,t=12){let n=e.trim().split(/\r?\n/);return n.length<=t?n.join(`
1517
+ `),process.exit(1));let o=await w(process.cwd()),s=T(o),c=i.modulesDir??s.dir??`src/modules`,l=Pn(t),u=S(o,process.cwd()),d=b(N()),f=await Fn({name:e,fields:l,modulesDir:H(c),noEntity:i.entity===!1,noTests:i.tests===!1,pluralize:x(i.pluralize,s),pluralizeRoutes:te(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)`:``}`);X(f,a),await Un(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=Y(t);O(n),X(await vn({outDir:H(`.`),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=Y(t);O(n);let r=e.only??`all`;Hn.includes(r)?X(await fe({outDir:H(`.`),only:r,name:e.name,pm:e.pm,template:e.template,force:e.force}),n):(console.error(` Invalid --only value: ${r}. Expected: ${Hn.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=Y(n);O(r);let i;try{i=y(e.flatMap(e=>e.split(`,`))),X(await v({dir:H(`.`),targets:i,pm:t.pm,force:t.force}),r)}catch(e){console.error(` ${e.message}`),process.exitCode=1}});for(let e of t?.generators??[])Zn(n,e,t?.projectRoot)}function Zn(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=Y(o);O(s);let c=await Ct({generatorName:i.name,itemName:e??``,args:r??[],flags:a,cwd:process.cwd(),projectRoot:n},[t]);c&&X(c.files,s)})}const Qn=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: `;async function $n(e){let t=R.resolve(e.cwd,`.kickjs/types`);e.check||await $e(t,{recursive:!0});let n=/* @__PURE__ */ new Map,r=e.scan??De,i=R.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=R.resolve(e.cwd,t);await $e(R.dirname(r),{recursive:!0}),await rt(r,n,`utf8`)},getScanResult:e=>{let t=er(e),o=n.get(t);if(!o){let s={cacheDir:i,...e};o=a?Ee(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=R.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=`${Qn}${n.id} */\n\n`+a+`
1518
+ `,u=``;P(i)&&(u=await G(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 rt(i,l,`utf8`),s.push({id:n.id,status:`written`,outFile:i}))}if(c.length>0)throw new Vn(c);return s}function er(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 tr(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 nr=/* @__PURE__ */ e({applyDisableFilter:()=>tr,runAllPluginTypegens:()=>rr});async function rr(e){let t=[...Es,...e.config?.plugins??[]],{enabled:n,skipped:r,unknown:i}=tr(ae(t,e.config?.commands??[]).typegens,e.config?.typegen?.disable??[]);if(!e.silent&&r.length>0)for(let e of r)console.log(` ${e.id}: disabled (typegen.disable)`);if(!e.silent&&i.length>0&&console.warn(` kick typegen: disable list references unknown id(s): ${i.map(e=>`'${e}'`).join(`, `)}. Run \`kick typegen --list\` to see registered ids.`),n.length===0)return[];try{let t=await $n({cwd:e.cwd,config:e.config??{},plugins:n,watch:e.watch,check:e.check,changedFiles:e.changedFiles});if(!e.silent&&Bn())for(let e of t)console.log(` ${e.id}: ${e.status}`);return t}catch(t){if(t instanceof Vn||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 ir(e){let t=/* @__PURE__ */ new Map;return{report(n,r){let i=r instanceof Error?r.message:String(r);t.get(n)!==i&&(t.set(n,i),e(` kick typegen: ${n} pass failed (${i}) — types in .kickjs/types may be stale`))},clear(e){t.delete(e)}}}const ar=`__kickjs_typegen_owner`;function or(e){let{cwd:t,config:n}=e,r=e.debounceMs??100,i=e.pipeline??{runTypegen:async e=>(await import(`./typegen-DlnhNbzD.mjs`).then(e=>e.n)).runTypegen(e),runAllPluginTypegens:async e=>(await Promise.resolve().then(()=>nr)).runAllPluginTypegens(e),writeTypegenArtifacts:async(e,t,n)=>(await import(`./typegen-DlnhNbzD.mjs`).then(e=>e.n)).writeTypegenArtifacts(e,t,n),buildAssets:async(e,t)=>(await import(`./build-CChfKQA_.mjs`).then(e=>e.n)).buildAssets(e,t)},a=n?.typegen?.schemaValidator??`zod`,o=n?.typegen?.envFile,s=R.resolve(t,n?.typegen?.outDir??`.kickjs/types`),c=n?.assetMap?Object.values(n.assetMap).map(e=>e?.src).filter(e=>typeof e==`string`&&e.length>0).map(e=>R.resolve(t,e)):[],l=!!n?.assetMap&&Object.keys(n.assetMap).length>0,u=e=>e.replaceAll(`\\`,`/`),d=c.map(u),f=e=>{let t=u(e);return d.some(e=>t===e||t.startsWith(`${e}/`))},p=ir(e.emitWarning),m=null,h=!1,g=/* @__PURE__ */ new Set,_=/* @__PURE__ */ new Set,v=!1,y=!1,b=Promise.resolve();function x(e,t){b=b.then(()=>S(e,t))}function S(r,c){let l=i.runTypegen({cwd:t,silent:!0,allowDuplicates:!0,schemaValidator:a,envFile:o,srcDir:n?.typegen?.srcDir,outDir:n?.typegen?.outDir,assetMap:n?.assetMap,changedFiles:r,runPlugins:!1}).then(()=>p.clear(`scan`)).catch(e=>p.report(`scan`,e)),u=i.runAllPluginTypegens({cwd:t,config:n,silent:!0,changedFiles:r,watch:!0}).then(e=>i.writeTypegenArtifacts(s,e,!0)).then(()=>p.clear(`plugins`)).catch(e=>p.report(`plugins`,e)).finally(()=>e.onPassComplete?.());return c&&n&&i.buildAssets(n,{cwd:t,silent:!0}).catch(()=>{}),Promise.all([l,u])}function ee(){let e=v?void 0:{changed:[...g],removed:[..._]},t=y;g.clear(),_.clear(),v=!1,y=!1,x(e,t)}return{assetSrcRoots:c,handleWatchEvent(e,t){if(!h&&!u(t).includes(`/.kickjs/`)){if(e===`unlinkDir`)v=!0,l&&(y=!0);else{if(t.endsWith(`.d.ts`))return;let n=/\.(ts|tsx|mts|cts)$/.test(t),r=f(t),i=t.endsWith(`.kick`);if(!n&&!r&&!i)return;r&&l&&(y=!0),n&&(e===`unlink`?(_.add(t),g.delete(t)):(g.add(t),_.delete(t)))}m&&clearTimeout(m),m=setTimeout(ee,r)}},runOnce(){h||x(void 0,l)},dispose(){h=!0,m&&clearTimeout(m),m=null}}}function sr(e){let t=process.platform===`win32`;for(let n of cr(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=B(n,i);if(P(r))return{cmd:r,args:[`--noEmit`],shell:t,kind:e}}}return null}function cr(e){let t=H(e),n=lr(t);return(n?[t,n]:[t]).map(e=>B(e,`node_modules`,`.bin`))}function lr(e){for(let t=z(e);t!==z(t);t=z(t)){let n=B(t,`pnpm-workspace.yaml`),r=B(t,`package.json`);if(P(n)||P(r))return ur(n,r).some(n=>dr(n,V(t,e)))?t:void 0}}function ur(e,t){try{if(P(e)){let t=F(e,`utf-8`).split(/^packages:\s*$/m)[1]??``,n=[];for(let e of t.split(`
1519
+ `)){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(F(t,`utf-8`)),r=Array.isArray(n)?n:n?.packages;return Array.isArray(r)?r.filter(e=>typeof e==`string`):[]}catch{return[]}}function dr(e,t){let n=e.replace(/^\.\//,``).replace(/\/+$/,``).split(`/`).map(e=>e===`**`?`.*`:e.replace(/[.+^${}()|[\]\\]/g,`\\$&`).replace(/\*/g,`[^/]*`)).join(`/`);return RegExp(`^${n}$`).test(t.split(U).join(`/`))}function fr(e){let t=e.spawnFn??Xe,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 pr(e,t=12){let n=e.trim().split(/\r?\n/);return n.length<=t?n.join(`
1520
1520
  `):`${n.slice(0,t).join(`
1521
- `)}\n… ${n.length-t} more line(s)`}function hr(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function gr(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 _r(e,t,n={}){t&&(process.env.PORT=t);let r=hr(n.polling),i=process.cwd(),a=await w(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await Fe({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=V(i,a?.typegen?.outDir??`.kickjs/types`);try{let e=await ir({cwd:i,config:a});await Oe(c,e,!1)}catch(e){console.warn(` kick typegen: plugin pass skipped (${e?.message??e})`)}let{createRequire:l}=await import(`node:module`),u=l(V(`package.json`)).resolve(`vite`),{createServer:d}=await import(U(u).href);globalThis[or]=`kick-dev`;let f=await d({configFile:V(`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=cr(i);e?m=pr({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(mr(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=sr({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(`
1521
+ `)}\n… ${n.length-t} more line(s)`}function mr(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function hr(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 gr(e,t,n={}){t&&(process.env.PORT=t);let r=mr(n.polling),i=process.cwd(),a=await w(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await Fe({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=H(i,a?.typegen?.outDir??`.kickjs/types`);try{let e=await rr({cwd:i,config:a});await Oe(c,e,!1)}catch(e){console.warn(` kick typegen: plugin pass skipped (${e?.message??e})`)}let{createRequire:l}=await import(`node:module`),u=l(H(`package.json`)).resolve(`vite`),{createServer:d}=await import(W(u).href);globalThis[ar]=`kick-dev`;let f=await d({configFile:H(`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=sr(i);e?m=fr({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(pr(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=or({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(`
1522
1522
  KickJS dev server running (Vite + @forinda/kickjs-vite)
1523
- `),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 vr(e){let t=await w(e);try{await Fe({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=V(e,t?.typegen?.outDir??`.kickjs/types`),r=await ir({cwd:e,config:t});await Oe(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 yr(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 _r(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: ${j()} add -D vite unplugin-swc\n`):console.error(`
1523
+ `),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 _r(e){let t=await w(e);try{await Fe({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=H(e,t?.typegen?.outDir??`.kickjs/types`),r=await rr({cwd:e,config:t});await Oe(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 vr(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 gr(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: ${j()} add -D vite unplugin-swc\n`):console.error(`
1524
1524
  Dev server failed:`,e.message??e),process.exit(1)}}),e.command(`build`).description(`Build for production via Vite`).action(async()=>{console.log(`
1525
1525
  Building for production...
1526
- `);let{createRequire:e}=await import(`node:module`),t=e(V(`package.json`)).resolve(`vite`),{build:n}=await import(U(t).href);await n({configFile:V(`vite.config.ts`)});let r=await w(process.cwd()),i=r?.copyDirs??[];if(i.length>0){console.log(`
1527
- Copying directories to dist...`);for(let e of i){let t=typeof e==`string`?e:e.src,n=typeof e==`string`?z(`dist`,e):e.dest??z(`dist`,t),r=V(t),i=V(n);P(r)?(We(i,{recursive:!0}),Ue(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(`
1526
+ `);let{createRequire:e}=await import(`node:module`),t=e(H(`package.json`)).resolve(`vite`),{build:n}=await import(W(t).href);await n({configFile:H(`vite.config.ts`)});let r=await w(process.cwd()),i=r?.copyDirs??[];if(i.length>0){console.log(`
1527
+ Copying directories to dist...`);for(let e of i){let t=typeof e==`string`?e:e.src,n=typeof e==`string`?B(`dist`,e):e.dest??B(`dist`,t),r=H(t),i=H(n);P(r)?(We(i,{recursive:!0}),Ue(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(`
1528
1528
  Building asset map...`);try{await Ve(r,{cwd:process.cwd()})}catch(e){console.error(` ✗ asset build failed: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}console.log(`
1529
1529
  Build complete.
1530
1530
  `)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await w(process.cwd());if(!e?.assetMap||Object.keys(e.assetMap).length===0)console.log(` No assetMap entries — nothing to build.`);else{console.log(`
1531
1531
  Building asset map...`);try{await Ve(e,{cwd:process.cwd()}),console.log(`
1532
1532
  Asset build complete.
1533
- `)}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 n={NODE_ENV:`production`};e.port&&(n.PORT=String(e.port)),t(e.entry,n)}),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=V(process.cwd(),e.cwd??`.`);e.typegen!==!1&&await vr(t);let n=cr(t);if(!n){console.error(`
1534
- No type-checker found. Install one in this project:\n ${j(t)} add -D typescript (tsc)\n ${j(t)} add -D @typescript/native-preview (tsgo, faster)\n`),process.exit(1);return}let r=Qe(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 gr(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 _r(e.entry,e.port)}catch(e){console.error(`
1535
- Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function br(){try{let e=R(Ye(import.meta.url));return JSON.parse(F(z(e,`..`,`package.json`),`utf-8`)).version??`unknown`}catch{return`unknown`}}const xr=new Set(Object.values(f).filter(e=>e.deprecated).map(e=>e.pkg));function Sr(e){let t=z(e,`package.json`);if(!P(t))return[];let n;try{n=JSON.parse(F(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=z(e,`node_modules`,...t.split(`/`),`package.json`);if(P(i))try{n=JSON.parse(F(i,`utf-8`)).version??null}catch{}return{name:t,installed:n,declared:r[t]??null,deprecated:xr.has(t)}})}function Cr(e){let t=e;for(;;){if(P(z(t,`package.json`)))return t;let e=R(t);if(e===t)return null;t=e}}function wr(e){e.command(`info`).description(`Print system and framework info`).action(()=>{let e=[``,` KickJS CLI v${br()}`,``,` System:`,` OS: ${lt()} ${ut()} (${ct()})`,` Node: ${process.version}`],t=Cr(process.cwd()),n=t?Sr(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(`
1536
- `))})}const{bold:X,dim:Z,green:Tr,red:Er,yellow:Dr,blue:Or}=A;function kr(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 Ar(e){let t=await fetch(e,{signal:AbortSignal.timeout(5e3)});if(!t.ok)throw Error(`${t.status} ${t.statusText}`);return t.json()}async function jr(e,t){try{return await Ar(`${e}${t}`)}catch{return null}}async function Mr(e){let[t,n,r,i,a]=await Promise.all([jr(e,`/health`),jr(e,`/metrics`),jr(e,`/routes`),jr(e,`/container`),jr(e,`/ws`)]);return{health:t,metrics:n,routes:r,container:i,ws:a}}function Nr(e,t){let{health:n,metrics:r,routes:i,container:a,ws:o}=t,s=Z(`─`.repeat(60));if(console.log(),console.log(X(` KickJS Inspector`)+Z(` → ${e}`)),console.log(s),n){let e=n.status===`healthy`?Tr(`● healthy`):Er(`● `+n.status);console.log(` ${X(`Health:`)} ${e}`)}else console.log(` ${X(`Health:`)} ${Er(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?Er:r.errorRate>0?Dr:Tr;console.log(` ${X(`Uptime:`)} ${kr(r.uptimeSeconds)}`),console.log(` ${X(`Requests:`)} ${r.requests}`),console.log(` ${X(`Errors:`)} ${r.serverErrors} server, ${r.clientErrors??0} client ${Z(`(`)}${t(e+`%`)}${Z(`)`)}`)}if(a&&console.log(` ${X(`DI:`)} ${a.count} bindings`),o&&o.enabled&&console.log(` ${X(`WS:`)} ${o.connections??0} connections, ${o.namespaces??0} namespaces`),i?.routes?.length){console.log(),console.log(X(` Routes`)),console.log(s),console.log(` ${Z(`METHOD`)} ${Z(`PATH`.padEnd(36))} ${Z(`CONTROLLER`)}`);for(let e of i.routes){let t=e.path.length>36?e.path.slice(0,33)+`...`:e.path.padEnd(36);console.log(` ${ue(e.method)} ${t} ${Or(e.controller)}.${Z(e.handler)}`)}}console.log(s),console.log()}function Pr(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 Mr(r);t.json?console.log(JSON.stringify(e,null,2)):Nr(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(Er(` ✖ Could not connect to ${n}`)),console.error(Z(` ${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 Fr={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 Lr(e,t,n,i=`src/index.ts`){let a={source:e,changes:[],manual:[],blocked:!1},o=Fr[t],c=Fr[n],l=Br(zr(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=Vr(l,`runtime`),d=`${c.name}()`;if(u){let e=u.value,r=Wr(zr(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=Hr(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=Gr(a.source,o.from,o.name,i),t===`express`&&n!==`express`){let e=Ur(a.source,i);e!==a.source&&(a.source=Kr(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:`${Ir}\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 Rr(e,t,n=`kick.config.ts`){let r=zr(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=Vr(r,`runtime`);if(!i)return Hr(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 zr(e,t){return ot(e,t).program}function Br(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 Vr(e,t){return e.properties.find(e=>e.type===`Property`&&(e.key?.name??e.key?.value)===t)}function Hr(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(`
1537
- `,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=Br(zr(t,e)),r=n&&Vr(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(`
1533
+ `)}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 n={NODE_ENV:`production`};e.port&&(n.PORT=String(e.port)),t(e.entry,n)}),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=H(process.cwd(),e.cwd??`.`);e.typegen!==!1&&await _r(t);let n=sr(t);if(!n){console.error(`
1534
+ No type-checker found. Install one in this project:\n ${j(t)} add -D typescript (tsc)\n ${j(t)} add -D @typescript/native-preview (tsgo, faster)\n`),process.exit(1);return}let r=Ze(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 hr(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 gr(e.entry,e.port)}catch(e){console.error(`
1535
+ Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function yr(){try{let e=z(Je(import.meta.url));return JSON.parse(F(B(e,`..`,`package.json`),`utf-8`)).version??`unknown`}catch{return`unknown`}}const br=new Set(Object.values(f).filter(e=>e.deprecated).map(e=>e.pkg));function xr(e){let t=B(e,`package.json`);if(!P(t))return[];let n;try{n=JSON.parse(F(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=B(e,`node_modules`,...t.split(`/`),`package.json`);if(P(i))try{n=JSON.parse(F(i,`utf-8`)).version??null}catch{}return{name:t,installed:n,declared:r[t]??null,deprecated:br.has(t)}})}function Sr(e){let t=e;for(;;){if(P(B(t,`package.json`)))return t;let e=z(t);if(e===t)return null;t=e}}function Cr(e){e.command(`info`).description(`Print system and framework info`).action(()=>{let e=[``,` KickJS CLI v${yr()}`,``,` System:`,` OS: ${ct()} ${lt()} (${st()})`,` Node: ${process.version}`],t=Sr(process.cwd()),n=t?xr(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(`
1536
+ `))})}const{bold:Z,dim:Q,green:wr,red:Tr,yellow:Er,blue:Dr}=A;function Or(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 kr(e){let t=await fetch(e,{signal:AbortSignal.timeout(5e3)});if(!t.ok)throw Error(`${t.status} ${t.statusText}`);return t.json()}async function Ar(e,t){try{return await kr(`${e}${t}`)}catch{return null}}async function jr(e){let[t,n,r,i,a]=await Promise.all([Ar(e,`/health`),Ar(e,`/metrics`),Ar(e,`/routes`),Ar(e,`/container`),Ar(e,`/ws`)]);return{health:t,metrics:n,routes:r,container:i,ws:a}}function Mr(e,t){let{health:n,metrics:r,routes:i,container:a,ws:o}=t,s=Q(`─`.repeat(60));if(console.log(),console.log(Z(` KickJS Inspector`)+Q(` → ${e}`)),console.log(s),n){let e=n.status===`healthy`?wr(`● healthy`):Tr(`● `+n.status);console.log(` ${Z(`Health:`)} ${e}`)}else console.log(` ${Z(`Health:`)} ${Tr(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?Tr:r.errorRate>0?Er:wr;console.log(` ${Z(`Uptime:`)} ${Or(r.uptimeSeconds)}`),console.log(` ${Z(`Requests:`)} ${r.requests}`),console.log(` ${Z(`Errors:`)} ${r.serverErrors} server, ${r.clientErrors??0} client ${Q(`(`)}${t(e+`%`)}${Q(`)`)}`)}if(a&&console.log(` ${Z(`DI:`)} ${a.count} bindings`),o&&o.enabled&&console.log(` ${Z(`WS:`)} ${o.connections??0} connections, ${o.namespaces??0} namespaces`),i?.routes?.length){console.log(),console.log(Z(` Routes`)),console.log(s),console.log(` ${Q(`METHOD`)} ${Q(`PATH`.padEnd(36))} ${Q(`CONTROLLER`)}`);for(let e of i.routes){let t=e.path.length>36?e.path.slice(0,33)+`...`:e.path.padEnd(36);console.log(` ${ue(e.method)} ${t} ${Dr(e.controller)}.${Q(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 jr(r);t.json?console.log(JSON.stringify(e,null,2)):Mr(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(Tr(` ✖ Could not connect to ${n}`)),console.error(Q(` ${e instanceof Error?e.message:String(e)}`))),t.watch||(process.exitCode=1)}};if(t.watch){let e=async()=>{process.stdout.write(`\x1B[2J\x1B[H`),await i()};await e(),setInterval(e,5e3)}else await i()})}const Pr={express:{name:`expressRuntime`,from:`@forinda/kickjs`},fastify:{name:`fastifyRuntime`,from:`@forinda/kickjs/fastify`},h3:{name:`h3Runtime`,from:`@forinda/kickjs/h3`}},Fr=`// Express needs a body parser; Fastify and h3 parse bodies natively.`;function Ir(e,t,n,i=`src/index.ts`){let a={source:e,changes:[],manual:[],blocked:!1},o=Pr[t],c=Pr[n],l=zr(Rr(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=Br(l,`runtime`),d=`${c.name}()`;if(u){let e=u.value,r=Ur(Rr(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 https://kickjs.app/guide/http-runtimes`)}a.source=a.source.slice(0,e.start)+d+a.source.slice(e.end)}else a.source=Vr(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=Wr(a.source,o.from,o.name,i),t===`express`&&n!==`express`){let e=Hr(a.source,i);e!==a.source&&(a.source=Gr(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:`${Fr}\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 Lr(e,t,n=`kick.config.ts`){let r=Rr(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=Br(r,`runtime`);if(!i)return Vr(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 Rr(e,t){return at(e,t).program}function zr(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 Br(e,t){return e.properties.find(e=>e.type===`Property`&&(e.key?.name??e.key?.value)===t)}function Vr(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(`
1537
+ `,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 Hr(e,t){let n=zr(Rr(t,e)),r=n&&Br(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(`
1538
1538
  `,a)+1;if(/^\s*$/.test(e.slice(c,a))){a=c;let t=e.lastIndexOf(`
1539
- `,a-2)+1;e.slice(t,a-1).trim()===Ir&&(a=t);let n=e.indexOf(`
1540
- `,o);n!==-1&&/^\s*$/.test(e.slice(o,n))&&(o=n+1)}return e.slice(0,a)+e.slice(o)}function Wr(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 Gr(e,t,n,r){let i=zr(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 qr(i,a.local.name)?e:Jr(e,r,a)}return e}function Kr(e,t,n){let r=zr(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 qr(r,i.local.name)?e:Jr(e,n,i)}return e}function qr(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 Jr(e,t,n){let r=t.specifiers;if(r.length===1){let n=e[t.end]===`
1541
- `?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 Yr={express:/from ['"](express|@types\/express)['"]/,fastify:/from ['"](fastify|@fastify\/[^'"]+)['"]/,h3:/from ['"]h3['"]/},Xr=e=>e.replace(/(?<=.)@[^/]*$/,``);function Zr(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 r=process.cwd(),i=await p(r);if(!e){let e=i.fromConfig?`kick.config.ts`:`guessed from package.json`;console.log(`\n HTTP runtime: ${i.runtime} (${e})`),i.ambiguous&&console.log(` Several engines are installed: ${i.candidates.join(`, `)}.`),console.log(` Move to another with: kick runtime <express|fastify|h3>
1542
- `);return}let a;try{a=l(e)}catch{console.error(`\n Unknown engine '${e}'. Expected express, fastify or h3.\n`),process.exitCode=1;return}if(i.ambiguous&&!i.fromConfig){console.error(`\n Cannot tell which engine this app boots on now: found ${i.candidates.join(`, `)} in package.json.\n Set \`runtime: '<engine>'\` in kick.config.ts, then rerun.\n`),process.exitCode=1;return}let o=i.runtime;if(o===a){console.log(`\n Already on ${a}.\n`);return}let s=c(r,t.entry);if(!s){console.error(`\n No entry file (${t.entry??`src/index.ts or src/main.ts`}).\n`),process.exitCode=1;return}let d=[`kick.config.ts`,`kick.config.mts`,`kick.config.js`].find(e=>P(z(r,e))),f=u(r,[s,...d?[d]:[]]);if(f.length>0&&!t.force&&!t.dryRun){console.error(`\n ${f.join(`, `)} ${f.length===1?`has`:`have`} uncommitted changes. Commit or stage them first, so this change is its own diff, or rerun with --force.
1543
- `),process.exitCode=1;return}let m=Lr(F(z(r,s),`utf-8`),o,a,s);if(m.blocked){for(let e of m.manual)console.error(`\n ${e}`);console.error(`\n Nothing changed. Fix that, then rerun kick runtime ${a}.\n`),process.exitCode=1;return}let h=d?F(z(r,d),`utf-8`):void 0,g=h===void 0?null:Rr(h,a,d);g===null&&m.manual.push(`Set \`runtime: '${a}'\` in ${d??`kick.config.ts`} so kick commands know the engine.`);let _=ti(z(r,`src`)).map(e=>({file:e,text:e===z(r,s)?m.source:F(e,`utf-8`)})),v=_.some(({text:e})=>/@FileUpload\(|upload\.(single|array|none)\(/.test(e)),y=ei(r),{toAdd:b,toAddDev:x,toRemove:S,stillImported:ee}=Qr({from:o,to:a,installed:/* @__PURE__ */ new Set([...Object.keys(y.dependencies),...Object.keys(y.devDependencies)]),uploads:v,imported:e=>_.some(({text:t})=>RegExp(`from ['"]${e}(/[^'"]*)?['"]`).test(t))}),C=[];for(let{file:e,text:t}of _)t.split(`
1544
- `).forEach((t,n)=>{(Yr[o].test(t)||/\bctx\.res\./.test(t))&&C.push(`${B(r,e)}:${n+1} ${t.trim()}`)});console.log(`\n ${o} → ${a}\n`);for(let e of m.changes)console.log(` ${s}: ${e}`);if(g&&console.log(` ${d}: runtime: '${a}'`),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(`
1539
+ `,a-2)+1;e.slice(t,a-1).trim()===Fr&&(a=t);let n=e.indexOf(`
1540
+ `,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 Wr(e,t,n,r){let i=Rr(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 Kr(i,a.local.name)?e:qr(e,r,a)}return e}function Gr(e,t,n){let r=Rr(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 Kr(r,i.local.name)?e:qr(e,n,i)}return e}function Kr(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 qr(e,t,n){let r=t.specifiers;if(r.length===1){let n=e[t.end]===`
1541
+ `?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 Jr={express:/from ['"](express|@types\/express)['"]/,fastify:/from ['"](fastify|@fastify\/[^'"]+)['"]/,h3:/from ['"]h3['"]/},Yr=e=>e.replace(/(?<=.)@[^/]*$/,``);function Xr(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 r=process.cwd(),i=await p(r);if(!e){let e=i.fromConfig?`kick.config.ts`:`guessed from package.json`;console.log(`\n HTTP runtime: ${i.runtime} (${e})`),i.ambiguous&&console.log(` Several engines are installed: ${i.candidates.join(`, `)}.`),console.log(` Move to another with: kick runtime <express|fastify|h3>
1542
+ `);return}let a;try{a=l(e)}catch{console.error(`\n Unknown engine '${e}'. Expected express, fastify or h3.\n`),process.exitCode=1;return}if(i.ambiguous&&!i.fromConfig){console.error(`\n Cannot tell which engine this app boots on now: found ${i.candidates.join(`, `)} in package.json.\n Set \`runtime: '<engine>'\` in kick.config.ts, then rerun.\n`),process.exitCode=1;return}let o=i.runtime;if(o===a){console.log(`\n Already on ${a}.\n`);return}let s=c(r,t.entry);if(!s){console.error(`\n No entry file (${t.entry??`src/index.ts or src/main.ts`}).\n`),process.exitCode=1;return}let d=[`kick.config.ts`,`kick.config.mts`,`kick.config.js`].find(e=>P(B(r,e))),f=u(r,[s,...d?[d]:[]]);if(f.length>0&&!t.force&&!t.dryRun){console.error(`\n ${f.join(`, `)} ${f.length===1?`has`:`have`} uncommitted changes. Commit or stage them first, so this change is its own diff, or rerun with --force.
1543
+ `),process.exitCode=1;return}let m=Ir(F(B(r,s),`utf-8`),o,a,s);if(m.blocked){for(let e of m.manual)console.error(`\n ${e}`);console.error(`\n Nothing changed. Fix that, then rerun kick runtime ${a}.\n`),process.exitCode=1;return}let h=d?F(B(r,d),`utf-8`):void 0,g=h===void 0?null:Lr(h,a,d);g===null&&m.manual.push(`Set \`runtime: '${a}'\` in ${d??`kick.config.ts`} so kick commands know the engine.`);let _=ei(B(r,`src`)).map(e=>({file:e,text:e===B(r,s)?m.source:F(e,`utf-8`)})),v=_.some(({text:e})=>/@FileUpload\(|upload\.(single|array|none)\(/.test(e)),y=$r(r),{toAdd:b,toAddDev:x,toRemove:S,stillImported:ee}=Zr({from:o,to:a,installed:/* @__PURE__ */ new Set([...Object.keys(y.dependencies),...Object.keys(y.devDependencies)]),uploads:v,imported:e=>_.some(({text:t})=>RegExp(`from ['"]${e}(/[^'"]*)?['"]`).test(t))}),C=[];for(let{file:e,text:t}of _)t.split(`
1544
+ `).forEach((t,n)=>{(Jr[o].test(t)||/\bctx\.res\./.test(t))&&C.push(`${V(r,e)}:${n+1} ${t.trim()}`)});console.log(`\n ${o} → ${a}\n`);for(let e of m.changes)console.log(` ${s}: ${e}`);if(g&&console.log(` ${d}: runtime: '${a}'`),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(`
1545
1545
  Dry run: nothing changed.
1546
- `),$r(m.manual,C,o);return}I(z(r,s),m.source),g!==null&&I(z(r,d),g);let te=!0;if(t.install!==!1){let{pm:e}=await pe(t.pm),i=t=>{let i=[e,...t].join(` `);console.log(`\n ${i}`);try{n(e,t,{cwd:r})}catch{te=!1,console.log(` Failed. Run it yourself:\n ${i}`)}};b.length&&i([`add`,...b]),x.length&&i([`add`,`-D`,...x]),S.length&&i([e===`npm`?`uninstall`:`remove`,...S])}$r(m.manual,C,o),console.log(te?" Done. Run `kick typegen` and your typecheck to see the rest.\n":` Files changed; the package step above did not finish.
1547
- `),te||(process.exitCode=1)})}function Qr(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(Xr)),u=[...i[t],...t===`express`?[`@types/express`]:[],...h[t].prod?[h[t].prod]:[],...h[t].dev?[h[t].dev]:[]].map(Xr).filter(e=>r.has(e)&&!l.has(e)),d=u.filter(e=>o(e.replace(/^@types\//,``)));return{toAdd:s.filter(e=>!r.has(Xr(e))),toAddDev:c.filter(e=>!r.has(Xr(e))),toRemove:u.filter(e=>!d.includes(e)),stillImported:d}}function $r(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 ei(e){try{let t=JSON.parse(F(z(e,`package.json`),`utf-8`));return{dependencies:t.dependencies??{},devDependencies:t.devDependencies??{}}}catch{return{dependencies:{},devDependencies:{}}}}function ti(e){return P(e)?Ge(e,{withFileTypes:!0,recursive:!0}).filter(e=>e.isFile()&&/\.(ts|tsx|mts)$/.test(e.name)).map(e=>z(e.parentPath,e.name)):[]}function ni(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 ri=[{match(e,t){let n=ni(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
1546
+ `),Qr(m.manual,C,o);return}L(B(r,s),m.source),g!==null&&L(B(r,d),g);let te=!0;if(t.install!==!1){let{pm:e}=await pe(t.pm),i=t=>{let i=[e,...t].join(` `);console.log(`\n ${i}`);try{n(e,t,{cwd:r})}catch{te=!1,console.log(` Failed. Run it yourself:\n ${i}`)}};b.length&&i([`add`,...b]),x.length&&i([`add`,`-D`,...x]),S.length&&i([e===`npm`?`uninstall`:`remove`,...S])}Qr(m.manual,C,o),console.log(te?" Done. Run `kick typegen` and your typecheck to see the rest.\n":` Files changed; the package step above did not finish.
1547
+ `),te||(process.exitCode=1)})}function Zr(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(Yr)),u=[...i[t],...t===`express`?[`@types/express`]:[],...h[t].prod?[h[t].prod]:[],...h[t].dev?[h[t].dev]:[]].map(Yr).filter(e=>r.has(e)&&!l.has(e)),d=u.filter(e=>o(e.replace(/^@types\//,``)));return{toAdd:s.filter(e=>!r.has(Yr(e))),toAddDev:c.filter(e=>!r.has(Yr(e))),toRemove:u.filter(e=>!d.includes(e)),stillImported:d}}function Qr(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 $r(e){try{let t=JSON.parse(F(B(e,`package.json`),`utf-8`));return{dependencies:t.dependencies??{},devDependencies:t.devDependencies??{}}}catch{return{dependencies:{},devDependencies:{}}}}function ei(e){return P(e)?I(e,{withFileTypes:!0,recursive:!0}).filter(e=>e.isFile()&&/\.(ts|tsx|mts)$/.test(e.name)).map(e=>B(e.parentPath,e.name)):[]}function ti(e,t){let n=e.toLowerCase();return t.every(e=>n.includes(e.toLowerCase()))}function $(e,t){let n=e.toLowerCase();return t.some(e=>n.includes(e.toLowerCase()))}const ni=[{match(e,t){let n=ti(e,[`config`,`get`])&&$(e,[`undefined`,`null`]),r=e.includes(`@Value`)&&$(e,[`undefined`,`is not defined`]);return!n&&!r?null:$(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
1548
1548
  src/config/index.ts, and src/index.ts imports it before bootstrap().
1549
1549
  Tests never load src/index.ts — \`createTestApp\` builds the app
1550
1550
  directly — so that import does not run and ConfigService falls back to
@@ -1568,7 +1568,7 @@ import { modules } from './modules'
1568
1568
  import './config' // ← add this — registers env schema
1569
1569
  import { bootstrap } from '@forinda/kickjs'
1570
1570
  import { modules } from './modules'
1571
- `,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.
1571
+ `,docs:`https://kickjs.app/guide/configuration.html#wiring-the-schema-at-startup`}}}},{match(e,t){let n=$(e,[`vitest`,`createTestApp`,`__tests__`,`.test.`,`.spec.`]);return $(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.
1572
1572
  When vitest re-imports your modules across tests, the same class can be
1573
1573
  registered twice and the container throws. The fix is to wipe the
1574
1574
  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'
@@ -1578,7 +1578,7 @@ describe('UserController', () => {
1578
1578
  beforeEach(() => Container.reset())
1579
1579
 
1580
1580
  it('does the thing', async () => { /* ... */ })
1581
- })`,docs:`https://kickjs.app/guide/testing.html`}}:null}},{match(e,t){return e.includes(`@Module`)||ni(e,[`Module`,`is not a function`])||ni(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
1581
+ })`,docs:`https://kickjs.app/guide/testing.html`}}:null}},{match(e,t){return e.includes(`@Module`)||ti(e,[`Module`,`is not a function`])||ti(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
1582
1582
  pattern instead: a class implements AppModule and exposes routes() that
1583
1583
  returns the controller wiring. This was a deliberate choice — modules
1584
1584
  become explicit values rather than metadata, which makes them easier to
@@ -1605,7 +1605,7 @@ KickRoutes["POST /users"]. The new form is per-controller, per-method,
1605
1605
  and matches the actual class names so refactors propagate via
1606
1606
  rename-symbol instead of grep.`,fix:`Update the Ctx<...> type parameter to use the namespace form:`,codeBefore:`@Post('/', { body: createUserSchema })
1607
1607
  create(ctx: Ctx<KickRoutes['POST /users']>) { /* ... */ }`,codeAfter:`@Post('/', { body: createUserSchema, name: 'CreateUser' })
1608
- 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
1608
+ create(ctx: Ctx<KickRoutes.UserController['create']>) { /* ... */ }`,docs:`https://kickjs.app/guide/typegen.html`}}:null}},{match(e,t){let n=$(e,[`cluster`,`workers`,`two ports`,`duplicate server`]),r=$(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
1609
1609
  cluster: { workers: N }, the framework forks N workers, each of which
1610
1610
  spins up its own Vite instance on a separate port. The fix landed in
1611
1611
  v2.2.5: McpAdapter (and bootstrap()) now detects Vite dev mode and
@@ -1613,7 +1613,7 @@ silently skips cluster, with a warning. If you see this on an older
1613
1613
  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({
1614
1614
  modules,
1615
1615
  cluster: process.env.NODE_ENV === 'production' ? { workers: 4 } : false,
1616
- })`,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
1616
+ })`,docs:`https://kickjs.app/guide/cluster.html`}}}},{match(e,t){return $(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
1617
1617
  reflect-metadata polyfill. The polyfill must be imported once,
1618
1618
  before any decorator runs. Most projects do this at the top of
1619
1619
  src/index.ts; missing the import causes obscure "design:paramtypes"
@@ -1622,7 +1622,7 @@ import './config'
1622
1622
  import { bootstrap } from '@forinda/kickjs'
1623
1623
  import { modules } from './modules'
1624
1624
 
1625
- 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
1625
+ export const app = await bootstrap({ modules })`,docs:`https://kickjs.app/guide/dependency-injection.html`}}:null}},{match(e,t){return $(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
1626
1626
  generated a module via \`kick g module foo\` but the routes don't appear,
1627
1627
  the most likely cause is that the module is missing from the exported
1628
1628
  array. The CLI usually wires this automatically, but a hand-edit can
@@ -1630,7 +1630,7 @@ drop the entry.`,fix:`Open src/modules/index.ts and verify the module is in the
1630
1630
  import { UserModule } from './users/user.module'
1631
1631
  import { TaskModule } from './tasks/task.module' // ← was this missing?
1632
1632
 
1633
- 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\`.
1633
+ export const modules: AppModuleEntry[] = [UserModule(), TaskModule()]`,docs:`https://kickjs.app/guide/project-structure.html`}}:null}},{match(e,t){if(!$(e,[`vitest`,`test`,`spec`,`__tests__`,`.test.`,`jest`]))return null;let n=$(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=$(e,[`stubenv`,`process.env`,`setupfiles`,`test.env`,`env override`])&&$(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\`.
1634
1634
  That protects the vars your test runner pinned — but every var it did NOT
1635
1635
  pin is silently backfilled from your \`.env\`. So a suite can pin its database
1636
1636
  URL and still reach live development services through the vars it forgot,
@@ -1664,7 +1664,7 @@ beforeAll(() => {
1664
1664
  vi.stubEnv('JWT_SECRET', 'x'.repeat(32))
1665
1665
  resetEnvCache()
1666
1666
  loadEnv(envSchema)
1667
- })`,docs:`https://kickjs.app/guide/testing.html#environment-isolation`}}}},{match(e,t){let n=ni(e,[`cannot inject`,`request-scoped`,`singleton`]),r=ni(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
1667
+ })`,docs:`https://kickjs.app/guide/testing.html#environment-isolation`}}}},{match(e,t){let n=ti(e,[`cannot inject`,`request-scoped`,`singleton`]),r=ti(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
1668
1668
  the first time the container resolves it. A REQUEST-scoped binding is the
1669
1669
  opposite — one instance per request, discarded when the response ends.
1670
1670
 
@@ -1685,7 +1685,7 @@ and the singleton never captures one.
1685
1685
 
1686
1686
  If the dependency did not need request scope in the first place, the
1687
1687
  other direction also works — make it SINGLETON and pass the per-request
1688
- 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=ni(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
1688
+ 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=ti(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
1689
1689
  is requested while it is already being resolved further up the stack, the
1690
1690
  graph has a cycle and there is no order that satisfies both ends.
1691
1691
 
@@ -1717,7 +1717,7 @@ export class OrderService {
1717
1717
  @Service()
1718
1718
  export class BillingService {
1719
1719
  @Autowired() private readonly orders!: OrderService // ← resolved after construction
1720
- }`,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 —
1720
+ }`,docs:`https://kickjs.app/guide/dependency-injection.html#circular-dependency-detection`}}}},{match(e,t){let n=e.includes(`KICK001`),r=$(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 —
1721
1721
  and a class is only loaded if something imports it. A module that is not
1722
1722
  in the bootstrap array is never imported, so none of its @Service /
1723
1723
  @Repository / @Controller classes ever register, and the first thing that
@@ -1743,7 +1743,7 @@ export const TenantModule = defineModule({
1743
1743
  },
1744
1744
  routes: () => null,
1745
1745
  }),
1746
- })`,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=ni(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
1746
+ })`,docs:`https://kickjs.app/guide/dependency-injection.html#registering-services`}}}},{match(e,t){if(!$(e,[`vite`,`kick dev`,`dev server`,`localhost:5173`,`:5173`])||!$(e,[`404`,`not found`,`cannot get`,`cannot post`,`no route`]))return null;let n=ti(e,[`app`,`export`]),r=$(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
1747
1747
  and reads \`app\` off it, then hands each request to that instance.
1748
1748
 
1749
1749
  When the entry runs \`await bootstrap(...)\` without assigning the result to
@@ -1759,23 +1759,23 @@ import { bootstrap } from '@forinda/kickjs'
1759
1759
  await bootstrap({ modules }) // ← nothing for the dev server to read`,codeAfter:`import './env'
1760
1760
  import { bootstrap } from '@forinda/kickjs'
1761
1761
 
1762
- export const app = await bootstrap({ modules })`,docs:`https://kickjs.app/guide/project-structure.html`}}}}];function ii(e,t){let n=null;for(let r of ri){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 ai(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.
1762
+ export const app = await bootstrap({ modules })`,docs:`https://kickjs.app/guide/project-structure.html`}}}}];function ri(e,t){let n=null;for(let r of ni){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 ii(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.
1763
1763
  export OPENAI_API_KEY="sk-..."
1764
1764
 
1765
1765
  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:
1766
1766
  kick add ai
1767
1767
 
1768
1768
  Or manually:
1769
- ${j()} add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=oi(e.cwd),s=`Error or stack trace:\n\n${e.input.trim()}`;try{let e=si((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 oi(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(`
1770
- `)}function si(e){let t=[e,ci(e),li(e)].filter(e=>e!==null);for(let e of t)try{let t=JSON.parse(e);if(ui(t))return t}catch{continue}return null}function ci(e){let t=e.match(/```(?:json)?\s*\n([\s\S]*?)```/);return t?t[1]?.trim()??null:null}function li(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 ui(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 di(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 mi(e,t.message);n&&n.trim().length!==0||(process.stderr.write(`Error: no input provided.
1769
+ ${j()} add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=ai(e.cwd),s=`Error or stack trace:\n\n${e.input.trim()}`;try{let e=oi((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 ai(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(`
1770
+ `)}function oi(e){let t=[e,si(e),ci(e)].filter(e=>e!==null);for(let e of t)try{let t=JSON.parse(e);if(li(t))return t}catch{continue}return null}function si(e){let t=e.match(/```(?:json)?\s*\n([\s\S]*?)```/);return t?t[1]?.trim()??null:null}function ci(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 li(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 ui(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 pi(e,t.message);n&&n.trim().length!==0||(process.stderr.write(`Error: no input provided.
1771
1771
 
1772
1772
  Pass a message as a positional arg, --message flag, or pipe via stdin:
1773
1773
  kick explain "config.get returned undefined"
1774
- ${ee(j(),`test`)} 2>&1 | kick explain\n`),process.exit(1));let r=gi(),i=ii(n,r);if(t.json&&i){process.stdout.write(JSON.stringify({matched:!0,...i},null,2)+`
1775
- `);return}if(i){_i(n,i.diagnosis,i.confidence);return}t.ai||(t.json&&(process.stdout.write(JSON.stringify({matched:!1},null,2)+`
1776
- `),process.exit(2)),vi(n),process.exit(2));let a=await ai({input:n,model:t.model,cwd:r.cwd});t.json&&(process.stdout.write(JSON.stringify(fi(a),null,2)+`
1777
- `),process.exit(a.kind===`ok`?0:2)),pi(n,a),process.exit(a.kind===`ok`?0:2)})}function fi(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 pi(e,t){t.kind===`ok`?_i(e,t.diagnosis,-1,!0):t.kind===`unavailable`?(process.stdout.write(`\n Explaining: ${bi(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback unavailable: ${t.reason}\n\n`),process.stdout.write(`${yi(t.suggestion,` `)}\n\n`)):(process.stdout.write(`\n Explaining: ${bi(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback error: ${t.message}\n\n`))}async function mi(e,t){return e&&e.trim().length>0?e:t&&t.trim().length>0?t:process.stdin.isTTY?``:hi()}function hi(){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 gi(){let e=process.cwd();return{cwd:e,hasFile:t=>P(V(e,t))}}function _i(e,t,n,r=!1){let i=bi(e.trim(),200),a=r?`AI-generated — verify before applying`:xi(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${yi(t.explanation,` `)}\n`),process.stdout.write(`\n Fix:\n${yi(t.fix,` `)}\n`),t.codeBefore&&process.stdout.write(`\n Before:\n${yi(t.codeBefore,` `)}\n`),t.codeAfter&&process.stdout.write(`\n After:\n${yi(t.codeAfter,` `)}\n`),t.docs&&process.stdout.write(`\n Docs: ${t.docs}\n`),process.stdout.write(`
1778
- `)}function vi(e){let t=bi(e.trim(),200);process.stdout.write(`\n Explaining: ${t}\n\n`),process.stdout.write(` No known-issue matched. Things you can try:
1774
+ ${ee(j(),`test`)} 2>&1 | kick explain\n`),process.exit(1));let r=hi(),i=ri(n,r);if(t.json&&i){process.stdout.write(JSON.stringify({matched:!0,...i},null,2)+`
1775
+ `);return}if(i){gi(n,i.diagnosis,i.confidence);return}t.ai||(t.json&&(process.stdout.write(JSON.stringify({matched:!1},null,2)+`
1776
+ `),process.exit(2)),_i(n),process.exit(2));let a=await ii({input:n,model:t.model,cwd:r.cwd});t.json&&(process.stdout.write(JSON.stringify(di(a),null,2)+`
1777
+ `),process.exit(a.kind===`ok`?0:2)),fi(n,a),process.exit(a.kind===`ok`?0:2)})}function di(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 fi(e,t){t.kind===`ok`?gi(e,t.diagnosis,-1,!0):t.kind===`unavailable`?(process.stdout.write(`\n Explaining: ${yi(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback unavailable: ${t.reason}\n\n`),process.stdout.write(`${vi(t.suggestion,` `)}\n\n`)):(process.stdout.write(`\n Explaining: ${yi(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback error: ${t.message}\n\n`))}async function pi(e,t){return e&&e.trim().length>0?e:t&&t.trim().length>0?t:process.stdin.isTTY?``:mi()}function mi(){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 hi(){let e=process.cwd();return{cwd:e,hasFile:t=>P(H(e,t))}}function gi(e,t,n,r=!1){let i=yi(e.trim(),200),a=r?`AI-generated — verify before applying`:bi(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${vi(t.explanation,` `)}\n`),process.stdout.write(`\n Fix:\n${vi(t.fix,` `)}\n`),t.codeBefore&&process.stdout.write(`\n Before:\n${vi(t.codeBefore,` `)}\n`),t.codeAfter&&process.stdout.write(`\n After:\n${vi(t.codeAfter,` `)}\n`),t.docs&&process.stdout.write(`\n Docs: ${t.docs}\n`),process.stdout.write(`
1778
+ `)}function _i(e){let t=yi(e.trim(),200);process.stdout.write(`\n Explaining: ${t}\n\n`),process.stdout.write(` No known-issue matched. Things you can try:
1779
1779
 
1780
1780
  1. Check the framework docs for the error keywords:
1781
1781
  https://kickjs.app/
@@ -1787,10 +1787,10 @@ Pass a message as a positional arg, --message flag, or pipe via stdin:
1787
1787
  3. File an issue with the error text:
1788
1788
  https://github.com/forinda/kick-js/issues/new
1789
1789
 
1790
- `)}function yi(e,t){return e.split(`
1790
+ `)}function vi(e,t){return e.split(`
1791
1791
  `).map(e=>`${t}${e}`).join(`
1792
- `)}function bi(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function xi(e){return e>=90?`high confidence`:e>=70?`good match`:e>=50?`medium confidence`:`low confidence — verify manually`}function Si(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(Ci),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(wi)}function Ci(e){let t=V(e.entry);P(t)||(process.stderr.write(`Error: entry file not found: ${t}\n\nBuild the app first with \`kick build\`, or pass a custom entry:\n kick mcp -e dist/server.js\n`),process.exit(1));let n=[...e.nodeArg??[],t],r=Ze(process.execPath,n,{stdio:`inherit`,env:{...process.env,KICK_MCP_STDIO:`1`,NODE_ENV:process.env.NODE_ENV??`production`}});r.on(`error`,e=>{process.stderr.write(`Failed to start MCP server: ${e.message}\n`),process.exit(1)}),r.on(`exit`,(e,t)=>{t?process.kill(process.pid,t):process.exit(e??0)});let i=e=>{r.killed||r.kill(e)};process.on(`SIGINT`,()=>i(`SIGINT`)),process.on(`SIGTERM`,()=>i(`SIGTERM`))}function wi(e){let t=process.cwd(),n=Ti(t)??Je(t),r=e.name??n,i=e.global?V(process.env.HOME??`.`,`.mcp.json`):V(t,e.out),a={command:`kick`,args:[`mcp`],cwd:t},o={mcpServers:{}};if(P(i))try{let e=F(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,I(i,JSON.stringify(o,null,2)+`
1793
- `,`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 Ti(e){let t=V(e,`package.json`);if(!P(t))return null;try{let e=F(t,`utf8`),n=JSON.parse(e);return typeof n.name==`string`?n.name:null}catch{return null}}function Ei(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=V(t,e.entry);P(n)||(console.error(`\n Error: ${e.entry} not found.\n`),process.exit(1));let r=Oi(t,`tsx`);r||(console.error(`\n Error: tsx not found. Install it: ${j(t)} add -D tsx\n`),process.exit(1));let i=Di(n,e.entry),a=z(t,`.kick-tinker.mjs`),{writeFileSync:o,unlinkSync:s}=await import(`node:fs`);o(a,i,`utf-8`);try{let e=Xe(a,[],{cwd:t,execPath:r,stdio:`inherit`});await new Promise(t=>{e.on(`exit`,()=>t())})}finally{try{s(a)}catch{}}})}function Di(e,t){return`
1792
+ `)}function yi(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function bi(e){return e>=90?`high confidence`:e>=70?`good match`:e>=50?`medium confidence`:`low confidence — verify manually`}function xi(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(Si),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(Ci)}function Si(e){let t=H(e.entry);P(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=Xe(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 Ci(e){let t=process.cwd(),n=wi(t)??qe(t),r=e.name??n,i=e.global?H(process.env.HOME??`.`,`.mcp.json`):H(t,e.out),a={command:`kick`,args:[`mcp`],cwd:t},o={mcpServers:{}};if(P(i))try{let e=F(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,L(i,JSON.stringify(o,null,2)+`
1793
+ `,`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 wi(e){let t=H(e,`package.json`);if(!P(t))return null;try{let e=F(t,`utf8`),n=JSON.parse(e);return typeof n.name==`string`?n.name:null}catch{return null}}function Ti(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=H(t,e.entry);P(n)||(console.error(`\n Error: ${e.entry} not found.\n`),process.exit(1));let r=Di(t,`tsx`);r||(console.error(`\n Error: tsx not found. Install it: ${j(t)} add -D tsx\n`),process.exit(1));let i=Ei(n,e.entry),a=B(t,`.kick-tinker.mjs`),{writeFileSync:o,unlinkSync:s}=await import(`node:fs`);o(a,i,`utf-8`);try{let e=Ye(a,[],{cwd:t,execPath:r,stdio:`inherit`});await new Promise(t=>{e.on(`exit`,()=>t())})}finally{try{s(a)}catch{}}})}function Ei(e,t){return`
1794
1794
  import 'reflect-metadata'
1795
1795
 
1796
1796
  // Prevent bootstrap() from starting the HTTP server
@@ -1815,7 +1815,7 @@ try {
1815
1815
 
1816
1816
  // Load entry to trigger decorator registration
1817
1817
  try {
1818
- await import('${U(e).href}')
1818
+ await import('${W(e).href}')
1819
1819
  } catch (err) {
1820
1820
  console.warn(' Warning: ' + err.message)
1821
1821
  console.warn(' Container may be partially initialized.\\n')
@@ -1844,58 +1844,58 @@ server.on('exit', () => {
1844
1844
  console.log('\\n Goodbye!\\n')
1845
1845
  process.exit(0)
1846
1846
  })
1847
- `}function Oi(e,t){for(let n of lr(e)){let e=z(n,t);if(P(e))return e}return null}function ki(e,t){let n=RegExp(`^\\s*${Ot(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]!==`
1847
+ `}function Di(e,t){for(let n of cr(e)){let e=B(n,t);if(P(e))return e}return null}function Oi(e,t){let n=RegExp(`^\\s*${Dt(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]!==`
1848
1848
  `;)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]===`
1849
- `);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t}else i=s+1}return{content:a,changed:r}}function Ai(e,t){let n=tn(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=ki(a,t).content,a=a.replace(RegExp(`\\s*,?\\s*${Ot(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 ji(e){let{name:t,modulesDir:n,force:r}=e,i=e.pluralize===!0,a=K(t),o=G(t),s=i?q(a):a;s!==a&&!await _e(z(n,s))&&await _e(z(n,a))&&(s=a);let c=z(n,s);if(!await _e(c)){console.log(`\n Module not found: ${c}\n`);return}if(!r&&!await he({message:A.red(`Delete module '${s}' at ${c}? This cannot be undone.`),initialValue:!1})){console.log(`
1849
+ `);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t}else i=s+1}return{content:a,changed:r}}function ki(e,t){let n=en(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=Oi(a,t).content,a=a.replace(RegExp(`\\s*,?\\s*${Dt(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 Ai(e){let{name:t,modulesDir:n,force:r}=e,i=e.pluralize===!0,a=q(t),o=K(t),s=i?J(a):a;s!==a&&!await _e(B(n,s))&&await _e(B(n,a))&&(s=a);let c=B(n,s);if(!await _e(c)){console.log(`\n Module not found: ${c}\n`);return}if(!r&&!await he({message:A.red(`Delete module '${s}' at ${c}? This cannot be undone.`),initialValue:!1})){console.log(`
1850
1850
  Cancelled.
1851
- `);return}await nt(c,{recursive:!0,force:!0}),console.log(` Deleted: ${c}`);let l=z(n,`index.ts`);if(await _e(l)){let e=await W(l,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${Ot(o)}Module\\s*\\}\\s*from\\s*['"][^'"]*${Ot(s)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=Ai(e,o),e=e.replace(/\n{3,}/g,`
1851
+ `);return}await tt(c,{recursive:!0,force:!0}),console.log(` Deleted: ${c}`);let l=B(n,`index.ts`);if(await _e(l)){let e=await G(l,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${Dt(o)}Module\\s*\\}\\s*from\\s*['"][^'"]*${Dt(s)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=ki(e,o),e=e.replace(/\n{3,}/g,`
1852
1852
 
1853
- `),e!==t&&(await D(l,e),console.log(` Unregistered: ${o}Module from ${l}`))}console.log(`\n Module '${s}' removed.\n`)}function Mi(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 w(process.cwd()),r=T(n),i=t.modulesDir??r.dir??`src/modules`,a=x(t.pluralize,r);for(let n of e)await ji({name:n,modulesDir:V(i),force:t.force,pluralize:a})})}function Ni(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 Pi(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function Fi(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=N(process.cwd()),n=await w(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-P1F0k7kH.mjs`).then(e=>e.t),{builtinCliPlugins:t}=await Promise.resolve().then(()=>Ts),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(`
1853
+ `),e!==t&&(await D(l,e),console.log(` Unregistered: ${o}Module from ${l}`))}console.log(`\n Module '${s}' removed.\n`)}function ji(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 w(process.cwd()),r=T(n),i=t.modulesDir??r.dir??`src/modules`,a=x(t.pluralize,r);for(let n of e)await Ai({name:n,modulesDir:H(i),force:t.force,pluralize:a})})}function Mi(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 Ni(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function Pi(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=N(process.cwd()),n=await w(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-DxXeitAU.mjs`).then(e=>e.t),{builtinCliPlugins:t}=await Promise.resolve().then(()=>Ts),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(`
1854
1854
  Registered typegen plugins:
1855
1855
  `);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(`
1856
1856
  Disable one in kick.config.ts:
1857
1857
  `),console.log(` typegen: { disable: ['`+(r.typegens[0]?.id??`kick/x`)+`'] }
1858
- `);return}let r=Ni(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=Pi(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 Ne(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 Fe(a);let r=await ir({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=V(t,e.out??n?.typegen?.outDir??`.kickjs/types`);await Oe(i,r,e.silent??!1)}}}catch(e){e instanceof Pe?console.error(`
1858
+ `);return}let r=Mi(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=Ni(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 Ne(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 Fe(a);let r=await rr({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=H(t,e.out??n?.typegen?.outDir??`.kickjs/types`);await Oe(i,r,e.silent??!1)}}}catch(e){e instanceof Pe?console.error(`
1859
1859
  `+e.message+`
1860
- `):e instanceof Hn?console.error(`
1860
+ `):e instanceof Vn?console.error(`
1861
1861
  `+e.message+`
1862
- `):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}const Ii=/* @__PURE__ */ new Set([`Service`,`Injectable`,`Component`,`Repository`]);function Li(e,t){return typeof t==`number`?e.slice(0,t).split(`
1863
- `).length:1}function Ri(e){let t=ve(e);if(t===`singleton`||t===`transient`||t===`request`)return t;if(ye(e)&&e.type===`MemberExpression`&&ze(e.object)===`Scope`){let t=ze(e.property);if(t===`SINGLETON`)return`singleton`;if(t===`TRANSIENT`)return`transient`;if(t===`REQUEST`)return`request`}return`unknown`}function zi(e){let t=ze(e);if(t)return{key:`id:${t}`,label:t};let n=ve(e);return n===null?null:{key:`lit:${n}`,label:`'${n}'`}}function Bi(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=Le(e).map(be).find(e=>e?.name===`Inject`),a=null;if(i)a=zi(i.call.arguments?.[0]);else{let e=n?.typeAnnotation?.typeAnnotation??null;e?.type===`TSTypeReference`&&(a=zi(e.typeName))}a&&r.push({...a,line:Li(t,e.start)})}return r}function Vi(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=ot(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`)&&ye(n.declaration)?n.declaration:n;if(e.type===`ClassDeclaration`&&a(ze(e.id),t),e.type===`VariableDeclaration`)for(let n of e.declarations??[])a(ze(n.id),t)}Re(e,e=>{if(e.type===`ClassDeclaration`){let a=ze(e.id);if(!a)return;for(let o of Le(e)){let s=be(o);if(s){if(s.name===`Controller`){i(`id:${a}`,`singleton`),r.push({name:a,kind:`controller`,file:t,params:Bi(e,n)});return}if(Ii.has(s.name)){let o=Se(Be(s.call),`scope`),c=o?Ri(o):`singleton`;i(`id:${a}`,c),r.push({name:a,kind:`other`,file:t,params:Bi(e,n)});return}}}return}if(e.type!==`CallExpression`)return;let a=e.callee;if(!ye(a)||a.type!==`MemberExpression`)return;let o=ze(a.property);if(o!==`register`&&o!==`registerFactory`)return;let s=e.arguments??[];if(s.length<2)return;let c=zi(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 Hi(e){let t=[];if(!P(e))return t;let n=Ge(e,{withFileTypes:!0});for(let r of n){let n=z(e,r.name);if(r.isDirectory()){if([`node_modules`,`dist`,`.kickjs`,`.git`].includes(r.name))continue;t.push(...Hi(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function Ui(e){try{return F(e,`utf-8`)}catch{return``}}const Wi=/* @__PURE__ */ new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function Gi(e,t){let n=Ui(z(e,`.env`));if(n){let e=n.match(/^JWT_SECRET\s*=\s*['"]?([^'"\n]*)['"]?/m);if(e){let t=e[1].trim();if(Wi.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 Ki(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 qi(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 Ji(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function Yi(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 Xi(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 Zi(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 Qi(e){let t=Hi(z(e,`src`)).map(e=>Ui(e)),n=[],r=Gi(e,t);r&&n.push(r);let i=Ki(t);i&&n.push(i);let a=qi(t);a&&n.push(a);let o=Ji();o&&n.push(o);let s=Yi(t);return s&&n.push(s),n.push(Xi(t)),n.push(Zi(t)),n}function $i(e){let t=Vi(Hi(z(e,`src`)).filter(e=>!/\.(test|spec)\.tsx?$/.test(e)).map(t=>({path:B(e,t).split(`\\`).join(`/`),source:Ui(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 ea(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(`
1862
+ `):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}const Fi=/* @__PURE__ */ new Set([`Service`,`Injectable`,`Component`,`Repository`]);function Ii(e,t){return typeof t==`number`?e.slice(0,t).split(`
1863
+ `).length:1}function Li(e){let t=ve(e);if(t===`singleton`||t===`transient`||t===`request`)return t;if(ye(e)&&e.type===`MemberExpression`&&ze(e.object)===`Scope`){let t=ze(e.property);if(t===`SINGLETON`)return`singleton`;if(t===`TRANSIENT`)return`transient`;if(t===`REQUEST`)return`request`}return`unknown`}function Ri(e){let t=ze(e);if(t)return{key:`id:${t}`,label:t};let n=ve(e);return n===null?null:{key:`lit:${n}`,label:`'${n}'`}}function zi(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=Le(e).map(be).find(e=>e?.name===`Inject`),a=null;if(i)a=Ri(i.call.arguments?.[0]);else{let e=n?.typeAnnotation?.typeAnnotation??null;e?.type===`TSTypeReference`&&(a=Ri(e.typeName))}a&&r.push({...a,line:Ii(t,e.start)})}return r}function Bi(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=at(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`)&&ye(n.declaration)?n.declaration:n;if(e.type===`ClassDeclaration`&&a(ze(e.id),t),e.type===`VariableDeclaration`)for(let n of e.declarations??[])a(ze(n.id),t)}Re(e,e=>{if(e.type===`ClassDeclaration`){let a=ze(e.id);if(!a)return;for(let o of Le(e)){let s=be(o);if(s){if(s.name===`Controller`){i(`id:${a}`,`singleton`),r.push({name:a,kind:`controller`,file:t,params:zi(e,n)});return}if(Fi.has(s.name)){let o=Se(Be(s.call),`scope`),c=o?Li(o):`singleton`;i(`id:${a}`,c),r.push({name:a,kind:`other`,file:t,params:zi(e,n)});return}}}return}if(e.type!==`CallExpression`)return;let a=e.callee;if(!ye(a)||a.type!==`MemberExpression`)return;let o=ze(a.property);if(o!==`register`&&o!==`registerFactory`)return;let s=e.arguments??[];if(s.length<2)return;let c=Ri(s[0]);c&&i(c.key,s.length>=3?Li(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 Vi(e){let t=[];if(!P(e))return t;let n=I(e,{withFileTypes:!0});for(let r of n){let n=B(e,r.name);if(r.isDirectory()){if([`node_modules`,`dist`,`.kickjs`,`.git`].includes(r.name))continue;t.push(...Vi(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function Hi(e){try{return F(e,`utf-8`)}catch{return``}}const Ui=/* @__PURE__ */ new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function Wi(e,t){let n=Hi(B(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 Gi(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 Ki(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 qi(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function Ji(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 Yi(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 Xi(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 Zi(e){let t=Vi(B(e,`src`)).map(e=>Hi(e)),n=[],r=Wi(e,t);r&&n.push(r);let i=Gi(t);i&&n.push(i);let a=Ki(t);a&&n.push(a);let o=qi();o&&n.push(o);let s=Ji(t);return s&&n.push(s),n.push(Yi(t)),n.push(Xi(t)),n}function Qi(e){let t=Bi(Vi(B(e,`src`)).filter(e=>!/\.(test|spec)\.tsx?$/.test(e)).map(t=>({path:V(e,t).split(`\\`).join(`/`),source:Hi(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 $i(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(`
1864
1864
  Usage: kick check [--deploy] [--di]
1865
1865
 
1866
1866
  Available checks:
1867
1867
  --deploy Audit for production readiness (security, config, best practices)
1868
1868
  --di Find REQUEST-scoped dependencies injected into singleton constructors
1869
- `);return}let t=process.cwd();ce(e.deploy?`KickJS Deploy Check`:`KickJS DI Check`);let n=me();n.start(`Scanning project...`);let r=[...e.deploy?Qi(t):[],...e.di?$i(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)M.message(`${oe(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?A.red(`${a} critical`):`${a} critical`,o>0?A.yellow(`${o} ${c}`):`${o} ${c}`,`${s} info`].join(`, `);a>0?(k(A.red(`${l} — fix critical issues before deploying`)),process.exit(1)):k(A.green(`${l} — looking good!`))})}function ta(e){try{return JSON.parse(F(e,`utf-8`))}catch{return null}}function na(e){try{return F(e,`utf-8`)}catch{return null}}const ra=[`include`,`exclude`];function ia(e){let t=``;for(let n=0;n<e.length;n++){let r=e[n];if(r===`"`){let r=n;for(n++;n<e.length&&e[n]!==`"`;n++)e[n]===`\\`&&n++;t+=e.slice(r,n+1)}else if(r===`/`&&e[n+1]===`/`){for(;n<e.length&&e[n]!==`
1869
+ `);return}let t=process.cwd();ce(e.deploy?`KickJS Deploy Check`:`KickJS DI Check`);let n=me();n.start(`Scanning project...`);let r=[...e.deploy?Zi(t):[],...e.di?Qi(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)M.message(`${oe(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?A.red(`${a} critical`):`${a} critical`,o>0?A.yellow(`${o} ${c}`):`${o} ${c}`,`${s} info`].join(`, `);a>0?(k(A.red(`${l} — fix critical issues before deploying`)),process.exit(1)):k(A.green(`${l} — looking good!`))})}function ea(e){try{return JSON.parse(F(e,`utf-8`))}catch{return null}}function ta(e){try{return F(e,`utf-8`)}catch{return null}}const na=[`include`,`exclude`];function ra(e){let t=``;for(let n=0;n<e.length;n++){let r=e[n];if(r===`"`){let r=n;for(n++;n<e.length&&e[n]!==`"`;n++)e[n]===`\\`&&n++;t+=e.slice(r,n+1)}else if(r===`/`&&e[n+1]===`/`){for(;n<e.length&&e[n]!==`
1870
1870
  `;)n++;t+=`
1871
- `}else if(r===`/`&&e[n+1]===`*`){let t=e.indexOf(`*/`,n+2);n=t===-1?e.length:t+1}else t+=r}try{return JSON.parse(t.replace(/,(\s*[}\]])/g,`$1`))}catch{return null}}function aa(e){let t=z(e,`tsconfig.json`);if(P(t))return oa(t,/* @__PURE__ */ new Set)}function oa(e,t){if(t.has(e)||t.size>=16)return null;t.add(e);let n=na(e);if(n===null)return null;let r=ia(n);if(typeof r!=`object`||!r)return null;let i=Array.isArray(r.extends)?r.extends:typeof r.extends==`string`?[r.extends]:[],a={},o={};for(let t of ra)r[t]!==void 0&&(r[`${t}Base`]=R(e));for(let n of i){if(typeof n!=`string`)continue;let r=sa(R(e),n);if(!r)continue;let i=oa(r,t);if(i){Object.assign(a,i.compilerOptions);for(let e of ra)i[e]!==void 0&&(o[e]=i[e],o[`${e}Base`]=i[`${e}Base`])}}r.compilerOptions={...a,...r.compilerOptions};for(let e of ra)r[e]===void 0&&o[e]!==void 0&&(r[e]=o[e],r[`${e}Base`]=o[`${e}Base`]);return r}function sa(e,t){if(t.startsWith(`.`)||t.startsWith(`/`))return ca(V(e,t));let n=e;for(;;){let e=ca(z(n,`node_modules`,t));if(e)return e;let r=R(n);if(r===n)break;n=r}return null}function ca(e){if(P(e)){try{if(qe(e).isDirectory()){let t=z(e,`tsconfig.json`);return P(t)?t:null}}catch{return null}return e}let t=`${e}.json`;return P(t)?t:null}function la(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}function ua(){let e=process.version,t=Number.parseInt(e.replace(/^v/,``).split(`.`)[0],10);return Number.isNaN(t)||t<20?{name:`Node version`,status:`fail`,message:e,fix:`KickJS requires Node 20 or newer.
1872
- Install a supported version via nvm / fnm / volta.`}:{name:`Node version`,status:`pass`,message:e}}function da(e){if(!e.pkg)return{name:`@forinda/kickjs installed`,status:`warn`,message:`no package.json`};let t={...e.pkg.dependencies,...e.pkg.peerDependencies};return t[`@forinda/kickjs`]?{name:`@forinda/kickjs installed`,status:`pass`,message:t[`@forinda/kickjs`]}:{name:`@forinda/kickjs installed`,status:`fail`,fix:"This directory does not look like a KickJS project — `@forinda/kickjs` is not in your package.json. Run `kick doctor` from the project root, or scaffold a fresh project with `kick new <name>`."}}function fa(e){if(!e.pkg||e.runtime!==`express`)return null;let t={...e.pkg.dependencies,...e.pkg.peerDependencies};return t[`@forinda/kickjs`]&&!t.express?{name:`express installed`,status:`fail`,fix:`This app runs on the Express runtime, but package.json does not include \`express\`. Install: ${j(e.cwd)} add express`}:t.express?{name:`express installed`,status:`pass`,message:t.express}:null}const pa={express:[],fastify:[`fastify`,`@fastify/middie`],h3:[`h3`]};function ma(e){if(!e.pkg||e.runtime===`express`)return null;let t={...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies},n=pa[e.runtime].filter(e=>!t[e]),r=`runtime engine (${e.runtime})`;return n.length>0?{name:r,status:`fail`,fix:`Resolved runtime '${e.runtime}' is missing engine peer(s): ${n.join(`, `)}.\nInstall: ${j(e.cwd)} add ${n.join(` `)}`}:e.runtime===`h3`&&ha(e.cwd,t.h3)===1?{name:r,status:`fail`,message:`h3 v1`,fix:`This version of @forinda/kickjs runs on h3 v2 only. Upgrade: ${j(e.cwd)} add h3@^2 — no code change for apps that only use KickJS APIs.`}:{name:r,status:`pass`}}function ha(e,t){let n=t;for(let t=V(e);;t=R(t)){try{n=JSON.parse(F(z(t,`node_modules`,`h3`,`package.json`),`utf8`)).version;break}catch{}if(R(t)===t)break}let r=/(\d+)/.exec(n)?.[1];return r===void 0?void 0:Number(r)}function ga(e){if(!e.pkg||!va(e.cwd))return null;let t=h[e.runtime],n=`upload driver (${e.runtime})`;return t.prod?{...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies}[t.prod]?{name:n,status:`pass`,message:t.prod}:{name:n,status:`fail`,fix:`This project uses file uploads on the '${e.runtime}' runtime, which needs '${t.prod}'.\nInstall it: kick add upload (or ${j(e.cwd)} add ${t.prod})`}:{name:n,status:`pass`,message:`native multipart`}}const _a=2e3;function va(e){let t=z(e,`src`);if(!P(t))return!1;let n=/@FileUpload\b|\bupload\.(single|array|none)\s*\(/,r=[t],i=0;for(;r.length>0&&i<_a;){let e=r.pop(),t;try{t=Ge(e,{withFileTypes:!0})}catch{continue}for(let a of t){if(i>=_a)break;let t=z(e,a.name);if(a.isDirectory())a.name!==`node_modules`&&r.push(t);else if(/\.(ts|tsx|mts|cts)$/.test(a.name)&&(i++,n.test(na(t)??``)))return!0}}return!1}function ya(e){if(!e.pkg)return{name:`reflect-metadata installed`,status:`warn`,message:`no package.json`};let t={...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies};return t[`reflect-metadata`]?{name:`reflect-metadata installed`,status:`pass`,message:t[`reflect-metadata`]}:{name:`reflect-metadata installed`,status:`fail`,fix:`KickJS decorators require the reflect-metadata polyfill.\nInstall it: ${j(e.cwd)} add reflect-metadata\nThen import it at the top of src/index.ts:\n\n import 'reflect-metadata'\n // ... rest of bootstrap`}}function ba(e){if(e.tsconfig===void 0)return[{name:`tsconfig.json present`,status:`fail`,fix:"Create a tsconfig.json with `experimentalDecorators: true` and `emitDecoratorMetadata: true`. `kick new` scaffolds one automatically."}];if(e.tsconfig===null)return[{name:`tsconfig.json readable`,status:`warn`,message:`could not parse tsconfig.json (or a config it extends)`,fix:"Check tsconfig.json for a syntax error, and that every path in its `extends` chain resolves. Decorator options could not be verified."}];let t=e.tsconfig.compilerOptions??{},n=[];return n.push(t.experimentalDecorators===!0?{name:`tsconfig: experimentalDecorators`,status:`pass`}:{name:`tsconfig: experimentalDecorators`,status:`fail`,fix:'Add `"experimentalDecorators": true` to compilerOptions in tsconfig.json. Without it, @Service / @Controller / @Get etc. don\'t register any metadata at compile time.'}),n.push(t.emitDecoratorMetadata===!0?{name:`tsconfig: emitDecoratorMetadata`,status:`pass`}:{name:`tsconfig: emitDecoratorMetadata`,status:`fail`,fix:'Add `"emitDecoratorMetadata": true` to compilerOptions in tsconfig.json. The DI container uses this metadata for constructor-parameter injection.'}),n}function xa(e){let t=[`src/env.ts`,`src/env/index.ts`,`src/config/env.ts`,`src/config/index.ts`].map(t=>z(e.cwd,t)).filter(e=>P(e)).filter(e=>/\bloadEnv(?:FromSchema)?\s*\(/.test(na(e)??``));if(t.length===0)return null;let n=[`src/index.ts`,`src/main.ts`].map(t=>z(e.cwd,t)).find(e=>P(e));if(!n)return{name:`env wiring`,status:`warn`,message:`env-init file exists but no src/index.ts or src/main.ts found`};let r=na(n)??``,i=R(n),a=[];for(let e of t){let t=B(i,e).replace(/\\/g,`/`).replace(/\.ts$/,``),n=t.startsWith(`.`)?t:`./`+t,r=n.replace(/\/index$/,``);a.push(n,r);let o=e.replace(/\\/g,`/`).match(/\/src\/(.+?)(?:\.ts)?$/);if(o){let e=`@/`+o[1],t=e.replace(/\/index$/,``);a.push(e,t)}}let o=-1;for(let e of new Set(a)){let t=RegExp(`^import\\s+(?:.*?from\\s+)?['"]${la(e)}['"]`,`m`),n=r.match(t);n&&n.index!==void 0&&(o===-1||n.index<o)&&(o=n.index)}let s=r.search(/\bbootstrap\s*\(/),c=t.map(t=>B(e.cwd,t).replace(/\\/g,`/`)).join(`, `);return o===-1?{name:`env wiring`,status:`fail`,message:c,fix:`An env-init file (${c}) calls \`loadEnv(...)\` but \`${B(e.cwd,n).replace(/\\/g,`/`)}\` doesn't import it.\nWithout this, ConfigService.get('X') returns undefined while @Value('X') works via process.env fallback — a half-broken config you won't notice until something is missing.\n\nFix: add a side-effect import at the top of ${B(e.cwd,n).replace(/\\/g,`/`)} (above bootstrap()), pointing at one of the detected files. For example:\n\n import './env'\n // or\n import './config'\n // or, with the @/ alias:\n import '@/config/env'`}:s!==-1&&o>s?{name:`env wiring`,status:`warn`,message:`env-init imported AFTER bootstrap() — should be before`,fix:`Move the env import above the bootstrap() call so the schema runs before any service reads from ConfigService.`}:{name:`env wiring`,status:`pass`}}function Sa(e,t=Ca){let n=0,r=0,i=[e];for(;i.length>0&&r<t;){let e=i.pop(),a;try{a=Ge(e,{withFileTypes:!0})}catch{continue}for(let o of a){if(r>=t)break;r++;let a=z(e,o.name);if(o.isDirectory())i.push(a);else try{let e=qe(a).mtimeMs;e>n&&(n=e)}catch{}}}return n}const Ca=2e3;function wa(e){let t=z(e.cwd,`.kickjs`,`types`);if(!P(t))return null;let n=Sa(t);if(n===0)return null;let r=Date.now()-n,i=Math.floor(r/6e4);return i>60?{name:`typegen freshness`,status:`warn`,message:`last updated ${i} minutes ago`,fix:"Re-run `kick typegen` (or `kick dev`, which runs it on every reload) so generated types match the current code."}:{name:`typegen freshness`,status:`pass`,message:i===0?`just now`:`${i}m ago`}}const Ta=[`vitest.config.ts`,`vitest.config.js`,`vitest.config.mts`,`vite.config.ts`,`jest.config.ts`,`jest.config.js`],Ea=[`.env.test`,`.env.test.local`],Da=[`.env`,`.env.local`];function Oa(e){let t=e.pkg?.scripts;if(t&&typeof t==`object`)for(let[e,n]of Object.entries(t)){if(!e.startsWith(`test`)||typeof n!=`string`)continue;let t=/KICKJS_ENV_FILE=(\S+)/.exec(n);if(t?.[1])return t[1]}return process.env.KICKJS_ENV_FILE??null}function ka(e){if(!Ta.some(t=>P(z(e.cwd,t))))return null;let t=Da.filter(t=>P(z(e.cwd,t)));if(t.length===0)return null;let n=Ea.filter(t=>P(z(e.cwd,t)));if(n.length>0){let t=Oa(e);return t&&t!==`off`&&t!==`none`?{name:`test env isolation`,status:`warn`,message:`${n.join(`, `)} present, but KICKJS_ENV_FILE=${t} overrides it`,fix:`KICKJS_ENV_FILE is checked before test-mode isolation, so ${n[0]} is\nignored and "${t}" is read instead. Drop the override to use the\ntest files, or set KICKJS_ENV_FILE=off if env comes from the runner.`}:{name:`test env isolation`,status:`pass`,message:`${n.join(`, `)} present`}}return{name:`test env isolation`,status:`warn`,message:`${t.join(`, `)} present, no .env.test`,fix:`Under NODE_ENV=test (or vitest's VITEST) KickJS reads .env.test / .env.test.local
1871
+ `}else if(r===`/`&&e[n+1]===`*`){let t=e.indexOf(`*/`,n+2);n=t===-1?e.length:t+1}else t+=r}try{return JSON.parse(t.replace(/,(\s*[}\]])/g,`$1`))}catch{return null}}function ia(e){let t=B(e,`tsconfig.json`);if(P(t))return aa(t,/* @__PURE__ */ new Set)}function aa(e,t){if(t.has(e)||t.size>=16)return null;t.add(e);let n=ta(e);if(n===null)return null;let r=ra(n);if(typeof r!=`object`||!r)return null;let i=Array.isArray(r.extends)?r.extends:typeof r.extends==`string`?[r.extends]:[],a={},o={};for(let t of na)r[t]!==void 0&&(r[`${t}Base`]=z(e));for(let n of i){if(typeof n!=`string`)continue;let r=oa(z(e),n);if(!r)continue;let i=aa(r,t);if(i){Object.assign(a,i.compilerOptions);for(let e of na)i[e]!==void 0&&(o[e]=i[e],o[`${e}Base`]=i[`${e}Base`])}}r.compilerOptions={...a,...r.compilerOptions};for(let e of na)r[e]===void 0&&o[e]!==void 0&&(r[e]=o[e],r[`${e}Base`]=o[`${e}Base`]);return r}function oa(e,t){if(t.startsWith(`.`)||t.startsWith(`/`))return sa(H(e,t));let n=e;for(;;){let e=sa(B(n,`node_modules`,t));if(e)return e;let r=z(n);if(r===n)break;n=r}return null}function sa(e){if(P(e)){try{if(Ke(e).isDirectory()){let t=B(e,`tsconfig.json`);return P(t)?t:null}}catch{return null}return e}let t=`${e}.json`;return P(t)?t:null}function ca(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}function la(){let e=process.version,t=Number.parseInt(e.replace(/^v/,``).split(`.`)[0],10);return Number.isNaN(t)||t<20?{name:`Node version`,status:`fail`,message:e,fix:`KickJS requires Node 20 or newer.
1872
+ Install a supported version via nvm / fnm / volta.`}:{name:`Node version`,status:`pass`,message:e}}function ua(e){if(!e.pkg)return{name:`@forinda/kickjs installed`,status:`warn`,message:`no package.json`};let t={...e.pkg.dependencies,...e.pkg.peerDependencies};return t[`@forinda/kickjs`]?{name:`@forinda/kickjs installed`,status:`pass`,message:t[`@forinda/kickjs`]}:{name:`@forinda/kickjs installed`,status:`fail`,fix:"This directory does not look like a KickJS project — `@forinda/kickjs` is not in your package.json. Run `kick doctor` from the project root, or scaffold a fresh project with `kick new <name>`."}}function da(e){if(!e.pkg||e.runtime!==`express`)return null;let t={...e.pkg.dependencies,...e.pkg.peerDependencies};return t[`@forinda/kickjs`]&&!t.express?{name:`express installed`,status:`fail`,fix:`This app runs on the Express runtime, but package.json does not include \`express\`. Install: ${j(e.cwd)} add express`}:t.express?{name:`express installed`,status:`pass`,message:t.express}:null}const fa={express:[],fastify:[`fastify`,`@fastify/middie`],h3:[`h3`]};function pa(e){if(!e.pkg||e.runtime===`express`)return null;let t={...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies},n=fa[e.runtime].filter(e=>!t[e]),r=`runtime engine (${e.runtime})`;return n.length>0?{name:r,status:`fail`,fix:`Resolved runtime '${e.runtime}' is missing engine peer(s): ${n.join(`, `)}.\nInstall: ${j(e.cwd)} add ${n.join(` `)}`}:e.runtime===`h3`&&ma(e.cwd,t.h3)===1?{name:r,status:`fail`,message:`h3 v1`,fix:`This version of @forinda/kickjs runs on h3 v2 only. Upgrade: ${j(e.cwd)} add h3@^2 — no code change for apps that only use KickJS APIs.`}:{name:r,status:`pass`}}function ma(e,t){let n=t;for(let t=H(e);;t=z(t)){try{n=JSON.parse(F(B(t,`node_modules`,`h3`,`package.json`),`utf8`)).version;break}catch{}if(z(t)===t)break}let r=/(\d+)/.exec(n)?.[1];return r===void 0?void 0:Number(r)}function ha(e){if(!e.pkg||!_a(e.cwd))return null;let t=h[e.runtime],n=`upload driver (${e.runtime})`;return t.prod?{...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies}[t.prod]?{name:n,status:`pass`,message:t.prod}:{name:n,status:`fail`,fix:`This project uses file uploads on the '${e.runtime}' runtime, which needs '${t.prod}'.\nInstall it: kick add upload (or ${j(e.cwd)} add ${t.prod})`}:{name:n,status:`pass`,message:`native multipart`}}const ga=2e3;function _a(e){let t=B(e,`src`);if(!P(t))return!1;let n=/@FileUpload\b|\bupload\.(single|array|none)\s*\(/,r=[t],i=0;for(;r.length>0&&i<ga;){let e=r.pop(),t;try{t=I(e,{withFileTypes:!0})}catch{continue}for(let a of t){if(i>=ga)break;let t=B(e,a.name);if(a.isDirectory())a.name!==`node_modules`&&r.push(t);else if(/\.(ts|tsx|mts|cts)$/.test(a.name)&&(i++,n.test(ta(t)??``)))return!0}}return!1}function va(e){if(!e.pkg)return{name:`reflect-metadata installed`,status:`warn`,message:`no package.json`};let t={...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies};return t[`reflect-metadata`]?{name:`reflect-metadata installed`,status:`pass`,message:t[`reflect-metadata`]}:{name:`reflect-metadata installed`,status:`fail`,fix:`KickJS decorators require the reflect-metadata polyfill.\nInstall it: ${j(e.cwd)} add reflect-metadata\nThen import it at the top of src/index.ts:\n\n import 'reflect-metadata'\n // ... rest of bootstrap`}}function ya(e){if(e.tsconfig===void 0)return[{name:`tsconfig.json present`,status:`fail`,fix:"Create a tsconfig.json with `experimentalDecorators: true` and `emitDecoratorMetadata: true`. `kick new` scaffolds one automatically."}];if(e.tsconfig===null)return[{name:`tsconfig.json readable`,status:`warn`,message:`could not parse tsconfig.json (or a config it extends)`,fix:"Check tsconfig.json for a syntax error, and that every path in its `extends` chain resolves. Decorator options could not be verified."}];let t=e.tsconfig.compilerOptions??{},n=[];return n.push(t.experimentalDecorators===!0?{name:`tsconfig: experimentalDecorators`,status:`pass`}:{name:`tsconfig: experimentalDecorators`,status:`fail`,fix:'Add `"experimentalDecorators": true` to compilerOptions in tsconfig.json. Without it, @Service / @Controller / @Get etc. don\'t register any metadata at compile time.'}),n.push(t.emitDecoratorMetadata===!0?{name:`tsconfig: emitDecoratorMetadata`,status:`pass`}:{name:`tsconfig: emitDecoratorMetadata`,status:`fail`,fix:'Add `"emitDecoratorMetadata": true` to compilerOptions in tsconfig.json. The DI container uses this metadata for constructor-parameter injection.'}),n}function ba(e){let t=[`src/env.ts`,`src/env/index.ts`,`src/config/env.ts`,`src/config/index.ts`].map(t=>B(e.cwd,t)).filter(e=>P(e)).filter(e=>/\bloadEnv(?:FromSchema)?\s*\(/.test(ta(e)??``));if(t.length===0)return null;let n=[`src/index.ts`,`src/main.ts`].map(t=>B(e.cwd,t)).find(e=>P(e));if(!n)return{name:`env wiring`,status:`warn`,message:`env-init file exists but no src/index.ts or src/main.ts found`};let r=ta(n)??``,i=z(n),a=[];for(let e of t){let t=V(i,e).replace(/\\/g,`/`).replace(/\.ts$/,``),n=t.startsWith(`.`)?t:`./`+t,r=n.replace(/\/index$/,``);a.push(n,r);let o=e.replace(/\\/g,`/`).match(/\/src\/(.+?)(?:\.ts)?$/);if(o){let e=`@/`+o[1],t=e.replace(/\/index$/,``);a.push(e,t)}}let o=-1;for(let e of new Set(a)){let t=RegExp(`^import\\s+(?:.*?from\\s+)?['"]${ca(e)}['"]`,`m`),n=r.match(t);n&&n.index!==void 0&&(o===-1||n.index<o)&&(o=n.index)}let s=r.search(/\bbootstrap\s*\(/),c=t.map(t=>V(e.cwd,t).replace(/\\/g,`/`)).join(`, `);return o===-1?{name:`env wiring`,status:`fail`,message:c,fix:`An env-init file (${c}) calls \`loadEnv(...)\` but \`${V(e.cwd,n).replace(/\\/g,`/`)}\` doesn't import it.\nWithout this, ConfigService.get('X') returns undefined while @Value('X') works via process.env fallback — a half-broken config you won't notice until something is missing.\n\nFix: add a side-effect import at the top of ${V(e.cwd,n).replace(/\\/g,`/`)} (above bootstrap()), pointing at one of the detected files. For example:\n\n import './env'\n // or\n import './config'\n // or, with the @/ alias:\n import '@/config/env'`}:s!==-1&&o>s?{name:`env wiring`,status:`warn`,message:`env-init imported AFTER bootstrap() — should be before`,fix:`Move the env import above the bootstrap() call so the schema runs before any service reads from ConfigService.`}:{name:`env wiring`,status:`pass`}}function xa(e,t=Sa){let n=0,r=0,i=[e];for(;i.length>0&&r<t;){let e=i.pop(),a;try{a=I(e,{withFileTypes:!0})}catch{continue}for(let o of a){if(r>=t)break;r++;let a=B(e,o.name);if(o.isDirectory())i.push(a);else try{let e=Ke(a).mtimeMs;e>n&&(n=e)}catch{}}}return n}const Sa=2e3;function Ca(e){let t=B(e.cwd,`.kickjs`,`types`);if(!P(t))return null;let n=xa(t);if(n===0)return null;let r=Date.now()-n,i=Math.floor(r/6e4);return i>60?{name:`typegen freshness`,status:`warn`,message:`last updated ${i} minutes ago`,fix:"Re-run `kick typegen` (or `kick dev`, which runs it on every reload) so generated types match the current code."}:{name:`typegen freshness`,status:`pass`,message:i===0?`just now`:`${i}m ago`}}const wa=[`vitest.config.ts`,`vitest.config.js`,`vitest.config.mts`,`vite.config.ts`,`jest.config.ts`,`jest.config.js`],Ta=[`.env.test`,`.env.test.local`],Ea=[`.env`,`.env.local`];function Da(e){let t=e.pkg?.scripts;if(t&&typeof t==`object`)for(let[e,n]of Object.entries(t)){if(!e.startsWith(`test`)||typeof n!=`string`)continue;let t=/KICKJS_ENV_FILE=(\S+)/.exec(n);if(t?.[1])return t[1]}return process.env.KICKJS_ENV_FILE??null}function Oa(e){if(!wa.some(t=>P(B(e.cwd,t))))return null;let t=Ea.filter(t=>P(B(e.cwd,t)));if(t.length===0)return null;let n=Ta.filter(t=>P(B(e.cwd,t)));if(n.length>0){let t=Da(e);return t&&t!==`off`&&t!==`none`?{name:`test env isolation`,status:`warn`,message:`${n.join(`, `)} present, but KICKJS_ENV_FILE=${t} overrides it`,fix:`KICKJS_ENV_FILE is checked before test-mode isolation, so ${n[0]} is\nignored and "${t}" is read instead. Drop the override to use the\ntest files, or set KICKJS_ENV_FILE=off if env comes from the runner.`}:{name:`test env isolation`,status:`pass`,message:`${n.join(`, `)} present`}}return{name:`test env isolation`,status:`warn`,message:`${t.join(`, `)} present, no .env.test`,fix:`Under NODE_ENV=test (or vitest's VITEST) KickJS reads .env.test / .env.test.local
1873
1873
  INSTEAD of ${t.join(` and `)} — no layering, no fallback. Without one of\nthose files, every var your test config does not pin resolves from your
1874
1874
  development env — including DATABASE_URL and any third-party credentials.
1875
1875
 
1876
1876
  Create .env.test (cp .env.test.example .env.test, if the project has one)
1877
1877
  holding the whole environment the suite should run against
1878
1878
  (a var you leave out is then missing, not inherited), or set KICKJS_ENV_FILE=off
1879
- and supply env from the test runner.`}}function Aa(e){let t={...e.pkg?.dependencies,...e.pkg?.devDependencies};if(!t[`@forinda/kickjs`]||!t[`@forinda/kickjs-di`])return null;let n=`one DI container`,r=t=>ta(z(e.cwd,`node_modules`,t,`package.json`)),i=r(`@forinda/kickjs`)?.dependencies?.[`@forinda/kickjs-di`],a=r(`@forinda/kickjs-di`)?.version,o=`Remove it and import from @forinda/kickjs, which re-exports it: ${j(e.cwd)} remove @forinda/kickjs-di`;return i&&a&&i!==a?{name:n,status:`fail`,message:`@forinda/kickjs-di ${a}, @forinda/kickjs uses ${i}`,fix:`Two copies of the DI container are installed, each with its own registrations — a class decorated against one is missing from the other.\n${o}`}:{name:n,status:`warn`,message:`@forinda/kickjs-di is listed in package.json`,fix:`@forinda/kickjs already depends on the exact version it needs; listing it too invites a second copy on the next upgrade.\n${o}`}}function ja(e){if(!e.tsconfig||!P(z(e.cwd,`.kickjs`,`types`)))return null;let t=`tsconfig includes typegen output`,n=t=>{let n=e.tsconfig[t],r=e.tsconfig[`${t}Base`]??e.cwd;return Array.isArray(n)?n.filter(e=>typeof e==`string`).map(t=>B(e.cwd,V(r,t)).replace(/\\/g,`/`)):[]},r=e=>/^\.kickjs\/(types(\/|$)|\*\*)/.test(e),i=e=>/^(\*\*\/)?\.kickjs(\/types)?(\/\*\*(\/\*)?|\/\*)?$/.test(e),a=n(`include`).filter(r),o=n(`exclude`).find(i),s=`Add ".kickjs/types/**/*.d.ts" and ".kickjs/types/**/*.ts" to "include" in tsconfig.json.`;return a.length===0?{name:t,status:`warn`,message:`.kickjs/types is not in include`,fix:`${s} Without them, the route, env and DI types from \`kick typegen\` don't apply.`}:o?{name:t,status:`warn`,message:`excluded by "${o}"`,fix:`Remove "${o}" from "exclude" in tsconfig.json — it drops the types \`kick typegen\` writes.`}:a.every(e=>e.endsWith(`.d.ts`))?{name:t,status:`warn`,message:`only the .d.ts files of .kickjs/types are included`,fix:`${s} The route types are a .ts file.`}:String(e.tsconfig.compilerOptions?.rootDir??``).replace(/^\.\//,``).replace(/\/$/,``)===`src`?{name:t,status:`warn`,message:`rootDir: 'src'`,fix:"Remove `rootDir` from tsconfig.json — the generated types live outside src/, and tsc refuses files outside rootDir."}:{name:t,status:`pass`}}const Ma=[()=>ua(),da,fa,ma,ga,Aa,ya,ba,ja,xa,ka,wa];async function Na(e,t={}){let n={cwd:e,pkg:ta(z(e,`package.json`)),tsconfig:aa(e),runtime:t.runtime??`express`},r=[...Ma,...t.extraChecks??[]],i=[];for(let e of r){let t;try{t=await e(n)}catch(t){i.push({name:e.name||`doctor check`,status:`fail`,message:t instanceof Error?t.message:String(t)});continue}t!=null&&(Array.isArray(t)?i.push(...t):i.push(t))}return i}function Pa(e){switch(e){case`pass`:return A.green(`✔`);case`warn`:return A.yellow(`⚠`);case`fail`:return A.red(`✖`)}}function Fa(e){let t=Pa(e.status),n=e.message?` ${A.dim(`(${e.message})`)}`:``;return`${t} ${e.name}${n}`}function Ia(e){return e.split(`
1879
+ and supply env from the test runner.`}}function ka(e){let t={...e.pkg?.dependencies,...e.pkg?.devDependencies};if(!t[`@forinda/kickjs`]||!t[`@forinda/kickjs-di`])return null;let n=`one DI container`,r=t=>ea(B(e.cwd,`node_modules`,t,`package.json`)),i=r(`@forinda/kickjs`)?.dependencies?.[`@forinda/kickjs-di`],a=r(`@forinda/kickjs-di`)?.version,o=`Remove it and import from @forinda/kickjs, which re-exports it: ${j(e.cwd)} remove @forinda/kickjs-di`;return i&&a&&i!==a?{name:n,status:`fail`,message:`@forinda/kickjs-di ${a}, @forinda/kickjs uses ${i}`,fix:`Two copies of the DI container are installed, each with its own registrations — a class decorated against one is missing from the other.\n${o}`}:{name:n,status:`warn`,message:`@forinda/kickjs-di is listed in package.json`,fix:`@forinda/kickjs already depends on the exact version it needs; listing it too invites a second copy on the next upgrade.\n${o}`}}function Aa(e){if(!e.tsconfig||!P(B(e.cwd,`.kickjs`,`types`)))return null;let t=`tsconfig includes typegen output`,n=t=>{let n=e.tsconfig[t],r=e.tsconfig[`${t}Base`]??e.cwd;return Array.isArray(n)?n.filter(e=>typeof e==`string`).map(t=>V(e.cwd,H(r,t)).replace(/\\/g,`/`)):[]},r=e=>/^\.kickjs\/(types(\/|$)|\*\*)/.test(e),i=e=>/^(\*\*\/)?\.kickjs(\/types)?(\/\*\*(\/\*)?|\/\*)?$/.test(e),a=n(`include`).filter(r),o=n(`exclude`).find(i),s=`Add ".kickjs/types/**/*.d.ts" and ".kickjs/types/**/*.ts" to "include" in tsconfig.json.`;return a.length===0?{name:t,status:`warn`,message:`.kickjs/types is not in include`,fix:`${s} Without them, the route, env and DI types from \`kick typegen\` don't apply.`}:o?{name:t,status:`warn`,message:`excluded by "${o}"`,fix:`Remove "${o}" from "exclude" in tsconfig.json — it drops the types \`kick typegen\` writes.`}:a.every(e=>e.endsWith(`.d.ts`))?{name:t,status:`warn`,message:`only the .d.ts files of .kickjs/types are included`,fix:`${s} The route types are a .ts file.`}:String(e.tsconfig.compilerOptions?.rootDir??``).replace(/^\.\//,``).replace(/\/$/,``)===`src`?{name:t,status:`warn`,message:`rootDir: 'src'`,fix:"Remove `rootDir` from tsconfig.json — the generated types live outside src/, and tsc refuses files outside rootDir."}:{name:t,status:`pass`}}const ja=[()=>la(),ua,da,pa,ha,ka,va,ya,Aa,ba,Oa,Ca];async function Ma(e,t={}){let n={cwd:e,pkg:ea(B(e,`package.json`)),tsconfig:ia(e),runtime:t.runtime??`express`},r=[...ja,...t.extraChecks??[]],i=[];for(let e of r){let t;try{t=await e(n)}catch(t){i.push({name:e.name||`doctor check`,status:`fail`,message:t instanceof Error?t.message:String(t)});continue}t!=null&&(Array.isArray(t)?i.push(...t):i.push(t))}return i}function Na(e){switch(e){case`pass`:return A.green(`✔`);case`warn`:return A.yellow(`⚠`);case`fail`:return A.red(`✖`)}}function Pa(e){let t=Na(e.status),n=e.message?` ${A.dim(`(${e.message})`)}`:``;return`${t} ${e.name}${n}`}function Fa(e){return e.split(`
1880
1880
  `).map(e=>` ${A.dim(`→`)} ${e}`).join(`
1881
- `)}function La(e){return e?.doctor?.checks??[]}function Ra(e){e.command(`doctor`).description(`Pre-flight checks for your KickJS project (dev environment health)`).action(async()=>{let e=process.cwd(),t=La(await w(e)),n=await o(e);ce(`KickJS Doctor`);let r=await Na(e,{extraChecks:t,runtime:n});for(let e of r)M.message(Fa(e)),e.fix&&e.status!==`pass`&&M.message(Ia(e.fix));let i=r.filter(e=>e.status===`pass`).length,a=r.filter(e=>e.status===`warn`).length,s=r.filter(e=>e.status===`fail`).length,c=[A.green(`${i} passed`),a>0?A.yellow(`${a} warning${a===1?``:`s`}`):`${a} warnings`,s>0?A.red(`${s} error${s===1?``:`s`}`):`${s} errors`].join(`, `);s>0?(k(`${c} — fix the errors above before running the app`),process.exit(1)):k(a>0?`${c} — review the warnings`:A.green(`${c} — your environment looks good`))})}const za=Symbol.for(`kickjs.handler.entryCapture`),Ba=Symbol.for(`kickjs.config.describe`);function Va(e){return Array.isArray(e)?e.join(`,`):typeof e==`object`&&e||typeof e==`string`&&/[\r\n]/.test(e)?JSON.stringify(e):String(e)}const Ha=e=>e.split(/\r?\n/).map(e=>`# ${e}`);function Ua(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(...Ha(e.join(` — `))),r.required&&!t?n.push(`${r.name}=`):n.push(`# ${r.name}=${r.default===void 0?``:Va(r.default)}`)}return n}function Wa(e){let t=[`# Generated by \`kick env example\` from the env schema and the declared settings
1881
+ `)}function Ia(e){return e?.doctor?.checks??[]}function La(e){e.command(`doctor`).description(`Pre-flight checks for your KickJS project (dev environment health)`).action(async()=>{let e=process.cwd(),t=Ia(await w(e)),n=await o(e);ce(`KickJS Doctor`);let r=await Ma(e,{extraChecks:t,runtime:n});for(let e of r)M.message(Pa(e)),e.fix&&e.status!==`pass`&&M.message(Fa(e.fix));let i=r.filter(e=>e.status===`pass`).length,a=r.filter(e=>e.status===`warn`).length,s=r.filter(e=>e.status===`fail`).length,c=[A.green(`${i} passed`),a>0?A.yellow(`${a} warning${a===1?``:`s`}`):`${a} warnings`,s>0?A.red(`${s} error${s===1?``:`s`}`):`${s} errors`].join(`, `);s>0?(k(`${c} — fix the errors above before running the app`),process.exit(1)):k(a>0?`${c} — review the warnings`:A.green(`${c} — your environment looks good`))})}const Ra=Symbol.for(`kickjs.handler.entryCapture`),za=Symbol.for(`kickjs.config.describe`);function Ba(e){return Array.isArray(e)?e.join(`,`):typeof e==`object`&&e||typeof e==`string`&&/[\r\n]/.test(e)?JSON.stringify(e):String(e)}const Va=e=>e.split(/\r?\n/).map(e=>`# ${e}`);function Ha(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(...Va(e.join(` — `))),r.required&&!t?n.push(`${r.name}=`):n.push(`# ${r.name}=${r.default===void 0?``:Ba(r.default)}`)}return n}function Ua(e){let t=[`# Generated by \`kick env example\` from the env schema and the declared settings
1882
1882
  # sections. Re-run it after changing them; \`kick env example --check\` fails when stale.
1883
1883
  #
1884
1884
  # Uncommented variables are required. Commented ones are optional; the value shown
1885
- # 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 ──`,...Ua(e.env)].join(`
1886
- `));for(let n of e.sections)t.push([`# ── ${n.prefix} settings (${n.optional?`optional, `:``}declared by ${n.declaredBy}) ──`,...n.description?Ha(n.description):[],...Ua(n.vars,n.optional)].join(`
1885
+ # 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 ──`,...Ha(e.env)].join(`
1886
+ `));for(let n of e.sections)t.push([`# ── ${n.prefix} settings (${n.optional?`optional, `:``}declared by ${n.declaredBy}) ──`,...n.description?Va(n.description):[],...Ha(n.vars,n.optional)].join(`
1887
1887
  `));return`${t.join(`
1888
1888
 
1889
- `)}\n`}async function Ga(e,t){let n=V(e,t);if(!P(n))throw Error(`${t} not found`);let r=V(e,`vite.config.ts`);if(!P(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(V(e,`package.json`)),{createServer:o}=await import(U(a.resolve(`vite`)).href),s=globalThis,c;s[za]=e=>{c??=e},s[Ba]=!0,s[or]=`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[za],delete s[Ba],delete s[or],await l.close()}if(!c)throw Error(`${t} finished loading without calling bootstrap()`);return c.describeConfig()}function Ka(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=V(t,e.out),r;try{r=Wa(await Ga(t,e.entry))}catch(e){console.error(`\n kick env example: ${e.message}\n`),process.exit(1)}e.check?((P(n)?F(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.`)):(I(n,r),console.log(` Wrote ${e.out}`))})}function qa(e){return e.optsWithGlobals().dryRun??!1}function Ja(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.
1889
+ `)}\n`}async function Wa(e,t){let n=H(e,t);if(!P(n))throw Error(`${t} not found`);let r=H(e,`vite.config.ts`);if(!P(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(H(e,`package.json`)),{createServer:o}=await import(W(a.resolve(`vite`)).href),s=globalThis,c;s[Ra]=e=>{c??=e},s[za]=!0,s[ar]=`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[Ra],delete s[za],delete s[ar],await l.close()}if(!c)throw Error(`${t} finished loading without calling bootstrap()`);return c.describeConfig()}function Ga(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=H(t,e.out),r;try{r=Ua(await Wa(t,e.entry))}catch(e){console.error(`\n kick env example: ${e.message}\n`),process.exit(1)}e.check?((P(n)?F(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.`)):(L(n,r),console.log(` Wrote ${e.out}`))})}function Ka(e){return e.optsWithGlobals().dryRun??!1}function qa(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.
1890
1890
  Direction defaults to \`modules.style\` from kick.config (or "define").
1891
1891
  --target define|class Override the migration direction.
1892
1892
  --apply Apply the changes (default: dry-run preview).
1893
- --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=qa(t)||!e.apply;O(n),e.experimental||(console.error(`
1893
+ --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=Ka(t)||!e.apply;O(n),e.experimental||(console.error(`
1894
1894
  `+A.red(`Error:`)+` kick codemod modules is experimental — pass --experimental to acknowledge.
1895
1895
  The regex-based rewrite handles the shapes our templates produce.
1896
1896
  Hand-rolled modules with non-standard structures may be skipped.
1897
1897
  Always commit before running with --apply.
1898
- `),process.exit(1));let r=await w(process.cwd()),i=T(r),a=V(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 ${A.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let s=A.dim(`→ ${o}`),c=n?A.dim(`(dry-run)`):A.bold(`(applying)`);console.log(`\n ${A.bold(`kick codemod modules`)} ${s} ${c}`),console.log(` modulesDir: ${A.dim(a)}\n`);let l=e.backup!==!1&&!n,u=await Mn(a,{dryRun:n,target:o,backup:l});if(u.backupDir){let e=u.backupDir;console.log(` ${A.green(`✓`)} backup: ${A.dim(e)}\n ${A.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else!n&&e.backup===!1&&console.log(` ${A.dim(`(--no-backup — skipping snapshot)`)}\n`);let d=0,f=0;for(let e of u.files)if(e.status===`migrated`)d++,console.log(` ${A.green(`✓`)} ${e.path}`);else{f++;let t=A.dim(`(${e.reason??`skipped`})`);console.log(` ${A.dim(`-`)} ${e.path} ${t}`)}if(console.log(),u.indexStatus===`migrated`)console.log(` ${A.green(`✓`)} ${u.indexPath}`);else if(u.indexStatus===`skipped`){let e=A.dim(`(${u.indexReason??`skipped`})`);console.log(` ${A.dim(`-`)} ${u.indexPath} ${e}`)}else console.log(` ${A.dim(`-`)} ${u.indexPath} ${A.dim(`(not found)`)}`);let p=n?A.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n ${A.bold(String(d))} migrated, ${A.bold(String(f))} skipped${p}\n`)})}function Ya(e){try{let t=JSON.parse(F(V(e,`package.json`),`utf-8`));return{...t.dependencies,...t.devDependencies}}catch{return{}}}function Xa(e,t=P,n=Ya(e)){if(n[`@forinda/kickjs-inertia`])return{staticDir:`dist/client`,siteRoot:`.`,apiPath:``,include:[`dist/client/.vite/manifest.json`,`dist/ssr`]};let r=R(e);return(t(V(r,`pnpm-workspace.yaml`))||t(V(r,`package.json`)))&&t(V(r,`web`,`package.json`))?{staticDir:`../web/dist`,siteRoot:`..`,apiPath:`/api`}:n[`@forinda/kickjs-view`]?{staticDir:`dist/public`,siteRoot:`.`,apiPath:``}:{siteRoot:`.`,apiPath:``}}function Za(e,t,n,r){let i=Xa(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 Qa(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'
1898
+ `),process.exit(1));let r=await w(process.cwd()),i=T(r),a=H(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 ${A.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let s=A.dim(`→ ${o}`),c=n?A.dim(`(dry-run)`):A.bold(`(applying)`);console.log(`\n ${A.bold(`kick codemod modules`)} ${s} ${c}`),console.log(` modulesDir: ${A.dim(a)}\n`);let l=e.backup!==!1&&!n,u=await jn(a,{dryRun:n,target:o,backup:l});if(u.backupDir){let e=u.backupDir;console.log(` ${A.green(`✓`)} backup: ${A.dim(e)}\n ${A.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else!n&&e.backup===!1&&console.log(` ${A.dim(`(--no-backup — skipping snapshot)`)}\n`);let d=0,f=0;for(let e of u.files)if(e.status===`migrated`)d++,console.log(` ${A.green(`✓`)} ${e.path}`);else{f++;let t=A.dim(`(${e.reason??`skipped`})`);console.log(` ${A.dim(`-`)} ${e.path} ${t}`)}if(console.log(),u.indexStatus===`migrated`)console.log(` ${A.green(`✓`)} ${u.indexPath}`);else if(u.indexStatus===`skipped`){let e=A.dim(`(${u.indexReason??`skipped`})`);console.log(` ${A.dim(`-`)} ${u.indexPath} ${e}`)}else console.log(` ${A.dim(`-`)} ${u.indexPath} ${A.dim(`(not found)`)}`);let p=n?A.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n ${A.bold(String(d))} migrated, ${A.bold(String(f))} skipped${p}\n`)})}function Ja(e){try{let t=JSON.parse(F(H(e,`package.json`),`utf-8`));return{...t.dependencies,...t.devDependencies}}catch{return{}}}function Ya(e,t=P,n=Ja(e)){if(n[`@forinda/kickjs-inertia`])return{staticDir:`dist/client`,siteRoot:`.`,apiPath:``,include:[`dist/client/.vite/manifest.json`,`dist/ssr`]};let r=z(e);return(t(H(r,`pnpm-workspace.yaml`))||t(H(r,`package.json`)))&&t(H(r,`web`,`package.json`))?{staticDir:`../web/dist`,siteRoot:`..`,apiPath:`/api`}:n[`@forinda/kickjs-view`]?{staticDir:`dist/public`,siteRoot:`.`,apiPath:``}:{siteRoot:`.`,apiPath:``}}function Xa(e,t,n,r){let i=Ya(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 Za(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'
1899
1899
  import { handler } from '${e}'
1900
1900
 
1901
1901
  // Where the app's build files were packaged; the platform starts this
@@ -1909,7 +1909,7 @@ export const config = {
1909
1909
  ${r.join(`
1910
1910
  `)}
1911
1911
  }
1912
- `}function $a(){return`import { fileURLToPath } from 'node:url'
1912
+ `}function Qa(){return`import { fileURLToPath } from 'node:url'
1913
1913
  import { handler } from './server.mjs'
1914
1914
 
1915
1915
  // The app's build files are copied into this function at their project
@@ -1919,11 +1919,11 @@ process.env.KICK_APP_ROOT ??= fileURLToPath(new URL('./', import.meta.url))
1919
1919
  const requestContext = () => globalThis[Symbol.for('@vercel/request-context')]?.get?.()
1920
1920
 
1921
1921
  export default (req, res) => handler.node(req, res, requestContext())
1922
- `}function eo(e){return/^\s*publish\s*=\s*["']([^"']+)["']/m.exec(e)?.[1]?.replace(/^\.\//,``).replace(/\/+$/,``)}function to(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 no(e,t){let n;try{n=ot(t,e).program}catch{return[]}let r=[],i=t=>e.slice(0,t).split(`
1923
- `).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 ro(e){let t=V(e,`src`);return P(t)?Ge(t,{recursive:!0,encoding:`utf-8`}).filter(e=>/\.m?ts$/.test(e)&&!/\.(test|spec|d)\.m?ts$/.test(e)).flatMap(e=>{let n=F(V(t,e),`utf-8`);return n.includes(`@Cron`)?no(n,`src/${e}`):[]}):[]}function io(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 ao(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(io(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 oo(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 so(e,t){let{createRequire:n}=await import(`node:module`),r=n(V(e,`package.json`)),i;try{i=r.resolve(`${t}/package.json`)}catch{i=V(e,`node_modules`,t,`package.json`)}if(!P(i))throw Error(`${t} is not installed in this project. Run: ${j(e)} add -D vite unplugin-swc @forinda/kickjs-vite`);let a=oo(JSON.parse(F(i,`utf-8`)));if(!a)throw Error(`${t} has no importable entry point`);return import(U(V(R(i),a)).href)}function co(e,t){if(!t.staticDir)return{clientFiles:`bundle`};let n=V(e,t.outDir);return{publicDir:B(n,V(e,t.staticDir)).split(H).join(`/`)}}function lo(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:V(e,`src`)}]}}}async function uo(e,t){return(await t({command:`build`,mode:`production`,isSsrBuild:!0},void 0,e))?.config}async function fo(e,t,n){let r=V(e,t.entry);if(!P(r))throw Error(`${t.entry} not found. The serverless entry exports \`handler = createHandler({ modules })\` — see the Serverless guide.`);let{build:i,loadConfigFromFile:a}=await so(e,`vite`),o=await uo(e,(e,t,n)=>a(e,t,n,`silent`)),{default:s}=await so(e,`unplugin-swc`),{devtoolsFlagPlugin:c,devtoolsStripPlugin:l,kickViewsPlugin:u}=await so(e,`@forinda/kickjs-vite`),d=Ya(e)[`@forinda/kickjs-view`]?[u(co(e,t))]:[];await i({configFile:!1,root:e,logLevel:`warn`,oxc:!1,plugins:[s.vite(),c(),l(),...d],...lo(e,o),ssr:{noExternal:!0,target:`node`},build:{ssr:!0,target:`node20`,outDir:V(e,t.outDir),emptyOutDir:!0,minify:!1,rollupOptions:{input:r,external:(n,r)=>mo(n,r?R(r):e)||t.external.includes(n)&&mo(n,e),output:{format:`esm`,entryFileNames:`server.mjs`,codeSplitting:!1}}}}),d.length&&t.staticDir&&We(V(e,t.staticDir),{recursive:!0});let f=V(e,t.outDir,`server.mjs`);return n(`bundled ${B(process.cwd(),f)}`),f}function po(e){return/^((?:@[a-z0-9][\w.-]*\/)?[a-z0-9][\w.-]*)(?:\/|$)/i.exec(e)?.[1]}function mo(e,t,n=P){let r=po(e);if(!r)return!1;for(let e=t;;e=R(e)){if(n(V(e,`node_modules`,r,`package.json`)))return!1;if(R(e)===e)return!0}}function ho(e,t){let n=B(e,t).split(H)[0];return n!==void 0&&n.startsWith(`.`)}function go(e){return e.flatMap(e=>[`/${e} /404 404!`,`/${e}/* /404 404!`])}function _o(e){try{return qe(e)}catch{return}}function vo(e,t){let n=t.filter(t=>!P(V(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 (\`${ee(j(e),`build`)}\`), or fix \`deploy.include\`.`)}function yo(e,t){let n=t.projectRoot,r=()=>Za(t.config?.deploy,n);e.command(`build:netlify`).description(`Bundle the serverless entry and write the Netlify function`).action(async()=>{let e=r();vo(n,e.include);let i=await fo(n,e,t.log),a=V(n,e.siteRoot),o=ro(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=V(a,`.netlify/v1/functions`);We(s,{recursive:!0});let c=B(s,i).split(H).join(`/`),l=e=>e.split(H).join(`/`);I(V(s,`api.mjs`),Qa(c,e.apiPath,{projectDir:l(B(s,n)),preferStatic:e.apiPath===``&&!!e.staticDir,includedFiles:e.include.flatMap(e=>{let t=l(B(s,V(n,e)));return _o(V(n,e))?.isDirectory()?[`${t}/**`]:[t]})})),t.log(`wrote ${B(process.cwd(),V(s,`api.mjs`))}`);let u=e.staticDir??e.publishDir;if(!e.staticDir)We(V(n,u),{recursive:!0}),t.log(`publish directory ready at ${B(process.cwd(),V(n,u))}`);else if(P(V(n,u))){let e=Ge(V(n,u)).filter(e=>e.startsWith(`.`));if(e.length>0){let t=V(n,u,`_redirects`),r=P(t)?F(t,`utf-8`):``,i=go(e).filter(e=>!r.includes(e));i.length>0&&I(t,`${r}${r&&!r.endsWith(`
1922
+ `}function $a(e){return/^\s*publish\s*=\s*["']([^"']+)["']/m.exec(e)?.[1]?.replace(/^\.\//,``).replace(/\/+$/,``)}function eo(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 to(e,t){let n;try{n=at(t,e).program}catch{return[]}let r=[],i=t=>e.slice(0,t).split(`
1923
+ `).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 no(e){let t=H(e,`src`);return P(t)?I(t,{recursive:!0,encoding:`utf-8`}).filter(e=>/\.m?ts$/.test(e)&&!/\.(test|spec|d)\.m?ts$/.test(e)).flatMap(e=>{let n=F(H(t,e),`utf-8`);return n.includes(`@Cron`)?to(n,`src/${e}`):[]}):[]}function ro(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 io(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(ro(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 ao(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 oo(e,t){let{createRequire:n}=await import(`node:module`),r=n(H(e,`package.json`)),i;try{i=r.resolve(`${t}/package.json`)}catch{i=H(e,`node_modules`,t,`package.json`)}if(!P(i))throw Error(`${t} is not installed in this project. Run: ${j(e)} add -D vite unplugin-swc @forinda/kickjs-vite`);let a=ao(JSON.parse(F(i,`utf-8`)));if(!a)throw Error(`${t} has no importable entry point`);return import(W(H(z(i),a)).href)}function so(e,t){if(!t.staticDir)return{clientFiles:`bundle`};let n=H(e,t.outDir);return{publicDir:V(n,H(e,t.staticDir)).split(U).join(`/`)}}function co(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:H(e,`src`)}]}}}async function lo(e,t){return(await t({command:`build`,mode:`production`,isSsrBuild:!0},void 0,e))?.config}async function uo(e,t,n){let r=H(e,t.entry);if(!P(r))throw Error(`${t.entry} not found. The serverless entry exports \`handler = createHandler({ modules })\` — see the Serverless guide.`);let{build:i,loadConfigFromFile:a}=await oo(e,`vite`),o=await lo(e,(e,t,n)=>a(e,t,n,`silent`)),{default:s}=await oo(e,`unplugin-swc`),{devtoolsFlagPlugin:c,devtoolsStripPlugin:l,kickViewsPlugin:u}=await oo(e,`@forinda/kickjs-vite`),d=Ja(e)[`@forinda/kickjs-view`]?[u(so(e,t))]:[];await i({configFile:!1,root:e,logLevel:`warn`,oxc:!1,plugins:[s.vite(),c(),l(),...d],...co(e,o),ssr:{noExternal:!0,target:`node`},build:{ssr:!0,target:`node20`,outDir:H(e,t.outDir),emptyOutDir:!0,minify:!1,rollupOptions:{input:r,external:(n,r)=>po(n,r?z(r):e)||t.external.includes(n)&&po(n,e),output:{format:`esm`,entryFileNames:`server.mjs`,codeSplitting:!1}}}}),d.length&&t.staticDir&&We(H(e,t.staticDir),{recursive:!0});let f=H(e,t.outDir,`server.mjs`);return n(`bundled ${V(process.cwd(),f)}`),f}function fo(e){return/^((?:@[a-z0-9][\w.-]*\/)?[a-z0-9][\w.-]*)(?:\/|$)/i.exec(e)?.[1]}function po(e,t,n=P){let r=fo(e);if(!r)return!1;for(let e=t;;e=z(e)){if(n(H(e,`node_modules`,r,`package.json`)))return!1;if(z(e)===e)return!0}}function mo(e,t){let n=V(e,t).split(U)[0];return n!==void 0&&n.startsWith(`.`)}function ho(e){return e.flatMap(e=>[`/${e} /404 404!`,`/${e}/* /404 404!`])}function go(e){try{return Ke(e)}catch{return}}function _o(e,t){let n=t.filter(t=>!P(H(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 (\`${ee(j(e),`build`)}\`), or fix \`deploy.include\`.`)}function vo(e,t){let n=t.projectRoot,r=()=>Xa(t.config?.deploy,n);e.command(`build:netlify`).description(`Bundle the serverless entry and write the Netlify function`).action(async()=>{let e=r();_o(n,e.include);let i=await uo(n,e,t.log),a=H(n,e.siteRoot),o=no(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=H(a,`.netlify/v1/functions`);We(s,{recursive:!0});let c=V(s,i).split(U).join(`/`),l=e=>e.split(U).join(`/`);L(H(s,`api.mjs`),Za(c,e.apiPath,{projectDir:l(V(s,n)),preferStatic:e.apiPath===``&&!!e.staticDir,includedFiles:e.include.flatMap(e=>{let t=l(V(s,H(n,e)));return go(H(n,e))?.isDirectory()?[`${t}/**`]:[t]})})),t.log(`wrote ${V(process.cwd(),H(s,`api.mjs`))}`);let u=e.staticDir??e.publishDir;if(!e.staticDir)We(H(n,u),{recursive:!0}),t.log(`publish directory ready at ${V(process.cwd(),H(n,u))}`);else if(P(H(n,u))){let e=I(H(n,u)).filter(e=>e.startsWith(`.`));if(e.length>0){let t=H(n,u,`_redirects`),r=P(t)?F(t,`utf-8`):``,i=ho(e).filter(e=>!r.includes(e));i.length>0&&L(t,`${r}${r&&!r.endsWith(`
1924
1924
  `)?`
1925
1925
  `:``}${i.join(`
1926
- `)}\n`)}}let d=V(a,`netlify.toml`);if(P(d)){let e=eo(F(d,`utf-8`)),r=B(a,V(n,u)).split(H).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();vo(n,e.include);let i=await fo(n,e,t.log),a=V(n,e.siteRoot),o=e.staticDir?V(n,e.staticDir):void 0,s=V(a,`.vercel/output`),c=V(s,`functions/api.func`);Ke(s,{recursive:!0,force:!0}),We(c,{recursive:!0}),Ue(i,V(c,`server.mjs`)),I(V(c,`index.mjs`),$a());for(let t of e.include)Ue(V(n,t),V(c,t),{recursive:!0});if(I(V(c,`.vc-config.json`),`${JSON.stringify({runtime:e.vercelRuntime,handler:`index.mjs`,launcherType:`Nodejs`,supportsResponseStreaming:!0},null,2)}\n`),o){if(!P(o))throw Error(`build:vercel: ${e.staticDir} does not exist — build the frontend first`);Ue(o,V(s,`static`),{recursive:!0,filter:e=>!ho(o,e)})}let{crons:l,warnings:u}=ao(ro(n));for(let e of u)t.log(`warning: ${e}`);let d={version:3,routes:to(e.apiPath,!!o,l.length>0),...l.length>0?{crons:l}:{}};I(V(s,`config.json`),`${JSON.stringify(d,null,2)}\n`),t.log(`wrote ${B(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 bo=()=>({id:`kick/assets`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`],async generate(e){let t=L.resolve(e.cwd,`kick.config.ts`);if(!P(t))return null;let n=await w(e.cwd);if(!n?.assetMap)return null;let r=xe(n.assetMap,e.cwd);return r.count===0?null:je(r)}}),xo="/* 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 So(e,t,n,r={}){if(e.length===0)return`${xo}
1926
+ `)}\n`)}}let d=H(a,`netlify.toml`);if(P(d)){let e=$a(F(d,`utf-8`)),r=V(a,H(n,u)).split(U).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();_o(n,e.include);let i=await uo(n,e,t.log),a=H(n,e.siteRoot),o=e.staticDir?H(n,e.staticDir):void 0,s=H(a,`.vercel/output`),c=H(s,`functions/api.func`);Ge(s,{recursive:!0,force:!0}),We(c,{recursive:!0}),Ue(i,H(c,`server.mjs`)),L(H(c,`index.mjs`),Qa());for(let t of e.include)Ue(H(n,t),H(c,t),{recursive:!0});if(L(H(c,`.vc-config.json`),`${JSON.stringify({runtime:e.vercelRuntime,handler:`index.mjs`,launcherType:`Nodejs`,supportsResponseStreaming:!0},null,2)}\n`),o){if(!P(o))throw Error(`build:vercel: ${e.staticDir} does not exist — build the frontend first`);Ue(o,H(s,`static`),{recursive:!0,filter:e=>!mo(o,e)})}let{crons:l,warnings:u}=io(no(n));for(let e of u)t.log(`warning: ${e}`);let d={version:3,routes:eo(e.apiPath,!!o,l.length>0),...l.length>0?{crons:l}:{}};L(H(s,`config.json`),`${JSON.stringify(d,null,2)}\n`),t.log(`wrote ${V(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 yo=()=>({id:`kick/assets`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`],async generate(e){let t=R.resolve(e.cwd,`kick.config.ts`);if(!P(t))return null;let n=await w(e.cwd);if(!n?.assetMap)return null;let r=xe(n.assetMap,e.cwd);return r.count===0?null:je(r)}}),bo="/* 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 xo(e,t,n,r={}){if(e.length===0)return`${bo}
1927
1927
  // (no routes discovered yet — annotate a controller method with
1928
1928
  // @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
1929
1929
  declare global {
@@ -1940,15 +1940,15 @@ declare global {
1940
1940
 
1941
1941
  /** Empty until the first route exists — see kick typegen. */
1942
1942
  export const kickRpc = {} as const
1943
- `;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=Eo(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 ${B(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??wo(e),u=c(e.responseSchema??null,e,`response`),d=s(e),f=u??`import('@forinda/kickjs').InferHandlerResponse<${d}['${e.method}']>`,p=To(e);n.push(` /**`,` * ${e.httpMethod} ${e.path}`,...p.map(e=>` * ${e}`),` */`,` ${e.method}: {`,` params: ${a}`,` body: ${o}`,` query: ${l}`,` response: ${f}`,` contextKeys: ${Co(e)}`,` }`)}n.push(` }`),l.push(n.join(`
1943
+ `;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=To(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 ${V(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??Co(e),u=c(e.responseSchema??null,e,`response`),d=s(e),f=u??`import('@forinda/kickjs').InferHandlerResponse<${d}['${e.method}']>`,p=wo(e);n.push(` /**`,` * ${e.httpMethod} ${e.path}`,...p.map(e=>` * ${e}`),` */`,` ${e.method}: {`,` params: ${a}`,` body: ${o}`,` query: ${l}`,` response: ${f}`,` contextKeys: ${So(e)}`,` }`)}n.push(` }`),l.push(n.join(`
1944
1944
  `))}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(`
1945
1945
  `);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(`
1946
- `));let h=[],g=/* @__PURE__ */ new Set;for(let[e,t]of i){let n=ko(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(`
1946
+ `));let h=[],g=/* @__PURE__ */ new Set;for(let[e,t]of i){let n=Oo(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(`
1947
1947
  `)}\n },`)}let _=[`/**`,` * Runtime route manifest for the tRPC-style sugar:`," * `createRpc(api, kickRpc)` from @forinda/kickjs-client.",` */`,`export const kickRpc = {`,...h,`} as const`].join(`
1948
- `),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=Oo(``,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(`
1948
+ `),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=Do(``,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(`
1949
1949
  `)+`
1950
- `:``,x=Do(a)+b,S=l.join(`
1951
- `);return`${xo}${x}
1950
+ `:``,x=Eo(a)+b,S=l.join(`
1951
+ `);return`${bo}${x}
1952
1952
  declare global {
1953
1953
  // eslint-disable-next-line @typescript-eslint/no-namespace
1954
1954
  namespace KickRoutes {
@@ -1960,18 +1960,18 @@ ${S}
1960
1960
  }
1961
1961
 
1962
1962
  ${_}
1963
- `}function Co(e){let t=e.contextKeys;return t==null?`string`:t.length===0?`never`:t.map(e=>JSON.stringify(e)).join(` | `)}function wo(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 To(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 Eo(e,t,n,r,i){if(!e||r===!1||e.source===null)return null;let a=Oo(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 Do(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(`
1963
+ `}function So(e){let t=e.contextKeys;return t==null?`string`:t.length===0?`never`:t.map(e=>JSON.stringify(e)).join(` | `)}function Co(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 wo(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 To(e,t,n,r,i){if(!e||r===!1||e.source===null)return null;let a=Do(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 Eo(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(`
1964
1964
  `)+`
1965
- `}function Oo(e,t,n){if(e===null)return`unknown`;let r=R(n);if(e===``){let e=B(r,t).split(H).join(`/`);return e=e.replace(/\.(ts|tsx|mts|cts)$/i,``),e.startsWith(`.`)||(e=`./`+e),e}if(!e.startsWith(`.`)&&!e.startsWith(`/`))return e;let i=R(t),a=V(i,e),o=B(r,a).split(H).join(`/`);return o=o.replace(/\.(ts|tsx|mts|cts)$/i,``),o.startsWith(`.`)||(o=`./`+o),o}function ko(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 Ao=()=>({id:`kick/routes`,outExtension:`.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){let t=await e.getScanResult({root:jo(e),cwd:e.cwd,envFile:Mo(e)}),n=e.config?.typegen?.schemaValidator??`zod`,r=L.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return So(t.routes,r,n,{onWarn:t=>e.log.warn(t)})}});function jo(e){return L.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Mo(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}const No=`@typescript/typescript6`;function Po(e){return typeof e?.createProgram==`function`}function Fo(e){if(Po(e.typescript))return{api:e.typescript,source:`typescript`};if(Po(e.ts6))return{api:e.ts6,source:No};let t=`Install it in the project:\n ${j()} add -D ${No}`;throw e.typescript?Error(`kick typegen: the client route map needs a TypeScript compiler API.
1966
- 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 '${No}' resolved from this project.\n ${t}`)}async function Io(e){let t=He(z(e,`package.json`)),n=async e=>{try{return await import(U(t.resolve(e)).href)}catch{return null}},[r,i]=await Promise.all([n(`typescript`),n(No)]);return Fo({typescript:Lo(r),ts6:Lo(i)}).api}function Lo(e){let t=e;return t?.default&&typeof t.default==`object`?t.default:e}const Ro=Symbol(`kick/client: expansion budget exhausted`);var zo=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!==Ro)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 Ro;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=`
1965
+ `}function Do(e,t,n){if(e===null)return`unknown`;let r=z(n);if(e===``){let e=V(r,t).split(U).join(`/`);return e=e.replace(/\.(ts|tsx|mts|cts)$/i,``),e.startsWith(`.`)||(e=`./`+e),e}if(!e.startsWith(`.`)&&!e.startsWith(`/`))return e;let i=z(t),a=H(i,e),o=V(r,a).split(U).join(`/`);return o=o.replace(/\.(ts|tsx|mts|cts)$/i,``),o.startsWith(`.`)||(o=`./`+o),o}function Oo(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 ko=()=>({id:`kick/routes`,outExtension:`.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){let t=await e.getScanResult({root:Ao(e),cwd:e.cwd,envFile:jo(e)}),n=e.config?.typegen?.schemaValidator??`zod`,r=R.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return xo(t.routes,r,n,{onWarn:t=>e.log.warn(t)})}});function Ao(e){return R.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function jo(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}const Mo=`@typescript/typescript6`;function No(e){return typeof e?.createProgram==`function`}function Po(e){if(No(e.typescript))return{api:e.typescript,source:`typescript`};if(No(e.ts6))return{api:e.ts6,source:Mo};let t=`Install it in the project:\n ${j()} add -D ${Mo}`;throw e.typescript?Error(`kick typegen: the client route map needs a TypeScript compiler API.
1966
+ 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 '${Mo}' resolved from this project.\n ${t}`)}async function Fo(e){let t=He(B(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(Mo)]);return Po({typescript:Io(r),ts6:Io(i)}).api}function Io(e){let t=e;return t?.default&&typeof t.default==`object`?t.default:e}const Lo=Symbol(`kick/client: expansion budget exhausted`);var Ro=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!==Lo)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 Lo;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=`
1967
1967
  `){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===`
1968
1968
  `?`
1969
- `: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 Bo=[`pnpm-lock.yaml`,`package-lock.json`,`yarn.lock`,`bun.lock`,`bun.lockb`],Vo=/(?:^|[\\/])(?:node_modules|\.kickjs)(?:[\\/]|$)/;function Ho(e){return at(`sha1`).update(e).digest(`hex`)}function Uo(e){let t=at(`sha1`);t.update(e.cliVersion),t.update(JSON.stringify(e.options??{})),t.update(e.keys.join(`
1970
- `));for(let n of Bo){let r=z(e.projectDir,n);if(P(r))try{t.update(F(r))}catch(e){throw Error(`kick/client: cannot read lockfile ${r}`,{cause:e})}}for(let n of e.fileNames.toSorted())if(!Vo.test(n)){t.update(n);try{t.update(F(n))}catch(e){throw Error(`kick/client: cannot read project file ${n}`,{cause:e})}}return t.digest(`hex`)}async function Wo(e){try{let t=await Io(e.compilerFrom??e.projectDir),n={...t.sys,onUnRecoverableConfigFileDiagnostic:()=>{}},r=t.getParsedCommandLineOfConfigFile(z(e.projectDir,`tsconfig.json`),{},n);return r?Uo({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 Go(e){let t=await Io(e.compilerFrom??e.projectDir),n=z(R(e.routesFile),`__kick_client_probe__.ts`),r=Jo(e.routesFile,e.keys),i=Zo(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.`);Ko(t,i,e.routesFile);let s=Yo(t,i,o,e.keys),c=null,l=new zo(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===qo(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 Ko(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(`
1971
- `);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 qo(e){return`_K${e}`}function Jo(e,t){let n=`./`+Je(e).replace(/\.tsx?$/,``),r=t.map((e,t)=>`type ${qo(t)} = KickRoutes.Api[${JSON.stringify(e)}]`);return[`import ${JSON.stringify(n)}`,...r].join(`
1969
+ `: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 zo=[`pnpm-lock.yaml`,`package-lock.json`,`yarn.lock`,`bun.lock`,`bun.lockb`],Bo=/(?:^|[\\/])(?:node_modules|\.kickjs)(?:[\\/]|$)/;function Vo(e){return it(`sha1`).update(e).digest(`hex`)}function Ho(e){let t=it(`sha1`);t.update(e.cliVersion),t.update(JSON.stringify(e.options??{})),t.update(e.keys.join(`
1970
+ `));for(let n of zo){let r=B(e.projectDir,n);if(P(r))try{t.update(F(r))}catch(e){throw Error(`kick/client: cannot read lockfile ${r}`,{cause:e})}}for(let n of e.fileNames.toSorted())if(!Bo.test(n)){t.update(n);try{t.update(F(n))}catch(e){throw Error(`kick/client: cannot read project file ${n}`,{cause:e})}}return t.digest(`hex`)}async function Uo(e){try{let t=await Fo(e.compilerFrom??e.projectDir),n={...t.sys,onUnRecoverableConfigFileDiagnostic:()=>{}},r=t.getParsedCommandLineOfConfigFile(B(e.projectDir,`tsconfig.json`),{},n);return r?Ho({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 Wo(e){let t=await Fo(e.compilerFrom??e.projectDir),n=B(z(e.routesFile),`__kick_client_probe__.ts`),r=qo(e.routesFile,e.keys),i=Xo(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.`);Go(t,i,e.routesFile);let s=Jo(t,i,o,e.keys),c=null,l=new Ro(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===Ko(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 Go(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(`
1971
+ `);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 Ko(e){return`_K${e}`}function qo(e,t){let n=`./`+qe(e).replace(/\.tsx?$/,``),r=t.map((e,t)=>`type ${Ko(t)} = KickRoutes.Api[${JSON.stringify(e)}]`);return[`import ${JSON.stringify(n)}`,...r].join(`
1972
1972
  `)+`
1973
- `}function Yo(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(qo(t));r&&e.start>=r.getStart(n)&&e.start<r.getEnd()&&i.add(o)}return i}function Xo(e,t){let n=e.filter(e=>/\.d\.(ts|mts|cts)$/.test(e)),r=[];try{r=Ge(t).filter(e=>e.endsWith(`.ts`)).map(e=>z(t,e))}catch{}return[.../* @__PURE__ */ new Set([...n,...r])]}function Zo(e,t,n,r){let i=z(t,`tsconfig.json`),a={...e.sys,onUnRecoverableConfigFileDiagnostic:t=>{throw Error(e.flattenDiagnosticMessageText(t.messageText,`
1974
- `))}},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:[...Xo(o.fileNames,R(n)),n],options:o.options,host:s})}const Qo=`/* eslint-disable */
1973
+ `}function Jo(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(Ko(t));r&&e.start>=r.getStart(n)&&e.start<r.getEnd()&&i.add(o)}return i}function Yo(e,t){let n=e.filter(e=>/\.d\.(ts|mts|cts)$/.test(e)),r=[];try{r=I(t).filter(e=>e.endsWith(`.ts`)).map(e=>B(t,e))}catch{}return[.../* @__PURE__ */ new Set([...n,...r])]}function Xo(e,t,n,r){let i=B(t,`tsconfig.json`),a={...e.sys,onUnRecoverableConfigFileDiagnostic:t=>{throw Error(e.flattenDiagnosticMessageText(t.messageText,`
1974
+ `))}},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:[...Yo(o.fileNames,z(n)),n],options:o.options,host:s})}const Zo=`/* eslint-disable */
1975
1975
  // AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
1976
1976
  //
1977
1977
  // Self-contained: this file has no imports, so a frontend consumes it without
@@ -1985,7 +1985,7 @@ ${_}
1985
1985
  //
1986
1986
  // Written when \`kick dev\` starts, not on save — resolving these types builds a
1987
1987
  // full TypeScript program over the server. Re-run \`kick typegen\`.
1988
- `;function $o(e,t){let n=t.filter(t=>e.entries.has(t));if(n.length===0)return`${Qo}
1988
+ `;function Qo(e,t){let n=t.filter(t=>e.entries.has(t));if(n.length===0)return`${Zo}
1989
1989
  // (no routes discovered yet — annotate a controller method with
1990
1990
  // @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
1991
1991
  interface Api {}
@@ -2002,7 +2002,7 @@ export type { Api }
2002
2002
 
2003
2003
  `)+`
2004
2004
 
2005
- `:``,i=n.map(t=>` ${JSON.stringify(t)}: ${e.entries.get(t)}`);return`${Qo}
2005
+ `:``,i=n.map(t=>` ${JSON.stringify(t)}: ${e.entries.get(t)}`);return`${Zo}
2006
2006
  ${r}interface Api {
2007
2007
  ${i.join(`
2008
2008
  `)}
@@ -2016,7 +2016,7 @@ declare global {
2016
2016
  }
2017
2017
 
2018
2018
  export type { Api }
2019
- `}const es=`kick/client`,$=`.kickjs/types/kick__client.d.ts`,ts=`.kickjs/cache/client-map.sha1`,ns=(()=>{try{return He(import.meta.url)(`../../../package.json`).version??`0.0.0`}catch{return`0.0.0`}})();function rs(e){try{if(!P(e))return null;let[t,n]=F(e,`utf-8`).trim().split(/\s+/);return t&&n?{inputs:t,output:n}:null}catch{return null}}function is(e){return`${$n}${es} */\n\n${e}\n`}function as(e){try{return P(e)?F(e,`utf-8`):null}catch{return null}}async function os(e){let t=L.resolve(e.cwd,$);if(!P(t))return!1;try{await nt(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 ss(e){let t=e?.typegen?.client;return typeof t==`object`?t.maxDepth:void 0}function cs(e){let t=e.config?.typegen?.client;return typeof t==`boolean`?t:t&&typeof t==`object`?t.enabled!==!1:(P(L.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 ls=()=>({id:es,outExtension:`.d.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){if(!cs(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:L.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=ss(e.config),a=await Wo({projectDir:e.cwd,keys:n,maxDepth:i,cliVersion:ns}),o=rs(L.resolve(e.cwd,ts)),s=as(L.resolve(e.cwd,$));if(a&&o&&s!==null&&o.inputs===a&&o.output===Ho(s))return Vn()&&e.log.info?.(` kick/client: unchanged, keeping ${$}`),null;try{let t=$o(await Go({projectDir:e.cwd,routesFile:L.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(ts,`${a} ${Ho(is(t))}`),t}catch(t){let n=P(L.resolve(e.cwd,$)),r=` kick/client: skipped — ${t instanceof Error?t.message:String(t)}`;return n?e.log.warn(r):Vn()&&e.log.info?.(r),n&&await os(e),null}}});function us(e,t,n=`zod`){if(!e)return null;let r=R(t),i=B(r,e.filePath).split(H).join(`/`);return i=i.replace(/\.(ts|tsx|mts|cts)$/i,``),i.startsWith(`.`)||(i=`./`+i),`/* eslint-disable */
2019
+ `}const $o=`kick/client`,es=`.kickjs/types/kick__client.d.ts`,ts=`.kickjs/cache/client-map.sha1`,ns=(()=>{try{return He(import.meta.url)(`../../../package.json`).version??`0.0.0`}catch{return`0.0.0`}})();function rs(e){try{if(!P(e))return null;let[t,n]=F(e,`utf-8`).trim().split(/\s+/);return t&&n?{inputs:t,output:n}:null}catch{return null}}function is(e){return`${Qn}${$o} */\n\n${e}\n`}function as(e){try{return P(e)?F(e,`utf-8`):null}catch{return null}}async function os(e){let t=R.resolve(e.cwd,es);if(!P(t))return!1;try{await tt(t,{force:!0})}catch(t){return e.log.warn(` kick/client: could not remove the stale ${es} — treat it as out of date (${t instanceof Error?t.message:String(t)})`),!0}return e.log.warn(` kick/client: removed the previously generated ${es} rather than leave a stale one — re-run \`kick typegen\` once the cause above is fixed.`),!0}function ss(e){let t=e?.typegen?.client;return typeof t==`object`?t.maxDepth:void 0}function cs(e){let t=e.config?.typegen?.client;return typeof t==`boolean`?t:t&&typeof t==`object`?t.enabled!==!1:(P(R.resolve(e.cwd,es))&&e.log.warn(` kick/client: ${es} 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 ls=()=>({id:$o,outExtension:`.d.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){if(!cs(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:R.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=ss(e.config),a=await Uo({projectDir:e.cwd,keys:n,maxDepth:i,cliVersion:ns}),o=rs(R.resolve(e.cwd,ts)),s=as(R.resolve(e.cwd,es));if(a&&o&&s!==null&&o.inputs===a&&o.output===Vo(s))return Bn()&&e.log.info?.(` kick/client: unchanged, keeping ${es}`),null;try{let t=Qo(await Wo({projectDir:e.cwd,routesFile:R.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(ts,`${a} ${Vo(is(t))}`),t}catch(t){let n=P(R.resolve(e.cwd,es)),r=` kick/client: skipped — ${t instanceof Error?t.message:String(t)}`;return n?e.log.warn(r):Bn()&&e.log.info?.(r),n&&await os(e),null}}});function us(e,t,n=`zod`){if(!e)return null;let r=z(t),i=V(r,e.filePath).split(U).join(`/`);return i=i.replace(/\.(ts|tsx|mts|cts)$/i,``),i.startsWith(`.`)||(i=`./`+i),`/* eslint-disable */
2020
2020
  // AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
2021
2021
  // Re-run with \`kick typegen\` or rely on \`kick dev\` to refresh.
2022
2022
 
@@ -2054,5 +2054,5 @@ declare global {
2054
2054
  }
2055
2055
 
2056
2056
  export {}
2057
- `}const ds=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=ps(e);if(t===!1)return null;let n=await e.getScanResult({root:fs(e),cwd:e.cwd,envFile:t});if(!n.env)return null;let r=e.config?.typegen?.schemaValidator??`zod`,i=L.resolve(e.cwd,`.kickjs/types/kick__env.ts`);return us(n.env,i,r)}});function fs(e){return L.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function ps(e){return e.config?.typegen?.envFile}function ms(e){return L.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function hs(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function gs(e){return{root:ms(e),cwd:e.cwd,envFile:hs(e)}}const _s=()=>({id:`kick/registry`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(gs(e)),n=L.resolve(e.cwd,`.kickjs/types/kick__registry.d.ts`),r=new Set(t.collisions.map(e=>e.className));return Te(t.classes,n,r)}}),vs=()=>({id:`kick/services`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(gs(e)),n=new Set(t.collisions.map(e=>e.className)),r=ke(t.classes,t.tokens,t.injects,n);return Ae(`ServiceToken`,r,"(no tokens discovered — declare with createToken<T>() or `kick g service <name>`)")}}),ys=()=>({id:`kick/modules`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(gs(e));return Ae(`ModuleToken`,Ce(t.classes),"(no @Module classes discovered — `kick g module <name>` to add one)")}}),bs=()=>({id:`kick/plugins`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(gs(e));return we(t.pluginsAndAdapters)}}),xs=()=>({id:`kick/context`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(gs(e));return t.contextKeys.length===0?null:Ie(t.contextKeys)}}),Ss=()=>({id:`kick/route-flags`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(gs(e));return Me(t.routeFlags)}}),Cs={express:{subpath:`@forinda/kickjs/express`,typeName:`ExpressRuntimeTypes`},fastify:{subpath:`@forinda/kickjs/fastify`,typeName:`FastifyRuntimeTypes`},h3:{subpath:`@forinda/kickjs/h3`,typeName:`H3RuntimeTypes`}},ws=()=>({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}=Cs[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(`
2058
- `)}});var Ts=/* @__PURE__ */ e({builtinCliPlugins:()=>Es});const Es=[E({name:`kick/init`,register:ft}),E({name:`kick/generate`,register:Zn}),E({name:`kick/run`,register:yr}),E({name:`kick/info`,register:wr}),E({name:`kick/inspect`,register:Pr}),E({name:`kick/add`,register:_}),E({name:`kick/runtime-swap`,register:Zr}),E({name:`kick/list`,register:a}),E({name:`kick/explain`,register:di}),E({name:`kick/mcp`,register:Si}),E({name:`kick/tinker`,register:Ei}),E({name:`kick/remove`,register:Mi}),E({name:`kick/typegen`,register:Fi}),E({name:`kick/check`,register:ea}),E({name:`kick/doctor`,register:Ra}),E({name:`kick/env-command`,register:Ka}),E({name:`kick/codemod`,register:Ja}),E({name:`kick/deploy`,register:yo}),E({name:`kick/registry`,typegens:[_s()]}),E({name:`kick/services`,typegens:[vs()]}),E({name:`kick/modules`,typegens:[ys()]}),E({name:`kick/plugins`,typegens:[bs()]}),E({name:`kick/context`,typegens:[xs()]}),E({name:`kick/route-flags`,typegens:[Ss()]}),E({name:`kick/assets`,typegens:[bo()]}),E({name:`kick/routes`,typegens:[Ao()]}),E({name:`kick/client`,typegens:[ls()]}),E({name:`kick/env`,typegens:[ds()]}),E({name:`kick/runtime`,typegens:[ws()]})];export{rr as n,Es as t};
2057
+ `}const ds=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=ps(e);if(t===!1)return null;let n=await e.getScanResult({root:fs(e),cwd:e.cwd,envFile:t});if(!n.env)return null;let r=e.config?.typegen?.schemaValidator??`zod`,i=R.resolve(e.cwd,`.kickjs/types/kick__env.ts`);return us(n.env,i,r)}});function fs(e){return R.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function ps(e){return e.config?.typegen?.envFile}function ms(e){return R.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function hs(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function gs(e){return{root:ms(e),cwd:e.cwd,envFile:hs(e)}}const _s=()=>({id:`kick/registry`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(gs(e)),n=R.resolve(e.cwd,`.kickjs/types/kick__registry.d.ts`),r=new Set(t.collisions.map(e=>e.className));return Te(t.classes,n,r)}}),vs=()=>({id:`kick/services`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(gs(e)),n=new Set(t.collisions.map(e=>e.className)),r=ke(t.classes,t.tokens,t.injects,n);return Ae(`ServiceToken`,r,"(no tokens discovered — declare with createToken<T>() or `kick g service <name>`)")}}),ys=()=>({id:`kick/modules`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(gs(e));return Ae(`ModuleToken`,Ce(t.classes),"(no @Module classes discovered — `kick g module <name>` to add one)")}}),bs=()=>({id:`kick/plugins`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(gs(e));return we(t.pluginsAndAdapters)}}),xs=()=>({id:`kick/context`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(gs(e));return t.contextKeys.length===0?null:Ie(t.contextKeys)}}),Ss=()=>({id:`kick/route-flags`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(gs(e));return Me(t.routeFlags)}}),Cs={express:{subpath:`@forinda/kickjs/express`,typeName:`ExpressRuntimeTypes`},fastify:{subpath:`@forinda/kickjs/fastify`,typeName:`FastifyRuntimeTypes`},h3:{subpath:`@forinda/kickjs/h3`,typeName:`H3RuntimeTypes`}},ws=()=>({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}=Cs[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(`
2058
+ `)}});var Ts=/* @__PURE__ */ e({builtinCliPlugins:()=>Es});const Es=[E({name:`kick/init`,register:dt}),E({name:`kick/generate`,register:Xn}),E({name:`kick/run`,register:vr}),E({name:`kick/info`,register:Cr}),E({name:`kick/inspect`,register:Nr}),E({name:`kick/add`,register:_}),E({name:`kick/runtime-swap`,register:Xr}),E({name:`kick/list`,register:a}),E({name:`kick/explain`,register:ui}),E({name:`kick/mcp`,register:xi}),E({name:`kick/tinker`,register:Ti}),E({name:`kick/remove`,register:ji}),E({name:`kick/typegen`,register:Pi}),E({name:`kick/check`,register:$i}),E({name:`kick/doctor`,register:La}),E({name:`kick/env-command`,register:Ga}),E({name:`kick/codemod`,register:qa}),E({name:`kick/deploy`,register:vo}),E({name:`kick/registry`,typegens:[_s()]}),E({name:`kick/services`,typegens:[vs()]}),E({name:`kick/modules`,typegens:[ys()]}),E({name:`kick/plugins`,typegens:[bs()]}),E({name:`kick/context`,typegens:[xs()]}),E({name:`kick/route-flags`,typegens:[Ss()]}),E({name:`kick/assets`,typegens:[yo()]}),E({name:`kick/routes`,typegens:[ko()]}),E({name:`kick/client`,typegens:[ls()]}),E({name:`kick/env`,typegens:[ds()]}),E({name:`kick/runtime`,typegens:[ws()]})];export{nr as n,Es as t};