@forinda/kickjs-cli 8.2.3 → 8.3.0

package/dist/project-Dck92mbC.mjs

@@ -1,427 +0,0 @@
-/**
- * @forinda/kickjs-cli v8.2.3
- *
- * 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{a as e,t}from"./config-CXqsXPQB.mjs";import{l as n,o as r}from"./project-docs-CjKscwGL.mjs";import{existsSync as i,readFileSync as a}from"node:fs";import{dirname as o,join as s,resolve as c}from"node:path";import{fileURLToPath as l}from"node:url";import{execFile as u,execFileSync as d,execSync as f,spawnSync as p}from"node:child_process";import{promisify as m}from"node:util";const h=m(u),g=/[&|<>^"'`(){}[\];!%\r\n\\]/;function _(e,t,n=process.platform){if(n!==`win32`)return[e,t];if(g.test(e)||t.some(e=>g.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 v(e,t,n={}){let r=_(e,t);if(!r)return null;try{return d(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 y(e,t,n={}){let r=_(e,t);if(!r)throw Error(`Refusing to run '${e}': unsafe arguments`);d(r[0],r[1],{cwd:n.cwd,stdio:`inherit`,windowsHide:!0})}function b(e,t,n){f(e,{cwd:t,stdio:`inherit`,env:n?{...process.env,...n}:process.env})}function ee(e,t,n){let r=p(process.execPath,[e],{cwd:n,stdio:`inherit`,env:{...process.env,...t}});r.status!==0&&process.exit(r.status??1)}async function x(e,t,n={}){let r=_(e,t);if(!r)return null;try{let{stdout:e}=await h(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 S={swagger:`@forinda/kickjs-swagger`,ws:`@forinda/kickjs-ws`,queue:`@forinda/kickjs-queue`,devtools:`@forinda/kickjs-devtools`},C={zod:{name:`zod`,range:`^4.3.6`},valibot:{name:`valibot`,range:`^1.4.1`},yup:{name:`yup`,range:`^1.7.1`}};function w(e,t){let n=e[t];if(!n)throw Error(`generatePackageJson: missing resolved version for ${t}. Add it to SIBLING_PACKAGES in generators/project.ts.`);return n}function T(e,t,n,r=[],i=`zod`,a=`express`,o=!1){let s=C[i],c={"@forinda/kickjs":w(n,`@forinda/kickjs`),"@forinda/kickjs-schema":w(n,`@forinda/kickjs-schema`),dotenv:`^17.3.1`,"reflect-metadata":`^0.2.2`,[s.name]:s.range};a===`express`?c.express=`^5.1.0`:a===`fastify`?(c.fastify=`^5.0.0`,c[`@fastify/middie`]=`^9.0.0`,c[`serve-static`]=`^2.2.0`):a===`h3`&&(c.h3=`^1.0.0`,c[`serve-static`]=`^2.2.0`);for(let e of r){let t=S[e];t&&!c[t]&&(c[t]=w(n,t))}return JSON.stringify({name:e,version:`0.0.0`,type:`module`,scripts:{dev:`kick dev`,build:`kick build`,start:`kick start`,test:`vitest run`},dependencies:c,devDependencies:{"@forinda/kickjs-cli":w(n,`@forinda/kickjs-cli`),"@forinda/kickjs-testing":w(n,`@forinda/kickjs-testing`),"@forinda/kickjs-vite":w(n,`@forinda/kickjs-vite`),"@types/supertest":`^7.2.1`,"@swc/core":`^1.15.21`,...a===`express`?{"@types/express":`^5.0.6`}:{},"@types/node":`^25.0.0`,"unplugin-swc":`^1.5.9`,vite:`^8.0.3`,supertest:`^7.2.2`,vitest:`^4.1.2`,typescript:`^7.0.2`,...o?{"@typescript/typescript6":`^6.0.2`}:{},oxfmt:`^0.65.0`,oxlint:`^1.80.0`}},null,2)}function E(){return`import { defineConfig } from 'vite'
-import { fileURLToPath } from 'node:url'
-import swc from 'unplugin-swc'
-import { kickjsVitePlugin, envWatchPlugin } from '@forinda/kickjs-vite'
-
-export default defineConfig({
-  oxc: false,
-  plugins: [
-    swc.vite(),
-    kickjsVitePlugin({ entry: 'src/index.ts' }),
-    // Watches .env files and triggers a full reload on change so the
-    // dev server picks up env tweaks without a manual restart.
-    envWatchPlugin(),
-  ],
-  resolve: {
-    alias: {
-      '@': fileURLToPath(new URL('./src', import.meta.url)),
-    },
-  },
-  build: {
-    target: 'node20',
-    ssr: true,
-    outDir: 'dist',
-    sourcemap: true,
-    rollupOptions: {
-      input: fileURLToPath(new URL('./src/index.ts', import.meta.url)),
-      output: { format: 'esm' },
-    },
-  },
-})
-`}function te(){return JSON.stringify({compilerOptions:{target:`ES2022`,module:`ESNext`,moduleResolution:`bundler`,lib:[`ES2022`],types:[`node`,`vite/client`],strict:!0,esModuleInterop:!0,skipLibCheck:!0,sourceMap:!0,declaration:!0,experimentalDecorators:!0,emitDecoratorMetadata:!0,outDir:`dist`,paths:{"@/*":[`./src/*`]}},include:[`src`,`.kickjs/types/**/*.d.ts`,`.kickjs/types/**/*.ts`]},null,2)}function ne(){return JSON.stringify({$schema:`./node_modules/oxfmt/configuration_schema.json`,semi:!1,singleQuote:!0,trailingComma:`all`,printWidth:100,tabWidth:2,ignorePatterns:[`**/dist/`,`**/.kickjs/`,`**/node_modules/`]},null,2)}function re(){return`# https://editorconfig.org
-root = true
-
-[*]
-indent_style = space
-indent_size = 2
-end_of_line = lf
-charset = utf-8
-trim_trailing_whitespace = true
-insert_final_newline = true
-
-[*.md]
-trim_trailing_whitespace = false
-`}function ie(){return`node_modules/
-dist/
-.env
-# Machine-specific: each developer's test env differs (database names, ports).
-# The shared template is the committed \`.env.test.example\`.
-.env.test
-*.local
-coverage/
-.DS_Store
-*.tsbuildinfo
-.kickjs/
-`}function ae(){return`# Auto-detect text files and normalise line endings to LF
-* text=auto eol=lf
-
-# Explicitly mark generated / binary files
-*.png binary
-*.jpg binary
-*.jpeg binary
-*.gif binary
-*.ico binary
-*.woff binary
-*.woff2 binary
-*.ttf binary
-*.eot binary
-
-# Lock files — treat as generated
-pnpm-lock.yaml -diff linguist-generated
-yarn.lock -diff linguist-generated
-package-lock.json -diff linguist-generated
-`}function oe(){return`PORT=3000
-NODE_ENV=development
-`}function se(){return`PORT=3000
-NODE_ENV=development
-`}function D(){return`# Read INSTEAD of .env when NODE_ENV=test (or under vitest).
-# No fallback to .env — declare here everything the suite needs, so a
-# missing var fails the run instead of silently resolving to your dev value.
-#
-# Not committed. Add new keys to .env.test.example too, with placeholder
-# values — never real endpoints or credentials.
-NODE_ENV=test
-PORT=0
-LOG_LEVEL=silent
-`}function ce(){return`# Template for .env.test. Copy it and fill in your machine's values:
-#   cp .env.test.example .env.test
-${D()}`}function O(){return`import { defineConfig, mergeConfig } from 'vitest/config'
-import viteConfig from './vite.config.ts'
-
-// A \`vitest.config.ts\` OVERRIDES \`vite.config.ts\` outright — vitest does not
-// merge the two, and it never reads tsconfig \`paths\`. Restating settings here
-// would mean the \`@\` alias lives in three files and drifts in two of them, so
-// merge the real config instead: the alias, plugins, and ssr externals all come
-// from one place.
-export default mergeConfig(
-  viteConfig,
-  defineConfig({
-    test: {
-      globals: true,
-      environment: 'node',
-      include: ['src/**/*.test.ts'],
-    },
-  }),
-)
-`}const k={express:{from:`@forinda/kickjs`,name:`expressRuntime`},fastify:{from:`@forinda/kickjs/fastify`,name:`fastifyRuntime`},h3:{from:`@forinda/kickjs/h3`,name:`h3Runtime`}};function A(e,t,n,r=[],i=`express`,a){let o=k[i],s=i===`express`;switch(t){case`minimal`:{let t=[],i=[],c=s?`import { bootstrap, ${o.name} } from '@forinda/kickjs'`:`import { bootstrap } from '@forinda/kickjs'\nimport { ${o.name} } from '${o.from}'`;r.includes(`swagger`)&&(t.push(`import { SwaggerAdapter } from '@forinda/kickjs-swagger'`),i.push(`    SwaggerAdapter({ info: { title: '${e}', version: '${n}' } }),`)),r.includes(`devtools`)&&(t.push(`import { DevToolsAdapter } from '@forinda/kickjs-devtools'`),i.push(`    DevToolsAdapter(),`)),a&&(t.push(`import { SpaAdapter } from '@forinda/kickjs/spa'`),i.push(`    // 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(a)} }),`));let l=t.length?t.join(`
-`)+`
-`:``,u=i.length?`,\n  adapters: [\n${i.join(`
-`)}\n  ]`:``;return`import 'reflect-metadata'
-// Side-effect import — registers the extended env schema with kickjs
-// **before** any controller / service / @Value gets resolved. Without
-// this line ConfigService.get('YOUR_KEY') returns undefined because the
-// cached schema would still be the base shape. See guide/configuration.
-import './config'
-${c}
-${l}import { modules } from './modules'
-
-// Export the app for the Vite plugin (dev mode)
-export const app = await bootstrap({ modules, runtime: ${o.name}()${u} })
-`}default:{let t=[],i=[];r.includes(`devtools`)&&(t.push(`import { DevToolsAdapter } from '@forinda/kickjs-devtools'`),i.push(`    DevToolsAdapter(),`)),r.includes(`swagger`)&&(t.push(`import { SwaggerAdapter } from '@forinda/kickjs-swagger'`),i.push(`    SwaggerAdapter({\n      info: { title: '${e}', version: '${n}' },\n    }),`));let a=t.length?t.join(`
-`)+`
-`:``,c=i.length?`\n  adapters: [\n${i.join(`
-`)}\n  ],`:``,l=[`bootstrap`,`requestId`,`requestLogger`,`helmet`,`cors`];s&&l.push(o.name);let u=s?`import express from 'express'\nimport {\n  ${l.join(`,
-  `)},\n} from '@forinda/kickjs'`:`import {\n  ${l.join(`,
-  `)},\n} from '@forinda/kickjs'\nimport { ${o.name} } from '${o.from}'`,d=s?`
-    express.json(),`:``;return`import 'reflect-metadata'
-// Side-effect import — registers the extended env schema with kickjs
-// **before** any controller / service / @Value gets resolved. Without
-// this line ConfigService.get('YOUR_KEY') returns undefined because the
-// cached schema would still be the base shape. See guide/configuration.
-import './config'
-${u}
-${a}import { modules } from './modules'
-
-// Export the app for the Vite plugin (dev mode)
-export const app = await bootstrap({
-  modules,
-  runtime: ${o.name}(),${c}
-  middlewares: [
-    // Security headers. The framework injects helmet() with these defaults
-    // anyway — declaring it here is what lets you CHANGE them, e.g.
-    // helmet({ frameguard: 'SAMEORIGIN' }) or helmet({ hsts: false }).
-    // Auto-injection stands down as soon as this line is present.
-    helmet(),
-    cors({ origin: '*' }),
-    requestId(),
-    requestLogger(),${d}
-  ],
-})
-`}}}function j(){return`import { defineModules } from '@forinda/kickjs'
-import { HelloModule } from './hello/hello.module'
-
-// Remove HelloModule and run: kick g module <name>
-// \`defineModules()\` returns a chainable list — \`kick g module\` appends
-// \`.mount(NewModule())\` to the chain on every generation.
-export const modules = defineModules().mount(HelloModule())
-`}function M(e=`zod`){return e===`valibot`?`import { loadEnvFromSchema } from '@forinda/kickjs/config'
-import { fromValibot } from '@forinda/kickjs-schema/valibot'
-import * as v from 'valibot'
-
-/**
- * Project environment schema (Valibot).
- *
- * \`fromValibot\` wraps the Valibot schema as a \`KickSchema\` so the
- * env loader, validate middleware, and swagger spec generator all see
- * the same shape. The default export is the contract \`kick typegen\`
- * reads to populate \`KickEnv\` via \`InferSchemaOutput<typeof _envSchema>\`
- * — that's what makes \`@Value('FOO')\` autocomplete and
- * \`process.env.FOO\` typed.
- *
- * @example
- *   DATABASE_URL: v.pipe(v.string(), v.url()),
- *   JWT_SECRET:   v.pipe(v.string(), v.minLength(32)),
- *   REDIS_URL:    v.optional(v.pipe(v.string(), v.url())),
- */
-const envSchema = fromValibot(
-  v.object({
-    PORT: v.optional(v.pipe(v.string(), v.transform(Number)), '3000'),
-    NODE_ENV: v.optional(v.picklist(['development', 'production', 'test']), 'development'),
-    LOG_LEVEL: v.optional(v.string(), 'info'),
-    // DATABASE_URL: v.pipe(v.string(), v.url()),
-  }),
-)
-
-/**
- * IMPORTANT — side effect: register the schema with kickjs's env cache
- * **at module-load time**. \`ConfigService\` and \`@Value()\` both consume
- * this cache, and they will fall back to the base schema (or undefined)
- * if no extended schema has been registered before they're resolved.
- *
- * As long as \`src/index.ts\` imports this file (\`import './config'\`) at
- * the top — before \`bootstrap()\` runs — every controller and service
- * in the app sees the typed extended values.
- */
-export const env = loadEnvFromSchema(envSchema)
-
-export default envSchema
-`:e===`yup`?`import { loadEnvFromSchema } from '@forinda/kickjs/config'
-import { fromYup } from '@forinda/kickjs-schema/yup'
-import * as yup from 'yup'
-
-/**
- * Project environment schema (Yup).
- *
- * \`fromYup\` wraps the Yup schema as a \`KickSchema\` so the env loader,
- * validate middleware, and swagger spec generator all see the same
- * shape. The default export is the contract \`kick typegen\` reads to
- * populate \`KickEnv\` via \`InferSchemaOutput<typeof _envSchema>\`.
- *
- * Note: Yup's \`.url()\` defaults to http/https; database connection
- * strings like \`postgres://\` use \`.matches(/^[a-z]+:\\/\\/.+/i)\` or
- * a plain \`.string().required()\`.
- *
- * @example
- *   DATABASE_URL: yup.string().required(),
- *   JWT_SECRET:   yup.string().min(32).required(),
- *   REDIS_URL:    yup.string().url().optional(),
- */
-const envSchema = fromYup(
-  yup.object({
-    PORT: yup.number().default(3000),
-    NODE_ENV: yup
-      .string()
-      .oneOf(['development', 'production', 'test'])
-      .default('development'),
-    LOG_LEVEL: yup.string().default('info'),
-    // DATABASE_URL: yup.string().required(),
-  }),
-)
-
-/**
- * IMPORTANT — side effect: register the schema with kickjs's env cache
- * **at module-load time**. \`ConfigService\` and \`@Value()\` both consume
- * this cache, and they will fall back to the base schema (or undefined)
- * if no extended schema has been registered before they're resolved.
- *
- * As long as \`src/index.ts\` imports this file (\`import './config'\`) at
- * the top — before \`bootstrap()\` runs — every controller and service
- * in the app sees the typed extended values.
- */
-export const env = loadEnvFromSchema(envSchema)
-
-export default envSchema
-`:`import { loadEnvFromSchema } from '@forinda/kickjs/config'
-import { fromZod } from '@forinda/kickjs-schema/zod'
-import { z } from 'zod'
-
-/**
- * Project environment schema (Zod).
- *
- * \`fromZod\` wraps the Zod schema as a \`KickSchema\` so the env loader,
- * validate middleware, and swagger spec generator all see the same
- * shape. The default export is the contract \`kick typegen\` reads to
- * populate \`KickEnv\` via \`InferSchemaOutput<typeof _envSchema>\` —
- * that's what makes \`@Value('FOO')\` autocomplete and
- * \`process.env.FOO\` typed.
- *
- * @example
- *   DATABASE_URL: z.string().url(),
- *   JWT_SECRET: z.string().min(32),
- *   REDIS_URL: z.string().url().optional(),
- */
-const envSchema = fromZod(
-  z.object({
-    PORT: z.coerce.number().default(3000),
-    NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
-    LOG_LEVEL: z.string().default('info'),
-    // DATABASE_URL: z.string().url(),
-  }),
-)
-
-/**
- * IMPORTANT — side effect: register the schema with kickjs's env cache
- * **at module-load time**. \`ConfigService\` and \`@Value()\` both consume
- * this cache, and they will fall back to the base schema (or undefined)
- * if no extended schema has been registered before they're resolved.
- *
- * As long as \`src/index.ts\` imports this file (\`import './config'\`) at
- * the top — before \`bootstrap()\` runs — every controller and service
- * in the app sees the typed extended values.
- */
-export const env = loadEnvFromSchema(envSchema)
-
-export default envSchema
-`}function N(){return`import { Service } from '@forinda/kickjs'
-
-@Service()
-export class HelloService {
-  greet(name: string) {
-    return { message: \`Hello \${name} from KickJS!\`, timestamp: new Date().toISOString() }
-  }
-
-  healthCheck() {
-    return { status: 'ok', uptime: process.uptime() }
-  }
-}
-`}function P(){return`import { Controller, Get, Autowired, type Ctx } from '@forinda/kickjs'
-import { HelloService } from './hello.service'
-
-// \`Ctx<KickRoutes.HelloController['<method>']>\` is generated by
-// \`kick typegen\` (auto-run on \`kick dev\`). The first run after a fresh
-// scaffold creates \`.kickjs/types/routes.ts\` so this file typechecks.
-// See https://kickjs.app/guide/typegen.
-
-@Controller()
-export class HelloController {
-  @Autowired() private readonly helloService!: HelloService
-
-  // Return-value handlers: the runtime sends the returned payload as
-  // 200 json, and \`kick typegen\` infers the response type into
-  // \`KickRoutes.Api\` — which is what makes the typed client
-  // (@forinda/kickjs-client) end-to-end type-safe.
-  @Get('/')
-  index(_ctx: Ctx<KickRoutes.HelloController['index']>) {
-    return this.helloService.greet('World')
-  }
-
-  @Get('/health')
-  health(_ctx: Ctx<KickRoutes.HelloController['health']>) {
-    return this.helloService.healthCheck()
-  }
-}
-`}function F(){return`import { defineModule } from '@forinda/kickjs'
-import { HelloController } from './hello.controller'
-
-export const HelloModule = defineModule({
-  name: 'HelloModule',
-  build: () => ({
-    // \`register(container)\` is optional — only implement it when you need
-    // to bind a token to a concrete implementation, e.g.
-    //   register(container) {
-    //     container.registerFactory(USER_REPOSITORY, () => container.resolve(InMemoryUserRepository))
-    //   }
-    // The HelloService uses @Service() so the decorator handles registration.
-
-    routes() {
-      return {
-        path: '/hello',
-        controller: HelloController,
-      }
-    },
-  }),
-})
-`}function I(e,t=`inmemory`,n=`pnpm`,r=`express`,i=!1){return`import { defineConfig } from '@forinda/kickjs-cli'
-
-export default defineConfig({
-  pattern: '${e}',
-  // The HTTP engine this app boots on (matches \`bootstrap({ runtime })\` in
-  // src/index.ts). Dep-aware commands read it: \`kick add upload\` installs the
-  // engine's multipart driver, \`kick doctor\` checks the engine peers, and
-  // \`kick typegen\` flips the runtime escape-hatch types to this engine.
-  runtime: '${r}',
-  // Pinned so \`kick add\` and other dep-installing commands always use the
-  // project's intended package manager, regardless of which lockfile exists.
-  packageManager: '${n}',
-  modules: {
-    dir: 'src/modules',
-    repo: ${t===`inmemory`?`'inmemory'`:`{ name: '${t}' }`},
-    pluralize: true,
-  },
-
-  // \`kick typegen\` populates \`.kickjs/types/\` so \`Ctx<KickRoutes.X['method']>\`
-  // resolves to fully-typed params/body/query. Auto-runs on \`kick dev\`.
-  // \`'kickjs-schema'\` routes inference through \`InferSchemaOutput\` so the
-  // typegen works for any wrapped schema (Zod / Valibot / Yup). Switch
-  // to \`'zod'\` if you ship Zod schemas without \`fromZod()\` wrapping, or
-  // set \`schemaValidator: false\` to skip schema-driven body typing.
-  typegen: {
-    schemaValidator: 'kickjs-schema',${i?`
-    // web/ reads this map from the ambient KickClientApi namespace. Producing
-    // it builds a TypeScript program over the server, so it stays off unless a
-    // project actually consumes it.
-    client: true,`:``}
-  },
-
-  commands: [
-    {
-      name: 'test',
-      description: 'Run tests with Vitest',
-      steps: 'vitest run',
-    },
-    {
-      name: 'lint',
-      description: 'Lint with oxlint',
-      steps: 'oxlint src/',
-    },
-    {
-      name: 'format',
-      description: 'Format code with oxfmt',
-      steps: 'oxfmt src/',
-    },
-    {
-      name: 'format:check',
-      description: 'Check formatting without writing',
-      steps: 'oxfmt --check src/',
-    },
-    {
-      name: 'ci:check',
-      description: 'Run typecheck + lint + format check',
-      steps: ['kick typecheck', 'oxlint src/', 'oxfmt --check src/'],
-      aliases: ['verify'],
-    },
-  ],
-})
-`}const L={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`},swagger:{pkg:`@forinda/kickjs-swagger`,peers:[],description:`OpenAPI spec + Swagger UI + ReDoc`},db:{pkg:`@forinda/kickjs-db`,peers:[],description:`kick/db core — schema DSL, migrations, KickDbClient, customType`},pg:{pkg:`@forinda/kickjs-db`,peers:[`pg`],description:`kick/db + PostgreSQL driver (use @forinda/kickjs-db/pg)`},sqlite:{pkg:`@forinda/kickjs-db`,peers:[`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`],description:`Queue with BullMQ + Redis`},"queue:rabbitmq":{pkg:`@forinda/kickjs-queue`,peers:[`amqplib`],description:`Queue with RabbitMQ`},"queue:kafka":{pkg:`@forinda/kickjs-queue`,peers:[`kafkajs`],description:`Queue with Kafka`},"queue:redis-pubsub":{pkg:`@forinda/kickjs-queue`,peers:[`ioredis`],description:`Lightweight pub/sub via Redis (no persistence)`},mcp:{pkg:`@forinda/kickjs-mcp`,peers:[`@modelcontextprotocol/sdk`],description:`Model Context Protocol server — expose @Controller endpoints as AI tools`},testing:{pkg:`@forinda/kickjs-testing`,peers:[],description:`Test utilities and TestModule builder`,dev:!0}},R=Object.entries(L).filter(([e,t])=>!t.core&&!t.deprecated&&!e.includes(`:`)&&![`pg`,`sqlite`,`mysql`,`zod`,`valibot`,`yup`].includes(e)).map(([e])=>e).join(`, `),z={express:[`express`],fastify:[`fastify`,`@fastify/middie`,`serve-static`],h3:[`h3`,`serve-static`]},B={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 V(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 H(e=process.cwd()){return(await U(e)).runtime}async function U(t=process.cwd()){let n=(await e(t))?.runtime;return n===`express`||n===`fastify`||n===`h3`?{runtime:n,candidates:[n],ambiguous:!1,fromConfig:!0}:{...G(t),fromConfig:!1}}const W=[[`express`,`express`],[`fastify`,`fastify`],[`h3`,`h3`]];function G(e=process.cwd()){let t=K(`package.json`,e);if(!t)return{runtime:`express`,candidates:[],ambiguous:!1};let n={},r={};try{let e=JSON.parse(a(c(t,`package.json`),`utf-8`));n=e.dependencies??{},r=e.devDependencies??{}}catch{return{runtime:`express`,candidates:[],ambiguous:!1}}let i=W.filter(([e])=>e in n).map(([,e])=>e),o=W.filter(([e])=>e in r&&!(e in n)).map(([,e])=>e),s=[...i,...o];return i.length===1?{runtime:i[0],candidates:s,ambiguous:!1}:i.length===0&&o.length===1?{runtime:o[0],candidates:s,ambiguous:!1}:s.length===0?{runtime:`express`,candidates:s,ambiguous:!1}:{runtime:`express`,candidates:s,ambiguous:!0}}function K(e,t=process.cwd()){let n=t;for(;;){if(i(c(n,e)))return n;let t=o(n);if(t===n)return null;n=t}}function le(){return K(`pnpm-lock.yaml`)?`pnpm`:K(`yarn.lock`)?`yarn`:K(`bun.lockb`)||K(`bun.lock`)?`bun`:K(`package-lock.json`)?`npm`:null}function ue(){let e=process.cwd();for(;e;){let n=c(e,`package.json`);if(i(n))try{let e=JSON.parse(a(n,`utf-8`)).packageManager;if(typeof e==`string`){let n=e.split(`@`)[0];if(t.includes(n))return n}}catch{}let r=o(e);if(r===e)return null;e=r}return null}async function q(n){if(n&&t.includes(n))return{pm:n,source:`flag`};let r=await e(process.cwd());if(r?.packageManager&&t.includes(r.packageManager))return{pm:r.packageManager,source:`config`};let i=ue();if(i)return{pm:i,source:`package.json`};let a=le();return a?{pm:a,source:`lockfile`}:{pm:`npm`,source:`default`}}async function de(e){let{pm:t}=await q(e);return t}function J(e=!1,t){let n=Object.entries(L),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,...z[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()}function fe(e,t,n=`express`){let r=new Set,i=new Set,a=[],o=[],s=[];for(let c of e){if(c===`upload`){let e=B[n];s.push(`upload (${n}): ${e.note}`),e.prod&&(t?i:r).add(e.prod),e.dev&&i.add(e.dev);continue}let e=L[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);if(e.enginePeers){let e=z[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 pe(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=>{J(!!e.all,V(e.runtime)??await H())})}function me(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`).action(async(e,t)=>{if(t.list||e.length===0){J(!!t.all,V(t.runtime)??await H());return}let{pm:n,source:r}=await q(t.pm);console.log(`\n  Using ${n} (resolved from ${r})`);let i=V(t.runtime),a=await U(process.cwd()),o=i??a.runtime;if(!i&&a.ambiguous){console.error(`\n  Cannot tell which HTTP engine this app boots on: found ${a.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 <${a.candidates.join(`|`)}> for this command\n`),process.exitCode=1;return}let{prodDeps:s,devDeps:c,unknown:l,warnings:u,notices:d}=fe(e,!!t.dev,o);for(let e of u)console.warn(`\n  WARNING: ${e}`);for(let e of d)console.log(`\n  ${e}`);if(!(l.length>0&&(console.log(`\n  Unknown packages: ${l.join(`, `)}`),console.log(`  Run "kick add --list" to see available packages.
-`),s.length===0&&c.length===0))){if(s.length>0){let e=s,t=`${n} add ${e.join(` `)}`;console.log(`\n  Installing ${e.length} dependency(ies):`);for(let t of e)console.log(`    + ${t}`);console.log();try{f(t,{stdio:`inherit`})}catch{console.log(`\n  Installation failed. Run manually:\n    ${t}\n`)}}if(c.length>0){let e=c,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{f(t,{stdio:`inherit`})}catch{console.log(`\n  Installation failed. Run manually:\n    ${t}\n`)}}console.log(`  Done!
-`)}})}const Y=o(l(import.meta.url)),X=JSON.parse(a([s(Y,`..`,`package.json`),s(Y,`..`,`..`,`package.json`)].find(i),`utf-8`)),he=[`@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`];function Z(e){return e===`@forinda/kickjs-cli`?`^${X.version}`:`latest`}async function Q(){let e=await Promise.all(he.map(async e=>{let t=await x(`npm`,[`view`,e,`version`],{timeout:2e4});return t&&/^\d+\.\d+\.\d+/.test(t)?[e,`^${t}`]:[e,Z(e)]}));return Object.fromEntries(e)}function ge(e,t){let n=v(`npm`,[`view`,`${e}@${t}`,`version`],{timeout:2e4});return n&&/^\d+\.\d+\.\d+/.test(n)?n:null}function $(e){return(e??``).replace(/^[\^~>=<\s]+/,``)}function _e(e,t){let n=e=>$(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 ve(e,t,n){let r=v(`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 ye(e){let{name:t,directory:i,packageManager:a=`pnpm`,template:o=`rest`,defaultRepo:c=`inmemory`,packages:l=[],schemaLib:u=`zod`,runtime:d=`express`}=e,p=i,m=e=>console.log(`  ${e}`);console.log(`\n  Creating KickJS project: ${t}\n`),m(`Resolving package versions...`);let h=await Q(),g=Object.keys(h).filter(e=>h[e]===`latest`);if(g.length>0&&m(`WARNING: could not reach npm for ${g.join(`, `)} — pinned to 'latest'`),d!==`express`){if(ve(`@forinda/kickjs`,`latest`,`./${d}`))m(`Using @forinda/kickjs@latest (stable ships the ${d} runtime)`);else{let e=[`@forinda/kickjs`,`@forinda/kickjs-cli`,`@forinda/kickjs-vite`],t=[],n=!1;for(let r of e){let e=ge(r,`alpha`);e&&_e(e,$(h[r]))&&(h[r]=`^${e}`,t.push(`${r}@^${e}`),r===`@forinda/kickjs`&&(n=!0))}m(n?`Using the alpha channel for the ${d} runtime: ${t.join(`, `)}`:`WARNING: could not resolve @forinda/kickjs@alpha — the ${d} runtime subpath may be missing. After install, run: ${a} add @forinda/kickjs@alpha`)}}await n(s(p,`package.json`),T(t,o,h,l,u,d,e.withClientMap)),await n(s(p,`vite.config.ts`),E()),await n(s(p,`tsconfig.json`),te()),await n(s(p,`.oxfmtrc.json`),ne()),await n(s(p,`.editorconfig`),re()),await n(s(p,`.gitignore`),ie()),await n(s(p,`.gitattributes`),ae()),await n(s(p,`.env`),oe()),await n(s(p,`.env.example`),se()),await n(s(p,`.env.test`),D()),await n(s(p,`.env.test.example`),ce()),await n(s(p,`src/config/index.ts`),M(u)),await n(s(p,`src/index.ts`),A(t,o,X.version,l,d,e.spaClientDir)),await n(s(p,`src/modules/index.ts`),j()),await n(s(p,`src/modules/hello/hello.service.ts`),N()),await n(s(p,`src/modules/hello/hello.controller.ts`),P()),await n(s(p,`src/modules/hello/hello.module.ts`),F()),await n(s(p,`kick.config.ts`),I(o,c,a,d,e.withClientMap)),await n(s(p,`vitest.config.ts`),O()),await n(s(p,`README.md`),r(t,o,a));let{generateAgentDocs:_}=await import(`./agent-docs-ckWIFTVN.mjs`).then(e=>e.t);if(await _({outDir:p,name:t,pm:a,template:o,only:`all`,force:!0}),e.installDeps){console.log(`\n  Installing dependencies with ${a}...\n`);try{f(`${a} install`,{cwd:p,stdio:`inherit`}),console.log(`
-  Dependencies installed successfully!`)}catch{console.log(`\n  Warning: ${a} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-CoIiSCqa.mjs`).then(e=>e.n);await e({cwd:p,allowDuplicates:!0,silent:!0})}catch{}if(e.initGit)try{f(`git init`,{cwd:p,stdio:`pipe`}),f(`git branch -M main`,{cwd:p,stdio:`pipe`}),f(`git add -A`,{cwd:p,stdio:`pipe`}),f(`git commit -m "chore: initial commit from kick new"`,{cwd:p,stdio:`pipe`}),m(`Git repository initialized`)}catch{m(`Warning: git init failed (git may not be installed)`)}console.log(`
-  Project scaffolded successfully!`),console.log();let v=p!==process.cwd();m(`Next steps:`),v&&m(`  cd ${t}`),e.installDeps||m(`  ${a} install`);let y={rest:`kick g module user`,minimal:`# add your routes to src/index.ts`};m(`  ${y[o]??y.rest}`),m(`  kick dev`),m(``),m(`Commands:`),m(`  kick dev                  Start dev server with Vite HMR`),m(`  kick build                Production build via Vite`),m(`  kick start                Run production build`),m(``),m(`Generators:`),m(`  kick g module <name>      REST module (controller, service, DTOs, repository)`),m(`  kick g scaffold <n> <f..> CRUD module from field definitions`),m(`  kick g controller <name>  Standalone controller`),m(`  kick g service <name>     @Service() class`),m(`  kick g middleware <name>   Global connect-style middleware`),m(`  kick g guard <name>       Route guard (auth, roles, etc.)`),m(`  kick g adapter <name>     AppAdapter with lifecycle hooks`),m(`  kick g dto <name>         DTO schema (Zod / Valibot / Yup)`),m(`  kick g config             Generate kick.config.ts`),m(``),m(`Add packages:`),m(`  kick add <pkg>            Install a KickJS package + peers`),m(`  kick add --list           Show all available packages`),m(``),m(`Available: ${R}`),m(``)}export{me as a,de as c,b as d,B as i,y as l,Q as n,pe as o,L as r,H as s,ye as t,ee as u};