@forinda/kickjs-cli 8.6.1 → 8.7.0

package/dist/{fullstack-BKD9McZF.mjs.map → fullstack-CjwAefj4.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"fullstack-BKD9McZF.mjs","names":[],"sources":["../src/generators/fullstack.ts"],"sourcesContent":["// `kick new --template fullstack` — a pnpm-workspace monorepo:\n//\n//   my-app/\n//     server/   KickJS API (the standard scaffold, minus its own git/install)\n//     web/      Vite + React frontend typed end-to-end via\n//               @forinda/kickjs-client + the server's generated KickRoutes.Api\n//\n// The type loop: server controllers use return-value handlers → `kick\n// typegen` (run here once, re-run by `kick dev`) emits\n// server/.kickjs/types/kick__client.d.ts → web tsconfig `types` (ambient)\n// side-effect-imports that file (type-only, erased at runtime) → the web\n// client calls `api.get('/hello')` with the handler's actual response type.\n\nimport { join } from 'node:path'\nimport { execFileSync } from 'node:child_process'\n\nimport { writeFileSafe } from '../utils/fs'\nimport { runCommand } from '../utils/shell'\nimport { initProject, resolveSiblingVersions } from './project'\nimport { approveInstallScripts } from '../commands/add'\nimport { fillVars, renderLayers } from '../scaffold/overlay'\n\n/** Wiring a frontend we did not scaffold: typed client, proxy, route types. */\nexport const FRONTEND_WIRING_URL = 'https://kickjs.app/guide/fullstack-frontend.html'\n\n/**\n * create-vite's TypeScript templates, in the order it lists them. Only the\n * `-ts` half: the wiring is typed — the route map is a `.d.ts` and the client\n * is `createClient<KickClientApi.Api>` — so a JavaScript template would leave\n * the reader following a guide that cannot apply.\n */\nexport const VITE_TEMPLATES = [\n  { value: 'react-ts', label: 'React' },\n  { value: 'react-compiler-ts', label: 'React + Compiler' },\n  { value: 'vue-ts', label: 'Vue' },\n  { value: 'svelte-ts', label: 'Svelte' },\n  { value: 'solid-ts', label: 'Solid' },\n  { value: 'preact-ts', label: 'Preact' },\n  { value: 'lit-ts', label: 'Lit' },\n  { value: 'qwik-ts', label: 'Qwik' },\n  { value: 'vanilla-ts', label: 'Vanilla' },\n] as const\n\nexport const DEFAULT_VITE_TEMPLATE = 'react-ts'\n\n/**\n * How each package manager runs create-vite, with the framework decided here\n * rather than by its prompts:\n *\n * - `--template` picks a TypeScript template, so the wiring guide applies;\n * - `--no-interactive` means it never waits for input (CI, `--yes`);\n * - `--no-immediate` stops it installing and launching a dev server — the\n *   workspace install happens once, at the root, after this returns.\n */\nexport function createViteCommand(\n  pm: 'pnpm' | 'npm' | 'yarn' | 'bun',\n  dir: string,\n  template: string = DEFAULT_VITE_TEMPLATE,\n): string[] {\n  const flags = ['--template', template, '--no-interactive', '--no-immediate']\n  // yarn and bun resolve `create vite` to create-vite themselves; npm and pnpm\n  // take the versioned package name, and npm needs `--` before the flags or it\n  // eats them itself.\n  if (pm === 'yarn' || pm === 'bun') return [pm, 'create', 'vite', dir, ...flags]\n  if (pm === 'npm') return [pm, 'create', 'vite@latest', dir, '--', ...flags]\n  return [pm, 'create', 'vite@latest', dir, ...flags]\n}\n\nexport interface InitFullstackOptions {\n  name: string\n  directory: string\n  packageManager?: 'pnpm' | 'npm' | 'yarn' | 'bun'\n  /**\n   * Who scaffolds `web/`. `'kick'` writes the wired React app (typed client,\n   * dev proxy, route-map types). `'vite'` hands the directory to\n   * `create-vite` and wires nothing — you pick the framework, and the guide\n   * at {@link FRONTEND_WIRING_URL} covers connecting it.\n   */\n  frontend?: 'kick' | 'vite'\n  /** create-vite template for `frontend: 'vite'`. Default `react-ts`. */\n  viteTemplate?: string\n  initGit?: boolean\n  installDeps?: boolean\n  schemaLib?: 'zod' | 'valibot' | 'yup'\n  runtime?: 'express' | 'fastify' | 'h3'\n  /** Optional packages (`--packages`), wired into the server like a plain scaffold. */\n  packages?: string[]\n}\n\nexport async function initFullstackProject(options: InitFullstackOptions): Promise<void> {\n  const {\n    name,\n    directory,\n    schemaLib = 'zod',\n    runtime = 'express',\n    packages = [],\n    frontend = 'kick',\n    viteTemplate = DEFAULT_VITE_TEMPLATE,\n  } = options\n  // `--pm` arrives as a free CLI string — allowlist before it reaches a\n  // process invocation (execFileSync takes an argv array, no shell, but a\n  // bogus binary name is still a confusing failure).\n  const pmValid = (['pnpm', 'npm', 'yarn', 'bun'] as const).includes(\n    options.packageManager as never,\n  )\n  const packageManager = pmValid\n    ? (options.packageManager as 'pnpm' | 'npm' | 'yarn' | 'bun')\n    : 'pnpm'\n  const dir = directory\n  const log = (msg: string) => console.log(`  ${msg}`)\n  if (options.packageManager !== undefined && !pmValid) {\n    log(\n      `Warning: unknown package manager '${String(options.packageManager)}' — falling back to pnpm.`,\n    )\n  }\n\n  console.log(`\\n  Creating fullstack KickJS workspace: ${name}\\n`)\n\n  // One map for both packages: the workspace shares a toolchain, so server/\n  // and web/ must not end up on different vite or TypeScript majors.\n  console.log('  Resolving package versions...')\n  const versions = await resolveSiblingVersions()\n\n  // ── server/ — the standard scaffold, deferred install/git ──────────\n  const server = await initProject({\n    name: `${name}-server`,\n    directory: join(dir, 'server'),\n    packageManager,\n    template: 'minimal',\n    schemaLib,\n    runtime,\n    packages,\n    // The client route map web/ reads (with the compiler API it needs), and a\n    // strict port — web/vite.config.ts proxies /api to it, so moving to\n    // another port would silently reach the wrong process.\n    extraLayers: ['server-fullstack'],\n    // server/ is a workspace member; the root records the approvals.\n    approveInstallScripts: false,\n    // netlify.toml / vercel.json live at the workspace root, written below.\n    platformConfig: false,\n    // Root owns install + git so the lockfile/commit cover the workspace.\n    initGit: false,\n    installDeps: false,\n    // Production single-origin serving. `web/` builds to `web/dist`, and\n    // nothing served it before — `pnpm build` produced a frontend the API had\n    // no way to hand out, so every deploy needed a hand-wired static host or\n    // a second process. The adapter is inert until `../web/dist` exists, so\n    // `dev` (Vite serves the client and proxies /api here) is untouched.\n    spaClientDir: '../web/dist',\n    versions,\n  })\n\n  // ── web/ — either our wired React app, or whatever create-vite makes ──\n  if (frontend === 'vite') {\n    // create-vite scaffolds it with the chosen TypeScript template. Nothing\n    // is patched afterwards: a scaffold we didn't write is not ours to\n    // rewrite, and the wiring is four steps in the guide.\n    console.log(`\\n  Handing web/ to create-vite (${viteTemplate})...\\n`)\n    const [file, ...args] = createViteCommand(packageManager, 'web', viteTemplate)\n    runCommand(file!, args, { cwd: dir })\n  } else {\n    // The wired React app (typed client, dev proxy, route-map types): its\n    // package.json here, its files from the web-kick layer below.\n    await writeFileSafe(join(dir, 'web/package.json'), webPackageJson(name, versions))\n  }\n\n  // ── workspace root ──────────────────────────────────────────────────\n  await writeFileSafe(\n    join(dir, 'package.json'),\n    rootPackageJson(name, packageManager, versions['@forinda/kickjs-cli']),\n  )\n  // Only pnpm reads this file. npm / yarn / bun declare workspaces via the\n  // `workspaces` field in the root package.json instead — see rootPackageJson.\n  if (packageManager === 'pnpm') {\n    await writeFileSafe(join(dir, 'pnpm-workspace.yaml'), 'packages:\\n  - server\\n  - web\\n')\n  }\n  // Before install, at the root every package manager reads them from.\n  approveInstallScripts(packageManager, dir, server.builds)\n  // .gitignore, and netlify.toml / vercel.json at the root both platforms\n  // build from; plus the kick web app's files under web/.\n  const layers = ['fullstack-root', ...(frontend === 'vite' ? [] : ['web-kick'])]\n  const files = fillVars(renderLayers(layers).files, { name, packageManager })\n  for (const [path, contents] of files) {\n    await writeFileSafe(join(dir, path), contents)\n  }\n  await writeFileSafe(join(dir, 'README.md'), rootReadme(name, packageManager, frontend))\n\n  // Workspace-root agent docs (CLAUDE.md + .agents/) flavored for the\n  // fullstack layout — the server/ subdir keeps its own generated set.\n  const { generateAgentDocs } = await import('./agent-docs')\n  await generateAgentDocs({\n    outDir: dir,\n    name,\n    pm: packageManager,\n    template: 'fullstack',\n    only: 'all',\n    force: true,\n  })\n\n  // ── install (root — covers both workspace packages) ────────────────\n  if (options.installDeps) {\n    console.log(`\\n  Installing workspace dependencies with ${packageManager}...\\n`)\n    try {\n      // `runCommand`, not bare execFileSync — on Windows every package\n      // manager is a `.cmd` shim that execFileSync cannot spawn.\n      runCommand(packageManager, ['install'], { cwd: dir })\n    } catch {\n      console.log(`\\n  Warning: ${packageManager} install failed. Run it manually.`)\n    }\n  }\n\n  // ── typegen (server) so web's KickRoutes.Api resolves immediately ──\n  try {\n    const { runTypegen } = await import('../typegen')\n    await runTypegen({ cwd: join(dir, 'server'), allowDuplicates: true, silent: true })\n  } catch {\n    // Non-fatal — `kick dev` in server/ retries on boot.\n  }\n\n  // ── git (root) ──────────────────────────────────────────────────────\n  if (options.initGit) {\n    try {\n      execFileSync('git', ['init'], { cwd: dir, stdio: 'pipe' })\n      execFileSync('git', ['branch', '-M', 'main'], { cwd: dir, stdio: 'pipe' })\n      execFileSync('git', ['add', '-A'], { cwd: dir, stdio: 'pipe' })\n      execFileSync('git', ['commit', '-m', 'chore: initial commit from kick new (fullstack)'], {\n        cwd: dir,\n        stdio: 'pipe',\n      })\n      log('Git repository initialized')\n    } catch {\n      log('Warning: git init failed (git may not be installed)')\n    }\n  }\n\n  console.log('\\n  Fullstack workspace scaffolded!')\n  console.log()\n  log('Next steps:')\n  log(`  cd ${name}`)\n  if (!options.installDeps) log(`  ${packageManager} install`)\n  if (packageManager === 'pnpm') {\n    log('  pnpm dev            # runs server (kick dev) + web (vite) together')\n  } else {\n    log(`  ${packageManager} run dev:server   # terminal 1`)\n    log(`  ${packageManager} run dev:web      # terminal 2`)\n  }\n  log('')\n  if (frontend === 'vite') {\n    // Nothing in web/ knows about the API yet — say so, and say where the\n    // four wiring steps live rather than half-wiring someone else's scaffold.\n    log('web/ is create-vite output, unwired. To type it against the API:')\n    log(`  ${FRONTEND_WIRING_URL}`)\n  } else {\n    log('The web app calls the API through @forinda/kickjs-client —')\n    log(\"edit server/src/modules/hello and watch web/src/App.tsx's types follow.\")\n  }\n  log('')\n}\n\n// ── web templates ─────────────────────────────────────────────────────\n\nfunction webPackageJson(name: string, versions: Record<string, string>): string {\n  // Every range here is resolved at scaffold time — see THIRD_PARTY_PACKAGES.\n  const dep = (pkg: string) => versions[pkg] ?? 'latest'\n  return `${JSON.stringify(\n    {\n      name: `${name}-web`,\n      private: true,\n      version: '0.0.0',\n      type: 'module',\n      scripts: {\n        dev: 'vite',\n        build: 'tsc --noEmit && vite build',\n        preview: 'vite preview',\n        typecheck: 'tsc --noEmit',\n      },\n      dependencies: {\n        '@forinda/kickjs-client': dep('@forinda/kickjs-client'),\n        react: dep('react'),\n        'react-dom': dep('react-dom'),\n      },\n      devDependencies: {\n        '@types/react': dep('@types/react'),\n        '@types/react-dom': dep('@types/react-dom'),\n        '@vitejs/plugin-react': dep('@vitejs/plugin-react'),\n        // Same majors as the server package: one workspace, one toolchain.\n        typescript: dep('typescript'),\n        vite: dep('vite'),\n      },\n    },\n    null,\n    2,\n  )}\\n`\n}\n\n// ── root templates ────────────────────────────────────────────────────\n\nfunction rootPackageJson(name: string, pm: string, cliVersion: string): string {\n  const scripts: Record<string, string> =\n    pm === 'pnpm'\n      ? {\n          dev: 'pnpm --parallel -r run dev',\n          // One origin: the server serves `web/dist` through SpaAdapter.\n          start: 'pnpm --filter ./server run start',\n          'dev:server': 'pnpm --filter ./server dev',\n          'dev:web': 'pnpm --filter ./web dev',\n          // Typegen first: web's `tsc` reads server/.kickjs/types, which is\n          // git-ignored, so a fresh clone (CI, Netlify, Vercel) has none and\n          // `pnpm -r run build` races the two packages anyway.\n          build: 'pnpm --filter ./server exec kick typegen && pnpm -r run build',\n          'build:netlify': 'pnpm build && pnpm --filter ./server exec kick build:netlify',\n          'build:vercel': 'pnpm build && pnpm --filter ./server exec kick build:vercel',\n          // No `npx`: the binary is `kick` but the package is\n          // `@forinda/kickjs-cli`, so npx cannot map one to the other and\n          // falls back to the REGISTRY — where `kick` is an unrelated\n          // AngularJS scaffolder. It runs, prints its own help, and exits 0,\n          // so this script would pass without type-checking anything.\n          //\n          // Every package manager puts `node_modules/.bin` on PATH for\n          // scripts, so the bare name resolves locally, and a missing install\n          // fails loudly instead of fetching a stranger.\n          typecheck: 'kick typecheck --cwd server && kick typecheck --cwd web',\n        }\n      : {\n          // cd-based scripts — the one form npm, yarn (classic AND berry),\n          // and bun all run identically; workspace-filter flags differ per\n          // manager (--workspace vs `yarn workspace <name>` vs --filter).\n          start: `cd server && ${pm} run start`,\n          'dev:server': `cd server && ${pm} run dev`,\n          'dev:web': `cd web && ${pm} run dev`,\n          // Typegen first — see the pnpm branch above.\n          build: `cd server && ${pm} exec kick typegen && cd .. && ${pm} run build:server && ${pm} run build:web`,\n          'build:netlify': `${pm} run build && cd server && ${pm} exec kick build:netlify`,\n          'build:vercel': `${pm} run build && cd server && ${pm} exec kick build:vercel`,\n          'build:server': `cd server && ${pm} run build`,\n          'build:web': `cd web && ${pm} run build`,\n          // No `npx`: the binary is `kick` but the package is\n          // `@forinda/kickjs-cli`, so npx cannot map one to the other and\n          // falls back to the REGISTRY — where `kick` is an unrelated\n          // AngularJS scaffolder. It runs, prints its own help, and exits 0,\n          // so this script would pass without type-checking anything.\n          //\n          // Every package manager puts `node_modules/.bin` on PATH for\n          // scripts, so the bare name resolves locally, and a missing install\n          // fails loudly instead of fetching a stranger.\n          typecheck: 'kick typecheck --cwd server && kick typecheck --cwd web',\n        }\n  return `${JSON.stringify(\n    {\n      name,\n      private: true,\n      version: '0.0.0',\n      type: 'module',\n      scripts,\n      // The CLI is a ROOT dependency so the bare `kick` in the scripts above\n      // resolves: package managers put `node_modules/.bin` on PATH for\n      // scripts, and the CLI otherwise lives only in `server/node_modules`.\n      devDependencies: { '@forinda/kickjs-cli': cliVersion },\n      workspaces: ['server', 'web'],\n    },\n    null,\n    2,\n  )}\\n`\n}\n\nexport function rootReadme(name: string, pm: string, frontend: 'kick' | 'vite' = 'kick'): string {\n  const readme = `# ${name}\n\nFullstack KickJS workspace — typed end to end.\n\n| Package   | What                                                              |\n| --------- | ----------------------------------------------------------------- |\n| \\`server/\\` | KickJS API (decorators, DI, \\`kick dev\\` with typegen watch)       |\n| \\`web/\\`    | Vite + React, typed against the API via \\`@forinda/kickjs-client\\` |\n\n## Develop\n\n\\`\\`\\`bash\n${pm} install\n${pm === 'pnpm' ? 'pnpm dev            # server (kick dev) + web (vite), in parallel' : `${pm} run dev:server   # terminal 1\\n${pm} run dev:web      # terminal 2`}\n\\`\\`\\`\n\nServer: http://localhost:3000 · Web: http://localhost:5173 (Vite proxies \\`/api\\`).\n\n## The type loop\n\n1. Server handlers **return** their payloads (\\`return this.service.greet(...)\\`).\n2. \\`kick typegen\\` emits \\`server/.kickjs/types/kick__client.d.ts\\` — the flat\n   route map with every response type resolved to a literal shape.\n3. \\`web/tsconfig.json\\` lists that file in \\`types\\`, so \\`KickClientApi\\` is\n   ambient — no import, no bridge file.\n4. \\`web/src/api.ts\\`'s \\`createClient<KickClientApi.Api>\\` types every call site.\n\nBecause the map holds resolved types rather than references to controllers,\n\\`web\\` never compiles server source: no \\`experimentalDecorators\\`, no path\naliases into \\`server/src\\`.\n\nRename a field in \\`server/src/modules/hello/hello.service.ts\\` → \\`web/src/App.tsx\\`\nstops compiling. That's the point.\n\n### Keeping the map fresh\n\n\\`server/.kickjs/types/kick__client.d.ts\\` is generated, and \\`web\\` reads it as\nan ambient type package. Two things follow.\n\n**It is not refreshed by \\`kick dev\\`.** Resolving it builds a whole TypeScript\nprogram over the server, which is a build-step cost rather than a per-save one,\nso a renamed response field surfaces on the next \\`kick typegen\\` rather than on\nsave. Everything else in \\`.kickjs/types\\` still updates on save. Add\n\\`kick typegen --check\\` to CI and a stale map fails the build.\n\n**It needs a compiler API.** TypeScript 7 ships none, so \\`server\\` depends on\n\\`@typescript/typescript6\\`. Remove it and typegen skips this one file, saying\nso; \\`web\\` then reports \\`TS2688\\` because the file it lists in \\`types\\` is gone.\n\n### The other way to wire it\n\nA \\`types\\` entry says \"this is a global type package\", which is what the map is,\nand it fails loudly when the file is missing. If you would rather it be quiet\nwhen absent — say, a repo where the map is not always generated — use\n\\`include\\` instead:\n\n\\`\\`\\`json\n{ \"include\": [\"src\", \"../server/.kickjs/types/kick__client.d.ts\"] }\n\\`\\`\\`\n\nThat tolerates the file not existing, at the cost of \\`KickClientApi\\` silently\nnot resolving. Note \\`types\\` replaces TypeScript's automatic \\`@types\\`\ninclusion, so if you add entries there, list the ones you rely on too\n(\\`\"types\": [\"node\", \"../server/.kickjs/types/kick__client\"]\\`).\n\nOr skip the global entirely — the same file exports the type:\n\n\\`\\`\\`ts\nimport type { Api } from '../../server/.kickjs/types/kick__client'\n\nexport const api = createClient<Api>({ baseUrl: '/api/v1' })\n\\`\\`\\`\n\nDocs: https://kickjs.app/guide/typed-client.html\n`\n\n  if (frontend !== 'vite') return readme\n\n  // create-vite's output is not ours to describe: it has no typed client, no\n  // proxy and no route-map types until the reader wires them. Everything from\n  // \"The type loop\" on is about files that do not exist in that scaffold.\n  const typeLoop = readme.indexOf('## The type loop')\n  return `${readme\n    .slice(0, typeLoop)\n    .replace(\n      'Vite + React, typed against the API via `@forinda/kickjs-client`',\n      'create-vite scaffold — unwired (see below)                       ',\n    )\n    .replace(' (Vite proxies `/api`)', '')}## Wiring web/ to the API\n\n\\`web/\\` is whatever create-vite scaffolded; nothing connects it to the API yet.\nFour steps — typed client, \\`/api\\` dev proxy, route-map types, \\`src/api.ts\\`:\n\n${FRONTEND_WIRING_URL}\n`\n}\n"],"mappings":"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"}
+{"version":3,"file":"fullstack-CjwAefj4.mjs","names":[],"sources":["../src/generators/fullstack.ts"],"sourcesContent":["// `kick new --template fullstack` — a pnpm-workspace monorepo:\n//\n//   my-app/\n//     server/   KickJS API (the standard scaffold, minus its own git/install)\n//     web/      Vite + React frontend typed end-to-end via\n//               @forinda/kickjs-client + the server's generated KickRoutes.Api\n//\n// The type loop: server controllers use return-value handlers → `kick\n// typegen` (run here once, re-run by `kick dev`) emits\n// server/.kickjs/types/kick__client.d.ts → web tsconfig `types` (ambient)\n// side-effect-imports that file (type-only, erased at runtime) → the web\n// client calls `api.get('/hello')` with the handler's actual response type.\n\nimport { join } from 'node:path'\nimport { execFileSync } from 'node:child_process'\n\nimport { writeFileSafe } from '../utils/fs'\nimport { runCommand } from '../utils/shell'\nimport { initProject, resolveSiblingVersions } from './project'\nimport { approveInstallScripts } from '../commands/add'\nimport { fillVars, renderLayers } from '../scaffold/overlay'\n\n/** Wiring a frontend we did not scaffold: typed client, proxy, route types. */\nexport const FRONTEND_WIRING_URL = 'https://kickjs.app/guide/fullstack-frontend.html'\n\n/**\n * create-vite's TypeScript templates, in the order it lists them. Only the\n * `-ts` half: the wiring is typed — the route map is a `.d.ts` and the client\n * is `createClient<KickClientApi.Api>` — so a JavaScript template would leave\n * the reader following a guide that cannot apply.\n */\nexport const VITE_TEMPLATES = [\n  { value: 'react-ts', label: 'React' },\n  { value: 'react-compiler-ts', label: 'React + Compiler' },\n  { value: 'vue-ts', label: 'Vue' },\n  { value: 'svelte-ts', label: 'Svelte' },\n  { value: 'solid-ts', label: 'Solid' },\n  { value: 'preact-ts', label: 'Preact' },\n  { value: 'lit-ts', label: 'Lit' },\n  { value: 'qwik-ts', label: 'Qwik' },\n  { value: 'vanilla-ts', label: 'Vanilla' },\n] as const\n\nexport const DEFAULT_VITE_TEMPLATE = 'react-ts'\n\n/**\n * How each package manager runs create-vite, with the framework decided here\n * rather than by its prompts:\n *\n * - `--template` picks a TypeScript template, so the wiring guide applies;\n * - `--no-interactive` means it never waits for input (CI, `--yes`);\n * - `--no-immediate` stops it installing and launching a dev server — the\n *   workspace install happens once, at the root, after this returns.\n */\nexport function createViteCommand(\n  pm: 'pnpm' | 'npm' | 'yarn' | 'bun',\n  dir: string,\n  template: string = DEFAULT_VITE_TEMPLATE,\n): string[] {\n  const flags = ['--template', template, '--no-interactive', '--no-immediate']\n  // yarn and bun resolve `create vite` to create-vite themselves; npm and pnpm\n  // take the versioned package name, and npm needs `--` before the flags or it\n  // eats them itself.\n  if (pm === 'yarn' || pm === 'bun') return [pm, 'create', 'vite', dir, ...flags]\n  if (pm === 'npm') return [pm, 'create', 'vite@latest', dir, '--', ...flags]\n  return [pm, 'create', 'vite@latest', dir, ...flags]\n}\n\nexport interface InitFullstackOptions {\n  name: string\n  directory: string\n  packageManager?: 'pnpm' | 'npm' | 'yarn' | 'bun'\n  /**\n   * Who scaffolds `web/`. `'kick'` writes the wired React app (typed client,\n   * dev proxy, route-map types). `'vite'` hands the directory to\n   * `create-vite` and wires nothing — you pick the framework, and the guide\n   * at {@link FRONTEND_WIRING_URL} covers connecting it.\n   */\n  frontend?: 'kick' | 'vite'\n  /** create-vite template for `frontend: 'vite'`. Default `react-ts`. */\n  viteTemplate?: string\n  initGit?: boolean\n  installDeps?: boolean\n  schemaLib?: 'zod' | 'valibot' | 'yup'\n  runtime?: 'express' | 'fastify' | 'h3'\n  /** Optional packages (`--packages`), wired into the server like a plain scaffold. */\n  packages?: string[]\n}\n\nexport async function initFullstackProject(options: InitFullstackOptions): Promise<void> {\n  const {\n    name,\n    directory,\n    schemaLib = 'zod',\n    runtime = 'express',\n    packages = [],\n    frontend = 'kick',\n    viteTemplate = DEFAULT_VITE_TEMPLATE,\n  } = options\n  // `--pm` arrives as a free CLI string — allowlist before it reaches a\n  // process invocation (execFileSync takes an argv array, no shell, but a\n  // bogus binary name is still a confusing failure).\n  const pmValid = (['pnpm', 'npm', 'yarn', 'bun'] as const).includes(\n    options.packageManager as never,\n  )\n  const packageManager = pmValid\n    ? (options.packageManager as 'pnpm' | 'npm' | 'yarn' | 'bun')\n    : 'pnpm'\n  const dir = directory\n  const log = (msg: string) => console.log(`  ${msg}`)\n  if (options.packageManager !== undefined && !pmValid) {\n    log(\n      `Warning: unknown package manager '${String(options.packageManager)}' — falling back to pnpm.`,\n    )\n  }\n\n  console.log(`\\n  Creating fullstack KickJS workspace: ${name}\\n`)\n\n  // One map for both packages: the workspace shares a toolchain, so server/\n  // and web/ must not end up on different vite or TypeScript majors.\n  console.log('  Resolving package versions...')\n  const versions = await resolveSiblingVersions()\n\n  // ── server/ — the standard scaffold, deferred install/git ──────────\n  const server = await initProject({\n    name: `${name}-server`,\n    directory: join(dir, 'server'),\n    packageManager,\n    template: 'minimal',\n    schemaLib,\n    runtime,\n    packages,\n    // The client route map web/ reads (with the compiler API it needs), and a\n    // strict port — web/vite.config.ts proxies /api to it, so moving to\n    // another port would silently reach the wrong process.\n    extraLayers: ['server-fullstack'],\n    // server/ is a workspace member; the root records the approvals.\n    approveInstallScripts: false,\n    // netlify.toml / vercel.json live at the workspace root, written below.\n    platformConfig: false,\n    // Root owns install + git so the lockfile/commit cover the workspace.\n    initGit: false,\n    installDeps: false,\n    // Production single-origin serving. `web/` builds to `web/dist`, and\n    // nothing served it before — `pnpm build` produced a frontend the API had\n    // no way to hand out, so every deploy needed a hand-wired static host or\n    // a second process. The adapter is inert until `../web/dist` exists, so\n    // `dev` (Vite serves the client and proxies /api here) is untouched.\n    spaClientDir: '../web/dist',\n    versions,\n  })\n\n  // ── web/ — either our wired React app, or whatever create-vite makes ──\n  if (frontend === 'vite') {\n    // create-vite scaffolds it with the chosen TypeScript template. Nothing\n    // is patched afterwards: a scaffold we didn't write is not ours to\n    // rewrite, and the wiring is four steps in the guide.\n    console.log(`\\n  Handing web/ to create-vite (${viteTemplate})...\\n`)\n    const [file, ...args] = createViteCommand(packageManager, 'web', viteTemplate)\n    runCommand(file!, args, { cwd: dir })\n  } else {\n    // The wired React app (typed client, dev proxy, route-map types): its\n    // package.json here, its files from the web-kick layer below.\n    await writeFileSafe(join(dir, 'web/package.json'), webPackageJson(name, versions))\n  }\n\n  // ── workspace root ──────────────────────────────────────────────────\n  await writeFileSafe(\n    join(dir, 'package.json'),\n    rootPackageJson(name, packageManager, versions['@forinda/kickjs-cli']),\n  )\n  // Only pnpm reads this file. npm / yarn / bun declare workspaces via the\n  // `workspaces` field in the root package.json instead — see rootPackageJson.\n  if (packageManager === 'pnpm') {\n    await writeFileSafe(join(dir, 'pnpm-workspace.yaml'), 'packages:\\n  - server\\n  - web\\n')\n  }\n  // Before install, at the root every package manager reads them from.\n  approveInstallScripts(packageManager, dir, server.builds)\n  // .gitignore, and netlify.toml / vercel.json at the root both platforms\n  // build from; plus the kick web app's files under web/.\n  const layers = ['fullstack-root', ...(frontend === 'vite' ? [] : ['web-kick'])]\n  const files = fillVars(renderLayers(layers).files, { name, packageManager })\n  for (const [path, contents] of files) {\n    await writeFileSafe(join(dir, path), contents)\n  }\n  await writeFileSafe(join(dir, 'README.md'), rootReadme(name, packageManager, frontend))\n\n  // Workspace-root agent docs (CLAUDE.md + .agents/) flavored for the\n  // fullstack layout — the server/ subdir keeps its own generated set.\n  const { generateAgentDocs } = await import('./agent-docs')\n  await generateAgentDocs({\n    outDir: dir,\n    name,\n    pm: packageManager,\n    template: 'fullstack',\n    only: 'all',\n    force: true,\n  })\n\n  // ── install (root — covers both workspace packages) ────────────────\n  if (options.installDeps) {\n    console.log(`\\n  Installing workspace dependencies with ${packageManager}...\\n`)\n    try {\n      // `runCommand`, not bare execFileSync — on Windows every package\n      // manager is a `.cmd` shim that execFileSync cannot spawn.\n      runCommand(packageManager, ['install'], { cwd: dir })\n    } catch {\n      console.log(`\\n  Warning: ${packageManager} install failed. Run it manually.`)\n    }\n  }\n\n  // ── typegen (server) so web's KickRoutes.Api resolves immediately ──\n  try {\n    const { runTypegen } = await import('../typegen')\n    await runTypegen({ cwd: join(dir, 'server'), allowDuplicates: true, silent: true })\n  } catch {\n    // Non-fatal — `kick dev` in server/ retries on boot.\n  }\n\n  // ── git (root) ──────────────────────────────────────────────────────\n  if (options.initGit) {\n    try {\n      execFileSync('git', ['init'], { cwd: dir, stdio: 'pipe' })\n      execFileSync('git', ['branch', '-M', 'main'], { cwd: dir, stdio: 'pipe' })\n      execFileSync('git', ['add', '-A'], { cwd: dir, stdio: 'pipe' })\n      execFileSync('git', ['commit', '-m', 'chore: initial commit from kick new (fullstack)'], {\n        cwd: dir,\n        stdio: 'pipe',\n      })\n      log('Git repository initialized')\n    } catch {\n      log('Warning: git init failed (git may not be installed)')\n    }\n  }\n\n  console.log('\\n  Fullstack workspace scaffolded!')\n  console.log()\n  log('Next steps:')\n  log(`  cd ${name}`)\n  if (!options.installDeps) log(`  ${packageManager} install`)\n  if (packageManager === 'pnpm') {\n    log('  pnpm dev            # runs server (kick dev) + web (vite) together')\n  } else {\n    log(`  ${packageManager} run dev:server   # terminal 1`)\n    log(`  ${packageManager} run dev:web      # terminal 2`)\n  }\n  log('')\n  if (frontend === 'vite') {\n    // Nothing in web/ knows about the API yet — say so, and say where the\n    // four wiring steps live rather than half-wiring someone else's scaffold.\n    log('web/ is create-vite output, unwired. To type it against the API:')\n    log(`  ${FRONTEND_WIRING_URL}`)\n  } else {\n    log('The web app calls the API through @forinda/kickjs-client —')\n    log(\"edit server/src/modules/hello and watch web/src/App.tsx's types follow.\")\n  }\n  log('')\n}\n\n// ── web templates ─────────────────────────────────────────────────────\n\nfunction webPackageJson(name: string, versions: Record<string, string>): string {\n  // Every range here is resolved at scaffold time — see THIRD_PARTY_PACKAGES.\n  const dep = (pkg: string) => versions[pkg] ?? 'latest'\n  return `${JSON.stringify(\n    {\n      name: `${name}-web`,\n      private: true,\n      version: '0.0.0',\n      type: 'module',\n      scripts: {\n        dev: 'vite',\n        build: 'tsc --noEmit && vite build',\n        preview: 'vite preview',\n        typecheck: 'tsc --noEmit',\n      },\n      dependencies: {\n        '@forinda/kickjs-client': dep('@forinda/kickjs-client'),\n        react: dep('react'),\n        'react-dom': dep('react-dom'),\n      },\n      devDependencies: {\n        '@types/react': dep('@types/react'),\n        '@types/react-dom': dep('@types/react-dom'),\n        '@vitejs/plugin-react': dep('@vitejs/plugin-react'),\n        // Same majors as the server package: one workspace, one toolchain.\n        typescript: dep('typescript'),\n        vite: dep('vite'),\n      },\n    },\n    null,\n    2,\n  )}\\n`\n}\n\n// ── root templates ────────────────────────────────────────────────────\n\nfunction rootPackageJson(name: string, pm: string, cliVersion: string): string {\n  const scripts: Record<string, string> =\n    pm === 'pnpm'\n      ? {\n          dev: 'pnpm --parallel -r run dev',\n          // One origin: the server serves `web/dist` through SpaAdapter.\n          start: 'pnpm --filter ./server run start',\n          'dev:server': 'pnpm --filter ./server dev',\n          'dev:web': 'pnpm --filter ./web dev',\n          // Typegen first: web's `tsc` reads server/.kickjs/types, which is\n          // git-ignored, so a fresh clone (CI, Netlify, Vercel) has none and\n          // `pnpm -r run build` races the two packages anyway.\n          build: 'pnpm --filter ./server exec kick typegen && pnpm -r run build',\n          'build:netlify': 'pnpm build && pnpm --filter ./server exec kick build:netlify',\n          'build:vercel': 'pnpm build && pnpm --filter ./server exec kick build:vercel',\n          // No `npx`: the binary is `kick` but the package is\n          // `@forinda/kickjs-cli`, so npx cannot map one to the other and\n          // falls back to the REGISTRY — where `kick` is an unrelated\n          // AngularJS scaffolder. It runs, prints its own help, and exits 0,\n          // so this script would pass without type-checking anything.\n          //\n          // Every package manager puts `node_modules/.bin` on PATH for\n          // scripts, so the bare name resolves locally, and a missing install\n          // fails loudly instead of fetching a stranger.\n          typecheck: 'kick typecheck --cwd server && kick typecheck --cwd web',\n        }\n      : {\n          // cd-based scripts — the one form npm, yarn (classic AND berry),\n          // and bun all run identically; workspace-filter flags differ per\n          // manager (--workspace vs `yarn workspace <name>` vs --filter).\n          start: `cd server && ${pm} run start`,\n          'dev:server': `cd server && ${pm} run dev`,\n          'dev:web': `cd web && ${pm} run dev`,\n          // Typegen first — see the pnpm branch above.\n          build: `cd server && ${pm} exec kick typegen && cd .. && ${pm} run build:server && ${pm} run build:web`,\n          'build:netlify': `${pm} run build && cd server && ${pm} exec kick build:netlify`,\n          'build:vercel': `${pm} run build && cd server && ${pm} exec kick build:vercel`,\n          'build:server': `cd server && ${pm} run build`,\n          'build:web': `cd web && ${pm} run build`,\n          // No `npx`: the binary is `kick` but the package is\n          // `@forinda/kickjs-cli`, so npx cannot map one to the other and\n          // falls back to the REGISTRY — where `kick` is an unrelated\n          // AngularJS scaffolder. It runs, prints its own help, and exits 0,\n          // so this script would pass without type-checking anything.\n          //\n          // Every package manager puts `node_modules/.bin` on PATH for\n          // scripts, so the bare name resolves locally, and a missing install\n          // fails loudly instead of fetching a stranger.\n          typecheck: 'kick typecheck --cwd server && kick typecheck --cwd web',\n        }\n  return `${JSON.stringify(\n    {\n      name,\n      private: true,\n      version: '0.0.0',\n      type: 'module',\n      scripts,\n      // The CLI is a ROOT dependency so the bare `kick` in the scripts above\n      // resolves: package managers put `node_modules/.bin` on PATH for\n      // scripts, and the CLI otherwise lives only in `server/node_modules`.\n      devDependencies: { '@forinda/kickjs-cli': cliVersion },\n      workspaces: ['server', 'web'],\n    },\n    null,\n    2,\n  )}\\n`\n}\n\nexport function rootReadme(name: string, pm: string, frontend: 'kick' | 'vite' = 'kick'): string {\n  const readme = `# ${name}\n\nFullstack KickJS workspace — typed end to end.\n\n| Package   | What                                                              |\n| --------- | ----------------------------------------------------------------- |\n| \\`server/\\` | KickJS API (decorators, DI, \\`kick dev\\` with typegen watch)       |\n| \\`web/\\`    | Vite + React, typed against the API via \\`@forinda/kickjs-client\\` |\n\n## Develop\n\n\\`\\`\\`bash\n${pm} install\n${pm === 'pnpm' ? 'pnpm dev            # server (kick dev) + web (vite), in parallel' : `${pm} run dev:server   # terminal 1\\n${pm} run dev:web      # terminal 2`}\n\\`\\`\\`\n\nServer: http://localhost:3000 · Web: http://localhost:5173 (Vite proxies \\`/api\\`).\n\n## The type loop\n\n1. Server handlers **return** their payloads (\\`return this.service.greet(...)\\`).\n2. \\`kick typegen\\` emits \\`server/.kickjs/types/kick__client.d.ts\\` — the flat\n   route map with every response type resolved to a literal shape.\n3. \\`web/tsconfig.json\\` lists that file in \\`types\\`, so \\`KickClientApi\\` is\n   ambient — no import, no bridge file.\n4. \\`web/src/api.ts\\`'s \\`createClient<KickClientApi.Api>\\` types every call site.\n\nBecause the map holds resolved types rather than references to controllers,\n\\`web\\` never compiles server source: no \\`experimentalDecorators\\`, no path\naliases into \\`server/src\\`.\n\nRename a field in \\`server/src/modules/hello/hello.service.ts\\` → \\`web/src/App.tsx\\`\nstops compiling. That's the point.\n\n### Keeping the map fresh\n\n\\`server/.kickjs/types/kick__client.d.ts\\` is generated, and \\`web\\` reads it as\nan ambient type package. Two things follow.\n\n**It is not refreshed by \\`kick dev\\`.** Resolving it builds a whole TypeScript\nprogram over the server, which is a build-step cost rather than a per-save one,\nso a renamed response field surfaces on the next \\`kick typegen\\` rather than on\nsave. Everything else in \\`.kickjs/types\\` still updates on save. Add\n\\`kick typegen --check\\` to CI and a stale map fails the build.\n\n**It needs a compiler API.** TypeScript 7 ships none, so \\`server\\` depends on\n\\`@typescript/typescript6\\`. Remove it and typegen skips this one file, saying\nso; \\`web\\` then reports \\`TS2688\\` because the file it lists in \\`types\\` is gone.\n\n### The other way to wire it\n\nA \\`types\\` entry says \"this is a global type package\", which is what the map is,\nand it fails loudly when the file is missing. If you would rather it be quiet\nwhen absent — say, a repo where the map is not always generated — use\n\\`include\\` instead:\n\n\\`\\`\\`json\n{ \"include\": [\"src\", \"../server/.kickjs/types/kick__client.d.ts\"] }\n\\`\\`\\`\n\nThat tolerates the file not existing, at the cost of \\`KickClientApi\\` silently\nnot resolving. Note \\`types\\` replaces TypeScript's automatic \\`@types\\`\ninclusion, so if you add entries there, list the ones you rely on too\n(\\`\"types\": [\"node\", \"../server/.kickjs/types/kick__client\"]\\`).\n\nOr skip the global entirely — the same file exports the type:\n\n\\`\\`\\`ts\nimport type { Api } from '../../server/.kickjs/types/kick__client'\n\nexport const api = createClient<Api>({ baseUrl: '/api/v1' })\n\\`\\`\\`\n\nDocs: https://kickjs.app/guide/typed-client.html\n`\n\n  if (frontend !== 'vite') return readme\n\n  // create-vite's output is not ours to describe: it has no typed client, no\n  // proxy and no route-map types until the reader wires them. Everything from\n  // \"The type loop\" on is about files that do not exist in that scaffold.\n  const typeLoop = readme.indexOf('## The type loop')\n  return `${readme\n    .slice(0, typeLoop)\n    .replace(\n      'Vite + React, typed against the API via `@forinda/kickjs-client`',\n      'create-vite scaffold — unwired (see below)                       ',\n    )\n    .replace(' (Vite proxies `/api`)', '')}## Wiring web/ to the API\n\n\\`web/\\` is whatever create-vite scaffolded; nothing connects it to the API yet.\nFour steps — typed client, \\`/api\\` dev proxy, route-map types, \\`src/api.ts\\`:\n\n${FRONTEND_WIRING_URL}\n`\n}\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -257,6 +257,8 @@ interface KickDbConfigBlock {
    * to `'db/migrations'`.
    */
   migrationsDir?: string;
+  /** Where `kick db seed` finds seed files. Defaults to `'db/seeds'`. */
+  seedsDir?: string;
   /** SQL dialect. Defaults to `'postgres'`. */
   dialect?: 'postgres' | 'sqlite' | 'mysql';
   /**
@@ -1180,23 +1182,6 @@ interface DiscoveredContextKey {
   /** Path relative to scan root, with forward slashes. */
   relativePath: string;
 }
-/**
- * A `defineAugmentation('Name', meta)` call discovered in source. Plugins
- * call this to advertise an augmentable interface so the typegen can list
- * every augmentation surface in one generated file.
- */
-interface DiscoveredAugmentation {
-  /** The literal string passed as the first arg to `defineAugmentation` */
-  name: string;
-  /** Optional `description` extracted from the second-arg object literal */
-  description: string | null;
-  /** Optional `example` extracted from the second-arg object literal */
-  example: string | null;
-  /** Absolute file path */
-  filePath: string;
-  /** Path relative to scan root, with forward slashes */
-  relativePath: string;
-}
 /**
  * A decorated class whose file sits inside a module directory but
  * isn't picked up by any of the module's `import.meta.glob(...)`
@@ -1227,8 +1212,6 @@ interface ScanResult {
   env: DiscoveredEnv | null;
   /** Plugins/adapters discovered via `defineAdapter`/`definePlugin`/`implements AppAdapter` */
   pluginsAndAdapters: DiscoveredPluginOrAdapter[];
-  /** Augmentation interfaces declared via `defineAugmentation('Name', meta)` */
-  augmentations: DiscoveredAugmentation[];
   /** Context keys from `define(Http)ContextDecorator({ key })` calls */
   contextKeys: DiscoveredContextKey[];
   /** Route flags from `defineRouteFlag('name')` calls. */
@@ -1403,8 +1386,6 @@ interface GenerateResult {
   routeEntries: number;
   /** Number of unique plugin/adapter names */
   pluginEntries: number;
-  /** Number of unique `defineAugmentation` calls */
-  augmentationEntries: number;
   /** Number of typed asset entries */
   assetEntries: number;
   /** Whether a typed env augmentation will be emitted */

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/commands/add.ts","../src/commands/doctor.ts","../src/plugin/types.ts","../src/config.ts","../src/generators/templates/types.ts","../src/generators/module.ts","../src/generators/adapter.ts","../src/generators/middleware.ts","../src/generators/guard.ts","../src/generators/service.ts","../src/generators/controller.ts","../src/generators/dto.ts","../src/generators/project.ts","../src/utils/project-root.ts","../src/typegen/scanner.ts","../src/typegen/plugin.ts","../src/typegen/token-conventions.ts","../src/typegen/index.ts","../src/typegen/run-plugins.ts","../src/asset-manager/build.ts","../src/typegen/dev-watcher.ts","../src/generator-extension/discover.ts","../src/generator-extension/context.ts","../src/utils/naming.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/commands/add.ts","../src/commands/doctor.ts","../src/plugin/types.ts","../src/config.ts","../src/generators/templates/types.ts","../src/generators/module.ts","../src/generators/adapter.ts","../src/generators/middleware.ts","../src/generators/guard.ts","../src/generators/service.ts","../src/generators/controller.ts","../src/generators/dto.ts","../src/generators/project.ts","../src/utils/project-root.ts","../src/typegen/scanner.ts","../src/typegen/plugin.ts","../src/typegen/token-conventions.ts","../src/typegen/index.ts","../src/typegen/run-plugins.ts","../src/asset-manager/build.ts","../src/typegen/dev-watcher.ts","../src/generator-extension/discover.ts","../src/generator-extension/context.ts","../src/utils/naming.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.6.1
+ * @forinda/kickjs-cli v8.7.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,4 +8,4 @@
  *
  * @license MIT
  */
-import{A as e,M as t,N as n,P as r,S as i,_ as a,c as o,d as s,g as c,h as l,l as u,m as d,n as f,o as p,p as m,s as h,t as g,y as _}from"./doctor-p4bjILiU.mjs";import{t as v}from"./project-BjxeGJBn.mjs";import{o as y,r as b}from"./config-BoXFaObA.mjs";import{t as x}from"./project-root-D8VclnwB.mjs";import{n as S,t as C}from"./types-Dudqvbd1.mjs";export{C as KickPluginConflictError,o as TYPEGEN_OWNER_KEY,p as buildGeneratorContext,u as createTypegenDevWatcher,S as defineCliPlugin,b as defineConfig,g as defineDoctorCheck,f as defineDoctorExtension,h as defineGenerator,s as defineTypegen,x as findProjectRoot,_ as generateAdapter,d as generateController,m as generateDto,c as generateGuard,a as generateMiddleware,i as generateModule,l as generateService,v as initProject,y as loadKickConfig,e as pluralize,t as toCamelCase,n as toKebabCase,r as toPascalCase};
+import{C as e,F as t,N as n,P as r,_ as i,c as a,d as o,g as s,h as c,j as l,l as u,m as d,n as f,o as p,p as m,s as h,t as g,y as _}from"./doctor-DOuVk9cj.mjs";import{t as v}from"./project-16gsHLs5.mjs";import{o as y,r as b}from"./config-CKtUkFnR.mjs";import{t as x}from"./project-root-DebxcXwp.mjs";import{n as S,t as C}from"./types-BtMrQ7AM.mjs";export{C as KickPluginConflictError,a as TYPEGEN_OWNER_KEY,p as buildGeneratorContext,u as createTypegenDevWatcher,S as defineCliPlugin,b as defineConfig,g as defineDoctorCheck,f as defineDoctorExtension,h as defineGenerator,o as defineTypegen,x as findProjectRoot,_ as generateAdapter,d as generateController,m as generateDto,s as generateGuard,i as generateMiddleware,e as generateModule,c as generateService,v as initProject,y as loadKickConfig,l as pluralize,n as toCamelCase,r as toKebabCase,t as toPascalCase};

package/dist/{plugin-Aof9UWs7.mjs → plugin-BWaA0gd6.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.6.1
+ * @forinda/kickjs-cli v8.7.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,4 +8,4 @@
  *
  * @license MIT
  */
-import"./types-Dudqvbd1.mjs";import{r as e}from"./run-plugins-DCVSqa5a.mjs";export{e as mergeCliPlugins};
+import"./types-BtMrQ7AM.mjs";import{r as e}from"./run-plugins-CEomWccT.mjs";export{e as mergeCliPlugins};

package/dist/{plugin-B-kr8WAU.mjs → plugin-rEXrK-TD.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.6.1
+ * @forinda/kickjs-cli v8.7.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,4 +8,4 @@
  *
  * @license MIT
  */
-import{t as e}from"./rolldown-runtime-DElgkk48.mjs";import{KickPluginConflictError as t,defineCliPlugin as n}from"@forinda/kickjs-cli-kit";function r(e,n=[]){let r=new Map;for(let n of e){let e=(r.get(n.name)??0)+1;if(r.set(n.name,e),e===2)throw new t(`plugin`,n.name,[n.name,n.name])}let i=new Map,a=[];for(let n of e)for(let e of n.commands??[]){let r=i.get(e.name);if(r)throw new t(`command`,e.name,[r,n.name]);i.set(e.name,n.name),a.push(e)}let o=new Set(n.map(e=>e.name)),s=[...a.filter(e=>!o.has(e.name)),...n],c=new Map,l=[];for(let n of e)for(let e of n.typegens??[]){let r=c.get(e.id);if(r)throw new t(`typegen`,e.id,[r,n.name]);c.set(e.id,n.name),l.push(e)}let u=new Map,d=[];for(let n of e)for(let e of n.generators??[]){let r=u.get(e.name);if(r)throw new t(`generator`,e.name,[r,n.name]);u.set(e.name,n.name),d.push({source:n.name,spec:e})}return{commands:s,typegens:l,generators:d,register:async(t,n)=>{let r;if(n)r={generators:d,...n};else{let{findProjectRoot:e}=await import(`./project-root-4oQKPMOs.mjs`).then(e=>e.n),t=process.cwd();r={cwd:t,projectRoot:e(t),config:null,log:()=>{},generators:d}}for(let n of e)n.register&&await n.register(t,r)}}}var i=e({mergeCliPlugins:()=>r});export{r as n,n as r,i as t};
+import{t as e}from"./rolldown-runtime-DyiVSlN6.mjs";import{KickPluginConflictError as t,defineCliPlugin as n}from"@forinda/kickjs-cli-kit";function r(e,n=[]){let r=new Map;for(let n of e){let e=(r.get(n.name)??0)+1;if(r.set(n.name,e),e===2)throw new t(`plugin`,n.name,[n.name,n.name])}let i=new Map,a=[];for(let n of e)for(let e of n.commands??[]){let r=i.get(e.name);if(r)throw new t(`command`,e.name,[r,n.name]);i.set(e.name,n.name),a.push(e)}let o=new Set(n.map(e=>e.name)),s=[...a.filter(e=>!o.has(e.name)),...n],c=new Map,l=[];for(let n of e)for(let e of n.typegens??[]){let r=c.get(e.id);if(r)throw new t(`typegen`,e.id,[r,n.name]);c.set(e.id,n.name),l.push(e)}let u=new Map,d=[];for(let n of e)for(let e of n.generators??[]){let r=u.get(e.name);if(r)throw new t(`generator`,e.name,[r,n.name]);u.set(e.name,n.name),d.push({source:n.name,spec:e})}return{commands:s,typegens:l,generators:d,register:async(t,n)=>{let r;if(n)r={generators:d,...n};else{let{findProjectRoot:e}=await import(`./project-root-Bab7F0mt.mjs`).then(e=>e.n),t=process.cwd();r={cwd:t,projectRoot:e(t),config:null,log:()=>{},generators:d}}for(let n of e)n.register&&await n.register(t,r)}}}var i=e({mergeCliPlugins:()=>r});export{r as n,n as r,i as t};

package/dist/{project-BjxeGJBn.mjs → project-16gsHLs5.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.6.1
+ * @forinda/kickjs-cli v8.7.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,7 +8,7 @@
  *
  * @license MIT
  */
-import{r as e}from"./fs-Dz7zBXL4.mjs";import{o as t,t as n}from"./config-BoXFaObA.mjs";import{dirname as r,join as i,resolve as a,sep as o}from"node:path";import{existsSync as s,readFileSync as c,readdirSync as l,statSync as u,writeFileSync as d}from"node:fs";import{execFile as f,execFileSync as p,execSync as m,spawnSync as h}from"node:child_process";import{fileURLToPath as g}from"node:url";import{promisify as _}from"node:util";import{parseSync as v}from"oxc-parser";const y=r(g(import.meta.url)),b=[i(y,`..`,`templates`),i(y,`..`,`..`,`templates`)].find(e=>s(i(e,`base`)));function x(e){return e.split(`/`).map(e=>e.startsWith(`_dot_`)?`.${e.slice(5)}`:e).join(`/`)}function S(e,t={}){let n=t.templatesDir??b,r=new Map,a=[],d=[],f={},p=[];for(let t of e){let e=i(n,t);if(!s(e))throw Error(`Unknown scaffold layer "${t}" (${e})`);let m=i(e,`feature.json`);if(s(m)){let e=JSON.parse(c(m,`utf-8`));a.push(...e.dependencies??[]),d.push(...e.devDependencies??[]),Object.assign(f,e.builds),p.push(...e.integrations??[])}let h=i(e,`files`);if(s(h))for(let e of l(h,{recursive:!0,encoding:`utf-8`}).toSorted()){let t=i(h,e);if(!u(t).isFile())continue;let n=c(t,`utf-8`),a=x(e.split(o).join(`/`));if(a.endsWith(`.append`)){let e=a.slice(0,-7);r.set(e,(r.get(e)??``)+n)}else r.set(a,n)}}p.push(...t.extra??[]);let m=t.vars??{},h=e=>e.replace(/\{\{(\w+)\}\}/g,(e,t)=>m[t]??e);for(let[e,t]of r)t.includes(`// @kick:`)&&r.set(e,T(t,p,h));return{files:r,dependencies:[...new Set(a)],devDependencies:[...new Set(d)],builds:f,integrations:p}}function C(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 w=/^([ \t]*)\/\/ @kick:([\w-]+)[ \t]*$/;function T(e,t,n=e=>e){let r=e.split(`
+import{r as e}from"./fs-BdI6OJqD.mjs";import{o as t,t as n}from"./config-CKtUkFnR.mjs";import{dirname as r,join as i,resolve as a,sep as o}from"node:path";import{existsSync as s,readFileSync as c,readdirSync as l,statSync as u,writeFileSync as d}from"node:fs";import{execFile as f,execFileSync as p,execSync as m,spawnSync as h}from"node:child_process";import{fileURLToPath as g}from"node:url";import{promisify as _}from"node:util";import{parseSync as v}from"oxc-parser";const y=r(g(import.meta.url)),b=[i(y,`..`,`templates`),i(y,`..`,`..`,`templates`)].find(e=>s(i(e,`base`)));function x(e){return e.split(`/`).map(e=>e.startsWith(`_dot_`)?`.${e.slice(5)}`:e).join(`/`)}function S(e,t={}){let n=t.templatesDir??b,r=new Map,a=[],d=[],f={},p=[];for(let t of e){let e=i(n,t);if(!s(e))throw Error(`Unknown scaffold layer "${t}" (${e})`);let m=i(e,`feature.json`);if(s(m)){let e=JSON.parse(c(m,`utf-8`));a.push(...e.dependencies??[]),d.push(...e.devDependencies??[]),Object.assign(f,e.builds),p.push(...e.integrations??[])}let h=i(e,`files`);if(s(h))for(let e of l(h,{recursive:!0,encoding:`utf-8`}).toSorted()){let t=i(h,e);if(!u(t).isFile())continue;let n=c(t,`utf-8`),a=x(e.split(o).join(`/`));if(a.endsWith(`.append`)){let e=a.slice(0,-7);r.set(e,(r.get(e)??``)+n)}else r.set(a,n)}}p.push(...t.extra??[]);let m=t.vars??{},h=e=>e.replace(/\{\{(\w+)\}\}/g,(e,t)=>m[t]??e);for(let[e,t]of r)t.includes(`// @kick:`)&&r.set(e,T(t,p,h));return{files:r,dependencies:[...new Set(a)],devDependencies:[...new Set(d)],builds:f,integrations:p}}function C(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 w=/^([ \t]*)\/\/ @kick:([\w-]+)[ \t]*$/;function T(e,t,n=e=>e){let r=e.split(`
 `),i=new Set(r.map(e=>w.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=w.exec(r[e]);if(!t){o.push(r[e]);continue}let[,i,s]=t,c=s===`imports`?ee(a.flatMap(e=>e.import?[e.import]:[])):a.filter(e=>e.slot===s&&e.code).map(e=>E(`${n(e.code)},`,i));if(c.length>0){o.push(...c);continue}o.at(-1)?.trimEnd().endsWith(`[`)&&r[e+1]?.trim().startsWith(`]`)&&(o.pop(),e++)}return o.join(`
 `)}function E(e,t){return e.split(`
 `).map(e=>e&&t+e).join(`
@@ -27,20 +27,21 @@ import{r as e}from"./fs-Dz7zBXL4.mjs";import{o as t,t as n}from"./config-BoXFaOb
 `)?``:`
 `;await e(n,`${l}${f}${d.join(`
 `)}\n`),r.push(a)}return r}const F=e=>/^\s*([A-Za-z_][\w]*)\s*=/.exec(e)?.[1];async function be(t,n,r){let a=i(t,n),o=c(a,`utf-8`),s=le(o,r,I(t),n);return s.source!==o&&await e(a,s.source),s}function I(e){let t=xe(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 xe(e){try{return JSON.parse(c(i(e,`package.json`),`utf-8`))}catch{return{}}}function Se(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 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`,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`],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`],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/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}},Ce=Object.entries(L).filter(([e,t])=>!t.core&&!t.deprecated&&!e.includes(`:`)&&![`pg`,`sqlite`,`mysql`,`zod`,`valibot`,`yup`].includes(e)).map(([e])=>e).join(`, `),R={express:[`express`],fastify:[`fastify`,`@fastify/middie`,`serve-static`],h3:[`h3`,`serve-static`]},z={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 B(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 V(e=process.cwd()){return(await H(e)).runtime}async function H(e=process.cwd()){let n=(await t(e))?.runtime;return n===`express`||n===`fastify`||n===`h3`?{runtime:n,candidates:[n],ambiguous:!1,fromConfig:!0}:{...we(e),fromConfig:!1}}const U=[[`express`,`express`],[`fastify`,`fastify`],[`h3`,`h3`]];function we(e=process.cwd()){let t=W(`package.json`,e);if(!t)return{runtime:`express`,candidates:[],ambiguous:!1};let n={},r={};try{let e=JSON.parse(c(a(t,`package.json`),`utf-8`));n=e.dependencies??{},r=e.devDependencies??{}}catch{return{runtime:`express`,candidates:[],ambiguous:!1}}let i=U.filter(([e])=>e in n).map(([,e])=>e),o=U.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 W(e,t=process.cwd()){let n=t;for(;;){if(s(a(n,e)))return n;let t=r(n);if(t===n)return null;n=t}}function Te(){return W(`pnpm-lock.yaml`)?`pnpm`:W(`yarn.lock`)?`yarn`:W(`bun.lockb`)||W(`bun.lock`)?`bun`:W(`package-lock.json`)?`npm`:null}function Ee(){let e=process.cwd();for(;e;){let t=a(e,`package.json`);if(s(t))try{let e=JSON.parse(c(t,`utf-8`)).packageManager;if(typeof e==`string`){let t=e.split(`@`)[0];if(n.includes(t))return t}}catch{}let i=r(e);if(i===e)return null;e=i}return null}async function G(e){if(e&&n.includes(e))return{pm:e,source:`flag`};let r=await t(process.cwd());if(r?.packageManager&&n.includes(r.packageManager))return{pm:r.packageManager,source:`config`};let i=Ee();if(i)return{pm:i,source:`package.json`};let a=Te();return a?{pm:a,source:`lockfile`}:{pm:`npm`,source:`default`}}async function De(e){let{pm:t}=await G(e);return t}function K(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,...R[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(`
+`)}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`,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}},Ce=Object.entries(L).filter(([e,t])=>!t.core&&!t.deprecated&&!e.includes(`:`)&&![`pg`,`sqlite`,`mysql`,`zod`,`valibot`,`yup`].includes(e)).map(([e])=>e).join(`, `),R={express:[`express`],fastify:[`fastify`,`@fastify/middie`,`serve-static`],h3:[`h3`,`serve-static`]},z={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 B(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 V(e=process.cwd()){return(await H(e)).runtime}async function H(e=process.cwd()){let n=(await t(e))?.runtime;return n===`express`||n===`fastify`||n===`h3`?{runtime:n,candidates:[n],ambiguous:!1,fromConfig:!0}:{...we(e),fromConfig:!1}}const U=[[`express`,`express`],[`fastify`,`fastify`],[`h3`,`h3`]];function we(e=process.cwd()){let t=W(`package.json`,e);if(!t)return{runtime:`express`,candidates:[],ambiguous:!1};let n={},r={};try{let e=JSON.parse(c(a(t,`package.json`),`utf-8`));n=e.dependencies??{},r=e.devDependencies??{}}catch{return{runtime:`express`,candidates:[],ambiguous:!1}}let i=U.filter(([e])=>e in n).map(([,e])=>e),o=U.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 W(e,t=process.cwd()){let n=t;for(;;){if(s(a(n,e)))return n;let t=r(n);if(t===n)return null;n=t}}function Te(){return W(`pnpm-lock.yaml`)?`pnpm`:W(`yarn.lock`)?`yarn`:W(`bun.lockb`)||W(`bun.lock`)?`bun`:W(`package-lock.json`)?`npm`:null}function Ee(){let e=process.cwd();for(;e;){let t=a(e,`package.json`);if(s(t))try{let e=JSON.parse(c(t,`utf-8`)).packageManager;if(typeof e==`string`){let t=e.split(`@`)[0];if(n.includes(t))return t}}catch{}let i=r(e);if(i===e)return null;e=i}return null}async function G(e){if(e&&n.includes(e))return{pm:e,source:`flag`};let r=await t(process.cwd());if(r?.packageManager&&n.includes(r.packageManager))return{pm:r.packageManager,source:`config`};let i=Ee();if(i)return{pm:i,source:`package.json`};let a=Te();return a?{pm:a,source:`lockfile`}:{pm:`npm`,source:`default`}}async function De(e){let{pm:t}=await G(e);return t}function K(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,...R[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 Oe={"@swc/core":!0,esbuild:!0};function q(e,t,n){if(e===`pnpm`){let e=a(t,`pnpm-workspace.yaml`),r=s(e)?c(e,`utf-8`):``,i=se(r,n);return i===r?void 0:(d(e,i),e)}if(e!==`npm`&&e!==`bun`)return;let r=a(t,`package.json`);if(!s(r))return;let i=JSON.parse(c(r,`utf-8`)),o=!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,o=!0);i.allowScripts=e}else{let e=i.trustedDependencies??[];for(let[t,r]of Object.entries(n))r&&!e.includes(t)&&(e.push(t),o=!0);i.trustedDependencies=e}if(o)return d(r,`${JSON.stringify(i,null,2)}\n`),r}function ke(e){if(e===`pnpm`)return W(`pnpm-workspace.yaml`)??process.cwd();for(let e=process.cwd();;e=r(e)){try{if(JSON.parse(c(a(e,`package.json`),`utf-8`)).workspaces)return e}catch{}if(r(e)===e)return process.cwd()}}function J(e){return Object.assign({},...e.map(e=>L[e]?.builds??{}))}function Ae(e,t,n=`express`){let r=new Set,i=new Set,a=[],o=[],s=[];for(let c of e){if(c===`upload`){let e=z[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=R[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 je(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=>{K(!!e.all,B(e.runtime)??await V())})}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`).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){K(!!t.all,B(t.runtime)??await V());return}let{pm:n,source:r}=await G(t.pm);console.log(`\n  Using ${n} (resolved from ${r})`);let i=B(t.runtime),o=await H(process.cwd()),c=i??o.runtime;if(!i&&o.ambiguous){console.error(`\n  Cannot tell which HTTP engine this app boots on: found ${o.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 <${o.candidates.join(`|`)}> for this command\n`),process.exitCode=1;return}let l=Ae(e,!!t.dev,c),{unknown:u,warnings:d,notices:f}=l,{prodDeps:p,devDeps:h}=l,g=process.cwd();if(t.entry&&!s(a(g,t.entry))){console.error(`\n  --entry ${t.entry} does not exist.\n`),process.exitCode=1;return}let _=t.wire===!1?void 0:_e(e),v=_?ve(g,t.entry):void 0;if(_){p=[...new Set([...p,..._.dependencies])],h=[...new Set([...h,..._.devDependencies].filter(e=>!p.includes(e)))];let e=ye(g,[...v?[v]:[],..._.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.
+  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 Oe={"@swc/core":!0,esbuild:!0};function q(e,t,n){if(e===`pnpm`){let e=a(t,`pnpm-workspace.yaml`),r=s(e)?c(e,`utf-8`):``,i=se(r,n);return i===r?void 0:(d(e,i),e)}if(e!==`npm`&&e!==`bun`)return;let r=a(t,`package.json`);if(!s(r))return;let i=JSON.parse(c(r,`utf-8`)),o=!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,o=!0);i.allowScripts=e}else{let e=i.trustedDependencies??[];for(let[t,r]of Object.entries(n))r&&!e.includes(t)&&(e.push(t),o=!0);i.trustedDependencies=e}if(o)return d(r,`${JSON.stringify(i,null,2)}\n`),r}function ke(e){if(e===`pnpm`)return W(`pnpm-workspace.yaml`)??process.cwd();for(let e=process.cwd();;e=r(e)){try{if(JSON.parse(c(a(e,`package.json`),`utf-8`)).workspaces)return e}catch{}if(r(e)===e)return process.cwd()}}function J(e){return Object.assign({},...e.map(e=>L[e]?.builds??{}))}function Ae(e,t,n=`express`){let r=new Set,i=new Set,a=[],o=[],s=[];for(let c of e){if(c===`upload`){let e=z[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);for(let t of e.typePeers??[])i.add(t);if(e.enginePeers){let e=R[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 je(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=>{K(!!e.all,B(e.runtime)??await V())})}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`).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){K(!!t.all,B(t.runtime)??await V());return}let{pm:n,source:r}=await G(t.pm);console.log(`\n  Using ${n} (resolved from ${r})`);let i=B(t.runtime),o=await H(process.cwd()),c=i??o.runtime;if(!i&&o.ambiguous){console.error(`\n  Cannot tell which HTTP engine this app boots on: found ${o.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 <${o.candidates.join(`|`)}> for this command\n`),process.exitCode=1;return}let l=Ae(e,!!t.dev,c),{unknown:u,warnings:d,notices:f}=l,{prodDeps:p,devDeps:h}=l,g=process.cwd();if(t.entry&&!s(a(g,t.entry))){console.error(`\n  --entry ${t.entry} does not exist.\n`),process.exitCode=1;return}let _=t.wire===!1?void 0:_e(e),v=_?ve(g,t.entry):void 0;if(_){p=[...new Set([...p,..._.dependencies])],h=[...new Set([...h,..._.devDependencies].filter(e=>!p.includes(e)))];let e=ye(g,[...v?[v]:[],..._.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.
 `),p.length===0&&h.length===0))return;let y={...J(e),..._?.builds};if(Object.keys(y).length>0){let e=q(n,ke(n),y);e&&console.log(`\n  Approved install scripts in ${e}`)}let b=!0;if(p.length>0){let e=p,t=`${n} add ${e.join(` `)}`;console.log(`\n  Installing ${e.length} dependency(ies):`);for(let t of e)console.log(`    + ${t}`);console.log();try{m(t,{stdio:`inherit`})}catch{b=!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{m(t,{stdio:`inherit`})}catch{b=!1,console.log(`\n  Installation failed. Run manually:\n    ${t}\n`)}}if(_){if(!b)console.log(`  Skipped wiring — the install did not finish.
 `);else{for(let e of await P(g,_.files))console.log(`  Updated ${e}`);let e=v?await be(g,v,_.integrations):void 0;for(let t of e?.added??[])console.log(`  Added ${t} to ${v}`);for(let t of e?.present??[])console.log(`  ${t} is already in ${v}`);let t=I(g),n=e?e.manual:_.integrations.filter(e=>e.slot&&e.code).map(e=>({...e,code:t(e.code)}));n.length>0&&(console.log(`\n  ${v?`Could not find bootstrap({ adapters: [...] }) in ${v}`:`No entry file found`} — add this yourself:
-`),console.log(Se(n).replace(/^/gm,`    `)),console.log())}}console.log(`  Done!
-`)})}const Y=r(g(import.meta.url)),X=JSON.parse(c([i(Y,`..`,`package.json`),i(Y,`..`,`..`,`package.json`)].find(s),`utf-8`)),Ne=[`@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`],Pe={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`},"@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:`^1.0.0`,cap:`^1`},"serve-static":{fallback:`^2.2.0`,cap:`^2`},zod:{fallback:`^4.3.6`,cap:`^4`},valibot:{fallback:`^1.4.1`,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 Fe(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 Ie(e){return e===`@forinda/kickjs-cli`?`^${X.version}`:`latest`}async function Z(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 Q(){let e=[...Ne.map(e=>({name:e,fallback:Ie(e),cap:void 0})),...Object.entries(Pe).map(([e,t])=>({name:e,...t}))],t=Date.now()+2e4,n=await Z(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=Fe(await ie(`npm`,r?[`view`,a,`version`,`--json`]:[`view`,a,`version`],{timeout:i}));return[e,o?`^${o}`:n]});return Object.fromEntries(n)}function Le(e,t){let n=k(`npm`,[`view`,`${e}@${t}`,`version`],{timeout:2e4});return n&&/^\d+\.\d+\.\d+/.test(n)?n:null}function $(e){return(e??``).replace(/^[\^~>=<\s]+/,``)}function Re(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 ze(e,t,n){let r=k(`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 Be(t){let{name:n,directory:r,packageManager:a=`pnpm`,template:o=`rest`,defaultRepo:c=`inmemory`,packages:l=[],schemaLib:u=`zod`,runtime:d=`express`}=t,f=r,p=e=>console.log(`  ${e}`);console.log(`\n  Creating KickJS project: ${n}\n`),t.versions||p(`Resolving package versions...`);let h=t.versions??await Q(),g=Object.keys(h).filter(e=>h[e]===`latest`);if(g.length>0&&p(`WARNING: could not reach npm for ${g.join(`, `)} — pinned to 'latest'`),d!==`express`){if(ze(`@forinda/kickjs`,`latest`,`./${d}`))p(`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=Le(r,`alpha`);e&&Re(e,$(h[r]))&&(h[r]=`^${e}`,t.push(`${r}@^${e}`),r===`@forinda/kickjs`&&(n=!0))}p(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`)}}let _=l.filter(e=>!s(i(b,`feature-${e}`)));_.length>0&&p(`WARNING: skipping unknown package(s): ${_.join(`, `)} — add them later with kick add`);let v=S([...He({template:o,runtime:d,schemaLib:u,packages:l}),...t.platformConfig===!1?[]:[`host-config`],...t.extraLayers??[]],{vars:{name:n,version:X.version},extra:[{slot:`repo`,code:c===`inmemory`?`repo: 'inmemory'`:`repo: { name: '${c.replace(/\\/g,`\\\\`).replace(/'/g,`\\'`)}' }`},...t.spaClientDir?[Ve(t.spaClientDir)]:[]]});await e(i(f,`package.json`),oe(n,h,v));let y=C(v.files,{name:n,template:o,runtime:d,packageManager:a,templateLabel:o===`rest`?`REST API`:`Minimal`,packages:[...v.dependencies,...v.devDependencies].filter(e=>e.startsWith(`@forinda/`)).map(e=>`- \`${e}\``).join(`
-`)});for(let[t,n]of y)await e(i(f,t),n);let{generateAgentDocs:x}=await import(`./agent-docs-BO_QMIkN.mjs`).then(e=>e.t);await x({outDir:f,name:n,pm:a,template:o,only:`all`,force:!0});let w={...Oe,...J(l),...v.builds};if(t.approveInstallScripts!==!1&&q(a,f,w),t.installDeps){console.log(`\n  Installing dependencies with ${a}...\n`);try{m(`${a} install`,{cwd:f,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-BOxA_1DU.mjs`).then(e=>e.n);await e({cwd:f,allowDuplicates:!0,silent:!0})}catch{}if(t.initGit)try{m(`git init`,{cwd:f,stdio:`pipe`}),m(`git branch -M main`,{cwd:f,stdio:`pipe`}),m(`git add -A`,{cwd:f,stdio:`pipe`}),m(`git commit -m "chore: initial commit from kick new"`,{cwd:f,stdio:`pipe`}),p(`Git repository initialized`)}catch{p(`Warning: git init failed (git may not be installed)`)}console.log(`
+`),console.log(Se(n).replace(/^/gm,`    `)),console.log())}}b?console.log(`  Done!
+`):(console.log(`  Finished with errors — the install above did not complete.
+`),process.exitCode=1)})}const Y=r(g(import.meta.url)),X=JSON.parse(c([i(Y,`..`,`package.json`),i(Y,`..`,`..`,`package.json`)].find(s),`utf-8`)),Ne=[`@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`],Pe={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`},"@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:`^1.0.0`,cap:`^1`},"serve-static":{fallback:`^2.2.0`,cap:`^2`},zod:{fallback:`^4.3.6`,cap:`^4`},valibot:{fallback:`^1.4.1`,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 Fe(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 Ie(e){return e===`@forinda/kickjs-cli`?`^${X.version}`:`latest`}async function Z(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 Q(){let e=[...Ne.map(e=>({name:e,fallback:Ie(e),cap:void 0})),...Object.entries(Pe).map(([e,t])=>({name:e,...t}))],t=Date.now()+2e4,n=await Z(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=Fe(await ie(`npm`,r?[`view`,a,`version`,`--json`]:[`view`,a,`version`],{timeout:i}));return[e,o?`^${o}`:n]});return Object.fromEntries(n)}function Le(e,t){let n=k(`npm`,[`view`,`${e}@${t}`,`version`],{timeout:2e4});return n&&/^\d+\.\d+\.\d+/.test(n)?n:null}function $(e){return(e??``).replace(/^[\^~>=<\s]+/,``)}function Re(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 ze(e,t,n){let r=k(`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 Be(t){let{name:n,directory:r,packageManager:a=`pnpm`,template:o=`rest`,defaultRepo:c=`inmemory`,packages:l=[],schemaLib:u=`zod`,runtime:d=`express`}=t,f=r,p=e=>console.log(`  ${e}`);console.log(`\n  Creating KickJS project: ${n}\n`),t.versions||p(`Resolving package versions...`);let h=t.versions??await Q(),g=Object.keys(h).filter(e=>h[e]===`latest`);if(g.length>0&&p(`WARNING: could not reach npm for ${g.join(`, `)} — pinned to 'latest'`),d!==`express`){if(ze(`@forinda/kickjs`,`latest`,`./${d}`))p(`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=Le(r,`alpha`);e&&Re(e,$(h[r]))&&(h[r]=`^${e}`,t.push(`${r}@^${e}`),r===`@forinda/kickjs`&&(n=!0))}p(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`)}}let _=l.filter(e=>!s(i(b,`feature-${e}`)));_.length>0&&p(`WARNING: skipping unknown package(s): ${_.join(`, `)} — add them later with kick add`);let v=S([...He({template:o,runtime:d,schemaLib:u,packages:l}),...t.platformConfig===!1?[]:[`host-config`],...t.extraLayers??[]],{vars:{name:n,version:X.version},extra:[{slot:`repo`,code:c===`inmemory`?`repo: 'inmemory'`:`repo: { name: '${c.replace(/\\/g,`\\\\`).replace(/'/g,`\\'`)}' }`},...t.spaClientDir?[Ve(t.spaClientDir)]:[]]});await e(i(f,`package.json`),oe(n,h,v));let y=C(v.files,{name:n,template:o,runtime:d,packageManager:a,templateLabel:o===`rest`?`REST API`:`Minimal`,packages:[...v.dependencies,...v.devDependencies].filter(e=>e.startsWith(`@forinda/`)).map(e=>`- \`${e}\``).join(`
+`)});for(let[t,n]of y)await e(i(f,t),n);let{generateAgentDocs:x}=await import(`./agent-docs-BWnHJdm8.mjs`).then(e=>e.t);await x({outDir:f,name:n,pm:a,template:o,only:`all`,force:!0});let w={...Oe,...J(l),...v.builds};if(t.approveInstallScripts!==!1&&q(a,f,w),t.installDeps){console.log(`\n  Installing dependencies with ${a}...\n`);try{m(`${a} install`,{cwd:f,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-Cs40J3ar.mjs`).then(e=>e.n);await e({cwd:f,allowDuplicates:!0,silent:!0})}catch{}if(t.initGit)try{m(`git init`,{cwd:f,stdio:`pipe`}),m(`git branch -M main`,{cwd:f,stdio:`pipe`}),m(`git add -A`,{cwd:f,stdio:`pipe`}),m(`git commit -m "chore: initial commit from kick new"`,{cwd:f,stdio:`pipe`}),p(`Git repository initialized`)}catch{p(`Warning: git init failed (git may not be installed)`)}console.log(`
   Project scaffolded successfully!`),console.log();let T=f!==process.cwd();p(`Next steps:`),T&&p(`  cd ${n}`),t.installDeps||p(`  ${a} install`);let E={rest:`kick g module user`,minimal:`# add your routes to src/index.ts`};return p(`  ${E[o]??E.rest}`),p(`  kick dev`),p(``),p(`Commands:`),p(`  kick dev                  Start dev server with Vite HMR`),p(`  kick build                Production build via Vite`),p(`  kick start                Run production build`),p(``),p(`Generators:`),p(`  kick g module <name>      REST module (controller, service, DTOs, repository)`),p(`  kick g scaffold <n> <f..> CRUD module from field definitions`),p(`  kick g controller <name>  Standalone controller`),p(`  kick g service <name>     @Service() class`),p(`  kick g middleware <name>   Global connect-style middleware`),p(`  kick g guard <name>       Route guard (auth, roles, etc.)`),p(`  kick g adapter <name>     AppAdapter with lifecycle hooks`),p(`  kick g dto <name>         DTO schema (Zod / Valibot / Yup)`),p(`  kick g config             Generate kick.config.ts`),p(``),p(`Add packages:`),p(`  kick add <pkg>            Install a KickJS package + peers`),p(`  kick add --list           Show all available packages`),p(``),p(`Available: ${Ce}`),p(``),{builds:w}}function Ve(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 He(e){return[`base`,`template-${e.template}`,`runtime-${e.runtime}`,`schema-${e.schemaLib}`,...e.packages.filter(e=>s(i(b,`feature-${e}`))).map(e=>`feature-${e}`)]}export{q as a,V as c,re as d,C as f,z as i,De as l,Q as n,Me as o,S as p,L as r,je as s,Be as t,ne as u};
-//# sourceMappingURL=project-BjxeGJBn.mjs.map
+//# sourceMappingURL=project-16gsHLs5.mjs.map