@forinda/kickjs-cli 6.1.1 → 6.2.0-alpha.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/README.md +15 -2
- package/dist/{agent-docs-GpRHHdWC.mjs → agent-docs-B65qHJup.mjs} +3 -3
- package/dist/{agent-docs-GpRHHdWC.mjs.map → agent-docs-B65qHJup.mjs.map} +1 -1
- package/dist/{build-D9X9QBkC.mjs → build-C8B6v3iF.mjs} +3 -3
- package/dist/{build-D9X9QBkC.mjs.map → build-C8B6v3iF.mjs.map} +1 -1
- package/dist/{builtins-DHcybuaw.mjs → builtins-D4DM7SWf.mjs} +2 -2
- package/dist/cli.mjs +156 -154
- package/dist/{config-DLy6JCCy.mjs → config-MpY5O0Uv.mjs} +3 -3
- package/dist/config-MpY5O0Uv.mjs.map +1 -0
- package/dist/{doctor-CcVNNzGj.mjs → doctor-Da_WPc4H.mjs} +71 -63
- package/dist/doctor-Da_WPc4H.mjs.map +1 -0
- package/dist/index.d.mts +28 -0
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +2 -2
- package/dist/{plugin-C6jhcq0N.mjs → plugin-1LpIVE1p.mjs} +3 -3
- package/dist/{plugin-C6jhcq0N.mjs.map → plugin-1LpIVE1p.mjs.map} +1 -1
- package/dist/{project-docs-CqOymvmb.mjs → project-docs-DdHhz2vw.mjs} +2 -2
- package/dist/{project-docs-CqOymvmb.mjs.map → project-docs-DdHhz2vw.mjs.map} +1 -1
- package/dist/{project-root-yLxS5CqO.mjs → project-root-DEufQPY3.mjs} +3 -3
- package/dist/{project-root-yLxS5CqO.mjs.map → project-root-DEufQPY3.mjs.map} +1 -1
- package/dist/{rolldown-runtime-BnMWUWuC.mjs → rolldown-runtime-DT7Ktfzg.mjs} +1 -1
- package/dist/{run-plugins-CubT9x_A.mjs → run-plugins-DtHMyrXU.mjs} +70 -76
- package/dist/run-plugins-DtHMyrXU.mjs.map +1 -0
- package/dist/{typegen-BJwy65-p.mjs → typegen-BaE5TxzH.mjs} +5 -5
- package/dist/{typegen-BJwy65-p.mjs.map → typegen-BaE5TxzH.mjs.map} +1 -1
- package/dist/{types-D7d_Y66D.mjs → types-Btg3O9XP.mjs} +1 -1
- package/package.json +4 -4
- package/dist/config-DLy6JCCy.mjs.map +0 -1
- package/dist/doctor-CcVNNzGj.mjs.map +0 -1
- package/dist/run-plugins-CubT9x_A.mjs.map +0 -1
package/dist/cli.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs-cli v6.
|
|
2
|
+
* @forinda/kickjs-cli v6.2.0-alpha.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 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
|
|
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 C,readFile as w,readdir as oe,rm as se,stat as ce,unlink as le,writeFile as T}from"node:fs/promises";import{KickPluginConflictError as ue,defineCliPlugin as E}from"@forinda/kickjs-cli-kit";import*as D from"@clack/prompts";import O from"picocolors";import de from"pluralize";import{parseSync as fe}from"oxc-parser";import{glob as pe,globSync as me}from"glob";import{groupAssetKeys as he}from"@forinda/kickjs";import{arch as ge,platform as _e,release as ve}from"node:os";var ye=Object.defineProperty,k=(e,t)=>{let n={};for(var r in e)ye(n,r,{get:e[r],enumerable:!0});return t||ye(n,Symbol.toStringTag,{value:`Module`}),n};function be(e,t,n){S(e,{cwd:t,stdio:`inherit`,env:n?{...process.env,...n}:process.env})}function xe(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 Se(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}Ce(e,r)}}function Ce(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{be(r)}catch{console.error(` Command failed: ${t.name}`),process.exitCode=1;return}}})}var we=k({BUILTIN_REPO_TYPES:()=>Ee,DEPRECATED_REPO_TYPES:()=>De,PACKAGE_MANAGERS:()=>Te,defineConfig:()=>ke,loadKickConfig:()=>j,resolveModuleConfig:()=>A,resolveTokenScope:()=>Ae,validateAssetMap:()=>Pe,warnIfDeprecatedRepo:()=>Oe,writeAssetConfigSnapshot:()=>Ne});const Te=[`pnpm`,`npm`,`yarn`,`bun`],Ee=[`inmemory`],De=[`prisma`,`drizzle`];function Oe(e){return De.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 ke(e){return e}function Ae(e,t){if(e?.tokenScope&&typeof e.tokenScope==`string`&&e.tokenScope.length>0){let t=je(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=je(e?e[1]:t.name);if(n.length>0)return n}}}catch{}return`app`}function je(e){return e.toLowerCase().replace(/[^a-z0-9-]/g,`-`).replace(/^-+|-+$/g,``).replace(/-{2,}/g,`-`)}function A(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`&&!Ee.includes(t.repo)&&(Oe(t.repo)||console.warn(` Warning: modules.repo '${t.repo}' is not a built-in type (${Ee.join(`, `)}). It will generate a stub repository. Use { name: '${t.repo}' } to silence this warning.`)),t}const Me=[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`,`kick.config.json`];async function j(e){let{findProjectRoot:t}=await Promise.resolve().then(()=>Xt),n=t(e);for(let e of Me){let t=h(n,e);try{await ie(t)}catch{continue}if(e.endsWith(`.json`)){let e=await w(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=Pe(e,n);for(let e of i)console.warn(` Warning: ${e}`);return Ne(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=Pe(i,n);for(let e of a)console.warn(` Warning: ${e}`);return Ne(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 Ne(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 Pe(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&&Fe(v(t,o.dest),i)&&n.push(`assetMap.${a}.dest ('${o.dest}') resolves outside the project root — refusing to copy`)}return n}function Fe(e,t){let n=_(t,e);return n===``?!1:n.startsWith(`..`)||m(n)}function Ie(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 ue(`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 ue(`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 ue(`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 ue(`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(()=>Xt),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 Le=k({mergeCliPlugins:()=>Ie});let Re=!1;function M(e){Re=e}const ze=new Set([`.ts`,`.tsx`,`.js`,`.jsx`,`.mjs`,`.cjs`,`.json`,`.md`]);async function N(e,t){Re||(await C(f(e),{recursive:!0}),await T(e,t,`utf-8`),ze.has(p(e))&&await He(e,t).catch(()=>{}))}let Be;async function Ve(t){if(Be!==void 0)return Be;try{Be=await import(e(h(t,`package.json`)).resolve(`oxfmt`))}catch{Be=null}return Be}async function He(e,t){let n=await Ve(process.cwd());if(!n)return;let r=await We(e);if(r===null)return;let i=await n.format(e,t,r);i.code!==t&&await T(e,i.code,`utf-8`)}const Ue=new Map;async function We(e){let t=f(e),n=t;if(Ue.has(n))return Ue.get(n);for(;;){let e=h(t,`.oxfmtrc.json`);if(r(e))try{let t=await w(e,`utf-8`),r=JSON.parse(t);return delete r.$schema,delete r.ignorePatterns,Ue.set(n,r),r}catch{return Ue.set(n,null),null}let i=f(t);if(i===t)return Ue.set(n,null),null;t=i}}async function Ge(e){try{return await ie(e),!0}catch{return!1}}const Ke={swagger:`@forinda/kickjs-swagger`,ws:`@forinda/kickjs-ws`,queue:`@forinda/kickjs-queue`,devtools:`@forinda/kickjs-devtools`},qe={zod:{name:`zod`,range:`^4.3.6`},valibot:{name:`valibot`,range:`^1.4.1`},yup:{name:`yup`,range:`^1.7.1`}};function Je(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 Ye(e,t,n,r=[],i=`zod`,a=`express`){let o=qe[i],s={"@forinda/kickjs":Je(n,`@forinda/kickjs`),"@forinda/kickjs-schema":Je(n,`@forinda/kickjs-schema`),dotenv:`^17.3.1`,express:`^5.1.0`,"reflect-metadata":`^0.2.2`,[o.name]:o.range};a===`fastify`?(s.fastify=`^5.0.0`,s[`@fastify/middie`]=`^9.0.0`):a===`h3`&&(s.h3=`^1.0.0`);for(let e of r){let t=Ke[e];t&&!s[t]&&(s[t]=Je(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:s,devDependencies:{"@forinda/kickjs-cli":Je(n,`@forinda/kickjs-cli`),"@forinda/kickjs-vite":Je(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 Xe(){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 Ze(){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 Qe(){return JSON.stringify({semi:!1,singleQuote:!0,trailingComma:`all`,printWidth:100,tabWidth:2},null,2)}function $e(){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 et(){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 tt(){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 nt(){return`PORT=3000
|
|
81
81
|
NODE_ENV=development
|
|
82
|
-
`}function
|
|
82
|
+
`}function rt(){return`PORT=3000
|
|
83
83
|
NODE_ENV=development
|
|
84
|
-
`}function
|
|
84
|
+
`}function it(){return`import { defineConfig } from 'vitest/config'
|
|
85
85
|
import swc from 'unplugin-swc'
|
|
86
86
|
|
|
87
87
|
export default defineConfig({
|
|
@@ -92,48 +92,44 @@ export default defineConfig({
|
|
|
92
92
|
include: ['src/**/*.test.ts'],
|
|
93
93
|
},
|
|
94
94
|
})
|
|
95
|
-
`}function ot(e,t,n,r=[]){switch(t){case`minimal`:{let t=[],i=[]
|
|
95
|
+
`}const at={express:{from:`@forinda/kickjs`,name:`expressRuntime`},fastify:{from:`@forinda/kickjs/fastify`,name:`fastifyRuntime`},h3:{from:`@forinda/kickjs/h3`,name:`h3Runtime`}};function ot(e,t,n,r=[],i=`express`){let a=at[i],o=i===`express`;switch(t){case`minimal`:{let t=[],i=[],s=o?`import { bootstrap, ${a.name} } from '@forinda/kickjs'`:`import { bootstrap } from '@forinda/kickjs'\nimport { ${a.name} } from '${a.from}'`;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(),`));let c=t.length?t.join(`
|
|
96
|
+
`)+`
|
|
97
|
+
`:``,l=i.length?`,\n adapters: [\n${i.join(`
|
|
98
|
+
`)}\n ]`:``;return`import 'reflect-metadata'
|
|
96
99
|
// Side-effect import — registers the extended env schema with kickjs
|
|
97
100
|
// **before** any controller / service / @Value gets resolved. Without
|
|
98
101
|
// this line ConfigService.get('YOUR_KEY') returns undefined because the
|
|
99
102
|
// cached schema would still be the base shape. See guide/configuration.
|
|
100
103
|
import './config'
|
|
101
|
-
|
|
102
|
-
${
|
|
103
|
-
`)+`
|
|
104
|
-
`:``}import { modules } from './modules'
|
|
104
|
+
${s}
|
|
105
|
+
${c}import { modules } from './modules'
|
|
105
106
|
|
|
106
107
|
// Export the app for the Vite plugin (dev mode)
|
|
107
|
-
export const app = await bootstrap({ modules
|
|
108
|
-
`)}\n
|
|
109
|
-
`
|
|
108
|
+
export const app = await bootstrap({ modules, runtime: ${a.name}()${l} })
|
|
109
|
+
`}default:{let t=[],i=[];r.includes(`devtools`)&&(t.push(`import { DevToolsAdapter } from '@forinda/kickjs-devtools'`),i.push(` DevToolsAdapter(),`)),r.includes(`swagger`)&&(t.push(`import { SwaggerAdapter } from '@forinda/kickjs-swagger'`),i.push(` SwaggerAdapter({\n info: { title: '${e}', version: '${n}' },\n }),`));let s=t.length?t.join(`
|
|
110
|
+
`)+`
|
|
111
|
+
`:``,c=i.length?`\n adapters: [\n${i.join(`
|
|
112
|
+
`)}\n ],`:``,l=[`bootstrap`,`requestId`,`requestLogger`,`helmet`,`cors`];o&&l.push(a.name);let u=o?`import express from 'express'\nimport {\n ${l.join(`,
|
|
113
|
+
`)},\n} from '@forinda/kickjs'`:`import {\n ${l.join(`,
|
|
114
|
+
`)},\n} from '@forinda/kickjs'\nimport { ${a.name} } from '${a.from}'`,d=o?`
|
|
115
|
+
express.json(),`:``;return`import 'reflect-metadata'
|
|
110
116
|
// Side-effect import — registers the extended env schema with kickjs
|
|
111
117
|
// **before** any controller / service / @Value gets resolved. Without
|
|
112
118
|
// this line ConfigService.get('YOUR_KEY') returns undefined because the
|
|
113
119
|
// cached schema would still be the base shape. See guide/configuration.
|
|
114
120
|
import './config'
|
|
115
|
-
|
|
116
|
-
import {
|
|
117
|
-
bootstrap,
|
|
118
|
-
requestId,
|
|
119
|
-
requestLogger,
|
|
120
|
-
helmet,
|
|
121
|
-
cors,
|
|
122
|
-
} from '@forinda/kickjs'
|
|
123
|
-
${t.length?t.join(`
|
|
124
|
-
`)+`
|
|
125
|
-
`:``}import { modules } from './modules'
|
|
121
|
+
${u}
|
|
122
|
+
${s}import { modules } from './modules'
|
|
126
123
|
|
|
127
124
|
// Export the app for the Vite plugin (dev mode)
|
|
128
125
|
export const app = await bootstrap({
|
|
129
|
-
modules
|
|
130
|
-
|
|
126
|
+
modules,
|
|
127
|
+
runtime: ${a.name}(),${c}
|
|
131
128
|
middleware: [
|
|
132
129
|
helmet(),
|
|
133
130
|
cors({ origin: '*' }),
|
|
134
131
|
requestId(),
|
|
135
|
-
requestLogger()
|
|
136
|
-
express.json(),
|
|
132
|
+
requestLogger(),${d}
|
|
137
133
|
],
|
|
138
134
|
})
|
|
139
135
|
`}}}function st(){return`import { defineModules } from '@forinda/kickjs'
|
|
@@ -326,10 +322,15 @@ export const HelloModule = defineModule({
|
|
|
326
322
|
},
|
|
327
323
|
}),
|
|
328
324
|
})
|
|
329
|
-
`}function ft(e,t=`inmemory`,n=`pnpm`){return`import { defineConfig } from '@forinda/kickjs-cli'
|
|
325
|
+
`}function ft(e,t=`inmemory`,n=`pnpm`,r=`express`){return`import { defineConfig } from '@forinda/kickjs-cli'
|
|
330
326
|
|
|
331
327
|
export default defineConfig({
|
|
332
328
|
pattern: '${e}',
|
|
329
|
+
// The HTTP engine this app boots on (matches \`bootstrap({ runtime })\` in
|
|
330
|
+
// src/index.ts). Dep-aware commands read it: \`kick add upload\` installs the
|
|
331
|
+
// engine's multipart driver, \`kick doctor\` checks the engine peers, and
|
|
332
|
+
// \`kick typegen\` flips the runtime escape-hatch types to this engine.
|
|
333
|
+
runtime: '${r}',
|
|
333
334
|
// Pinned so \`kick add\` and other dep-installing commands always use the
|
|
334
335
|
// project's intended package manager, regardless of which lockfile exists.
|
|
335
336
|
packageManager: '${n}',
|
|
@@ -1189,16 +1190,16 @@ Codex / Cursor / Gemini / Claude Code without copy-pasting.
|
|
|
1189
1190
|
\`kick g agents --only copilot -f\` regenerates this file from the
|
|
1190
1191
|
CLI template. Hand-edited content is overwritten — keep customisation
|
|
1191
1192
|
in \`.agents/COPILOT.local.md\`.
|
|
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,
|
|
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
|
|
1193
|
+
`}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`,runtime:c=`express`}=e,l=n,u=e=>console.log(` ${e}`);console.log(`\n Creating KickJS project: ${t}\n`),u(`Resolving package versions...`);let d=await Ct();await N(h(l,`package.json`),Ye(t,i,d,o,s,c)),await N(h(l,`vite.config.ts`),Xe()),await N(h(l,`tsconfig.json`),Ze()),await N(h(l,`.prettierrc`),Qe()),await N(h(l,`.editorconfig`),$e()),await N(h(l,`.gitignore`),et()),await N(h(l,`.gitattributes`),tt()),await N(h(l,`.env`),nt()),await N(h(l,`.env.example`),rt()),await N(h(l,`src/config/index.ts`),ct(s)),await N(h(l,`src/index.ts`),ot(t,i,bt.version,o,c)),await N(h(l,`src/modules/index.ts`),st()),await N(h(l,`src/modules/hello/hello.service.ts`),lt()),await N(h(l,`src/modules/hello/hello.controller.ts`),ut()),await N(h(l,`src/modules/hello/hello.module.ts`),dt()),await N(h(l,`kick.config.ts`),ft(i,a,r,c)),await N(h(l,`vitest.config.ts`),it()),await N(h(l,`README.md`),pt(t,i,r));let{generateAgentDocs:f}=await Promise.resolve().then(()=>er);if(await f({outDir:l,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:l,stdio:`inherit`}),console.log(`
|
|
1194
|
+
Dependencies installed successfully!`)}catch{console.log(`\n Warning: ${r} install failed. Run it manually.`)}}try{let{runTypegen:e}=await Promise.resolve().then(()=>_a);await e({cwd:l,allowDuplicates:!0,silent:!0})}catch{}if(e.initGit)try{S(`git init`,{cwd:l,stdio:`pipe`}),S(`git branch -M main`,{cwd:l,stdio:`pipe`}),S(`git add -A`,{cwd:l,stdio:`pipe`}),S(`git commit -m "chore: initial commit from kick new"`,{cwd:l,stdio:`pipe`}),u(`Git repository initialized`)}catch{u(`Warning: git init failed (git may not be installed)`)}console.log(`
|
|
1195
|
+
Project scaffolded successfully!`),console.log();let p=l!==process.cwd();u(`Next steps:`),p&&u(` cd ${t}`),e.installDeps||u(` ${r} install`);let m={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`};u(` ${m[i]??m.rest}`),u(` kick dev`),u(``),u(`Commands:`),u(` kick dev Start dev server with Vite HMR`),u(` kick build Production build via Vite`),u(` kick start Run production build`),u(``),u(`Generators:`),u(` kick g module <name> Full DDD module (controller, DTOs, use-cases, repo)`),u(` kick g scaffold <n> <f..> CRUD module from field definitions`),u(` kick g controller <name> Standalone controller`),u(` kick g service <name> @Service() class`),u(` kick g middleware <name> Express middleware`),u(` kick g guard <name> Route guard (auth, roles, etc.)`),u(` kick g adapter <name> AppAdapter with lifecycle hooks`),u(` kick g dto <name> Zod DTO schema`),u(` kick g config Generate kick.config.ts`),u(``),u(`Add packages:`),u(` kick add <pkg> Install a KickJS package + peers`),u(` kick add --list Show all available packages`),u(``),u(`Available: auth, swagger, drizzle, prisma, ws, queue, devtools, mcp, testing`),u(``)}const Tt={GET:O.green,POST:O.cyan,PUT:O.yellow,PATCH:O.magenta,DELETE:O.red};function Et(e){return(Tt[e]??O.dim)(e.padEnd(7))}function Dt(e){let t=`[${e}]`.padEnd(10);switch(e){case`CRITICAL`:return O.red(t);case`WARNING`:return O.yellow(t);case`INFO`:return O.blue(O.dim(t));default:return t}}O.green(`✓`),O.red(`✖`),O.yellow(`⚠`),O.blue(`ℹ`);function Ot(e){D.intro(O.bgCyan(O.black(` ${e} `)))}function P(e){D.outro(e)}function kt(e){D.isCancel(e)&&(D.cancel(`Operation cancelled.`),process.exit(0))}async function At(e){let t=await D.text(e);return kt(t),t}async function jt(e){let t=await D.select(e);return kt(t),t}async function Mt(e){let t=await D.multiselect(e);return kt(t),t}async function F(e){let t=await D.confirm(e);return kt(t),t}function Nt(){return D.spinner()}const I=D.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:[`ws`],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}},Ft={express:{prod:`multer`,dev:`@types/multer`,note:`Express uploads use multer (memory/disk storage, ctx.file / ctx.files).`},fastify:{prod:`@fastify/multipart`,note:`Fastify uploads use @fastify/multipart (buffered into ctx.file / ctx.files).`},h3:{note:`h3 parses multipart natively (readMultipartFormData) — no driver to install.`}};async function It(e=process.cwd()){let t=(await j(e))?.runtime;return t===`express`||t===`fastify`||t===`h3`?t:Lt(e)}function Lt(e=process.cwd()){let t=Rt(`package.json`,e);if(t)try{let e=JSON.parse(a(v(t,`package.json`),`utf-8`)),n={...e.dependencies,...e.devDependencies};if(`fastify`in n)return`fastify`;if(`h3`in n)return`h3`}catch{}return`express`}function Rt(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 zt(){return Rt(`pnpm-lock.yaml`)?`pnpm`:Rt(`yarn.lock`)?`yarn`:Rt(`bun.lockb`)||Rt(`bun.lock`)?`bun`:Rt(`package-lock.json`)?`npm`:null}function Bt(){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(Te.includes(t))return t}}catch{}let n=f(e);if(n===e)return null;e=n}return null}async function Vt(e){if(e&&Te.includes(e))return{pm:e,source:`flag`};let t=await j(process.cwd());if(t?.packageManager&&Te.includes(t.packageManager))return{pm:t.packageManager,source:`config`};let n=Bt();if(n)return{pm:n,source:`package.json`};let r=zt();return r?{pm:r,source:`lockfile`}:{pm:`npm`,source:`default`}}async function Ht(e){let{pm:t}=await Vt(e);return t}function Ut(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
1196
|
Core packages (always installed by \`kick new\`):
|
|
1196
1197
|
`);for(let e of r)console.log(a(e));if(e){console.log(`
|
|
1197
1198
|
Optional packages (add as needed):
|
|
1198
1199
|
`);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 ai db swagger`),console.log(` kick add queue:bullmq`),console.log()}function
|
|
1200
|
-
`),
|
|
1201
|
-
`)}})}const
|
|
1200
|
+
Usage: kick add ai db swagger`),console.log(` kick add queue:bullmq`),console.log(` kick add upload # installs the multipart driver for your runtime`),console.log()}function Wt(e,t,n=`express`){let r=new Set,i=new Set,a=[],o=[],s=[];for(let c of e){if(c===`upload`){let e=Ft[n];s.push(`upload (${n}): ${e.note}`),e.prod&&(t?i:r).add(e.prod),e.dev&&i.add(e.dev);continue}let e=Pt[c];if(!e){a.push(c);continue}e.deprecated&&o.push(`'${c}' (${e.pkg}) is deprecated — ${e.deprecated}`);let l=t||e.dev?i:r;l.add(e.pkg);for(let t of e.peers)l.add(t)}return{prodDeps:[...r],devDeps:[...i],unknown:a,warnings:o,notices:s}}function Gt(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=>{Ut(!!e.all)})}function Kt(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){Ut(!!t.all);return}let{pm:n,source:r}=await Vt(t.pm);console.log(`\n Using ${n} (resolved from ${r})`);let i=await It(process.cwd()),{prodDeps:a,devDeps:o,unknown:s,warnings:c,notices:l}=Wt(e,!!t.dev,i);for(let e of c)console.warn(`\n WARNING: ${e}`);for(let e of l)console.log(`\n ${e}`);if(!(s.length>0&&(console.log(`\n Unknown packages: ${s.join(`, `)}`),console.log(` Run "kick add --list" to see available packages.
|
|
1201
|
+
`),a.length===0&&o.length===0))){if(a.length>0){let e=a,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(o.length>0){let e=o,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!
|
|
1202
|
+
`)}})}const qt=[{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 Jt(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(`--runtime <engine>`,`HTTP runtime: express | fastify | h3`).option(`-r, --repo <type>`,`Repository name (inmemory, or any DB name e.g. postgres)`).option(`-s, --schema <lib>`,`Schema library for env / DTOs: zod | valibot | yup (default: zod)`).option(`--packages <packages>`,`Comma-separated packages to include (e.g. 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)I.warn(`Clearing existing files in ${i}`);else if(n){I.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),P(`Aborted.`);return}else{I.warn(`Directory "${e}" is not empty:`);let t=r.slice(0,5);for(let e of t)I.message(` - ${e}`);if(r.length>5&&I.message(` ... and ${r.length-5} more`),!await F({message:O.red(`Remove all existing files and proceed?`),initialValue:!1})){P(`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.runtime;c||=n?`express`:await jt({message:`HTTP runtime`,options:[{value:`express`,label:`Express`,hint:`default, zero-config`},{value:`fastify`,label:`Fastify`,hint:`fastify + @fastify/middie`},{value:`h3`,label:`h3`,hint:`Nitro / Nuxt engine`}]});let l=t.pm;l||=n?await Ht(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 u=t.repo;u||=n?`inmemory`:await At({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),Oe(u);let f=t.schema;f||=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(f)||(I.warn(`Unknown --schema "${f}", falling back to zod.`),f=`zod`);let p;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();p=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else p=n?[]:await Mt({message:`Select packages to include`,options:[...qt],required:!1});let m;m=t.git===void 0?n?!0:await F({message:`Initialize git repository?`,initialValue:!0}):t.git;let h;h=t.install===void 0?n?!0:await F({message:`Install dependencies?`,initialValue:!0}):t.install,await wt({name:e,directory:i,packageManager:l,initGit:m,installDeps:h,template:a,defaultRepo:u,packages:p,schemaLib:f,runtime:c}),P(`Done! Next steps: ${O.cyan(`cd ${e} && ${l} dev`)}`)})}function L(e){return e.replace(/[-_\s]+(.)?/g,(e,t)=>t?t.toUpperCase():``).replace(/^(.)/,e=>e.toUpperCase())}function R(e){let t=L(e);return t.charAt(0).toLowerCase()+t.slice(1)}function z(e){return e.replace(/([a-z])([A-Z])/g,`$1-$2`).replace(/[\s_]+/g,`-`).toLowerCase()}function B(e){return de.plural(e)}function Yt(e){return de.plural(e)}var Xt=k({findProjectRoot:()=>Qt});const Zt=[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`,`kick.config.json`];function Qt(e=process.cwd()){let t=v(e),{root:n}=g(t),i=null,a=t;for(;;){for(let e of Zt)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 $t(e){return z(e).replace(/-/g,`_`)}function en(e){let t=e.cwd??process.cwd(),n=e.projectRoot??Qt(t),r=e.pluralize??!0,i=L(e.name),a=R(e.name),o=z(e.name),s=$t(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=B(o);c.pluralKebab=e,c.pluralPascal=L(e),c.pluralCamel=R(e)}return c}function tn(e,t){return v(e.cwd,t)}async function nn(e){return import(x(e).href)}const rn=new Map;async function an(e){let t=rn.get(e);if(t)return t;let n=on(e);return rn.set(e,n),n}async function on(t){let n=v(t,`package.json`);if(!r(n))return{generators:[],loaded:[],failed:[]};let i=sn(JSON.parse(await w(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 w(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 nn(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(!cn(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 sn(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 cn(e){if(!e||typeof e!=`object`)return!1;let t=e;return typeof t.name==`string`&&typeof t.files==`function`}async function ln(e,t=[]){let n=e.cwd??process.cwd(),r=t.find(t=>t.spec.name===e.generatorName);if(r)return fn(r.spec,r.source,e,n);let i=dn(await an(n),e.generatorName);return i?fn(i.spec,i.source,e,n):null}async function un(e,t=[]){let n=await an(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 dn(e,t){return e.generators.find(e=>e.spec.name===t)}async function fn(e,t,n,r){let i=en({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=tn(i,e.path);await N(t,e.content),o.push(t)}return{files:o,source:t}}function V(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}function pn(e){return e.charAt(0).toUpperCase()+e.slice(1).replace(/-([a-z])/g,(e,t)=>t.toUpperCase())}function mn(e){return e.replace(/([a-z])([A-Z])/g,`$1-$2`).toLowerCase()}function hn(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]??`${pn(n)}${e}Repository`,repoFile:i[n]??`${mn(n)}-${t}`}}function gn(e){return e??`define`}function _n(e){let{pascal:t,kebab:n,plural:r=``,repo:i,style:a}=e,{repoClass:o,repoFile:s}=hn(t,n,i),c=gn(a),l=`/**
|
|
1202
1203
|
* ${t} Module
|
|
1203
1204
|
*
|
|
1204
1205
|
* REST module with a flat folder structure.
|
|
@@ -1270,7 +1271,7 @@ ${d}
|
|
|
1270
1271
|
},
|
|
1271
1272
|
}),
|
|
1272
1273
|
})
|
|
1273
|
-
`}function
|
|
1274
|
+
`}function vn(e){let{pascal:t,kebab:n,plural:r=``,style:i}=e,a=gn(i),o=` /**
|
|
1274
1275
|
* Declare HTTP routes. Return value shape:
|
|
1275
1276
|
*
|
|
1276
1277
|
* - \`path\` — URL prefix for this route set.
|
|
@@ -1310,7 +1311,7 @@ ${o}
|
|
|
1310
1311
|
},
|
|
1311
1312
|
}),
|
|
1312
1313
|
})
|
|
1313
|
-
`}function
|
|
1314
|
+
`}function yn(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
1315
|
import { ApiTags } from '@forinda/kickjs-swagger'
|
|
1315
1316
|
import { ${t}Service } from './${n}.service'
|
|
1316
1317
|
import { create${t}Schema } from './dtos/create-${n}.dto'
|
|
@@ -1365,7 +1366,7 @@ export class ${t}Controller {
|
|
|
1365
1366
|
ctx.noContent()
|
|
1366
1367
|
}
|
|
1367
1368
|
}
|
|
1368
|
-
`}function
|
|
1369
|
+
`}function bn(e){let{pascal:t}=e;return`import { z } from 'zod'
|
|
1369
1370
|
|
|
1370
1371
|
/**
|
|
1371
1372
|
* Create ${t} DTO — Zod schema for validating POST request bodies.
|
|
@@ -1381,20 +1382,20 @@ export const create${t}Schema = z.object({
|
|
|
1381
1382
|
})
|
|
1382
1383
|
|
|
1383
1384
|
export type Create${t}DTO = z.infer<typeof create${t}Schema>
|
|
1384
|
-
`}function
|
|
1385
|
+
`}function xn(e){let{pascal:t}=e;return`import { z } from 'zod'
|
|
1385
1386
|
|
|
1386
1387
|
export const update${t}Schema = z.object({
|
|
1387
1388
|
name: z.string().min(1).max(200).optional(),
|
|
1388
1389
|
})
|
|
1389
1390
|
|
|
1390
1391
|
export type Update${t}DTO = z.infer<typeof update${t}Schema>
|
|
1391
|
-
`}function
|
|
1392
|
+
`}function Sn(e){let{pascal:t}=e;return`export interface ${t}ResponseDTO {
|
|
1392
1393
|
id: string
|
|
1393
1394
|
name: string
|
|
1394
1395
|
createdAt: string
|
|
1395
1396
|
updatedAt: string
|
|
1396
1397
|
}
|
|
1397
|
-
`}function
|
|
1398
|
+
`}function Cn(e){let{pascal:t,kebab:n,dtoPrefix:r=`../../application/dtos`,tokenScope:i=`app`}=e;return`/**
|
|
1398
1399
|
* ${t} Repository Interface
|
|
1399
1400
|
*
|
|
1400
1401
|
* Defines the contract for data access.
|
|
@@ -1429,7 +1430,7 @@ export interface I${t}Repository {
|
|
|
1429
1430
|
* adopters must NOT use the reserved \`'kick/'\` namespace.
|
|
1430
1431
|
*/
|
|
1431
1432
|
export const ${t.toUpperCase()}_REPOSITORY = createToken<I${t}Repository>('${i}/${t}/repository')
|
|
1432
|
-
`}function
|
|
1433
|
+
`}function wn(e){let{pascal:t,kebab:n,repoPrefix:r=`../../domain/repositories`,dtoPrefix:i=`../../application/dtos`}=e;return`/**
|
|
1433
1434
|
* In-Memory ${t} Repository
|
|
1434
1435
|
*
|
|
1435
1436
|
* Implements the repository interface using a Map.
|
|
@@ -1489,7 +1490,7 @@ export class InMemory${t}Repository implements I${t}Repository {
|
|
|
1489
1490
|
this.store.delete(id)
|
|
1490
1491
|
}
|
|
1491
1492
|
}
|
|
1492
|
-
`}function
|
|
1493
|
+
`}function Tn(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
1494
|
* ${o} ${t} Repository
|
|
1494
1495
|
*
|
|
1495
1496
|
* Stub implementation for a custom '${r}' repository.
|
|
@@ -1558,7 +1559,7 @@ export class ${o}${t}Repository implements I${t}Repository {
|
|
|
1558
1559
|
this.store.delete(id)
|
|
1559
1560
|
}
|
|
1560
1561
|
}
|
|
1561
|
-
`}function
|
|
1562
|
+
`}function En(e){let{pascal:t,kebab:n,plural:r=``}=e;return`import { describe, it, expect, beforeEach } from 'vitest'
|
|
1562
1563
|
import { Container } from '@forinda/kickjs'
|
|
1563
1564
|
|
|
1564
1565
|
describe('${t}Controller', () => {
|
|
@@ -1610,7 +1611,7 @@ describe('${t}Controller', () => {
|
|
|
1610
1611
|
})
|
|
1611
1612
|
})
|
|
1612
1613
|
})
|
|
1613
|
-
`}function
|
|
1614
|
+
`}function Dn(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
1615
|
import { InMemory${t}Repository } from '${i}'
|
|
1615
1616
|
|
|
1616
1617
|
describe('InMemory${t}Repository', () => {
|
|
@@ -1672,7 +1673,7 @@ describe('InMemory${t}Repository', () => {
|
|
|
1672
1673
|
expect(found).toBeNull()
|
|
1673
1674
|
})
|
|
1674
1675
|
})
|
|
1675
|
-
`}function
|
|
1676
|
+
`}function On(e){let{pascal:t,kebab:n}=e;return`import { Service, Inject, HttpException } from '@forinda/kickjs'
|
|
1676
1677
|
import type { ParsedQuery } from '@forinda/kickjs'
|
|
1677
1678
|
import { ${t.toUpperCase()}_REPOSITORY, type I${t}Repository } from './${n}.repository'
|
|
1678
1679
|
import type { ${t}ResponseDTO } from './dtos/${n}-response.dto'
|
|
@@ -1709,14 +1710,14 @@ export class ${t}Service {
|
|
|
1709
1710
|
await this.repo.delete(id)
|
|
1710
1711
|
}
|
|
1711
1712
|
}
|
|
1712
|
-
`}function
|
|
1713
|
+
`}function kn(e){let{pascal:t}=e;return`import type { QueryFieldConfig } from '@forinda/kickjs'
|
|
1713
1714
|
|
|
1714
1715
|
export const ${t.toUpperCase()}_QUERY_CONFIG: QueryFieldConfig = {
|
|
1715
1716
|
filterable: ['name'],
|
|
1716
1717
|
sortable: ['name', 'createdAt'],
|
|
1717
1718
|
searchable: ['name'],
|
|
1718
1719
|
}
|
|
1719
|
-
`}async function
|
|
1720
|
+
`}async function An(e){let{pascal:t,kebab:n,plural:r,style:i,write:a}=e;await a(`${n}.module.ts`,vn({pascal:t,kebab:n,plural:r,style:i})),await a(`${n}.controller.ts`,`import { Controller, Get, type Ctx } from '@forinda/kickjs'
|
|
1720
1721
|
|
|
1721
1722
|
// \`Ctx<KickRoutes.${t}Controller['<method>']>\` is generated by
|
|
1722
1723
|
// \`kick typegen\` (auto-run on \`kick dev\`).
|
|
@@ -1728,7 +1729,7 @@ export class ${t}Controller {
|
|
|
1728
1729
|
ctx.json({ message: '${t} list' })
|
|
1729
1730
|
}
|
|
1730
1731
|
}
|
|
1731
|
-
`)}async function
|
|
1732
|
+
`)}async function jn(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`,_n({pascal:t,kebab:n,plural:r,repo:a,style:c})),await l(`${n}.constants.ts`,kn({pascal:t,kebab:n})),await l(`${n}.controller.ts`,yn({pascal:t,kebab:n,plural:r,pluralPascal:i})),await l(`${n}.service.ts`,On({pascal:t,kebab:n})),await l(`dtos/create-${n}.dto.ts`,bn({pascal:t,kebab:n})),await l(`dtos/update-${n}.dto.ts`,xn({pascal:t,kebab:n})),await l(`dtos/${n}-response.dto.ts`,Sn({pascal:t,kebab:n})),await l(`${n}.repository.ts`,Cn({pascal:t,kebab:n,dtoPrefix:`./dtos`,tokenScope:s}));let u=a===`inmemory`,d=u?`in-memory-${n}`:`${z(a)}-${n}`,f=u?wn({pascal:t,kebab:n,repoPrefix:`.`,dtoPrefix:`./dtos`}):Tn({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`,wn({pascal:t,kebab:n,repoPrefix:`.`,dtoPrefix:`./dtos`})),await l(`__tests__/${n}.controller.test.ts`,En({pascal:t,kebab:n,plural:r})),await l(`__tests__/${n}.repository.test.ts`,Dn({pascal:t,kebab:n,plural:r,repoPrefix:`../in-memory-${n}.repository`})))}function Mn(e){return e?typeof e==`string`?e:e.name:`inmemory`}async function Nn(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=z(t),d=L(t),f=c?B(u):u,p=c?Yt(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 Ge(n)&&!await F({message:`File exists: ${O.dim(e)}. Overwrite?`,initialValue:!1})){I.warn(`Skipped: ${e}`);return}await N(n,t),g.push(n)},files:g};switch(l){case`minimal`:await An(v);break;default:await jn(v);break}return s||await Pn(n,d,f,u,v.style),g}async function Pn(e,t,n,r,i=`define`){let a=h(e,`index.ts`),o=await Ge(a),s=`./${n}/${r}.module`,c=i===`class`?`${t}Module`:`${t}Module()`;if(!o){await N(a,i===`class`?`import type { AppModuleEntry } from '@forinda/kickjs'
|
|
1732
1733
|
import { ${t}Module } from '${s}'
|
|
1733
1734
|
|
|
1734
1735
|
export const modules: AppModuleEntry[] = [${c}]
|
|
@@ -1736,11 +1737,11 @@ export const modules: AppModuleEntry[] = [${c}]
|
|
|
1736
1737
|
import { ${t}Module } from '${s}'
|
|
1737
1738
|
|
|
1738
1739
|
export const modules = defineModules().mount(${c})
|
|
1739
|
-
`);return}let l=await
|
|
1740
|
+
`);return}let l=await w(a,`utf-8`),u=`import { ${t}Module } from '${s}'`,d=V(s);if(!RegExp(`^import\\s*\\{[^}]*\\b${V(t)}Module\\b[^}]*\\}\\s*from\\s*['"]${d}['"]`,`m`).test(l)){let e=l.lastIndexOf(`import `);if(e!==-1){let t=l.indexOf(`
|
|
1740
1741
|
`,e);l=l.slice(0,t+1)+u+`
|
|
1741
1742
|
`+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
|
|
1743
|
+
`+l}let f=In(l);if(f){let e=l.slice(f.rhsStart,f.rhsEnd+1);RegExp(`\\b${V(t)}Module\\b`).test(e)||(l=Fn(l,c))}else l=Fn(l,c);await T(a,l,`utf-8`)}function Fn(e,t){let n=In(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 In(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=zn(e,n);return t===-1?null:{shape:`array`,rhsStart:n,rhsEnd:t}}if(e.slice(n,n+13)===`defineModules`){let t=Ln(e,n);return t===-1?null:{shape:`chain`,rhsStart:n,rhsEnd:t-1,chainEnd:t}}return null}function Ln(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=Bn(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=Bn(e,t);if(n===-1)break;i=n+1}return i}function Rn(e,t){let n=e.slice(t,t+2);if(n===`//`){for(t+=2;t<e.length&&e[t]!==`
|
|
1744
|
+
`;)t++;return t}if(n===`/*`){for(t+=2;t+1<e.length&&!(e[t]===`*`&&e[t+1]===`/`);)t++;return t+2}return t}function zn(e,t){if(e[t]!==`[`)return-1;let n=1,r=t+1;for(;r<e.length;){let t=e.slice(r,r+2);if(t===`//`||t===`/*`){r=Rn(e,r);continue}let i=e[r]??``;if(i===`'`||i===`"`||i==="`"){let t=i;for(r++;r<e.length&&e[r]!==t;)e[r]===`\\`&&r++,r++;r<e.length&&r++;continue}if(i===`[`)n++;else if(i===`]`&&(n--,n===0))return r;r++}return-1}function Bn(e,t){if(e[t]!==`(`)return-1;let n=1,r=t+1;for(;r<e.length;){let t=e.slice(r,r+2);if(t===`//`||t===`/*`){r=Rn(e,r);continue}let i=e[r]??``;if(i===`'`||i===`"`||i==="`"){let t=i;for(r++;r<e.length&&e[r]!==t;)e[r]===`\\`&&r++,r++;r<e.length&&r++;continue}if(i===`(`)n++;else if(i===`)`&&(n--,n===0))return r;r++}return-1}async function Vn(e){let{name:t,outDir:n}=e,r=z(t),i=L(t),a=[],o=h(n,`${r}.adapter.ts`);return await N(o,`import {
|
|
1744
1745
|
defineAdapter,
|
|
1745
1746
|
type AdapterContext,
|
|
1746
1747
|
type AdapterMiddleware,
|
|
@@ -1909,7 +1910,7 @@ export const ${i}Adapter = defineAdapter<${i}AdapterConfig>({
|
|
|
1909
1910
|
}
|
|
1910
1911
|
},
|
|
1911
1912
|
})
|
|
1912
|
-
`),a.push(o),a}async function
|
|
1913
|
+
`),a.push(o),a}async function Hn(e){let{name:t,outDir:n}=e,r=z(t),i=L(t),a=[],o=h(n,`${r}.plugin.ts`);return await N(o,`import {
|
|
1913
1914
|
definePlugin,
|
|
1914
1915
|
type AppAdapter,
|
|
1915
1916
|
type AppModuleEntry,
|
|
@@ -2053,9 +2054,9 @@ export const ${i}Plugin = definePlugin<${i}PluginConfig>({
|
|
|
2053
2054
|
},
|
|
2054
2055
|
}),
|
|
2055
2056
|
})
|
|
2056
|
-
`),a.push(o),a}const
|
|
2057
|
+
`),a.push(o),a}const Un={controller:``,service:``,dto:`dtos`,guard:`guards`,middleware:`middleware`,contributor:`contributors`};function Wn(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=Un,n=z(r),a=o?B(n):n,s=e[t]??``,c=h(i,a);return v(s?h(c,s):c)}return v(a)}async function Gn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=Wn({type:`middleware`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/middleware`,pattern:i,shouldPluralize:e.pluralize??!0}),o=z(t),s=R(t),c=[],l=h(a,`${o}.middleware.ts`);return await N(l,`import type { Request, Response, NextFunction } from 'express'
|
|
2057
2058
|
|
|
2058
|
-
export interface ${
|
|
2059
|
+
export interface ${L(t)}Options {
|
|
2059
2060
|
// Add configuration options here. The factory below closes over the
|
|
2060
2061
|
// resolved options object; pass them at the call site —
|
|
2061
2062
|
// \`${s}({ foo: 'bar' })\` — and the closure preserves them across
|
|
@@ -2063,7 +2064,7 @@ export interface ${I(t)}Options {
|
|
|
2063
2064
|
}
|
|
2064
2065
|
|
|
2065
2066
|
/**
|
|
2066
|
-
* ${
|
|
2067
|
+
* ${L(t)} middleware.
|
|
2067
2068
|
*
|
|
2068
2069
|
* Usage in bootstrap (fires on every request):
|
|
2069
2070
|
* middleware: [${s}()]
|
|
@@ -2095,7 +2096,7 @@ export interface ${I(t)}Options {
|
|
|
2095
2096
|
* Usage with @Middleware decorator:
|
|
2096
2097
|
* @Middleware(${s}())
|
|
2097
2098
|
*/
|
|
2098
|
-
export function ${s}(options: ${
|
|
2099
|
+
export function ${s}(options: ${L(t)}Options = {}) {
|
|
2099
2100
|
return (req: Request, res: Response, next: NextFunction) => {
|
|
2100
2101
|
// Implement your middleware logic here. \`options\` is captured by
|
|
2101
2102
|
// closure — log or read it anywhere in this handler body.
|
|
@@ -2103,7 +2104,7 @@ export function ${s}(options: ${I(t)}Options = {}) {
|
|
|
2103
2104
|
next()
|
|
2104
2105
|
}
|
|
2105
2106
|
}
|
|
2106
|
-
`),c.push(l),c}async function
|
|
2107
|
+
`),c.push(l),c}async function Kn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=Wn({type:`guard`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/guards`,pattern:i,shouldPluralize:e.pluralize??!0}),o=z(t),s=R(t),c=L(t),l=[],u=h(a,`${o}.guard.ts`);return await N(u,`import { Container, HttpException } from '@forinda/kickjs'
|
|
2107
2108
|
import type { RequestContext } from '@forinda/kickjs'
|
|
2108
2109
|
|
|
2109
2110
|
/**
|
|
@@ -2139,8 +2140,8 @@ export async function ${s}Guard(ctx: RequestContext, next: () => void): Promise<
|
|
|
2139
2140
|
ctx.res.status(401).json({ message: 'Invalid or expired token' })
|
|
2140
2141
|
}
|
|
2141
2142
|
}
|
|
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:
|
|
2143
|
+
`),l.push(u),l}function qn(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 Jn(e){switch(e){case`string`:return`''`;case`number`:return`0`;case`boolean`:return`false`;default:return null}}async function Yn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=e.type??`http`,o=z(t),s=L(t),c=e.key??R(t),l=Array.isArray(e.params)?e.params:qn(e.params),u=Wn({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(`
|
|
2144
|
+
`)}\n}\n`:``,m=l.length>0?`${d}.withParams<${s}Params>()({`:`${d}({`,g=l.map(e=>({name:e.name,def:Jn(e.type)})).filter(e=>e.def!==null).map(e=>` ${e.name}: ${e.def},`),_=l.length>0?` paramDefaults: {\n${g.join(`
|
|
2144
2145
|
`)}\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
2146
|
import type { ${f} } from '@forinda/kickjs'
|
|
2146
2147
|
|
|
@@ -2179,7 +2180,7 @@ ${y}
|
|
|
2179
2180
|
throw new Error("${s} contributor: resolve() not implemented")
|
|
2180
2181
|
},
|
|
2181
2182
|
})
|
|
2182
|
-
`,x=h(u,`${o}.contributor.ts`);return await
|
|
2183
|
+
`,x=h(u,`${o}.contributor.ts`);return await N(x,b),[x]}async function Xn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=Wn({type:`service`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/services`,pattern:i,shouldPluralize:e.pluralize??!0}),o=z(t),s=L(t),c=[],l=h(a,`${o}.service.ts`);return await N(l,`import { Service } from '@forinda/kickjs'
|
|
2183
2184
|
|
|
2184
2185
|
@Service()
|
|
2185
2186
|
export class ${s}Service {
|
|
@@ -2188,7 +2189,7 @@ export class ${s}Service {
|
|
|
2188
2189
|
// @Inject(MY_REPO) private readonly repo: IMyRepository,
|
|
2189
2190
|
// ) {}
|
|
2190
2191
|
}
|
|
2191
|
-
`),c.push(l),c}async function
|
|
2192
|
+
`),c.push(l),c}async function Zn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=Wn({type:`controller`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/controllers`,pattern:i,shouldPluralize:e.pluralize??!0}),o=z(t),s=L(t),c=[],l=h(a,`${o}.controller.ts`);return await N(l,`import { Controller, Get, Post, type Ctx } from '@forinda/kickjs'
|
|
2192
2193
|
|
|
2193
2194
|
// \`Ctx<KickRoutes.${s}Controller['<method>']>\` is generated by
|
|
2194
2195
|
// \`kick typegen\` (auto-run on \`kick dev\`). After the first run, your IDE
|
|
@@ -2209,7 +2210,7 @@ export class ${s}Controller {
|
|
|
2209
2210
|
ctx.created({ message: '${s} created', data: ctx.body })
|
|
2210
2211
|
}
|
|
2211
2212
|
}
|
|
2212
|
-
`),c.push(l),c}async function
|
|
2213
|
+
`),c.push(l),c}async function Qn(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=Wn({type:`dto`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/dtos`,pattern:i,shouldPluralize:e.pluralize??!0}),o=z(t),s=L(t),c=R(t),l=[],u=h(a,`${o}.dto.ts`);return await N(u,`import { z } from 'zod'
|
|
2213
2214
|
|
|
2214
2215
|
export const ${c}Schema = z.object({
|
|
2215
2216
|
// Define your schema fields here
|
|
@@ -2217,8 +2218,8 @@ export const ${c}Schema = z.object({
|
|
|
2217
2218
|
})
|
|
2218
2219
|
|
|
2219
2220
|
export type ${s}DTO = z.infer<typeof ${c}Schema>
|
|
2220
|
-
`),l.push(u),l}async function
|
|
2221
|
-
Skipped — existing kick.config.ts preserved.`),[]):(await
|
|
2221
|
+
`),l.push(u),l}async function $n(e){let t=h(e.outDir,`kick.config.ts`),n=e.modulesDir??`src/modules`,i=e.defaultRepo??`inmemory`;return r(t)&&!e.force&&!await F({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
|
|
2222
|
+
Skipped — existing kick.config.ts preserved.`),[]):(await N(t,`import { defineConfig } from '@forinda/kickjs-cli'
|
|
2222
2223
|
|
|
2223
2224
|
export default defineConfig({
|
|
2224
2225
|
modules: {
|
|
@@ -2255,18 +2256,18 @@ export default defineConfig({
|
|
|
2255
2256
|
},
|
|
2256
2257
|
],
|
|
2257
2258
|
})
|
|
2258
|
-
`),[t])}var
|
|
2259
|
+
`),[t])}var er=k({generateAgentDocs:()=>or});const tr=`.agents`,nr=new Set([`rest`,`minimal`]);function rr(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 ir(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 ar(e,t){if(t)return t;try{let t=(await j(e))?.pattern;if(t&&nr.has(t))return t}catch{}return`rest`}async function or(e){let t=e.only??`all`,n=rr(e.outDir,e.name),i=ir(e.outDir,e.pm),a=await ar(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,tr,`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,tr,`skills`,t.slug,`SKILL.md`),render:()=>t.content});l&&d.push({file:h(e.outDir,tr,`GEMINI.md`),render:()=>_t(n,a,i)}),u&&d.push({file:h(e.outDir,tr,`COPILOT.md`),render:()=>vt(n,a,i)});let f=[];for(let{file:t,render:n}of d){if(r(t)&&!e.force&&!await F({message:`${t.replace(e.outDir+`/`,``)} already exists. Overwrite?`,initialValue:!1})){console.log(` Skipped — existing ${t.replace(e.outDir+`/`,``)} preserved.`);continue}await N(t,n()),f.push(t)}return f}function sr(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 cr(e,t){let n=t.exec(e);if(!n)return null;let r=n.index+n[0].length-1,i=sr(e,r);return i===-1?null:e.slice(r+1,i)}function lr(e,t,n){let r=` `.repeat(n);return e.split(`
|
|
2259
2260
|
`).map(e=>{if(e.trim()===``)return e;let n=RegExp(`^ {0,${t}}`);return r+e.replace(n,``)}).join(`
|
|
2260
|
-
`)}function
|
|
2261
|
+
`)}function ur(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 dr(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 fr(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=sr(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=cr(o,/register\s*\(([^)]*)\)\s*:\s*void\s*\{/),u=cr(o,/contributors\s*\(\s*\)\s*:\s*ContributorRegistrations\s*\{/),d=cr(o,/routes\s*\(\s*\)\s*:\s*[A-Za-z|[\]\s]+\{/);if(!d)return{migrated:null,reason:`routes() method missing or signature unrecognized`};let f=ur(s),p=``;return l&&(p+=` register(container) {${lr(l,4,6)} },\n\n`),u&&(p+=` contributors() {${lr(u,4,6)} },\n\n`),p+=` routes() {${lr(d,4,6)} },`,{migrated:`${f}${`export const ${r} = defineModule({
|
|
2261
2262
|
name: '${r}',
|
|
2262
2263
|
build: () => ({
|
|
2263
2264
|
${p}
|
|
2264
2265
|
}),
|
|
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=
|
|
2266
|
+
})`}${c}`}}function pr(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=sr(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]===`
|
|
2267
|
+
`||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=sr(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=cr(m,/register\s*\(([^)]*)\)\s*\{/),g=cr(m,/contributors\s*\(\s*\)\s*\{/),_=cr(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let v=dr(c,{container:h!==null,appModule:!0,moduleRoutes:!0,contributorRegistrations:g!==null}),y=``;return h!==null&&(y+=` register(container: Container): void {${lr(h,6,4)} }\n\n`),g!==null&&(y+=` contributors(): ContributorRegistrations {${lr(g,6,4)} }\n\n`),y+=` routes(): ModuleRoutes {${lr(_,6,4)} }`,{migrated:`${v}${`export class ${r} implements AppModule {
|
|
2267
2268
|
${y}
|
|
2268
2269
|
}
|
|
2269
|
-
`}${u}`}}function
|
|
2270
|
+
`}${u}`}}function mr(e,t){return t===`class`?pr(e):fr(e)}function hr(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 gr(e){let t=[];return await n(v(e),0),t;async function n(e,r){let i;try{i=await oe(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 ce(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function _r(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await oe(e)}catch{return}await C(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 ce(i)}catch{continue}s.isDirectory()?await r(i,o):(await ae(i,o),n++)}}}function vr(e){return h(e,`.kickjs`,`codemod-backups`,`${new Date().toISOString().replaceAll(/[:.]/g,`-`)}-modules`)}async function yr(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await gr(e),s=await w(h(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=vr(r),await _r(e,c));let l=[];for(let e of o){let t=mr(await w(e,`utf-8`),i);if(t.migrated==null){l.push({path:e,status:`skipped`,reason:t.reason});continue}n||await T(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`})}let u=h(e,`index.ts`),d=null;try{d=await w(u,`utf-8`)}catch{return{target:i,files:l,indexStatus:`not-found`,indexPath:u,backupDir:c}}let f=hr(d,i);return f.migrated==null?{target:i,files:l,indexStatus:`skipped`,indexPath:u,indexReason:f.reason,backupDir:c}:(n||await T(u,f.migrated,`utf-8`),{target:i,files:l,indexStatus:`migrated`,indexPath:u,backupDir:c})}async function br(e,t){let n=await gr(e),r=[],i=t===`define`?/export\s+class\s+\w+Module\s+implements\s+AppModule\s*\{/:/export\s+const\s+\w+Module\s*=\s*defineModule\s*\(/;for(let e of n){let t=await w(e,`utf-8`);i.test(t)&&r.push(e)}return r}async function xr(e){let{name:t,outDir:n}=e,r=L(t),i=z(t),a=R(t),o=e.queue??`${i}-queue`,s=[];return await(async(e,t)=>{let r=h(n,e);await N(r,t),s.push(r)})(`${i}.job.ts`,`import { Inject } from '@forinda/kickjs'
|
|
2270
2271
|
import { Job, Process, QUEUE_MANAGER, type QueueService } from '@forinda/kickjs-queue'
|
|
2271
2272
|
|
|
2272
2273
|
/**
|
|
@@ -2299,7 +2300,7 @@ export class ${r}Job {
|
|
|
2299
2300
|
// Handle high-priority variant of this job
|
|
2300
2301
|
}
|
|
2301
2302
|
}
|
|
2302
|
-
`),s}const
|
|
2303
|
+
`),s}const Sr={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 Cr(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=Sr[a];if(!o){let e=[...Object.keys(Sr),`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 wr(e){let{name:t,fields:n,modulesDir:r,repo:i=`inmemory`,tokenScope:a=`app`,style:o=`define`}=e,s=e.pluralize!==!1,c=z(t),l=L(t),u=s?B(c):c,d=s?Yt(l):l,f=h(r,u),p=[],m=async(e,t)=>{let n=h(f,e);await N(n,t),p.push(n)};await m(`${c}.module.ts`,_n({pascal:l,kebab:c,plural:u,repo:i,style:o})),await m(`${c}.constants.ts`,kn({pascal:l,kebab:c})),await m(`${c}.controller.ts`,yn({pascal:l,kebab:c,plural:u,pluralPascal:d})),await m(`${c}.service.ts`,On({pascal:l,kebab:c})),await m(`dtos/create-${c}.dto.ts`,Tr(l,n)),await m(`dtos/update-${c}.dto.ts`,Er(l,n)),await m(`dtos/${c}-response.dto.ts`,Dr(l,n)),await m(`${c}.repository.ts`,Cn({pascal:l,kebab:c,dtoPrefix:`./dtos`,tokenScope:a}));let g=i===`inmemory`,_=g?`in-memory-${c}`:`${z(i)}-${c}`,v=g?wn({pascal:l,kebab:c,repoPrefix:`.`,dtoPrefix:`./dtos`}):Tn({pascal:l,kebab:c,repoType:i,repoPrefix:`.`,dtoPrefix:`./dtos`});return await m(`${_}.repository.ts`,v),await Pn(r,l,u,c,o),p}function Tr(e,t){return`import { z } from 'zod'
|
|
2303
2304
|
|
|
2304
2305
|
export const create${e}Schema = z.object({
|
|
2305
2306
|
${t.map(e=>{let t=e.zodType;return` ${e.name}: ${t}${e.optional?`.optional()`:``},`}).join(`
|
|
@@ -2307,7 +2308,7 @@ ${t.map(e=>{let t=e.zodType;return` ${e.name}: ${t}${e.optional?`.optional()`:`
|
|
|
2307
2308
|
})
|
|
2308
2309
|
|
|
2309
2310
|
export type Create${e}DTO = z.infer<typeof create${e}Schema>
|
|
2310
|
-
`}function
|
|
2311
|
+
`}function Er(e,t){return`import { z } from 'zod'
|
|
2311
2312
|
|
|
2312
2313
|
export const update${e}Schema = z.object({
|
|
2313
2314
|
${t.map(e=>` ${e.name}: ${e.zodType}.optional(),`).join(`
|
|
@@ -2315,14 +2316,14 @@ ${t.map(e=>` ${e.name}: ${e.zodType}.optional(),`).join(`
|
|
|
2315
2316
|
})
|
|
2316
2317
|
|
|
2317
2318
|
export type Update${e}DTO = z.infer<typeof update${e}Schema>
|
|
2318
|
-
`}function
|
|
2319
|
+
`}function Dr(e,t){return`export interface ${e}ResponseDTO {
|
|
2319
2320
|
id: string
|
|
2320
2321
|
${t.map(e=>` ${e.name}${e.optional?`?`:``}: ${e.tsType}`).join(`
|
|
2321
2322
|
`)}
|
|
2322
2323
|
createdAt: string
|
|
2323
2324
|
updatedAt: string
|
|
2324
2325
|
}
|
|
2325
|
-
`}async function
|
|
2326
|
+
`}async function Or(e){let{name:t,moduleName:n,modulesDir:r}=e,i=e.pluralize??!0,a=z(t),o=L(t),s=[],c;if(e.outDir)c=v(e.outDir);else if(n){let e=z(n),t=i?B(e):e;c=v(h(r??`src/modules`,t,`__tests__`))}else c=v(`src/__tests__`);let l=h(c,`${a}.test.ts`);return await N(l,`import { describe, it, expect, beforeEach } from 'vitest'
|
|
2326
2327
|
import { Container } from '@forinda/kickjs'
|
|
2327
2328
|
|
|
2328
2329
|
describe('${o}', () => {
|
|
@@ -2345,9 +2346,9 @@ describe('${o}', () => {
|
|
|
2345
2346
|
expect(true).toBe(true)
|
|
2346
2347
|
})
|
|
2347
2348
|
})
|
|
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
|
|
2350
|
-
`)}function
|
|
2349
|
+
`),s.push(l),s}const kr=[`classes`,`tokens`,`injects`,`pluginsAndAdapters`,`augmentations`,`contextKeys`,`routes`,`moduleMounts`,`globPatterns`];function Ar(e){if(!e||typeof e!=`object`)return!1;let t=e;return kr.every(e=>Array.isArray(t[e]))}var jr=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 w(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`&&Ar(n.extract)&&r.set(e,n)}catch{}return new e(n,r)}static async signature(e){try{let t=await ce(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 C(f(this.path),{recursive:!0}),await T(this.path,JSON.stringify(t),`utf-8`)}catch{}}};let Mr=null;function Nr(){return Mr??=new Set(Yr),Mr}const Pr=new Set([`Get`,`Post`,`Put`,`Delete`,`Patch`]);function H(e){return typeof e==`object`&&!!e&&typeof e.type==`string`}function U(e,t){if(Array.isArray(e)){for(let n of e)U(n,t);return}if(H(e)){t(e);for(let n of Object.keys(e)){if(n===`type`)continue;let r=e[n];typeof r==`object`&&r&&U(r,t)}}}function W(e){if(!H(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 G(e){return H(e)&&e.type===`Identifier`?e.name:null}function Fr(e){return G(e.callee)}function K(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((G(e)??(e.type===`Literal`?String(e.value):W(e)))===t)return n.value}return null}function Ir(e){let t=e.arguments?.[0];return H(t)&&t.type===`ObjectExpression`?t:null}function Lr(e,t){let n=K(e,t);if(!H(n)||n.type!==`ArrayExpression`)return[];let r=[];for(let e of n.elements??[]){let t=W(e);t!==null&&r.push(t)}return r}function Rr(e,t){return _(t,e).split(y).join(`/`)}function zr(e){return(e.match(/:([a-zA-Z_]\w*)/g)??[]).map(e=>e.slice(1))}function Br(e,t){for(let n of e.implements??[]){let e=n.expression??n;if(G(e)===t)return!0;if(e.type===`TSQualifiedName`||e.type===`MemberExpression`){let n=e.right??e.property;if(n&&G(n)===t)return!0}}return!1}function Vr(e){return e.decorators??[]}function Hr(e){let t=e.expression;if(!H(t)||t.type!==`CallExpression`)return null;let n=Fr(t);return n?{name:n,call:t}:null}function Ur(e){let t=new Map,n=new Set;for(let r of e.body??[]){if(r.type===`ImportDeclaration`){let e=W(r.source)??``;for(let n of r.specifiers??[]){let r=G(n.local);r&&t.set(r,{source:e})}continue}let e=r.type===`VariableDeclaration`?r:r.type===`ExportNamedDeclaration`&&H(r.declaration)?r.declaration:null;if(H(e)&&e.type===`VariableDeclaration`)for(let t of e.declarations??[]){let e=G(t.id);e&&n.add(e)}}return{imports:t,topLevelConsts:n}}function Wr(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 Gr(e,t,n){let r=G(K(e,t));return r?Wr(r,n):null}function Kr(e,t){for(let n of e){let e=Hr(n);if(!e||e.name!==`ApiQueryParams`)continue;let r=e.call.arguments?.[0],i=null;if(H(r)&&r.type===`ObjectExpression`)i=r;else{let e=G(r);if(e){let n=t.get(e);n&&n.type===`ObjectExpression`&&(i=n)}}return{filterable:Lr(i,`filterable`),sortable:Lr(i,`sortable`),searchable:Lr(i,`searchable`)}}return null}function qr(e,t,n){let r;try{let n=fe(t,e);if(n.errors.length>0)return null;r=n.program}catch{return null}let i=Rr(t,n),a=Ur(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`&&H(e.declaration)?e.declaration:null;if(H(t)&&t.type===`VariableDeclaration`)for(let e of t.declarations??[]){let t=G(e.id);t&&H(e.init)&&v.set(t,e.init)}}let y=[];for(let e of r.body??[])if(e.type===`ExportNamedDeclaration`&&H(e.declaration)){let t=e.declaration;t.type===`ClassDeclaration`&&y.push({cls:t,isDefault:!1})}else if(e.type===`ExportDefaultDeclaration`&&H(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=G(e.id);if(!r)continue;let a=null;for(let t of Vr(e)){let e=Hr(t);if(e&&Nr().has(e.name)){a=e.name;break}}a?o.push({className:r,decorator:a,filePath:t,relativePath:i,isDefault:n}):Br(e,`AppModule`)&&o.push({className:r,decorator:`Module`,filePath:t,relativePath:i,isDefault:n})}for(let e of r.body??[]){if(e.type!==`ExportNamedDeclaration`||!H(e.declaration))continue;let n=e.declaration;if(n.type===`VariableDeclaration`)for(let e of n.declarations??[]){let n=G(e.id),r=e.init;!n||!H(r)||r.type!==`CallExpression`||Fr(r)===`defineModule`&&(o.some(e=>e.className===n)||o.push({className:n,decorator:`Module`,filePath:t,relativePath:i,isDefault:!1}))}}U(r,e=>{if(e.type===`VariableDeclarator`){let n=e.init;if(H(n)&&n.type===`CallExpression`&&Fr(n)===`createToken`){let r=W(n.arguments?.[0]);r!==null&&(_.add(n),s.push({name:r,variable:G(e.id),filePath:t,relativePath:i}))}return}if(e.type!==`CallExpression`){if(e.type===`Decorator`){let n=Hr(e);if(n?.name===`Inject`){let e=W(n.call.arguments?.[0]);e!==null&&c.push({name:e,filePath:t,relativePath:i})}}return}let n=e.callee,r=Fr(e);if(r===`createToken`&&!_.has(e)){let n=W(e.arguments?.[0]);n!==null&&s.push({name:n,variable:null,filePath:t,relativePath:i});return}if(r===`defineAdapter`||r===`definePlugin`){let n=W(K(Ir(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=W(n[0]);if(r!==null){let e=H(n[1])&&n[1].type===`ObjectExpression`?n[1]:null;u.push({name:r,description:W(K(e,`description`)),example:W(K(e,`example`)),filePath:t,relativePath:i})}return}if(r===`defineContextDecorator`||r===`defineHttpContextDecorator`){let n=W(K(Ir(e),`key`));n!==null&&!g.has(n)&&(g.add(n),d.push({key:n,filePath:t,relativePath:i}));return}if(H(n)&&n.type===`CallExpression`){let r=n.callee;if(H(r)&&r.type===`MemberExpression`&&G(r.property)===`withParams`){let n=G(r.object);if(n===`defineContextDecorator`||n===`defineHttpContextDecorator`){let n=W(K(Ir(e),`key`));n!==null&&!g.has(n)&&(g.add(n),d.push({key:n,filePath:t,relativePath:i}))}}return}if(H(n)&&n.type===`MemberExpression`&&G(n.property)===`glob`){let t=n.object;H(t)&&t.type===`MetaProperty`&&U(e.arguments,e=>{let t=W(e);t!==null&&m.push(t)})}});let b=[];U(r,e=>{if(e.type===`ClassDeclaration`||e.type===`ClassExpression`){let t=G(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(Br(e,`AppAdapter`))for(let e of s??[]){if(e.type!==`PropertyDefinition`||G(e.key)!==`name`)continue;let n=W(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=G(e.key);if(!o)continue;if(o===`routes`){Jr(e.value,p);continue}if(!r)continue;let s=Vr(e),c=Kr(s,v);for(let e of s){let r=Hr(e);if(!r||!Pr.has(r.name))continue;let s=r.call.arguments??[],l=W(s[0]),u=l&&l.length>0?l:`/`,d=H(s[1])&&s[1].type===`ObjectExpression`?s[1]:null;f.push({controller:n,method:o,httpMethod:r.name.toUpperCase(),path:u,pathParams:zr(u),queryFilterable:c?.filterable??null,querySortable:c?.sortable??null,querySearchable:c?.searchable??null,bodySchema:Gr(d,`body`,a),querySchema:Gr(d,`query`,a),paramsSchema:Gr(d,`params`,a),filePath:t,relativePath:i})}}}return U(r,e=>{if(e.type!==`Property`||G(e.key)!==`routes`)return;let t=e.value;H(t)&&(t.type===`FunctionExpression`||t.type===`ArrowFunctionExpression`)&&Jr(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 Jr(e,t){let n=[],r=[];U(e.body,e=>{if(e.type!==`Property`)return;let t=G(e.key);if(t===`path`){let t=W(e.value);t!==null&&n.push(t)}else if(t===`controller`){let t=G(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 Yr=[`Service`,`Controller`,`Repository`,`Injectable`,`Component`,`Module`],Xr=[`.ts`,`.tsx`,`.mts`,`.cts`],Zr=[`node_modules`,`.kickjs`,`dist`,`build`,`.test.`,`.spec.`,`.d.ts`],Qr=new RegExp(String.raw`@(${Yr.join(`|`)})\s*\([^)]*\)`+String.raw`(?:\s*@[A-Z]\w*(?:\s*\([^)]*\))?)*`+String.raw`\s*export\s+(default\s+)?(?:abstract\s+)?class\s+(\w+)`,`g`),$r=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`),ei=/export\s+const\s+(\w+)\s*(?::\s*[^=]+)?=\s*defineModule\s*(?:<[^>]*>)?\s*\(/g,ti=/(?:export\s+)?const\s+(\w+)\s*(?::\s*[^=]+)?=\s*createToken\s*(?:<[^>]*>)?\s*\(\s*['"`]([^'"`]+)['"`]\s*\)/g,ni=/createToken\s*(?:<[^>]*>)?\s*\(\s*['"`]([^'"`]+)['"`]\s*\)/g,ri=/@Inject\s*\(\s*['"`]([^'"`]+)['"`]\s*\)/g,ii=/\b(defineAdapter|definePlugin)\s*(?:<[^>]*>)?\s*\(/g,ai=/\b(?:defineContextDecorator|defineHttpContextDecorator)\s*(?:\.withParams\s*<(?:[^<>]|<[^<>]*>)*>\s*\(\s*\))?\s*(?:<(?:[^<>]|<[^<>]*>)*>)?\s*\(/g,oi=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`),si=/\bname\s*(?::\s*[^=]+)?=\s*['"`]([^'"`]+)['"`]/,ci=/\bdefineAugmentation\s*\(\s*['"`]([^'"`]+)['"`]\s*(,\s*\{)?/g,li=new RegExp(String.raw`@(${[`Get`,`Post`,`Put`,`Delete`,`Patch`].join(`|`)})\s*\(`,`g`);function ui(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 di(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=ui(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 fi(e){return(e.match(/:([a-zA-Z_]\w*)/g)??[]).map(e=>e.slice(1))}function pi(e,t){let n=e.endsWith(`/`)?e.slice(0,-1):e;return!t||t===`/`?n||`/`:n+(t.startsWith(`/`)?t:`/`+t)||`/`}const mi=/\b(?:public\s+|private\s+|protected\s+)?routes\s*\([^)]*\)\s*(?::\s*[A-Za-z_][\w<>[\]\s,|]*\s*)?\{/g,hi=/\bpath\s*:\s*['"`]([^'"`]*)['"`]/g,gi=/\bcontroller\s*:\s*([A-Z]\w*)\b/g,_i=/\bimport\.meta\.glob\s*\(/g;function vi(e){let t=[];for(_i.lastIndex=0;_i.exec(e)!==null;){let n=_i.lastIndex-1,r=ui(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 yi(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 bi(e,t){let n=e.startsWith(`./`)?e:`./`+e,r=!1;for(let e of t){let t=e.startsWith(`!`);yi(t?e.slice(1):e).test(n)&&(r=!t)}return r}function xi(e){let t=[];mi.lastIndex=0;let n;for(;(n=mi.exec(e))!==null;){let r=e.indexOf(`{`,n.index+n[0].length-1);if(r<0)continue;let i=Ni(e,r);if(i<0)continue;let a=e.slice(r+1,i),o=[];hi.lastIndex=0;let s;for(;(s=hi.exec(a))!==null;)o.push(s[1]??``);let c=[];gi.lastIndex=0;let l;for(;(l=gi.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 Si(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 Ci(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 wi(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?Ti(n[1].trim(),t):null}return Ti(n[1].trim(),t)}function Ti(e,t){if(e.startsWith(`{`))return Di(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 Di(r[1])}return{filterable:[],sortable:[],searchable:[]}}function Ei(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 Di(e){return{filterable:Ei(e,`filterable`),sortable:Ei(e,`sortable`),searchable:Ei(e,`searchable`)}}async function Oi(e,t){let n=t.extensions??Xr,r=t.exclude??Zr,i=[],a;try{a=await oe(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 Oi(a,t)):o.isFile()&&n.some(e=>o.name.endsWith(e))&&i.push(a))}return i}function q(e,t){return _(t,e).split(y).join(`/`)}function ki(e,t,n){let r=[],i=q(t,n);Qr.lastIndex=0;let a;for(;(a=Qr.exec(e))!==null;){let[,e,n,o]=a;r.push({className:o,decorator:e,filePath:t,relativePath:i,isDefault:!!n})}$r.lastIndex=0;let o;for(;(o=$r.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})}ei.lastIndex=0;let s;for(;(s=ei.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 Ai(e,t,n){let r=[],i=q(t,n),a=new Set;ti.lastIndex=0;let o;for(;(o=ti.exec(e))!==null;){let[e,n,s]=o;a.add(e),r.push({name:s,variable:n,filePath:t,relativePath:i})}for(ni.lastIndex=0;(o=ni.exec(e))!==null;)a.has(o[0])||r.push({name:o[1],variable:null,filePath:t,relativePath:i});return r}function ji(e,t,n,r,i=new Map){let a=[];if(r.length===0)return a;let o=q(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);li.lastIndex=0;let d;for(;(d=li.exec(u))!==null;){let n=d[1],s=d.index,c=li.lastIndex-1,l=ui(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=di(u,l+1);if(!h)continue;let{methodName:g,endPos:_}=h;li.lastIndex=_;let v=wi(u.slice(s,_),e),y=Si(f,`body`),b=Si(f,`query`),x=Si(f,`params`),ee=i.get(r.className)??``,S=ee?pi(ee,m):m;a.push({controller:r.className,method:g,httpMethod:n.toUpperCase(),path:m,pathParams:fi(S),queryFilterable:v?.filterable??null,querySortable:v?.sortable??null,querySearchable:v?.searchable??null,bodySchema:y?{identifier:y,source:Ci(e,y)}:null,querySchema:b?{identifier:b,source:Ci(e,b)}:null,paramsSchema:x?{identifier:x,source:Ci(e,x)}:null,filePath:t,relativePath:o})}}return a}function Mi(e,t,n){let r=[],i=q(t,n);ri.lastIndex=0;let a;for(;(a=ri.exec(e))!==null;)r.push({name:a[1],filePath:t,relativePath:i});return r}function Ni(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 Pi(e,t,n){let r=[],i=q(t,n),a=new Set;ii.lastIndex=0;let o;for(;(o=ii.exec(e))!==null;){let n=o[1],s=ii.lastIndex-1,c=ui(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}))}oi.lastIndex=0;let s;for(;(s=oi.exec(e))!==null;){let n=s.index,o=e.indexOf(`{`,n);if(o<0)continue;let c=Ni(e,o);if(c<0)continue;let l=e.slice(o+1,c),u=si.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 Fi(e,t,n){let r=[],i=q(t,n),a=new Set;for(ai.lastIndex=0;ai.exec(e)!==null;){let n=ai.lastIndex-1,o=ui(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 Ii(e,t,n){let r=[],i=q(t,n);ci.lastIndex=0;let a;for(;(a=ci.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=Ni(e,t);if(n>=0){let r=e.slice(t+1,n);o=Li(r,`description`),s=Li(r,`example`)}}}r.push({name:n,description:o,example:s,filePath:t,relativePath:i})}return r}function Li(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`?`
|
|
2350
|
+
`:t===`t`?` `:t===`r`?`\r`:t)}const Ri=[`src/config/index.ts`,`src/config/env.ts`,`src/config.ts`,`src/env.ts`];async function zi(e,t){let n=t===`src/env.ts`?Ri:[t];for(let t of n){let n=v(e,t),r;try{r=await w(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:q(n,e)}}return null}function Bi(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 Vi(e,t,n){return qr(e,t,n)||Hi(e,t,n)}function Hi(e,t,n){let r=ki(e,t,n);return{classes:r,tokens:Ai(e,t,n),injects:Mi(e,t,n),pluginsAndAdapters:Pi(e,t,n),augmentations:Ii(e,t,n),contextKeys:Fi(e,t,n),routes:ji(e,t,n,r,new Map),moduleMounts:xi(e),globPatterns:/\.module\.[mc]?[tj]sx?$/.test(t)?vi(e):[]}}async function Ui(e,t,n){let r=n?await jr.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 w(e,`utf-8`)}catch{return null}let a=Vi(i,e,t);return n&&r&&n.set(e,r,a),a}async function Wi(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 Gi(e){let t=(await Oi(v(e.root),e)).toSorted(),n=e.cacheDir?await jr.load(e.cacheDir):null,r=Ji(t,await Wi(t,16,t=>Ui(t,e.cwd,n))),i=await zi(e.cwd,e.envFile??`src/env.ts`);return n&&await n.save(),{...r,env:i}}function Ki(e,t,n){let r=n.extensions??Xr,i=n.exclude??Zr;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 qi(e,t){if(!e.cacheDir)return Gi(e);let n=v(e.root),r=await jr.load(e.cacheDir),i=r.cachedFiles();if(i.length===0)return Gi(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)&&Ki(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 Wi(o,16,async t=>{if(!c.has(t))return;let n=await jr.signature(t),i;try{i=await w(t,`utf-8`)}catch{c.delete(t);return}let a=Vi(i,t,e.cwd);l.set(t,a),n&&r.set(t,n,a)});let u=[...c].toSorted(),d=Ji(u,u.map(e=>l.get(e)||(r.carry(e),r.peek(e)))),f=await zi(e.cwd,e.envFile??`src/env.ts`);return await r.save(),{...d,env:f}}function Ji(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=pi(t,e.path);r.push({...e,pathParams:fi(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&&(bi(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=Bi(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 J="/* 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",Yi=new Set([`Service`,`Repository`,`Injectable`,`Component`]);var Xi=class extends Error{collisions;constructor(e){super(Zi(e)),this.name=`TokenCollisionError`,this.collisions=e}};function Zi(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(`
|
|
2351
|
+
`)}function Qi(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 $i(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 ea(e,t,n){let r=new Set,i=[];for(let a of e){if(!Yi.has(a.decorator))continue;let e=n.has(a.className)?$i(a):a.className;if(r.has(e))continue;r.add(e);let o=Qi(a.filePath,t),s=a.isDefault?`import('${o}').default`:`import('${o}').${a.className}`;i.push(` '${e}': ${s}`)}return`${J}
|
|
2351
2352
|
declare module '@forinda/kickjs' {
|
|
2352
2353
|
interface KickJsRegistry {
|
|
2353
2354
|
${i.length?i.join(`
|
|
@@ -2356,7 +2357,7 @@ ${i.length?i.join(`
|
|
|
2356
2357
|
}
|
|
2357
2358
|
|
|
2358
2359
|
export {}
|
|
2359
|
-
`}function
|
|
2360
|
+
`}function ta(e){return/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(e)}function na(e){return`${J}
|
|
2360
2361
|
declare module '@forinda/kickjs' {
|
|
2361
2362
|
/**
|
|
2362
2363
|
* Key-only registry of every context key produced by a
|
|
@@ -2365,20 +2366,20 @@ declare module '@forinda/kickjs' {
|
|
|
2365
2366
|
* \`ContextMeta\`; this only records that the key exists.
|
|
2366
2367
|
*/
|
|
2367
2368
|
interface ContextKeys {
|
|
2368
|
-
${[...new Set(e.map(e=>e.key))].toSorted().map(e=>` ${
|
|
2369
|
+
${[...new Set(e.map(e=>e.key))].toSorted().map(e=>` ${ta(e)?e:JSON.stringify(e)}: true`).join(`
|
|
2369
2370
|
`)}
|
|
2370
2371
|
}
|
|
2371
2372
|
}
|
|
2372
2373
|
|
|
2373
2374
|
export {}
|
|
2374
|
-
`}function
|
|
2375
|
+
`}function ra(e,t,n){return t.length===0?`${J}
|
|
2375
2376
|
// ${n}
|
|
2376
2377
|
export type ${e} = never
|
|
2377
|
-
`:`${
|
|
2378
|
+
`:`${J}
|
|
2378
2379
|
export type ${e} =
|
|
2379
2380
|
${[...new Set(t)].toSorted().map(e=>` | '${e}'`).join(`
|
|
2380
2381
|
`)}
|
|
2381
|
-
`}function
|
|
2382
|
+
`}function ia(e,t,n,r){return[...e.filter(e=>Yi.has(e.decorator)).map(e=>r.has(e.className)?$i(e):e.className),...t.map(e=>e.name),...n.map(e=>e.name)]}function aa(e){return e.filter(e=>e.decorator===`Module`).map(e=>e.className)}function oa(e){let t=new Map;for(let n of e)t.has(n.name)||t.set(n.name,n);return`${J}
|
|
2382
2383
|
declare module '@forinda/kickjs' {
|
|
2383
2384
|
/**
|
|
2384
2385
|
* Map of every plugin/adapter \`name\` discovered in the project. The
|
|
@@ -2393,7 +2394,7 @@ ${[...t.values()].toSorted((e,t)=>e.name.localeCompare(t.name)).map(e=>` '${e
|
|
|
2393
2394
|
}
|
|
2394
2395
|
|
|
2395
2396
|
export {}
|
|
2396
|
-
`}function
|
|
2397
|
+
`}function sa(e){if(e.length===0)return`${J}
|
|
2397
2398
|
// No augmentations discovered.
|
|
2398
2399
|
//
|
|
2399
2400
|
// Plugins advertise augmentable interfaces via:
|
|
@@ -2409,7 +2410,7 @@ export {}
|
|
|
2409
2410
|
`;let t=new Map;for(let n of e)t.has(n.name)||t.set(n.name,n);let n=[];for(let e of[...t.values()].toSorted((e,t)=>e.name.localeCompare(t.name))){let t=[];if(e.description)for(let n of e.description.split(`
|
|
2410
2411
|
`))t.push(` * ${n}`);if(e.example){t.push(` * @example`," * ```ts");for(let n of e.example.split(`
|
|
2411
2412
|
`))t.push(` * ${n}`);t.push(" * ```")}t.push(` * @see ${e.relativePath}`),n.push([`/**`,...t,` */`,`export interface ${e.name}Augmentation {}`].join(`
|
|
2412
|
-
`))}return`${
|
|
2413
|
+
`))}return`${J}
|
|
2413
2414
|
// Catalogue of augmentable interfaces in this project. The interfaces
|
|
2414
2415
|
// below are documentation only — augment the source-of-truth interfaces
|
|
2415
2416
|
// in your own \`d.ts\` files (the framework declares the actual types).
|
|
@@ -2417,7 +2418,7 @@ export {}
|
|
|
2417
2418
|
${n.join(`
|
|
2418
2419
|
|
|
2419
2420
|
`)}
|
|
2420
|
-
`}const
|
|
2421
|
+
`}const ca=/^(kick\/)?([a-z][\w-]*\/[A-Z]\w*)(\/.+)?(:[a-z][\w-]+(:[a-z][\w-]+)*)?$/;function la(e){let t=[];for(let n of e){let e=n.name;e.startsWith(`kickjs.`)||ca.test(e)||t.push({token:e,variable:n.variable,filePath:n.relativePath,reason:"does not match `<scope>/<PascalKey>[/<suffix>][:<instance>]`",suggestion:ua(e)})}return t}function ua(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 da(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(!ga(e))continue;let a=me(i.glob??`**/*`,{cwd:e,nodir:!0,dot:!1,posix:!0});a.sort();let{pairs:o}=he(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 fa(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
2422
|
declare module '@forinda/kickjs' {
|
|
2422
2423
|
/**
|
|
2423
2424
|
* Map of every typed asset discovered in the project's assetMap.
|
|
@@ -2428,7 +2429,7 @@ declare module '@forinda/kickjs' {
|
|
|
2428
2429
|
}
|
|
2429
2430
|
|
|
2430
2431
|
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===
|
|
2432
|
+
`;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===pa){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]=pa)}return`${t}
|
|
2432
2433
|
declare module '@forinda/kickjs' {
|
|
2433
2434
|
/**
|
|
2434
2435
|
* Map of every typed asset discovered in the project's assetMap.
|
|
@@ -2437,63 +2438,63 @@ declare module '@forinda/kickjs' {
|
|
|
2437
2438
|
* prod → dist).
|
|
2438
2439
|
*/
|
|
2439
2440
|
interface KickAssets {
|
|
2440
|
-
${
|
|
2441
|
+
${ma(n,` `)}
|
|
2441
2442
|
}
|
|
2442
2443
|
}
|
|
2443
2444
|
|
|
2444
2445
|
export {}
|
|
2445
|
-
`}const
|
|
2446
|
-
`)}function
|
|
2446
|
+
`}const pa=Symbol(`asset-leaf`);function ma(e,t){let n=Object.keys(e).toSorted(),r=[];for(let i of n){let n=e[i],a=ha(i)?i:JSON.stringify(i);n===pa?r.push(`${t}${a}: () => string`):(r.push(`${t}${a}: {`),r.push(ma(n,`${t} `)),r.push(`${t}}`))}return r.join(`
|
|
2447
|
+
`)}function ha(e){return/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(e)}function ga(e){try{return c(e).isDirectory()}catch{return!1}}var _a=k({runTypegen:()=>ya,sweepStaleTypegen:()=>Ca,watchTypegen:()=>Sa,writeTypegenArtifacts:()=>xa});function va(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 ya(e={}){let{cwd:t,srcDir:n,outDir:r,silent:i,allowDuplicates:a,envFile:o}=va(e),s=Date.now(),c={root:n,cwd:t,cacheDir:e.noCache?void 0:v(t,`.kickjs`,`cache`),envFile:o===!1?void 0:o},l=e.changedFiles?await qi(c,e.changedFiles):await Gi(c);if(l.collisions.length>0&&!a)throw new Xi(l.collisions);let u=da(e.assetMap,t),d=[],f=[];if(e.runPlugins!==!1){try{let{runAllPluginTypegens:n}=await Promise.resolve().then(()=>Ia),{loadKickConfig:r}=await Promise.resolve().then(()=>we);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 xa(r,d,i))}let p=la(l.tokens),m=ba(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 ba(e,t,n){let r=new Set(e.collisions.map(e=>e.className)),i=e.classes.filter(e=>Yi.has(e.decorator)),a=ia(e.classes,e.tokens,e.injects,r);return{registryEntries:i.length,serviceTokens:new Set(a).size,moduleTokens:aa(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 xa(e,t,n){await C(e,{recursive:!0}),await T(h(f(e),`.gitignore`),`# Auto-generated by kick typegen
|
|
2447
2448
|
*
|
|
2448
|
-
`,`utf-8`);let r=t.filter(e=>e.outFile).map(e=>e.outFile);return await
|
|
2449
|
+
`,`utf-8`);let r=t.filter(e=>e.outFile).map(e=>e.outFile);return await Ca(e,r,t,n),r}async function Sa(e={}){let t=va(e),{srcDir:n,silent:r,cwd:i}=t,a={...t,allowDuplicates:!0,runPlugins:!1,noCache:e.noCache},o=process.env.KICKJS_WATCH_POLLING===`1`||process.env.KICKJS_WATCH_POLLING===`true`,[{runAllPluginTypegens:s},{loadKickConfig:c}]=await Promise.all([Promise.resolve().then(()=>Ia),Promise.resolve().then(()=>we)]),l=await c(i),u=async()=>{try{await ya({...a})}catch(e){if(r)return;if(e instanceof Xi)console.error(`
|
|
2449
2450
|
`+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
|
|
2451
|
+
`);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 xa(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 Ca(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 oe(e)}catch{return[]}let o=[];for(let t of a){if(!wa.has(t)||i.has(t))continue;let n=v(e,t);try{if(!(await ce(n)).isFile())continue;await le(n),o.push(t)}catch{}}return o.length>0&&!r&&console.log(` kick typegen: swept ${o.length} stale file(s): ${o.join(`, `)}`),o}const wa=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`]),Ta=[`agents`,`claude`,`skills`,`gemini`,`copilot`,`both`,`all`];function Y(e){return e.parent?.opts()?.dryRun??!1}function X(e,t=!1){let n=process.cwd();console.log(`\n ${t?`Would generate`:`Generated`} ${e.length} file${e.length===1?``:`s`}:`);for(let t of e)console.log(` ${t.replace(n+`/`,``)}`);t&&console.log(`
|
|
2452
|
+
(dry run — no files were written)`),console.log()}async function Ea(e){if(!e)try{let e=await j(process.cwd());await ya({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 Da=[{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`}],Oa=new Set(Da.map(e=>e.name.split(` `)[0]));async function ka(){console.log(`
|
|
2452
2453
|
Built-in generators:
|
|
2453
|
-
`);let e=Math.max(...
|
|
2454
|
+
`);let e=Math.max(...Da.map(e=>e.name.length));for(let t of Da)console.log(` kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await j(process.cwd()),n=Ie(t?.plugins??[],t?.commands??[]),r=await un(process.cwd(),n.generators);if(r.generators.length>0){console.log(`
|
|
2454
2455
|
Plugin generators:
|
|
2455
2456
|
`);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
2457
|
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=
|
|
2458
|
+
`);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}async function Aa(e,t,n){let r=await j(process.cwd()),i=A(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??Mn(i.repo);t.repo&&Oe(t.repo);let s=t.pattern??r?.pattern??`rest`,c=t.pluralize===!1?!1:i.pluralize??!0,l=Ae(r,process.cwd()),u=i.style??`define`;if(!n&&u===`define`){let e=await br(v(a),`define`);if(e.length>0){console.error(`\n ${O.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n ${O.dim(`Project setting:`)} modules.style: 'define' (default)\n\n ${O.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 ${O.bold(`Pick one:`)}\n 1. Migrate everything to defineModule:\n ${O.dim(`$`)} kick codemod modules --experimental --apply\n 2. Keep the class form — pin it in kick.config.ts:\n ${O.dim(`// kick.config.ts`)}\n ${O.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let d=[];for(let r of e){let e=await Nn({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)}X(d,n),await Ea(n)}function ja(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 ka();return}if(!e||e.length===0){n.help();return}let a=Y(i);M(a);let[o,s,...c]=e;if(o){let e=await j(process.cwd()),n=Ie(e?.plugins??[],e?.commands??[]),i=await ln({generatorName:o,itemName:s??``,args:c,flags:r,cwd:process.cwd(),projectRoot:t?.projectRoot},n.generators);if(i){X(i.files,a);return}if(o!==`module`&&Oa.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 Aa(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=Y(n);M(r),await Aa(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=Y(n);M(r),X(await Vn({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=Y(n);M(r),X(await Hn({name:e,outDir:v(t.out)}),r)}),n.command(`middleware <name>`).description(`Generate an Express middleware function
|
|
2459
|
+
Use -m to scope it to a module: kick g middleware auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=Y(n);M(r);let i=await j(process.cwd()),a=A(i),o=a.dir??`src/modules`;X(await Gn({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.)
|
|
2460
|
+
Use -m to scope it to a module: kick g guard admin -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=Y(n);M(r);let i=await j(process.cwd()),a=A(i),o=a.dir??`src/modules`;X(await Kn({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
2461
|
--type http (default, RequestContext) | bare (ExecutionContext)
|
|
2461
2462
|
--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=
|
|
2463
|
+
Use -m to scope it to a module: kick g contributor tenant -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).option(`-t, --type <type>`,`Contributor flavour: http | bare`,`http`).option(`-k, --key <key>`,`Context key it writes (defaults to camelCase of name)`).option(`--params <fields>`,`Per-call params, e.g. "source:string,region:number"`).action(async(e,t,n)=>{let r=Y(n);M(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 j(process.cwd()),o=A(a),s=o.dir??`src/modules`;X(await Yn({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
|
|
2464
|
+
Use -m to scope it to a module: kick g service payment -m orders`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=Y(n);M(r);let i=await j(process.cwd()),a=A(i),o=a.dir??`src/modules`;X(await Xn({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
|
|
2465
|
+
Use -m to scope it to a module: kick g controller auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=Y(n);M(r);let i=await j(process.cwd()),a=A(i),o=a.dir??`src/modules`;X(await Zn({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r),await Ea(r)}),n.command(`dto <name>`).description(`Generate a Zod DTO schema
|
|
2466
|
+
Use -m to scope it to a module: kick g dto create-user -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=Y(n);M(r);let i=await j(process.cwd()),a=A(i),o=a.dir??`src/modules`;X(await Qn({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
|
|
2467
|
+
Use -m to scope it to a module: kick g test user-service -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module's __tests__/ folder`).action(async(e,t,n)=>{let r=Y(n);M(r);let i=A(await j(process.cwd())),a=i.dir??`src/modules`;X(await Or({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=Y(n);M(r),X(await xr({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
2468
|
Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
|
|
2468
2469
|
Types: string, text, number, int, float, boolean, date, email, url, uuid, json, enum:a,b,c
|
|
2469
2470
|
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=
|
|
2471
|
+
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=Y(r);M(i),t.length===0&&(console.error(`
|
|
2471
2472
|
Error: At least one field is required.
|
|
2472
2473
|
Usage: kick g scaffold <name> <field:type> [field:type...]
|
|
2473
2474
|
Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
|
|
2474
2475
|
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
|
|
2476
|
+
`),process.exit(1));let a=await j(process.cwd()),o=A(a),s=n.modulesDir??o.dir??`src/modules`,c=Cr(t),l=Ae(a,process.cwd()),u=await wr({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)`:``}`);X(u,i),await Ea(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=Y(t);M(n),X(await $n({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=Y(t);M(n);let r=e.only??`all`;if(!Ta.includes(r)){console.error(` Invalid --only value: ${r}. Expected: ${Ta.join(` | `)}`),process.exitCode=1;return}X(await or({outDir:v(`.`),only:r,name:e.name,pm:e.pm,template:e.template,force:e.force}),n)});for(let e of t?.generators??[])Ma(n,e,t?.projectRoot)}function Ma(e,t,n){let{source:r,spec:i}=t,a=i.args?.[0],o=a?.name??`itemName`,s=a?.required?`<${o}>`:`[${o}]`,c=`${i.name} ${s} [extraArgs...]`,l=e.command(c).description(`${i.description} [${r}]`);for(let e of i.flags??[]){let t=e.takesValue?`--${e.name} <value>`:`--${e.name}`,n=e.alias?`-${e.alias}, ${t}`:t;l.option(n,e.description??``)}l.action(async(e,r,a,o)=>{let s=Y(o);M(s);let c=await ln({generatorName:i.name,itemName:e??``,args:r??[],flags:a,cwd:process.cwd(),projectRoot:n},[t]);c&&X(c.files,s)})}async function Na(e){let t=u.resolve(e.cwd,`.kickjs/types`);await C(t,{recursive:!0});let n=new Map,i=e.scan??Gi,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 C(u.dirname(r),{recursive:!0}),await T(r,n,`utf8`)},getScanResult:e=>{let t=Pa(e),r=n.get(t);if(!r){let s={cacheDir:a,...e};r=o?qi(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+`
|
|
2477
|
+
`,d=``;if(r(a)&&(d=await w(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 T(a,l,`utf8`),c.push({id:n.id,status:`written`,outFile:a})}return c}function Pa(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 Fa(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 Ia=k({applyDisableFilter:()=>Fa,runAllPluginTypegens:()=>Ra});function La(){let e=(process.env.LOG_LEVEL??process.env.KICKJS_LOG_LEVEL??``).toLowerCase();return e===`debug`||e===`trace`}async function Ra(e){let{enabled:t,skipped:n,unknown:r}=Fa(Ie([...lc,...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 Na({cwd:e.cwd,config:e.config??{},plugins:t,check:e.check,changedFiles:e.changedFiles});if(!e.silent&&La())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 za=k({ASSET_MANIFEST_VERSION:()=>1,buildAssets:()=>Ba});async function Ba(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 Va(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)+`
|
|
2478
|
+
`,`utf-8`),s(` ✓ wrote manifest → ${_(n,p)} (${Object.keys(d).length} entries)`),{manifestPath:p,entries:u,manifest:f}}async function Va(e,t,a,o){let s=v(a,t.src),c=t.dest?v(a,t.dest):h(o,e);if(Wa(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)||!Ga(s))return{entrySummary:{namespace:e,src:t.src,dest:_(a,c),filesCopied:0},manifestSlice:{}};let l=await pe(t.glob??`**/*`,{cwd:s,nodir:!0,dot:!1,posix:!0});i(c,{recursive:!0});let u={},{pairs:d,collisionGroupsResolved:p}=he(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]=Ua(o,a),!Ha(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 Ha(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 Ua(e,t){return _(e,t).split(/[\\/]/).filter(Boolean).join(`/`)}function Wa(e,t){let n=_(t,e);return n===``?!1:n.startsWith(`..`)||m(n)}function Ga(e){try{return c(e).isDirectory()}catch{return!1}}function Ka(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 qa(e){let{cwd:t,config:n}=e,r=e.debounceMs??100,i=e.pipeline??{runTypegen:async e=>(await Promise.resolve().then(()=>_a)).runTypegen(e),runAllPluginTypegens:async e=>(await Promise.resolve().then(()=>Ia)).runAllPluginTypegens(e),writeTypegenArtifacts:async(e,t,n)=>(await Promise.resolve().then(()=>_a)).writeTypegenArtifacts(e,t,n),buildAssets:async(e,t)=>(await Promise.resolve().then(()=>za)).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=Ka(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 Ja(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 Ya(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 Xa(e,t=12){let n=e.trim().split(/\r?\n/);return n.length<=t?n.join(`
|
|
2478
2479
|
`):`${n.slice(0,t).join(`
|
|
2479
|
-
`)}\n… ${n.length-t} more line(s)`}function
|
|
2480
|
+
`)}\n… ${n.length-t} more line(s)`}function Za(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function Qa(e,t,n={}){t&&(process.env.PORT=t);let r=Za(n.polling),i=process.cwd(),a=await j(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await ya({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 xa(c,await Ra({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=Ja(i);e?p=Ya({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(Xa(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=qa({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(`
|
|
2480
2481
|
KickJS dev server running (Vite + @forinda/kickjs-vite)
|
|
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
|
|
2482
|
+
`),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 $a(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 Qa(e.entry,e.port,{polling:e.polling,typecheck:e.typecheck})}catch(e){e.code===`ERR_MODULE_NOT_FOUND`&&e.message?.includes(`vite`)?console.error(`
|
|
2482
2483
|
Error: vite is not installed.
|
|
2483
2484
|
Run: pnpm add -D vite unplugin-swc
|
|
2484
2485
|
`):console.error(`
|
|
2485
2486
|
Dev server failed:`,e.message??e),process.exit(1)}}),e.command(`build`).description(`Build for production via Vite`).action(async()=>{console.log(`
|
|
2486
2487
|
Building for production...
|
|
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
|
|
2488
|
+
`);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 j(process.cwd()),o=a?.copyDirs??[];if(o.length>0){console.log(`
|
|
2488
2489
|
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(`
|
|
2489
|
-
Building asset map...`);try{await
|
|
2490
|
+
Building asset map...`);try{await Ba(a,{cwd:process.cwd()})}catch(e){console.error(` ✗ asset build failed: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}console.log(`
|
|
2490
2491
|
Build complete.
|
|
2491
|
-
`)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await
|
|
2492
|
-
Building asset map...`);try{await
|
|
2492
|
+
`)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await j(process.cwd());if(!e?.assetMap||Object.keys(e.assetMap).length===0){console.log(` No assetMap entries — nothing to build.`);return}console.log(`
|
|
2493
|
+
Building asset map...`);try{await Ba(e,{cwd:process.cwd()}),console.log(`
|
|
2493
2494
|
Asset build complete.
|
|
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)),
|
|
2495
|
-
Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function
|
|
2496
|
-
`))})}const{bold:
|
|
2495
|
+
`)}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)),xe(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 Qa(e.entry,e.port)}catch(e){console.error(`
|
|
2496
|
+
Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function eo(){try{let e=f(b(import.meta.url));return JSON.parse(a(h(e,`..`,`package.json`),`utf-8`)).version??`unknown`}catch{return`unknown`}}const to=new Set(Object.values(Pt).filter(e=>e.deprecated).map(e=>e.pkg));function no(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:to.has(t)}})}function ro(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 io(e){e.command(`info`).description(`Print system and framework info`).action(()=>{let e=[``,` KickJS CLI v${eo()}`,``,` System:`,` OS: ${_e()} ${ve()} (${ge()})`,` Node: ${process.version}`],t=ro(process.cwd()),n=t?no(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(`
|
|
2497
|
+
`))})}const{bold:Z,dim:Q,green:ao,red:oo,yellow:so,blue:co}=O;function lo(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 uo(e){let t=await fetch(e,{signal:AbortSignal.timeout(5e3)});if(!t.ok)throw Error(`${t.status} ${t.statusText}`);return t.json()}async function fo(e,t){try{return await uo(`${e}${t}`)}catch{return null}}async function po(e){let[t,n,r,i,a]=await Promise.all([fo(e,`/health`),fo(e,`/metrics`),fo(e,`/routes`),fo(e,`/container`),fo(e,`/ws`)]);return{health:t,metrics:n,routes:r,container:i,ws:a}}function mo(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`?ao(`● healthy`):oo(`● `+n.status);console.log(` ${Z(`Health:`)} ${e}`)}else console.log(` ${Z(`Health:`)} ${oo(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?oo:r.errorRate>0?so:ao;console.log(` ${Z(`Uptime:`)} ${lo(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(` ${Et(e.method)} ${t} ${co(e.controller)}.${Q(e.handler)}`)}}console.log(s),console.log()}function ho(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 po(r);t.json?console.log(JSON.stringify(e,null,2)):mo(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(oo(` ✖ 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 go(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 _o=[{match(e,t){let n=go(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
|
|
2497
2498
|
registers the env schema with kickjs at module-load time. Without it,
|
|
2498
2499
|
ConfigService falls back to the base schema (PORT/NODE_ENV/LOG_LEVEL only)
|
|
2499
2500
|
and every user-defined key reads as undefined. @Value() may *appear* to
|
|
@@ -2505,7 +2506,7 @@ import { modules } from './modules'
|
|
|
2505
2506
|
import './config' // ← add this — registers env schema
|
|
2506
2507
|
import { bootstrap } from '@forinda/kickjs'
|
|
2507
2508
|
import { modules } from './modules'
|
|
2508
|
-
`,docs:`https://forinda.github.io/kick-js/guide/configuration.html#wiring-the-schema-at-startup`}}}},{match(e,t){let n
|
|
2509
|
+
`,docs:`https://forinda.github.io/kick-js/guide/configuration.html#wiring-the-schema-at-startup`}}}},{match(e,t){let n=$(e,[`vitest`,`test`,`spec`,`__tests__`,`.test.`]);return $(e,[`already registered`,`already exists`,`duplicate`,`has been registered`])?{confidence:n?85:60,diagnosis:{id:`container-not-reset-in-tests`,title:`DI container leaks between test cases`,explanation:`KickJS decorators register classes on the global Container at import time.
|
|
2509
2510
|
When vitest re-imports your modules across tests, the same class can be
|
|
2510
2511
|
registered twice and the container throws. The fix is to wipe the
|
|
2511
2512
|
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'
|
|
@@ -2515,7 +2516,7 @@ describe('UserController', () => {
|
|
|
2515
2516
|
beforeEach(() => Container.reset())
|
|
2516
2517
|
|
|
2517
2518
|
it('does the thing', async () => { /* ... */ })
|
|
2518
|
-
})`,docs:`https://forinda.github.io/kick-js/guide/testing.html`}}:null}},{match(e,t){return e.includes(`@Module`)||
|
|
2519
|
+
})`,docs:`https://forinda.github.io/kick-js/guide/testing.html`}}:null}},{match(e,t){return e.includes(`@Module`)||go(e,[`Module`,`is not a function`])||go(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
|
|
2519
2520
|
pattern instead: a class implements AppModule and exposes routes() that
|
|
2520
2521
|
returns the controller wiring. This was a deliberate choice — modules
|
|
2521
2522
|
become explicit values rather than metadata, which makes them easier to
|
|
@@ -2542,7 +2543,7 @@ KickRoutes["POST /users"]. The new form is per-controller, per-method,
|
|
|
2542
2543
|
and matches the actual class names so refactors propagate via
|
|
2543
2544
|
rename-symbol instead of grep.`,fix:`Update the Ctx<...> type parameter to use the namespace form:`,codeBefore:`@Post('/', { body: createUserSchema })
|
|
2544
2545
|
create(ctx: Ctx<KickRoutes['POST /users']>) { /* ... */ }`,codeAfter:`@Post('/', { body: createUserSchema, name: 'CreateUser' })
|
|
2545
|
-
create(ctx: Ctx<KickRoutes.UserController['create']>) { /* ... */ }`,docs:`https://forinda.github.io/kick-js/guide/typegen.html`}}:null}},{match(e,t){let n
|
|
2546
|
+
create(ctx: Ctx<KickRoutes.UserController['create']>) { /* ... */ }`,docs:`https://forinda.github.io/kick-js/guide/typegen.html`}}:null}},{match(e,t){let n=$(e,[`cluster`,`workers`,`two ports`,`duplicate server`]),r=$(e,[`kick dev`,`vite`,`eaddrinuse`,`5173`,`5174`,`two servers`]);return!n||!r?null:{confidence:85,diagnosis:{id:`cluster-in-vite-dev`,title:"Cluster mode is incompatible with `kick dev` (Vite owns the server)",explanation:`In dev mode, Vite owns the HTTP server. If your bootstrap passes
|
|
2546
2547
|
cluster: { workers: N }, the framework forks N workers, each of which
|
|
2547
2548
|
spins up its own Vite instance on a separate port. The fix landed in
|
|
2548
2549
|
v2.2.5: McpAdapter (and bootstrap()) now detects Vite dev mode and
|
|
@@ -2550,7 +2551,7 @@ silently skips cluster, with a warning. If you see this on an older
|
|
|
2550
2551
|
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({
|
|
2551
2552
|
modules,
|
|
2552
2553
|
cluster: process.env.NODE_ENV === 'production' ? { workers: 4 } : false,
|
|
2553
|
-
})`,docs:`https://forinda.github.io/kick-js/guide/cluster.html`}}}},{match(e,t){return
|
|
2554
|
+
})`,docs:`https://forinda.github.io/kick-js/guide/cluster.html`}}}},{match(e,t){return $(e,[`reflect-metadata`,`Reflect.getMetadata is not a function`,`Reflect.defineMetadata`,`design:type`,`design:paramtypes`])?{confidence:90,diagnosis:{id:`reflect-metadata-missing`,title:`reflect-metadata is not loaded — DI cannot read decorator types`,explanation:`The DI container reads constructor parameter types via the
|
|
2554
2555
|
reflect-metadata polyfill. The polyfill must be imported once,
|
|
2555
2556
|
before any decorator runs. Most projects do this at the top of
|
|
2556
2557
|
src/index.ts; missing the import causes obscure "design:paramtypes"
|
|
@@ -2559,7 +2560,7 @@ import './config'
|
|
|
2559
2560
|
import { bootstrap } from '@forinda/kickjs'
|
|
2560
2561
|
import { modules } from './modules'
|
|
2561
2562
|
|
|
2562
|
-
export const app = await bootstrap({ modules })`,docs:`https://forinda.github.io/kick-js/guide/dependency-injection.html`}}:null}},{match(e,t){return
|
|
2563
|
+
export const app = await bootstrap({ modules })`,docs:`https://forinda.github.io/kick-js/guide/dependency-injection.html`}}:null}},{match(e,t){return $(e,[`404`,`cannot get`,`cannot post`,`no route`])?{confidence:50,diagnosis:{id:`module-not-registered`,title:`A 404 may indicate a module is not in the modules array`,explanation:`KickJS only mounts modules listed in \`src/modules/index.ts\`. If you
|
|
2563
2564
|
generated a module via \`kick g module foo\` but the routes don't appear,
|
|
2564
2565
|
the most likely cause is that the module is missing from the exported
|
|
2565
2566
|
array. The CLI usually wires this automatically, but a hand-edit can
|
|
@@ -2567,24 +2568,24 @@ drop the entry.`,fix:`Open src/modules/index.ts and verify the module is in the
|
|
|
2567
2568
|
import { UserModule } from './users/user.module'
|
|
2568
2569
|
import { TaskModule } from './tasks/task.module' // ← was this missing?
|
|
2569
2570
|
|
|
2570
|
-
export const modules: AppModuleEntry[] = [UserModule(), TaskModule()]`,docs:`https://forinda.github.io/kick-js/guide/project-structure.html`}}:null}}];function
|
|
2571
|
+
export const modules: AppModuleEntry[] = [UserModule(), TaskModule()]`,docs:`https://forinda.github.io/kick-js/guide/project-structure.html`}}:null}}];function vo(e,t){let n=null;for(let r of _o){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 yo(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.
|
|
2571
2572
|
export OPENAI_API_KEY="sk-..."
|
|
2572
2573
|
|
|
2573
2574
|
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:
|
|
2574
2575
|
kick add ai
|
|
2575
2576
|
|
|
2576
2577
|
Or manually:
|
|
2577
|
-
pnpm add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=
|
|
2578
|
-
`)}function
|
|
2578
|
+
pnpm add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=bo(e.cwd),s=`Error or stack trace:\n\n${e.input.trim()}`;try{let e=xo((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 bo(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(`
|
|
2579
|
+
`)}function xo(e){let t=[e,So(e),Co(e)].filter(e=>e!==null);for(let e of t)try{let t=JSON.parse(e);if(wo(t))return t}catch{continue}return null}function So(e){let t=e.match(/```(?:json)?\s*\n([\s\S]*?)```/);return t?t[1]?.trim()??null:null}function Co(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 wo(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 To(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 Oo(e,t.message);(!n||n.trim().length===0)&&(process.stderr.write(`Error: no input provided.
|
|
2579
2580
|
|
|
2580
2581
|
Pass a message as a positional arg, --message flag, or pipe via stdin:
|
|
2581
2582
|
kick explain "config.get returned undefined"
|
|
2582
2583
|
pnpm test 2>&1 | kick explain
|
|
2583
|
-
`),process.exit(1));let r=
|
|
2584
|
-
`);return}if(i){
|
|
2585
|
-
`),process.exit(2)),
|
|
2586
|
-
`),process.exit(a.kind===`ok`?0:2)),
|
|
2587
|
-
`)}function
|
|
2584
|
+
`),process.exit(1));let r=Ao(),i=vo(n,r);if(t.json&&i){process.stdout.write(JSON.stringify({matched:!0,...i},null,2)+`
|
|
2585
|
+
`);return}if(i){jo(n,i.diagnosis,i.confidence);return}t.ai||(t.json&&(process.stdout.write(JSON.stringify({matched:!1},null,2)+`
|
|
2586
|
+
`),process.exit(2)),Mo(n,!1),process.exit(2));let a=await yo({input:n,model:t.model,cwd:r.cwd});t.json&&(process.stdout.write(JSON.stringify(Eo(a),null,2)+`
|
|
2587
|
+
`),process.exit(a.kind===`ok`?0:2)),Do(n,a),process.exit(a.kind===`ok`?0:2)})}function Eo(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 Do(e,t){if(t.kind===`ok`){jo(e,t.diagnosis,-1,!0);return}if(t.kind===`unavailable`){process.stdout.write(`\n Explaining: ${Po(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback unavailable: ${t.reason}\n\n`),process.stdout.write(`${No(t.suggestion,` `)}\n\n`);return}process.stdout.write(`\n Explaining: ${Po(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback error: ${t.message}\n\n`)}async function Oo(e,t){return e&&e.trim().length>0?e:t&&t.trim().length>0?t:process.stdin.isTTY?``:ko()}function ko(){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 Ao(){let e=process.cwd();return{cwd:e,hasFile:t=>r(v(e,t))}}function jo(e,t,n,r=!1){let i=Po(e.trim(),200),a=r?`AI-generated — verify before applying`:Fo(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${No(t.explanation,` `)}\n`),process.stdout.write(`\n Fix:\n${No(t.fix,` `)}\n`),t.codeBefore&&process.stdout.write(`\n Before:\n${No(t.codeBefore,` `)}\n`),t.codeAfter&&process.stdout.write(`\n After:\n${No(t.codeAfter,` `)}\n`),t.docs&&process.stdout.write(`\n Docs: ${t.docs}\n`),process.stdout.write(`
|
|
2588
|
+
`)}function Mo(e,t){let n=Po(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.
|
|
2588
2589
|
When @forinda/kickjs-ai ships its provider implementations,
|
|
2589
2590
|
this command will call the configured LLM with the error +
|
|
2590
2591
|
project context and return a structured fix.
|
|
@@ -2601,12 +2602,12 @@ Pass a message as a positional arg, --message flag, or pipe via stdin:
|
|
|
2601
2602
|
3. File an issue with the error text:
|
|
2602
2603
|
https://github.com/forinda/kick-js/issues/new
|
|
2603
2604
|
|
|
2604
|
-
`)}function
|
|
2605
|
+
`)}function No(e,t){return e.split(`
|
|
2605
2606
|
`).map(e=>`${t}${e}`).join(`
|
|
2606
|
-
`)}function
|
|
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
|
|
2607
|
+
`)}function Po(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function Fo(e){return e>=90?`high confidence`:e>=70?`good match`:e>=50?`medium confidence`:`low confidence — verify manually`}function Io(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(Lo),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(Ro)}function Lo(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 Ro(e){let t=process.cwd(),n=zo(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)+`
|
|
2608
|
+
`,`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 zo(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 Bo(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=Ho(t,`tsx`);i||(console.error(`
|
|
2608
2609
|
Error: tsx not found. Install it: pnpm add -D tsx
|
|
2609
|
-
`),process.exit(1));let a=
|
|
2610
|
+
`),process.exit(1));let a=Vo(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 Vo(e,t){return`
|
|
2610
2611
|
import 'reflect-metadata'
|
|
2611
2612
|
|
|
2612
2613
|
// Prevent bootstrap() from starting the HTTP server
|
|
@@ -2660,39 +2661,39 @@ server.on('exit', () => {
|
|
|
2660
2661
|
console.log('\\n Goodbye!\\n')
|
|
2661
2662
|
process.exit(0)
|
|
2662
2663
|
})
|
|
2663
|
-
`}function
|
|
2664
|
+
`}function Ho(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 Uo(e,t){let n=RegExp(`^\\s*${V(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]!==`
|
|
2664
2665
|
`;)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]===`
|
|
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
|
|
2666
|
+
`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t;continue}i=s+1}return{content:a,changed:r}}function Wo(e,t){let n=In(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=Uo(a,t).content,a=a.replace(RegExp(`\\s*,?\\s*${V(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 Go(e){let{name:t,modulesDir:n,force:r}=e,i=e.pluralize!==!1,a=z(t),o=L(t),s=i?B(a):a,c=h(n,s);if(!await Ge(c)){console.log(`\n Module not found: ${c}\n`);return}if(!r&&!await F({message:O.red(`Delete module '${s}' at ${c}? This cannot be undone.`),initialValue:!1})){console.log(`
|
|
2666
2667
|
Cancelled.
|
|
2667
|
-
`);return}await
|
|
2668
|
+
`);return}await se(c,{recursive:!0,force:!0}),console.log(` Deleted: ${c}`);let l=h(n,`index.ts`);if(await Ge(l)){let e=await w(l,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${V(o)}Module\\s*\\}\\s*from\\s*['"][^'"]*${V(s)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=Wo(e,o),e=e.replace(/\n{3,}/g,`
|
|
2668
2669
|
|
|
2669
|
-
`),e!==t&&(await
|
|
2670
|
+
`),e!==t&&(await T(l,e,`utf-8`),console.log(` Unregistered: ${o}Module from ${l}`))}console.log(`\n Module '${s}' removed.\n`)}function Ko(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=A(await j(process.cwd())),r=t.modulesDir??n.dir??`src/modules`,i=t.pluralize===!1?!1:n.pluralize??!0;for(let n of e)await Go({name:n,modulesDir:v(r),force:t.force,pluralize:i})})}function qo(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 Jo(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function Yo(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`)").option(`--no-cache`,`Disable the persistent scan cache; re-read + re-extract every file from cold`).action(async e=>{let t=Qt(process.cwd()),n=await j(t);if(e.list){let{mergeCliPlugins:e}=await Promise.resolve().then(()=>Le),{builtinCliPlugins:t}=await Promise.resolve().then(()=>cc),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(`
|
|
2670
2671
|
Registered typegen plugins:
|
|
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=
|
|
2672
|
+
`);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=qo(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=Jo(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,noCache:e.cache===!1,schemaValidator:r,envFile:i,assetMap:n?.assetMap,runPlugins:!1};try{if(e.watch){let t=await Sa(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 ya(a);let r=await Ra({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 xa(v(t,e.out??n?.typegen?.outDir??`.kickjs/types`),r,e.silent??!1)}}catch(e){e instanceof Xi?console.error(`
|
|
2672
2673
|
`+e.message+`
|
|
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
|
|
2674
|
+
`):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}function Xo(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(...Xo(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function Zo(e){try{return a(e,`utf-8`)}catch{return``}}const Qo=new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function $o(e,t){let n=Zo(h(e,`.env`));if(n){let e=n.match(/^JWT_SECRET\s*=\s*['"]?([^'"\n]*)['"]?/m);if(e){let t=e[1].trim();if(Qo.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 es(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 ts(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 ns(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function rs(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 is(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 as(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 os(e){let t=Xo(h(e,`src`)).map(e=>Zo(e)),n=[],r=$o(e,t);r&&n.push(r);let i=es(t);i&&n.push(i);let a=ts(t);a&&n.push(a);let o=ns();o&&n.push(o);let s=rs(t);return s&&n.push(s),n.push(is(t)),n.push(as(t)),n}function ss(e){e.command(`check`).description(`Audit project for common issues`).option(`--deploy`,`Run production readiness checks`).action(e=>{if(!e.deploy){console.log(`
|
|
2674
2675
|
Usage: kick check --deploy
|
|
2675
2676
|
|
|
2676
2677
|
Available checks:
|
|
2677
2678
|
--deploy Audit for production readiness (security, config, best practices)
|
|
2678
|
-
`);return}let t=process.cwd();Ot(`KickJS Deploy Check`);let n=Nt();n.start(`Scanning project...`);let r=
|
|
2679
|
-
Install a supported version via nvm / fnm / volta.`}:{name:`Node version`,status:`pass`,message:e}}function
|
|
2679
|
+
`);return}let t=process.cwd();Ot(`KickJS Deploy Check`);let n=Nt();n.start(`Scanning project...`);let r=os(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)I.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?O.red(`${a} critical`):`${a} critical`,o>0?O.yellow(`${o} ${c}`):`${o} ${c}`,`${s} info`].join(`, `);a>0?(P(O.red(`${l} — fix critical issues before deploying`)),process.exit(1)):P(O.green(`${l} — looking good!`))})}function cs(e){try{return JSON.parse(a(e,`utf-8`))}catch{return null}}function ls(e){try{return a(e,`utf-8`)}catch{return null}}function us(e){let t=ls(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=ds(e,r.extends);if(t){let e=cs(t)??{};r.compilerOptions={...e.compilerOptions,...r.compilerOptions}}}return r}function ds(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 fs(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}function ps(){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.
|
|
2680
|
+
Install a supported version via nvm / fnm / volta.`}:{name:`Node version`,status:`pass`,message:e}}function ms(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 hs(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}const gs={express:[],fastify:[`fastify`,`@fastify/middie`],h3:[`h3`]};function _s(e){if(!e.pkg||e.runtime===`express`)return null;let t={...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies},n=gs[e.runtime].filter(e=>!t[e]),r=`runtime engine (${e.runtime})`;return n.length>0?{name:r,status:`fail`,fix:`Resolved runtime '${e.runtime}' is missing engine peer(s): ${n.join(`, `)}.\nInstall: pnpm add ${n.join(` `)}`}:{name:r,status:`pass`}}function vs(e){if(!e.pkg||!bs(e.cwd))return null;let t=Ft[e.runtime],n=`upload driver (${e.runtime})`;return t.prod?{...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies}[t.prod]?{name:n,status:`pass`,message:t.prod}:{name:n,status:`fail`,fix:`This project uses file uploads on the '${e.runtime}' runtime, which needs '${t.prod}'.\nInstall it: kick add upload (or pnpm add ${t.prod})`}:{name:n,status:`pass`,message:`native multipart`}}const ys=2e3;function bs(e){let t=h(e,`src`);if(!r(t))return!1;let n=/@FileUpload\b|\bupload\.(single|array|none)\s*\(/,i=[t],a=0;for(;i.length>0&&a<ys;){let e=i.pop(),t;try{t=o(e,{withFileTypes:!0})}catch{continue}for(let r of t){if(a>=ys)break;let t=h(e,r.name);if(r.isDirectory()){r.name!==`node_modules`&&i.push(t);continue}if(/\.(ts|tsx|mts|cts)$/.test(r.name)&&(a++,n.test(ls(t)??``)))return!0}}return!1}function xs(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.
|
|
2680
2681
|
Install it: pnpm add reflect-metadata
|
|
2681
2682
|
Then import it at the top of src/index.ts:
|
|
2682
2683
|
|
|
2683
2684
|
import 'reflect-metadata'
|
|
2684
|
-
// ... rest of bootstrap`}}function
|
|
2685
|
-
`).map(e=>` ${
|
|
2686
|
-
`)}function
|
|
2685
|
+
// ... rest of bootstrap`}}function Ss(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 Cs(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(ls(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=ls(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+)?['"]${fs(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 ws(e,t=Ts){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 Ts=2e3;function Es(e){let t=h(e.cwd,`.kickjs`,`types`);if(!r(t))return null;let n=ws(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 Ds=[()=>ps(),ms,hs,_s,vs,xs,Ss,Cs,Es];async function Os(e,t={}){let n={cwd:e,pkg:cs(h(e,`package.json`)),tsconfig:us(e),runtime:t.runtime??`express`},r=[...Ds,...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 ks(e){switch(e){case`pass`:return O.green(`✔`);case`warn`:return O.yellow(`⚠`);case`fail`:return O.red(`✖`)}}function As(e){let t=ks(e.status),n=e.message?` ${O.dim(`(${e.message})`)}`:``;return`${t} ${e.name}${n}`}function js(e){return e.split(`
|
|
2686
|
+
`).map(e=>` ${O.dim(`→`)} ${e}`).join(`
|
|
2687
|
+
`)}function Ms(e){return e?.doctor?.checks??[]}function Ns(e){e.command(`doctor`).description(`Pre-flight checks for your KickJS project (dev environment health)`).action(async()=>{let e=process.cwd(),t=Ms(await j(e)),n=await It(e);Ot(`KickJS Doctor`);let r=await Os(e,{extraChecks:t,runtime:n});for(let e of r)I.message(As(e)),e.fix&&e.status!==`pass`&&I.message(js(e.fix));let i=r.filter(e=>e.status===`pass`).length,a=r.filter(e=>e.status===`warn`).length,o=r.filter(e=>e.status===`fail`).length,s=[O.green(`${i} passed`),a>0?O.yellow(`${a} warning${a===1?``:`s`}`):`${a} warnings`,o>0?O.red(`${o} error${o===1?``:`s`}`):`${o} errors`].join(`, `);o>0?(P(`${s} — fix the errors above before running the app`),process.exit(1)):P(a>0?`${s} — review the warnings`:O.green(`${s} — your environment looks good`))})}function Ps(e){return e.optsWithGlobals().dryRun??!1}function Fs(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.
|
|
2687
2688
|
Direction defaults to \`modules.style\` from kick.config (or "define").
|
|
2688
2689
|
--target define|class Override the migration direction.
|
|
2689
2690
|
--apply Apply the changes (default: dry-run preview).
|
|
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=
|
|
2691
|
-
`+
|
|
2691
|
+
--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=Ps(t)||!e.apply;M(n),e.experimental||(console.error(`
|
|
2692
|
+
`+O.red(`Error:`)+` kick codemod modules is experimental — pass --experimental to acknowledge.
|
|
2692
2693
|
The regex-based rewrite handles the shapes our templates produce.
|
|
2693
2694
|
Hand-rolled modules with non-standard structures may be skipped.
|
|
2694
2695
|
Always commit before running with --apply.
|
|
2695
|
-
`),process.exit(1));let r=
|
|
2696
|
+
`),process.exit(1));let r=A(await j(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 ${O.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let o=O.dim(`→ ${a}`),s=n?O.dim(`(dry-run)`):O.bold(`(applying)`);console.log(`\n ${O.bold(`kick codemod modules`)} ${o} ${s}`),console.log(` modulesDir: ${O.dim(i)}\n`);let c=e.backup!==!1&&!n,l=await yr(i,{dryRun:n,target:a,backup:c});if(l.backupDir){let e=l.backupDir;console.log(` ${O.green(`✓`)} backup: ${O.dim(e)}\n ${O.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else !n&&e.backup===!1&&console.log(` ${O.dim(`(--no-backup — skipping snapshot)`)}\n`);let u=0,d=0;for(let e of l.files)if(e.status===`migrated`)u++,console.log(` ${O.green(`✓`)} ${e.path}`);else{d++;let t=O.dim(`(${e.reason??`skipped`})`);console.log(` ${O.dim(`-`)} ${e.path} ${t}`)}if(console.log(),l.indexStatus===`migrated`)console.log(` ${O.green(`✓`)} ${l.indexPath}`);else if(l.indexStatus===`skipped`){let e=O.dim(`(${l.indexReason??`skipped`})`);console.log(` ${O.dim(`-`)} ${l.indexPath} ${e}`)}else console.log(` ${O.dim(`-`)} ${l.indexPath} ${O.dim(`(not found)`)}`);let f=n?O.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n ${O.bold(String(u))} migrated, ${O.bold(String(d))} skipped${f}\n`)})}const Is=()=>({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 j(e.cwd);if(!t?.assetMap)return null;let n=da(t.assetMap,e.cwd);return n.count===0?null:fa(n)}}),Ls="/* 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 Rs(e,t,n,r={}){if(e.length===0)return`${Ls}
|
|
2696
2697
|
// (no routes discovered yet — annotate a controller method with
|
|
2697
2698
|
// @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
|
|
2698
2699
|
declare global {
|
|
@@ -2701,8 +2702,8 @@ declare global {
|
|
|
2701
2702
|
}
|
|
2702
2703
|
|
|
2703
2704
|
export {}
|
|
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=
|
|
2705
|
-
`))}return`${
|
|
2705
|
+
`;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=Vs(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??zs(e),l=Bs(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(`
|
|
2706
|
+
`))}return`${Ls}${Hs(a)}
|
|
2706
2707
|
declare global {
|
|
2707
2708
|
// eslint-disable-next-line @typescript-eslint/no-namespace
|
|
2708
2709
|
namespace KickRoutes {
|
|
@@ -2712,9 +2713,9 @@ ${s.join(`
|
|
|
2712
2713
|
}
|
|
2713
2714
|
|
|
2714
2715
|
export {}
|
|
2715
|
-
`}function
|
|
2716
|
+
`}function zs(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 Bs(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 Vs(e,t,n,r,i){if(!e||r===!1||e.source===null)return null;let a=Us(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 Hs(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(`
|
|
2716
2717
|
`)+`
|
|
2717
|
-
`}function
|
|
2718
|
+
`}function Us(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 Ws=()=>({id:`kick/routes`,outExtension:`.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){let t=await e.getScanResult({root:Gs(e),cwd:e.cwd,envFile:Ks(e)}),n=e.config?.typegen?.schemaValidator??`zod`,r=u.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return Rs(t.routes,r,n,{onWarn:t=>e.log.warn(t)})}});function Gs(e){return u.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Ks(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function qs(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 */
|
|
2718
2719
|
// AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
|
|
2719
2720
|
// Re-run with \`kick typegen\` or rely on \`kick dev\` to refresh.
|
|
2720
2721
|
|
|
@@ -2752,4 +2753,5 @@ declare global {
|
|
|
2752
2753
|
}
|
|
2753
2754
|
|
|
2754
2755
|
export {}
|
|
2755
|
-
`}const
|
|
2756
|
+
`}const Js=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=Xs(e);if(t===!1)return null;let n=await e.getScanResult({root:Ys(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 qs(n.env,i,r)}});function Ys(e){return u.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Xs(e){return e.config?.typegen?.envFile}function Zs(e){return u.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Qs(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function $s(e){return{root:Zs(e),cwd:e.cwd,envFile:Qs(e)}}const ec=()=>({id:`kick/registry`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($s(e)),n=u.resolve(e.cwd,`.kickjs/types/kick__registry.d.ts`),r=new Set(t.collisions.map(e=>e.className));return ea(t.classes,n,r)}}),tc=()=>({id:`kick/services`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($s(e)),n=new Set(t.collisions.map(e=>e.className));return ra(`ServiceToken`,ia(t.classes,t.tokens,t.injects,n),"(no tokens discovered — declare with createToken<T>() or `kick g service <name>`)")}}),nc=()=>({id:`kick/modules`,inputs:[`src/**/*.ts`],async generate(e){return ra(`ModuleToken`,aa((await e.getScanResult($s(e))).classes),"(no @Module classes discovered — `kick g module <name>` to add one)")}}),rc=()=>({id:`kick/plugins`,inputs:[`src/**/*.ts`],async generate(e){return oa((await e.getScanResult($s(e))).pluginsAndAdapters)}}),ic=()=>({id:`kick/augmentations`,inputs:[`src/**/*.ts`],async generate(e){return sa((await e.getScanResult($s(e))).augmentations)}}),ac=()=>({id:`kick/context`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($s(e));return t.contextKeys.length===0?null:na(t.contextKeys)}}),oc={fastify:{subpath:`@forinda/kickjs/fastify`,typeName:`FastifyRuntimeTypes`},h3:{subpath:`@forinda/kickjs/h3`,typeName:`H3RuntimeTypes`}},sc=()=>({id:`kick/runtime`,outExtension:`.ts`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`,`kick.config.json`],async generate(e){let t=e.config?.runtime;if(t!==`fastify`&&t!==`h3`)return null;let{subpath:n,typeName:r}=oc[t];return[`// Runtime escape-hatch types for the '${t}' engine (kick.config runtime).`,`declare module '@forinda/kickjs' {`,` interface KickRuntimeRegister {`,` runtime: import('${n}').${r}`,` }`,`}`,``,`export {}`,``].join(`
|
|
2757
|
+
`)}});var cc=k({builtinCliPlugins:()=>lc});const lc=[E({name:`kick/init`,register:Jt}),E({name:`kick/generate`,register:ja}),E({name:`kick/run`,register:$a}),E({name:`kick/info`,register:io}),E({name:`kick/inspect`,register:ho}),E({name:`kick/add`,register:Kt}),E({name:`kick/list`,register:Gt}),E({name:`kick/explain`,register:To}),E({name:`kick/mcp`,register:Io}),E({name:`kick/tinker`,register:Bo}),E({name:`kick/remove`,register:Ko}),E({name:`kick/typegen`,register:Yo}),E({name:`kick/check`,register:ss}),E({name:`kick/doctor`,register:Ns}),E({name:`kick/codemod`,register:Fs}),E({name:`kick/registry`,typegens:[ec()]}),E({name:`kick/services`,typegens:[tc()]}),E({name:`kick/modules`,typegens:[nc()]}),E({name:`kick/plugins`,typegens:[rc()]}),E({name:`kick/augmentations`,typegens:[ic()]}),E({name:`kick/context`,typegens:[ac()]}),E({name:`kick/assets`,typegens:[Is()]}),E({name:`kick/routes`,typegens:[Ws()]}),E({name:`kick/env`,typegens:[Js()]}),E({name:`kick/runtime`,typegens:[sc()]})],uc=f(b(import.meta.url)),dc=JSON.parse(a(h(uc,`..`,`package.json`),`utf-8`));async function fc(){let e=new t;e.name(`kick`).description(`KickJS — A production-grade, decorator-driven Node.js framework`).version(dc.version);let n=Qt(process.cwd()),r=n,i=await j(r)??{},a=Ie([...lc,...i.plugins??[]],i.commands??[]);await a.register(e,{cwd:r,projectRoot:n,config:i,log:e=>console.log(e)}),Se(e,{...i,commands:a.commands}),e.showHelpAfterError();let o=process.argv.map(e=>e===`-v`?`--version`:e);await e.parseAsync(o)}fc().catch(e=>{console.error(e instanceof Error?e.message:e),process.exitCode=1});export{};
|