@forinda/kickjs-cli 8.10.2 → 8.11.0

package/dist/project-TbTVQCnh.mjs

@@ -1,114 +0,0 @@
-/**
- * @forinda/kickjs-cli v8.10.2
- *
- * Copyright (c) Felix Orinda
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- * @license MIT
- */
-import{o as e,r as t,u as n}from"./config-Ck9aQVpE.mjs";import{o as r,r as i}from"./package-manager--IUl91nq.mjs";import{existsSync as a,readFileSync as o,readdirSync as s,statSync as c,writeFileSync as l}from"node:fs";import{dirname as u,join as d,posix as f,resolve as p,sep as m}from"node:path";import{fileURLToPath as h}from"node:url";import{execFile as g,execFileSync as _,execSync as v,spawnSync as y}from"node:child_process";import{promisify as b}from"node:util";import{randomBytes as x}from"node:crypto";import{parseSync as S}from"oxc-parser";const C=b(g),w=/[&|<>^"'`(){}[\];!%\r\n\\]/;function T(e,t,n=process.platform){if(n!==`win32`)return[e,t];if(w.test(e)||t.some(e=>w.test(e)))return null;let r=[e,...t].map(e=>e.includes(` `)?`"${e}"`:e).join(` `);return[process.env.ComSpec||`cmd.exe`,[`/d`,`/s`,`/c`,r]]}function E(e,t,n={}){let r=T(e,t);if(!r)return null;try{return _(r[0],r[1],{encoding:`utf-8`,timeout:n.timeout??5e3,cwd:n.cwd,stdio:[`ignore`,`pipe`,`ignore`],windowsHide:!0}).toString().trim()||null}catch{return null}}function D(e,t,n={}){let r=T(e,t);if(!r)throw Error(`Refusing to run '${e}': unsafe arguments`);_(r[0],r[1],{cwd:n.cwd,stdio:`inherit`,windowsHide:!0})}function O(e,t,n){v(e,{cwd:t,stdio:`inherit`,env:n?{...process.env,...n}:process.env})}function k(e,t,n){let r=y(process.execPath,[e],{cwd:n,stdio:`inherit`,env:{...process.env,...t}});r.status!==0&&process.exit(r.status??1)}async function A(e,t,n={}){let r=T(e,t);if(!r)return null;try{let{stdout:e}=await C(r[0],r[1],{encoding:`utf-8`,timeout:n.timeout??5e3,cwd:n.cwd,windowsHide:!0});return e.toString().trim()||null}catch{return null}}const j=u(h(import.meta.url)),M=[d(j,`..`,`templates`),d(j,`..`,`..`,`templates`)].find(e=>a(d(e,`base`)));function ee(e){return e.split(`/`).map(e=>e.startsWith(`_dot_`)?`.${e.slice(5)}`:e).join(`/`)}function N(e,t={}){let n=t.templatesDir??M,r=/* @__PURE__ */ new Map,i=[],l=[],u={},f=[],p={};for(let t of e){let e=d(n,t);if(!a(e))throw Error(`Unknown scaffold layer "${t}" (${e})`);let h=d(e,`feature.json`);if(a(h)){let e=JSON.parse(o(h,`utf-8`));i.push(...e.dependencies??[]),l.push(...e.devDependencies??[]),Object.assign(u,e.builds),f.push(...e.integrations??[]),Object.assign(p,e.scripts)}let g=d(e,`files`);if(a(g))for(let e of s(g,{recursive:!0,encoding:`utf-8`}).toSorted()){let t=d(g,e);if(!c(t).isFile())continue;let n=o(t,`utf-8`),i=ee(e.split(m).join(`/`));if(i.endsWith(`.append`)){let e=i.slice(0,-7);r.set(e,(r.get(e)??``)+n)}else r.set(i,n)}}f.push(...t.extra??[]);let h=t.vars??{},g=e=>e.replace(/\{\{(\w+)\}\}/g,(e,t)=>h[t]??e);for(let[e,t]of r)t.includes(`// @kick:`)&&r.set(e,te(t,f,g));return{files:r,dependencies:[...new Set(i)],devDependencies:[...new Set(l)],builds:u,integrations:f,scripts:p}}function P(e,t){let n=e=>e.replace(/\{\{(\w+)\}\}/g,(e,n)=>n in t?t[n]:e);return new Map([...e].map(([e,t])=>[e,n(t)]))}const F=/^([ \t]*)\/\/ @kick:([\w-]+)[ \t]*$/;function te(e,t,n=e=>e){let r=e.split(`
-`),i=new Set(r.map(e=>F.exec(e)?.[2]).filter(Boolean)),a=t.filter(e=>!e.slot||i.has(e.slot)),o=[];for(let e=0;e<r.length;e++){let t=F.exec(r[e]);if(!t){o.push(r[e]);continue}let[,i,s]=t,c=s===`imports`?re(a.flatMap(e=>e.import?[e.import]:[])):a.filter(e=>e.slot===s&&e.code).map(e=>ne(`${n(e.code)},`,i));c.length>0?o.push(...c):o.at(-1)?.trimEnd().endsWith(`[`)&&r[e+1]?.trim().startsWith(`]`)&&(o.pop(),e++)}return o.join(`
-`)}function ne(e,t){return e.split(`
-`).map(e=>e&&t+e).join(`
-`)}function re(e){let t=/* @__PURE__ */ new Map;for(let n of e){let e=t.get(n.from)??{names:[]};e.default??=n.default;for(let t of n.names??[])e.names.includes(t)||e.names.push(t);t.set(n.from,e)}return[...t].map(([e,{names:t,default:n}])=>{let r=`import ${[n,t.length?`{ ${t.join(`, `)} }`:void 0].filter(Boolean).join(`, `)} from '${e}'`;return r.length<=100||t.length===0?r:`import ${n?`${n}, `:``}{\n${t.map(e=>`  ${e},`).join(`
-`)}\n} from '${e}'`})}function ie(e,t){let n=e[t];if(!n)throw Error(`generatePackageJson: missing resolved version for ${t}. Add it to SIBLING_PACKAGES or THIRD_PARTY_PACKAGES in generators/project.ts.`);return n}function ae(e,t){return Object.fromEntries(e.toSorted().map(e=>[e,ie(t,e)]))}function oe(e){try{let t=_(e,[`--version`],{encoding:`utf-8`,stdio:[`ignore`,`pipe`,`ignore`],timeout:1e4}).trim();return/^\d+\.\d+\.\d+$/.test(t)?`${e}@${t}`:void 0}catch{return}}function I(e){let t=e?.match(/@(\d+)\.(\d+)\./);return t?[Number(t[1]),Number(t[2])]:void 0}function L(e,t){let n=I(t)?.[0];return e===`yarn`&&n!==void 0&&n>=2?`nodeLinker: node-modules
-`:void 0}function se(e,t,n,r){return JSON.stringify({name:e,...r?{packageManager:r}:{},version:`0.0.0`,type:`module`,scripts:{dev:`kick dev`,build:`kick build`,start:`kick start`,test:`vitest run --passWithNoTests`,"build:netlify":`kick build && kick build:netlify`,"build:vercel":`kick build && kick build:vercel`,...n.scripts},dependencies:ae(n.dependencies,t),devDependencies:ae(n.devDependencies,t)},null,2)}function ce(e,t){let n=Object.entries(t);if(n.length===0)return e;let r=e===``?[]:e.replace(/\n$/,``).split(`
-`),i=e=>e.trim().replace(/^['"]|['"]$/g,``),a=e=>/^[\w-]+$/.test(e)?e:`'${e}'`,o=(e,t)=>{let n=r.findIndex(t=>t.replace(/\s+$/,``)===`${e}:`);if(n===-1){if(!t)return;r.length>0&&r[r.length-1]!==``&&r.push(``),r.push(`${e}:`),n=r.length-1}let i=n+1;for(let e=n+1;e<r.length&&/^(\s|$)/.test(r[e]);e++)r[e].trim()!==``&&(i=e+1);return{start:n,end:i}},s=[];for(let[e,t]of n){let{start:n,end:c}=o(`allowBuilds`,!0),l=r.slice(n+1,c).findIndex(t=>i(t.split(`:`)[0])===e),u=l===-1?void 0:/:\s*(true|false)\s*$/.exec(r[n+1+l]);if(u){s.push([e,u[1]===`true`]);continue}let d=`  ${a(e)}: ${t}`;l===-1?r.splice(c,0,d):r[n+1+l]=d,s.push([e,t])}let c=[`onlyBuiltDependencies`,`ignoredBuiltDependencies`];for(let[e,t]of s){if(c.some(t=>{let n=o(t,!1);return n!==void 0&&r.slice(n.start+1,n.end).some(t=>i(t.replace(/^\s*-/,``))===e)}))continue;let{end:n}=o(t?c[0]:c[1],!0);r.splice(n,0,`  - ${a(e)}`)}return`${r.join(`
-`)}\n`}const R=`node:22-slim`,z={pnpm:{lockfile:`pnpm-lock.yaml`,installFiles:[`pnpm-workspace.yaml`],install:`pnpm install --frozen-lockfile`,installProd:`pnpm install --prod --frozen-lockfile`,run:e=>`pnpm run ${e}`,image:R,setup:`RUN corepack enable`},npm:{lockfile:`package-lock.json`,installFiles:[],install:`npm ci`,installProd:`npm ci --omit=dev`,run:e=>`npm run ${e}`,image:R},yarn:{lockfile:`yarn.lock`,installFiles:[],install:`yarn install --frozen-lockfile`,installProd:`yarn install --production --frozen-lockfile`,run:e=>`yarn run ${e}`,image:R,setup:`RUN corepack enable`},bun:{lockfile:`bun.lock`,installFiles:[],install:`bun install --frozen-lockfile`,installProd:`bun install --production --frozen-lockfile`,run:e=>`bun run ${e}`,image:`oven/bun:1`}},B={lockfile:`yarn.lock`,installFiles:[`.yarnrc.yml`],install:`yarn install --immutable`,installProd:`yarn workspaces focus --all --production`,run:e=>`yarn run ${e}`,image:R,setup:`RUN corepack enable`},le={api:`docker run -p 3000:3000 <name>`,inertia:`docker run -p 3000:3000 -e SESSION_SECRET=<a long random string> <name>`,fullstack:`docker run -p 3000:3000 <name>`};function V(e,t,n,r){let[i=0,a=0]=I(r)??[],o=t===`yarn`&&i>=2?i>=4?B:{...B,installProd:B.install}:t===`bun`&&r&&(i<1||i===1&&a<2)?{...z.bun,lockfile:`bun.lockb`}:z[t],s=o.setup?`\n${o.setup}`:``,c=(e===`fullstack`?[`package.json`,o.lockfile,...o.installFiles,`server/package.json`,`web/package.json`]:[`package.json`,o.lockfile,...o.installFiles]).map(e=>`COPY ${e} ./${e.includes(`/`)?e.slice(0,e.lastIndexOf(`/`)+1):``}`).join(`
-`),l=`# syntax=docker/dockerfile:1
-# ${n} — the long-running server in one image.
-#
-#   docker build -t ${n} .
-#   ${le[e].replace(`<name>`,n)}
-#
-# Environment comes from the platform or \`docker run\`; .env files are not
-# copied into the image. The lockfile must be committed — installs are frozen.
-`;if(e===`fullstack`)return`${l}
-FROM ${o.image} AS base
-WORKDIR /app${s}
-
-# Production dependencies of every workspace member.
-FROM base AS deps
-${c}
-RUN ${o.installProd}
-# Hoisting may leave a member without its own node_modules; the runtime copies both.
-RUN mkdir -p node_modules server/node_modules
-
-# The server bundle and the built web app.
-FROM base AS build
-${c}
-RUN ${o.install}
-COPY . .
-RUN ${o.run(`build`)}
-
-FROM ${R}
-ENV NODE_ENV=production PORT=3000
-WORKDIR /app
-COPY --from=deps /app/node_modules ./node_modules
-COPY --from=deps /app/server/node_modules ./server/node_modules
-COPY --from=build /app/package.json ./
-COPY --from=build /app/server/package.json ./server/
-COPY --from=build /app/server/dist ./server/dist
-# SpaAdapter serves ../web/dist relative to the server.
-COPY --from=build /app/web/dist ./web/dist
-WORKDIR /app/server
-USER node
-EXPOSE 3000
-CMD ["node", "dist/index.js"]
-`;let u=e===`inertia`?`# The server, the pages (dist/client) and the SSR bundle (dist/ssr).`:`# The server bundle.`;return`${l}
-FROM ${o.image} AS base
-WORKDIR /app${s}
-
-FROM base AS deps
-${c}
-RUN ${o.installProd}
-
-${u}
-FROM base AS build
-${c}
-RUN ${o.install}
-COPY . .
-RUN ${o.run(`build`)}
-
-FROM ${R}
-ENV NODE_ENV=production PORT=3000
-WORKDIR /app
-COPY --from=deps /app/node_modules ./node_modules
-COPY --from=build /app/package.json ./
-COPY --from=build /app/dist ./dist
-USER node
-EXPOSE 3000
-CMD ["node", "dist/index.js"]
-`}function H(){return`${[`# Rebuilt inside the image.`,`**/node_modules`,`**/dist`,`**/.kickjs`,`# Secrets stay out of the image; pass them at run time.`,`**/.env`,`**/.env.*`,`!**/.env.example`,`# Platform and tooling output.`,`.netlify`,`.vercel`,`.git`,`**/coverage`,`*.log`].join(`
-`)}\n`}const ue={adapter:`adapters`,middleware:`middlewares`};function de(e,t,n=e=>e,r=`src/index.ts`){let i={source:e,added:[],present:[],manual:[]};for(let e of t){if(!e.slot||!e.code)continue;let t=ue[e.slot],a=n(e.code),o=me(a),s=S(r,i.source).program,c=t?fe(s):void 0;if(!c){i.manual.push({...e,code:a});continue}let l=c.properties.find(e=>e.type===`Property`&&(e.key?.name??e.key?.value)===t);if(l&&l.value.type!==`ArrayExpression`){i.manual.push({...e,code:a});continue}let u=o&&e.import?pe(s,e.import.from,o):o;l&&u&&i.source.slice(l.value.start,l.value.end).includes(`${u}(`)?i.present.push(o??U(a)):(i.source=l?he(i.source,l.value,a):ge(i.source,c,t,a),e.import&&(i.source=_e(i.source,e.import,r)),i.added.push(o??U(a)))}return i}function fe(e){let t,n=e=>{if(t||!e||typeof e!=`object`)return;if(Array.isArray(e))return e.forEach(n);let r=e;if(r.type===`CallExpression`&&r.callee?.type===`Identifier`&&r.callee.name===`bootstrap`&&r.arguments?.[0]?.type===`ObjectExpression`)t=r.arguments[0];else for(let e in r)n(r[e])};return n(e),t}function pe(e,t,n){for(let r of e.body)if(r.type===`ImportDeclaration`&&r.source.value===t)for(let e of r.specifiers){let t=e.imported?.name??e.imported?.value;if(e.type===`ImportSpecifier`&&t===n)return e.local.name}return n}function me(e){let t=e.split(`
-`).find(e=>e.trim()&&!e.trim().startsWith(`//`));return/^\s*([A-Za-z_$][\w$.]*)\s*\(/.exec(t??``)?.[1]}const U=e=>e.split(`
-`).find(e=>e.trim()&&!e.trim().startsWith(`//`))?.trim()??e,W=(e,t)=>/^[ \t]*/.exec(e.slice(e.lastIndexOf(`
-`,t-1)+1))[0],G=(e,t)=>e.split(`
-`).map(e=>e&&t+e).join(`
-`);function he(e,t,n){let r=t.elements.filter(Boolean),i=W(e,t.start);if(r.length===0){let r=G(`${n},`,`${i}  `);return`${e.slice(0,t.start)}[\n${r}\n${i}]${e.slice(t.end)}`}let a=r.at(-1),o=W(e,a.start),s=e.slice(a.end,t.end-1).match(/^\s*,/),c=s?a.end+s[0].length:a.end,l=`\n${G(`${n},`,o)}`;return s?e.slice(0,c)+l+e.slice(c):`${e.slice(0,c)},${l.replace(/,$/,``)}${e.slice(c)}`}function ge(e,t,n,r){let i=t.properties.at(-1),a=i?W(e,i.start):`${W(e,t.start)}  `,o=`${a}${n}: [\n${G(`${r},`,`${a}  `)}\n${a}],`;if(!i)return`${e.slice(0,t.start)}{\n${o}\n${W(e,t.start)}}${e.slice(t.end)}`;let s=e.slice(i.end,t.end-1).match(/^\s*,/),c=s?i.end+s[0].length:i.end;return`${e.slice(0,c)}${s?``:`,`}\n${o}${e.slice(c)}`}function _e(e,t,n=`src/index.ts`){let r=S(n,e).program.body.filter(e=>e.type===`ImportDeclaration`),i=r.find(e=>e.source.value===t.from&&e.importKind!==`type`&&e.specifiers.length>0&&!e.specifiers.some(e=>e.type===`ImportNamespaceSpecifier`)),a=t.names??[];if(i){let t=new Set(i.specifiers.map(e=>e.local?.name)),n=a.filter(e=>!t.has(e));if(n.length===0)return e;let r=i.specifiers.filter(e=>e.type===`ImportSpecifier`);if(r.length>0){let t=r.at(-1).end;return`${e.slice(0,t)}, ${n.join(`, `)}${e.slice(t)}`}let o=i.specifiers[0];return`${e.slice(0,o.end)}, { ${n.join(`, `)} }${e.slice(o.end)}`}let o=`import ${[t.default,a.length?`{ ${a.join(`, `)} }`:void 0].filter(Boolean).join(`, `)} from '${t.from}'`,s=r.at(-1);return s?`${e.slice(0,s.end)}\n${o}${e.slice(s.end)}`:`${o}\n${e}`}const ve={swagger:`feature-swagger`,devtools:`feature-devtools`,ws:`feature-ws`,queue:`feature-queue`,"queue:bullmq":`feature-queue`,storage:`feature-storage`};function ye(e){let t=[...new Set(e.map(e=>ve[e]).filter(Boolean))];return t.length>0?N(t):void 0}function be(e,t){return(t?[t]:[`src/index.ts`,`src/main.ts`]).find(t=>a(d(e,t)))}function xe(e,t){try{return _(`git`,[`status`,`--porcelain`,`--`,...t],{cwd:e,encoding:`utf-8`,stdio:[`ignore`,`pipe`,`ignore`]}).split(`
-`).filter(Boolean).map(e=>e.slice(3))}catch{return[]}}const K=/\.(?:[cm]?[jt]sx?)$/;function Se(e,t){return[...t].filter(([t,n])=>{let r=d(e,t);return K.test(t)&&a(r)&&o(r,`utf-8`)!==n}).map(([e])=>e)}async function Ce(e,t){let n=[];for(let[i,s]of t){let t=d(e,i);if(!a(t)){await r(t,s),n.push(i);continue}if(K.test(i))continue;let c=o(t,`utf-8`),l=new Set(c.split(`
-`).map(e=>q(e)??e)),u=s.split(`
-`).filter(e=>e.trim()&&!l.has(q(e)??e));if(u.length===0)continue;let f=c===``||c.endsWith(`
-`)?``:`
-`;await r(t,`${c}${f}${u.join(`
-`)}\n`),n.push(i)}return n}function we(e,t,n){let r=e.import?.from;if(!r?.startsWith(`.`))return!1;let i=f.join(f.dirname(t.replaceAll(`\\`,`/`)),r);return n.some(e=>e.replace(K,``)===i)}const q=e=>/^\s*([A-Za-z_][\w]*)\s*=/.exec(e)?.[1];async function Te(e,t,n){let i=d(e,t),a=o(i,`utf-8`),s=de(a,n,J(e),t);return s.source!==a&&await r(i,s.source),s}function J(e){let t=Ee(e),n={name:String(t.name??`app`),version:String(t.version??`0.0.0`)};return e=>e.replace(/\{\{(\w+)\}\}/g,(e,t)=>n[t]??e)}function Ee(e){try{return JSON.parse(o(d(e,`package.json`),`utf-8`))}catch{return{}}}function De(e){let t=e.flatMap(e=>e.import?[e.import]:[]).map(e=>`import ${[e.default,e.names?.length?`{ ${e.names.join(`, `)} }`:void 0].filter(Boolean).join(`, `)} from '${e.from}'`),n=e.map(e=>`${e.code},`);return[...t,``,`// in bootstrap({ adapters: [ ... ] }):`,...n].join(`
-`)}const Y={kickjs:{pkg:`@forinda/kickjs`,peers:[],enginePeers:!0,description:`Unified framework: DI, decorators, routing, middleware`,core:!0},vite:{pkg:`@forinda/kickjs-vite`,peers:[`vite`],description:`Vite plugin: dev server, HMR, module discovery`,dev:!0,core:!0},cli:{pkg:`@forinda/kickjs-cli`,peers:[],description:`CLI tool and code generators`,dev:!0,core:!0},zod:{pkg:`zod`,peers:[],description:`Zod schema validation (env, DTOs, OpenAPI) — wrap with fromZod()`},valibot:{pkg:`valibot`,peers:[],description:`Valibot schema validation — wrap with fromValibot()`},yup:{pkg:`yup`,peers:[],description:`Yup schema validation — wrap with fromYup()`},ai:{pkg:`@forinda/kickjs-ai`,peers:[`zod`],description:`AI toolkit — LLM providers, tool definitions from controllers`},storage:{pkg:`@forinda/kickjs-storage`,peers:[],description:`File storage — memory, disk, S3-compatible buckets, signed URLs`},swagger:{pkg:`@forinda/kickjs-swagger`,peers:[],description:`OpenAPI spec + Swagger UI + ReDoc`,builds:{"@scarf/scarf":!0}},db:{pkg:`@forinda/kickjs-db`,peers:[],description:`kick/db core — schema DSL, migrations, KickDbClient, customType`},pg:{pkg:`@forinda/kickjs-db`,peers:[`pg`],typePeers:[`@types/pg`],description:`kick/db + PostgreSQL driver (use @forinda/kickjs-db/pg)`},sqlite:{pkg:`@forinda/kickjs-db`,peers:[`better-sqlite3`],builds:{"better-sqlite3":!0},typePeers:[`@types/better-sqlite3`],description:`kick/db + SQLite driver (use @forinda/kickjs-db/sqlite)`},mysql:{pkg:`@forinda/kickjs-db`,peers:[`mysql2`],description:`kick/db + MySQL driver (use @forinda/kickjs-db/mysql)`},ws:{pkg:`@forinda/kickjs-ws`,peers:[`ws`],description:`WebSocket with @WsController decorators`},devtools:{pkg:`@forinda/kickjs-devtools`,peers:[],description:`Development dashboard — routes, DI, metrics, health`,dev:!0},queue:{pkg:`@forinda/kickjs-queue`,peers:[],description:`Queue adapter (BullMQ/RabbitMQ/Kafka)`},"queue:bullmq":{pkg:`@forinda/kickjs-queue`,peers:[`bullmq`,`ioredis`],builds:{"msgpackr-extract":!1},description:`Queue with BullMQ + Redis`},"queue:rabbitmq":{pkg:`@forinda/kickjs-queue`,peers:[`amqplib`],description:`Queue with RabbitMQ`},"queue:kafka":{pkg:`@forinda/kickjs-queue`,peers:[`kafkajs`],description:`Queue with Kafka`},"queue:redis-pubsub":{pkg:`@forinda/kickjs-queue`,peers:[`ioredis`],description:`Lightweight pub/sub via Redis (no persistence)`},mcp:{pkg:`@forinda/kickjs-mcp`,peers:[`@modelcontextprotocol/server`],description:`Model Context Protocol server — expose @Controller endpoints as AI tools`},testing:{pkg:`@forinda/kickjs-testing`,peers:[],description:`Test utilities and TestModule builder`,dev:!0}},Oe=Object.entries(Y).filter(([e,t])=>!t.core&&!t.deprecated&&!e.includes(`:`)&&![`pg`,`sqlite`,`mysql`,`zod`,`valibot`,`yup`].includes(e)).map(([e])=>e).join(`, `),ke={express:[`express`],fastify:[`fastify`,`@fastify/middie`,`serve-static`],h3:[`h3@^2`,`serve-static`]},Ae={express:{prod:`multer`,dev:`@types/multer`,note:`Express uploads use multer (memory/disk storage, ctx.file / ctx.files).`},fastify:{prod:`@fastify/multipart`,note:`Fastify uploads use @fastify/multipart (buffered into ctx.file / ctx.files).`},h3:{note:`h3 parses multipart natively (readMultipartFormData) — no driver to install.`}};function X(e){if(e!==void 0){if(e===`express`||e===`fastify`||e===`h3`)return e;throw Error(`Invalid --runtime '${String(e)}'. Expected express, fastify or h3.`)}}async function Z(e=process.cwd()){return(await je(e)).runtime}async function je(t=process.cwd()){let n=(await e(t))?.runtime;return n===`express`||n===`fastify`||n===`h3`?{runtime:n,candidates:[n],ambiguous:!1,fromConfig:!0}:{...Ne(t),fromConfig:!1}}const Me=[[`express`,`express`],[`fastify`,`fastify`],[`h3`,`h3`]];function Ne(e=process.cwd()){let t=Pe(`package.json`,e);if(!t)return{runtime:`express`,candidates:[],ambiguous:!1};let n={},r={};try{let e=JSON.parse(o(p(t,`package.json`),`utf-8`));n=e.dependencies??{},r=e.devDependencies??{}}catch{return{runtime:`express`,candidates:[],ambiguous:!1}}let i=Me.filter(([e])=>e in n).map(([,e])=>e),a=Me.filter(([e])=>e in r&&!(e in n)).map(([,e])=>e),s=[...i,...a];return i.length===1?{runtime:i[0],candidates:s,ambiguous:!1}:i.length===0&&a.length===1?{runtime:a[0],candidates:s,ambiguous:!1}:s.length===0?{runtime:`express`,candidates:s,ambiguous:!1}:{runtime:`express`,candidates:s,ambiguous:!0}}function Pe(e,t=process.cwd()){let n=t;for(;;){if(a(p(n,e)))return n;let t=u(n);if(t===n)return null;n=t}}function Fe(e=!1,t){let n=Object.entries(Y),r=Math.max(...n.map(([e])=>e.length)),i=n.filter(([,e])=>e.core),a=n.filter(([,e])=>!e.core),o=([e,n])=>{let i=e.padEnd(r+2),a=n.enginePeers?[...n.peers,...ke[t??`express`]]:n.peers,o=n.enginePeers?` [${t??`express`} engine]`:``,s=a.length?` (+ ${a.join(`, `)})${o}`:``,c=n.deprecated?` [DEPRECATED — ${n.deprecated}]`:``;return`    ${i} ${n.description}${s}${c}`};console.log(`
-  Core packages (always installed by \`kick new\`):
-`);for(let e of i)console.log(o(e));if(e){console.log(`
-  Optional packages (add as needed):
-`);for(let e of a)console.log(o(e))}else console.log(`\n  Plus ${a.length} optional packages (swagger, db, queue, …).`),console.log("  Run `kick add --list --all` for the full catalog.");console.log(`
-  Usage: kick add ai db swagger`),console.log(`         kick add queue:bullmq`),console.log(`         kick add upload   # installs the multipart driver for your runtime`),console.log()}const Ie={"@swc/core":!0,esbuild:!0};function Q(e,t,n){if(e===`pnpm`){let e=p(t,`pnpm-workspace.yaml`),r=a(e)?o(e,`utf-8`):``,i=ce(r,n);return i===r?void 0:(l(e,i),e)}if(e!==`npm`&&e!==`bun`)return;let r=p(t,`package.json`);if(!a(r))return;let i=JSON.parse(o(r,`utf-8`)),s=!1;if(e===`npm`){let e=i.allowScripts??{};for(let[t,r]of Object.entries(n))Object.keys(e).some(e=>e===t||e.startsWith(`${t}@`))||(e[t]=r,s=!0);i.allowScripts=e}else{let e=i.trustedDependencies??[];for(let[t,r]of Object.entries(n))r&&!e.includes(t)&&(e.push(t),s=!0);i.trustedDependencies=e}if(s)return l(r,`${JSON.stringify(i,null,2)}\n`),r}function Le(e){if(e===`pnpm`)return Pe(`pnpm-workspace.yaml`)??process.cwd();for(let e=process.cwd();;e=u(e)){try{if(JSON.parse(o(p(e,`package.json`),`utf-8`)).workspaces)return e}catch{}if(u(e)===e)return process.cwd()}}function $(e){return Object.assign({},...e.map(e=>Y[e]?.builds??{}))}function Re(e,t,n=`express`){let r=/* @__PURE__ */ new Set,i=/* @__PURE__ */ new Set,a=[],o=[],s=[];for(let c of e){if(c===`upload`){let e=Ae[n];s.push(`upload (${n}): ${e.note}`),e.prod&&(t?i:r).add(e.prod),e.dev&&i.add(e.dev);continue}let e=Y[c];if(!e){a.push(c);continue}e.deprecated&&o.push(`'${c}' (${e.pkg}) is deprecated — ${e.deprecated}`);let l=t||e.dev?i:r;l.add(e.pkg);for(let t of e.peers)l.add(t);for(let t of e.typePeers??[])i.add(t);if(e.enginePeers){let e=ke[n];for(let t of e)l.add(t);s.push(`${c} (${n}): engine peers ${e.join(`, `)}`)}}return{prodDeps:[...r],devDeps:[...i],unknown:a,warnings:o,notices:s}}function ze(e){e.command(`list`).alias(`ls`).description(`List KickJS packages (core only; pair with --all for the full catalog)`).option(`--all`,`Include the full optional catalog`).option(`--runtime <engine>`,`HTTP engine to show peers for: express | fastify | h3`).action(async e=>{Fe(!!e.all,X(e.runtime)??await Z())})}function Be(e){e.command(`add [packages...]`).description(`Add KickJS packages with their required dependencies`).option(`--pm <manager>`,`Package manager override`).option(`-D, --dev`,`Install as dev dependency`).option(`--list`,`List packages (core only by default; pair with --all)`).option(`--runtime <engine>`,`HTTP engine for peer resolution: express | fastify | h3 (overrides kick.config.ts)`).option(`--all`,`When listing, include the full optional catalog`).option(`--no-wire`,`Install only — do not add adapters to the entry file or .env`).option(`--entry <file>`,`Entry file to wire (default: src/index.ts, then src/main.ts)`).option(`-f, --force`,`Wire even when the files it edits have uncommitted changes`).action(async(e,t)=>{if(t.list||e.length===0){Fe(!!t.all,X(t.runtime)??await Z());return}let{pm:n,source:r}=await i(t.pm);console.log(`\n  Using ${n} (resolved from ${r})`);let o=X(t.runtime),s=await je(process.cwd()),c=o??s.runtime;if(!o&&s.ambiguous){console.error(`\n  Cannot tell which HTTP engine this app boots on: found ${s.candidates.join(`, `)} in package.json.\n\n  Installing engine peers for the wrong one is worse than not installing them, so:\n    • set \`runtime: '<engine>'\` in kick.config.ts (permanent, also fixes kick doctor), or\n    • pass --runtime <${s.candidates.join(`|`)}> for this command\n`),process.exitCode=1;return}let l=Re(e,!!t.dev,c),{unknown:u,warnings:d,notices:f}=l,{prodDeps:m,devDeps:h}=l,g=process.cwd();if(t.entry&&!a(p(g,t.entry))){console.error(`\n  --entry ${t.entry} does not exist.\n`),process.exitCode=1;return}let _=t.wire===!1?void 0:ye(e),y=_?be(g,t.entry):void 0;if(_){m=[.../* @__PURE__ */ new Set([...m,..._.dependencies])],h=[...new Set([...h,..._.devDependencies].filter(e=>!m.includes(e)))];let e=xe(g,[...y?[y]:[],..._.files.keys()]);if(e.length>0&&!t.force){console.error(`\n  ${e.join(`, `)} ${e.length===1?`has`:`have`} uncommitted changes, and kick add would edit ${e.length===1?`it`:`them`}.\n  Commit or stash first, pass --force to edit anyway, or --no-wire to install only.\n`),process.exitCode=1;return}}for(let e of d)console.warn(`\n  WARNING: ${e}`);for(let e of f)console.log(`\n  ${e}`);if(u.length>0&&(console.log(`\n  Unknown packages: ${u.join(`, `)}`),console.log(`  Run "kick add --list" to see available packages.
-`),m.length===0&&h.length===0))return;let b={...$(e),..._?.builds};if(Object.keys(b).length>0){let e=Q(n,Le(n),b);e&&console.log(`\n  Approved install scripts in ${e}`)}let x=!0;if(m.length>0){let e=m,t=`${n} add ${e.join(` `)}`;console.log(`\n  Installing ${e.length} dependency(ies):`);for(let t of e)console.log(`    + ${t}`);console.log();try{v(t,{stdio:`inherit`})}catch{x=!1,console.log(`\n  Installation failed. Run manually:\n    ${t}\n`)}}if(h.length>0){let e=h,t=`${n} add -D ${e.join(` `)}`;console.log(`\n  Installing ${e.length} dev dependency(ies):`);for(let t of e)console.log(`    + ${t} (dev)`);console.log();try{v(t,{stdio:`inherit`})}catch{x=!1,console.log(`\n  Installation failed. Run manually:\n    ${t}\n`)}}if(_){if(!x)console.log(`  Skipped wiring — the install did not finish.
-`);else{let e=Se(g,_.files);for(let e of await Ce(g,_.files))console.log(`  Updated ${e}`);let t=y?_.integrations.filter(t=>we(t,y,e)):[],n=_.integrations.filter(e=>!t.includes(e)),r=y?await Te(g,y,n):void 0;for(let e of r?.added??[])console.log(`  Added ${e} to ${y}`);for(let e of r?.present??[])console.log(`  ${e} is already in ${y}`);let i=J(g),a=r?r.manual:_.integrations.filter(e=>e.slot&&e.code).map(e=>({...e,code:i(e.code)}));if(e.length>0){let n=t.map(e=>({...e,code:i(e.code??``)}));console.log(`\n  ${e.join(`, `)} already exist${e.length===1?`s`:``} — left as ${e.length===1?`it is`:`they are`}. Merge in what the layer needs, then wire it yourself:
-`),console.log(`${De(n)}`.replace(/^/gm,`    `)),console.log()}a.length>0&&(console.log(`\n  ${y?`Could not find bootstrap({ adapters: [...] }) in ${y}`:`No entry file found`} — add this yourself:
-`),console.log(De(a).replace(/^/gm,`    `)),console.log())}}x?console.log(`  Done!
-`):(console.log(`  Finished with errors — the install above did not complete.
-`),process.exitCode=1)})}const Ve=u(h(import.meta.url));function He(e){return{kick:t(e,`kick`),runDev:n(e,`dev`),runBuild:n(e,`build`),runStart:n(e,`start`),runTest:n(e,`test`)}}const Ue=JSON.parse(o([d(Ve,`..`,`package.json`),d(Ve,`..`,`..`,`package.json`)].find(a),`utf-8`)),We=[`@forinda/kickjs`,`@forinda/kickjs-cli`,`@forinda/kickjs-schema`,`@forinda/kickjs-vite`,`@forinda/kickjs-swagger`,`@forinda/kickjs-ws`,`@forinda/kickjs-queue`,`@forinda/kickjs-devtools`,`@forinda/kickjs-testing`,`@forinda/kickjs-client`,`@forinda/kickjs-inertia`,`@forinda/kickjs-storage`],Ge={react:{fallback:`^19.0.0`},"react-dom":{fallback:`^19.0.0`},"@types/react":{fallback:`^19.0.0`},"@types/react-dom":{fallback:`^19.0.0`},"@vitejs/plugin-react":{fallback:`^5.0.0`},"@inertiajs/react":{fallback:`^3.9.0`,cap:`^3`},"@inertiajs/core":{fallback:`^3.9.0`,cap:`^3`},"@types/node":{fallback:`^25.0.0`},"@types/supertest":{fallback:`^7.2.1`},supertest:{fallback:`^7.2.2`},vitest:{fallback:`^4.1.2`},"@swc/core":{fallback:`^1.15.21`},"unplugin-swc":{fallback:`^1.5.9`},oxfmt:{fallback:`^0.65.0`},oxlint:{fallback:`^1.80.0`},dotenv:{fallback:`^17.3.1`,cap:`^17`},"reflect-metadata":{fallback:`^0.2.2`},vite:{fallback:`^8.0.3`,cap:`^8`},typescript:{fallback:`^7.0.2`,cap:`^7`},"@typescript/typescript6":{fallback:`^6.0.2`,cap:`^6`},express:{fallback:`^5.1.0`,cap:`^5`},"@types/express":{fallback:`^5.0.6`,cap:`^5`},fastify:{fallback:`^5.0.0`,cap:`^5`},"@fastify/middie":{fallback:`^9.0.0`,cap:`^9`},h3:{fallback:`^2.0.2`,cap:`^2`},"serve-static":{fallback:`^2.2.0`,cap:`^2`},zod:{fallback:`^4.3.6`,cap:`^4`},valibot:{fallback:`^1.4.1`,cap:`^1`},"@valibot/to-json-schema":{fallback:`^1.8.0`,cap:`^1`},yup:{fallback:`^1.7.1`,cap:`^1`},ws:{fallback:`^8.18.0`,cap:`^8`},bullmq:{fallback:`^5.0.0`,cap:`^5`},ioredis:{fallback:`^5.0.0`,cap:`^5`}};function Ke(e){if(!e)return null;let t=e.trim();if(/^\d+\.\d+\.\d+/.test(t))return t.split(/\s/)[0];try{let e=JSON.parse(t),n=(Array.isArray(e)?e:[e]).filter(e=>typeof e==`string`);return n.length>0?n[n.length-1]:null}catch{return null}}function qe(e){return e===`@forinda/kickjs-cli`?`^${Ue.version}`:`latest`}async function Je(e,t,n){let r=Array.from({length:e.length}),i=0,a=Array.from({length:Math.min(t,e.length)},async()=>{for(;i<e.length;){let t=i++;r[t]=await n(e[t])}});return await Promise.all(a),r}async function Ye(){let e=[...We.map(e=>({name:e,fallback:qe(e),cap:void 0})),...Object.entries(Ge).map(([e,t])=>({name:e,...t}))],t=Date.now()+2e4,n=await Je(e,8,async({name:e,fallback:n,cap:r})=>{let i=t-Date.now();if(i<=0)return[e,n];let a=r?`${e}@${r}`:e,o=Ke(await A(`npm`,r?[`view`,a,`version`,`--json`]:[`view`,a,`version`],{timeout:i}));return[e,o?`^${o}`:n]});return Object.fromEntries(n)}function Xe(e,t){let n=E(`npm`,[`view`,`${e}@${t}`,`version`],{timeout:2e4});return n&&/^\d+\.\d+\.\d+/.test(n)?n:null}function Ze(e){return(e??``).replace(/^[\^~>=<\s]+/,``)}function Qe(e,t){let n=e=>Ze(e).split(`-`)[0].split(`.`).map(e=>Number.parseInt(e,10)||0),[r=0,i=0,a=0]=n(e),[o=0,s=0,c=0]=n(t);return r===o?i===s?a>=c:i>s:r>o}function $e(e,t,n){let r=E(`npm`,[`view`,`${e}@${t}`,`exports`,`--json`],{timeout:2e4});if(!r)return!1;try{let e=JSON.parse(r);return Object.prototype.hasOwnProperty.call(e,n)}catch{return!1}}async function et(e){let{name:i,directory:o,packageManager:s=`pnpm`,template:c=`rest`,defaultRepo:l=`inmemory`,packages:u=[],schemaLib:f=`zod`,runtime:p=`express`}=e,m=o,h=e=>console.log(`  ${e}`);console.log(`\n  Creating KickJS project: ${i}\n`),e.versions||h(`Resolving package versions...`);let g=e.versions??await Ye(),_=Object.keys(g).filter(e=>g[e]===`latest`);if(_.length>0&&h(`WARNING: could not reach npm for ${_.join(`, `)} — pinned to 'latest'`),p!==`express`){if($e(`@forinda/kickjs`,`latest`,`./${p}`))h(`Using @forinda/kickjs@latest (stable ships the ${p} runtime)`);else{let e=[`@forinda/kickjs`,`@forinda/kickjs-cli`,`@forinda/kickjs-vite`],t=[],n=!1;for(let r of e){let e=Xe(r,`alpha`);e&&Qe(e,Ze(g[r]))&&(g[r]=`^${e}`,t.push(`${r}@^${e}`),r===`@forinda/kickjs`&&(n=!0))}h(n?`Using the alpha channel for the ${p} runtime: ${t.join(`, `)}`:`WARNING: could not resolve @forinda/kickjs@alpha — the ${p} runtime subpath may be missing. After install, run: ${s} add @forinda/kickjs@alpha`)}}let y=u.filter(e=>!a(d(M,`feature-${e}`)));y.length>0&&h(`WARNING: skipping unknown package(s): ${y.join(`, `)} — add them later with kick add`);let b=N([...nt({template:c,runtime:p,schemaLib:f,packages:u}),...e.platformConfig===!1?[]:[`host-config`],...e.extraLayers??[]],{vars:{name:i,version:Ue.version},extra:[{slot:`repo`,code:l===`inmemory`?`repo: 'inmemory'`:`repo: { name: '${l.replace(/\\/g,`\\\\`).replace(/'/g,`\\'`)}' }`},...e.spaClientDir?[tt(e.spaClientDir)]:[]]}),S=e.platformConfig===!1?void 0:oe(s);await r(d(m,`package.json`),se(i,g,b,S));let C=L(s,S);C&&await r(d(m,`.yarnrc.yml`),C);let w=P(b.files,{name:i,template:c,runtime:p,packageManager:s,...He(s),netlifyPublish:c===`inertia`?`dist/client`:`dist/public`,templateLabel:{rest:`REST API`,minimal:`Minimal`,inertia:`Inertia (React)`}[c],sessionSecret:x(32).toString(`hex`),packages:[...b.dependencies,...b.devDependencies].filter(e=>e.startsWith(`@forinda/`)).map(e=>`- \`${e}\``).join(`
-`)});for(let[e,t]of w)await r(d(m,e),t);if(e.platformConfig!==!1){let e=c===`inertia`?`inertia`:`api`;await r(d(m,`Dockerfile`),V(e,s,i,S)),await r(d(m,`.dockerignore`),H())}let{generateAgentDocs:T}=await import(`./agent-docs-As_KjQBC.mjs`).then(e=>e.t);await T({outDir:m,name:i,pm:s,template:c,only:`all`,force:!0});let E={...Ie,...$(u),...b.builds};if(e.approveInstallScripts!==!1&&Q(s,m,E),e.installDeps){console.log(`\n  Installing dependencies with ${s}...\n`);try{v(`${s} install`,{cwd:m,stdio:`inherit`}),console.log(`
-  Dependencies installed successfully!`)}catch{console.log(`\n  Warning: ${s} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-DJQ6WBwr.mjs`).then(e=>e.n);await e({cwd:m,allowDuplicates:!0,silent:!0})}catch{}if(e.initGit)try{v(`git init`,{cwd:m,stdio:`pipe`}),v(`git branch -M main`,{cwd:m,stdio:`pipe`}),v(`git add -A`,{cwd:m,stdio:`pipe`}),v(`git commit -m "chore: initial commit from kick new"`,{cwd:m,stdio:`pipe`}),h(`Git repository initialized`)}catch{h(`Warning: git init failed (git may not be installed)`)}console.log(`
-  Project scaffolded successfully!`),console.log();let D=m!==process.cwd();h(`Next steps:`),D&&h(`  cd ${i}`),e.installDeps||h(`  ${s} install`);let O=t(s,`kick`),k={rest:`${O} g module user`,minimal:`# add your routes to src/index.ts`,inertia:`# pages: src/modules/pages + src/client/pages`};h(`  ${k[c]??k.rest}`),h(`  ${n(s,`dev`)}`);let A=e=>{let t=Math.max(...e.map(([e])=>e.length))+2;for(let[n,r]of e)h(`  ${n.padEnd(t)}${r}`)};return h(``),h(`Commands:`),A([[n(s,`dev`),`Start dev server with Vite HMR`],[n(s,`build`),`Production build via Vite`],[n(s,`start`),`Run production build`]]),h(``),h(`Generators:`),A([[`${O} g module <name>`,`REST module (controller, service, DTOs, repository)`],[`${O} g scaffold <n> <f..>`,`CRUD module from field definitions`],[`${O} g controller <name>`,`Standalone controller`],[`${O} g service <name>`,`@Service() class`],[`${O} g middleware <name>`,`Global connect-style middleware`],[`${O} g guard <name>`,`Route guard (auth, roles, etc.)`],[`${O} g adapter <name>`,`AppAdapter with lifecycle hooks`],[`${O} g dto <name>`,`DTO schema (Zod / Valibot / Yup)`],[`${O} g config`,`Generate kick.config.ts`]]),h(``),h(`Add packages:`),A([[`${O} add <pkg>`,`Install a KickJS package + peers`],[`${O} add --list`,`Show all available packages`]]),h(``),h(`Available: ${Oe}`),h(``),{builds:E}}function tt(e){return{import:{from:`@forinda/kickjs/spa`,names:[`SpaAdapter`]},slot:`adapter`,code:`// Serves the built frontend from this origin in production.
-// Inert until the client build exists, so \`kick dev\` (where Vite
-// serves the client and proxies /api here) is unaffected.
-SpaAdapter({ clientDir: ${JSON.stringify(e)} })`}}function nt(e){return[`base`,`template-${e.template}`,`runtime-${e.runtime}`,`schema-${e.schemaLib}`,...e.packages.filter(e=>a(d(M,`feature-${e}`))).map(e=>`feature-${e}`)]}export{O as _,Q as a,Z as c,oe as d,L as f,k as g,D as h,Ae as i,V as l,N as m,Ye as n,Be as o,P as p,Y as r,ze as s,et as t,H as u};