@forinda/kickjs-cli 8.1.5 → 8.1.6
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-BK33p0Pw.mjs → agent-docs-BBlVl1tY.mjs} +2 -2
- package/dist/{agent-docs-DzaWoZc7.mjs → agent-docs-CW5TQHti.mjs} +3 -3
- package/dist/{agent-docs-DzaWoZc7.mjs.map → agent-docs-CW5TQHti.mjs.map} +1 -1
- package/dist/{build-DBT23vXN.mjs → build-DOI_zYDS.mjs} +3 -3
- package/dist/{build-DBT23vXN.mjs.map → build-DOI_zYDS.mjs.map} +1 -1
- package/dist/{build-clh7HpZV.mjs → build-htBdOg51.mjs} +2 -2
- package/dist/{builtins-HdwKAx0s.mjs → builtins-Cj4BWpIe.mjs} +2 -2
- package/dist/{builtins-B6Dc2coA.mjs → builtins-SMK1mtlk.mjs} +104 -8
- package/dist/cli.mjs +2 -2
- package/dist/{config-CzL24fBQ.mjs → config-BYSNxf_t.mjs} +2 -2
- package/dist/{config-D06pHD-Y.mjs → config-DST3ilXt.mjs} +3 -3
- package/dist/{config-D06pHD-Y.mjs.map → config-DST3ilXt.mjs.map} +1 -1
- package/dist/{doctor-Bi_jVzha.mjs → doctor-CJYTXARe.mjs} +4 -4
- package/dist/{doctor-Bi_jVzha.mjs.map → doctor-CJYTXARe.mjs.map} +1 -1
- package/dist/{fullstack-DAEEITND.mjs → fullstack-19gafr4U.mjs} +3 -3
- package/dist/{fullstack-CdAbknb3.mjs → fullstack-Mkw3lkF1.mjs} +4 -4
- package/dist/{fullstack-CdAbknb3.mjs.map → fullstack-Mkw3lkF1.mjs.map} +1 -1
- package/dist/index.mjs +2 -2
- package/dist/{plugin-CD9WjquV.mjs → plugin-Cfiz2G3K.mjs} +3 -3
- package/dist/{plugin-CD9WjquV.mjs.map → plugin-Cfiz2G3K.mjs.map} +1 -1
- package/dist/{plugin-BSNGbECd.mjs → plugin-IEDGa0ny.mjs} +2 -2
- package/dist/{project-DfBzpCeE.mjs → project-5ljMCm0U.mjs} +4 -4
- package/dist/{project-indmSdfC.mjs → project-CAamSqrL.mjs} +5 -5
- package/dist/{project-indmSdfC.mjs.map → project-CAamSqrL.mjs.map} +1 -1
- package/dist/{project-docs-DRLN1EDX.mjs → project-docs-CYCi7cHt.mjs} +1 -1
- package/dist/{project-docs-BCwWphge.mjs → project-docs-at2gZlUE.mjs} +2 -2
- package/dist/{project-docs-BCwWphge.mjs.map → project-docs-at2gZlUE.mjs.map} +1 -1
- package/dist/{project-root-BsyQhlS5.mjs → project-root-BhBKSGeK.mjs} +2 -2
- package/dist/{project-root-CQCNCAvv.mjs → project-root-PMRCA_2T.mjs} +3 -3
- package/dist/{project-root-CQCNCAvv.mjs.map → project-root-PMRCA_2T.mjs.map} +1 -1
- package/dist/{prompts-Ba0PO3Rn.mjs → prompts-BxPTyuY3.mjs} +2 -2
- package/dist/{prompts-Ba0PO3Rn.mjs.map → prompts-BxPTyuY3.mjs.map} +1 -1
- package/dist/{rolldown-runtime-DmTqmRjS.mjs → rolldown-runtime-D-i_dFAb.mjs} +1 -1
- package/dist/{run-plugins-BKWupYoJ.mjs → run-plugins-GxEtP9WR.mjs} +160 -64
- package/dist/run-plugins-GxEtP9WR.mjs.map +1 -0
- package/dist/{typegen-CnsfSSpH.mjs → typegen-CJvd5MEz.mjs} +5 -5
- package/dist/{typegen-CnsfSSpH.mjs.map → typegen-CJvd5MEz.mjs.map} +1 -1
- package/dist/{typegen-B6vIx4Qd.mjs → typegen-D7aeVM0D.mjs} +4 -4
- package/dist/{types-B6yNws8R.mjs → types-PxKCj-JF.mjs} +1 -1
- package/package.json +1 -1
- package/dist/run-plugins-BKWupYoJ.mjs.map +0 -1
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs-cli v8.1.
|
|
2
|
+
* @forinda/kickjs-cli v8.1.6
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{c as e,l as t,s as n}from"./project-docs-
|
|
11
|
+
import{c as e,l as t,s as n}from"./project-docs-at2gZlUE.mjs";import{a as r,c as i,d as a,i as o,l as s,n as c,o as l,r as u,s as d,t as f,u as p}from"./prompts-BxPTyuY3.mjs";import{A as m,C as h,D as g,E as _,M as v,N as y,O as ee,P as b,S as te,T as ne,_ as re,a as ie,b as ae,c as oe,f as se,g as ce,h as le,i as ue,j as de,k as x,l as fe,m as pe,p as me,r as he,u as ge,v as _e,w as ve,x as ye,y as be}from"./doctor-CJYTXARe.mjs";import{a as xe,c as Se,o as Ce,r as we,t as Te,u as Ee}from"./project-CAamSqrL.mjs";import{a as De,c as Oe,i as ke,l as Ae,o as S,s as C,u as je}from"./config-DST3ilXt.mjs";import{t as w}from"./project-root-PMRCA_2T.mjs";import{n as T}from"./types-PxKCj-JF.mjs";import{t as Me}from"./build-DOI_zYDS.mjs";import{n as Ne}from"./agent-docs-CW5TQHti.mjs";import{n as Pe}from"./plugin-Cfiz2G3K.mjs";import{_ as Fe,a as Ie,c as Le,d as Re,f as ze,g as Be,h as Ve,i as He,l as Ue,m as We,o as Ge,p as Ke,r as qe,s as Je,t as E,u as Ye}from"./typegen-CJvd5MEz.mjs";import{createRequire as Xe}from"node:module";import D,{basename as Ze,dirname as O,join as k,relative as Qe,resolve as A,sep as $e}from"node:path";import{cpSync as et,existsSync as j,mkdirSync as tt,readFileSync as M,readdirSync as nt,rmSync as rt,writeFileSync as it}from"node:fs";import{copyFile as at,mkdir as N,readFile as P,readdir as ot,rm as st,stat as ct,writeFile as F}from"node:fs/promises";import{fork as lt,spawn as ut,spawnSync as dt}from"node:child_process";import{fileURLToPath as ft,pathToFileURL as I}from"node:url";import{arch as pt,platform as mt,release as ht}from"node:os";import{createHash as gt}from"node:crypto";const _t=[{value:`swagger`,label:`Swagger`,hint:`OpenAPI docs`},{value:`ws`,label:`WebSocket`,hint:`rooms, heartbeat`},{value:`queue`,label:`Queue`,hint:`BullMQ/RabbitMQ/Kafka`},{value:`devtools`,label:`DevTools`,hint:`debug dashboard`}];function vt(e){e.command(`new [name]`).alias(`init`).description(`Create a new KickJS project (use "." for current directory)`).option(`-d, --directory <dir>`,`Target directory (defaults to project name)`).option(`--pm <manager>`,`Package manager: pnpm | npm | yarn | bun`).option(`--git`,`Initialize git repository`).option(`--no-git`,`Skip git initialization`).option(`--install`,`Install dependencies after scaffolding`).option(`--no-install`,`Skip dependency installation`).option(`-f, --force`,`Remove existing files without prompting`).option(`-t, --template <type>`,`Project template: rest | minimal | fullstack`).option(`--runtime <engine>`,`HTTP runtime: express | fastify | h3`).option(`-r, --repo <type>`,`Repository name (inmemory, or any DB name e.g. postgres)`).option(`-s, --schema <lib>`,`Schema library for env / DTOs: zod | valibot | yup (default: zod)`).option(`--packages <packages>`,`Comma-separated packages to include (e.g. swagger,ws,queue,devtools)`).option(`-y, --yes`,`Pick safe defaults for every prompt (template=minimal, repo=inmemory, no extras, git+install on)`).option(`--non-interactive`,`alias for --yes`).action(async(e,t)=>{c(`KickJS — Create a new project`);let n=!!(t.yes||t.nonInteractive);e||=n?`my-api`:await i({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let a;if(e===`.`?(a=A(`.`),e=Ze(a)):a=A(t.directory||e),j(a)){let i=nt(a);if(i.length>0){if(t.force)u.warn(`Clearing existing files in ${a}`);else if(n){u.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),r(`Aborted.`);return}else{u.warn(`Directory "${e}" is not empty:`);let t=i.slice(0,5);for(let e of t)u.message(` - ${e}`);if(i.length>5&&u.message(` ... and ${i.length-5} more`),!await f({message:p.red(`Remove all existing files and proceed?`),initialValue:!1})){r(`Aborted.`);return}}for(let e of i)rt(A(a,e),{recursive:!0,force:!0})}}let s=t.template;s||=n?`minimal`:await l({message:`Project template`,options:[{value:`rest`,label:`REST API`,hint:`Express + Swagger`},{value:`minimal`,label:`Minimal`,hint:`bare Express`},{value:`fullstack`,label:`Fullstack`,hint:`server + Vite React web, typed client`}]});let d=t.runtime;d||=n?`express`:await l({message:`HTTP runtime`,options:[{value:`express`,label:`Express`,hint:`default, zero-config`},{value:`fastify`,label:`Fastify`,hint:`fastify + @fastify/middie`},{value:`h3`,label:`h3`,hint:`Nitro / Nuxt engine`}]});let m=t.pm;m||=n?await Se(void 0):await l({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let h=t.repo;h||=n?`inmemory`:await i({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),je(h);let g=t.schema;g||=n?`zod`:await l({message:`Schema library (env + DTO validation)`,options:[{value:`zod`,label:`Zod`,hint:`default — broad ecosystem`},{value:`valibot`,label:`Valibot`,hint:`smaller bundle`},{value:`yup`,label:`Yup`,hint:`classic API`}]}),[`zod`,`valibot`,`yup`].includes(g)||(u.warn(`Unknown --schema "${g}", falling back to zod.`),g=`zod`);let _;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();_=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else _=n?[]:await o({message:`Select packages to include`,options:[..._t],required:!1});let v;v=t.git===void 0?n?!0:await f({message:`Initialize git repository?`,initialValue:!0}):t.git;let y;if(y=t.install===void 0?n?!0:await f({message:`Install dependencies?`,initialValue:!0}):t.install,s===`fullstack`){let{initFullstackProject:t}=await import(`./fullstack-Mkw3lkF1.mjs`);await t({name:e,directory:a,packageManager:m,initGit:v,installDeps:y,schemaLib:g,runtime:d}),r(`Done! Next steps: ${p.cyan(`cd ${e} && ${m}${m===`pnpm`?` dev`:` run dev:server`}`)}`);return}await Te({name:e,directory:a,packageManager:m,initGit:v,installDeps:y,template:s,defaultRepo:h,packages:_,schemaLib:g,runtime:d}),r(`Done! Next steps: ${p.cyan(`cd ${e} && ${m} dev`)}`)})}async function yt(e){let{name:n,outDir:r}=e,i=y(n),a=b(n),o=[],s=k(r,`${i}.plugin.ts`);return await t(s,`import {
|
|
12
12
|
definePlugin,
|
|
13
13
|
type AppAdapter,
|
|
14
14
|
type AppModuleEntry,
|
|
@@ -166,7 +166,7 @@ export const ${a}Plugin = definePlugin<${a}PluginConfig>({
|
|
|
166
166
|
},
|
|
167
167
|
}),
|
|
168
168
|
})
|
|
169
|
-
`),o.push(s),o}function
|
|
169
|
+
`),o.push(s),o}function bt(e){return e?e.split(`,`).map(e=>e.trim()).filter(Boolean).map(e=>{let[t,n]=e.split(`:`).map(e=>e.trim());return{name:t,type:n||`string`}}).filter(e=>e.name.length>0):[]}async function xt(e){let{name:n,moduleName:r,modulesDir:i,pattern:a}=e,o=e.type??`http`,s=y(n),c=b(n),l=e.key??v(n),u=Array.isArray(e.params)?e.params:bt(e.params),d=_e({type:`contributor`,outDir:e.outDir,moduleName:r,modulesDir:i,defaultDir:`src/contributors`,pattern:a,shouldPluralize:e.pluralize??!0}),f=o===`http`?`defineHttpContextDecorator`:`defineContextDecorator`,p=o===`http`?`RequestContext`:`ExecutionContext`,m=u.length>0?`\nexport type ${c}Params = {\n${u.map(e=>` ${e.name}: ${e.type}`).join(`
|
|
170
170
|
`)}\n}\n`:``,h=u.length>0?`${f}.withParams<${c}Params>()({`:`${f}({`,g=u.length>0?` // Every call site must supply these — no placeholder defaults.
|
|
171
171
|
// Add \`paramDefaults: { … }\` for any field whose default is
|
|
172
172
|
// genuinely correct for an undecorated route, and drop it from here.
|
|
@@ -217,7 +217,7 @@ ${ee}
|
|
|
217
217
|
throw new Error("${c} contributor: resolve() not implemented")
|
|
218
218
|
},
|
|
219
219
|
})
|
|
220
|
-
`,
|
|
220
|
+
`,ne=k(d,`${s}.contributor.ts`);return await t(ne,te),[ne]}async function St(e){let n=k(e.outDir,`kick.config.ts`),r=e.modulesDir??`src/modules`,i=e.defaultRepo??`inmemory`;return j(n)&&!e.force&&!await f({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
|
|
221
221
|
Skipped — existing kick.config.ts preserved.`),[]):(await t(n,`import { defineConfig } from '@forinda/kickjs-cli'
|
|
222
222
|
|
|
223
223
|
export default defineConfig({
|
|
@@ -260,18 +260,18 @@ export default defineConfig({
|
|
|
260
260
|
},
|
|
261
261
|
],
|
|
262
262
|
})
|
|
263
|
-
`),[n])}function
|
|
263
|
+
`),[n])}function L(e,t){if(e[t]!==`{`)return-1;let n=1;for(let r=t+1;r<e.length;r++){let t=e[r];if(t===`{`)n++;else if(t===`}`&&(n--,n===0))return r}return-1}function R(e,t){let n=t.exec(e);if(!n)return null;let r=n.index+n[0].length-1,i=L(e,r);return i===-1?null:e.slice(r+1,i)}function z(e,t,n){let r=` `.repeat(n);return e.split(`
|
|
264
264
|
`).map(e=>{if(e.trim()===``)return e;let n=RegExp(`^ {0,${t}}`),i=e.replace(n,``);return r+i}).join(`
|
|
265
|
-
`)}function
|
|
265
|
+
`)}function Ct(e){return e.replaceAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*'@forinda\/kickjs'/g,(e,t)=>{let n=t.split(`,`).map(e=>e.trim()).filter(e=>e&&e!==`Container`&&e!==`type Container`&&e!==`type AppModule`&&e!==`AppModule`&&e!==`type ModuleRoutes`&&e!==`ModuleRoutes`);return n.includes(`defineModule`)||n.push(`defineModule`),`import { ${n.join(`, `)} } from '@forinda/kickjs'`})}function wt(e,t){return e.replaceAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*'@forinda\/kickjs'/g,(e,n)=>{let r=n.split(`,`).map(e=>e.trim()).filter(e=>e&&e!==`defineModule`);return t.container&&!r.includes(`Container`)&&r.push(`Container`),t.appModule&&!r.some(e=>e===`AppModule`||e===`type AppModule`)&&r.push(`type AppModule`),t.moduleRoutes&&!r.some(e=>e===`ModuleRoutes`||e===`type ModuleRoutes`)&&r.push(`type ModuleRoutes`),t.contributorRegistrations&&!r.some(e=>e===`ContributorRegistrations`||e===`type ContributorRegistrations`)&&r.push(`type ContributorRegistrations`),`import { ${r.join(`, `)} } from '@forinda/kickjs'`})}function Tt(e){if(/\bdefineModule\s*\(/.test(e))return{migrated:null,reason:`already in target form`};let t=[...e.matchAll(/export\s+class\s+(\w+Module)\s+implements\s+AppModule\s*\{/g)];if(t.length===0)return{migrated:null,reason:`no class form detected`};if(t.length>1)return{migrated:null,reason:`multiple module classes in one file — migrate manually`};let n=t[0],r=n[1],i=n.index+n[0].length-1,a=L(e,i);if(a===-1)return{migrated:null,reason:`unbalanced class braces`};let o=e.slice(i+1,a),s=e.slice(0,n.index),c=e.slice(a+1),l=R(o,/register\s*\(([^)]*)\)\s*:\s*void\s*\{/),u=R(o,/contributors\s*\(\s*\)\s*:\s*ContributorRegistrations\s*\{/),d=R(o,/routes\s*\(\s*\)\s*:\s*[A-Za-z|[\]\s]+\{/);if(!d)return{migrated:null,reason:`routes() method missing or signature unrecognized`};let f=Ct(s),p=``;return l&&(p+=` register(container) {${z(l,4,6)} },\n\n`),u&&(p+=` contributors() {${z(u,4,6)} },\n\n`),p+=` routes() {${z(d,4,6)} },`,{migrated:`${f}${`export const ${r} = defineModule({
|
|
266
266
|
name: '${r}',
|
|
267
267
|
build: () => ({
|
|
268
268
|
${p}
|
|
269
269
|
}),
|
|
270
|
-
})`}${c}`}}function
|
|
271
|
-
`||e[l]===`\r`);)l++;let u=e.slice(l),d=/build\s*:\s*\([^)]*\)\s*=>\s*\(\s*\{/g.exec(s);if(!d)return{migrated:null,reason:`build: () => ({...}) not found in defineModule`};let f=d.index+d[0].length-1,p=
|
|
270
|
+
})`}${c}`}}function Et(e){if(/export\s+class\s+\w+Module\s+implements\s+AppModule\s*\{/.test(e))return{migrated:null,reason:`already in target form`};let t=[...e.matchAll(/export\s+const\s+(\w+Module)\s*=\s*defineModule\s*\(\s*\{/g)];if(t.length===0)return{migrated:null,reason:`no defineModule form detected`};if(t.length>1)return{migrated:null,reason:`multiple defineModule blocks in one file — migrate manually`};let n=t[0],r=n[1],i=n.index+n[0].length-1,a=L(e,i);if(a===-1)return{migrated:null,reason:`unbalanced defineModule braces`};let o=e.indexOf(`)`,a);if(o===-1)return{migrated:null,reason:`unbalanced defineModule call parens`};let s=e.slice(i+1,a),c=e.slice(0,n.index),l=o+1;for(;l<e.length&&(e[l]===`
|
|
271
|
+
`||e[l]===`\r`);)l++;let u=e.slice(l),d=/build\s*:\s*\([^)]*\)\s*=>\s*\(\s*\{/g.exec(s);if(!d)return{migrated:null,reason:`build: () => ({...}) not found in defineModule`};let f=d.index+d[0].length-1,p=L(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=R(m,/register\s*\(([^)]*)\)\s*\{/),g=R(m,/contributors\s*\(\s*\)\s*\{/),_=R(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let v=wt(c,{container:h!==null,appModule:!0,moduleRoutes:!0,contributorRegistrations:g!==null}),y=``;return h!==null&&(y+=` register(container: Container): void {${z(h,6,4)} }\n\n`),g!==null&&(y+=` contributors(): ContributorRegistrations {${z(g,6,4)} }\n\n`),y+=` routes(): ModuleRoutes {${z(_,6,4)} }`,{migrated:`${v}${`export class ${r} implements AppModule {
|
|
272
272
|
${y}
|
|
273
273
|
}
|
|
274
|
-
`}${u}`}}function
|
|
274
|
+
`}${u}`}}function Dt(e,t){return t===`class`?Et(e):Tt(e)}function Ot(e,t){let n=e,r=!1;if(t===`define`){/\bAppModuleClass\b/.test(n)&&(n=n.replaceAll(/\bAppModuleClass\b/g,`AppModuleEntry`),r=!0);let e=/(=\s*\[)([\s\S]*?)(])/,t=e.exec(n);if(t){let i=t[1],a=t[3],o=t[2],s=o.replaceAll(/(\b\w+Module)(?![(.])/g,`$1()`);s!==o&&(n=n.replace(e,`${i}${s}${a}`),r=!0)}}else{/\bAppModuleEntry\b/.test(n)&&(n=n.replaceAll(/\bAppModuleEntry\b/g,`AppModuleClass`),r=!0);let e=/(=\s*\[)([\s\S]*?)(])/,t=e.exec(n);if(t){let i=t[1],a=t[3],o=t[2],s=o.replaceAll(/(\b\w+Module)\s*\(\s*\)/g,`$1`);s!==o&&(n=n.replace(e,`${i}${s}${a}`),r=!0)}}return r?{migrated:n}:{migrated:null,reason:`no changes needed`}}async function kt(e){let t=[];return await n(A(e),0),t;async function n(e,r){let i;try{i=await ot(e)}catch{return}for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=k(e,a),o;try{o=await ct(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function At(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await ot(e)}catch{return}await N(t,{recursive:!0});for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=k(e,a),o=k(t,a),s;try{s=await ct(i)}catch{continue}s.isDirectory()?await r(i,o):(await at(i,o),n++)}}}function jt(e){return k(e,`.kickjs`,`codemod-backups`,`${new Date().toISOString().replaceAll(/[:.]/g,`-`)}-modules`)}async function Mt(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await kt(e),s=await P(k(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=jt(r),await At(e,c));let l=[];for(let e of o){let t=Dt(await P(e,`utf-8`),i);if(t.migrated==null){l.push({path:e,status:`skipped`,reason:t.reason});continue}n||await F(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`})}let u=k(e,`index.ts`),d=null;try{d=await P(u,`utf-8`)}catch{return{target:i,files:l,indexStatus:`not-found`,indexPath:u,backupDir:c}}let f=Ot(d,i);return f.migrated==null?{target:i,files:l,indexStatus:`skipped`,indexPath:u,indexReason:f.reason,backupDir:c}:(n||await F(u,f.migrated,`utf-8`),{target:i,files:l,indexStatus:`migrated`,indexPath:u,backupDir:c})}async function Nt(e,t){let n=await kt(e),r=[],i=t===`define`?/export\s+class\s+\w+Module\s+implements\s+AppModule\s*\{/:/export\s+const\s+\w+Module\s*=\s*defineModule\s*\(/;for(let e of n){let t=await P(e,`utf-8`);i.test(t)&&r.push(e)}return r}const Pt={string:{ts:`string`,zod:`z.string()`},text:{ts:`string`,zod:`z.string()`},number:{ts:`number`,zod:`z.number()`},int:{ts:`number`,zod:`z.number().int()`},float:{ts:`number`,zod:`z.number()`},boolean:{ts:`boolean`,zod:`z.boolean()`},date:{ts:`string`,zod:`z.string().datetime()`},email:{ts:`string`,zod:`z.string().email()`},url:{ts:`string`,zod:`z.string().url()`},uuid:{ts:`string`,zod:`z.string().uuid()`},json:{ts:`any`,zod:`z.any()`}};function Ft(e){return e.map(e=>{let t=e.indexOf(`:`);if(t===-1)throw Error(`Invalid field: "${e}". Use format: name:type (e.g. title:string)`);let n=e.slice(0,t),r=e.slice(t+1);if(!n||!r)throw Error(`Invalid field: "${e}". Use format: name:type (e.g. title:string)`);let i=!1;r.endsWith(`:optional`)&&(r=r.slice(0,-9),i=!0),n.endsWith(`?`)&&(n=n.slice(0,-1),i=!0),r.endsWith(`?`)&&(r=r.slice(0,-1),i=!0);let a=r;if(a.startsWith(`enum:`)){let e=a.slice(5).split(`,`);return{name:n,type:`enum`,tsType:e.map(e=>`'${e}'`).join(` | `),zodType:`z.enum([${e.map(e=>`'${e}'`).join(`, `)}])`,optional:i}}let o=Pt[a];if(!o){let e=[...Object.keys(Pt),`enum:a,b,c`].join(`, `);throw Error(`Unknown field type: "${a}". Valid types: ${e}`)}return{name:n,type:a,tsType:o.ts,zodType:o.zod,optional:i}})}async function It(e){let{name:n,fields:r,modulesDir:i,repo:a=`inmemory`,tokenScope:o=`app`,style:s=`define`}=e,c=e.pluralize!==!1,l=y(n),u=b(n),d=c?m(l):l,f=c?de(u):u,p=k(i,d),h=[],v=async(e,n)=>{let r=k(p,e);await t(r,n),h.push(r)};return await v(`${l}.module.ts`,ee({pascal:u,kebab:l,plural:d,repo:a,style:s})),await v(`${l}.constants.ts`,ve({pascal:u,kebab:l})),await v(`${l}.controller.ts`,g({pascal:u,kebab:l,plural:d,pluralPascal:f,swagger:e.swagger??!1})),await v(`${l}.service.ts`,ne({pascal:u,kebab:l})),await v(`dtos/create-${l}.dto.ts`,Lt(u,r)),await v(`dtos/update-${l}.dto.ts`,Rt(u,r)),await v(`dtos/${l}-response.dto.ts`,zt(u,r)),await v(`${l}.repository.ts`,_({pascal:u,kebab:l,repoType:a,dtoPrefix:`./dtos`,tokenScope:o})),await ae(i,u,d,l,s),h}function Lt(e,t){return`import { z } from 'zod'
|
|
275
275
|
|
|
276
276
|
export const create${e}Schema = z.object({
|
|
277
277
|
${t.map(e=>{let t=e.zodType;return` ${e.name}: ${t}${e.optional?`.optional()`:``},`}).join(`
|
|
@@ -279,7 +279,7 @@ ${t.map(e=>{let t=e.zodType;return` ${e.name}: ${t}${e.optional?`.optional()`:`
|
|
|
279
279
|
})
|
|
280
280
|
|
|
281
281
|
export type Create${e}DTO = z.infer<typeof create${e}Schema>
|
|
282
|
-
`}function
|
|
282
|
+
`}function Rt(e,t){return`import { z } from 'zod'
|
|
283
283
|
|
|
284
284
|
export const update${e}Schema = z.object({
|
|
285
285
|
${t.map(e=>` ${e.name}: ${e.zodType}.optional(),`).join(`
|
|
@@ -287,14 +287,14 @@ ${t.map(e=>` ${e.name}: ${e.zodType}.optional(),`).join(`
|
|
|
287
287
|
})
|
|
288
288
|
|
|
289
289
|
export type Update${e}DTO = z.infer<typeof update${e}Schema>
|
|
290
|
-
`}function
|
|
290
|
+
`}function zt(e,t){return`export interface ${e}ResponseDTO {
|
|
291
291
|
id: string
|
|
292
292
|
${t.map(e=>` ${e.name}${e.optional?`?`:``}: ${e.tsType}`).join(`
|
|
293
293
|
`)}
|
|
294
294
|
createdAt: string
|
|
295
295
|
updatedAt: string
|
|
296
296
|
}
|
|
297
|
-
`}async function
|
|
297
|
+
`}async function Bt(e){let{name:n,moduleName:r,modulesDir:i}=e,a=e.pluralize??!0,o=y(n),s=b(n),c=[],l;if(e.outDir)l=A(e.outDir);else if(r){let e=y(r),t=a?m(e):e;l=A(k(i??`src/modules`,t,`__tests__`))}else l=A(`src/__tests__`);let u=k(l,`${o}.test.ts`);return await t(u,`import { describe, it, expect, beforeEach } from 'vitest'
|
|
298
298
|
import { Container } from '@forinda/kickjs'
|
|
299
299
|
|
|
300
300
|
describe('${s}', () => {
|
|
@@ -317,57 +317,57 @@ describe('${s}', () => {
|
|
|
317
317
|
expect(true).toBe(true)
|
|
318
318
|
})
|
|
319
319
|
})
|
|
320
|
-
`),c.push(u),c}const
|
|
321
|
-
(dry run — no files were written)`),console.log()}async function
|
|
322
|
-
Add your own in kick.config.ts: https://kickjs.app/guide/plugin-generators.html`]]),
|
|
320
|
+
`),c.push(u),c}const Vt=[`agents`,`claude`,`skills`,`gemini`,`copilot`,`both`,`all`];function B(e){return e.parent?.opts()?.dryRun??!1}function V(e,t=!1){let n=process.cwd();console.log(`\n ${t?`Would generate`:`Generated`} ${e.length} file${e.length===1?``:`s`}:`);for(let t of e)console.log(` ${t.replace(n+`/`,``)}`);t&&console.log(`
|
|
321
|
+
(dry run — no files were written)`),console.log()}async function Ht(e){if(!e)try{let e=await S(process.cwd());await E({cwd:process.cwd(),allowDuplicates:!0,silent:!0,schemaValidator:e?.typegen?.schemaValidator??`zod`,envFile:e?.typegen?.envFile,srcDir:e?.typegen?.srcDir,outDir:e?.typegen?.outDir})}catch{}}const Ut=[{name:`module <name>`,description:`REST module (controller, service, DTOs, repo)`},{name:`scaffold <name> <fields...>`,description:`CRUD module from field definitions`},{name:`controller <name>`,description:`@Controller() class [-m module]`},{name:`service <name>`,description:`@Service() singleton [-m module]`},{name:`middleware <name>`,description:`Express middleware function [-m module]`},{name:`guard <name>`,description:`Route guard (auth, roles, etc.) [-m module]`},{name:`contributor <name>`,description:`Context contributor [--type http|bare] [--params a:string] [-m]`},{name:`dto <name>`,description:`Zod DTO schema [-m module]`},{name:`adapter <name>`,description:`AppAdapter with lifecycle hooks (app-level only)`},{name:`test <name>`,description:`Vitest test scaffold [-m module]`},{name:`config`,description:`Generate kick.config.ts`},{name:`agents`,description:`Regenerate .agents/* + root CLAUDE.md from upstream templates`}],Wt=new Map([[`job`,`Queue processors are no longer built in — their shape belongs to whichever queue you run.
|
|
322
|
+
Add your own in kick.config.ts: https://kickjs.app/guide/plugin-generators.html`]]),Gt=new Set([...Ut.map(e=>e.name.split(` `)[0]),...Wt.keys()]);async function Kt(){console.log(`
|
|
323
323
|
Built-in generators:
|
|
324
|
-
`);let e=Math.max(...
|
|
324
|
+
`);let e=Math.max(...Ut.map(e=>e.name.length));for(let t of Ut)console.log(` kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await S(process.cwd()),n=Pe(t?.plugins??[],t?.commands??[]),r=await ue(process.cwd(),n.generators);if(r.generators.length>0){console.log(`
|
|
325
325
|
Plugin generators:
|
|
326
326
|
`);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(`
|
|
327
327
|
Failed to load:
|
|
328
|
-
`);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}async function
|
|
329
|
-
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(t,n,r)=>{let i=
|
|
330
|
-
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(t,n,r)=>{let i=
|
|
328
|
+
`);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}async function qt(e,t,n){let r=await S(process.cwd()),i=C(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??h(i.repo);t.repo&&je(t.repo);let s=t.pattern??r?.pattern??`rest`,c=t.pluralize===!1?!1:i.pluralize??!0,l=Ae(r,process.cwd()),u=De(w()),d=Oe(w()),f=w(),m=ke(f,`@forinda/kickjs-testing`,`any`)&&ke(f,`supertest`,`any`),g=i.style??`define`;if(!n&&g===`define`){let e=await Nt(A(a),`define`);if(e.length>0){console.error(`\n ${p.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n ${p.dim(`Project setting:`)} modules.style: 'define' (default)\n\n ${p.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 ${p.bold(`Pick one:`)}\n 1. Migrate everything to defineModule:\n ${p.dim(`$`)} kick codemod modules --experimental --apply\n 2. Keep the class form — pin it in kick.config.ts:\n ${p.dim(`// kick.config.ts`)}\n ${p.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let _=[];for(let r of e){let e=await te({name:r,modulesDir:A(a),noEntity:t.entity===!1,noTests:t.tests===!1,repo:o,minimal:t.minimal,force:t.force,pattern:s,testHarness:m,dryRun:n,pluralize:c,tokenScope:l,swagger:u,schemaLib:d,style:i.style});_.push(...e)}V(_,n),await Ht(n)}function Jt(t,n){let r=t.command(`generate [names...]`).alias(`g`).description("Generate code scaffolds — bare form `kick g <name>` is shorthand for `kick g module <name>`").option(`--list`,`List all available generators`).option(`--dry-run`,`Preview files that would be generated without writing them`).option(`--no-entity`,`Skip entity and value object generation (module shortcut)`).option(`--no-tests`,`Skip test file generation (module shortcut)`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name (e.g. postgres)`).option(`--pattern <pattern>`,`Override project pattern: rest | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(t,i,a)=>{if(i.list){await Kt();return}if(!t||t.length===0){r.help();return}let o=B(a);e(o);let[s,c,...l]=t;if(s){let e=await S(process.cwd()),t=Pe(e?.plugins??[],e?.commands??[]),r=await ie({generatorName:s,itemName:c??``,args:l,flags:i,cwd:process.cwd(),projectRoot:n?.projectRoot},t.generators);if(r){V(r.files,o);return}if(s!==`module`&&Gt.has(s)){let e=Wt.get(s);e?(console.error(`\n 'kick g ${s}' has been removed.`),console.error(` ${e}\n`)):(console.error(`\n '${s}' is a generator, not a module name.`),console.error(` Did you mean: kick g ${s} ${c??`<name>`}`),console.error(` If that errors, your @forinda/kickjs-cli is older than the '${s}' generator — upgrade it.\n`)),process.exitCode=1;return}}await qt(t,i,o)});r.command(`module <names...>`).description(`Generate one or more modules (e.g. kick g module user task project)`).option(`--no-entity`,`Skip entity and value object generation`).option(`--no-tests`,`Skip test file generation`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name (e.g. postgres)`).option(`--pattern <pattern>`,`Override project pattern: rest | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(t,n,r)=>{let i=B(r);e(i),await qt(t,{...r.optsWithGlobals(),...n},i)}),r.command(`adapter <name>`).description(`Generate an AppAdapter with lifecycle hooks and middleware support`).option(`-o, --out <dir>`,`Output directory`,`src/adapters`).action(async(t,n,r)=>{let i=B(r);e(i),V(await be({name:t,outDir:A(n.out)}),i)}),r.command(`plugin <name>`).description(`Generate a KickPlugin with DI, modules, adapters, middleware, and lifecycle hooks`).option(`-o, --out <dir>`,`Output directory`,`src/plugins`).action(async(t,n,r)=>{let i=B(r);e(i),V(await yt({name:t,outDir:A(n.out)}),i)}),r.command(`middleware <name>`).description(`Generate a global middleware function, typed for the configured runtime
|
|
329
|
+
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(t,n,r)=>{let i=B(r);e(i);let a=await S(process.cwd()),o=C(a),s=o.dir??`src/modules`;V(await re({name:t,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0,runtime:a?.runtime}),i)}),r.command(`guard <name>`).description(`Generate a route guard (auth, roles, etc.)
|
|
330
|
+
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(t,n,r)=>{let i=B(r);e(i);let a=await S(process.cwd()),o=C(a),s=o.dir??`src/modules`;V(await ce({name:t,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),i)}),r.command(`contributor <name>`).description(`Generate a Context Contributor (typed alternative to @Middleware for ctx.set)
|
|
331
331
|
--type http (default, RequestContext) | bare (ExecutionContext)
|
|
332
332
|
--params "source:string,region:number" → emits the withParams<T>() form
|
|
333
|
-
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(t,n,r)=>{let i=
|
|
334
|
-
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(t,n,r)=>{let i=
|
|
335
|
-
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(t,n,r)=>{let i=
|
|
336
|
-
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(t,n,r)=>{let i=
|
|
337
|
-
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(t,n,r)=>{let i=
|
|
333
|
+
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(t,n,r)=>{let i=B(r);e(i);let a=(n.type??`http`).toLowerCase();a!==`http`&&a!==`bare`&&(console.warn(` kick g contributor: unknown --type '${n.type}', using 'http'.`),a=`http`);let o=await S(process.cwd()),s=C(o),c=s.dir??`src/modules`;V(await xt({name:t,type:a,key:n.key,params:n.params,outDir:n.out,moduleName:n.module,modulesDir:c,pattern:o?.pattern,pluralize:s.pluralize??!0}),i)}),r.command(`service <name>`).description(`Generate a @Service() class
|
|
334
|
+
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(t,n,r)=>{let i=B(r);e(i);let a=await S(process.cwd()),o=C(a),s=o.dir??`src/modules`;V(await le({name:t,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),i)}),r.command(`controller <name>`).description(`Generate a @Controller() class with basic routes
|
|
335
|
+
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(t,n,r)=>{let i=B(r);e(i);let a=await S(process.cwd()),o=C(a),s=o.dir??`src/modules`;V(await pe({name:t,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),i),await Ht(i)}),r.command(`dto <name>`).description(`Generate a DTO schema for the project’s validation library
|
|
336
|
+
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(t,n,r)=>{let i=B(r);e(i);let a=await S(process.cwd()),o=C(a),s=o.dir??`src/modules`;V(await me({name:t,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0,schemaLib:Oe(w())}),i)}),r.command(`test <name>`).description(`Generate a Vitest test scaffold
|
|
337
|
+
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(t,n,r)=>{let i=B(r);e(i);let a=C(await S(process.cwd())),o=a.dir??`src/modules`;V(await Bt({name:t,outDir:n.out,moduleName:n.module,modulesDir:o,pluralize:a.pluralize??!0}),i)}),r.command(`scaffold <name> [fields...]`).description(`Generate a full CRUD module from field definitions
|
|
338
338
|
Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
|
|
339
339
|
Types: string, text, number, int, float, boolean, date, email, url, uuid, json, enum:a,b,c
|
|
340
340
|
Optional: append :optional (shell-safe): description:text:optional
|
|
341
|
-
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(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`--modules-dir <dir>`,`Modules directory`).action(async(t,n,r,i)=>{let a=
|
|
341
|
+
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(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`--modules-dir <dir>`,`Modules directory`).action(async(t,n,r,i)=>{let a=B(i);e(a),n.length===0&&(console.error(`
|
|
342
342
|
Error: At least one field is required.
|
|
343
343
|
Usage: kick g scaffold <name> <field:type> [field:type...]
|
|
344
344
|
Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
|
|
345
345
|
Optional: append :optional (shell-safe, no quoting needed)
|
|
346
|
-
`),process.exit(1));let o=await
|
|
347
|
-
`,u=``;if(
|
|
346
|
+
`),process.exit(1));let o=await S(process.cwd()),s=C(o),c=r.modulesDir??s.dir??`src/modules`,l=Ft(n),u=Ae(o,process.cwd()),d=De(w()),f=await It({name:t,fields:l,modulesDir:A(c),noEntity:r.entity===!1,noTests:r.tests===!1,pluralize:r.pluralize===!1?!1:s.pluralize??!0,tokenScope:u,swagger:d,style:s.style});console.log(`\n Scaffolded ${t} with ${l.length} field(s):`);for(let e of l)console.log(` ${e.name}: ${e.type}${e.optional?` (optional)`:``}`);V(f,a),await Ht(a)}),r.command(`config`).description(`Generate a kick.config.ts at the project root`).option(`--modules-dir <dir>`,`Modules directory path`,`src/modules`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name`,`inmemory`).option(`-f, --force`,`Overwrite existing kick.config.ts without prompting`).action(async(t,n)=>{let r=B(n);e(r),V(await St({outDir:A(`.`),modulesDir:t.modulesDir,defaultRepo:t.repo,force:t.force}),r)}),r.command(`agents`).alias(`agent-docs`).alias(`ai-docs`).description(`Regenerate .agents/* + root CLAUDE.md (sync after framework upgrades)`).option(`--only <which>`,`Limit scope: agents | claude | skills | gemini | copilot | both (agents+claude) | all (default: all)`,`all`).option(`--name <name>`,`Project name (defaults to package.json name)`).option(`--pm <pm>`,`Package manager (defaults to package.json packageManager)`).option(`--template <template>`,`Template: rest | minimal | fullstack`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(t,n)=>{let r=B(n);e(r);let i=t.only??`all`;if(!Vt.includes(i)){console.error(` Invalid --only value: ${i}. Expected: ${Vt.join(` | `)}`),process.exitCode=1;return}V(await Ne({outDir:A(`.`),only:i,name:t.name,pm:t.pm,template:t.template,force:t.force}),r)});for(let e of n?.generators??[])Yt(r,e,n?.projectRoot)}function Yt(t,n,r){let{source:i,spec:a}=n,o=a.args?.[0],s=o?.name??`itemName`,c=o?.required?`<${s}>`:`[${s}]`,l=`${a.name} ${c} [extraArgs...]`,u=t.command(l).description(`${a.description} [${i}]`);for(let e of a.flags??[]){let t=e.takesValue?`--${e.name} <value>`:`--${e.name}`,n=e.alias?`-${e.alias}, ${t}`:t;u.option(n,e.description??``)}u.action(async(t,i,o,s)=>{let c=B(s);e(c);let l=await ie({generatorName:a.name,itemName:t??``,args:i??[],flags:o,cwd:process.cwd(),projectRoot:r},[n]);l&&V(l.files,c)})}const Xt=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: `;async function Zt(e){let t=D.resolve(e.cwd,`.kickjs/types`);e.check||await N(t,{recursive:!0});let n=new Map,r=e.scan??Be,i=D.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(I(e).href)},async writeFile(t,n){let r=D.resolve(e.cwd,t);await N(D.dirname(r),{recursive:!0}),await F(r,n,`utf8`)},getScanResult:e=>{let t=Qt(e),o=n.get(t);if(!o){let s={cacheDir:i,...e};o=a?Fe(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=D.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=`${Xt}${n.id} */\n\n`+a+`
|
|
347
|
+
`,u=``;if(j(i)&&(u=await P(i,`utf8`)),u===l){s.push({id:n.id,status:`unchanged`,outFile:i});continue}if(e.check){c.push({id:n.id,outFile:i}),s.push({id:n.id,status:`drifted`,outFile:i});continue}await F(i,l,`utf8`),s.push({id:n.id,status:`written`,outFile:i})}if(c.length>0)throw new ge(c);return s}function Qt(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 $t(e,t){let n=new Set(t),r=[],i=[],a=new Set;for(let t of e)n.has(t.id)?(i.push(t),a.add(t.id)):r.push(t);return{enabled:r,skipped:i,unknown:[...n].filter(e=>!a.has(e))}}async function H(e){let{enabled:t,skipped:n,unknown:r}=$t(Pe([...gi,...e.config?.plugins??[]],e.config?.commands??[]).typegens,e.config?.typegen?.disable??[]);if(!e.silent&&n.length>0)for(let e of n)console.log(` ${e.id}: disabled (typegen.disable)`);if(!e.silent&&r.length>0&&console.warn(` kick typegen: disable list references unknown id(s): ${r.map(e=>`'${e}'`).join(`, `)}. Run \`kick typegen --list\` to see registered ids.`),t.length===0)return[];try{let n=await Zt({cwd:e.cwd,config:e.config??{},plugins:t,watch:e.watch,check:e.check,changedFiles:e.changedFiles});if(!e.silent&&se())for(let e of n)console.log(` ${e.id}: ${e.status}`);return n}catch(t){if(t instanceof ge||e.check)throw t;if(!e.silent){let e=t instanceof Error?t.message:String(t);console.warn(` kick typegen plugins: skipped (${e})`)}return[]}}function en(e){let t=k(e,`node_modules`,`.bin`),n=process.platform===`win32`;for(let e of[`vue-tsc`,`tsgo`,`tsc`]){let r=n?[`${e}.CMD`,`${e}.cmd`,`${e}.exe`]:[e];for(let i of r){let r=k(t,i);if(j(r))return{cmd:r,args:[`--noEmit`],shell:n,kind:e}}}return null}function tn(e){let t=e.spawnFn??ut,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 nn(e,t=12){let n=e.trim().split(/\r?\n/);return n.length<=t?n.join(`
|
|
348
348
|
`):`${n.slice(0,t).join(`
|
|
349
|
-
`)}\n… ${n.length-t} more line(s)`}function
|
|
349
|
+
`)}\n… ${n.length-t} more line(s)`}function rn(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function an(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 on(e,t,n={}){t&&(process.env.PORT=t);let r=rn(n.polling),i=process.cwd(),a=await S(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await E({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=A(i,a?.typegen?.outDir??`.kickjs/types`);try{await He(c,await H({cwd:i,config:a}),!1)}catch(e){console.warn(` kick typegen: plugin pass skipped (${e?.message??e})`)}let{createRequire:l}=await import(`node:module`),{createServer:u}=await import(I(l(A(`package.json`)).resolve(`vite`)).href);globalThis[oe]=`kick-dev`;let d=await u({configFile:A(`vite.config.ts`),server:{port:t?parseInt(t,10):void 0,...r?{watch:{usePolling:!0,interval:100}}:{}}}),f=n.typecheck??a?.dev?.typecheck??!1,p=null,m=!0;if(f){let e=en(i);e?p=tn({cwd:i,bin:e,onResult:e=>{d.hot.send({type:`custom`,event:`kickjs:typecheck`,data:{ok:e.ok,output:e.output,durationMs:e.durationMs}}),e.ok?m||(m=!0,console.log(` kick typecheck: clean again (${e.kind}, ${e.durationMs}ms)`)):(m=!1,console.warn(`\n kick typecheck (${e.kind}, ${e.durationMs}ms):`),console.warn(nn(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 h=fe({cwd:i,config:a,emitWarning:e=>{console.warn(e),d.hot.send({type:`custom`,event:`kickjs:typegen-error`,data:{message:e,timestamp:Date.now()}})},onPassComplete:()=>p?.schedule()});d.watcher.on(`add`,e=>h.handleWatchEvent(`add`,e)),d.watcher.on(`unlink`,e=>h.handleWatchEvent(`unlink`,e)),d.watcher.on(`change`,e=>h.handleWatchEvent(`change`,e)),d.watcher.on(`unlinkDir`,e=>h.handleWatchEvent(`unlinkDir`,e)),h.assetSrcRoots.length>0&&d.watcher.add([...h.assetSrcRoots]),await d.listen(),d.printUrls(),console.log(`
|
|
350
350
|
KickJS dev server running (Vite + @forinda/kickjs-vite)
|
|
351
|
-
`),p?.schedule();let g=!1,_=async()=>{if(!g){g=!0,h.dispose(),p?.dispose();try{await globalThis.__kickjs_app_shutdown?.()}catch(e){console.error(` app shutdown hook failed: ${e?.message??e}`)}await d.close(),process.exit(0)}};process.on(`SIGINT`,_),process.on(`SIGTERM`,_),process.on(`SIGBREAK`,_)}async function
|
|
351
|
+
`),p?.schedule();let g=!1,_=async()=>{if(!g){g=!0,h.dispose(),p?.dispose();try{await globalThis.__kickjs_app_shutdown?.()}catch(e){console.error(` app shutdown hook failed: ${e?.message??e}`)}await d.close(),process.exit(0)}};process.on(`SIGINT`,_),process.on(`SIGTERM`,_),process.on(`SIGBREAK`,_)}async function sn(e){let t=await S(e);try{await E({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}),await He(A(e,t?.typegen?.outDir??`.kickjs/types`),await H({cwd:e,config:t}),!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 cn(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 on(e.entry,e.port,{polling:e.polling,typecheck:e.typecheck})}catch(e){e.code===`ERR_MODULE_NOT_FOUND`&&e.message?.includes(`vite`)?console.error(`
|
|
352
352
|
Error: vite is not installed.
|
|
353
353
|
Run: pnpm add -D vite unplugin-swc
|
|
354
354
|
`):console.error(`
|
|
355
355
|
Dev server failed:`,e.message??e),process.exit(1)}}),e.command(`build`).description(`Build for production via Vite`).action(async()=>{console.log(`
|
|
356
356
|
Building for production...
|
|
357
|
-
`);let{createRequire:e}=await import(`node:module`),{build:t}=await import(
|
|
358
|
-
Copying directories to dist...`);for(let e of r){let t=typeof e==`string`?e:e.src,n=typeof e==`string`?
|
|
359
|
-
Building asset map...`);try{await
|
|
357
|
+
`);let{createRequire:e}=await import(`node:module`),{build:t}=await import(I(e(A(`package.json`)).resolve(`vite`)).href);await t({configFile:A(`vite.config.ts`)});let n=await S(process.cwd()),r=n?.copyDirs??[];if(r.length>0){console.log(`
|
|
358
|
+
Copying directories to dist...`);for(let e of r){let t=typeof e==`string`?e:e.src,n=typeof e==`string`?k(`dist`,e):e.dest??k(`dist`,t),r=A(t),i=A(n);if(!j(r)){console.log(` ⚠ Skipped ${t} (not found)`);continue}tt(i,{recursive:!0}),et(r,i,{recursive:!0}),console.log(` ✓ ${t} → ${n}`)}}if(n?.assetMap&&Object.keys(n.assetMap).length>0){console.log(`
|
|
359
|
+
Building asset map...`);try{await Me(n,{cwd:process.cwd()})}catch(e){console.error(` ✗ asset build failed: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}console.log(`
|
|
360
360
|
Build complete.
|
|
361
|
-
`)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await
|
|
362
|
-
Building asset map...`);try{await
|
|
361
|
+
`)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await S(process.cwd());if(!e?.assetMap||Object.keys(e.assetMap).length===0){console.log(` No assetMap entries — nothing to build.`);return}console.log(`
|
|
362
|
+
Building asset map...`);try{await Me(e,{cwd:process.cwd()}),console.log(`
|
|
363
363
|
Asset build complete.
|
|
364
|
-
`)}catch(e){console.error(` ✗ ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}),e.command(`start`).description(`Start production server`).option(`-e, --entry <file>`,`Entry file`,`dist/index.js`).option(`-p, --port <port>`,`Port number`).action(e=>{let t={NODE_ENV:`production`};e.port&&(t.PORT=String(e.port)),
|
|
364
|
+
`)}catch(e){console.error(` ✗ ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}),e.command(`start`).description(`Start production server`).option(`-e, --entry <file>`,`Entry file`,`dist/index.js`).option(`-p, --port <port>`,`Port number`).action(e=>{let t={NODE_ENV:`production`};e.port&&(t.PORT=String(e.port)),Ee(e.entry,t)}),e.command(`typecheck`).description(`Type-check the project with its own tsgo/tsc`).option(`--cwd <dir>`,`Directory to type-check`,`.`).option(`--no-typegen`,`Skip refreshing .kickjs/types first`).action(async e=>{let t=A(process.cwd(),e.cwd??`.`);e.typegen!==!1&&await sn(t);let n=en(t);if(!n){console.error(`
|
|
365
365
|
No type-checker found. Install one in this project:
|
|
366
366
|
pnpm add -D typescript (tsc)
|
|
367
367
|
pnpm add -D @typescript/native-preview (tsgo, faster)
|
|
368
|
-
`),process.exit(1);return}let r=
|
|
369
|
-
Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function
|
|
370
|
-
`))})}const{bold:
|
|
368
|
+
`),process.exit(1);return}let r=dt(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 an(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 on(e.entry,e.port)}catch(e){console.error(`
|
|
369
|
+
Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function ln(){try{let e=O(ft(import.meta.url));return JSON.parse(M(k(e,`..`,`package.json`),`utf-8`)).version??`unknown`}catch{return`unknown`}}const un=new Set(Object.values(we).filter(e=>e.deprecated).map(e=>e.pkg));function dn(e){let t=k(e,`package.json`);if(!j(t))return[];let n;try{n=JSON.parse(M(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=k(e,`node_modules`,...t.split(`/`),`package.json`);if(j(i))try{n=JSON.parse(M(i,`utf-8`)).version??null}catch{}return{name:t,installed:n,declared:r[t]??null,deprecated:un.has(t)}})}function fn(e){let t=e;for(;;){if(j(k(t,`package.json`)))return t;let e=O(t);if(e===t)return null;t=e}}function pn(e){e.command(`info`).description(`Print system and framework info`).action(()=>{let e=[``,` KickJS CLI v${ln()}`,``,` System:`,` OS: ${mt()} ${ht()} (${pt()})`,` Node: ${process.version}`],t=fn(process.cwd()),n=t?dn(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(`
|
|
370
|
+
`))})}const{bold:U,dim:W,green:mn,red:G,yellow:hn,blue:gn}=p;function _n(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 vn(e){let t=await fetch(e,{signal:AbortSignal.timeout(5e3)});if(!t.ok)throw Error(`${t.status} ${t.statusText}`);return t.json()}async function K(e,t){try{return await vn(`${e}${t}`)}catch{return null}}async function yn(e){let[t,n,r,i,a]=await Promise.all([K(e,`/health`),K(e,`/metrics`),K(e,`/routes`),K(e,`/container`),K(e,`/ws`)]);return{health:t,metrics:n,routes:r,container:i,ws:a}}function bn(e,t){let{health:n,metrics:r,routes:i,container:a,ws:o}=t,c=W(`─`.repeat(60));if(console.log(),console.log(U(` KickJS Inspector`)+W(` → ${e}`)),console.log(c),n){let e=n.status===`healthy`?mn(`● healthy`):G(`● `+n.status);console.log(` ${U(`Health:`)} ${e}`)}else console.log(` ${U(`Health:`)} ${G(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?G:r.errorRate>0?hn:mn;console.log(` ${U(`Uptime:`)} ${_n(r.uptimeSeconds)}`),console.log(` ${U(`Requests:`)} ${r.requests}`),console.log(` ${U(`Errors:`)} ${r.serverErrors} server, ${r.clientErrors??0} client ${W(`(`)}${t(e+`%`)}${W(`)`)}`)}if(a&&console.log(` ${U(`DI:`)} ${a.count} bindings`),o&&o.enabled&&console.log(` ${U(`WS:`)} ${o.connections??0} connections, ${o.namespaces??0} namespaces`),i?.routes?.length){console.log(),console.log(U(` Routes`)),console.log(c),console.log(` ${W(`METHOD`)} ${W(`PATH`.padEnd(36))} ${W(`CONTROLLER`)}`);for(let e of i.routes){let t=e.path.length>36?e.path.slice(0,33)+`...`:e.path.padEnd(36);console.log(` ${s(e.method)} ${t} ${gn(e.controller)}.${W(e.handler)}`)}}console.log(c),console.log()}function xn(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 yn(r);t.json?console.log(JSON.stringify(e,null,2)):bn(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(G(` ✖ Could not connect to ${n}`)),console.error(W(` ${e instanceof Error?e.message:String(e)}`))),t.watch||(process.exitCode=1)}};if(t.watch){let e=async()=>{process.stdout.write(`\x1B[2J\x1B[H`),await i()};await e(),setInterval(e,5e3)}else await i()})}function q(e,t){let n=e.toLowerCase();return t.every(e=>n.includes(e.toLowerCase()))}function J(e,t){let n=e.toLowerCase();return t.some(e=>n.includes(e.toLowerCase()))}const Sn=[{match(e,t){let n=q(e,[`config`,`get`])&&J(e,[`undefined`,`null`]),r=e.includes(`@Value`)&&J(e,[`undefined`,`is not defined`]);return!n&&!r?null:J(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
|
|
371
371
|
src/config/index.ts, and src/index.ts imports it before bootstrap().
|
|
372
372
|
Tests never load src/index.ts — \`createTestApp\` builds the app
|
|
373
373
|
directly — so that import does not run and ConfigService falls back to
|
|
@@ -401,7 +401,7 @@ describe('UserController', () => {
|
|
|
401
401
|
beforeEach(() => Container.reset())
|
|
402
402
|
|
|
403
403
|
it('does the thing', async () => { /* ... */ })
|
|
404
|
-
})`,docs:`https://kickjs.app/guide/testing.html`}}:null}},{match(e,t){return e.includes(`@Module`)||
|
|
404
|
+
})`,docs:`https://kickjs.app/guide/testing.html`}}:null}},{match(e,t){return e.includes(`@Module`)||q(e,[`Module`,`is not a function`])||q(e,[`Module`,`no exported member`])?{confidence:80,diagnosis:{id:`module-decorator-not-found`,title:`KickJS does not have a @Module decorator (different pattern from NestJS)`,explanation:`NestJS uses @Module({ controllers, providers }). KickJS uses an interface
|
|
405
405
|
pattern instead: a class implements AppModule and exposes routes() that
|
|
406
406
|
returns the controller wiring. This was a deliberate choice — modules
|
|
407
407
|
become explicit values rather than metadata, which makes them easier to
|
|
@@ -487,7 +487,103 @@ beforeAll(() => {
|
|
|
487
487
|
vi.stubEnv('JWT_SECRET', 'x'.repeat(32))
|
|
488
488
|
resetEnvCache()
|
|
489
489
|
loadEnv(envSchema)
|
|
490
|
-
})`,docs:`https://kickjs.app/guide/testing.html#environment-isolation`}}}}
|
|
490
|
+
})`,docs:`https://kickjs.app/guide/testing.html#environment-isolation`}}}},{match(e,t){let n=q(e,[`cannot inject`,`request-scoped`,`singleton`]),r=q(e,[`request-scoped`,`singleton`]);return!n&&!r?null:{confidence:n?100:70,diagnosis:{id:`di-request-scope-into-singleton`,title:`A SINGLETON cannot hold a REQUEST-scoped dependency`,explanation:`Controllers are SINGLETON by default: one instance for the process, built
|
|
491
|
+
the first time the container resolves it. A REQUEST-scoped binding is the
|
|
492
|
+
opposite — one instance per request, discarded when the response ends.
|
|
493
|
+
|
|
494
|
+
Injecting the second into the first would capture whichever request
|
|
495
|
+
happened to build the singleton and hand that same instance to every
|
|
496
|
+
later request, so the container refuses at resolve time instead.
|
|
497
|
+
|
|
498
|
+
This surfaces on the first request that reaches the controller, not at
|
|
499
|
+
boot, because the container builds lazily. The route mounts fine and then
|
|
500
|
+
answers 500.`,fix:`The error says "use TRANSIENT or REQUEST scope for the parent", and that
|
|
501
|
+
is the fix when the parent is a @Service / @Repository / @Component —
|
|
502
|
+
each takes \`{ scope }\`.
|
|
503
|
+
|
|
504
|
+
@Controller() does NOT. It takes no options and always registers as a
|
|
505
|
+
SINGLETON, so for a controller the advice in the message is not
|
|
506
|
+
available. Switch that one dependency to @Autowired instead: property
|
|
507
|
+
injection re-resolves per access, so each request reads its own instance
|
|
508
|
+
and the singleton never captures one.
|
|
509
|
+
|
|
510
|
+
If the dependency did not need request scope in the first place, the
|
|
511
|
+
other direction also works — make it SINGLETON and pass the per-request
|
|
512
|
+
values in as method arguments.`,docs:`https://kickjs.app/guide/dependency-injection.html#scopes`}}}},{match(e,t){let n=e.toLowerCase().includes(`circular dependency detected`),r=q(e,[`circular`,`dependency`]);return!n&&!r?null:{confidence:n?100:65,diagnosis:{id:`di-circular-dependency`,title:`Two services depend on each other, directly or through a chain`,explanation:`The container resolves constructor dependencies depth-first. When a token
|
|
513
|
+
is requested while it is already being resolved further up the stack, the
|
|
514
|
+
graph has a cycle and there is no order that satisfies both ends.
|
|
515
|
+
|
|
516
|
+
The error prints the whole chain, arrow-separated — read it as "A needed
|
|
517
|
+
B, which needed C, which needed A again". The repeated name at both ends
|
|
518
|
+
is where the cycle closes, and it is usually the pair in the middle that
|
|
519
|
+
is worth splitting, not the class you were resolving.
|
|
520
|
+
|
|
521
|
+
Constructor injection is what forces the ordering. Property injection
|
|
522
|
+
(@Autowired) resolves after construction, so it tolerates a cycle the
|
|
523
|
+
constructor form cannot.`,fix:`Preferred: pull the shared behaviour into a third service both sides
|
|
524
|
+
depend on. A cycle is usually a missing collaborator, and breaking it
|
|
525
|
+
this way leaves both classes independently testable.
|
|
526
|
+
|
|
527
|
+
If the cycle is genuine and the design is settled, switch ONE side from
|
|
528
|
+
constructor injection to @Autowired so it resolves lazily.`,codeBefore:`@Service()
|
|
529
|
+
export class OrderService {
|
|
530
|
+
constructor(private readonly billing: BillingService) {}
|
|
531
|
+
}
|
|
532
|
+
|
|
533
|
+
@Service()
|
|
534
|
+
export class BillingService {
|
|
535
|
+
constructor(private readonly orders: OrderService) {} // ← closes the cycle
|
|
536
|
+
}`,codeAfter:`@Service()
|
|
537
|
+
export class OrderService {
|
|
538
|
+
constructor(private readonly billing: BillingService) {}
|
|
539
|
+
}
|
|
540
|
+
|
|
541
|
+
@Service()
|
|
542
|
+
export class BillingService {
|
|
543
|
+
@Autowired() private readonly orders!: OrderService // ← resolved after construction
|
|
544
|
+
}`,docs:`https://kickjs.app/guide/dependency-injection.html#circular-dependency-detection`}}}},{match(e,t){let n=e.includes(`KICK001`),r=J(e,[`no provider for`,`no provider found for`,`no binding is registered`]);return!n&&!r?null:{confidence:n?100:85,diagnosis:{id:`di-no-provider-for-token`,title:`A token was requested but nothing registers it`,explanation:`Decorators register bindings as a side effect of the class being LOADED —
|
|
545
|
+
and a class is only loaded if something imports it. A module that is not
|
|
546
|
+
in the bootstrap array is never imported, so none of its @Service /
|
|
547
|
+
@Repository / @Controller classes ever register, and the first thing that
|
|
548
|
+
asks for one gets this error.
|
|
549
|
+
|
|
550
|
+
That makes the failure almost always about the MODULE, not the class the
|
|
551
|
+
error names — which is why the token in the message usually looks
|
|
552
|
+
correctly decorated when you open it.
|
|
553
|
+
|
|
554
|
+
The other two causes: a class with no decorator at all, or a
|
|
555
|
+
createToken() handle that nothing binds. Tokens are inert values — they
|
|
556
|
+
carry a type, never an implementation.`,fix:`Check, in this order:
|
|
557
|
+
1. Is the enclosing module in \`bootstrap({ modules })\` (or in the array
|
|
558
|
+
exported from src/modules/index.ts)?
|
|
559
|
+
2. Does the class carry @Service() / @Repository() / @Controller()?
|
|
560
|
+
3. For a createToken() token — does some module bind it in \`register()\`?`,codeAfter:`const TENANT_REPO = createToken<TenantRepo>('TENANT_REPO')
|
|
561
|
+
|
|
562
|
+
export const TenantModule = defineModule({
|
|
563
|
+
name: 'TenantModule',
|
|
564
|
+
build: () => ({
|
|
565
|
+
register(container) {
|
|
566
|
+
container.register(TENANT_REPO, { useClass: PrismaTenantRepo }) // ← the binding
|
|
567
|
+
},
|
|
568
|
+
routes: () => null,
|
|
569
|
+
}),
|
|
570
|
+
})`,docs:`https://kickjs.app/guide/dependency-injection.html#registering-services`}}}},{match(e,t){if(!J(e,[`vite`,`kick dev`,`dev server`,`localhost:5173`,`:5173`])||!J(e,[`404`,`not found`,`cannot get`,`cannot post`,`no route`]))return null;let n=q(e,[`app`,`export`]),r=J(e,[`every route`,`all routes`,`every endpoint`,`all endpoints`,`none of the routes`]);return!n&&!r?null:{confidence:n&&r?85:n?80:70,diagnosis:{id:`vite-dev-app-not-exported`,title:"Every route 404s in dev because the entry file exports no `app`",explanation:`The Vite plugin does not start your server. It imports the entry module
|
|
571
|
+
and reads \`app\` off it, then hands each request to that instance.
|
|
572
|
+
|
|
573
|
+
When the entry runs \`await bootstrap(...)\` without assigning the result to
|
|
574
|
+
an exported \`app\`, the plugin finds nothing to delegate to and falls
|
|
575
|
+
through to Vite's own 404 handler. Your app booted; nothing is routing to
|
|
576
|
+
it.
|
|
577
|
+
|
|
578
|
+
The giveaway is that EVERY route 404s, including ones that clearly exist,
|
|
579
|
+
and the failure is dev-only — \`kick start\` runs the entry directly and
|
|
580
|
+
never needs the export.`,fix:"Export the bootstrap result as `app` from your entry file. The name is\nload-bearing — the plugin looks up exactly that export.",codeBefore:`import './env'
|
|
581
|
+
import { bootstrap } from '@forinda/kickjs'
|
|
582
|
+
|
|
583
|
+
await bootstrap({ modules }) // ← nothing for the dev server to read`,codeAfter:`import './env'
|
|
584
|
+
import { bootstrap } from '@forinda/kickjs'
|
|
585
|
+
|
|
586
|
+
export const app = await bootstrap({ modules })`,docs:`https://kickjs.app/guide/project-structure.html`}}}}];function Cn(e,t){let n=null;for(let r of Sn){let i=null;try{i=r.match(e,t)}catch{continue}!i||i.confidence<40||(!n||i.confidence>n.confidence)&&(n=i)}return n}async function wn(e){let t=e.provider??`openai`,n=process.env.OPENAI_API_KEY;if(t===`openai`&&!n)return{kind:`unavailable`,reason:`OPENAI_API_KEY environment variable is not set`,suggestion:`Set OPENAI_API_KEY in your shell, e.g.
|
|
491
587
|
export OPENAI_API_KEY="sk-..."
|
|
492
588
|
|
|
493
589
|
Then re-run \`kick explain --ai "<your error>"\`.`};let r;try{r=await import(`@forinda/kickjs-ai`)}catch{return{kind:`unavailable`,reason:`@forinda/kickjs-ai is not installed`,suggestion:`Install the AI package to enable the LLM fallback:
|
|
@@ -503,7 +599,7 @@ Pass a message as a positional arg, --message flag, or pipe via stdin:
|
|
|
503
599
|
`),process.exit(1));let r=Fn(),i=Cn(n,r);if(t.json&&i){process.stdout.write(JSON.stringify({matched:!0,...i},null,2)+`
|
|
504
600
|
`);return}if(i){In(n,i.diagnosis,i.confidence);return}t.ai||(t.json&&(process.stdout.write(JSON.stringify({matched:!1},null,2)+`
|
|
505
601
|
`),process.exit(2)),Ln(n,!1),process.exit(2));let a=await wn({input:n,model:t.model,cwd:r.cwd});t.json&&(process.stdout.write(JSON.stringify(jn(a),null,2)+`
|
|
506
|
-
`),process.exit(a.kind===`ok`?0:2)),Mn(n,a),process.exit(a.kind===`ok`?0:2)})}function jn(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 Mn(e,t){if(t.kind===`ok`){In(e,t.diagnosis,-1,!0);return}if(t.kind===`unavailable`){process.stdout.write(`\n Explaining: ${X(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback unavailable: ${t.reason}\n\n`),process.stdout.write(`${Y(t.suggestion,` `)}\n\n`);return}process.stdout.write(`\n Explaining: ${X(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback error: ${t.message}\n\n`)}async function Nn(e,t){return e&&e.trim().length>0?e:t&&t.trim().length>0?t:process.stdin.isTTY?``:Pn()}function Pn(){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 Fn(){let e=process.cwd();return{cwd:e,hasFile:t=>
|
|
602
|
+
`),process.exit(a.kind===`ok`?0:2)),Mn(n,a),process.exit(a.kind===`ok`?0:2)})}function jn(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 Mn(e,t){if(t.kind===`ok`){In(e,t.diagnosis,-1,!0);return}if(t.kind===`unavailable`){process.stdout.write(`\n Explaining: ${X(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback unavailable: ${t.reason}\n\n`),process.stdout.write(`${Y(t.suggestion,` `)}\n\n`);return}process.stdout.write(`\n Explaining: ${X(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback error: ${t.message}\n\n`)}async function Nn(e,t){return e&&e.trim().length>0?e:t&&t.trim().length>0?t:process.stdin.isTTY?``:Pn()}function Pn(){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 Fn(){let e=process.cwd();return{cwd:e,hasFile:t=>j(A(e,t))}}function In(e,t,n,r=!1){let i=X(e.trim(),200),a=r?`AI-generated — verify before applying`:Rn(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${Y(t.explanation,` `)}\n`),process.stdout.write(`\n Fix:\n${Y(t.fix,` `)}\n`),t.codeBefore&&process.stdout.write(`\n Before:\n${Y(t.codeBefore,` `)}\n`),t.codeAfter&&process.stdout.write(`\n After:\n${Y(t.codeAfter,` `)}\n`),t.docs&&process.stdout.write(`\n Docs: ${t.docs}\n`),process.stdout.write(`
|
|
507
603
|
`)}function Ln(e,t){let n=X(e.trim(),200);process.stdout.write(`\n Explaining: ${n}\n\n`),t?process.stdout.write(` No known-issue matched, and --ai fallback is not yet wired.
|
|
508
604
|
When @forinda/kickjs-ai ships its provider implementations,
|
|
509
605
|
this command will call the configured LLM with the error +
|
|
@@ -523,10 +619,10 @@ Pass a message as a positional arg, --message flag, or pipe via stdin:
|
|
|
523
619
|
|
|
524
620
|
`)}function Y(e,t){return e.split(`
|
|
525
621
|
`).map(e=>`${t}${e}`).join(`
|
|
526
|
-
`)}function X(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function Rn(e){return e>=90?`high confidence`:e>=70?`good match`:e>=50?`medium confidence`:`low confidence — verify manually`}function zn(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(Bn),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(Vn)}function Bn(e){let t=
|
|
527
|
-
`,`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 Hn(e){let t=
|
|
622
|
+
`)}function X(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function Rn(e){return e>=90?`high confidence`:e>=70?`good match`:e>=50?`medium confidence`:`low confidence — verify manually`}function zn(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(Bn),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(Vn)}function Bn(e){let t=A(e.entry);j(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=ut(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)=>{if(t){process.kill(process.pid,t);return}process.exit(e??0)});let i=e=>{r.killed||r.kill(e)};process.on(`SIGINT`,()=>i(`SIGINT`)),process.on(`SIGTERM`,()=>i(`SIGTERM`))}function Vn(e){let t=process.cwd(),n=Hn(t)??Ze(t),r=e.name??n,i=e.global?A(process.env.HOME??`.`,`.mcp.json`):A(t,e.out),a={command:`kick`,args:[`mcp`],cwd:t},o={mcpServers:{}};if(j(i))try{let e=M(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,it(i,JSON.stringify(o,null,2)+`
|
|
623
|
+
`,`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 Hn(e){let t=A(e,`package.json`);if(!j(t))return null;try{let e=M(t,`utf8`),n=JSON.parse(e);return typeof n.name==`string`?n.name:null}catch{return null}}function Un(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=A(t,e.entry);j(n)||(console.error(`\n Error: ${e.entry} not found.\n`),process.exit(1));let r=Gn(t,`tsx`);r||(console.error(`
|
|
528
624
|
Error: tsx not found. Install it: pnpm add -D tsx
|
|
529
|
-
`),process.exit(1));let i=Wn(n,e.entry),a=
|
|
625
|
+
`),process.exit(1));let i=Wn(n,e.entry),a=k(t,`.kick-tinker.mjs`),{writeFileSync:o,unlinkSync:s}=await import(`node:fs`);o(a,i,`utf-8`);try{let e=lt(a,[],{cwd:t,execPath:r,stdio:`inherit`});await new Promise(t=>{e.on(`exit`,()=>t())})}finally{try{s(a)}catch{}}})}function Wn(e,t){return`
|
|
530
626
|
import 'reflect-metadata'
|
|
531
627
|
|
|
532
628
|
// Prevent bootstrap() from starting the HTTP server
|
|
@@ -551,7 +647,7 @@ try {
|
|
|
551
647
|
|
|
552
648
|
// Load entry to trigger decorator registration
|
|
553
649
|
try {
|
|
554
|
-
await import('${
|
|
650
|
+
await import('${I(e).href}')
|
|
555
651
|
} catch (err) {
|
|
556
652
|
console.warn(' Warning: ' + err.message)
|
|
557
653
|
console.warn(' Container may be partially initialized.\\n')
|
|
@@ -580,22 +676,22 @@ server.on('exit', () => {
|
|
|
580
676
|
console.log('\\n Goodbye!\\n')
|
|
581
677
|
process.exit(0)
|
|
582
678
|
})
|
|
583
|
-
`}function Gn(e,t){let n=e;for(;;){let e=
|
|
679
|
+
`}function Gn(e,t){let n=e;for(;;){let e=k(n,`node_modules`,`.bin`,t);if(j(e))return e;let r=A(n,`..`);if(r===n)break;n=r}return null}function Kn(e,t){let n=RegExp(`^\\s*${x(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]!==`
|
|
584
680
|
`;)s++;else{for(s+=2;s+1<a.length&&(a[s]!==`*`||a[s+1]!==`/`);)s++;s+=2}continue}let t=a[s]??``;if(t===`'`||t===`"`||t==="`"){let e=t;for(s++;s<a.length&&a[s]!==e;)a[s]===`\\`&&s++,s++}else if(t===`(`)o++;else if(t===`)`&&(o--,o===0))break;s++}if(o!==0)break;let c=a.slice(t,s);if(n.test(c)){let t=e;for(;t>0&&(a[t-1]===` `||a[t-1]===` `||a[t-1]===`
|
|
585
|
-
`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t;continue}i=s+1}return{content:a,changed:r}}function qn(e,t){let n=
|
|
681
|
+
`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t;continue}i=s+1}return{content:a,changed:r}}function qn(e,t){let n=ye(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=Kn(a,t).content,a=a.replace(RegExp(`\\s*,?\\s*${x(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 Jn(e){let{name:t,modulesDir:r,force:i}=e,a=e.pluralize!==!1,o=y(t),s=b(t),c=a?m(o):o,l=k(r,c);if(!await n(l)){console.log(`\n Module not found: ${l}\n`);return}if(!i&&!await f({message:p.red(`Delete module '${c}' at ${l}? This cannot be undone.`),initialValue:!1})){console.log(`
|
|
586
682
|
Cancelled.
|
|
587
|
-
`);return}await
|
|
683
|
+
`);return}await st(l,{recursive:!0,force:!0}),console.log(` Deleted: ${l}`);let u=k(r,`index.ts`);if(await n(u)){let e=await P(u,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${x(s)}Module\\s*\\}\\s*from\\s*['"][^'"]*${x(c)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=qn(e,s),e=e.replace(/\n{3,}/g,`
|
|
588
684
|
|
|
589
|
-
`),e!==t&&(await
|
|
685
|
+
`),e!==t&&(await F(u,e,`utf-8`),console.log(` Unregistered: ${s}Module from ${u}`))}console.log(`\n Module '${c}' removed.\n`)}function Yn(e){e.command(`remove`).alias(`rm`).description(`Remove generated code`).command(`module <names...>`).description(`Remove one or more modules (e.g. kick rm module user task)`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular module name`).option(`-f, --force`,`Skip confirmation prompt`).action(async(e,t)=>{let n=C(await S(process.cwd())),r=t.modulesDir??n.dir??`src/modules`,i=t.pluralize===!1?!1:n.pluralize??!0;for(let n of e)await Jn({name:n,modulesDir:A(r),force:t.force,pluralize:i})})}function Xn(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 Zn(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function Qn(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=w(process.cwd()),n=await S(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-Cfiz2G3K.mjs`).then(e=>e.t),{builtinCliPlugins:t}=await import(`./builtins-Cj4BWpIe.mjs`),r=e([...t,...n?.plugins??[]],n?.commands??[]),i=new Set(n?.typegen?.disable??[]);if(r.typegens.length===0){console.log(` No typegen plugins registered.`);return}let a=Math.max(...r.typegens.map(e=>e.id.length));console.log(`
|
|
590
686
|
Registered typegen plugins:
|
|
591
687
|
`);for(let e of r.typegens){let t=i.has(e.id)?` (disabled)`:``,n=`${e.id.replace(/\//g,`__`)}${e.outExtension??`.d.ts`}`;console.log(` ${e.id.padEnd(a+2)}→ .kickjs/types/${n}${t}`),console.log(` ${` `.repeat(a+2)} watches: ${e.inputs.join(`, `)||`(none)`}`)}console.log(`
|
|
592
688
|
Disable one in kick.config.ts:
|
|
593
689
|
`),console.log(` typegen: { disable: ['`+(r.typegens[0]?.id??`kick/x`)+`'] }
|
|
594
|
-
`);return}let r=Xn(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=Zn(e.envFile)??n?.typegen?.envFile,a={cwd:t,srcDir:e.src??n?.typegen?.srcDir,outDir:e.out??n?.typegen?.outDir,silent:e.silent,fix:e.fix,allowDuplicates:e.allowDuplicates,noCache:e.cache===!1,schemaValidator:r,envFile:i,assetMap:n?.assetMap,runPlugins:!1};try{if(e.watch){let t=await
|
|
690
|
+
`);return}let r=Xn(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=Zn(e.envFile)??n?.typegen?.envFile,a={cwd:t,srcDir:e.src??n?.typegen?.srcDir,outDir:e.out??n?.typegen?.outDir,silent:e.silent,fix:e.fix,allowDuplicates:e.allowDuplicates,noCache:e.cache===!1,schemaValidator:r,envFile:i,assetMap:n?.assetMap,runPlugins:!1};try{if(e.watch){let t=await qe(a);e.silent||console.log(` kick typegen: watching for changes (Ctrl-C to exit)`);let n=()=>{t(),process.exit(0)};process.on(`SIGINT`,n),process.on(`SIGTERM`,n),await new Promise(()=>{})}else{await E(a);let r=await H({cwd:t,config:n??null,silent:e.silent,check:e.check});e.check&&r.some(e=>e.status===`written`)&&process.exit(1),e.check||await He(A(t,e.out??n?.typegen?.outDir??`.kickjs/types`),r,e.silent??!1)}}catch(e){e instanceof Je?console.error(`
|
|
595
691
|
`+e.message+`
|
|
596
|
-
`):e instanceof
|
|
692
|
+
`):e instanceof ge?console.error(`
|
|
597
693
|
`+e.message+`
|
|
598
|
-
`):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}function $n(e){let t=[];if(!
|
|
694
|
+
`):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}function $n(e){let t=[];if(!j(e))return t;let n=nt(e,{withFileTypes:!0});for(let r of n){let n=k(e,r.name);if(r.isDirectory()){if([`node_modules`,`dist`,`.kickjs`,`.git`].includes(r.name))continue;t.push(...$n(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function er(e){try{return M(e,`utf-8`)}catch{return``}}const tr=new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function nr(e,t){let n=er(k(e,`.env`));if(n){let e=n.match(/^JWT_SECRET\s*=\s*['"]?([^'"\n]*)['"]?/m);if(e){let t=e[1].trim();if(tr.has(t.toLowerCase())||t.length<32)return{severity:`CRITICAL`,message:`JWT_SECRET appears to be a default value or too short (< 32 chars) — change it`}}}for(let e of t)for(let t of[/JWT_SECRET['"]?\s*[:=]\s*['"]?(secret|changeme|password|test|default)['"]?/i,/secret\s*[:=]\s*['"]?(secret|changeme|password|test|default)['"]?/i])if(t.test(e))return{severity:`CRITICAL`,message:`JWT_SECRET appears to be a default value in source code — use an environment variable`};return null}function rr(e){for(let t of e)if(/cors\s*\(/.test(t)&&/origin\s*:\s*['"]\*['"]/.test(t))return{severity:`CRITICAL`,message:`CORS origin is '*' — restrict to your domains`};return null}function ir(e){for(let t of e)if(/rateLimit/i.test(t)||/@RateLimit/i.test(t))return null;return{severity:`WARNING`,message:`No rate limiting detected — add rateLimit() middleware or @RateLimit decorator`}}function ar(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function or(e){let t=!1,n=!1;for(let r of e)/tokenStore/i.test(r)&&(t=!0),/MemoryTokenStore/i.test(r)&&(n=!0);return n?{severity:`WARNING`,message:`MemoryTokenStore detected — use a persistent store (Redis, DB) for production deployments`}:t?null:{severity:`WARNING`,message:`No token revocation store detected — consider adding one for auth token management`}}function sr(e){for(let t of e)if(/helmet\s*\(/.test(t))return/security\s*\.\s*helmet\s*.*false/.test(t)?{severity:`WARNING`,message:`Helmet security headers are disabled — enable them for production`}:{severity:`INFO`,message:`Helmet security headers active`};return{severity:`WARNING`,message:`Helmet not detected — add helmet() middleware for security headers`}}function cr(e){for(let t of e)if(/AuthAdapter/i.test(t))return{severity:`INFO`,message:`AuthAdapter configured`};return{severity:`INFO`,message:`No AuthAdapter detected — add one if your app requires authentication`}}function lr(e){let t=$n(k(e,`src`)).map(e=>er(e)),n=[],r=nr(e,t);r&&n.push(r);let i=rr(t);i&&n.push(i);let a=ir(t);a&&n.push(a);let o=ar();o&&n.push(o);let s=or(t);return s&&n.push(s),n.push(sr(t)),n.push(cr(t)),n}function ur(e){e.command(`check`).description(`Audit project for common issues`).option(`--deploy`,`Run production readiness checks`).action(e=>{if(!e.deploy){console.log(`
|
|
599
695
|
Usage: kick check --deploy
|
|
600
696
|
|
|
601
697
|
Available checks:
|
|
@@ -609,7 +705,7 @@ server.on('exit', () => {
|
|
|
609
705
|
The regex-based rewrite handles the shapes our templates produce.
|
|
610
706
|
Hand-rolled modules with non-standard structures may be skipped.
|
|
611
707
|
Always commit before running with --apply.
|
|
612
|
-
`),process.exit(1));let i=
|
|
708
|
+
`),process.exit(1));let i=C(await S(process.cwd())),a=A(t.modulesDir??i.dir??`src/modules`),o;t.target===`define`||t.target===`class`?o=t.target:t.target===void 0?o=i.style??`define`:(console.error(`\n ${p.red(`Error:`)} --target must be 'define' or 'class' (got '${t.target}').\n`),process.exit(1));let s=p.dim(`→ ${o}`),c=r?p.dim(`(dry-run)`):p.bold(`(applying)`);console.log(`\n ${p.bold(`kick codemod modules`)} ${s} ${c}`),console.log(` modulesDir: ${p.dim(a)}\n`);let l=t.backup!==!1&&!r,u=await Mt(a,{dryRun:r,target:o,backup:l});if(u.backupDir){let e=u.backupDir;console.log(` ${p.green(`✓`)} backup: ${p.dim(e)}\n ${p.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else!r&&t.backup===!1&&console.log(` ${p.dim(`(--no-backup — skipping snapshot)`)}\n`);let d=0,f=0;for(let e of u.files)if(e.status===`migrated`)d++,console.log(` ${p.green(`✓`)} ${e.path}`);else{f++;let t=p.dim(`(${e.reason??`skipped`})`);console.log(` ${p.dim(`-`)} ${e.path} ${t}`)}if(console.log(),u.indexStatus===`migrated`)console.log(` ${p.green(`✓`)} ${u.indexPath}`);else if(u.indexStatus===`skipped`){let e=p.dim(`(${u.indexReason??`skipped`})`);console.log(` ${p.dim(`-`)} ${u.indexPath} ${e}`)}else console.log(` ${p.dim(`-`)} ${u.indexPath} ${p.dim(`(not found)`)}`);let m=r?p.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n ${p.bold(String(d))} migrated, ${p.bold(String(f))} skipped${m}\n`)})}const pr=()=>({id:`kick/assets`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`],async generate(e){if(!j(D.resolve(e.cwd,`kick.config.ts`)))return null;let t=await S(e.cwd);if(!t?.assetMap)return null;let n=Ie(t.assetMap,e.cwd);return n.count===0?null:Ge(n)}}),mr="/* eslint-disable */\n// AUTO-GENERATED by `kick typegen`. DO NOT EDIT.\n// Re-run with `kick typegen` or rely on `kick dev` to refresh.\n";function hr(e,t,n,r={}){if(e.length===0)return`${mr}
|
|
613
709
|
// (no routes discovered yet — annotate a controller method with
|
|
614
710
|
// @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
|
|
615
711
|
declare global {
|
|
@@ -647,16 +743,16 @@ ${b}
|
|
|
647
743
|
${g}
|
|
648
744
|
`}function gr(e){let t=e.contextKeys;return t==null?`string`:t.length===0?`never`:t.map(e=>JSON.stringify(e)).join(` | `)}function _r(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 }`}function vr(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 yr(e,t,n,r,i){if(!e||r===!1||e.source===null)return null;let a=xr(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 br(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(`
|
|
649
745
|
`)+`
|
|
650
|
-
`}function xr(e,t,n){if(e===null)return`unknown`;let r=
|
|
651
|
-
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 '${Z}' resolved from this project.\n ${t}`)}async function Or(e){let t=
|
|
746
|
+
`}function xr(e,t,n){if(e===null)return`unknown`;let r=O(n);if(e===``){let e=Qe(r,t).split($e).join(`/`);return e=e.replace(/\.(ts|tsx|mts|cts)$/i,``),e.startsWith(`.`)||(e=`./`+e),e}if(!e.startsWith(`.`)&&!e.startsWith(`/`))return e;let i=Qe(r,A(O(t),e)).split($e).join(`/`);return i=i.replace(/\.(ts|tsx|mts|cts)$/i,``),i.startsWith(`.`)||(i=`./`+i),i}function Sr(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 Cr=()=>({id:`kick/routes`,outExtension:`.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){let t=await e.getScanResult({root:wr(e),cwd:e.cwd,envFile:Tr(e)}),n=e.config?.typegen?.schemaValidator??`zod`,r=D.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return hr(t.routes,r,n,{onWarn:t=>e.log.warn(t)})}});function wr(e){return D.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Tr(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}const Z=`@typescript/typescript6`;function Er(e){return typeof e?.createProgram==`function`}function Dr(e){if(Er(e.typescript))return{api:e.typescript,source:`typescript`};if(Er(e.ts6))return{api:e.ts6,source:Z};let t=`Install it in the project:\n pnpm add -D ${Z}`;throw e.typescript?Error(`kick typegen: the client route map needs a TypeScript compiler API.
|
|
747
|
+
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 '${Z}' resolved from this project.\n ${t}`)}async function Or(e){let t=Xe(k(e,`package.json`)),n=async e=>{try{return await import(I(t.resolve(e)).href)}catch{return null}},[r,i]=await Promise.all([n(`typescript`),n(Z)]);return Dr({typescript:kr(r),ts6:kr(i)}).api}function kr(e){let t=e;return t?.default&&typeof t.default==`object`?t.default:e}const Ar=Symbol(`kick/client: expansion budget exhausted`);var jr=class{ts;checker;program;opts;get printFlags(){return this.ts.TypeFormatFlags.NoTruncation}hoistedByType=new Map;inProgress=new Map;jsonInProgress=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;try{return this.render(e,0)}catch(e){if(e!==Ar)throw e;return this.opts.onWarn?.(`expansion abandoned after ${this.budget} truncations — emitting 'unknown'. This usually means a recursive type. Declare a response schema on the route for an exact type.`),`unknown`}}render(e,t){let n=this.ts.TypeFlags;if(t>this.maxDepth){if(++this.truncations>this.budget)throw Ar;return this.opts.onWarn?.(`type nesting exceeded ${this.maxDepth} levels — emitting 'unknown'. Declare a response schema on the route for an exact type.`),`unknown`}if(e.flags&(n.String|n.Number|n.Boolean|n.BigInt|n.ESSymbol)||e.flags&(n.Any|n.Unknown|n.Never|n.Void|n.Undefined|n.Null)||e.isLiteral()||e.flags&n.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 r=this.arrayElement(e);if(r){let e=this.render(r.element,t+1),n=/[|&]/.test(e)?`(${e})[]`:`${e}[]`;return r.readonly?`readonly ${n}`:n}let i=this.toJsonType(e);if(i){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(i,t)}finally{this.jsonInProgress.delete(e)}}return this.isLibType(e)?this.renderLibType(e,t):e.flags&n.Object?this.renderObject(e,t):(this.opts.onWarn?.(`could not expand type '${this.checker.typeToString(e)}' — emitting 'unknown'`),`unknown`)}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=`
|
|
652
748
|
`){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===`
|
|
653
749
|
`?`
|
|
654
|
-
`: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 Mr=[`pnpm-lock.yaml`,`package-lock.json`,`yarn.lock`,`bun.lock`,`bun.lockb`],Nr=/(?:^|[\\/])(?:node_modules|\.kickjs)(?:[\\/]|$)/;function Pr(e){return
|
|
655
|
-
`));for(let n of Mr){let r=
|
|
656
|
-
`);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 zr(e){return`_K${e}`}function Br(e,t){let n=`./`+
|
|
750
|
+
`: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 Mr=[`pnpm-lock.yaml`,`package-lock.json`,`yarn.lock`,`bun.lock`,`bun.lockb`],Nr=/(?:^|[\\/])(?:node_modules|\.kickjs)(?:[\\/]|$)/;function Pr(e){return gt(`sha1`).update(e).digest(`hex`)}function Fr(e){let t=gt(`sha1`);t.update(e.cliVersion),t.update(JSON.stringify(e.options??{})),t.update(e.keys.join(`
|
|
751
|
+
`));for(let n of Mr){let r=k(e.projectDir,n);if(j(r))try{t.update(M(r))}catch(e){throw Error(`kick/client: cannot read lockfile ${r}`,{cause:e})}}for(let n of e.fileNames.toSorted())if(!Nr.test(n)){t.update(n);try{t.update(M(n))}catch(e){throw Error(`kick/client: cannot read project file ${n}`,{cause:e})}}return t.digest(`hex`)}async function Ir(e){try{let t=await Or(e.compilerFrom??e.projectDir),n={...t.sys,onUnRecoverableConfigFileDiagnostic:()=>{}},r=t.getParsedCommandLineOfConfigFile(k(e.projectDir,`tsconfig.json`),{},n);return r?Fr({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 Lr(e){let t=await Or(e.compilerFrom??e.projectDir),n=k(O(e.routesFile),`__kick_client_probe__.ts`),r=Br(e.routesFile,e.keys),i=Ur(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.`);Rr(t,i,e.routesFile);let s=Vr(t,i,o,e.keys),c=null,l=new jr(t,a,i,{maxDepth:e.maxDepth,onWarn:t=>e.onWarn?.(c?`route '${c}': ${t}`:t)}),u=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===zr(n));if(!i){e.onWarn?.(`route '${r}' could not be resolved — skipped.`);continue}let d=a.getTypeAtLocation(i.type);if(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.`);continue}c=r,u.set(r,l.expand(d)),c=null}return{entries:u,hoisted:l.hoisted()}}function Rr(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(`
|
|
752
|
+
`);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 zr(e){return`_K${e}`}function Br(e,t){let n=`./`+Ze(e).replace(/\.tsx?$/,``),r=t.map((e,t)=>`type ${zr(t)} = KickRoutes.Api[${JSON.stringify(e)}]`);return[`import ${JSON.stringify(n)}`,...r].join(`
|
|
657
753
|
`)+`
|
|
658
|
-
`}function Vr(e,t,n,r){let i=new Set,a=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(zr(t));r&&e.start>=r.getStart(n)&&e.start<r.getEnd()&&i.add(o)}return i}function Hr(e,t){let n=e.filter(e=>/\.d\.(ts|mts|cts)$/.test(e)),r=[];try{r=
|
|
659
|
-
`))}},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:[...Hr(o.fileNames,
|
|
754
|
+
`}function Vr(e,t,n,r){let i=new Set,a=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(zr(t));r&&e.start>=r.getStart(n)&&e.start<r.getEnd()&&i.add(o)}return i}function Hr(e,t){let n=e.filter(e=>/\.d\.(ts|mts|cts)$/.test(e)),r=[];try{r=nt(t).filter(e=>e.endsWith(`.ts`)).map(e=>k(t,e))}catch{}return[...new Set([...n,...r])]}function Ur(e,t,n,r){let i=k(t,`tsconfig.json`),a={...e.sys,onUnRecoverableConfigFileDiagnostic:t=>{throw Error(e.flattenDiagnosticMessageText(t.messageText,`
|
|
755
|
+
`))}},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:[...Hr(o.fileNames,O(n)),n],options:o.options,host:s})}const Wr=`/* eslint-disable */
|
|
660
756
|
// AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
|
|
661
757
|
//
|
|
662
758
|
// Self-contained: this file has no imports, so a frontend consumes it without
|
|
@@ -701,7 +797,7 @@ declare global {
|
|
|
701
797
|
}
|
|
702
798
|
|
|
703
799
|
export type { Api }
|
|
704
|
-
`}const Kr=`kick/client`,Q=`.kickjs/types/kick__client.d.ts`,qr=`.kickjs/cache/client-map.sha1`,Jr=(()=>{try{return
|
|
800
|
+
`}const Kr=`kick/client`,Q=`.kickjs/types/kick__client.d.ts`,qr=`.kickjs/cache/client-map.sha1`,Jr=(()=>{try{return Xe(import.meta.url)(`../../../package.json`).version??`0.0.0`}catch{return`0.0.0`}})();function Yr(e){try{if(!j(e))return null;let[t,n]=M(e,`utf-8`).trim().split(/\s+/);return t&&n?{inputs:t,output:n}:null}catch{return null}}function Xr(e){return`${Xt}${Kr} */\n\n${e}\n`}function Zr(e){try{return j(e)?M(e,`utf-8`):null}catch{return null}}async function Qr(e){let t=D.resolve(e.cwd,Q);if(!j(t))return!1;try{await st(t,{force:!0})}catch(t){return e.log.warn(` kick/client: could not remove the stale ${Q} — treat it as out of date (${t instanceof Error?t.message:String(t)})`),!0}return e.log.warn(` kick/client: removed the previously generated ${Q} rather than leave a stale one — re-run \`kick typegen\` once the cause above is fixed.`),!0}function $r(e){let t=e?.typegen?.client;return typeof t==`object`?t.maxDepth:void 0}function ei(e){let t=e.config?.typegen?.client;return typeof t==`boolean`?t:t&&typeof t==`object`?t.enabled!==!1:(j(D.resolve(e.cwd,Q))&&e.log.warn(` kick/client: ${Q} exists but typegen.client is not set, so it is NOT being refreshed.\n Add \`typegen: { client: true }\` to kick.config.ts to keep it current, or delete the file if nothing reads it.`),!1)}const ti=()=>({id:Kr,outExtension:`.d.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){if(!ei(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:D.resolve(e.cwd,e.config?.typegen?.srcDir??`src`),cwd:e.cwd}),n=[],r=new Set;for(let e of t.routes){let t=`${e.httpMethod} ${e.mountedPath??e.path}`;r.has(t)||(r.add(t),n.push(t))}let i=$r(e.config),a=await Ir({projectDir:e.cwd,keys:n,maxDepth:i,cliVersion:Jr}),o=Yr(D.resolve(e.cwd,qr)),s=Zr(D.resolve(e.cwd,Q));if(a&&o&&s!==null&&o.inputs===a&&o.output===Pr(s))return se()&&e.log.info?.(` kick/client: unchanged, keeping ${Q}`),null;try{let t=Gr(await Lr({projectDir:e.cwd,routesFile:D.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(qr,`${a} ${Pr(Xr(t))}`),t}catch(t){let n=j(D.resolve(e.cwd,Q)),r=` kick/client: skipped — ${t instanceof Error?t.message:String(t)}`;return n?e.log.warn(r):se()&&e.log.info?.(r),n&&await Qr(e),null}}});function ni(e,t,n=`zod`){if(!e)return null;let r=Qe(O(t),e.filePath).split($e).join(`/`);return r=r.replace(/\.(ts|tsx|mts|cts)$/i,``),r.startsWith(`.`)||(r=`./`+r),`/* eslint-disable */
|
|
705
801
|
// AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
|
|
706
802
|
// Re-run with \`kick typegen\` or rely on \`kick dev\` to refresh.
|
|
707
803
|
|
|
@@ -739,6 +835,6 @@ declare global {
|
|
|
739
835
|
}
|
|
740
836
|
|
|
741
837
|
export {}
|
|
742
|
-
`}const ri=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=ai(e);if(t===!1)return null;let n=await e.getScanResult({root:ii(e),cwd:e.cwd,envFile:t});if(!n.env)return null;let r=e.config?.typegen?.schemaValidator??`zod`,i=
|
|
743
|
-
`)}}]})];export{
|
|
744
|
-
//# sourceMappingURL=run-plugins-
|
|
838
|
+
`}const ri=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=ai(e);if(t===!1)return null;let n=await e.getScanResult({root:ii(e),cwd:e.cwd,envFile:t});if(!n.env)return null;let r=e.config?.typegen?.schemaValidator??`zod`,i=D.resolve(e.cwd,`.kickjs/types/kick__env.ts`);return ni(n.env,i,r)}});function ii(e){return D.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function ai(e){return e.config?.typegen?.envFile}function oi(e){return D.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function si(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function $(e){return{root:oi(e),cwd:e.cwd,envFile:si(e)}}const ci=()=>({id:`kick/registry`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e)),n=D.resolve(e.cwd,`.kickjs/types/kick__registry.d.ts`),r=new Set(t.collisions.map(e=>e.className));return Ke(t.classes,n,r)}}),li=()=>({id:`kick/services`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e)),n=new Set(t.collisions.map(e=>e.className));return Ve(`ServiceToken`,Ue(t.classes,t.tokens,t.injects,n),"(no tokens discovered — declare with createToken<T>() or `kick g service <name>`)")}}),ui=()=>({id:`kick/modules`,inputs:[`src/**/*.ts`],async generate(e){return Ve(`ModuleToken`,Le((await e.getScanResult($(e))).classes),"(no @Module classes discovered — `kick g module <name>` to add one)")}}),di=()=>({id:`kick/plugins`,inputs:[`src/**/*.ts`],async generate(e){return ze((await e.getScanResult($(e))).pluginsAndAdapters)}}),fi=()=>({id:`kick/augmentations`,inputs:[`src/**/*.ts`],async generate(e){return Ye((await e.getScanResult($(e))).augmentations)}}),pi=()=>({id:`kick/context`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return t.contextKeys.length===0?null:Re(t.contextKeys)}}),mi=()=>({id:`kick/route-flags`,inputs:[`src/**/*.ts`],async generate(e){return We((await e.getScanResult($(e))).routeFlags)}}),hi={fastify:{subpath:`@forinda/kickjs/fastify`,typeName:`FastifyRuntimeTypes`},h3:{subpath:`@forinda/kickjs/h3`,typeName:`H3RuntimeTypes`}},gi=[T({name:`kick/init`,register:vt}),T({name:`kick/generate`,register:Jt}),T({name:`kick/run`,register:cn}),T({name:`kick/info`,register:pn}),T({name:`kick/inspect`,register:xn}),T({name:`kick/add`,register:xe}),T({name:`kick/list`,register:Ce}),T({name:`kick/explain`,register:An}),T({name:`kick/mcp`,register:zn}),T({name:`kick/tinker`,register:Un}),T({name:`kick/remove`,register:Yn}),T({name:`kick/typegen`,register:Qn}),T({name:`kick/check`,register:ur}),T({name:`kick/doctor`,register:he}),T({name:`kick/codemod`,register:fr}),T({name:`kick/registry`,typegens:[ci()]}),T({name:`kick/services`,typegens:[li()]}),T({name:`kick/modules`,typegens:[ui()]}),T({name:`kick/plugins`,typegens:[di()]}),T({name:`kick/augmentations`,typegens:[fi()]}),T({name:`kick/context`,typegens:[pi()]}),T({name:`kick/route-flags`,typegens:[mi()]}),T({name:`kick/assets`,typegens:[pr()]}),T({name:`kick/routes`,typegens:[Cr()]}),T({name:`kick/client`,typegens:[ti()]}),T({name:`kick/env`,typegens:[ri()]}),T({name:`kick/runtime`,typegens:[{id:`kick/runtime`,outExtension:`.ts`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`,`kick.config.json`],async generate(e){let t=e.config?.runtime;if(t!==`fastify`&&t!==`h3`)return null;let{subpath:n,typeName:r}=hi[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(`
|
|
839
|
+
`)}}]})];export{$t as applyDisableFilter,H as runAllPluginTypegens,gi as t};
|
|
840
|
+
//# sourceMappingURL=run-plugins-GxEtP9WR.mjs.map
|