@forinda/kickjs-cli 6.15.1 → 7.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{agent-docs-CpVNxPXD.mjs → agent-docs-ByLNah3Q.mjs} +2 -2
- package/dist/{agent-docs-DUcdJj9b.mjs → agent-docs-DpnGe5eB.mjs} +3 -3
- package/dist/{agent-docs-DUcdJj9b.mjs.map → agent-docs-DpnGe5eB.mjs.map} +1 -1
- package/dist/{build-CQl0YJbD.mjs → build-BhHgwfnn.mjs} +3 -3
- package/dist/{build-CQl0YJbD.mjs.map → build-BhHgwfnn.mjs.map} +1 -1
- package/dist/{build-DfxdnjMV.mjs → build-kAS8vTgJ.mjs} +2 -2
- package/dist/{builtins-DXVb_-6f.mjs → builtins-C1AUhwra.mjs} +2 -2
- package/dist/{builtins-TOygGCrz.mjs → builtins-OqcjV5Ah.mjs} +161 -167
- package/dist/cli.mjs +2 -2
- package/dist/config-BpuK2U4H.mjs +13 -0
- package/dist/config-BpuK2U4H.mjs.map +1 -0
- package/dist/config-CAMuUYHB.mjs +12 -0
- package/dist/{doctor-CHB6rl5Q.mjs → doctor-CaxYeesL.mjs} +24 -29
- package/dist/doctor-CaxYeesL.mjs.map +1 -0
- package/dist/fullstack-CFb-_pLC.mjs +189 -0
- package/dist/fullstack-D6NhL_2E.mjs +190 -0
- package/dist/fullstack-D6NhL_2E.mjs.map +1 -0
- package/dist/index.d.mts +42 -22
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +2 -2
- package/dist/{plugin-CmoOrd3O.mjs → plugin-B5cTyUvL.mjs} +3 -3
- package/dist/{plugin-CmoOrd3O.mjs.map → plugin-B5cTyUvL.mjs.map} +1 -1
- package/dist/{plugin-Y-IVgvlu.mjs → plugin-DLmjmJ0w.mjs} +2 -2
- package/dist/{project-CKN4-nV4.mjs → project-DYUMUXFZ.mjs} +22 -13
- package/dist/{project-docs-m3jPVPAH.mjs → project-docs-BCQIwKnL.mjs} +5 -5
- package/dist/{project-docs-rYxsjZzT.mjs → project-docs-BVwzaWxS.mjs} +6 -6
- package/dist/project-docs-BVwzaWxS.mjs.map +1 -0
- package/dist/{project-root-Aq5DOz-j.mjs → project-root-De_nJub0.mjs} +3 -3
- package/dist/{project-root-Aq5DOz-j.mjs.map → project-root-De_nJub0.mjs.map} +1 -1
- package/dist/{project-root-CAM62woQ.mjs → project-root-DxxK-sLA.mjs} +2 -2
- package/dist/{project-mSo3W3zE.mjs → project-y3fadrjc.mjs} +24 -15
- package/dist/project-y3fadrjc.mjs.map +1 -0
- package/dist/{prompts-CQQjtoKB.mjs → prompts-BMOJYPvM.mjs} +2 -2
- package/dist/{prompts-CQQjtoKB.mjs.map → prompts-BMOJYPvM.mjs.map} +1 -1
- package/dist/{rolldown-runtime-Pz0cqJu0.mjs → rolldown-runtime-qj3ktXfH.mjs} +1 -1
- package/dist/{run-plugins-DBnVyuyi.mjs → run-plugins-UrVjs36R.mjs} +128 -129
- package/dist/run-plugins-UrVjs36R.mjs.map +1 -0
- package/dist/{typegen-DpENVFpt.mjs → typegen-C0-zbJ7C.mjs} +4 -4
- package/dist/{typegen-lmpEgt9z.mjs → typegen-C2eQNnoa.mjs} +5 -5
- package/dist/{typegen-lmpEgt9z.mjs.map → typegen-C2eQNnoa.mjs.map} +1 -1
- package/dist/{types-BQOKyLP8.mjs → types-8TVtHOJr.mjs} +1 -1
- package/package.json +3 -3
- package/dist/config-CKBLLO-j.mjs +0 -13
- package/dist/config-CKBLLO-j.mjs.map +0 -1
- package/dist/config-Ot0ZhGQi.mjs +0 -12
- package/dist/doctor-CHB6rl5Q.mjs.map +0 -1
- package/dist/fullstack-CS9vKXOa.mjs +0 -137
- package/dist/fullstack-D1YuNkEe.mjs +0 -138
- package/dist/fullstack-D1YuNkEe.mjs.map +0 -1
- package/dist/project-docs-rYxsjZzT.mjs.map +0 -1
- package/dist/project-mSo3W3zE.mjs.map +0 -1
- package/dist/run-plugins-DBnVyuyi.mjs.map +0 -1
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs-cli
|
|
2
|
+
* @forinda/kickjs-cli v7.0.1
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{t as e}from"./rolldown-runtime-
|
|
11
|
+
import{t as e}from"./rolldown-runtime-qj3ktXfH.mjs";import{a as t,c as n,i as r,o as i,r as a,s as o,t as s,u as c}from"./project-DYUMUXFZ.mjs";import{a as l,i as u,o as d,r as f,s as p}from"./config-CAMuUYHB.mjs";import{n as m,r as h}from"./plugin-DLmjmJ0w.mjs";import{c as g,l as _,s as v}from"./project-docs-BCQIwKnL.mjs";import{a as y,c as b,d as ee,f as x,i as te,l as ne,n as re,o as ie,p as ae,r as S,s as C,u as oe}from"./agent-docs-ByLNah3Q.mjs";import{t as se}from"./project-root-DxxK-sLA.mjs";import{a as ce,c as le,d as ue,f as de,g as fe,h as pe,i as me,l as he,m as ge,o as _e,p as ve,r as ye,s as be,t as xe,u as Se}from"./typegen-C0-zbJ7C.mjs";import{t as Ce}from"./build-kAS8vTgJ.mjs";import{createRequire as we}from"node:module";import{cpSync as Te,existsSync as w,mkdirSync as Ee,readFileSync as T,readdirSync as E,rmSync as De,statSync as Oe,writeFileSync as ke}from"node:fs";import D,{basename as Ae,dirname as O,join as k,relative as A,resolve as j,sep as je}from"node:path";import{fileURLToPath as Me,pathToFileURL as M}from"node:url";import{fork as Ne,spawn as Pe,spawnSync as Fe}from"node:child_process";import{copyFile as Ie,mkdir as Le,readFile as N,readdir as Re,rm as ze,stat as Be,writeFile as P}from"node:fs/promises";import"@forinda/kickjs-cli-kit";import Ve from"pluralize";import{arch as He,platform as Ue,release as We}from"node:os";import{createHash as Ge}from"node:crypto";const Ke=[{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 qe(e){e.command(`new [name]`).alias(`init`).description(`Create a new KickJS project (use "." for current directory)`).option(`-d, --directory <dir>`,`Target directory (defaults to project name)`).option(`--pm <manager>`,`Package manager: pnpm | npm | yarn | bun`).option(`--git`,`Initialize git repository`).option(`--no-git`,`Skip git initialization`).option(`--install`,`Install dependencies after scaffolding`).option(`--no-install`,`Skip dependency installation`).option(`-f, --force`,`Remove existing files without prompting`).option(`-t, --template <type>`,`Project template: rest | minimal | fullstack`).option(`--runtime <engine>`,`HTTP runtime: express | fastify | h3`).option(`-r, --repo <type>`,`Repository name (inmemory, or any DB name e.g. postgres)`).option(`-s, --schema <lib>`,`Schema library for env / DTOs: zod | valibot | yup (default: zod)`).option(`--packages <packages>`,`Comma-separated packages to include (e.g. 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)=>{te(`KickJS — Create a new project`);let r=!!(t.yes||t.nonInteractive);e||=r?`my-api`:await oe({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let i;if(e===`.`?(i=j(`.`),e=Ae(i)):i=j(t.directory||e),w(i)){let n=E(i);if(n.length>0){if(t.force)y.warn(`Clearing existing files in ${i}`);else if(r){y.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),C(`Aborted.`);return}else{y.warn(`Directory "${e}" is not empty:`);let t=n.slice(0,5);for(let e of t)y.message(` - ${e}`);if(n.length>5&&y.message(` ... and ${n.length-5} more`),!await S({message:x.red(`Remove all existing files and proceed?`),initialValue:!1})){C(`Aborted.`);return}}for(let e of n)De(j(i,e),{recursive:!0,force:!0})}}let a=t.template;a||=r?`minimal`:await b({message:`Project template`,options:[{value:`rest`,label:`REST API`,hint:`Express + Swagger`},{value:`minimal`,label:`Minimal`,hint:`bare Express`},{value:`fullstack`,label:`Fullstack`,hint:`server + Vite React web, typed client`}]});let o=t.runtime;o||=r?`express`:await b({message:`HTTP runtime`,options:[{value:`express`,label:`Express`,hint:`default, zero-config`},{value:`fastify`,label:`Fastify`,hint:`fastify + @fastify/middie`},{value:`h3`,label:`h3`,hint:`Nitro / Nuxt engine`}]});let c=t.pm;c||=r?await n(void 0):await b({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let l=t.repo;l||=r?`inmemory`:await oe({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),p(l);let u=t.schema;u||=r?`zod`:await b({message:`Schema library (env + DTO validation)`,options:[{value:`zod`,label:`Zod`,hint:`default — broad ecosystem`},{value:`valibot`,label:`Valibot`,hint:`smaller bundle`},{value:`yup`,label:`Yup`,hint:`classic API`}]}),[`zod`,`valibot`,`yup`].includes(u)||(y.warn(`Unknown --schema "${u}", falling back to zod.`),u=`zod`);let d;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();d=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else d=r?[]:await ie({message:`Select packages to include`,options:[...Ke],required:!1});let f;f=t.git===void 0?r?!0:await S({message:`Initialize git repository?`,initialValue:!0}):t.git;let m;if(m=t.install===void 0?r?!0:await S({message:`Install dependencies?`,initialValue:!0}):t.install,a===`fullstack`){let{initFullstackProject:t}=await import(`./fullstack-CFb-_pLC.mjs`);await t({name:e,directory:i,packageManager:c,initGit:f,installDeps:m,schemaLib:u,runtime:o}),C(`Done! Next steps: ${x.cyan(`cd ${e} && ${c}${c===`pnpm`?` dev`:` run dev:server`}`)}`);return}await s({name:e,directory:i,packageManager:c,initGit:f,installDeps:m,template:a,defaultRepo:l,packages:d,schemaLib:u,runtime:o}),C(`Done! Next steps: ${x.cyan(`cd ${e} && ${c} dev`)}`)})}function F(e){return e.replace(/[-_\s]+(.)?/g,(e,t)=>t?t.toUpperCase():``).replace(/^(.)/,e=>e.toUpperCase())}function I(e){let t=F(e);return t.charAt(0).toLowerCase()+t.slice(1)}function L(e){return e.replace(/([a-z])([A-Z])/g,`$1-$2`).replace(/[\s_]+/g,`-`).toLowerCase()}function R(e){return Ve.plural(e)}function Je(e){return Ve.plural(e)}function Ye(e){return L(e).replace(/-/g,`_`)}function Xe(e){let t=e.cwd??process.cwd(),n=e.projectRoot??se(t),r=e.pluralize??!0,i=F(e.name),a=I(e.name),o=L(e.name),s=Ye(e.name),c={name:e.name,pascal:i,camel:a,kebab:o,snake:s,modulesDir:e.modulesDir??`src/modules`,cwd:t,projectRoot:n,args:e.args??[],flags:e.flags??{}};if(r){let e=R(o);c.pluralKebab=e,c.pluralPascal=F(e),c.pluralCamel=I(e)}return c}function Ze(e,t){return j(e.cwd,t)}async function Qe(e){return import(M(e).href)}const $e=new Map;async function et(e){let t=$e.get(e);if(t)return t;let n=tt(e);return $e.set(e,n),n}async function tt(e){let t=j(e,`package.json`);if(!w(t))return{generators:[],loaded:[],failed:[]};let n=nt(JSON.parse(await N(t,`utf-8`))),r=we(j(e,`package.json`)),i=[],a=[],o=[];for(let e of n){let t;try{t=r.resolve(`${e}/package.json`)}catch{continue}let n;try{n=JSON.parse(await N(t,`utf-8`))}catch(t){o.push({source:e,reason:`failed to parse package.json: ${t}`});continue}if(!n.kickjs?.generators)continue;let s=n.kickjs.generators,c=j(O(t),s);if(!w(c)){o.push({source:e,reason:`kickjs.generators points to missing file: ${s}`});continue}let l;try{l=await Qe(c)}catch(t){o.push({source:e,reason:`failed to import manifest: ${t}`});continue}let u=l.default;if(!Array.isArray(u)){o.push({source:e,reason:`manifest's default export is not an array of GeneratorSpec`});continue}for(let t of u){if(!rt(t)){o.push({source:e,reason:`manifest entry is not a valid GeneratorSpec (missing name/files)`});continue}i.push({source:e,spec:t})}a.push(e)}return{generators:i,loaded:a,failed:o}}function nt(e){let t=new Set;for(let n of[e.dependencies,e.devDependencies,e.peerDependencies])if(n)for(let e of Object.keys(n))t.add(e);return Array.from(t)}function rt(e){if(!e||typeof e!=`object`)return!1;let t=e;return typeof t.name==`string`&&typeof t.files==`function`}async function it(e,t=[]){let n=e.cwd??process.cwd(),r=t.find(t=>t.spec.name===e.generatorName);if(r)return st(r.spec,r.source,e,n);let i=ot(await et(n),e.generatorName);return i?st(i.spec,i.source,e,n):null}async function at(e,t=[]){let n=await et(e),r=new Set(t.map(e=>e.spec.name)),i=n.generators.filter(e=>!r.has(e.spec.name));return{generators:[...t,...i],loaded:n.loaded,failed:n.failed}}function ot(e,t){return e.generators.find(e=>e.spec.name===t)}async function st(e,t,n,r){let i=Xe({name:n.itemName,args:n.args,flags:n.flags,modulesDir:n.modulesDir,pluralize:n.pluralize,cwd:r,projectRoot:n.projectRoot}),a=await e.files(i),o=[];for(let e of a){let t=Ze(i,e.path);await _(t,e.content),o.push(t)}return{files:o,source:t}}function z(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}function ct(e){return e.charAt(0).toUpperCase()+e.slice(1).replace(/-([a-z])/g,(e,t)=>t.toUpperCase())}function lt(e){return e.replace(/([a-z])([A-Z])/g,`$1-$2`).toLowerCase()}function ut(e,t,n){let r={inmemory:`InMemory${e}Repository`,drizzle:`Drizzle${e}Repository`,prisma:`Prisma${e}Repository`},i={inmemory:`in-memory-${t}`,drizzle:`drizzle-${t}`,prisma:`prisma-${t}`};return{repoClass:r[n]??`${ct(n)}${e}Repository`,repoFile:i[n]??`${lt(n)}-${t}`}}function dt(e){return e??`define`}function ft(e){let{pascal:t,kebab:n,plural:r=``,repo:i,style:a}=e,{repoClass:o,repoFile:s}=ut(t,n,i),c=dt(a),l=`/**
|
|
12
12
|
* ${t} Module
|
|
13
13
|
*
|
|
14
14
|
* REST module with a flat folder structure.
|
|
@@ -85,7 +85,7 @@ ${d}
|
|
|
85
85
|
},
|
|
86
86
|
}),
|
|
87
87
|
})
|
|
88
|
-
`}function
|
|
88
|
+
`}function pt(e){let{pascal:t,kebab:n,plural:r=``,style:i}=e,a=dt(i),o=` /**
|
|
89
89
|
* Declare HTTP routes. Return value shape:
|
|
90
90
|
*
|
|
91
91
|
* - \`path\` — URL prefix for this route set.
|
|
@@ -125,7 +125,8 @@ ${o}
|
|
|
125
125
|
},
|
|
126
126
|
}),
|
|
127
127
|
})
|
|
128
|
-
`}function
|
|
128
|
+
`}function mt(e){let{pascal:t,kebab:n}=e,r=e.swagger?`import { ApiTags } from '@forinda/kickjs-swagger'
|
|
129
|
+
`:``,i=e.swagger?` @ApiTags('${e.pascal}')\n`:``,a=t.charAt(0).toLowerCase()+t.slice(1);return`import {
|
|
129
130
|
Controller,
|
|
130
131
|
Get,
|
|
131
132
|
Post,
|
|
@@ -136,8 +137,7 @@ ${o}
|
|
|
136
137
|
reply,
|
|
137
138
|
type Ctx,
|
|
138
139
|
} from '@forinda/kickjs'
|
|
139
|
-
import {
|
|
140
|
-
import { ${t}Service } from './${n}.service'
|
|
140
|
+
${r}import { ${t}Service } from './${n}.service'
|
|
141
141
|
import { create${t}Schema } from './dtos/create-${n}.dto'
|
|
142
142
|
import { update${t}Schema } from './dtos/update-${n}.dto'
|
|
143
143
|
import { ${t.toUpperCase()}_QUERY_CONFIG } from './${n}.constants'
|
|
@@ -158,22 +158,20 @@ import { ${t.toUpperCase()}_QUERY_CONFIG } from './${n}.constants'
|
|
|
158
158
|
|
|
159
159
|
@Controller()
|
|
160
160
|
export class ${t}Controller {
|
|
161
|
-
@Autowired() private readonly ${
|
|
161
|
+
@Autowired() private readonly ${a}Service!: ${t}Service
|
|
162
162
|
|
|
163
163
|
@Get('/')
|
|
164
|
-
@
|
|
165
|
-
@ApiQueryParams(${t.toUpperCase()}_QUERY_CONFIG)
|
|
164
|
+
${i} @ApiQueryParams(${t.toUpperCase()}_QUERY_CONFIG)
|
|
166
165
|
async list(ctx: Ctx<KickRoutes.${t}Controller['list']>) {
|
|
167
166
|
return ctx.paginate(
|
|
168
|
-
(parsed) => this.${
|
|
167
|
+
(parsed) => this.${a}Service.findPaginated(parsed),
|
|
169
168
|
${t.toUpperCase()}_QUERY_CONFIG,
|
|
170
169
|
)
|
|
171
170
|
}
|
|
172
171
|
|
|
173
172
|
@Get('/:id')
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
const result = await this.${r}Service.findById(ctx.params.id)
|
|
173
|
+
${i} async getById(ctx: Ctx<KickRoutes.${t}Controller['getById']>) {
|
|
174
|
+
const result = await this.${a}Service.findById(ctx.params.id)
|
|
177
175
|
if (!result) {
|
|
178
176
|
// Sends RFC 9457 problem+json now; returning nothing keeps the 404 out
|
|
179
177
|
// of this route's inferred response type.
|
|
@@ -184,25 +182,22 @@ export class ${t}Controller {
|
|
|
184
182
|
}
|
|
185
183
|
|
|
186
184
|
@Post('/', { body: create${t}Schema, name: 'Create${t}' })
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
return reply.created(await this.${r}Service.create(ctx.body))
|
|
185
|
+
${i} async create(ctx: Ctx<KickRoutes.${t}Controller['create']>) {
|
|
186
|
+
return reply.created(await this.${a}Service.create(ctx.body))
|
|
190
187
|
}
|
|
191
188
|
|
|
192
189
|
@Put('/:id', { body: update${t}Schema, name: 'Update${t}' })
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
return this.${r}Service.update(ctx.params.id, ctx.body)
|
|
190
|
+
${i} async update(ctx: Ctx<KickRoutes.${t}Controller['update']>) {
|
|
191
|
+
return this.${a}Service.update(ctx.params.id, ctx.body)
|
|
196
192
|
}
|
|
197
193
|
|
|
198
194
|
@Delete('/:id')
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
await this.${r}Service.delete(ctx.params.id)
|
|
195
|
+
${i} async remove(ctx: Ctx<KickRoutes.${t}Controller['remove']>) {
|
|
196
|
+
await this.${a}Service.delete(ctx.params.id)
|
|
202
197
|
return reply.noContent()
|
|
203
198
|
}
|
|
204
199
|
}
|
|
205
|
-
`}function
|
|
200
|
+
`}function ht(e){let{pascal:t}=e;return`import { z } from 'zod'
|
|
206
201
|
|
|
207
202
|
/**
|
|
208
203
|
* Create ${t} DTO — Zod schema for validating POST request bodies.
|
|
@@ -218,20 +213,20 @@ export const create${t}Schema = z.object({
|
|
|
218
213
|
})
|
|
219
214
|
|
|
220
215
|
export type Create${t}DTO = z.infer<typeof create${t}Schema>
|
|
221
|
-
`}function
|
|
216
|
+
`}function gt(e){let{pascal:t}=e;return`import { z } from 'zod'
|
|
222
217
|
|
|
223
218
|
export const update${t}Schema = z.object({
|
|
224
219
|
name: z.string().min(1).max(200).optional(),
|
|
225
220
|
})
|
|
226
221
|
|
|
227
222
|
export type Update${t}DTO = z.infer<typeof update${t}Schema>
|
|
228
|
-
`}function
|
|
223
|
+
`}function _t(e){let{pascal:t}=e;return`export interface ${t}ResponseDTO {
|
|
229
224
|
id: string
|
|
230
225
|
name: string
|
|
231
226
|
createdAt: string
|
|
232
227
|
updatedAt: string
|
|
233
228
|
}
|
|
234
|
-
`}function
|
|
229
|
+
`}function vt(e){let{pascal:t,kebab:n,dtoPrefix:r=`../../application/dtos`,tokenScope:i=`app`}=e;return`/**
|
|
235
230
|
* ${t} Repository Interface
|
|
236
231
|
*
|
|
237
232
|
* Defines the contract for data access.
|
|
@@ -266,7 +261,7 @@ export interface I${t}Repository {
|
|
|
266
261
|
* adopters must NOT use the reserved \`'kick/'\` namespace.
|
|
267
262
|
*/
|
|
268
263
|
export const ${t.toUpperCase()}_REPOSITORY = createToken<I${t}Repository>('${i}/${t}/repository')
|
|
269
|
-
`}function
|
|
264
|
+
`}function yt(e){let{pascal:t,kebab:n,repoPrefix:r=`../../domain/repositories`,dtoPrefix:i=`../../application/dtos`}=e;return`/**
|
|
270
265
|
* In-Memory ${t} Repository
|
|
271
266
|
*
|
|
272
267
|
* Implements the repository interface using a Map.
|
|
@@ -326,7 +321,7 @@ export class InMemory${t}Repository implements I${t}Repository {
|
|
|
326
321
|
this.store.delete(id)
|
|
327
322
|
}
|
|
328
323
|
}
|
|
329
|
-
`}function
|
|
324
|
+
`}function bt(e){let{pascal:t,kebab:n,repoType:r=``,repoPrefix:i=`../../domain/repositories`,dtoPrefix:a=`../../application/dtos`}=e,o=r.charAt(0).toUpperCase()+r.slice(1).replace(/-([a-z])/g,(e,t)=>t.toUpperCase());return`/**
|
|
330
325
|
* ${o} ${t} Repository
|
|
331
326
|
*
|
|
332
327
|
* Stub implementation for a custom '${r}' repository.
|
|
@@ -395,7 +390,7 @@ export class ${o}${t}Repository implements I${t}Repository {
|
|
|
395
390
|
this.store.delete(id)
|
|
396
391
|
}
|
|
397
392
|
}
|
|
398
|
-
`}function
|
|
393
|
+
`}function xt(e){let{pascal:t,kebab:n,plural:r=``}=e;return`import { describe, it, expect, beforeEach } from 'vitest'
|
|
399
394
|
import { Container } from '@forinda/kickjs'
|
|
400
395
|
|
|
401
396
|
describe('${t}Controller', () => {
|
|
@@ -447,7 +442,7 @@ describe('${t}Controller', () => {
|
|
|
447
442
|
})
|
|
448
443
|
})
|
|
449
444
|
})
|
|
450
|
-
`}function
|
|
445
|
+
`}function St(e){let{pascal:t,kebab:n,plural:r=``,repoPrefix:i=`../infrastructure/repositories/in-memory-${n}.repository`}=e;return`import { describe, it, expect, beforeEach } from 'vitest'
|
|
451
446
|
import { InMemory${t}Repository } from '${i}'
|
|
452
447
|
|
|
453
448
|
describe('InMemory${t}Repository', () => {
|
|
@@ -509,7 +504,7 @@ describe('InMemory${t}Repository', () => {
|
|
|
509
504
|
expect(found).toBeNull()
|
|
510
505
|
})
|
|
511
506
|
})
|
|
512
|
-
`}function
|
|
507
|
+
`}function Ct(e){let{pascal:t,kebab:n}=e;return`import { Service, Inject, HttpException } from '@forinda/kickjs'
|
|
513
508
|
import type { ParsedQuery } from '@forinda/kickjs'
|
|
514
509
|
import { ${t.toUpperCase()}_REPOSITORY, type I${t}Repository } from './${n}.repository'
|
|
515
510
|
import type { ${t}ResponseDTO } from './dtos/${n}-response.dto'
|
|
@@ -546,14 +541,14 @@ export class ${t}Service {
|
|
|
546
541
|
await this.repo.delete(id)
|
|
547
542
|
}
|
|
548
543
|
}
|
|
549
|
-
`}function
|
|
544
|
+
`}function wt(e){let{pascal:t}=e;return`import type { QueryFieldConfig } from '@forinda/kickjs'
|
|
550
545
|
|
|
551
546
|
export const ${t.toUpperCase()}_QUERY_CONFIG: QueryFieldConfig = {
|
|
552
547
|
filterable: ['name'],
|
|
553
548
|
sortable: ['name', 'createdAt'],
|
|
554
549
|
searchable: ['name'],
|
|
555
550
|
}
|
|
556
|
-
`}async function
|
|
551
|
+
`}async function Tt(e){let{pascal:t,kebab:n,plural:r,style:i,write:a}=e;await a(`${n}.module.ts`,pt({pascal:t,kebab:n,plural:r,style:i})),await a(`${n}.controller.ts`,`import { Controller, Get, Post, Put, Delete, reply, type Ctx } from '@forinda/kickjs'
|
|
557
552
|
|
|
558
553
|
// \`Ctx<KickRoutes.${t}Controller['<method>']>\` is generated by
|
|
559
554
|
// \`kick typegen\` (auto-run on \`kick dev\`).
|
|
@@ -593,7 +588,7 @@ export class ${t}Controller {
|
|
|
593
588
|
return reply.noContent()
|
|
594
589
|
}
|
|
595
590
|
}
|
|
596
|
-
`)}async function
|
|
591
|
+
`)}async function Et(e){let{pascal:t,kebab:n,plural:r,pluralPascal:i,repo:a,noTests:o,tokenScope:s,style:c,write:l}=e,u=e.swagger??!1;await l(`${n}.module.ts`,ft({pascal:t,kebab:n,plural:r,repo:a,style:c})),await l(`${n}.constants.ts`,wt({pascal:t,kebab:n})),await l(`${n}.controller.ts`,mt({pascal:t,kebab:n,plural:r,pluralPascal:i,swagger:u})),await l(`${n}.service.ts`,Ct({pascal:t,kebab:n})),await l(`dtos/create-${n}.dto.ts`,ht({pascal:t,kebab:n})),await l(`dtos/update-${n}.dto.ts`,gt({pascal:t,kebab:n})),await l(`dtos/${n}-response.dto.ts`,_t({pascal:t,kebab:n})),await l(`${n}.repository.ts`,vt({pascal:t,kebab:n,dtoPrefix:`./dtos`,tokenScope:s}));let d=a===`inmemory`,f=d?`in-memory-${n}`:`${L(a)}-${n}`,p=d?yt({pascal:t,kebab:n,repoPrefix:`.`,dtoPrefix:`./dtos`}):bt({pascal:t,kebab:n,repoType:a,repoPrefix:`.`,dtoPrefix:`./dtos`});await l(`${f}.repository.ts`,p),o||(a!==`inmemory`&&await l(`in-memory-${n}.repository.ts`,yt({pascal:t,kebab:n,repoPrefix:`.`,dtoPrefix:`./dtos`})),await l(`__tests__/${n}.controller.test.ts`,xt({pascal:t,kebab:n,plural:r})),await l(`__tests__/${n}.repository.test.ts`,St({pascal:t,kebab:n,plural:r,repoPrefix:`../in-memory-${n}.repository`})))}function Dt(e){return e?typeof e==`string`?e:e.name:`inmemory`}async function Ot(e){let{name:t,modulesDir:n,noEntity:r,noTests:i,repo:a=`inmemory`,force:o,dryRun:s}=e,c=e.pluralize!==!1,l=e.pattern??`rest`;e.minimal&&(l=`minimal`);let u=L(t),d=F(t),f=c?R(u):u,p=c?Je(d):d,m=k(n,f),h=[],g=o??!1,b={kebab:u,pascal:d,plural:f,pluralPascal:p,moduleDir:m,repo:a,noEntity:r??!1,noTests:i??!1,tokenScope:e.tokenScope??`app`,swagger:e.swagger??!1,style:e.style??`define`,write:async(e,t)=>{let n=k(m,e);if(s){h.push(n);return}if(!g&&await v(n)&&!await S({message:`File exists: ${x.dim(e)}. Overwrite?`,initialValue:!1})){y.warn(`Skipped: ${e}`);return}await _(n,t),h.push(n)},files:h};switch(l){case`minimal`:await Tt(b);break;default:await Et(b);break}return s||await kt(n,d,f,u,b.style),h}async function kt(e,t,n,r,i=`define`){let a=k(e,`index.ts`),o=await v(a),s=`./${n}/${r}.module`,c=i===`class`?`${t}Module`:`${t}Module()`;if(!o){await _(a,i===`class`?`import type { AppModuleEntry } from '@forinda/kickjs'
|
|
597
592
|
import { ${t}Module } from '${s}'
|
|
598
593
|
|
|
599
594
|
export const modules: AppModuleEntry[] = [${c}]
|
|
@@ -604,8 +599,8 @@ export const modules = defineModules().mount(${c})
|
|
|
604
599
|
`);return}let l=await N(a,`utf-8`),u=`import { ${t}Module } from '${s}'`,d=z(s);if(!RegExp(`^import\\s*\\{[^}]*\\b${z(t)}Module\\b[^}]*\\}\\s*from\\s*['"]${d}['"]`,`m`).test(l)){let e=l.lastIndexOf(`import `);if(e!==-1){let t=l.indexOf(`
|
|
605
600
|
`,e);l=l.slice(0,t+1)+u+`
|
|
606
601
|
`+l.slice(t+1)}else l=u+`
|
|
607
|
-
`+l}let f=
|
|
608
|
-
`;)t++;return t}if(n===`/*`){for(t+=2;t+1<e.length&&(e[t]!==`*`||e[t+1]!==`/`);)t++;return t+2}return t}function
|
|
602
|
+
`+l}let f=jt(l);if(f){let e=l.slice(f.rhsStart,f.rhsEnd+1);RegExp(`\\b${z(t)}Module\\b`).test(e)||(l=At(l,c))}else l=At(l,c);await P(a,l,`utf-8`)}function At(e,t){let n=jt(e);if(!n)return e;if(n.shape===`array`){let r=e.slice(n.rhsStart+1,n.rhsEnd),i=r.trim(),a;if(!i)a=`[${t}]`;else{let e=i.endsWith(`,`)?``:`,`;a=`[${r.trimEnd()}${e} ${t}]`}return e.slice(0,n.rhsStart)+a+e.slice(n.rhsEnd+1)}return`${e.slice(0,n.chainEnd)}\n .mount(${t})${e.slice(n.chainEnd)}`}function jt(e){let t=/export\s+const\s+modules\b[^=]*=/.exec(e);if(!t)return null;let n=t.index+t[0].length;for(;n<e.length&&/\s/.test(e[n]??``);)n++;if(e[n]===`[`){let t=Pt(e,n);return t===-1?null:{shape:`array`,rhsStart:n,rhsEnd:t}}if(e.slice(n,n+13)===`defineModules`){let t=Mt(e,n);return t===-1?null:{shape:`chain`,rhsStart:n,rhsEnd:t-1,chainEnd:t}}return null}function Mt(e,t=0){let n=/defineModules\s*\(/g;n.lastIndex=t;let r=n.exec(e);if(!r)return-1;let i=r.index+r[0].length-1;if(e[i]!==`(`||(i=Ft(e,i),i===-1))return-1;for(i++;;){let t=i;for(;t<e.length&&/\s/.test(e[t]??``);)t++;if(e[t]!==`.`||e.slice(t,t+6)!==`.mount`)break;for(t+=6;t<e.length&&/\s/.test(e[t]??``);)t++;if(e[t]!==`(`)break;let n=Ft(e,t);if(n===-1)break;i=n+1}return i}function Nt(e,t){let n=e.slice(t,t+2);if(n===`//`){for(t+=2;t<e.length&&e[t]!==`
|
|
603
|
+
`;)t++;return t}if(n===`/*`){for(t+=2;t+1<e.length&&(e[t]!==`*`||e[t+1]!==`/`);)t++;return t+2}return t}function Pt(e,t){if(e[t]!==`[`)return-1;let n=1,r=t+1;for(;r<e.length;){let t=e.slice(r,r+2);if(t===`//`||t===`/*`){r=Nt(e,r);continue}let i=e[r]??``;if(i===`'`||i===`"`||i==="`"){let t=i;for(r++;r<e.length&&e[r]!==t;)e[r]===`\\`&&r++,r++;r<e.length&&r++;continue}if(i===`[`)n++;else if(i===`]`&&(n--,n===0))return r;r++}return-1}function Ft(e,t){if(e[t]!==`(`)return-1;let n=1,r=t+1;for(;r<e.length;){let t=e.slice(r,r+2);if(t===`//`||t===`/*`){r=Nt(e,r);continue}let i=e[r]??``;if(i===`'`||i===`"`||i==="`"){let t=i;for(r++;r<e.length&&e[r]!==t;)e[r]===`\\`&&r++,r++;r<e.length&&r++;continue}if(i===`(`)n++;else if(i===`)`&&(n--,n===0))return r;r++}return-1}async function It(e){let{name:t,outDir:n}=e,r=L(t),i=F(t),a=[],o=k(n,`${r}.adapter.ts`);return await _(o,`import {
|
|
609
604
|
defineAdapter,
|
|
610
605
|
type AdapterContext,
|
|
611
606
|
type AdapterMiddleware,
|
|
@@ -781,7 +776,7 @@ export const ${i}Adapter = defineAdapter<${i}AdapterConfig>({
|
|
|
781
776
|
}
|
|
782
777
|
},
|
|
783
778
|
})
|
|
784
|
-
`),a.push(o),a}async function
|
|
779
|
+
`),a.push(o),a}async function Lt(e){let{name:t,outDir:n}=e,r=L(t),i=F(t),a=[],o=k(n,`${r}.plugin.ts`);return await _(o,`import {
|
|
785
780
|
definePlugin,
|
|
786
781
|
type AppAdapter,
|
|
787
782
|
type AppModuleEntry,
|
|
@@ -927,8 +922,8 @@ export const ${i}Plugin = definePlugin<${i}PluginConfig>({
|
|
|
927
922
|
},
|
|
928
923
|
}),
|
|
929
924
|
})
|
|
930
|
-
`),a.push(o),a}const
|
|
931
|
-
// \`express\``:"this project declares no `runtime` in kick.config.ts, so it\n // may have no `express`",s=B({type:`middleware`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/middleware`,pattern:i,shouldPluralize:e.pluralize??!0}),c=L(t),l=I(t),u=[],d=k(s,`${c}.middleware.ts`);return await
|
|
925
|
+
`),a.push(o),a}const Rt={controller:``,service:``,dto:`dtos`,guard:`guards`,middleware:`middleware`,contributor:`contributors`};function B(e){let{type:t,outDir:n,moduleName:r,modulesDir:i=`src/modules`,defaultDir:a,shouldPluralize:o=!0}=e;if(n)return j(n);if(r){let e=Rt,n=L(r),a=o?R(n):n,s=e[t]??``,c=k(i,a);return j(s?k(c,s):c)}return j(a)}async function zt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=e.runtime===`express`,o=e.runtime?`this project runs on ${e.runtime} and has no
|
|
926
|
+
// \`express\``:"this project declares no `runtime` in kick.config.ts, so it\n // may have no `express`",s=B({type:`middleware`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/middleware`,pattern:i,shouldPluralize:e.pluralize??!0}),c=L(t),l=I(t),u=[],d=k(s,`${c}.middleware.ts`);return await _(d,`${a?`import type { Request, Response, NextFunction } from 'express'`:`import type { IncomingMessage, ServerResponse } from 'node:http'`}
|
|
932
927
|
|
|
933
928
|
export interface ${F(t)}Options {
|
|
934
929
|
// Add configuration options here. The factory below closes over the
|
|
@@ -983,7 +978,7 @@ ${a?" // Typed from `express` because that is this project's runtime\n // (`ru
|
|
|
983
978
|
next()
|
|
984
979
|
}
|
|
985
980
|
}
|
|
986
|
-
`),u.push(d),u}async function
|
|
981
|
+
`),u.push(d),u}async function Bt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=B({type:`guard`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/guards`,pattern:i,shouldPluralize:e.pluralize??!0}),o=L(t),s=I(t),c=F(t),l=[],u=k(a,`${o}.guard.ts`);return await _(u,`import { Container, HttpException } from '@forinda/kickjs'
|
|
987
982
|
import type { RequestContext } from '@forinda/kickjs'
|
|
988
983
|
|
|
989
984
|
/**
|
|
@@ -1023,11 +1018,11 @@ export async function ${s}Guard(ctx: RequestContext, next: () => void): Promise<
|
|
|
1023
1018
|
ctx.problem.unauthorized({ detail: 'Invalid or expired token' })
|
|
1024
1019
|
}
|
|
1025
1020
|
}
|
|
1026
|
-
`),l.push(u),l}function
|
|
1021
|
+
`),l.push(u),l}function Vt(e){return e?e.split(`,`).map(e=>e.trim()).filter(Boolean).map(e=>{let[t,n]=e.split(`:`).map(e=>e.trim());return{name:t,type:n||`string`}}).filter(e=>e.name.length>0):[]}async function Ht(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=e.type??`http`,o=L(t),s=F(t),c=e.key??I(t),l=Array.isArray(e.params)?e.params:Vt(e.params),u=B({type:`contributor`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/contributors`,pattern:i,shouldPluralize:e.pluralize??!0}),d=a===`http`?`defineHttpContextDecorator`:`defineContextDecorator`,f=a===`http`?`RequestContext`:`ExecutionContext`,p=l.length>0?`\nexport type ${s}Params = {\n${l.map(e=>` ${e.name}: ${e.type}`).join(`
|
|
1027
1022
|
`)}\n}\n`:``,m=l.length>0?`${d}.withParams<${s}Params>()({`:`${d}({`,h=l.length>0?` // Every call site must supply these — no placeholder defaults.
|
|
1028
1023
|
// Add \`paramDefaults: { … }\` for any field whose default is
|
|
1029
1024
|
// genuinely correct for an undecorated route, and drop it from here.
|
|
1030
|
-
requiredParams: [${l.map(e=>`'${e.name}'`).join(`, `)}],\n`:``,
|
|
1025
|
+
requiredParams: [${l.map(e=>`'${e.name}'`).join(`, `)}],\n`:``,g=l.length>0?`(ctx, _deps, params)`:`(ctx)`,v=l.length>0?` // \`params\` is typed as ${s}Params (call-site params merged onto any paramDefaults).`:` // \`ctx\` is a ${f} — read ctx.req / ctx.headers / ctx.params (http) or ctx.get (bare).`,y=`import { ${d} } from '@forinda/kickjs'
|
|
1031
1026
|
import type { ${f} } from '@forinda/kickjs'
|
|
1032
1027
|
|
|
1033
1028
|
/**
|
|
@@ -1068,13 +1063,13 @@ declare module '@forinda/kickjs' {
|
|
|
1068
1063
|
${p}
|
|
1069
1064
|
export const ${s} = ${m}
|
|
1070
1065
|
key: '${c}',
|
|
1071
|
-
${h} resolve: ${
|
|
1066
|
+
${h} resolve: ${g} => {
|
|
1072
1067
|
${v}
|
|
1073
1068
|
// TODO: compute and return the value written to ctx.set('${c}', …)
|
|
1074
1069
|
throw new Error("${s} contributor: resolve() not implemented")
|
|
1075
1070
|
},
|
|
1076
1071
|
})
|
|
1077
|
-
`,b=k(u,`${o}.contributor.ts`);return await
|
|
1072
|
+
`,b=k(u,`${o}.contributor.ts`);return await _(b,y),[b]}async function Ut(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=B({type:`service`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/services`,pattern:i,shouldPluralize:e.pluralize??!0}),o=L(t),s=F(t),c=[],l=k(a,`${o}.service.ts`);return await _(l,`import { Service } from '@forinda/kickjs'
|
|
1078
1073
|
|
|
1079
1074
|
@Service()
|
|
1080
1075
|
export class ${s}Service {
|
|
@@ -1083,7 +1078,7 @@ export class ${s}Service {
|
|
|
1083
1078
|
// @Inject(MY_REPO) private readonly repo: IMyRepository,
|
|
1084
1079
|
// ) {}
|
|
1085
1080
|
}
|
|
1086
|
-
`),c.push(l),c}async function
|
|
1081
|
+
`),c.push(l),c}async function Wt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=B({type:`controller`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/controllers`,pattern:i,shouldPluralize:e.pluralize??!0}),o=L(t),s=F(t),c=[],l=k(a,`${o}.controller.ts`);return await _(l,`import { Controller, Get, Post, Put, Delete, reply, type Ctx } from '@forinda/kickjs'
|
|
1087
1082
|
|
|
1088
1083
|
// \`Ctx<KickRoutes.${s}Controller['<method>']>\` is generated by
|
|
1089
1084
|
// \`kick typegen\` (auto-run on \`kick dev\`). After the first run, your IDE
|
|
@@ -1125,7 +1120,7 @@ export class ${s}Controller {
|
|
|
1125
1120
|
return reply.noContent()
|
|
1126
1121
|
}
|
|
1127
1122
|
}
|
|
1128
|
-
`),c.push(l),c}async function
|
|
1123
|
+
`),c.push(l),c}async function Gt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=B({type:`dto`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/dtos`,pattern:i,shouldPluralize:e.pluralize??!0}),o=L(t),s=F(t),c=I(t),l=[],u=k(a,`${o}.dto.ts`);return await _(u,`import { z } from 'zod'
|
|
1129
1124
|
|
|
1130
1125
|
export const ${c}Schema = z.object({
|
|
1131
1126
|
// Define your schema fields here
|
|
@@ -1133,8 +1128,8 @@ export const ${c}Schema = z.object({
|
|
|
1133
1128
|
})
|
|
1134
1129
|
|
|
1135
1130
|
export type ${s}DTO = z.infer<typeof ${c}Schema>
|
|
1136
|
-
`),l.push(u),l}async function
|
|
1137
|
-
Skipped — existing kick.config.ts preserved.`),[]):(await
|
|
1131
|
+
`),l.push(u),l}async function Kt(e){let t=k(e.outDir,`kick.config.ts`),n=e.modulesDir??`src/modules`,r=e.defaultRepo??`inmemory`;return w(t)&&!e.force&&!await S({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
|
|
1132
|
+
Skipped — existing kick.config.ts preserved.`),[]):(await _(t,`import { defineConfig } from '@forinda/kickjs-cli'
|
|
1138
1133
|
|
|
1139
1134
|
export default defineConfig({
|
|
1140
1135
|
modules: {
|
|
@@ -1151,71 +1146,43 @@ export default defineConfig({
|
|
|
1151
1146
|
{
|
|
1152
1147
|
name: 'test',
|
|
1153
1148
|
description: 'Run tests with Vitest',
|
|
1154
|
-
steps: '
|
|
1149
|
+
steps: 'vitest run',
|
|
1150
|
+
},
|
|
1151
|
+
{
|
|
1152
|
+
name: 'lint',
|
|
1153
|
+
description: 'Lint with oxlint',
|
|
1154
|
+
steps: 'oxlint src/',
|
|
1155
1155
|
},
|
|
1156
1156
|
{
|
|
1157
1157
|
name: 'format',
|
|
1158
|
-
description: 'Format code with
|
|
1159
|
-
steps: '
|
|
1158
|
+
description: 'Format code with oxfmt',
|
|
1159
|
+
steps: 'oxfmt src/',
|
|
1160
1160
|
},
|
|
1161
1161
|
{
|
|
1162
1162
|
name: 'format:check',
|
|
1163
1163
|
description: 'Check formatting without writing',
|
|
1164
|
-
steps: '
|
|
1164
|
+
steps: 'oxfmt --check src/',
|
|
1165
1165
|
},
|
|
1166
1166
|
{
|
|
1167
1167
|
name: 'ci:check',
|
|
1168
|
-
description: 'Run typecheck + format check',
|
|
1169
|
-
steps: ['
|
|
1168
|
+
description: 'Run typecheck + lint + format check',
|
|
1169
|
+
steps: ['kick typecheck', 'oxlint src/', 'oxfmt --check src/'],
|
|
1170
1170
|
aliases: ['verify'],
|
|
1171
1171
|
},
|
|
1172
1172
|
],
|
|
1173
1173
|
})
|
|
1174
1174
|
`),[t])}function V(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 H(e,t){let n=t.exec(e);if(!n)return null;let r=n.index+n[0].length-1,i=V(e,r);return i===-1?null:e.slice(r+1,i)}function U(e,t,n){let r=` `.repeat(n);return e.split(`
|
|
1175
1175
|
`).map(e=>{if(e.trim()===``)return e;let n=RegExp(`^ {0,${t}}`),i=e.replace(n,``);return r+i}).join(`
|
|
1176
|
-
`)}function
|
|
1176
|
+
`)}function qt(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 Jt(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 Yt(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=V(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=H(o,/register\s*\(([^)]*)\)\s*:\s*void\s*\{/),u=H(o,/contributors\s*\(\s*\)\s*:\s*ContributorRegistrations\s*\{/),d=H(o,/routes\s*\(\s*\)\s*:\s*[A-Za-z|[\]\s]+\{/);if(!d)return{migrated:null,reason:`routes() method missing or signature unrecognized`};let f=qt(s),p=``;return l&&(p+=` register(container) {${U(l,4,6)} },\n\n`),u&&(p+=` contributors() {${U(u,4,6)} },\n\n`),p+=` routes() {${U(d,4,6)} },`,{migrated:`${f}${`export const ${r} = defineModule({
|
|
1177
1177
|
name: '${r}',
|
|
1178
1178
|
build: () => ({
|
|
1179
1179
|
${p}
|
|
1180
1180
|
}),
|
|
1181
|
-
})`}${c}`}}function
|
|
1182
|
-
`||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=V(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=H(m,/register\s*\(([^)]*)\)\s*\{/),g=H(m,/contributors\s*\(\s*\)\s*\{/),_=H(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let v=
|
|
1181
|
+
})`}${c}`}}function Xt(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=V(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]===`
|
|
1182
|
+
`||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=V(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=H(m,/register\s*\(([^)]*)\)\s*\{/),g=H(m,/contributors\s*\(\s*\)\s*\{/),_=H(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let v=Jt(c,{container:h!==null,appModule:!0,moduleRoutes:!0,contributorRegistrations:g!==null}),y=``;return h!==null&&(y+=` register(container: Container): void {${U(h,6,4)} }\n\n`),g!==null&&(y+=` contributors(): ContributorRegistrations {${U(g,6,4)} }\n\n`),y+=` routes(): ModuleRoutes {${U(_,6,4)} }`,{migrated:`${v}${`export class ${r} implements AppModule {
|
|
1183
1183
|
${y}
|
|
1184
1184
|
}
|
|
1185
|
-
`}${u}`}}function
|
|
1186
|
-
import { Job, Process, QUEUE_MANAGER, type QueueService } from '@forinda/kickjs-queue'
|
|
1187
|
-
|
|
1188
|
-
/**
|
|
1189
|
-
* ${r} Job Processor
|
|
1190
|
-
*
|
|
1191
|
-
* Decorators:
|
|
1192
|
-
* @Job(queueName) — marks this class as a job processor for a queue
|
|
1193
|
-
* @Process(jobName?) — marks a method as the handler for a specific job type
|
|
1194
|
-
* - Without a name: handles all jobs in the queue
|
|
1195
|
-
* - With a name: handles only jobs matching that name
|
|
1196
|
-
*
|
|
1197
|
-
* To add jobs to this queue from a service or controller:
|
|
1198
|
-
* @Inject(QUEUE_MANAGER) private queue: QueueService
|
|
1199
|
-
* await this.queue.add('${o}', '${a}', { ... })
|
|
1200
|
-
*/
|
|
1201
|
-
@Job('${o}')
|
|
1202
|
-
export class ${r}Job {
|
|
1203
|
-
@Process()
|
|
1204
|
-
async handle(job: { name: string; data: any; id?: string }) {
|
|
1205
|
-
console.log(\`Processing \${job.name} (id: \${job.id})\`, job.data)
|
|
1206
|
-
|
|
1207
|
-
// TODO: Implement job logic here
|
|
1208
|
-
// Example:
|
|
1209
|
-
// await this.emailService.send(job.data.to, job.data.subject, job.data.body)
|
|
1210
|
-
}
|
|
1211
|
-
|
|
1212
|
-
@Process('${a}.priority')
|
|
1213
|
-
async handlePriority(job: { name: string; data: any; id?: string }) {
|
|
1214
|
-
console.log(\`Priority job: \${job.name}\`, job.data)
|
|
1215
|
-
// Handle high-priority variant of this job
|
|
1216
|
-
}
|
|
1217
|
-
}
|
|
1218
|
-
`),s}const nn={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 rn(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=nn[a];if(!o){let e=[...Object.keys(nn),`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 an(e){let{name:t,fields:n,modulesDir:r,repo:i=`inmemory`,tokenScope:a=`app`,style:o=`define`}=e,s=e.pluralize!==!1,c=L(t),l=F(t),u=s?R(c):c,d=s?Ge(l):l,f=k(r,u),p=[],m=async(e,t)=>{let n=k(f,e);await g(n,t),p.push(n)};await m(`${c}.module.ts`,lt({pascal:l,kebab:c,plural:u,repo:i,style:o})),await m(`${c}.constants.ts`,xt({pascal:l,kebab:c})),await m(`${c}.controller.ts`,dt({pascal:l,kebab:c,plural:u,pluralPascal:d})),await m(`${c}.service.ts`,bt({pascal:l,kebab:c})),await m(`dtos/create-${c}.dto.ts`,on(l,n)),await m(`dtos/update-${c}.dto.ts`,sn(l,n)),await m(`dtos/${c}-response.dto.ts`,cn(l,n)),await m(`${c}.repository.ts`,ht({pascal:l,kebab:c,dtoPrefix:`./dtos`,tokenScope:a}));let h=i===`inmemory`,_=h?`in-memory-${c}`:`${L(i)}-${c}`,v=h?gt({pascal:l,kebab:c,repoPrefix:`.`,dtoPrefix:`./dtos`}):_t({pascal:l,kebab:c,repoType:i,repoPrefix:`.`,dtoPrefix:`./dtos`});return await m(`${_}.repository.ts`,v),await Et(r,l,u,c,o),p}function on(e,t){return`import { z } from 'zod'
|
|
1185
|
+
`}${u}`}}function Zt(e,t){return t===`class`?Xt(e):Yt(e)}function Qt(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 $t(e){let t=[];return await n(j(e),0),t;async function n(e,r){let i;try{i=await Re(e)}catch{return}for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=k(e,a),o;try{o=await Be(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function en(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await Re(e)}catch{return}await Le(t,{recursive:!0});for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=k(e,a),o=k(t,a),s;try{s=await Be(i)}catch{continue}s.isDirectory()?await r(i,o):(await Ie(i,o),n++)}}}function tn(e){return k(e,`.kickjs`,`codemod-backups`,`${new Date().toISOString().replaceAll(/[:.]/g,`-`)}-modules`)}async function nn(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await $t(e),s=await N(k(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=tn(r),await en(e,c));let l=[];for(let e of o){let t=Zt(await N(e,`utf-8`),i);if(t.migrated==null){l.push({path:e,status:`skipped`,reason:t.reason});continue}n||await P(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`})}let u=k(e,`index.ts`),d=null;try{d=await N(u,`utf-8`)}catch{return{target:i,files:l,indexStatus:`not-found`,indexPath:u,backupDir:c}}let f=Qt(d,i);return f.migrated==null?{target:i,files:l,indexStatus:`skipped`,indexPath:u,indexReason:f.reason,backupDir:c}:(n||await P(u,f.migrated,`utf-8`),{target:i,files:l,indexStatus:`migrated`,indexPath:u,backupDir:c})}async function rn(e,t){let n=await $t(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 N(e,`utf-8`);i.test(t)&&r.push(e)}return r}const an={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 on(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=an[a];if(!o){let e=[...Object.keys(an),`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 sn(e){let{name:t,fields:n,modulesDir:r,repo:i=`inmemory`,tokenScope:a=`app`,style:o=`define`}=e,s=e.pluralize!==!1,c=L(t),l=F(t),u=s?R(c):c,d=s?Je(l):l,f=k(r,u),p=[],m=async(e,t)=>{let n=k(f,e);await _(n,t),p.push(n)};await m(`${c}.module.ts`,ft({pascal:l,kebab:c,plural:u,repo:i,style:o})),await m(`${c}.constants.ts`,wt({pascal:l,kebab:c})),await m(`${c}.controller.ts`,mt({pascal:l,kebab:c,plural:u,pluralPascal:d,swagger:e.swagger??!1})),await m(`${c}.service.ts`,Ct({pascal:l,kebab:c})),await m(`dtos/create-${c}.dto.ts`,cn(l,n)),await m(`dtos/update-${c}.dto.ts`,ln(l,n)),await m(`dtos/${c}-response.dto.ts`,un(l,n)),await m(`${c}.repository.ts`,vt({pascal:l,kebab:c,dtoPrefix:`./dtos`,tokenScope:a}));let h=i===`inmemory`,g=h?`in-memory-${c}`:`${L(i)}-${c}`,v=h?yt({pascal:l,kebab:c,repoPrefix:`.`,dtoPrefix:`./dtos`}):bt({pascal:l,kebab:c,repoType:i,repoPrefix:`.`,dtoPrefix:`./dtos`});return await m(`${g}.repository.ts`,v),await kt(r,l,u,c,o),p}function cn(e,t){return`import { z } from 'zod'
|
|
1219
1186
|
|
|
1220
1187
|
export const create${e}Schema = z.object({
|
|
1221
1188
|
${t.map(e=>{let t=e.zodType;return` ${e.name}: ${t}${e.optional?`.optional()`:``},`}).join(`
|
|
@@ -1223,7 +1190,7 @@ ${t.map(e=>{let t=e.zodType;return` ${e.name}: ${t}${e.optional?`.optional()`:`
|
|
|
1223
1190
|
})
|
|
1224
1191
|
|
|
1225
1192
|
export type Create${e}DTO = z.infer<typeof create${e}Schema>
|
|
1226
|
-
`}function
|
|
1193
|
+
`}function ln(e,t){return`import { z } from 'zod'
|
|
1227
1194
|
|
|
1228
1195
|
export const update${e}Schema = z.object({
|
|
1229
1196
|
${t.map(e=>` ${e.name}: ${e.zodType}.optional(),`).join(`
|
|
@@ -1231,14 +1198,14 @@ ${t.map(e=>` ${e.name}: ${e.zodType}.optional(),`).join(`
|
|
|
1231
1198
|
})
|
|
1232
1199
|
|
|
1233
1200
|
export type Update${e}DTO = z.infer<typeof update${e}Schema>
|
|
1234
|
-
`}function
|
|
1201
|
+
`}function un(e,t){return`export interface ${e}ResponseDTO {
|
|
1235
1202
|
id: string
|
|
1236
1203
|
${t.map(e=>` ${e.name}${e.optional?`?`:``}: ${e.tsType}`).join(`
|
|
1237
1204
|
`)}
|
|
1238
1205
|
createdAt: string
|
|
1239
1206
|
updatedAt: string
|
|
1240
1207
|
}
|
|
1241
|
-
`}async function
|
|
1208
|
+
`}async function dn(e){let{name:t,moduleName:n,modulesDir:r}=e,i=e.pluralize??!0,a=L(t),o=F(t),s=[],c;if(e.outDir)c=j(e.outDir);else if(n){let e=L(n),t=i?R(e):e;c=j(k(r??`src/modules`,t,`__tests__`))}else c=j(`src/__tests__`);let l=k(c,`${a}.test.ts`);return await _(l,`import { describe, it, expect, beforeEach } from 'vitest'
|
|
1242
1209
|
import { Container } from '@forinda/kickjs'
|
|
1243
1210
|
|
|
1244
1211
|
describe('${o}', () => {
|
|
@@ -1261,53 +1228,58 @@ describe('${o}', () => {
|
|
|
1261
1228
|
expect(true).toBe(true)
|
|
1262
1229
|
})
|
|
1263
1230
|
})
|
|
1264
|
-
`),s.push(l),s}var
|
|
1265
|
-
`);super(`kick typegen --check: ${e.length} generated file(s) are out of date:\n${t}\n Run \`kick typegen\` and commit the result.`),this.name=`TypegenDriftError`,this.drifted=e}};const
|
|
1266
|
-
(dry run — no files were written)`),console.log()}async function
|
|
1231
|
+
`),s.push(l),s}function fn(){let e=(process.env.LOG_LEVEL??process.env.KICKJS_LOG_LEVEL??``).toLowerCase();return e===`debug`||e===`trace`}var pn=class extends Error{drifted;constructor(e){let t=e.map(e=>` ${e.id} → ${e.outFile}`).join(`
|
|
1232
|
+
`);super(`kick typegen --check: ${e.length} generated file(s) are out of date:\n${t}\n Run \`kick typegen\` and commit the result.`),this.name=`TypegenDriftError`,this.drifted=e}};const mn=[`agents`,`claude`,`skills`,`gemini`,`copilot`,`both`,`all`];function W(e){return e.parent?.opts()?.dryRun??!1}function G(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(`
|
|
1233
|
+
(dry run — no files were written)`),console.log()}async function hn(e){if(!e)try{let e=await u(process.cwd());await xe({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 gn=[{name:`module <name>`,description:`REST module (controller, service, DTOs, repo)`},{name:`scaffold <name> <fields...>`,description:`CRUD module from field definitions`},{name:`controller <name>`,description:`@Controller() class [-m module]`},{name:`service <name>`,description:`@Service() singleton [-m module]`},{name:`middleware <name>`,description:`Express middleware function [-m module]`},{name:`guard <name>`,description:`Route guard (auth, roles, etc.) [-m module]`},{name:`contributor <name>`,description:`Context contributor [--type http|bare] [--params a:string] [-m]`},{name:`dto <name>`,description:`Zod DTO schema [-m module]`},{name:`adapter <name>`,description:`AppAdapter with lifecycle hooks (app-level only)`},{name:`test <name>`,description:`Vitest test scaffold [-m module]`},{name:`config`,description:`Generate kick.config.ts`},{name:`agents`,description:`Regenerate AGENTS.md + CLAUDE.md + kickjs-skills.md from upstream templates`}],_n=new Map([[`job`,`Queue processors are no longer built in — their shape belongs to whichever queue you run.
|
|
1234
|
+
Add your own in kick.config.ts: https://kickjs.app/guide/plugin-generators.html`]]),vn=new Set([...gn.map(e=>e.name.split(` `)[0]),..._n.keys()]);async function yn(){console.log(`
|
|
1267
1235
|
Built-in generators:
|
|
1268
|
-
`);let e=Math.max(...
|
|
1236
|
+
`);let e=Math.max(...gn.map(e=>e.name.length));for(let t of gn)console.log(` kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await u(process.cwd()),n=m(t?.plugins??[],t?.commands??[]),r=await at(process.cwd(),n.generators);if(r.generators.length>0){console.log(`
|
|
1269
1237
|
Plugin generators:
|
|
1270
1238
|
`);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(`
|
|
1271
1239
|
Failed to load:
|
|
1272
|
-
`);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}async function
|
|
1273
|
-
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=W(n);
|
|
1274
|
-
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=W(n);
|
|
1240
|
+
`);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}async function bn(e,t,n){let r=await u(process.cwd()),i=l(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??Dt(i.repo);t.repo&&p(t.repo);let s=t.pattern??r?.pattern??`rest`,c=t.pluralize===!1?!1:i.pluralize??!0,m=d(r,process.cwd()),h=f(se()),g=i.style??`define`;if(!n&&g===`define`){let e=await rn(j(a),`define`);if(e.length>0){console.error(`\n ${x.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n ${x.dim(`Project setting:`)} modules.style: 'define' (default)\n\n ${x.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 ${x.bold(`Pick one:`)}\n 1. Migrate everything to defineModule:\n ${x.dim(`$`)} kick codemod modules --experimental --apply\n 2. Keep the class form — pin it in kick.config.ts:\n ${x.dim(`// kick.config.ts`)}\n ${x.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let _=[];for(let r of e){let e=await Ot({name:r,modulesDir:j(a),noEntity:t.entity===!1,noTests:t.tests===!1,repo:o,minimal:t.minimal,force:t.force,pattern:s,dryRun:n,pluralize:c,tokenScope:m,swagger:h,style:i.style});_.push(...e)}G(_,n),await hn(n)}function xn(e,t){let n=e.command(`generate [names...]`).alias(`g`).description("Generate code scaffolds — bare form `kick g <name>` is shorthand for `kick g module <name>`").option(`--list`,`List all available generators`).option(`--dry-run`,`Preview files that would be generated without writing them`).option(`--no-entity`,`Skip entity and value object generation (module shortcut)`).option(`--no-tests`,`Skip test file generation (module shortcut)`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name (e.g. postgres)`).option(`--pattern <pattern>`,`Override project pattern: rest | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,r,i)=>{if(r.list){await yn();return}if(!e||e.length===0){n.help();return}let a=W(i);g(a);let[o,s,...c]=e;if(o){let e=await u(process.cwd()),n=m(e?.plugins??[],e?.commands??[]),i=await it({generatorName:o,itemName:s??``,args:c,flags:r,cwd:process.cwd(),projectRoot:t?.projectRoot},n.generators);if(i){G(i.files,a);return}if(o!==`module`&&vn.has(o)){let e=_n.get(o);e?(console.error(`\n 'kick g ${o}' has been removed.`),console.error(` ${e}\n`)):(console.error(`\n '${o}' is a generator, not a module name.`),console.error(` Did you mean: kick g ${o} ${s??`<name>`}`),console.error(` If that errors, your @forinda/kickjs-cli is older than the '${o}' generator — upgrade it.\n`)),process.exitCode=1;return}}await bn(e,r,a)});n.command(`module <names...>`).description(`Generate one or more modules (e.g. kick g module user task project)`).option(`--no-entity`,`Skip entity and value object generation`).option(`--no-tests`,`Skip test file generation`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name (e.g. postgres)`).option(`--pattern <pattern>`,`Override project pattern: rest | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t,n)=>{let r=W(n);g(r),await bn(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=W(n);g(r),G(await It({name:e,outDir:j(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=W(n);g(r),G(await Lt({name:e,outDir:j(t.out)}),r)}),n.command(`middleware <name>`).description(`Generate a global middleware function, typed for the configured runtime
|
|
1241
|
+
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=W(n);g(r);let i=await u(process.cwd()),a=l(i),o=a.dir??`src/modules`;G(await zt({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0,runtime:i?.runtime}),r)}),n.command(`guard <name>`).description(`Generate a route guard (auth, roles, etc.)
|
|
1242
|
+
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=W(n);g(r);let i=await u(process.cwd()),a=l(i),o=a.dir??`src/modules`;G(await Bt({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`contributor <name>`).description(`Generate a Context Contributor (typed alternative to @Middleware for ctx.set)
|
|
1275
1243
|
--type http (default, RequestContext) | bare (ExecutionContext)
|
|
1276
1244
|
--params "source:string,region:number" → emits the withParams<T>() form
|
|
1277
|
-
Use -m to scope it to a module: kick g contributor tenant -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).option(`-t, --type <type>`,`Contributor flavour: http | bare`,`http`).option(`-k, --key <key>`,`Context key it writes (defaults to camelCase of name)`).option(`--params <fields>`,`Per-call params, e.g. "source:string,region:number"`).action(async(e,t,n)=>{let r=W(n);
|
|
1278
|
-
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=W(n);
|
|
1279
|
-
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=W(n);
|
|
1280
|
-
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=W(n);
|
|
1281
|
-
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=W(n);
|
|
1245
|
+
Use -m to scope it to a module: kick g contributor tenant -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).option(`-t, --type <type>`,`Contributor flavour: http | bare`,`http`).option(`-k, --key <key>`,`Context key it writes (defaults to camelCase of name)`).option(`--params <fields>`,`Per-call params, e.g. "source:string,region:number"`).action(async(e,t,n)=>{let r=W(n);g(r);let i=(t.type??`http`).toLowerCase();i!==`http`&&i!==`bare`&&(console.warn(` kick g contributor: unknown --type '${t.type}', using 'http'.`),i=`http`);let a=await u(process.cwd()),o=l(a),s=o.dir??`src/modules`;G(await Ht({name:e,type:i,key:t.key,params:t.params,outDir:t.out,moduleName:t.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),r)}),n.command(`service <name>`).description(`Generate a @Service() class
|
|
1246
|
+
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=W(n);g(r);let i=await u(process.cwd()),a=l(i),o=a.dir??`src/modules`;G(await Ut({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
|
|
1247
|
+
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=W(n);g(r);let i=await u(process.cwd()),a=l(i),o=a.dir??`src/modules`;G(await Wt({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r),await hn(r)}),n.command(`dto <name>`).description(`Generate a Zod DTO schema
|
|
1248
|
+
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=W(n);g(r);let i=await u(process.cwd()),a=l(i),o=a.dir??`src/modules`;G(await Gt({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
|
|
1249
|
+
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=W(n);g(r);let i=l(await u(process.cwd())),a=i.dir??`src/modules`;G(await dn({name:e,outDir:t.out,moduleName:t.module,modulesDir:a,pluralize:i.pluralize??!0}),r)}),n.command(`scaffold <name> [fields...]`).description(`Generate a full CRUD module from field definitions
|
|
1282
1250
|
Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
|
|
1283
1251
|
Types: string, text, number, int, float, boolean, date, email, url, uuid, json, enum:a,b,c
|
|
1284
1252
|
Optional: append :optional (shell-safe): description:text:optional
|
|
1285
|
-
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=W(r);
|
|
1253
|
+
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=W(r);g(i),t.length===0&&(console.error(`
|
|
1286
1254
|
Error: At least one field is required.
|
|
1287
1255
|
Usage: kick g scaffold <name> <field:type> [field:type...]
|
|
1288
1256
|
Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
|
|
1289
1257
|
Optional: append :optional (shell-safe, no quoting needed)
|
|
1290
|
-
`),process.exit(1));let a=await
|
|
1291
|
-
`,u=``;if(w(i)&&(u=await N(i,`utf8`)),u===l){s.push({id:n.id,status:`unchanged`,outFile:i});continue}if(e.check){c.push({id:n.id,outFile:i}),s.push({id:n.id,status:`drifted`,outFile:i});continue}await P(i,l,`utf8`),s.push({id:n.id,status:`written`,outFile:i})}if(c.length>0)throw new
|
|
1258
|
+
`),process.exit(1));let a=await u(process.cwd()),o=l(a),s=n.modulesDir??o.dir??`src/modules`,c=on(t),p=d(a,process.cwd()),m=f(se()),h=await sn({name:e,fields:c,modulesDir:j(s),noEntity:n.entity===!1,noTests:n.tests===!1,pluralize:n.pluralize===!1?!1:o.pluralize??!0,tokenScope:p,swagger:m,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)`:``}`);G(h,i),await hn(i)}),n.command(`config`).description(`Generate a kick.config.ts at the project root`).option(`--modules-dir <dir>`,`Modules directory path`,`src/modules`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name`,`inmemory`).option(`-f, --force`,`Overwrite existing kick.config.ts without prompting`).action(async(e,t)=>{let n=W(t);g(n),G(await Kt({outDir:j(`.`),modulesDir:e.modulesDir,defaultRepo:e.repo,force:e.force}),n)}),n.command(`agents`).alias(`agent-docs`).alias(`ai-docs`).description(`Regenerate AGENTS.md + CLAUDE.md + kickjs-skills.md (sync after framework upgrades)`).option(`--only <which>`,`Limit scope: agents | claude | skills | both (agents+claude) | all (default: all)`,`all`).option(`--name <name>`,`Project name (defaults to package.json name)`).option(`--pm <pm>`,`Package manager (defaults to package.json packageManager)`).option(`--template <template>`,`Template: rest | minimal`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t)=>{let n=W(t);g(n);let r=e.only??`all`;if(!mn.includes(r)){console.error(` Invalid --only value: ${r}. Expected: ${mn.join(` | `)}`),process.exitCode=1;return}G(await re({outDir:j(`.`),only:r,name:e.name,pm:e.pm,template:e.template,force:e.force}),n)});for(let e of t?.generators??[])Sn(n,e,t?.projectRoot)}function Sn(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=W(o);g(s);let c=await it({generatorName:i.name,itemName:e??``,args:r??[],flags:a,cwd:process.cwd(),projectRoot:n},[t]);c&&G(c.files,s)})}const Cn=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: `;async function wn(e){let t=D.resolve(e.cwd,`.kickjs/types`);e.check||await Le(t,{recursive:!0});let n=new Map,r=e.scan??pe,i=D.resolve(e.cwd,`.kickjs`,`cache`),a=e.scan?void 0:e.changedFiles,o={cwd:e.cwd,config:e.config,async importTs(e){return await import(M(e).href)},async writeFile(t,n){let r=D.resolve(e.cwd,t);await Le(D.dirname(r),{recursive:!0}),await P(r,n,`utf8`)},getScanResult:e=>{let t=Tn(e),o=n.get(t);if(!o){let s={cacheDir:i,...e};o=a?fe(s,a):r(s),n.set(t,o)}return o},log:console,watch:e.watch,check:e.check},s=[],c=[];for(let n of e.plugins){let r=n.outExtension??`.d.ts`,i=D.join(t,`${n.id.replace(/\//g,`__`)}${r}`),a;try{a=await n.generate(o)}catch(t){let r=t instanceof Error?t.message:String(t);if(e.check)throw Error(`kick typegen --check: ${n.id} failed to generate (${r})`,{cause:t});o.log.error(` ${n.id}: typegen failed (${r}) — keeping previous output`),s.push({id:n.id,status:`error`,outFile:i});continue}if(a===null){s.push({id:n.id,status:`skipped`});continue}let l=`${Cn}${n.id} */\n\n`+a+`
|
|
1259
|
+
`,u=``;if(w(i)&&(u=await N(i,`utf8`)),u===l){s.push({id:n.id,status:`unchanged`,outFile:i});continue}if(e.check){c.push({id:n.id,outFile:i}),s.push({id:n.id,status:`drifted`,outFile:i});continue}await P(i,l,`utf8`),s.push({id:n.id,status:`written`,outFile:i})}if(c.length>0)throw new pn(c);return s}function Tn(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 En(e,t){let n=new Set(t),r=[],i=[],a=new Set;for(let t of e)n.has(t.id)?(i.push(t),a.add(t.id)):r.push(t);return{enabled:r,skipped:i,unknown:[...n].filter(e=>!a.has(e))}}var Dn=e({applyDisableFilter:()=>En,runAllPluginTypegens:()=>On});async function On(e){let{enabled:t,skipped:n,unknown:r}=En(m([...Da,...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 wn({cwd:e.cwd,config:e.config??{},plugins:t,watch:e.watch,check:e.check,changedFiles:e.changedFiles});if(!e.silent&&fn())for(let e of n)console.log(` ${e.id}: ${e.status}`);return n}catch(t){if(t instanceof pn||e.check)throw t;if(!e.silent){let e=t instanceof Error?t.message:String(t);console.warn(` kick typegen plugins: skipped (${e})`)}return[]}}function kn(e){let t=new Map;return{report(n,r){let i=r instanceof Error?r.message:String(r);t.get(n)!==i&&(t.set(n,i),e(` kick typegen: ${n} pass failed (${i}) — types in .kickjs/types may be stale`))},clear(e){t.delete(e)}}}function An(e){let{cwd:t,config:n}=e,r=e.debounceMs??100,i=e.pipeline??{runTypegen:async e=>(await import(`./typegen-C0-zbJ7C.mjs`).then(e=>e.n)).runTypegen(e),runAllPluginTypegens:async e=>(await Promise.resolve().then(()=>Dn)).runAllPluginTypegens(e),writeTypegenArtifacts:async(e,t,n)=>(await import(`./typegen-C0-zbJ7C.mjs`).then(e=>e.n)).writeTypegenArtifacts(e,t,n),buildAssets:async(e,t)=>(await import(`./build-kAS8vTgJ.mjs`).then(e=>e.n)).buildAssets(e,t)},a=n?.typegen?.schemaValidator??`zod`,o=n?.typegen?.envFile,s=D.resolve(t,n?.typegen?.outDir??`.kickjs/types`),c=n?.assetMap?Object.values(n.assetMap).map(e=>e?.src).filter(e=>typeof e==`string`&&e.length>0).map(e=>D.resolve(t,e)):[],l=!!n?.assetMap&&Object.keys(n.assetMap).length>0,u=e=>e.replaceAll(`\\`,`/`),d=c.map(u),f=e=>{let t=u(e);return d.some(e=>t===e||t.startsWith(`${e}/`))},p=kn(e.emitWarning),m=null,h=!1,g=new Set,_=new Set,v=!1,y=!1;function b(r,c){i.runTypegen({cwd:t,silent:!0,allowDuplicates:!0,schemaValidator:a,envFile:o,srcDir:n?.typegen?.srcDir,outDir:n?.typegen?.outDir,assetMap:n?.assetMap,changedFiles:r,runPlugins:!1}).then(()=>p.clear(`scan`)).catch(e=>p.report(`scan`,e)),i.runAllPluginTypegens({cwd:t,config:n,silent:!0,changedFiles:r,watch:!0}).then(e=>i.writeTypegenArtifacts(s,e,!0)).then(()=>p.clear(`plugins`)).catch(e=>p.report(`plugins`,e)).finally(()=>e.onPassComplete?.()),c&&n&&i.buildAssets(n,{cwd:t,silent:!0}).catch(()=>{})}function ee(){let e=v?void 0:{changed:[...g],removed:[..._]},t=y;g.clear(),_.clear(),v=!1,y=!1,b(e,t)}return{assetSrcRoots:c,handleWatchEvent(e,t){if(!h&&!u(t).includes(`/.kickjs/`)){if(e===`unlinkDir`)v=!0,l&&(y=!0);else{if(t.endsWith(`.d.ts`))return;let n=/\.(ts|tsx|mts|cts)$/.test(t),r=f(t);if(!n&&!r)return;r&&l&&(y=!0),n&&(e===`unlink`?(_.add(t),g.delete(t)):(g.add(t),_.delete(t)))}m&&clearTimeout(m),m=setTimeout(ee,r)}},runOnce(){h||b(void 0,l)},dispose(){h=!0,m&&clearTimeout(m),m=null}}}function jn(e){let t=k(e,`node_modules`,`.bin`),n=process.platform===`win32`;for(let e of[`vue-tsc`,`tsgo`,`tsc`]){let r=n?[`${e}.CMD`,`${e}.cmd`,`${e}.exe`]:[e];for(let i of r){let r=k(t,i);if(w(r))return{cmd:r,args:[`--noEmit`],shell:n,kind:e}}}return null}function Mn(e){let t=e.spawnFn??Pe,n=null,r=0,i=!1;return{schedule(){if(i)return;let a=++r;n&&=(n.kill(),null);let o=Date.now(),s=t(e.bin.cmd,e.bin.args,{cwd:e.cwd,shell:e.bin.shell,stdio:[`ignore`,`pipe`,`pipe`]});n=s;let c=``;s.stdout?.on(`data`,e=>{c+=e.toString()}),s.stderr?.on(`data`,e=>{c+=e.toString()}),s.on(`error`,()=>{a===r&&(n=null)}),s.on(`close`,t=>{i||a!==r||(n=null,e.onResult({ok:t===0,output:c,durationMs:Date.now()-o,kind:e.bin.kind}))})},dispose(){i=!0,n&&=(n.kill(),null)}}}function Nn(e,t=12){let n=e.trim().split(/\r?\n/);return n.length<=t?n.join(`
|
|
1292
1260
|
`):`${n.slice(0,t).join(`
|
|
1293
|
-
`)}\n… ${n.length-t} more line(s)`}function
|
|
1261
|
+
`)}\n… ${n.length-t} more line(s)`}function Pn(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function Fn(e,t=`127.0.0.1`){let n=await import(`node:inspector`);n.open(e,t,!1);let r=n.url();if(!r)throw Error(`inspector.open() reported no URL`);return r}async function In(e,t,n={}){t&&(process.env.PORT=t);let r=Pn(n.polling),i=process.cwd(),a=await u(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await xe({cwd:i,allowDuplicates:!0,schemaValidator:o,envFile:s,srcDir:a?.typegen?.srcDir,outDir:a?.typegen?.outDir,assetMap:a?.assetMap,runPlugins:!1})}catch(e){console.warn(` kick typegen: skipped (${e?.message??e})`)}let c=j(i,a?.typegen?.outDir??`.kickjs/types`);try{await me(c,await On({cwd:i,config:a}),!1)}catch(e){console.warn(` kick typegen: plugin pass skipped (${e?.message??e})`)}let{createRequire:l}=await import(`node:module`),{createServer:d}=await import(M(l(j(`package.json`)).resolve(`vite`)).href);globalThis.__kickjs_typegen_owner=`kick-dev`;let f=await d({configFile:j(`vite.config.ts`),server:{port:t?parseInt(t,10):void 0,...r?{watch:{usePolling:!0,interval:100}}:{}}}),p=n.typecheck??a?.dev?.typecheck??!1,m=null,h=!0;if(p){let e=jn(i);e?m=Mn({cwd:i,bin:e,onResult:e=>{f.hot.send({type:`custom`,event:`kickjs:typecheck`,data:{ok:e.ok,output:e.output,durationMs:e.durationMs}}),e.ok?h||(h=!0,console.log(` kick typecheck: clean again (${e.kind}, ${e.durationMs}ms)`)):(h=!1,console.warn(`\n kick typecheck (${e.kind}, ${e.durationMs}ms):`),console.warn(Nn(e.output).replace(/^/gm,` `)))}}):console.warn(` kick dev: --typecheck requested but neither tsgo (@typescript/native-preview) nor typescript is installed in this project — skipping type checks.`)}let g=An({cwd:i,config:a,emitWarning:e=>{console.warn(e),f.hot.send({type:`custom`,event:`kickjs:typegen-error`,data:{message:e,timestamp:Date.now()}})},onPassComplete:()=>m?.schedule()});f.watcher.on(`add`,e=>g.handleWatchEvent(`add`,e)),f.watcher.on(`unlink`,e=>g.handleWatchEvent(`unlink`,e)),f.watcher.on(`change`,e=>g.handleWatchEvent(`change`,e)),f.watcher.on(`unlinkDir`,e=>g.handleWatchEvent(`unlinkDir`,e)),g.assetSrcRoots.length>0&&f.watcher.add([...g.assetSrcRoots]),await f.listen(),f.printUrls(),console.log(`
|
|
1294
1262
|
KickJS dev server running (Vite + @forinda/kickjs-vite)
|
|
1295
|
-
`),m?.schedule();let _=!1,v=async()=>{if(!_){_=!0,g.dispose(),m?.dispose();try{await globalThis.__kickjs_app_shutdown?.()}catch(e){console.error(` app shutdown hook failed: ${e?.message??e}`)}await
|
|
1263
|
+
`),m?.schedule();let _=!1,v=async()=>{if(!_){_=!0,g.dispose(),m?.dispose();try{await globalThis.__kickjs_app_shutdown?.()}catch(e){console.error(` app shutdown hook failed: ${e?.message??e}`)}await f.close(),process.exit(0)}};process.on(`SIGINT`,v),process.on(`SIGTERM`,v),process.on(`SIGBREAK`,v)}function Ln(e){e.command(`dev`).description(`Start development server with Vite HMR (zero-downtime reload)`).option(`-e, --entry <file>`,`Entry file`,`src/index.ts`).option(`-p, --port <port>`,`Port number`).option(`--polling`,`Force chokidar to poll for file changes (Docker / WSL / NFS / older kernels)`).option(`--typecheck`,`Run the project TypeScript checker (tsgo/tsc --noEmit) after each change and report diagnostics`).action(async e=>{try{await In(e.entry,e.port,{polling:e.polling,typecheck:e.typecheck})}catch(e){e.code===`ERR_MODULE_NOT_FOUND`&&e.message?.includes(`vite`)?console.error(`
|
|
1296
1264
|
Error: vite is not installed.
|
|
1297
1265
|
Run: pnpm add -D vite unplugin-swc
|
|
1298
1266
|
`):console.error(`
|
|
1299
1267
|
Dev server failed:`,e.message??e),process.exit(1)}}),e.command(`build`).description(`Build for production via Vite`).action(async()=>{console.log(`
|
|
1300
1268
|
Building for production...
|
|
1301
|
-
`);let{createRequire:e}=await import(`node:module`),{build:t}=await import(M(e(j(`package.json`)).resolve(`vite`)).href);await t({configFile:j(`vite.config.ts`)});let n=await
|
|
1302
|
-
Copying directories to dist...`);for(let e of r){let t=typeof e==`string`?e:e.src,n=typeof e==`string`?k(`dist`,e):e.dest??k(`dist`,t),r=j(t),i=j(n);if(!w(r)){console.log(` ⚠ Skipped ${t} (not found)`);continue}
|
|
1303
|
-
Building asset map...`);try{await
|
|
1269
|
+
`);let{createRequire:e}=await import(`node:module`),{build:t}=await import(M(e(j(`package.json`)).resolve(`vite`)).href);await t({configFile:j(`vite.config.ts`)});let n=await u(process.cwd()),r=n?.copyDirs??[];if(r.length>0){console.log(`
|
|
1270
|
+
Copying directories to dist...`);for(let e of r){let t=typeof e==`string`?e:e.src,n=typeof e==`string`?k(`dist`,e):e.dest??k(`dist`,t),r=j(t),i=j(n);if(!w(r)){console.log(` ⚠ Skipped ${t} (not found)`);continue}Ee(i,{recursive:!0}),Te(r,i,{recursive:!0}),console.log(` ✓ ${t} → ${n}`)}}if(n?.assetMap&&Object.keys(n.assetMap).length>0){console.log(`
|
|
1271
|
+
Building asset map...`);try{await Ce(n,{cwd:process.cwd()})}catch(e){console.error(` ✗ asset build failed: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}console.log(`
|
|
1304
1272
|
Build complete.
|
|
1305
|
-
`)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await
|
|
1306
|
-
Building asset map...`);try{await
|
|
1273
|
+
`)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await u(process.cwd());if(!e?.assetMap||Object.keys(e.assetMap).length===0){console.log(` No assetMap entries — nothing to build.`);return}console.log(`
|
|
1274
|
+
Building asset map...`);try{await Ce(e,{cwd:process.cwd()}),console.log(`
|
|
1307
1275
|
Asset build complete.
|
|
1308
|
-
`)}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)),c(e.entry,t)}),e.command(`
|
|
1309
|
-
|
|
1310
|
-
|
|
1276
|
+
`)}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)),c(e.entry,t)}),e.command(`typecheck`).description(`Type-check the project with its own tsgo/tsc`).option(`--cwd <dir>`,`Directory to type-check`,`.`).action(e=>{let t=j(process.cwd(),e.cwd??`.`),n=jn(t);if(!n){console.error(`
|
|
1277
|
+
No type-checker found. Install one in this project:
|
|
1278
|
+
pnpm add -D typescript (tsc)
|
|
1279
|
+
pnpm add -D @typescript/native-preview (tsgo, faster)
|
|
1280
|
+
`),process.exit(1);return}let r=Fe(n.cmd,n.args,{stdio:`inherit`,shell:n.shell,cwd:t});process.exit(r.status??1)}),e.command(`dev:debug`).description(`Start dev server with Node.js inspector attached`).option(`-e, --entry <file>`,`Entry file`,`src/index.ts`).option(`-p, --port <port>`,`Port number`).option(`--inspect-port <port>`,`Inspector port`,`9229`).option(`--inspect-host <host>`,`Inspector bind address (use 0.0.0.0 to reach it from outside a container)`,`127.0.0.1`).action(async e=>{let t=Number(e.inspectPort??`9229`),n=e.inspectHost??`127.0.0.1`;[`127.0.0.1`,`localhost`,`::1`].includes(n)||console.warn(` WARNING: the debugger is bound to ${n}, not loopback. Anyone who can\n reach port ${t} can run code in this process. Use it on a trusted\n network only, and prefer publishing the port from your container instead.`);let r;try{r=await Fn(t,n)}catch(e){console.error(`\n Could not open the inspector on ${t}: ${e.message??e}\n Another process may already hold it — try --inspect-port <port>.`),process.exit(1);return}console.log(` Debugger: ${r}`);try{await In(e.entry,e.port)}catch(e){console.error(`
|
|
1281
|
+
Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function Rn(){try{let e=O(Me(import.meta.url));return JSON.parse(T(k(e,`..`,`package.json`),`utf-8`)).version??`unknown`}catch{return`unknown`}}const zn=new Set(Object.values(a).filter(e=>e.deprecated).map(e=>e.pkg));function Bn(e){let t=k(e,`package.json`);if(!w(t))return[];let n;try{n=JSON.parse(T(t,`utf-8`))}catch{return[]}let r={...n.dependencies,...n.devDependencies};return Object.keys(r).filter(e=>e===`@forinda/kickjs`||e.startsWith(`@forinda/kickjs-`)).toSorted().map(t=>{let n=null,i=k(e,`node_modules`,...t.split(`/`),`package.json`);if(w(i))try{n=JSON.parse(T(i,`utf-8`)).version??null}catch{}return{name:t,installed:n,declared:r[t]??null,deprecated:zn.has(t)}})}function Vn(e){let t=e;for(;;){if(w(k(t,`package.json`)))return t;let e=O(t);if(e===t)return null;t=e}}function Hn(e){e.command(`info`).description(`Print system and framework info`).action(()=>{let e=[``,` KickJS CLI v${Rn()}`,``,` System:`,` OS: ${Ue()} ${We()} (${He()})`,` Node: ${process.version}`],t=Vn(process.cwd()),n=t?Bn(t):[];if(!t)e.push(``,` Packages: (not inside a project — no package.json found)`);else if(n.length===0)e.push(``,` Packages: (no @forinda/kickjs* dependencies in ${t})`);else{e.push(``,` Packages:`);let t=Math.max(...n.map(e=>e.name.length));for(let r of n){let n=r.installed??`${r.declared??`?`} (declared — not installed)`,i=r.deprecated?" [DEPRECATED — see `kick add --list --all`]":``;e.push(` ${r.name.padEnd(t+2)} ${n}${i}`)}}e.push(``),console.log(e.join(`
|
|
1282
|
+
`))})}const{bold:K,dim:q,green:Un,red:J,yellow:Wn,blue:Gn}=x;function Kn(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 qn(e){let t=await fetch(e,{signal:AbortSignal.timeout(5e3)});if(!t.ok)throw Error(`${t.status} ${t.statusText}`);return t.json()}async function Y(e,t){try{return await qn(`${e}${t}`)}catch{return null}}async function Jn(e){let[t,n,r,i,a]=await Promise.all([Y(e,`/health`),Y(e,`/metrics`),Y(e,`/routes`),Y(e,`/container`),Y(e,`/ws`)]);return{health:t,metrics:n,routes:r,container:i,ws:a}}function Yn(e,t){let{health:n,metrics:r,routes:i,container:a,ws:o}=t,s=q(`─`.repeat(60));if(console.log(),console.log(K(` KickJS Inspector`)+q(` → ${e}`)),console.log(s),n){let e=n.status===`healthy`?Un(`● healthy`):J(`● `+n.status);console.log(` ${K(`Health:`)} ${e}`)}else console.log(` ${K(`Health:`)} ${J(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?J:r.errorRate>0?Wn:Un;console.log(` ${K(`Uptime:`)} ${Kn(r.uptimeSeconds)}`),console.log(` ${K(`Requests:`)} ${r.requests}`),console.log(` ${K(`Errors:`)} ${r.serverErrors} server, ${r.clientErrors??0} client ${q(`(`)}${t(e+`%`)}${q(`)`)}`)}if(a&&console.log(` ${K(`DI:`)} ${a.count} bindings`),o&&o.enabled&&console.log(` ${K(`WS:`)} ${o.connections??0} connections, ${o.namespaces??0} namespaces`),i?.routes?.length){console.log(),console.log(K(` Routes`)),console.log(s),console.log(` ${q(`METHOD`)} ${q(`PATH`.padEnd(36))} ${q(`CONTROLLER`)}`);for(let e of i.routes){let t=e.path.length>36?e.path.slice(0,33)+`...`:e.path.padEnd(36);console.log(` ${ee(e.method)} ${t} ${Gn(e.controller)}.${q(e.handler)}`)}}console.log(s),console.log()}function Xn(e){e.command(`inspect [url]`).description(`Connect to a running KickJS app and display debug info`).option(`-p, --port <port>`,`Override port`).option(`-w, --watch`,`Poll every 5 seconds`).option(`-j, --json`,`Output raw JSON`).action(async(e,t)=>{let n=e??`http://localhost:3000`;if(t.port)try{let e=new URL(n);e.port=t.port,n=e.origin}catch{n=`http://localhost:${t.port}`}let r=`${n.replace(/\/$/,``)}/_debug`,i=async()=>{try{let e=await Jn(r);t.json?console.log(JSON.stringify(e,null,2)):Yn(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(J(` ✖ Could not connect to ${n}`)),console.error(q(` ${e instanceof Error?e.message:String(e)}`))),t.watch||(process.exitCode=1)}};if(t.watch){let e=async()=>{process.stdout.write(`\x1B[2J\x1B[H`),await i()};await e(),setInterval(e,5e3)}else await i()})}function Zn(e,t){let n=e.toLowerCase();return t.every(e=>n.includes(e.toLowerCase()))}function X(e,t){let n=e.toLowerCase();return t.some(e=>n.includes(e.toLowerCase()))}const Qn=[{match(e,t){let n=Zn(e,[`config`,`get`])&&X(e,[`undefined`,`null`]),r=e.includes(`@Value`)&&X(e,[`undefined`,`is not defined`]);return!n&&!r?null:X(e,[`vitest`,`createTestApp`,`__tests__`,`.test.`,`.spec.`])?{confidence:85,diagnosis:{id:`env-schema-not-registered-in-test`,title:`ConfigService.get() returns undefined inside a test`,explanation:`The env schema is registered by a module-load side effect in
|
|
1311
1283
|
src/config/index.ts, and src/index.ts imports it before bootstrap().
|
|
1312
1284
|
Tests never load src/index.ts — \`createTestApp\` builds the app
|
|
1313
1285
|
directly — so that import does not run and ConfigService falls back to
|
|
@@ -1341,7 +1313,7 @@ describe('UserController', () => {
|
|
|
1341
1313
|
beforeEach(() => Container.reset())
|
|
1342
1314
|
|
|
1343
1315
|
it('does the thing', async () => { /* ... */ })
|
|
1344
|
-
})`,docs:`https://kickjs.app/guide/testing.html`}}:null}},{match(e,t){return e.includes(`@Module`)||
|
|
1316
|
+
})`,docs:`https://kickjs.app/guide/testing.html`}}:null}},{match(e,t){return e.includes(`@Module`)||Zn(e,[`Module`,`is not a function`])||Zn(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
|
|
1345
1317
|
pattern instead: a class implements AppModule and exposes routes() that
|
|
1346
1318
|
returns the controller wiring. This was a deliberate choice — modules
|
|
1347
1319
|
become explicit values rather than metadata, which makes them easier to
|
|
@@ -1427,24 +1399,24 @@ beforeAll(() => {
|
|
|
1427
1399
|
vi.stubEnv('JWT_SECRET', 'x'.repeat(32))
|
|
1428
1400
|
resetEnvCache()
|
|
1429
1401
|
loadEnv(envSchema)
|
|
1430
|
-
})`,docs:`https://kickjs.app/guide/testing.html#environment-isolation`}}}}];function
|
|
1402
|
+
})`,docs:`https://kickjs.app/guide/testing.html#environment-isolation`}}}}];function $n(e,t){let n=null;for(let r of Qn){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 er(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.
|
|
1431
1403
|
export OPENAI_API_KEY="sk-..."
|
|
1432
1404
|
|
|
1433
1405
|
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:
|
|
1434
1406
|
kick add ai
|
|
1435
1407
|
|
|
1436
1408
|
Or manually:
|
|
1437
|
-
pnpm add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=
|
|
1438
|
-
`)}function
|
|
1409
|
+
pnpm add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=tr(e.cwd),s=`Error or stack trace:\n\n${e.input.trim()}`;try{let e=nr((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 tr(e){return[`You are a diagnostic assistant for KickJS, a decorator-driven Node.js`,`framework built on Express 5 and TypeScript. KickJS projects use:`,` - @Controller, @Get, @Post, @Autowired, @Service, @Value decorators`,` - An AppModule interface with a routes() method (NOT a @Module decorator)`,` - Zod schemas as both runtime validators and OpenAPI sources`,` - Ctx<KickRoutes.ControllerName['method']> for typed request context`,` - src/config/index.ts with defineEnv/loadEnv for env schema`,' - A side-effect `import "./config"` in src/index.ts to register the schema',` - Container.reset() in beforeEach for DI test isolation`,``,`When the user gives you an error message or stack trace, produce a`,`structured diagnosis that helps them fix the bug. You MUST respond`,`with a single JSON object (no surrounding prose, no markdown fences)`,`matching this shape:`,``,`{`,` "id": "<kebab-case-identifier>",`,` "title": "<one-line problem summary>",`,` "explanation": "<multi-line explanation of what is wrong>",`,` "fix": "<multi-line instructions for fixing the problem>",`,` "codeBefore": "<optional: broken code snippet>",`,` "codeAfter": "<optional: corrected code snippet>",`,` "docs": "<optional: KickJS doc URL that discusses this topic>"`,`}`,``,`The KickJS docs live at https://kickjs.app/ — prefer`,`that domain for any doc links you suggest.`,e?`The project is located at ${e}.`:``].filter(e=>e.length>0).join(`
|
|
1410
|
+
`)}function nr(e){let t=[e,rr(e),ir(e)].filter(e=>e!==null);for(let e of t)try{let t=JSON.parse(e);if(ar(t))return t}catch{continue}return null}function rr(e){let t=e.match(/```(?:json)?\s*\n([\s\S]*?)```/);return t?t[1]?.trim()??null:null}function ir(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 ar(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 or(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 lr(e,t.message);(!n||n.trim().length===0)&&(process.stderr.write(`Error: no input provided.
|
|
1439
1411
|
|
|
1440
1412
|
Pass a message as a positional arg, --message flag, or pipe via stdin:
|
|
1441
1413
|
kick explain "config.get returned undefined"
|
|
1442
1414
|
pnpm test 2>&1 | kick explain
|
|
1443
|
-
`),process.exit(1));let r=
|
|
1444
|
-
`);return}if(i){
|
|
1445
|
-
`),process.exit(2)),
|
|
1446
|
-
`),process.exit(a.kind===`ok`?0:2)),
|
|
1447
|
-
`)}function
|
|
1415
|
+
`),process.exit(1));let r=dr(),i=$n(n,r);if(t.json&&i){process.stdout.write(JSON.stringify({matched:!0,...i},null,2)+`
|
|
1416
|
+
`);return}if(i){fr(n,i.diagnosis,i.confidence);return}t.ai||(t.json&&(process.stdout.write(JSON.stringify({matched:!1},null,2)+`
|
|
1417
|
+
`),process.exit(2)),pr(n,!1),process.exit(2));let a=await er({input:n,model:t.model,cwd:r.cwd});t.json&&(process.stdout.write(JSON.stringify(sr(a),null,2)+`
|
|
1418
|
+
`),process.exit(a.kind===`ok`?0:2)),cr(n,a),process.exit(a.kind===`ok`?0:2)})}function sr(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 cr(e,t){if(t.kind===`ok`){fr(e,t.diagnosis,-1,!0);return}if(t.kind===`unavailable`){process.stdout.write(`\n Explaining: ${mr(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback unavailable: ${t.reason}\n\n`),process.stdout.write(`${Z(t.suggestion,` `)}\n\n`);return}process.stdout.write(`\n Explaining: ${mr(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback error: ${t.message}\n\n`)}async function lr(e,t){return e&&e.trim().length>0?e:t&&t.trim().length>0?t:process.stdin.isTTY?``:ur()}function ur(){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 dr(){let e=process.cwd();return{cwd:e,hasFile:t=>w(j(e,t))}}function fr(e,t,n,r=!1){let i=mr(e.trim(),200),a=r?`AI-generated — verify before applying`:hr(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${Z(t.explanation,` `)}\n`),process.stdout.write(`\n Fix:\n${Z(t.fix,` `)}\n`),t.codeBefore&&process.stdout.write(`\n Before:\n${Z(t.codeBefore,` `)}\n`),t.codeAfter&&process.stdout.write(`\n After:\n${Z(t.codeAfter,` `)}\n`),t.docs&&process.stdout.write(`\n Docs: ${t.docs}\n`),process.stdout.write(`
|
|
1419
|
+
`)}function pr(e,t){let n=mr(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.
|
|
1448
1420
|
When @forinda/kickjs-ai ships its provider implementations,
|
|
1449
1421
|
this command will call the configured LLM with the error +
|
|
1450
1422
|
project context and return a structured fix.
|
|
@@ -1463,10 +1435,10 @@ Pass a message as a positional arg, --message flag, or pipe via stdin:
|
|
|
1463
1435
|
|
|
1464
1436
|
`)}function Z(e,t){return e.split(`
|
|
1465
1437
|
`).map(e=>`${t}${e}`).join(`
|
|
1466
|
-
`)}function
|
|
1467
|
-
`,`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
|
|
1438
|
+
`)}function mr(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function hr(e){return e>=90?`high confidence`:e>=70?`good match`:e>=50?`medium confidence`:`low confidence — verify manually`}function gr(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(_r),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(vr)}function _r(e){let t=j(e.entry);w(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=Pe(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 vr(e){let t=process.cwd(),n=yr(t)??Ae(t),r=e.name??n,i=e.global?j(process.env.HOME??`.`,`.mcp.json`):j(t,e.out),a={command:`kick`,args:[`mcp`],cwd:t},o={mcpServers:{}};if(w(i))try{let e=T(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,ke(i,JSON.stringify(o,null,2)+`
|
|
1439
|
+
`,`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 yr(e){let t=j(e,`package.json`);if(!w(t))return null;try{let e=T(t,`utf8`),n=JSON.parse(e);return typeof n.name==`string`?n.name:null}catch{return null}}function br(e){e.command(`tinker`).description(`Interactive REPL with DI container and services loaded`).option(`-e, --entry <file>`,`Entry file to load`,`src/index.ts`).action(async e=>{let t=process.cwd(),n=j(t,e.entry);w(n)||(console.error(`\n Error: ${e.entry} not found.\n`),process.exit(1));let r=Sr(t,`tsx`);r||(console.error(`
|
|
1468
1440
|
Error: tsx not found. Install it: pnpm add -D tsx
|
|
1469
|
-
`),process.exit(1));let i=
|
|
1441
|
+
`),process.exit(1));let i=xr(n,e.entry),a=k(t,`.kick-tinker.mjs`),{writeFileSync:o,unlinkSync:s}=await import(`node:fs`);o(a,i,`utf-8`);try{let e=Ne(a,[],{cwd:t,execPath:r,stdio:`inherit`});await new Promise(t=>{e.on(`exit`,()=>t())})}finally{try{s(a)}catch{}}})}function xr(e,t){return`
|
|
1470
1442
|
import 'reflect-metadata'
|
|
1471
1443
|
|
|
1472
1444
|
// Prevent bootstrap() from starting the HTTP server
|
|
@@ -1520,47 +1492,47 @@ server.on('exit', () => {
|
|
|
1520
1492
|
console.log('\\n Goodbye!\\n')
|
|
1521
1493
|
process.exit(0)
|
|
1522
1494
|
})
|
|
1523
|
-
`}function
|
|
1495
|
+
`}function Sr(e,t){let n=e;for(;;){let e=k(n,`node_modules`,`.bin`,t);if(w(e))return e;let r=j(n,`..`);if(r===n)break;n=r}return null}function Cr(e,t){let n=RegExp(`^\\s*${z(t)}Module\\b`),r=!1,i=0,a=e;for(;;){let e=a.indexOf(`.mount(`,i);if(e===-1)break;let t=e+7,o=1,s=t;for(;s<a.length&&o>0;){let e=a.slice(s,s+2);if(e===`//`||e===`/*`){if(e===`//`)for(s+=2;s<a.length&&a[s]!==`
|
|
1524
1496
|
`;)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]===`
|
|
1525
|
-
`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t;continue}i=s+1}return{content:a,changed:r}}function
|
|
1497
|
+
`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t;continue}i=s+1}return{content:a,changed:r}}function wr(e,t){let n=jt(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=Cr(a,t).content,a=a.replace(RegExp(`\\s*,?\\s*${z(t)}Module\\b(?:\\s*\\(\\s*\\))?\\s*,?`,`g`),e=>{let t=e.trimStart().startsWith(`,`),n=e.trimEnd().endsWith(`,`);return t&&n?`,`:``}),a=a.replace(/,(\s*])/,`$1`),e.slice(0,r)+a+e.slice(i)}async function Tr(e){let{name:t,modulesDir:n,force:r}=e,i=e.pluralize!==!1,a=L(t),o=F(t),s=i?R(a):a,c=k(n,s);if(!await v(c)){console.log(`\n Module not found: ${c}\n`);return}if(!r&&!await S({message:x.red(`Delete module '${s}' at ${c}? This cannot be undone.`),initialValue:!1})){console.log(`
|
|
1526
1498
|
Cancelled.
|
|
1527
|
-
`);return}await
|
|
1499
|
+
`);return}await ze(c,{recursive:!0,force:!0}),console.log(` Deleted: ${c}`);let l=k(n,`index.ts`);if(await v(l)){let e=await N(l,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${z(o)}Module\\s*\\}\\s*from\\s*['"][^'"]*${z(s)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=wr(e,o),e=e.replace(/\n{3,}/g,`
|
|
1528
1500
|
|
|
1529
|
-
`),e!==t&&(await P(l,e,`utf-8`),console.log(` Unregistered: ${o}Module from ${l}`))}console.log(`\n Module '${s}' removed.\n`)}function
|
|
1501
|
+
`),e!==t&&(await P(l,e,`utf-8`),console.log(` Unregistered: ${o}Module from ${l}`))}console.log(`\n Module '${s}' removed.\n`)}function Er(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=l(await u(process.cwd())),r=t.modulesDir??n.dir??`src/modules`,i=t.pluralize===!1?!1:n.pluralize??!0;for(let n of e)await Tr({name:n,modulesDir:j(r),force:t.force,pluralize:i})})}function Dr(e){if(e!==void 0){if(e===`false`||e===`off`||e===`none`)return!1;if(e===`zod`)return`zod`;if(e===`kickjs-schema`||e===`schema`)return`kickjs-schema`;console.warn(` kick typegen: unknown --schema-validator '${e}' (supported: 'zod', 'kickjs-schema', 'false'). Falling back to project config.`)}}function Or(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function kr(e){e.command(`typegen`).description(`Generate type-safe DI registry and module types into .kickjs/types/`).option(`-w, --watch`,`Watch source files and regenerate on change`).option(`-s, --src <dir>`,`Source directory to scan`,`src`).option(`-o, --out <dir>`,`Output directory`,`.kickjs/types`).option(`--silent`,`Suppress output`).option(`--allow-duplicates`,`Auto-namespace duplicate class names instead of failing (use with caution)`).option(`--schema-validator <name>`,`Schema validator for body/query/params typing (currently 'zod' or 'false')`).option(`--env-file <path>`,`Path to env schema file for KickEnv typing (default 'src/env.ts'; pass 'false' to disable)`).option(`--check`,`CI gate: exit non-zero if any generated file in .kickjs/types/ is out of date (routes, env, db, assets, adopter plugins) instead of writing it`).option(`--fix`,`Patch module import.meta.glob() calls to cover decorated classes that aren't loaded by any glob (orphans)`).option(`--list`,"List every registered typegen plugin id (use to populate `typegen.disable`)").option(`--no-cache`,`Disable the persistent scan cache; re-read + re-extract every file from cold`).action(async e=>{let t=se(process.cwd()),n=await u(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-DLmjmJ0w.mjs`).then(e=>e.t),{builtinCliPlugins:t}=await Promise.resolve().then(()=>Ea),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(`
|
|
1530
1502
|
Registered typegen plugins:
|
|
1531
|
-
`);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=
|
|
1503
|
+
`);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=Dr(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=Or(e.envFile)??n?.typegen?.envFile,a={cwd:t,srcDir:e.src??n?.typegen?.srcDir,outDir:e.out??n?.typegen?.outDir,silent:e.silent,fix:e.fix,allowDuplicates:e.allowDuplicates,noCache:e.cache===!1,schemaValidator:r,envFile:i,assetMap:n?.assetMap,runPlugins:!1};try{if(e.watch){let t=await ye(a);e.silent||console.log(` kick typegen: watching for changes (Ctrl-C to exit)`);let n=()=>{t(),process.exit(0)};process.on(`SIGINT`,n),process.on(`SIGTERM`,n),await new Promise(()=>{})}else{await xe(a);let r=await On({cwd:t,config:n??null,silent:e.silent,check:e.check});e.check&&r.some(e=>e.status===`written`)&&process.exit(1),e.check||await me(j(t,e.out??n?.typegen?.outDir??`.kickjs/types`),r,e.silent??!1)}}catch(e){e instanceof be?console.error(`
|
|
1532
1504
|
`+e.message+`
|
|
1533
|
-
`):e instanceof
|
|
1505
|
+
`):e instanceof pn?console.error(`
|
|
1534
1506
|
`+e.message+`
|
|
1535
|
-
`):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}function
|
|
1507
|
+
`):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}function Ar(e){let t=[];if(!w(e))return t;let n=E(e,{withFileTypes:!0});for(let r of n){let n=k(e,r.name);if(r.isDirectory()){if([`node_modules`,`dist`,`.kickjs`,`.git`].includes(r.name))continue;t.push(...Ar(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function jr(e){try{return T(e,`utf-8`)}catch{return``}}const Mr=new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function Nr(e,t){let n=jr(k(e,`.env`));if(n){let e=n.match(/^JWT_SECRET\s*=\s*['"]?([^'"\n]*)['"]?/m);if(e){let t=e[1].trim();if(Mr.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 Pr(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 Fr(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 Ir(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function Lr(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 Rr(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 zr(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 Br(e){let t=Ar(k(e,`src`)).map(e=>jr(e)),n=[],r=Nr(e,t);r&&n.push(r);let i=Pr(t);i&&n.push(i);let a=Fr(t);a&&n.push(a);let o=Ir();o&&n.push(o);let s=Lr(t);return s&&n.push(s),n.push(Rr(t)),n.push(zr(t)),n}function Vr(e){e.command(`check`).description(`Audit project for common issues`).option(`--deploy`,`Run production readiness checks`).action(e=>{if(!e.deploy){console.log(`
|
|
1536
1508
|
Usage: kick check --deploy
|
|
1537
1509
|
|
|
1538
1510
|
Available checks:
|
|
1539
1511
|
--deploy Audit for production readiness (security, config, best practices)
|
|
1540
|
-
`);return}let t=process.cwd();
|
|
1541
|
-
Install a supported version via nvm / fnm / volta.`}:{name:`Node version`,status:`pass`,message:e}}function
|
|
1512
|
+
`);return}let t=process.cwd();te(`KickJS Deploy Check`);let n=ne();n.start(`Scanning project...`);let r=Br(t);n.stop(`Scan complete`);let i={CRITICAL:0,WARNING:1,INFO:2};r.sort((e,t)=>i[e.severity]-i[t.severity]);for(let e of r)y.message(`${ae(e.severity)} ${e.message}`);let a=r.filter(e=>e.severity===`CRITICAL`).length,o=r.filter(e=>e.severity===`WARNING`).length,s=r.filter(e=>e.severity===`INFO`).length,c=o===1?`warning`:`warnings`,l=[a>0?x.red(`${a} critical`):`${a} critical`,o>0?x.yellow(`${o} ${c}`):`${o} ${c}`,`${s} info`].join(`, `);a>0?(C(x.red(`${l} — fix critical issues before deploying`)),process.exit(1)):C(x.green(`${l} — looking good!`))})}function Hr(e){try{return JSON.parse(T(e,`utf-8`))}catch{return null}}function Ur(e){try{return T(e,`utf-8`)}catch{return null}}function Wr(e){let t=e.replace(/\/\*[\s\S]*?\*\//g,``).replace(/(^|[^:"'\\])\/\/.*$/gm,`$1`).replace(/,(\s*[}\]])/g,`$1`);try{return JSON.parse(t)}catch{return null}}function Gr(e){let t=k(e,`tsconfig.json`);if(w(t))return Kr(t,new Set)}function Kr(e,t){if(t.has(e)||t.size>=16)return null;t.add(e);let n=Ur(e);if(n===null)return null;let r=Wr(n);if(typeof r!=`object`||!r)return null;let i=Array.isArray(r.extends)?r.extends:typeof r.extends==`string`?[r.extends]:[],a={};for(let n of i){if(typeof n!=`string`)continue;let r=qr(O(e),n);if(!r)continue;let i=Kr(r,t);i&&Object.assign(a,i.compilerOptions)}return r.compilerOptions={...a,...r.compilerOptions},r}function qr(e,t){if(t.startsWith(`.`)||t.startsWith(`/`))return Jr(j(e,t));let n=e;for(;;){let e=Jr(k(n,`node_modules`,t));if(e)return e;let r=O(n);if(r===n)break;n=r}return null}function Jr(e){if(w(e)){try{if(Oe(e).isDirectory()){let t=k(e,`tsconfig.json`);return w(t)?t:null}}catch{return null}return e}let t=`${e}.json`;return w(t)?t:null}function Yr(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}function Xr(){let e=process.version,t=Number.parseInt(e.replace(/^v/,``).split(`.`)[0],10);return Number.isNaN(t)||t<20?{name:`Node version`,status:`fail`,message:e,fix:`KickJS requires Node 20 or newer.
|
|
1513
|
+
Install a supported version via nvm / fnm / volta.`}:{name:`Node version`,status:`pass`,message:e}}function Zr(e){if(!e.pkg)return{name:`@forinda/kickjs installed`,status:`warn`,message:`no package.json`};let t={...e.pkg.dependencies,...e.pkg.peerDependencies};return t[`@forinda/kickjs`]?{name:`@forinda/kickjs installed`,status:`pass`,message:t[`@forinda/kickjs`]}:{name:`@forinda/kickjs installed`,status:`fail`,fix:"This directory does not look like a KickJS project — `@forinda/kickjs` is not in your package.json. Run `kick doctor` from the project root, or scaffold a fresh project with `kick new <name>`."}}function Qr(e){if(!e.pkg)return null;let t={...e.pkg.dependencies,...e.pkg.peerDependencies};return t[`@forinda/kickjs`]&&!t.express?{name:`express installed`,status:`fail`,fix:"`@forinda/kickjs` declares `express` as a required peer dependency, but your package.json does not include it. Install: pnpm add express"}:t.express?{name:`express installed`,status:`pass`,message:t.express}:null}const $r={express:[],fastify:[`fastify`,`@fastify/middie`],h3:[`h3`]};function ei(e){if(!e.pkg||e.runtime===`express`)return null;let t={...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies},n=$r[e.runtime].filter(e=>!t[e]),r=`runtime engine (${e.runtime})`;return n.length>0?{name:r,status:`fail`,fix:`Resolved runtime '${e.runtime}' is missing engine peer(s): ${n.join(`, `)}.\nInstall: pnpm add ${n.join(` `)}`}:{name:r,status:`pass`}}function ti(e){if(!e.pkg||!ri(e.cwd))return null;let t=r[e.runtime],n=`upload driver (${e.runtime})`;return t.prod?{...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies}[t.prod]?{name:n,status:`pass`,message:t.prod}:{name:n,status:`fail`,fix:`This project uses file uploads on the '${e.runtime}' runtime, which needs '${t.prod}'.\nInstall it: kick add upload (or pnpm add ${t.prod})`}:{name:n,status:`pass`,message:`native multipart`}}const ni=2e3;function ri(e){let t=k(e,`src`);if(!w(t))return!1;let n=/@FileUpload\b|\bupload\.(single|array|none)\s*\(/,r=[t],i=0;for(;r.length>0&&i<ni;){let e=r.pop(),t;try{t=E(e,{withFileTypes:!0})}catch{continue}for(let a of t){if(i>=ni)break;let t=k(e,a.name);if(a.isDirectory()){a.name!==`node_modules`&&r.push(t);continue}if(/\.(ts|tsx|mts|cts)$/.test(a.name)&&(i++,n.test(Ur(t)??``)))return!0}}return!1}function ii(e){if(!e.pkg)return{name:`reflect-metadata installed`,status:`warn`,message:`no package.json`};let t={...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies};return t[`reflect-metadata`]?{name:`reflect-metadata installed`,status:`pass`,message:t[`reflect-metadata`]}:{name:`reflect-metadata installed`,status:`fail`,fix:`KickJS decorators require the reflect-metadata polyfill.
|
|
1542
1514
|
Install it: pnpm add reflect-metadata
|
|
1543
1515
|
Then import it at the top of src/index.ts:
|
|
1544
1516
|
|
|
1545
1517
|
import 'reflect-metadata'
|
|
1546
|
-
// ... rest of bootstrap`}}function
|
|
1518
|
+
// ... rest of bootstrap`}}function ai(e){if(e.tsconfig===void 0)return[{name:`tsconfig.json present`,status:`fail`,fix:"Create a tsconfig.json with `experimentalDecorators: true` and `emitDecoratorMetadata: true`. `kick new` scaffolds one automatically."}];if(e.tsconfig===null)return[{name:`tsconfig.json readable`,status:`warn`,message:`could not parse tsconfig.json (or a config it extends)`,fix:"Check tsconfig.json for a syntax error, and that every path in its `extends` chain resolves. Decorator options could not be verified."}];let t=e.tsconfig.compilerOptions??{},n=[];return n.push(t.experimentalDecorators===!0?{name:`tsconfig: experimentalDecorators`,status:`pass`}:{name:`tsconfig: experimentalDecorators`,status:`fail`,fix:'Add `"experimentalDecorators": true` to compilerOptions in tsconfig.json. Without it, @Service / @Controller / @Get etc. don\'t register any metadata at compile time.'}),n.push(t.emitDecoratorMetadata===!0?{name:`tsconfig: emitDecoratorMetadata`,status:`pass`}:{name:`tsconfig: emitDecoratorMetadata`,status:`fail`,fix:'Add `"emitDecoratorMetadata": true` to compilerOptions in tsconfig.json. The DI container uses this metadata for constructor-parameter injection.'}),n}function oi(e){let t=[`src/env.ts`,`src/env/index.ts`,`src/config/env.ts`,`src/config/index.ts`].map(t=>k(e.cwd,t)).filter(e=>w(e)).filter(e=>/\bloadEnv\s*\(/.test(Ur(e)??``));if(t.length===0)return null;let n=[`src/index.ts`,`src/main.ts`].map(t=>k(e.cwd,t)).find(e=>w(e));if(!n)return{name:`env wiring`,status:`warn`,message:`env-init file exists but no src/index.ts or src/main.ts found`};let r=Ur(n)??``,i=O(n),a=[];for(let e of t){let t=A(i,e).replace(/\\/g,`/`).replace(/\.ts$/,``),n=t.startsWith(`.`)?t:`./`+t,r=n.replace(/\/index$/,``);a.push(n,r);let o=e.replace(/\\/g,`/`).match(/\/src\/(.+?)(?:\.ts)?$/);if(o){let e=`@/`+o[1],t=e.replace(/\/index$/,``);a.push(e,t)}}let o=-1;for(let e of new Set(a)){let t=RegExp(`^import\\s+(?:.*?from\\s+)?['"]${Yr(e)}['"]`,`m`),n=r.match(t);n&&n.index!==void 0&&(o===-1||n.index<o)&&(o=n.index)}let s=r.search(/\bbootstrap\s*\(/),c=t.map(t=>A(e.cwd,t).replace(/\\/g,`/`)).join(`, `);return o===-1?{name:`env wiring`,status:`fail`,message:c,fix:`An env-init file (${c}) calls \`loadEnv(...)\` but \`${A(e.cwd,n).replace(/\\/g,`/`)}\` doesn't import it.\nWithout this, ConfigService.get('X') returns undefined while @Value('X') works via process.env fallback — a half-broken config you won't notice until something is missing.\n\nFix: add a side-effect import at the top of ${A(e.cwd,n).replace(/\\/g,`/`)} (above bootstrap()), pointing at one of the detected files. For example:\n\n import './env'\n // or\n import './config'\n // or, with the @/ alias:\n import '@/config/env'`}:s!==-1&&o>s?{name:`env wiring`,status:`warn`,message:`env-init imported AFTER bootstrap() — should be before`,fix:`Move the env import above the bootstrap() call so the schema runs before any service reads from ConfigService.`}:{name:`env wiring`,status:`pass`}}function si(e,t=ci){let n=0,r=0,i=[e];for(;i.length>0&&r<t;){let e=i.pop(),a;try{a=E(e,{withFileTypes:!0})}catch{continue}for(let o of a){if(r>=t)break;r++;let a=k(e,o.name);if(o.isDirectory()){i.push(a);continue}try{let e=Oe(a).mtimeMs;e>n&&(n=e)}catch{}}}return n}const ci=2e3;function li(e){let t=k(e.cwd,`.kickjs`,`types`);if(!w(t))return null;let n=si(t);if(n===0)return null;let r=Date.now()-n,i=Math.floor(r/6e4);return i>60?{name:`typegen freshness`,status:`warn`,message:`last updated ${i} minutes ago`,fix:"Re-run `kick typegen` (or `kick dev`, which runs it on every reload) so generated types match the current code."}:{name:`typegen freshness`,status:`pass`,message:i===0?`just now`:`${i}m ago`}}const ui=[`vitest.config.ts`,`vitest.config.js`,`vitest.config.mts`,`vite.config.ts`,`jest.config.ts`,`jest.config.js`],di=[`.env.test`,`.env.test.local`],fi=[`.env`,`.env.local`];function pi(e){let t=e.pkg?.scripts;if(t&&typeof t==`object`)for(let[e,n]of Object.entries(t)){if(!e.startsWith(`test`)||typeof n!=`string`)continue;let t=/KICKJS_ENV_FILE=(\S+)/.exec(n);if(t?.[1])return t[1]}return process.env.KICKJS_ENV_FILE??null}function mi(e){if(!ui.some(t=>w(k(e.cwd,t))))return null;let t=fi.filter(t=>w(k(e.cwd,t)));if(t.length===0)return null;let n=di.filter(t=>w(k(e.cwd,t)));if(n.length>0){let t=pi(e);return t&&t!==`off`&&t!==`none`?{name:`test env isolation`,status:`warn`,message:`${n.join(`, `)} present, but KICKJS_ENV_FILE=${t} overrides it`,fix:`KICKJS_ENV_FILE is checked before test-mode isolation, so ${n[0]} is\nignored and "${t}" is read instead. Drop the override to use the\ntest files, or set KICKJS_ENV_FILE=off if env comes from the runner.`}:{name:`test env isolation`,status:`pass`,message:`${n.join(`, `)} present`}}return{name:`test env isolation`,status:`warn`,message:`${t.join(`, `)} present, no .env.test`,fix:`Under NODE_ENV=test (or vitest's VITEST) KickJS reads .env.test / .env.test.local
|
|
1547
1519
|
INSTEAD of ${t.join(` and `)} — no layering, no fallback. Without one of\nthose files, every var your test config does not pin resolves from your
|
|
1548
1520
|
development env — including DATABASE_URL and any third-party credentials.
|
|
1549
1521
|
|
|
1550
1522
|
Create .env.test holding the whole environment the suite should run against
|
|
1551
1523
|
(a var you leave out is then missing, not inherited), or set KICKJS_ENV_FILE=off
|
|
1552
|
-
and supply env from the test runner.`}}const
|
|
1524
|
+
and supply env from the test runner.`}}const hi=[()=>Xr(),Zr,Qr,ei,ti,ii,ai,oi,mi,li];async function gi(e,t={}){let n={cwd:e,pkg:Hr(k(e,`package.json`)),tsconfig:Gr(e),runtime:t.runtime??`express`},r=[...hi,...t.extraChecks??[]],i=[];for(let e of r){let t;try{t=await e(n)}catch(t){i.push({name:e.name||`doctor check`,status:`fail`,message:t instanceof Error?t.message:String(t)});continue}t!=null&&(Array.isArray(t)?i.push(...t):i.push(t))}return i}function _i(e){switch(e){case`pass`:return x.green(`✔`);case`warn`:return x.yellow(`⚠`);case`fail`:return x.red(`✖`)}}function vi(e){let t=_i(e.status),n=e.message?` ${x.dim(`(${e.message})`)}`:``;return`${t} ${e.name}${n}`}function yi(e){return e.split(`
|
|
1553
1525
|
`).map(e=>` ${x.dim(`→`)} ${e}`).join(`
|
|
1554
|
-
`)}function
|
|
1526
|
+
`)}function bi(e){return e?.doctor?.checks??[]}function xi(e){e.command(`doctor`).description(`Pre-flight checks for your KickJS project (dev environment health)`).action(async()=>{let e=process.cwd(),t=bi(await u(e)),n=await o(e);te(`KickJS Doctor`);let r=await gi(e,{extraChecks:t,runtime:n});for(let e of r)y.message(vi(e)),e.fix&&e.status!==`pass`&&y.message(yi(e.fix));let i=r.filter(e=>e.status===`pass`).length,a=r.filter(e=>e.status===`warn`).length,s=r.filter(e=>e.status===`fail`).length,c=[x.green(`${i} passed`),a>0?x.yellow(`${a} warning${a===1?``:`s`}`):`${a} warnings`,s>0?x.red(`${s} error${s===1?``:`s`}`):`${s} errors`].join(`, `);s>0?(C(`${c} — fix the errors above before running the app`),process.exit(1)):C(a>0?`${c} — review the warnings`:x.green(`${c} — your environment looks good`))})}function Si(e){return e.optsWithGlobals().dryRun??!1}function Ci(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.
|
|
1555
1527
|
Direction defaults to \`modules.style\` from kick.config (or "define").
|
|
1556
1528
|
--target define|class Override the migration direction.
|
|
1557
1529
|
--apply Apply the changes (default: dry-run preview).
|
|
1558
|
-
--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=
|
|
1530
|
+
--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=Si(t)||!e.apply;g(n),e.experimental||(console.error(`
|
|
1559
1531
|
`+x.red(`Error:`)+` kick codemod modules is experimental — pass --experimental to acknowledge.
|
|
1560
1532
|
The regex-based rewrite handles the shapes our templates produce.
|
|
1561
1533
|
Hand-rolled modules with non-standard structures may be skipped.
|
|
1562
1534
|
Always commit before running with --apply.
|
|
1563
|
-
`),process.exit(1));let r=
|
|
1535
|
+
`),process.exit(1));let r=l(await u(process.cwd())),i=j(e.modulesDir??r.dir??`src/modules`),a;e.target===`define`||e.target===`class`?a=e.target:e.target===void 0?a=r.style??`define`:(console.error(`\n ${x.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let o=x.dim(`→ ${a}`),s=n?x.dim(`(dry-run)`):x.bold(`(applying)`);console.log(`\n ${x.bold(`kick codemod modules`)} ${o} ${s}`),console.log(` modulesDir: ${x.dim(i)}\n`);let c=e.backup!==!1&&!n,d=await nn(i,{dryRun:n,target:a,backup:c});if(d.backupDir){let e=d.backupDir;console.log(` ${x.green(`✓`)} backup: ${x.dim(e)}\n ${x.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else!n&&e.backup===!1&&console.log(` ${x.dim(`(--no-backup — skipping snapshot)`)}\n`);let f=0,p=0;for(let e of d.files)if(e.status===`migrated`)f++,console.log(` ${x.green(`✓`)} ${e.path}`);else{p++;let t=x.dim(`(${e.reason??`skipped`})`);console.log(` ${x.dim(`-`)} ${e.path} ${t}`)}if(console.log(),d.indexStatus===`migrated`)console.log(` ${x.green(`✓`)} ${d.indexPath}`);else if(d.indexStatus===`skipped`){let e=x.dim(`(${d.indexReason??`skipped`})`);console.log(` ${x.dim(`-`)} ${d.indexPath} ${e}`)}else console.log(` ${x.dim(`-`)} ${d.indexPath} ${x.dim(`(not found)`)}`);let m=n?x.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n ${x.bold(String(f))} migrated, ${x.bold(String(p))} skipped${m}\n`)})}const wi=()=>({id:`kick/assets`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`],async generate(e){if(!w(D.resolve(e.cwd,`kick.config.ts`)))return null;let t=await u(e.cwd);if(!t?.assetMap)return null;let n=ce(t.assetMap,e.cwd);return n.count===0?null:_e(n)}}),Ti="/* 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 Ei(e,t,n,r={}){if(e.length===0)return`${Ti}
|
|
1564
1536
|
// (no routes discovered yet — annotate a controller method with
|
|
1565
1537
|
// @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
|
|
1566
1538
|
declare global {
|
|
@@ -1577,18 +1549,18 @@ declare global {
|
|
|
1577
1549
|
|
|
1578
1550
|
/** Empty until the first route exists — see kick typegen. */
|
|
1579
1551
|
export const kickRpc = {} as const
|
|
1580
|
-
`;let i=new Map;for(let t of e){let e=i.get(t.controller)??[];e.push(t),i.set(t.controller,e)}let a=new Map,o=new Map,s=e=>{let t=`${e.filePath}::${e.controller}`,n=o.get(t);return n||(n=`_C${o.size}`,o.set(t,n)),n},c=(e,i,o)=>{let s=
|
|
1552
|
+
`;let i=new Map;for(let t of e){let e=i.get(t.controller)??[];e.push(t),i.set(t.controller,e)}let a=new Map,o=new Map,s=e=>{let t=`${e.filePath}::${e.controller}`,n=o.get(t);return n||(n=`_C${o.size}`,o.set(t,n)),n},c=(e,i,o)=>{let s=Ai(e,i.filePath,t,n,a);if(!s){if(e&&n!==!1){let t=o===`params`?`URL-pattern params`:o===`query`&&i.queryFilterable!==null?`the @ApiQueryParams-derived query shape`:`'unknown'`;r.onWarn?.(`route ${i.controller}.${i.method} (${i.httpMethod} ${i.path}): ${o} schema '${e.identifier}' could not be statically resolved — falling back to ${t}. Export the schema from the controller file or import it with a static specifier.`)}return null}return n===`kickjs-schema`?`import('@forinda/kickjs-schema').InferSchemaOutput<typeof ${s}>`:`import('zod').infer<typeof ${s}>`},l=[];for(let[e,t]of i){let n=[` interface ${e} {`];for(let e of t){let t=e.pathParams.length>0?`{ ${e.pathParams.map(e=>`${e}: string`).join(`; `)} }`:`{}`,r=c(e.bodySchema,e,`body`),i=c(e.querySchema,e,`query`),a=c(e.paramsSchema,e,`params`)??t,o=r??`unknown`,l=i??Oi(e),u=c(e.responseSchema??null,e,`response`),d=s(e),f=u??`import('@forinda/kickjs').InferHandlerResponse<${d}['${e.method}']>`,p=ki(e);n.push(` /**`,` * ${e.httpMethod} ${e.path}`,...p.map(e=>` * ${e}`),` */`,` ${e.method}: {`,` params: ${a}`,` body: ${o}`,` query: ${l}`,` response: ${f}`,` contextKeys: ${Di(e)}`,` }`)}n.push(` }`),l.push(n.join(`
|
|
1581
1553
|
`))}let u=[],d=new Set,f=new Set;i.has(`Api`)&&r.onWarn?.(`controller class 'Api' collides with the reserved KickRoutes.Api client map — its interface declaration-merges into the flat route map. Rename the controller.`);for(let[e,t]of i)for(let n of t){let t=`${n.httpMethod} ${n.mountedPath??n.path}`;if(d.has(t)){r.onWarn?.(`duplicate route '${t}' (${e}.${n.method}) — two handlers claim the same verb+path at runtime. KickRoutes.Api keeps the first (scan order, which may not match runtime dispatch); resolve the conflict in the modules.`);continue}d.add(t),f.add(`${e}.${n.method}`),u.push(` '${t}': ${e}['${n.method}']`)}let p=[` interface Api {`,...u,` }`].join(`
|
|
1582
|
-
`);l.push(p);let m=[],h=new Set;for(let[e,t]of i){let n=
|
|
1554
|
+
`);l.push(p);let m=[],h=new Set;for(let[e,t]of i){let n=Ni(e);if(h.has(n)){r.onWarn?.(`RPC manifest: controller key '${n}' (from ${e}) collides with another controller — keeping the first; rename one class for distinct RPC namespaces.`);continue}h.add(n);let i=[];for(let n of t){if(!f.has(`${e}.${n.method}`))continue;let t=`${n.httpMethod} ${n.mountedPath??n.path}`;i.push(` ${n.method}: '${t}',`)}i.length>0&&m.push(` ${n}: {\n${i.join(`
|
|
1583
1555
|
`)}\n },`)}let g=[`/**`,` * Runtime route manifest for the tRPC-style sugar:`," * `createRpc(api, kickRpc)` from @forinda/kickjs-client.",` */`,`export const kickRpc = {`,...m,`} as const`].join(`
|
|
1584
|
-
`),_=[],v=new Map;for(let t of e)v.set(`${t.filePath}::${t.controller}`,t);for(let[e,n]of o){let r=v.get(e),i=
|
|
1556
|
+
`),_=[],v=new Map;for(let t of e)v.set(`${t.filePath}::${t.controller}`,t);for(let[e,n]of o){let r=v.get(e),i=Mi(``,r.filePath,t),a=r.controllerIsDefaultExport?`default as ${n}`:`${r.controller} as ${n}`;_.push(`import type { ${a} } from '${i}'`)}let y=_.length>0?_.join(`
|
|
1585
1557
|
`)+`
|
|
1586
|
-
`:``,b=
|
|
1587
|
-
`);return`${
|
|
1558
|
+
`:``,b=ji(a)+y,ee=l.join(`
|
|
1559
|
+
`);return`${Ti}${b}
|
|
1588
1560
|
declare global {
|
|
1589
1561
|
// eslint-disable-next-line @typescript-eslint/no-namespace
|
|
1590
1562
|
namespace KickRoutes {
|
|
1591
|
-
${
|
|
1563
|
+
${ee}
|
|
1592
1564
|
}
|
|
1593
1565
|
|
|
1594
1566
|
/** Short alias for \`KickRoutes.Api\` — \`createClient<KickApi>(...)\`. */
|
|
@@ -1596,41 +1568,63 @@ ${x}
|
|
|
1596
1568
|
}
|
|
1597
1569
|
|
|
1598
1570
|
${g}
|
|
1599
|
-
`}function
|
|
1571
|
+
`}function Di(e){let t=e.contextKeys;return t==null?`string`:t.length===0?`never`:t.map(e=>JSON.stringify(e)).join(` | `)}function Oi(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 ki(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 Ai(e,t,n,r,i){if(!e||r===!1||e.source===null)return null;let a=Mi(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 ji(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(`
|
|
1600
1572
|
`)+`
|
|
1601
|
-
`}function
|
|
1602
|
-
TypeScript 7 does not ship a compiler API, so the compatibility package is required.\n ${t}`):Error(`kick typegen: the client route map needs a TypeScript compiler API, and neither 'typescript' nor '${
|
|
1573
|
+
`}function Mi(e,t,n){if(e===null)return`unknown`;let r=O(n);if(e===``){let e=A(r,t).split(je).join(`/`);return e=e.replace(/\.(ts|tsx|mts|cts)$/i,``),e.startsWith(`.`)||(e=`./`+e),e}if(!e.startsWith(`.`)&&!e.startsWith(`/`))return e;let i=A(r,j(O(t),e)).split(je).join(`/`);return i=i.replace(/\.(ts|tsx|mts|cts)$/i,``),i.startsWith(`.`)||(i=`./`+i),i}function Ni(e){let t=e.endsWith(`Controller`)?e.slice(0,-10):e,n=t.length>0?t:e;return n.charAt(0).toLowerCase()+n.slice(1)}const Pi=()=>({id:`kick/routes`,outExtension:`.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){let t=await e.getScanResult({root:Fi(e),cwd:e.cwd,envFile:Ii(e)}),n=e.config?.typegen?.schemaValidator??`zod`,r=D.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return Ei(t.routes,r,n,{onWarn:t=>e.log.warn(t)})}});function Fi(e){return D.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Ii(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}const Li=`@typescript/typescript6`;function Ri(e){return typeof e?.createProgram==`function`}function zi(e){if(Ri(e.typescript))return{api:e.typescript,source:`typescript`};if(Ri(e.ts6))return{api:e.ts6,source:Li};let t=`Install it in the project:\n pnpm add -D ${Li}`;throw e.typescript?Error(`kick typegen: the client route map needs a TypeScript compiler API.
|
|
1574
|
+
TypeScript 7 does not ship a compiler API, so the compatibility package is required.\n ${t}`):Error(`kick typegen: the client route map needs a TypeScript compiler API, and neither 'typescript' nor '${Li}' resolved from this project.\n ${t}`)}async function Bi(e){let t=we(k(e,`package.json`)),n=async e=>{try{return await import(M(t.resolve(e)).href)}catch{return null}},[r,i]=await Promise.all([n(`typescript`),n(Li)]);return zi({typescript:Vi(r),ts6:Vi(i)}).api}function Vi(e){let t=e;return t?.default&&typeof t.default==`object`?t.default:e}var Hi=class{ts;checker;program;opts;hoistedByType=new Map;blocks=[];maxDepth;constructor(e,t,n,r={}){this.ts=e,this.checker=t,this.program=n,this.opts=r,this.maxDepth=r.maxDepth??12}hoisted(){return this.blocks}expand(e){return this.render(e,0)}render(e,t){let n=this.ts.TypeFlags;if(t>this.maxDepth)return this.opts.onWarn?.(`type nesting exceeded ${this.maxDepth} levels — emitting 'unknown'. Declare a response schema on the route for an exact type.`),`unknown`;if(e.flags&(n.String|n.Number|n.Boolean|n.BigInt|n.ESSymbol)||e.flags&(n.Any|n.Unknown|n.Never|n.Void|n.Undefined|n.Null)||e.isLiteral()||e.flags&n.BooleanLiteral)return this.checker.typeToString(e);if(e.isUnion())return e.types.map(e=>this.render(e,t+1)).join(` | `);if(e.isIntersection())return e.types.map(e=>this.render(e,t+1)).join(` & `);if(this.isTuple(e))return this.renderTuple(e,t);let r=this.arrayElement(e);if(r){let e=this.render(r.element,t+1),n=/[|&]/.test(e)?`(${e})[]`:`${e}[]`;return r.readonly?`readonly ${n}`:n}return this.isLibType(e)?this.renderLibType(e,t):e.flags&n.Object?this.renderObject(e,t):(this.opts.onWarn?.(`could not expand type '${this.checker.typeToString(e)}' — emitting 'unknown'`),`unknown`)}renderObject(e,t){let n=this.hoistedByType.get(e);if(n)return n;if(this.isNamed(e)){let t=`__T${this.hoistedByType.size}`;this.hoistedByType.set(e,t);let n=this.blocks.length;return this.blocks.push(``),this.blocks[n]=`interface ${t} {\n${this.members(e,0,` `)}\n}`,t}let r=this.members(e,t,``,`; `);return r.length>0?`{ ${r} }`:`{}`}members(e,t,n,r=`
|
|
1603
1575
|
`){let i=[];for(let r of this.checker.getIndexInfosOfType(e)){let e=this.checker.typeToString(r.keyType);i.push(`${n}[key: ${e}]: ${this.render(r.type,t+1)}`)}for(let r of this.checker.getPropertiesOfType(e)){let e=this.typeOfProperty(r),a=(r.flags&this.ts.SymbolFlags.Optional)!==0,o=this.renderPropertyType(e,a,r,t+1),s=this.isReadonlyProp(r)?`readonly `:``;i.push(`${n}${s}${this.propName(r.getName())}${a?`?`:``}: ${o}`)}return i.join(r===`
|
|
1604
1576
|
`?`
|
|
1605
|
-
`:r)}typeOfProperty(e){let t=this.checker;if(typeof t.getTypeOfSymbol==`function`)return t.getTypeOfSymbol(e);let n=e.valueDeclaration??e.declarations?.[0];return n?this.checker.getTypeOfSymbolAtLocation(e,n):this.checker.getDeclaredTypeOfSymbol(e)}renderPropertyType(e,t,n,r){if(!t||!e.isUnion()||this.declaresUndefined(n))return this.render(e,r);let i=e.types.filter(e=>!(e.flags&this.ts.TypeFlags.Undefined));return i.length===0?`undefined`:i.map(e=>this.render(e,r)).join(` | `)}isReadonlyProp(e){let t=e.valueDeclaration??e.declarations?.[0];return t?(this.ts.getCombinedModifierFlags(t)&this.ts.ModifierFlags.Readonly)!==0:!1}declaresUndefined(e){let t=e.valueDeclaration??e.declarations?.[0];if(!t||!(this.ts.isPropertySignature(t)||this.ts.isPropertyDeclaration(t))||!t.type)return!1;let n=this.checker.getTypeFromTypeNode(t.type);return(n.isUnion()?n.types:[n]).some(e=>(e.flags&this.ts.TypeFlags.Undefined)!==0)}renderTuple(e,t){let n=this.ts.ElementFlags,r=this.checker.getTypeArguments(e),i=e.target,a=i.elementFlags??[],o=r.map((e,r)=>{let i=a[r]??n.Required;return i&n.Optional?`${(e.isUnion()?e.types.filter(e=>!(e.flags&this.ts.TypeFlags.Undefined)):[e]).map(e=>this.render(e,t+1)).join(` | `)}?`:i&n.Rest?`...${this.render(e,t+1)}[]`:i&n.Variadic?`...${this.render(e,t+1)}`:this.render(e,t+1)});return`${i.readonly?`readonly `:``}[${o.join(`, `)}]`}propName(e){return/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(e)?e:JSON.stringify(e)}isLibType(e){let t=e.aliasSymbol?.declarations??e.getSymbol()?.declarations;return!t||t.length===0?!1:t.every(e=>this.program.isSourceFileDefaultLibrary(e.getSourceFile()))}renderLibType(e,t){let n=(e.aliasSymbol??e.getSymbol())?.getName(),r=e.aliasTypeArguments??this.typeArguments(e);return!n||r.length===0?this.checker.typeToString(e):`${n}<${r.map(e=>this.render(e,t+1)).join(`, `)}>`}typeArguments(e){return!(e.flags&this.ts.TypeFlags.Object)||!(e.objectFlags&this.ts.ObjectFlags.Reference)?[]:this.checker.getTypeArguments(e)}isNamed(e){let t=e.getSymbol();if(!t)return!1;let n=t.getName();return n!==`__type`&&n!==`__object`&&n.length>0}isTuple(e){let t=this.ts.ObjectFlags;if(!(e.flags&this.ts.TypeFlags.Object)||!(e.objectFlags&t.Reference))return!1;let n=e.target;return!!(n&&n.objectFlags&t.Tuple)}arrayElement(e){let t=e.getSymbol()?.getName();if(t!==`Array`&&t!==`ReadonlyArray`)return null;let n=this.checker.getTypeArguments(e);return n.length===1?{element:n[0],readonly:t===`ReadonlyArray`}:null}};
|
|
1606
|
-
`);throw Error(
|
|
1577
|
+
`:r)}typeOfProperty(e){let t=this.checker;if(typeof t.getTypeOfSymbol==`function`)return t.getTypeOfSymbol(e);let n=e.valueDeclaration??e.declarations?.[0];return n?this.checker.getTypeOfSymbolAtLocation(e,n):this.checker.getDeclaredTypeOfSymbol(e)}renderPropertyType(e,t,n,r){if(!t||!e.isUnion()||this.declaresUndefined(n))return this.render(e,r);let i=e.types.filter(e=>!(e.flags&this.ts.TypeFlags.Undefined));return i.length===0?`undefined`:i.map(e=>this.render(e,r)).join(` | `)}isReadonlyProp(e){let t=e.valueDeclaration??e.declarations?.[0];return t?(this.ts.getCombinedModifierFlags(t)&this.ts.ModifierFlags.Readonly)!==0:!1}declaresUndefined(e){let t=e.valueDeclaration??e.declarations?.[0];if(!t||!(this.ts.isPropertySignature(t)||this.ts.isPropertyDeclaration(t))||!t.type)return!1;let n=this.checker.getTypeFromTypeNode(t.type);return(n.isUnion()?n.types:[n]).some(e=>(e.flags&this.ts.TypeFlags.Undefined)!==0)}renderTuple(e,t){let n=this.ts.ElementFlags,r=this.checker.getTypeArguments(e),i=e.target,a=i.elementFlags??[],o=r.map((e,r)=>{let i=a[r]??n.Required;return i&n.Optional?`${(e.isUnion()?e.types.filter(e=>!(e.flags&this.ts.TypeFlags.Undefined)):[e]).map(e=>this.render(e,t+1)).join(` | `)}?`:i&n.Rest?`...${this.render(e,t+1)}[]`:i&n.Variadic?`...${this.render(e,t+1)}`:this.render(e,t+1)});return`${i.readonly?`readonly `:``}[${o.join(`, `)}]`}propName(e){return/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(e)?e:JSON.stringify(e)}isLibType(e){let t=e.aliasSymbol?.declarations??e.getSymbol()?.declarations;return!t||t.length===0?!1:t.every(e=>this.program.isSourceFileDefaultLibrary(e.getSourceFile()))}renderLibType(e,t){let n=(e.aliasSymbol??e.getSymbol())?.getName(),r=e.aliasTypeArguments??this.typeArguments(e);return!n||r.length===0?this.checker.typeToString(e):`${n}<${r.map(e=>this.render(e,t+1)).join(`, `)}>`}typeArguments(e){return!(e.flags&this.ts.TypeFlags.Object)||!(e.objectFlags&this.ts.ObjectFlags.Reference)?[]:this.checker.getTypeArguments(e)}isNamed(e){let t=e.getSymbol();if(!t)return!1;let n=t.getName();return n!==`__type`&&n!==`__object`&&n.length>0}isTuple(e){let t=this.ts.ObjectFlags;if(!(e.flags&this.ts.TypeFlags.Object)||!(e.objectFlags&t.Reference))return!1;let n=e.target;return!!(n&&n.objectFlags&t.Tuple)}arrayElement(e){let t=e.getSymbol()?.getName();if(t!==`Array`&&t!==`ReadonlyArray`)return null;let n=this.checker.getTypeArguments(e);return n.length===1?{element:n[0],readonly:t===`ReadonlyArray`}:null}};const Ui=[`pnpm-lock.yaml`,`package-lock.json`,`yarn.lock`,`bun.lock`,`bun.lockb`],Wi=/(?:^|[\\/])(?:node_modules|\.kickjs)(?:[\\/]|$)/;function Gi(e){return Ge(`sha1`).update(e).digest(`hex`)}function Ki(e){let t=Ge(`sha1`);t.update(e.cliVersion),t.update(JSON.stringify(e.options??{})),t.update(e.keys.join(`
|
|
1578
|
+
`));for(let n of Ui){let r=k(e.projectDir,n);if(w(r))try{t.update(T(r))}catch(e){throw Error(`kick/client: cannot read lockfile ${r}`,{cause:e})}}for(let n of e.fileNames.toSorted())if(!Wi.test(n)){t.update(n);try{t.update(T(n))}catch(e){throw Error(`kick/client: cannot read project file ${n}`,{cause:e})}}return t.digest(`hex`)}async function qi(e){try{let t=await Bi(e.compilerFrom??e.projectDir),n={...t.sys,onUnRecoverableConfigFileDiagnostic:()=>{}},r=t.getParsedCommandLineOfConfigFile(k(e.projectDir,`tsconfig.json`),{},n);return r?Ki({projectDir:e.projectDir,fileNames:r.fileNames,keys:e.keys,options:r.options,cliVersion:e.cliVersion}):null}catch{return null}}async function Ji(e){let t=await Bi(e.compilerFrom??e.projectDir),n=k(O(e.routesFile),`__kick_client_probe__.ts`),r=Zi(e.routesFile,e.keys),i=ea(t,e.projectDir,n,r),a=i.getTypeChecker(),o=i.getSourceFile(n);if(!o)throw Error(`kick/client: could not add the resolution probe to the program. Check that ${e.routesFile} exists — run \`kick typegen\` first.`);Yi(t,i,e.routesFile);let s=Qi(t,i,o,e.keys),c=null,l=new Hi(t,a,i,{onWarn:t=>e.onWarn?.(c?`route '${c}': ${t}`:t)}),u=new Map;for(let[n,r]of e.keys.entries()){if(s.has(r)){e.onWarn?.(`route '${r}' is not present in KickRoutes.Api — skipped. Re-run \`kick typegen\` so the two maps agree.`);continue}let i=o.statements.find(e=>t.isTypeAliasDeclaration(e)&&e.name.text===Xi(n));if(!i){e.onWarn?.(`route '${r}' could not be resolved — skipped.`);continue}let d=a.getTypeAtLocation(i.type);if(d.flags&t.TypeFlags.Any){e.onWarn?.(`route '${r}' resolved to 'any' — skipped rather than emitted, since an 'any' entry silently accepts every call. Check that the server type-checks.`);continue}c=r,u.set(r,l.expand(d)),c=null}return{entries:u,hoisted:l.hoisted()}}function Yi(e,t,n){let r=t.getSourceFile(n);if(!r)throw Error(`kick/client: ${n} is not in the TypeScript program. Run \`kick typegen\` first, and check that tsconfig.json includes .kickjs.`);let i=t.getSemanticDiagnostics(r);if(i.length===0)return;let a=i.slice(0,3).map(t=>` ${e.flattenDiagnosticMessageText(t.messageText,` `)}`).join(`
|
|
1579
|
+
`);throw Error(`${n} has ${i.length} type error(s), so its route types cannot be resolved — every entry would come out as 'any'.\n${a}\n Usually this means dependencies are not installed or the server does not type-check.`)}function Xi(e){return`_K${e}`}function Zi(e,t){let n=`./`+Ae(e).replace(/\.tsx?$/,``),r=t.map((e,t)=>`type ${Xi(t)} = KickRoutes.Api[${JSON.stringify(e)}]`);return[`import ${JSON.stringify(n)}`,...r].join(`
|
|
1607
1580
|
`)+`
|
|
1608
|
-
`}function
|
|
1609
|
-
`))}},o=e.getParsedCommandLineOfConfigFile(i,{},a);if(!o)throw Error(`kick/client: could not read ${i}`);let s=e.createCompilerHost(o.options,!0),c=s.readFile.bind(s),l=s.getSourceFile.bind(s),u=s.fileExists.bind(s);return s.readFile=e=>e===n?r:c(e),s.fileExists=e=>e===n||u(e),s.getSourceFile=(t,i,a,o)=>t===n?e.createSourceFile(t,r,i,!0):l(t,i,a,o),e.createProgram({rootNames:[
|
|
1581
|
+
`}function Qi(e,t,n,r){let i=new Set,a=new Map;for(let t of n.statements)e.isTypeAliasDeclaration(t)&&a.set(t.name.text,t);for(let e of t.getSemanticDiagnostics(n))if(e.start!==void 0)for(let[t,o]of r.entries()){let r=a.get(Xi(t));r&&e.start>=r.getStart(n)&&e.start<r.getEnd()&&i.add(o)}return i}function $i(e,t){let n=e.filter(e=>/\.d\.(ts|mts|cts)$/.test(e)),r=[];try{r=E(t).filter(e=>e.endsWith(`.ts`)).map(e=>k(t,e))}catch{}return[...new Set([...n,...r])]}function ea(e,t,n,r){let i=k(t,`tsconfig.json`),a={...e.sys,onUnRecoverableConfigFileDiagnostic:t=>{throw Error(e.flattenDiagnosticMessageText(t.messageText,`
|
|
1582
|
+
`))}},o=e.getParsedCommandLineOfConfigFile(i,{},a);if(!o)throw Error(`kick/client: could not read ${i}`);let s=e.createCompilerHost(o.options,!0),c=s.readFile.bind(s),l=s.getSourceFile.bind(s),u=s.fileExists.bind(s);return s.readFile=e=>e===n?r:c(e),s.fileExists=e=>e===n||u(e),s.getSourceFile=(t,i,a,o)=>t===n?e.createSourceFile(t,r,i,!0):l(t,i,a,o),e.createProgram({rootNames:[...$i(o.fileNames,O(n)),n],options:o.options,host:s})}const ta=`/* eslint-disable */
|
|
1610
1583
|
// AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
|
|
1611
1584
|
//
|
|
1612
1585
|
// Self-contained: this file has no imports, so a frontend consumes it without
|
|
1613
1586
|
// compiling the server, its decorators, or its path aliases.
|
|
1614
1587
|
//
|
|
1615
|
-
//
|
|
1616
|
-
// export const api = createClient<
|
|
1588
|
+
// // Ambient — add this file to the frontend's tsconfig "include", then:
|
|
1589
|
+
// export const api = createClient<KickClientApi.Api>({ baseUrl: '/api/v1' })
|
|
1590
|
+
//
|
|
1591
|
+
// // Or import it explicitly, if you prefer no globals:
|
|
1592
|
+
// import type { Api } from './path/to/kick__client'
|
|
1617
1593
|
//
|
|
1618
1594
|
// Not refreshed by \`kick dev\` — resolving these types builds a full
|
|
1619
1595
|
// TypeScript program over the server. Re-run \`kick typegen\`.
|
|
1620
|
-
`;function
|
|
1596
|
+
`;function na(e,t){let n=t.filter(t=>e.entries.has(t));if(n.length===0)return`${ta}
|
|
1621
1597
|
// (no routes discovered yet — annotate a controller method with
|
|
1622
1598
|
// @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
|
|
1623
|
-
|
|
1599
|
+
interface Api {}
|
|
1600
|
+
|
|
1601
|
+
declare global {
|
|
1602
|
+
// eslint-disable-next-line @typescript-eslint/no-namespace
|
|
1603
|
+
namespace KickClientApi {
|
|
1604
|
+
export { Api }
|
|
1605
|
+
}
|
|
1606
|
+
}
|
|
1607
|
+
|
|
1608
|
+
export type { Api }
|
|
1624
1609
|
`;let r=e.hoisted.length>0?e.hoisted.join(`
|
|
1625
1610
|
|
|
1626
1611
|
`)+`
|
|
1627
1612
|
|
|
1628
|
-
`:``,i=n.map(t=>` ${JSON.stringify(t)}: ${e.entries.get(t)}`);return`${
|
|
1629
|
-
${r}
|
|
1613
|
+
`:``,i=n.map(t=>` ${JSON.stringify(t)}: ${e.entries.get(t)}`);return`${ta}
|
|
1614
|
+
${r}interface Api {
|
|
1630
1615
|
${i.join(`
|
|
1631
1616
|
`)}
|
|
1632
1617
|
}
|
|
1633
|
-
|
|
1618
|
+
|
|
1619
|
+
declare global {
|
|
1620
|
+
// eslint-disable-next-line @typescript-eslint/no-namespace
|
|
1621
|
+
namespace KickClientApi {
|
|
1622
|
+
export { Api }
|
|
1623
|
+
}
|
|
1624
|
+
}
|
|
1625
|
+
|
|
1626
|
+
export type { Api }
|
|
1627
|
+
`}const ra=`kick/client`,Q=`.kickjs/types/kick__client.d.ts`,ia=`.kickjs/cache/client-map.sha1`,aa=(()=>{try{return we(import.meta.url)(`../../../package.json`).version??`0.0.0`}catch{return`0.0.0`}})();function oa(e){try{if(!w(e))return null;let[t,n]=T(e,`utf-8`).trim().split(/\s+/);return t&&n?{inputs:t,output:n}:null}catch{return null}}function sa(e){return`${Cn}${ra} */\n\n${e}\n`}function ca(e){try{return w(e)?T(e,`utf-8`):null}catch{return null}}async function la(e){let t=D.resolve(e.cwd,Q);if(!w(t))return!1;try{await ze(t,{force:!0})}catch(t){return e.log.warn(` kick/client: could not remove the stale ${Q} — treat it as out of date (${t instanceof Error?t.message:String(t)})`),!0}return e.log.warn(` kick/client: removed the previously generated ${Q} rather than leave a stale one — re-run \`kick typegen\` once the cause above is fixed.`),!0}function ua(e){let t=e.config?.typegen?.client;return typeof t==`boolean`?t:(w(D.resolve(e.cwd,Q))&&e.log.warn(` kick/client: ${Q} exists but typegen.client is not set, so it is NOT being refreshed.\n Add \`typegen: { client: true }\` to kick.config.ts to keep it current, or delete the file if nothing reads it.`),!1)}const da=()=>({id:ra,outExtension:`.d.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){if(!ua(e))return null;if(e.watch)return e.log.info?.(" kick/client: skipped under watch (builds a full TypeScript program). Run `kick typegen` to refresh the client route map."),null;let t=await e.getScanResult({root:D.resolve(e.cwd,e.config?.typegen?.srcDir??`src`),cwd:e.cwd}),n=[],r=new Set;for(let e of t.routes){let t=`${e.httpMethod} ${e.mountedPath??e.path}`;r.has(t)||(r.add(t),n.push(t))}let i=await qi({projectDir:e.cwd,keys:n,cliVersion:aa}),a=oa(D.resolve(e.cwd,ia)),o=ca(D.resolve(e.cwd,Q));if(i&&a&&o!==null&&a.inputs===i&&a.output===Gi(o))return fn()&&e.log.info?.(` kick/client: unchanged, keeping ${Q}`),null;try{let t=na(await Ji({projectDir:e.cwd,routesFile:D.resolve(e.cwd,`.kickjs/types/kick__routes.ts`),keys:n,onWarn:t=>e.log.warn(t)}),n);return i&&!e.check&&await e.writeFile(ia,`${i} ${Gi(sa(t))}`),t}catch(t){let n=w(D.resolve(e.cwd,Q)),r=` kick/client: skipped — ${t instanceof Error?t.message:String(t)}`;return n?e.log.warn(r):fn()&&e.log.info?.(r),n&&await la(e),null}}});function fa(e,t,n=`zod`){if(!e)return null;let r=A(O(t),e.filePath).split(je).join(`/`);return r=r.replace(/\.(ts|tsx|mts|cts)$/i,``),r.startsWith(`.`)||(r=`./`+r),`/* eslint-disable */
|
|
1634
1628
|
// AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
|
|
1635
1629
|
// Re-run with \`kick typegen\` or rely on \`kick dev\` to refresh.
|
|
1636
1630
|
|
|
@@ -1668,5 +1662,5 @@ declare global {
|
|
|
1668
1662
|
}
|
|
1669
1663
|
|
|
1670
1664
|
export {}
|
|
1671
|
-
`}const
|
|
1672
|
-
`)}});var
|
|
1665
|
+
`}const pa=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=ha(e);if(t===!1)return null;let n=await e.getScanResult({root:ma(e),cwd:e.cwd,envFile:t});if(!n.env)return null;let r=e.config?.typegen?.schemaValidator??`zod`,i=D.resolve(e.cwd,`.kickjs/types/kick__env.ts`);return fa(n.env,i,r)}});function ma(e){return D.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function ha(e){return e.config?.typegen?.envFile}function ga(e){return D.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function _a(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function $(e){return{root:ga(e),cwd:e.cwd,envFile:_a(e)}}const va=()=>({id:`kick/registry`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e)),n=D.resolve(e.cwd,`.kickjs/types/kick__registry.d.ts`),r=new Set(t.collisions.map(e=>e.className));return ve(t.classes,n,r)}}),ya=()=>({id:`kick/services`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e)),n=new Set(t.collisions.map(e=>e.className));return ge(`ServiceToken`,he(t.classes,t.tokens,t.injects,n),"(no tokens discovered — declare with createToken<T>() or `kick g service <name>`)")}}),ba=()=>({id:`kick/modules`,inputs:[`src/**/*.ts`],async generate(e){return ge(`ModuleToken`,le((await e.getScanResult($(e))).classes),"(no @Module classes discovered — `kick g module <name>` to add one)")}}),xa=()=>({id:`kick/plugins`,inputs:[`src/**/*.ts`],async generate(e){return de((await e.getScanResult($(e))).pluginsAndAdapters)}}),Sa=()=>({id:`kick/augmentations`,inputs:[`src/**/*.ts`],async generate(e){return Se((await e.getScanResult($(e))).augmentations)}}),Ca=()=>({id:`kick/context`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return t.contextKeys.length===0?null:ue(t.contextKeys)}}),wa={fastify:{subpath:`@forinda/kickjs/fastify`,typeName:`FastifyRuntimeTypes`},h3:{subpath:`@forinda/kickjs/h3`,typeName:`H3RuntimeTypes`}},Ta=()=>({id:`kick/runtime`,outExtension:`.ts`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`,`kick.config.json`],async generate(e){let t=e.config?.runtime;if(t!==`fastify`&&t!==`h3`)return null;let{subpath:n,typeName:r}=wa[t];return[`// Runtime escape-hatch types for the '${t}' engine (kick.config runtime).`,`declare module '@forinda/kickjs' {`,` interface KickRuntimeRegister {`,` runtime: import('${n}').${r}`,` }`,`}`,``,`export {}`,``].join(`
|
|
1666
|
+
`)}});var Ea=e({builtinCliPlugins:()=>Da});const Da=[h({name:`kick/init`,register:qe}),h({name:`kick/generate`,register:xn}),h({name:`kick/run`,register:Ln}),h({name:`kick/info`,register:Hn}),h({name:`kick/inspect`,register:Xn}),h({name:`kick/add`,register:t}),h({name:`kick/list`,register:i}),h({name:`kick/explain`,register:or}),h({name:`kick/mcp`,register:gr}),h({name:`kick/tinker`,register:br}),h({name:`kick/remove`,register:Er}),h({name:`kick/typegen`,register:kr}),h({name:`kick/check`,register:Vr}),h({name:`kick/doctor`,register:xi}),h({name:`kick/codemod`,register:Ci}),h({name:`kick/registry`,typegens:[va()]}),h({name:`kick/services`,typegens:[ya()]}),h({name:`kick/modules`,typegens:[ba()]}),h({name:`kick/plugins`,typegens:[xa()]}),h({name:`kick/augmentations`,typegens:[Sa()]}),h({name:`kick/context`,typegens:[Ca()]}),h({name:`kick/assets`,typegens:[wi()]}),h({name:`kick/routes`,typegens:[Pi()]}),h({name:`kick/client`,typegens:[da()]}),h({name:`kick/env`,typegens:[pa()]}),h({name:`kick/runtime`,typegens:[Ta()]})];export{Dn as n,Da as t};
|