@forinda/kickjs-cli 8.9.0 → 8.10.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-DUB-1Z6Q.mjs → agent-docs-CmPrfpaP.mjs} +8 -3
- package/dist/agent-docs-CmPrfpaP.mjs.map +1 -0
- package/dist/{agent-docs-bVMPt2m5.mjs → agent-docs-CvBsLoE4.mjs} +7 -2
- package/dist/{build-C30mBgw6.mjs → build-Dr7_JT3S.mjs} +3 -3
- package/dist/{build-C30mBgw6.mjs.map → build-Dr7_JT3S.mjs.map} +1 -1
- package/dist/{build-xQXbdDpw.mjs → build-Snjzr08O.mjs} +2 -2
- package/dist/{builtins-DiWfXc-D.mjs → builtins-BTPvizzK.mjs} +126 -117
- package/dist/{builtins-CtpLZ4FY.mjs → builtins-MG6t5uS3.mjs} +2 -2
- package/dist/cli.mjs +2 -2
- package/dist/{config-ZHuFjsKI.mjs → config-B7ZUrOl6.mjs} +3 -3
- package/dist/{config-ZHuFjsKI.mjs.map → config-B7ZUrOl6.mjs.map} +1 -1
- package/dist/{config-YvIngROH.mjs → config-DO4J2xgV.mjs} +2 -2
- package/dist/{doctor-CnsnRW7T.mjs → doctor-C-VSGhJ6.mjs} +4 -4
- package/dist/{doctor-CnsnRW7T.mjs.map → doctor-C-VSGhJ6.mjs.map} +1 -1
- package/dist/{fs-Bm2St4gk.mjs → fs-CT9PRuSw.mjs} +1 -1
- package/dist/{fs-BvGbbHY0.mjs → fs-gRPNbfZO.mjs} +2 -2
- package/dist/{fs-BvGbbHY0.mjs.map → fs-gRPNbfZO.mjs.map} +1 -1
- package/dist/{fullstack-CZ9XQYk-.mjs → fullstack-CTB1yuCK.mjs} +3 -3
- package/dist/{fullstack-B0g06sSQ.mjs → fullstack-bVcLaFbj.mjs} +4 -4
- package/dist/{fullstack-B0g06sSQ.mjs.map → fullstack-bVcLaFbj.mjs.map} +1 -1
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +2 -2
- package/dist/{plugin-BfdvW6_r.mjs → plugin-BpfANLIW.mjs} +2 -2
- package/dist/{plugin-Bs0soxrU.mjs → plugin-E910l1_e.mjs} +2 -2
- package/dist/project-BAmOMd-l.mjs +113 -0
- package/dist/project-D7x753R7.mjs +114 -0
- package/dist/project-D7x753R7.mjs.map +1 -0
- package/dist/{project-root-LYOxQHXp.mjs → project-root-D74lbi2U.mjs} +2 -2
- package/dist/{project-root-B9BrO1na.mjs → project-root-DO7MsZOq.mjs} +3 -3
- package/dist/{project-root-B9BrO1na.mjs.map → project-root-DO7MsZOq.mjs.map} +1 -1
- package/dist/{prompts-BEAqcbPT.mjs → prompts-DKR7UZkc.mjs} +2 -2
- package/dist/{prompts-BEAqcbPT.mjs.map → prompts-DKR7UZkc.mjs.map} +1 -1
- package/dist/{rolldown-runtime-Da-NDvKz.mjs → rolldown-runtime-vT0bVE76.mjs} +1 -1
- package/dist/{run-plugins-0AfIgIsZ.mjs → run-plugins-BXNfws9R.mjs} +43 -34
- package/dist/run-plugins-BXNfws9R.mjs.map +1 -0
- package/dist/{typegen-BzgWveE_.mjs → typegen-B90QMhV8.mjs} +5 -5
- package/dist/{typegen-BzgWveE_.mjs.map → typegen-B90QMhV8.mjs.map} +1 -1
- package/dist/{typegen-up-UkaNc.mjs → typegen-BmyEoY3Z.mjs} +4 -4
- package/dist/{types-ChFFRT8E.mjs → types-C2QNIHnD.mjs} +1 -1
- package/package.json +6 -6
- package/templates/feature-storage/feature.json +13 -0
- package/templates/feature-storage/files/_dot_env.example.append +6 -0
- package/templates/feature-storage/files/_dot_gitignore.append +2 -0
- package/templates/feature-storage/files/src/storage.ts +16 -0
- package/dist/agent-docs-DUB-1Z6Q.mjs.map +0 -1
- package/dist/project-B_qDdkYQ.mjs +0 -113
- package/dist/project-B_qDdkYQ.mjs.map +0 -1
- package/dist/project-Bp-KfBNb.mjs +0 -112
- package/dist/run-plugins-0AfIgIsZ.mjs.map +0 -1
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs-cli v8.
|
|
2
|
+
* @forinda/kickjs-cli v8.10.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-Da-NDvKz.mjs";import{c as t,g as n,i as r,l as i,o as a,r as o,s,t as c}from"./project-Bp-KfBNb.mjs";import{a as l,c as u,i as d,l as f,o as p,r as m,s as h}from"./config-YvIngROH.mjs";import{n as g,r as _}from"./plugin-BfdvW6_r.mjs";import{n as v,r as y,t as b}from"./fs-Bm2St4gk.mjs";import{a as x,c as S,d as ee,f as C,i as te,l as ne,n as re,o as ie,p as ae,r as oe,s as w,u as se}from"./agent-docs-bVMPt2m5.mjs";import{t as T}from"./project-root-LYOxQHXp.mjs";import{C as ce,S as le,_ as ue,a as de,b as fe,c as pe,d as me,f as he,g as ge,h as _e,i as ve,l as ye,m as be,o as xe,p as Se,r as Ce,s as we,t as Te,u as Ee,v as De,w as Oe,x as E,y as ke}from"./typegen-up-UkaNc.mjs";import{t as Ae}from"./build-xQXbdDpw.mjs";import{createRequire as je}from"node:module";import{cpSync as Me,existsSync as D,mkdirSync as Ne,readFileSync as O,readdirSync as k,rmSync as Pe,statSync as Fe,writeFileSync as A}from"node:fs";import j,{basename as Ie,dirname as M,join as N,relative as P,resolve as F,sep as I}from"node:path";import{fileURLToPath as Le,pathToFileURL as L}from"node:url";import{fork as Re,spawn as ze,spawnSync as Be}from"node:child_process";import{copyFile as Ve,mkdir as He,readFile as R,readdir as Ue,rm as We,stat as Ge,writeFile as z}from"node:fs/promises";import"@forinda/kickjs-cli-kit";import{createHash as Ke}from"node:crypto";import{parseSync as qe}from"oxc-parser";import Je from"pluralize";import{arch as Ye,platform as Xe,release as Ze}from"node:os";const Qe=[{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 $e(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 | inertia`).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)=>{te(`KickJS — Create a new project`);let n=!!(t.yes||t.nonInteractive);e||=n?`my-api`:await se({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let r;if(e===`.`?(r=F(`.`),e=Ie(r)):r=F(t.directory||e),D(r)){let i=k(r);if(i.length>0){if(t.force)x.warn(`Clearing existing files in ${r}`);else if(n){x.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),w(`Aborted.`);return}else{x.warn(`Directory "${e}" is not empty:`);let t=i.slice(0,5);for(let e of t)x.message(` - ${e}`);if(i.length>5&&x.message(` ... and ${i.length-5} more`),!await oe({message:C.red(`Remove all existing files and proceed?`),initialValue:!1})){w(`Aborted.`);return}}for(let e of i)Pe(F(r,e),{recursive:!0,force:!0})}}let a=t.template;a||=n?`minimal`:await S({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`},{value:`inertia`,label:`Inertia`,hint:`server-driven React pages, one app, SSR`}]});let o=t.runtime;o||=n?`express`:await S({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 s=t.pm;s||=n?await i(void 0):await S({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let l=t.repo;l||=n?`inmemory`:await se({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),f(l);let u=t.schema;a===`inertia`&&(u&&u!==`zod`&&x.warn(`The inertia template uses zod — ignoring --schema ${u}.`),u=`zod`),u||=n?`zod`:await S({message:`Schema library (env + DTO validation)`,options:[{value:`zod`,label:`Zod`,hint:`default — broad ecosystem`},{value:`valibot`,label:`Valibot`,hint:`smaller bundle`},{value:`yup`,label:`Yup`,hint:`classic API`}]}),[`zod`,`valibot`,`yup`].includes(u)||(x.warn(`Unknown --schema "${u}", falling back to zod.`),u=`zod`);let d;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();d=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else d=n?[]:await ie({message:`Select packages to include`,options:[...Qe],required:!1});let p;p=t.git===void 0?n?!0:await oe({message:`Initialize git repository?`,initialValue:!0}):t.git;let m;if(m=t.install===void 0?n?!0:await oe({message:`Install dependencies?`,initialValue:!0}):t.install,t.frontend!==void 0&&t.frontend!==`kick`&&t.frontend!==`vite`){x.error(`Unknown --frontend '${String(t.frontend)}'. Use 'kick' (wired React app) or 'vite' (create-vite).`),w(`Aborted.`);return}let{VITE_TEMPLATES:h,DEFAULT_VITE_TEMPLATE:g}=await import(`./fullstack-CZ9XQYk-.mjs`);if(t.viteTemplate!==void 0&&!h.some(e=>e.value===t.viteTemplate)){x.error(`Unknown --vite-template '${String(t.viteTemplate)}'. TypeScript templates only: ${h.map(e=>e.value).join(`, `)}.`),w(`Aborted.`);return}let _=t.frontend===`vite`?`vite`:`kick`,v=t.viteTemplate??g;if(a===`fullstack`&&!t.frontend&&!n&&(_=await S({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)`}]})),_===`vite`&&!t.viteTemplate&&!n&&(v=await S({message:`create-vite template`,options:h.map(e=>({value:e.value,label:e.label})),initialValue:g})),a===`fullstack`){let{initFullstackProject:t}=await import(`./fullstack-CZ9XQYk-.mjs`);await t({name:e,directory:r,packageManager:s,initGit:p,installDeps:m,schemaLib:u,runtime:o,packages:d,frontend:_,viteTemplate:v}),w(`Done! Next steps: ${C.cyan(`cd ${e} && ${s}${s===`pnpm`?` dev`:` run dev:server`}`)}`)}else await c({name:e,directory:r,packageManager:s,initGit:p,installDeps:m,template:a,defaultRepo:l,packages:d,schemaLib:u,runtime:o}),w(`Done! Next steps: ${C.cyan(`cd ${e} && ${s} dev`)}`)})}function B(e){return e.replace(/[-_\s]+(.)?/g,(e,t)=>t?t.toUpperCase():``).replace(/^(.)/,e=>e.toUpperCase())}function V(e){let t=B(e);return t.charAt(0).toLowerCase()+t.slice(1)}function H(e){return e.replace(/([a-z])([A-Z])/g,`$1-$2`).replace(/[\s_]+/g,`-`).toLowerCase()}function U(e){return Je.plural(e)}function et(e){return Je.plural(e)}function tt(e){return H(e).replace(/-/g,`_`)}function nt(e){let t=e.cwd??process.cwd(),n=e.projectRoot??T(t),r=e.pluralize??!0,i=B(e.name),a=V(e.name),o=H(e.name),s=tt(e.name),c={name:e.name,pascal:i,camel:a,kebab:o,snake:s,modulesDir:e.modulesDir??`src/modules`,cwd:t,projectRoot:n,args:e.args??[],flags:e.flags??{}};if(r){let e=U(o);c.pluralKebab=e,c.pluralPascal=B(e),c.pluralCamel=V(e)}return c}function rt(e,t){return F(e.cwd,t)}async function it(e){return import(L(e).href)}const at=/* @__PURE__ */ new Map;async function ot(e){let t=at.get(e);if(t)return t;let n=st(e);return at.set(e,n),n}async function st(e){let t=F(e,`package.json`);if(!D(t))return{generators:[],loaded:[],failed:[]};let n=ct(JSON.parse(await R(t,`utf-8`))),r=je(F(e,`package.json`)),i=[],a=[],o=[];for(let e of n){let t;try{t=r.resolve(`${e}/package.json`)}catch{continue}let n;try{n=JSON.parse(await R(t,`utf-8`))}catch(t){o.push({source:e,reason:`failed to parse package.json: ${t}`});continue}if(!n.kickjs?.generators)continue;let s=n.kickjs.generators,c=F(M(t),s);if(!D(c)){o.push({source:e,reason:`kickjs.generators points to missing file: ${s}`});continue}let l;try{l=await it(c)}catch(t){o.push({source:e,reason:`failed to import manifest: ${t}`});continue}let u=l.default;if(!Array.isArray(u))o.push({source:e,reason:`manifest's default export is not an array of GeneratorSpec`});else{for(let t of u)lt(t)?i.push({source:e,spec:t}):o.push({source:e,reason:`manifest entry is not a valid GeneratorSpec (missing name/files)`});a.push(e)}}return{generators:i,loaded:a,failed:o}}function ct(e){let t=/* @__PURE__ */ new Set;for(let n of[e.dependencies,e.devDependencies,e.peerDependencies])if(n)for(let e of Object.keys(n))t.add(e);return Array.from(t)}function lt(e){if(!e||typeof e!=`object`)return!1;let t=e;return typeof t.name==`string`&&typeof t.files==`function`}async function ut(e,t=[]){let n=e.cwd??process.cwd(),r=t.find(t=>t.spec.name===e.generatorName);if(r)return pt(r.spec,r.source,e,n);let i=ft(await ot(n),e.generatorName);return i?pt(i.spec,i.source,e,n):null}async function dt(e,t=[]){let n=await ot(e),r=new Set(t.map(e=>e.spec.name)),i=n.generators.filter(e=>!r.has(e.spec.name));return{generators:[...t,...i],loaded:n.loaded,failed:n.failed}}function ft(e,t){return e.generators.find(e=>e.spec.name===t)}async function pt(e,t,n,r){let i=nt({name:n.itemName,args:n.args,flags:n.flags,modulesDir:n.modulesDir,pluralize:n.pluralize,cwd:r,projectRoot:n.projectRoot}),a=await e.files(i),o=[];for(let e of a){let t=rt(i,e.path);await y(t,e.content),o.push(t)}return{files:o,source:t}}function W(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}const mt={inmemory:`in-memory`,drizzle:`Drizzle`,prisma:`Prisma`};function ht(e){return e.charAt(0).toUpperCase()+e.slice(1).replace(/-([a-z])/g,(e,t)=>t.toUpperCase())}function gt(e){return mt[e]??ht(e)}function _t(e){return`create${e}Repository`}function vt(e){return e??`define`}function yt(e){let{pascal:t,kebab:n,plural:r=``,repo:i,style:a}=e,o=_t(t),s=vt(a),c=`/**
|
|
11
|
+
import{t as e}from"./rolldown-runtime-vT0bVE76.mjs";import{c as t,g as n,i as r,l as i,o as a,r as o,s,t as c}from"./project-BAmOMd-l.mjs";import{a as l,c as u,i as d,l as f,o as p,r as m,s as h}from"./config-DO4J2xgV.mjs";import{n as g,r as _}from"./plugin-BpfANLIW.mjs";import{n as v,r as y,t as b}from"./fs-CT9PRuSw.mjs";import{a as x,c as S,d as ee,f as C,i as te,l as ne,n as re,o as ie,p as ae,r as w,s as T,u as oe}from"./agent-docs-CvBsLoE4.mjs";import{t as E}from"./project-root-D74lbi2U.mjs";import{C as se,S as ce,_ as le,a as ue,b as de,c as fe,d as pe,f as me,g as he,h as ge,i as _e,l as ve,m as ye,o as be,p as xe,r as Se,s as Ce,t as we,u as Te,v as Ee,w as De,x as D,y as Oe}from"./typegen-BmyEoY3Z.mjs";import{t as ke}from"./build-Snjzr08O.mjs";import{createRequire as Ae}from"node:module";import{cpSync as je,existsSync as O,mkdirSync as Me,readFileSync as k,readdirSync as A,rmSync as Ne,statSync as Pe,writeFileSync as j}from"node:fs";import M,{basename as Fe,dirname as N,join as P,relative as F,resolve as I,sep as L}from"node:path";import{fileURLToPath as Ie,pathToFileURL as R}from"node:url";import{fork as Le,spawn as Re,spawnSync as ze}from"node:child_process";import{copyFile as Be,mkdir as Ve,readFile as z,readdir as He,rm as Ue,stat as We,writeFile as B}from"node:fs/promises";import"@forinda/kickjs-cli-kit";import{createHash as Ge}from"node:crypto";import{parseSync as Ke}from"oxc-parser";import qe from"pluralize";import{arch as Je,platform as Ye,release as Xe}from"node:os";const Ze=[{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`},{value:`storage`,label:`Storage`,hint:`disk, S3 / R2 / MinIO`}];function Qe(e){e.command(`new [name]`).alias(`init`).description(`Create a new KickJS project (use "." for current directory)`).option(`-d, --directory <dir>`,`Target directory (defaults to project name)`).option(`--pm <manager>`,`Package manager: pnpm | npm | yarn | bun`).option(`--git`,`Initialize git repository`).option(`--no-git`,`Skip git initialization`).option(`--install`,`Install dependencies after scaffolding`).option(`--no-install`,`Skip dependency installation`).option(`-f, --force`,`Remove existing files without prompting`).option(`-t, --template <type>`,`Project template: rest | minimal | fullstack | inertia`).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)=>{te(`KickJS — Create a new project`);let n=!!(t.yes||t.nonInteractive);e||=n?`my-api`:await oe({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let r;if(e===`.`?(r=I(`.`),e=Fe(r)):r=I(t.directory||e),O(r)){let i=A(r);if(i.length>0){if(t.force)x.warn(`Clearing existing files in ${r}`);else if(n){x.warn(`Directory "${e}" is not empty. Pass --force to clear it.`),T(`Aborted.`);return}else{x.warn(`Directory "${e}" is not empty:`);let t=i.slice(0,5);for(let e of t)x.message(` - ${e}`);if(i.length>5&&x.message(` ... and ${i.length-5} more`),!await w({message:C.red(`Remove all existing files and proceed?`),initialValue:!1})){T(`Aborted.`);return}}for(let e of i)Ne(I(r,e),{recursive:!0,force:!0})}}let a=t.template;a||=n?`minimal`:await S({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`},{value:`inertia`,label:`Inertia`,hint:`server-driven React pages, one app, SSR`}]});let o=t.runtime;o||=n?`express`:await S({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 s=t.pm;s||=n?await i(void 0):await S({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let l=t.repo;l||=n?`inmemory`:await oe({message:`Repository name`,placeholder:`inmemory (or a DB name, e.g. postgres)`,defaultValue:`inmemory`}),f(l);let u=t.schema;a===`inertia`&&(u&&u!==`zod`&&x.warn(`The inertia template uses zod — ignoring --schema ${u}.`),u=`zod`),u||=n?`zod`:await S({message:`Schema library (env + DTO validation)`,options:[{value:`zod`,label:`Zod`,hint:`default — broad ecosystem`},{value:`valibot`,label:`Valibot`,hint:`smaller bundle`},{value:`yup`,label:`Yup`,hint:`classic API`}]}),[`zod`,`valibot`,`yup`].includes(u)||(x.warn(`Unknown --schema "${u}", falling back to zod.`),u=`zod`);let d;if(t.packages!==void 0){let e=t.packages.trim().toLowerCase();d=e===``||e===`none`||e===`false`?[]:t.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else d=n?[]:await ie({message:`Select packages to include`,options:[...Ze],required:!1});let p;p=t.git===void 0?n?!0:await w({message:`Initialize git repository?`,initialValue:!0}):t.git;let m;if(m=t.install===void 0?n?!0:await w({message:`Install dependencies?`,initialValue:!0}):t.install,t.frontend!==void 0&&t.frontend!==`kick`&&t.frontend!==`vite`){x.error(`Unknown --frontend '${String(t.frontend)}'. Use 'kick' (wired React app) or 'vite' (create-vite).`),T(`Aborted.`);return}let{VITE_TEMPLATES:h,DEFAULT_VITE_TEMPLATE:g}=await import(`./fullstack-CTB1yuCK.mjs`);if(t.viteTemplate!==void 0&&!h.some(e=>e.value===t.viteTemplate)){x.error(`Unknown --vite-template '${String(t.viteTemplate)}'. TypeScript templates only: ${h.map(e=>e.value).join(`, `)}.`),T(`Aborted.`);return}let _=t.frontend===`vite`?`vite`:`kick`,v=t.viteTemplate??g;if(a===`fullstack`&&!t.frontend&&!n&&(_=await S({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)`}]})),_===`vite`&&!t.viteTemplate&&!n&&(v=await S({message:`create-vite template`,options:h.map(e=>({value:e.value,label:e.label})),initialValue:g})),a===`fullstack`){let{initFullstackProject:t}=await import(`./fullstack-CTB1yuCK.mjs`);await t({name:e,directory:r,packageManager:s,initGit:p,installDeps:m,schemaLib:u,runtime:o,packages:d,frontend:_,viteTemplate:v}),T(`Done! Next steps: ${C.cyan(`cd ${e} && ${s}${s===`pnpm`?` dev`:` run dev:server`}`)}`)}else await c({name:e,directory:r,packageManager:s,initGit:p,installDeps:m,template:a,defaultRepo:l,packages:d,schemaLib:u,runtime:o}),T(`Done! Next steps: ${C.cyan(`cd ${e} && ${s} dev`)}`)})}function V(e){return e.replace(/[-_\s]+(.)?/g,(e,t)=>t?t.toUpperCase():``).replace(/^(.)/,e=>e.toUpperCase())}function H(e){let t=V(e);return t.charAt(0).toLowerCase()+t.slice(1)}function U(e){return e.replace(/([a-z])([A-Z])/g,`$1-$2`).replace(/[\s_]+/g,`-`).toLowerCase()}function W(e){return qe.plural(e)}function $e(e){return qe.plural(e)}function et(e){return U(e).replace(/-/g,`_`)}function tt(e){let t=e.cwd??process.cwd(),n=e.projectRoot??E(t),r=e.pluralize??!0,i=V(e.name),a=H(e.name),o=U(e.name),s=et(e.name),c={name:e.name,pascal:i,camel:a,kebab:o,snake:s,modulesDir:e.modulesDir??`src/modules`,cwd:t,projectRoot:n,args:e.args??[],flags:e.flags??{}};if(r){let e=W(o);c.pluralKebab=e,c.pluralPascal=V(e),c.pluralCamel=H(e)}return c}function nt(e,t){return I(e.cwd,t)}async function rt(e){return import(R(e).href)}const it=/* @__PURE__ */ new Map;async function at(e){let t=it.get(e);if(t)return t;let n=ot(e);return it.set(e,n),n}async function ot(e){let t=I(e,`package.json`);if(!O(t))return{generators:[],loaded:[],failed:[]};let n=st(JSON.parse(await z(t,`utf-8`))),r=Ae(I(e,`package.json`)),i=[],a=[],o=[];for(let e of n){let t;try{t=r.resolve(`${e}/package.json`)}catch{continue}let n;try{n=JSON.parse(await z(t,`utf-8`))}catch(t){o.push({source:e,reason:`failed to parse package.json: ${t}`});continue}if(!n.kickjs?.generators)continue;let s=n.kickjs.generators,c=I(N(t),s);if(!O(c)){o.push({source:e,reason:`kickjs.generators points to missing file: ${s}`});continue}let l;try{l=await rt(c)}catch(t){o.push({source:e,reason:`failed to import manifest: ${t}`});continue}let u=l.default;if(!Array.isArray(u))o.push({source:e,reason:`manifest's default export is not an array of GeneratorSpec`});else{for(let t of u)ct(t)?i.push({source:e,spec:t}):o.push({source:e,reason:`manifest entry is not a valid GeneratorSpec (missing name/files)`});a.push(e)}}return{generators:i,loaded:a,failed:o}}function st(e){let t=/* @__PURE__ */ new Set;for(let n of[e.dependencies,e.devDependencies,e.peerDependencies])if(n)for(let e of Object.keys(n))t.add(e);return Array.from(t)}function ct(e){if(!e||typeof e!=`object`)return!1;let t=e;return typeof t.name==`string`&&typeof t.files==`function`}async function lt(e,t=[]){let n=e.cwd??process.cwd(),r=t.find(t=>t.spec.name===e.generatorName);if(r)return ft(r.spec,r.source,e,n);let i=dt(await at(n),e.generatorName);return i?ft(i.spec,i.source,e,n):null}async function ut(e,t=[]){let n=await at(e),r=new Set(t.map(e=>e.spec.name)),i=n.generators.filter(e=>!r.has(e.spec.name));return{generators:[...t,...i],loaded:n.loaded,failed:n.failed}}function dt(e,t){return e.generators.find(e=>e.spec.name===t)}async function ft(e,t,n,r){let i=tt({name:n.itemName,args:n.args,flags:n.flags,modulesDir:n.modulesDir,pluralize:n.pluralize,cwd:r,projectRoot:n.projectRoot}),a=await e.files(i),o=[];for(let e of a){let t=nt(i,e.path);await y(t,e.content),o.push(t)}return{files:o,source:t}}function G(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}const pt={inmemory:`in-memory`,drizzle:`Drizzle`,prisma:`Prisma`};function mt(e){return e.charAt(0).toUpperCase()+e.slice(1).replace(/-([a-z])/g,(e,t)=>t.toUpperCase())}function ht(e){return pt[e]??mt(e)}function gt(e){return`create${e}Repository`}function _t(e){return e??`define`}function vt(e){let{pascal:t,kebab:n,plural:r=``,repo:i,style:a}=e,o=gt(t),s=_t(a),c=`/**
|
|
12
12
|
* ${t} Module
|
|
13
13
|
*
|
|
14
14
|
* REST module with a flat folder structure.
|
|
@@ -21,7 +21,7 @@ import{t as e}from"./rolldown-runtime-Da-NDvKz.mjs";import{c as t,g as n,i as r,
|
|
|
21
21
|
* dtos/ — Request/response schemas
|
|
22
22
|
*
|
|
23
23
|
* The repository is backed by an in-memory Map so this module works as
|
|
24
|
-
* generated. Swap in ${i===`inmemory`?`a database`:
|
|
24
|
+
* generated. Swap in ${i===`inmemory`?`a database`:ht(i)} by replacing the factory body in
|
|
25
25
|
* ${n}.repository.ts — the contract is whatever that factory returns, so
|
|
26
26
|
* nothing else has to change.
|
|
27
27
|
*/`,l=`import { ${t.toUpperCase()}_REPOSITORY, ${o} } from './${n}.repository'
|
|
@@ -86,7 +86,7 @@ ${u}
|
|
|
86
86
|
},
|
|
87
87
|
}),
|
|
88
88
|
})
|
|
89
|
-
`}function
|
|
89
|
+
`}function yt(e){let{pascal:t,kebab:n,plural:r=``,style:i}=e,a=_t(i),o=` /**
|
|
90
90
|
* Declare HTTP routes. Return value shape:
|
|
91
91
|
*
|
|
92
92
|
* - \`path\` — URL prefix for this route set.
|
|
@@ -126,7 +126,7 @@ ${o}
|
|
|
126
126
|
},
|
|
127
127
|
}),
|
|
128
128
|
})
|
|
129
|
-
`}function
|
|
129
|
+
`}function bt(e){let{pascal:t,kebab:n}=e,r=e.swagger?`import { ApiTags } from '@forinda/kickjs-swagger'
|
|
130
130
|
`:``,i=e.swagger?` @ApiTags('${e.pascal}')\n`:``,a=t.charAt(0).toLowerCase()+t.slice(1);return`import {
|
|
131
131
|
Controller,
|
|
132
132
|
Get,
|
|
@@ -198,10 +198,10 @@ ${i} async remove(ctx: Ctx<KickRoutes.${t}Controller['remove']>) {
|
|
|
198
198
|
return reply.noContent()
|
|
199
199
|
}
|
|
200
200
|
}
|
|
201
|
-
`}const
|
|
201
|
+
`}const xt={zod:{import:`import { z } from 'zod'`,required:`z.string().min(1, { error: 'Name is required' }).max(200)`,optional:`z.string().min(1).max(200).optional()`,infer:e=>`z.infer<typeof ${e}>`,hint:[` * z.string(), z.number(), z.boolean(), z.enum([...]),`,` * z.array(), z.object(), .optional(), .default(), .transform()`].join(`
|
|
202
202
|
`)},valibot:{import:`import * as v from 'valibot'`,required:`v.pipe(v.string(), v.minLength(1, 'Name is required'), v.maxLength(200))`,optional:`v.optional(v.pipe(v.string(), v.minLength(1), v.maxLength(200)))`,infer:e=>`v.InferOutput<typeof ${e}>`,hint:[` * v.string(), v.number(), v.boolean(), v.picklist([...]),`,` * v.array(), v.object(), v.optional(), and v.pipe(...) to chain checks`].join(`
|
|
203
203
|
`)},yup:{import:`import * as yup from 'yup'`,required:`yup.string().required('Name is required').min(1).max(200)`,optional:`yup.string().min(1).max(200).optional()`,infer:e=>`yup.InferType<typeof ${e}>`,hint:[` * yup.string(), yup.number(), yup.boolean(), .oneOf([...]),`,` * yup.array(), yup.object(), .required(), .optional(), .default()`].join(`
|
|
204
|
-
`)}};function
|
|
204
|
+
`)}};function St(e,t){return`${e===`zod`?`z.object`:e===`valibot`?`v.object`:`yup.object`}({\n ${t},\n})`}function Ct(e){let{pascal:t}=e,n=e.schemaLib??`zod`,r=xt[n],i=`create${t}Schema`,a=n===`zod`?`Zod`:n===`valibot`?`Valibot`:`Yup`;return`${r.import}
|
|
205
205
|
|
|
206
206
|
/**
|
|
207
207
|
* Create ${t} DTO — ${a} schema for validating POST request bodies.
|
|
@@ -211,21 +211,21 @@ ${i} async remove(ctx: Ctx<KickRoutes.${t}Controller['remove']>) {
|
|
|
211
211
|
* Add more fields as needed. Supported ${a} types:
|
|
212
212
|
${r.hint}
|
|
213
213
|
*/
|
|
214
|
-
export const ${i} = ${
|
|
214
|
+
export const ${i} = ${St(n,`name: ${r.required}`)}
|
|
215
215
|
|
|
216
216
|
export type Create${t}DTO = ${r.infer(i)}
|
|
217
|
-
`}function
|
|
217
|
+
`}function wt(e){let{pascal:t}=e,n=e.schemaLib??`zod`,r=xt[n],i=`update${t}Schema`;return`${r.import}
|
|
218
218
|
|
|
219
|
-
export const ${i} = ${
|
|
219
|
+
export const ${i} = ${St(n,`name: ${r.optional}`)}
|
|
220
220
|
|
|
221
221
|
export type Update${t}DTO = ${r.infer(i)}
|
|
222
|
-
`}function
|
|
222
|
+
`}function Tt(e){let{pascal:t}=e;return`export interface ${t}ResponseDTO {
|
|
223
223
|
id: string
|
|
224
224
|
name: string
|
|
225
225
|
createdAt: string
|
|
226
226
|
updatedAt: string
|
|
227
227
|
}
|
|
228
|
-
`}function
|
|
228
|
+
`}function Et(e){let{pascal:t,kebab:n,repoType:r,dtoPrefix:i=`./dtos`,tokenScope:a=`app`}=e,o=r&&r!==`inmemory`?r:``,s=`create${t}Repository`,c=` const store = new Map<string, ${t}ResponseDTO>()
|
|
229
229
|
|
|
230
230
|
return {
|
|
231
231
|
async findById(id: string): Promise<${t}ResponseDTO | null> {
|
|
@@ -300,7 +300,7 @@ export type ${t}Repository = ReturnType<typeof ${s}>
|
|
|
300
300
|
* adopters must NOT use the reserved \`'kick/'\` namespace.
|
|
301
301
|
*/
|
|
302
302
|
export const ${t.toUpperCase()}_REPOSITORY = createToken<${t}Repository>('${a}/${t}/repository')
|
|
303
|
-
`}function
|
|
303
|
+
`}function Dt(e){let{pascal:t,kebab:n,plural:r=``,style:i=`define`,testHarness:a=!1}=e,o=i===`define`?`${t}Module()`:`${t}Module`;return`${a?`import { describe, it, expect, beforeEach } from 'vitest'
|
|
304
304
|
import request from 'supertest'
|
|
305
305
|
import { Container } from '@forinda/kickjs'
|
|
306
306
|
import { createTestApp } from '@forinda/kickjs-testing'
|
|
@@ -394,7 +394,7 @@ ${a?` /**
|
|
|
394
394
|
it.todo('deletes a ${n}')
|
|
395
395
|
})
|
|
396
396
|
})
|
|
397
|
-
`}function
|
|
397
|
+
`}function Ot(e){let{pascal:t,kebab:n,plural:r=``,repoPrefix:i=`../${n}.repository`}=e,a=`create${t}Repository`;return`import { describe, it, expect, beforeEach } from 'vitest'
|
|
398
398
|
import { ${a}, type ${t}Repository } from '${i}'
|
|
399
399
|
|
|
400
400
|
describe('${t} repository', () => {
|
|
@@ -456,7 +456,7 @@ describe('${t} repository', () => {
|
|
|
456
456
|
expect(found).toBeNull()
|
|
457
457
|
})
|
|
458
458
|
})
|
|
459
|
-
`}function
|
|
459
|
+
`}function kt(e){let{pascal:t,kebab:n}=e;return`import { Service, Inject, HttpException } from '@forinda/kickjs'
|
|
460
460
|
import type { ParsedQuery } from '@forinda/kickjs'
|
|
461
461
|
import { ${t.toUpperCase()}_REPOSITORY, type ${t}Repository } from './${n}.repository'
|
|
462
462
|
import type { ${t}ResponseDTO } from './dtos/${n}-response.dto'
|
|
@@ -493,14 +493,14 @@ export class ${t}Service {
|
|
|
493
493
|
await this.repo.delete(id)
|
|
494
494
|
}
|
|
495
495
|
}
|
|
496
|
-
`}function
|
|
496
|
+
`}function At(e){let{pascal:t}=e;return`import type { QueryFieldConfig } from '@forinda/kickjs'
|
|
497
497
|
|
|
498
498
|
export const ${t.toUpperCase()}_QUERY_CONFIG: QueryFieldConfig = {
|
|
499
499
|
filterable: ['name'],
|
|
500
500
|
sortable: ['name', 'createdAt'],
|
|
501
501
|
searchable: ['name'],
|
|
502
502
|
}
|
|
503
|
-
`}async function
|
|
503
|
+
`}async function jt(e){let{pascal:t,kebab:n,plural:r,style:i,write:a}=e;await a(`${n}.module.ts`,yt({pascal:t,kebab:n,plural:r,style:i})),await a(`${n}.controller.ts`,`import { Controller, Get, Post, Put, Delete, reply, type Ctx } from '@forinda/kickjs'
|
|
504
504
|
|
|
505
505
|
// \`Ctx<KickRoutes.${t}Controller['<method>']>\` is generated by
|
|
506
506
|
// \`kick typegen\` (auto-run on \`kick dev\`).
|
|
@@ -540,7 +540,7 @@ export class ${t}Controller {
|
|
|
540
540
|
return reply.noContent()
|
|
541
541
|
}
|
|
542
542
|
}
|
|
543
|
-
`)}async function
|
|
543
|
+
`)}async function Mt(e){let{pascal:t,kebab:n,plural:r,pluralPascal:i,repo:a,noTests:o,tokenScope:s,style:c,testHarness:l,write:u}=e,d=e.swagger??!1,f=e.schemaLib??`zod`;await u(`${n}.module.ts`,vt({pascal:t,kebab:n,plural:r,repo:a,style:c})),await u(`${n}.constants.ts`,At({pascal:t,kebab:n})),await u(`${n}.controller.ts`,bt({pascal:t,kebab:n,plural:r,pluralPascal:i,swagger:d})),await u(`${n}.service.ts`,kt({pascal:t,kebab:n})),await u(`dtos/create-${n}.dto.ts`,Ct({pascal:t,kebab:n,schemaLib:f})),await u(`dtos/update-${n}.dto.ts`,wt({pascal:t,kebab:n,schemaLib:f})),await u(`dtos/${n}-response.dto.ts`,Tt({pascal:t,kebab:n})),await u(`${n}.repository.ts`,Et({pascal:t,kebab:n,repoType:a,dtoPrefix:`./dtos`,tokenScope:s})),o||(await u(`__tests__/${n}.controller.test.ts`,Dt({pascal:t,kebab:n,plural:r,style:c,testHarness:l})),await u(`__tests__/${n}.repository.test.ts`,Ot({pascal:t,kebab:n,plural:r,repoPrefix:`../${n}.repository`})))}function Nt(e){return e?typeof e==`string`?e:e.name:`inmemory`}async function Pt(e){let{name:t,modulesDir:n,noEntity:r,noTests:i,repo:a=`inmemory`,force:o,dryRun:s}=e,c=e.pluralize!==!1,l=e.pattern??`rest`;e.minimal&&(l=`minimal`);let u=U(t),d=V(t),f=c?W(u):u,p=c?$e(d):d,m=P(n,f),h=[],g=o??!1,_={kebab:u,pascal:d,plural:f,pluralPascal:p,moduleDir:m,repo:a,noEntity:r??!1,noTests:i??!1,tokenScope:e.tokenScope??`app`,swagger:e.swagger??!1,schemaLib:e.schemaLib??`zod`,testHarness:e.testHarness??!1,style:e.style??`define`,write:async(e,t)=>{let n=P(m,e);s?h.push(n):!g&&await b(n)&&!await w({message:`File exists: ${C.dim(e)}. Overwrite?`,initialValue:!1})?x.warn(`Skipped: ${e}`):(await y(n,t),h.push(n))},files:h};switch(l){case`minimal`:await jt(_);break;default:await Mt(_)}return s||await Ft(n,d,f,u,_.style),h}async function Ft(e,t,n,r,i=`define`){let a=P(e,`index.ts`),o=await b(a),s=`./${n}/${r}.module`,c=i===`class`?`${t}Module`:`${t}Module()`;if(!o){let e=i===`class`?`import type { AppModuleEntry } from '@forinda/kickjs'
|
|
544
544
|
import { ${t}Module } from '${s}'
|
|
545
545
|
|
|
546
546
|
export const modules: AppModuleEntry[] = [${c}]
|
|
@@ -548,11 +548,11 @@ export const modules: AppModuleEntry[] = [${c}]
|
|
|
548
548
|
import { ${t}Module } from '${s}'
|
|
549
549
|
|
|
550
550
|
export const modules = defineModules().mount(${c})
|
|
551
|
-
`;await y(a,e);return}let l=await
|
|
551
|
+
`;await y(a,e);return}let l=await z(a,`utf-8`),u=`import { ${t}Module } from '${s}'`,d=G(s);if(!RegExp(`^import\\s*\\{[^}]*\\b${G(t)}Module\\b[^}]*\\}\\s*from\\s*['"]${d}['"]`,`m`).test(l)){let e=l.lastIndexOf(`import `);if(e!==-1){let t=l.indexOf(`
|
|
552
552
|
`,e);l=l.slice(0,t+1)+u+`
|
|
553
553
|
`+l.slice(t+1)}else l=u+`
|
|
554
|
-
`+l}let f=
|
|
555
|
-
`;)t++;return t}if(n===`/*`){for(t+=2;t+1<e.length&&(e[t]!==`*`||e[t+1]!==`/`);)t++;return t+2}return t}function
|
|
554
|
+
`+l}let f=Lt(l);if(f){let e=l.slice(f.rhsStart,f.rhsEnd+1);RegExp(`\\b${G(t)}Module\\b`).test(e)||(l=It(l,c))}else l=It(l,c);await B(a,l,`utf-8`)}function It(e,t){let n=Lt(e);if(!n)return e;if(n.shape===`array`){let r=e.slice(n.rhsStart+1,n.rhsEnd),i=r.trim(),a;if(!i)a=`[${t}]`;else{let e=i.endsWith(`,`)?``:`,`;a=`[${r.trimEnd()}${e} ${t}]`}return e.slice(0,n.rhsStart)+a+e.slice(n.rhsEnd+1)}return`${e.slice(0,n.chainEnd)}\n .mount(${t})${e.slice(n.chainEnd)}`}function Lt(e){let t=/export\s+const\s+modules\b[^=]*=/.exec(e);if(!t)return null;let n=t.index+t[0].length;for(;n<e.length&&/\s/.test(e[n]??``);)n++;if(e[n]===`[`){let t=Bt(e,n);return t===-1?null:{shape:`array`,rhsStart:n,rhsEnd:t}}if(e.slice(n,n+13)===`defineModules`){let t=Rt(e,n);return t===-1?null:{shape:`chain`,rhsStart:n,rhsEnd:t-1,chainEnd:t}}return null}function Rt(e,t=0){let n=/defineModules\s*\(/g;n.lastIndex=t;let r=n.exec(e);if(!r)return-1;let i=r.index+r[0].length-1;if(e[i]!==`(`||(i=Vt(e,i),i===-1))return-1;for(i++;;){let t=i;for(;t<e.length&&/\s/.test(e[t]??``);)t++;if(e[t]!==`.`||e.slice(t,t+6)!==`.mount`)break;for(t+=6;t<e.length&&/\s/.test(e[t]??``);)t++;if(e[t]!==`(`)break;let n=Vt(e,t);if(n===-1)break;i=n+1}return i}function zt(e,t){let n=e.slice(t,t+2);if(n===`//`){for(t+=2;t<e.length&&e[t]!==`
|
|
555
|
+
`;)t++;return t}if(n===`/*`){for(t+=2;t+1<e.length&&(e[t]!==`*`||e[t+1]!==`/`);)t++;return t+2}return t}function Bt(e,t){if(e[t]!==`[`)return-1;let n=1,r=t+1;for(;r<e.length;){let t=e.slice(r,r+2);if(t===`//`||t===`/*`){r=zt(e,r);continue}let i=e[r]??``;if(i===`'`||i===`"`||i==="`"){let t=i;for(r++;r<e.length&&e[r]!==t;)e[r]===`\\`&&r++,r++;r<e.length&&r++}else{if(i===`[`)n++;else if(i===`]`&&(n--,n===0))return r;r++}}return-1}function Vt(e,t){if(e[t]!==`(`)return-1;let n=1,r=t+1;for(;r<e.length;){let t=e.slice(r,r+2);if(t===`//`||t===`/*`){r=zt(e,r);continue}let i=e[r]??``;if(i===`'`||i===`"`||i==="`"){let t=i;for(r++;r<e.length&&e[r]!==t;)e[r]===`\\`&&r++,r++;r<e.length&&r++}else{if(i===`(`)n++;else if(i===`)`&&(n--,n===0))return r;r++}}return-1}function Ht(e,t,n,r){return`/**
|
|
556
556
|
* Snapshot for the DevTools topology view (\`/_debug\`).
|
|
557
557
|
*
|
|
558
558
|
* Must be CHEAP — the topology endpoint polls on a short interval, so
|
|
@@ -592,7 +592,7 @@ export const modules = defineModules().mount(${c})
|
|
|
592
592
|
// ]
|
|
593
593
|
// },`.split(`
|
|
594
594
|
`).map(e=>r+e).join(`
|
|
595
|
-
`)}async function
|
|
595
|
+
`)}async function Ut(e){let{name:t,outDir:n}=e,r=U(t),i=V(t),a=[],o=P(n,`${r}.adapter.ts`);return await y(o,`import {
|
|
596
596
|
defineAdapter,
|
|
597
597
|
type AdapterContext,
|
|
598
598
|
type AdapterMiddleware,
|
|
@@ -797,11 +797,11 @@ export const ${i}Adapter = defineAdapter<${i}AdapterConfig>({
|
|
|
797
797
|
return { name: '${r}', status: 'up' }
|
|
798
798
|
},
|
|
799
799
|
|
|
800
|
-
${
|
|
800
|
+
${Ht(r,i,`adapter`,` `)}
|
|
801
801
|
}
|
|
802
802
|
},
|
|
803
803
|
})
|
|
804
|
-
`),a.push(o),a}async function
|
|
804
|
+
`),a.push(o),a}async function Wt(e){let{name:t,outDir:n}=e,r=U(t),i=V(t),a=[],o=P(n,`${r}.plugin.ts`);return await y(o,`import {
|
|
805
805
|
definePlugin,
|
|
806
806
|
type AppAdapter,
|
|
807
807
|
type AppModuleEntry,
|
|
@@ -958,13 +958,13 @@ export const ${i}Plugin = definePlugin<${i}PluginConfig>({
|
|
|
958
958
|
// Example: await this.connection?.close()
|
|
959
959
|
},
|
|
960
960
|
|
|
961
|
-
${
|
|
961
|
+
${Ht(r,i,`plugin`,` `)}
|
|
962
962
|
}),
|
|
963
963
|
})
|
|
964
|
-
`),a.push(o),a}const
|
|
965
|
-
// \`express\``:"this project declares no `runtime` in kick.config.ts, so it\n // may have no `express`",s=
|
|
964
|
+
`),a.push(o),a}const Gt={controller:``,service:``,dto:`dtos`,guard:`guards`,middleware:`middleware`,contributor:`contributors`};function K(e){let{type:t,outDir:n,moduleName:r,modulesDir:i=`src/modules`,defaultDir:a,shouldPluralize:o=!0}=e;if(n)return I(n);if(r){let e=Gt,n=U(r),a=o?W(n):n,s=e[t]??``,c=P(i,a);return I(s?P(c,s):c)}return I(a)}async function Kt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=e.runtime===`express`,o=e.runtime?`this project runs on ${e.runtime} and has no
|
|
965
|
+
// \`express\``:"this project declares no `runtime` in kick.config.ts, so it\n // may have no `express`",s=K({type:`middleware`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/middleware`,pattern:i,shouldPluralize:e.pluralize??!0}),c=U(t),l=H(t),u=[],d=P(s,`${c}.middleware.ts`);return await y(d,`${a?`import type { Request, Response, NextFunction } from 'express'`:`import type { IncomingMessage, ServerResponse } from 'node:http'`}
|
|
966
966
|
|
|
967
|
-
export interface ${
|
|
967
|
+
export interface ${V(t)}Options {
|
|
968
968
|
// Add configuration options here. The factory below closes over the
|
|
969
969
|
// resolved options object; pass them at the call site —
|
|
970
970
|
// \`${l}({ foo: 'bar' })\` — and the closure preserves them across
|
|
@@ -972,7 +972,7 @@ export interface ${B(t)}Options {
|
|
|
972
972
|
}
|
|
973
973
|
|
|
974
974
|
/**
|
|
975
|
-
* ${
|
|
975
|
+
* ${V(t)} middleware.
|
|
976
976
|
*
|
|
977
977
|
* Usage in bootstrap (fires on every request):
|
|
978
978
|
* middlewares: [${l}()]
|
|
@@ -1008,7 +1008,7 @@ export interface ${B(t)}Options {
|
|
|
1008
1008
|
* first \`next()\` throws \`TypeError: next is not a function\`. Generate a
|
|
1009
1009
|
* guard instead (\`kick g guard\`) for the per-route, ctx-style shape.
|
|
1010
1010
|
*/
|
|
1011
|
-
export function ${l}(options: ${
|
|
1011
|
+
export function ${l}(options: ${V(t)}Options = {}) {
|
|
1012
1012
|
${a?" // Typed from `express` because that is this project's runtime\n // (`runtime: 'express'` in kick.config.ts). Global middleware is\n // connect-style on every engine, but only Express hands the handler its own\n // request / response objects — so `req.originalUrl`, `req.query` and\n // `res.json()` are all available here. Switching `runtime` later means\n // re-typing this signature from `node:http`.\n return (req: Request, res: Response, next: NextFunction) => {":` // Typed from \`node:http\`, not \`express\`. Global middleware is connect-style
|
|
1013
1013
|
// on every engine, but ${o} dependency to import types from. Under Fastify the handler
|
|
1014
1014
|
// receives \`request.raw\` / a reply driver, and under h3 the node objects, so
|
|
@@ -1021,7 +1021,7 @@ ${a?" // Typed from `express` because that is this project's runtime\n // (`ru
|
|
|
1021
1021
|
next()
|
|
1022
1022
|
}
|
|
1023
1023
|
}
|
|
1024
|
-
`),u.push(d),u}async function
|
|
1024
|
+
`),u.push(d),u}async function qt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=K({type:`guard`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/guards`,pattern:i,shouldPluralize:e.pluralize??!0}),o=U(t),s=H(t),c=V(t),l=[],u=P(a,`${o}.guard.ts`);return await y(u,`import { Container, HttpException } from '@forinda/kickjs'
|
|
1025
1025
|
import type { RequestContext } from '@forinda/kickjs'
|
|
1026
1026
|
|
|
1027
1027
|
/**
|
|
@@ -1061,7 +1061,7 @@ export async function ${s}Guard(ctx: RequestContext, next: () => void): Promise<
|
|
|
1061
1061
|
ctx.problem.unauthorized({ detail: 'Invalid or expired token' })
|
|
1062
1062
|
}
|
|
1063
1063
|
}
|
|
1064
|
-
`),l.push(u),l}function
|
|
1064
|
+
`),l.push(u),l}function Jt(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 Yt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=e.type??`http`,o=U(t),s=V(t),c=e.key??H(t),l=Array.isArray(e.params)?e.params:Jt(e.params),u=K({type:`contributor`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/contributors`,pattern:i,shouldPluralize:e.pluralize??!0}),d=a===`http`?`defineHttpContextDecorator`:`defineContextDecorator`,f=a===`http`?`RequestContext`:`ExecutionContext`,p=l.length>0?`\nexport type ${s}Params = {\n${l.map(e=>` ${e.name}: ${e.type}`).join(`
|
|
1065
1065
|
`)}\n}\n`:``,m=l.length>0?`${d}.withParams<${s}Params>()({`:`${d}({`,h=l.length>0?` // Every call site must supply these — no placeholder defaults.
|
|
1066
1066
|
// Add \`paramDefaults: { … }\` for any field whose default is
|
|
1067
1067
|
// genuinely correct for an undecorated route, and drop it from here.
|
|
@@ -1112,7 +1112,7 @@ ${_}
|
|
|
1112
1112
|
throw new Error("${s} contributor: resolve() not implemented")
|
|
1113
1113
|
},
|
|
1114
1114
|
})
|
|
1115
|
-
`,b=
|
|
1115
|
+
`,b=P(u,`${o}.contributor.ts`);return await y(b,v),[b]}async function Xt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=K({type:`service`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/services`,pattern:i,shouldPluralize:e.pluralize??!0}),o=U(t),s=V(t),c=[],l=P(a,`${o}.service.ts`);return await y(l,`import { Service } from '@forinda/kickjs'
|
|
1116
1116
|
|
|
1117
1117
|
@Service()
|
|
1118
1118
|
export class ${s}Service {
|
|
@@ -1121,7 +1121,7 @@ export class ${s}Service {
|
|
|
1121
1121
|
// @Inject(MY_REPO) private readonly repo: IMyRepository,
|
|
1122
1122
|
// ) {}
|
|
1123
1123
|
}
|
|
1124
|
-
`),c.push(l),c}async function
|
|
1124
|
+
`),c.push(l),c}async function Zt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=K({type:`controller`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/controllers`,pattern:i,shouldPluralize:e.pluralize??!0}),o=U(t),s=V(t),c=[],l=P(a,`${o}.controller.ts`);return await y(l,`import { Controller, Get, Post, Put, Delete, reply, type Ctx } from '@forinda/kickjs'
|
|
1125
1125
|
|
|
1126
1126
|
// \`Ctx<KickRoutes.${s}Controller['<method>']>\` is generated by
|
|
1127
1127
|
// \`kick typegen\` (auto-run on \`kick dev\`). After the first run, your IDE
|
|
@@ -1163,12 +1163,12 @@ export class ${s}Controller {
|
|
|
1163
1163
|
return reply.noContent()
|
|
1164
1164
|
}
|
|
1165
1165
|
}
|
|
1166
|
-
`),c.push(l),c}async function
|
|
1166
|
+
`),c.push(l),c}async function Qt(e){let{name:t,moduleName:n,modulesDir:r,pattern:i}=e,a=K({type:`dto`,outDir:e.outDir,moduleName:n,modulesDir:r,defaultDir:`src/dtos`,pattern:i,shouldPluralize:e.pluralize??!0}),o=U(t),s=V(t),c=H(t),l=e.schemaLib??`zod`,u=xt[l],d=[],f=P(a,`${o}.dto.ts`);return await y(f,`${u.import}
|
|
1167
1167
|
|
|
1168
|
-
export const ${c}Schema = ${
|
|
1168
|
+
export const ${c}Schema = ${St(l,`// Define your schema fields here\n name: ${u.required}`)}
|
|
1169
1169
|
|
|
1170
1170
|
export type ${s}DTO = ${u.infer(`${c}Schema`)}
|
|
1171
|
-
`),d.push(f),d}async function
|
|
1171
|
+
`),d.push(f),d}async function $t(e){let t=P(e.outDir,`kick.config.ts`),n=e.modulesDir??`src/modules`,r=e.defaultRepo??`inmemory`;return O(t)&&!e.force&&!await w({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
|
|
1172
1172
|
Skipped — existing kick.config.ts preserved.`),[]):(await y(t,`import { defineConfig } from '@forinda/kickjs-cli'
|
|
1173
1173
|
|
|
1174
1174
|
export default defineConfig({
|
|
@@ -1212,18 +1212,18 @@ export default defineConfig({
|
|
|
1212
1212
|
},
|
|
1213
1213
|
],
|
|
1214
1214
|
})
|
|
1215
|
-
`),[t])}function
|
|
1215
|
+
`),[t])}function en(e,t){if(e[t]!==`{`)return-1;let n=1;for(let r=t+1;r<e.length;r++){let t=e[r];if(t===`{`)n++;else if(t===`}`&&(n--,n===0))return r}return-1}function tn(e,t){let n=t.exec(e);if(!n)return null;let r=n.index+n[0].length-1,i=en(e,r);return i===-1?null:e.slice(r+1,i)}function nn(e,t,n){let r=` `.repeat(n);return e.split(`
|
|
1216
1216
|
`).map(e=>{if(e.trim()===``)return e;let n=RegExp(`^ {0,${t}}`),i=e.replace(n,``);return r+i}).join(`
|
|
1217
|
-
`)}function rn(e){return e.replaceAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*'@forinda\/kickjs'/g,(e,t)=>{let n=t.split(`,`).map(e=>e.trim()).filter(e=>e&&e!==`Container`&&e!==`type Container`&&e!==`type AppModule`&&e!==`AppModule`&&e!==`type ModuleRoutes`&&e!==`ModuleRoutes`);return n.includes(`defineModule`)||n.push(`defineModule`),`import { ${n.join(`, `)} } from '@forinda/kickjs'`})}function an(e,t){return e.replaceAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*'@forinda\/kickjs'/g,(e,n)=>{let r=n.split(`,`).map(e=>e.trim()).filter(e=>e&&e!==`defineModule`);return t.container&&!r.includes(`Container`)&&r.push(`Container`),t.appModule&&!r.some(e=>e===`AppModule`||e===`type AppModule`)&&r.push(`type AppModule`),t.moduleRoutes&&!r.some(e=>e===`ModuleRoutes`||e===`type ModuleRoutes`)&&r.push(`type ModuleRoutes`),t.contributorRegistrations&&!r.some(e=>e===`ContributorRegistrations`||e===`type ContributorRegistrations`)&&r.push(`type ContributorRegistrations`),`import { ${r.join(`, `)} } from '@forinda/kickjs'`})}function on(e){if(/\bdefineModule\s*\(/.test(e))return{migrated:null,reason:`already in target form`};let t=[...e.matchAll(/export\s+class\s+(\w+Module)\s+implements\s+AppModule\s*\{/g)];if(t.length===0)return{migrated:null,reason:`no class form detected`};if(t.length>1)return{migrated:null,reason:`multiple module classes in one file — migrate manually`};let n=t[0],r=n[1],i=n.index+n[0].length-1,a=
|
|
1217
|
+
`)}function rn(e){return e.replaceAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*'@forinda\/kickjs'/g,(e,t)=>{let n=t.split(`,`).map(e=>e.trim()).filter(e=>e&&e!==`Container`&&e!==`type Container`&&e!==`type AppModule`&&e!==`AppModule`&&e!==`type ModuleRoutes`&&e!==`ModuleRoutes`);return n.includes(`defineModule`)||n.push(`defineModule`),`import { ${n.join(`, `)} } from '@forinda/kickjs'`})}function an(e,t){return e.replaceAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*'@forinda\/kickjs'/g,(e,n)=>{let r=n.split(`,`).map(e=>e.trim()).filter(e=>e&&e!==`defineModule`);return t.container&&!r.includes(`Container`)&&r.push(`Container`),t.appModule&&!r.some(e=>e===`AppModule`||e===`type AppModule`)&&r.push(`type AppModule`),t.moduleRoutes&&!r.some(e=>e===`ModuleRoutes`||e===`type ModuleRoutes`)&&r.push(`type ModuleRoutes`),t.contributorRegistrations&&!r.some(e=>e===`ContributorRegistrations`||e===`type ContributorRegistrations`)&&r.push(`type ContributorRegistrations`),`import { ${r.join(`, `)} } from '@forinda/kickjs'`})}function on(e){if(/\bdefineModule\s*\(/.test(e))return{migrated:null,reason:`already in target form`};let t=[...e.matchAll(/export\s+class\s+(\w+Module)\s+implements\s+AppModule\s*\{/g)];if(t.length===0)return{migrated:null,reason:`no class form detected`};if(t.length>1)return{migrated:null,reason:`multiple module classes in one file — migrate manually`};let n=t[0],r=n[1],i=n.index+n[0].length-1,a=en(e,i);if(a===-1)return{migrated:null,reason:`unbalanced class braces`};let o=e.slice(i+1,a),s=e.slice(0,n.index),c=e.slice(a+1),l=tn(o,/register\s*\(([^)]*)\)\s*:\s*void\s*\{/),u=tn(o,/contributors\s*\(\s*\)\s*:\s*ContributorRegistrations\s*\{/),d=tn(o,/routes\s*\(\s*\)\s*:\s*[A-Za-z|[\]\s]+\{/);if(!d)return{migrated:null,reason:`routes() method missing or signature unrecognized`};let f=rn(s),p=``;return l&&(p+=` register(container) {${nn(l,4,6)} },\n\n`),u&&(p+=` contributors() {${nn(u,4,6)} },\n\n`),p+=` routes() {${nn(d,4,6)} },`,{migrated:`${f}${`export const ${r} = defineModule({
|
|
1218
1218
|
name: '${r}',
|
|
1219
1219
|
build: () => ({
|
|
1220
1220
|
${p}
|
|
1221
1221
|
}),
|
|
1222
|
-
})`}${c}`}}function sn(e){if(/export\s+class\s+\w+Module\s+implements\s+AppModule\s*\{/.test(e))return{migrated:null,reason:`already in target form`};let t=[...e.matchAll(/export\s+const\s+(\w+Module)\s*=\s*defineModule\s*\(\s*\{/g)];if(t.length===0)return{migrated:null,reason:`no defineModule form detected`};if(t.length>1)return{migrated:null,reason:`multiple defineModule blocks in one file — migrate manually`};let n=t[0],r=n[1],i=n.index+n[0].length-1,a=
|
|
1223
|
-
`||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=
|
|
1222
|
+
})`}${c}`}}function sn(e){if(/export\s+class\s+\w+Module\s+implements\s+AppModule\s*\{/.test(e))return{migrated:null,reason:`already in target form`};let t=[...e.matchAll(/export\s+const\s+(\w+Module)\s*=\s*defineModule\s*\(\s*\{/g)];if(t.length===0)return{migrated:null,reason:`no defineModule form detected`};if(t.length>1)return{migrated:null,reason:`multiple defineModule blocks in one file — migrate manually`};let n=t[0],r=n[1],i=n.index+n[0].length-1,a=en(e,i);if(a===-1)return{migrated:null,reason:`unbalanced defineModule braces`};let o=e.indexOf(`)`,a);if(o===-1)return{migrated:null,reason:`unbalanced defineModule call parens`};let s=e.slice(i+1,a),c=e.slice(0,n.index),l=o+1;for(;l<e.length&&(e[l]===`
|
|
1223
|
+
`||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=en(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=tn(m,/register\s*\(([^)]*)\)\s*\{/),g=tn(m,/contributors\s*\(\s*\)\s*\{/),_=tn(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let v=an(c,{container:h!==null,appModule:!0,moduleRoutes:!0,contributorRegistrations:g!==null}),y=``;return h!==null&&(y+=` register(container: Container): void {${nn(h,6,4)} }\n\n`),g!==null&&(y+=` contributors(): ContributorRegistrations {${nn(g,6,4)} }\n\n`),y+=` routes(): ModuleRoutes {${nn(_,6,4)} }`,{migrated:`${v}${`export class ${r} implements AppModule {
|
|
1224
1224
|
${y}
|
|
1225
1225
|
}
|
|
1226
|
-
`}${u}`}}function cn(e,t){return t===`class`?sn(e):on(e)}function ln(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 un(e){let t=[];return await n(
|
|
1226
|
+
`}${u}`}}function cn(e,t){return t===`class`?sn(e):on(e)}function ln(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 un(e){let t=[];return await n(I(e),0),t;async function n(e,r){let i;try{i=await He(e)}catch{return}for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=P(e,a),o;try{o=await We(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function dn(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await He(e)}catch{return}await Ve(t,{recursive:!0});for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=P(e,a),o=P(t,a),s;try{s=await We(i)}catch{continue}s.isDirectory()?await r(i,o):(await Be(i,o),n++)}}}function fn(e){let t=(/* @__PURE__ */ new Date()).toISOString().replaceAll(/[:.]/g,`-`);return P(e,`.kickjs`,`codemod-backups`,`${t}-modules`)}async function pn(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await un(e),s=await z(P(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=fn(r),await dn(e,c));let l=[];for(let e of o){let t=cn(await z(e,`utf-8`),i);t.migrated==null?l.push({path:e,status:`skipped`,reason:t.reason}):(n||await B(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`}))}let u=P(e,`index.ts`),d=null;try{d=await z(u,`utf-8`)}catch{return{target:i,files:l,indexStatus:`not-found`,indexPath:u,backupDir:c}}let f=ln(d,i);return f.migrated==null?{target:i,files:l,indexStatus:`skipped`,indexPath:u,indexReason:f.reason,backupDir:c}:(n||await B(u,f.migrated,`utf-8`),{target:i,files:l,indexStatus:`migrated`,indexPath:u,backupDir:c})}async function mn(e,t){let n=await un(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 z(e,`utf-8`);i.test(t)&&r.push(e)}return r}const hn={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.iso.datetime()`},email:{ts:`string`,zod:`z.email()`},url:{ts:`string`,zod:`z.url()`},uuid:{ts:`string`,zod:`z.uuid()`},json:{ts:`any`,zod:`z.any()`}};function gn(e){let t=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=hn[a];if(!o){let e=[...Object.keys(hn),`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}}),n=/* @__PURE__ */ new Set;for(let{name:e}of t){if(n.has(e))throw Error(`Duplicate field: "${e}". Each field name may appear once.`);n.add(e)}return t}async function _n(e){let{name:t,fields:n,modulesDir:r,repo:i=`inmemory`,tokenScope:a=`app`,style:o=`define`}=e,s=e.pluralize!==!1,c=U(t),l=V(t),u=s?W(c):c,d=s?$e(l):l,f=P(r,u),p=[],m=async(e,t)=>{let n=P(f,e);await y(n,t),p.push(n)};return await m(`${c}.module.ts`,vt({pascal:l,kebab:c,plural:u,repo:i,style:o})),await m(`${c}.constants.ts`,At({pascal:l,kebab:c})),await m(`${c}.controller.ts`,bt({pascal:l,kebab:c,plural:u,pluralPascal:d,swagger:e.swagger??!1})),await m(`${c}.service.ts`,kt({pascal:l,kebab:c})),await m(`dtos/create-${c}.dto.ts`,vn(l,n)),await m(`dtos/update-${c}.dto.ts`,yn(l,n)),await m(`dtos/${c}-response.dto.ts`,bn(l,n)),await m(`${c}.repository.ts`,Et({pascal:l,kebab:c,repoType:i,dtoPrefix:`./dtos`,tokenScope:a})),await Ft(r,l,u,c,o),p}function vn(e,t){return`import { z } from 'zod'
|
|
1227
1227
|
|
|
1228
1228
|
export const create${e}Schema = z.object({
|
|
1229
1229
|
${t.map(e=>{let t=e.zodType;return` ${e.name}: ${t}${e.optional?`.optional()`:``},`}).join(`
|
|
@@ -1246,7 +1246,7 @@ ${t.map(e=>` ${e.name}${e.optional?`?`:``}: ${e.tsType}`).join(`
|
|
|
1246
1246
|
createdAt: string
|
|
1247
1247
|
updatedAt: string
|
|
1248
1248
|
}
|
|
1249
|
-
`}async function xn(e){let{name:t,moduleName:n,modulesDir:r}=e,i=e.pluralize??!0,a=
|
|
1249
|
+
`}async function xn(e){let{name:t,moduleName:n,modulesDir:r}=e,i=e.pluralize??!0,a=U(t),o=V(t),s=[],c;if(e.outDir)c=I(e.outDir);else if(n){let e=U(n),t=i?W(e):e;c=I(P(r??`src/modules`,t,`__tests__`))}else c=I(`src/__tests__`);let l=P(c,`${a}.test.ts`);return await y(l,`import { describe, it, expect, beforeEach } from 'vitest'
|
|
1250
1250
|
import { Container } from '@forinda/kickjs'
|
|
1251
1251
|
|
|
1252
1252
|
describe('${o}', () => {
|
|
@@ -1271,22 +1271,22 @@ describe('${o}', () => {
|
|
|
1271
1271
|
})
|
|
1272
1272
|
`),s.push(l),s}function Sn(){let e=(process.env.LOG_LEVEL??process.env.KICKJS_LOG_LEVEL??``).toLowerCase();return e===`debug`||e===`trace`}var Cn=class extends Error{drifted;constructor(e){let t=e.map(e=>` ${e.id} → ${e.outFile}`).join(`
|
|
1273
1273
|
`);super(`kick typegen --check: ${e.length} generated file(s) are out of date:\n${t}\n Run \`kick typegen\` and commit the result.`),this.name=`TypegenDriftError`,this.drifted=e}};const wn=[`agents`,`claude`,`skills`,`gemini`,`copilot`,`both`,`all`];function q(e){return e.parent?.opts()?.dryRun??!1}function J(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(`
|
|
1274
|
-
(dry run — no files were written)`),console.log()}async function Tn(e){if(!e)try{let e=await l(process.cwd());await
|
|
1274
|
+
(dry run — no files were written)`),console.log()}async function Tn(e){if(!e)try{let e=await l(process.cwd());await we({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 En=[{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`}],Dn=/* @__PURE__ */ new Map([[`job`,`Queue processors are no longer built in — their shape belongs to whichever queue you run.
|
|
1275
1275
|
Add your own in kick.config.ts: https://kickjs.app/guide/plugin-generators.html`]]),On=/* @__PURE__ */ new Set([...En.map(e=>e.name.split(` `)[0]),...Dn.keys()]);async function kn(){console.log(`
|
|
1276
1276
|
Built-in generators:
|
|
1277
|
-
`);let e=Math.max(...En.map(e=>e.name.length));for(let t of En)console.log(` kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await l(process.cwd()),n=g(t?.plugins??[],t?.commands??[]),r=await
|
|
1277
|
+
`);let e=Math.max(...En.map(e=>e.name.length));for(let t of En)console.log(` kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await l(process.cwd()),n=g(t?.plugins??[],t?.commands??[]),r=await ut(process.cwd(),n.generators);if(r.generators.length>0){console.log(`
|
|
1278
1278
|
Plugin generators:
|
|
1279
1279
|
`);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(`
|
|
1280
1280
|
Failed to load:
|
|
1281
|
-
`);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}function An(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 jn(e,t,n){let r=await l(process.cwd()),i=p(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??
|
|
1282
|
-
Use -m to scope it to a module: kick g middleware auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await
|
|
1283
|
-
Use -m to scope it to a module: kick g guard admin -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await
|
|
1281
|
+
`);for(let{source:e,reason:t}of r.failed)console.log(` ${e} — ${t}`)}console.log()}function An(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 jn(e,t,n){let r=await l(process.cwd()),i=p(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??Nt(i.repo);t.repo&&f(t.repo);let s=t.pattern??r?.pattern??`rest`,c=t.pluralize===!1?!1:i.pluralize??!0,g=u(r,process.cwd()),_=d(E()),v=h(E()),y=E(),b=m(y,`@forinda/kickjs-testing`,`any`)&&m(y,`supertest`,`any`),x=i.style??`define`;if(!n&&x===`define`){let e=await mn(I(a),`define`);if(e.length>0){console.error(`\n ${C.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n ${C.dim(`Project setting:`)} modules.style: 'define' (default)\n\n ${C.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 ${C.bold(`Pick one:`)}\n 1. Migrate everything to defineModule:\n ${C.dim(`$`)} kick codemod modules --experimental --apply\n 2. Keep the class form — pin it in kick.config.ts:\n ${C.dim(`// kick.config.ts`)}\n ${C.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let S=[];for(let r of e){let e=await Pt({name:r,modulesDir:I(a),noEntity:t.entity===!1,noTests:t.tests===!1,repo:o,minimal:t.minimal,force:t.force,pattern:s,testHarness:b,dryRun:n,pluralize:c,tokenScope:g,swagger:_,schemaLib:v,style:i.style});S.push(...e)}J(S,n),await Tn(n)}function Mn(e,t){let n=e.command(`generate [names...]`).alias(`g`).description("Generate code scaffolds — bare form `kick g <name>` is shorthand for `kick g module <name>`").option(`--list`,`List all available generators`).option(`--dry-run`,`Preview files that would be generated without writing them`).option(`--no-entity`,`Skip entity and value object generation (module shortcut)`).option(`--no-tests`,`Skip test file generation (module shortcut)`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name (e.g. postgres)`).option(`--pattern <pattern>`,`Override project pattern: rest | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,r,i)=>{if(r.list){await kn();return}if(!e||e.length===0){n.help();return}let a=q(i);v(a);let[o,s,...c]=e;if(o){let e=await l(process.cwd()),n=g(e?.plugins??[],e?.commands??[]),i=await lt({generatorName:o,itemName:s??``,args:c,flags:r,cwd:process.cwd(),projectRoot:t?.projectRoot},n.generators);if(i){J(i.files,a);return}if(o!==`module`&&On.has(o)){let e=Dn.get(o);e?(console.error(`\n 'kick g ${o}' has been removed.`),console.error(` ${e}\n`)):(console.error(`\n '${o}' is a generator, not a module name.`),console.error(` Did you mean: kick g ${o} ${s??`<name>`}`),console.error(` If that errors, your @forinda/kickjs-cli is older than the '${o}' generator — upgrade it.\n`)),process.exitCode=1;return}}await jn(e,r,a)});n.command(`module <names...>`).description(`Generate one or more modules (e.g. kick g module user task project)`).option(`--no-entity`,`Skip entity and value object generation`).option(`--no-tests`,`Skip test file generation`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name (e.g. postgres)`).option(`--pattern <pattern>`,`Override project pattern: rest | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t,n)=>{let r=q(n);v(r),await jn(e,An(n,t),r)}),n.command(`adapter <name>`).description(`Generate an AppAdapter with lifecycle hooks and middleware support`).option(`-o, --out <dir>`,`Output directory`,`src/adapters`).action(async(e,t,n)=>{let r=q(n);v(r),J(await Ut({name:e,outDir:I(t.out)}),r)}),n.command(`plugin <name>`).description(`Generate a KickPlugin with DI, modules, adapters, middleware, and lifecycle hooks`).option(`-o, --out <dir>`,`Output directory`,`src/plugins`).action(async(e,t,n)=>{let r=q(n);v(r),J(await Wt({name:e,outDir:I(t.out)}),r)}),n.command(`middleware <name>`).description(`Generate a global middleware function, typed for the configured runtime
|
|
1282
|
+
Use -m to scope it to a module: kick g middleware auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await Kt({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0,runtime:i?.runtime}),r)}),n.command(`guard <name>`).description(`Generate a route guard (auth, roles, etc.)
|
|
1283
|
+
Use -m to scope it to a module: kick g guard admin -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await qt({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`contributor <name>`).description(`Generate a Context Contributor (typed alternative to @Middleware for ctx.set)
|
|
1284
1284
|
--type http (default, RequestContext) | bare (ExecutionContext)
|
|
1285
1285
|
--params "source:string,region:number" → emits the withParams<T>() form
|
|
1286
|
-
Use -m to scope it to a module: kick g contributor tenant -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).option(`-t, --type <type>`,`Contributor flavour: http | bare`,`http`).option(`-k, --key <key>`,`Context key it writes (defaults to camelCase of name)`).option(`--params <fields>`,`Per-call params, e.g. "source:string,region:number"`).action(async(e,t,n)=>{let r=q(n);v(r);let i=(t.type??`http`).toLowerCase();i!==`http`&&i!==`bare`&&(console.warn(` kick g contributor: unknown --type '${t.type}', using 'http'.`),i=`http`);let a=await l(process.cwd()),o=p(a),s=o.dir??`src/modules`;J(await
|
|
1287
|
-
Use -m to scope it to a module: kick g service payment -m orders`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await
|
|
1288
|
-
Use -m to scope it to a module: kick g controller auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await
|
|
1289
|
-
Use -m to scope it to a module: kick g dto create-user -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await
|
|
1286
|
+
Use -m to scope it to a module: kick g contributor tenant -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).option(`-t, --type <type>`,`Contributor flavour: http | bare`,`http`).option(`-k, --key <key>`,`Context key it writes (defaults to camelCase of name)`).option(`--params <fields>`,`Per-call params, e.g. "source:string,region:number"`).action(async(e,t,n)=>{let r=q(n);v(r);let i=(t.type??`http`).toLowerCase();i!==`http`&&i!==`bare`&&(console.warn(` kick g contributor: unknown --type '${t.type}', using 'http'.`),i=`http`);let a=await l(process.cwd()),o=p(a),s=o.dir??`src/modules`;J(await Yt({name:e,type:i,key:t.key,params:t.params,outDir:t.out,moduleName:t.module,modulesDir:s,pattern:a?.pattern,pluralize:o.pluralize??!0}),r)}),n.command(`service <name>`).description(`Generate a @Service() class
|
|
1287
|
+
Use -m to scope it to a module: kick g service payment -m orders`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await Xt({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`controller <name>`).description(`Generate a @Controller() class with basic routes
|
|
1288
|
+
Use -m to scope it to a module: kick g controller auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await Zt({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r),await Tn(r)}),n.command(`dto <name>`).description(`Generate a DTO schema for the project’s validation library
|
|
1289
|
+
Use -m to scope it to a module: kick g dto create-user -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await Qt({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0,schemaLib:h(E())}),r)}),n.command(`test <name>`).description(`Generate a Vitest test scaffold
|
|
1290
1290
|
Use -m to scope it to a module: kick g test user-service -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module's __tests__/ folder`).action(async(e,t,n)=>{let r=q(n);v(r);let i=await l(process.cwd()),a=p(i),o=a.dir??`src/modules`;J(await xn({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pluralize:a.pluralize??!0}),r)}),n.command(`scaffold <name> [fields...]`).description(`Generate a full CRUD module from field definitions
|
|
1291
1291
|
Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
|
|
1292
1292
|
Types: string, text, number, int, float, boolean, date, email, url, uuid, json, enum:a,b,c
|
|
@@ -1296,31 +1296,31 @@ describe('${o}', () => {
|
|
|
1296
1296
|
Usage: kick g scaffold <name> <field:type> [field:type...]
|
|
1297
1297
|
Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
|
|
1298
1298
|
Optional: append :optional (shell-safe, no quoting needed)
|
|
1299
|
-
`),process.exit(1));let o=await l(process.cwd()),s=p(o),c=i.modulesDir??s.dir??`src/modules`,f=gn(t),m=u(o,process.cwd()),h=d(
|
|
1300
|
-
`,u=``;
|
|
1299
|
+
`),process.exit(1));let o=await l(process.cwd()),s=p(o),c=i.modulesDir??s.dir??`src/modules`,f=gn(t),m=u(o,process.cwd()),h=d(E()),g=await _n({name:e,fields:f,modulesDir:I(c),noEntity:i.entity===!1,noTests:i.tests===!1,pluralize:i.pluralize===!1?!1:s.pluralize??!0,tokenScope:m,swagger:h,style:s.style});console.log(`\n Scaffolded ${e} with ${f.length} field(s):`);for(let e of f)console.log(` ${e.name}: ${e.type}${e.optional?` (optional)`:``}`);J(g,a),await Tn(a)}),n.command(`config`).description(`Generate a kick.config.ts at the project root`).option(`--modules-dir <dir>`,`Modules directory path`,`src/modules`).option(`--repo <type>`,`Repository name: inmemory (default) or any DB name`,`inmemory`).option(`-f, --force`,`Overwrite existing kick.config.ts without prompting`).action(async(e,t)=>{let n=q(t);v(n),J(await $t({outDir:I(`.`),modulesDir:e.modulesDir,defaultRepo:e.repo,force:e.force}),n)}),n.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 | inertia`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t)=>{let n=q(t);v(n);let r=e.only??`all`;wn.includes(r)?J(await re({outDir:I(`.`),only:r,name:e.name,pm:e.pm,template:e.template,force:e.force}),n):(console.error(` Invalid --only value: ${r}. Expected: ${wn.join(` | `)}`),process.exitCode=1)});for(let e of t?.generators??[])Nn(n,e,t?.projectRoot)}function Nn(e,t,n){let{source:r,spec:i}=t,a=i.args?.[0],o=a?.name??`itemName`,s=a?.required?`<${o}>`:`[${o}]`,c=`${i.name} ${s} [extraArgs...]`,l=e.command(c).description(`${i.description} [${r}]`);for(let e of i.flags??[]){let t=e.takesValue?`--${e.name} <value>`:`--${e.name}`,n=e.alias?`-${e.alias}, ${t}`:t;l.option(n,e.description??``)}l.action(async(e,r,a,o)=>{let s=q(o);v(s);let c=await lt({generatorName:i.name,itemName:e??``,args:r??[],flags:a,cwd:process.cwd(),projectRoot:n},[t]);c&&J(c.files,s)})}const Pn=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: `;async function Fn(e){let t=M.resolve(e.cwd,`.kickjs/types`);e.check||await Ve(t,{recursive:!0});let n=/* @__PURE__ */ new Map,r=e.scan??ge,i=M.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(R(e).href)},async writeFile(t,n){let r=M.resolve(e.cwd,t);await Ve(M.dirname(r),{recursive:!0}),await B(r,n,`utf8`)},getScanResult:e=>{let t=In(e),o=n.get(t);if(!o){let s={cacheDir:i,...e};o=a?he(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=M.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=`${Pn}${n.id} */\n\n`+a+`
|
|
1300
|
+
`,u=``;O(i)&&(u=await z(i,`utf8`)),u===l?s.push({id:n.id,status:`unchanged`,outFile:i}):e.check?(c.push({id:n.id,outFile:i}),s.push({id:n.id,status:`drifted`,outFile:i})):(await B(i,l,`utf8`),s.push({id:n.id,status:`written`,outFile:i}))}if(c.length>0)throw new Cn(c);return s}function In(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=/* @__PURE__ */ 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 Rn=/* @__PURE__ */ e({applyDisableFilter:()=>Ln,runAllPluginTypegens:()=>zn});async function zn(e){let t=[...Oo,...e.config?.plugins??[]],{enabled:n,skipped:r,unknown:i}=Ln(g(t,e.config?.commands??[]).typegens,e.config?.typegen?.disable??[]);if(!e.silent&&r.length>0)for(let e of r)console.log(` ${e.id}: disabled (typegen.disable)`);if(!e.silent&&i.length>0&&console.warn(` kick typegen: disable list references unknown id(s): ${i.map(e=>`'${e}'`).join(`, `)}. Run \`kick typegen --list\` to see registered ids.`),n.length===0)return[];try{let t=await Fn({cwd:e.cwd,config:e.config??{},plugins:n,watch:e.watch,check:e.check,changedFiles:e.changedFiles});if(!e.silent&&Sn())for(let e of t)console.log(` ${e.id}: ${e.status}`);return t}catch(t){if(t instanceof Cn||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 Bn(e){let t=/* @__PURE__ */ new Map;return{report(n,r){let i=r instanceof Error?r.message:String(r);t.get(n)!==i&&(t.set(n,i),e(` kick typegen: ${n} pass failed (${i}) — types in .kickjs/types may be stale`))},clear(e){t.delete(e)}}}const Vn=`__kickjs_typegen_owner`;function Hn(e){let{cwd:t,config:n}=e,r=e.debounceMs??100,i=e.pipeline??{runTypegen:async e=>(await import(`./typegen-BmyEoY3Z.mjs`).then(e=>e.n)).runTypegen(e),runAllPluginTypegens:async e=>(await Promise.resolve().then(()=>Rn)).runAllPluginTypegens(e),writeTypegenArtifacts:async(e,t,n)=>(await import(`./typegen-BmyEoY3Z.mjs`).then(e=>e.n)).writeTypegenArtifacts(e,t,n),buildAssets:async(e,t)=>(await import(`./build-Snjzr08O.mjs`).then(e=>e.n)).buildAssets(e,t)},a=n?.typegen?.schemaValidator??`zod`,o=n?.typegen?.envFile,s=M.resolve(t,n?.typegen?.outDir??`.kickjs/types`),c=n?.assetMap?Object.values(n.assetMap).map(e=>e?.src).filter(e=>typeof e==`string`&&e.length>0).map(e=>M.resolve(t,e)):[],l=!!n?.assetMap&&Object.keys(n.assetMap).length>0,u=e=>e.replaceAll(`\\`,`/`),d=c.map(u),f=e=>{let t=u(e);return d.some(e=>t===e||t.startsWith(`${e}/`))},p=Bn(e.emitWarning),m=null,h=!1,g=/* @__PURE__ */ new Set,_=/* @__PURE__ */ new Set,v=!1,y=!1;function b(r,c){i.runTypegen({cwd:t,silent:!0,allowDuplicates:!0,schemaValidator:a,envFile:o,srcDir:n?.typegen?.srcDir,outDir:n?.typegen?.outDir,assetMap:n?.assetMap,changedFiles:r,runPlugins:!1}).then(()=>p.clear(`scan`)).catch(e=>p.report(`scan`,e)),i.runAllPluginTypegens({cwd:t,config:n,silent:!0,changedFiles:r,watch:!0}).then(e=>i.writeTypegenArtifacts(s,e,!0)).then(()=>p.clear(`plugins`)).catch(e=>p.report(`plugins`,e)).finally(()=>e.onPassComplete?.()),c&&n&&i.buildAssets(n,{cwd:t,silent:!0}).catch(()=>{})}function x(){let e=v?void 0:{changed:[...g],removed:[..._]},t=y;g.clear(),_.clear(),v=!1,y=!1,b(e,t)}return{assetSrcRoots:c,handleWatchEvent(e,t){if(!h&&!u(t).includes(`/.kickjs/`)){if(e===`unlinkDir`)v=!0,l&&(y=!0);else{if(t.endsWith(`.d.ts`))return;let n=/\.(ts|tsx|mts|cts)$/.test(t),r=f(t);if(!n&&!r)return;r&&l&&(y=!0),n&&(e===`unlink`?(_.add(t),g.delete(t)):(g.add(t),_.delete(t)))}m&&clearTimeout(m),m=setTimeout(x,r)}},runOnce(){h||b(void 0,l)},dispose(){h=!0,m&&clearTimeout(m),m=null}}}function Un(e){let t=P(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=P(t,i);if(O(r))return{cmd:r,args:[`--noEmit`],shell:n,kind:e}}}return null}function Wn(e){let t=e.spawnFn??Re,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 Gn(e,t=12){let n=e.trim().split(/\r?\n/);return n.length<=t?n.join(`
|
|
1301
1301
|
`):`${n.slice(0,t).join(`
|
|
1302
|
-
`)}\n… ${n.length-t} more line(s)`}function
|
|
1302
|
+
`)}\n… ${n.length-t} more line(s)`}function Kn(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function qn(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 Jn(e,t,n={}){t&&(process.env.PORT=t);let r=Kn(n.polling),i=process.cwd(),a=await l(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await we({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=I(i,a?.typegen?.outDir??`.kickjs/types`);try{let e=await zn({cwd:i,config:a});await _e(c,e,!1)}catch(e){console.warn(` kick typegen: plugin pass skipped (${e?.message??e})`)}let{createRequire:u}=await import(`node:module`),d=u(I(`package.json`)).resolve(`vite`),{createServer:f}=await import(R(d).href);globalThis[Vn]=`kick-dev`;let p=await f({configFile:I(`vite.config.ts`),server:{port:t?parseInt(t,10):void 0,...r?{watch:{usePolling:!0,interval:100}}:{}}}),m=n.typecheck??a?.dev?.typecheck??!1,h=null,g=!0;if(m){let e=Un(i);e?h=Wn({cwd:i,bin:e,onResult:e=>{p.hot.send({type:`custom`,event:`kickjs:typecheck`,data:{ok:e.ok,output:e.output,durationMs:e.durationMs}}),e.ok?g||(g=!0,console.log(` kick typecheck: clean again (${e.kind}, ${e.durationMs}ms)`)):(g=!1,console.warn(`\n kick typecheck (${e.kind}, ${e.durationMs}ms):`),console.warn(Gn(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 _=Hn({cwd:i,config:a,emitWarning:e=>{console.warn(e),p.hot.send({type:`custom`,event:`kickjs:typegen-error`,data:{message:e,timestamp:Date.now()}})},onPassComplete:()=>h?.schedule()});p.watcher.on(`add`,e=>_.handleWatchEvent(`add`,e)),p.watcher.on(`unlink`,e=>_.handleWatchEvent(`unlink`,e)),p.watcher.on(`change`,e=>_.handleWatchEvent(`change`,e)),p.watcher.on(`unlinkDir`,e=>_.handleWatchEvent(`unlinkDir`,e)),_.assetSrcRoots.length>0&&p.watcher.add([..._.assetSrcRoots]),await p.listen(),p.printUrls(),console.log(`
|
|
1303
1303
|
KickJS dev server running (Vite + @forinda/kickjs-vite)
|
|
1304
|
-
`),h?.schedule();let v=!1,y=async()=>{if(!v){v=!0,_.dispose(),h?.dispose();try{await globalThis.__kickjs_app_shutdown?.()}catch(e){console.error(` app shutdown hook failed: ${e?.message??e}`)}await p.close(),process.exit(0)}};process.on(`SIGINT`,y),process.on(`SIGTERM`,y),process.on(`SIGBREAK`,y)}async function
|
|
1304
|
+
`),h?.schedule();let v=!1,y=async()=>{if(!v){v=!0,_.dispose(),h?.dispose();try{await globalThis.__kickjs_app_shutdown?.()}catch(e){console.error(` app shutdown hook failed: ${e?.message??e}`)}await p.close(),process.exit(0)}};process.on(`SIGINT`,y),process.on(`SIGTERM`,y),process.on(`SIGBREAK`,y)}async function Yn(e){let t=await l(e);try{await we({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=I(e,t?.typegen?.outDir??`.kickjs/types`),r=await zn({cwd:e,config:t});await _e(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 Xn(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 Jn(e.entry,e.port,{polling:e.polling,typecheck:e.typecheck})}catch(e){e.code===`ERR_MODULE_NOT_FOUND`&&e.message?.includes(`vite`)?console.error(`
|
|
1305
1305
|
Error: vite is not installed.
|
|
1306
1306
|
Run: pnpm add -D vite unplugin-swc
|
|
1307
1307
|
`):console.error(`
|
|
1308
1308
|
Dev server failed:`,e.message??e),process.exit(1)}}),e.command(`build`).description(`Build for production via Vite`).action(async()=>{console.log(`
|
|
1309
1309
|
Building for production...
|
|
1310
|
-
`);let{createRequire:e}=await import(`node:module`),t=e(
|
|
1311
|
-
Copying directories to dist...`);for(let e of i){let t=typeof e==`string`?e:e.src,n=typeof e==`string`?
|
|
1312
|
-
Building asset map...`);try{await
|
|
1310
|
+
`);let{createRequire:e}=await import(`node:module`),t=e(I(`package.json`)).resolve(`vite`),{build:n}=await import(R(t).href);await n({configFile:I(`vite.config.ts`)});let r=await l(process.cwd()),i=r?.copyDirs??[];if(i.length>0){console.log(`
|
|
1311
|
+
Copying directories to dist...`);for(let e of i){let t=typeof e==`string`?e:e.src,n=typeof e==`string`?P(`dist`,e):e.dest??P(`dist`,t),r=I(t),i=I(n);O(r)?(Me(i,{recursive:!0}),je(r,i,{recursive:!0}),console.log(` ✓ ${t} → ${n}`)):console.log(` ⚠ Skipped ${t} (not found)`)}}if(r?.assetMap&&Object.keys(r.assetMap).length>0){console.log(`
|
|
1312
|
+
Building asset map...`);try{await ke(r,{cwd:process.cwd()})}catch(e){console.error(` ✗ asset build failed: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}console.log(`
|
|
1313
1313
|
Build complete.
|
|
1314
1314
|
`)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await l(process.cwd());if(!e?.assetMap||Object.keys(e.assetMap).length===0)console.log(` No assetMap entries — nothing to build.`);else{console.log(`
|
|
1315
|
-
Building asset map...`);try{await
|
|
1315
|
+
Building asset map...`);try{await ke(e,{cwd:process.cwd()}),console.log(`
|
|
1316
1316
|
Asset build complete.
|
|
1317
|
-
`)}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)),n(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=
|
|
1317
|
+
`)}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)),n(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=I(process.cwd(),e.cwd??`.`);e.typegen!==!1&&await Yn(t);let n=Un(t);if(!n){console.error(`
|
|
1318
1318
|
No type-checker found. Install one in this project:
|
|
1319
1319
|
pnpm add -D typescript (tsc)
|
|
1320
1320
|
pnpm add -D @typescript/native-preview (tsgo, faster)
|
|
1321
|
-
`),process.exit(1);return}let r=
|
|
1322
|
-
Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function
|
|
1323
|
-
`))})}const{bold:Y,dim:X,green:
|
|
1321
|
+
`),process.exit(1);return}let r=ze(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 qn(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 Jn(e.entry,e.port)}catch(e){console.error(`
|
|
1322
|
+
Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function Zn(){try{let e=N(Ie(import.meta.url));return JSON.parse(k(P(e,`..`,`package.json`),`utf-8`)).version??`unknown`}catch{return`unknown`}}const Qn=new Set(Object.values(o).filter(e=>e.deprecated).map(e=>e.pkg));function $n(e){let t=P(e,`package.json`);if(!O(t))return[];let n;try{n=JSON.parse(k(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=P(e,`node_modules`,...t.split(`/`),`package.json`);if(O(i))try{n=JSON.parse(k(i,`utf-8`)).version??null}catch{}return{name:t,installed:n,declared:r[t]??null,deprecated:Qn.has(t)}})}function er(e){let t=e;for(;;){if(O(P(t,`package.json`)))return t;let e=N(t);if(e===t)return null;t=e}}function tr(e){e.command(`info`).description(`Print system and framework info`).action(()=>{let e=[``,` KickJS CLI v${Zn()}`,``,` System:`,` OS: ${Ye()} ${Xe()} (${Je()})`,` Node: ${process.version}`],t=er(process.cwd()),n=t?$n(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(`
|
|
1323
|
+
`))})}const{bold:Y,dim:X,green:nr,red:rr,yellow:ir,blue:ar}=C;function or(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 sr(e){let t=await fetch(e,{signal:AbortSignal.timeout(5e3)});if(!t.ok)throw Error(`${t.status} ${t.statusText}`);return t.json()}async function cr(e,t){try{return await sr(`${e}${t}`)}catch{return null}}async function lr(e){let[t,n,r,i,a]=await Promise.all([cr(e,`/health`),cr(e,`/metrics`),cr(e,`/routes`),cr(e,`/container`),cr(e,`/ws`)]);return{health:t,metrics:n,routes:r,container:i,ws:a}}function ur(e,t){let{health:n,metrics:r,routes:i,container:a,ws:o}=t,s=X(`─`.repeat(60));if(console.log(),console.log(Y(` KickJS Inspector`)+X(` → ${e}`)),console.log(s),n){let e=n.status===`healthy`?nr(`● healthy`):rr(`● `+n.status);console.log(` ${Y(`Health:`)} ${e}`)}else console.log(` ${Y(`Health:`)} ${rr(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?rr:r.errorRate>0?ir:nr;console.log(` ${Y(`Uptime:`)} ${or(r.uptimeSeconds)}`),console.log(` ${Y(`Requests:`)} ${r.requests}`),console.log(` ${Y(`Errors:`)} ${r.serverErrors} server, ${r.clientErrors??0} client ${X(`(`)}${t(e+`%`)}${X(`)`)}`)}if(a&&console.log(` ${Y(`DI:`)} ${a.count} bindings`),o&&o.enabled&&console.log(` ${Y(`WS:`)} ${o.connections??0} connections, ${o.namespaces??0} namespaces`),i?.routes?.length){console.log(),console.log(Y(` Routes`)),console.log(s),console.log(` ${X(`METHOD`)} ${X(`PATH`.padEnd(36))} ${X(`CONTROLLER`)}`);for(let e of i.routes){let t=e.path.length>36?e.path.slice(0,33)+`...`:e.path.padEnd(36);console.log(` ${ee(e.method)} ${t} ${ar(e.controller)}.${X(e.handler)}`)}}console.log(s),console.log()}function dr(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 lr(r);t.json?console.log(JSON.stringify(e,null,2)):ur(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(rr(` ✖ Could not connect to ${n}`)),console.error(X(` ${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 Z(e,t){let n=e.toLowerCase();return t.every(e=>n.includes(e.toLowerCase()))}function Q(e,t){let n=e.toLowerCase();return t.some(e=>n.includes(e.toLowerCase()))}const fr=[{match(e,t){let n=Z(e,[`config`,`get`])&&Q(e,[`undefined`,`null`]),r=e.includes(`@Value`)&&Q(e,[`undefined`,`is not defined`]);return!n&&!r?null:Q(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
|
|
1324
1324
|
src/config/index.ts, and src/index.ts imports it before bootstrap().
|
|
1325
1325
|
Tests never load src/index.ts — \`createTestApp\` builds the app
|
|
1326
1326
|
directly — so that import does not run and ConfigService falls back to
|
|
@@ -1535,24 +1535,24 @@ import { bootstrap } from '@forinda/kickjs'
|
|
|
1535
1535
|
await bootstrap({ modules }) // ← nothing for the dev server to read`,codeAfter:`import './env'
|
|
1536
1536
|
import { bootstrap } from '@forinda/kickjs'
|
|
1537
1537
|
|
|
1538
|
-
export const app = await bootstrap({ modules })`,docs:`https://kickjs.app/guide/project-structure.html`}}}}];function
|
|
1538
|
+
export const app = await bootstrap({ modules })`,docs:`https://kickjs.app/guide/project-structure.html`}}}}];function pr(e,t){let n=null;for(let r of fr){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 mr(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.
|
|
1539
1539
|
export OPENAI_API_KEY="sk-..."
|
|
1540
1540
|
|
|
1541
1541
|
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:
|
|
1542
1542
|
kick add ai
|
|
1543
1543
|
|
|
1544
1544
|
Or manually:
|
|
1545
|
-
pnpm add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=
|
|
1546
|
-
`)}function
|
|
1545
|
+
pnpm add @forinda/kickjs-ai`}}let{OpenAIProvider:i}=r,a=new i({apiKey:n,defaultChatModel:e.model??`gpt-4o-mini`}),o=hr(e.cwd),s=`Error or stack trace:\n\n${e.input.trim()}`;try{let e=gr((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 hr(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(`
|
|
1546
|
+
`)}function gr(e){let t=[e,_r(e),vr(e)].filter(e=>e!==null);for(let e of t)try{let t=JSON.parse(e);if(yr(t))return t}catch{continue}return null}function _r(e){let t=e.match(/```(?:json)?\s*\n([\s\S]*?)```/);return t?t[1]?.trim()??null:null}function vr(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;else if(o===`\\`&&r)i=!0;else if(o===`"`)r=!r;else if(!r&&(o===`{`&&n++,o===`}`&&(n--,n===0)))return e.slice(t,a+1)}return null}function yr(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 br(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 Cr(e,t.message);(!n||n.trim().length===0)&&(process.stderr.write(`Error: no input provided.
|
|
1547
1547
|
|
|
1548
1548
|
Pass a message as a positional arg, --message flag, or pipe via stdin:
|
|
1549
1549
|
kick explain "config.get returned undefined"
|
|
1550
1550
|
pnpm test 2>&1 | kick explain
|
|
1551
|
-
`),process.exit(1));let r=
|
|
1552
|
-
`);return}if(i){
|
|
1553
|
-
`),process.exit(2)),
|
|
1554
|
-
`),process.exit(a.kind===`ok`?0:2)),
|
|
1555
|
-
`)}function
|
|
1551
|
+
`),process.exit(1));let r=Tr(),i=pr(n,r);if(t.json&&i){process.stdout.write(JSON.stringify({matched:!0,...i},null,2)+`
|
|
1552
|
+
`);return}if(i){Er(n,i.diagnosis,i.confidence);return}t.ai||(t.json&&(process.stdout.write(JSON.stringify({matched:!1},null,2)+`
|
|
1553
|
+
`),process.exit(2)),Dr(n),process.exit(2));let a=await mr({input:n,model:t.model,cwd:r.cwd});t.json&&(process.stdout.write(JSON.stringify(xr(a),null,2)+`
|
|
1554
|
+
`),process.exit(a.kind===`ok`?0:2)),Sr(n,a),process.exit(a.kind===`ok`?0:2)})}function xr(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 Sr(e,t){t.kind===`ok`?Er(e,t.diagnosis,-1,!0):t.kind===`unavailable`?(process.stdout.write(`\n Explaining: ${kr(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback unavailable: ${t.reason}\n\n`),process.stdout.write(`${Or(t.suggestion,` `)}\n\n`)):(process.stdout.write(`\n Explaining: ${kr(e.trim(),200)}\n\n`),process.stdout.write(` AI fallback error: ${t.message}\n\n`))}async function Cr(e,t){return e&&e.trim().length>0?e:t&&t.trim().length>0?t:process.stdin.isTTY?``:wr()}function wr(){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 Tr(){let e=process.cwd();return{cwd:e,hasFile:t=>O(I(e,t))}}function Er(e,t,n,r=!1){let i=kr(e.trim(),200),a=r?`AI-generated — verify before applying`:Ar(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${Or(t.explanation,` `)}\n`),process.stdout.write(`\n Fix:\n${Or(t.fix,` `)}\n`),t.codeBefore&&process.stdout.write(`\n Before:\n${Or(t.codeBefore,` `)}\n`),t.codeAfter&&process.stdout.write(`\n After:\n${Or(t.codeAfter,` `)}\n`),t.docs&&process.stdout.write(`\n Docs: ${t.docs}\n`),process.stdout.write(`
|
|
1555
|
+
`)}function Dr(e){let t=kr(e.trim(),200);process.stdout.write(`\n Explaining: ${t}\n\n`),process.stdout.write(` No known-issue matched. Things you can try:
|
|
1556
1556
|
|
|
1557
1557
|
1. Check the framework docs for the error keywords:
|
|
1558
1558
|
https://kickjs.app/
|
|
@@ -1564,12 +1564,12 @@ Pass a message as a positional arg, --message flag, or pipe via stdin:
|
|
|
1564
1564
|
3. File an issue with the error text:
|
|
1565
1565
|
https://github.com/forinda/kick-js/issues/new
|
|
1566
1566
|
|
|
1567
|
-
`)}function
|
|
1567
|
+
`)}function Or(e,t){return e.split(`
|
|
1568
1568
|
`).map(e=>`${t}${e}`).join(`
|
|
1569
|
-
`)}function
|
|
1570
|
-
`,`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
|
|
1569
|
+
`)}function kr(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function Ar(e){return e>=90?`high confidence`:e>=70?`good match`:e>=50?`medium confidence`:`low confidence — verify manually`}function jr(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(Mr),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(Nr)}function Mr(e){let t=I(e.entry);O(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=Re(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)=>{t?process.kill(process.pid,t):process.exit(e??0)});let i=e=>{r.killed||r.kill(e)};process.on(`SIGINT`,()=>i(`SIGINT`)),process.on(`SIGTERM`,()=>i(`SIGTERM`))}function Nr(e){let t=process.cwd(),n=Pr(t)??Fe(t),r=e.name??n,i=e.global?I(process.env.HOME??`.`,`.mcp.json`):I(t,e.out),a={command:`kick`,args:[`mcp`],cwd:t},o={mcpServers:{}};if(O(i))try{let e=k(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,j(i,JSON.stringify(o,null,2)+`
|
|
1570
|
+
`,`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 Pr(e){let t=I(e,`package.json`);if(!O(t))return null;try{let e=k(t,`utf8`),n=JSON.parse(e);return typeof n.name==`string`?n.name:null}catch{return null}}function Fr(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=I(t,e.entry);O(n)||(console.error(`\n Error: ${e.entry} not found.\n`),process.exit(1));let r=Lr(t,`tsx`);r||(console.error(`
|
|
1571
1571
|
Error: tsx not found. Install it: pnpm add -D tsx
|
|
1572
|
-
`),process.exit(1));let i=
|
|
1572
|
+
`),process.exit(1));let i=Ir(n,e.entry),a=P(t,`.kick-tinker.mjs`),{writeFileSync:o,unlinkSync:s}=await import(`node:fs`);o(a,i,`utf-8`);try{let e=Le(a,[],{cwd:t,execPath:r,stdio:`inherit`});await new Promise(t=>{e.on(`exit`,()=>t())})}finally{try{s(a)}catch{}}})}function Ir(e,t){return`
|
|
1573
1573
|
import 'reflect-metadata'
|
|
1574
1574
|
|
|
1575
1575
|
// Prevent bootstrap() from starting the HTTP server
|
|
@@ -1594,7 +1594,7 @@ try {
|
|
|
1594
1594
|
|
|
1595
1595
|
// Load entry to trigger decorator registration
|
|
1596
1596
|
try {
|
|
1597
|
-
await import('${
|
|
1597
|
+
await import('${R(e).href}')
|
|
1598
1598
|
} catch (err) {
|
|
1599
1599
|
console.warn(' Warning: ' + err.message)
|
|
1600
1600
|
console.warn(' Container may be partially initialized.\\n')
|
|
@@ -1623,53 +1623,61 @@ server.on('exit', () => {
|
|
|
1623
1623
|
console.log('\\n Goodbye!\\n')
|
|
1624
1624
|
process.exit(0)
|
|
1625
1625
|
})
|
|
1626
|
-
`}function
|
|
1626
|
+
`}function Lr(e,t){let n=e;for(;;){let e=P(n,`node_modules`,`.bin`,t);if(O(e))return e;let r=I(n,`..`);if(r===n)break;n=r}return null}function Rr(e,t){let n=RegExp(`^\\s*${G(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]!==`
|
|
1627
1627
|
`;)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]===`
|
|
1628
|
-
`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t}else i=s+1}return{content:a,changed:r}}function
|
|
1628
|
+
`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t}else i=s+1}return{content:a,changed:r}}function zr(e,t){let n=Lt(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=Rr(a,t).content,a=a.replace(RegExp(`\\s*,?\\s*${G(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 Br(e){let{name:t,modulesDir:n,force:r}=e,i=e.pluralize!==!1,a=U(t),o=V(t),s=i?W(a):a;s!==a&&!await b(P(n,s))&&await b(P(n,a))&&(s=a);let c=P(n,s);if(!await b(c)){console.log(`\n Module not found: ${c}\n`);return}if(!r&&!await w({message:C.red(`Delete module '${s}' at ${c}? This cannot be undone.`),initialValue:!1})){console.log(`
|
|
1629
1629
|
Cancelled.
|
|
1630
|
-
`);return}await
|
|
1630
|
+
`);return}await Ue(c,{recursive:!0,force:!0}),console.log(` Deleted: ${c}`);let l=P(n,`index.ts`);if(await b(l)){let e=await z(l,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${G(o)}Module\\s*\\}\\s*from\\s*['"][^'"]*${G(s)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=zr(e,o),e=e.replace(/\n{3,}/g,`
|
|
1631
1631
|
|
|
1632
|
-
`),e!==t&&(await
|
|
1632
|
+
`),e!==t&&(await B(l,e,`utf-8`),console.log(` Unregistered: ${o}Module from ${l}`))}console.log(`\n Module '${s}' removed.\n`)}function Vr(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 l(process.cwd()),r=p(n),i=t.modulesDir??r.dir??`src/modules`,a=t.pluralize===!1?!1:r.pluralize??!0;for(let n of e)await Br({name:n,modulesDir:I(i),force:t.force,pluralize:a})})}function Hr(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 Ur(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function Wr(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=E(process.cwd()),n=await l(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-BpfANLIW.mjs`).then(e=>e.t),{builtinCliPlugins:t}=await Promise.resolve().then(()=>Do),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(`
|
|
1633
1633
|
Registered typegen plugins:
|
|
1634
1634
|
`);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(`
|
|
1635
1635
|
Disable one in kick.config.ts:
|
|
1636
1636
|
`),console.log(` typegen: { disable: ['`+(r.typegens[0]?.id??`kick/x`)+`'] }
|
|
1637
|
-
`);return}let r=
|
|
1637
|
+
`);return}let r=Hr(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=Ur(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 Se(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 we(a);let r=await zn({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=I(t,e.out??n?.typegen?.outDir??`.kickjs/types`);await _e(i,r,e.silent??!1)}}}catch(e){e instanceof Ce?console.error(`
|
|
1638
1638
|
`+e.message+`
|
|
1639
1639
|
`):e instanceof Cn?console.error(`
|
|
1640
1640
|
`+e.message+`
|
|
1641
|
-
`):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}const
|
|
1642
|
-
`).length:1}function
|
|
1641
|
+
`):e instanceof Error?console.error(`\n kick typegen failed: ${e.message}`):console.error(`\n kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}const Gr=/* @__PURE__ */ new Set([`Service`,`Injectable`,`Component`,`Repository`]);function Kr(e,t){return typeof t==`number`?e.slice(0,t).split(`
|
|
1642
|
+
`).length:1}function qr(e){let t=se(e);if(t===`singleton`||t===`transient`||t===`request`)return t;if(ce(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 Jr(e){let t=D(e);if(t)return{key:`id:${t}`,label:t};let n=se(e);return n===null?null:{key:`lit:${n}`,label:`'${n}'`}}function Yr(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=Ee(e).map(le).find(e=>e?.name===`Inject`),a=null;if(i)a=Jr(i.call.arguments?.[0]);else{let e=n?.typeAnnotation?.typeAnnotation??null;e?.type===`TSTypeReference`&&(a=Jr(e.typeName))}a&&r.push({...a,line:Kr(t,e.start)})}return r}function Xr(e){let t=/* @__PURE__ */ new Map,n=/* @__PURE__ */ new Map,r=[],i=(e,n)=>{t.has(e)||t.set(e,/* @__PURE__ */ new Set),t.get(e).add(n)},a=(e,t)=>{e&&(n.has(e)||n.set(e,/* @__PURE__ */ new Set),n.get(e).add(t))};for(let{path:t,source:n}of e){let e;try{let r=Ke(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`)&&ce(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)}De(e,e=>{if(e.type===`ClassDeclaration`){let a=D(e.id);if(!a)return;for(let o of Ee(e)){let s=le(o);if(s){if(s.name===`Controller`){i(`id:${a}`,`singleton`),r.push({name:a,kind:`controller`,file:t,params:Yr(e,n)});return}if(Gr.has(s.name)){let o=de(Oe(s.call),`scope`),c=o?qr(o):`singleton`;i(`id:${a}`,c),r.push({name:a,kind:`other`,file:t,params:Yr(e,n)});return}}}return}if(e.type!==`CallExpression`)return;let a=e.callee;if(!ce(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=Jr(s[0]);c&&i(c.key,s.length>=3?qr(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 Zr(e){let t=[];if(!O(e))return t;let n=A(e,{withFileTypes:!0});for(let r of n){let n=P(e,r.name);if(r.isDirectory()){if([`node_modules`,`dist`,`.kickjs`,`.git`].includes(r.name))continue;t.push(...Zr(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function Qr(e){try{return k(e,`utf-8`)}catch{return``}}const $r=/* @__PURE__ */ new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function ei(e,t){let n=Qr(P(e,`.env`));if(n){let e=n.match(/^JWT_SECRET\s*=\s*['"]?([^'"\n]*)['"]?/m);if(e){let t=e[1].trim();if($r.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 ti(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 ni(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 ri(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function ii(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 ai(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 oi(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 si(e){let t=Zr(P(e,`src`)).map(e=>Qr(e)),n=[],r=ei(e,t);r&&n.push(r);let i=ti(t);i&&n.push(i);let a=ni(t);a&&n.push(a);let o=ri();o&&n.push(o);let s=ii(t);return s&&n.push(s),n.push(ai(t)),n.push(oi(t)),n}function ci(e){let t=Xr(Zr(P(e,`src`)).filter(e=>!/\.(test|spec)\.tsx?$/.test(e)).map(t=>({path:F(e,t).split(`\\`).join(`/`),source:Qr(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 li(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(`
|
|
1643
1643
|
Usage: kick check [--deploy] [--di]
|
|
1644
1644
|
|
|
1645
1645
|
Available checks:
|
|
1646
1646
|
--deploy Audit for production readiness (security, config, best practices)
|
|
1647
1647
|
--di Find REQUEST-scoped dependencies injected into singleton constructors
|
|
1648
|
-
`);return}let t=process.cwd();te(e.deploy?`KickJS Deploy Check`:`KickJS DI Check`);let n=ne();n.start(`Scanning project...`);let r=[...e.deploy?
|
|
1649
|
-
Install a supported version via nvm / fnm / volta.`}:{name:`Node version`,status:`pass`,message:e}}function
|
|
1648
|
+
`);return}let t=process.cwd();te(e.deploy?`KickJS Deploy Check`:`KickJS DI Check`);let n=ne();n.start(`Scanning project...`);let r=[...e.deploy?si(t):[],...e.di?ci(t):[]];n.stop(`Scan complete`);let i={CRITICAL:0,WARNING:1,INFO:2};r.sort((e,t)=>i[e.severity]-i[t.severity]);for(let e of r)x.message(`${ae(e.severity)} ${e.message}`);let a=r.filter(e=>e.severity===`CRITICAL`).length,o=r.filter(e=>e.severity===`WARNING`).length,s=r.filter(e=>e.severity===`INFO`).length,c=o===1?`warning`:`warnings`,l=[a>0?C.red(`${a} critical`):`${a} critical`,o>0?C.yellow(`${o} ${c}`):`${o} ${c}`,`${s} info`].join(`, `);a>0?(T(C.red(`${l} — fix critical issues before deploying`)),process.exit(1)):T(C.green(`${l} — looking good!`))})}function ui(e){try{return JSON.parse(k(e,`utf-8`))}catch{return null}}function di(e){try{return k(e,`utf-8`)}catch{return null}}function fi(e){let t=e.replace(/\/\*[\s\S]*?\*\//g,``).replace(/(^|[^:"'\\])\/\/.*$/gm,`$1`).replace(/,(\s*[}\]])/g,`$1`);try{return JSON.parse(t)}catch{return null}}function pi(e){let t=P(e,`tsconfig.json`);if(O(t))return mi(t,/* @__PURE__ */ new Set)}function mi(e,t){if(t.has(e)||t.size>=16)return null;t.add(e);let n=di(e);if(n===null)return null;let r=fi(n);if(typeof r!=`object`||!r)return null;let i=Array.isArray(r.extends)?r.extends:typeof r.extends==`string`?[r.extends]:[],a={};for(let n of i){if(typeof n!=`string`)continue;let r=hi(N(e),n);if(!r)continue;let i=mi(r,t);i&&Object.assign(a,i.compilerOptions)}return r.compilerOptions={...a,...r.compilerOptions},r}function hi(e,t){if(t.startsWith(`.`)||t.startsWith(`/`))return gi(I(e,t));let n=e;for(;;){let e=gi(P(n,`node_modules`,t));if(e)return e;let r=N(n);if(r===n)break;n=r}return null}function gi(e){if(O(e)){try{if(Pe(e).isDirectory()){let t=P(e,`tsconfig.json`);return O(t)?t:null}}catch{return null}return e}let t=`${e}.json`;return O(t)?t:null}function _i(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}function vi(){let e=process.version,t=Number.parseInt(e.replace(/^v/,``).split(`.`)[0],10);return Number.isNaN(t)||t<20?{name:`Node version`,status:`fail`,message:e,fix:`KickJS requires Node 20 or newer.
|
|
1649
|
+
Install a supported version via nvm / fnm / volta.`}:{name:`Node version`,status:`pass`,message:e}}function yi(e){if(!e.pkg)return{name:`@forinda/kickjs installed`,status:`warn`,message:`no package.json`};let t={...e.pkg.dependencies,...e.pkg.peerDependencies};return t[`@forinda/kickjs`]?{name:`@forinda/kickjs installed`,status:`pass`,message:t[`@forinda/kickjs`]}:{name:`@forinda/kickjs installed`,status:`fail`,fix:"This directory does not look like a KickJS project — `@forinda/kickjs` is not in your package.json. Run `kick doctor` from the project root, or scaffold a fresh project with `kick new <name>`."}}function bi(e){if(!e.pkg)return null;let t={...e.pkg.dependencies,...e.pkg.peerDependencies};return t[`@forinda/kickjs`]&&!t.express?{name:`express installed`,status:`fail`,fix:"`@forinda/kickjs` declares `express` as a required peer dependency, but your package.json does not include it. Install: pnpm add express"}:t.express?{name:`express installed`,status:`pass`,message:t.express}:null}const xi={express:[],fastify:[`fastify`,`@fastify/middie`],h3:[`h3`]};function Si(e){if(!e.pkg||e.runtime===`express`)return null;let t={...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies},n=xi[e.runtime].filter(e=>!t[e]),r=`runtime engine (${e.runtime})`;return n.length>0?{name:r,status:`fail`,fix:`Resolved runtime '${e.runtime}' is missing engine peer(s): ${n.join(`, `)}.\nInstall: pnpm add ${n.join(` `)}`}:e.runtime===`h3`&&Ci(e.cwd,t.h3)===1?{name:r,status:`fail`,message:`h3 v1`,fix:`This version of @forinda/kickjs runs on h3 v2 only. Upgrade: pnpm add h3@^2 — no code change for apps that only use KickJS APIs.`}:{name:r,status:`pass`}}function Ci(e,t){let n=t;for(let t=I(e);;t=N(t)){try{n=JSON.parse(k(P(t,`node_modules`,`h3`,`package.json`),`utf8`)).version;break}catch{}if(N(t)===t)break}let r=/(\d+)/.exec(n)?.[1];return r===void 0?void 0:Number(r)}function wi(e){if(!e.pkg||!Ei(e.cwd))return null;let t=r[e.runtime],n=`upload driver (${e.runtime})`;return t.prod?{...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies}[t.prod]?{name:n,status:`pass`,message:t.prod}:{name:n,status:`fail`,fix:`This project uses file uploads on the '${e.runtime}' runtime, which needs '${t.prod}'.\nInstall it: kick add upload (or pnpm add ${t.prod})`}:{name:n,status:`pass`,message:`native multipart`}}const Ti=2e3;function Ei(e){let t=P(e,`src`);if(!O(t))return!1;let n=/@FileUpload\b|\bupload\.(single|array|none)\s*\(/,r=[t],i=0;for(;r.length>0&&i<Ti;){let e=r.pop(),t;try{t=A(e,{withFileTypes:!0})}catch{continue}for(let a of t){if(i>=Ti)break;let t=P(e,a.name);if(a.isDirectory())a.name!==`node_modules`&&r.push(t);else if(/\.(ts|tsx|mts|cts)$/.test(a.name)&&(i++,n.test(di(t)??``)))return!0}}return!1}function Di(e){if(!e.pkg)return{name:`reflect-metadata installed`,status:`warn`,message:`no package.json`};let t={...e.pkg.dependencies,...e.pkg.peerDependencies,...e.pkg.devDependencies};return t[`reflect-metadata`]?{name:`reflect-metadata installed`,status:`pass`,message:t[`reflect-metadata`]}:{name:`reflect-metadata installed`,status:`fail`,fix:`KickJS decorators require the reflect-metadata polyfill.
|
|
1650
1650
|
Install it: pnpm add reflect-metadata
|
|
1651
1651
|
Then import it at the top of src/index.ts:
|
|
1652
1652
|
|
|
1653
1653
|
import 'reflect-metadata'
|
|
1654
|
-
// ... rest of bootstrap`}}function
|
|
1654
|
+
// ... rest of bootstrap`}}function Oi(e){if(e.tsconfig===void 0)return[{name:`tsconfig.json present`,status:`fail`,fix:"Create a tsconfig.json with `experimentalDecorators: true` and `emitDecoratorMetadata: true`. `kick new` scaffolds one automatically."}];if(e.tsconfig===null)return[{name:`tsconfig.json readable`,status:`warn`,message:`could not parse tsconfig.json (or a config it extends)`,fix:"Check tsconfig.json for a syntax error, and that every path in its `extends` chain resolves. Decorator options could not be verified."}];let t=e.tsconfig.compilerOptions??{},n=[];return n.push(t.experimentalDecorators===!0?{name:`tsconfig: experimentalDecorators`,status:`pass`}:{name:`tsconfig: experimentalDecorators`,status:`fail`,fix:'Add `"experimentalDecorators": true` to compilerOptions in tsconfig.json. Without it, @Service / @Controller / @Get etc. don\'t register any metadata at compile time.'}),n.push(t.emitDecoratorMetadata===!0?{name:`tsconfig: emitDecoratorMetadata`,status:`pass`}:{name:`tsconfig: emitDecoratorMetadata`,status:`fail`,fix:'Add `"emitDecoratorMetadata": true` to compilerOptions in tsconfig.json. The DI container uses this metadata for constructor-parameter injection.'}),n}function ki(e){let t=[`src/env.ts`,`src/env/index.ts`,`src/config/env.ts`,`src/config/index.ts`].map(t=>P(e.cwd,t)).filter(e=>O(e)).filter(e=>/\bloadEnv\s*\(/.test(di(e)??``));if(t.length===0)return null;let n=[`src/index.ts`,`src/main.ts`].map(t=>P(e.cwd,t)).find(e=>O(e));if(!n)return{name:`env wiring`,status:`warn`,message:`env-init file exists but no src/index.ts or src/main.ts found`};let r=di(n)??``,i=N(n),a=[];for(let e of t){let t=F(i,e).replace(/\\/g,`/`).replace(/\.ts$/,``),n=t.startsWith(`.`)?t:`./`+t,r=n.replace(/\/index$/,``);a.push(n,r);let o=e.replace(/\\/g,`/`).match(/\/src\/(.+?)(?:\.ts)?$/);if(o){let e=`@/`+o[1],t=e.replace(/\/index$/,``);a.push(e,t)}}let o=-1;for(let e of new Set(a)){let t=RegExp(`^import\\s+(?:.*?from\\s+)?['"]${_i(e)}['"]`,`m`),n=r.match(t);n&&n.index!==void 0&&(o===-1||n.index<o)&&(o=n.index)}let s=r.search(/\bbootstrap\s*\(/),c=t.map(t=>F(e.cwd,t).replace(/\\/g,`/`)).join(`, `);return o===-1?{name:`env wiring`,status:`fail`,message:c,fix:`An env-init file (${c}) calls \`loadEnv(...)\` but \`${F(e.cwd,n).replace(/\\/g,`/`)}\` doesn't import it.\nWithout this, ConfigService.get('X') returns undefined while @Value('X') works via process.env fallback — a half-broken config you won't notice until something is missing.\n\nFix: add a side-effect import at the top of ${F(e.cwd,n).replace(/\\/g,`/`)} (above bootstrap()), pointing at one of the detected files. For example:\n\n import './env'\n // or\n import './config'\n // or, with the @/ alias:\n import '@/config/env'`}:s!==-1&&o>s?{name:`env wiring`,status:`warn`,message:`env-init imported AFTER bootstrap() — should be before`,fix:`Move the env import above the bootstrap() call so the schema runs before any service reads from ConfigService.`}:{name:`env wiring`,status:`pass`}}function Ai(e,t=ji){let n=0,r=0,i=[e];for(;i.length>0&&r<t;){let e=i.pop(),a;try{a=A(e,{withFileTypes:!0})}catch{continue}for(let o of a){if(r>=t)break;r++;let a=P(e,o.name);if(o.isDirectory())i.push(a);else try{let e=Pe(a).mtimeMs;e>n&&(n=e)}catch{}}}return n}const ji=2e3;function Mi(e){let t=P(e.cwd,`.kickjs`,`types`);if(!O(t))return null;let n=Ai(t);if(n===0)return null;let r=Date.now()-n,i=Math.floor(r/6e4);return i>60?{name:`typegen freshness`,status:`warn`,message:`last updated ${i} minutes ago`,fix:"Re-run `kick typegen` (or `kick dev`, which runs it on every reload) so generated types match the current code."}:{name:`typegen freshness`,status:`pass`,message:i===0?`just now`:`${i}m ago`}}const Ni=[`vitest.config.ts`,`vitest.config.js`,`vitest.config.mts`,`vite.config.ts`,`jest.config.ts`,`jest.config.js`],Pi=[`.env.test`,`.env.test.local`],Fi=[`.env`,`.env.local`];function Ii(e){let t=e.pkg?.scripts;if(t&&typeof t==`object`)for(let[e,n]of Object.entries(t)){if(!e.startsWith(`test`)||typeof n!=`string`)continue;let t=/KICKJS_ENV_FILE=(\S+)/.exec(n);if(t?.[1])return t[1]}return process.env.KICKJS_ENV_FILE??null}function Li(e){if(!Ni.some(t=>O(P(e.cwd,t))))return null;let t=Fi.filter(t=>O(P(e.cwd,t)));if(t.length===0)return null;let n=Pi.filter(t=>O(P(e.cwd,t)));if(n.length>0){let t=Ii(e);return t&&t!==`off`&&t!==`none`?{name:`test env isolation`,status:`warn`,message:`${n.join(`, `)} present, but KICKJS_ENV_FILE=${t} overrides it`,fix:`KICKJS_ENV_FILE is checked before test-mode isolation, so ${n[0]} is\nignored and "${t}" is read instead. Drop the override to use the\ntest files, or set KICKJS_ENV_FILE=off if env comes from the runner.`}:{name:`test env isolation`,status:`pass`,message:`${n.join(`, `)} present`}}return{name:`test env isolation`,status:`warn`,message:`${t.join(`, `)} present, no .env.test`,fix:`Under NODE_ENV=test (or vitest's VITEST) KickJS reads .env.test / .env.test.local
|
|
1655
1655
|
INSTEAD of ${t.join(` and `)} — no layering, no fallback. Without one of\nthose files, every var your test config does not pin resolves from your
|
|
1656
1656
|
development env — including DATABASE_URL and any third-party credentials.
|
|
1657
1657
|
|
|
1658
1658
|
Create .env.test (cp .env.test.example .env.test, if the project has one)
|
|
1659
1659
|
holding the whole environment the suite should run against
|
|
1660
1660
|
(a var you leave out is then missing, not inherited), or set KICKJS_ENV_FILE=off
|
|
1661
|
-
and supply env from the test runner.`}}const
|
|
1661
|
+
and supply env from the test runner.`}}const Ri=[()=>vi(),yi,bi,Si,wi,Di,Oi,ki,Li,Mi];async function zi(e,t={}){let n={cwd:e,pkg:ui(P(e,`package.json`)),tsconfig:pi(e),runtime:t.runtime??`express`},r=[...Ri,...t.extraChecks??[]],i=[];for(let e of r){let t;try{t=await e(n)}catch(t){i.push({name:e.name||`doctor check`,status:`fail`,message:t instanceof Error?t.message:String(t)});continue}t!=null&&(Array.isArray(t)?i.push(...t):i.push(t))}return i}function Bi(e){switch(e){case`pass`:return C.green(`✔`);case`warn`:return C.yellow(`⚠`);case`fail`:return C.red(`✖`)}}function Vi(e){let t=Bi(e.status),n=e.message?` ${C.dim(`(${e.message})`)}`:``;return`${t} ${e.name}${n}`}function Hi(e){return e.split(`
|
|
1662
1662
|
`).map(e=>` ${C.dim(`→`)} ${e}`).join(`
|
|
1663
|
-
`)}function
|
|
1663
|
+
`)}function Ui(e){return e?.doctor?.checks??[]}function Wi(e){e.command(`doctor`).description(`Pre-flight checks for your KickJS project (dev environment health)`).action(async()=>{let e=process.cwd(),n=Ui(await l(e)),r=await t(e);te(`KickJS Doctor`);let i=await zi(e,{extraChecks:n,runtime:r});for(let e of i)x.message(Vi(e)),e.fix&&e.status!==`pass`&&x.message(Hi(e.fix));let a=i.filter(e=>e.status===`pass`).length,o=i.filter(e=>e.status===`warn`).length,s=i.filter(e=>e.status===`fail`).length,c=[C.green(`${a} passed`),o>0?C.yellow(`${o} warning${o===1?``:`s`}`):`${o} warnings`,s>0?C.red(`${s} error${s===1?``:`s`}`):`${s} errors`].join(`, `);s>0?(T(`${c} — fix the errors above before running the app`),process.exit(1)):T(o>0?`${c} — review the warnings`:C.green(`${c} — your environment looks good`))})}const Gi=Symbol.for(`kickjs.handler.entryCapture`),Ki=Symbol.for(`kickjs.config.describe`);function qi(e){return Array.isArray(e)?e.join(`,`):typeof e==`object`&&e||typeof e==`string`&&/[\r\n]/.test(e)?JSON.stringify(e):String(e)}function Ji(e){let t=[];for(let n of e){let e=[n.description,n.list?`comma-separated list`:void 0].filter(Boolean);for(let n of e.length>0?e.join(` — `).split(/\r?\n/):[])t.push(`# ${n}`);n.required?t.push(`${n.name}=`):t.push(`# ${n.name}=${n.default===void 0?``:qi(n.default)}`)}return t}function Yi(e){let t=[`# Generated by \`kick env example\` from the env schema and the declared settings
|
|
1664
|
+
# sections. Re-run it after changing them; \`kick env example --check\` fails when stale.
|
|
1665
|
+
#
|
|
1666
|
+
# Uncommented variables are required. Commented ones are optional; the value shown
|
|
1667
|
+
# is the default. Any variable can come from a file instead: NAME_FILE=/run/secrets/name`];e.env.length>0&&t.push([`# ── App env schema ──`,...Ji(e.env)].join(`
|
|
1668
|
+
`));for(let n of e.sections)t.push([`# ── ${n.prefix} settings (declared by ${n.declaredBy}) ──`,...Ji(n.vars)].join(`
|
|
1669
|
+
`));return`${t.join(`
|
|
1670
|
+
|
|
1671
|
+
`)}\n`}async function Xi(e,t){let n=I(e,t);if(!O(n))throw Error(`${t} not found`);let r=I(e,`vite.config.ts`);if(!O(r))throw Error(`vite.config.ts not found — kick env example loads the app through it`);let{createRequire:i}=await import(`node:module`),a=i(I(e,`package.json`)),{createServer:o}=await import(R(a.resolve(`vite`)).href),s=globalThis,c;s[Gi]=e=>{c??=e},s[Ki]=!0,s[Vn]=`kick-env`;let l=await o({configFile:r,root:e,logLevel:`error`,appType:`custom`,server:{middlewareMode:!0,hmr:!1,watch:null}});try{await l.ssrLoadModule(n)}finally{delete s[Gi],delete s[Ki],delete s[Vn],await l.close()}if(!c)throw Error(`${t} finished loading without calling bootstrap()`);return c.describeConfig()}function Zi(e){e.command(`env`).description(`Work with the environment the app reads`).command(`example`).description(`Write .env.example from the env schema and declared settings sections`).option(`-e, --entry <file>`,`App entry that calls bootstrap()`,`src/index.ts`).option(`-o, --out <file>`,`File to write`,`.env.example`).option(`--check`,`Exit 1 if the file is missing or out of date, instead of writing it`).action(async e=>{let t=process.cwd(),n=I(t,e.out),r;try{r=Yi(await Xi(t,e.entry))}catch(e){console.error(`\n kick env example: ${e.message}\n`),process.exit(1)}e.check?((O(n)?k(n,`utf8`):void 0)!==r&&(console.error(`\n ${e.out} is out of date — run \`kick env example\`.\n`),process.exit(1)),console.log(` ${e.out} is up to date.`)):(j(n,r),console.log(` Wrote ${e.out}`))})}function Qi(e){return e.optsWithGlobals().dryRun??!1}function $i(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.
|
|
1664
1672
|
Direction defaults to \`modules.style\` from kick.config (or "define").
|
|
1665
1673
|
--target define|class Override the migration direction.
|
|
1666
1674
|
--apply Apply the changes (default: dry-run preview).
|
|
1667
|
-
--experimental Acknowledge that AST migration is experimental.`).option(`--modules-dir <dir>`,`Modules directory (default: src/modules from kick.config)`).option(`--apply`,`Apply the migration to disk (default: dry-run)`).option(`--experimental`,`Acknowledge that this command is experimental`).option(`--target <style>`,`Migration direction — 'define' or 'class'`).option(`--no-backup`,`Skip the .kickjs/codemod-backups/ snapshot (default: backup on)`).action(async(e,t)=>{let n=
|
|
1675
|
+
--experimental Acknowledge that AST migration is experimental.`).option(`--modules-dir <dir>`,`Modules directory (default: src/modules from kick.config)`).option(`--apply`,`Apply the migration to disk (default: dry-run)`).option(`--experimental`,`Acknowledge that this command is experimental`).option(`--target <style>`,`Migration direction — 'define' or 'class'`).option(`--no-backup`,`Skip the .kickjs/codemod-backups/ snapshot (default: backup on)`).action(async(e,t)=>{let n=Qi(t)||!e.apply;v(n),e.experimental||(console.error(`
|
|
1668
1676
|
`+C.red(`Error:`)+` kick codemod modules is experimental — pass --experimental to acknowledge.
|
|
1669
1677
|
The regex-based rewrite handles the shapes our templates produce.
|
|
1670
1678
|
Hand-rolled modules with non-standard structures may be skipped.
|
|
1671
1679
|
Always commit before running with --apply.
|
|
1672
|
-
`),process.exit(1));let r=await l(process.cwd()),i=p(r),a=
|
|
1680
|
+
`),process.exit(1));let r=await l(process.cwd()),i=p(r),a=I(e.modulesDir??i.dir??`src/modules`),o;e.target===`define`||e.target===`class`?o=e.target:e.target===void 0?o=i.style??`define`:(console.error(`\n ${C.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let s=C.dim(`→ ${o}`),c=n?C.dim(`(dry-run)`):C.bold(`(applying)`);console.log(`\n ${C.bold(`kick codemod modules`)} ${s} ${c}`),console.log(` modulesDir: ${C.dim(a)}\n`);let u=e.backup!==!1&&!n,d=await pn(a,{dryRun:n,target:o,backup:u});if(d.backupDir){let e=d.backupDir;console.log(` ${C.green(`✓`)} backup: ${C.dim(e)}\n ${C.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else!n&&e.backup===!1&&console.log(` ${C.dim(`(--no-backup — skipping snapshot)`)}\n`);let f=0,m=0;for(let e of d.files)if(e.status===`migrated`)f++,console.log(` ${C.green(`✓`)} ${e.path}`);else{m++;let t=C.dim(`(${e.reason??`skipped`})`);console.log(` ${C.dim(`-`)} ${e.path} ${t}`)}if(console.log(),d.indexStatus===`migrated`)console.log(` ${C.green(`✓`)} ${d.indexPath}`);else if(d.indexStatus===`skipped`){let e=C.dim(`(${d.indexReason??`skipped`})`);console.log(` ${C.dim(`-`)} ${d.indexPath} ${e}`)}else console.log(` ${C.dim(`-`)} ${d.indexPath} ${C.dim(`(not found)`)}`);let h=n?C.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n ${C.bold(String(f))} migrated, ${C.bold(String(m))} skipped${h}\n`)})}function ea(e){try{let t=JSON.parse(k(I(e,`package.json`),`utf-8`));return{...t.dependencies,...t.devDependencies}}catch{return{}}}function ta(e,t=O,n=ea(e)){if(n[`@forinda/kickjs-inertia`])return{staticDir:`dist/client`,siteRoot:`.`,apiPath:``,include:[`dist/client/.vite/manifest.json`,`dist/ssr`]};let r=N(e);return(t(I(r,`pnpm-workspace.yaml`))||t(I(r,`package.json`)))&&t(I(r,`web`,`package.json`))?{staticDir:`../web/dist`,siteRoot:`..`,apiPath:`/api`}:{siteRoot:`.`,apiPath:``}}function na(e,t,n,r){let i=ta(t,n,r),a=e?.staticDir===!1?void 0:e?.staticDir??i.staticDir;return{entry:e?.entry??`src/serverless.ts`,outDir:e?.outDir??`dist/serverless`,staticDir:a,siteRoot:e?.siteRoot??i.siteRoot,publishDir:e?.publishDir??`dist/public`,apiPath:e?.apiPath??i.apiPath,external:e?.external??[`valibot`,`yup`],vercelRuntime:e?.vercelRuntime??`nodejs22.x`,include:e?.include??i.include??[]}}function ra(e,t,n={projectDir:`.`}){let r=[` path: '${t}/*',`,...n.preferStatic?[` preferStatic: true,`]:[],...n.includedFiles?.length?[` includedFiles: ${JSON.stringify(n.includedFiles)},`]:[]];return`import { fileURLToPath } from 'node:url'
|
|
1673
1681
|
import { handler } from '${e}'
|
|
1674
1682
|
|
|
1675
1683
|
// Where the app's build files were packaged; the platform starts this
|
|
@@ -1683,7 +1691,7 @@ export const config = {
|
|
|
1683
1691
|
${r.join(`
|
|
1684
1692
|
`)}
|
|
1685
1693
|
}
|
|
1686
|
-
`}function
|
|
1694
|
+
`}function ia(){return`import { fileURLToPath } from 'node:url'
|
|
1687
1695
|
import { handler } from './server.mjs'
|
|
1688
1696
|
|
|
1689
1697
|
// The app's build files are copied into this function at their project
|
|
@@ -1693,11 +1701,11 @@ process.env.KICK_APP_ROOT ??= fileURLToPath(new URL('./', import.meta.url))
|
|
|
1693
1701
|
const requestContext = () => globalThis[Symbol.for('@vercel/request-context')]?.get?.()
|
|
1694
1702
|
|
|
1695
1703
|
export default (req, res) => handler.node(req, res, requestContext())
|
|
1696
|
-
`}function
|
|
1697
|
-
`).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
|
|
1704
|
+
`}function aa(e){return/^\s*publish\s*=\s*["']([^"']+)["']/m.exec(e)?.[1]?.replace(/^\.\//,``).replace(/\/+$/,``)}function oa(e,t,n=!1){let r=[{handle:`filesystem`},{src:`^${e}/(.*)$`,dest:`/api`}];return n&&e!==``&&r.push({src:`^/_kick/(.*)$`,dest:`/api`}),t&&e!==``&&r.push({src:`^/(.*)$`,dest:`/index.html`}),r}function sa(e,t){let n;try{n=Ke(t,e).program}catch{return[]}let r=[],i=t=>e.slice(0,t).split(`
|
|
1705
|
+
`).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 ca(e){let t=I(e,`src`);return O(t)?A(t,{recursive:!0,encoding:`utf-8`}).filter(e=>/\.m?ts$/.test(e)&&!/\.(test|spec|d)\.m?ts$/.test(e)).flatMap(e=>{let n=k(I(t,e),`utf-8`);return n.includes(`@Cron`)?sa(n,`src/${e}`):[]}):[]}function la(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 ua(e){let t=[],n=/* @__PURE__ */ 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,` `);i.split(` `).length===5?n.set(la(i),i):t.push(`${e}: Vercel crons need a five-field expression, so it has no Vercel cron entry`)}return{crons:[...n].map(([e,t])=>({path:`/_kick/cron/${e}`,schedule:t})),warnings:t}}function da(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 fa(e,t){let{createRequire:n}=await import(`node:module`),r=n(I(e,`package.json`)),i;try{i=r.resolve(`${t}/package.json`)}catch{i=I(e,`node_modules`,t,`package.json`)}if(!O(i))throw Error(`${t} is not installed in this project. Run: pnpm add -D vite unplugin-swc @forinda/kickjs-vite`);let a=da(JSON.parse(k(i,`utf-8`)));if(!a)throw Error(`${t} has no importable entry point`);return import(R(I(N(i),a)).href)}async function pa(e,t,n){let r=I(e,t.entry);if(!O(r))throw Error(`${t.entry} not found. The serverless entry exports \`handler = createHandler({ modules })\` — see the Serverless guide.`);let{build:i}=await fa(e,`vite`),{default:a}=await fa(e,`unplugin-swc`),{devtoolsFlagPlugin:o,devtoolsStripPlugin:s}=await fa(e,`@forinda/kickjs-vite`);await i({configFile:!1,root:e,logLevel:`warn`,oxc:!1,plugins:[a.vite(),o(),s()],resolve:{alias:{"@":I(e,`src`)}},ssr:{noExternal:!0,target:`node`},build:{ssr:!0,target:`node20`,outDir:I(e,t.outDir),emptyOutDir:!0,minify:!1,rollupOptions:{input:r,external:(n,r)=>ha(n,r?N(r):e)||t.external.includes(n)&&!O(I(e,`node_modules`,n)),output:{format:`esm`,entryFileNames:`server.mjs`,codeSplitting:!1}}}});let c=I(e,t.outDir,`server.mjs`);return n(`bundled ${F(process.cwd(),c)}`),c}function ma(e){return/^((?:@[a-z0-9][\w.-]*\/)?[a-z0-9][\w.-]*)(?:\/|$)/i.exec(e)?.[1]}function ha(e,t,n=O){let r=ma(e);if(!r)return!1;for(let e=t;;e=N(e)){if(n(I(e,`node_modules`,r,`package.json`)))return!1;if(N(e)===e)return!0}}function ga(e,t){let n=F(e,t).split(L)[0];return n!==void 0&&n.startsWith(`.`)}function _a(e){return e.flatMap(e=>[`/${e} /404 404!`,`/${e}/* /404 404!`])}function va(e){try{return Pe(e)}catch{return}}function ya(e,t){let n=t.filter(t=>!O(I(e,t)));if(n.length>0)throw Error(`${n.join(`, `)} not found — the function reads ${n.length===1?`it`:`them`} at runtime. Run the full build first (\`pnpm build\`), or fix \`deploy.include\`.`)}function ba(e,t){let n=t.projectRoot,r=()=>na(t.config?.deploy,n);e.command(`build:netlify`).description(`Bundle the serverless entry and write the Netlify function`).action(async()=>{let e=r();ya(n,e.include);let i=await pa(n,e,t.log),a=I(n,e.siteRoot),o=ca(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=I(a,`.netlify/v1/functions`);Me(s,{recursive:!0});let c=F(s,i).split(L).join(`/`),l=e=>e.split(L).join(`/`);j(I(s,`api.mjs`),ra(c,e.apiPath,{projectDir:l(F(s,n)),preferStatic:e.apiPath===``&&!!e.staticDir,includedFiles:e.include.flatMap(e=>{let t=l(F(s,I(n,e)));return va(I(n,e))?.isDirectory()?[`${t}/**`]:[t]})})),t.log(`wrote ${F(process.cwd(),I(s,`api.mjs`))}`);let u=e.staticDir??e.publishDir;if(!e.staticDir)Me(I(n,u),{recursive:!0}),t.log(`publish directory ready at ${F(process.cwd(),I(n,u))}`);else if(O(I(n,u))){let e=A(I(n,u)).filter(e=>e.startsWith(`.`));if(e.length>0){let t=I(n,u,`_redirects`),r=O(t)?k(t,`utf-8`):``,i=_a(e).filter(e=>!r.includes(e));i.length>0&&j(t,`${r}${r&&!r.endsWith(`
|
|
1698
1706
|
`)?`
|
|
1699
1707
|
`:``}${i.join(`
|
|
1700
|
-
`)}\n`)}}let d=
|
|
1708
|
+
`)}\n`)}}let d=I(a,`netlify.toml`);if(O(d)){let e=aa(k(d,`utf-8`)),r=F(a,I(n,u)).split(L).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();ya(n,e.include);let i=await pa(n,e,t.log),a=I(n,e.siteRoot),o=e.staticDir?I(n,e.staticDir):void 0,s=I(a,`.vercel/output`),c=I(s,`functions/api.func`);Ne(s,{recursive:!0,force:!0}),Me(c,{recursive:!0}),je(i,I(c,`server.mjs`)),j(I(c,`index.mjs`),ia());for(let t of e.include)je(I(n,t),I(c,t),{recursive:!0});if(j(I(c,`.vc-config.json`),`${JSON.stringify({runtime:e.vercelRuntime,handler:`index.mjs`,launcherType:`Nodejs`,supportsResponseStreaming:!0},null,2)}\n`),o){if(!O(o))throw Error(`build:vercel: ${e.staticDir} does not exist — build the frontend first`);je(o,I(s,`static`),{recursive:!0,filter:e=>!ga(o,e)})}let{crons:l,warnings:u}=ua(ca(n));for(let e of u)t.log(`warning: ${e}`);let d={version:3,routes:oa(e.apiPath,!!o,l.length>0),...l.length>0?{crons:l}:{}};j(I(s,`config.json`),`${JSON.stringify(d,null,2)}\n`),t.log(`wrote ${F(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 xa=()=>({id:`kick/assets`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`],async generate(e){let t=M.resolve(e.cwd,`kick.config.ts`);if(!O(t))return null;let n=await l(e.cwd);if(!n?.assetMap)return null;let r=ue(n.assetMap,e.cwd);return r.count===0?null:be(r)}}),Sa="/* 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 Ca(e,t,n,r={}){if(e.length===0)return`${Sa}
|
|
1701
1709
|
// (no routes discovered yet — annotate a controller method with
|
|
1702
1710
|
// @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
|
|
1703
1711
|
declare global {
|
|
@@ -1714,37 +1722,38 @@ declare global {
|
|
|
1714
1722
|
|
|
1715
1723
|
/** Empty until the first route exists — see kick typegen. */
|
|
1716
1724
|
export const kickRpc = {} as const
|
|
1717
|
-
`;let i=/* @__PURE__ */ new Map;for(let t of e){let e=i.get(t.controller)??[];e.push(t),i.set(t.controller,e)}let a=/* @__PURE__ */ new Map,o=/* @__PURE__ */ 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=
|
|
1718
|
-
`))}let u=[],d=/* @__PURE__ */ new Set,f=/* @__PURE__ */ 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}`;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.`):(d.add(t),f.add(`${e}.${n.method}`),u.push(` '${t}': ${e}['${n.method}']`))}let p=[` interface Api {`,...u,` }`].join(`
|
|
1719
|
-
`);l.push(p);let m=[]
|
|
1720
|
-
`)
|
|
1721
|
-
`)
|
|
1725
|
+
`;let i=/* @__PURE__ */ new Map;for(let t of e){let e=i.get(t.controller)??[];e.push(t),i.set(t.controller,e)}let a=/* @__PURE__ */ new Map,o=/* @__PURE__ */ 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=Da(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??Ta(e),u=c(e.responseSchema??null,e,`response`),d=s(e),f=u??`import('@forinda/kickjs').InferHandlerResponse<${d}['${e.method}']>`,p=Ea(e);n.push(` /**`,` * ${e.httpMethod} ${e.path}`,...p.map(e=>` * ${e}`),` */`,` ${e.method}: {`,` params: ${a}`,` body: ${o}`,` query: ${l}`,` response: ${f}`,` contextKeys: ${wa(e)}`,` }`)}n.push(` }`),l.push(n.join(`
|
|
1726
|
+
`))}let u=[],d=/* @__PURE__ */ new Set,f=/* @__PURE__ */ new Set;i.has(`Named`)&&r.onWarn?.(`controller class 'Named' collides with the reserved KickRoutes.Named route-name map — its interface declaration-merges into it. Rename the controller.`),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}`;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.`):(d.add(t),f.add(`${e}.${n.method}`),u.push(` '${t}': ${e}['${n.method}']`))}let p=[` interface Api {`,...u,` }`].join(`
|
|
1727
|
+
`);l.push(p);let m=[];for(let[e,t]of i)for(let n of t)f.has(`${e}.${n.method}`)&&m.push(` '${e}.${n.method}': ${e}['${n.method}']`);l.push([` interface Named {`,...m,` }`].join(`
|
|
1728
|
+
`));let h=[],g=/* @__PURE__ */ new Set;for(let[e,t]of i){let n=Aa(e);if(g.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}g.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&&h.push(` ${n}: {\n${i.join(`
|
|
1729
|
+
`)}\n },`)}let _=[`/**`,` * Runtime route manifest for the tRPC-style sugar:`," * `createRpc(api, kickRpc)` from @forinda/kickjs-client.",` */`,`export const kickRpc = {`,...h,`} as const`].join(`
|
|
1730
|
+
`),v=[],y=/* @__PURE__ */ new Map;for(let t of e)y.set(`${t.filePath}::${t.controller}`,t);for(let[e,n]of o){let r=y.get(e),i=ka(``,r.filePath,t),a=r.controllerIsDefaultExport?`default as ${n}`:`${r.controller} as ${n}`;v.push(`import type { ${a} } from '${i}'`)}let b=v.length>0?v.join(`
|
|
1722
1731
|
`)+`
|
|
1723
|
-
`:``,
|
|
1724
|
-
`);return`${
|
|
1732
|
+
`:``,x=Oa(a)+b,S=l.join(`
|
|
1733
|
+
`);return`${Sa}${x}
|
|
1725
1734
|
declare global {
|
|
1726
1735
|
// eslint-disable-next-line @typescript-eslint/no-namespace
|
|
1727
1736
|
namespace KickRoutes {
|
|
1728
|
-
${
|
|
1737
|
+
${S}
|
|
1729
1738
|
}
|
|
1730
1739
|
|
|
1731
1740
|
/** Short alias for \`KickRoutes.Api\` — \`createClient<KickApi>(...)\`. */
|
|
1732
1741
|
type KickApi = KickRoutes.Api
|
|
1733
1742
|
}
|
|
1734
1743
|
|
|
1735
|
-
${
|
|
1736
|
-
`}function
|
|
1744
|
+
${_}
|
|
1745
|
+
`}function wa(e){let t=e.contextKeys;return t==null?`string`:t.length===0?`never`:t.map(e=>JSON.stringify(e)).join(` | `)}function Ta(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 Ea(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 Da(e,t,n,r,i){if(!e||r===!1||e.source===null)return null;let a=ka(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 Oa(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(`
|
|
1737
1746
|
`)+`
|
|
1738
|
-
`}function
|
|
1739
|
-
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 '${
|
|
1747
|
+
`}function ka(e,t,n){if(e===null)return`unknown`;let r=N(n);if(e===``){let e=F(r,t).split(L).join(`/`);return e=e.replace(/\.(ts|tsx|mts|cts)$/i,``),e.startsWith(`.`)||(e=`./`+e),e}if(!e.startsWith(`.`)&&!e.startsWith(`/`))return e;let i=N(t),a=I(i,e),o=F(r,a).split(L).join(`/`);return o=o.replace(/\.(ts|tsx|mts|cts)$/i,``),o.startsWith(`.`)||(o=`./`+o),o}function Aa(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 ja=()=>({id:`kick/routes`,outExtension:`.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){let t=await e.getScanResult({root:Ma(e),cwd:e.cwd,envFile:Na(e)}),n=e.config?.typegen?.schemaValidator??`zod`,r=M.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return Ca(t.routes,r,n,{onWarn:t=>e.log.warn(t)})}});function Ma(e){return M.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Na(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}const Pa=`@typescript/typescript6`;function Fa(e){return typeof e?.createProgram==`function`}function Ia(e){if(Fa(e.typescript))return{api:e.typescript,source:`typescript`};if(Fa(e.ts6))return{api:e.ts6,source:Pa};let t=`Install it in the project:\n pnpm add -D ${Pa}`;throw e.typescript?Error(`kick typegen: the client route map needs a TypeScript compiler API.
|
|
1748
|
+
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 '${Pa}' resolved from this project.\n ${t}`)}async function La(e){let t=Ae(P(e,`package.json`)),n=async e=>{try{return await import(R(t.resolve(e)).href)}catch{return null}},[r,i]=await Promise.all([n(`typescript`),n(Pa)]);return Ia({typescript:Ra(r),ts6:Ra(i)}).api}function Ra(e){let t=e;return t?.default&&typeof t.default==`object`?t.default:e}const za=Symbol(`kick/client: expansion budget exhausted`);var Ba=class{ts;checker;program;opts;get printFlags(){return this.ts.TypeFormatFlags.NoTruncation}hoistedByType=/* @__PURE__ */ new Map;inProgress=/* @__PURE__ */ new Map;jsonInProgress=/* @__PURE__ */ 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;let t=this.blocks.length,n=this.nextName,r=new Set(this.hoistedByType.keys());try{return this.render(e,0)}catch(e){if(e!==za)throw e;this.blocks.length=t,this.nextName=n;for(let e of this.hoistedByType.keys())r.has(e)||this.hoistedByType.delete(e);return this.opts.onWarn?.(`expansion abandoned after ${this.budget} depth hoists — emitting 'unknown'. Either the response type never repeats (a generic that grows at every level) or it nests more distinct types than the budget allows; raising maxDepth hoists fewer of them. Declare a response schema on the route for an exact type.`),`unknown`}}render(e,t,n=!0){let r=this.ts.TypeFlags;if(n){let t=this.hoistedByType.get(e);if(t)return t}if(t>this.maxDepth&&!this.isLeaf(e))return this.hoistDeep(e);if(e.flags&(r.String|r.Number|r.Boolean|r.BigInt|r.ESSymbol)||e.flags&(r.Any|r.Unknown|r.Never|r.Void|r.Undefined|r.Null)||e.isLiteral()||e.flags&r.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 i=this.arrayElement(e);if(i){let e=this.render(i.element,t+1),n=/[|&]/.test(e)?`(${e})[]`:`${e}[]`;return i.readonly?`readonly ${n}`:n}let a=this.toJsonType(e);if(a){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(a,t)}finally{this.jsonInProgress.delete(e)}}return this.isLibType(e)?this.renderLibType(e,t):e.flags&r.Object?this.renderObject(e,t):(this.opts.onWarn?.(`could not expand type '${this.checker.typeToString(e)}' — emitting 'unknown'`),`unknown`)}isLeaf(e){let t=this.ts.TypeFlags;return(e.flags&(t.String|t.Number|t.Boolean|t.BigInt|t.ESSymbol|t.Any|t.Unknown|t.Never|t.Void|t.Undefined|t.Null|t.BooleanLiteral))!==0||e.isLiteral()}hoistDeep(e){if(++this.truncations>this.budget)throw za;let t=this.allocName();this.hoistedByType.set(e,t);let n=this.blocks.length;return this.blocks.push(``),this.blocks[n]=this.isPlainObject(e)?`interface ${t} {\n${this.members(e,0,` `)}\n}`:`type ${t} = ${this.render(e,0,!1)}`,t}isPlainObject(e){return(e.flags&this.ts.TypeFlags.Object)!==0&&!e.isUnionOrIntersection()&&!this.isTuple(e)&&!this.arrayElement(e)&&!this.toJsonType(e)&&!this.isLibType(e)}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=`
|
|
1740
1749
|
`){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===`
|
|
1741
1750
|
`?`
|
|
1742
|
-
`: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
|
|
1743
|
-
`));for(let n of
|
|
1744
|
-
`);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
|
|
1751
|
+
`: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 Va=[`pnpm-lock.yaml`,`package-lock.json`,`yarn.lock`,`bun.lock`,`bun.lockb`],Ha=/(?:^|[\\/])(?:node_modules|\.kickjs)(?:[\\/]|$)/;function Ua(e){return Ge(`sha1`).update(e).digest(`hex`)}function Wa(e){let t=Ge(`sha1`);t.update(e.cliVersion),t.update(JSON.stringify(e.options??{})),t.update(e.keys.join(`
|
|
1752
|
+
`));for(let n of Va){let r=P(e.projectDir,n);if(O(r))try{t.update(k(r))}catch(e){throw Error(`kick/client: cannot read lockfile ${r}`,{cause:e})}}for(let n of e.fileNames.toSorted())if(!Ha.test(n)){t.update(n);try{t.update(k(n))}catch(e){throw Error(`kick/client: cannot read project file ${n}`,{cause:e})}}return t.digest(`hex`)}async function Ga(e){try{let t=await La(e.compilerFrom??e.projectDir),n={...t.sys,onUnRecoverableConfigFileDiagnostic:()=>{}},r=t.getParsedCommandLineOfConfigFile(P(e.projectDir,`tsconfig.json`),{},n);return r?Wa({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 Ka(e){let t=await La(e.compilerFrom??e.projectDir),n=P(N(e.routesFile),`__kick_client_probe__.ts`),r=Ya(e.routesFile,e.keys),i=Qa(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.`);qa(t,i,e.routesFile);let s=Xa(t,i,o,e.keys),c=null,l=new Ba(t,a,i,{maxDepth:e.maxDepth,onWarn:t=>e.onWarn?.(c?`route '${c}': ${t}`:t)}),u=/* @__PURE__ */ 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===Ja(n));if(!i){e.onWarn?.(`route '${r}' could not be resolved — skipped.`);continue}let d=a.getTypeAtLocation(i.type);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.`):(c=r,u.set(r,l.expand(d)),c=null)}return{entries:u,hoisted:l.hoisted()}}function qa(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(`
|
|
1753
|
+
`);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 Ja(e){return`_K${e}`}function Ya(e,t){let n=`./`+Fe(e).replace(/\.tsx?$/,``),r=t.map((e,t)=>`type ${Ja(t)} = KickRoutes.Api[${JSON.stringify(e)}]`);return[`import ${JSON.stringify(n)}`,...r].join(`
|
|
1745
1754
|
`)+`
|
|
1746
|
-
`}function
|
|
1747
|
-
`))}},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:[...
|
|
1755
|
+
`}function Xa(e,t,n,r){let i=/* @__PURE__ */ new Set,a=/* @__PURE__ */ 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(Ja(t));r&&e.start>=r.getStart(n)&&e.start<r.getEnd()&&i.add(o)}return i}function Za(e,t){let n=e.filter(e=>/\.d\.(ts|mts|cts)$/.test(e)),r=[];try{r=A(t).filter(e=>e.endsWith(`.ts`)).map(e=>P(t,e))}catch{}return[.../* @__PURE__ */ new Set([...n,...r])]}function Qa(e,t,n,r){let i=P(t,`tsconfig.json`),a={...e.sys,onUnRecoverableConfigFileDiagnostic:t=>{throw Error(e.flattenDiagnosticMessageText(t.messageText,`
|
|
1756
|
+
`))}},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:[...Za(o.fileNames,N(n)),n],options:o.options,host:s})}const $a=`/* eslint-disable */
|
|
1748
1757
|
// AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
|
|
1749
1758
|
//
|
|
1750
1759
|
// Self-contained: this file has no imports, so a frontend consumes it without
|
|
@@ -1758,7 +1767,7 @@ ${g}
|
|
|
1758
1767
|
//
|
|
1759
1768
|
// Written when \`kick dev\` starts, not on save — resolving these types builds a
|
|
1760
1769
|
// full TypeScript program over the server. Re-run \`kick typegen\`.
|
|
1761
|
-
`;function
|
|
1770
|
+
`;function eo(e,t){let n=t.filter(t=>e.entries.has(t));if(n.length===0)return`${$a}
|
|
1762
1771
|
// (no routes discovered yet — annotate a controller method with
|
|
1763
1772
|
// @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
|
|
1764
1773
|
interface Api {}
|
|
@@ -1775,7 +1784,7 @@ export type { Api }
|
|
|
1775
1784
|
|
|
1776
1785
|
`)+`
|
|
1777
1786
|
|
|
1778
|
-
`:``,i=n.map(t=>` ${JSON.stringify(t)}: ${e.entries.get(t)}`);return`${
|
|
1787
|
+
`:``,i=n.map(t=>` ${JSON.stringify(t)}: ${e.entries.get(t)}`);return`${$a}
|
|
1779
1788
|
${r}interface Api {
|
|
1780
1789
|
${i.join(`
|
|
1781
1790
|
`)}
|
|
@@ -1789,7 +1798,7 @@ declare global {
|
|
|
1789
1798
|
}
|
|
1790
1799
|
|
|
1791
1800
|
export type { Api }
|
|
1792
|
-
`}const
|
|
1801
|
+
`}const to=`kick/client`,$=`.kickjs/types/kick__client.d.ts`,no=`.kickjs/cache/client-map.sha1`,ro=(()=>{try{return Ae(import.meta.url)(`../../../package.json`).version??`0.0.0`}catch{return`0.0.0`}})();function io(e){try{if(!O(e))return null;let[t,n]=k(e,`utf-8`).trim().split(/\s+/);return t&&n?{inputs:t,output:n}:null}catch{return null}}function ao(e){return`${Pn}${to} */\n\n${e}\n`}function oo(e){try{return O(e)?k(e,`utf-8`):null}catch{return null}}async function so(e){let t=M.resolve(e.cwd,$);if(!O(t))return!1;try{await Ue(t,{force:!0})}catch(t){return e.log.warn(` kick/client: could not remove the stale ${$} — treat it as out of date (${t instanceof Error?t.message:String(t)})`),!0}return e.log.warn(` kick/client: removed the previously generated ${$} rather than leave a stale one — re-run \`kick typegen\` once the cause above is fixed.`),!0}function co(e){let t=e?.typegen?.client;return typeof t==`object`?t.maxDepth:void 0}function lo(e){let t=e.config?.typegen?.client;return typeof t==`boolean`?t:t&&typeof t==`object`?t.enabled!==!1:(O(M.resolve(e.cwd,$))&&e.log.warn(` kick/client: ${$} 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 uo=()=>({id:to,outExtension:`.d.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){if(!lo(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:M.resolve(e.cwd,e.config?.typegen?.srcDir??`src`),cwd:e.cwd}),n=[],r=/* @__PURE__ */ 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=co(e.config),a=await Ga({projectDir:e.cwd,keys:n,maxDepth:i,cliVersion:ro}),o=io(M.resolve(e.cwd,no)),s=oo(M.resolve(e.cwd,$));if(a&&o&&s!==null&&o.inputs===a&&o.output===Ua(s))return Sn()&&e.log.info?.(` kick/client: unchanged, keeping ${$}`),null;try{let t=eo(await Ka({projectDir:e.cwd,routesFile:M.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(no,`${a} ${Ua(ao(t))}`),t}catch(t){let n=O(M.resolve(e.cwd,$)),r=` kick/client: skipped — ${t instanceof Error?t.message:String(t)}`;return n?e.log.warn(r):Sn()&&e.log.info?.(r),n&&await so(e),null}}});function fo(e,t,n=`zod`){if(!e)return null;let r=N(t),i=F(r,e.filePath).split(L).join(`/`);return i=i.replace(/\.(ts|tsx|mts|cts)$/i,``),i.startsWith(`.`)||(i=`./`+i),`/* eslint-disable */
|
|
1793
1802
|
// AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
|
|
1794
1803
|
// Re-run with \`kick typegen\` or rely on \`kick dev\` to refresh.
|
|
1795
1804
|
|
|
@@ -1827,5 +1836,5 @@ declare global {
|
|
|
1827
1836
|
}
|
|
1828
1837
|
|
|
1829
1838
|
export {}
|
|
1830
|
-
`}const
|
|
1831
|
-
`)}});var
|
|
1839
|
+
`}const po=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=ho(e);if(t===!1)return null;let n=await e.getScanResult({root:mo(e),cwd:e.cwd,envFile:t});if(!n.env)return null;let r=e.config?.typegen?.schemaValidator??`zod`,i=M.resolve(e.cwd,`.kickjs/types/kick__env.ts`);return fo(n.env,i,r)}});function mo(e){return M.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function ho(e){return e.config?.typegen?.envFile}function go(e){return M.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function _o(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function vo(e){return{root:go(e),cwd:e.cwd,envFile:_o(e)}}const yo=()=>({id:`kick/registry`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(vo(e)),n=M.resolve(e.cwd,`.kickjs/types/kick__registry.d.ts`),r=new Set(t.collisions.map(e=>e.className));return me(t.classes,n,r)}}),bo=()=>({id:`kick/services`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(vo(e)),n=new Set(t.collisions.map(e=>e.className)),r=ve(t.classes,t.tokens,t.injects,n);return ye(`ServiceToken`,r,"(no tokens discovered — declare with createToken<T>() or `kick g service <name>`)")}}),xo=()=>({id:`kick/modules`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(vo(e));return ye(`ModuleToken`,fe(t.classes),"(no @Module classes discovered — `kick g module <name>` to add one)")}}),So=()=>({id:`kick/plugins`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(vo(e));return pe(t.pluginsAndAdapters)}}),Co=()=>({id:`kick/context`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(vo(e));return t.contextKeys.length===0?null:Te(t.contextKeys)}}),wo=()=>({id:`kick/route-flags`,inputs:[`src/**/*.ts`],async generate(e){let t=await e.getScanResult(vo(e));return xe(t.routeFlags)}}),To={fastify:{subpath:`@forinda/kickjs/fastify`,typeName:`FastifyRuntimeTypes`},h3:{subpath:`@forinda/kickjs/h3`,typeName:`H3RuntimeTypes`}},Eo=()=>({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}=To[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(`
|
|
1840
|
+
`)}});var Do=/* @__PURE__ */ e({builtinCliPlugins:()=>Oo});const Oo=[_({name:`kick/init`,register:Qe}),_({name:`kick/generate`,register:Mn}),_({name:`kick/run`,register:Xn}),_({name:`kick/info`,register:tr}),_({name:`kick/inspect`,register:dr}),_({name:`kick/add`,register:a}),_({name:`kick/list`,register:s}),_({name:`kick/explain`,register:br}),_({name:`kick/mcp`,register:jr}),_({name:`kick/tinker`,register:Fr}),_({name:`kick/remove`,register:Vr}),_({name:`kick/typegen`,register:Wr}),_({name:`kick/check`,register:li}),_({name:`kick/doctor`,register:Wi}),_({name:`kick/env-command`,register:Zi}),_({name:`kick/codemod`,register:$i}),_({name:`kick/deploy`,register:ba}),_({name:`kick/registry`,typegens:[yo()]}),_({name:`kick/services`,typegens:[bo()]}),_({name:`kick/modules`,typegens:[xo()]}),_({name:`kick/plugins`,typegens:[So()]}),_({name:`kick/context`,typegens:[Co()]}),_({name:`kick/route-flags`,typegens:[wo()]}),_({name:`kick/assets`,typegens:[xa()]}),_({name:`kick/routes`,typegens:[ja()]}),_({name:`kick/client`,typegens:[uo()]}),_({name:`kick/env`,typegens:[po()]}),_({name:`kick/runtime`,typegens:[Eo()]})];export{Rn as n,Oo as t};
|