@forinda/kickjs-cli 8.1.3 → 8.1.5
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-C6feHEIe.mjs → agent-docs-BK33p0Pw.mjs} +2 -2
- package/dist/{agent-docs-CksX-ROg.mjs → agent-docs-DzaWoZc7.mjs} +3 -3
- package/dist/{agent-docs-CksX-ROg.mjs.map → agent-docs-DzaWoZc7.mjs.map} +1 -1
- package/dist/{build-nf_1TqZ-.mjs → build-DBT23vXN.mjs} +3 -3
- package/dist/{build-nf_1TqZ-.mjs.map → build-DBT23vXN.mjs.map} +1 -1
- package/dist/{build-BDwasfWP.mjs → build-clh7HpZV.mjs} +2 -2
- package/dist/{builtins-XSYvrFb3.mjs → builtins-B6Dc2coA.mjs} +163 -146
- package/dist/{builtins-CXyb3PC1.mjs → builtins-HdwKAx0s.mjs} +2 -2
- package/dist/cli.mjs +2 -2
- package/dist/config-CzL24fBQ.mjs +12 -0
- package/dist/config-D06pHD-Y.mjs +13 -0
- package/dist/{config-DNf67j-M.mjs.map → config-D06pHD-Y.mjs.map} +1 -1
- package/dist/{doctor-C_Nwy9pB.mjs → doctor-Bi_jVzha.mjs} +59 -54
- package/dist/doctor-Bi_jVzha.mjs.map +1 -0
- package/dist/{fullstack-0pA-ni3E.mjs → fullstack-CdAbknb3.mjs} +4 -4
- package/dist/{fullstack-0pA-ni3E.mjs.map → fullstack-CdAbknb3.mjs.map} +1 -1
- package/dist/{fullstack-BLs3Q93Y.mjs → fullstack-DAEEITND.mjs} +3 -3
- package/dist/index.d.mts +11 -0
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +2 -2
- package/dist/{plugin-D5BaucQm.mjs → plugin-BSNGbECd.mjs} +2 -2
- package/dist/{plugin-DgYOUNLo.mjs → plugin-CD9WjquV.mjs} +3 -3
- package/dist/{plugin-DgYOUNLo.mjs.map → plugin-CD9WjquV.mjs.map} +1 -1
- package/dist/{project-ChvYcc9t.mjs → project-DfBzpCeE.mjs} +5 -5
- package/dist/{project-docs-BgHHE2Y-.mjs → project-docs-BCwWphge.mjs} +3 -3
- package/dist/{project-docs-BgHHE2Y-.mjs.map → project-docs-BCwWphge.mjs.map} +1 -1
- package/dist/{project-docs-Bj8TOOks.mjs → project-docs-DRLN1EDX.mjs} +2 -2
- package/dist/{project-BwghMh67.mjs → project-indmSdfC.mjs} +6 -6
- package/dist/project-indmSdfC.mjs.map +1 -0
- package/dist/{project-root-Bakzso9Y.mjs → project-root-BsyQhlS5.mjs} +2 -2
- package/dist/{project-root-C-NAF0bl.mjs → project-root-CQCNCAvv.mjs} +3 -3
- package/dist/{project-root-C-NAF0bl.mjs.map → project-root-CQCNCAvv.mjs.map} +1 -1
- package/dist/{prompts-B1P3iwUU.mjs → prompts-Ba0PO3Rn.mjs} +2 -2
- package/dist/{prompts-B1P3iwUU.mjs.map → prompts-Ba0PO3Rn.mjs.map} +1 -1
- package/dist/{rolldown-runtime-C7LUc-Oa.mjs → rolldown-runtime-DmTqmRjS.mjs} +1 -1
- package/dist/{run-plugins-CTbRE_nh.mjs → run-plugins-BKWupYoJ.mjs} +94 -82
- package/dist/run-plugins-BKWupYoJ.mjs.map +1 -0
- package/dist/{typegen-D1esvePN.mjs → typegen-B6vIx4Qd.mjs} +4 -4
- package/dist/{typegen-CgN9aE8p.mjs → typegen-CnsfSSpH.mjs} +5 -5
- package/dist/{typegen-CgN9aE8p.mjs.map → typegen-CnsfSSpH.mjs.map} +1 -1
- package/dist/{types-Cloqgm4i.mjs → types-B6yNws8R.mjs} +1 -1
- package/package.json +4 -4
- package/dist/config-B78h-btI.mjs +0 -12
- package/dist/config-DNf67j-M.mjs +0 -13
- package/dist/doctor-C_Nwy9pB.mjs.map +0 -1
- package/dist/project-BwghMh67.mjs.map +0 -1
- package/dist/run-plugins-CTbRE_nh.mjs.map +0 -1
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs-cli v8.1.
|
|
2
|
+
* @forinda/kickjs-cli v8.1.5
|
|
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-BCwWphge.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-Ba0PO3Rn.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 x,_ as ne,a as re,b as ie,c as ae,f as oe,g as se,h as ce,i as le,j as ue,k as S,l as de,m as fe,p as pe,r as me,u as he,v as ge,w as _e,x as ve,y as ye}from"./doctor-Bi_jVzha.mjs";import{a as be,c as xe,o as Se,r as Ce,t as we,u as Te}from"./project-indmSdfC.mjs";import{a as Ee,c as De,i as Oe,l as ke,o as C,s as w,u as Ae}from"./config-D06pHD-Y.mjs";import{t as T}from"./project-root-CQCNCAvv.mjs";import{n as E}from"./types-B6yNws8R.mjs";import{t as je}from"./build-DBT23vXN.mjs";import{n as Me}from"./agent-docs-DzaWoZc7.mjs";import{n as Ne}from"./plugin-CD9WjquV.mjs";import{_ as Pe,a as Fe,c as Ie,d as Le,f as Re,g as ze,h as Be,i as Ve,l as He,m as Ue,o as We,p as Ge,r as Ke,s as qe,t as D,u as Je}from"./typegen-CnsfSSpH.mjs";import{createRequire as Ye}from"node:module";import O,{basename as Xe,dirname as k,join as A,relative as Ze,resolve as j,sep as Qe}from"node:path";import{cpSync as $e,existsSync as M,mkdirSync as et,readFileSync as N,readdirSync as tt,rmSync as nt,writeFileSync as rt}from"node:fs";import{copyFile as it,mkdir as P,readFile as F,readdir as at,rm as ot,stat as st,writeFile as I}from"node:fs/promises";import{fork as ct,spawn as lt,spawnSync as ut}from"node:child_process";import{fileURLToPath as dt,pathToFileURL as L}from"node:url";import{arch as ft,platform as pt,release as mt}from"node:os";import{createHash as ht}from"node:crypto";const gt=[{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 _t(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=j(`.`),e=Xe(a)):a=j(t.directory||e),M(a)){let i=tt(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)nt(j(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 xe(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`}),Ae(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:[...gt],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-CdAbknb3.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 we({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 vt(e){let{name:n,outDir:r}=e,i=y(n),a=b(n),o=[],s=A(r,`${i}.plugin.ts`);return await t(s,`import {
|
|
12
12
|
definePlugin,
|
|
13
13
|
type AppAdapter,
|
|
14
14
|
type AppModuleEntry,
|
|
@@ -37,18 +37,27 @@ export interface ${a}PluginConfig {
|
|
|
37
37
|
* A plugin bundles DI bindings, modules, adapters, and middleware
|
|
38
38
|
* into one object that can be added to \`bootstrap({ plugins })\`.
|
|
39
39
|
*
|
|
40
|
-
*
|
|
41
|
-
*
|
|
40
|
+
* Call order (each hook is optional — delete the ones you don't need and
|
|
41
|
+
* keep only the surface your plugin actually uses). This is the order the
|
|
42
|
+
* hooks are INVOKED in, which is not the order they read in below:
|
|
42
43
|
*
|
|
43
|
-
* 1. \`
|
|
44
|
-
*
|
|
45
|
-
* 2. \`
|
|
46
|
-
*
|
|
47
|
-
*
|
|
44
|
+
* 1. \`adapters()\` — read first, while the app is still being
|
|
45
|
+
* constructed; the returned adapters mount before user adapters.
|
|
46
|
+
* 2. \`register(container)\` — runs before user modules load. Use it to
|
|
47
|
+
* bind services that modules depend on.
|
|
48
|
+
* 3. \`middleware()\` — mounts BEFORE \`modules()\` is read, so a
|
|
49
|
+
* handler here cannot resolve anything a plugin module registers.
|
|
50
|
+
* 4. \`modules()\` / \`setup(registry)\` — plugin modules load before user
|
|
51
|
+
* modules.
|
|
48
52
|
* 5. \`contributors()\` — Context Contributors merged into every route.
|
|
49
53
|
* 6. \`onReady(container)\` — runs after the app has fully bootstrapped.
|
|
50
54
|
* 7. \`shutdown()\` — on shutdown AND every HMR reload.
|
|
51
55
|
*
|
|
56
|
+
* \`.async()\` resolves its config inside \`onReady\`, which is past every
|
|
57
|
+
* contribution point above: only \`register()\`, \`onReady()\` and
|
|
58
|
+
* \`shutdown()\` still run. Use the bare or \`.scoped()\` form when the plugin
|
|
59
|
+
* ships modules, adapters, middleware, or contributors.
|
|
60
|
+
*
|
|
52
61
|
* @example
|
|
53
62
|
* \`\`\`ts
|
|
54
63
|
* import { bootstrap } from '@forinda/kickjs'
|
|
@@ -102,8 +111,11 @@ export const ${a}Plugin = definePlugin<${a}PluginConfig>({
|
|
|
102
111
|
},
|
|
103
112
|
|
|
104
113
|
/**
|
|
105
|
-
* Return
|
|
106
|
-
* pipeline.
|
|
114
|
+
* Return connect-style handlers — \`(req, res, next)\` — for the global
|
|
115
|
+
* pipeline. Every runtime accepts them: each one is mounted through the
|
|
116
|
+
* engine's \`useConnect\` seam, so this is NOT Express-only. Plugin
|
|
117
|
+
* middleware runs before user-defined middleware, and takes no
|
|
118
|
+
* \`phase\` / \`path\` — use an adapter's \`middleware()\` for those.
|
|
107
119
|
*/
|
|
108
120
|
middleware(): unknown[] {
|
|
109
121
|
return [
|
|
@@ -154,7 +166,7 @@ export const ${a}Plugin = definePlugin<${a}PluginConfig>({
|
|
|
154
166
|
},
|
|
155
167
|
}),
|
|
156
168
|
})
|
|
157
|
-
`),o.push(s),o}function
|
|
169
|
+
`),o.push(s),o}function yt(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 bt(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:yt(e.params),d=ge({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(`
|
|
158
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.
|
|
159
171
|
// Add \`paramDefaults: { … }\` for any field whose default is
|
|
160
172
|
// genuinely correct for an undecorated route, and drop it from here.
|
|
@@ -205,7 +217,7 @@ ${ee}
|
|
|
205
217
|
throw new Error("${c} contributor: resolve() not implemented")
|
|
206
218
|
},
|
|
207
219
|
})
|
|
208
|
-
`,
|
|
220
|
+
`,x=A(d,`${s}.contributor.ts`);return await t(x,te),[x]}async function xt(e){let n=A(e.outDir,`kick.config.ts`),r=e.modulesDir??`src/modules`,i=e.defaultRepo??`inmemory`;return M(n)&&!e.force&&!await f({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
|
|
209
221
|
Skipped — existing kick.config.ts preserved.`),[]):(await t(n,`import { defineConfig } from '@forinda/kickjs-cli'
|
|
210
222
|
|
|
211
223
|
export default defineConfig({
|
|
@@ -250,16 +262,16 @@ export default defineConfig({
|
|
|
250
262
|
})
|
|
251
263
|
`),[n])}function R(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 z(e,t){let n=t.exec(e);if(!n)return null;let r=n.index+n[0].length-1,i=R(e,r);return i===-1?null:e.slice(r+1,i)}function B(e,t,n){let r=` `.repeat(n);return e.split(`
|
|
252
264
|
`).map(e=>{if(e.trim()===``)return e;let n=RegExp(`^ {0,${t}}`),i=e.replace(n,``);return r+i}).join(`
|
|
253
|
-
`)}function
|
|
265
|
+
`)}function St(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 Ct(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 wt(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=R(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=z(o,/register\s*\(([^)]*)\)\s*:\s*void\s*\{/),u=z(o,/contributors\s*\(\s*\)\s*:\s*ContributorRegistrations\s*\{/),d=z(o,/routes\s*\(\s*\)\s*:\s*[A-Za-z|[\]\s]+\{/);if(!d)return{migrated:null,reason:`routes() method missing or signature unrecognized`};let f=St(s),p=``;return l&&(p+=` register(container) {${B(l,4,6)} },\n\n`),u&&(p+=` contributors() {${B(u,4,6)} },\n\n`),p+=` routes() {${B(d,4,6)} },`,{migrated:`${f}${`export const ${r} = defineModule({
|
|
254
266
|
name: '${r}',
|
|
255
267
|
build: () => ({
|
|
256
268
|
${p}
|
|
257
269
|
}),
|
|
258
|
-
})`}${c}`}}function
|
|
259
|
-
`||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=R(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=z(m,/register\s*\(([^)]*)\)\s*\{/),g=z(m,/contributors\s*\(\s*\)\s*\{/),_=z(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let v=
|
|
270
|
+
})`}${c}`}}function Tt(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=R(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=R(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=z(m,/register\s*\(([^)]*)\)\s*\{/),g=z(m,/contributors\s*\(\s*\)\s*\{/),_=z(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let v=Ct(c,{container:h!==null,appModule:!0,moduleRoutes:!0,contributorRegistrations:g!==null}),y=``;return h!==null&&(y+=` register(container: Container): void {${B(h,6,4)} }\n\n`),g!==null&&(y+=` contributors(): ContributorRegistrations {${B(g,6,4)} }\n\n`),y+=` routes(): ModuleRoutes {${B(_,6,4)} }`,{migrated:`${v}${`export class ${r} implements AppModule {
|
|
260
272
|
${y}
|
|
261
273
|
}
|
|
262
|
-
`}${u}`}}function
|
|
274
|
+
`}${u}`}}function Et(e,t){return t===`class`?Tt(e):wt(e)}function Dt(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 Ot(e){let t=[];return await n(j(e),0),t;async function n(e,r){let i;try{i=await at(e)}catch{return}for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=A(e,a),o;try{o=await st(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function kt(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await at(e)}catch{return}await P(t,{recursive:!0});for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=A(e,a),o=A(t,a),s;try{s=await st(i)}catch{continue}s.isDirectory()?await r(i,o):(await it(i,o),n++)}}}function At(e){return A(e,`.kickjs`,`codemod-backups`,`${new Date().toISOString().replaceAll(/[:.]/g,`-`)}-modules`)}async function jt(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await Ot(e),s=await F(A(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=At(r),await kt(e,c));let l=[];for(let e of o){let t=Et(await F(e,`utf-8`),i);if(t.migrated==null){l.push({path:e,status:`skipped`,reason:t.reason});continue}n||await I(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`})}let u=A(e,`index.ts`),d=null;try{d=await F(u,`utf-8`)}catch{return{target:i,files:l,indexStatus:`not-found`,indexPath:u,backupDir:c}}let f=Dt(d,i);return f.migrated==null?{target:i,files:l,indexStatus:`skipped`,indexPath:u,indexReason:f.reason,backupDir:c}:(n||await I(u,f.migrated,`utf-8`),{target:i,files:l,indexStatus:`migrated`,indexPath:u,backupDir:c})}async function Mt(e,t){let n=await Ot(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 F(e,`utf-8`);i.test(t)&&r.push(e)}return r}const Nt={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 Pt(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=Nt[a];if(!o){let e=[...Object.keys(Nt),`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 Ft(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?ue(u):u,p=A(i,d),h=[],v=async(e,n)=>{let r=A(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`,_e({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`,x({pascal:u,kebab:l})),await v(`dtos/create-${l}.dto.ts`,It(u,r)),await v(`dtos/update-${l}.dto.ts`,Lt(u,r)),await v(`dtos/${l}-response.dto.ts`,Rt(u,r)),await v(`${l}.repository.ts`,_({pascal:u,kebab:l,repoType:a,dtoPrefix:`./dtos`,tokenScope:o})),await ie(i,u,d,l,s),h}function It(e,t){return`import { z } from 'zod'
|
|
263
275
|
|
|
264
276
|
export const create${e}Schema = z.object({
|
|
265
277
|
${t.map(e=>{let t=e.zodType;return` ${e.name}: ${t}${e.optional?`.optional()`:``},`}).join(`
|
|
@@ -267,7 +279,7 @@ ${t.map(e=>{let t=e.zodType;return` ${e.name}: ${t}${e.optional?`.optional()`:`
|
|
|
267
279
|
})
|
|
268
280
|
|
|
269
281
|
export type Create${e}DTO = z.infer<typeof create${e}Schema>
|
|
270
|
-
`}function
|
|
282
|
+
`}function Lt(e,t){return`import { z } from 'zod'
|
|
271
283
|
|
|
272
284
|
export const update${e}Schema = z.object({
|
|
273
285
|
${t.map(e=>` ${e.name}: ${e.zodType}.optional(),`).join(`
|
|
@@ -275,14 +287,14 @@ ${t.map(e=>` ${e.name}: ${e.zodType}.optional(),`).join(`
|
|
|
275
287
|
})
|
|
276
288
|
|
|
277
289
|
export type Update${e}DTO = z.infer<typeof update${e}Schema>
|
|
278
|
-
`}function
|
|
290
|
+
`}function Rt(e,t){return`export interface ${e}ResponseDTO {
|
|
279
291
|
id: string
|
|
280
292
|
${t.map(e=>` ${e.name}${e.optional?`?`:``}: ${e.tsType}`).join(`
|
|
281
293
|
`)}
|
|
282
294
|
createdAt: string
|
|
283
295
|
updatedAt: string
|
|
284
296
|
}
|
|
285
|
-
`}async function
|
|
297
|
+
`}async function zt(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=j(e.outDir);else if(r){let e=y(r),t=a?m(e):e;l=j(A(i??`src/modules`,t,`__tests__`))}else l=j(`src/__tests__`);let u=A(l,`${o}.test.ts`);return await t(u,`import { describe, it, expect, beforeEach } from 'vitest'
|
|
286
298
|
import { Container } from '@forinda/kickjs'
|
|
287
299
|
|
|
288
300
|
describe('${s}', () => {
|
|
@@ -305,24 +317,24 @@ describe('${s}', () => {
|
|
|
305
317
|
expect(true).toBe(true)
|
|
306
318
|
})
|
|
307
319
|
})
|
|
308
|
-
`),c.push(u),c}const
|
|
309
|
-
(dry run — no files were written)`),console.log()}async function
|
|
310
|
-
Add your own in kick.config.ts: https://kickjs.app/guide/plugin-generators.html`]]),
|
|
320
|
+
`),c.push(u),c}const Bt=[`agents`,`claude`,`skills`,`gemini`,`copilot`,`both`,`all`];function V(e){return e.parent?.opts()?.dryRun??!1}function H(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 Vt(e){if(!e)try{let e=await C(process.cwd());await D({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 Ht=[{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`}],Ut=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`]]),Wt=new Set([...Ht.map(e=>e.name.split(` `)[0]),...Ut.keys()]);async function Gt(){console.log(`
|
|
311
323
|
Built-in generators:
|
|
312
|
-
`);let e=Math.max(...
|
|
324
|
+
`);let e=Math.max(...Ht.map(e=>e.name.length));for(let t of Ht)console.log(` kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await C(process.cwd()),n=Ne(t?.plugins??[],t?.commands??[]),r=await le(process.cwd(),n.generators);if(r.generators.length>0){console.log(`
|
|
313
325
|
Plugin generators:
|
|
314
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(`
|
|
315
327
|
Failed to load:
|
|
316
|
-
`);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}async function
|
|
317
|
-
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=V(r);e(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;H(await
|
|
328
|
+
`);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}async function Kt(e,t,n){let r=await C(process.cwd()),i=w(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??h(i.repo);t.repo&&Ae(t.repo);let s=t.pattern??r?.pattern??`rest`,c=t.pluralize===!1?!1:i.pluralize??!0,l=ke(r,process.cwd()),u=Ee(T()),d=De(T()),f=T(),m=Oe(f,`@forinda/kickjs-testing`,`any`)&&Oe(f,`supertest`,`any`),g=i.style??`define`;if(!n&&g===`define`){let e=await Mt(j(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:j(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)}H(_,n),await Vt(n)}function qt(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 Gt();return}if(!t||t.length===0){r.help();return}let o=V(a);e(o);let[s,c,...l]=t;if(s){let e=await C(process.cwd()),t=Ne(e?.plugins??[],e?.commands??[]),r=await re({generatorName:s,itemName:c??``,args:l,flags:i,cwd:process.cwd(),projectRoot:n?.projectRoot},t.generators);if(r){H(r.files,o);return}if(s!==`module`&&Wt.has(s)){let e=Ut.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 Kt(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=V(r);e(i),await Kt(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=V(r);e(i),H(await ye({name:t,outDir:j(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=V(r);e(i),H(await vt({name:t,outDir:j(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=V(r);e(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;H(await ne({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.)
|
|
318
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=V(r);e(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;H(await se({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)
|
|
319
331
|
--type http (default, RequestContext) | bare (ExecutionContext)
|
|
320
332
|
--params "source:string,region:number" → emits the withParams<T>() form
|
|
321
|
-
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=V(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 C(process.cwd()),s=w(o),c=s.dir??`src/modules`;H(await
|
|
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=V(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 C(process.cwd()),s=w(o),c=s.dir??`src/modules`;H(await bt({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
|
|
322
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=V(r);e(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;H(await ce({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
|
|
323
|
-
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=V(r);e(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;H(await fe({name:t,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),i),await
|
|
324
|
-
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=V(r);e(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;H(await pe({name:t,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),i)}),r.command(`test <name>`).description(`Generate a Vitest test scaffold
|
|
325
|
-
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=V(r);e(i);let a=w(await C(process.cwd())),o=a.dir??`src/modules`;H(await
|
|
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=V(r);e(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;H(await fe({name:t,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),i),await Vt(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=V(r);e(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;H(await pe({name:t,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0,schemaLib:De(T())}),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=V(r);e(i);let a=w(await C(process.cwd())),o=a.dir??`src/modules`;H(await zt({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
|
|
326
338
|
Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
|
|
327
339
|
Types: string, text, number, int, float, boolean, date, email, url, uuid, json, enum:a,b,c
|
|
328
340
|
Optional: append :optional (shell-safe): description:text:optional
|
|
@@ -331,31 +343,31 @@ describe('${s}', () => {
|
|
|
331
343
|
Usage: kick g scaffold <name> <field:type> [field:type...]
|
|
332
344
|
Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
|
|
333
345
|
Optional: append :optional (shell-safe, no quoting needed)
|
|
334
|
-
`),process.exit(1));let o=await C(process.cwd()),s=w(o),c=r.modulesDir??s.dir??`src/modules`,l=
|
|
335
|
-
`,u=``;if(
|
|
346
|
+
`),process.exit(1));let o=await C(process.cwd()),s=w(o),c=r.modulesDir??s.dir??`src/modules`,l=Pt(n),u=ke(o,process.cwd()),d=Ee(T()),f=await Ft({name:t,fields:l,modulesDir:j(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)`:``}`);H(f,a),await Vt(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=V(n);e(r),H(await xt({outDir:j(`.`),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=V(n);e(r);let i=t.only??`all`;if(!Bt.includes(i)){console.error(` Invalid --only value: ${i}. Expected: ${Bt.join(` | `)}`),process.exitCode=1;return}H(await Me({outDir:j(`.`),only:i,name:t.name,pm:t.pm,template:t.template,force:t.force}),r)});for(let e of n?.generators??[])Jt(r,e,n?.projectRoot)}function Jt(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=V(s);e(c);let l=await re({generatorName:a.name,itemName:t??``,args:i??[],flags:o,cwd:process.cwd(),projectRoot:r},[n]);l&&H(l.files,c)})}const Yt=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: `;async function Xt(e){let t=O.resolve(e.cwd,`.kickjs/types`);e.check||await P(t,{recursive:!0});let n=new Map,r=e.scan??ze,i=O.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(L(e).href)},async writeFile(t,n){let r=O.resolve(e.cwd,t);await P(O.dirname(r),{recursive:!0}),await I(r,n,`utf8`)},getScanResult:e=>{let t=Zt(e),o=n.get(t);if(!o){let s={cacheDir:i,...e};o=a?Pe(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=O.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=`${Yt}${n.id} */\n\n`+a+`
|
|
347
|
+
`,u=``;if(M(i)&&(u=await F(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 I(i,l,`utf8`),s.push({id:n.id,status:`written`,outFile:i})}if(c.length>0)throw new he(c);return s}function Zt(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 Qt(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 U(e){let{enabled:t,skipped:n,unknown:r}=Qt(Ne([...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 Xt({cwd:e.cwd,config:e.config??{},plugins:t,watch:e.watch,check:e.check,changedFiles:e.changedFiles});if(!e.silent&&oe())for(let e of n)console.log(` ${e.id}: ${e.status}`);return n}catch(t){if(t instanceof he||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 $t(e){let t=A(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=A(t,i);if(M(r))return{cmd:r,args:[`--noEmit`],shell:n,kind:e}}}return null}function en(e){let t=e.spawnFn??lt,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 tn(e,t=12){let n=e.trim().split(/\r?\n/);return n.length<=t?n.join(`
|
|
336
348
|
`):`${n.slice(0,t).join(`
|
|
337
|
-
`)}\n… ${n.length-t} more line(s)`}function
|
|
349
|
+
`)}\n… ${n.length-t} more line(s)`}function nn(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function rn(e,t=`127.0.0.1`){let n=await import(`node:inspector`);n.open(e,t,!1);let r=n.url();if(!r)throw Error(`inspector.open() reported no URL`);return r}async function an(e,t,n={}){t&&(process.env.PORT=t);let r=nn(n.polling),i=process.cwd(),a=await C(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await D({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=j(i,a?.typegen?.outDir??`.kickjs/types`);try{await Ve(c,await U({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(L(l(j(`package.json`)).resolve(`vite`)).href);globalThis[ae]=`kick-dev`;let d=await u({configFile:j(`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=$t(i);e?p=en({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(tn(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=de({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(`
|
|
338
350
|
KickJS dev server running (Vite + @forinda/kickjs-vite)
|
|
339
|
-
`),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 on(e){let t=await C(e);try{await D({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 Ve(j(e,t?.typegen?.outDir??`.kickjs/types`),await U({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 sn(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 an(e.entry,e.port,{polling:e.polling,typecheck:e.typecheck})}catch(e){e.code===`ERR_MODULE_NOT_FOUND`&&e.message?.includes(`vite`)?console.error(`
|
|
340
352
|
Error: vite is not installed.
|
|
341
353
|
Run: pnpm add -D vite unplugin-swc
|
|
342
354
|
`):console.error(`
|
|
343
355
|
Dev server failed:`,e.message??e),process.exit(1)}}),e.command(`build`).description(`Build for production via Vite`).action(async()=>{console.log(`
|
|
344
356
|
Building for production...
|
|
345
|
-
`);let{createRequire:e}=await import(`node:module`),{build:t}=await import(L(e(
|
|
346
|
-
Copying directories to dist...`);for(let e of r){let t=typeof e==`string`?e:e.src,n=typeof e==`string`?
|
|
347
|
-
Building asset map...`);try{await
|
|
357
|
+
`);let{createRequire:e}=await import(`node:module`),{build:t}=await import(L(e(j(`package.json`)).resolve(`vite`)).href);await t({configFile:j(`vite.config.ts`)});let n=await C(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`?A(`dist`,e):e.dest??A(`dist`,t),r=j(t),i=j(n);if(!M(r)){console.log(` ⚠ Skipped ${t} (not found)`);continue}et(i,{recursive:!0}),$e(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 je(n,{cwd:process.cwd()})}catch(e){console.error(` ✗ asset build failed: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}console.log(`
|
|
348
360
|
Build complete.
|
|
349
361
|
`)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await C(process.cwd());if(!e?.assetMap||Object.keys(e.assetMap).length===0){console.log(` No assetMap entries — nothing to build.`);return}console.log(`
|
|
350
|
-
Building asset map...`);try{await
|
|
362
|
+
Building asset map...`);try{await je(e,{cwd:process.cwd()}),console.log(`
|
|
351
363
|
Asset build complete.
|
|
352
|
-
`)}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)),Te(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=
|
|
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)),Te(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=j(process.cwd(),e.cwd??`.`);e.typegen!==!1&&await on(t);let n=$t(t);if(!n){console.error(`
|
|
353
365
|
No type-checker found. Install one in this project:
|
|
354
366
|
pnpm add -D typescript (tsc)
|
|
355
367
|
pnpm add -D @typescript/native-preview (tsgo, faster)
|
|
356
|
-
`),process.exit(1);return}let r=
|
|
357
|
-
Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function
|
|
358
|
-
`))})}const{bold:W,dim:G,green:
|
|
368
|
+
`),process.exit(1);return}let r=ut(n.cmd,n.args,{stdio:`inherit`,shell:n.shell,cwd:t});process.exit(r.status??1)}),e.command(`dev:debug`).description(`Start dev server with Node.js inspector attached`).option(`-e, --entry <file>`,`Entry file`,`src/index.ts`).option(`-p, --port <port>`,`Port number`).option(`--inspect-port <port>`,`Inspector port`,`9229`).option(`--inspect-host <host>`,`Inspector bind address (use 0.0.0.0 to reach it from outside a container)`,`127.0.0.1`).action(async e=>{let t=Number(e.inspectPort??`9229`),n=e.inspectHost??`127.0.0.1`;[`127.0.0.1`,`localhost`,`::1`].includes(n)||console.warn(` WARNING: the debugger is bound to ${n}, not loopback. Anyone who can\n reach port ${t} can run code in this process. Use it on a trusted\n network only, and prefer publishing the port from your container instead.`);let r;try{r=await rn(t,n)}catch(e){console.error(`\n Could not open the inspector on ${t}: ${e.message??e}\n Another process may already hold it — try --inspect-port <port>.`),process.exit(1);return}console.log(` Debugger: ${r}`);try{await an(e.entry,e.port)}catch(e){console.error(`
|
|
369
|
+
Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function cn(){try{let e=k(dt(import.meta.url));return JSON.parse(N(A(e,`..`,`package.json`),`utf-8`)).version??`unknown`}catch{return`unknown`}}const ln=new Set(Object.values(Ce).filter(e=>e.deprecated).map(e=>e.pkg));function un(e){let t=A(e,`package.json`);if(!M(t))return[];let n;try{n=JSON.parse(N(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=A(e,`node_modules`,...t.split(`/`),`package.json`);if(M(i))try{n=JSON.parse(N(i,`utf-8`)).version??null}catch{}return{name:t,installed:n,declared:r[t]??null,deprecated:ln.has(t)}})}function dn(e){let t=e;for(;;){if(M(A(t,`package.json`)))return t;let e=k(t);if(e===t)return null;t=e}}function fn(e){e.command(`info`).description(`Print system and framework info`).action(()=>{let e=[``,` KickJS CLI v${cn()}`,``,` System:`,` OS: ${pt()} ${mt()} (${ft()})`,` Node: ${process.version}`],t=dn(process.cwd()),n=t?un(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:W,dim:G,green:pn,red:K,yellow:mn,blue:hn}=p;function gn(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 _n(e){let t=await fetch(e,{signal:AbortSignal.timeout(5e3)});if(!t.ok)throw Error(`${t.status} ${t.statusText}`);return t.json()}async function q(e,t){try{return await _n(`${e}${t}`)}catch{return null}}async function vn(e){let[t,n,r,i,a]=await Promise.all([q(e,`/health`),q(e,`/metrics`),q(e,`/routes`),q(e,`/container`),q(e,`/ws`)]);return{health:t,metrics:n,routes:r,container:i,ws:a}}function yn(e,t){let{health:n,metrics:r,routes:i,container:a,ws:o}=t,c=G(`─`.repeat(60));if(console.log(),console.log(W(` KickJS Inspector`)+G(` → ${e}`)),console.log(c),n){let e=n.status===`healthy`?pn(`● healthy`):K(`● `+n.status);console.log(` ${W(`Health:`)} ${e}`)}else console.log(` ${W(`Health:`)} ${K(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?K:r.errorRate>0?mn:pn;console.log(` ${W(`Uptime:`)} ${gn(r.uptimeSeconds)}`),console.log(` ${W(`Requests:`)} ${r.requests}`),console.log(` ${W(`Errors:`)} ${r.serverErrors} server, ${r.clientErrors??0} client ${G(`(`)}${t(e+`%`)}${G(`)`)}`)}if(a&&console.log(` ${W(`DI:`)} ${a.count} bindings`),o&&o.enabled&&console.log(` ${W(`WS:`)} ${o.connections??0} connections, ${o.namespaces??0} namespaces`),i?.routes?.length){console.log(),console.log(W(` Routes`)),console.log(c),console.log(` ${G(`METHOD`)} ${G(`PATH`.padEnd(36))} ${G(`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} ${hn(e.controller)}.${G(e.handler)}`)}}console.log(c),console.log()}function bn(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 vn(r);t.json?console.log(JSON.stringify(e,null,2)):yn(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(K(` ✖ Could not connect to ${n}`)),console.error(G(` ${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 xn(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=xn(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
|
|
359
371
|
src/config/index.ts, and src/index.ts imports it before bootstrap().
|
|
360
372
|
Tests never load src/index.ts — \`createTestApp\` builds the app
|
|
361
373
|
directly — so that import does not run and ConfigService falls back to
|
|
@@ -389,7 +401,7 @@ describe('UserController', () => {
|
|
|
389
401
|
beforeEach(() => Container.reset())
|
|
390
402
|
|
|
391
403
|
it('does the thing', async () => { /* ... */ })
|
|
392
|
-
})`,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`)||xn(e,[`Module`,`is not a function`])||xn(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
|
|
393
405
|
pattern instead: a class implements AppModule and exposes routes() that
|
|
394
406
|
returns the controller wiring. This was a deliberate choice — modules
|
|
395
407
|
become explicit values rather than metadata, which makes them easier to
|
|
@@ -475,24 +487,24 @@ beforeAll(() => {
|
|
|
475
487
|
vi.stubEnv('JWT_SECRET', 'x'.repeat(32))
|
|
476
488
|
resetEnvCache()
|
|
477
489
|
loadEnv(envSchema)
|
|
478
|
-
})`,docs:`https://kickjs.app/guide/testing.html#environment-isolation`}}}}];function
|
|
490
|
+
})`,docs:`https://kickjs.app/guide/testing.html#environment-isolation`}}}}];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.
|
|
479
491
|
export OPENAI_API_KEY="sk-..."
|
|
480
492
|
|
|
481
493
|
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:
|
|
482
494
|
kick add ai
|
|
483
495
|
|
|
484
496
|
Or manually:
|
|
485
|
-
pnpm add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=
|
|
486
|
-
`)}function
|
|
497
|
+
pnpm add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=Tn(e.cwd),s=`Error or stack trace:\n\n${e.input.trim()}`;try{let e=En((await a.chat({messages:[{role:`system`,content:o},{role:`user`,content:s}]})).content);return e?{kind:`ok`,diagnosis:e}:{kind:`error`,message:`The LLM responded but the payload was not valid JSON in the expected shape. Try again, or file an issue with the error text.`}}catch(e){return{kind:`error`,message:`LLM request failed: ${e instanceof Error?e.message:String(e)}`}}}function Tn(e){return[`You are a diagnostic assistant for KickJS, a decorator-driven Node.js`,`framework built on Express 5 and TypeScript. KickJS projects use:`,` - @Controller, @Get, @Post, @Autowired, @Service, @Value decorators`,` - An AppModule interface with a routes() method (NOT a @Module decorator)`,` - Zod schemas as both runtime validators and OpenAPI sources`,` - Ctx<KickRoutes.ControllerName['method']> for typed request context`,` - src/config/index.ts with defineEnv/loadEnv for env schema`,' - A side-effect `import "./config"` in src/index.ts to register the schema',` - Container.reset() in beforeEach for DI test isolation`,``,`When the user gives you an error message or stack trace, produce a`,`structured diagnosis that helps them fix the bug. You MUST respond`,`with a single JSON object (no surrounding prose, no markdown fences)`,`matching this shape:`,``,`{`,` "id": "<kebab-case-identifier>",`,` "title": "<one-line problem summary>",`,` "explanation": "<multi-line explanation of what is wrong>",`,` "fix": "<multi-line instructions for fixing the problem>",`,` "codeBefore": "<optional: broken code snippet>",`,` "codeAfter": "<optional: corrected code snippet>",`,` "docs": "<optional: KickJS doc URL that discusses this topic>"`,`}`,``,`The KickJS docs live at https://kickjs.app/ — prefer`,`that domain for any doc links you suggest.`,e?`The project is located at ${e}.`:``].filter(e=>e.length>0).join(`
|
|
498
|
+
`)}function En(e){let t=[e,Dn(e),On(e)].filter(e=>e!==null);for(let e of t)try{let t=JSON.parse(e);if(kn(t))return t}catch{continue}return null}function Dn(e){let t=e.match(/```(?:json)?\s*\n([\s\S]*?)```/);return t?t[1]?.trim()??null:null}function On(e){let t=e.indexOf(`{`);if(t===-1)return null;let n=0,r=!1,i=!1;for(let a=t;a<e.length;a++){let o=e[a];if(i){i=!1;continue}if(o===`\\`&&r){i=!0;continue}if(o===`"`){r=!r;continue}if(!r&&(o===`{`&&n++,o===`}`&&(n--,n===0)))return e.slice(t,a+1)}return null}function kn(e){if(typeof e!=`object`||!e)return!1;let t=e;return typeof t.id==`string`&&typeof t.title==`string`&&typeof t.explanation==`string`&&typeof t.fix==`string`}function An(e){e.command(`explain [message]`).description(`Explain a KickJS error and suggest a fix`).option(`-m, --message <text>`,`Error message to explain (alternative to positional arg)`).option(`--ai`,`Fall back to LLM if no known-issue matches (requires @forinda/kickjs-ai)`).option(`--model <name>`,`Model name for the --ai fallback`,`gpt-4o-mini`).option(`--json`,`Output the diagnosis as JSON for tooling integration`).action(async(e,t)=>{let n=await Nn(e,t.message);(!n||n.trim().length===0)&&(process.stderr.write(`Error: no input provided.
|
|
487
499
|
|
|
488
500
|
Pass a message as a positional arg, --message flag, or pipe via stdin:
|
|
489
501
|
kick explain "config.get returned undefined"
|
|
490
502
|
pnpm test 2>&1 | kick explain
|
|
491
|
-
`),process.exit(1));let r=
|
|
492
|
-
`);return}if(i){
|
|
493
|
-
`),process.exit(2)),
|
|
494
|
-
`),process.exit(a.kind===`ok`?0:2)),
|
|
495
|
-
`)}function
|
|
503
|
+
`),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
|
+
`);return}if(i){In(n,i.diagnosis,i.confidence);return}t.ai||(t.json&&(process.stdout.write(JSON.stringify({matched:!1},null,2)+`
|
|
505
|
+
`),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=>M(j(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
|
+
`)}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.
|
|
496
508
|
When @forinda/kickjs-ai ships its provider implementations,
|
|
497
509
|
this command will call the configured LLM with the error +
|
|
498
510
|
project context and return a structured fix.
|
|
@@ -511,10 +523,10 @@ Pass a message as a positional arg, --message flag, or pipe via stdin:
|
|
|
511
523
|
|
|
512
524
|
`)}function Y(e,t){return e.split(`
|
|
513
525
|
`).map(e=>`${t}${e}`).join(`
|
|
514
|
-
`)}function X(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function
|
|
515
|
-
`,`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
|
|
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=j(e.entry);M(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=lt(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)??Xe(t),r=e.name??n,i=e.global?j(process.env.HOME??`.`,`.mcp.json`):j(t,e.out),a={command:`kick`,args:[`mcp`],cwd:t},o={mcpServers:{}};if(M(i))try{let e=N(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,rt(i,JSON.stringify(o,null,2)+`
|
|
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=j(e,`package.json`);if(!M(t))return null;try{let e=N(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=j(t,e.entry);M(n)||(console.error(`\n Error: ${e.entry} not found.\n`),process.exit(1));let r=Gn(t,`tsx`);r||(console.error(`
|
|
516
528
|
Error: tsx not found. Install it: pnpm add -D tsx
|
|
517
|
-
`),process.exit(1));let i=
|
|
529
|
+
`),process.exit(1));let i=Wn(n,e.entry),a=A(t,`.kick-tinker.mjs`),{writeFileSync:o,unlinkSync:s}=await import(`node:fs`);o(a,i,`utf-8`);try{let e=ct(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`
|
|
518
530
|
import 'reflect-metadata'
|
|
519
531
|
|
|
520
532
|
// Prevent bootstrap() from starting the HTTP server
|
|
@@ -568,36 +580,36 @@ server.on('exit', () => {
|
|
|
568
580
|
console.log('\\n Goodbye!\\n')
|
|
569
581
|
process.exit(0)
|
|
570
582
|
})
|
|
571
|
-
`}function
|
|
583
|
+
`}function Gn(e,t){let n=e;for(;;){let e=A(n,`node_modules`,`.bin`,t);if(M(e))return e;let r=j(n,`..`);if(r===n)break;n=r}return null}function Kn(e,t){let n=RegExp(`^\\s*${S(t)}Module\\b`),r=!1,i=0,a=e;for(;;){let e=a.indexOf(`.mount(`,i);if(e===-1)break;let t=e+7,o=1,s=t;for(;s<a.length&&o>0;){let e=a.slice(s,s+2);if(e===`//`||e===`/*`){if(e===`//`)for(s+=2;s<a.length&&a[s]!==`
|
|
572
584
|
`;)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]===`
|
|
573
|
-
`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t;continue}i=s+1}return{content:a,changed:r}}function
|
|
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=ve(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*${S(t)}Module\\b(?:\\s*\\(\\s*\\))?\\s*,?`,`g`),e=>{let t=e.trimStart().startsWith(`,`),n=e.trimEnd().endsWith(`,`);return t&&n?`,`:``}),a=a.replace(/,(\s*])/,`$1`),e.slice(0,r)+a+e.slice(i)}async function 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=A(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(`
|
|
574
586
|
Cancelled.
|
|
575
|
-
`);return}await
|
|
587
|
+
`);return}await ot(l,{recursive:!0,force:!0}),console.log(` Deleted: ${l}`);let u=A(r,`index.ts`);if(await n(u)){let e=await F(u,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${S(s)}Module\\s*\\}\\s*from\\s*['"][^'"]*${S(c)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=qn(e,s),e=e.replace(/\n{3,}/g,`
|
|
576
588
|
|
|
577
|
-
`),e!==t&&(await I(u,e,`utf-8`),console.log(` Unregistered: ${s}Module from ${u}`))}console.log(`\n Module '${c}' removed.\n`)}function
|
|
589
|
+
`),e!==t&&(await I(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=w(await C(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:j(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=T(process.cwd()),n=await C(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-CD9WjquV.mjs`).then(e=>e.t),{builtinCliPlugins:t}=await import(`./builtins-HdwKAx0s.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(`
|
|
578
590
|
Registered typegen plugins:
|
|
579
591
|
`);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(`
|
|
580
592
|
Disable one in kick.config.ts:
|
|
581
593
|
`),console.log(` typegen: { disable: ['`+(r.typegens[0]?.id??`kick/x`)+`'] }
|
|
582
|
-
`);return}let r=
|
|
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 Ke(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 D(a);let r=await U({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 Ve(j(t,e.out??n?.typegen?.outDir??`.kickjs/types`),r,e.silent??!1)}}catch(e){e instanceof qe?console.error(`
|
|
583
595
|
`+e.message+`
|
|
584
596
|
`):e instanceof he?console.error(`
|
|
585
597
|
`+e.message+`
|
|
586
|
-
`):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}function
|
|
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(!M(e))return t;let n=tt(e,{withFileTypes:!0});for(let r of n){let n=A(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 N(e,`utf-8`)}catch{return``}}const tr=new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function nr(e,t){let n=er(A(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(A(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(`
|
|
587
599
|
Usage: kick check --deploy
|
|
588
600
|
|
|
589
601
|
Available checks:
|
|
590
602
|
--deploy Audit for production readiness (security, config, best practices)
|
|
591
|
-
`);return}let t=process.cwd();c(`KickJS Deploy Check`);let n=d();n.start(`Scanning project...`);let i=
|
|
603
|
+
`);return}let t=process.cwd();c(`KickJS Deploy Check`);let n=d();n.start(`Scanning project...`);let i=lr(t);n.stop(`Scan complete`);let o={CRITICAL:0,WARNING:1,INFO:2};i.sort((e,t)=>o[e.severity]-o[t.severity]);for(let e of i)u.message(`${a(e.severity)} ${e.message}`);let s=i.filter(e=>e.severity===`CRITICAL`).length,l=i.filter(e=>e.severity===`WARNING`).length,f=i.filter(e=>e.severity===`INFO`).length,m=l===1?`warning`:`warnings`,h=[s>0?p.red(`${s} critical`):`${s} critical`,l>0?p.yellow(`${l} ${m}`):`${l} ${m}`,`${f} info`].join(`, `);s>0?(r(p.red(`${h} — fix critical issues before deploying`)),process.exit(1)):r(p.green(`${h} — looking good!`))})}function dr(e){return e.optsWithGlobals().dryRun??!1}function fr(t){t.command(`codemod`).description(`Codebase migration commands (AST-style rewrites — distinct from db migrate)`).command(`modules`).description(`Rewrite module declarations between class form and the defineModule factory.
|
|
592
604
|
Direction defaults to \`modules.style\` from kick.config (or "define").
|
|
593
605
|
--target define|class Override the migration direction.
|
|
594
606
|
--apply Apply the changes (default: dry-run preview).
|
|
595
|
-
--experimental Acknowledge that AST migration is experimental.`).option(`--modules-dir <dir>`,`Modules directory (default: src/modules from kick.config)`).option(`--apply`,`Apply the migration to disk (default: dry-run)`).option(`--experimental`,`Acknowledge that this command is experimental`).option(`--target <style>`,`Migration direction — 'define' or 'class'`).option(`--no-backup`,`Skip the .kickjs/codemod-backups/ snapshot (default: backup on)`).action(async(t,n)=>{let r=
|
|
607
|
+
--experimental Acknowledge that AST migration is experimental.`).option(`--modules-dir <dir>`,`Modules directory (default: src/modules from kick.config)`).option(`--apply`,`Apply the migration to disk (default: dry-run)`).option(`--experimental`,`Acknowledge that this command is experimental`).option(`--target <style>`,`Migration direction — 'define' or 'class'`).option(`--no-backup`,`Skip the .kickjs/codemod-backups/ snapshot (default: backup on)`).action(async(t,n)=>{let r=dr(n)||!t.apply;e(r),t.experimental||(console.error(`
|
|
596
608
|
`+p.red(`Error:`)+` kick codemod modules is experimental — pass --experimental to acknowledge.
|
|
597
609
|
The regex-based rewrite handles the shapes our templates produce.
|
|
598
610
|
Hand-rolled modules with non-standard structures may be skipped.
|
|
599
611
|
Always commit before running with --apply.
|
|
600
|
-
`),process.exit(1));let i=w(await C(process.cwd())),a=
|
|
612
|
+
`),process.exit(1));let i=w(await C(process.cwd())),a=j(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 jt(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(!M(O.resolve(e.cwd,`kick.config.ts`)))return null;let t=await C(e.cwd);if(!t?.assetMap)return null;let n=Fe(t.assetMap,e.cwd);return n.count===0?null:We(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}
|
|
601
613
|
// (no routes discovered yet — annotate a controller method with
|
|
602
614
|
// @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
|
|
603
615
|
declare global {
|
|
@@ -614,14 +626,14 @@ declare global {
|
|
|
614
626
|
|
|
615
627
|
/** Empty until the first route exists — see kick typegen. */
|
|
616
628
|
export const kickRpc = {} as const
|
|
617
|
-
`;let i=new Map;for(let t of e){let e=i.get(t.controller)??[];e.push(t),i.set(t.controller,e)}let a=new Map,o=new Map,s=e=>{let t=`${e.filePath}::${e.controller}`,n=o.get(t);return n||(n=`_C${o.size}`,o.set(t,n)),n},c=(e,i,o)=>{let s=
|
|
629
|
+
`;let i=new Map;for(let t of e){let e=i.get(t.controller)??[];e.push(t),i.set(t.controller,e)}let a=new Map,o=new Map,s=e=>{let t=`${e.filePath}::${e.controller}`,n=o.get(t);return n||(n=`_C${o.size}`,o.set(t,n)),n},c=(e,i,o)=>{let s=yr(e,i.filePath,t,n,a);if(!s){if(e&&n!==!1){let t=o===`params`?`URL-pattern params`:o===`query`&&i.queryFilterable!==null?`the @ApiQueryParams-derived query shape`:`'unknown'`;r.onWarn?.(`route ${i.controller}.${i.method} (${i.httpMethod} ${i.path}): ${o} schema '${e.identifier}' could not be statically resolved — falling back to ${t}. Export the schema from the controller file or import it with a static specifier.`)}return null}return n===`kickjs-schema`?`import('@forinda/kickjs-schema').InferSchemaOutput<typeof ${s}>`:`import('zod').infer<typeof ${s}>`},l=[];for(let[e,t]of i){let n=[` interface ${e} {`];for(let e of t){let t=e.pathParams.length>0?`{ ${e.pathParams.map(e=>`${e}: string`).join(`; `)} }`:`{}`,r=c(e.bodySchema,e,`body`),i=c(e.querySchema,e,`query`),a=c(e.paramsSchema,e,`params`)??t,o=r??`unknown`,l=i??_r(e),u=c(e.responseSchema??null,e,`response`),d=s(e),f=u??`import('@forinda/kickjs').InferHandlerResponse<${d}['${e.method}']>`,p=vr(e);n.push(` /**`,` * ${e.httpMethod} ${e.path}`,...p.map(e=>` * ${e}`),` */`,` ${e.method}: {`,` params: ${a}`,` body: ${o}`,` query: ${l}`,` response: ${f}`,` contextKeys: ${gr(e)}`,` }`)}n.push(` }`),l.push(n.join(`
|
|
618
630
|
`))}let u=[],d=new Set,f=new Set;i.has(`Api`)&&r.onWarn?.(`controller class 'Api' collides with the reserved KickRoutes.Api client map — its interface declaration-merges into the flat route map. Rename the controller.`);for(let[e,t]of i)for(let n of t){let t=`${n.httpMethod} ${n.mountedPath??n.path}`;if(d.has(t)){r.onWarn?.(`duplicate route '${t}' (${e}.${n.method}) — two handlers claim the same verb+path at runtime. KickRoutes.Api keeps the first (scan order, which may not match runtime dispatch); resolve the conflict in the modules.`);continue}d.add(t),f.add(`${e}.${n.method}`),u.push(` '${t}': ${e}['${n.method}']`)}let p=[` interface Api {`,...u,` }`].join(`
|
|
619
|
-
`);l.push(p);let m=[],h=new Set;for(let[e,t]of i){let n=
|
|
631
|
+
`);l.push(p);let m=[],h=new Set;for(let[e,t]of i){let n=Sr(e);if(h.has(n)){r.onWarn?.(`RPC manifest: controller key '${n}' (from ${e}) collides with another controller — keeping the first; rename one class for distinct RPC namespaces.`);continue}h.add(n);let i=[];for(let n of t){if(!f.has(`${e}.${n.method}`))continue;let t=`${n.httpMethod} ${n.mountedPath??n.path}`;i.push(` ${n.method}: '${t}',`)}i.length>0&&m.push(` ${n}: {\n${i.join(`
|
|
620
632
|
`)}\n },`)}let g=[`/**`,` * Runtime route manifest for the tRPC-style sugar:`," * `createRpc(api, kickRpc)` from @forinda/kickjs-client.",` */`,`export const kickRpc = {`,...m,`} as const`].join(`
|
|
621
|
-
`),_=[],v=new Map;for(let t of e)v.set(`${t.filePath}::${t.controller}`,t);for(let[e,n]of o){let r=v.get(e),i=
|
|
633
|
+
`),_=[],v=new Map;for(let t of e)v.set(`${t.filePath}::${t.controller}`,t);for(let[e,n]of o){let r=v.get(e),i=xr(``,r.filePath,t),a=r.controllerIsDefaultExport?`default as ${n}`:`${r.controller} as ${n}`;_.push(`import type { ${a} } from '${i}'`)}let y=_.length>0?_.join(`
|
|
622
634
|
`)+`
|
|
623
|
-
`:``,ee=
|
|
624
|
-
`);return`${
|
|
635
|
+
`:``,ee=br(a)+y,b=l.join(`
|
|
636
|
+
`);return`${mr}${ee}
|
|
625
637
|
declare global {
|
|
626
638
|
// eslint-disable-next-line @typescript-eslint/no-namespace
|
|
627
639
|
namespace KickRoutes {
|
|
@@ -633,18 +645,18 @@ ${b}
|
|
|
633
645
|
}
|
|
634
646
|
|
|
635
647
|
${g}
|
|
636
|
-
`}function
|
|
648
|
+
`}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(`
|
|
637
649
|
`)+`
|
|
638
|
-
`}function
|
|
639
|
-
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
|
|
650
|
+
`}function xr(e,t,n){if(e===null)return`unknown`;let r=k(n);if(e===``){let e=Ze(r,t).split(Qe).join(`/`);return e=e.replace(/\.(ts|tsx|mts|cts)$/i,``),e.startsWith(`.`)||(e=`./`+e),e}if(!e.startsWith(`.`)&&!e.startsWith(`/`))return e;let i=Ze(r,j(k(t),e)).split(Qe).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=O.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return hr(t.routes,r,n,{onWarn:t=>e.log.warn(t)})}});function wr(e){return O.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.
|
|
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=Ye(A(e,`package.json`)),n=async e=>{try{return await import(L(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=`
|
|
640
652
|
`){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===`
|
|
641
653
|
`?`
|
|
642
|
-
`: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
|
|
643
|
-
`));for(let n of
|
|
644
|
-
`);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
|
|
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 ht(`sha1`).update(e).digest(`hex`)}function Fr(e){let t=ht(`sha1`);t.update(e.cliVersion),t.update(JSON.stringify(e.options??{})),t.update(e.keys.join(`
|
|
655
|
+
`));for(let n of Mr){let r=A(e.projectDir,n);if(M(r))try{t.update(N(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(N(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(A(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=A(k(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(`
|
|
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=`./`+Xe(e).replace(/\.tsx?$/,``),r=t.map((e,t)=>`type ${zr(t)} = KickRoutes.Api[${JSON.stringify(e)}]`);return[`import ${JSON.stringify(n)}`,...r].join(`
|
|
645
657
|
`)+`
|
|
646
|
-
`}function
|
|
647
|
-
`))}},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:[...
|
|
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=tt(t).filter(e=>e.endsWith(`.ts`)).map(e=>A(t,e))}catch{}return[...new Set([...n,...r])]}function Ur(e,t,n,r){let i=A(t,`tsconfig.json`),a={...e.sys,onUnRecoverableConfigFileDiagnostic:t=>{throw Error(e.flattenDiagnosticMessageText(t.messageText,`
|
|
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,k(n)),n],options:o.options,host:s})}const Wr=`/* eslint-disable */
|
|
648
660
|
// AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
|
|
649
661
|
//
|
|
650
662
|
// Self-contained: this file has no imports, so a frontend consumes it without
|
|
@@ -658,7 +670,7 @@ ${g}
|
|
|
658
670
|
//
|
|
659
671
|
// Not refreshed by \`kick dev\` — resolving these types builds a full
|
|
660
672
|
// TypeScript program over the server. Re-run \`kick typegen\`.
|
|
661
|
-
`;function
|
|
673
|
+
`;function Gr(e,t){let n=t.filter(t=>e.entries.has(t));if(n.length===0)return`${Wr}
|
|
662
674
|
// (no routes discovered yet — annotate a controller method with
|
|
663
675
|
// @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
|
|
664
676
|
interface Api {}
|
|
@@ -675,7 +687,7 @@ export type { Api }
|
|
|
675
687
|
|
|
676
688
|
`)+`
|
|
677
689
|
|
|
678
|
-
`:``,i=n.map(t=>` ${JSON.stringify(t)}: ${e.entries.get(t)}`);return`${
|
|
690
|
+
`:``,i=n.map(t=>` ${JSON.stringify(t)}: ${e.entries.get(t)}`);return`${Wr}
|
|
679
691
|
${r}interface Api {
|
|
680
692
|
${i.join(`
|
|
681
693
|
`)}
|
|
@@ -689,7 +701,7 @@ declare global {
|
|
|
689
701
|
}
|
|
690
702
|
|
|
691
703
|
export type { Api }
|
|
692
|
-
`}const
|
|
704
|
+
`}const Kr=`kick/client`,Q=`.kickjs/types/kick__client.d.ts`,qr=`.kickjs/cache/client-map.sha1`,Jr=(()=>{try{return Ye(import.meta.url)(`../../../package.json`).version??`0.0.0`}catch{return`0.0.0`}})();function Yr(e){try{if(!M(e))return null;let[t,n]=N(e,`utf-8`).trim().split(/\s+/);return t&&n?{inputs:t,output:n}:null}catch{return null}}function Xr(e){return`${Yt}${Kr} */\n\n${e}\n`}function Zr(e){try{return M(e)?N(e,`utf-8`):null}catch{return null}}async function Qr(e){let t=O.resolve(e.cwd,Q);if(!M(t))return!1;try{await ot(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:(M(O.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:O.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(O.resolve(e.cwd,qr)),s=Zr(O.resolve(e.cwd,Q));if(a&&o&&s!==null&&o.inputs===a&&o.output===Pr(s))return oe()&&e.log.info?.(` kick/client: unchanged, keeping ${Q}`),null;try{let t=Gr(await Lr({projectDir:e.cwd,routesFile:O.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=M(O.resolve(e.cwd,Q)),r=` kick/client: skipped — ${t instanceof Error?t.message:String(t)}`;return n?e.log.warn(r):oe()&&e.log.info?.(r),n&&await Qr(e),null}}});function ni(e,t,n=`zod`){if(!e)return null;let r=Ze(k(t),e.filePath).split(Qe).join(`/`);return r=r.replace(/\.(ts|tsx|mts|cts)$/i,``),r.startsWith(`.`)||(r=`./`+r),`/* eslint-disable */
|
|
693
705
|
// AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
|
|
694
706
|
// Re-run with \`kick typegen\` or rely on \`kick dev\` to refresh.
|
|
695
707
|
|
|
@@ -727,6 +739,6 @@ declare global {
|
|
|
727
739
|
}
|
|
728
740
|
|
|
729
741
|
export {}
|
|
730
|
-
`}const
|
|
731
|
-
`)}}]})];export{
|
|
732
|
-
//# sourceMappingURL=run-plugins-
|
|
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=O.resolve(e.cwd,`.kickjs/types/kick__env.ts`);return ni(n.env,i,r)}});function ii(e){return O.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function ai(e){return e.config?.typegen?.envFile}function oi(e){return O.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=O.resolve(e.cwd,`.kickjs/types/kick__registry.d.ts`),r=new Set(t.collisions.map(e=>e.className));return Ge(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 Be(`ServiceToken`,He(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 Be(`ModuleToken`,Ie((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 Re((await e.getScanResult($(e))).pluginsAndAdapters)}}),fi=()=>({id:`kick/augmentations`,inputs:[`src/**/*.ts`],async generate(e){return Je((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:Le(t.contextKeys)}}),mi=()=>({id:`kick/route-flags`,inputs:[`src/**/*.ts`],async generate(e){return Ue((await e.getScanResult($(e))).routeFlags)}}),hi={fastify:{subpath:`@forinda/kickjs/fastify`,typeName:`FastifyRuntimeTypes`},h3:{subpath:`@forinda/kickjs/h3`,typeName:`H3RuntimeTypes`}},gi=[E({name:`kick/init`,register:_t}),E({name:`kick/generate`,register:qt}),E({name:`kick/run`,register:sn}),E({name:`kick/info`,register:fn}),E({name:`kick/inspect`,register:bn}),E({name:`kick/add`,register:be}),E({name:`kick/list`,register:Se}),E({name:`kick/explain`,register:An}),E({name:`kick/mcp`,register:zn}),E({name:`kick/tinker`,register:Un}),E({name:`kick/remove`,register:Yn}),E({name:`kick/typegen`,register:Qn}),E({name:`kick/check`,register:ur}),E({name:`kick/doctor`,register:me}),E({name:`kick/codemod`,register:fr}),E({name:`kick/registry`,typegens:[ci()]}),E({name:`kick/services`,typegens:[li()]}),E({name:`kick/modules`,typegens:[ui()]}),E({name:`kick/plugins`,typegens:[di()]}),E({name:`kick/augmentations`,typegens:[fi()]}),E({name:`kick/context`,typegens:[pi()]}),E({name:`kick/route-flags`,typegens:[mi()]}),E({name:`kick/assets`,typegens:[pr()]}),E({name:`kick/routes`,typegens:[Cr()]}),E({name:`kick/client`,typegens:[ti()]}),E({name:`kick/env`,typegens:[ri()]}),E({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(`
|
|
743
|
+
`)}}]})];export{Qt as applyDisableFilter,U as runAllPluginTypegens,gi as t};
|
|
744
|
+
//# sourceMappingURL=run-plugins-BKWupYoJ.mjs.map
|