@forinda/kickjs-cli 5.8.0 → 5.8.2
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 +1 -1
- package/dist/agent-docs-BFAfGQir.mjs +12 -0
- package/dist/agent-docs-BFAfGQir.mjs.map +1 -0
- package/dist/{builtins-CYSzLo7U.mjs → builtins-cz42mDMv.mjs} +2 -2
- package/dist/cli.mjs +63 -312
- package/dist/{config-ierHW69f.mjs → config-BlM3L0kV.mjs} +3 -3
- package/dist/{config-ierHW69f.mjs.map → config-BlM3L0kV.mjs.map} +1 -1
- package/dist/generator-extension-D8q_Dcqh.mjs +1977 -0
- package/dist/generator-extension-D8q_Dcqh.mjs.map +1 -0
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +2 -2
- package/dist/{plugin-D_nBy6VP.mjs → plugin-CbMjTNda.mjs} +3 -3
- package/dist/{plugin-D_nBy6VP.mjs.map → plugin-CbMjTNda.mjs.map} +1 -1
- package/dist/project-docs-DkHcUaf1.mjs +858 -0
- package/dist/project-docs-DkHcUaf1.mjs.map +1 -0
- package/dist/{project-root-CqGZOrRR.mjs → project-root-_5MF5flH.mjs} +3 -3
- package/dist/{project-root-CqGZOrRR.mjs.map → project-root-_5MF5flH.mjs.map} +1 -1
- package/dist/{rolldown-runtime-B8-Ifyj3.mjs → rolldown-runtime-BQW-90zC.mjs} +1 -1
- package/dist/{run-plugins-Cvgyo_th.mjs → run-plugins-D_jHPl16.mjs} +99 -99
- package/dist/run-plugins-D_jHPl16.mjs.map +1 -0
- package/dist/{typegen-C3G375CR.mjs → typegen-CGrhe0Ta.mjs} +4 -4
- package/dist/{typegen-C3G375CR.mjs.map → typegen-CGrhe0Ta.mjs.map} +1 -1
- package/dist/{types-Kj2ldTnQ.mjs → types-g7lTGmOR.mjs} +2 -2
- package/dist/{types-Kj2ldTnQ.mjs.map → types-g7lTGmOR.mjs.map} +1 -1
- package/package.json +5 -5
- package/dist/generator-extension-BXLt3Tp_.mjs +0 -3072
- package/dist/generator-extension-BXLt3Tp_.mjs.map +0 -1
- package/dist/run-plugins-Cvgyo_th.mjs.map +0 -1
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs-cli v5.8.
|
|
2
|
+
* @forinda/kickjs-cli v5.8.2
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,14 +8,14 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{
|
|
11
|
+
import{_ as e,b as t,c as n,d as r,f as i,g as a,h as o,l as s,m as c,p as l,s as u,u as d,v as f,y as p}from"./project-docs-DkHcUaf1.mjs";import{_ as m,a as h,b as g,c as _,d as v,f as y,g as b,h as ee,l as te,m as ne,n as re,o as ie,p as ae,s as oe,t as se,u as ce,v as le,x,y as ue}from"./generator-extension-D8q_Dcqh.mjs";import{a as S,i as C,o as de,t as fe}from"./config-BlM3L0kV.mjs";import{t as pe}from"./project-root-_5MF5flH.mjs";import{n as w}from"./types-g7lTGmOR.mjs";import{n as me}from"./agent-docs-BFAfGQir.mjs";import{n as he}from"./plugin-CbMjTNda.mjs";import{a as ge,c as _e,i as ve,n as ye,o as be,s as xe,t as T}from"./typegen-CGrhe0Ta.mjs";import E,{basename as Se,dirname as D,isAbsolute as Ce,join as O,relative as k,resolve as A,sep as j}from"node:path";import{cpSync as we,existsSync as M,mkdirSync as N,readFileSync as P,readdirSync as Te,rmSync as Ee,statSync as De,writeFileSync as Oe}from"node:fs";import{copyFile as ke,mkdir as Ae,readFile as F,readdir as je,rm as Me,stat as Ne,writeFile as I}from"node:fs/promises";import{execSync as Pe,fork as Fe,spawn as Ie,spawnSync as Le}from"node:child_process";import{pathToFileURL as L}from"node:url";import{glob as Re}from"glob";import{groupAssetKeys as ze}from"@forinda/kickjs";import{arch as Be,platform as Ve,release as He}from"node:os";import{detectCompositeReferences as Ue,generate as We,migrateDown as Ge,migrateLatest as Ke,migrateRollback as qe,migrateStatus as Je,migrateUp as Ye,renderSchemaSource as Xe,resolveDbConfig as Ze}from"@forinda/kickjs-db";const Qe={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},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`},"db-pg":{pkg:`@forinda/kickjs-db-pg`,peers:[`pg`],description:`kick/db PostgreSQL dialect + adapter (pgDialect, pgAdapter)`},drizzle:{pkg:`@forinda/kickjs-drizzle`,peers:[`drizzle-orm`],description:`Drizzle ORM adapter + query builder`},prisma:{pkg:`@forinda/kickjs-prisma`,peers:[`@prisma/client`],description:`Prisma adapter + query builder`},ws:{pkg:`@forinda/kickjs-ws`,peers:[`socket.io`],description:`WebSocket with @WsController decorators`},devtools:{pkg:`@forinda/kickjs-devtools`,peers:[],description:`Development dashboard — routes, DI, metrics, health`,dev:!0},queue:{pkg:`@forinda/kickjs-queue`,peers:[],description:`Queue adapter (BullMQ/RabbitMQ/Kafka)`},"queue:bullmq":{pkg:`@forinda/kickjs-queue`,peers:[`bullmq`,`ioredis`],description:`Queue with BullMQ + Redis`},"queue:rabbitmq":{pkg:`@forinda/kickjs-queue`,peers:[`amqplib`],description:`Queue with RabbitMQ`},"queue:kafka":{pkg:`@forinda/kickjs-queue`,peers:[`kafkajs`],description:`Queue with Kafka`},"queue:redis-pubsub":{pkg:`@forinda/kickjs-queue`,peers:[`ioredis`],description:`Lightweight pub/sub via Redis (no persistence)`},mcp:{pkg:`@forinda/kickjs-mcp`,peers:[`@modelcontextprotocol/sdk`],description:`Model Context Protocol server — expose @Controller endpoints as AI tools`},testing:{pkg:`@forinda/kickjs-testing`,peers:[],description:`Test utilities and TestModule builder`,dev:!0}};function R(e,t=process.cwd()){let n=t;for(;;){if(M(A(n,e)))return n;let t=D(n);if(t===n)return null;n=t}}function $e(){return R(`pnpm-lock.yaml`)?`pnpm`:R(`yarn.lock`)?`yarn`:R(`bun.lockb`)||R(`bun.lock`)?`bun`:R(`package-lock.json`)?`npm`:null}function et(){let e=process.cwd();for(;e;){let t=A(e,`package.json`);if(M(t))try{let e=JSON.parse(P(t,`utf-8`)).packageManager;if(typeof e==`string`){let t=e.split(`@`)[0];if(fe.includes(t))return t}}catch{}let n=D(e);if(n===e)return null;e=n}return null}async function tt(e){if(e&&fe.includes(e))return{pm:e,source:`flag`};let t=await C(process.cwd());if(t?.packageManager&&fe.includes(t.packageManager))return{pm:t.packageManager,source:`config`};let n=et();if(n)return{pm:n,source:`package.json`};let r=$e();return r?{pm:r,source:`lockfile`}:{pm:`npm`,source:`default`}}async function nt(e){let{pm:t}=await tt(e);return t}function rt(e=!1){let t=Object.entries(Qe),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(`, `)})`:``;return` ${r} ${t.description}${i}`};console.log(`
|
|
12
12
|
Core packages (always installed by \`kick new\`):
|
|
13
13
|
`);for(let e of r)console.log(a(e));if(e){console.log(`
|
|
14
14
|
Optional packages (add as needed):
|
|
15
15
|
`);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(`
|
|
16
|
-
Usage: kick add auth drizzle swagger`),console.log(` kick add queue:bullmq`),console.log()}function
|
|
17
|
-
`),a.size===0&&o.size===0))){if(a.size>0){let e=Array.from(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{
|
|
18
|
-
`)}})}const
|
|
16
|
+
Usage: kick add auth drizzle swagger`),console.log(` kick add queue:bullmq`),console.log()}function it(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=>{rt(!!e.all)})}function at(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){rt(!!t.all);return}let{pm:n,source:r}=await tt(t.pm);console.log(`\n Using ${n} (resolved from ${r})`);let i=t.dev,a=new Set,o=new Set,s=[];for(let t of e){let e=Qe[t];if(!e){s.push(t);continue}let n=i||e.dev?o:a;n.add(e.pkg);for(let t of e.peers)n.add(t)}if(!(s.length>0&&(console.log(`\n Unknown packages: ${s.join(`, `)}`),console.log(` Run "kick add --list" to see available packages.
|
|
17
|
+
`),a.size===0&&o.size===0))){if(a.size>0){let e=Array.from(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{Pe(t,{stdio:`inherit`})}catch{console.log(`\n Installation failed. Run manually:\n ${t}\n`)}}if(o.size>0){let e=Array.from(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{Pe(t,{stdio:`inherit`})}catch{console.log(`\n Installation failed. Run manually:\n ${t}\n`)}}console.log(` Done!
|
|
18
|
+
`)}})}const ot=[{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 st(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 | ddd | cqrs | minimal`).option(`-r, --repo <type>`,`Default repository: prisma | drizzle | inmemory | custom`).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)=>{n(`KickJS — Create a new project`);let o=!!(t.yes||t.nonInteractive);e||=o?`my-api`:await c({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let l;if(e===`.`?(l=A(`.`),e=Se(l)):l=A(t.directory||e),M(l)){let n=Te(l);if(n.length>0){if(t.force)s.warn(`Clearing existing files in ${l}`);else if(o){s.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),r(`Aborted.`);return}else{s.warn(`Directory "${e}" is not empty:`);let t=n.slice(0,5);for(let e of t)s.message(` - ${e}`);if(n.length>5&&s.message(` ... and ${n.length-5} more`),!await u({message:a.red(`Remove all existing files and proceed?`),initialValue:!1})){r(`Aborted.`);return}}for(let e of n)Ee(A(l,e),{recursive:!0,force:!0})}}let f=t.template;f||=o?`minimal`:await i({message:`Project template`,options:[{value:`rest`,label:`REST API`,hint:`Express + Swagger`},{value:`ddd`,label:`DDD`,hint:`Domain-Driven Design modules`},{value:`cqrs`,label:`CQRS`,hint:`Commands, Queries, Events + WS/Queue`},{value:`minimal`,label:`Minimal`,hint:`bare Express`}]});let p=t.pm;p||=o?await nt(void 0):await i({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let m=t.repo;m||(o?m=`inmemory`:(m=await i({message:`Default repository/ORM`,options:[{value:`prisma`,label:`Prisma`},{value:`drizzle`,label:`Drizzle`},{value:`inmemory`,label:`In-Memory`},{value:`custom`,label:`Custom`,hint:`specify later`}]}),m===`custom`&&(m=await c({message:`Custom repository name`,defaultValue:`custom`}))));let g;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();g=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else g=o?[]:await d({message:`Select packages to include`,options:[...ot],required:!1});let _;_=t.git===void 0?o?!0:await u({message:`Initialize git repository?`,initialValue:!0}):t.git;let v;v=t.install===void 0?o?!0:await u({message:`Install dependencies?`,initialValue:!0}):t.install,await h({name:e,directory:l,packageManager:p,initGit:_,installDeps:v,template:f,defaultRepo:m,packages:g}),r(`Done! Next steps: ${a.cyan(`cd ${e} && ${p} dev`)}`)})}async function ct(e){let{name:n,outDir:r}=e,i=g(n),a=x(n),o=[],s=O(r,`${i}.plugin.ts`);return await t(s,`import {
|
|
19
19
|
definePlugin,
|
|
20
20
|
type AppAdapter,
|
|
21
21
|
type AppModuleEntry,
|
|
@@ -24,21 +24,21 @@ import{A as e,B as t,C as n,D as r,E as i,F as a,I as o,L as s,M as c,N as l,O a
|
|
|
24
24
|
} from '@forinda/kickjs'
|
|
25
25
|
|
|
26
26
|
/**
|
|
27
|
-
* Configuration for the ${
|
|
27
|
+
* Configuration for the ${a} plugin.
|
|
28
28
|
*
|
|
29
29
|
* Plugins typically take a small config object so callers can tune
|
|
30
30
|
* behaviour at bootstrap time. Keep the shape narrow — anything
|
|
31
31
|
* derived from the environment should be read inside the build
|
|
32
32
|
* function via getEnv(), not forced onto the caller.
|
|
33
33
|
*/
|
|
34
|
-
export interface ${
|
|
34
|
+
export interface ${a}PluginConfig {
|
|
35
35
|
// Add your plugin config here, e.g.:
|
|
36
36
|
// enabled?: boolean
|
|
37
37
|
// apiKey?: string
|
|
38
38
|
}
|
|
39
39
|
|
|
40
40
|
/**
|
|
41
|
-
* ${
|
|
41
|
+
* ${a} plugin — built via \`definePlugin()\` so callers get the
|
|
42
42
|
* factory's call / \`.scoped()\` / \`.async()\` surfaces for free.
|
|
43
43
|
*
|
|
44
44
|
* A plugin bundles DI bindings, modules, adapters, and middleware
|
|
@@ -59,16 +59,16 @@ export interface ${o}PluginConfig {
|
|
|
59
59
|
* @example
|
|
60
60
|
* \`\`\`ts
|
|
61
61
|
* import { bootstrap } from '@forinda/kickjs'
|
|
62
|
-
* import { ${
|
|
62
|
+
* import { ${a}Plugin } from './plugins/${i}.plugin'
|
|
63
63
|
*
|
|
64
64
|
* export const app = await bootstrap({
|
|
65
65
|
* modules,
|
|
66
|
-
* plugins: [${
|
|
66
|
+
* plugins: [${a}Plugin({ /* config overrides *\\/ })],
|
|
67
67
|
* })
|
|
68
68
|
* \`\`\`
|
|
69
69
|
*/
|
|
70
|
-
export const ${
|
|
71
|
-
name: '${
|
|
70
|
+
export const ${a}Plugin = definePlugin<${a}PluginConfig>({
|
|
71
|
+
name: '${a}Plugin',
|
|
72
72
|
defaults: {
|
|
73
73
|
// Default config values go here
|
|
74
74
|
},
|
|
@@ -131,12 +131,12 @@ export const ${o}Plugin = definePlugin<${o}PluginConfig>({
|
|
|
131
131
|
return [
|
|
132
132
|
// Example:
|
|
133
133
|
// import { defineHttpContextDecorator } from '@forinda/kickjs'
|
|
134
|
-
// declare module '@forinda/kickjs' { interface ContextMeta { ${
|
|
135
|
-
// const Load${
|
|
136
|
-
// key: '${
|
|
137
|
-
// resolve: (ctx) => ({ foo: ctx.req.headers['x-${
|
|
134
|
+
// declare module '@forinda/kickjs' { interface ContextMeta { ${i}: { foo: string } } }
|
|
135
|
+
// const Load${a} = defineHttpContextDecorator({
|
|
136
|
+
// key: '${i}',
|
|
137
|
+
// resolve: (ctx) => ({ foo: ctx.req.headers['x-${i}'] as string }),
|
|
138
138
|
// })
|
|
139
|
-
// return [Load${
|
|
139
|
+
// return [Load${a}.registration]
|
|
140
140
|
]
|
|
141
141
|
},
|
|
142
142
|
|
|
@@ -147,7 +147,7 @@ export const ${o}Plugin = definePlugin<${o}PluginConfig>({
|
|
|
147
147
|
*/
|
|
148
148
|
async onReady(_container: Container): Promise<void> {
|
|
149
149
|
// const log = _container.resolve(Logger)
|
|
150
|
-
// log.info('${
|
|
150
|
+
// log.info('${a} plugin ready')
|
|
151
151
|
},
|
|
152
152
|
|
|
153
153
|
/**
|
|
@@ -159,13 +159,13 @@ export const ${o}Plugin = definePlugin<${o}PluginConfig>({
|
|
|
159
159
|
},
|
|
160
160
|
}),
|
|
161
161
|
})
|
|
162
|
-
`),
|
|
162
|
+
`),o.push(s),o}async function lt(e){let n=O(e.outDir,`kick.config.ts`),r=e.modulesDir??`src/modules`,i=e.defaultRepo??`inmemory`;return M(n)&&!e.force&&!await u({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
|
|
163
163
|
Skipped — existing kick.config.ts preserved.`),[]):(await t(n,`import { defineConfig } from '@forinda/kickjs-cli'
|
|
164
164
|
|
|
165
165
|
export default defineConfig({
|
|
166
166
|
modules: {
|
|
167
|
-
dir: '${
|
|
168
|
-
repo: '${
|
|
167
|
+
dir: '${r}',
|
|
168
|
+
repo: '${i}',
|
|
169
169
|
pluralize: true,
|
|
170
170
|
},
|
|
171
171
|
|
|
@@ -197,22 +197,22 @@ export default defineConfig({
|
|
|
197
197
|
},
|
|
198
198
|
],
|
|
199
199
|
})
|
|
200
|
-
`),[n])}
|
|
200
|
+
`),[n])}function z(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 B(e,t){let n=t.exec(e);if(!n)return null;let r=n.index+n[0].length-1,i=z(e,r);return i===-1?null:e.slice(r+1,i)}function V(e,t,n){let r=` `.repeat(n);return e.split(`
|
|
201
201
|
`).map(e=>{if(e.trim()===``)return e;let n=RegExp(`^ {0,${t}}`);return r+e.replace(n,``)}).join(`
|
|
202
|
-
`)}function
|
|
202
|
+
`)}function ut(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 dt(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 ft(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=z(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=B(o,/register\s*\(([^)]*)\)\s*:\s*void\s*\{/),u=B(o,/contributors\s*\(\s*\)\s*:\s*ContributorRegistrations\s*\{/),d=B(o,/routes\s*\(\s*\)\s*:\s*[A-Za-z|[\]\s]+\{/);if(!d)return{migrated:null,reason:`routes() method missing or signature unrecognized`};let f=ut(s),p=``;return l&&(p+=` register(container) {${V(l,4,6)} },\n\n`),u&&(p+=` contributors() {${V(u,4,6)} },\n\n`),p+=` routes() {${V(d,4,6)} },`,{migrated:`${f}${`export const ${r} = defineModule({
|
|
203
203
|
name: '${r}',
|
|
204
204
|
build: () => ({
|
|
205
205
|
${p}
|
|
206
206
|
}),
|
|
207
|
-
})`}${c}`}}function
|
|
208
|
-
`||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=
|
|
207
|
+
})`}${c}`}}function pt(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=z(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]===`
|
|
208
|
+
`||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=z(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=B(m,/register\s*\(([^)]*)\)\s*\{/),g=B(m,/contributors\s*\(\s*\)\s*\{/),_=B(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let v=dt(c,{container:h!==null,appModule:!0,moduleRoutes:!0,contributorRegistrations:g!==null}),y=``;return h!==null&&(y+=` register(container: Container): void {${V(h,6,4)} }\n\n`),g!==null&&(y+=` contributors(): ContributorRegistrations {${V(g,6,4)} }\n\n`),y+=` routes(): ModuleRoutes {${V(_,6,4)} }`,{migrated:`${v}${`export class ${r} implements AppModule {
|
|
209
209
|
${y}
|
|
210
210
|
}
|
|
211
|
-
`}${u}`}}function
|
|
211
|
+
`}${u}`}}function mt(e,t){return t===`class`?pt(e):ft(e)}function ht(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 gt(e){let t=[];return await n(A(e),0),t;async function n(e,r){let i;try{i=await je(e)}catch{return}for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=O(e,a),o;try{o=await Ne(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function _t(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await je(e)}catch{return}await Ae(t,{recursive:!0});for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=O(e,a),o=O(t,a),s;try{s=await Ne(i)}catch{continue}s.isDirectory()?await r(i,o):(await ke(i,o),n++)}}}function vt(e){return O(e,`.kickjs`,`codemod-backups`,`${new Date().toISOString().replaceAll(/[:.]/g,`-`)}-modules`)}async function yt(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await gt(e),s=await F(O(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=vt(r),await _t(e,c));let l=[];for(let e of o){let t=mt(await F(e,`utf-8`),i);if(t.migrated==null){l.push({path:e,status:`skipped`,reason:t.reason});continue}n||await I(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`})}let u=O(e,`index.ts`),d=null;try{d=await F(u,`utf-8`)}catch{return{target:i,files:l,indexStatus:`not-found`,indexPath:u,backupDir:c}}let f=ht(d,i);return f.migrated==null?{target:i,files:l,indexStatus:`skipped`,indexPath:u,indexReason:f.reason,backupDir:c}:(n||await I(u,f.migrated,`utf-8`),{target:i,files:l,indexStatus:`migrated`,indexPath:u,backupDir:c})}async function bt(e,t){let n=await gt(e),r=[],i=t===`define`?/export\s+class\s+\w+Module\s+implements\s+AppModule\s*\{/:/export\s+const\s+\w+Module\s*=\s*defineModule\s*\(/;for(let e of n){let t=await F(e,`utf-8`);i.test(t)&&r.push(e)}return r}async function xt(e){let{name:n,outDir:r}=e,i=x(n),a=g(n),o=ue(n),s=e.queue??`${a}-queue`,c=[];return await(async(e,n)=>{let i=O(r,e);await t(i,n),c.push(i)})(`${a}.job.ts`,`import { Inject } from '@forinda/kickjs'
|
|
212
212
|
import { Job, Process, QUEUE_MANAGER, type QueueService } from '@forinda/kickjs-queue'
|
|
213
213
|
|
|
214
214
|
/**
|
|
215
|
-
* ${
|
|
215
|
+
* ${i} Job Processor
|
|
216
216
|
*
|
|
217
217
|
* Decorators:
|
|
218
218
|
* @Job(queueName) — marks this class as a job processor for a queue
|
|
@@ -222,10 +222,10 @@ import { Job, Process, QUEUE_MANAGER, type QueueService } from '@forinda/kickjs-
|
|
|
222
222
|
*
|
|
223
223
|
* To add jobs to this queue from a service or controller:
|
|
224
224
|
* @Inject(QUEUE_MANAGER) private queue: QueueService
|
|
225
|
-
* await this.queue.add('${
|
|
225
|
+
* await this.queue.add('${s}', '${o}', { ... })
|
|
226
226
|
*/
|
|
227
|
-
@Job('${
|
|
228
|
-
export class ${
|
|
227
|
+
@Job('${s}')
|
|
228
|
+
export class ${i}Job {
|
|
229
229
|
@Process()
|
|
230
230
|
async handle(job: { name: string; data: any; id?: string }) {
|
|
231
231
|
console.log(\`Processing \${job.name} (id: \${job.id})\`, job.data)
|
|
@@ -235,13 +235,13 @@ export class ${a}Job {
|
|
|
235
235
|
// await this.emailService.send(job.data.to, job.data.subject, job.data.body)
|
|
236
236
|
}
|
|
237
237
|
|
|
238
|
-
@Process('${
|
|
238
|
+
@Process('${o}.priority')
|
|
239
239
|
async handlePriority(job: { name: string; data: any; id?: string }) {
|
|
240
240
|
console.log(\`Priority job: \${job.name}\`, job.data)
|
|
241
241
|
// Handle high-priority variant of this job
|
|
242
242
|
}
|
|
243
243
|
}
|
|
244
|
-
`),
|
|
244
|
+
`),c}const St={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 Ct(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=St[a];if(!o){let e=[...Object.keys(St),`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 wt(e){let{name:n,fields:r,modulesDir:i,noEntity:a,noTests:o,repo:s=`inmemory`,tokenScope:c=`app`,style:l=`define`}=e,u=e.pluralize!==!1,d=g(n),f=x(n);ue(n);let p=u?m(d):d,h=u?le(f):f,_=O(i,p),v=[],b=async(e,n)=>{let r=O(_,e);await t(r,n),v.push(r)};await b(`${d}.module.ts`,Mt(f,d,p,l)),await b(`constants.ts`,Ot(f,r)),await b(`presentation/${d}.controller.ts`,Nt(f,d,p,h)),await b(`application/dtos/create-${d}.dto.ts`,Tt(f,r)),await b(`application/dtos/update-${d}.dto.ts`,Et(f,r)),await b(`application/dtos/${d}-response.dto.ts`,Dt(f,r));let ee=It(f,d,p,h);for(let e of ee)await b(`application/use-cases/${e.file}`,e.content);return await b(`domain/repositories/${d}.repository.ts`,Pt(f,d,c)),await b(`domain/services/${d}-domain.service.ts`,Ft(f,d)),s===`inmemory`&&await b(`infrastructure/repositories/in-memory-${d}.repository.ts`,kt(f,d,r)),a||(await b(`domain/entities/${d}.entity.ts`,At(f,d,r)),await b(`domain/value-objects/${d}-id.vo.ts`,jt(f))),await y(i,f,p,d,l),v}function Tt(e,t){return`import { z } from 'zod'
|
|
245
245
|
|
|
246
246
|
export const create${e}Schema = z.object({
|
|
247
247
|
${t.map(e=>{let t=e.zodType;return` ${e.name}: ${t}${e.optional?`.optional()`:``},`}).join(`
|
|
@@ -249,7 +249,7 @@ ${t.map(e=>{let t=e.zodType;return` ${e.name}: ${t}${e.optional?`.optional()`:`
|
|
|
249
249
|
})
|
|
250
250
|
|
|
251
251
|
export type Create${e}DTO = z.infer<typeof create${e}Schema>
|
|
252
|
-
`}function
|
|
252
|
+
`}function Et(e,t){return`import { z } from 'zod'
|
|
253
253
|
|
|
254
254
|
export const update${e}Schema = z.object({
|
|
255
255
|
${t.map(e=>` ${e.name}: ${e.zodType}.optional(),`).join(`
|
|
@@ -257,21 +257,21 @@ ${t.map(e=>` ${e.name}: ${e.zodType}.optional(),`).join(`
|
|
|
257
257
|
})
|
|
258
258
|
|
|
259
259
|
export type Update${e}DTO = z.infer<typeof update${e}Schema>
|
|
260
|
-
`}function
|
|
260
|
+
`}function Dt(e,t){return`export interface ${e}ResponseDTO {
|
|
261
261
|
id: string
|
|
262
262
|
${t.map(e=>` ${e.name}${e.optional?`?`:``}: ${e.tsType}`).join(`
|
|
263
263
|
`)}
|
|
264
264
|
createdAt: string
|
|
265
265
|
updatedAt: string
|
|
266
266
|
}
|
|
267
|
-
`}function
|
|
267
|
+
`}function Ot(e,t){let n=t.filter(e=>e.tsType===`string`).map(e=>`'${e.name}'`);t.filter(e=>e.tsType===`number`).map(e=>`'${e.name}'`);let r=t.map(e=>`'${e.name}'`),i=[...r].join(`, `),a=[...r,`'createdAt'`,`'updatedAt'`].join(`, `),o=n.length>0?n.join(`, `):`'name'`;return`import type { ApiQueryParamsConfig } from '@forinda/kickjs'
|
|
268
268
|
|
|
269
269
|
export const ${e.toUpperCase()}_QUERY_CONFIG: ApiQueryParamsConfig = {
|
|
270
270
|
filterable: [${i}],
|
|
271
271
|
sortable: [${a}],
|
|
272
272
|
searchable: [${o}],
|
|
273
273
|
}
|
|
274
|
-
`}function
|
|
274
|
+
`}function kt(e,t,n){return`import { randomUUID } from 'node:crypto'
|
|
275
275
|
import { Repository, HttpException } from '@forinda/kickjs'
|
|
276
276
|
import type { ParsedQuery } from '@forinda/kickjs'
|
|
277
277
|
import type { I${e}Repository } from '../../domain/repositories/${t}.repository'
|
|
@@ -323,7 +323,7 @@ ${n.map(e=>` ${e.name}: dto.${e.name},`).join(`
|
|
|
323
323
|
this.store.delete(id)
|
|
324
324
|
}
|
|
325
325
|
}
|
|
326
|
-
`}function
|
|
326
|
+
`}function At(e,t,n){return`import { ${e}Id } from '../value-objects/${t}-id.vo'
|
|
327
327
|
|
|
328
328
|
interface ${e}Props {
|
|
329
329
|
id: ${e}Id
|
|
@@ -369,7 +369,7 @@ ${n.map(e=>` ${e.name}: this.props.${e.name},`).join(`
|
|
|
369
369
|
}
|
|
370
370
|
}
|
|
371
371
|
}
|
|
372
|
-
`}function
|
|
372
|
+
`}function jt(e){return`import { randomUUID } from 'node:crypto'
|
|
373
373
|
|
|
374
374
|
export class ${e}Id {
|
|
375
375
|
private constructor(private readonly value: string) {}
|
|
@@ -384,7 +384,7 @@ export class ${e}Id {
|
|
|
384
384
|
toString(): string { return this.value }
|
|
385
385
|
equals(other: ${e}Id): boolean { return this.value === other.value }
|
|
386
386
|
}
|
|
387
|
-
`}function
|
|
387
|
+
`}function Mt(e,t,n,r=`define`){let i=`import { ${e}Controller } from './presentation/${t}.controller'
|
|
388
388
|
import { ${e.toUpperCase()}_REPOSITORY } from './domain/repositories/${t}.repository'
|
|
389
389
|
import { InMemory${e}Repository } from './infrastructure/repositories/in-memory-${t}.repository'
|
|
390
390
|
|
|
@@ -457,7 +457,7 @@ ${a}
|
|
|
457
457
|
},
|
|
458
458
|
}),
|
|
459
459
|
})
|
|
460
|
-
`}function
|
|
460
|
+
`}function Nt(e,t,n,r){return`import { Controller, Get, Post, Put, Delete, Autowired, ApiQueryParams, type Ctx } from '@forinda/kickjs'
|
|
461
461
|
import { ApiTags } from '@forinda/kickjs-swagger'
|
|
462
462
|
import { Create${e}UseCase } from '../application/use-cases/create-${t}.use-case'
|
|
463
463
|
import { Get${e}UseCase } from '../application/use-cases/get-${t}.use-case'
|
|
@@ -520,7 +520,7 @@ export class ${e}Controller {
|
|
|
520
520
|
ctx.noContent()
|
|
521
521
|
}
|
|
522
522
|
}
|
|
523
|
-
`}function
|
|
523
|
+
`}function Pt(e,t,n){return`import { createToken } from '@forinda/kickjs'
|
|
524
524
|
import type { ${e}ResponseDTO } from '../../application/dtos/${t}-response.dto'
|
|
525
525
|
import type { Create${e}DTO } from '../../application/dtos/create-${t}.dto'
|
|
526
526
|
import type { Update${e}DTO } from '../../application/dtos/update-${t}.dto'
|
|
@@ -546,7 +546,7 @@ export interface I${e}Repository {
|
|
|
546
546
|
* adopters must NOT use the reserved \`'kick/'\` namespace.
|
|
547
547
|
*/
|
|
548
548
|
export const ${e.toUpperCase()}_REPOSITORY = createToken<I${e}Repository>('${n}/${e}/repository')
|
|
549
|
-
`}function
|
|
549
|
+
`}function Ft(e,t){return`import { Service, Inject, HttpException } from '@forinda/kickjs'
|
|
550
550
|
import { ${e.toUpperCase()}_REPOSITORY, type I${e}Repository } from '../repositories/${t}.repository'
|
|
551
551
|
|
|
552
552
|
@Service()
|
|
@@ -560,7 +560,7 @@ export class ${e}DomainService {
|
|
|
560
560
|
if (!entity) throw HttpException.notFound('${e} not found')
|
|
561
561
|
}
|
|
562
562
|
}
|
|
563
|
-
`}function
|
|
563
|
+
`}function It(e,t,n,r){return[{file:`create-${t}.use-case.ts`,content:`import { Service, Inject } from '@forinda/kickjs'
|
|
564
564
|
import { ${e.toUpperCase()}_REPOSITORY, type I${e}Repository } from '../../domain/repositories/${t}.repository'
|
|
565
565
|
import type { Create${e}DTO } from '../dtos/create-${t}.dto'
|
|
566
566
|
|
|
@@ -603,10 +603,10 @@ export class Delete${e}UseCase {
|
|
|
603
603
|
constructor(@Inject(${e.toUpperCase()}_REPOSITORY) private repo: I${e}Repository) {}
|
|
604
604
|
async execute(id: string) { return this.repo.delete(id) }
|
|
605
605
|
}
|
|
606
|
-
`}]}async function
|
|
606
|
+
`}]}async function Lt(e){let{name:n,moduleName:r,modulesDir:i}=e,a=e.pluralize??!0,o=g(n),s=x(n),c=[],l;if(e.outDir)l=A(e.outDir);else if(r){let e=g(r),t=a?m(e):e;l=A(O(i??`src/modules`,t,`__tests__`))}else l=A(`src/__tests__`);let u=O(l,`${o}.test.ts`);return await t(u,`import { describe, it, expect, beforeEach } from 'vitest'
|
|
607
607
|
import { Container } from '@forinda/kickjs'
|
|
608
608
|
|
|
609
|
-
describe('${
|
|
609
|
+
describe('${s}', () => {
|
|
610
610
|
beforeEach(() => {
|
|
611
611
|
Container.reset()
|
|
612
612
|
})
|
|
@@ -626,58 +626,58 @@ describe('${c}', () => {
|
|
|
626
626
|
expect(true).toBe(true)
|
|
627
627
|
})
|
|
628
628
|
})
|
|
629
|
-
`),
|
|
630
|
-
(dry run — no files were written)`),console.log()}async function
|
|
629
|
+
`),c.push(u),c}const Rt=[`agents`,`claude`,`skills`,`gemini`,`copilot`,`both`,`all`];function H(e){return e.parent?.opts()?.dryRun??!1}function U(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(`
|
|
630
|
+
(dry run — no files were written)`),console.log()}async function zt(e){if(!e)try{let e=await C(process.cwd());await T({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 Bt=[{name:`module <name>`,description:`Full DDD module (controller, DTOs, use-cases, 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:`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`}];async function Vt(){console.log(`
|
|
631
631
|
Built-in generators:
|
|
632
|
-
`);let e=Math.max(...
|
|
632
|
+
`);let e=Math.max(...Bt.map(e=>e.name.length));for(let t of Bt)console.log(` kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await C(process.cwd()),n=he(t?.plugins??[],t?.commands??[]),r=await se(process.cwd(),n.generators);if(r.generators.length>0){console.log(`
|
|
633
633
|
Plugin generators:
|
|
634
634
|
`);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(`
|
|
635
635
|
Failed to load:
|
|
636
|
-
`);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}async function
|
|
637
|
-
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=
|
|
638
|
-
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=
|
|
639
|
-
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=
|
|
640
|
-
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=
|
|
641
|
-
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=
|
|
642
|
-
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=
|
|
636
|
+
`);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}async function Ht(e,t,n){let r=await C(process.cwd()),i=S(r),o=t.modulesDir??i.dir??`src/modules`,s=t.repo??ee(i.repo),c=t.pattern??r?.pattern??`ddd`,l=t.pluralize===!1?!1:i.pluralize??!0,u=de(r,process.cwd()),d=i.style??`define`;if(!n&&d===`define`){let e=await bt(A(o),`define`);if(e.length>0){console.error(`\n ${a.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n ${a.dim(`Project setting:`)} modules.style: 'define' (default)\n\n ${a.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 ${a.bold(`Pick one:`)}\n 1. Migrate everything to defineModule:\n ${a.dim(`$`)} kick codemod modules --experimental --apply\n 2. Keep the class form — pin it in kick.config.ts:\n ${a.dim(`// kick.config.ts`)}\n ${a.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let f=[];for(let r of e){let e=await ne({name:r,modulesDir:A(o),noEntity:t.entity===!1,noTests:t.tests===!1,repo:s,minimal:t.minimal,force:t.force,pattern:c,dryRun:n,pluralize:l,prismaClientPath:i.prismaClientPath,tokenScope:u,style:i.style});f.push(...e)}U(f,n),await zt(n)}function Ut(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 implementation: inmemory | drizzle | prisma`).option(`--pattern <pattern>`,`Override project pattern: rest | ddd | cqrs | 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 Vt();return}if(!e||e.length===0){n.help();return}let a=H(i);p(a);let[o,s,...c]=e;if(o){let e=await C(process.cwd()),n=he(e?.plugins??[],e?.commands??[]),i=await re({generatorName:o,itemName:s??``,args:c,flags:r,cwd:process.cwd(),projectRoot:t?.projectRoot},n.generators);if(i){U(i.files,a);return}}await Ht(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 implementation: inmemory | drizzle | prisma`).option(`--pattern <pattern>`,`Override project pattern: rest | ddd | cqrs | 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=H(n);p(r),await Ht(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=H(n);p(r),U(await v({name:e,outDir:A(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=H(n);p(r),U(await ct({name:e,outDir:A(t.out)}),r)}),n.command(`middleware <name>`).description(`Generate an Express middleware function
|
|
637
|
+
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=H(n);p(r);let i=await C(process.cwd()),a=S(i),o=a.dir??`src/modules`;U(await ce({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.)
|
|
638
|
+
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=H(n);p(r);let i=await C(process.cwd()),a=S(i),o=a.dir??`src/modules`;U(await te({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`service <name>`).description(`Generate a @Service() class
|
|
639
|
+
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=H(n);p(r);let i=await C(process.cwd()),a=S(i),o=a.dir??`src/modules`;U(await _({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
|
|
640
|
+
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=H(n);p(r);let i=await C(process.cwd()),a=S(i),o=a.dir??`src/modules`;U(await oe({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r),await zt(r)}),n.command(`dto <name>`).description(`Generate a Zod DTO schema
|
|
641
|
+
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=H(n);p(r);let i=await C(process.cwd()),a=S(i),o=a.dir??`src/modules`;U(await ie({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
|
|
642
|
+
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=H(n);p(r);let i=S(await C(process.cwd())),a=i.dir??`src/modules`;U(await Lt({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=H(n);p(r),U(await xt({name:e,outDir:A(t.out),queue:t.queue}),r)}),n.command(`scaffold <name> [fields...]`).description(`Generate a full CRUD module from field definitions
|
|
643
643
|
Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
|
|
644
644
|
Types: string, text, number, int, float, boolean, date, email, url, uuid, json, enum:a,b,c
|
|
645
645
|
Optional: append :optional (shell-safe): description:text:optional
|
|
646
|
-
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=
|
|
646
|
+
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=H(r);p(i),t.length===0&&(console.error(`
|
|
647
647
|
Error: At least one field is required.
|
|
648
648
|
Usage: kick g scaffold <name> <field:type> [field:type...]
|
|
649
649
|
Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
|
|
650
650
|
Optional: append :optional (shell-safe, no quoting needed)
|
|
651
|
-
`),process.exit(1));let a=await
|
|
652
|
-
`,l=``;if(
|
|
653
|
-
`,`utf-8`),o(` ✓ wrote manifest → ${
|
|
651
|
+
`),process.exit(1));let a=await C(process.cwd()),o=S(a),s=n.modulesDir??o.dir??`src/modules`,c=Ct(t),l=de(a,process.cwd()),u=a?.pattern??`ddd`;u!==`ddd`&&(console.error(`\n Error: 'kick g scaffold' currently only supports the DDD pattern.\n Detected project pattern: '${u}'.\n Workarounds:\n - Run 'kick g module ${e}' for the ${u} layout (no fields), then add fields manually.\n - Override the pattern for this scaffold by setting kick.config.ts pattern: 'ddd'.\n`),process.exit(1));let d=await wt({name:e,fields:c,modulesDir:A(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)`:``}`);U(d,i),await zt(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>`,`Default repository type: inmemory | drizzle | prisma`,`inmemory`).option(`-f, --force`,`Overwrite existing kick.config.ts without prompting`).action(async(e,t)=>{let n=H(t);p(n),U(await lt({outDir:A(`.`),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 | ddd | cqrs | minimal`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t)=>{let n=H(t);p(n);let r=e.only??`all`;if(!Rt.includes(r)){console.error(` Invalid --only value: ${r}. Expected: ${Rt.join(` | `)}`),process.exitCode=1;return}U(await me({outDir:A(`.`),only:r,name:e.name,pm:e.pm,template:e.template,force:e.force}),n)});for(let e of t?.generators??[])Wt(n,e,t?.projectRoot)}function Wt(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=H(o);p(s);let c=await re({generatorName:i.name,itemName:e??``,args:r??[],flags:a,cwd:process.cwd(),projectRoot:n},[t]);c&&U(c.files,s)})}function Gt(e,t,n){let r=Le(process.execPath,[e],{cwd:n,stdio:`inherit`,env:{...process.env,...t}});r.status!==0&&process.exit(r.status??1)}async function Kt(e){let t=E.resolve(e.cwd,`.kickjs/types`);await Ae(t,{recursive:!0});let n=new Map,r=e.scan??_e,i={cwd:e.cwd,config:e.config,async importTs(e){return await import(L(e).href)},async writeFile(t,n){let r=E.resolve(e.cwd,t);await Ae(E.dirname(r),{recursive:!0}),await I(r,n,`utf8`)},getScanResult:e=>{let t=qt(e),i=n.get(t);return i||(i=r(e),n.set(t,i)),i},log:console},a=[];for(let n of e.plugins){let r=await n.generate(i);if(r===null){a.push({id:n.id,status:`skipped`});continue}let o=n.outExtension??`.d.ts`,s=E.join(t,`${n.id.replace(/\//g,`__`)}${o}`),c=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: ${n.id} */\n\n`+r+`
|
|
652
|
+
`,l=``;if(M(s)&&(l=await F(s,`utf8`)),l===c){a.push({id:n.id,status:`unchanged`,outFile:s});continue}if(e.check)throw Error(`kick typegen --check: drift detected for ${n.id} (${s})`);await I(s,c,`utf8`),a.push({id:n.id,status:`written`,outFile:s})}return a}function qt(e){let t=(e.extensions??[]).slice().toSorted().join(`,`),n=(e.exclude??[]).slice().toSorted().join(`,`);return[`root=${e.root}`,`cwd=${e.cwd}`,`extensions=${t}`,`exclude=${n}`,`envFile=${e.envFile??``}`].join(`|`)}function Jt(e,t){let n=new Set(t),r=[],i=[],a=new Set;for(let t of e)n.has(t.id)?(i.push(t),a.add(t.id)):r.push(t);return{enabled:r,skipped:i,unknown:[...n].filter(e=>!a.has(e))}}async function W(e){let{enabled:t,skipped:n,unknown:r}=Jt(he([...Dr,...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 Kt({cwd:e.cwd,config:e.config??{},plugins:t,check:e.check});if(!e.silent)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[]}}async function Yt(e,t){let{cwd:n,silent:r=!1}=t,i=t.distDir??e?.build?.outDir??`dist`,a=e?.assetMap;if(!a||Object.keys(a).length===0)return null;let o=r?()=>{}:console.log,s=A(n,i);N(s,{recursive:!0});let c=[],l={};for(let[e,t]of Object.entries(a)){let r=await Xt(e,t,n,s);c.push(r.entrySummary),Object.assign(l,r.manifestSlice),o(` ✓ ${e}: ${r.entrySummary.filesCopied} file(s) → ${r.entrySummary.dest}`)}let u={version:1,entries:l},d=O(s,`.kickjs-assets.json`);return Oe(d,JSON.stringify(u,null,2)+`
|
|
653
|
+
`,`utf-8`),o(` ✓ wrote manifest → ${k(n,d)} (${Object.keys(l).length} entries)`),{manifestPath:d,entries:c,manifest:u}}async function Xt(e,t,n,r){let i=A(n,t.src),a=t.dest?A(n,t.dest):O(r,e);if(Qt(a,n))return console.warn(` ⚠ assetMap.${e}.dest ('${t.dest}') resolves outside the project root — skipping copy`),{entrySummary:{namespace:e,src:t.src,dest:k(n,a),filesCopied:0},manifestSlice:{}};if(!M(i)||!$t(i))return{entrySummary:{namespace:e,src:t.src,dest:k(n,a),filesCopied:0},manifestSlice:{}};let o=await Re(t.glob??`**/*`,{cwd:i,nodir:!0,dot:!1,posix:!0});N(a,{recursive:!0});let s={},{pairs:c,collisionGroupsResolved:l}=ze(e,[...o].toSorted(),{strategy:t.keys??`auto`});for(let{rel:e,key:t}of c){let n=O(i,e),o=O(a,e);N(D(o),{recursive:!0}),we(n,o),s[t]=Zt(r,o)}return l>0&&console.log(` ℹ assetMap.${e}: auto-resolved ${l} 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:k(n,a),filesCopied:o.length},manifestSlice:s}}function Zt(e,t){return k(e,t).split(/[\\/]/).filter(Boolean).join(`/`)}function Qt(e,t){let n=k(t,e);return n===``?!1:n.startsWith(`..`)||Ce(n)}function $t(e){try{return De(e).isDirectory()}catch{return!1}}function en(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function tn(e,t,n={}){t&&(process.env.PORT=t);let r=en(n.polling),i=process.cwd(),a=await C(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await T({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})`)}await W({cwd:i,config:a});let{createRequire:c}=await import(`node:module`),{createServer:l}=await import(L(c(A(`package.json`)).resolve(`vite`)).href),u=await l({configFile:A(`vite.config.ts`),server:{port:t?parseInt(t,10):void 0,...r?{watch:{usePolling:!0,interval:100}}:{}}}),d=a?.assetMap?Object.values(a.assetMap).map(e=>e?.src).filter(e=>typeof e==`string`&&e.length>0).map(e=>A(i,e)):[],f=e=>d.some(t=>e===t||e.startsWith(`${t}/`)),p=null,m=e=>{if(e.includes(`.kickjs`)||e.endsWith(`.d.ts`))return;let t=/\.(ts|tsx|mts|cts)$/.test(e),n=f(e);!t&&!n||(p&&clearTimeout(p),p=setTimeout(()=>{T({cwd:i,silent:!0,allowDuplicates:!0,schemaValidator:o,envFile:s,srcDir:a?.typegen?.srcDir,outDir:a?.typegen?.outDir,assetMap:a?.assetMap,runPlugins:!1}).catch(()=>{}),W({cwd:i,config:a,silent:!0}).catch(()=>{})},100))};u.watcher.on(`add`,m),u.watcher.on(`unlink`,m),u.watcher.on(`change`,m),d.length>0&&u.watcher.add(d),await u.listen(),u.printUrls(),console.log(`
|
|
654
654
|
KickJS dev server running (Vite + @forinda/kickjs-vite)
|
|
655
|
-
`);let h=async()=>{p&&clearTimeout(p),await u.close(),process.exit(0)};process.on(`SIGINT`,h),process.on(`SIGTERM`,h)}function
|
|
655
|
+
`);let h=async()=>{p&&clearTimeout(p),await u.close(),process.exit(0)};process.on(`SIGINT`,h),process.on(`SIGTERM`,h)}function nn(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)`).action(async e=>{try{await tn(e.entry,e.port,{polling:e.polling})}catch(e){e.code===`ERR_MODULE_NOT_FOUND`&&e.message?.includes(`vite`)?console.error(`
|
|
656
656
|
Error: vite is not installed.
|
|
657
657
|
Run: pnpm add -D vite unplugin-swc
|
|
658
658
|
`):console.error(`
|
|
659
659
|
Dev server failed:`,e.message??e),process.exit(1)}}),e.command(`build`).description(`Build for production via Vite`).action(async()=>{console.log(`
|
|
660
660
|
Building for production...
|
|
661
|
-
`);let{createRequire:e}=await import(`node:module`),{build:t}=await import(
|
|
662
|
-
Copying directories to dist...`);for(let e of r){let t=typeof e==`string`?e:e.src,n=typeof e==`string`?
|
|
663
|
-
Building asset map...`);try{await
|
|
661
|
+
`);let{createRequire:e}=await import(`node:module`),{build:t}=await import(L(e(A(`package.json`)).resolve(`vite`)).href);await t({configFile:A(`vite.config.ts`)});let n=await C(process.cwd()),r=n?.copyDirs??[];if(r.length>0){console.log(`
|
|
662
|
+
Copying directories to dist...`);for(let e of r){let t=typeof e==`string`?e:e.src,n=typeof e==`string`?O(`dist`,e):e.dest??O(`dist`,t),r=A(t),i=A(n);if(!M(r)){console.log(` ⚠ Skipped ${t} (not found)`);continue}N(i,{recursive:!0}),we(r,i,{recursive:!0}),console.log(` ✓ ${t} → ${n}`)}}if(n?.assetMap&&Object.keys(n.assetMap).length>0){console.log(`
|
|
663
|
+
Building asset map...`);try{await Yt(n,{cwd:process.cwd()})}catch(e){console.error(` ✗ asset build failed: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}console.log(`
|
|
664
664
|
Build complete.
|
|
665
|
-
`)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await
|
|
666
|
-
Building asset map...`);try{await
|
|
665
|
+
`)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await C(process.cwd());if(!e?.assetMap||Object.keys(e.assetMap).length===0){console.log(` No assetMap entries — nothing to build.`);return}console.log(`
|
|
666
|
+
Building asset map...`);try{await Yt(e,{cwd:process.cwd()}),console.log(`
|
|
667
667
|
Asset build complete.
|
|
668
|
-
`)}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))
|
|
669
|
-
Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function
|
|
668
|
+
`)}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)),Gt(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 tn(e.entry,e.port)}catch(e){console.error(`
|
|
669
|
+
Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function rn(e){e.command(`info`).description(`Print system and framework info`).action(()=>{console.log(`
|
|
670
670
|
KickJS CLI
|
|
671
671
|
|
|
672
672
|
System:
|
|
673
|
-
OS: ${
|
|
673
|
+
OS: ${Ve()} ${He()} (${Be()})
|
|
674
674
|
Node: ${process.version}
|
|
675
675
|
|
|
676
676
|
Packages:
|
|
677
677
|
@forinda/kickjs workspace
|
|
678
678
|
@forinda/kickjs-vite workspace
|
|
679
679
|
@forinda/kickjs-cli workspace
|
|
680
|
-
`)})}const{bold:
|
|
680
|
+
`)})}const{bold:G,dim:K,green:an,red:q,yellow:on,blue:sn}=a;function cn(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 ln(e){let t=await fetch(e,{signal:AbortSignal.timeout(5e3)});if(!t.ok)throw Error(`${t.status} ${t.statusText}`);return t.json()}async function J(e,t){try{return await ln(`${e}${t}`)}catch{return null}}async function un(e){let[t,n,r,i,a]=await Promise.all([J(e,`/health`),J(e,`/metrics`),J(e,`/routes`),J(e,`/container`),J(e,`/ws`)]);return{health:t,metrics:n,routes:r,container:i,ws:a}}function dn(e,t){let{health:n,metrics:r,routes:i,container:a,ws:s}=t,c=K(`─`.repeat(60));if(console.log(),console.log(G(` KickJS Inspector`)+K(` → ${e}`)),console.log(c),n){let e=n.status===`healthy`?an(`● healthy`):q(`● `+n.status);console.log(` ${G(`Health:`)} ${e}`)}else console.log(` ${G(`Health:`)} ${q(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?q:r.errorRate>0?on:an;console.log(` ${G(`Uptime:`)} ${cn(r.uptimeSeconds)}`),console.log(` ${G(`Requests:`)} ${r.requests}`),console.log(` ${G(`Errors:`)} ${r.serverErrors} server, ${r.clientErrors??0} client ${K(`(`)}${t(e+`%`)}${K(`)`)}`)}if(a&&console.log(` ${G(`DI:`)} ${a.count} bindings`),s&&s.enabled&&console.log(` ${G(`WS:`)} ${s.connections??0} connections, ${s.namespaces??0} namespaces`),i?.routes?.length){console.log(),console.log(G(` Routes`)),console.log(c),console.log(` ${K(`METHOD`)} ${K(`PATH`.padEnd(36))} ${K(`CONTROLLER`)}`);for(let e of i.routes){let t=e.path.length>36?e.path.slice(0,33)+`...`:e.path.padEnd(36);console.log(` ${o(e.method)} ${t} ${sn(e.controller)}.${K(e.handler)}`)}}console.log(c),console.log()}function fn(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 un(r);t.json?console.log(JSON.stringify(e,null,2)):dn(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(q(` ✖ Could not connect to ${n}`)),console.error(K(` ${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 pn(e,t){let n=e.toLowerCase();return t.every(e=>n.includes(e.toLowerCase()))}function Y(e,t){let n=e.toLowerCase();return t.some(e=>n.includes(e.toLowerCase()))}const mn=[{match(e,t){let n=pn(e,[`config`,`get`])&&Y(e,[`undefined`,`null`]),r=e.includes(`@Value`)&&Y(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
|
|
681
681
|
registers the env schema with kickjs at module-load time. Without it,
|
|
682
682
|
ConfigService falls back to the base schema (PORT/NODE_ENV/LOG_LEVEL only)
|
|
683
683
|
and every user-defined key reads as undefined. @Value() may *appear* to
|
|
@@ -699,7 +699,7 @@ describe('UserController', () => {
|
|
|
699
699
|
beforeEach(() => Container.reset())
|
|
700
700
|
|
|
701
701
|
it('does the thing', async () => { /* ... */ })
|
|
702
|
-
})`,docs:`https://forinda.github.io/kick-js/guide/testing.html`}}:null}},{match(e,t){return e.includes(`@Module`)||
|
|
702
|
+
})`,docs:`https://forinda.github.io/kick-js/guide/testing.html`}}:null}},{match(e,t){return e.includes(`@Module`)||pn(e,[`Module`,`is not a function`])||pn(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
|
|
703
703
|
pattern instead: a class implements AppModule and exposes routes() that
|
|
704
704
|
returns the controller wiring. This was a deliberate choice — modules
|
|
705
705
|
become explicit values rather than metadata, which makes them easier to
|
|
@@ -751,24 +751,24 @@ drop the entry.`,fix:`Open src/modules/index.ts and verify the module is in the
|
|
|
751
751
|
import { UserModule } from './users/user.module'
|
|
752
752
|
import { TaskModule } from './tasks/task.module' // ← was this missing?
|
|
753
753
|
|
|
754
|
-
export const modules: AppModuleEntry[] = [UserModule(), TaskModule()]`,docs:`https://forinda.github.io/kick-js/guide/project-structure.html`}}:null}}];function
|
|
754
|
+
export const modules: AppModuleEntry[] = [UserModule(), TaskModule()]`,docs:`https://forinda.github.io/kick-js/guide/project-structure.html`}}:null}}];function hn(e,t){let n=null;for(let r of mn){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 gn(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.
|
|
755
755
|
export OPENAI_API_KEY="sk-..."
|
|
756
756
|
|
|
757
757
|
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:
|
|
758
758
|
kick add ai
|
|
759
759
|
|
|
760
760
|
Or manually:
|
|
761
|
-
pnpm add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=
|
|
762
|
-
`)}function
|
|
761
|
+
pnpm add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=_n(e.cwd),s=`Error or stack trace:\n\n${e.input.trim()}`;try{let e=vn((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 _n(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(`
|
|
762
|
+
`)}function vn(e){let t=[e,yn(e),bn(e)].filter(e=>e!==null);for(let e of t)try{let t=JSON.parse(e);if(xn(t))return t}catch{continue}return null}function yn(e){let t=e.match(/```(?:json)?\s*\n([\s\S]*?)```/);return t?t[1]?.trim()??null:null}function bn(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 xn(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 Sn(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 Tn(e,t.message);(!n||n.trim().length===0)&&(process.stderr.write(`Error: no input provided.
|
|
763
763
|
|
|
764
764
|
Pass a message as a positional arg, --message flag, or pipe via stdin:
|
|
765
765
|
kick explain "config.get returned undefined"
|
|
766
766
|
pnpm test 2>&1 | kick explain
|
|
767
|
-
`),process.exit(1));let r=
|
|
768
|
-
`);return}if(i){
|
|
769
|
-
`),process.exit(2)),
|
|
770
|
-
`),process.exit(a.kind===`ok`?0:2)),
|
|
771
|
-
`)}function
|
|
767
|
+
`),process.exit(1));let r=Dn(),i=hn(n,r);if(t.json&&i){process.stdout.write(JSON.stringify({matched:!0,...i},null,2)+`
|
|
768
|
+
`);return}if(i){On(n,i.diagnosis,i.confidence);return}t.ai||(t.json&&(process.stdout.write(JSON.stringify({matched:!1},null,2)+`
|
|
769
|
+
`),process.exit(2)),kn(n,!1),process.exit(2));let a=await gn({input:n,model:t.model,cwd:r.cwd});t.json&&(process.stdout.write(JSON.stringify(Cn(a),null,2)+`
|
|
770
|
+
`),process.exit(a.kind===`ok`?0:2)),wn(n,a),process.exit(a.kind===`ok`?0:2)})}function Cn(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 wn(e,t){if(t.kind===`ok`){On(e,t.diagnosis,-1,!0);return}if(t.kind===`unavailable`){process.stdout.write(`\n Explaining: ${Z(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback unavailable: ${t.reason}\n\n`),process.stdout.write(`${X(t.suggestion,` `)}\n\n`);return}process.stdout.write(`\n Explaining: ${Z(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback error: ${t.message}\n\n`)}async function Tn(e,t){return e&&e.trim().length>0?e:t&&t.trim().length>0?t:process.stdin.isTTY?``:En()}function En(){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 Dn(){let e=process.cwd();return{cwd:e,hasFile:t=>M(A(e,t))}}function On(e,t,n,r=!1){let i=Z(e.trim(),200),a=r?`AI-generated — verify before applying`:An(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${X(t.explanation,` `)}\n`),process.stdout.write(`\n Fix:\n${X(t.fix,` `)}\n`),t.codeBefore&&process.stdout.write(`\n Before:\n${X(t.codeBefore,` `)}\n`),t.codeAfter&&process.stdout.write(`\n After:\n${X(t.codeAfter,` `)}\n`),t.docs&&process.stdout.write(`\n Docs: ${t.docs}\n`),process.stdout.write(`
|
|
771
|
+
`)}function kn(e,t){let n=Z(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.
|
|
772
772
|
When @forinda/kickjs-ai ships its provider implementations,
|
|
773
773
|
this command will call the configured LLM with the error +
|
|
774
774
|
project context and return a structured fix.
|
|
@@ -787,10 +787,10 @@ Pass a message as a positional arg, --message flag, or pipe via stdin:
|
|
|
787
787
|
|
|
788
788
|
`)}function X(e,t){return e.split(`
|
|
789
789
|
`).map(e=>`${t}${e}`).join(`
|
|
790
|
-
`)}function Z(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function
|
|
791
|
-
`,`utf8`),process.stdout.write(`\n ✓ Wrote MCP server entry "${r}" to ${i}\n\n To activate it:\n 1. Build your app: kick build\n 2. Restart your MCP client (Claude Code, Cursor, Zed)\n 3. The server should appear in the client's tool picker\n\n`)}function
|
|
790
|
+
`)}function Z(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function An(e){return e>=90?`high confidence`:e>=70?`good match`:e>=50?`medium confidence`:`low confidence — verify manually`}function jn(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(Mn),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(Nn)}function Mn(e){let t=A(e.entry);M(t)||(process.stderr.write(`Error: entry file not found: ${t}\n\nBuild the app first with \`kick build\`, or pass a custom entry:\n kick mcp -e dist/server.js\n`),process.exit(1));let n=[...e.nodeArg??[],t],r=Ie(process.execPath,n,{stdio:`inherit`,env:{...process.env,KICK_MCP_STDIO:`1`,NODE_ENV:process.env.NODE_ENV??`production`}});r.on(`error`,e=>{process.stderr.write(`Failed to start MCP server: ${e.message}\n`),process.exit(1)}),r.on(`exit`,(e,t)=>{if(t){process.kill(process.pid,t);return}process.exit(e??0)});let i=e=>{r.killed||r.kill(e)};process.on(`SIGINT`,()=>i(`SIGINT`)),process.on(`SIGTERM`,()=>i(`SIGTERM`))}function Nn(e){let t=process.cwd(),n=Pn(t)??Se(t),r=e.name??n,i=e.global?A(process.env.HOME??`.`,`.mcp.json`):A(t,e.out),a={command:`kick`,args:[`mcp`],cwd:t},o={mcpServers:{}};if(M(i))try{let e=P(i,`utf8`),t=JSON.parse(e);t&&typeof t==`object`&&t.mcpServers&&(o={mcpServers:{...t.mcpServers}})}catch(e){let t=e instanceof Error?e.message:String(e);process.stderr.write(`Error: existing ${i} is not valid JSON (${t}).\nFix the file or pass --force to overwrite the entry.\n`),process.exit(1)}o.mcpServers[r]&&!e.force&&(process.stderr.write(`Error: an entry for "${r}" already exists in ${i}.\nPass --force to overwrite it, or use --name to pick a different key.\n`),process.exit(1)),o.mcpServers[r]=a,Oe(i,JSON.stringify(o,null,2)+`
|
|
791
|
+
`,`utf8`),process.stdout.write(`\n ✓ Wrote MCP server entry "${r}" to ${i}\n\n To activate it:\n 1. Build your app: kick build\n 2. Restart your MCP client (Claude Code, Cursor, Zed)\n 3. The server should appear in the client's tool picker\n\n`)}function Pn(e){let t=A(e,`package.json`);if(!M(t))return null;try{let e=P(t,`utf8`),n=JSON.parse(e);return typeof n.name==`string`?n.name:null}catch{return null}}function Fn(e){e.command(`tinker`).description(`Interactive REPL with DI container and services loaded`).option(`-e, --entry <file>`,`Entry file to load`,`src/index.ts`).action(async e=>{let t=process.cwd(),n=A(t,e.entry);M(n)||(console.error(`\n Error: ${e.entry} not found.\n`),process.exit(1));let r=Ln(t,`tsx`);r||(console.error(`
|
|
792
792
|
Error: tsx not found. Install it: pnpm add -D tsx
|
|
793
|
-
`),process.exit(1));let i=
|
|
793
|
+
`),process.exit(1));let i=In(n,e.entry),a=O(t,`.kick-tinker.mjs`),{writeFileSync:o,unlinkSync:s}=await import(`node:fs`);o(a,i,`utf-8`);try{let e=Fe(a,[],{cwd:t,execPath:r,stdio:`inherit`});await new Promise(t=>{e.on(`exit`,()=>t())})}finally{try{s(a)}catch{}}})}function In(e,t){return`
|
|
794
794
|
import 'reflect-metadata'
|
|
795
795
|
|
|
796
796
|
// Prevent bootstrap() from starting the HTTP server
|
|
@@ -815,7 +815,7 @@ try {
|
|
|
815
815
|
|
|
816
816
|
// Load entry to trigger decorator registration
|
|
817
817
|
try {
|
|
818
|
-
await import('${
|
|
818
|
+
await import('${L(e).href}')
|
|
819
819
|
} catch (err) {
|
|
820
820
|
console.warn(' Warning: ' + err.message)
|
|
821
821
|
console.warn(' Container may be partially initialized.\\n')
|
|
@@ -844,32 +844,32 @@ server.on('exit', () => {
|
|
|
844
844
|
console.log('\\n Goodbye!\\n')
|
|
845
845
|
process.exit(0)
|
|
846
846
|
})
|
|
847
|
-
`}function
|
|
847
|
+
`}function Ln(e,t){let n=e;for(;;){let e=O(n,`node_modules`,`.bin`,t);if(M(e))return e;let r=A(n,`..`);if(r===n)break;n=r}return null}function Rn(e,t){let n=RegExp(`^\\s*${b(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]!==`
|
|
848
848
|
`;)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]===`
|
|
849
|
-
`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t;continue}i=s+1}return{content:a,changed:r}}function
|
|
849
|
+
`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t;continue}i=s+1}return{content:a,changed:r}}function zn(e,t){let n=ae(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=Rn(a,t).content,a=a.replace(RegExp(`\\s*,?\\s*${b(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 Bn(e){let{name:t,modulesDir:n,force:r}=e,i=e.pluralize!==!1,o=g(t),s=x(t),c=i?m(o):o,l=O(n,c);if(!await f(l)){console.log(`\n Module not found: ${l}\n`);return}if(!r&&!await u({message:a.red(`Delete module '${c}' at ${l}? This cannot be undone.`),initialValue:!1})){console.log(`
|
|
850
850
|
Cancelled.
|
|
851
|
-
`);return}await
|
|
851
|
+
`);return}await Me(l,{recursive:!0,force:!0}),console.log(` Deleted: ${l}`);let d=O(n,`index.ts`);if(await f(d)){let e=await F(d,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${b(s)}Module\\s*\\}\\s*from\\s*['"][^'"]*${b(c)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=zn(e,s),e=e.replace(/\n{3,}/g,`
|
|
852
852
|
|
|
853
|
-
`),e!==t&&(await
|
|
853
|
+
`),e!==t&&(await I(d,e,`utf-8`),console.log(` Unregistered: ${s}Module from ${d}`))}console.log(`\n Module '${c}' removed.\n`)}function Vn(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=S(await C(process.cwd())),r=t.modulesDir??n.dir??`src/modules`,i=t.pluralize===!1?!1:n.pluralize??!0;for(let n of e)await Bn({name:n,modulesDir:A(r),force:t.force,pluralize:i})})}function Hn(e){if(e!==void 0){if(e===`false`||e===`off`||e===`none`)return!1;if(e===`zod`)return`zod`;console.warn(` kick typegen: unknown --schema-validator '${e}' (only 'zod' and 'false' are supported). Falling back to project config.`)}}function Un(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function Wn(e){e.command(`typegen`).description(`Generate type-safe DI registry and module types into .kickjs/types/`).option(`-w, --watch`,`Watch source files and regenerate on change`).option(`-s, --src <dir>`,`Source directory to scan`,`src`).option(`-o, --out <dir>`,`Output directory`,`.kickjs/types`).option(`--silent`,`Suppress output`).option(`--allow-duplicates`,`Auto-namespace duplicate class names instead of failing (use with caution)`).option(`--schema-validator <name>`,`Schema validator for body/query/params typing (currently 'zod' or 'false')`).option(`--env-file <path>`,`Path to env schema file for KickEnv typing (default 'src/env.ts'; pass 'false' to disable)`).option(`--check`,`CI gate: fail on plugin-typegen drift instead of writing`).option(`--list`,"List every registered typegen plugin id (use to populate `typegen.disable`)").action(async e=>{let t=pe(process.cwd()),n=await C(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-CbMjTNda.mjs`).then(e=>e.t),{builtinCliPlugins:t}=await import(`./builtins-cz42mDMv.mjs`),r=e([...t,...n?.plugins??[]],n?.commands??[]),i=new Set(n?.typegen?.disable??[]);if(r.typegens.length===0){console.log(` No typegen plugins registered.`);return}let a=Math.max(...r.typegens.map(e=>e.id.length));console.log(`
|
|
854
854
|
Registered typegen plugins:
|
|
855
|
-
`);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=
|
|
855
|
+
`);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=Hn(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=Un(e.envFile)??n?.typegen?.envFile,a={cwd:t,srcDir:e.src??n?.typegen?.srcDir,outDir:e.out??n?.typegen?.outDir,silent:e.silent,allowDuplicates:e.allowDuplicates,schemaValidator:r,envFile:i,assetMap:n?.assetMap,runPlugins:!1};try{if(e.watch){let t=await ve(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{let{result:r}=await T(a),i=await W({cwd:t,config:n??null,silent:e.silent,check:e.check});e.check&&i.some(e=>e.status===`written`)&&process.exit(1),e.check||await ye(A(t,e.out??n?.typegen?.outDir??`.kickjs/types`),r.written,i,e.silent??!1)}}catch(e){e instanceof xe?console.error(`
|
|
856
856
|
`+e.message+`
|
|
857
|
-
`):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}function
|
|
857
|
+
`):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}function Gn(e){let t=[];if(!M(e))return t;let n=Te(e,{withFileTypes:!0});for(let r of n){let n=O(e,r.name);if(r.isDirectory()){if([`node_modules`,`dist`,`.kickjs`,`.git`].includes(r.name))continue;t.push(...Gn(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function Kn(e){try{return P(e,`utf-8`)}catch{return``}}const qn=new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function Jn(e,t){let n=Kn(O(e,`.env`));if(n){let e=n.match(/^JWT_SECRET\s*=\s*['"]?([^'"\n]*)['"]?/m);if(e){let t=e[1].trim();if(qn.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 Yn(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 Xn(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 Zn(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function Qn(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 $n(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 er(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 tr(e){let t=Gn(O(e,`src`)).map(e=>Kn(e)),n=[],r=Jn(e,t);r&&n.push(r);let i=Yn(t);i&&n.push(i);let a=Xn(t);a&&n.push(a);let o=Zn();o&&n.push(o);let s=Qn(t);return s&&n.push(s),n.push($n(t)),n.push(er(t)),n}function nr(t){t.command(`check`).description(`Audit project for common issues`).option(`--deploy`,`Run production readiness checks`).action(t=>{if(!t.deploy){console.log(`
|
|
858
858
|
Usage: kick check --deploy
|
|
859
859
|
|
|
860
860
|
Available checks:
|
|
861
861
|
--deploy Audit for production readiness (security, config, best practices)
|
|
862
|
-
`);return}let
|
|
862
|
+
`);return}let i=process.cwd();n(`KickJS Deploy Check`);let o=l();o.start(`Scanning project...`);let c=tr(i);o.stop(`Scan complete`);let u={CRITICAL:0,WARNING:1,INFO:2};c.sort((e,t)=>u[e.severity]-u[t.severity]);for(let t of c)s.message(`${e(t.severity)} ${t.message}`);let d=c.filter(e=>e.severity===`CRITICAL`).length,f=c.filter(e=>e.severity===`WARNING`).length,p=c.filter(e=>e.severity===`INFO`).length,m=f===1?`warning`:`warnings`,h=[d>0?a.red(`${d} critical`):`${d} critical`,f>0?a.yellow(`${f} ${m}`):`${f} ${m}`,`${p} info`].join(`, `);d>0?(r(a.red(`${h} — fix critical issues before deploying`)),process.exit(1)):r(a.green(`${h} — looking good!`))})}async function Q(e){return Ze({configPath:E.resolve(process.cwd(),e.config)})}async function $(e){if(e.adapter){let t=await e.adapter();return{adapter:t,cleanup:async()=>t.close()}}if(!e.connectionString)throw Error(`kickjs-db: no adapter resolved — set db.connectionString (or DATABASE_URL) in kick.config.ts, or supply db.adapter() factory`);let t=e.dialect??`postgres`;if(t!==`postgres`)throw Error(`kickjs-db: built-in CLI adapter only supports postgres in M1 (dialect=${t}); use db.adapter() factory for other dialects`);let[{pgAdapter:n},r]=await Promise.all([import(`@forinda/kickjs-db-pg`),import(`pg`)]),i=new r.default.Pool({connectionString:e.connectionString}),a=n({pool:i});return{adapter:a,cleanup:async()=>{await a.close(),await i.end()}}}async function rr(e){if(e.adapter||(e.dialect??`postgres`)!==`postgres`||!e.connectionString)return null;let t=new(await(import(`pg`))).default.Pool({connectionString:e.connectionString});return{runner:t,cleanup:async()=>{await t.end()}}}function ir(e){if(e.length===0){console.log(`No migrations.`);return}console.table(e.map(e=>({id:e.id,state:e.state,batch:e.batch??`-`,reviewed:e.reviewed,applied:e.appliedAt??`-`})))}function ar(e){let t=e.command(`db`).description(`Database commands (kickjs-db)`);t.command(`generate <name>`).description(`Generate a new migration from schema diff`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).option(`-e, --empty`,`Skip schema diff and create an empty migration shell (data migration, seed, freeform SQL)`).action(async(e,t)=>{let n=process.cwd(),r=await Q(t),i=await rr(r),a=i?e=>Ue(i.runner,e):void 0;try{let i=await We({name:e,config:r,cwd:n,empty:t.empty,detectCompositeRefs:a});if(i.status===`no-changes`){console.log(`No schema changes detected.`);return}if(i.empty){console.log(`Created empty migration ${i.migrationDir} (author up.sql + down.sql).`);return}let o=i.changeCount===1?``:`s`;console.log(`Created migration ${i.migrationDir} (${i.changeCount} change${o}).`)}finally{await i?.cleanup()}});let n=t.command(`migrate`).description(`Migration runner subcommands`);n.command(`latest`).description(`Apply all pending migrations in a new batch`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).option(`--confirm-enum-drop`,"Allow migrations carrying the `-- KICK ENUM REMOVE` header to apply",!1).action(async e=>{let t=await Q(e),{adapter:n,cleanup:r}=await $(t);try{let r=await Ke({adapter:n,migrationsDir:t.migrationsDir,confirmEnumDrop:e.confirmEnumDrop});r.applied.length===0?console.log(`No pending migrations.`):console.log(`Applied batch ${r.batch}: ${r.applied.join(`, `)}`)}finally{await r()}}),n.command(`up`).description(`Apply the next single pending migration`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).option(`--confirm-enum-drop`,"Allow migrations carrying the `-- KICK ENUM REMOVE` header to apply",!1).action(async e=>{let t=await Q(e),{adapter:n,cleanup:r}=await $(t);try{let r=await Ye({adapter:n,migrationsDir:t.migrationsDir,confirmEnumDrop:e.confirmEnumDrop});r.applied.length===0?console.log(`No pending migrations.`):console.log(`Applied ${r.applied[0]} (batch ${r.batch})`)}finally{await r()}}),n.command(`down`).description(`Reverse the most recent applied migration`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).action(async e=>{let t=await Q(e),{adapter:n,cleanup:r}=await $(t);try{let e=await Ge({adapter:n,migrationsDir:t.migrationsDir});e.reversed?console.log(`Reversed ${e.reversed}.`):console.log(`Nothing to reverse.`)}finally{await r()}}),n.command(`rollback`).description(`Reverse the entire last batch as a single unit`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).action(async e=>{let t=await Q(e),{adapter:n,cleanup:r}=await $(t);try{let e=await qe({adapter:n,migrationsDir:t.migrationsDir});e.reversed.length===0?console.log(`Nothing to roll back.`):console.log(`Rolled back batch ${e.batch}: ${e.reversed.join(`, `)}`)}finally{await r()}}),n.command(`status`).description(`Print applied + pending migrations`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).action(async e=>{let t=await Q(e),{adapter:n,cleanup:r}=await $(t);try{ir(await Je({adapter:n,migrationsDir:t.migrationsDir}))}finally{await r()}}),t.command(`introspect`).description(`Generate a TypeScript schema file from a live database`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).option(`--out <path>`,`Output file (defaults to db.schemaPath from config)`).option(`--json`,`Print the raw SchemaSnapshot JSON to stdout instead of writing TS source`).action(async e=>{let t=await Q(e),{adapter:n,cleanup:r}=await $(t);try{let r=await n.introspect();if(e.json){console.log(JSON.stringify(r,null,2));return}let i=e.out??t.schemaPath;await I(i,Xe(r),`utf8`);let a=Object.keys(r.tables).length;console.log(`Wrote ${i} (${a} table${a===1?``:`s`}).`)}finally{await r()}})}function or(e){return e.optsWithGlobals().dryRun??!1}function sr(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.
|
|
863
863
|
Direction defaults to \`modules.style\` from kick.config (or "define").
|
|
864
864
|
--target define|class Override the migration direction.
|
|
865
865
|
--apply Apply the changes (default: dry-run preview).
|
|
866
|
-
--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=
|
|
867
|
-
`+
|
|
866
|
+
--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=or(t)||!e.apply;p(n),e.experimental||(console.error(`
|
|
867
|
+
`+a.red(`Error:`)+` kick codemod modules is experimental — pass --experimental to acknowledge.
|
|
868
868
|
The regex-based rewrite handles the shapes our templates produce.
|
|
869
869
|
Hand-rolled modules with non-standard structures may be skipped.
|
|
870
870
|
Always commit before running with --apply.
|
|
871
|
-
`),process.exit(1));let r=
|
|
872
|
-
`)}});function
|
|
871
|
+
`),process.exit(1));let r=S(await C(process.cwd())),i=A(e.modulesDir??r.dir??`src/modules`),o;e.target===`define`||e.target===`class`?o=e.target:e.target===void 0?o=r.style??`define`:(console.error(`\n ${a.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let s=a.dim(`→ ${o}`),c=n?a.dim(`(dry-run)`):a.bold(`(applying)`);console.log(`\n ${a.bold(`kick codemod modules`)} ${s} ${c}`),console.log(` modulesDir: ${a.dim(i)}\n`);let l=e.backup!==!1&&!n,u=await yt(i,{dryRun:n,target:o,backup:l});if(u.backupDir){let e=u.backupDir;console.log(` ${a.green(`✓`)} backup: ${a.dim(e)}\n ${a.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else !n&&e.backup===!1&&console.log(` ${a.dim(`(--no-backup — skipping snapshot)`)}\n`);let d=0,f=0;for(let e of u.files)if(e.status===`migrated`)d++,console.log(` ${a.green(`✓`)} ${e.path}`);else{f++;let t=a.dim(`(${e.reason??`skipped`})`);console.log(` ${a.dim(`-`)} ${e.path} ${t}`)}if(console.log(),u.indexStatus===`migrated`)console.log(` ${a.green(`✓`)} ${u.indexPath}`);else if(u.indexStatus===`skipped`){let e=a.dim(`(${u.indexReason??`skipped`})`);console.log(` ${a.dim(`-`)} ${u.indexPath} ${e}`)}else console.log(` ${a.dim(`-`)} ${u.indexPath} ${a.dim(`(not found)`)}`);let m=n?a.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n ${a.bold(String(d))} migrated, ${a.bold(String(f))} skipped${m}\n`)})}const cr=[`src/db/schema.ts`,`src/db/schema/index.ts`,`src/db/schema`],lr=()=>({id:`kick/db`,inputs:[`src/db/schema.ts`,`src/db/schema/**/*.ts`],async generate(e){let t=ur(e.cwd);if(!t)return null;let n=E.resolve(e.cwd,`.kickjs/types`);return[`import type { SchemaToTypes, SchemaToRelationsRegister, KickDbClient } from '@forinda/kickjs-db'`,`import type * as appSchema from '${dr(E.relative(n,t)).replace(/\.ts$/,``).replace(/\/index$/,``)}'`,``,`declare global {`,` interface KickDbSchema extends SchemaToTypes<typeof appSchema> {}`,`}`,``,`declare module '@forinda/kickjs-db' {`,` interface KickDbRegister {`,` db: KickDbClient<KickDbSchema>`,` }`,``,` interface KickDbRelationsRegister {`,` db: SchemaToRelationsRegister<typeof appSchema>`,` }`,`}`].join(`
|
|
872
|
+
`)}});function ur(e){for(let t of cr){let n=E.resolve(e,t);if(t.endsWith(`.ts`)){if(M(n))return n}else{let e=E.join(n,`index.ts`);if(M(e))return e}}return null}function dr(e){return e.replace(/\\/g,`/`)}const fr=()=>({id:`kick/assets`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`],async generate(e){if(!M(E.resolve(e.cwd,`kick.config.ts`)))return null;let t=await C(e.cwd);if(!t?.assetMap)return null;let n=ge(t.assetMap,e.cwd);return n.count===0?null:be(n)}}),pr="/* 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 mr(e,t,n){if(e.length===0)return`${pr}
|
|
873
873
|
// (no routes discovered yet — annotate a controller method with
|
|
874
874
|
// @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
|
|
875
875
|
declare global {
|
|
@@ -878,8 +878,8 @@ declare global {
|
|
|
878
878
|
}
|
|
879
879
|
|
|
880
880
|
export {}
|
|
881
|
-
`;let r=new Map;for(let t of e){let e=r.get(t.controller)??[];e.push(t),r.set(t.controller,e)}let i=new Map,a=(e,r)=>{let a=
|
|
882
|
-
`))}return`${
|
|
881
|
+
`;let r=new Map;for(let t of e){let e=r.get(t.controller)??[];e.push(t),r.set(t.controller,e)}let i=new Map,a=(e,r)=>{let a=_r(e,r,t,n,i);return a?`import('zod').infer<typeof ${a}>`:null},o=[];for(let[e,t]of r){let n=[` interface ${e} {`];for(let e of t){let t=e.pathParams.length>0?`{ ${e.pathParams.map(e=>`${e}: string`).join(`; `)} }`:`{}`,r=a(e.bodySchema,e.filePath),i=a(e.querySchema,e.filePath),o=a(e.paramsSchema,e.filePath)??t,s=r??`unknown`,c=i??hr(e),l=gr(e);n.push(` /**`,` * ${e.httpMethod} ${e.path}`,...l.map(e=>` * ${e}`),` */`,` ${e.method}: {`,` params: ${o}`,` body: ${s}`,` query: ${c}`,` response: unknown`,` }`)}n.push(` }`),o.push(n.join(`
|
|
882
|
+
`))}return`${pr}${vr(i)}
|
|
883
883
|
declare global {
|
|
884
884
|
// eslint-disable-next-line @typescript-eslint/no-namespace
|
|
885
885
|
namespace KickRoutes {
|
|
@@ -889,9 +889,9 @@ ${o.join(`
|
|
|
889
889
|
}
|
|
890
890
|
|
|
891
891
|
export {}
|
|
892
|
-
`}function
|
|
892
|
+
`}function hr(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 gr(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 _r(e,t,n,r,i){if(!e||r!==`zod`||e.source===null)return null;let a=yr(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 vr(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(`
|
|
893
893
|
`)+`
|
|
894
|
-
`}function
|
|
894
|
+
`}function yr(e,t,n){if(e===null)return`unknown`;let r=D(n);if(e===``){let e=k(r,t).split(j).join(`/`);return e=e.replace(/\.(ts|tsx|mts|cts)$/i,``),e.startsWith(`.`)||(e=`./`+e),e}if(!e.startsWith(`.`)&&!e.startsWith(`/`))return e;let i=k(r,A(D(t),e)).split(j).join(`/`);return i=i.replace(/\.(ts|tsx|mts|cts)$/i,``),i.startsWith(`.`)||(i=`./`+i),i}const br=()=>({id:`kick/routes`,outExtension:`.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){let t=await e.getScanResult({root:xr(e),cwd:e.cwd,envFile:Sr(e)}),n=e.config?.typegen?.schemaValidator??`zod`,r=E.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return mr(t.routes,r,n)}});function xr(e){return E.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Sr(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function Cr(e,t){if(!e)return null;let n=k(D(t),e.filePath).split(j).join(`/`);return n=n.replace(/\.(ts|tsx|mts|cts)$/i,``),n.startsWith(`.`)||(n=`./`+n),`/* eslint-disable */
|
|
895
895
|
// AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
|
|
896
896
|
// Re-run with \`kick typegen\` or rely on \`kick dev\` to refresh.
|
|
897
897
|
|
|
@@ -927,5 +927,5 @@ declare global {
|
|
|
927
927
|
}
|
|
928
928
|
|
|
929
929
|
export {}
|
|
930
|
-
`}const
|
|
931
|
-
//# sourceMappingURL=run-plugins-
|
|
930
|
+
`}const wr=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=Er(e);if(t===!1)return null;let n=await e.getScanResult({root:Tr(e),cwd:e.cwd,envFile:t});if(!n.env)return null;let r=E.resolve(e.cwd,`.kickjs/types/kick__env.ts`);return Cr(n.env,r)}});function Tr(e){return E.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Er(e){return e.config?.typegen?.envFile}const Dr=[w({name:`kick/init`,register:st}),w({name:`kick/generate`,register:Ut}),w({name:`kick/run`,register:nn}),w({name:`kick/info`,register:rn}),w({name:`kick/inspect`,register:fn}),w({name:`kick/add`,register:at}),w({name:`kick/list`,register:it}),w({name:`kick/explain`,register:Sn}),w({name:`kick/mcp`,register:jn}),w({name:`kick/tinker`,register:Fn}),w({name:`kick/remove`,register:Vn}),w({name:`kick/typegen`,register:Wn}),w({name:`kick/check`,register:nr}),w({name:`kick/db`,register:ar,typegens:[lr()]}),w({name:`kick/codemod`,register:sr}),w({name:`kick/assets`,typegens:[fr()]}),w({name:`kick/routes`,typegens:[br()]}),w({name:`kick/env`,typegens:[wr()]})];export{Jt as applyDisableFilter,W as runAllPluginTypegens,Dr as t};
|
|
931
|
+
//# sourceMappingURL=run-plugins-D_jHPl16.mjs.map
|