@forinda/kickjs-cli 8.6.0 → 8.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{agent-docs-BFOgLbXq.mjs → agent-docs-BWnHJdm8.mjs} +5 -5
- package/dist/agent-docs-BWnHJdm8.mjs.map +1 -0
- package/dist/{agent-docs-BU1rORKA.mjs → agent-docs-BpcruhI0.mjs} +4 -4
- package/dist/{build-DlfIkjcw.mjs → build-CkO4WI5N.mjs} +2 -2
- package/dist/{build-CdIpRyfy.mjs → build-CmmbAJ-6.mjs} +3 -3
- package/dist/{build-CdIpRyfy.mjs.map → build-CmmbAJ-6.mjs.map} +1 -1
- package/dist/{builtins-CfAXBoIM.mjs → builtins-C_zzIKuU.mjs} +2 -2
- package/dist/{builtins-CmuUgcIq.mjs → builtins-CrQekXun.mjs} +150 -144
- package/dist/cli.mjs +2 -2
- package/dist/{config-ndsVdO8u.mjs → config-CKtUkFnR.mjs} +3 -3
- package/dist/config-CKtUkFnR.mjs.map +1 -0
- package/dist/{config-SvlcF3Ls.mjs → config-Po20hhzt.mjs} +2 -2
- package/dist/{doctor-D3RMXkxE.mjs → doctor-DOuVk9cj.mjs} +74 -70
- package/dist/doctor-DOuVk9cj.mjs.map +1 -0
- package/dist/{fs-DdNMcW_P.mjs → fs-BdI6OJqD.mjs} +2 -2
- package/dist/{fs-DdNMcW_P.mjs.map → fs-BdI6OJqD.mjs.map} +1 -1
- package/dist/{fs-v57MCgpH.mjs → fs-Cj6xpMO3.mjs} +1 -1
- package/dist/{fullstack-DOufUeMv.mjs → fullstack-CYWi1UG7.mjs} +3 -3
- package/dist/{fullstack-LJwhodT-.mjs → fullstack-CjwAefj4.mjs} +4 -4
- package/dist/{fullstack-LJwhodT-.mjs.map → fullstack-CjwAefj4.mjs.map} +1 -1
- package/dist/index.d.mts +2 -21
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +2 -2
- package/dist/{plugin-Dighdqh-.mjs → plugin-BWaA0gd6.mjs} +2 -2
- package/dist/{plugin-Dn67elEZ.mjs → plugin-rEXrK-TD.mjs} +2 -2
- package/dist/{project-Cb_NLUWI.mjs → project-16gsHLs5.mjs} +10 -9
- package/dist/project-16gsHLs5.mjs.map +1 -0
- package/dist/{project-AXCA1hD9.mjs → project-Coim2UNJ.mjs} +9 -8
- package/dist/{project-root-Dgvy5kYG.mjs → project-root-Bab7F0mt.mjs} +2 -2
- package/dist/{project-root-C7TrLJlZ.mjs → project-root-DebxcXwp.mjs} +3 -3
- package/dist/{project-root-C7TrLJlZ.mjs.map → project-root-DebxcXwp.mjs.map} +1 -1
- package/dist/{prompts-CSATvwXw.mjs → prompts-XSHQCmzs.mjs} +2 -2
- package/dist/{prompts-CSATvwXw.mjs.map → prompts-XSHQCmzs.mjs.map} +1 -1
- package/dist/{rolldown-runtime-BhxEEqxa.mjs → rolldown-runtime-DyiVSlN6.mjs} +1 -1
- package/dist/{run-plugins-Cf_6BgGZ.mjs → run-plugins-CEomWccT.mjs} +79 -77
- package/dist/run-plugins-CEomWccT.mjs.map +1 -0
- package/dist/typegen-CEcjoYli.mjs +106 -0
- package/dist/typegen-Cs40J3ar.mjs +107 -0
- package/dist/typegen-Cs40J3ar.mjs.map +1 -0
- package/dist/{types-lHwt_SNI.mjs → types-BtMrQ7AM.mjs} +1 -1
- package/package.json +4 -4
- package/templates/base/files/src/modules/index.ts +2 -3
- package/templates/base/files/tsconfig.json +0 -1
- package/dist/agent-docs-BFOgLbXq.mjs.map +0 -1
- package/dist/config-ndsVdO8u.mjs.map +0 -1
- package/dist/doctor-D3RMXkxE.mjs.map +0 -1
- package/dist/project-Cb_NLUWI.mjs.map +0 -1
- package/dist/run-plugins-Cf_6BgGZ.mjs.map +0 -1
- package/dist/typegen-97E_RYNp.mjs +0 -131
- package/dist/typegen-CYhFNfIu.mjs +0 -132
- package/dist/typegen-CYhFNfIu.mjs.map +0 -1
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs-cli v8.
|
|
2
|
+
* @forinda/kickjs-cli v8.7.0
|
|
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-DyiVSlN6.mjs";import{n as t,r as n,t as r}from"./fs-BdI6OJqD.mjs";import{a as i,c as a,d as o,i as s,l as c,n as l,o as u,r as d,s as f,t as p,u as m}from"./prompts-XSHQCmzs.mjs";import{A as h,C as g,D as _,E as v,F as y,M as b,N as ee,O as x,P as S,S as te,T as ne,_ as re,a as ie,b as ae,c as oe,f as se,g as ce,h as le,i as ue,j as de,k as fe,l as pe,m as me,p as he,r as ge,u as _e,v as ve,w as ye,x as be,y as xe}from"./doctor-DOuVk9cj.mjs";import{d as Se,l as Ce,o as we,r as Te,s as Ee,t as De}from"./project-16gsHLs5.mjs";import{a as Oe,c as ke,i as Ae,l as je,o as C,s as w,u as Me}from"./config-CKtUkFnR.mjs";import{t as T}from"./project-root-DebxcXwp.mjs";import{n as E,t as Ne}from"./types-BtMrQ7AM.mjs";import{t as Pe}from"./build-CmmbAJ-6.mjs";import{n as Fe}from"./agent-docs-BWnHJdm8.mjs";import{C as Ie,S as Le,_ as Re,a as ze,b as Be,c as Ve,d as He,f as Ue,g as We,h as Ge,i as Ke,l as qe,m as Je,o as Ye,p as Xe,r as Ze,s as Qe,t as $e,u as et,v as tt,w as nt,x as D,y as rt}from"./typegen-Cs40J3ar.mjs";import{createRequire as it}from"node:module";import O,{basename as at,dirname as k,join as A,relative as j,resolve as M,sep as N}from"node:path";import{cpSync as ot,existsSync as P,mkdirSync as st,readFileSync as F,readdirSync as ct,rmSync as lt,writeFileSync as I}from"node:fs";import{copyFile as ut,mkdir as dt,readFile as L,readdir as ft,rm as pt,stat as mt,writeFile as R}from"node:fs/promises";import{fork as ht,spawn as gt,spawnSync as _t}from"node:child_process";import{fileURLToPath as vt,pathToFileURL as z}from"node:url";import{parseSync as yt}from"oxc-parser";import{arch as bt,platform as xt,release as St}from"node:os";import{createHash as Ct}from"node:crypto";const wt=[{value:`swagger`,label:`Swagger`,hint:`OpenAPI docs`},{value:`ws`,label:`WebSocket`,hint:`rooms, heartbeat`},{value:`queue`,label:`Queue`,hint:`BullMQ/RabbitMQ/Kafka`},{value:`devtools`,label:`DevTools`,hint:`debug dashboard`}];function Tt(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(`--frontend <kind>`,`Fullstack web/ scaffold: 'kick' (wired React app) or 'vite' (create-vite, unwired)`).option(`--vite-template <name>`,`create-vite TypeScript template for --frontend vite (default 'react-ts')`).option(`--packages <packages>`,`Comma-separated packages to include (e.g. swagger,ws,queue,devtools)`).option(`-y, --yes`,`Pick safe defaults for every prompt (template=minimal, repo=inmemory, no extras, git+install on)`).option(`--non-interactive`,`alias for --yes`).action(async(e,t)=>{l(`KickJS — Create a new project`);let n=!!(t.yes||t.nonInteractive);e||=n?`my-api`:await a({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let r;if(e===`.`?(r=M(`.`),e=at(r)):r=M(t.directory||e),P(r)){let a=ct(r);if(a.length>0){if(t.force)d.warn(`Clearing existing files in ${r}`);else if(n){d.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),i(`Aborted.`);return}else{d.warn(`Directory "${e}" is not empty:`);let t=a.slice(0,5);for(let e of t)d.message(` - ${e}`);if(a.length>5&&d.message(` ... and ${a.length-5} more`),!await p({message:m.red(`Remove all existing files and proceed?`),initialValue:!1})){i(`Aborted.`);return}}for(let e of a)lt(M(r,e),{recursive:!0,force:!0})}}let o=t.template;o||=n?`minimal`:await u({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 c=t.runtime;c||=n?`express`:await u({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 f=t.pm;f||=n?await Ce(void 0):await u({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let h=t.repo;h||=n?`inmemory`:await a({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),Me(h);let g=t.schema;g||=n?`zod`:await u({message:`Schema library (env + DTO validation)`,options:[{value:`zod`,label:`Zod`,hint:`default — broad ecosystem`},{value:`valibot`,label:`Valibot`,hint:`smaller bundle`},{value:`yup`,label:`Yup`,hint:`classic API`}]}),[`zod`,`valibot`,`yup`].includes(g)||(d.warn(`Unknown --schema "${g}", falling back to zod.`),g=`zod`);let _;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();_=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else _=n?[]:await s({message:`Select packages to include`,options:[...wt],required:!1});let v;v=t.git===void 0?n?!0:await p({message:`Initialize git repository?`,initialValue:!0}):t.git;let y;if(y=t.install===void 0?n?!0:await p({message:`Install dependencies?`,initialValue:!0}):t.install,t.frontend!==void 0&&t.frontend!==`kick`&&t.frontend!==`vite`){d.error(`Unknown --frontend '${String(t.frontend)}'. Use 'kick' (wired React app) or 'vite' (create-vite).`),i(`Aborted.`);return}let{VITE_TEMPLATES:b,DEFAULT_VITE_TEMPLATE:ee}=await import(`./fullstack-CjwAefj4.mjs`);if(t.viteTemplate!==void 0&&!b.some(e=>e.value===t.viteTemplate)){d.error(`Unknown --vite-template '${String(t.viteTemplate)}'. TypeScript templates only: ${b.map(e=>e.value).join(`, `)}.`),i(`Aborted.`);return}let x=t.frontend===`vite`?`vite`:`kick`,S=t.viteTemplate??ee;if(o===`fullstack`&&!t.frontend&&!n&&(x=await u({message:`Frontend for web/`,options:[{value:`kick`,label:`KickJS React app`,hint:`typed client, /api proxy, route types — wired`},{value:`vite`,label:`Delegate to create-vite`,hint:`pick any framework; wiring is manual (guide printed after)`}]})),x===`vite`&&!t.viteTemplate&&!n&&(S=await u({message:`create-vite template`,options:b.map(e=>({value:e.value,label:e.label})),initialValue:ee})),o===`fullstack`){let{initFullstackProject:t}=await import(`./fullstack-CjwAefj4.mjs`);await t({name:e,directory:r,packageManager:f,initGit:v,installDeps:y,schemaLib:g,runtime:c,packages:_,frontend:x,viteTemplate:S}),i(`Done! Next steps: ${m.cyan(`cd ${e} && ${f}${f===`pnpm`?` dev`:` run dev:server`}`)}`);return}await De({name:e,directory:r,packageManager:f,initGit:v,installDeps:y,template:o,defaultRepo:h,packages:_,schemaLib:g,runtime:c}),i(`Done! Next steps: ${m.cyan(`cd ${e} && ${f} dev`)}`)})}function B(e,t=[]){let n=new Map;for(let t of e){let e=(n.get(t.name)??0)+1;if(n.set(t.name,e),e===2)throw new Ne(`plugin`,t.name,[t.name,t.name])}let r=new Map,i=[];for(let t of e)for(let e of t.commands??[]){let n=r.get(e.name);if(n)throw new Ne(`command`,e.name,[n,t.name]);r.set(e.name,t.name),i.push(e)}let a=new Set(t.map(e=>e.name)),o=[...i.filter(e=>!a.has(e.name)),...t],s=new Map,c=[];for(let t of e)for(let e of t.typegens??[]){let n=s.get(e.id);if(n)throw new Ne(`typegen`,e.id,[n,t.name]);s.set(e.id,t.name),c.push(e)}let l=new Map,u=[];for(let t of e)for(let e of t.generators??[]){let n=l.get(e.name);if(n)throw new Ne(`generator`,e.name,[n,t.name]);l.set(e.name,t.name),u.push({source:t.name,spec:e})}return{commands:o,typegens:c,generators:u,register:async(t,n)=>{let r;if(n)r={generators:u,...n};else{let{findProjectRoot:e}=await import(`./project-root-DebxcXwp.mjs`).then(e=>e.n),t=process.cwd();r={cwd:t,projectRoot:e(t),config:null,log:()=>{},generators:u}}for(let n of e)n.register&&await n.register(t,r)}}}async function Et(e){let{name:t,outDir:r}=e,i=S(t),a=y(t),o=[],s=A(r,`${i}.plugin.ts`);return await n(s,`import {
|
|
12
12
|
definePlugin,
|
|
13
13
|
type AppAdapter,
|
|
14
14
|
type AppModuleEntry,
|
|
@@ -164,13 +164,15 @@ export const ${a}Plugin = definePlugin<${a}PluginConfig>({
|
|
|
164
164
|
async shutdown(): Promise<void> {
|
|
165
165
|
// Example: await this.connection?.close()
|
|
166
166
|
},
|
|
167
|
+
|
|
168
|
+
${ae(i,a,`plugin`,` `)}
|
|
167
169
|
}),
|
|
168
170
|
})
|
|
169
|
-
`),o.push(s),o}function Dt(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 Ot(e){let{name:t,moduleName:r,modulesDir:i,pattern:a}=e,o=e.type??`http`,s=
|
|
171
|
+
`),o.push(s),o}function Dt(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 Ot(e){let{name:t,moduleName:r,modulesDir:i,pattern:a}=e,o=e.type??`http`,s=S(t),c=y(t),l=e.key??ee(t),u=Array.isArray(e.params)?e.params:Dt(e.params),d=ve({type:`contributor`,outDir:e.outDir,moduleName:r,modulesDir:i,defaultDir:`src/contributors`,pattern:a,shouldPluralize:e.pluralize??!0}),f=o===`http`?`defineHttpContextDecorator`:`defineContextDecorator`,p=o===`http`?`RequestContext`:`ExecutionContext`,m=u.length>0?`\nexport type ${c}Params = {\n${u.map(e=>` ${e.name}: ${e.type}`).join(`
|
|
170
172
|
`)}\n}\n`:``,h=u.length>0?`${f}.withParams<${c}Params>()({`:`${f}({`,g=u.length>0?` // Every call site must supply these — no placeholder defaults.
|
|
171
173
|
// Add \`paramDefaults: { … }\` for any field whose default is
|
|
172
174
|
// genuinely correct for an undecorated route, and drop it from here.
|
|
173
|
-
requiredParams: [${u.map(e=>`'${e.name}'`).join(`, `)}],\n`:``,_=u.length>0?`(ctx, _deps, params)`:`(ctx)`,v=u.length>0?` // \`params\` is typed as ${c}Params (call-site params merged onto any paramDefaults).`:` // \`ctx\` is a ${p} — read ctx.req / ctx.headers / ctx.params (http) or ctx.get (bare).`,
|
|
175
|
+
requiredParams: [${u.map(e=>`'${e.name}'`).join(`, `)}],\n`:``,_=u.length>0?`(ctx, _deps, params)`:`(ctx)`,v=u.length>0?` // \`params\` is typed as ${c}Params (call-site params merged onto any paramDefaults).`:` // \`ctx\` is a ${p} — read ctx.req / ctx.headers / ctx.params (http) or ctx.get (bare).`,b=`import { ${f} } from '@forinda/kickjs'
|
|
174
176
|
import type { ${p} } from '@forinda/kickjs'
|
|
175
177
|
|
|
176
178
|
/**
|
|
@@ -217,7 +219,7 @@ ${v}
|
|
|
217
219
|
throw new Error("${c} contributor: resolve() not implemented")
|
|
218
220
|
},
|
|
219
221
|
})
|
|
220
|
-
`,
|
|
222
|
+
`,x=A(d,`${s}.contributor.ts`);return await n(x,b),[x]}async function kt(e){let t=A(e.outDir,`kick.config.ts`),r=e.modulesDir??`src/modules`,i=e.defaultRepo??`inmemory`;return P(t)&&!e.force&&!await p({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
|
|
221
223
|
Skipped — existing kick.config.ts preserved.`),[]):(await n(t,`import { defineConfig } from '@forinda/kickjs-cli'
|
|
222
224
|
|
|
223
225
|
export default defineConfig({
|
|
@@ -271,7 +273,7 @@ ${p}
|
|
|
271
273
|
`||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=At(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=V(m,/register\s*\(([^)]*)\)\s*\{/),g=V(m,/contributors\s*\(\s*\)\s*\{/),_=V(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let v=Mt(c,{container:h!==null,appModule:!0,moduleRoutes:!0,contributorRegistrations:g!==null}),y=``;return h!==null&&(y+=` register(container: Container): void {${H(h,6,4)} }\n\n`),g!==null&&(y+=` contributors(): ContributorRegistrations {${H(g,6,4)} }\n\n`),y+=` routes(): ModuleRoutes {${H(_,6,4)} }`,{migrated:`${v}${`export class ${r} implements AppModule {
|
|
272
274
|
${y}
|
|
273
275
|
}
|
|
274
|
-
`}${u}`}}function Ft(e,t){return t===`class`?Pt(e):Nt(e)}function It(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 Lt(e){let t=[];return await n(
|
|
276
|
+
`}${u}`}}function Ft(e,t){return t===`class`?Pt(e):Nt(e)}function It(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 Lt(e){let t=[];return await n(M(e),0),t;async function n(e,r){let i;try{i=await ft(e)}catch{return}for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=A(e,a),o;try{o=await mt(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function Rt(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await ft(e)}catch{return}await dt(t,{recursive:!0});for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=A(e,a),o=A(t,a),s;try{s=await mt(i)}catch{continue}s.isDirectory()?await r(i,o):(await ut(i,o),n++)}}}function zt(e){let t=new Date().toISOString().replaceAll(/[:.]/g,`-`);return A(e,`.kickjs`,`codemod-backups`,`${t}-modules`)}async function Bt(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await Lt(e),s=await L(A(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=zt(r),await Rt(e,c));let l=[];for(let e of o){let t=Ft(await L(e,`utf-8`),i);if(t.migrated==null){l.push({path:e,status:`skipped`,reason:t.reason});continue}n||await R(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`})}let u=A(e,`index.ts`),d=null;try{d=await L(u,`utf-8`)}catch{return{target:i,files:l,indexStatus:`not-found`,indexPath:u,backupDir:c}}let f=It(d,i);return f.migrated==null?{target:i,files:l,indexStatus:`skipped`,indexPath:u,indexReason:f.reason,backupDir:c}:(n||await R(u,f.migrated,`utf-8`),{target:i,files:l,indexStatus:`migrated`,indexPath:u,backupDir:c})}async function Vt(e,t){let n=await Lt(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 L(e,`utf-8`);i.test(t)&&r.push(e)}return r}const Ht={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 Ut(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=Ht[a];if(!o){let e=[...Object.keys(Ht),`enum:a,b,c`].join(`, `);throw Error(`Unknown field type: "${a}". Valid types: ${e}`)}return{name:n,type:a,tsType:o.ts,zodType:o.zod,optional:i}})}async function Wt(e){let{name:t,fields:r,modulesDir:i,repo:a=`inmemory`,tokenScope:o=`app`,style:s=`define`}=e,c=e.pluralize!==!1,l=S(t),u=y(t),d=c?de(l):l,f=c?b(u):u,p=A(i,d),m=[],h=async(e,t)=>{let r=A(p,e);await n(r,t),m.push(r)};return await h(`${l}.module.ts`,fe({pascal:u,kebab:l,plural:d,repo:a,style:s})),await h(`${l}.constants.ts`,ne({pascal:u,kebab:l})),await h(`${l}.controller.ts`,x({pascal:u,kebab:l,plural:d,pluralPascal:f,swagger:e.swagger??!1})),await h(`${l}.service.ts`,v({pascal:u,kebab:l})),await h(`dtos/create-${l}.dto.ts`,Gt(u,r)),await h(`dtos/update-${l}.dto.ts`,Kt(u,r)),await h(`dtos/${l}-response.dto.ts`,qt(u,r)),await h(`${l}.repository.ts`,_({pascal:u,kebab:l,repoType:a,dtoPrefix:`./dtos`,tokenScope:o})),await be(i,u,d,l,s),m}function Gt(e,t){return`import { z } from 'zod'
|
|
275
277
|
|
|
276
278
|
export const create${e}Schema = z.object({
|
|
277
279
|
${t.map(e=>{let t=e.zodType;return` ${e.name}: ${t}${e.optional?`.optional()`:``},`}).join(`
|
|
@@ -294,7 +296,7 @@ ${t.map(e=>` ${e.name}${e.optional?`?`:``}: ${e.tsType}`).join(`
|
|
|
294
296
|
createdAt: string
|
|
295
297
|
updatedAt: string
|
|
296
298
|
}
|
|
297
|
-
`}async function Jt(e){let{name:t,moduleName:r,modulesDir:i}=e,a=e.pluralize??!0,o=
|
|
299
|
+
`}async function Jt(e){let{name:t,moduleName:r,modulesDir:i}=e,a=e.pluralize??!0,o=S(t),s=y(t),c=[],l;if(e.outDir)l=M(e.outDir);else if(r){let e=S(r),t=a?de(e):e;l=M(A(i??`src/modules`,t,`__tests__`))}else l=M(`src/__tests__`);let u=A(l,`${o}.test.ts`);return await n(u,`import { describe, it, expect, beforeEach } from 'vitest'
|
|
298
300
|
import { Container } from '@forinda/kickjs'
|
|
299
301
|
|
|
300
302
|
describe('${s}', () => {
|
|
@@ -318,56 +320,56 @@ describe('${s}', () => {
|
|
|
318
320
|
})
|
|
319
321
|
})
|
|
320
322
|
`),c.push(u),c}const Yt=[`agents`,`claude`,`skills`,`gemini`,`copilot`,`both`,`all`];function U(e){return e.parent?.opts()?.dryRun??!1}function W(e,t=!1){let n=process.cwd();console.log(`\n ${t?`Would generate`:`Generated`} ${e.length} file${e.length===1?``:`s`}:`);for(let t of e)console.log(` ${t.replace(n+`/`,``)}`);t&&console.log(`
|
|
321
|
-
(dry run — no files were written)`),console.log()}async function Xt(e){if(!e)try{let e=await
|
|
323
|
+
(dry run — no files were written)`),console.log()}async function Xt(e){if(!e)try{let e=await C(process.cwd());await $e({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 Zt=[{name:`module <name>`,description:`REST module (controller, service, DTOs, repo)`},{name:`scaffold <name> <fields...>`,description:`CRUD module from field definitions`},{name:`controller <name>`,description:`@Controller() class [-m module]`},{name:`service <name>`,description:`@Service() singleton [-m module]`},{name:`middleware <name>`,description:`Express middleware function [-m module]`},{name:`guard <name>`,description:`Route guard (auth, roles, etc.) [-m module]`},{name:`contributor <name>`,description:`Context contributor [--type http|bare] [--params a:string] [-m]`},{name:`dto <name>`,description:`Zod DTO schema [-m module]`},{name:`adapter <name>`,description:`AppAdapter with lifecycle hooks (app-level only)`},{name:`test <name>`,description:`Vitest test scaffold [-m module]`},{name:`config`,description:`Generate kick.config.ts`},{name:`agents`,description:`Regenerate .agents/* + root CLAUDE.md from upstream templates`}],Qt=new Map([[`job`,`Queue processors are no longer built in — their shape belongs to whichever queue you run.
|
|
322
324
|
Add your own in kick.config.ts: https://kickjs.app/guide/plugin-generators.html`]]),$t=new Set([...Zt.map(e=>e.name.split(` `)[0]),...Qt.keys()]);async function en(){console.log(`
|
|
323
325
|
Built-in generators:
|
|
324
|
-
`);let e=Math.max(...Zt.map(e=>e.name.length));for(let t of Zt)console.log(` kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await
|
|
326
|
+
`);let e=Math.max(...Zt.map(e=>e.name.length));for(let t of Zt)console.log(` kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await C(process.cwd()),n=B(t?.plugins??[],t?.commands??[]),r=await ue(process.cwd(),n.generators);if(r.generators.length>0){console.log(`
|
|
325
327
|
Plugin generators:
|
|
326
328
|
`);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(`
|
|
327
329
|
Failed to load:
|
|
328
|
-
`);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}async function
|
|
329
|
-
Use -m to scope it to a module: kick g middleware auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,n,r)=>{let i=U(r);t(i);let a=await
|
|
330
|
-
Use -m to scope it to a module: kick g guard admin -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,n,r)=>{let i=U(r);t(i);let a=await
|
|
330
|
+
`);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}function tn(e,t){let n=e.parent?.opts()??{},r={...e.optsWithGlobals(),...t};for(let e of[`entity`,`tests`,`pluralize`])n[e]===!1&&(r[e]=!1);return r}async function nn(e,t,n){let r=await C(process.cwd()),i=w(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??ye(i.repo);t.repo&&Me(t.repo);let s=t.pattern??r?.pattern??`rest`,c=t.pluralize===!1?!1:i.pluralize??!0,l=je(r,process.cwd()),u=Oe(T()),d=ke(T()),f=T(),p=Ae(f,`@forinda/kickjs-testing`,`any`)&&Ae(f,`supertest`,`any`),h=i.style??`define`;if(!n&&h===`define`){let e=await Vt(M(a),`define`);if(e.length>0){console.error(`\n ${m.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n ${m.dim(`Project setting:`)} modules.style: 'define' (default)\n\n ${m.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 ${m.bold(`Pick one:`)}\n 1. Migrate everything to defineModule:\n ${m.dim(`$`)} kick codemod modules --experimental --apply\n 2. Keep the class form — pin it in kick.config.ts:\n ${m.dim(`// kick.config.ts`)}\n ${m.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let _=[];for(let r of e){let e=await g({name:r,modulesDir:M(a),noEntity:t.entity===!1,noTests:t.tests===!1,repo:o,minimal:t.minimal,force:t.force,pattern:s,testHarness:p,dryRun:n,pluralize:c,tokenScope:l,swagger:u,schemaLib:d,style:i.style});_.push(...e)}W(_,n),await Xt(n)}function rn(e,n){let r=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,i,a)=>{if(i.list){await en();return}if(!e||e.length===0){r.help();return}let o=U(a);t(o);let[s,c,...l]=e;if(s){let e=await C(process.cwd()),t=B(e?.plugins??[],e?.commands??[]),r=await ie({generatorName:s,itemName:c??``,args:l,flags:i,cwd:process.cwd(),projectRoot:n?.projectRoot},t.generators);if(r){W(r.files,o);return}if(s!==`module`&&$t.has(s)){let e=Qt.get(s);e?(console.error(`\n 'kick g ${s}' has been removed.`),console.error(` ${e}\n`)):(console.error(`\n '${s}' is a generator, not a module name.`),console.error(` Did you mean: kick g ${s} ${c??`<name>`}`),console.error(` If that errors, your @forinda/kickjs-cli is older than the '${s}' generator — upgrade it.\n`)),process.exitCode=1;return}}await nn(e,i,o)});r.command(`module <names...>`).description(`Generate one or more modules (e.g. kick g module user task project)`).option(`--no-entity`,`Skip entity and value object generation`).option(`--no-tests`,`Skip test file generation`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name (e.g. postgres)`).option(`--pattern <pattern>`,`Override project pattern: rest | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,n,r)=>{let i=U(r);t(i),await nn(e,tn(r,n),i)}),r.command(`adapter <name>`).description(`Generate an AppAdapter with lifecycle hooks and middleware support`).option(`-o, --out <dir>`,`Output directory`,`src/adapters`).action(async(e,n,r)=>{let i=U(r);t(i),W(await xe({name:e,outDir:M(n.out)}),i)}),r.command(`plugin <name>`).description(`Generate a KickPlugin with DI, modules, adapters, middleware, and lifecycle hooks`).option(`-o, --out <dir>`,`Output directory`,`src/plugins`).action(async(e,n,r)=>{let i=U(r);t(i),W(await Et({name:e,outDir:M(n.out)}),i)}),r.command(`middleware <name>`).description(`Generate a global middleware function, typed for the configured runtime
|
|
331
|
+
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,n,r)=>{let i=U(r);t(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;W(await re({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0,runtime:a?.runtime}),i)}),r.command(`guard <name>`).description(`Generate a route guard (auth, roles, etc.)
|
|
332
|
+
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,n,r)=>{let i=U(r);t(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;W(await ce({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),i)}),r.command(`contributor <name>`).description(`Generate a Context Contributor (typed alternative to @Middleware for ctx.set)
|
|
331
333
|
--type http (default, RequestContext) | bare (ExecutionContext)
|
|
332
334
|
--params "source:string,region:number" → emits the withParams<T>() form
|
|
333
|
-
Use -m to scope it to a module: kick g contributor tenant -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).option(`-t, --type <type>`,`Contributor flavour: http | bare`,`http`).option(`-k, --key <key>`,`Context key it writes (defaults to camelCase of name)`).option(`--params <fields>`,`Per-call params, e.g. "source:string,region:number"`).action(async(e,n,r)=>{let i=U(r);t(i);let a=(n.type??`http`).toLowerCase();a!==`http`&&a!==`bare`&&(console.warn(` kick g contributor: unknown --type '${n.type}', using 'http'.`),a=`http`);let o=await
|
|
334
|
-
Use -m to scope it to a module: kick g service payment -m orders`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,n,r)=>{let i=U(r);t(i);let a=await
|
|
335
|
-
Use -m to scope it to a module: kick g controller auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,n,r)=>{let i=U(r);t(i);let a=await
|
|
336
|
-
Use -m to scope it to a module: kick g dto create-user -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,n,r)=>{let i=U(r);t(i);let a=await
|
|
337
|
-
Use -m to scope it to a module: kick g test user-service -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module's __tests__/ folder`).action(async(e,n,r)=>{let i=U(r);t(i);let a=await
|
|
335
|
+
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,n,r)=>{let i=U(r);t(i);let a=(n.type??`http`).toLowerCase();a!==`http`&&a!==`bare`&&(console.warn(` kick g contributor: unknown --type '${n.type}', using 'http'.`),a=`http`);let o=await C(process.cwd()),s=w(o),c=s.dir??`src/modules`;W(await Ot({name:e,type:a,key:n.key,params:n.params,outDir:n.out,moduleName:n.module,modulesDir:c,pattern:o?.pattern,pluralize:s.pluralize??!0}),i)}),r.command(`service <name>`).description(`Generate a @Service() class
|
|
336
|
+
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,n,r)=>{let i=U(r);t(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;W(await le({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),i)}),r.command(`controller <name>`).description(`Generate a @Controller() class with basic routes
|
|
337
|
+
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,n,r)=>{let i=U(r);t(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;W(await me({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),i),await Xt(i)}),r.command(`dto <name>`).description(`Generate a DTO schema for the project’s validation library
|
|
338
|
+
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,n,r)=>{let i=U(r);t(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;W(await he({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0,schemaLib:ke(T())}),i)}),r.command(`test <name>`).description(`Generate a Vitest test scaffold
|
|
339
|
+
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,n,r)=>{let i=U(r);t(i);let a=await C(process.cwd()),o=w(a),s=o.dir??`src/modules`;W(await Jt({name:e,outDir:n.out,moduleName:n.module,modulesDir:s,pluralize:o.pluralize??!0}),i)}),r.command(`scaffold <name> [fields...]`).description(`Generate a full CRUD module from field definitions
|
|
338
340
|
Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
|
|
339
341
|
Types: string, text, number, int, float, boolean, date, email, url, uuid, json, enum:a,b,c
|
|
340
342
|
Optional: append :optional (shell-safe): description:text:optional
|
|
341
|
-
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,n,r,i)=>{let a=U(i);t(
|
|
343
|
+
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,n,r,i)=>{let a=tn(i,r),o=U(i);t(o),n.length===0&&(console.error(`
|
|
342
344
|
Error: At least one field is required.
|
|
343
345
|
Usage: kick g scaffold <name> <field:type> [field:type...]
|
|
344
346
|
Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
|
|
345
347
|
Optional: append :optional (shell-safe, no quoting needed)
|
|
346
|
-
`),process.exit(1));let
|
|
347
|
-
`,u=``;if(
|
|
348
|
+
`),process.exit(1));let s=await C(process.cwd()),c=w(s),l=a.modulesDir??c.dir??`src/modules`,u=Ut(n),d=je(s,process.cwd()),f=Oe(T()),p=await Wt({name:e,fields:u,modulesDir:M(l),noEntity:a.entity===!1,noTests:a.tests===!1,pluralize:a.pluralize===!1?!1:c.pluralize??!0,tokenScope:d,swagger:f,style:c.style});console.log(`\n Scaffolded ${e} with ${u.length} field(s):`);for(let e of u)console.log(` ${e.name}: ${e.type}${e.optional?` (optional)`:``}`);W(p,o),await Xt(o)}),r.command(`config`).description(`Generate a kick.config.ts at the project root`).option(`--modules-dir <dir>`,`Modules directory path`,`src/modules`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name`,`inmemory`).option(`-f, --force`,`Overwrite existing kick.config.ts without prompting`).action(async(e,n)=>{let r=U(n);t(r),W(await kt({outDir:M(`.`),modulesDir:e.modulesDir,defaultRepo:e.repo,force:e.force}),r)}),r.command(`agents`).alias(`agent-docs`).alias(`ai-docs`).description(`Regenerate .agents/* + root CLAUDE.md (sync after framework upgrades)`).option(`--only <which>`,`Limit scope: agents | claude | skills | gemini | copilot | both (agents+claude) | all (default: all)`,`all`).option(`--name <name>`,`Project name (defaults to package.json name)`).option(`--pm <pm>`,`Package manager (defaults to package.json packageManager)`).option(`--template <template>`,`Template: rest | minimal | fullstack`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,n)=>{let r=U(n);t(r);let i=e.only??`all`;if(!Yt.includes(i)){console.error(` Invalid --only value: ${i}. Expected: ${Yt.join(` | `)}`),process.exitCode=1;return}W(await Fe({outDir:M(`.`),only:i,name:e.name,pm:e.pm,template:e.template,force:e.force}),r)});for(let e of n?.generators??[])an(r,e,n?.projectRoot)}function an(e,n,r){let{source:i,spec:a}=n,o=a.args?.[0],s=o?.name??`itemName`,c=o?.required?`<${s}>`:`[${s}]`,l=`${a.name} ${c} [extraArgs...]`,u=e.command(l).description(`${a.description} [${i}]`);for(let e of a.flags??[]){let t=e.takesValue?`--${e.name} <value>`:`--${e.name}`,n=e.alias?`-${e.alias}, ${t}`:t;u.option(n,e.description??``)}u.action(async(e,i,o,s)=>{let c=U(s);t(c);let l=await ie({generatorName:a.name,itemName:e??``,args:i??[],flags:o,cwd:process.cwd(),projectRoot:r},[n]);l&&W(l.files,c)})}const on=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: `;async function sn(e){let t=O.resolve(e.cwd,`.kickjs/types`);e.check||await dt(t,{recursive:!0});let n=new Map,r=e.scan??Ge,i=O.resolve(e.cwd,`.kickjs`,`cache`),a=e.scan?void 0:e.changedFiles,o={cwd:e.cwd,config:e.config,async importTs(e){return await import(z(e).href)},async writeFile(t,n){let r=O.resolve(e.cwd,t);await dt(O.dirname(r),{recursive:!0}),await R(r,n,`utf8`)},getScanResult:e=>{let t=cn(e),o=n.get(t);if(!o){let s={cacheDir:i,...e};o=a?We(s,a):r(s),n.set(t,o)}return o},log:console,watch:e.watch,check:e.check},s=[],c=[];for(let n of e.plugins){let r=n.outExtension??`.d.ts`,i=O.join(t,`${n.id.replace(/\//g,`__`)}${r}`),a;try{a=await n.generate(o)}catch(t){let r=t instanceof Error?t.message:String(t);if(e.check)throw Error(`kick typegen --check: ${n.id} failed to generate (${r})`,{cause:t});o.log.error(` ${n.id}: typegen failed (${r}) — keeping previous output`),s.push({id:n.id,status:`error`,outFile:i});continue}if(a===null){s.push({id:n.id,status:`skipped`});continue}let l=`${on}${n.id} */\n\n`+a+`
|
|
349
|
+
`,u=``;if(P(i)&&(u=await L(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 R(i,l,`utf8`),s.push({id:n.id,status:`written`,outFile:i})}if(c.length>0)throw new _e(c);return s}function cn(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 ln(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 un=e({applyDisableFilter:()=>ln,runAllPluginTypegens:()=>G});async function G(e){let{enabled:t,skipped:n,unknown:r}=ln(B([...Yi,...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 sn({cwd:e.cwd,config:e.config??{},plugins:t,watch:e.watch,check:e.check,changedFiles:e.changedFiles});if(!e.silent&&se())for(let e of n)console.log(` ${e.id}: ${e.status}`);return n}catch(t){if(t instanceof _e||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 dn(e){let t=A(e,`node_modules`,`.bin`),n=process.platform===`win32`;for(let e of[`vue-tsc`,`tsgo`,`tsc`]){let r=n?[`${e}.CMD`,`${e}.cmd`,`${e}.exe`]:[e];for(let i of r){let r=A(t,i);if(P(r))return{cmd:r,args:[`--noEmit`],shell:n,kind:e}}}return null}function fn(e){let t=e.spawnFn??gt,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 pn(e,t=12){let n=e.trim().split(/\r?\n/);return n.length<=t?n.join(`
|
|
348
350
|
`):`${n.slice(0,t).join(`
|
|
349
|
-
`)}\n… ${n.length-t} more line(s)`}function
|
|
351
|
+
`)}\n… ${n.length-t} more line(s)`}function mn(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function hn(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 gn(e,t,n={}){t&&(process.env.PORT=t);let r=mn(n.polling),i=process.cwd(),a=await C(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await $e({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=M(i,a?.typegen?.outDir??`.kickjs/types`);try{let e=await G({cwd:i,config:a});await Ke(c,e,!1)}catch(e){console.warn(` kick typegen: plugin pass skipped (${e?.message??e})`)}let{createRequire:l}=await import(`node:module`),u=l(M(`package.json`)).resolve(`vite`),{createServer:d}=await import(z(u).href);globalThis[oe]=`kick-dev`;let f=await d({configFile:M(`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=dn(i);e?m=fn({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(pn(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=pe({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(`
|
|
350
352
|
KickJS dev server running (Vite + @forinda/kickjs-vite)
|
|
351
|
-
`),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)}async function
|
|
353
|
+
`),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)}async function _n(e){let t=await C(e);try{await $e({cwd:e,allowDuplicates:!0,schemaValidator:t?.typegen?.schemaValidator??`zod`,envFile:t?.typegen?.envFile,srcDir:t?.typegen?.srcDir,outDir:t?.typegen?.outDir,assetMap:t?.assetMap,runPlugins:!1});let n=M(e,t?.typegen?.outDir??`.kickjs/types`),r=await G({cwd:e,config:t});await Ke(n,r,!1)}catch(e){console.warn(` kick typegen: skipped before typecheck (${e?.message??e}).\n Generated types may be stale — errors inside .kickjs/types are likely from that.`)}}function vn(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 gn(e.entry,e.port,{polling:e.polling,typecheck:e.typecheck})}catch(e){e.code===`ERR_MODULE_NOT_FOUND`&&e.message?.includes(`vite`)?console.error(`
|
|
352
354
|
Error: vite is not installed.
|
|
353
355
|
Run: pnpm add -D vite unplugin-swc
|
|
354
356
|
`):console.error(`
|
|
355
357
|
Dev server failed:`,e.message??e),process.exit(1)}}),e.command(`build`).description(`Build for production via Vite`).action(async()=>{console.log(`
|
|
356
358
|
Building for production...
|
|
357
|
-
`);let{createRequire:e}=await import(`node:module`),t=e(
|
|
358
|
-
Copying directories to dist...`);for(let e of i){let t=typeof e==`string`?e:e.src,n=typeof e==`string`?
|
|
359
|
-
Building asset map...`);try{await
|
|
359
|
+
`);let{createRequire:e}=await import(`node:module`),t=e(M(`package.json`)).resolve(`vite`),{build:n}=await import(z(t).href);await n({configFile:M(`vite.config.ts`)});let r=await C(process.cwd()),i=r?.copyDirs??[];if(i.length>0){console.log(`
|
|
360
|
+
Copying directories to dist...`);for(let e of i){let t=typeof e==`string`?e:e.src,n=typeof e==`string`?A(`dist`,e):e.dest??A(`dist`,t),r=M(t),i=M(n);if(!P(r)){console.log(` ⚠ Skipped ${t} (not found)`);continue}st(i,{recursive:!0}),ot(r,i,{recursive:!0}),console.log(` ✓ ${t} → ${n}`)}}if(r?.assetMap&&Object.keys(r.assetMap).length>0){console.log(`
|
|
361
|
+
Building asset map...`);try{await Pe(r,{cwd:process.cwd()})}catch(e){console.error(` ✗ asset build failed: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}console.log(`
|
|
360
362
|
Build complete.
|
|
361
|
-
`)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await
|
|
362
|
-
Building asset map...`);try{await
|
|
363
|
+
`)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await C(process.cwd());if(!e?.assetMap||Object.keys(e.assetMap).length===0){console.log(` No assetMap entries — nothing to build.`);return}console.log(`
|
|
364
|
+
Building asset map...`);try{await Pe(e,{cwd:process.cwd()}),console.log(`
|
|
363
365
|
Asset build complete.
|
|
364
|
-
`)}catch(e){console.error(` ✗ ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}),e.command(`start`).description(`Start production server`).option(`-e, --entry <file>`,`Entry file`,`dist/index.js`).option(`-p, --port <port>`,`Port number`).action(e=>{let t={NODE_ENV:`production`};e.port&&(t.PORT=String(e.port)),
|
|
366
|
+
`)}catch(e){console.error(` ✗ ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}),e.command(`start`).description(`Start production server`).option(`-e, --entry <file>`,`Entry file`,`dist/index.js`).option(`-p, --port <port>`,`Port number`).action(e=>{let t={NODE_ENV:`production`};e.port&&(t.PORT=String(e.port)),Se(e.entry,t)}),e.command(`typecheck`).description(`Type-check the project with its own tsgo/tsc`).option(`--cwd <dir>`,`Directory to type-check`,`.`).option(`--no-typegen`,`Skip refreshing .kickjs/types first`).action(async e=>{let t=M(process.cwd(),e.cwd??`.`);e.typegen!==!1&&await _n(t);let n=dn(t);if(!n){console.error(`
|
|
365
367
|
No type-checker found. Install one in this project:
|
|
366
368
|
pnpm add -D typescript (tsc)
|
|
367
369
|
pnpm add -D @typescript/native-preview (tsgo, faster)
|
|
368
|
-
`),process.exit(1);return}let r=
|
|
369
|
-
Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function
|
|
370
|
-
`))})}const{bold:K,dim:q,green:
|
|
370
|
+
`),process.exit(1);return}let r=_t(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 hn(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 gn(e.entry,e.port)}catch(e){console.error(`
|
|
371
|
+
Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function yn(){try{let e=k(vt(import.meta.url));return JSON.parse(F(A(e,`..`,`package.json`),`utf-8`)).version??`unknown`}catch{return`unknown`}}const bn=new Set(Object.values(Te).filter(e=>e.deprecated).map(e=>e.pkg));function xn(e){let t=A(e,`package.json`);if(!P(t))return[];let n;try{n=JSON.parse(F(t,`utf-8`))}catch{return[]}let r={...n.dependencies,...n.devDependencies};return Object.keys(r).filter(e=>e===`@forinda/kickjs`||e.startsWith(`@forinda/kickjs-`)).toSorted().map(t=>{let n=null,i=A(e,`node_modules`,...t.split(`/`),`package.json`);if(P(i))try{n=JSON.parse(F(i,`utf-8`)).version??null}catch{}return{name:t,installed:n,declared:r[t]??null,deprecated:bn.has(t)}})}function Sn(e){let t=e;for(;;){if(P(A(t,`package.json`)))return t;let e=k(t);if(e===t)return null;t=e}}function Cn(e){e.command(`info`).description(`Print system and framework info`).action(()=>{let e=[``,` KickJS CLI v${yn()}`,``,` System:`,` OS: ${xt()} ${St()} (${bt()})`,` Node: ${process.version}`],t=Sn(process.cwd()),n=t?xn(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(`
|
|
372
|
+
`))})}const{bold:K,dim:q,green:wn,red:Tn,yellow:En,blue:Dn}=m;function On(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 kn(e){let t=await fetch(e,{signal:AbortSignal.timeout(5e3)});if(!t.ok)throw Error(`${t.status} ${t.statusText}`);return t.json()}async function J(e,t){try{return await kn(`${e}${t}`)}catch{return null}}async function An(e){let[t,n,r,i,a]=await Promise.all([J(e,`/health`),J(e,`/metrics`),J(e,`/routes`),J(e,`/container`),J(e,`/ws`)]);return{health:t,metrics:n,routes:r,container:i,ws:a}}function jn(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`?wn(`● healthy`):Tn(`● `+n.status);console.log(` ${K(`Health:`)} ${e}`)}else console.log(` ${K(`Health:`)} ${Tn(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?Tn:r.errorRate>0?En:wn;console.log(` ${K(`Uptime:`)} ${On(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(` ${c(e.method)} ${t} ${Dn(e.controller)}.${q(e.handler)}`)}}console.log(s),console.log()}function Mn(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 An(r);t.json?console.log(JSON.stringify(e,null,2)):jn(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(Tn(` ✖ 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 Y(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 Nn=[{match(e,t){let n=Y(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
|
|
371
373
|
src/config/index.ts, and src/index.ts imports it before bootstrap().
|
|
372
374
|
Tests never load src/index.ts — \`createTestApp\` builds the app
|
|
373
375
|
directly — so that import does not run and ConfigService falls back to
|
|
@@ -582,24 +584,24 @@ import { bootstrap } from '@forinda/kickjs'
|
|
|
582
584
|
await bootstrap({ modules }) // ← nothing for the dev server to read`,codeAfter:`import './env'
|
|
583
585
|
import { bootstrap } from '@forinda/kickjs'
|
|
584
586
|
|
|
585
|
-
export const app = await bootstrap({ modules })`,docs:`https://kickjs.app/guide/project-structure.html`}}}}];function
|
|
587
|
+
export const app = await bootstrap({ modules })`,docs:`https://kickjs.app/guide/project-structure.html`}}}}];function Pn(e,t){let n=null;for(let r of Nn){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 Fn(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.
|
|
586
588
|
export OPENAI_API_KEY="sk-..."
|
|
587
589
|
|
|
588
590
|
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:
|
|
589
591
|
kick add ai
|
|
590
592
|
|
|
591
593
|
Or manually:
|
|
592
|
-
pnpm add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=
|
|
593
|
-
`)}function
|
|
594
|
+
pnpm add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=In(e.cwd),s=`Error or stack trace:\n\n${e.input.trim()}`;try{let e=Ln((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 In(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(`
|
|
595
|
+
`)}function Ln(e){let t=[e,Rn(e),zn(e)].filter(e=>e!==null);for(let e of t)try{let t=JSON.parse(e);if(Bn(t))return t}catch{continue}return null}function Rn(e){let t=e.match(/```(?:json)?\s*\n([\s\S]*?)```/);return t?t[1]?.trim()??null:null}function zn(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 Bn(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 Vn(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 Wn(e,t.message);(!n||n.trim().length===0)&&(process.stderr.write(`Error: no input provided.
|
|
594
596
|
|
|
595
597
|
Pass a message as a positional arg, --message flag, or pipe via stdin:
|
|
596
598
|
kick explain "config.get returned undefined"
|
|
597
599
|
pnpm test 2>&1 | kick explain
|
|
598
|
-
`),process.exit(1));let r=
|
|
599
|
-
`);return}if(i){
|
|
600
|
-
`),process.exit(2)),
|
|
601
|
-
`),process.exit(a.kind===`ok`?0:2)),
|
|
602
|
-
`)}function
|
|
600
|
+
`),process.exit(1));let r=Kn(),i=Pn(n,r);if(t.json&&i){process.stdout.write(JSON.stringify({matched:!0,...i},null,2)+`
|
|
601
|
+
`);return}if(i){qn(n,i.diagnosis,i.confidence);return}t.ai||(t.json&&(process.stdout.write(JSON.stringify({matched:!1},null,2)+`
|
|
602
|
+
`),process.exit(2)),Jn(n),process.exit(2));let a=await Fn({input:n,model:t.model,cwd:r.cwd});t.json&&(process.stdout.write(JSON.stringify(Hn(a),null,2)+`
|
|
603
|
+
`),process.exit(a.kind===`ok`?0:2)),Un(n,a),process.exit(a.kind===`ok`?0:2)})}function Hn(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 Un(e,t){if(t.kind===`ok`){qn(e,t.diagnosis,-1,!0);return}if(t.kind===`unavailable`){process.stdout.write(`\n Explaining: ${Yn(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: ${Yn(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback error: ${t.message}\n\n`)}async function Wn(e,t){return e&&e.trim().length>0?e:t&&t.trim().length>0?t:process.stdin.isTTY?``:Gn()}function Gn(){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 Kn(){let e=process.cwd();return{cwd:e,hasFile:t=>P(M(e,t))}}function qn(e,t,n,r=!1){let i=Yn(e.trim(),200),a=r?`AI-generated — verify before applying`:Xn(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(`
|
|
604
|
+
`)}function Jn(e){let t=Yn(e.trim(),200);process.stdout.write(`\n Explaining: ${t}\n\n`),process.stdout.write(` No known-issue matched. Things you can try:
|
|
603
605
|
|
|
604
606
|
1. Check the framework docs for the error keywords:
|
|
605
607
|
https://kickjs.app/
|
|
@@ -613,10 +615,10 @@ Pass a message as a positional arg, --message flag, or pipe via stdin:
|
|
|
613
615
|
|
|
614
616
|
`)}function Z(e,t){return e.split(`
|
|
615
617
|
`).map(e=>`${t}${e}`).join(`
|
|
616
|
-
`)}function
|
|
617
|
-
`,`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
|
|
618
|
+
`)}function Yn(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function Xn(e){return e>=90?`high confidence`:e>=70?`good match`:e>=50?`medium confidence`:`low confidence — verify manually`}function Zn(e){let t=e.command(`mcp`).description(`Model Context Protocol commands (start | init)`);t.command(`start`,{isDefault:!0}).description(`Run the built application as an MCP server over stdio`).option(`-e, --entry <file>`,`Entry file`,`dist/index.js`).option(`--node-arg <arg...>`,`Extra arguments to pass to node`).action(Qn),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($n)}function Qn(e){let t=M(e.entry);P(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=gt(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 $n(e){let t=process.cwd(),n=er(t)??at(t),r=e.name??n,i=e.global?M(process.env.HOME??`.`,`.mcp.json`):M(t,e.out),a={command:`kick`,args:[`mcp`],cwd:t},o={mcpServers:{}};if(P(i))try{let e=F(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,I(i,JSON.stringify(o,null,2)+`
|
|
619
|
+
`,`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 er(e){let t=M(e,`package.json`);if(!P(t))return null;try{let e=F(t,`utf8`),n=JSON.parse(e);return typeof n.name==`string`?n.name:null}catch{return null}}function tr(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=M(t,e.entry);P(n)||(console.error(`\n Error: ${e.entry} not found.\n`),process.exit(1));let r=rr(t,`tsx`);r||(console.error(`
|
|
618
620
|
Error: tsx not found. Install it: pnpm add -D tsx
|
|
619
|
-
`),process.exit(1));let i=
|
|
621
|
+
`),process.exit(1));let i=nr(n,e.entry),a=A(t,`.kick-tinker.mjs`),{writeFileSync:o,unlinkSync:s}=await import(`node:fs`);o(a,i,`utf-8`);try{let e=ht(a,[],{cwd:t,execPath:r,stdio:`inherit`});await new Promise(t=>{e.on(`exit`,()=>t())})}finally{try{s(a)}catch{}}})}function nr(e,t){return`
|
|
620
622
|
import 'reflect-metadata'
|
|
621
623
|
|
|
622
624
|
// Prevent bootstrap() from starting the HTTP server
|
|
@@ -641,7 +643,7 @@ try {
|
|
|
641
643
|
|
|
642
644
|
// Load entry to trigger decorator registration
|
|
643
645
|
try {
|
|
644
|
-
await import('${
|
|
646
|
+
await import('${z(e).href}')
|
|
645
647
|
} catch (err) {
|
|
646
648
|
console.warn(' Warning: ' + err.message)
|
|
647
649
|
console.warn(' Container may be partially initialized.\\n')
|
|
@@ -670,38 +672,38 @@ server.on('exit', () => {
|
|
|
670
672
|
console.log('\\n Goodbye!\\n')
|
|
671
673
|
process.exit(0)
|
|
672
674
|
})
|
|
673
|
-
`}function
|
|
675
|
+
`}function rr(e,t){let n=e;for(;;){let e=A(n,`node_modules`,`.bin`,t);if(P(e))return e;let r=M(n,`..`);if(r===n)break;n=r}return null}function ir(e,t){let n=RegExp(`^\\s*${h(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]!==`
|
|
674
676
|
`;)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]===`
|
|
675
|
-
`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t;continue}i=s+1}return{content:a,changed:r}}function
|
|
677
|
+
`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t;continue}i=s+1}return{content:a,changed:r}}function ar(e,t){let n=te(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=ir(a,t).content,a=a.replace(RegExp(`\\s*,?\\s*${h(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 or(e){let{name:t,modulesDir:n,force:i}=e,a=e.pluralize!==!1,o=S(t),s=y(t),c=a?de(o):o;c!==o&&!await r(A(n,c))&&await r(A(n,o))&&(c=o);let l=A(n,c);if(!await r(l)){console.log(`\n Module not found: ${l}\n`);return}if(!i&&!await p({message:m.red(`Delete module '${c}' at ${l}? This cannot be undone.`),initialValue:!1})){console.log(`
|
|
676
678
|
Cancelled.
|
|
677
|
-
`);return}await
|
|
679
|
+
`);return}await pt(l,{recursive:!0,force:!0}),console.log(` Deleted: ${l}`);let u=A(n,`index.ts`);if(await r(u)){let e=await L(u,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${h(s)}Module\\s*\\}\\s*from\\s*['"][^'"]*${h(c)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=ar(e,s),e=e.replace(/\n{3,}/g,`
|
|
678
680
|
|
|
679
|
-
`),e!==t&&(await
|
|
681
|
+
`),e!==t&&(await R(u,e,`utf-8`),console.log(` Unregistered: ${s}Module from ${u}`))}console.log(`\n Module '${c}' removed.\n`)}function sr(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=await C(process.cwd()),r=w(n),i=t.modulesDir??r.dir??`src/modules`,a=t.pluralize===!1?!1:r.pluralize??!0;for(let n of e)await or({name:n,modulesDir:M(i),force:t.force,pluralize:a})})}function cr(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 lr(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function ur(e){e.command(`typegen`).description(`Generate type-safe DI registry and module types into .kickjs/types/`).option(`-w, --watch`,`Watch source files and regenerate on change`).option(`-s, --src <dir>`,`Source directory to scan`,`src`).option(`-o, --out <dir>`,`Output directory`,`.kickjs/types`).option(`--silent`,`Suppress output`).option(`--allow-duplicates`,`Auto-namespace duplicate class names instead of failing (use with caution)`).option(`--schema-validator <name>`,`Schema validator for body/query/params typing (currently 'zod' or 'false')`).option(`--env-file <path>`,`Path to env schema file for KickEnv typing (default 'src/env.ts'; pass 'false' to disable)`).option(`--check`,`CI gate: exit non-zero if any generated file in .kickjs/types/ is out of date (routes, env, db, assets, adopter plugins) instead of writing it`).option(`--fix`,`Patch module import.meta.glob() calls to cover decorated classes that aren't loaded by any glob (orphans)`).option(`--list`,"List every registered typegen plugin id (use to populate `typegen.disable`)").option(`--no-cache`,`Disable the persistent scan cache; re-read + re-extract every file from cold`).action(async e=>{let t=T(process.cwd()),n=await C(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-BWaA0gd6.mjs`),{builtinCliPlugins:t}=await import(`./builtins-C_zzIKuU.mjs`),r=e([...t,...n?.plugins??[]],n?.commands??[]),i=new Set(n?.typegen?.disable??[]);if(r.typegens.length===0){console.log(` No typegen plugins registered.`);return}let a=Math.max(...r.typegens.map(e=>e.id.length));console.log(`
|
|
680
682
|
Registered typegen plugins:
|
|
681
683
|
`);for(let e of r.typegens){let t=i.has(e.id)?` (disabled)`:``,n=`${e.id.replace(/\//g,`__`)}${e.outExtension??`.d.ts`}`;console.log(` ${e.id.padEnd(a+2)}→ .kickjs/types/${n}${t}`),console.log(` ${` `.repeat(a+2)} watches: ${e.inputs.join(`, `)||`(none)`}`)}console.log(`
|
|
682
684
|
Disable one in kick.config.ts:
|
|
683
685
|
`),console.log(` typegen: { disable: ['`+(r.typegens[0]?.id??`kick/x`)+`'] }
|
|
684
|
-
`);return}let r=
|
|
686
|
+
`);return}let r=cr(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=lr(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 Ze(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 $e(a);let r=await G({cwd:t,config:n??null,silent:e.silent,check:e.check});if(e.check&&r.some(e=>e.status===`written`)&&process.exit(1),!e.check){let i=M(t,e.out??n?.typegen?.outDir??`.kickjs/types`);await Ke(i,r,e.silent??!1)}}}catch(e){e instanceof Qe?console.error(`
|
|
685
687
|
`+e.message+`
|
|
686
|
-
`):e instanceof
|
|
688
|
+
`):e instanceof _e?console.error(`
|
|
687
689
|
`+e.message+`
|
|
688
|
-
`):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}const
|
|
689
|
-
`).length:1}function
|
|
690
|
+
`):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}const dr=new Set([`Service`,`Injectable`,`Component`,`Repository`]);function fr(e,t){return typeof t==`number`?e.slice(0,t).split(`
|
|
691
|
+
`).length:1}function pr(e){let t=Ie(e);if(t===`singleton`||t===`transient`||t===`request`)return t;if(Le(e)&&e.type===`MemberExpression`&&D(e.object)===`Scope`){let t=D(e.property);if(t===`SINGLETON`)return`singleton`;if(t===`TRANSIENT`)return`transient`;if(t===`REQUEST`)return`request`}return`unknown`}function mr(e){let t=D(e);if(t)return{key:`id:${t}`,label:t};let n=Ie(e);return n===null?null:{key:`lit:${n}`,label:`'${n}'`}}function hr(e,t){let n=(e.body?.body??[]).find(e=>e.type===`MethodDefinition`&&e.kind===`constructor`)?.value?.params??[],r=[];for(let e of n){let n=e.type===`TSParameterProperty`?e.parameter:e,i=tt(e).map(Re).find(e=>e?.name===`Inject`),a=null;if(i)a=mr(i.call.arguments?.[0]);else{let e=n?.typeAnnotation?.typeAnnotation??null;e?.type===`TSTypeReference`&&(a=mr(e.typeName))}a&&r.push({...a,line:fr(t,e.start)})}return r}function gr(e){let t=new Map,n=new Map,r=[],i=(e,n)=>{t.has(e)||t.set(e,new Set),t.get(e).add(n)},a=(e,t)=>{e&&(n.has(e)||n.set(e,new Set),n.get(e).add(t))};for(let{path:t,source:n}of e){let e;try{let r=yt(t,n);if(r.errors.length>0)continue;e=r.program}catch{continue}for(let n of e.body??[]){let e=(n.type===`ExportNamedDeclaration`||n.type===`ExportDefaultDeclaration`)&&Le(n.declaration)?n.declaration:n;if(e.type===`ClassDeclaration`&&a(D(e.id),t),e.type===`VariableDeclaration`)for(let n of e.declarations??[])a(D(n.id),t)}nt(e,e=>{if(e.type===`ClassDeclaration`){let a=D(e.id);if(!a)return;for(let o of tt(e)){let s=Re(o);if(s){if(s.name===`Controller`){i(`id:${a}`,`singleton`),r.push({name:a,kind:`controller`,file:t,params:hr(e,n)});return}if(dr.has(s.name)){let o=Be(rt(s.call),`scope`),c=o?pr(o):`singleton`;i(`id:${a}`,c),r.push({name:a,kind:`other`,file:t,params:hr(e,n)});return}}}return}if(e.type!==`CallExpression`)return;let a=e.callee;if(!Le(a)||a.type!==`MemberExpression`)return;let o=D(a.property);if(o!==`register`&&o!==`registerFactory`)return;let s=e.arguments??[];if(s.length<2)return;let c=mr(s[0]);c&&i(c.key,s.length>=3?pr(s[2]):`singleton`)})}let o=e=>(n.get(e)?.size??0)<=1,s=(e,n)=>{let r=t.get(e);return r?.size===1&&r.has(n)},c=[];for(let e of r)if(o(e.name)&&s(`id:${e.name}`,`singleton`))for(let t of e.params){if(t.key.startsWith(`id:`)&&!o(t.label)||!s(t.key,`request`))continue;let n=e.kind===`controller`?`@Controller() is always SINGLETON, so inject ${t.label} with @Autowired() instead of the constructor.`:`Give ${e.name} TRANSIENT or REQUEST scope, or inject ${t.label} with @Autowired() instead of the constructor.`;c.push({file:e.file,line:t.line,parent:e.name,dependency:t.label,message:`${e.name} (SINGLETON) injects REQUEST-scoped ${t.label} through its constructor — the first request that resolves it answers 500. ${n}`})}return c}function _r(e){let t=[];if(!P(e))return t;let n=ct(e,{withFileTypes:!0});for(let r of n){let n=A(e,r.name);if(r.isDirectory()){if([`node_modules`,`dist`,`.kickjs`,`.git`].includes(r.name))continue;t.push(..._r(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function vr(e){try{return F(e,`utf-8`)}catch{return``}}const yr=new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function br(e,t){let n=vr(A(e,`.env`));if(n){let e=n.match(/^JWT_SECRET\s*=\s*['"]?([^'"\n]*)['"]?/m);if(e){let t=e[1].trim();if(yr.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 xr(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 Sr(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 Cr(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function wr(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 Tr(e){for(let t of e)if(/helmet\s*\(/.test(t))return/security\s*\.\s*helmet\s*.*false/.test(t)?{severity:`WARNING`,message:`Helmet security headers are disabled — enable them for production`}:{severity:`INFO`,message:`Helmet security headers active`};return{severity:`WARNING`,message:`Helmet not detected — add helmet() middleware for security headers`}}function Er(e){for(let t of e)if(/AuthAdapter/i.test(t))return{severity:`INFO`,message:`AuthAdapter configured`};return{severity:`INFO`,message:`No AuthAdapter detected — add one if your app requires authentication`}}function Dr(e){let t=_r(A(e,`src`)).map(e=>vr(e)),n=[],r=br(e,t);r&&n.push(r);let i=xr(t);i&&n.push(i);let a=Sr(t);a&&n.push(a);let o=Cr();o&&n.push(o);let s=wr(t);return s&&n.push(s),n.push(Tr(t)),n.push(Er(t)),n}function Or(e){let t=gr(_r(A(e,`src`)).filter(e=>!/\.(test|spec)\.tsx?$/.test(e)).map(t=>({path:j(e,t).split(`\\`).join(`/`),source:vr(t)})));return t.length===0?[{severity:`INFO`,message:`No REQUEST-scoped dependency injected into a singleton`}]:t.map(e=>({severity:`CRITICAL`,message:`${e.file}:${e.line} ${e.message}`}))}function kr(e){e.command(`check`).description(`Audit project for common issues`).option(`--deploy`,`Run production readiness checks`).option(`--di`,`Find REQUEST-scoped dependencies injected into singletons`).action(e=>{if(!e.deploy&&!e.di){console.log(`
|
|
690
692
|
Usage: kick check [--deploy] [--di]
|
|
691
693
|
|
|
692
694
|
Available checks:
|
|
693
695
|
--deploy Audit for production readiness (security, config, best practices)
|
|
694
696
|
--di Find REQUEST-scoped dependencies injected into singleton constructors
|
|
695
|
-
`);return}let t=process.cwd();l(e.deploy?`KickJS Deploy Check`:`KickJS DI Check`);let n=f();n.start(`Scanning project...`);let r=[...e.deploy?
|
|
697
|
+
`);return}let t=process.cwd();l(e.deploy?`KickJS Deploy Check`:`KickJS DI Check`);let n=f();n.start(`Scanning project...`);let r=[...e.deploy?Dr(t):[],...e.di?Or(t):[]];n.stop(`Scan complete`);let a={CRITICAL:0,WARNING:1,INFO:2};r.sort((e,t)=>a[e.severity]-a[t.severity]);for(let e of r)d.message(`${o(e.severity)} ${e.message}`);let s=r.filter(e=>e.severity===`CRITICAL`).length,c=r.filter(e=>e.severity===`WARNING`).length,u=r.filter(e=>e.severity===`INFO`).length,p=c===1?`warning`:`warnings`,h=[s>0?m.red(`${s} critical`):`${s} critical`,c>0?m.yellow(`${c} ${p}`):`${c} ${p}`,`${u} info`].join(`, `);s>0?(i(m.red(`${h} — fix critical issues before deploying`)),process.exit(1)):i(m.green(`${h} — looking good!`))})}function Ar(e){return e.optsWithGlobals().dryRun??!1}function jr(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.
|
|
696
698
|
Direction defaults to \`modules.style\` from kick.config (or "define").
|
|
697
699
|
--target define|class Override the migration direction.
|
|
698
700
|
--apply Apply the changes (default: dry-run preview).
|
|
699
|
-
--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,n)=>{let r=
|
|
701
|
+
--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,n)=>{let r=Ar(n)||!e.apply;t(r),e.experimental||(console.error(`
|
|
700
702
|
`+m.red(`Error:`)+` kick codemod modules is experimental — pass --experimental to acknowledge.
|
|
701
703
|
The regex-based rewrite handles the shapes our templates produce.
|
|
702
704
|
Hand-rolled modules with non-standard structures may be skipped.
|
|
703
705
|
Always commit before running with --apply.
|
|
704
|
-
`),process.exit(1));let i=await
|
|
706
|
+
`),process.exit(1));let i=await C(process.cwd()),a=w(i),o=M(e.modulesDir??a.dir??`src/modules`),s;e.target===`define`||e.target===`class`?s=e.target:e.target===void 0?s=a.style??`define`:(console.error(`\n ${m.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let c=m.dim(`→ ${s}`),l=r?m.dim(`(dry-run)`):m.bold(`(applying)`);console.log(`\n ${m.bold(`kick codemod modules`)} ${c} ${l}`),console.log(` modulesDir: ${m.dim(o)}\n`);let u=e.backup!==!1&&!r,d=await Bt(o,{dryRun:r,target:s,backup:u});if(d.backupDir){let e=d.backupDir;console.log(` ${m.green(`✓`)} backup: ${m.dim(e)}\n ${m.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else!r&&e.backup===!1&&console.log(` ${m.dim(`(--no-backup — skipping snapshot)`)}\n`);let f=0,p=0;for(let e of d.files)if(e.status===`migrated`)f++,console.log(` ${m.green(`✓`)} ${e.path}`);else{p++;let t=m.dim(`(${e.reason??`skipped`})`);console.log(` ${m.dim(`-`)} ${e.path} ${t}`)}if(console.log(),d.indexStatus===`migrated`)console.log(` ${m.green(`✓`)} ${d.indexPath}`);else if(d.indexStatus===`skipped`){let e=m.dim(`(${d.indexReason??`skipped`})`);console.log(` ${m.dim(`-`)} ${d.indexPath} ${e}`)}else console.log(` ${m.dim(`-`)} ${d.indexPath} ${m.dim(`(not found)`)}`);let h=r?m.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n ${m.bold(String(f))} migrated, ${m.bold(String(p))} skipped${h}\n`)})}function Mr(e,t=P){let n=k(e);return(t(M(n,`pnpm-workspace.yaml`))||t(M(n,`package.json`)))&&t(M(n,`web`,`package.json`))?{staticDir:`../web/dist`,siteRoot:`..`,apiPath:`/api`}:{siteRoot:`.`,apiPath:``}}function Nr(e,t,n){let r=Mr(t,n),i=e?.staticDir===!1?void 0:e?.staticDir??r.staticDir;return{entry:e?.entry??`src/serverless.ts`,outDir:e?.outDir??`dist/serverless`,staticDir:i,siteRoot:e?.siteRoot??r.siteRoot,publishDir:e?.publishDir??`dist/public`,apiPath:e?.apiPath??r.apiPath,external:e?.external??[`valibot`,`yup`],vercelRuntime:e?.vercelRuntime??`nodejs22.x`}}function Pr(e,t){return`import { handler } from '${e}'
|
|
705
707
|
|
|
706
708
|
// Netlify's context carries waitUntil, so ctx.waitUntil() work finishes after the response.
|
|
707
709
|
export default (request, context) => handler.fetch(request, context)
|
|
@@ -709,13 +711,13 @@ export default (request, context) => handler.fetch(request, context)
|
|
|
709
711
|
export const config = {
|
|
710
712
|
path: '${t}/*',
|
|
711
713
|
}
|
|
712
|
-
`}function
|
|
714
|
+
`}function Fr(){return`import { handler } from './server.mjs'
|
|
713
715
|
|
|
714
716
|
const requestContext = () => globalThis[Symbol.for('@vercel/request-context')]?.get?.()
|
|
715
717
|
|
|
716
718
|
export default (req, res) => handler.node(req, res, requestContext())
|
|
717
|
-
`}function
|
|
718
|
-
`).length,a=e=>{if(!e||typeof e!=`object`)return;if(Array.isArray(e))return e.forEach(a);let n=e,o=n.expression;if(n.type===`Decorator`&&o?.type===`CallExpression`&&o.callee?.type===`Identifier`&&o.callee.name===`Cron`){let[e,a]=o.arguments??[],s=e?.type===`Literal`&&typeof e.value==`string`?e.value:e?.type===`TemplateLiteral`&&e.expressions.length===0?e.quasis[0]?.value?.cooked:void 0;r.push({file:t,line:i(n.start??0),expression:s,timezone:a?.type===`ObjectExpression`&&a.properties.some(e=>(e.key?.name??e.key?.value)===`timezone`)})}for(let e in n)e!==`parent`&&a(n[e])};return a(n),r}function
|
|
719
|
+
`}function Ir(e){return/^\s*publish\s*=\s*["']([^"']+)["']/m.exec(e)?.[1]?.replace(/^\.\//,``).replace(/\/+$/,``)}function Lr(e,t,n=!1){let r=[{handle:`filesystem`},{src:`^${e}/(.*)$`,dest:`/api`}];return n&&e!==``&&r.push({src:`^/_kick/(.*)$`,dest:`/api`}),t&&r.push({src:`^/(.*)$`,dest:`/index.html`}),r}function Rr(e,t){let n;try{n=yt(t,e).program}catch{return[]}let r=[],i=t=>e.slice(0,t).split(`
|
|
720
|
+
`).length,a=e=>{if(!e||typeof e!=`object`)return;if(Array.isArray(e))return e.forEach(a);let n=e,o=n.expression;if(n.type===`Decorator`&&o?.type===`CallExpression`&&o.callee?.type===`Identifier`&&o.callee.name===`Cron`){let[e,a]=o.arguments??[],s=e?.type===`Literal`&&typeof e.value==`string`?e.value:e?.type===`TemplateLiteral`&&e.expressions.length===0?e.quasis[0]?.value?.cooked:void 0;r.push({file:t,line:i(n.start??0),expression:s,timezone:a?.type===`ObjectExpression`&&a.properties.some(e=>(e.key?.name??e.key?.value)===`timezone`)})}for(let e in n)e!==`parent`&&a(n[e])};return a(n),r}function zr(e){let t=M(e,`src`);return P(t)?ct(t,{recursive:!0,encoding:`utf-8`}).filter(e=>/\.m?ts$/.test(e)&&!/\.(test|spec|d)\.m?ts$/.test(e)).flatMap(e=>{let n=F(M(t,e),`utf-8`);return n.includes(`@Cron`)?Rr(n,`src/${e}`):[]}):[]}function Br(e){let t=2166136261;for(let n of e.trim().replace(/\s+/g,` `))t^=n.codePointAt(0),t=Math.imul(t,16777619)>>>0;return t.toString(36)}function Vr(e){let t=[],n=new Map;for(let r of e){let e=`${r.file}:${r.line}`;if(r.expression===void 0){t.push(`${e}: @Cron expression is not a string literal, so it has no Vercel cron entry`);continue}r.timezone&&t.push(`${e}: Vercel crons run in UTC — the timezone option is ignored there`);let i=r.expression.trim().replace(/\s+/g,` `);if(i.split(` `).length!==5){t.push(`${e}: Vercel crons need a five-field expression, so it has no Vercel cron entry`);continue}n.set(Br(i),i)}return{crons:[...n].map(([e,t])=>({path:`/_kick/cron/${e}`,schedule:t})),warnings:t}}function Hr(e){let t=e=>{if(typeof e==`string`)return e;if(!e||typeof e!=`object`)return;let n=e;for(let e of[`import`,`module`,`node`,`default`]){let r=t(n[e]);if(r)return r}},n=e.exports;return t(typeof n==`string`||Array.isArray(n)?n:n?.[`.`]??n)??e.module??e.main}async function Ur(e,t){let{createRequire:n}=await import(`node:module`),r=n(M(e,`package.json`)),i;try{i=r.resolve(`${t}/package.json`)}catch{i=M(e,`node_modules`,t,`package.json`)}if(!P(i))throw Error(`${t} is not installed in this project. Run: pnpm add -D vite unplugin-swc @forinda/kickjs-vite`);let a=Hr(JSON.parse(F(i,`utf-8`)));if(!a)throw Error(`${t} has no importable entry point`);return import(z(M(k(i),a)).href)}async function Wr(e,t,n){let r=M(e,t.entry);if(!P(r))throw Error(`${t.entry} not found. The serverless entry exports \`handler = createHandler({ modules })\` — see the Serverless guide.`);let{build:i}=await Ur(e,`vite`),{default:a}=await Ur(e,`unplugin-swc`),{devtoolsFlagPlugin:o,devtoolsStripPlugin:s}=await Ur(e,`@forinda/kickjs-vite`);await i({configFile:!1,root:e,logLevel:`warn`,oxc:!1,plugins:[a.vite(),o(),s()],resolve:{alias:{"@":M(e,`src`)}},ssr:{noExternal:!0,target:`node`},build:{ssr:!0,target:`node20`,outDir:M(e,t.outDir),emptyOutDir:!0,minify:!1,rollupOptions:{input:r,external:t.external.filter(t=>!P(M(e,`node_modules`,t))),output:{format:`esm`,entryFileNames:`server.mjs`,codeSplitting:!1}}}});let c=M(e,t.outDir,`server.mjs`);return n(`bundled ${j(process.cwd(),c)}`),c}function Gr(e,t){let n=t.projectRoot,r=()=>Nr(t.config?.deploy,n);e.command(`build:netlify`).description(`Bundle the serverless entry and write the Netlify function`).action(async()=>{let e=r(),i=await Wr(n,e,t.log),a=M(n,e.siteRoot),o=zr(n);o.length>0&&t.log(`warning: ${o.length} @Cron job(s) found — Netlify has no cron trigger for them, so they will not run. Use Netlify scheduled functions, or deploy to Vercel or Workers.`);let s=M(a,`.netlify/v1/functions`);st(s,{recursive:!0});let c=j(s,i).split(N).join(`/`);I(M(s,`api.mjs`),Pr(c,e.apiPath)),t.log(`wrote ${j(process.cwd(),M(s,`api.mjs`))}`);let l=e.staticDir??e.publishDir;e.staticDir||(st(M(n,l),{recursive:!0}),t.log(`publish directory ready at ${j(process.cwd(),M(n,l))}`));let u=M(a,`netlify.toml`);if(P(u)){let e=Ir(F(u,`utf-8`)),r=j(a,M(n,l)).split(N).join(`/`);e!==void 0&&e!==r&&t.log(`warning: netlify.toml publishes "${e}", but this build fills "${r}". Update netlify.toml, or set \`deploy.publishDir\` / \`deploy.staticDir\` to match.`)}}),e.command(`build:vercel`).description(`Bundle the serverless entry and write .vercel/output (Build Output API v3)`).action(async()=>{let e=r(),i=await Wr(n,e,t.log),a=M(n,e.siteRoot),o=e.staticDir?M(n,e.staticDir):void 0,s=M(a,`.vercel/output`),c=M(s,`functions/api.func`);if(lt(s,{recursive:!0,force:!0}),st(c,{recursive:!0}),ot(i,M(c,`server.mjs`)),I(M(c,`index.mjs`),Fr()),I(M(c,`.vc-config.json`),`${JSON.stringify({runtime:e.vercelRuntime,handler:`index.mjs`,launcherType:`Nodejs`,supportsResponseStreaming:!0},null,2)}\n`),o){if(!P(o))throw Error(`build:vercel: ${e.staticDir} does not exist — build the frontend first`);ot(o,M(s,`static`),{recursive:!0})}let{crons:l,warnings:u}=Vr(zr(n));for(let e of u)t.log(`warning: ${e}`);let d={version:3,routes:Lr(e.apiPath,!!o,l.length>0),...l.length>0?{crons:l}:{}};I(M(s,`config.json`),`${JSON.stringify(d,null,2)}\n`),t.log(`wrote ${j(process.cwd(),s)}`),l.length>0&&t.log(`${l.length} cron schedule(s) written. Set CRON_SECRET in the Vercel project — the trigger is not mounted without it.`)})}const Kr=()=>({id:`kick/assets`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`],async generate(e){let t=O.resolve(e.cwd,`kick.config.ts`);if(!P(t))return null;let n=await C(e.cwd);if(!n?.assetMap)return null;let r=ze(n.assetMap,e.cwd);return r.count===0?null:Ye(r)}}),qr="/* 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 Jr(e,t,n,r={}){if(e.length===0)return`${qr}
|
|
719
721
|
// (no routes discovered yet — annotate a controller method with
|
|
720
722
|
// @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
|
|
721
723
|
declare global {
|
|
@@ -732,18 +734,18 @@ declare global {
|
|
|
732
734
|
|
|
733
735
|
/** Empty until the first route exists — see kick typegen. */
|
|
734
736
|
export const kickRpc = {} as const
|
|
735
|
-
`;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=
|
|
737
|
+
`;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=Qr(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??Xr(e),u=c(e.responseSchema??null,e,`response`),d=s(e),f=u??`import('@forinda/kickjs').InferHandlerResponse<${d}['${e.method}']>`,p=Zr(e);n.push(` /**`,` * ${e.httpMethod} ${e.path}`,...p.map(e=>` * ${e}`),` */`,` ${e.method}: {`,` params: ${a}`,` body: ${o}`,` query: ${l}`,` response: ${f}`,` contextKeys: ${Yr(e)}`,` }`)}n.push(` }`),l.push(n.join(`
|
|
736
738
|
`))}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(`
|
|
737
|
-
`);l.push(p);let m=[],h=new Set;for(let[e,t]of i){let n=
|
|
739
|
+
`);l.push(p);let m=[],h=new Set;for(let[e,t]of i){let n=ti(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(`
|
|
738
740
|
`)}\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(`
|
|
739
|
-
`),_=[],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
|
|
741
|
+
`),_=[],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=ei(``,r.filePath,t),a=r.controllerIsDefaultExport?`default as ${n}`:`${r.controller} as ${n}`;_.push(`import type { ${a} } from '${i}'`)}let y=_.length>0?_.join(`
|
|
740
742
|
`)+`
|
|
741
|
-
`:``,b
|
|
742
|
-
`);return`${
|
|
743
|
+
`:``,b=$r(a)+y,ee=l.join(`
|
|
744
|
+
`);return`${qr}${b}
|
|
743
745
|
declare global {
|
|
744
746
|
// eslint-disable-next-line @typescript-eslint/no-namespace
|
|
745
747
|
namespace KickRoutes {
|
|
746
|
-
${
|
|
748
|
+
${ee}
|
|
747
749
|
}
|
|
748
750
|
|
|
749
751
|
/** Short alias for \`KickRoutes.Api\` — \`createClient<KickApi>(...)\`. */
|
|
@@ -751,18 +753,18 @@ ${x}
|
|
|
751
753
|
}
|
|
752
754
|
|
|
753
755
|
${g}
|
|
754
|
-
`}function
|
|
756
|
+
`}function Yr(e){let t=e.contextKeys;return t==null?`string`:t.length===0?`never`:t.map(e=>JSON.stringify(e)).join(` | `)}function Xr(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 Zr(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 Qr(e,t,n,r,i){if(!e||r===!1||e.source===null)return null;let a=ei(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 $r(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(`
|
|
755
757
|
`)+`
|
|
756
|
-
`}function
|
|
757
|
-
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 '${
|
|
758
|
+
`}function ei(e,t,n){if(e===null)return`unknown`;let r=k(n);if(e===``){let e=j(r,t).split(N).join(`/`);return e=e.replace(/\.(ts|tsx|mts|cts)$/i,``),e.startsWith(`.`)||(e=`./`+e),e}if(!e.startsWith(`.`)&&!e.startsWith(`/`))return e;let i=k(t),a=M(i,e),o=j(r,a).split(N).join(`/`);return o=o.replace(/\.(ts|tsx|mts|cts)$/i,``),o.startsWith(`.`)||(o=`./`+o),o}function ti(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 ni=()=>({id:`kick/routes`,outExtension:`.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){let t=await e.getScanResult({root:ri(e),cwd:e.cwd,envFile:ii(e)}),n=e.config?.typegen?.schemaValidator??`zod`,r=O.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return Jr(t.routes,r,n,{onWarn:t=>e.log.warn(t)})}});function ri(e){return O.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function ii(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}const ai=`@typescript/typescript6`;function oi(e){return typeof e?.createProgram==`function`}function si(e){if(oi(e.typescript))return{api:e.typescript,source:`typescript`};if(oi(e.ts6))return{api:e.ts6,source:ai};let t=`Install it in the project:\n pnpm add -D ${ai}`;throw e.typescript?Error(`kick typegen: the client route map needs a TypeScript compiler API.
|
|
759
|
+
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 '${ai}' resolved from this project.\n ${t}`)}async function ci(e){let t=it(A(e,`package.json`)),n=async e=>{try{return await import(z(t.resolve(e)).href)}catch{return null}},[r,i]=await Promise.all([n(`typescript`),n(ai)]);return si({typescript:li(r),ts6:li(i)}).api}function li(e){let t=e;return t?.default&&typeof t.default==`object`?t.default:e}const ui=Symbol(`kick/client: expansion budget exhausted`);var di=class{ts;checker;program;opts;get printFlags(){return this.ts.TypeFormatFlags.NoTruncation}hoistedByType=new Map;inProgress=new Map;jsonInProgress=new Set;nextName=0;blocks=[];maxDepth;truncations=0;budget;constructor(e,t,n,r={}){this.ts=e,this.checker=t,this.program=n,this.opts=r,this.maxDepth=r.maxDepth??12,this.budget=r.truncationBudget??1e3}hoisted(){return this.blocks}expand(e){this.truncations=0;try{return this.render(e,0)}catch(e){if(e!==ui)throw e;return this.opts.onWarn?.(`expansion abandoned after ${this.budget} truncations — emitting 'unknown'. This usually means a recursive type. Declare a response schema on the route for an exact type.`),`unknown`}}render(e,t){let n=this.ts.TypeFlags;if(t>this.maxDepth){if(++this.truncations>this.budget)throw ui;return this.opts.onWarn?.(`type nesting exceeded ${this.maxDepth} levels — emitting 'unknown'. Declare a response schema on the route for an exact type.`),`unknown`}if(e.flags&(n.String|n.Number|n.Boolean|n.BigInt|n.ESSymbol)||e.flags&(n.Any|n.Unknown|n.Never|n.Void|n.Undefined|n.Null)||e.isLiteral()||e.flags&n.BooleanLiteral)return this.checker.typeToString(e,void 0,this.printFlags);if(e.isUnion()){let n=e.types.filter(e=>!this.isCallable(e));return(n.length>0?n:e.types).map(e=>this.render(e,t+1)).join(` | `)}if(e.isIntersection())return e.types.map(e=>this.render(e,t+1)).join(` & `);if(this.isTuple(e))return this.renderTuple(e,t);let r=this.arrayElement(e);if(r){let e=this.render(r.element,t+1),n=/[|&]/.test(e)?`(${e})[]`:`${e}[]`;return r.readonly?`readonly ${n}`:n}let i=this.toJsonType(e);if(i){if(this.jsonInProgress.has(e))return this.opts.onWarn?.(`'${this.checker.typeToString(e,void 0,this.printFlags)}' has a cyclic toJSON() — emitting 'unknown', since it has no serializable form.`),`unknown`;this.jsonInProgress.add(e);try{return this.render(i,t)}finally{this.jsonInProgress.delete(e)}}return this.isLibType(e)?this.renderLibType(e,t):e.flags&n.Object?this.renderObject(e,t):(this.opts.onWarn?.(`could not expand type '${this.checker.typeToString(e)}' — emitting 'unknown'`),`unknown`)}renderObject(e,t){let n=this.hoistedByType.get(e);if(n)return n;if(this.isNamed(e)){let t=this.allocName();this.hoistedByType.set(e,t);let n=this.blocks.length;return this.blocks.push(``),this.blocks[n]=`interface ${t} {\n${this.members(e,0,` `)}\n}`,t}let r=this.inProgress.get(e);if(r)return r.name??=this.allocName();let i={name:null};this.inProgress.set(e,i);let a;try{a=this.members(e,t,``,`; `)}finally{this.inProgress.delete(e)}if(i.name){this.hoistedByType.set(e,i.name);let t=this.blocks.length;return this.blocks.push(``),this.blocks[t]=`interface ${i.name} {\n${this.members(e,0,` `)}\n}`,i.name}return a.length>0?`{ ${a} }`:`{}`}allocName(){return`__T${this.nextName++}`}members(e,t,n,r=`
|
|
758
760
|
`){let i=[];for(let r of this.checker.getIndexInfosOfType(e)){let e=this.checker.typeToString(r.keyType,void 0,this.printFlags);i.push(`${n}[key: ${e}]: ${this.render(r.type,t+1)}`)}for(let r of this.checker.getPropertiesOfType(e)){let e=this.typeOfProperty(r);if(this.isCallable(e)||r.getName().startsWith(`__@`))continue;let a=(r.flags&this.ts.SymbolFlags.Optional)!==0,o=this.renderPropertyType(e,a,r,t+1),s=this.isReadonlyProp(r)?`readonly `:``;i.push(`${n}${s}${this.propName(r.getName())}${a?`?`:``}: ${o}`)}return i.join(r===`
|
|
759
761
|
`?`
|
|
760
|
-
`:r)}typeOfProperty(e){let t=this.checker;if(typeof t.getTypeOfSymbol==`function`)return t.getTypeOfSymbol(e);let n=e.valueDeclaration??e.declarations?.[0];return n?this.checker.getTypeOfSymbolAtLocation(e,n):this.checker.getDeclaredTypeOfSymbol(e)}renderPropertyType(e,t,n,r){if(!t||!e.isUnion()||this.declaresUndefined(n))return this.render(e,r);let i=e.types.filter(e=>!(e.flags&this.ts.TypeFlags.Undefined));return i.length===0?`undefined`:i.map(e=>this.render(e,r)).join(` | `)}isReadonlyProp(e){let t=e.valueDeclaration??e.declarations?.[0];return t?(this.ts.getCombinedModifierFlags(t)&this.ts.ModifierFlags.Readonly)!==0:!1}declaresUndefined(e){let t=e.valueDeclaration??e.declarations?.[0];if(!t||!(this.ts.isPropertySignature(t)||this.ts.isPropertyDeclaration(t))||!t.type)return!1;let n=this.checker.getTypeFromTypeNode(t.type);return(n.isUnion()?n.types:[n]).some(e=>(e.flags&this.ts.TypeFlags.Undefined)!==0)}renderTuple(e,t){let n=this.ts.ElementFlags,r=this.checker.getTypeArguments(e),i=e.target,a=i.elementFlags??[],o=r.map((e,r)=>{let i=a[r]??n.Required;return i&n.Optional?`${(e.isUnion()?e.types.filter(e=>!(e.flags&this.ts.TypeFlags.Undefined)):[e]).map(e=>this.render(e,t+1)).join(` | `)}?`:i&n.Rest?`...${this.render(e,t+1)}[]`:i&n.Variadic?`...${this.render(e,t+1)}`:this.render(e,t+1)});return`${i.readonly?`readonly `:``}[${o.join(`, `)}]`}propName(e){return/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(e)?e:JSON.stringify(e)}isLibType(e){let t=e.aliasSymbol?.declarations??e.getSymbol()?.declarations;return!t||t.length===0?!1:t.every(e=>this.program.isSourceFileDefaultLibrary(e.getSourceFile()))}renderLibType(e,t){let n=(e.aliasSymbol??e.getSymbol())?.getName(),r=e.aliasTypeArguments??this.typeArguments(e);return!n||r.length===0?this.checker.typeToString(e,void 0,this.printFlags):`${n}<${r.map(e=>this.render(e,t+1)).join(`, `)}>`}typeArguments(e){return!(e.flags&this.ts.TypeFlags.Object)||!(e.objectFlags&this.ts.ObjectFlags.Reference)?[]:this.checker.getTypeArguments(e)}toJsonType(e){if(!(e.flags&this.ts.TypeFlags.Object))return null;let t=this.checker.getPropertyOfType(e,`toJSON`);if(!t)return null;let[n]=this.checker.getSignaturesOfType(this.typeOfProperty(t),this.ts.SignatureKind.Call);if(!n)return null;let r=this.checker.getReturnTypeOfSignature(n);return r===e?null:r}isCallable(e){if(e.isUnion()){let t=e.types.filter(e=>!(e.flags&(this.ts.TypeFlags.Undefined|this.ts.TypeFlags.Null)));return t.length>0&&t.every(e=>this.isCallable(e))}return this.checker.getSignaturesOfType(e,this.ts.SignatureKind.Call).length>0||this.checker.getSignaturesOfType(e,this.ts.SignatureKind.Construct).length>0}isNamed(e){let t=e.getSymbol();if(!t)return!1;let n=t.getName();return n!==`__type`&&n!==`__object`&&n.length>0}isTuple(e){let t=this.ts.ObjectFlags;if(!(e.flags&this.ts.TypeFlags.Object)||!(e.objectFlags&t.Reference))return!1;let n=e.target;return!!(n&&n.objectFlags&t.Tuple)}arrayElement(e){let t=e.getSymbol()?.getName();if(t!==`Array`&&t!==`ReadonlyArray`)return null;let n=this.checker.getTypeArguments(e);return n.length===1?{element:n[0],readonly:t===`ReadonlyArray`}:null}};const
|
|
761
|
-
`));for(let n of
|
|
762
|
-
`);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
|
|
762
|
+
`:r)}typeOfProperty(e){let t=this.checker;if(typeof t.getTypeOfSymbol==`function`)return t.getTypeOfSymbol(e);let n=e.valueDeclaration??e.declarations?.[0];return n?this.checker.getTypeOfSymbolAtLocation(e,n):this.checker.getDeclaredTypeOfSymbol(e)}renderPropertyType(e,t,n,r){if(!t||!e.isUnion()||this.declaresUndefined(n))return this.render(e,r);let i=e.types.filter(e=>!(e.flags&this.ts.TypeFlags.Undefined));return i.length===0?`undefined`:i.map(e=>this.render(e,r)).join(` | `)}isReadonlyProp(e){let t=e.valueDeclaration??e.declarations?.[0];return t?(this.ts.getCombinedModifierFlags(t)&this.ts.ModifierFlags.Readonly)!==0:!1}declaresUndefined(e){let t=e.valueDeclaration??e.declarations?.[0];if(!t||!(this.ts.isPropertySignature(t)||this.ts.isPropertyDeclaration(t))||!t.type)return!1;let n=this.checker.getTypeFromTypeNode(t.type);return(n.isUnion()?n.types:[n]).some(e=>(e.flags&this.ts.TypeFlags.Undefined)!==0)}renderTuple(e,t){let n=this.ts.ElementFlags,r=this.checker.getTypeArguments(e),i=e.target,a=i.elementFlags??[],o=r.map((e,r)=>{let i=a[r]??n.Required;return i&n.Optional?`${(e.isUnion()?e.types.filter(e=>!(e.flags&this.ts.TypeFlags.Undefined)):[e]).map(e=>this.render(e,t+1)).join(` | `)}?`:i&n.Rest?`...${this.render(e,t+1)}[]`:i&n.Variadic?`...${this.render(e,t+1)}`:this.render(e,t+1)});return`${i.readonly?`readonly `:``}[${o.join(`, `)}]`}propName(e){return/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(e)?e:JSON.stringify(e)}isLibType(e){let t=e.aliasSymbol?.declarations??e.getSymbol()?.declarations;return!t||t.length===0?!1:t.every(e=>this.program.isSourceFileDefaultLibrary(e.getSourceFile()))}renderLibType(e,t){let n=(e.aliasSymbol??e.getSymbol())?.getName(),r=e.aliasTypeArguments??this.typeArguments(e);return!n||r.length===0?this.checker.typeToString(e,void 0,this.printFlags):`${n}<${r.map(e=>this.render(e,t+1)).join(`, `)}>`}typeArguments(e){return!(e.flags&this.ts.TypeFlags.Object)||!(e.objectFlags&this.ts.ObjectFlags.Reference)?[]:this.checker.getTypeArguments(e)}toJsonType(e){if(!(e.flags&this.ts.TypeFlags.Object))return null;let t=this.checker.getPropertyOfType(e,`toJSON`);if(!t)return null;let[n]=this.checker.getSignaturesOfType(this.typeOfProperty(t),this.ts.SignatureKind.Call);if(!n)return null;let r=this.checker.getReturnTypeOfSignature(n);return r===e?null:r}isCallable(e){if(e.isUnion()){let t=e.types.filter(e=>!(e.flags&(this.ts.TypeFlags.Undefined|this.ts.TypeFlags.Null)));return t.length>0&&t.every(e=>this.isCallable(e))}return this.checker.getSignaturesOfType(e,this.ts.SignatureKind.Call).length>0||this.checker.getSignaturesOfType(e,this.ts.SignatureKind.Construct).length>0}isNamed(e){let t=e.getSymbol();if(!t)return!1;let n=t.getName();return n!==`__type`&&n!==`__object`&&n.length>0}isTuple(e){let t=this.ts.ObjectFlags;if(!(e.flags&this.ts.TypeFlags.Object)||!(e.objectFlags&t.Reference))return!1;let n=e.target;return!!(n&&n.objectFlags&t.Tuple)}arrayElement(e){let t=e.getSymbol()?.getName();if(t!==`Array`&&t!==`ReadonlyArray`)return null;let n=this.checker.getTypeArguments(e);return n.length===1?{element:n[0],readonly:t===`ReadonlyArray`}:null}};const fi=[`pnpm-lock.yaml`,`package-lock.json`,`yarn.lock`,`bun.lock`,`bun.lockb`],pi=/(?:^|[\\/])(?:node_modules|\.kickjs)(?:[\\/]|$)/;function mi(e){return Ct(`sha1`).update(e).digest(`hex`)}function hi(e){let t=Ct(`sha1`);t.update(e.cliVersion),t.update(JSON.stringify(e.options??{})),t.update(e.keys.join(`
|
|
763
|
+
`));for(let n of fi){let r=A(e.projectDir,n);if(P(r))try{t.update(F(r))}catch(e){throw Error(`kick/client: cannot read lockfile ${r}`,{cause:e})}}for(let n of e.fileNames.toSorted())if(!pi.test(n)){t.update(n);try{t.update(F(n))}catch(e){throw Error(`kick/client: cannot read project file ${n}`,{cause:e})}}return t.digest(`hex`)}async function gi(e){try{let t=await ci(e.compilerFrom??e.projectDir),n={...t.sys,onUnRecoverableConfigFileDiagnostic:()=>{}},r=t.getParsedCommandLineOfConfigFile(A(e.projectDir,`tsconfig.json`),{},n);return r?hi({projectDir:e.projectDir,fileNames:r.fileNames,keys:e.keys,options:{...r.options,__kickMaxDepth:e.maxDepth??null},cliVersion:e.cliVersion}):null}catch{return null}}async function _i(e){let t=await ci(e.compilerFrom??e.projectDir),n=A(k(e.routesFile),`__kick_client_probe__.ts`),r=bi(e.routesFile,e.keys),i=Ci(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.`);vi(t,i,e.routesFile);let s=xi(t,i,o,e.keys),c=null,l=new di(t,a,i,{maxDepth:e.maxDepth,onWarn:t=>e.onWarn?.(c?`route '${c}': ${t}`:t)}),u=new Map;for(let[n,r]of e.keys.entries()){if(s.has(r)){e.onWarn?.(`route '${r}' is not present in KickRoutes.Api — skipped. Re-run \`kick typegen\` so the two maps agree.`);continue}let i=o.statements.find(e=>t.isTypeAliasDeclaration(e)&&e.name.text===yi(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 vi(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(`
|
|
764
|
+
`);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 yi(e){return`_K${e}`}function bi(e,t){let n=`./`+at(e).replace(/\.tsx?$/,``),r=t.map((e,t)=>`type ${yi(t)} = KickRoutes.Api[${JSON.stringify(e)}]`);return[`import ${JSON.stringify(n)}`,...r].join(`
|
|
763
765
|
`)+`
|
|
764
|
-
`}function
|
|
765
|
-
`))}},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:[...
|
|
766
|
+
`}function xi(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(yi(t));r&&e.start>=r.getStart(n)&&e.start<r.getEnd()&&i.add(o)}return i}function Si(e,t){let n=e.filter(e=>/\.d\.(ts|mts|cts)$/.test(e)),r=[];try{r=ct(t).filter(e=>e.endsWith(`.ts`)).map(e=>A(t,e))}catch{}return[...new Set([...n,...r])]}function Ci(e,t,n,r){let i=A(t,`tsconfig.json`),a={...e.sys,onUnRecoverableConfigFileDiagnostic:t=>{throw Error(e.flattenDiagnosticMessageText(t.messageText,`
|
|
767
|
+
`))}},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:[...Si(o.fileNames,k(n)),n],options:o.options,host:s})}const wi=`/* eslint-disable */
|
|
766
768
|
// AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
|
|
767
769
|
//
|
|
768
770
|
// Self-contained: this file has no imports, so a frontend consumes it without
|
|
@@ -776,7 +778,7 @@ ${g}
|
|
|
776
778
|
//
|
|
777
779
|
// Not refreshed by \`kick dev\` — resolving these types builds a full
|
|
778
780
|
// TypeScript program over the server. Re-run \`kick typegen\`.
|
|
779
|
-
`;function
|
|
781
|
+
`;function Ti(e,t){let n=t.filter(t=>e.entries.has(t));if(n.length===0)return`${wi}
|
|
780
782
|
// (no routes discovered yet — annotate a controller method with
|
|
781
783
|
// @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
|
|
782
784
|
interface Api {}
|
|
@@ -793,7 +795,7 @@ export type { Api }
|
|
|
793
795
|
|
|
794
796
|
`)+`
|
|
795
797
|
|
|
796
|
-
`:``,i=n.map(t=>` ${JSON.stringify(t)}: ${e.entries.get(t)}`);return`${
|
|
798
|
+
`:``,i=n.map(t=>` ${JSON.stringify(t)}: ${e.entries.get(t)}`);return`${wi}
|
|
797
799
|
${r}interface Api {
|
|
798
800
|
${i.join(`
|
|
799
801
|
`)}
|
|
@@ -807,7 +809,7 @@ declare global {
|
|
|
807
809
|
}
|
|
808
810
|
|
|
809
811
|
export type { Api }
|
|
810
|
-
`}const
|
|
812
|
+
`}const Ei=`kick/client`,Q=`.kickjs/types/kick__client.d.ts`,Di=`.kickjs/cache/client-map.sha1`,Oi=(()=>{try{return it(import.meta.url)(`../../../package.json`).version??`0.0.0`}catch{return`0.0.0`}})();function ki(e){try{if(!P(e))return null;let[t,n]=F(e,`utf-8`).trim().split(/\s+/);return t&&n?{inputs:t,output:n}:null}catch{return null}}function Ai(e){return`${on}${Ei} */\n\n${e}\n`}function ji(e){try{return P(e)?F(e,`utf-8`):null}catch{return null}}async function Mi(e){let t=O.resolve(e.cwd,Q);if(!P(t))return!1;try{await pt(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 Ni(e){let t=e?.typegen?.client;return typeof t==`object`?t.maxDepth:void 0}function Pi(e){let t=e.config?.typegen?.client;return typeof t==`boolean`?t:t&&typeof t==`object`?t.enabled!==!1:(P(O.resolve(e.cwd,Q))&&e.log.warn(` kick/client: ${Q} exists but typegen.client is not set, so it is NOT being refreshed.\n Add \`typegen: { client: true }\` to kick.config.ts to keep it current, or delete the file if nothing reads it.`),!1)}const Fi=()=>({id:Ei,outExtension:`.d.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){if(!Pi(e))return null;if(e.watch)return e.log.info?.(" kick/client: skipped under watch (builds a full TypeScript program). Run `kick typegen` to refresh the client route map."),null;let t=await e.getScanResult({root:O.resolve(e.cwd,e.config?.typegen?.srcDir??`src`),cwd:e.cwd}),n=[],r=new Set;for(let e of t.routes){let t=`${e.httpMethod} ${e.mountedPath??e.path}`;r.has(t)||(r.add(t),n.push(t))}let i=Ni(e.config),a=await gi({projectDir:e.cwd,keys:n,maxDepth:i,cliVersion:Oi}),o=ki(O.resolve(e.cwd,Di)),s=ji(O.resolve(e.cwd,Q));if(a&&o&&s!==null&&o.inputs===a&&o.output===mi(s))return se()&&e.log.info?.(` kick/client: unchanged, keeping ${Q}`),null;try{let t=Ti(await _i({projectDir:e.cwd,routesFile:O.resolve(e.cwd,`.kickjs/types/kick__routes.ts`),keys:n,maxDepth:i,onWarn:t=>e.log.warn(t)}),n);return a&&!e.check&&await e.writeFile(Di,`${a} ${mi(Ai(t))}`),t}catch(t){let n=P(O.resolve(e.cwd,Q)),r=` kick/client: skipped — ${t instanceof Error?t.message:String(t)}`;return n?e.log.warn(r):se()&&e.log.info?.(r),n&&await Mi(e),null}}});function Ii(e,t,n=`zod`){if(!e)return null;let r=k(t),i=j(r,e.filePath).split(N).join(`/`);return i=i.replace(/\.(ts|tsx|mts|cts)$/i,``),i.startsWith(`.`)||(i=`./`+i),`/* eslint-disable */
|
|
811
813
|
// AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
|
|
812
814
|
// Re-run with \`kick typegen\` or rely on \`kick dev\` to refresh.
|
|
813
815
|
|
|
@@ -845,6 +847,6 @@ declare global {
|
|
|
845
847
|
}
|
|
846
848
|
|
|
847
849
|
export {}
|
|
848
|
-
`}const
|
|
849
|
-
`)}}]})];export{
|
|
850
|
-
//# sourceMappingURL=run-plugins-
|
|
850
|
+
`}const Li=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=zi(e);if(t===!1)return null;let n=await e.getScanResult({root:Ri(e),cwd:e.cwd,envFile:t});if(!n.env)return null;let r=e.config?.typegen?.schemaValidator??`zod`,i=O.resolve(e.cwd,`.kickjs/types/kick__env.ts`);return Ii(n.env,i,r)}});function Ri(e){return O.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function zi(e){return e.config?.typegen?.envFile}function Bi(e){return O.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Vi(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function $(e){return{root:Bi(e),cwd:e.cwd,envFile:Vi(e)}}const Hi=()=>({id:`kick/registry`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e)),n=O.resolve(e.cwd,`.kickjs/types/kick__registry.d.ts`),r=new Set(t.collisions.map(e=>e.className));return Ue(t.classes,n,r)}}),Ui=()=>({id:`kick/services`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e)),n=new Set(t.collisions.map(e=>e.className)),r=qe(t.classes,t.tokens,t.injects,n);return Je(`ServiceToken`,r,"(no tokens discovered — declare with createToken<T>() or `kick g service <name>`)")}}),Wi=()=>({id:`kick/modules`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return Je(`ModuleToken`,Ve(t.classes),"(no @Module classes discovered — `kick g module <name>` to add one)")}}),Gi=()=>({id:`kick/plugins`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return He(t.pluginsAndAdapters)}}),Ki=()=>({id:`kick/context`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return t.contextKeys.length===0?null:et(t.contextKeys)}}),qi=()=>({id:`kick/route-flags`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult($(e));return Xe(t.routeFlags)}}),Ji={fastify:{subpath:`@forinda/kickjs/fastify`,typeName:`FastifyRuntimeTypes`},h3:{subpath:`@forinda/kickjs/h3`,typeName:`H3RuntimeTypes`}},Yi=[E({name:`kick/init`,register:Tt}),E({name:`kick/generate`,register:rn}),E({name:`kick/run`,register:vn}),E({name:`kick/info`,register:Cn}),E({name:`kick/inspect`,register:Mn}),E({name:`kick/add`,register:we}),E({name:`kick/list`,register:Ee}),E({name:`kick/explain`,register:Vn}),E({name:`kick/mcp`,register:Zn}),E({name:`kick/tinker`,register:tr}),E({name:`kick/remove`,register:sr}),E({name:`kick/typegen`,register:ur}),E({name:`kick/check`,register:kr}),E({name:`kick/doctor`,register:ge}),E({name:`kick/codemod`,register:jr}),E({name:`kick/deploy`,register:Gr}),E({name:`kick/registry`,typegens:[Hi()]}),E({name:`kick/services`,typegens:[Ui()]}),E({name:`kick/modules`,typegens:[Wi()]}),E({name:`kick/plugins`,typegens:[Gi()]}),E({name:`kick/context`,typegens:[Ki()]}),E({name:`kick/route-flags`,typegens:[qi()]}),E({name:`kick/assets`,typegens:[Kr()]}),E({name:`kick/routes`,typegens:[ni()]}),E({name:`kick/client`,typegens:[Fi()]}),E({name:`kick/env`,typegens:[Li()]}),E({name:`kick/runtime`,typegens:[{id:`kick/runtime`,outExtension:`.ts`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`,`kick.config.json`],async generate(e){let t=e.config?.runtime;if(t!==`fastify`&&t!==`h3`)return null;let{subpath:n,typeName:r}=Ji[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(`
|
|
851
|
+
`)}}]})];export{ln as applyDisableFilter,un as n,B as r,G as runAllPluginTypegens,Yi as t};
|
|
852
|
+
//# sourceMappingURL=run-plugins-CEomWccT.mjs.map
|