@forinda/kickjs-cli 6.0.1 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{agent-docs-hbOXsAAh.mjs → agent-docs-DB5y-kvS.mjs} +3 -3
- package/dist/{agent-docs-hbOXsAAh.mjs.map → agent-docs-DB5y-kvS.mjs.map} +1 -1
- package/dist/build-9YFC7Rd4.mjs +13 -0
- package/dist/build-9YFC7Rd4.mjs.map +1 -0
- package/dist/{builtins-Dyk9a-mv.mjs → builtins-mr3TIDa8.mjs} +2 -2
- package/dist/cli.mjs +143 -151
- package/dist/{config-DSpcRefL.mjs → config-Dc4XuP2E.mjs} +3 -3
- package/dist/config-Dc4XuP2E.mjs.map +1 -0
- package/dist/{doctor-559QZlHi.mjs → doctor-shX-k8ju.mjs} +41 -41
- package/dist/doctor-shX-k8ju.mjs.map +1 -0
- package/dist/index.d.mts +279 -1
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +2 -2
- package/dist/index.mjs.map +1 -1
- package/dist/{plugin-DK01q7wy.mjs → plugin-DVOWYRqG.mjs} +3 -3
- package/dist/{plugin-DK01q7wy.mjs.map → plugin-DVOWYRqG.mjs.map} +1 -1
- package/dist/{project-docs-CrfNQIZA.mjs → project-docs-Cq_MswOY.mjs} +2 -2
- package/dist/{project-docs-CrfNQIZA.mjs.map → project-docs-Cq_MswOY.mjs.map} +1 -1
- package/dist/{project-root-BdTe6EpE.mjs → project-root-C3u57Vec.mjs} +3 -3
- package/dist/{project-root-BdTe6EpE.mjs.map → project-root-C3u57Vec.mjs.map} +1 -1
- package/dist/{rolldown-runtime-CoN4EDcd.mjs → rolldown-runtime-BMxBusPc.mjs} +1 -1
- package/dist/{run-plugins-BAYoDnFI.mjs → run-plugins-COniKxrL.mjs} +73 -82
- package/dist/run-plugins-COniKxrL.mjs.map +1 -0
- package/dist/typegen-DPATg8Ix.mjs +114 -0
- package/dist/typegen-DPATg8Ix.mjs.map +1 -0
- package/dist/{types-BKKzf_bU.mjs → types-B2r_OeIa.mjs} +1 -1
- package/package.json +6 -6
- package/dist/config-DSpcRefL.mjs.map +0 -1
- package/dist/doctor-559QZlHi.mjs.map +0 -1
- package/dist/run-plugins-BAYoDnFI.mjs.map +0 -1
- package/dist/typegen-CwtvFZ0t.mjs +0 -114
- package/dist/typegen-CwtvFZ0t.mjs.map +0 -1
package/dist/cli.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs-cli v6.0
|
|
2
|
+
* @forinda/kickjs-cli v6.1.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,8 +8,8 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{createRequire as e}from"node:module";import{Command as t}from"commander";import{cpSync as n,existsSync as r,mkdirSync as i,readFileSync as a,readdirSync as o,rmSync as s,statSync as c,writeFileSync as l}from"node:fs";import u,{basename as d,dirname as f,extname as p,isAbsolute as m,join as h,parse as g,relative as _,resolve as v,sep as y}from"node:path";import{fileURLToPath as b,pathToFileURL as x}from"node:url";import{execFileSync as
|
|
12
|
-
`,`utf-8`)}catch{}}function
|
|
11
|
+
import{createRequire as e}from"node:module";import{Command as t}from"commander";import{cpSync as n,existsSync as r,mkdirSync as i,readFileSync as a,readdirSync as o,rmSync as s,statSync as c,writeFileSync as l}from"node:fs";import u,{basename as d,dirname as f,extname as p,isAbsolute as m,join as h,parse as g,relative as _,resolve as v,sep as y}from"node:path";import{fileURLToPath as b,pathToFileURL as x}from"node:url";import{execFileSync as ee,execSync as S,fork as te,spawn as ne,spawnSync as re}from"node:child_process";import{access as ie,copyFile as ae,mkdir as oe,readFile as C,readdir as se,rm as ce,stat as le,unlink as ue,writeFile as w}from"node:fs/promises";import{KickPluginConflictError as de,defineCliPlugin as T}from"@forinda/kickjs-cli-kit";import*as E from"@clack/prompts";import D from"picocolors";import fe from"pluralize";import{parseSync as pe}from"oxc-parser";import{glob as me,globSync as he}from"glob";import{groupAssetKeys as ge}from"@forinda/kickjs";import{arch as _e,platform as ve,release as ye}from"node:os";var be=Object.defineProperty,O=(e,t)=>{let n={};for(var r in e)be(n,r,{get:e[r],enumerable:!0});return t||be(n,Symbol.toStringTag,{value:`Module`}),n};function xe(e,t,n){S(e,{cwd:t,stdio:`inherit`,env:n?{...process.env,...n}:process.env})}function Se(e,t,n){let r=re(process.execPath,[e],{cwd:n,stdio:`inherit`,env:{...process.env,...t}});r.status!==0&&process.exit(r.status??1)}function Ce(e,t){if(!t?.commands?.length)return;let n=new Set(e.commands.map(e=>e.name()));for(let r of t.commands){if(n.has(r.name)){console.warn(` Warning: custom command '${r.name}' skipped — conflicts with a built-in command`);continue}we(e,r)}}function we(e,t){let n=e.command(t.name).description(t.description);if(t.aliases)for(let e of t.aliases)n.alias(e);n.allowUnknownOption(!0),n.argument(`[args...]`,`Additional arguments passed to the command`),n.action(e=>{let n=e.join(` `),r=Array.isArray(t.steps)?t.steps:[t.steps];for(let e of r){let r=n?`${e} ${n}`:e;console.log(` $ ${r}`);try{xe(r)}catch{console.error(` Command failed: ${t.name}`),process.exitCode=1;return}}})}var Te=O({BUILTIN_REPO_TYPES:()=>De,DEPRECATED_REPO_TYPES:()=>Oe,PACKAGE_MANAGERS:()=>Ee,defineConfig:()=>Ae,loadKickConfig:()=>A,resolveModuleConfig:()=>k,resolveTokenScope:()=>je,validateAssetMap:()=>Fe,warnIfDeprecatedRepo:()=>ke,writeAssetConfigSnapshot:()=>Pe});const Ee=[`pnpm`,`npm`,`yarn`,`bun`],De=[`inmemory`],Oe=[`prisma`,`drizzle`];function ke(e){return Oe.includes(e)?(console.warn(` Note: the '${e}' repository preset is deprecated. Generating a generic custom repository named '${e}' instead — wire it to your DB by hand. Pass any name via \`--repo <name>\` or \`modules.repo: { name: '<name>' }\`.`),!0):!1}function Ae(e){return e}function je(e,t){if(e?.tokenScope&&typeof e.tokenScope==`string`&&e.tokenScope.length>0){let t=Me(e.tokenScope);if(t.length>0)return t}try{let e=h(t,`package.json`);if(r(e)){let t=JSON.parse(a(e,`utf-8`));if(typeof t.name==`string`&&t.name.length>0){let e=t.name.match(/^@([^/]+)\//),n=Me(e?e[1]:t.name);if(n.length>0)return n}}}catch{}return`app`}function Me(e){return e.toLowerCase().replace(/[^a-z0-9-]/g,`-`).replace(/^-+|-+$/g,``).replace(/-{2,}/g,`-`)}function k(e){if(!e)return{};let t={dir:e.modules?.dir,repo:e.modules?.repo,schemaDir:e.modules?.schemaDir,pluralize:e.modules?.pluralize,prismaClientPath:e.modules?.prismaClientPath,style:e.modules?.style};return t.style!==void 0&&t.style!==`define`&&t.style!==`class`&&(console.warn(` Warning: modules.style '${t.style}' is not a valid value (expected 'define' or 'class'). Falling back to 'define'.`),t.style=`define`),t.repo&&typeof t.repo==`string`&&!De.includes(t.repo)&&(ke(t.repo)||console.warn(` Warning: modules.repo '${t.repo}' is not a built-in type (${De.join(`, `)}). It will generate a stub repository. Use { name: '${t.repo}' } to silence this warning.`)),t}const Ne=[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`,`kick.config.json`];async function A(e){let{findProjectRoot:t}=await Promise.resolve().then(()=>Jt),n=t(e);for(let e of Ne){let t=h(n,e);try{await ie(t)}catch{continue}if(e.endsWith(`.json`)){let e=await C(t,`utf-8`);return JSON.parse(e)}if(e.endsWith(`.ts`)){let r;try{r=await import(`jiti`)}catch(t){let n=t instanceof Error?t.message:String(t);n.includes(`Cannot find package 'jiti'`)||n.includes(`ERR_MODULE_NOT_FOUND`)?console.warn(`Warning: Failed to load ${e} — 'jiti' is required for TypeScript configs. Run \`pnpm add -D jiti\` (or your package manager's equivalent), or rename the file to kick.config.js / kick.config.mjs / kick.config.json.`):console.warn(`Warning: Failed to initialize jiti for ${e}: ${n}`);continue}try{let e=await r.createJiti(n,{interopDefault:!0,fsCache:!1}).import(t,{default:!0}),i=Fe(e,n);for(let e of i)console.warn(` Warning: ${e}`);return Pe(n,e),e}catch(t){let n=t instanceof Error?t.message:String(t);console.warn(`Warning: Failed to load ${e}: ${n}`);continue}}try{let{pathToFileURL:e}=await import(`node:url`),r=await import(e(t).href),i=r.default??r,a=Fe(i,n);for(let e of a)console.warn(` Warning: ${e}`);return Pe(n,i),i}catch(t){let n=t instanceof Error?t.message:String(t);console.warn(`Warning: Failed to load ${e}: ${n}`);continue}}return null}function Pe(e,t){if(!(!t?.assetMap||Object.keys(t.assetMap).length===0))try{let n=h(e,`.kickjs`);i(n,{recursive:!0});let r={version:1,assetMap:t.assetMap,...t.build?.outDir?{build:{outDir:t.build.outDir}}:{}};l(h(n,`kick.config.json`),JSON.stringify(r,null,2)+`
|
|
12
|
+
`,`utf-8`)}catch{}}function Fe(e,t){let n=[];if(!e?.assetMap)return n;let i=v(t);for(let[a,o]of Object.entries(e.assetMap)){if(!a||a.includes(`/`)){n.push(`assetMap key '${a}' is invalid — must be a non-empty string without '/'`);continue}if(typeof o?.src!=`string`||o.src.length===0){n.push(`assetMap.${a} is missing a non-empty 'src' field`);continue}r(v(t,o.src))||n.push(`assetMap.${a}.src ('${o.src}') does not exist — typegen + build will fail`),o.dest&&Ie(v(t,o.dest),i)&&n.push(`assetMap.${a}.dest ('${o.dest}') resolves outside the project root — refusing to copy`)}return n}function Ie(e,t){let n=_(t,e);return n===``?!1:n.startsWith(`..`)||m(n)}function Le(e,t=[]){let n=new Map;for(let t of e){let e=(n.get(t.name)??0)+1;if(n.set(t.name,e),e===2)throw new de(`plugin`,t.name,[t.name,t.name])}let r=new Map,i=[];for(let t of e)for(let e of t.commands??[]){let n=r.get(e.name);if(n)throw new de(`command`,e.name,[n,t.name]);r.set(e.name,t.name),i.push(e)}let a=new Set(t.map(e=>e.name)),o=[...i.filter(e=>!a.has(e.name)),...t],s=new Map,c=[];for(let t of e)for(let e of t.typegens??[]){let n=s.get(e.id);if(n)throw new de(`typegen`,e.id,[n,t.name]);s.set(e.id,t.name),c.push(e)}let l=new Map,u=[];for(let t of e)for(let e of t.generators??[]){let n=l.get(e.name);if(n)throw new de(`generator`,e.name,[n,t.name]);l.set(e.name,t.name),u.push({source:t.name,spec:e})}return{commands:o,typegens:c,generators:u,register:async(t,n)=>{let r;if(n)r={generators:u,...n};else{let{findProjectRoot:e}=await Promise.resolve().then(()=>Jt),t=process.cwd();r={cwd:t,projectRoot:e(t),config:null,log:()=>{},generators:u}}for(let n of e)n.register&&await n.register(t,r)}}}var Re=O({mergeCliPlugins:()=>Le});let ze=!1;function j(e){ze=e}const Be=new Set([`.ts`,`.tsx`,`.js`,`.jsx`,`.mjs`,`.cjs`,`.json`,`.md`]);async function M(e,t){ze||(await oe(f(e),{recursive:!0}),await w(e,t,`utf-8`),Be.has(p(e))&&await Ue(e,t).catch(()=>{}))}let Ve;async function He(t){if(Ve!==void 0)return Ve;try{Ve=await import(e(h(t,`package.json`)).resolve(`oxfmt`))}catch{Ve=null}return Ve}async function Ue(e,t){let n=await He(process.cwd());if(!n)return;let r=await Ge(e);if(r===null)return;let i=await n.format(e,t,r);i.code!==t&&await w(e,i.code,`utf-8`)}const We=new Map;async function Ge(e){let t=f(e),n=t;if(We.has(n))return We.get(n);for(;;){let e=h(t,`.oxfmtrc.json`);if(r(e))try{let t=await C(e,`utf-8`),r=JSON.parse(t);return delete r.$schema,delete r.ignorePatterns,We.set(n,r),r}catch{return We.set(n,null),null}let i=f(t);if(i===t)return We.set(n,null),null;t=i}}async function Ke(e){try{return await ie(e),!0}catch{return!1}}const qe={swagger:`@forinda/kickjs-swagger`,ws:`@forinda/kickjs-ws`,queue:`@forinda/kickjs-queue`,devtools:`@forinda/kickjs-devtools`},Je={zod:{name:`zod`,range:`^4.3.6`},valibot:{name:`valibot`,range:`^1.4.1`},yup:{name:`yup`,range:`^1.7.1`}};function Ye(e,t){let n=e[t];if(!n)throw Error(`generatePackageJson: missing resolved version for ${t}. Add it to SIBLING_PACKAGES in generators/project.ts.`);return n}function Xe(e,t,n,r=[],i=`zod`){let a=Je[i],o={"@forinda/kickjs":Ye(n,`@forinda/kickjs`),"@forinda/kickjs-schema":Ye(n,`@forinda/kickjs-schema`),dotenv:`^17.3.1`,express:`^5.1.0`,"reflect-metadata":`^0.2.2`,[a.name]:a.range};for(let e of r){let t=qe[e];t&&!o[t]&&(o[t]=Ye(n,t))}return JSON.stringify({name:e,version:`0.0.0`,type:`module`,scripts:{dev:`kick dev`,"dev:debug":`kick dev:debug`,build:`kick build`,start:`kick start`,test:`vitest run`,"test:watch":`vitest`,typecheck:`tsc --noEmit`,typegen:`kick typegen`,lint:`eslint src/`,format:`prettier --write src/`},dependencies:o,devDependencies:{"@forinda/kickjs-cli":Ye(n,`@forinda/kickjs-cli`),"@forinda/kickjs-vite":Ye(n,`@forinda/kickjs-vite`),"@swc/core":`^1.15.21`,"@types/express":`^5.0.6`,"@types/node":`^25.0.0`,"unplugin-swc":`^1.5.9`,vite:`^8.0.3`,vitest:`^4.1.2`,typescript:`^6.0.3`,prettier:`^3.8.1`}},null,2)}function Ze(){return`import { defineConfig } from 'vite'
|
|
13
13
|
import { resolve } from 'node:path'
|
|
14
14
|
import swc from 'unplugin-swc'
|
|
15
15
|
import { kickjsVitePlugin, envWatchPlugin } from '@forinda/kickjs-vite'
|
|
@@ -39,7 +39,7 @@ export default defineConfig({
|
|
|
39
39
|
},
|
|
40
40
|
},
|
|
41
41
|
})
|
|
42
|
-
`}function
|
|
42
|
+
`}function Qe(){return JSON.stringify({compilerOptions:{target:`ES2022`,module:`ESNext`,moduleResolution:`bundler`,lib:[`ES2022`],types:[`node`,`vite/client`],strict:!0,esModuleInterop:!0,skipLibCheck:!0,sourceMap:!0,declaration:!0,experimentalDecorators:!0,emitDecoratorMetadata:!0,outDir:`dist`,paths:{"@/*":[`./src/*`]}},include:[`src`,`.kickjs/types/**/*.d.ts`,`.kickjs/types/**/*.ts`]},null,2)}function $e(){return JSON.stringify({semi:!1,singleQuote:!0,trailingComma:`all`,printWidth:100,tabWidth:2},null,2)}function et(){return`# https://editorconfig.org
|
|
43
43
|
root = true
|
|
44
44
|
|
|
45
45
|
[*]
|
|
@@ -52,14 +52,14 @@ insert_final_newline = true
|
|
|
52
52
|
|
|
53
53
|
[*.md]
|
|
54
54
|
trim_trailing_whitespace = false
|
|
55
|
-
`}function
|
|
55
|
+
`}function tt(){return`node_modules/
|
|
56
56
|
dist/
|
|
57
57
|
.env
|
|
58
58
|
coverage/
|
|
59
59
|
.DS_Store
|
|
60
60
|
*.tsbuildinfo
|
|
61
61
|
.kickjs/
|
|
62
|
-
`}function
|
|
62
|
+
`}function nt(){return`# Auto-detect text files and normalise line endings to LF
|
|
63
63
|
* text=auto eol=lf
|
|
64
64
|
|
|
65
65
|
# Explicitly mark generated / binary files
|
|
@@ -77,11 +77,11 @@ coverage/
|
|
|
77
77
|
pnpm-lock.yaml -diff linguist-generated
|
|
78
78
|
yarn.lock -diff linguist-generated
|
|
79
79
|
package-lock.json -diff linguist-generated
|
|
80
|
-
`}function
|
|
80
|
+
`}function rt(){return`PORT=3000
|
|
81
81
|
NODE_ENV=development
|
|
82
|
-
`}function
|
|
82
|
+
`}function it(){return`PORT=3000
|
|
83
83
|
NODE_ENV=development
|
|
84
|
-
`}function
|
|
84
|
+
`}function at(){return`import { defineConfig } from 'vitest/config'
|
|
85
85
|
import swc from 'unplugin-swc'
|
|
86
86
|
|
|
87
87
|
export default defineConfig({
|
|
@@ -92,7 +92,7 @@ export default defineConfig({
|
|
|
92
92
|
include: ['src/**/*.test.ts'],
|
|
93
93
|
},
|
|
94
94
|
})
|
|
95
|
-
`}function
|
|
95
|
+
`}function ot(e,t,n,r=[]){switch(t){case`minimal`:{let t=[],i=[];return r.includes(`swagger`)&&(t.push(`import { SwaggerAdapter } from '@forinda/kickjs-swagger'`),i.push(` SwaggerAdapter({ info: { title: '${e}', version: '${n}' } }),`)),r.includes(`devtools`)&&(t.push(`import { DevToolsAdapter } from '@forinda/kickjs-devtools'`),i.push(` DevToolsAdapter(),`)),`import 'reflect-metadata'
|
|
96
96
|
// Side-effect import — registers the extended env schema with kickjs
|
|
97
97
|
// **before** any controller / service / @Value gets resolved. Without
|
|
98
98
|
// this line ConfigService.get('YOUR_KEY') returns undefined because the
|
|
@@ -136,14 +136,14 @@ export const app = await bootstrap({
|
|
|
136
136
|
express.json(),
|
|
137
137
|
],
|
|
138
138
|
})
|
|
139
|
-
`}}}function
|
|
139
|
+
`}}}function st(){return`import { defineModules } from '@forinda/kickjs'
|
|
140
140
|
import { HelloModule } from './hello/hello.module'
|
|
141
141
|
|
|
142
142
|
// Remove HelloModule and run: kick g module <name>
|
|
143
143
|
// \`defineModules()\` returns a chainable list — \`kick g module\` appends
|
|
144
144
|
// \`.mount(NewModule())\` to the chain on every generation.
|
|
145
145
|
export const modules = defineModules().mount(HelloModule())
|
|
146
|
-
`}function
|
|
146
|
+
`}function ct(e=`zod`){return e===`valibot`?`import { loadEnvFromSchema } from '@forinda/kickjs/config'
|
|
147
147
|
import { fromValibot } from '@forinda/kickjs-schema/valibot'
|
|
148
148
|
import * as v from 'valibot'
|
|
149
149
|
|
|
@@ -271,7 +271,7 @@ const envSchema = fromZod(
|
|
|
271
271
|
export const env = loadEnvFromSchema(envSchema)
|
|
272
272
|
|
|
273
273
|
export default envSchema
|
|
274
|
-
`}function
|
|
274
|
+
`}function lt(){return`import { Service } from '@forinda/kickjs'
|
|
275
275
|
|
|
276
276
|
@Service()
|
|
277
277
|
export class HelloService {
|
|
@@ -283,7 +283,7 @@ export class HelloService {
|
|
|
283
283
|
return { status: 'ok', uptime: process.uptime() }
|
|
284
284
|
}
|
|
285
285
|
}
|
|
286
|
-
`}function
|
|
286
|
+
`}function ut(){return`import { Controller, Get, Autowired, type Ctx } from '@forinda/kickjs'
|
|
287
287
|
import { HelloService } from './hello.service'
|
|
288
288
|
|
|
289
289
|
// \`Ctx<KickRoutes.HelloController['<method>']>\` is generated by
|
|
@@ -305,7 +305,7 @@ export class HelloController {
|
|
|
305
305
|
ctx.json(this.helloService.healthCheck())
|
|
306
306
|
}
|
|
307
307
|
}
|
|
308
|
-
`}function
|
|
308
|
+
`}function dt(){return`import { defineModule } from '@forinda/kickjs'
|
|
309
309
|
import { HelloController } from './hello.controller'
|
|
310
310
|
|
|
311
311
|
export const HelloModule = defineModule({
|
|
@@ -326,7 +326,7 @@ export const HelloModule = defineModule({
|
|
|
326
326
|
},
|
|
327
327
|
}),
|
|
328
328
|
})
|
|
329
|
-
`}function
|
|
329
|
+
`}function ft(e,t=`inmemory`,n=`pnpm`){return`import { defineConfig } from '@forinda/kickjs-cli'
|
|
330
330
|
|
|
331
331
|
export default defineConfig({
|
|
332
332
|
pattern: '${e}',
|
|
@@ -373,7 +373,7 @@ export default defineConfig({
|
|
|
373
373
|
},
|
|
374
374
|
],
|
|
375
375
|
})
|
|
376
|
-
`}function
|
|
376
|
+
`}function pt(e,t,n){let r={rest:`REST API`,ddd:`Domain-Driven Design`,cqrs:`CQRS + Event-Driven`,minimal:`Minimal`},i=[`@forinda/kickjs`,`@forinda/kickjs-vite`];return t!==`minimal`&&i.push(`@forinda/kickjs-swagger`,`@forinda/kickjs-devtools`),`# ${e}
|
|
377
377
|
|
|
378
378
|
A **${r[t]??`REST API`}** built with [KickJS](https://forinda.github.io/kick-js/) — a decorator-driven Node.js framework on Express 5 and TypeScript.
|
|
379
379
|
|
|
@@ -436,7 +436,7 @@ Copy \`.env.example\` to \`.env\` and configure:
|
|
|
436
436
|
|
|
437
437
|
- [KickJS Documentation](https://forinda.github.io/kick-js/)
|
|
438
438
|
- [CLI Reference](https://forinda.github.io/kick-js/api/cli.html)
|
|
439
|
-
`}function
|
|
439
|
+
`}function mt(e,t,n){return`# CLAUDE.md — ${e}
|
|
440
440
|
|
|
441
441
|
**Read \`./.agents/AGENTS.md\` first.** It is the canonical, multi-agent
|
|
442
442
|
reference for this project (Claude, Copilot, Codex, Gemini, etc.) —
|
|
@@ -510,7 +510,7 @@ When generating or modifying code in this project, stay aligned with the v4 conv
|
|
|
510
510
|
- **Refresh these files**: \`kick g agents -f\` regenerates \`CLAUDE.md\` at the project root and \`.agents/AGENTS.md\` + \`.agents/GEMINI.md\` + \`.agents/COPILOT.md\` + every \`.agents/skills/<name>/SKILL.md\` from the latest CLI templates. Hand-edited content is overwritten — keep customisation in \`.agents/AGENTS.local.md\` or per-skill \`SKILL.local.md\` files alongside.
|
|
511
511
|
|
|
512
512
|
For everything else (controllers, services, modules, RequestContext API, generators, CLI commands, package additions, env wiring, troubleshooting) → \`.agents/AGENTS.md\`.
|
|
513
|
-
`}function
|
|
513
|
+
`}function ht(e,t,n){return`# AGENTS.md — AI Agent Guide for ${e}
|
|
514
514
|
|
|
515
515
|
This guide is the **canonical, multi-agent reference** for this KickJS
|
|
516
516
|
application — Claude, Copilot, Codex, Gemini, etc. all read it first.
|
|
@@ -987,7 +987,7 @@ Full guide: <https://forinda.github.io/kick-js/guide/context-decorators>.
|
|
|
987
987
|
- [Decorators Guide](https://forinda.github.io/kick-js/guide/decorators.html)
|
|
988
988
|
- [DI System](https://forinda.github.io/kick-js/guide/dependency-injection.html)
|
|
989
989
|
- [Testing](https://forinda.github.io/kick-js/api/testing.html)
|
|
990
|
-
`}function
|
|
990
|
+
`}function gt(e,t,n){let r=`<!-- Generated by \`kick g agents\` for ${e}. Edits are overwritten on the next refresh; keep customisation in a SKILL.local.md alongside. -->`;return[{slug:`add-module`,frontmatterName:`kickjs-add-module`,description:`Use when the user asks to add a new feature module (controller + service + repo + DTOs).`,body:`**Trigger phrases**: "add a users module", "scaffold tasks", "new feature for X".
|
|
991
991
|
|
|
992
992
|
**Steps**:
|
|
993
993
|
1. Run \`kick g module <name>\` (use plural form if the project pluralizes — check \`kick.config.ts\`).
|
|
@@ -1122,7 +1122,7 @@ description: ${e.description}
|
|
|
1122
1122
|
${r}
|
|
1123
1123
|
|
|
1124
1124
|
${e.body}
|
|
1125
|
-
`}))}function
|
|
1125
|
+
`}))}function _t(e,t,n){return`# GEMINI.md — ${e}
|
|
1126
1126
|
|
|
1127
1127
|
**Read \`./AGENTS.md\` first.** It is the canonical, multi-agent
|
|
1128
1128
|
reference for this project — every convention, structure, decorator
|
|
@@ -1156,7 +1156,7 @@ without us copy-pasting.
|
|
|
1156
1156
|
\`kick g agents --only gemini -f\` regenerates this file from the
|
|
1157
1157
|
CLI template. Hand-edited content is overwritten — keep customisation
|
|
1158
1158
|
in \`.agents/GEMINI.local.md\`.
|
|
1159
|
-
`}function
|
|
1159
|
+
`}function vt(e,t,n){return`# COPILOT.md — ${e}
|
|
1160
1160
|
|
|
1161
1161
|
**Read \`./AGENTS.md\` first.** It is the canonical, multi-agent
|
|
1162
1162
|
reference for this project — every convention, structure, decorator
|
|
@@ -1189,16 +1189,16 @@ Codex / Cursor / Gemini / Claude Code without copy-pasting.
|
|
|
1189
1189
|
\`kick g agents --only copilot -f\` regenerates this file from the
|
|
1190
1190
|
CLI template. Hand-edited content is overwritten — keep customisation
|
|
1191
1191
|
in \`.agents/COPILOT.local.md\`.
|
|
1192
|
-
`}const
|
|
1193
|
-
Dependencies installed successfully!`)}catch{console.log(`\n Warning: ${r} install failed. Run it manually.`)}}try{let{runTypegen:e}=await Promise.resolve().then(()=>
|
|
1194
|
-
Project scaffolded successfully!`),console.log();let f=c!==process.cwd();l(`Next steps:`),f&&l(` cd ${t}`),e.installDeps||l(` ${r} install`);let p={rest:`kick g module user`,ddd:`kick g module user --repo drizzle`,cqrs:`kick g module user --pattern cqrs`,minimal:`# add your routes to src/index.ts`};l(` ${p[i]??p.rest}`),l(` kick dev`),l(``),l(`Commands:`),l(` kick dev Start dev server with Vite HMR`),l(` kick build Production build via Vite`),l(` kick start Run production build`),l(``),l(`Generators:`),l(` kick g module <name> Full DDD module (controller, DTOs, use-cases, repo)`),l(` kick g scaffold <n> <f..> CRUD module from field definitions`),l(` kick g controller <name> Standalone controller`),l(` kick g service <name> @Service() class`),l(` kick g middleware <name> Express middleware`),l(` kick g guard <name> Route guard (auth, roles, etc.)`),l(` kick g adapter <name> AppAdapter with lifecycle hooks`),l(` kick g dto <name> Zod DTO schema`),l(` kick g config Generate kick.config.ts`),l(``),l(`Add packages:`),l(` kick add <pkg> Install a KickJS package + peers`),l(` kick add --list Show all available packages`),l(``),l(`Available: auth, swagger, drizzle, prisma, ws, queue, devtools, mcp, testing`),l(``)}const
|
|
1192
|
+
`}const yt=f(b(import.meta.url)),bt=JSON.parse(a(h(yt,`..`,`package.json`),`utf-8`)),xt=`^${bt.version}`,St=[`@forinda/kickjs`,`@forinda/kickjs-cli`,`@forinda/kickjs-schema`,`@forinda/kickjs-vite`,`@forinda/kickjs-swagger`,`@forinda/kickjs-ws`,`@forinda/kickjs-queue`,`@forinda/kickjs-devtools`,`@forinda/kickjs-testing`];async function Ct(){let e=await Promise.all(St.map(async e=>{try{let t=ee(`npm`,[`view`,e,`version`],{encoding:`utf-8`,timeout:5e3,stdio:[`ignore`,`pipe`,`ignore`]}).toString().trim();if(t&&/^\d+\.\d+\.\d+/.test(t))return[e,`^${t}`]}catch{}return[e,xt]}));return Object.fromEntries(e)}async function wt(e){let{name:t,directory:n,packageManager:r=`pnpm`,template:i=`rest`,defaultRepo:a=`inmemory`,packages:o=[],schemaLib:s=`zod`}=e,c=n,l=e=>console.log(` ${e}`);console.log(`\n Creating KickJS project: ${t}\n`),l(`Resolving package versions...`);let u=await Ct();await M(h(c,`package.json`),Xe(t,i,u,o,s)),await M(h(c,`vite.config.ts`),Ze()),await M(h(c,`tsconfig.json`),Qe()),await M(h(c,`.prettierrc`),$e()),await M(h(c,`.editorconfig`),et()),await M(h(c,`.gitignore`),tt()),await M(h(c,`.gitattributes`),nt()),await M(h(c,`.env`),rt()),await M(h(c,`.env.example`),it()),await M(h(c,`src/config/index.ts`),ct(s)),await M(h(c,`src/index.ts`),ot(t,i,bt.version,o)),await M(h(c,`src/modules/index.ts`),st()),await M(h(c,`src/modules/hello/hello.service.ts`),lt()),await M(h(c,`src/modules/hello/hello.controller.ts`),ut()),await M(h(c,`src/modules/hello/hello.module.ts`),dt()),await M(h(c,`kick.config.ts`),ft(i,a,r)),await M(h(c,`vitest.config.ts`),at()),await M(h(c,`README.md`),pt(t,i,r));let{generateAgentDocs:d}=await Promise.resolve().then(()=>Zn);if(await d({outDir:c,name:t,pm:r,template:i,only:`all`,force:!0}),e.installDeps){console.log(`\n Installing dependencies with ${r}...\n`);try{S(`${r} install`,{cwd:c,stdio:`inherit`}),console.log(`
|
|
1193
|
+
Dependencies installed successfully!`)}catch{console.log(`\n Warning: ${r} install failed. Run it manually.`)}}try{let{runTypegen:e}=await Promise.resolve().then(()=>ma);await e({cwd:c,allowDuplicates:!0,silent:!0})}catch{}if(e.initGit)try{S(`git init`,{cwd:c,stdio:`pipe`}),S(`git branch -M main`,{cwd:c,stdio:`pipe`}),S(`git add -A`,{cwd:c,stdio:`pipe`}),S(`git commit -m "chore: initial commit from kick new"`,{cwd:c,stdio:`pipe`}),l(`Git repository initialized`)}catch{l(`Warning: git init failed (git may not be installed)`)}console.log(`
|
|
1194
|
+
Project scaffolded successfully!`),console.log();let f=c!==process.cwd();l(`Next steps:`),f&&l(` cd ${t}`),e.installDeps||l(` ${r} install`);let p={rest:`kick g module user`,ddd:`kick g module user --repo drizzle`,cqrs:`kick g module user --pattern cqrs`,minimal:`# add your routes to src/index.ts`};l(` ${p[i]??p.rest}`),l(` kick dev`),l(``),l(`Commands:`),l(` kick dev Start dev server with Vite HMR`),l(` kick build Production build via Vite`),l(` kick start Run production build`),l(``),l(`Generators:`),l(` kick g module <name> Full DDD module (controller, DTOs, use-cases, repo)`),l(` kick g scaffold <n> <f..> CRUD module from field definitions`),l(` kick g controller <name> Standalone controller`),l(` kick g service <name> @Service() class`),l(` kick g middleware <name> Express middleware`),l(` kick g guard <name> Route guard (auth, roles, etc.)`),l(` kick g adapter <name> AppAdapter with lifecycle hooks`),l(` kick g dto <name> Zod DTO schema`),l(` kick g config Generate kick.config.ts`),l(``),l(`Add packages:`),l(` kick add <pkg> Install a KickJS package + peers`),l(` kick add --list Show all available packages`),l(``),l(`Available: auth, swagger, drizzle, prisma, ws, queue, devtools, mcp, testing`),l(``)}const Tt={GET:D.green,POST:D.cyan,PUT:D.yellow,PATCH:D.magenta,DELETE:D.red};function Et(e){return(Tt[e]??D.dim)(e.padEnd(7))}function Dt(e){let t=`[${e}]`.padEnd(10);switch(e){case`CRITICAL`:return D.red(t);case`WARNING`:return D.yellow(t);case`INFO`:return D.blue(D.dim(t));default:return t}}D.green(`✓`),D.red(`✖`),D.yellow(`⚠`),D.blue(`ℹ`);function Ot(e){E.intro(D.bgCyan(D.black(` ${e} `)))}function N(e){E.outro(e)}function kt(e){E.isCancel(e)&&(E.cancel(`Operation cancelled.`),process.exit(0))}async function At(e){let t=await E.text(e);return kt(t),t}async function jt(e){let t=await E.select(e);return kt(t),t}async function Mt(e){let t=await E.multiselect(e);return kt(t),t}async function P(e){let t=await E.confirm(e);return kt(t),t}function Nt(){return E.spinner()}const F=E.log,Pt={kickjs:{pkg:`@forinda/kickjs`,peers:[`express`],description:`Unified framework: DI, decorators, routing, middleware`,core:!0},vite:{pkg:`@forinda/kickjs-vite`,peers:[`vite`],description:`Vite plugin: dev server, HMR, module discovery`,dev:!0,core:!0},cli:{pkg:`@forinda/kickjs-cli`,peers:[],description:`CLI tool and code generators`,dev:!0,core:!0},zod:{pkg:`zod`,peers:[],description:`Zod schema validation (env, DTOs, OpenAPI) — wrap with fromZod()`},valibot:{pkg:`valibot`,peers:[],description:`Valibot schema validation — wrap with fromValibot()`},yup:{pkg:`yup`,peers:[],description:`Yup schema validation — wrap with fromYup()`},auth:{pkg:`@forinda/kickjs-auth`,peers:[`jsonwebtoken`],description:`JWT, API key, OAuth strategies, @Public, @Roles (+ optional argon2/bcryptjs)`,deprecated:`auth is moving to BYO — compose @LoadAuthUser/@RequireRole/@Public from defineContextDecorator (see the BYO Auth recipe in the docs)`},ai:{pkg:`@forinda/kickjs-ai`,peers:[`zod`],description:`AI toolkit — LLM providers, tool definitions from controllers`},swagger:{pkg:`@forinda/kickjs-swagger`,peers:[],description:`OpenAPI spec + Swagger UI + ReDoc`},db:{pkg:`@forinda/kickjs-db`,peers:[],description:`kick/db core — schema DSL, migrations, KickDbClient, customType`},pg:{pkg:`@forinda/kickjs-db`,peers:[`pg`],description:`kick/db + PostgreSQL driver (use @forinda/kickjs-db/pg)`},sqlite:{pkg:`@forinda/kickjs-db`,peers:[`better-sqlite3`],description:`kick/db + SQLite driver (use @forinda/kickjs-db/sqlite)`},mysql:{pkg:`@forinda/kickjs-db`,peers:[`mysql2`],description:`kick/db + MySQL driver (use @forinda/kickjs-db/mysql)`},drizzle:{pkg:`@forinda/kickjs-drizzle`,peers:[`drizzle-orm`],description:`Drizzle ORM adapter + query builder`,deprecated:"early-adoption adapter, no longer maintained — wire Drizzle directly (BYO), or use @forinda/kickjs-db, the built-in Kick ORM (`kick add db` / pg / sqlite / mysql)"},prisma:{pkg:`@forinda/kickjs-prisma`,peers:[`@prisma/client`],description:`Prisma adapter + query builder`,deprecated:"early-adoption adapter, no longer maintained — wire Prisma directly (BYO), or use @forinda/kickjs-db, the built-in Kick ORM (`kick add db` / pg / sqlite / mysql)"},ws:{pkg:`@forinda/kickjs-ws`,peers:[`socket.io`],description:`WebSocket with @WsController decorators`},devtools:{pkg:`@forinda/kickjs-devtools`,peers:[],description:`Development dashboard — routes, DI, metrics, health`,dev:!0},queue:{pkg:`@forinda/kickjs-queue`,peers:[],description:`Queue adapter (BullMQ/RabbitMQ/Kafka)`},"queue:bullmq":{pkg:`@forinda/kickjs-queue`,peers:[`bullmq`,`ioredis`],description:`Queue with BullMQ + Redis`},"queue:rabbitmq":{pkg:`@forinda/kickjs-queue`,peers:[`amqplib`],description:`Queue with RabbitMQ`},"queue:kafka":{pkg:`@forinda/kickjs-queue`,peers:[`kafkajs`],description:`Queue with Kafka`},"queue:redis-pubsub":{pkg:`@forinda/kickjs-queue`,peers:[`ioredis`],description:`Lightweight pub/sub via Redis (no persistence)`},mcp:{pkg:`@forinda/kickjs-mcp`,peers:[`@modelcontextprotocol/sdk`],description:`Model Context Protocol server — expose @Controller endpoints as AI tools`},testing:{pkg:`@forinda/kickjs-testing`,peers:[],description:`Test utilities and TestModule builder`,dev:!0}};function Ft(e,t=process.cwd()){let n=t;for(;;){if(r(v(n,e)))return n;let t=f(n);if(t===n)return null;n=t}}function It(){return Ft(`pnpm-lock.yaml`)?`pnpm`:Ft(`yarn.lock`)?`yarn`:Ft(`bun.lockb`)||Ft(`bun.lock`)?`bun`:Ft(`package-lock.json`)?`npm`:null}function Lt(){let e=process.cwd();for(;e;){let t=v(e,`package.json`);if(r(t))try{let e=JSON.parse(a(t,`utf-8`)).packageManager;if(typeof e==`string`){let t=e.split(`@`)[0];if(Ee.includes(t))return t}}catch{}let n=f(e);if(n===e)return null;e=n}return null}async function Rt(e){if(e&&Ee.includes(e))return{pm:e,source:`flag`};let t=await A(process.cwd());if(t?.packageManager&&Ee.includes(t.packageManager))return{pm:t.packageManager,source:`config`};let n=Lt();if(n)return{pm:n,source:`package.json`};let r=It();return r?{pm:r,source:`lockfile`}:{pm:`npm`,source:`default`}}async function zt(e){let{pm:t}=await Rt(e);return t}function Bt(e=!1){let t=Object.entries(Pt),n=Math.max(...t.map(([e])=>e.length)),r=t.filter(([,e])=>e.core),i=t.filter(([,e])=>!e.core),a=([e,t])=>{let r=e.padEnd(n+2),i=t.peers.length?` (+ ${t.peers.join(`, `)})`:``,a=t.deprecated?` [DEPRECATED — ${t.deprecated}]`:``;return` ${r} ${t.description}${i}${a}`};console.log(`
|
|
1195
1195
|
Core packages (always installed by \`kick new\`):
|
|
1196
1196
|
`);for(let e of r)console.log(a(e));if(e){console.log(`
|
|
1197
1197
|
Optional packages (add as needed):
|
|
1198
1198
|
`);for(let e of i)console.log(a(e))}else console.log(`\n Plus ${i.length} optional packages (auth, swagger, db, queue, …).`),console.log(" Run `kick add --list --all` for the full catalog.");console.log(`
|
|
1199
|
-
Usage: kick add
|
|
1200
|
-
`),
|
|
1201
|
-
`)}})}const
|
|
1199
|
+
Usage: kick add ai db swagger`),console.log(` kick add queue:bullmq`),console.log()}function Vt(e,t){let n=new Set,r=new Set,i=[],a=[];for(let o of e){let e=Pt[o];if(!e){i.push(o);continue}e.deprecated&&a.push(`'${o}' (${e.pkg}) is deprecated — ${e.deprecated}`);let s=t||e.dev?r:n;s.add(e.pkg);for(let t of e.peers)s.add(t)}return{prodDeps:[...n],devDeps:[...r],unknown:i,warnings:a}}function Ht(e){e.command(`list`).alias(`ls`).description(`List KickJS packages (core only; pair with --all for the full catalog)`).option(`--all`,`Include the full optional catalog`).action(e=>{Bt(!!e.all)})}function Ut(e){e.command(`add [packages...]`).description(`Add KickJS packages with their required dependencies`).option(`--pm <manager>`,`Package manager override`).option(`-D, --dev`,`Install as dev dependency`).option(`--list`,`List packages (core only by default; pair with --all)`).option(`--all`,`When listing, include the full optional catalog`).action(async(e,t)=>{if(t.list||e.length===0){Bt(!!t.all);return}let{pm:n,source:r}=await Rt(t.pm);console.log(`\n Using ${n} (resolved from ${r})`);let{prodDeps:i,devDeps:a,unknown:o,warnings:s}=Vt(e,!!t.dev);for(let e of s)console.warn(`\n WARNING: ${e}`);if(!(o.length>0&&(console.log(`\n Unknown packages: ${o.join(`, `)}`),console.log(` Run "kick add --list" to see available packages.
|
|
1200
|
+
`),i.length===0&&a.length===0))){if(i.length>0){let e=i,t=`${n} add ${e.join(` `)}`;console.log(`\n Installing ${e.length} dependency(ies):`);for(let t of e)console.log(` + ${t}`);console.log();try{S(t,{stdio:`inherit`})}catch{console.log(`\n Installation failed. Run manually:\n ${t}\n`)}}if(a.length>0){let e=a,t=`${n} add -D ${e.join(` `)}`;console.log(`\n Installing ${e.length} dev dependency(ies):`);for(let t of e)console.log(` + ${t} (dev)`);console.log();try{S(t,{stdio:`inherit`})}catch{console.log(`\n Installation failed. Run manually:\n ${t}\n`)}}console.log(` Done!
|
|
1201
|
+
`)}})}const Wt=[{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 Gt(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`).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. auth,swagger,ws,queue)`).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)=>{Ot(`KickJS — Create a new project`);let n=!!(t.yes||t.nonInteractive);e||=n?`my-api`:await At({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let i;if(e===`.`?(i=v(`.`),e=d(i)):i=v(t.directory||e),r(i)){let r=o(i);if(r.length>0){if(t.force)F.warn(`Clearing existing files in ${i}`);else if(n){F.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),N(`Aborted.`);return}else{F.warn(`Directory "${e}" is not empty:`);let t=r.slice(0,5);for(let e of t)F.message(` - ${e}`);if(r.length>5&&F.message(` ... and ${r.length-5} more`),!await P({message:D.red(`Remove all existing files and proceed?`),initialValue:!1})){N(`Aborted.`);return}}for(let e of r)s(v(i,e),{recursive:!0,force:!0})}}let a=t.template;a||=n?`minimal`:await jt({message:`Project template`,options:[{value:`rest`,label:`REST API`,hint:`Express + Swagger`},{value:`minimal`,label:`Minimal`,hint:`bare Express`}]});let c=t.pm;c||=n?await zt(void 0):await jt({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let l=t.repo;l||=n?`inmemory`:await At({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),ke(l);let u=t.schema;u||=n?`zod`:await jt({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(u)||(F.warn(`Unknown --schema "${u}", falling back to zod.`),u=`zod`);let f;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();f=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else f=n?[]:await Mt({message:`Select packages to include`,options:[...Wt],required:!1});let p;p=t.git===void 0?n?!0:await P({message:`Initialize git repository?`,initialValue:!0}):t.git;let m;m=t.install===void 0?n?!0:await P({message:`Install dependencies?`,initialValue:!0}):t.install,await wt({name:e,directory:i,packageManager:c,initGit:p,installDeps:m,template:a,defaultRepo:l,packages:f,schemaLib:u}),N(`Done! Next steps: ${D.cyan(`cd ${e} && ${c} dev`)}`)})}function I(e){return e.replace(/[-_\s]+(.)?/g,(e,t)=>t?t.toUpperCase():``).replace(/^(.)/,e=>e.toUpperCase())}function L(e){let t=I(e);return t.charAt(0).toLowerCase()+t.slice(1)}function R(e){return e.replace(/([a-z])([A-Z])/g,`$1-$2`).replace(/[\s_]+/g,`-`).toLowerCase()}function Kt(e){return fe.plural(e)}function qt(e){return fe.plural(e)}var Jt=O({findProjectRoot:()=>Xt});const Yt=[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`,`kick.config.json`];function Xt(e=process.cwd()){let t=v(e),{root:n}=g(t),i=null,a=t;for(;;){for(let e of Yt)if(r(v(a,e)))return a;if(i===null&&r(v(a,`package.json`))&&(i=a),a===n)break;let e=f(a);if(e===a)break;a=e}return i??t}function Zt(e){return R(e).replace(/-/g,`_`)}function Qt(e){let t=e.cwd??process.cwd(),n=e.projectRoot??Xt(t),r=e.pluralize??!0,i=I(e.name),a=L(e.name),o=R(e.name),s=Zt(e.name),c={name:e.name,pascal:i,camel:a,kebab:o,snake:s,modulesDir:e.modulesDir??`src/modules`,cwd:t,projectRoot:n,args:e.args??[],flags:e.flags??{}};if(r){let e=Kt(o);c.pluralKebab=e,c.pluralPascal=I(e),c.pluralCamel=L(e)}return c}function $t(e,t){return v(e.cwd,t)}async function en(e){return import(x(e).href)}const tn=new Map;async function nn(e){let t=tn.get(e);if(t)return t;let n=rn(e);return tn.set(e,n),n}async function rn(t){let n=v(t,`package.json`);if(!r(n))return{generators:[],loaded:[],failed:[]};let i=an(JSON.parse(await C(n,`utf-8`))),a=e(v(t,`package.json`)),o=[],s=[],c=[];for(let e of i){let t;try{t=a.resolve(`${e}/package.json`)}catch{continue}let n;try{n=JSON.parse(await C(t,`utf-8`))}catch(t){c.push({source:e,reason:`failed to parse package.json: ${t}`});continue}if(!n.kickjs?.generators)continue;let i=n.kickjs.generators,l=v(f(t),i);if(!r(l)){c.push({source:e,reason:`kickjs.generators points to missing file: ${i}`});continue}let u;try{u=await en(l)}catch(t){c.push({source:e,reason:`failed to import manifest: ${t}`});continue}let d=u.default;if(!Array.isArray(d)){c.push({source:e,reason:`manifest's default export is not an array of GeneratorSpec`});continue}for(let t of d){if(!on(t)){c.push({source:e,reason:`manifest entry is not a valid GeneratorSpec (missing name/files)`});continue}o.push({source:e,spec:t})}s.push(e)}return{generators:o,loaded:s,failed:c}}function an(e){let t=new Set;for(let n of[e.dependencies,e.devDependencies,e.peerDependencies])if(n)for(let e of Object.keys(n))t.add(e);return Array.from(t)}function on(e){if(!e||typeof e!=`object`)return!1;let t=e;return typeof t.name==`string`&&typeof t.files==`function`}async function sn(e,t=[]){let n=e.cwd??process.cwd(),r=t.find(t=>t.spec.name===e.generatorName);if(r)return un(r.spec,r.source,e,n);let i=ln(await nn(n),e.generatorName);return i?un(i.spec,i.source,e,n):null}async function cn(e,t=[]){let n=await nn(e),r=new Set(t.map(e=>e.spec.name)),i=n.generators.filter(e=>!r.has(e.spec.name));return{generators:[...t,...i],loaded:n.loaded,failed:n.failed}}function ln(e,t){return e.generators.find(e=>e.spec.name===t)}async function un(e,t,n,r){let i=Qt({name:n.itemName,args:n.args,flags:n.flags,modulesDir:n.modulesDir,pluralize:n.pluralize,cwd:r,projectRoot:n.projectRoot}),a=await e.files(i),o=[];for(let e of a){let t=$t(i,e.path);await M(t,e.content),o.push(t)}return{files:o,source:t}}function z(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}function dn(e){return e.charAt(0).toUpperCase()+e.slice(1).replace(/-([a-z])/g,(e,t)=>t.toUpperCase())}function fn(e){return e.replace(/([a-z])([A-Z])/g,`$1-$2`).toLowerCase()}function pn(e,t,n){let r={inmemory:`InMemory${e}Repository`,drizzle:`Drizzle${e}Repository`,prisma:`Prisma${e}Repository`},i={inmemory:`in-memory-${t}`,drizzle:`drizzle-${t}`,prisma:`prisma-${t}`};return{repoClass:r[n]??`${dn(n)}${e}Repository`,repoFile:i[n]??`${fn(n)}-${t}`}}function mn(e){return e??`define`}function hn(e){let{pascal:t,kebab:n,plural:r=``,repo:i,style:a}=e,{repoClass:o,repoFile:s}=pn(t,n,i),c=mn(a),l=`/**
|
|
1202
1202
|
* ${t} Module
|
|
1203
1203
|
*
|
|
1204
1204
|
* REST module with a flat folder structure.
|
|
@@ -1270,7 +1270,7 @@ ${d}
|
|
|
1270
1270
|
},
|
|
1271
1271
|
}),
|
|
1272
1272
|
})
|
|
1273
|
-
`}function
|
|
1273
|
+
`}function gn(e){let{pascal:t,kebab:n,plural:r=``,style:i}=e,a=mn(i),o=` /**
|
|
1274
1274
|
* Declare HTTP routes. Return value shape:
|
|
1275
1275
|
*
|
|
1276
1276
|
* - \`path\` — URL prefix for this route set.
|
|
@@ -1310,7 +1310,7 @@ ${o}
|
|
|
1310
1310
|
},
|
|
1311
1311
|
}),
|
|
1312
1312
|
})
|
|
1313
|
-
`}function
|
|
1313
|
+
`}function _n(e){let{pascal:t,kebab:n}=e,r=t.charAt(0).toLowerCase()+t.slice(1);return`import { Controller, Get, Post, Put, Delete, Autowired, ApiQueryParams, type Ctx } from '@forinda/kickjs'
|
|
1314
1314
|
import { ApiTags } from '@forinda/kickjs-swagger'
|
|
1315
1315
|
import { ${t}Service } from './${n}.service'
|
|
1316
1316
|
import { create${t}Schema } from './dtos/create-${n}.dto'
|
|
@@ -1365,7 +1365,7 @@ export class ${t}Controller {
|
|
|
1365
1365
|
ctx.noContent()
|
|
1366
1366
|
}
|
|
1367
1367
|
}
|
|
1368
|
-
`}function
|
|
1368
|
+
`}function vn(e){let{pascal:t}=e;return`import { z } from 'zod'
|
|
1369
1369
|
|
|
1370
1370
|
/**
|
|
1371
1371
|
* Create ${t} DTO — Zod schema for validating POST request bodies.
|
|
@@ -1381,20 +1381,20 @@ export const create${t}Schema = z.object({
|
|
|
1381
1381
|
})
|
|
1382
1382
|
|
|
1383
1383
|
export type Create${t}DTO = z.infer<typeof create${t}Schema>
|
|
1384
|
-
`}function
|
|
1384
|
+
`}function yn(e){let{pascal:t}=e;return`import { z } from 'zod'
|
|
1385
1385
|
|
|
1386
1386
|
export const update${t}Schema = z.object({
|
|
1387
1387
|
name: z.string().min(1).max(200).optional(),
|
|
1388
1388
|
})
|
|
1389
1389
|
|
|
1390
1390
|
export type Update${t}DTO = z.infer<typeof update${t}Schema>
|
|
1391
|
-
`}function
|
|
1391
|
+
`}function bn(e){let{pascal:t}=e;return`export interface ${t}ResponseDTO {
|
|
1392
1392
|
id: string
|
|
1393
1393
|
name: string
|
|
1394
1394
|
createdAt: string
|
|
1395
1395
|
updatedAt: string
|
|
1396
1396
|
}
|
|
1397
|
-
`}function
|
|
1397
|
+
`}function xn(e){let{pascal:t,kebab:n,dtoPrefix:r=`../../application/dtos`,tokenScope:i=`app`}=e;return`/**
|
|
1398
1398
|
* ${t} Repository Interface
|
|
1399
1399
|
*
|
|
1400
1400
|
* Defines the contract for data access.
|
|
@@ -1429,7 +1429,7 @@ export interface I${t}Repository {
|
|
|
1429
1429
|
* adopters must NOT use the reserved \`'kick/'\` namespace.
|
|
1430
1430
|
*/
|
|
1431
1431
|
export const ${t.toUpperCase()}_REPOSITORY = createToken<I${t}Repository>('${i}/${t}/repository')
|
|
1432
|
-
`}function
|
|
1432
|
+
`}function Sn(e){let{pascal:t,kebab:n,repoPrefix:r=`../../domain/repositories`,dtoPrefix:i=`../../application/dtos`}=e;return`/**
|
|
1433
1433
|
* In-Memory ${t} Repository
|
|
1434
1434
|
*
|
|
1435
1435
|
* Implements the repository interface using a Map.
|
|
@@ -1489,7 +1489,7 @@ export class InMemory${t}Repository implements I${t}Repository {
|
|
|
1489
1489
|
this.store.delete(id)
|
|
1490
1490
|
}
|
|
1491
1491
|
}
|
|
1492
|
-
`}function
|
|
1492
|
+
`}function Cn(e){let{pascal:t,kebab:n,repoType:r=``,repoPrefix:i=`../../domain/repositories`,dtoPrefix:a=`../../application/dtos`}=e,o=r.charAt(0).toUpperCase()+r.slice(1).replace(/-([a-z])/g,(e,t)=>t.toUpperCase());return`/**
|
|
1493
1493
|
* ${o} ${t} Repository
|
|
1494
1494
|
*
|
|
1495
1495
|
* Stub implementation for a custom '${r}' repository.
|
|
@@ -1558,7 +1558,7 @@ export class ${o}${t}Repository implements I${t}Repository {
|
|
|
1558
1558
|
this.store.delete(id)
|
|
1559
1559
|
}
|
|
1560
1560
|
}
|
|
1561
|
-
`}function
|
|
1561
|
+
`}function wn(e){let{pascal:t,kebab:n,plural:r=``}=e;return`import { describe, it, expect, beforeEach } from 'vitest'
|
|
1562
1562
|
import { Container } from '@forinda/kickjs'
|
|
1563
1563
|
|
|
1564
1564
|
describe('${t}Controller', () => {
|
|
@@ -1610,7 +1610,7 @@ describe('${t}Controller', () => {
|
|
|
1610
1610
|
})
|
|
1611
1611
|
})
|
|
1612
1612
|
})
|
|
1613
|
-
`}function
|
|
1613
|
+
`}function Tn(e){let{pascal:t,kebab:n,plural:r=``,repoPrefix:i=`../infrastructure/repositories/in-memory-${n}.repository`}=e;return`import { describe, it, expect, beforeEach } from 'vitest'
|
|
1614
1614
|
import { InMemory${t}Repository } from '${i}'
|
|
1615
1615
|
|
|
1616
1616
|
describe('InMemory${t}Repository', () => {
|
|
@@ -1672,7 +1672,7 @@ describe('InMemory${t}Repository', () => {
|
|
|
1672
1672
|
expect(found).toBeNull()
|
|
1673
1673
|
})
|
|
1674
1674
|
})
|
|
1675
|
-
`}function
|
|
1675
|
+
`}function En(e){let{pascal:t,kebab:n}=e;return`import { Service, Inject, HttpException } from '@forinda/kickjs'
|
|
1676
1676
|
import type { ParsedQuery } from '@forinda/kickjs'
|
|
1677
1677
|
import { ${t.toUpperCase()}_REPOSITORY, type I${t}Repository } from './${n}.repository'
|
|
1678
1678
|
import type { ${t}ResponseDTO } from './dtos/${n}-response.dto'
|
|
@@ -1709,14 +1709,14 @@ export class ${t}Service {
|
|
|
1709
1709
|
await this.repo.delete(id)
|
|
1710
1710
|
}
|
|
1711
1711
|
}
|
|
1712
|
-
`}function
|
|
1712
|
+
`}function Dn(e){let{pascal:t}=e;return`import type { QueryFieldConfig } from '@forinda/kickjs'
|
|
1713
1713
|
|
|
1714
1714
|
export const ${t.toUpperCase()}_QUERY_CONFIG: QueryFieldConfig = {
|
|
1715
1715
|
filterable: ['name'],
|
|
1716
1716
|
sortable: ['name', 'createdAt'],
|
|
1717
1717
|
searchable: ['name'],
|
|
1718
1718
|
}
|
|
1719
|
-
`}async function
|
|
1719
|
+
`}async function On(e){let{pascal:t,kebab:n,plural:r,style:i,write:a}=e;await a(`${n}.module.ts`,gn({pascal:t,kebab:n,plural:r,style:i})),await a(`${n}.controller.ts`,`import { Controller, Get, type Ctx } from '@forinda/kickjs'
|
|
1720
1720
|
|
|
1721
1721
|
// \`Ctx<KickRoutes.${t}Controller['<method>']>\` is generated by
|
|
1722
1722
|
// \`kick typegen\` (auto-run on \`kick dev\`).
|
|
@@ -1728,7 +1728,7 @@ export class ${t}Controller {
|
|
|
1728
1728
|
ctx.json({ message: '${t} list' })
|
|
1729
1729
|
}
|
|
1730
1730
|
}
|
|
1731
|
-
`)}async function
|
|
1731
|
+
`)}async function kn(e){let{pascal:t,kebab:n,plural:r,pluralPascal:i,repo:a,noTests:o,tokenScope:s,style:c,write:l}=e;await l(`${n}.module.ts`,hn({pascal:t,kebab:n,plural:r,repo:a,style:c})),await l(`${n}.constants.ts`,Dn({pascal:t,kebab:n})),await l(`${n}.controller.ts`,_n({pascal:t,kebab:n,plural:r,pluralPascal:i})),await l(`${n}.service.ts`,En({pascal:t,kebab:n})),await l(`dtos/create-${n}.dto.ts`,vn({pascal:t,kebab:n})),await l(`dtos/update-${n}.dto.ts`,yn({pascal:t,kebab:n})),await l(`dtos/${n}-response.dto.ts`,bn({pascal:t,kebab:n})),await l(`${n}.repository.ts`,xn({pascal:t,kebab:n,dtoPrefix:`./dtos`,tokenScope:s}));let u=a===`inmemory`,d=u?`in-memory-${n}`:`${R(a)}-${n}`,f=u?Sn({pascal:t,kebab:n,repoPrefix:`.`,dtoPrefix:`./dtos`}):Cn({pascal:t,kebab:n,repoType:a,repoPrefix:`.`,dtoPrefix:`./dtos`});await l(`${d}.repository.ts`,f),o||(a!==`inmemory`&&await l(`in-memory-${n}.repository.ts`,Sn({pascal:t,kebab:n,repoPrefix:`.`,dtoPrefix:`./dtos`})),await l(`__tests__/${n}.controller.test.ts`,wn({pascal:t,kebab:n,plural:r})),await l(`__tests__/${n}.repository.test.ts`,Tn({pascal:t,kebab:n,plural:r,repoPrefix:`../in-memory-${n}.repository`})))}function An(e){return e?typeof e==`string`?e:e.name:`inmemory`}async function jn(e){let{name:t,modulesDir:n,noEntity:r,noTests:i,repo:a=`inmemory`,force:o,dryRun:s}=e,c=e.pluralize!==!1,l=e.pattern??`rest`;e.minimal&&(l=`minimal`);let u=R(t),d=I(t),f=c?Kt(u):u,p=c?qt(d):d,m=h(n,f),g=[],_=o??!1,v={kebab:u,pascal:d,plural:f,pluralPascal:p,moduleDir:m,repo:a,noEntity:r??!1,noTests:i??!1,prismaClientPath:e.prismaClientPath??`@prisma/client`,tokenScope:e.tokenScope??`app`,style:e.style??`define`,write:async(e,t)=>{let n=h(m,e);if(s){g.push(n);return}if(!_&&await Ke(n)&&!await P({message:`File exists: ${D.dim(e)}. Overwrite?`,initialValue:!1})){F.warn(`Skipped: ${e}`);return}await M(n,t),g.push(n)},files:g};switch(l){case`minimal`:await On(v);break;default:await kn(v);break}return s||await Mn(n,d,f,u,v.style),g}async function Mn(e,t,n,r,i=`define`){let a=h(e,`index.ts`),o=await Ke(a),s=`./${n}/${r}.module`,c=i===`class`?`${t}Module`:`${t}Module()`;if(!o){await M(a,i===`class`?`import type { AppModuleEntry } from '@forinda/kickjs'
|
|
1732
1732
|
import { ${t}Module } from '${s}'
|
|
1733
1733
|
|
|
1734
1734
|
export const modules: AppModuleEntry[] = [${c}]
|
|
@@ -1736,11 +1736,11 @@ export const modules: AppModuleEntry[] = [${c}]
|
|
|
1736
1736
|
import { ${t}Module } from '${s}'
|
|
1737
1737
|
|
|
1738
1738
|
export const modules = defineModules().mount(${c})
|
|
1739
|
-
`);return}let l=await
|
|
1739
|
+
`);return}let l=await C(a,`utf-8`),u=`import { ${t}Module } from '${s}'`,d=z(s);if(!RegExp(`^import\\s*\\{[^}]*\\b${z(t)}Module\\b[^}]*\\}\\s*from\\s*['"]${d}['"]`,`m`).test(l)){let e=l.lastIndexOf(`import `);if(e!==-1){let t=l.indexOf(`
|
|
1740
1740
|
`,e);l=l.slice(0,t+1)+u+`
|
|
1741
1741
|
`+l.slice(t+1)}else l=u+`
|
|
1742
|
-
`+l}let f=
|
|
1743
|
-
`;)t++;return t}if(n===`/*`){for(t+=2;t+1<e.length&&!(e[t]===`*`&&e[t+1]===`/`);)t++;return t+2}return t}function
|
|
1742
|
+
`+l}let f=Pn(l);if(f){let e=l.slice(f.rhsStart,f.rhsEnd+1);RegExp(`\\b${z(t)}Module\\b`).test(e)||(l=Nn(l,c))}else l=Nn(l,c);await w(a,l,`utf-8`)}function Nn(e,t){let n=Pn(e);if(!n)return e;if(n.shape===`array`){let r=e.slice(n.rhsStart+1,n.rhsEnd),i=r.trim(),a;if(!i)a=`[${t}]`;else{let e=i.endsWith(`,`)?``:`,`;a=`[${r.trimEnd()}${e} ${t}]`}return e.slice(0,n.rhsStart)+a+e.slice(n.rhsEnd+1)}return`${e.slice(0,n.chainEnd)}\n .mount(${t})${e.slice(n.chainEnd)}`}function Pn(e){let t=/export\s+const\s+modules\b[^=]*=/.exec(e);if(!t)return null;let n=t.index+t[0].length;for(;n<e.length&&/\s/.test(e[n]??``);)n++;if(e[n]===`[`){let t=Ln(e,n);return t===-1?null:{shape:`array`,rhsStart:n,rhsEnd:t}}if(e.slice(n,n+13)===`defineModules`){let t=Fn(e,n);return t===-1?null:{shape:`chain`,rhsStart:n,rhsEnd:t-1,chainEnd:t}}return null}function Fn(e,t=0){let n=/defineModules\s*\(/g;n.lastIndex=t;let r=n.exec(e);if(!r)return-1;let i=r.index+r[0].length-1;if(e[i]!==`(`||(i=Rn(e,i),i===-1))return-1;for(i++;;){let t=i;for(;t<e.length&&/\s/.test(e[t]??``);)t++;if(e[t]!==`.`||e.slice(t,t+6)!==`.mount`)break;for(t+=6;t<e.length&&/\s/.test(e[t]??``);)t++;if(e[t]!==`(`)break;let n=Rn(e,t);if(n===-1)break;i=n+1}return i}function In(e,t){let n=e.slice(t,t+2);if(n===`//`){for(t+=2;t<e.length&&e[t]!==`
|
|
1743
|
+
`;)t++;return t}if(n===`/*`){for(t+=2;t+1<e.length&&!(e[t]===`*`&&e[t+1]===`/`);)t++;return t+2}return t}function Ln(e,t){if(e[t]!==`[`)return-1;let n=1,r=t+1;for(;r<e.length;){let t=e.slice(r,r+2);if(t===`//`||t===`/*`){r=In(e,r);continue}let i=e[r]??``;if(i===`'`||i===`"`||i==="`"){let t=i;for(r++;r<e.length&&e[r]!==t;)e[r]===`\\`&&r++,r++;r<e.length&&r++;continue}if(i===`[`)n++;else if(i===`]`&&(n--,n===0))return r;r++}return-1}function Rn(e,t){if(e[t]!==`(`)return-1;let n=1,r=t+1;for(;r<e.length;){let t=e.slice(r,r+2);if(t===`//`||t===`/*`){r=In(e,r);continue}let i=e[r]??``;if(i===`'`||i===`"`||i==="`"){let t=i;for(r++;r<e.length&&e[r]!==t;)e[r]===`\\`&&r++,r++;r<e.length&&r++;continue}if(i===`(`)n++;else if(i===`)`&&(n--,n===0))return r;r++}return-1}async function zn(e){let{name:t,outDir:n}=e,r=R(t),i=I(t),a=[],o=h(n,`${r}.adapter.ts`);return await M(o,`import {
|
|
1744
1744
|
defineAdapter,
|
|
1745
1745
|
type AdapterContext,
|
|
1746
1746
|
type AdapterMiddleware,
|
|
@@ -1909,7 +1909,7 @@ export const ${i}Adapter = defineAdapter<${i}AdapterConfig>({
|
|
|
1909
1909
|
}
|
|
1910
1910
|
},
|
|
1911
1911
|
})
|
|
1912
|
-
`),a.push(o),a}async function
|
|
1912
|
+
`),a.push(o),a}async function Bn(e){let{name:t,outDir:n}=e,r=R(t),i=I(t),a=[],o=h(n,`${r}.plugin.ts`);return await M(o,`import {
|
|
1913
1913
|
definePlugin,
|
|
1914
1914
|
type AppAdapter,
|
|
1915
1915
|
type AppModuleEntry,
|
|
@@ -2053,9 +2053,9 @@ export const ${i}Plugin = definePlugin<${i}PluginConfig>({
|
|
|
2053
2053
|
},
|
|
2054
2054
|
}),
|
|
2055
2055
|
})
|
|
2056
|
-
`),a.push(o),a}const
|
|
2056
|
+
`),a.push(o),a}const Vn={controller:``,service:``,dto:`dtos`,guard:`guards`,middleware:`middleware`,contributor:`contributors`};function B(e){let{type:t,outDir:n,moduleName:r,modulesDir:i=`src/modules`,defaultDir:a,shouldPluralize:o=!0}=e;if(n)return v(n);if(r){let e=Vn,n=R(r),a=o?Kt(n):n,s=e[t]??``,c=h(i,a);return v(s?h(c,s):c)}return v(a)}async function Hn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=B({type:`middleware`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/middleware`,pattern:i,shouldPluralize:e.pluralize??!0}),o=R(t),s=L(t),c=[],l=h(a,`${o}.middleware.ts`);return await M(l,`import type { Request, Response, NextFunction } from 'express'
|
|
2057
2057
|
|
|
2058
|
-
export interface ${
|
|
2058
|
+
export interface ${I(t)}Options {
|
|
2059
2059
|
// Add configuration options here. The factory below closes over the
|
|
2060
2060
|
// resolved options object; pass them at the call site —
|
|
2061
2061
|
// \`${s}({ foo: 'bar' })\` — and the closure preserves them across
|
|
@@ -2063,7 +2063,7 @@ export interface ${R(t)}Options {
|
|
|
2063
2063
|
}
|
|
2064
2064
|
|
|
2065
2065
|
/**
|
|
2066
|
-
* ${
|
|
2066
|
+
* ${I(t)} middleware.
|
|
2067
2067
|
*
|
|
2068
2068
|
* Usage in bootstrap (fires on every request):
|
|
2069
2069
|
* middleware: [${s}()]
|
|
@@ -2095,7 +2095,7 @@ export interface ${R(t)}Options {
|
|
|
2095
2095
|
* Usage with @Middleware decorator:
|
|
2096
2096
|
* @Middleware(${s}())
|
|
2097
2097
|
*/
|
|
2098
|
-
export function ${s}(options: ${
|
|
2098
|
+
export function ${s}(options: ${I(t)}Options = {}) {
|
|
2099
2099
|
return (req: Request, res: Response, next: NextFunction) => {
|
|
2100
2100
|
// Implement your middleware logic here. \`options\` is captured by
|
|
2101
2101
|
// closure — log or read it anywhere in this handler body.
|
|
@@ -2103,7 +2103,7 @@ export function ${s}(options: ${R(t)}Options = {}) {
|
|
|
2103
2103
|
next()
|
|
2104
2104
|
}
|
|
2105
2105
|
}
|
|
2106
|
-
`),c.push(l),c}async function
|
|
2106
|
+
`),c.push(l),c}async function Un(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=B({type:`guard`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/guards`,pattern:i,shouldPluralize:e.pluralize??!0}),o=R(t),s=L(t),c=I(t),l=[],u=h(a,`${o}.guard.ts`);return await M(u,`import { Container, HttpException } from '@forinda/kickjs'
|
|
2107
2107
|
import type { RequestContext } from '@forinda/kickjs'
|
|
2108
2108
|
|
|
2109
2109
|
/**
|
|
@@ -2139,8 +2139,8 @@ export async function ${s}Guard(ctx: RequestContext, next: () => void): Promise<
|
|
|
2139
2139
|
ctx.res.status(401).json({ message: 'Invalid or expired token' })
|
|
2140
2140
|
}
|
|
2141
2141
|
}
|
|
2142
|
-
`),l.push(u),l}function
|
|
2143
|
-
`)}\n}\n`:``,m=l.length>0?`${d}.withParams<${s}Params>()({`:`${d}({`,g=l.map(e=>({name:e.name,def:
|
|
2142
|
+
`),l.push(u),l}function Wn(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):[]}function Gn(e){switch(e){case`string`:return`''`;case`number`:return`0`;case`boolean`:return`false`;default:return null}}async function Kn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=e.type??`http`,o=R(t),s=I(t),c=e.key??L(t),l=Array.isArray(e.params)?e.params:Wn(e.params),u=B({type:`contributor`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/contributors`,pattern:i,shouldPluralize:e.pluralize??!0}),d=a===`http`?`defineHttpContextDecorator`:`defineContextDecorator`,f=a===`http`?`RequestContext`:`ExecutionContext`,p=l.length>0?`\nexport type ${s}Params = {\n${l.map(e=>` ${e.name}: ${e.type}`).join(`
|
|
2143
|
+
`)}\n}\n`:``,m=l.length>0?`${d}.withParams<${s}Params>()({`:`${d}({`,g=l.map(e=>({name:e.name,def:Gn(e.type)})).filter(e=>e.def!==null).map(e=>` ${e.name}: ${e.def},`),_=l.length>0?` paramDefaults: {\n${g.join(`
|
|
2144
2144
|
`)}\n },\n`:``,v=l.length>0?`(ctx, _deps, params)`:`(ctx)`,y=l.length>0?` // \`params\` is typed as ${s}Params (call-site overrides merged onto paramDefaults).`:` // \`ctx\` is a ${f} — read ctx.req / ctx.headers / ctx.params (http) or ctx.get (bare).`,b=`import { ${d} } from '@forinda/kickjs'
|
|
2145
2145
|
import type { ${f} } from '@forinda/kickjs'
|
|
2146
2146
|
|
|
@@ -2179,7 +2179,7 @@ ${y}
|
|
|
2179
2179
|
throw new Error("${s} contributor: resolve() not implemented")
|
|
2180
2180
|
},
|
|
2181
2181
|
})
|
|
2182
|
-
`,x=h(u,`${o}.contributor.ts`);return await
|
|
2182
|
+
`,x=h(u,`${o}.contributor.ts`);return await M(x,b),[x]}async function qn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=B({type:`service`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/services`,pattern:i,shouldPluralize:e.pluralize??!0}),o=R(t),s=I(t),c=[],l=h(a,`${o}.service.ts`);return await M(l,`import { Service } from '@forinda/kickjs'
|
|
2183
2183
|
|
|
2184
2184
|
@Service()
|
|
2185
2185
|
export class ${s}Service {
|
|
@@ -2188,7 +2188,7 @@ export class ${s}Service {
|
|
|
2188
2188
|
// @Inject(MY_REPO) private readonly repo: IMyRepository,
|
|
2189
2189
|
// ) {}
|
|
2190
2190
|
}
|
|
2191
|
-
`),c.push(l),c}async function
|
|
2191
|
+
`),c.push(l),c}async function Jn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=B({type:`controller`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/controllers`,pattern:i,shouldPluralize:e.pluralize??!0}),o=R(t),s=I(t),c=[],l=h(a,`${o}.controller.ts`);return await M(l,`import { Controller, Get, Post, type Ctx } from '@forinda/kickjs'
|
|
2192
2192
|
|
|
2193
2193
|
// \`Ctx<KickRoutes.${s}Controller['<method>']>\` is generated by
|
|
2194
2194
|
// \`kick typegen\` (auto-run on \`kick dev\`). After the first run, your IDE
|
|
@@ -2209,7 +2209,7 @@ export class ${s}Controller {
|
|
|
2209
2209
|
ctx.created({ message: '${s} created', data: ctx.body })
|
|
2210
2210
|
}
|
|
2211
2211
|
}
|
|
2212
|
-
`),c.push(l),c}async function
|
|
2212
|
+
`),c.push(l),c}async function Yn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=B({type:`dto`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/dtos`,pattern:i,shouldPluralize:e.pluralize??!0}),o=R(t),s=I(t),c=L(t),l=[],u=h(a,`${o}.dto.ts`);return await M(u,`import { z } from 'zod'
|
|
2213
2213
|
|
|
2214
2214
|
export const ${c}Schema = z.object({
|
|
2215
2215
|
// Define your schema fields here
|
|
@@ -2217,8 +2217,8 @@ export const ${c}Schema = z.object({
|
|
|
2217
2217
|
})
|
|
2218
2218
|
|
|
2219
2219
|
export type ${s}DTO = z.infer<typeof ${c}Schema>
|
|
2220
|
-
`),l.push(u),l}async function
|
|
2221
|
-
Skipped — existing kick.config.ts preserved.`),[]):(await
|
|
2220
|
+
`),l.push(u),l}async function Xn(e){let t=h(e.outDir,`kick.config.ts`),n=e.modulesDir??`src/modules`,i=e.defaultRepo??`inmemory`;return r(t)&&!e.force&&!await P({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
|
|
2221
|
+
Skipped — existing kick.config.ts preserved.`),[]):(await M(t,`import { defineConfig } from '@forinda/kickjs-cli'
|
|
2222
2222
|
|
|
2223
2223
|
export default defineConfig({
|
|
2224
2224
|
modules: {
|
|
@@ -2255,18 +2255,18 @@ export default defineConfig({
|
|
|
2255
2255
|
},
|
|
2256
2256
|
],
|
|
2257
2257
|
})
|
|
2258
|
-
`),[t])}var
|
|
2258
|
+
`),[t])}var Zn=O({generateAgentDocs:()=>rr});const Qn=`.agents`,$n=new Set([`rest`,`minimal`]);function er(e,t){if(t)return t;try{let t=JSON.parse(a(h(e,`package.json`),`utf-8`));if(t.name)return t.name.replace(/^@[^/]+\//,``)}catch{}return e.split(`/`).findLast(Boolean)??`app`}function tr(e,t){if(t)return t;try{let t=JSON.parse(a(h(e,`package.json`),`utf-8`));if(t.packageManager)return t.packageManager.split(`@`)[0]}catch{}return`pnpm`}async function nr(e,t){if(t)return t;try{let t=(await A(e))?.pattern;if(t&&$n.has(t))return t}catch{}return`rest`}async function rr(e){let t=e.only??`all`,n=er(e.outDir,e.name),i=tr(e.outDir,e.pm),a=await nr(e.outDir,e.template),o=t===`agents`||t===`both`||t===`all`,s=t===`claude`||t===`both`||t===`all`,c=t===`skills`||t===`all`,l=t===`gemini`||t===`all`,u=t===`copilot`||t===`all`,d=[];if(o&&d.push({file:h(e.outDir,Qn,`AGENTS.md`),render:()=>ht(n,a,i)}),s&&d.push({file:h(e.outDir,`CLAUDE.md`),render:()=>mt(n,a,i)}),c)for(let t of gt(n,a,i))d.push({file:h(e.outDir,Qn,`skills`,t.slug,`SKILL.md`),render:()=>t.content});l&&d.push({file:h(e.outDir,Qn,`GEMINI.md`),render:()=>_t(n,a,i)}),u&&d.push({file:h(e.outDir,Qn,`COPILOT.md`),render:()=>vt(n,a,i)});let f=[];for(let{file:t,render:n}of d){if(r(t)&&!e.force&&!await P({message:`${t.replace(e.outDir+`/`,``)} already exists. Overwrite?`,initialValue:!1})){console.log(` Skipped — existing ${t.replace(e.outDir+`/`,``)} preserved.`);continue}await M(t,n()),f.push(t)}return f}function ir(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 ar(e,t){let n=t.exec(e);if(!n)return null;let r=n.index+n[0].length-1,i=ir(e,r);return i===-1?null:e.slice(r+1,i)}function or(e,t,n){let r=` `.repeat(n);return e.split(`
|
|
2259
2259
|
`).map(e=>{if(e.trim()===``)return e;let n=RegExp(`^ {0,${t}}`);return r+e.replace(n,``)}).join(`
|
|
2260
|
-
`)}function
|
|
2260
|
+
`)}function sr(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 cr(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 lr(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=ir(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=ar(o,/register\s*\(([^)]*)\)\s*:\s*void\s*\{/),u=ar(o,/contributors\s*\(\s*\)\s*:\s*ContributorRegistrations\s*\{/),d=ar(o,/routes\s*\(\s*\)\s*:\s*[A-Za-z|[\]\s]+\{/);if(!d)return{migrated:null,reason:`routes() method missing or signature unrecognized`};let f=sr(s),p=``;return l&&(p+=` register(container) {${or(l,4,6)} },\n\n`),u&&(p+=` contributors() {${or(u,4,6)} },\n\n`),p+=` routes() {${or(d,4,6)} },`,{migrated:`${f}${`export const ${r} = defineModule({
|
|
2261
2261
|
name: '${r}',
|
|
2262
2262
|
build: () => ({
|
|
2263
2263
|
${p}
|
|
2264
2264
|
}),
|
|
2265
|
-
})`}${c}`}}function
|
|
2266
|
-
`||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
|
|
2265
|
+
})`}${c}`}}function ur(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=ir(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]===`
|
|
2266
|
+
`||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=ir(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=ar(m,/register\s*\(([^)]*)\)\s*\{/),g=ar(m,/contributors\s*\(\s*\)\s*\{/),_=ar(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let v=cr(c,{container:h!==null,appModule:!0,moduleRoutes:!0,contributorRegistrations:g!==null}),y=``;return h!==null&&(y+=` register(container: Container): void {${or(h,6,4)} }\n\n`),g!==null&&(y+=` contributors(): ContributorRegistrations {${or(g,6,4)} }\n\n`),y+=` routes(): ModuleRoutes {${or(_,6,4)} }`,{migrated:`${v}${`export class ${r} implements AppModule {
|
|
2267
2267
|
${y}
|
|
2268
2268
|
}
|
|
2269
|
-
`}${u}`}}function
|
|
2269
|
+
`}${u}`}}function dr(e,t){return t===`class`?ur(e):lr(e)}function fr(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 pr(e){let t=[];return await n(v(e),0),t;async function n(e,r){let i;try{i=await se(e)}catch{return}for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=h(e,a),o;try{o=await le(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function mr(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await se(e)}catch{return}await oe(t,{recursive:!0});for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=h(e,a),o=h(t,a),s;try{s=await le(i)}catch{continue}s.isDirectory()?await r(i,o):(await ae(i,o),n++)}}}function hr(e){return h(e,`.kickjs`,`codemod-backups`,`${new Date().toISOString().replaceAll(/[:.]/g,`-`)}-modules`)}async function gr(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await pr(e),s=await C(h(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=hr(r),await mr(e,c));let l=[];for(let e of o){let t=dr(await C(e,`utf-8`),i);if(t.migrated==null){l.push({path:e,status:`skipped`,reason:t.reason});continue}n||await w(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`})}let u=h(e,`index.ts`),d=null;try{d=await C(u,`utf-8`)}catch{return{target:i,files:l,indexStatus:`not-found`,indexPath:u,backupDir:c}}let f=fr(d,i);return f.migrated==null?{target:i,files:l,indexStatus:`skipped`,indexPath:u,indexReason:f.reason,backupDir:c}:(n||await w(u,f.migrated,`utf-8`),{target:i,files:l,indexStatus:`migrated`,indexPath:u,backupDir:c})}async function _r(e,t){let n=await pr(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 C(e,`utf-8`);i.test(t)&&r.push(e)}return r}async function vr(e){let{name:t,outDir:n}=e,r=I(t),i=R(t),a=L(t),o=e.queue??`${i}-queue`,s=[];return await(async(e,t)=>{let r=h(n,e);await M(r,t),s.push(r)})(`${i}.job.ts`,`import { Inject } from '@forinda/kickjs'
|
|
2270
2270
|
import { Job, Process, QUEUE_MANAGER, type QueueService } from '@forinda/kickjs-queue'
|
|
2271
2271
|
|
|
2272
2272
|
/**
|
|
@@ -2299,7 +2299,7 @@ export class ${r}Job {
|
|
|
2299
2299
|
// Handle high-priority variant of this job
|
|
2300
2300
|
}
|
|
2301
2301
|
}
|
|
2302
|
-
`),s}const
|
|
2302
|
+
`),s}const yr={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 br(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=yr[a];if(!o){let e=[...Object.keys(yr),`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 xr(e){let{name:t,fields:n,modulesDir:r,repo:i=`inmemory`,tokenScope:a=`app`,style:o=`define`}=e,s=e.pluralize!==!1,c=R(t),l=I(t),u=s?Kt(c):c,d=s?qt(l):l,f=h(r,u),p=[],m=async(e,t)=>{let n=h(f,e);await M(n,t),p.push(n)};await m(`${c}.module.ts`,hn({pascal:l,kebab:c,plural:u,repo:i,style:o})),await m(`${c}.constants.ts`,Dn({pascal:l,kebab:c})),await m(`${c}.controller.ts`,_n({pascal:l,kebab:c,plural:u,pluralPascal:d})),await m(`${c}.service.ts`,En({pascal:l,kebab:c})),await m(`dtos/create-${c}.dto.ts`,Sr(l,n)),await m(`dtos/update-${c}.dto.ts`,Cr(l,n)),await m(`dtos/${c}-response.dto.ts`,wr(l,n)),await m(`${c}.repository.ts`,xn({pascal:l,kebab:c,dtoPrefix:`./dtos`,tokenScope:a}));let g=i===`inmemory`,_=g?`in-memory-${c}`:`${R(i)}-${c}`,v=g?Sn({pascal:l,kebab:c,repoPrefix:`.`,dtoPrefix:`./dtos`}):Cn({pascal:l,kebab:c,repoType:i,repoPrefix:`.`,dtoPrefix:`./dtos`});return await m(`${_}.repository.ts`,v),await Mn(r,l,u,c,o),p}function Sr(e,t){return`import { z } from 'zod'
|
|
2303
2303
|
|
|
2304
2304
|
export const create${e}Schema = z.object({
|
|
2305
2305
|
${t.map(e=>{let t=e.zodType;return` ${e.name}: ${t}${e.optional?`.optional()`:``},`}).join(`
|
|
@@ -2307,7 +2307,7 @@ ${t.map(e=>{let t=e.zodType;return` ${e.name}: ${t}${e.optional?`.optional()`:`
|
|
|
2307
2307
|
})
|
|
2308
2308
|
|
|
2309
2309
|
export type Create${e}DTO = z.infer<typeof create${e}Schema>
|
|
2310
|
-
`}function
|
|
2310
|
+
`}function Cr(e,t){return`import { z } from 'zod'
|
|
2311
2311
|
|
|
2312
2312
|
export const update${e}Schema = z.object({
|
|
2313
2313
|
${t.map(e=>` ${e.name}: ${e.zodType}.optional(),`).join(`
|
|
@@ -2315,14 +2315,14 @@ ${t.map(e=>` ${e.name}: ${e.zodType}.optional(),`).join(`
|
|
|
2315
2315
|
})
|
|
2316
2316
|
|
|
2317
2317
|
export type Update${e}DTO = z.infer<typeof update${e}Schema>
|
|
2318
|
-
`}function
|
|
2318
|
+
`}function wr(e,t){return`export interface ${e}ResponseDTO {
|
|
2319
2319
|
id: string
|
|
2320
2320
|
${t.map(e=>` ${e.name}${e.optional?`?`:``}: ${e.tsType}`).join(`
|
|
2321
2321
|
`)}
|
|
2322
2322
|
createdAt: string
|
|
2323
2323
|
updatedAt: string
|
|
2324
2324
|
}
|
|
2325
|
-
`}async function
|
|
2325
|
+
`}async function Tr(e){let{name:t,moduleName:n,modulesDir:r}=e,i=e.pluralize??!0,a=R(t),o=I(t),s=[],c;if(e.outDir)c=v(e.outDir);else if(n){let e=R(n),t=i?Kt(e):e;c=v(h(r??`src/modules`,t,`__tests__`))}else c=v(`src/__tests__`);let l=h(c,`${a}.test.ts`);return await M(l,`import { describe, it, expect, beforeEach } from 'vitest'
|
|
2326
2326
|
import { Container } from '@forinda/kickjs'
|
|
2327
2327
|
|
|
2328
2328
|
describe('${o}', () => {
|
|
@@ -2345,9 +2345,9 @@ describe('${o}', () => {
|
|
|
2345
2345
|
expect(true).toBe(true)
|
|
2346
2346
|
})
|
|
2347
2347
|
})
|
|
2348
|
-
`),s.push(l),s}const yr=[`classes`,`tokens`,`injects`,`pluginsAndAdapters`,`augmentations`,`contextKeys`,`routes`,`moduleMounts`,`globPatterns`];function br(e){if(!e||typeof e!=`object`)return!1;let t=e;return yr.every(e=>Array.isArray(t[e]))}var xr=class e{path;prev;next=new Map;nextSig=new Map;constructor(e,t){this.path=e,this.prev=t}static async load(t){let n=h(t,`scan.json`),r=new Map;try{let e=await T(n,`utf-8`),t=JSON.parse(e);if(t.version===1&&t.files)for(let[e,n]of Object.entries(t.files))n&&typeof n.sig==`string`&&br(n.extract)&&r.set(e,n)}catch{}return new e(n,r)}static async signature(e){try{let t=await se(e);return`${t.mtimeMs}:${t.size}`}catch{return null}}get(e,t){let n=this.prev.get(e);return n&&n.sig===t?n.extract:null}set(e,t,n){this.next.set(e,n),this.nextSig.set(e,t)}cachedFiles(){return[...this.prev.keys()]}peek(e){return this.prev.get(e)?.extract??null}carry(e){let t=this.prev.get(e);return t?(this.next.set(e,t.extract),this.nextSig.set(e,t.sig),!0):!1}async save(){let e={};for(let[t,n]of this.next){let r=this.nextSig.get(t);r&&(e[t]={sig:r,extract:n})}let t={version:1,files:e};try{await w(f(this.path),{recursive:!0}),await E(this.path,JSON.stringify(t),`utf-8`)}catch{}}};const Sr=[`Service`,`Controller`,`Repository`,`Injectable`,`Component`,`Module`],Cr=[`.ts`,`.tsx`,`.mts`,`.cts`],wr=[`node_modules`,`.kickjs`,`dist`,`build`,`.test.`,`.spec.`,`.d.ts`],Tr=new RegExp(String.raw`@(${Sr.join(`|`)})\s*\([^)]*\)`+String.raw`(?:\s*@[A-Z]\w*(?:\s*\([^)]*\))?)*`+String.raw`\s*export\s+(default\s+)?(?:abstract\s+)?class\s+(\w+)`,`g`),Er=new RegExp(String.raw`export\s+(default\s+)?(?:abstract\s+)?class\s+(\w+)`+String.raw`(?:\s+extends\s+\w+(?:<[^>]*>)?)?`+String.raw`\s+implements\s+[^{]*\bAppModule\b`,`g`),Dr=/export\s+const\s+(\w+)\s*(?::\s*[^=]+)?=\s*defineModule\s*(?:<[^>]*>)?\s*\(/g,Or=/(?:export\s+)?const\s+(\w+)\s*(?::\s*[^=]+)?=\s*createToken\s*(?:<[^>]*>)?\s*\(\s*['"`]([^'"`]+)['"`]\s*\)/g,kr=/createToken\s*(?:<[^>]*>)?\s*\(\s*['"`]([^'"`]+)['"`]\s*\)/g,Ar=/@Inject\s*\(\s*['"`]([^'"`]+)['"`]\s*\)/g,jr=/\b(defineAdapter|definePlugin)\s*(?:<[^>]*>)?\s*\(/g,Mr=/\b(?:defineContextDecorator|defineHttpContextDecorator)\s*(?:\.withParams\s*<(?:[^<>]|<[^<>]*>)*>\s*\(\s*\))?\s*(?:<(?:[^<>]|<[^<>]*>)*>)?\s*\(/g,Nr=new RegExp(String.raw`export\s+(?:default\s+)?(?:abstract\s+)?class\s+(\w+)`+String.raw`(?:\s+extends\s+\w+(?:<[^>]*>)?)?`+String.raw`\s+implements\s+[^{]*\bAppAdapter\b`,`g`),Pr=/\bname\s*(?::\s*[^=]+)?=\s*['"`]([^'"`]+)['"`]/,Fr=/\bdefineAugmentation\s*\(\s*['"`]([^'"`]+)['"`]\s*(,\s*\{)?/g,Ir=new RegExp(String.raw`@(${[`Get`,`Post`,`Put`,`Delete`,`Patch`].join(`|`)})\s*\(`,`g`);function Lr(e,t){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 Rr(e,t){let n=t;for(;n<e.length;){for(;n<e.length&&/\s/.test(e[n]);)n++;if(e[n]!==`@`)break;let t=e.slice(n).match(/^@([A-Z]\w*)/);if(!t)break;for(n+=t[0].length;n<e.length&&/\s/.test(e[n]);)n++;if(e[n]===`(`){let t=Lr(e,n);if(t<0)return null;n=t+1}}for(;n<e.length&&/\s/.test(e[n]);)n++;for(let t of[`public`,`private`,`protected`])if(e.slice(n,n+t.length)===t&&/\s/.test(e.charAt(n+t.length))){for(n+=t.length;n<e.length&&/\s/.test(e[n]);)n++;break}if(e.slice(n,n+5)===`async`&&/\s/.test(e.charAt(n+5)))for(n+=5;n<e.length&&/\s/.test(e[n]);)n++;let r=e.slice(n).match(/^([a-zA-Z_]\w*)\s*\(/);return r?{methodName:r[1],endPos:n+r[0].length}:null}function zr(e){return(e.match(/:([a-zA-Z_]\w*)/g)??[]).map(e=>e.slice(1))}function Br(e,t){let n=e.endsWith(`/`)?e.slice(0,-1):e;return!t||t===`/`?n||`/`:n+(t.startsWith(`/`)?t:`/`+t)||`/`}const Vr=/\b(?:public\s+|private\s+|protected\s+)?routes\s*\([^)]*\)\s*(?::\s*[A-Za-z_][\w<>[\]\s,|]*\s*)?\{/g,Hr=/\bpath\s*:\s*['"`]([^'"`]*)['"`]/g,Ur=/\bcontroller\s*:\s*([A-Z]\w*)\b/g,Wr=/\bimport\.meta\.glob\s*\(/g;function Gr(e){let t=[];for(Wr.lastIndex=0;Wr.exec(e)!==null;){let n=Wr.lastIndex-1,r=Lr(e,n);if(r<0)continue;let i=e.slice(n+1,r),a=/['"`]([^'"`]+)['"`]/g,o;for(;(o=a.exec(i))!==null;)t.push(o[1])}return t}function Kr(e){let t=e.replace(/[.+^$()|[\]\\]/g,`\\$&`).replace(/\?/g,`.`).replace(/\*\*\//g,`___DOUBLESTAR_SLASH___`).replace(/\*\*/g,`___DOUBLESTAR___`).replace(/\*/g,`[^/]*`).replace(/___DOUBLESTAR_SLASH___/g,`(?:.+/)?`).replace(/___DOUBLESTAR___/g,`.*`);return RegExp(`^`+t+`$`)}function qr(e,t){let n=e.startsWith(`./`)?e:`./`+e,r=!1;for(let e of t){let t=e.startsWith(`!`);Kr(t?e.slice(1):e).test(n)&&(r=!t)}return r}function Jr(e){let t=[];Vr.lastIndex=0;let n;for(;(n=Vr.exec(e))!==null;){let r=e.indexOf(`{`,n.index+n[0].length-1);if(r<0)continue;let i=oi(e,r);if(i<0)continue;let a=e.slice(r+1,i),o=[];Hr.lastIndex=0;let s;for(;(s=Hr.exec(a))!==null;)o.push(s[1]??``);let c=[];Ur.lastIndex=0;let l;for(;(l=Ur.exec(a))!==null;)c.push(l[1]);let u=Math.min(o.length,c.length);for(let e=0;e<u;e++)t.push({controller:c[e],mountPath:o[e]})}return t}function Yr(e,t){let n=new RegExp(String.raw`\b${t}\s*:\s*([A-Za-z_$][\w$]*)`,`g`).exec(e);return n?n[1]:null}function Xr(e,t){let n=new RegExp(String.raw`import\s*(?:type\s+)?\{[^}]*\b${t}\b[^}]*\}\s*from\s*['"\`]([^'"\`]+)['"\`]`).exec(e);if(n)return n[1];let r=new RegExp(String.raw`import\s+(?:type\s+)?${t}\s+from\s*['"\`]([^'"\`]+)['"\`]`).exec(e);if(r)return r[1];let i=new RegExp(String.raw`import\s*\*\s*as\s+${t}\s+from\s*['"\`]([^'"\`]+)['"\`]`).exec(e);return i?i[1]:new RegExp(String.raw`(?:^|\n)\s*(?:export\s+)?const\s+${t}\b`).test(e)?``:null}function Zr(e,t){let n=/@ApiQueryParams\s*\(\s*([\s\S]*?)\s*\)\s*$/.exec(e);if(!n){let n=/@ApiQueryParams\s*\(([\s\S]*?)\)/.exec(e);return n?Qr(n[1].trim(),t):null}return Qr(n[1].trim(),t)}function Qr(e,t){if(e.startsWith(`{`))return ei(e);let n=/^([A-Za-z_]\w*)/.exec(e);if(n){let e=n[1],r=new RegExp(String.raw`const\s+${e}\s*(?::\s*[^=]+)?=\s*(\{[\s\S]*?\n\})`,`m`).exec(t);if(r)return ei(r[1])}return{filterable:[],sortable:[],searchable:[]}}function $r(e,t){let n=new RegExp(String.raw`${t}\s*:\s*\[([\s\S]*?)\]`).exec(e);return n?Array.from(n[1].matchAll(/['"`]([^'"`]+)['"`]/g)).map(e=>e[1]):[]}function ei(e){return{filterable:$r(e,`filterable`),sortable:$r(e,`sortable`),searchable:$r(e,`searchable`)}}async function ti(e,t){let n=t.extensions??Cr,r=t.exclude??wr,i=[],a;try{a=await ae(e,{withFileTypes:!0,encoding:`utf-8`})}catch{return i}for(let o of a){let a=h(e,o.name),s=_(t.cwd,a);r.some(e=>s.includes(e))||(o.isDirectory()?i.push(...await ti(a,t)):o.isFile()&&n.some(e=>o.name.endsWith(e))&&i.push(a))}return i}function K(e,t){return _(t,e).split(y).join(`/`)}function ni(e,t,n){let r=[],i=K(t,n);Tr.lastIndex=0;let a;for(;(a=Tr.exec(e))!==null;){let[,e,n,o]=a;r.push({className:o,decorator:e,filePath:t,relativePath:i,isDefault:!!n})}Er.lastIndex=0;let o;for(;(o=Er.exec(e))!==null;){let[,e,n]=o;r.some(e=>e.className===n&&e.filePath===t)||r.push({className:n,decorator:`Module`,filePath:t,relativePath:i,isDefault:!!e})}Dr.lastIndex=0;let s;for(;(s=Dr.exec(e))!==null;){let[,e]=s;r.some(n=>n.className===e&&n.filePath===t)||r.push({className:e,decorator:`Module`,filePath:t,relativePath:i,isDefault:!1})}return r}function ri(e,t,n){let r=[],i=K(t,n),a=new Set;Or.lastIndex=0;let o;for(;(o=Or.exec(e))!==null;){let[e,n,s]=o;a.add(e),r.push({name:s,variable:n,filePath:t,relativePath:i})}for(kr.lastIndex=0;(o=kr.exec(e))!==null;)a.has(o[0])||r.push({name:o[1],variable:null,filePath:t,relativePath:i});return r}function ii(e,t,n,r,i=new Map){let a=[];if(r.length===0)return a;let o=K(t,n),s=[];for(let t of r){let n=new RegExp(String.raw`class\s+${t.className}\b`).exec(e);n?.index!==void 0&&s.push({cls:t,start:n.index})}s.sort((e,t)=>e.start-t.start);for(let n=0;n<s.length;n++){let{cls:r,start:c}=s[n],l=n+1<s.length?s[n+1].start:e.length,u=e.slice(c,l);Ir.lastIndex=0;let d;for(;(d=Ir.exec(u))!==null;){let n=d[1],s=d.index,c=Ir.lastIndex-1,l=Lr(u,c);if(l<0)continue;let f=u.slice(c+1,l),p=f.match(/^\s*['"`]([^'"`]*)['"`]/),m=p&&p[1].length>0?p[1]:`/`,h=Rr(u,l+1);if(!h)continue;let{methodName:g,endPos:_}=h;Ir.lastIndex=_;let v=Zr(u.slice(s,_),e),y=Yr(f,`body`),b=Yr(f,`query`),x=Yr(f,`params`),S=i.get(r.className)??``,C=S?Br(S,m):m;a.push({controller:r.className,method:g,httpMethod:n.toUpperCase(),path:m,pathParams:zr(C),queryFilterable:v?.filterable??null,querySortable:v?.sortable??null,querySearchable:v?.searchable??null,bodySchema:y?{identifier:y,source:Xr(e,y)}:null,querySchema:b?{identifier:b,source:Xr(e,b)}:null,paramsSchema:x?{identifier:x,source:Xr(e,x)}:null,filePath:t,relativePath:o})}}return a}function ai(e,t,n){let r=[],i=K(t,n);Ar.lastIndex=0;let a;for(;(a=Ar.exec(e))!==null;)r.push({name:a[1],filePath:t,relativePath:i});return r}function oi(e,t){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 si(e,t,n){let r=[],i=K(t,n),a=new Set;jr.lastIndex=0;let o;for(;(o=jr.exec(e))!==null;){let n=o[1],s=jr.lastIndex-1,c=Lr(e,s);if(c<0)continue;let l=e.slice(s+1,c),u=/\bname\s*:\s*['"`]([^'"`]+)['"`]/.exec(l);if(!u)continue;let d=u[1],f=`${n}::${d}::${t}`;a.has(f)||(a.add(f),r.push({kind:n===`definePlugin`?`plugin`:`adapter`,name:d,filePath:t,relativePath:i}))}Nr.lastIndex=0;let s;for(;(s=Nr.exec(e))!==null;){let n=s.index,o=e.indexOf(`{`,n);if(o<0)continue;let c=oi(e,o);if(c<0)continue;let l=e.slice(o+1,c),u=Pr.exec(l);if(!u)continue;let d=u[1],f=`class::${d}::${t}`;a.has(f)||(a.add(f),r.push({kind:`adapter`,name:d,filePath:t,relativePath:i}))}return r}function ci(e,t,n){let r=[],i=K(t,n),a=new Set;for(Mr.lastIndex=0;Mr.exec(e)!==null;){let n=Mr.lastIndex-1,o=Lr(e,n);if(o<0)continue;let s=e.slice(n+1,o),c=/\bkey\s*:\s*['"`]([^'"`]+)['"`]/.exec(s);if(!c)continue;let l=c[1];a.has(l)||(a.add(l),r.push({key:l,filePath:t,relativePath:i}))}return r}function li(e,t,n){let r=[],i=K(t,n);Fr.lastIndex=0;let a;for(;(a=Fr.exec(e))!==null;){let n=a[1],o=null,s=null;if(a[2]){let t=e.indexOf(`{`,a.index+a[0].length-1);if(t>=0){let n=oi(e,t);if(n>=0){let r=e.slice(t+1,n);o=ui(r,`description`),s=ui(r,`example`)}}}r.push({name:n,description:o,example:s,filePath:t,relativePath:i})}return r}function ui(e,t){let n=RegExp(`\\b${t}\\s*:\\s*(['"\`])`,`g`).exec(e);if(!n)return null;let r=n[1],i=n.index+n[0].length,a=i,o=null;for(;a<e.length;){let t=e[a];if(t===`\\`){a+=2;continue}if(t===r){o=e.slice(i,a);break}a++}return o===null?null:o.replace(/\\(.)/g,(e,t)=>t===`n`?`
|
|
2349
|
-
`:t===`t`?` `:t===`r`?`\r`:t)}const
|
|
2350
|
-
`)}function
|
|
2348
|
+
`),s.push(l),s}const Er=[`classes`,`tokens`,`injects`,`pluginsAndAdapters`,`augmentations`,`contextKeys`,`routes`,`moduleMounts`,`globPatterns`];function Dr(e){if(!e||typeof e!=`object`)return!1;let t=e;return Er.every(e=>Array.isArray(t[e]))}var Or=class e{path;prev;next=new Map;nextSig=new Map;constructor(e,t){this.path=e,this.prev=t}static async load(t){let n=h(t,`scan.json`),r=new Map;try{let e=await C(n,`utf-8`),t=JSON.parse(e);if(t.version===2&&t.files)for(let[e,n]of Object.entries(t.files))n&&typeof n.sig==`string`&&Dr(n.extract)&&r.set(e,n)}catch{}return new e(n,r)}static async signature(e){try{let t=await le(e);return`${t.mtimeMs}:${t.size}`}catch{return null}}get(e,t){let n=this.prev.get(e);return n&&n.sig===t?n.extract:null}set(e,t,n){this.next.set(e,n),this.nextSig.set(e,t)}cachedFiles(){return[...this.prev.keys()]}peek(e){return this.prev.get(e)?.extract??null}carry(e){let t=this.prev.get(e);return t?(this.next.set(e,t.extract),this.nextSig.set(e,t.sig),!0):!1}async save(){let e={};for(let[t,n]of this.next){let r=this.nextSig.get(t);r&&(e[t]={sig:r,extract:n})}let t={version:2,files:e};try{await oe(f(this.path),{recursive:!0}),await w(this.path,JSON.stringify(t),`utf-8`)}catch{}}};let kr=null;function Ar(){return kr??=new Set(Kr),kr}const jr=new Set([`Get`,`Post`,`Put`,`Delete`,`Patch`]);function V(e){return typeof e==`object`&&!!e&&typeof e.type==`string`}function H(e,t){if(Array.isArray(e)){for(let n of e)H(n,t);return}if(V(e)){t(e);for(let n of Object.keys(e)){if(n===`type`)continue;let r=e[n];typeof r==`object`&&r&&H(r,t)}}}function U(e){if(!V(e))return null;if(e.type===`Literal`&&typeof e.value==`string`)return e.value;if(e.type===`TemplateLiteral`){let t=e.quasis,n=e.expressions;if(t?.length===1&&(n?.length??0)===0){let e=t[0].value?.cooked;return typeof e==`string`?e:null}}return null}function W(e){return V(e)&&e.type===`Identifier`?e.name:null}function Mr(e){return W(e.callee)}function G(e,t){if(!e||e.type!==`ObjectExpression`)return null;for(let n of e.properties??[]){if(n.type!==`Property`)continue;let e=n.key;if((W(e)??(e.type===`Literal`?String(e.value):U(e)))===t)return n.value}return null}function Nr(e){let t=e.arguments?.[0];return V(t)&&t.type===`ObjectExpression`?t:null}function Pr(e,t){let n=G(e,t);if(!V(n)||n.type!==`ArrayExpression`)return[];let r=[];for(let e of n.elements??[]){let t=U(e);t!==null&&r.push(t)}return r}function Fr(e,t){return _(t,e).split(y).join(`/`)}function Ir(e){return(e.match(/:([a-zA-Z_]\w*)/g)??[]).map(e=>e.slice(1))}function Lr(e,t){for(let n of e.implements??[]){let e=n.expression??n;if(W(e)===t)return!0;if(e.type===`TSQualifiedName`||e.type===`MemberExpression`){let n=e.right??e.property;if(n&&W(n)===t)return!0}}return!1}function Rr(e){return e.decorators??[]}function zr(e){let t=e.expression;if(!V(t)||t.type!==`CallExpression`)return null;let n=Mr(t);return n?{name:n,call:t}:null}function Br(e){let t=new Map,n=new Set;for(let r of e.body??[]){if(r.type===`ImportDeclaration`){let e=U(r.source)??``;for(let n of r.specifiers??[]){let r=W(n.local);r&&t.set(r,{source:e})}continue}let e=r.type===`VariableDeclaration`?r:r.type===`ExportNamedDeclaration`&&V(r.declaration)?r.declaration:null;if(V(e)&&e.type===`VariableDeclaration`)for(let t of e.declarations??[]){let e=W(t.id);e&&n.add(e)}}return{imports:t,topLevelConsts:n}}function Vr(e,t){let n=t.imports.get(e);return n?{identifier:e,source:n.source}:t.topLevelConsts.has(e)?{identifier:e,source:``}:{identifier:e,source:null}}function Hr(e,t,n){let r=W(G(e,t));return r?Vr(r,n):null}function Ur(e,t){for(let n of e){let e=zr(n);if(!e||e.name!==`ApiQueryParams`)continue;let r=e.call.arguments?.[0],i=null;if(V(r)&&r.type===`ObjectExpression`)i=r;else{let e=W(r);if(e){let n=t.get(e);n&&n.type===`ObjectExpression`&&(i=n)}}return{filterable:Pr(i,`filterable`),sortable:Pr(i,`sortable`),searchable:Pr(i,`searchable`)}}return null}function Wr(e,t,n){let r;try{let n=pe(t,e);if(n.errors.length>0)return null;r=n.program}catch{return null}let i=Fr(t,n),a=Br(r),o=[],s=[],c=[],l=[],u=[],d=[],f=[],p=[],m=[],h=new Set,g=new Set,_=new Set,v=new Map;for(let e of r.body??[]){let t=e.type===`VariableDeclaration`?e:e.type===`ExportNamedDeclaration`&&V(e.declaration)?e.declaration:null;if(V(t)&&t.type===`VariableDeclaration`)for(let e of t.declarations??[]){let t=W(e.id);t&&V(e.init)&&v.set(t,e.init)}}let y=[];for(let e of r.body??[])if(e.type===`ExportNamedDeclaration`&&V(e.declaration)){let t=e.declaration;t.type===`ClassDeclaration`&&y.push({cls:t,isDefault:!1})}else if(e.type===`ExportDefaultDeclaration`&&V(e.declaration)){let t=e.declaration;t.type===`ClassDeclaration`&&y.push({cls:t,isDefault:!0})}for(let{cls:e,isDefault:n}of y){let r=W(e.id);if(!r)continue;let a=null;for(let t of Rr(e)){let e=zr(t);if(e&&Ar().has(e.name)){a=e.name;break}}a?o.push({className:r,decorator:a,filePath:t,relativePath:i,isDefault:n}):Lr(e,`AppModule`)&&o.push({className:r,decorator:`Module`,filePath:t,relativePath:i,isDefault:n})}for(let e of r.body??[]){if(e.type!==`ExportNamedDeclaration`||!V(e.declaration))continue;let n=e.declaration;if(n.type===`VariableDeclaration`)for(let e of n.declarations??[]){let n=W(e.id),r=e.init;!n||!V(r)||r.type!==`CallExpression`||Mr(r)===`defineModule`&&(o.some(e=>e.className===n)||o.push({className:n,decorator:`Module`,filePath:t,relativePath:i,isDefault:!1}))}}H(r,e=>{if(e.type===`VariableDeclarator`){let n=e.init;if(V(n)&&n.type===`CallExpression`&&Mr(n)===`createToken`){let r=U(n.arguments?.[0]);r!==null&&(_.add(n),s.push({name:r,variable:W(e.id),filePath:t,relativePath:i}))}return}if(e.type!==`CallExpression`){if(e.type===`Decorator`){let n=zr(e);if(n?.name===`Inject`){let e=U(n.call.arguments?.[0]);e!==null&&c.push({name:e,filePath:t,relativePath:i})}}return}let n=e.callee,r=Mr(e);if(r===`createToken`&&!_.has(e)){let n=U(e.arguments?.[0]);n!==null&&s.push({name:n,variable:null,filePath:t,relativePath:i});return}if(r===`defineAdapter`||r===`definePlugin`){let n=U(G(Nr(e),`name`));if(n!==null){let e=r===`definePlugin`?`plugin`:`adapter`,a=`${r}::${n}::${t}`;h.has(a)||(h.add(a),l.push({kind:e,name:n,filePath:t,relativePath:i}))}return}if(r===`defineAugmentation`){let n=e.arguments??[],r=U(n[0]);if(r!==null){let e=V(n[1])&&n[1].type===`ObjectExpression`?n[1]:null;u.push({name:r,description:U(G(e,`description`)),example:U(G(e,`example`)),filePath:t,relativePath:i})}return}if(r===`defineContextDecorator`||r===`defineHttpContextDecorator`){let n=U(G(Nr(e),`key`));n!==null&&!g.has(n)&&(g.add(n),d.push({key:n,filePath:t,relativePath:i}));return}if(V(n)&&n.type===`CallExpression`){let r=n.callee;if(V(r)&&r.type===`MemberExpression`&&W(r.property)===`withParams`){let n=W(r.object);if(n===`defineContextDecorator`||n===`defineHttpContextDecorator`){let n=U(G(Nr(e),`key`));n!==null&&!g.has(n)&&(g.add(n),d.push({key:n,filePath:t,relativePath:i}))}}return}if(V(n)&&n.type===`MemberExpression`&&W(n.property)===`glob`){let t=n.object;V(t)&&t.type===`MetaProperty`&&H(e.arguments,e=>{let t=U(e);t!==null&&m.push(t)})}});let b=[];H(r,e=>{if(e.type===`ClassDeclaration`||e.type===`ClassExpression`){let t=W(e.id);t&&b.push({cls:e,className:t})}});for(let{cls:e,className:n}of b){let r=o.find(e=>e.className===n),s=e.body?.body;if(Lr(e,`AppAdapter`))for(let e of s??[]){if(e.type!==`PropertyDefinition`||W(e.key)!==`name`)continue;let n=U(e.value);if(n===null)continue;let r=`class::${n}::${t}`;h.has(r)||(h.add(r),l.push({kind:`adapter`,name:n,filePath:t,relativePath:i}));break}for(let e of s??[]){if(e.type!==`MethodDefinition`)continue;let o=W(e.key);if(!o)continue;if(o===`routes`){Gr(e.value,p);continue}if(!r)continue;let s=Rr(e),c=Ur(s,v);for(let e of s){let r=zr(e);if(!r||!jr.has(r.name))continue;let s=r.call.arguments??[],l=U(s[0]),u=l&&l.length>0?l:`/`,d=V(s[1])&&s[1].type===`ObjectExpression`?s[1]:null;f.push({controller:n,method:o,httpMethod:r.name.toUpperCase(),path:u,pathParams:Ir(u),queryFilterable:c?.filterable??null,querySortable:c?.sortable??null,querySearchable:c?.searchable??null,bodySchema:Hr(d,`body`,a),querySchema:Hr(d,`query`,a),paramsSchema:Hr(d,`params`,a),filePath:t,relativePath:i})}}}return H(r,e=>{if(e.type!==`Property`||W(e.key)!==`routes`)return;let t=e.value;V(t)&&(t.type===`FunctionExpression`||t.type===`ArrowFunctionExpression`)&&Gr(t,p)}),{classes:o,tokens:s,injects:c,pluginsAndAdapters:l,augmentations:u,contextKeys:d,routes:f,moduleMounts:p,globPatterns:/\.module\.[mc]?[tj]sx?$/.test(t)?m:[]}}function Gr(e,t){let n=[],r=[];H(e.body,e=>{if(e.type!==`Property`)return;let t=W(e.key);if(t===`path`){let t=U(e.value);t!==null&&n.push(t)}else if(t===`controller`){let t=W(e.value);t&&/^[A-Z]/.test(t)&&r.push(t)}});let i=Math.min(n.length,r.length);for(let e=0;e<i;e++)t.push({controller:r[e],mountPath:n[e]})}const Kr=[`Service`,`Controller`,`Repository`,`Injectable`,`Component`,`Module`],qr=[`.ts`,`.tsx`,`.mts`,`.cts`],Jr=[`node_modules`,`.kickjs`,`dist`,`build`,`.test.`,`.spec.`,`.d.ts`],Yr=new RegExp(String.raw`@(${Kr.join(`|`)})\s*\([^)]*\)`+String.raw`(?:\s*@[A-Z]\w*(?:\s*\([^)]*\))?)*`+String.raw`\s*export\s+(default\s+)?(?:abstract\s+)?class\s+(\w+)`,`g`),Xr=new RegExp(String.raw`export\s+(default\s+)?(?:abstract\s+)?class\s+(\w+)`+String.raw`(?:\s+extends\s+\w+(?:<[^>]*>)?)?`+String.raw`\s+implements\s+[^{]*\bAppModule\b`,`g`),Zr=/export\s+const\s+(\w+)\s*(?::\s*[^=]+)?=\s*defineModule\s*(?:<[^>]*>)?\s*\(/g,Qr=/(?:export\s+)?const\s+(\w+)\s*(?::\s*[^=]+)?=\s*createToken\s*(?:<[^>]*>)?\s*\(\s*['"`]([^'"`]+)['"`]\s*\)/g,$r=/createToken\s*(?:<[^>]*>)?\s*\(\s*['"`]([^'"`]+)['"`]\s*\)/g,ei=/@Inject\s*\(\s*['"`]([^'"`]+)['"`]\s*\)/g,ti=/\b(defineAdapter|definePlugin)\s*(?:<[^>]*>)?\s*\(/g,ni=/\b(?:defineContextDecorator|defineHttpContextDecorator)\s*(?:\.withParams\s*<(?:[^<>]|<[^<>]*>)*>\s*\(\s*\))?\s*(?:<(?:[^<>]|<[^<>]*>)*>)?\s*\(/g,ri=new RegExp(String.raw`export\s+(?:default\s+)?(?:abstract\s+)?class\s+(\w+)`+String.raw`(?:\s+extends\s+\w+(?:<[^>]*>)?)?`+String.raw`\s+implements\s+[^{]*\bAppAdapter\b`,`g`),ii=/\bname\s*(?::\s*[^=]+)?=\s*['"`]([^'"`]+)['"`]/,ai=/\bdefineAugmentation\s*\(\s*['"`]([^'"`]+)['"`]\s*(,\s*\{)?/g,oi=new RegExp(String.raw`@(${[`Get`,`Post`,`Put`,`Delete`,`Patch`].join(`|`)})\s*\(`,`g`);function si(e,t){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 ci(e,t){let n=t;for(;n<e.length;){for(;n<e.length&&/\s/.test(e[n]);)n++;if(e[n]!==`@`)break;let t=e.slice(n).match(/^@([A-Z]\w*)/);if(!t)break;for(n+=t[0].length;n<e.length&&/\s/.test(e[n]);)n++;if(e[n]===`(`){let t=si(e,n);if(t<0)return null;n=t+1}}for(;n<e.length&&/\s/.test(e[n]);)n++;for(let t of[`public`,`private`,`protected`])if(e.slice(n,n+t.length)===t&&/\s/.test(e.charAt(n+t.length))){for(n+=t.length;n<e.length&&/\s/.test(e[n]);)n++;break}if(e.slice(n,n+5)===`async`&&/\s/.test(e.charAt(n+5)))for(n+=5;n<e.length&&/\s/.test(e[n]);)n++;let r=e.slice(n).match(/^([a-zA-Z_]\w*)\s*\(/);return r?{methodName:r[1],endPos:n+r[0].length}:null}function li(e){return(e.match(/:([a-zA-Z_]\w*)/g)??[]).map(e=>e.slice(1))}function ui(e,t){let n=e.endsWith(`/`)?e.slice(0,-1):e;return!t||t===`/`?n||`/`:n+(t.startsWith(`/`)?t:`/`+t)||`/`}const di=/\b(?:public\s+|private\s+|protected\s+)?routes\s*\([^)]*\)\s*(?::\s*[A-Za-z_][\w<>[\]\s,|]*\s*)?\{/g,fi=/\bpath\s*:\s*['"`]([^'"`]*)['"`]/g,pi=/\bcontroller\s*:\s*([A-Z]\w*)\b/g,mi=/\bimport\.meta\.glob\s*\(/g;function hi(e){let t=[];for(mi.lastIndex=0;mi.exec(e)!==null;){let n=mi.lastIndex-1,r=si(e,n);if(r<0)continue;let i=e.slice(n+1,r),a=/['"`]([^'"`]+)['"`]/g,o;for(;(o=a.exec(i))!==null;)t.push(o[1])}return t}function gi(e){let t=e.replace(/[.+^$()|[\]\\]/g,`\\$&`).replace(/\?/g,`.`).replace(/\*\*\//g,`___DOUBLESTAR_SLASH___`).replace(/\*\*/g,`___DOUBLESTAR___`).replace(/\*/g,`[^/]*`).replace(/___DOUBLESTAR_SLASH___/g,`(?:.+/)?`).replace(/___DOUBLESTAR___/g,`.*`);return RegExp(`^`+t+`$`)}function _i(e,t){let n=e.startsWith(`./`)?e:`./`+e,r=!1;for(let e of t){let t=e.startsWith(`!`);gi(t?e.slice(1):e).test(n)&&(r=!t)}return r}function vi(e){let t=[];di.lastIndex=0;let n;for(;(n=di.exec(e))!==null;){let r=e.indexOf(`{`,n.index+n[0].length-1);if(r<0)continue;let i=Ai(e,r);if(i<0)continue;let a=e.slice(r+1,i),o=[];fi.lastIndex=0;let s;for(;(s=fi.exec(a))!==null;)o.push(s[1]??``);let c=[];pi.lastIndex=0;let l;for(;(l=pi.exec(a))!==null;)c.push(l[1]);let u=Math.min(o.length,c.length);for(let e=0;e<u;e++)t.push({controller:c[e],mountPath:o[e]})}return t}function yi(e,t){let n=new RegExp(String.raw`\b${t}\s*:\s*([A-Za-z_$][\w$]*)`,`g`).exec(e);return n?n[1]:null}function bi(e,t){let n=new RegExp(String.raw`import\s*(?:type\s+)?\{[^}]*\b${t}\b[^}]*\}\s*from\s*['"\`]([^'"\`]+)['"\`]`).exec(e);if(n)return n[1];let r=new RegExp(String.raw`import\s+(?:type\s+)?${t}\s+from\s*['"\`]([^'"\`]+)['"\`]`).exec(e);if(r)return r[1];let i=new RegExp(String.raw`import\s*\*\s*as\s+${t}\s+from\s*['"\`]([^'"\`]+)['"\`]`).exec(e);return i?i[1]:new RegExp(String.raw`(?:^|\n)\s*(?:export\s+)?const\s+${t}\b`).test(e)?``:null}function xi(e,t){let n=/@ApiQueryParams\s*\(\s*([\s\S]*?)\s*\)\s*$/.exec(e);if(!n){let n=/@ApiQueryParams\s*\(([\s\S]*?)\)/.exec(e);return n?Si(n[1].trim(),t):null}return Si(n[1].trim(),t)}function Si(e,t){if(e.startsWith(`{`))return wi(e);let n=/^([A-Za-z_]\w*)/.exec(e);if(n){let e=n[1],r=new RegExp(String.raw`const\s+${e}\s*(?::\s*[^=]+)?=\s*(\{[\s\S]*?\n\})`,`m`).exec(t);if(r)return wi(r[1])}return{filterable:[],sortable:[],searchable:[]}}function Ci(e,t){let n=new RegExp(String.raw`${t}\s*:\s*\[([\s\S]*?)\]`).exec(e);return n?Array.from(n[1].matchAll(/['"`]([^'"`]+)['"`]/g)).map(e=>e[1]):[]}function wi(e){return{filterable:Ci(e,`filterable`),sortable:Ci(e,`sortable`),searchable:Ci(e,`searchable`)}}async function Ti(e,t){let n=t.extensions??qr,r=t.exclude??Jr,i=[],a;try{a=await se(e,{withFileTypes:!0,encoding:`utf-8`})}catch{return i}for(let o of a){let a=h(e,o.name),s=_(t.cwd,a);r.some(e=>s.includes(e))||(o.isDirectory()?i.push(...await Ti(a,t)):o.isFile()&&n.some(e=>o.name.endsWith(e))&&i.push(a))}return i}function K(e,t){return _(t,e).split(y).join(`/`)}function Ei(e,t,n){let r=[],i=K(t,n);Yr.lastIndex=0;let a;for(;(a=Yr.exec(e))!==null;){let[,e,n,o]=a;r.push({className:o,decorator:e,filePath:t,relativePath:i,isDefault:!!n})}Xr.lastIndex=0;let o;for(;(o=Xr.exec(e))!==null;){let[,e,n]=o;r.some(e=>e.className===n&&e.filePath===t)||r.push({className:n,decorator:`Module`,filePath:t,relativePath:i,isDefault:!!e})}Zr.lastIndex=0;let s;for(;(s=Zr.exec(e))!==null;){let[,e]=s;r.some(n=>n.className===e&&n.filePath===t)||r.push({className:e,decorator:`Module`,filePath:t,relativePath:i,isDefault:!1})}return r}function Di(e,t,n){let r=[],i=K(t,n),a=new Set;Qr.lastIndex=0;let o;for(;(o=Qr.exec(e))!==null;){let[e,n,s]=o;a.add(e),r.push({name:s,variable:n,filePath:t,relativePath:i})}for($r.lastIndex=0;(o=$r.exec(e))!==null;)a.has(o[0])||r.push({name:o[1],variable:null,filePath:t,relativePath:i});return r}function Oi(e,t,n,r,i=new Map){let a=[];if(r.length===0)return a;let o=K(t,n),s=[];for(let t of r){let n=new RegExp(String.raw`class\s+${t.className}\b`).exec(e);n?.index!==void 0&&s.push({cls:t,start:n.index})}s.sort((e,t)=>e.start-t.start);for(let n=0;n<s.length;n++){let{cls:r,start:c}=s[n],l=n+1<s.length?s[n+1].start:e.length,u=e.slice(c,l);oi.lastIndex=0;let d;for(;(d=oi.exec(u))!==null;){let n=d[1],s=d.index,c=oi.lastIndex-1,l=si(u,c);if(l<0)continue;let f=u.slice(c+1,l),p=f.match(/^\s*['"`]([^'"`]*)['"`]/),m=p&&p[1].length>0?p[1]:`/`,h=ci(u,l+1);if(!h)continue;let{methodName:g,endPos:_}=h;oi.lastIndex=_;let v=xi(u.slice(s,_),e),y=yi(f,`body`),b=yi(f,`query`),x=yi(f,`params`),ee=i.get(r.className)??``,S=ee?ui(ee,m):m;a.push({controller:r.className,method:g,httpMethod:n.toUpperCase(),path:m,pathParams:li(S),queryFilterable:v?.filterable??null,querySortable:v?.sortable??null,querySearchable:v?.searchable??null,bodySchema:y?{identifier:y,source:bi(e,y)}:null,querySchema:b?{identifier:b,source:bi(e,b)}:null,paramsSchema:x?{identifier:x,source:bi(e,x)}:null,filePath:t,relativePath:o})}}return a}function ki(e,t,n){let r=[],i=K(t,n);ei.lastIndex=0;let a;for(;(a=ei.exec(e))!==null;)r.push({name:a[1],filePath:t,relativePath:i});return r}function Ai(e,t){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 ji(e,t,n){let r=[],i=K(t,n),a=new Set;ti.lastIndex=0;let o;for(;(o=ti.exec(e))!==null;){let n=o[1],s=ti.lastIndex-1,c=si(e,s);if(c<0)continue;let l=e.slice(s+1,c),u=/\bname\s*:\s*['"`]([^'"`]+)['"`]/.exec(l);if(!u)continue;let d=u[1],f=`${n}::${d}::${t}`;a.has(f)||(a.add(f),r.push({kind:n===`definePlugin`?`plugin`:`adapter`,name:d,filePath:t,relativePath:i}))}ri.lastIndex=0;let s;for(;(s=ri.exec(e))!==null;){let n=s.index,o=e.indexOf(`{`,n);if(o<0)continue;let c=Ai(e,o);if(c<0)continue;let l=e.slice(o+1,c),u=ii.exec(l);if(!u)continue;let d=u[1],f=`class::${d}::${t}`;a.has(f)||(a.add(f),r.push({kind:`adapter`,name:d,filePath:t,relativePath:i}))}return r}function Mi(e,t,n){let r=[],i=K(t,n),a=new Set;for(ni.lastIndex=0;ni.exec(e)!==null;){let n=ni.lastIndex-1,o=si(e,n);if(o<0)continue;let s=e.slice(n+1,o),c=/\bkey\s*:\s*['"`]([^'"`]+)['"`]/.exec(s);if(!c)continue;let l=c[1];a.has(l)||(a.add(l),r.push({key:l,filePath:t,relativePath:i}))}return r}function Ni(e,t,n){let r=[],i=K(t,n);ai.lastIndex=0;let a;for(;(a=ai.exec(e))!==null;){let n=a[1],o=null,s=null;if(a[2]){let t=e.indexOf(`{`,a.index+a[0].length-1);if(t>=0){let n=Ai(e,t);if(n>=0){let r=e.slice(t+1,n);o=Pi(r,`description`),s=Pi(r,`example`)}}}r.push({name:n,description:o,example:s,filePath:t,relativePath:i})}return r}function Pi(e,t){let n=RegExp(`\\b${t}\\s*:\\s*(['"\`])`,`g`).exec(e);if(!n)return null;let r=n[1],i=n.index+n[0].length,a=i,o=null;for(;a<e.length;){let t=e[a];if(t===`\\`){a+=2;continue}if(t===r){o=e.slice(i,a);break}a++}return o===null?null:o.replace(/\\(.)/g,(e,t)=>t===`n`?`
|
|
2349
|
+
`:t===`t`?` `:t===`r`?`\r`:t)}const Fi=[`src/config/index.ts`,`src/config/env.ts`,`src/config.ts`,`src/env.ts`];async function Ii(e,t){let n=t===`src/env.ts`?Fi:[t];for(let t of n){let n=v(e,t),r;try{r=await C(n,`utf-8`)}catch{continue}if(!(!/\bdefineEnv\s*\(/.test(r)&&!/\bfrom(Zod|Valibot|Yup)\s*\(/.test(r))&&/export\s+default\b/.test(r)&&!/export\s+default\s+loadEnvFromSchema\s*\(/.test(r))return{filePath:n,relativePath:K(n,e)}}return null}function Li(e){let t=new Map;for(let n of e){let e=t.get(n.className)??[];e.push(n),t.set(n.className,e)}let n=[];for(let[e,r]of t)new Set(r.map(e=>e.filePath)).size>1&&n.push({className:e,classes:r});return n.sort((e,t)=>e.className.localeCompare(t.className)),n}function Ri(e,t,n){return Wr(e,t,n)||zi(e,t,n)}function zi(e,t,n){let r=Ei(e,t,n);return{classes:r,tokens:Di(e,t,n),injects:ki(e,t,n),pluginsAndAdapters:ji(e,t,n),augmentations:Ni(e,t,n),contextKeys:Mi(e,t,n),routes:Oi(e,t,n,r,new Map),moduleMounts:vi(e),globPatterns:/\.module\.[mc]?[tj]sx?$/.test(t)?hi(e):[]}}async function Bi(e,t,n){let r=n?await Or.signature(e):null;if(n&&r){let t=n.get(e,r);if(t)return n.set(e,r,t),t}let i;try{i=await C(e,`utf-8`)}catch{return null}let a=Ri(i,e,t);return n&&r&&n.set(e,r,a),a}async function Vi(e,t,n){let r=[],i=0,a=Array.from({length:Math.min(t,e.length)},async()=>{for(;;){let t=i++;if(t>=e.length)return;r[t]=await n(e[t],t)}});return await Promise.all(a),r}async function Hi(e){let t=(await Ti(v(e.root),e)).toSorted(),n=e.cacheDir?await Or.load(e.cacheDir):null,r=Gi(t,await Vi(t,16,t=>Bi(t,e.cwd,n))),i=await Ii(e.cwd,e.envFile??`src/env.ts`);return n&&await n.save(),{...r,env:i}}function Ui(e,t,n){let r=n.extensions??qr,i=n.exclude??Jr;if(!e.startsWith(t+y)&&e!==t||!r.some(t=>e.endsWith(t)))return!1;let a=_(n.cwd,e);return!i.some(e=>a.includes(e))}async function Wi(e,t){if(!e.cacheDir)return Hi(e);let n=v(e.root),r=await Or.load(e.cacheDir),i=r.cachedFiles();if(i.length===0)return Hi(e);let a=new Set(t.removed.map(t=>v(e.cwd,t))),o=t.changed.map(t=>v(e.cwd,t)).filter(t=>!a.has(t)&&Ui(t,n,e)),s=new Set(o),c=new Set(i);for(let e of s)c.add(e);for(let e of a)c.delete(e);let l=new Map;await Vi(o,16,async t=>{if(!c.has(t))return;let n=await Or.signature(t),i;try{i=await C(t,`utf-8`)}catch{c.delete(t);return}let a=Ri(i,t,e.cwd);l.set(t,a),n&&r.set(t,n,a)});let u=[...c].toSorted(),d=Gi(u,u.map(e=>l.get(e)||(r.carry(e),r.peek(e)))),f=await Ii(e.cwd,e.envFile??`src/env.ts`);return await r.save(),{...d,env:f}}function Gi(e,t){let n=[],r=[],i=[],a=[],o=[],s=[],c=[],l=new Map;for(let e of t)if(e)for(let{controller:t,mountPath:n}of e.moduleMounts)l.has(t)||l.set(t,n);let u=new Map;for(let d=0;d<e.length;d++){let f=t[d];if(f){n.push(...f.classes),i.push(...f.tokens),a.push(...f.injects),o.push(...f.pluginsAndAdapters),s.push(...f.augmentations),c.push(...f.contextKeys),f.globPatterns.length>0&&u.set(e[d],f.globPatterns);for(let e of f.routes){let t=l.get(e.controller);if(t){let n=ui(t,e.path);r.push({...e,pathParams:li(n)})}else r.push(e)}}}let d=[];for(let[e,t]of u){if(!/\.module\.[mc]?[tj]sx?$/.test(e)||t.length===0)continue;let r=e.replaceAll(y,`/`),i=r.slice(0,r.lastIndexOf(`/`));for(let a of n){if(a.decorator===`Module`)continue;let n=a.filePath.replaceAll(y,`/`);n.startsWith(i+`/`)&&n!==r&&(_i(n.slice(i.length+1),t)||d.push({className:a.className,filePath:a.filePath,relativePath:a.relativePath,moduleFilePath:e,decorator:a.decorator}))}}n.sort((e,t)=>e.className===t.className?e.relativePath.localeCompare(t.relativePath):e.className.localeCompare(t.className)),i.sort((e,t)=>e.name.localeCompare(t.name)||e.relativePath.localeCompare(t.relativePath)),a.sort((e,t)=>e.name.localeCompare(t.name)||e.relativePath.localeCompare(t.relativePath)),r.sort((e,t)=>e.controller.localeCompare(t.controller)||e.method.localeCompare(t.method)),o.sort((e,t)=>e.name.localeCompare(t.name)||e.relativePath.localeCompare(t.relativePath)),s.sort((e,t)=>e.name.localeCompare(t.name)||e.relativePath.localeCompare(t.relativePath)),c.sort((e,t)=>e.key.localeCompare(t.key)||e.relativePath.localeCompare(t.relativePath));let f=Li(n);return d.sort((e,t)=>e.relativePath.localeCompare(t.relativePath)||e.className.localeCompare(t.className)),{classes:n,routes:r,tokens:i,injects:a,collisions:f,pluginsAndAdapters:o,augmentations:s,contextKeys:c,orphanedClasses:d}}const q="/* 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",Ki=new Set([`Service`,`Repository`,`Injectable`,`Component`]);var qi=class extends Error{collisions;constructor(e){super(Ji(e)),this.name=`TokenCollisionError`,this.collisions=e}};function Ji(e){let t=[`kick typegen: token collision detected`];for(let n of e){t.push(``),t.push(` ${n.classes.length} classes named '${n.className}':`);for(let e of n.classes)t.push(` - ${e.relativePath}`)}return t.push(``),t.push(`Resolutions:`),t.push(` (a) Rename one of the classes`),t.push(` (b) Use createToken<T>('namespaced/Name') and import the token explicitly — see @forinda/kickjs`),t.push(` (c) Pass --allow-duplicates to namespace the registry keys automatically`),t.push(` (e.g. 'modules/users/UserService' instead of 'UserService')`),t.join(`
|
|
2350
|
+
`)}function Yi(e,t){let n=_(f(t),e).split(y).join(`/`);return n=n.replace(/\.(ts|tsx|mts|cts)$/i,``),n.startsWith(`.`)||(n=`./`+n),n}function Xi(e){let t=e.relativePath.replace(/^src\//,``).replace(/\.(ts|tsx|mts|cts)$/i,``).split(`/`);t.pop();let n=t.join(`/`);return n?`${n}/${e.className}`:e.className}function Zi(e,t,n){let r=new Set,i=[];for(let a of e){if(!Ki.has(a.decorator))continue;let e=n.has(a.className)?Xi(a):a.className;if(r.has(e))continue;r.add(e);let o=Yi(a.filePath,t),s=a.isDefault?`import('${o}').default`:`import('${o}').${a.className}`;i.push(` '${e}': ${s}`)}return`${q}
|
|
2351
2351
|
declare module '@forinda/kickjs' {
|
|
2352
2352
|
interface KickJsRegistry {
|
|
2353
2353
|
${i.length?i.join(`
|
|
@@ -2356,7 +2356,7 @@ ${i.length?i.join(`
|
|
|
2356
2356
|
}
|
|
2357
2357
|
|
|
2358
2358
|
export {}
|
|
2359
|
-
`}function
|
|
2359
|
+
`}function Qi(e){return/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(e)}function $i(e){return`${q}
|
|
2360
2360
|
declare module '@forinda/kickjs' {
|
|
2361
2361
|
/**
|
|
2362
2362
|
* Key-only registry of every context key produced by a
|
|
@@ -2365,20 +2365,20 @@ declare module '@forinda/kickjs' {
|
|
|
2365
2365
|
* \`ContextMeta\`; this only records that the key exists.
|
|
2366
2366
|
*/
|
|
2367
2367
|
interface ContextKeys {
|
|
2368
|
-
${[...new Set(e.map(e=>e.key))].toSorted().map(e=>` ${
|
|
2368
|
+
${[...new Set(e.map(e=>e.key))].toSorted().map(e=>` ${Qi(e)?e:JSON.stringify(e)}: true`).join(`
|
|
2369
2369
|
`)}
|
|
2370
2370
|
}
|
|
2371
2371
|
}
|
|
2372
2372
|
|
|
2373
2373
|
export {}
|
|
2374
|
-
`}function
|
|
2374
|
+
`}function ea(e,t,n){return t.length===0?`${q}
|
|
2375
2375
|
// ${n}
|
|
2376
2376
|
export type ${e} = never
|
|
2377
2377
|
`:`${q}
|
|
2378
2378
|
export type ${e} =
|
|
2379
2379
|
${[...new Set(t)].toSorted().map(e=>` | '${e}'`).join(`
|
|
2380
2380
|
`)}
|
|
2381
|
-
`}function
|
|
2381
|
+
`}function ta(e,t,n,r){return[...e.filter(e=>Ki.has(e.decorator)).map(e=>r.has(e.className)?Xi(e):e.className),...t.map(e=>e.name),...n.map(e=>e.name)]}function na(e){return e.filter(e=>e.decorator===`Module`).map(e=>e.className)}function ra(e){let t=new Map;for(let n of e)t.has(n.name)||t.set(n.name,n);return`${q}
|
|
2382
2382
|
declare module '@forinda/kickjs' {
|
|
2383
2383
|
/**
|
|
2384
2384
|
* Map of every plugin/adapter \`name\` discovered in the project. The
|
|
@@ -2393,7 +2393,7 @@ ${[...t.values()].toSorted((e,t)=>e.name.localeCompare(t.name)).map(e=>` '${e
|
|
|
2393
2393
|
}
|
|
2394
2394
|
|
|
2395
2395
|
export {}
|
|
2396
|
-
`}function
|
|
2396
|
+
`}function ia(e){if(e.length===0)return`${q}
|
|
2397
2397
|
// No augmentations discovered.
|
|
2398
2398
|
//
|
|
2399
2399
|
// Plugins advertise augmentable interfaces via:
|
|
@@ -2417,7 +2417,7 @@ export {}
|
|
|
2417
2417
|
${n.join(`
|
|
2418
2418
|
|
|
2419
2419
|
`)}
|
|
2420
|
-
`}const
|
|
2420
|
+
`}const aa=/^(kick\/)?([a-z][\w-]*\/[A-Z]\w*)(\/.+)?(:[a-z][\w-]+(:[a-z][\w-]+)*)?$/;function oa(e){let t=[];for(let n of e){let e=n.name;e.startsWith(`kickjs.`)||aa.test(e)||t.push({token:e,variable:n.variable,filePath:n.relativePath,reason:"does not match `<scope>/<PascalKey>[/<suffix>][:<instance>]`",suggestion:sa(e)})}return t}function sa(e){if(/^[A-Z]\w*$/.test(e))return`'<scope>/${e}' (e.g. 'mycorp/${e}')`;if(e.includes(`.`))return`consider '<scope>/PascalKey' instead of dotted form`;let t=/^([a-z][\w-]*)\/([a-z]\w*)$/.exec(e);if(t){let[,e,n]=t;return`'${e}/${n.charAt(0).toUpperCase()}${n.slice(1)}'`}}function ca(e,t){if(!e)return{entries:[],count:0};let n=new Map;for(let[r,i]of Object.entries(e)){if(!i||typeof i.src!=`string`)continue;let e=v(t,i.src);if(!pa(e))continue;let a=he(i.glob??`**/*`,{cwd:e,nodir:!0,dot:!1,posix:!0});a.sort();let{pairs:o}=ge(r,a,{strategy:i.keys??`auto`});for(let{key:e}of o){let t=e.slice(r.length+1);n.set(e,{namespace:r,key:t})}}return{entries:[...n.values()],count:n.size}}function la(e){let t="/* 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";if(e.entries.length===0)return`${t}
|
|
2421
2421
|
declare module '@forinda/kickjs' {
|
|
2422
2422
|
/**
|
|
2423
2423
|
* Map of every typed asset discovered in the project's assetMap.
|
|
@@ -2428,7 +2428,7 @@ declare module '@forinda/kickjs' {
|
|
|
2428
2428
|
}
|
|
2429
2429
|
|
|
2430
2430
|
export {}
|
|
2431
|
-
`;let n={};for(let t of e.entries){let e=`${t.namespace}/${t.key}`.split(`/`),r=n;for(let t=0;t<e.length-1;t++){let n=e[t],i=r[n];if(i===
|
|
2431
|
+
`;let n={};for(let t of e.entries){let e=`${t.namespace}/${t.key}`.split(`/`),r=n;for(let t=0;t<e.length-1;t++){let n=e[t],i=r[n];if(i===ua){let e={};r[n]=e,r=e}else i||(r[n]={}),r=r[n]}let i=e[e.length-1];typeof r[i]!=`object`&&(r[i]=ua)}return`${t}
|
|
2432
2432
|
declare module '@forinda/kickjs' {
|
|
2433
2433
|
/**
|
|
2434
2434
|
* Map of every typed asset discovered in the project's assetMap.
|
|
@@ -2437,71 +2437,63 @@ declare module '@forinda/kickjs' {
|
|
|
2437
2437
|
* prod → dist).
|
|
2438
2438
|
*/
|
|
2439
2439
|
interface KickAssets {
|
|
2440
|
-
${
|
|
2440
|
+
${da(n,` `)}
|
|
2441
2441
|
}
|
|
2442
2442
|
}
|
|
2443
2443
|
|
|
2444
2444
|
export {}
|
|
2445
|
-
`}const
|
|
2446
|
-
`)}function
|
|
2445
|
+
`}const ua=Symbol(`asset-leaf`);function da(e,t){let n=Object.keys(e).toSorted(),r=[];for(let i of n){let n=e[i],a=fa(i)?i:JSON.stringify(i);n===ua?r.push(`${t}${a}: () => string`):(r.push(`${t}${a}: {`),r.push(da(n,`${t} `)),r.push(`${t}}`))}return r.join(`
|
|
2446
|
+
`)}function fa(e){return/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(e)}function pa(e){try{return c(e).isDirectory()}catch{return!1}}var ma=O({runTypegen:()=>ga,sweepStaleTypegen:()=>ba,watchTypegen:()=>ya,writeTypegenArtifacts:()=>va});function ha(e){let t=e.cwd??process.cwd();return{cwd:t,srcDir:v(t,e.srcDir??`src`),outDir:v(t,e.outDir??`.kickjs/types`),silent:e.silent??!1,allowDuplicates:e.allowDuplicates??!1,schemaValidator:e.schemaValidator??!1,envFile:e.envFile??`src/env.ts`}}async function ga(e={}){let{cwd:t,srcDir:n,outDir:r,silent:i,allowDuplicates:a,envFile:o}=ha(e),s=Date.now(),c={root:n,cwd:t,cacheDir:v(t,`.kickjs`,`cache`),envFile:o===!1?void 0:o},l=e.changedFiles?await Wi(c,e.changedFiles):await Hi(c);if(l.collisions.length>0&&!a)throw new qi(l.collisions);let u=ca(e.assetMap,t),d=[],f=[];if(e.runPlugins!==!1){try{let{runAllPluginTypegens:n}=await Promise.resolve().then(()=>Na),{loadKickConfig:r}=await Promise.resolve().then(()=>Te);d=await n({cwd:t,config:await r(t),silent:!0,changedFiles:e.changedFiles})}catch(e){if(!i){let t=e instanceof Error?e.message:String(e);console.warn(` kick typegen: plugin pipeline failed (${t}) — continuing`)}}f.push(...await va(r,d,i))}let p=oa(l.tokens),m=_a(l,u.count,f),h=Date.now()-s;if(!i){let e=r.replace(t+`/`,``),n=m.resolvedCollisions>0?`, ${m.resolvedCollisions} collisions namespaced`:``,i=m.envWritten?`, env typed`:``,a=m.pluginEntries>0?`, ${m.pluginEntries} plugins/adapters`:``,o=m.augmentationEntries>0?`, ${m.augmentationEntries} augmentations`:``,s=m.assetEntries>0?`, ${m.assetEntries} assets`:``;if(console.log(` kick typegen → ${m.serviceTokens} services, ${m.routeEntries} routes, ${m.moduleTokens} modules${a}${o}${s}${i}${n} → ${e} (${h}ms)`),p.length>0){console.warn(` kick typegen: ${p.length} token(s) don't match the §22.2 convention:`);for(let e of p){let t=e.variable?` [${e.variable}]`:``;console.warn(` '${e.token}' (${e.filePath})${t} — ${e.reason}`),e.suggestion&&console.warn(` → suggestion: ${e.suggestion}`)}}if(l.orphanedClasses.length>0){console.warn(` kick typegen: ${l.orphanedClasses.length} decorated class(es) not matched by any module's import.meta.glob():`);for(let e of l.orphanedClasses)console.warn(` @${e.decorator} ${e.className} (${e.relativePath})`),console.warn(` → not picked up by any glob in ${e.moduleFilePath}`)}}return{scan:l,result:m,tokenWarnings:p}}function _a(e,t,n){let r=new Set(e.collisions.map(e=>e.className)),i=e.classes.filter(e=>Ki.has(e.decorator)),a=ta(e.classes,e.tokens,e.injects,r);return{registryEntries:i.length,serviceTokens:new Set(a).size,moduleTokens:na(e.classes).length,routeEntries:e.routes.length,pluginEntries:new Set(e.pluginsAndAdapters.map(e=>e.name)).size,augmentationEntries:new Set(e.augmentations.map(e=>e.name)).size,assetEntries:t,envWritten:e.env!==null,written:n,resolvedCollisions:e.collisions.length}}async function va(e,t,n){await oe(e,{recursive:!0}),await w(h(f(e),`.gitignore`),`# Auto-generated by kick typegen
|
|
2447
2447
|
*
|
|
2448
|
-
`,`utf-8`);let r=t.filter(e=>e.outFile).map(e=>e.outFile);return await
|
|
2448
|
+
`,`utf-8`);let r=t.filter(e=>e.outFile).map(e=>e.outFile);return await ba(e,r,t,n),r}async function ya(e={}){let t=ha(e),{srcDir:n,silent:r,cwd:i}=t,a={...t,allowDuplicates:!0,runPlugins:!1},o=process.env.KICKJS_WATCH_POLLING===`1`||process.env.KICKJS_WATCH_POLLING===`true`,[{runAllPluginTypegens:s},{loadKickConfig:c}]=await Promise.all([Promise.resolve().then(()=>Na),Promise.resolve().then(()=>Te)]),l=await c(i),u=async()=>{try{await ga({...a})}catch(e){if(r)return;if(e instanceof qi)console.error(`
|
|
2449
2449
|
`+e.message+`
|
|
2450
|
-
`);else{let t=e instanceof Error?e.message:String(e);console.error(` kick typegen failed: ${t}`)}}},d=async()=>{try{let e=await s({cwd:i,config:l,silent:!0});await
|
|
2451
|
-
(dry run — no files were written)`),console.log()}async function
|
|
2450
|
+
`);else{let t=e instanceof Error?e.message:String(e);console.error(` kick typegen failed: ${t}`)}}},d=async()=>{try{let e=await s({cwd:i,config:l,silent:!0});await va(t.outDir,e,!0)}catch{}};await u(),await d();let{watch:f}=await import(`node:fs`),p=null,m=e=>{e&&/\.(ts|tsx|mts|cts)$/.test(e)&&(e.includes(`.kickjs`)||e.endsWith(`.d.ts`)||(p&&clearTimeout(p),p=setTimeout(()=>{u().then(d)},100)))};if(o){r||console.log(` kick typegen: polling mode (KICKJS_WATCH_POLLING)`);let e=setInterval(()=>{u().then(d)},2e3);return()=>clearInterval(e)}let h;try{h=f(n,{recursive:!0},(e,t)=>{m(t)})}catch(e){r||console.warn(` kick typegen: watch mode unavailable (${e?.message??e}). Falling back to polling.`);let t=setInterval(()=>{u().then(d)},2e3);return()=>clearInterval(t)}return()=>{p&&clearTimeout(p),h.close()}}async function ba(e,t,n,r){let i=new Set;for(let e of t)i.add(d(e));for(let e of n)e.outFile&&i.add(d(e.outFile));let a;try{a=await se(e)}catch{return[]}let o=[];for(let t of a){if(!xa.has(t)||i.has(t))continue;let n=v(e,t);try{if(!(await le(n)).isFile())continue;await ue(n),o.push(t)}catch{}}return o.length>0&&!r&&console.log(` kick typegen: swept ${o.length} stale file(s): ${o.join(`, `)}`),o}const xa=new Set([`assets.d.ts`,`env.ts`,`routes.ts`,`registry.d.ts`,`services.d.ts`,`modules.d.ts`,`plugins.d.ts`,`augmentations.d.ts`,`index.d.ts`]),Sa=[`agents`,`claude`,`skills`,`gemini`,`copilot`,`both`,`all`];function J(e){return e.parent?.opts()?.dryRun??!1}function Y(e,t=!1){let n=process.cwd();console.log(`\n ${t?`Would generate`:`Generated`} ${e.length} file${e.length===1?``:`s`}:`);for(let t of e)console.log(` ${t.replace(n+`/`,``)}`);t&&console.log(`
|
|
2451
|
+
(dry run — no files were written)`),console.log()}async function Ca(e){if(!e)try{let e=await A(process.cwd());await ga({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 wa=[{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:`job <name>`,description:`Queue @Job processor`},{name:`config`,description:`Generate kick.config.ts`},{name:`agents`,description:`Regenerate AGENTS.md + CLAUDE.md + kickjs-skills.md from upstream templates`}],Ta=new Set(wa.map(e=>e.name.split(` `)[0]));async function Ea(){console.log(`
|
|
2452
2452
|
Built-in generators:
|
|
2453
|
-
`);let e=Math.max(...
|
|
2453
|
+
`);let e=Math.max(...wa.map(e=>e.name.length));for(let t of wa)console.log(` kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await A(process.cwd()),n=Le(t?.plugins??[],t?.commands??[]),r=await cn(process.cwd(),n.generators);if(r.generators.length>0){console.log(`
|
|
2454
2454
|
Plugin generators:
|
|
2455
2455
|
`);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(`
|
|
2456
2456
|
Failed to load:
|
|
2457
|
-
`);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}async function
|
|
2458
|
-
Use -m to scope it to a module: kick g middleware auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=
|
|
2459
|
-
Use -m to scope it to a module: kick g guard admin -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=
|
|
2457
|
+
`);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}async function Da(e,t,n){let r=await A(process.cwd()),i=k(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??An(i.repo);t.repo&&ke(t.repo);let s=t.pattern??r?.pattern??`rest`,c=t.pluralize===!1?!1:i.pluralize??!0,l=je(r,process.cwd()),u=i.style??`define`;if(!n&&u===`define`){let e=await _r(v(a),`define`);if(e.length>0){console.error(`\n ${D.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n ${D.dim(`Project setting:`)} modules.style: 'define' (default)\n\n ${D.bold(`Files needing migration:`)}`);for(let t of e.slice(0,5))console.error(` - ${t}`);e.length>5&&console.error(` … and ${e.length-5} more`),console.error(`\n ${D.bold(`Pick one:`)}\n 1. Migrate everything to defineModule:\n ${D.dim(`$`)} kick codemod modules --experimental --apply\n 2. Keep the class form — pin it in kick.config.ts:\n ${D.dim(`// kick.config.ts`)}\n ${D.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let d=[];for(let r of e){let e=await jn({name:r,modulesDir:v(a),noEntity:t.entity===!1,noTests:t.tests===!1,repo:o,minimal:t.minimal,force:t.force,pattern:s,dryRun:n,pluralize:c,prismaClientPath:i.prismaClientPath,tokenScope:l,style:i.style});d.push(...e)}Y(d,n),await Ca(n)}function Oa(e,t){let n=e.command(`generate [names...]`).alias(`g`).description("Generate code scaffolds — bare form `kick g <name>` is shorthand for `kick g module <name>`").option(`--list`,`List all available generators`).option(`--dry-run`,`Preview files that would be generated without writing them`).option(`--no-entity`,`Skip entity and value object generation (module shortcut)`).option(`--no-tests`,`Skip test file generation (module shortcut)`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name (e.g. postgres)`).option(`--pattern <pattern>`,`Override project pattern: rest | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,r,i)=>{if(r.list){await Ea();return}if(!e||e.length===0){n.help();return}let a=J(i);j(a);let[o,s,...c]=e;if(o){let e=await A(process.cwd()),n=Le(e?.plugins??[],e?.commands??[]),i=await sn({generatorName:o,itemName:s??``,args:c,flags:r,cwd:process.cwd(),projectRoot:t?.projectRoot},n.generators);if(i){Y(i.files,a);return}if(o!==`module`&&Ta.has(o)){console.error(`\n '${o}' is a generator, not a module name.`),console.error(` Did you mean: kick g ${o} ${s??`<name>`}`),console.error(` If that errors, your @forinda/kickjs-cli is older than the '${o}' generator — upgrade it.\n`),process.exitCode=1;return}}await Da(e,r,a)});n.command(`module <names...>`).description(`Generate one or more modules (e.g. kick g module user task project)`).option(`--no-entity`,`Skip entity and value object generation`).option(`--no-tests`,`Skip test file generation`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name (e.g. postgres)`).option(`--pattern <pattern>`,`Override project pattern: rest | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t,n)=>{let r=J(n);j(r),await Da(e,{...n.optsWithGlobals(),...t},r)}),n.command(`adapter <name>`).description(`Generate an AppAdapter with lifecycle hooks and middleware support`).option(`-o, --out <dir>`,`Output directory`,`src/adapters`).action(async(e,t,n)=>{let r=J(n);j(r),Y(await zn({name:e,outDir:v(t.out)}),r)}),n.command(`plugin <name>`).description(`Generate a KickPlugin with DI, modules, adapters, middleware, and lifecycle hooks`).option(`-o, --out <dir>`,`Output directory`,`src/plugins`).action(async(e,t,n)=>{let r=J(n);j(r),Y(await Bn({name:e,outDir:v(t.out)}),r)}),n.command(`middleware <name>`).description(`Generate an Express middleware function
|
|
2458
|
+
Use -m to scope it to a module: kick g middleware auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=J(n);j(r);let i=await A(process.cwd()),a=k(i),o=a.dir??`src/modules`;Y(await Hn({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`guard <name>`).description(`Generate a route guard (auth, roles, etc.)
|
|
2459
|
+
Use -m to scope it to a module: kick g guard admin -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=J(n);j(r);let i=await A(process.cwd()),a=k(i),o=a.dir??`src/modules`;Y(await Un({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`contributor <name>`).description(`Generate a Context Contributor (typed alternative to @Middleware for ctx.set)
|
|
2460
2460
|
--type http (default, RequestContext) | bare (ExecutionContext)
|
|
2461
2461
|
--params "source:string,region:number" → emits the withParams<T>() form
|
|
2462
|
-
Use -m to scope it to a module: kick g contributor tenant -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).option(`-t, --type <type>`,`Contributor flavour: http | bare`,`http`).option(`-k, --key <key>`,`Context key it writes (defaults to camelCase of name)`).option(`--params <fields>`,`Per-call params, e.g. "source:string,region:number"`).action(async(e,t,n)=>{let r=
|
|
2463
|
-
Use -m to scope it to a module: kick g service payment -m orders`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=
|
|
2464
|
-
Use -m to scope it to a module: kick g controller auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=
|
|
2465
|
-
Use -m to scope it to a module: kick g dto create-user -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=
|
|
2466
|
-
Use -m to scope it to a module: kick g test user-service -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module's __tests__/ folder`).action(async(e,t,n)=>{let r=
|
|
2462
|
+
Use -m to scope it to a module: kick g contributor tenant -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).option(`-t, --type <type>`,`Contributor flavour: http | bare`,`http`).option(`-k, --key <key>`,`Context key it writes (defaults to camelCase of name)`).option(`--params <fields>`,`Per-call params, e.g. "source:string,region:number"`).action(async(e,t,n)=>{let r=J(n);j(r);let i=(t.type??`http`).toLowerCase();i!==`http`&&i!==`bare`&&(console.warn(` kick g contributor: unknown --type '${t.type}', using 'http'.`),i=`http`);let a=await A(process.cwd()),o=k(a),s=o.dir??`src/modules`;Y(await Kn({name:e,type:i,key:t.key,params:t.params,outDir:t.out,moduleName:t.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),r)}),n.command(`service <name>`).description(`Generate a @Service() class
|
|
2463
|
+
Use -m to scope it to a module: kick g service payment -m orders`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=J(n);j(r);let i=await A(process.cwd()),a=k(i),o=a.dir??`src/modules`;Y(await qn({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`controller <name>`).description(`Generate a @Controller() class with basic routes
|
|
2464
|
+
Use -m to scope it to a module: kick g controller auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=J(n);j(r);let i=await A(process.cwd()),a=k(i),o=a.dir??`src/modules`;Y(await Jn({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r),await Ca(r)}),n.command(`dto <name>`).description(`Generate a Zod DTO schema
|
|
2465
|
+
Use -m to scope it to a module: kick g dto create-user -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=J(n);j(r);let i=await A(process.cwd()),a=k(i),o=a.dir??`src/modules`;Y(await Yn({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`test <name>`).description(`Generate a Vitest test scaffold
|
|
2466
|
+
Use -m to scope it to a module: kick g test user-service -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module's __tests__/ folder`).action(async(e,t,n)=>{let r=J(n);j(r);let i=k(await A(process.cwd())),a=i.dir??`src/modules`;Y(await Tr({name:e,outDir:t.out,moduleName:t.module,modulesDir:a,pluralize:i.pluralize??!0}),r)}),n.command(`job <name>`).description(`Generate a @Job queue processor with @Process handlers`).option(`-o, --out <dir>`,`Output directory`,`src/jobs`).option(`-q, --queue <name>`,`Queue name (default: <name>-queue)`).action(async(e,t,n)=>{let r=J(n);j(r),Y(await vr({name:e,outDir:v(t.out),queue:t.queue}),r)}),n.command(`scaffold <name> [fields...]`).description(`Generate a full CRUD module from field definitions
|
|
2467
2467
|
Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
|
|
2468
2468
|
Types: string, text, number, int, float, boolean, date, email, url, uuid, json, enum:a,b,c
|
|
2469
2469
|
Optional: append :optional (shell-safe): description:text:optional
|
|
2470
|
-
or use ? with quoting: "description:text?" or "description?:text"`).option(`--no-entity`,`Skip entity and value object generation`).option(`--no-tests`,`Skip test file generation`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`--modules-dir <dir>`,`Modules directory`).action(async(e,t,n,r)=>{let i=
|
|
2470
|
+
or use ? with quoting: "description:text?" or "description?:text"`).option(`--no-entity`,`Skip entity and value object generation`).option(`--no-tests`,`Skip test file generation`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`--modules-dir <dir>`,`Modules directory`).action(async(e,t,n,r)=>{let i=J(r);j(i),t.length===0&&(console.error(`
|
|
2471
2471
|
Error: At least one field is required.
|
|
2472
2472
|
Usage: kick g scaffold <name> <field:type> [field:type...]
|
|
2473
2473
|
Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
|
|
2474
2474
|
Optional: append :optional (shell-safe, no quoting needed)
|
|
2475
|
-
`),process.exit(1));let a=await
|
|
2476
|
-
`,d=``;if(r(a)&&(d=await
|
|
2477
|
-
`,`utf-8`),s(` ✓ wrote manifest → ${_(n,p)} (${Object.keys(d).length} entries)`),{manifestPath:p,entries:u,manifest:f}}async function
|
|
2475
|
+
`),process.exit(1));let a=await A(process.cwd()),o=k(a),s=n.modulesDir??o.dir??`src/modules`,c=br(t),l=je(a,process.cwd()),u=await xr({name:e,fields:c,modulesDir:v(s),noEntity:n.entity===!1,noTests:n.tests===!1,pluralize:n.pluralize===!1?!1:o.pluralize??!0,tokenScope:l,style:o.style});console.log(`\n Scaffolded ${e} with ${c.length} field(s):`);for(let e of c)console.log(` ${e.name}: ${e.type}${e.optional?` (optional)`:``}`);Y(u,i),await Ca(i)}),n.command(`config`).description(`Generate a kick.config.ts at the project root`).option(`--modules-dir <dir>`,`Modules directory path`,`src/modules`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name`,`inmemory`).option(`-f, --force`,`Overwrite existing kick.config.ts without prompting`).action(async(e,t)=>{let n=J(t);j(n),Y(await Xn({outDir:v(`.`),modulesDir:e.modulesDir,defaultRepo:e.repo,force:e.force}),n)}),n.command(`agents`).alias(`agent-docs`).alias(`ai-docs`).description(`Regenerate AGENTS.md + CLAUDE.md + kickjs-skills.md (sync after framework upgrades)`).option(`--only <which>`,`Limit scope: agents | claude | skills | 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`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t)=>{let n=J(t);j(n);let r=e.only??`all`;if(!Sa.includes(r)){console.error(` Invalid --only value: ${r}. Expected: ${Sa.join(` | `)}`),process.exitCode=1;return}Y(await rr({outDir:v(`.`),only:r,name:e.name,pm:e.pm,template:e.template,force:e.force}),n)});for(let e of t?.generators??[])ka(n,e,t?.projectRoot)}function ka(e,t,n){let{source:r,spec:i}=t,a=i.args?.[0],o=a?.name??`itemName`,s=a?.required?`<${o}>`:`[${o}]`,c=`${i.name} ${s} [extraArgs...]`,l=e.command(c).description(`${i.description} [${r}]`);for(let e of i.flags??[]){let t=e.takesValue?`--${e.name} <value>`:`--${e.name}`,n=e.alias?`-${e.alias}, ${t}`:t;l.option(n,e.description??``)}l.action(async(e,r,a,o)=>{let s=J(o);j(s);let c=await sn({generatorName:i.name,itemName:e??``,args:r??[],flags:a,cwd:process.cwd(),projectRoot:n},[t]);c&&Y(c.files,s)})}async function Aa(e){let t=u.resolve(e.cwd,`.kickjs/types`);await oe(t,{recursive:!0});let n=new Map,i=e.scan??Hi,a=u.resolve(e.cwd,`.kickjs`,`cache`),o=e.scan?void 0:e.changedFiles,s={cwd:e.cwd,config:e.config,async importTs(e){return await import(x(e).href)},async writeFile(t,n){let r=u.resolve(e.cwd,t);await oe(u.dirname(r),{recursive:!0}),await w(r,n,`utf8`)},getScanResult:e=>{let t=ja(e),r=n.get(t);if(!r){let s={cacheDir:a,...e};r=o?Wi(s,o):i(s),n.set(t,r)}return r},log:console},c=[];for(let n of e.plugins){let i=n.outExtension??`.d.ts`,a=u.join(t,`${n.id.replace(/\//g,`__`)}${i}`),o;try{o=await n.generate(s)}catch(e){let t=e instanceof Error?e.message:String(e);s.log.error(` ${n.id}: typegen failed (${t}) — keeping previous output`),c.push({id:n.id,status:`error`,outFile:a});continue}if(o===null){c.push({id:n.id,status:`skipped`});continue}let l=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: ${n.id} */\n\n`+o+`
|
|
2476
|
+
`,d=``;if(r(a)&&(d=await C(a,`utf8`)),d===l){c.push({id:n.id,status:`unchanged`,outFile:a});continue}if(e.check)throw Error(`kick typegen --check: drift detected for ${n.id} (${a})`);await w(a,l,`utf8`),c.push({id:n.id,status:`written`,outFile:a})}return c}function ja(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 Ma(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))}}var Na=O({applyDisableFilter:()=>Ma,runAllPluginTypegens:()=>Fa});function Pa(){let e=(process.env.LOG_LEVEL??process.env.KICKJS_LOG_LEVEL??``).toLowerCase();return e===`debug`||e===`trace`}async function Fa(e){let{enabled:t,skipped:n,unknown:r}=Ma(Le([...Qs,...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 Aa({cwd:e.cwd,config:e.config??{},plugins:t,check:e.check,changedFiles:e.changedFiles});if(!e.silent&&Pa())for(let e of n)console.log(` ${e.id}: ${e.status}`);return n}catch(t){if(!e.silent){let e=t instanceof Error?t.message:String(t);console.warn(` kick typegen plugins: skipped (${e})`)}return[]}}var Ia=O({ASSET_MANIFEST_VERSION:()=>1,buildAssets:()=>La});async function La(e,t){let{cwd:n,silent:r=!1}=t,a=t.distDir??e?.build?.outDir??`dist`,o=e?.assetMap;if(!o||Object.keys(o).length===0)return null;let s=r?()=>{}:console.log,c=v(n,a);i(c,{recursive:!0});let u=[],d={};for(let[e,t]of Object.entries(o)){let r=await Ra(e,t,n,c);u.push(r.entrySummary),Object.assign(d,r.manifestSlice),s(` ✓ ${e}: ${r.entrySummary.filesCopied} file(s) → ${r.entrySummary.dest}`)}let f={version:1,entries:d},p=h(c,`.kickjs-assets.json`);return l(p,JSON.stringify(f,null,2)+`
|
|
2477
|
+
`,`utf-8`),s(` ✓ wrote manifest → ${_(n,p)} (${Object.keys(d).length} entries)`),{manifestPath:p,entries:u,manifest:f}}async function Ra(e,t,a,o){let s=v(a,t.src),c=t.dest?v(a,t.dest):h(o,e);if(Va(c,a))return console.warn(` ⚠ assetMap.${e}.dest ('${t.dest}') resolves outside the project root — skipping copy`),{entrySummary:{namespace:e,src:t.src,dest:_(a,c),filesCopied:0},manifestSlice:{}};if(!r(s)||!Ha(s))return{entrySummary:{namespace:e,src:t.src,dest:_(a,c),filesCopied:0},manifestSlice:{}};let l=await me(t.glob??`**/*`,{cwd:s,nodir:!0,dot:!1,posix:!0});i(c,{recursive:!0});let u={},{pairs:d,collisionGroupsResolved:p}=ge(e,[...l].toSorted(),{strategy:t.keys??`auto`}),m=0;for(let{rel:e,key:t}of d){let r=h(s,e),a=h(c,e);u[t]=Ba(o,a),!za(r,a)&&(i(f(a),{recursive:!0}),n(r,a),m++)}return p>0&&console.log(` ℹ assetMap.${e}: auto-resolved ${p} basename collision(s) by keeping extensions (set 'keys: "strip"' to opt back into legacy last-write-wins behaviour, or 'keys: "with-extension"' to keep all keys verbose).`),{entrySummary:{namespace:e,src:t.src,dest:_(a,c),filesCopied:m},manifestSlice:u}}function za(e,t){if(!r(t))return!1;try{let n=c(e),r=c(t);return r.size===n.size&&r.mtimeMs>=n.mtimeMs}catch{return!1}}function Ba(e,t){return _(e,t).split(/[\\/]/).filter(Boolean).join(`/`)}function Va(e,t){let n=_(t,e);return n===``?!1:n.startsWith(`..`)||m(n)}function Ha(e){try{return c(e).isDirectory()}catch{return!1}}function Ua(e){let t=new Map;return{report(n,r){let i=r instanceof Error?r.message:String(r);t.get(n)!==i&&(t.set(n,i),e(` kick typegen: ${n} pass failed (${i}) — types in .kickjs/types may be stale`))},clear(e){t.delete(e)}}}function Wa(e){let{cwd:t,config:n}=e,r=e.debounceMs??100,i=e.pipeline??{runTypegen:async e=>(await Promise.resolve().then(()=>ma)).runTypegen(e),runAllPluginTypegens:async e=>(await Promise.resolve().then(()=>Na)).runAllPluginTypegens(e),writeTypegenArtifacts:async(e,t,n)=>(await Promise.resolve().then(()=>ma)).writeTypegenArtifacts(e,t,n),buildAssets:async(e,t)=>(await Promise.resolve().then(()=>Ia)).buildAssets(e,t)},a=n?.typegen?.schemaValidator??`zod`,o=n?.typegen?.envFile,s=u.resolve(t,n?.typegen?.outDir??`.kickjs/types`),c=n?.assetMap?Object.values(n.assetMap).map(e=>e?.src).filter(e=>typeof e==`string`&&e.length>0).map(e=>u.resolve(t,e)):[],l=!!n?.assetMap&&Object.keys(n.assetMap).length>0,d=e=>e.replaceAll(`\\`,`/`),f=c.map(d),p=e=>{let t=d(e);return f.some(e=>t===e||t.startsWith(`${e}/`))},m=Ua(e.emitWarning),h=null,g=!1,_=new Set,v=new Set,y=!1,b=!1;function x(r,c){i.runTypegen({cwd:t,silent:!0,allowDuplicates:!0,schemaValidator:a,envFile:o,srcDir:n?.typegen?.srcDir,outDir:n?.typegen?.outDir,assetMap:n?.assetMap,changedFiles:r,runPlugins:!1}).then(()=>m.clear(`scan`)).catch(e=>m.report(`scan`,e)),i.runAllPluginTypegens({cwd:t,config:n,silent:!0,changedFiles:r}).then(e=>i.writeTypegenArtifacts(s,e,!0)).then(()=>m.clear(`plugins`)).catch(e=>m.report(`plugins`,e)).finally(()=>e.onPassComplete?.()),c&&n&&i.buildAssets(n,{cwd:t,silent:!0}).catch(()=>{})}function ee(){let e=y?void 0:{changed:[..._],removed:[...v]},t=b;_.clear(),v.clear(),y=!1,b=!1,x(e,t)}return{assetSrcRoots:c,handleWatchEvent(e,t){if(!g&&!d(t).includes(`/.kickjs/`)){if(e===`unlinkDir`)y=!0,l&&(b=!0);else{if(t.endsWith(`.d.ts`))return;let n=/\.(ts|tsx|mts|cts)$/.test(t),r=p(t);if(!n&&!r)return;r&&l&&(b=!0),n&&(e===`unlink`?(v.add(t),_.delete(t)):(_.add(t),v.delete(t)))}h&&clearTimeout(h),h=setTimeout(ee,r)}},runOnce(){g||x(void 0,l)},dispose(){g=!0,h&&clearTimeout(h),h=null}}}function Ga(e){let t=h(e,`node_modules`,`.bin`),n=process.platform===`win32`;for(let e of[`tsgo`,`tsc`]){let i=n?[`${e}.CMD`,`${e}.cmd`,`${e}.exe`]:[e];for(let a of i){let i=h(t,a);if(r(i))return{cmd:i,args:[`--noEmit`],shell:n,kind:e}}}return null}function Ka(e){let t=e.spawnFn??ne,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 qa(e,t=12){let n=e.trim().split(/\r?\n/);return n.length<=t?n.join(`
|
|
2478
|
+
`):`${n.slice(0,t).join(`
|
|
2479
|
+
`)}\n… ${n.length-t} more line(s)`}function Ja(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function Ya(e,t,n={}){t&&(process.env.PORT=t);let r=Ja(n.polling),i=process.cwd(),a=await A(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await ga({cwd:i,allowDuplicates:!0,schemaValidator:o,envFile:s,srcDir:a?.typegen?.srcDir,outDir:a?.typegen?.outDir,assetMap:a?.assetMap,runPlugins:!1})}catch(e){console.warn(` kick typegen: skipped (${e?.message??e})`)}let c=v(i,a?.typegen?.outDir??`.kickjs/types`);try{await va(c,await Fa({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(x(l(v(`package.json`)).resolve(`vite`)).href);globalThis.__kickjs_typegen_owner=`kick-dev`;let d=await u({configFile:v(`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=Ga(i);e?p=Ka({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(qa(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=Wa({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(`
|
|
2478
2480
|
KickJS dev server running (Vite + @forinda/kickjs-vite)
|
|
2479
|
-
`);let
|
|
2481
|
+
`),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`,_)}function Xa(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 Ya(e.entry,e.port,{polling:e.polling,typecheck:e.typecheck})}catch(e){e.code===`ERR_MODULE_NOT_FOUND`&&e.message?.includes(`vite`)?console.error(`
|
|
2480
2482
|
Error: vite is not installed.
|
|
2481
2483
|
Run: pnpm add -D vite unplugin-swc
|
|
2482
2484
|
`):console.error(`
|
|
2483
2485
|
Dev server failed:`,e.message??e),process.exit(1)}}),e.command(`build`).description(`Build for production via Vite`).action(async()=>{console.log(`
|
|
2484
2486
|
Building for production...
|
|
2485
|
-
`);let{createRequire:e}=await import(`node:module`),{build:t}=await import(x(e(v(`package.json`)).resolve(`vite`)).href);await t({configFile:v(`vite.config.ts`)});let a=await
|
|
2487
|
+
`);let{createRequire:e}=await import(`node:module`),{build:t}=await import(x(e(v(`package.json`)).resolve(`vite`)).href);await t({configFile:v(`vite.config.ts`)});let a=await A(process.cwd()),o=a?.copyDirs??[];if(o.length>0){console.log(`
|
|
2486
2488
|
Copying directories to dist...`);for(let e of o){let t=typeof e==`string`?e:e.src,a=typeof e==`string`?h(`dist`,e):e.dest??h(`dist`,t),o=v(t),s=v(a);if(!r(o)){console.log(` ⚠ Skipped ${t} (not found)`);continue}i(s,{recursive:!0}),n(o,s,{recursive:!0}),console.log(` ✓ ${t} → ${a}`)}}if(a?.assetMap&&Object.keys(a.assetMap).length>0){console.log(`
|
|
2487
|
-
Building asset map...`);try{await
|
|
2489
|
+
Building asset map...`);try{await La(a,{cwd:process.cwd()})}catch(e){console.error(` ✗ asset build failed: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}console.log(`
|
|
2488
2490
|
Build complete.
|
|
2489
|
-
`)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await
|
|
2490
|
-
Building asset map...`);try{await
|
|
2491
|
+
`)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await A(process.cwd());if(!e?.assetMap||Object.keys(e.assetMap).length===0){console.log(` No assetMap entries — nothing to build.`);return}console.log(`
|
|
2492
|
+
Building asset map...`);try{await La(e,{cwd:process.cwd()}),console.log(`
|
|
2491
2493
|
Asset build complete.
|
|
2492
|
-
`)}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)),
|
|
2493
|
-
Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function
|
|
2494
|
-
KickJS
|
|
2495
|
-
|
|
2496
|
-
System:
|
|
2497
|
-
OS: ${he()} ${ge()} (${me()})
|
|
2498
|
-
Node: ${process.version}
|
|
2499
|
-
|
|
2500
|
-
Packages:
|
|
2501
|
-
@forinda/kickjs workspace
|
|
2502
|
-
@forinda/kickjs-vite workspace
|
|
2503
|
-
@forinda/kickjs-cli workspace
|
|
2504
|
-
`)})}const{bold:Z,dim:Q,green:ba,red:xa,yellow:Sa,blue:Ca}=k;function wa(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 Ta(e){let t=await fetch(e,{signal:AbortSignal.timeout(5e3)});if(!t.ok)throw Error(`${t.status} ${t.statusText}`);return t.json()}async function Ea(e,t){try{return await Ta(`${e}${t}`)}catch{return null}}async function Da(e){let[t,n,r,i,a]=await Promise.all([Ea(e,`/health`),Ea(e,`/metrics`),Ea(e,`/routes`),Ea(e,`/container`),Ea(e,`/ws`)]);return{health:t,metrics:n,routes:r,container:i,ws:a}}function Oa(e,t){let{health:n,metrics:r,routes:i,container:a,ws:o}=t,s=Q(`─`.repeat(60));if(console.log(),console.log(Z(` KickJS Inspector`)+Q(` → ${e}`)),console.log(s),n){let e=n.status===`healthy`?ba(`● healthy`):xa(`● `+n.status);console.log(` ${Z(`Health:`)} ${e}`)}else console.log(` ${Z(`Health:`)} ${xa(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?xa:r.errorRate>0?Sa:ba;console.log(` ${Z(`Uptime:`)} ${wa(r.uptimeSeconds)}`),console.log(` ${Z(`Requests:`)} ${r.requests}`),console.log(` ${Z(`Errors:`)} ${r.serverErrors} server, ${r.clientErrors??0} client ${Q(`(`)}${t(e+`%`)}${Q(`)`)}`)}if(a&&console.log(` ${Z(`DI:`)} ${a.count} bindings`),o&&o.enabled&&console.log(` ${Z(`WS:`)} ${o.connections??0} connections, ${o.namespaces??0} namespaces`),i?.routes?.length){console.log(),console.log(Z(` Routes`)),console.log(s),console.log(` ${Q(`METHOD`)} ${Q(`PATH`.padEnd(36))} ${Q(`CONTROLLER`)}`);for(let e of i.routes){let t=e.path.length>36?e.path.slice(0,33)+`...`:e.path.padEnd(36);console.log(` ${Ct(e.method)} ${t} ${Ca(e.controller)}.${Q(e.handler)}`)}}console.log(s),console.log()}function ka(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 Da(r);t.json?console.log(JSON.stringify(e,null,2)):Oa(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(xa(` ✖ Could not connect to ${n}`)),console.error(Q(` ${e instanceof Error?e.message:String(e)}`))),t.watch||(process.exitCode=1)}};if(t.watch){let e=async()=>{process.stdout.write(`\x1B[2J\x1B[H`),await i()};await e(),setInterval(e,5e3)}else await i()})}function Aa(e,t){let n=e.toLowerCase();return t.every(e=>n.includes(e.toLowerCase()))}function $(e,t){let n=e.toLowerCase();return t.some(e=>n.includes(e.toLowerCase()))}const ja=[{match(e,t){let n=Aa(e,[`config`,`get`])&&$(e,[`undefined`,`null`]),r=e.includes(`@Value`)&&$(e,[`undefined`,`is not defined`]);return!n&&!r?null:{confidence:n&&r?90:75,diagnosis:{id:`env-schema-not-registered`,title:`ConfigService.get() returns undefined for user-defined keys`,explanation:`Your src/index.ts is missing \`import "./config"\`. That side-effect import
|
|
2494
|
+
`)}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)),Se(e.entry,t)}),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`).action(async e=>{let t=e.inspectPort??`9229`;process.env.NODE_OPTIONS=`--inspect=0.0.0.0:${t}`,console.log(` Debugger: ws://0.0.0.0:${t}`);try{await Ya(e.entry,e.port)}catch(e){console.error(`
|
|
2495
|
+
Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function Za(){try{let e=f(b(import.meta.url));return JSON.parse(a(h(e,`..`,`package.json`),`utf-8`)).version??`unknown`}catch{return`unknown`}}const Qa=new Set(Object.values(Pt).filter(e=>e.deprecated).map(e=>e.pkg));function $a(e){let t=h(e,`package.json`);if(!r(t))return[];let n;try{n=JSON.parse(a(t,`utf-8`))}catch{return[]}let i={...n.dependencies,...n.devDependencies};return Object.keys(i).filter(e=>e===`@forinda/kickjs`||e.startsWith(`@forinda/kickjs-`)).toSorted().map(t=>{let n=null,o=h(e,`node_modules`,...t.split(`/`),`package.json`);if(r(o))try{n=JSON.parse(a(o,`utf-8`)).version??null}catch{}return{name:t,installed:n,declared:i[t]??null,deprecated:Qa.has(t)}})}function eo(e){let t=e;for(;;){if(r(h(t,`package.json`)))return t;let e=f(t);if(e===t)return null;t=e}}function to(e){e.command(`info`).description(`Print system and framework info`).action(()=>{let e=[``,` KickJS CLI v${Za()}`,``,` System:`,` OS: ${ve()} ${ye()} (${_e()})`,` Node: ${process.version}`],t=eo(process.cwd()),n=t?$a(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(`
|
|
2496
|
+
`))})}const{bold:X,dim:Z,green:no,red:ro,yellow:io,blue:ao}=D;function oo(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 so(e){let t=await fetch(e,{signal:AbortSignal.timeout(5e3)});if(!t.ok)throw Error(`${t.status} ${t.statusText}`);return t.json()}async function co(e,t){try{return await so(`${e}${t}`)}catch{return null}}async function lo(e){let[t,n,r,i,a]=await Promise.all([co(e,`/health`),co(e,`/metrics`),co(e,`/routes`),co(e,`/container`),co(e,`/ws`)]);return{health:t,metrics:n,routes:r,container:i,ws:a}}function uo(e,t){let{health:n,metrics:r,routes:i,container:a,ws:o}=t,s=Z(`─`.repeat(60));if(console.log(),console.log(X(` KickJS Inspector`)+Z(` → ${e}`)),console.log(s),n){let e=n.status===`healthy`?no(`● healthy`):ro(`● `+n.status);console.log(` ${X(`Health:`)} ${e}`)}else console.log(` ${X(`Health:`)} ${ro(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?ro:r.errorRate>0?io:no;console.log(` ${X(`Uptime:`)} ${oo(r.uptimeSeconds)}`),console.log(` ${X(`Requests:`)} ${r.requests}`),console.log(` ${X(`Errors:`)} ${r.serverErrors} server, ${r.clientErrors??0} client ${Z(`(`)}${t(e+`%`)}${Z(`)`)}`)}if(a&&console.log(` ${X(`DI:`)} ${a.count} bindings`),o&&o.enabled&&console.log(` ${X(`WS:`)} ${o.connections??0} connections, ${o.namespaces??0} namespaces`),i?.routes?.length){console.log(),console.log(X(` Routes`)),console.log(s),console.log(` ${Z(`METHOD`)} ${Z(`PATH`.padEnd(36))} ${Z(`CONTROLLER`)}`);for(let e of i.routes){let t=e.path.length>36?e.path.slice(0,33)+`...`:e.path.padEnd(36);console.log(` ${Et(e.method)} ${t} ${ao(e.controller)}.${Z(e.handler)}`)}}console.log(s),console.log()}function fo(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 lo(r);t.json?console.log(JSON.stringify(e,null,2)):uo(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(ro(` ✖ Could not connect to ${n}`)),console.error(Z(` ${e instanceof Error?e.message:String(e)}`))),t.watch||(process.exitCode=1)}};if(t.watch){let e=async()=>{process.stdout.write(`\x1B[2J\x1B[H`),await i()};await e(),setInterval(e,5e3)}else await i()})}function po(e,t){let n=e.toLowerCase();return t.every(e=>n.includes(e.toLowerCase()))}function Q(e,t){let n=e.toLowerCase();return t.some(e=>n.includes(e.toLowerCase()))}const mo=[{match(e,t){let n=po(e,[`config`,`get`])&&Q(e,[`undefined`,`null`]),r=e.includes(`@Value`)&&Q(e,[`undefined`,`is not defined`]);return!n&&!r?null:{confidence:n&&r?90:75,diagnosis:{id:`env-schema-not-registered`,title:`ConfigService.get() returns undefined for user-defined keys`,explanation:`Your src/index.ts is missing \`import "./config"\`. That side-effect import
|
|
2505
2497
|
registers the env schema with kickjs at module-load time. Without it,
|
|
2506
2498
|
ConfigService falls back to the base schema (PORT/NODE_ENV/LOG_LEVEL only)
|
|
2507
2499
|
and every user-defined key reads as undefined. @Value() may *appear* to
|
|
@@ -2513,7 +2505,7 @@ import { modules } from './modules'
|
|
|
2513
2505
|
import './config' // ← add this — registers env schema
|
|
2514
2506
|
import { bootstrap } from '@forinda/kickjs'
|
|
2515
2507
|
import { modules } from './modules'
|
|
2516
|
-
`,docs:`https://forinda.github.io/kick-js/guide/configuration.html#wiring-the-schema-at-startup`}}}},{match(e,t){let n
|
|
2508
|
+
`,docs:`https://forinda.github.io/kick-js/guide/configuration.html#wiring-the-schema-at-startup`}}}},{match(e,t){let n=Q(e,[`vitest`,`test`,`spec`,`__tests__`,`.test.`]);return Q(e,[`already registered`,`already exists`,`duplicate`,`has been registered`])?{confidence:n?85:60,diagnosis:{id:`container-not-reset-in-tests`,title:`DI container leaks between test cases`,explanation:`KickJS decorators register classes on the global Container at import time.
|
|
2517
2509
|
When vitest re-imports your modules across tests, the same class can be
|
|
2518
2510
|
registered twice and the container throws. The fix is to wipe the
|
|
2519
2511
|
container between tests so each case starts fresh.`,fix:`Add Container.reset() to a beforeEach hook in the failing test file:`,codeAfter:`import { describe, it, beforeEach } from 'vitest'
|
|
@@ -2523,7 +2515,7 @@ describe('UserController', () => {
|
|
|
2523
2515
|
beforeEach(() => Container.reset())
|
|
2524
2516
|
|
|
2525
2517
|
it('does the thing', async () => { /* ... */ })
|
|
2526
|
-
})`,docs:`https://forinda.github.io/kick-js/guide/testing.html`}}:null}},{match(e,t){return e.includes(`@Module`)||
|
|
2518
|
+
})`,docs:`https://forinda.github.io/kick-js/guide/testing.html`}}:null}},{match(e,t){return e.includes(`@Module`)||po(e,[`Module`,`is not a function`])||po(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
|
|
2527
2519
|
pattern instead: a class implements AppModule and exposes routes() that
|
|
2528
2520
|
returns the controller wiring. This was a deliberate choice — modules
|
|
2529
2521
|
become explicit values rather than metadata, which makes them easier to
|
|
@@ -2550,7 +2542,7 @@ KickRoutes["POST /users"]. The new form is per-controller, per-method,
|
|
|
2550
2542
|
and matches the actual class names so refactors propagate via
|
|
2551
2543
|
rename-symbol instead of grep.`,fix:`Update the Ctx<...> type parameter to use the namespace form:`,codeBefore:`@Post('/', { body: createUserSchema })
|
|
2552
2544
|
create(ctx: Ctx<KickRoutes['POST /users']>) { /* ... */ }`,codeAfter:`@Post('/', { body: createUserSchema, name: 'CreateUser' })
|
|
2553
|
-
create(ctx: Ctx<KickRoutes.UserController['create']>) { /* ... */ }`,docs:`https://forinda.github.io/kick-js/guide/typegen.html`}}:null}},{match(e,t){let n
|
|
2545
|
+
create(ctx: Ctx<KickRoutes.UserController['create']>) { /* ... */ }`,docs:`https://forinda.github.io/kick-js/guide/typegen.html`}}:null}},{match(e,t){let n=Q(e,[`cluster`,`workers`,`two ports`,`duplicate server`]),r=Q(e,[`kick dev`,`vite`,`eaddrinuse`,`5173`,`5174`,`two servers`]);return!n||!r?null:{confidence:85,diagnosis:{id:`cluster-in-vite-dev`,title:"Cluster mode is incompatible with `kick dev` (Vite owns the server)",explanation:`In dev mode, Vite owns the HTTP server. If your bootstrap passes
|
|
2554
2546
|
cluster: { workers: N }, the framework forks N workers, each of which
|
|
2555
2547
|
spins up its own Vite instance on a separate port. The fix landed in
|
|
2556
2548
|
v2.2.5: McpAdapter (and bootstrap()) now detects Vite dev mode and
|
|
@@ -2558,7 +2550,7 @@ silently skips cluster, with a warning. If you see this on an older
|
|
|
2558
2550
|
version, upgrade or guard the cluster option behind NODE_ENV.`,fix:`Either upgrade to v2.2.5+ or gate cluster mode on production:`,codeAfter:`export const app = await bootstrap({
|
|
2559
2551
|
modules,
|
|
2560
2552
|
cluster: process.env.NODE_ENV === 'production' ? { workers: 4 } : false,
|
|
2561
|
-
})`,docs:`https://forinda.github.io/kick-js/guide/cluster.html`}}}},{match(e,t){return
|
|
2553
|
+
})`,docs:`https://forinda.github.io/kick-js/guide/cluster.html`}}}},{match(e,t){return Q(e,[`reflect-metadata`,`Reflect.getMetadata is not a function`,`Reflect.defineMetadata`,`design:type`,`design:paramtypes`])?{confidence:90,diagnosis:{id:`reflect-metadata-missing`,title:`reflect-metadata is not loaded — DI cannot read decorator types`,explanation:`The DI container reads constructor parameter types via the
|
|
2562
2554
|
reflect-metadata polyfill. The polyfill must be imported once,
|
|
2563
2555
|
before any decorator runs. Most projects do this at the top of
|
|
2564
2556
|
src/index.ts; missing the import causes obscure "design:paramtypes"
|
|
@@ -2567,7 +2559,7 @@ import './config'
|
|
|
2567
2559
|
import { bootstrap } from '@forinda/kickjs'
|
|
2568
2560
|
import { modules } from './modules'
|
|
2569
2561
|
|
|
2570
|
-
export const app = await bootstrap({ modules })`,docs:`https://forinda.github.io/kick-js/guide/dependency-injection.html`}}:null}},{match(e,t){return
|
|
2562
|
+
export const app = await bootstrap({ modules })`,docs:`https://forinda.github.io/kick-js/guide/dependency-injection.html`}}:null}},{match(e,t){return Q(e,[`404`,`cannot get`,`cannot post`,`no route`])?{confidence:50,diagnosis:{id:`module-not-registered`,title:`A 404 may indicate a module is not in the modules array`,explanation:`KickJS only mounts modules listed in \`src/modules/index.ts\`. If you
|
|
2571
2563
|
generated a module via \`kick g module foo\` but the routes don't appear,
|
|
2572
2564
|
the most likely cause is that the module is missing from the exported
|
|
2573
2565
|
array. The CLI usually wires this automatically, but a hand-edit can
|
|
@@ -2575,24 +2567,24 @@ drop the entry.`,fix:`Open src/modules/index.ts and verify the module is in the
|
|
|
2575
2567
|
import { UserModule } from './users/user.module'
|
|
2576
2568
|
import { TaskModule } from './tasks/task.module' // ← was this missing?
|
|
2577
2569
|
|
|
2578
|
-
export const modules: AppModuleEntry[] = [UserModule(), TaskModule()]`,docs:`https://forinda.github.io/kick-js/guide/project-structure.html`}}:null}}];function
|
|
2570
|
+
export const modules: AppModuleEntry[] = [UserModule(), TaskModule()]`,docs:`https://forinda.github.io/kick-js/guide/project-structure.html`}}:null}}];function ho(e,t){let n=null;for(let r of mo){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 go(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.
|
|
2579
2571
|
export OPENAI_API_KEY="sk-..."
|
|
2580
2572
|
|
|
2581
2573
|
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:
|
|
2582
2574
|
kick add ai
|
|
2583
2575
|
|
|
2584
2576
|
Or manually:
|
|
2585
|
-
pnpm add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=
|
|
2586
|
-
`)}function
|
|
2577
|
+
pnpm add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=_o(e.cwd),s=`Error or stack trace:\n\n${e.input.trim()}`;try{let e=vo((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 _o(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://forinda.github.io/kick-js/ — prefer`,`that domain for any doc links you suggest.`,e?`The project is located at ${e}.`:``].filter(e=>e.length>0).join(`
|
|
2578
|
+
`)}function vo(e){let t=[e,yo(e),bo(e)].filter(e=>e!==null);for(let e of t)try{let t=JSON.parse(e);if(xo(t))return t}catch{continue}return null}function yo(e){let t=e.match(/```(?:json)?\s*\n([\s\S]*?)```/);return t?t[1]?.trim()??null:null}function bo(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 xo(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 So(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 To(e,t.message);(!n||n.trim().length===0)&&(process.stderr.write(`Error: no input provided.
|
|
2587
2579
|
|
|
2588
2580
|
Pass a message as a positional arg, --message flag, or pipe via stdin:
|
|
2589
2581
|
kick explain "config.get returned undefined"
|
|
2590
2582
|
pnpm test 2>&1 | kick explain
|
|
2591
|
-
`),process.exit(1));let r=
|
|
2592
|
-
`);return}if(i){
|
|
2593
|
-
`),process.exit(2)),
|
|
2594
|
-
`),process.exit(a.kind===`ok`?0:2)),
|
|
2595
|
-
`)}function
|
|
2583
|
+
`),process.exit(1));let r=Do(),i=ho(n,r);if(t.json&&i){process.stdout.write(JSON.stringify({matched:!0,...i},null,2)+`
|
|
2584
|
+
`);return}if(i){Oo(n,i.diagnosis,i.confidence);return}t.ai||(t.json&&(process.stdout.write(JSON.stringify({matched:!1},null,2)+`
|
|
2585
|
+
`),process.exit(2)),ko(n,!1),process.exit(2));let a=await go({input:n,model:t.model,cwd:r.cwd});t.json&&(process.stdout.write(JSON.stringify(Co(a),null,2)+`
|
|
2586
|
+
`),process.exit(a.kind===`ok`?0:2)),wo(n,a),process.exit(a.kind===`ok`?0:2)})}function Co(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 wo(e,t){if(t.kind===`ok`){Oo(e,t.diagnosis,-1,!0);return}if(t.kind===`unavailable`){process.stdout.write(`\n Explaining: ${jo(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback unavailable: ${t.reason}\n\n`),process.stdout.write(`${Ao(t.suggestion,` `)}\n\n`);return}process.stdout.write(`\n Explaining: ${jo(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback error: ${t.message}\n\n`)}async function To(e,t){return e&&e.trim().length>0?e:t&&t.trim().length>0?t:process.stdin.isTTY?``:Eo()}function Eo(){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 Do(){let e=process.cwd();return{cwd:e,hasFile:t=>r(v(e,t))}}function Oo(e,t,n,r=!1){let i=jo(e.trim(),200),a=r?`AI-generated — verify before applying`:Mo(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${Ao(t.explanation,` `)}\n`),process.stdout.write(`\n Fix:\n${Ao(t.fix,` `)}\n`),t.codeBefore&&process.stdout.write(`\n Before:\n${Ao(t.codeBefore,` `)}\n`),t.codeAfter&&process.stdout.write(`\n After:\n${Ao(t.codeAfter,` `)}\n`),t.docs&&process.stdout.write(`\n Docs: ${t.docs}\n`),process.stdout.write(`
|
|
2587
|
+
`)}function ko(e,t){let n=jo(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.
|
|
2596
2588
|
When @forinda/kickjs-ai ships its provider implementations,
|
|
2597
2589
|
this command will call the configured LLM with the error +
|
|
2598
2590
|
project context and return a structured fix.
|
|
@@ -2609,12 +2601,12 @@ Pass a message as a positional arg, --message flag, or pipe via stdin:
|
|
|
2609
2601
|
3. File an issue with the error text:
|
|
2610
2602
|
https://github.com/forinda/kick-js/issues/new
|
|
2611
2603
|
|
|
2612
|
-
`)}function
|
|
2604
|
+
`)}function Ao(e,t){return e.split(`
|
|
2613
2605
|
`).map(e=>`${t}${e}`).join(`
|
|
2614
|
-
`)}function
|
|
2615
|
-
`,`utf8`),process.stdout.write(`\n ✓ Wrote MCP server entry "${i}" to ${o}\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
|
|
2606
|
+
`)}function jo(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function Mo(e){return e>=90?`high confidence`:e>=70?`good match`:e>=50?`medium confidence`:`low confidence — verify manually`}function No(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(Po),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(Fo)}function Po(e){let t=v(e.entry);r(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],i=ne(process.execPath,n,{stdio:`inherit`,env:{...process.env,KICK_MCP_STDIO:`1`,NODE_ENV:process.env.NODE_ENV??`production`}});i.on(`error`,e=>{process.stderr.write(`Failed to start MCP server: ${e.message}\n`),process.exit(1)}),i.on(`exit`,(e,t)=>{if(t){process.kill(process.pid,t);return}process.exit(e??0)});let a=e=>{i.killed||i.kill(e)};process.on(`SIGINT`,()=>a(`SIGINT`)),process.on(`SIGTERM`,()=>a(`SIGTERM`))}function Fo(e){let t=process.cwd(),n=Io(t)??d(t),i=e.name??n,o=e.global?v(process.env.HOME??`.`,`.mcp.json`):v(t,e.out),s={command:`kick`,args:[`mcp`],cwd:t},c={mcpServers:{}};if(r(o))try{let e=a(o,`utf8`),t=JSON.parse(e);t&&typeof t==`object`&&t.mcpServers&&(c={mcpServers:{...t.mcpServers}})}catch(e){let t=e instanceof Error?e.message:String(e);process.stderr.write(`Error: existing ${o} is not valid JSON (${t}).\nFix the file or pass --force to overwrite the entry.\n`),process.exit(1)}c.mcpServers[i]&&!e.force&&(process.stderr.write(`Error: an entry for "${i}" already exists in ${o}.\nPass --force to overwrite it, or use --name to pick a different key.\n`),process.exit(1)),c.mcpServers[i]=s,l(o,JSON.stringify(c,null,2)+`
|
|
2607
|
+
`,`utf8`),process.stdout.write(`\n ✓ Wrote MCP server entry "${i}" to ${o}\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 Io(e){let t=v(e,`package.json`);if(!r(t))return null;try{let e=a(t,`utf8`),n=JSON.parse(e);return typeof n.name==`string`?n.name:null}catch{return null}}function Lo(e){e.command(`tinker`).description(`Interactive REPL with DI container and services loaded`).option(`-e, --entry <file>`,`Entry file to load`,`src/index.ts`).action(async e=>{let t=process.cwd(),n=v(t,e.entry);r(n)||(console.error(`\n Error: ${e.entry} not found.\n`),process.exit(1));let i=zo(t,`tsx`);i||(console.error(`
|
|
2616
2608
|
Error: tsx not found. Install it: pnpm add -D tsx
|
|
2617
|
-
`),process.exit(1));let a=
|
|
2609
|
+
`),process.exit(1));let a=Ro(n,e.entry),o=h(t,`.kick-tinker.mjs`),{writeFileSync:s,unlinkSync:c}=await import(`node:fs`);s(o,a,`utf-8`);try{let e=te(o,[],{cwd:t,execPath:i,stdio:`inherit`});await new Promise(t=>{e.on(`exit`,()=>t())})}finally{try{c(o)}catch{}}})}function Ro(e,t){return`
|
|
2618
2610
|
import 'reflect-metadata'
|
|
2619
2611
|
|
|
2620
2612
|
// Prevent bootstrap() from starting the HTTP server
|
|
@@ -2668,39 +2660,39 @@ server.on('exit', () => {
|
|
|
2668
2660
|
console.log('\\n Goodbye!\\n')
|
|
2669
2661
|
process.exit(0)
|
|
2670
2662
|
})
|
|
2671
|
-
`}function
|
|
2663
|
+
`}function zo(e,t){let n=e;for(;;){let e=h(n,`node_modules`,`.bin`,t);if(r(e))return e;let i=v(n,`..`);if(i===n)break;n=i}return null}function Bo(e,t){let n=RegExp(`^\\s*${z(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]!==`
|
|
2672
2664
|
`;)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]===`
|
|
2673
|
-
`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t;continue}i=s+1}return{content:a,changed:r}}function
|
|
2665
|
+
`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t;continue}i=s+1}return{content:a,changed:r}}function Vo(e,t){let n=Pn(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=Bo(a,t).content,a=a.replace(RegExp(`\\s*,?\\s*${z(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 Ho(e){let{name:t,modulesDir:n,force:r}=e,i=e.pluralize!==!1,a=R(t),o=I(t),s=i?Kt(a):a,c=h(n,s);if(!await Ke(c)){console.log(`\n Module not found: ${c}\n`);return}if(!r&&!await P({message:D.red(`Delete module '${s}' at ${c}? This cannot be undone.`),initialValue:!1})){console.log(`
|
|
2674
2666
|
Cancelled.
|
|
2675
|
-
`);return}await
|
|
2667
|
+
`);return}await ce(c,{recursive:!0,force:!0}),console.log(` Deleted: ${c}`);let l=h(n,`index.ts`);if(await Ke(l)){let e=await C(l,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${z(o)}Module\\s*\\}\\s*from\\s*['"][^'"]*${z(s)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=Vo(e,o),e=e.replace(/\n{3,}/g,`
|
|
2676
2668
|
|
|
2677
|
-
`),e!==t&&(await
|
|
2669
|
+
`),e!==t&&(await w(l,e,`utf-8`),console.log(` Unregistered: ${o}Module from ${l}`))}console.log(`\n Module '${s}' removed.\n`)}function Uo(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=k(await A(process.cwd())),r=t.modulesDir??n.dir??`src/modules`,i=t.pluralize===!1?!1:n.pluralize??!0;for(let n of e)await Ho({name:n,modulesDir:v(r),force:t.force,pluralize:i})})}function Wo(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 Go(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function Ko(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: fail on plugin-typegen drift instead of writing`).option(`--list`,"List every registered typegen plugin id (use to populate `typegen.disable`)").action(async e=>{let t=Xt(process.cwd()),n=await A(t);if(e.list){let{mergeCliPlugins:e}=await Promise.resolve().then(()=>Re),{builtinCliPlugins:t}=await Promise.resolve().then(()=>Zs),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(`
|
|
2678
2670
|
Registered typegen plugins:
|
|
2679
|
-
`);for(let e of r.typegens){let t=i.has(e.id)?` (disabled)`:``;console.log(` ${e.id.padEnd(a+2)}inputs: ${e.inputs.join(`, `)||`(none)`}${t}`)}console.log();return}let r=
|
|
2671
|
+
`);for(let e of r.typegens){let t=i.has(e.id)?` (disabled)`:``;console.log(` ${e.id.padEnd(a+2)}inputs: ${e.inputs.join(`, `)||`(none)`}${t}`)}console.log();return}let r=Wo(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=Go(e.envFile)??n?.typegen?.envFile,a={cwd:t,srcDir:e.src??n?.typegen?.srcDir,outDir:e.out??n?.typegen?.outDir,silent:e.silent,allowDuplicates:e.allowDuplicates,schemaValidator:r,envFile:i,assetMap:n?.assetMap,runPlugins:!1};try{if(e.watch){let t=await ya(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 ga(a);let r=await Fa({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 va(v(t,e.out??n?.typegen?.outDir??`.kickjs/types`),r,e.silent??!1)}}catch(e){e instanceof qi?console.error(`
|
|
2680
2672
|
`+e.message+`
|
|
2681
|
-
`):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}function
|
|
2673
|
+
`):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}function qo(e){let t=[];if(!r(e))return t;let n=o(e,{withFileTypes:!0});for(let r of n){let n=h(e,r.name);if(r.isDirectory()){if([`node_modules`,`dist`,`.kickjs`,`.git`].includes(r.name))continue;t.push(...qo(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function Jo(e){try{return a(e,`utf-8`)}catch{return``}}const Yo=new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function Xo(e,t){let n=Jo(h(e,`.env`));if(n){let e=n.match(/^JWT_SECRET\s*=\s*['"]?([^'"\n]*)['"]?/m);if(e){let t=e[1].trim();if(Yo.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 Zo(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 Qo(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 $o(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function es(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 ts(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 ns(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 rs(e){let t=qo(h(e,`src`)).map(e=>Jo(e)),n=[],r=Xo(e,t);r&&n.push(r);let i=Zo(t);i&&n.push(i);let a=Qo(t);a&&n.push(a);let o=$o();o&&n.push(o);let s=es(t);return s&&n.push(s),n.push(ts(t)),n.push(ns(t)),n}function is(e){e.command(`check`).description(`Audit project for common issues`).option(`--deploy`,`Run production readiness checks`).action(e=>{if(!e.deploy){console.log(`
|
|
2682
2674
|
Usage: kick check --deploy
|
|
2683
2675
|
|
|
2684
2676
|
Available checks:
|
|
2685
2677
|
--deploy Audit for production readiness (security, config, best practices)
|
|
2686
|
-
`);return}let t=process.cwd();
|
|
2687
|
-
Install a supported version via nvm / fnm / volta.`}:{name:`Node version`,status:`pass`,message:e}}function
|
|
2678
|
+
`);return}let t=process.cwd();Ot(`KickJS Deploy Check`);let n=Nt();n.start(`Scanning project...`);let r=rs(t);n.stop(`Scan complete`);let i={CRITICAL:0,WARNING:1,INFO:2};r.sort((e,t)=>i[e.severity]-i[t.severity]);for(let e of r)F.message(`${Dt(e.severity)} ${e.message}`);let a=r.filter(e=>e.severity===`CRITICAL`).length,o=r.filter(e=>e.severity===`WARNING`).length,s=r.filter(e=>e.severity===`INFO`).length,c=o===1?`warning`:`warnings`,l=[a>0?D.red(`${a} critical`):`${a} critical`,o>0?D.yellow(`${o} ${c}`):`${o} ${c}`,`${s} info`].join(`, `);a>0?(N(D.red(`${l} — fix critical issues before deploying`)),process.exit(1)):N(D.green(`${l} — looking good!`))})}function as(e){try{return JSON.parse(a(e,`utf-8`))}catch{return null}}function os(e){try{return a(e,`utf-8`)}catch{return null}}function ss(e){let t=os(h(e,`tsconfig.json`));if(!t)return null;let n=t.replace(/\/\*[\s\S]*?\*\//g,``).replace(/\/\/.*$/gm,``),r;try{r=JSON.parse(n)}catch{return null}if(typeof r?.extends==`string`){let t=cs(e,r.extends);if(t){let e=as(t)??{};r.compilerOptions={...e.compilerOptions,...r.compilerOptions}}}return r}function cs(e,t){if(t.startsWith(`.`)){let n=v(e,t);return r(n)?n:null}let n=h(e,`node_modules`,t);return r(n)?n:null}function ls(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}function us(){let e=process.version,t=Number.parseInt(e.replace(/^v/,``).split(`.`)[0],10);return Number.isNaN(t)||t<20?{name:`Node version`,status:`fail`,message:e,fix:`KickJS requires Node 20 or newer.
|
|
2679
|
+
Install a supported version via nvm / fnm / volta.`}:{name:`Node version`,status:`pass`,message:e}}function ds(e){if(!e.pkg)return{name:`@forinda/kickjs installed`,status:`warn`,message:`no package.json`};let t={...e.pkg.dependencies,...e.pkg.peerDependencies};return t[`@forinda/kickjs`]?{name:`@forinda/kickjs installed`,status:`pass`,message:t[`@forinda/kickjs`]}:{name:`@forinda/kickjs installed`,status:`fail`,fix:"This directory does not look like a KickJS project — `@forinda/kickjs` is not in your package.json. Run `kick doctor` from the project root, or scaffold a fresh project with `kick new <name>`."}}function fs(e){if(!e.pkg)return null;let t={...e.pkg.dependencies,...e.pkg.peerDependencies};return t[`@forinda/kickjs`]&&!t.express?{name:`express installed`,status:`fail`,fix:"`@forinda/kickjs` declares `express` as a required peer dependency, but your package.json does not include it. Install: pnpm add express"}:t.express?{name:`express installed`,status:`pass`,message:t.express}:null}function ps(e){if(!e.pkg)return{name:`reflect-metadata installed`,status:`warn`,message:`no package.json`};let t={...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies};return t[`reflect-metadata`]?{name:`reflect-metadata installed`,status:`pass`,message:t[`reflect-metadata`]}:{name:`reflect-metadata installed`,status:`fail`,fix:`KickJS decorators require the reflect-metadata polyfill.
|
|
2688
2680
|
Install it: pnpm add reflect-metadata
|
|
2689
2681
|
Then import it at the top of src/index.ts:
|
|
2690
2682
|
|
|
2691
2683
|
import 'reflect-metadata'
|
|
2692
|
-
// ... rest of bootstrap`}}function
|
|
2693
|
-
`).map(e=>` ${
|
|
2694
|
-
`)}function
|
|
2684
|
+
// ... rest of bootstrap`}}function ms(e){if(!e.tsconfig)return[{name:`tsconfig.json present`,status:`fail`,fix:"Create a tsconfig.json with `experimentalDecorators: true` and `emitDecoratorMetadata: true`. `kick new` scaffolds one automatically."}];let t=e.tsconfig.compilerOptions??{},n=[];return n.push(t.experimentalDecorators===!0?{name:`tsconfig: experimentalDecorators`,status:`pass`}:{name:`tsconfig: experimentalDecorators`,status:`fail`,fix:'Add `"experimentalDecorators": true` to compilerOptions in tsconfig.json. Without it, @Service / @Controller / @Get etc. don\'t register any metadata at compile time.'}),n.push(t.emitDecoratorMetadata===!0?{name:`tsconfig: emitDecoratorMetadata`,status:`pass`}:{name:`tsconfig: emitDecoratorMetadata`,status:`fail`,fix:'Add `"emitDecoratorMetadata": true` to compilerOptions in tsconfig.json. The DI container uses this metadata for constructor-parameter injection.'}),n}function hs(e){let t=[`src/env.ts`,`src/env/index.ts`,`src/config/env.ts`,`src/config/index.ts`].map(t=>h(e.cwd,t)).filter(e=>r(e)).filter(e=>/\bloadEnv\s*\(/.test(os(e)??``));if(t.length===0)return null;let n=[`src/index.ts`,`src/main.ts`].map(t=>h(e.cwd,t)).find(e=>r(e));if(!n)return{name:`env wiring`,status:`warn`,message:`env-init file exists but no src/index.ts or src/main.ts found`};let i=os(n)??``,a=f(n),o=[];for(let e of t){let t=_(a,e).replace(/\\/g,`/`).replace(/\.ts$/,``),n=t.startsWith(`.`)?t:`./`+t,r=n.replace(/\/index$/,``);o.push(n,r);let i=e.replace(/\\/g,`/`).match(/\/src\/(.+?)(?:\.ts)?$/);if(i){let e=`@/`+i[1],t=e.replace(/\/index$/,``);o.push(e,t)}}let s=-1;for(let e of new Set(o)){let t=RegExp(`^import\\s+(?:.*?from\\s+)?['"]${ls(e)}['"]`,`m`),n=i.match(t);n&&n.index!==void 0&&(s===-1||n.index<s)&&(s=n.index)}let c=i.search(/\bbootstrap\s*\(/),l=t.map(t=>_(e.cwd,t).replace(/\\/g,`/`)).join(`, `);return s===-1?{name:`env wiring`,status:`fail`,message:l,fix:`An env-init file (${l}) calls \`loadEnv(...)\` but \`${_(e.cwd,n).replace(/\\/g,`/`)}\` doesn't import it.\nWithout this, ConfigService.get('X') returns undefined while @Value('X') works via process.env fallback — a half-broken config you won't notice until something is missing.\n\nFix: add a side-effect import at the top of ${_(e.cwd,n).replace(/\\/g,`/`)} (above bootstrap()), pointing at one of the detected files. For example:\n\n import './env'\n // or\n import './config'\n // or, with the @/ alias:\n import '@/config/env'`}:c!==-1&&s>c?{name:`env wiring`,status:`warn`,message:`env-init imported AFTER bootstrap() — should be before`,fix:`Move the env import above the bootstrap() call so the schema runs before any service reads from ConfigService.`}:{name:`env wiring`,status:`pass`}}function gs(e,t=_s){let n=0,r=0,i=[e];for(;i.length>0&&r<t;){let e=i.pop(),a;try{a=o(e,{withFileTypes:!0})}catch{continue}for(let o of a){if(r>=t)break;r++;let a=h(e,o.name);if(o.isDirectory()){i.push(a);continue}try{let e=c(a).mtimeMs;e>n&&(n=e)}catch{}}}return n}const _s=2e3;function vs(e){let t=h(e.cwd,`.kickjs`,`types`);if(!r(t))return null;let n=gs(t);if(n===0)return null;let i=Date.now()-n,a=Math.floor(i/6e4);return a>60?{name:`typegen freshness`,status:`warn`,message:`last updated ${a} minutes ago`,fix:"Re-run `kick typegen` (or `kick dev`, which runs it on every reload) so generated types match the current code."}:{name:`typegen freshness`,status:`pass`,message:a===0?`just now`:`${a}m ago`}}const ys=[()=>us(),ds,fs,ps,ms,hs,vs];async function bs(e,t={}){let n={cwd:e,pkg:as(h(e,`package.json`)),tsconfig:ss(e)},r=[...ys,...t.extraChecks??[]],i=[];for(let e of r){let t;try{t=await e(n)}catch(t){i.push({name:e.name||`doctor check`,status:`fail`,message:t instanceof Error?t.message:String(t)});continue}t!=null&&(Array.isArray(t)?i.push(...t):i.push(t))}return i}function xs(e){switch(e){case`pass`:return D.green(`✔`);case`warn`:return D.yellow(`⚠`);case`fail`:return D.red(`✖`)}}function Ss(e){let t=xs(e.status),n=e.message?` ${D.dim(`(${e.message})`)}`:``;return`${t} ${e.name}${n}`}function Cs(e){return e.split(`
|
|
2685
|
+
`).map(e=>` ${D.dim(`→`)} ${e}`).join(`
|
|
2686
|
+
`)}function ws(e){return e?.doctor?.checks??[]}function Ts(e){e.command(`doctor`).description(`Pre-flight checks for your KickJS project (dev environment health)`).action(async()=>{let e=process.cwd(),t=ws(await A(e));Ot(`KickJS Doctor`);let n=await bs(e,{extraChecks:t});for(let e of n)F.message(Ss(e)),e.fix&&e.status!==`pass`&&F.message(Cs(e.fix));let r=n.filter(e=>e.status===`pass`).length,i=n.filter(e=>e.status===`warn`).length,a=n.filter(e=>e.status===`fail`).length,o=[D.green(`${r} passed`),i>0?D.yellow(`${i} warning${i===1?``:`s`}`):`${i} warnings`,a>0?D.red(`${a} error${a===1?``:`s`}`):`${a} errors`].join(`, `);a>0?(N(`${o} — fix the errors above before running the app`),process.exit(1)):N(i>0?`${o} — review the warnings`:D.green(`${o} — your environment looks good`))})}function Es(e){return e.optsWithGlobals().dryRun??!1}function Ds(e){e.command(`codemod`).description(`Codebase migration commands (AST-style rewrites — distinct from db migrate)`).command(`modules`).description(`Rewrite module declarations between class form and the defineModule factory.
|
|
2695
2687
|
Direction defaults to \`modules.style\` from kick.config (or "define").
|
|
2696
2688
|
--target define|class Override the migration direction.
|
|
2697
2689
|
--apply Apply the changes (default: dry-run preview).
|
|
2698
|
-
--experimental Acknowledge that AST migration is experimental.`).option(`--modules-dir <dir>`,`Modules directory (default: src/modules from kick.config)`).option(`--apply`,`Apply the migration to disk (default: dry-run)`).option(`--experimental`,`Acknowledge that this command is experimental`).option(`--target <style>`,`Migration direction — 'define' or 'class'`).option(`--no-backup`,`Skip the .kickjs/codemod-backups/ snapshot (default: backup on)`).action(async(e,t)=>{let n=
|
|
2699
|
-
`+
|
|
2690
|
+
--experimental Acknowledge that AST migration is experimental.`).option(`--modules-dir <dir>`,`Modules directory (default: src/modules from kick.config)`).option(`--apply`,`Apply the migration to disk (default: dry-run)`).option(`--experimental`,`Acknowledge that this command is experimental`).option(`--target <style>`,`Migration direction — 'define' or 'class'`).option(`--no-backup`,`Skip the .kickjs/codemod-backups/ snapshot (default: backup on)`).action(async(e,t)=>{let n=Es(t)||!e.apply;j(n),e.experimental||(console.error(`
|
|
2691
|
+
`+D.red(`Error:`)+` kick codemod modules is experimental — pass --experimental to acknowledge.
|
|
2700
2692
|
The regex-based rewrite handles the shapes our templates produce.
|
|
2701
2693
|
Hand-rolled modules with non-standard structures may be skipped.
|
|
2702
2694
|
Always commit before running with --apply.
|
|
2703
|
-
`),process.exit(1));let r=
|
|
2695
|
+
`),process.exit(1));let r=k(await A(process.cwd())),i=v(e.modulesDir??r.dir??`src/modules`),a;e.target===`define`||e.target===`class`?a=e.target:e.target===void 0?a=r.style??`define`:(console.error(`\n ${D.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let o=D.dim(`→ ${a}`),s=n?D.dim(`(dry-run)`):D.bold(`(applying)`);console.log(`\n ${D.bold(`kick codemod modules`)} ${o} ${s}`),console.log(` modulesDir: ${D.dim(i)}\n`);let c=e.backup!==!1&&!n,l=await gr(i,{dryRun:n,target:a,backup:c});if(l.backupDir){let e=l.backupDir;console.log(` ${D.green(`✓`)} backup: ${D.dim(e)}\n ${D.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else !n&&e.backup===!1&&console.log(` ${D.dim(`(--no-backup — skipping snapshot)`)}\n`);let u=0,d=0;for(let e of l.files)if(e.status===`migrated`)u++,console.log(` ${D.green(`✓`)} ${e.path}`);else{d++;let t=D.dim(`(${e.reason??`skipped`})`);console.log(` ${D.dim(`-`)} ${e.path} ${t}`)}if(console.log(),l.indexStatus===`migrated`)console.log(` ${D.green(`✓`)} ${l.indexPath}`);else if(l.indexStatus===`skipped`){let e=D.dim(`(${l.indexReason??`skipped`})`);console.log(` ${D.dim(`-`)} ${l.indexPath} ${e}`)}else console.log(` ${D.dim(`-`)} ${l.indexPath} ${D.dim(`(not found)`)}`);let f=n?D.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n ${D.bold(String(u))} migrated, ${D.bold(String(d))} skipped${f}\n`)})}const Os=()=>({id:`kick/assets`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`],async generate(e){if(!r(u.resolve(e.cwd,`kick.config.ts`)))return null;let t=await A(e.cwd);if(!t?.assetMap)return null;let n=ca(t.assetMap,e.cwd);return n.count===0?null:la(n)}}),ks="/* 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 As(e,t,n,r={}){if(e.length===0)return`${ks}
|
|
2704
2696
|
// (no routes discovered yet — annotate a controller method with
|
|
2705
2697
|
// @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
|
|
2706
2698
|
declare global {
|
|
@@ -2709,20 +2701,20 @@ declare global {
|
|
|
2709
2701
|
}
|
|
2710
2702
|
|
|
2711
2703
|
export {}
|
|
2712
|
-
`;let
|
|
2713
|
-
`))}return`${
|
|
2704
|
+
`;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=(e,i,o)=>{let s=Ns(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}>`},s=[];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=o(e.bodySchema,e,`body`),i=o(e.querySchema,e,`query`),a=o(e.paramsSchema,e,`params`)??t,s=r??`unknown`,c=i??js(e),l=Ms(e);n.push(` /**`,` * ${e.httpMethod} ${e.path}`,...l.map(e=>` * ${e}`),` */`,` ${e.method}: {`,` params: ${a}`,` body: ${s}`,` query: ${c}`,` response: unknown`,` }`)}n.push(` }`),s.push(n.join(`
|
|
2705
|
+
`))}return`${ks}${Ps(a)}
|
|
2714
2706
|
declare global {
|
|
2715
2707
|
// eslint-disable-next-line @typescript-eslint/no-namespace
|
|
2716
2708
|
namespace KickRoutes {
|
|
2717
|
-
${
|
|
2709
|
+
${s.join(`
|
|
2718
2710
|
`)}
|
|
2719
2711
|
}
|
|
2720
2712
|
}
|
|
2721
2713
|
|
|
2722
2714
|
export {}
|
|
2723
|
-
`}function
|
|
2715
|
+
`}function js(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 Ms(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 Ns(e,t,n,r,i){if(!e||r===!1||e.source===null)return null;let a=Fs(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 Ps(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(`
|
|
2724
2716
|
`)+`
|
|
2725
|
-
`}function
|
|
2717
|
+
`}function Fs(e,t,n){if(e===null)return`unknown`;let r=f(n);if(e===``){let e=_(r,t).split(y).join(`/`);return e=e.replace(/\.(ts|tsx|mts|cts)$/i,``),e.startsWith(`.`)||(e=`./`+e),e}if(!e.startsWith(`.`)&&!e.startsWith(`/`))return e;let i=_(r,v(f(t),e)).split(y).join(`/`);return i=i.replace(/\.(ts|tsx|mts|cts)$/i,``),i.startsWith(`.`)||(i=`./`+i),i}const Is=()=>({id:`kick/routes`,outExtension:`.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){let t=await e.getScanResult({root:Ls(e),cwd:e.cwd,envFile:Rs(e)}),n=e.config?.typegen?.schemaValidator??`zod`,r=u.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return As(t.routes,r,n,{onWarn:t=>e.log.warn(t)})}});function Ls(e){return u.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Rs(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function zs(e,t,n=`zod`){if(!e)return null;let r=_(f(t),e.filePath).split(y).join(`/`);return r=r.replace(/\.(ts|tsx|mts|cts)$/i,``),r.startsWith(`.`)||(r=`./`+r),`/* eslint-disable */
|
|
2726
2718
|
// AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
|
|
2727
2719
|
// Re-run with \`kick typegen\` or rely on \`kick dev\` to refresh.
|
|
2728
2720
|
|
|
@@ -2760,4 +2752,4 @@ declare global {
|
|
|
2760
2752
|
}
|
|
2761
2753
|
|
|
2762
2754
|
export {}
|
|
2763
|
-
`}const
|
|
2755
|
+
`}const Bs=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=Hs(e);if(t===!1)return null;let n=await e.getScanResult({root:Vs(e),cwd:e.cwd,envFile:t});if(!n.env)return null;let r=e.config?.typegen?.schemaValidator??`zod`,i=u.resolve(e.cwd,`.kickjs/types/kick__env.ts`);return zs(n.env,i,r)}});function Vs(e){return u.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Hs(e){return e.config?.typegen?.envFile}function Us(e){return u.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Ws(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function $(e){return{root:Us(e),cwd:e.cwd,envFile:Ws(e)}}const Gs=()=>({id:`kick/registry`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e)),n=u.resolve(e.cwd,`.kickjs/types/kick__registry.d.ts`),r=new Set(t.collisions.map(e=>e.className));return Zi(t.classes,n,r)}}),Ks=()=>({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 ea(`ServiceToken`,ta(t.classes,t.tokens,t.injects,n),"(no tokens discovered — declare with createToken<T>() or `kick g service <name>`)")}}),qs=()=>({id:`kick/modules`,inputs:[`src/**/*.ts`],async generate(e){return ea(`ModuleToken`,na((await e.getScanResult($(e))).classes),"(no @Module classes discovered — `kick g module <name>` to add one)")}}),Js=()=>({id:`kick/plugins`,inputs:[`src/**/*.ts`],async generate(e){return ra((await e.getScanResult($(e))).pluginsAndAdapters)}}),Ys=()=>({id:`kick/augmentations`,inputs:[`src/**/*.ts`],async generate(e){return ia((await e.getScanResult($(e))).augmentations)}}),Xs=()=>({id:`kick/context`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return t.contextKeys.length===0?null:$i(t.contextKeys)}});var Zs=O({builtinCliPlugins:()=>Qs});const Qs=[T({name:`kick/init`,register:Gt}),T({name:`kick/generate`,register:Oa}),T({name:`kick/run`,register:Xa}),T({name:`kick/info`,register:to}),T({name:`kick/inspect`,register:fo}),T({name:`kick/add`,register:Ut}),T({name:`kick/list`,register:Ht}),T({name:`kick/explain`,register:So}),T({name:`kick/mcp`,register:No}),T({name:`kick/tinker`,register:Lo}),T({name:`kick/remove`,register:Uo}),T({name:`kick/typegen`,register:Ko}),T({name:`kick/check`,register:is}),T({name:`kick/doctor`,register:Ts}),T({name:`kick/codemod`,register:Ds}),T({name:`kick/registry`,typegens:[Gs()]}),T({name:`kick/services`,typegens:[Ks()]}),T({name:`kick/modules`,typegens:[qs()]}),T({name:`kick/plugins`,typegens:[Js()]}),T({name:`kick/augmentations`,typegens:[Ys()]}),T({name:`kick/context`,typegens:[Xs()]}),T({name:`kick/assets`,typegens:[Os()]}),T({name:`kick/routes`,typegens:[Is()]}),T({name:`kick/env`,typegens:[Bs()]})],$s=f(b(import.meta.url)),ec=JSON.parse(a(h($s,`..`,`package.json`),`utf-8`));async function tc(){let e=new t;e.name(`kick`).description(`KickJS — A production-grade, decorator-driven Node.js framework`).version(ec.version);let n=Xt(process.cwd()),r=n,i=await A(r)??{},a=Le([...Qs,...i.plugins??[]],i.commands??[]);await a.register(e,{cwd:r,projectRoot:n,config:i,log:e=>console.log(e)}),Ce(e,{...i,commands:a.commands}),e.showHelpAfterError();let o=process.argv.map(e=>e===`-v`?`--version`:e);await e.parseAsync(o)}tc().catch(e=>{console.error(e instanceof Error?e.message:e),process.exitCode=1});export{};
|