@forinda/kickjs-cli 8.14.8 → 8.16.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.
- package/dist/agent-docs-DhiaLsBj.mjs +591 -0
- package/dist/agent-docs-DhiaLsBj.mjs.map +1 -0
- package/dist/agent-docs-lNvu1K1x.mjs +590 -0
- package/dist/{build-cXg5ZlrG.mjs → build-BNHMWtNY.mjs} +2 -2
- package/dist/{build-Ch7Mu-zN.mjs → build-vY0bmwuH.mjs} +3 -3
- package/dist/{build-Ch7Mu-zN.mjs.map → build-vY0bmwuH.mjs.map} +1 -1
- package/dist/{builtins-Cj-H0MpD.mjs → builtins-CRRb7Lq1.mjs} +2 -2
- package/dist/{builtins-1iFKUPC8.mjs → builtins-tE4nrAZ_.mjs} +59 -59
- package/dist/cli.mjs +2 -2
- package/dist/{config-DJ3Yuos3.mjs → config-mXO3F69m.mjs} +2 -2
- package/dist/{config-LzGMuzP3.mjs → config-zWl1-NCq.mjs} +3 -3
- package/dist/{config-LzGMuzP3.mjs.map → config-zWl1-NCq.mjs.map} +1 -1
- package/dist/{doctor-hrYL914U.mjs → doctor-z92r35fo.mjs} +9 -9
- package/dist/{doctor-hrYL914U.mjs.map → doctor-z92r35fo.mjs.map} +1 -1
- package/dist/{fullstack-BDk2Min0.mjs → fullstack-BqevN8LJ.mjs} +13 -13
- package/dist/{fullstack-BDk2Min0.mjs.map → fullstack-BqevN8LJ.mjs.map} +1 -1
- package/dist/{fullstack-DOx3kvFi.mjs → fullstack-eMi-9BtZ.mjs} +9 -9
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +2 -2
- package/dist/{plugin-h1RvCxk1.mjs → plugin-BbbHEAzr.mjs} +2 -2
- package/dist/{plugin-DmerIwIH.mjs → plugin-CH4X4T0O.mjs} +2 -2
- package/dist/project-Bp6SIRyt.mjs +132 -0
- package/dist/project-D96UoR0P.mjs +133 -0
- package/dist/project-D96UoR0P.mjs.map +1 -0
- package/dist/{project-root-DBTLa3ee.mjs → project-root-Bw3CEPC7.mjs} +3 -3
- package/dist/{project-root-DBTLa3ee.mjs.map → project-root-Bw3CEPC7.mjs.map} +1 -1
- package/dist/{project-root-DQwgpeEX.mjs → project-root-DN0YbQE5.mjs} +2 -2
- package/dist/{rolldown-runtime-UeWuLvbj.mjs → rolldown-runtime-CYy3EyO3.mjs} +1 -1
- package/dist/{run-plugins-CajtgfCU.mjs → run-plugins-f7i7TlPV.mjs} +67 -67
- package/dist/run-plugins-f7i7TlPV.mjs.map +1 -0
- package/dist/{typegen-BsYWuduu.mjs → typegen-Bq4Fis9G.mjs} +5 -5
- package/dist/{typegen-BsYWuduu.mjs.map → typegen-Bq4Fis9G.mjs.map} +1 -1
- package/dist/{typegen-DmSQleE5.mjs → typegen-_x_Q5O0b.mjs} +4 -4
- package/dist/{types-CX1RqHCf.mjs → types-BLZecxnS.mjs} +1 -1
- package/package.json +3 -3
- package/templates/base/files/_dot_vscode/extensions.json +3 -0
- package/templates/base/files/kick.config.ts +4 -0
- package/templates/base/skills/add-adapter.txt +56 -0
- package/templates/base/skills/add-module.txt +53 -0
- package/templates/base/skills/add-plugin.txt +69 -0
- package/templates/base/skills/bootstrap-export.txt +21 -0
- package/templates/base/skills/cli-commands-cheatsheet.txt +46 -0
- package/templates/base/skills/cli-plugin.txt +61 -0
- package/templates/base/skills/context-contributor.txt +73 -0
- package/templates/base/skills/deny-list.txt +44 -0
- package/templates/base/skills/deploy.txt +99 -0
- package/templates/base/skills/docs-lookup.txt +40 -0
- package/templates/base/skills/env-wiring-check.txt +44 -0
- package/templates/base/skills/guard-vs-middleware-vs-contributor.txt +95 -0
- package/templates/base/skills/query-parsing-list-endpoint.txt +48 -0
- package/templates/base/skills/refresh-agent-docs.txt +27 -0
- package/templates/base/skills/route-flags.txt +73 -0
- package/templates/base/skills/thin-entry-file.txt +49 -0
- package/templates/base/skills/use-asset-manager.txt +61 -0
- package/templates/base/skills/write-controller-test.txt +63 -0
- package/templates/feature-views/feature.json +21 -0
- package/templates/feature-views/files/src/adapters/views.ts +5 -0
- package/templates/feature-views/files/src/views/home.kick +3 -0
- package/templates/feature-views/files/src/views/layouts/main.kick +13 -0
- package/templates/feature-views/files/src/views.ts +9 -0
- package/templates/feature-views/skills/views-forms.txt +68 -0
- package/templates/feature-views/skills/views.txt +49 -0
- package/templates/fullstack-root/files/_dot_vscode/extensions.json +3 -0
- package/dist/agent-docs-BLpdFCWy.mjs +0 -932
- package/dist/agent-docs-c9x_je96.mjs +0 -933
- package/dist/agent-docs-c9x_je96.mjs.map +0 -1
- package/dist/package-manager-DMNCUv5Z.mjs +0 -12
- package/dist/package-manager-DMNCUv5Z.mjs.map +0 -1
- package/dist/package-manager-W-gJGan_.mjs +0 -11
- package/dist/project-BhLkKHOD.mjs +0 -135
- package/dist/project-CXcAR-tR.mjs +0 -136
- package/dist/project-CXcAR-tR.mjs.map +0 -1
- package/dist/run-plugins-CajtgfCU.mjs.map +0 -1
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs-cli v8.
|
|
2
|
+
* @forinda/kickjs-cli v8.16.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-UeWuLvbj.mjs";import{T as t,_ as n,a as r,d as i,f as a,g as o,h as s,l as c,m as l,n as u,o as d,p as f,r as p,s as m,t as h,u as g,v as _,w as v,y}from"./project-BhLkKHOD.mjs";import{a as b,c as x,d as S,f as ee,i as te,l as ne,m as re,o as C,p as ie,s as w,u as ae}from"./config-DJ3Yuos3.mjs";import{n as oe,r as T}from"./plugin-DmerIwIH.mjs";import{_ as E,a as se,c as D,d as ce,f as le,g as O,h as ue,i as de,l as fe,m as pe,n as me,o as k,p as A,r as he,s as ge,t as j,u as _e}from"./package-manager-W-gJGan_.mjs";import{t as M}from"./project-root-DQwgpeEX.mjs";import{n as ve}from"./agent-docs-BLpdFCWy.mjs";import{C as ye,S as be,_ as xe,a as Se,b as Ce,c as we,d as Te,f as Ee,g as De,h as Oe,i as ke,l as Ae,m as je,o as Me,p as Ne,r as Pe,s as Fe,t as Ie,u as Le,v as Re,w as ze,x as Be,y as Ve}from"./typegen-DmSQleE5.mjs";import{t as He}from"./build-cXg5ZlrG.mjs";import{createRequire as Ue}from"node:module";import{cpSync as We,existsSync as N,mkdirSync as Ge,readFileSync as P,readdirSync as F,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`}];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(`-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)=>{se(`KickJS — Create a new project`);let n=p(),r=e=>{e&&k.warn(`kick ${h} 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){k.error(e.message),D(`Aborted.`),process.exitCode=1;return}let a=!!(t.yes||t.nonInteractive);e||=a?`my-api`:await ce({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let o;if(e===`.`?(o=V(`.`),e=Je(o)):o=V(t.directory||e),N(o)){let n=F(o);if(n.length>0){if(t.force)k.warn(`Clearing existing files in ${o}`);else if(a){k.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),D(`Aborted.`);return}else{k.warn(`Directory "${e}" is not empty:`);let t=n.slice(0,5);for(let e of t)k.message(` - ${e}`);if(n.length>5&&k.message(` ... and ${n.length-5} more`),!await de({message:A.red(`Remove all existing files and proceed?`),initialValue:!1})){D(`Aborted.`);return}}for(let e of n)Ke(V(o,e),{recursive:!0,force:!0})}}a||r(await Promise.race([n,new Promise(e=>setTimeout(e,3e3,null).unref())]));let s=t.template;s||=a?`minimal`:await fe({message:`Project template`,options:[{value:`rest`,label:`REST API`,hint:`Express + Swagger`},{value:`minimal`,label:`Minimal`,hint:`bare Express`},{value:`fullstack`,label:`Fullstack`,hint:`server + Vite React web, typed client`},{value:`inertia`,label:`Inertia`,hint:`server-driven React pages, one app, SSR`}]});let c=t.runtime;c||=a?`express`:await fe({message:`HTTP runtime`,options:[{value:`express`,label:`Express`,hint:`default, zero-config`},{value:`fastify`,label:`Fastify`,hint:`fastify + @fastify/middie`},{value:`h3`,label:`h3`,hint:`Nitro / Nuxt engine`}]});let l=t.pm;l||=a?await me(void 0):await fe({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let d=t.repo;d||=a?`inmemory`:await ce({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),re(d);let f=t.schema;s===`inertia`&&(f&&f!==`zod`&&k.warn(`The inertia template uses zod — ignoring --schema ${f}.`),f=`zod`),f||=a?`zod`:await fe({message:`Schema library (env + DTO validation)`,options:[{value:`zod`,label:`Zod`,hint:`default — broad ecosystem`},{value:`valibot`,label:`Valibot`,hint:`smaller bundle`},{value:`yup`,label:`Yup`,hint:`classic API`}]}),[`zod`,`valibot`,`yup`].includes(f)||(k.warn(`Unknown --schema "${f}", falling back to zod.`),f=`zod`);let m;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();m=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else m=a?[]:await ge({message:`Select packages to include`,options:[...dt],required:!1});let g;g=t.git===void 0?a?!0:await de({message:`Initialize git repository?`,initialValue:!0}):t.git;let _;if(_=t.install===void 0?a?!0:await de({message:`Install dependencies?`,initialValue:!0}):t.install,t.frontend!==void 0&&t.frontend!==`kick`&&t.frontend!==`vite`){k.error(`Unknown --frontend '${String(t.frontend)}'. Use 'kick' (wired React app) or 'vite' (create-vite).`),D(`Aborted.`);return}let{VITE_TEMPLATES:v,DEFAULT_VITE_TEMPLATE:b}=await import(`./fullstack-DOx3kvFi.mjs`);if(t.viteTemplate!==void 0&&!v.some(e=>e.value===t.viteTemplate)){k.error(`Unknown --vite-template '${String(t.viteTemplate)}'. TypeScript templates only: ${v.map(e=>e.value).join(`, `)}.`),D(`Aborted.`);return}let x=t.frontend===`vite`?`vite`:`kick`,S=t.viteTemplate??b;if(s===`fullstack`&&!t.frontend&&!a&&(x=await fe({message:`Frontend for web/`,options:[{value:`kick`,label:`KickJS React app`,hint:`typed client, /api proxy, route types — wired`},{value:`vite`,label:`Delegate to create-vite`,hint:`pick any framework; wiring is manual (guide printed after)`}]})),x===`vite`&&!t.viteTemplate&&!a&&(S=await fe({message:`create-vite template`,options:v.map(e=>({value:e.value,label:e.label})),initialValue:b})),s===`fullstack`){let{initFullstackProject:t}=await import(`./fullstack-DOx3kvFi.mjs`);await t({name:e,directory:o,packageManager:l,initGit:g,installDeps:_,schemaLib:f,runtime:c,packages:m,frontend:x,viteTemplate:S,deploy:i}),a&&r(await n),D(`Done! Next steps: ${A.cyan(`cd ${e} && ${l}${l===`pnpm`?` dev`:` run dev:server`}`)}`)}else await u({name:e,directory:o,packageManager:l,initGit:g,installDeps:_,template:s,defaultRepo:d,packages:m,schemaLib:f,runtime:c,deploy:i}),a&&r(await n),D(`Done! Next steps: ${A.cyan(`cd ${e} && ${ee(l,`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??M(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(!N(t))return{generators:[],loaded:[],failed:[]};let n=St(JSON.parse(await W(t,`utf-8`))),r=Ue(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(!N(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 E(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-CYy3EyO3.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-Bp6SIRyt.mjs";import{a as b,c as x,d as S,f as ee,i as te,l as ne,m as re,o as C,p as ie,s as w,u as ae}from"./config-mXO3F69m.mjs";import{n as oe,r as T}from"./plugin-CH4X4T0O.mjs";import{C as E,S as D,_ as se,a as ce,c as le,d as O,f as ue,g as k,h as de,i as A,l as j,m as fe,n as pe,o as me,p as he,s as ge,u as _e,x as ve}from"./agent-docs-lNvu1K1x.mjs";import{t as M}from"./project-root-DN0YbQE5.mjs";import{C as ye,S as be,_ as xe,a as Se,b as Ce,c as we,d as Te,f as Ee,g as De,h as Oe,i as ke,l as Ae,m as je,o as Me,p as Ne,r as Pe,s as Fe,t as Ie,u as Le,v as Re,w as ze,x as Be,y as Ve}from"./typegen-_x_Q5O0b.mjs";import{t as He}from"./build-BNHMWtNY.mjs";import{createRequire as Ue}from"node:module";import{cpSync as We,existsSync as N,mkdirSync as Ge,readFileSync as P,readdirSync as F,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(`-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)=>{le(`KickJS — Create a new project`);let n=m(),r=e=>{e&&j.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){j.error(e.message),O(`Aborted.`),process.exitCode=1;return}let a=!!(t.yes||t.nonInteractive);e||=a?`my-api`:await fe({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let o;if(e===`.`?(o=V(`.`),e=Je(o)):o=V(t.directory||e),N(o)){let n=F(o);if(n.length>0){if(t.force)j.warn(`Clearing existing files in ${o}`);else if(a){j.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),O(`Aborted.`);return}else{j.warn(`Directory "${e}" is not empty:`);let t=n.slice(0,5);for(let e of t)j.message(` - ${e}`);if(n.length>5&&j.message(` ... and ${n.length-5} more`),!await ge({message:k.red(`Remove all existing files and proceed?`),initialValue:!1})){O(`Aborted.`);return}}for(let e of n)Ke(V(o,e),{recursive:!0,force:!0})}}a||r(await Promise.race([n,new Promise(e=>setTimeout(e,3e3,null).unref())]));let s=t.template;s||=a?`minimal`:await ue({message:`Project template`,options:[{value:`rest`,label:`REST API`,hint:`Express + Swagger`},{value:`minimal`,label:`Minimal`,hint:`bare Express`},{value:`fullstack`,label:`Fullstack`,hint:`server + Vite React web, typed client`},{value:`inertia`,label:`Inertia`,hint:`server-driven React pages, one app, SSR`}]});let c=t.runtime;c||=a?`express`:await ue({message:`HTTP runtime`,options:[{value:`express`,label:`Express`,hint:`default, zero-config`},{value:`fastify`,label:`Fastify`,hint:`fastify + @fastify/middie`},{value:`h3`,label:`h3`,hint:`Nitro / Nuxt engine`}]});let l=t.pm;l||=a?await ce(void 0):await ue({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let u=t.repo;u||=a?`inmemory`:await fe({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),re(u);let f=t.schema;s===`inertia`&&(f&&f!==`zod`&&j.warn(`The inertia template uses zod — ignoring --schema ${f}.`),f=`zod`),f||=a?`zod`:await ue({message:`Schema library (env + DTO validation)`,options:[{value:`zod`,label:`Zod`,hint:`default — broad ecosystem`},{value:`valibot`,label:`Valibot`,hint:`smaller bundle`},{value:`yup`,label:`Yup`,hint:`classic API`}]}),[`zod`,`valibot`,`yup`].includes(f)||(j.warn(`Unknown --schema "${f}", falling back to zod.`),f=`zod`);let p;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();p=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else p=a?[]:await _e({message:`Select packages to include`,options:[...dt],required:!1});let h;h=t.git===void 0?a?!0:await ge({message:`Initialize git repository?`,initialValue:!0}):t.git;let _;if(_=t.install===void 0?a?!0:await ge({message:`Install dependencies?`,initialValue:!0}):t.install,t.frontend!==void 0&&t.frontend!==`kick`&&t.frontend!==`vite`){j.error(`Unknown --frontend '${String(t.frontend)}'. Use 'kick' (wired React app) or 'vite' (create-vite).`),O(`Aborted.`);return}let{VITE_TEMPLATES:v,DEFAULT_VITE_TEMPLATE:b}=await import(`./fullstack-eMi-9BtZ.mjs`);if(t.viteTemplate!==void 0&&!v.some(e=>e.value===t.viteTemplate)){j.error(`Unknown --vite-template '${String(t.viteTemplate)}'. TypeScript templates only: ${v.map(e=>e.value).join(`, `)}.`),O(`Aborted.`);return}let x=t.frontend===`vite`?`vite`:`kick`,S=t.viteTemplate??b;if(s===`fullstack`&&!t.frontend&&!a&&(x=await ue({message:`Frontend for web/`,options:[{value:`kick`,label:`KickJS React app`,hint:`typed client, /api proxy, route types — wired`},{value:`vite`,label:`Delegate to create-vite`,hint:`pick any framework; wiring is manual (guide printed after)`}]})),x===`vite`&&!t.viteTemplate&&!a&&(S=await ue({message:`create-vite template`,options:v.map(e=>({value:e.value,label:e.label})),initialValue:b})),s===`fullstack`){let{initFullstackProject:t}=await import(`./fullstack-eMi-9BtZ.mjs`);await t({name:e,directory:o,packageManager:l,initGit:h,installDeps:_,schemaLib:f,runtime:c,packages:p,frontend:x,viteTemplate:S,deploy:i}),a&&r(await n),O(`Done! Next steps: ${k.cyan(`cd ${e} && ${l}${l===`pnpm`?` dev`:` run dev:server`}`)}`)}else await d({name:e,directory:o,packageManager:l,initGit:h,installDeps:_,template:s,defaultRepo:u,packages:p,schemaLib:f,runtime:c,deploy:i}),a&&r(await n),O(`Done! Next steps: ${k.cyan(`cd ${e} && ${ee(l,`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??M(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(!N(t))return{generators:[],loaded:[],failed:[]};let n=St(JSON.parse(await W(t,`utf-8`))),r=Ue(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(!N(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 E(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=`/**
|
|
12
12
|
* ${t} Module
|
|
13
13
|
*
|
|
14
14
|
* REST module with a flat folder structure.
|
|
@@ -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
|
|
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 ve(n)&&!await ge({message:`File exists: ${k.dim(e)}. Overwrite?`,initialValue:!1})?j.warn(`Skipped: ${e}`):(await E(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 ve(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}]
|
|
@@ -1386,7 +1386,7 @@ export class ${s}Controller {
|
|
|
1386
1386
|
export const ${c}Schema = ${Rt(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 N(t)&&!e.force&&!await
|
|
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 N(t)&&!e.force&&!await ge({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
|
|
1390
1390
|
Skipped — existing kick.config.ts preserved.`),[]):(await E(t,`import { defineConfig } from '@forinda/kickjs-cli'
|
|
1391
1391
|
|
|
1392
1392
|
export default defineConfig({
|
|
@@ -1496,31 +1496,31 @@ describe('${s}', () => {
|
|
|
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 C(process.cwd()),i=w(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??Zt(i.repo);t.repo&&re(t.repo);let s=t.pattern??r?.pattern??`rest`,c=x(t.pluralize,i),l=ne(t.pluralizeRoutes,i),u=S(r,process.cwd()),d=b(M()),f=ae(M()),p=M(),m=te(p,`@forinda/kickjs-testing`,`any`)&&te(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 ${
|
|
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);
|
|
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);
|
|
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 C(process.cwd()),i=w(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??Zt(i.repo);t.repo&&re(t.repo);let s=t.pattern??r?.pattern??`rest`,c=x(t.pluralize,i),l=ne(t.pluralizeRoutes,i),u=S(r,process.cwd()),d=b(M()),f=ae(M()),p=M(),m=te(p,`@forinda/kickjs-testing`,`any`)&&te(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 ${k.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n ${k.dim(`Project setting:`)} modules.style: 'define' (default)\n\n ${k.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 ${k.bold(`Pick one:`)}\n 1. Migrate everything to defineModule:\n ${k.dim(`$`)} kick codemod modules --experimental --apply\n 2. Keep the class form — pin it in kick.config.ts:\n ${k.dim(`// kick.config.ts`)}\n ${k.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:ie(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);D(a);let[o,s,...c]=e;if(o){let e=await C(process.cwd()),n=oe(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);D(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);D(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);D(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);D(r);let i=await C(process.cwd()),a=w(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);D(r);let i=await C(process.cwd()),a=w(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)
|
|
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);
|
|
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);
|
|
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);
|
|
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);
|
|
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);
|
|
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);D(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 C(process.cwd()),o=w(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);D(r);let i=await C(process.cwd()),a=w(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);D(r);let i=await C(process.cwd()),a=w(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);D(r);let i=await C(process.cwd()),a=w(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:ae(M())}),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);D(r);let i=await C(process.cwd()),a=w(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:ie(M())}),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);
|
|
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);D(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 C(process.cwd()),s=w(o),c=i.modulesDir??s.dir??`src/modules`,l=Fn(t),u=S(o,process.cwd()),d=b(M()),f=await In({name:e,fields:l,modulesDir:V(c),noEntity:i.entity===!1,noTests:i.tests===!1,pluralize:x(i.pluralize,s),pluralizeRoutes:ne(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);
|
|
1518
|
-
`,u=``;N(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=[...
|
|
1517
|
+
`),process.exit(1));let o=await C(process.cwd()),s=w(o),c=i.modulesDir??s.dir??`src/modules`,l=Fn(t),u=S(o,process.cwd()),d=b(M()),f=await In({name:e,fields:l,modulesDir:V(c),noEntity:i.entity===!1,noTests:i.tests===!1,pluralize:x(i.pluralize,s),pluralizeRoutes:ne(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);D(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);D(n);let r=e.only??`all`;Un.includes(r)?Y(await pe({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);D(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);D(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??Oe,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?De(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=``;N(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=[...Ts,...e.config?.plugins??[]],{enabled:n,skipped:r,unknown:i}=nr(oe(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-_x_Q5O0b.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-_x_Q5O0b.mjs`).then(e=>e.n)).writeTypegenArtifacts(e,t,n),buildAssets:async(e,t)=>(await import(`./build-BNHMWtNY.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(N(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(N(n)||N(r))return dr(n,r).some(n=>fr(n,B(t,e)))?t:void 0}}function dr(e,t){try{if(N(e)){let t=P(e,`utf-8`).split(/^packages:\s*$/m)[1]??``,n=[];for(let e of t.split(`
|
|
1519
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(P(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(`
|
|
1520
1520
|
`):`${n.slice(0,t).join(`
|
|
1521
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 C(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await Ie({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 ke(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(`
|
|
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 C(e);try{await Ie({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 ke(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: ${
|
|
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 C(e);try{await Ie({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 ke(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: ${A()} 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
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 C(process.cwd()),i=r?.copyDirs??[];if(i.length>0){console.log(`
|
|
@@ -1531,20 +1531,20 @@ describe('${s}', () => {
|
|
|
1531
1531
|
Building asset map...`);try{await He(e,{cwd:process.cwd()}),console.log(`
|
|
1532
1532
|
Asset build complete.
|
|
1533
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 ${
|
|
1535
|
-
Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function br(){try{let e=R(Ye(import.meta.url));return JSON.parse(P(z(e,`..`,`package.json`),`utf-8`)).version??`unknown`}catch{return`unknown`}}const xr=new Set(Object.values(
|
|
1536
|
-
`))})}const{bold:X,dim:Z,green:Tr,red:Er,yellow:Dr,blue:Or}=
|
|
1534
|
+
No type-checker found. Install one in this project:\n ${A(t)} add -D typescript (tsc)\n ${A(t)} add -D @typescript/native-preview (tsgo, faster)\n`),process.exit(1);return}let r=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(P(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(!N(t))return[];let n;try{n=JSON.parse(P(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(N(i))try{n=JSON.parse(P(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(N(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}=k;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(` ${de(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
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(`
|
|
1538
1538
|
`,a)+1;if(/^\s*$/.test(e.slice(c,a))){a=c;let t=e.lastIndexOf(`
|
|
1539
1539
|
`,a-2)+1;e.slice(t,a-1).trim()===Ir&&(a=t);let n=e.indexOf(`
|
|
1540
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
|
|
1542
|
-
`);return}let
|
|
1543
|
-
`),process.exitCode=1;return}let
|
|
1544
|
-
`).forEach((t,
|
|
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=>N(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(P(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?P(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:P(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))}),te=[];for(let{file:e,text:t}of _)t.split(`
|
|
1544
|
+
`).forEach((t,n)=>{(Yr[o].test(t)||/\bctx\.res\./.test(t))&&te.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(`
|
|
1545
1545
|
Dry run: nothing changed.
|
|
1546
|
-
`),$r(
|
|
1547
|
-
`),ne||(process.exitCode=1)})}function Qr(e){let{from:t,to:n,installed:
|
|
1546
|
+
`),$r(m.manual,te,o);return}I(z(r,s),m.source),g!==null&&I(z(r,d),g);let ne=!0;if(t.install!==!1){let{pm:e}=await me(t.pm),i=t=>{let i=[e,...t].join(` `);console.log(`\n ${i}`);try{n(e,t,{cwd:r})}catch{ne=!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,te,o),console.log(ne?" Done. Run `kick typegen` and your typecheck to see the rest.\n":` Files changed; the package step above did not finish.
|
|
1547
|
+
`),ne||(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(P(z(e,`package.json`),`utf-8`));return{dependencies:t.dependencies??{},devDependencies:t.devDependencies??{}}}catch{return{dependencies:{},devDependencies:{}}}}function ti(e){return N(e)?F(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
|
|
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
|
|
@@ -1766,12 +1766,12 @@ Then re-run \`kick explain --ai "<your error>"\`.`};let r;try{r=await import(`@f
|
|
|
1766
1766
|
kick add ai
|
|
1767
1767
|
|
|
1768
1768
|
Or manually:
|
|
1769
|
-
${
|
|
1769
|
+
${A()} 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
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.
|
|
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(
|
|
1774
|
+
${ee(A(),`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
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
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
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=>N(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(`
|
|
@@ -1790,7 +1790,7 @@ Pass a message as a positional arg, --message flag, or pipe via stdin:
|
|
|
1790
1790
|
`)}function yi(e,t){return e.split(`
|
|
1791
1791
|
`).map(e=>`${t}${e}`).join(`
|
|
1792
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);N(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(N(i))try{let e=P(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(!N(t))return null;try{let e=P(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);N(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: ${
|
|
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(!N(t))return null;try{let e=P(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);N(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: ${A(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`
|
|
1794
1794
|
import 'reflect-metadata'
|
|
1795
1795
|
|
|
1796
1796
|
// Prevent bootstrap() from starting the HTTP server
|
|
@@ -1846,11 +1846,11 @@ server.on('exit', () => {
|
|
|
1846
1846
|
})
|
|
1847
1847
|
`}function Oi(e,t){for(let n of lr(e)){let e=z(n,t);if(N(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]!==`
|
|
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
|
|
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 ve(z(n,s))&&await ve(z(n,a))&&(s=a);let c=z(n,s);if(!await ve(c)){console.log(`\n Module not found: ${c}\n`);return}if(!r&&!await ge({message:k.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
|
|
1851
|
+
`);return}await nt(c,{recursive:!0,force:!0}),console.log(` Deleted: ${c}`);let l=z(n,`index.ts`);if(await ve(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,`
|
|
1852
1852
|
|
|
1853
|
-
`),e!==t&&(await E(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 C(process.cwd()),r=w(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=M(process.cwd()),n=await C(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-
|
|
1853
|
+
`),e!==t&&(await E(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 C(process.cwd()),r=w(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=M(process.cwd()),n=await C(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-CH4X4T0O.mjs`).then(e=>e.t),{builtinCliPlugins:t}=await Promise.resolve().then(()=>ws),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:
|
|
@@ -1866,19 +1866,19 @@ server.on('exit', () => {
|
|
|
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();
|
|
1869
|
+
`);return}let t=process.cwd();le(e.deploy?`KickJS Deploy Check`:`KickJS DI Check`);let n=he();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)j.message(`${se(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?k.red(`${a} critical`):`${a} critical`,o>0?k.yellow(`${o} ${c}`):`${o} ${c}`,`${s} info`].join(`, `);a>0?(O(k.red(`${l} — fix critical issues before deploying`)),process.exit(1)):O(k.green(`${l} — looking good!`))})}function ta(e){try{return JSON.parse(P(e,`utf-8`))}catch{return null}}function na(e){try{return P(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]!==`
|
|
1870
1870
|
`;)n++;t+=`
|
|
1871
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(N(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(N(e)){try{if(qe(e).isDirectory()){let t=z(e,`tsconfig.json`);return N(t)?t:null}}catch{return null}return e}let t=`${e}.json`;return N(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: ${
|
|
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: ${A(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: ${A(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: ${A(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(P(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 ${A(e.cwd)} add ${t.prod})`}:{name:n,status:`pass`,message:`native multipart`}}const _a=2e3;function va(e){let t=z(e,`src`);if(!N(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=F(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: ${A(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=>N(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=>N(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=F(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(!N(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=>N(z(e.cwd,t))))return null;let t=Da.filter(t=>N(z(e.cwd,t)));if(t.length===0)return null;let n=Ea.filter(t=>N(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
|
|
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: ${
|
|
1880
|
-
`).map(e=>` ${
|
|
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 C(e)),n=await
|
|
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: ${A(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||!N(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 k.green(`✔`);case`warn`:return k.yellow(`⚠`);case`fail`:return k.red(`✖`)}}function Fa(e){let t=Pa(e.status),n=e.message?` ${k.dim(`(${e.message})`)}`:``;return`${t} ${e.name}${n}`}function Ia(e){return e.split(`
|
|
1880
|
+
`).map(e=>` ${k.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 C(e)),n=await o(e);le(`KickJS Doctor`);let r=await Na(e,{extraChecks:t,runtime:n});for(let e of r)j.message(Fa(e)),e.fix&&e.status!==`pass`&&j.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=[k.green(`${i} passed`),a>0?k.yellow(`${a} warning${a===1?``:`s`}`):`${a} warnings`,s>0?k.red(`${s} error${s===1?``:`s`}`):`${s} errors`].join(`, `);s>0?(O(`${c} — fix the errors above before running the app`),process.exit(1)):O(a>0?`${c} — review the warnings`:k.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)}function Ha(e){let t=[];for(let n of e){let e=[n.description,n.list?`comma-separated list`:void 0].filter(Boolean);for(let n of e.length>0?e.join(` — `).split(/\r?\n/):[])t.push(`# ${n}`);n.required?t.push(`${n.name}=`):t.push(`# ${n.name}=${n.default===void 0?``:Va(n.default)}`)}return t}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
|
|
@@ -1890,12 +1890,12 @@ and supply env from the test runner.`}}function Aa(e){let t={...e.pkg?.dependenc
|
|
|
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=Ka(t)||!e.apply;
|
|
1894
|
-
`+
|
|
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;D(n),e.experimental||(console.error(`
|
|
1894
|
+
`+k.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 C(process.cwd()),i=w(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 ${
|
|
1898
|
+
`),process.exit(1));let r=await C(process.cwd()),i=w(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 ${k.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let s=k.dim(`→ ${o}`),c=n?k.dim(`(dry-run)`):k.bold(`(applying)`);console.log(`\n ${k.bold(`kick codemod modules`)} ${s} ${c}`),console.log(` modulesDir: ${k.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(` ${k.green(`✓`)} backup: ${k.dim(e)}\n ${k.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else!n&&e.backup===!1&&console.log(` ${k.dim(`(--no-backup — skipping snapshot)`)}\n`);let d=0,f=0;for(let e of u.files)if(e.status===`migrated`)d++,console.log(` ${k.green(`✓`)} ${e.path}`);else{f++;let t=k.dim(`(${e.reason??`skipped`})`);console.log(` ${k.dim(`-`)} ${e.path} ${t}`)}if(console.log(),u.indexStatus===`migrated`)console.log(` ${k.green(`✓`)} ${u.indexPath}`);else if(u.indexStatus===`skipped`){let e=k.dim(`(${u.indexReason??`skipped`})`);console.log(` ${k.dim(`-`)} ${u.indexPath} ${e}`)}else console.log(` ${k.dim(`-`)} ${u.indexPath} ${k.dim(`(not found)`)}`);let p=n?k.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n ${k.bold(String(d))} migrated, ${k.bold(String(f))} skipped${p}\n`)})}function Ja(e){try{let t=JSON.parse(P(V(e,`package.json`),`utf-8`));return{...t.dependencies,...t.devDependencies}}catch{return{}}}function Ya(e,t=N,n=Ja(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 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
|
|
@@ -1920,10 +1920,10 @@ const requestContext = () => globalThis[Symbol.for('@vercel/request-context')]?.
|
|
|
1920
1920
|
|
|
1921
1921
|
export default (req, res) => handler.node(req, res, requestContext())
|
|
1922
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=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 no(e){let t=V(e,`src`);return N(t)?F(t,{recursive:!0,encoding:`utf-8`}).filter(e=>/\.m?ts$/.test(e)&&!/\.(test|spec|d)\.m?ts$/.test(e)).flatMap(e=>{let n=P(V(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(V(e,`package.json`)),i;try{i=r.resolve(`${t}/package.json`)}catch{i=V(e,`node_modules`,t,`package.json`)}if(!N(i))throw Error(`${t} is not installed in this project. Run: ${
|
|
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=V(e,`src`);return N(t)?F(t,{recursive:!0,encoding:`utf-8`}).filter(e=>/\.m?ts$/.test(e)&&!/\.(test|spec|d)\.m?ts$/.test(e)).flatMap(e=>{let n=P(V(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(V(e,`package.json`)),i;try{i=r.resolve(`${t}/package.json`)}catch{i=V(e,`node_modules`,t,`package.json`)}if(!N(i))throw Error(`${t} is not installed in this project. Run: ${A(e)} add -D vite unplugin-swc @forinda/kickjs-vite`);let a=ao(JSON.parse(P(i,`utf-8`)));if(!a)throw Error(`${t} has no importable entry point`);return import(U(V(R(i),a)).href)}function so(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 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:V(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=V(e,t.entry);if(!N(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:V(e,t.outDir),emptyOutDir:!0,minify:!1,rollupOptions:{input:r,external:(n,r)=>po(n,r?R(r):e)||t.external.includes(n)&&po(n,e),output:{format:`esm`,entryFileNames:`server.mjs`,codeSplitting:!1}}}}),d.length&&t.staticDir&&Ge(V(e,t.staticDir),{recursive:!0});let f=V(e,t.outDir,`server.mjs`);return n(`bundled ${B(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=N){let r=fo(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 mo(e,t){let n=B(e,t).split(H)[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 qe(e)}catch{return}}function _o(e,t){let n=t.filter(t=>!N(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(A(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=V(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=V(a,`.netlify/v1/functions`);Ge(s,{recursive:!0});let c=B(s,i).split(H).join(`/`),l=e=>e.split(H).join(`/`);I(V(s,`api.mjs`),Za(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 go(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)Ge(V(n,u),{recursive:!0}),t.log(`publish directory ready at ${B(process.cwd(),V(n,u))}`);else if(N(V(n,u))){let e=F(V(n,u)).filter(e=>e.startsWith(`.`));if(e.length>0){let t=V(n,u,`_redirects`),r=N(t)?P(t,`utf-8`):``,i=ho(e).filter(e=>!r.includes(e));i.length>0&&I(t,`${r}${r&&!r.endsWith(`
|
|
1924
1924
|
`)?`
|
|
1925
1925
|
`:``}${i.join(`
|
|
1926
|
-
`)}\n`)}}let d=V(a,`netlify.toml`);if(N(d)){let e=$a(P(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();
|
|
1926
|
+
`)}\n`)}}let d=V(a,`netlify.toml`);if(N(d)){let e=$a(P(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();_o(n,e.include);let i=await uo(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}),Ge(c,{recursive:!0}),We(i,V(c,`server.mjs`)),I(V(c,`index.mjs`),Qa());for(let t of e.include)We(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(!N(o))throw Error(`build:vercel: ${e.staticDir} does not exist — build the frontend first`);We(o,V(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}:{}};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 yo=()=>({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(!N(t))return null;let n=await C(e.cwd);if(!n?.assetMap)return null;let r=Se(n.assetMap,e.cwd);return r.count===0?null:Me(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=
|
|
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 ${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??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=
|
|
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=
|
|
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=
|
|
1951
|
-
`);return`${
|
|
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
|
|
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
|
|
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 '${
|
|
1965
|
+
`}function Do(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 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=L.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return xo(t.routes,r,n,{onWarn:t=>e.log.warn(t)})}});function Ao(e){return L.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 ${A()} 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=Ue(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(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
|
|
1970
|
-
`));for(let n of
|
|
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
|
|
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 at(`sha1`).update(e).digest(`hex`)}function Ho(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 zo){let r=z(e.projectDir,n);if(N(r))try{t.update(P(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(P(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(z(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=z(R(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=`./`+Je(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
|
|
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:[...
|
|
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=F(t).filter(e=>e.endsWith(`.ts`)).map(e=>z(t,e))}catch{}return[.../* @__PURE__ */ new Set([...n,...r])]}function Xo(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:[...Yo(o.fileNames,R(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
|
|
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`${
|
|
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
|
|
2019
|
+
`}const $o=`kick/client`,$=`.kickjs/types/kick__client.d.ts`,es=`.kickjs/cache/client-map.sha1`,ts=(()=>{try{return Ue(import.meta.url)(`../../../package.json`).version??`0.0.0`}catch{return`0.0.0`}})();function ns(e){try{if(!N(e))return null;let[t,n]=P(e,`utf-8`).trim().split(/\s+/);return t&&n?{inputs:t,output:n}:null}catch{return null}}function rs(e){return`${$n}${$o} */\n\n${e}\n`}function is(e){try{return N(e)?P(e,`utf-8`):null}catch{return null}}async function as(e){let t=L.resolve(e.cwd,$);if(!N(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 os(e){let t=e?.typegen?.client;return typeof t==`object`?t.maxDepth:void 0}function ss(e){let t=e.config?.typegen?.client;return typeof t==`boolean`?t:t&&typeof t==`object`?t.enabled!==!1:(N(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 cs=()=>({id:$o,outExtension:`.d.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){if(!ss(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=os(e.config),a=await Uo({projectDir:e.cwd,keys:n,maxDepth:i,cliVersion:ts}),o=ns(L.resolve(e.cwd,es)),s=is(L.resolve(e.cwd,$));if(a&&o&&s!==null&&o.inputs===a&&o.output===Vo(s))return Vn()&&e.log.info?.(` kick/client: unchanged, keeping ${$}`),null;try{let t=Qo(await Wo({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(es,`${a} ${Vo(rs(t))}`),t}catch(t){let n=N(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 as(e),null}}});function ls(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 */
|
|
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
|
|
2058
|
-
`)}});var
|
|
2057
|
+
`}const us=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=fs(e);if(t===!1)return null;let n=await e.getScanResult({root:ds(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 ls(n.env,i,r)}});function ds(e){return L.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function fs(e){return e.config?.typegen?.envFile}function ps(e){return L.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function ms(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function hs(e){return{root:ps(e),cwd:e.cwd,envFile:ms(e)}}const gs=()=>({id:`kick/registry`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(hs(e)),n=L.resolve(e.cwd,`.kickjs/types/kick__registry.d.ts`),r=new Set(t.collisions.map(e=>e.className));return Ee(t.classes,n,r)}}),_s=()=>({id:`kick/services`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(hs(e)),n=new Set(t.collisions.map(e=>e.className)),r=Ae(t.classes,t.tokens,t.injects,n);return je(`ServiceToken`,r,"(no tokens discovered — declare with createToken<T>() or `kick g service <name>`)")}}),vs=()=>({id:`kick/modules`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(hs(e));return je(`ModuleToken`,we(t.classes),"(no @Module classes discovered — `kick g module <name>` to add one)")}}),ys=()=>({id:`kick/plugins`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(hs(e));return Te(t.pluginsAndAdapters)}}),bs=()=>({id:`kick/context`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(hs(e));return t.contextKeys.length===0?null:Le(t.contextKeys)}}),xs=()=>({id:`kick/route-flags`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(hs(e));return Ne(t.routeFlags)}}),Ss={express:{subpath:`@forinda/kickjs/express`,typeName:`ExpressRuntimeTypes`},fastify:{subpath:`@forinda/kickjs/fastify`,typeName:`FastifyRuntimeTypes`},h3:{subpath:`@forinda/kickjs/h3`,typeName:`H3RuntimeTypes`}},Cs=()=>({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}=Ss[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 ws=/* @__PURE__ */ e({builtinCliPlugins:()=>Ts});const Ts=[T({name:`kick/init`,register:ft}),T({name:`kick/generate`,register:Zn}),T({name:`kick/run`,register:yr}),T({name:`kick/info`,register:wr}),T({name:`kick/inspect`,register:Pr}),T({name:`kick/add`,register:_}),T({name:`kick/runtime-swap`,register:Zr}),T({name:`kick/list`,register:a}),T({name:`kick/explain`,register:di}),T({name:`kick/mcp`,register:Si}),T({name:`kick/tinker`,register:Ei}),T({name:`kick/remove`,register:Mi}),T({name:`kick/typegen`,register:Fi}),T({name:`kick/check`,register:ea}),T({name:`kick/doctor`,register:Ra}),T({name:`kick/env-command`,register:Ga}),T({name:`kick/codemod`,register:qa}),T({name:`kick/deploy`,register:vo}),T({name:`kick/registry`,typegens:[gs()]}),T({name:`kick/services`,typegens:[_s()]}),T({name:`kick/modules`,typegens:[vs()]}),T({name:`kick/plugins`,typegens:[ys()]}),T({name:`kick/context`,typegens:[bs()]}),T({name:`kick/route-flags`,typegens:[xs()]}),T({name:`kick/assets`,typegens:[yo()]}),T({name:`kick/routes`,typegens:[ko()]}),T({name:`kick/client`,typegens:[cs()]}),T({name:`kick/env`,typegens:[us()]}),T({name:`kick/runtime`,typegens:[Cs()]})];export{rr as n,Ts as t};
|