@forinda/kickjs-cli 8.10.1 → 8.11.0

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.10.1
+ * @forinda/kickjs-cli v8.11.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,4 +8,4 @@
  *
  * @license MIT
  */
-import{_ as e}from"./project-BBiJ64ya.mjs";import{o as t}from"./config-CVuSVUvw.mjs";import{n}from"./plugin-FOqPjQ0u.mjs";import{t as r}from"./builtins-CNJXXYW-.mjs";import{t as i}from"./project-root-BMpUTIbO.mjs";import{Command as a}from"commander";import{readFileSync as o}from"node:fs";import{delimiter as s,dirname as c,join as l}from"node:path";import{fileURLToPath as u}from"node:url";function d(e,t){if(!t?.commands?.length)return;let n=new Set(e.commands.map(e=>e.name()));for(let r of t.commands)n.has(r.name)?console.warn(`  Warning: custom command '${r.name}' skipped — conflicts with a built-in command`):f(e,r)}function f(t,n){let r=t.command(n.name).description(n.description);if(n.aliases)for(let e of n.aliases)r.alias(e);r.allowUnknownOption(!0),r.argument(`[args...]`,`Additional arguments passed to the command`);function i(){return{PATH:`${l(process.cwd(),`node_modules`,`.bin`)}${s}${process.env.PATH??``}`}}r.action(t=>{let r=t.join(` `),a=Array.isArray(n.steps)?n.steps:[n.steps];for(let t of a){let a=r?`${t} ${r}`:t;console.log(`  $ ${a}`);try{e(a,void 0,i())}catch{console.error(`  Command failed: ${n.name}`),process.exitCode=1;return}}})}const p=c(u(import.meta.url)),m=JSON.parse(o(l(p,`..`,`package.json`),`utf-8`));async function h(){let e=new a;e.name(`kick`).description(`KickJS — A production-grade, decorator-driven Node.js framework`).version(m.version);let o=i(process.cwd()),s=o,c=await t(s)??{},l=[...r,...c.plugins??[]],u=n(l,c.commands??[]);await u.register(e,{cwd:s,projectRoot:o,config:c,log:e=>console.log(e)}),d(e,{...c,commands:u.commands}),e.showHelpAfterError();let f=process.argv.map(e=>e===`-v`?`--version`:e);await e.parseAsync(f)}h().catch(e=>{console.error(e instanceof Error?e.message:e),process.exitCode=1});export{};
+import{_ as e}from"./project-CDUJMeIr.mjs";import{o as t}from"./config-DhzyaY1S.mjs";import{n}from"./plugin-DS5g6A5U.mjs";import{t as r}from"./builtins-d9YrHyb1.mjs";import{t as i}from"./project-root-Da2aMneY.mjs";import{Command as a}from"commander";import{readFileSync as o}from"node:fs";import{delimiter as s,dirname as c,join as l}from"node:path";import{fileURLToPath as u}from"node:url";function d(e,t){if(!t?.commands?.length)return;let n=new Set(e.commands.map(e=>e.name()));for(let r of t.commands)n.has(r.name)?console.warn(`  Warning: custom command '${r.name}' skipped — conflicts with a built-in command`):f(e,r)}function f(t,n){let r=t.command(n.name).description(n.description);if(n.aliases)for(let e of n.aliases)r.alias(e);r.allowUnknownOption(!0),r.argument(`[args...]`,`Additional arguments passed to the command`);function i(){return{PATH:`${l(process.cwd(),`node_modules`,`.bin`)}${s}${process.env.PATH??``}`}}r.action(t=>{let r=t.join(` `),a=Array.isArray(n.steps)?n.steps:[n.steps];for(let t of a){let a=r?`${t} ${r}`:t;console.log(`  $ ${a}`);try{e(a,void 0,i())}catch{console.error(`  Command failed: ${n.name}`),process.exitCode=1;return}}})}const p=c(u(import.meta.url)),m=JSON.parse(o(l(p,`..`,`package.json`),`utf-8`));async function h(){let e=new a;e.name(`kick`).description(`KickJS — A production-grade, decorator-driven Node.js framework`).version(m.version);let o=i(process.cwd()),s=o,c=await t(s)??{},l=[...r,...c.plugins??[]],u=n(l,c.commands??[]);await u.register(e,{cwd:s,projectRoot:o,config:c,log:e=>console.log(e)}),d(e,{...c,commands:u.commands}),e.showHelpAfterError();let f=process.argv.map(e=>e===`-v`?`--version`:e);await e.parseAsync(f)}h().catch(e=>{console.error(e instanceof Error?e.message:e),process.exitCode=1});export{};

package/dist/config-CcsYA02N.mjs

@@ -0,0 +1,13 @@
+/**
+ * @forinda/kickjs-cli v8.11.0
+ *
+ * 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{t as e}from"./rolldown-runtime-DAPeToCs.mjs";import{dirname as t,isAbsolute as n,join as r,relative as i,resolve as a}from"node:path";import{existsSync as o,mkdirSync as s,readFileSync as c,writeFileSync as l}from"node:fs";import{access as u,readFile as d}from"node:fs/promises";import{fileURLToPath as f}from"node:url";var p=/* @__PURE__ */ e({BUILTIN_REPO_TYPES:()=>_,DEPRECATED_REPO_TYPES:()=>v,PACKAGE_MANAGERS:()=>m,PLURALIZE_DEFAULT:()=>!1,defineConfig:()=>b,execBin:()=>g,hasDependency:()=>x,hasSwagger:()=>S,loadKickConfig:()=>j,resolveModuleConfig:()=>O,resolvePluralize:()=>E,resolvePluralizeRoutes:()=>D,resolveSchemaLib:()=>C,resolveTokenScope:()=>w,runScript:()=>h,validateAssetMap:()=>N,warnIfDeprecatedRepo:()=>y,writeAssetConfigSnapshot:()=>M});const m=[`pnpm`,`npm`,`yarn`,`bun`];function h(e,t){return e===`npm`||e===`bun`?`${e} run ${t}`:`${e} ${t}`}function g(e,t){return{npm:`npx ${t}`,pnpm:`pnpm exec ${t}`,yarn:`yarn ${t}`,bun:`bunx ${t}`}[e]}const _=[`inmemory`],v=[`prisma`,`drizzle`];function y(e){return v.includes(e)?(console.warn(`  Note: '${e}' is no longer a built-in repository preset — a repository shaped to it is that library's interface, not KickJS's.\n  Scaffolding a generic custom-repository stub instead; wire it to ${e} yourself.`),!0):!1}function b(e){return e}function x(e,t,n=`runtime`){try{let i=r(e,`package.json`);if(!o(i))return!1;let a=JSON.parse(c(i,`utf-8`));return a.dependencies?.[t]?!0:n===`any`&&!!a.devDependencies?.[t]}catch{return!1}}function S(e){return x(e,`@forinda/kickjs-swagger`,`runtime`)}function C(e){return x(e,`valibot`,`runtime`)?`valibot`:x(e,`yup`,`runtime`)?`yup`:`zod`}function w(e,t){if(e?.tokenScope&&typeof e.tokenScope==`string`&&e.tokenScope.length>0){let t=T(e.tokenScope);if(t.length>0)return t}try{let e=r(t,`package.json`);if(o(e)){let t=JSON.parse(c(e,`utf-8`));if(typeof t.name==`string`&&t.name.length>0){let e=t.name.match(/^@([^/]+)\//),n=T(e?e[1]:t.name);if(n.length>0)return n}}}catch{}return`app`}function T(e){return e.toLowerCase().replace(/[^a-z0-9-]/g,`-`).replace(/^-+|-+$/g,``).replace(/-{2,}/g,`-`)}function E(e,t){return e??t?.pluralize??!1}function D(e,t){return e??t?.pluralizeRoutes??!0}function O(e){if(!e)return{};let t={dir:e.modules?.dir,repo:e.modules?.repo,schemaDir:e.modules?.schemaDir,pluralize:e.modules?.pluralize,pluralizeRoutes:e.modules?.pluralizeRoutes,style:e.modules?.style};return t.style!==void 0&&t.style!==`define`&&t.style!==`class`&&(console.warn(`  Warning: modules.style '${t.style}' is not a valid value (expected 'define' or 'class'). Falling back to 'define'.`),t.style=`define`),t.repo&&typeof t.repo==`string`&&!_.includes(t.repo)&&(y(t.repo)||console.warn(`  Warning: modules.repo '${t.repo}' is not a built-in type (${_.join(`, `)}). It will generate a stub repository. Use { name: '${t.repo}' } to silence this warning.`)),t}const k=[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`,`kick.config.json`];function A(e){for(let n=e;;n=t(n)){if(o(r(n,`node_modules`,`@forinda`,`kickjs-cli`,`package.json`)))return{};if(t(n)===n)break}let n=r(t(f(import.meta.url)),`..`),i=[r(n,`dist`,`index.mjs`),r(n,`src`,`index.ts`)].find(o);return i?{"@forinda/kickjs-cli":i}:{}}async function j(e){let{findProjectRoot:t}=await import(`./project-root-ThZdP1t_.mjs`).then(e=>e.n),n=t(e);for(let e of k){let t=r(n,e);try{await u(t)}catch{continue}if(e.endsWith(`.json`)){let e=await d(t,`utf-8`);return JSON.parse(e)}if(e.endsWith(`.ts`)){let r;try{r=await import(`jiti`)}catch(t){let n=t instanceof Error?t.message:String(t);n.includes(`Cannot find package 'jiti'`)||n.includes(`ERR_MODULE_NOT_FOUND`)?console.warn(`Warning: Failed to load ${e} — 'jiti' is required for TypeScript configs. Install jiti as a dev dependency, or rename the file to kick.config.js / kick.config.mjs / kick.config.json.`):console.warn(`Warning: Failed to initialize jiti for ${e}: ${n}`);continue}try{let e=await r.createJiti(n,{interopDefault:!0,fsCache:!1,alias:A(n),tsconfigPaths:!0}).import(t,{default:!0}),i=N(e,n);for(let e of i)console.warn(`  Warning: ${e}`);return M(n,e),e}catch(t){let n=t instanceof Error?t.message:String(t);console.warn(`Warning: Failed to load ${e}: ${n}`);continue}}try{let{pathToFileURL:e}=await import(`node:url`),r=await import(e(t).href),i=r.default??r,a=N(i,n);for(let e of a)console.warn(`  Warning: ${e}`);return M(n,i),i}catch(t){let n=t instanceof Error?t.message:String(t);console.warn(`Warning: Failed to load ${e}: ${n}`);continue}}return null}function M(e,t){if(t?.assetMap&&Object.keys(t.assetMap).length!==0)try{let n=r(e,`.kickjs`);s(n,{recursive:!0});let i={version:1,assetMap:t.assetMap,...t.build?.outDir?{build:{outDir:t.build.outDir}}:{}};l(r(n,`kick.config.json`),JSON.stringify(i,null,2)+`
+`,`utf-8`)}catch{}}function N(e,t){let n=[];if(!e?.assetMap)return n;let r=a(t);for(let[i,s]of Object.entries(e.assetMap)){if(!i||i.includes(`/`)){n.push(`assetMap key '${i}' is invalid — must be a non-empty string without '/'`);continue}if(typeof s?.src!=`string`||s.src.length===0){n.push(`assetMap.${i} is missing a non-empty 'src' field`);continue}let e=a(t,s.src);o(e)||n.push(`assetMap.${i}.src ('${s.src}') does not exist — typegen + build will fail`),s.dest&&P(a(t,s.dest),r)&&n.push(`assetMap.${i}.dest ('${s.dest}') resolves outside the project root — refusing to copy`)}return n}function P(e,t){let r=i(t,e);return r===``?!1:r.startsWith(`..`)||n(r)}export{x as a,O as c,C as d,w as f,g as i,E as l,y as m,p as n,S as o,h as p,b as r,j as s,m as t,D as u};
+//# sourceMappingURL=config-CcsYA02N.mjs.map

package/dist/config-CcsYA02N.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-CcsYA02N.mjs","names":["__exportAll","config_exports","BUILTIN_REPO_TYPES","DEPRECATED_REPO_TYPES","PACKAGE_MANAGERS","defineConfig","execBin","hasDependency","hasSwagger","loadKickConfig","resolveModuleConfig","resolvePluralize","resolvePluralizeRoutes","resolveSchemaLib","resolveTokenScope","runScript","validateAssetMap","warnIfDeprecatedRepo","writeAssetConfigSnapshot","pm","script","bin","repo","config","pkgPath","join","cwd","existsSync","pkg","readFileSync","name","scope","sanitised","sanitizeScope","scoped","candidate","raw","flag","mc","CONFIG_FILES","selfAlias","dir","root","dirname","pkgRoot","fileURLToPath","entry","n","findProjectRoot","startDir","filename","filepath","access","content","readFile","jitiModule","err","msg","warnings","warning","mod","pathToFileURL","mkdirSync","snapshot","writeFileSync","resolve","namespace","srcAbs","escapesRoot","rel","relative","path","isAbsolute"],"sources":["../src/config.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'\nimport { readFile, access } from 'node:fs/promises'\nimport { dirname, isAbsolute, join, relative, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nimport type { KickCliPlugin } from './plugin/types'\n\n/** A custom command that developers can register via kick.config.ts */\nexport interface KickCommandDefinition {\n  /** The command name (e.g. 'db:migrate', 'seed', 'proto:gen') */\n  name: string\n  /** Description shown in --help */\n  description: string\n  /**\n   * Shell command(s) to run. Can be a single string or an array of\n   * sequential steps. Use {args} as a placeholder for CLI arguments.\n   *\n   * @example\n   * 'npx drizzle-kit migrate'\n   * ['npx drizzle-kit generate', 'npx drizzle-kit migrate']\n   */\n  steps: string | string[]\n  /** Optional aliases (e.g. ['migrate'] for 'db:migrate') */\n  aliases?: string[]\n}\n\n/** Project pattern — controls what generators produce and which deps are installed */\nexport type ProjectPattern = 'rest' | 'minimal'\n\n/** Package manager used for `kick add` and other dep-installing commands */\nexport type PackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun'\n\nexport const PACKAGE_MANAGERS: readonly PackageManager[] = ['pnpm', 'npm', 'yarn', 'bun']\n\n/**\n * A package.json script as `pm` runs it. npm needs `run` for anything but\n * `test`/`start`, and `bun test` / `bun build` are Bun's own tools, not the script.\n */\nexport function runScript(pm: PackageManager, script: string): string {\n  return pm === 'npm' || pm === 'bun' ? `${pm} run ${script}` : `${pm} ${script}`\n}\n\n/** A binary installed in the project, as `pm` runs it — a bare `kick` needs a global install. */\nexport function execBin(pm: PackageManager, bin: string): string {\n  return { npm: `npx ${bin}`, pnpm: `pnpm exec ${bin}`, yarn: `yarn ${bin}`, bun: `bunx ${bin}` }[\n    pm\n  ]\n}\n\n/**\n * Built-in repository type with first-class code generation support.\n *\n * Only `inmemory` is built in — zero-dependency and framework-owned.\n *\n * There are deliberately no ORM presets. A repository shaped to Prisma or\n * Drizzle is that library's interface, not KickJS's, and a generator for it is\n * a promise to track someone else's API across versions. Any other name\n * scaffolds a generic custom-repository stub you own, passed as an object\n * because `RepoTypeConfig` is `BuiltinRepoType | CustomRepoType` and the\n * builtin side is `'inmemory'` alone: `repo: { name: 'postgres' }`.\n */\nexport type BuiltinRepoType = 'inmemory'\n\nexport const BUILTIN_REPO_TYPES: readonly string[] = ['inmemory']\n\n/**\n * Repo names that once had dedicated ORM generators. They still scaffold — as\n * the same generic stub any other custom name produces — and the CLI says so\n * once, because silently changing what a flag generates is worse than a note.\n */\nexport const DEPRECATED_REPO_TYPES: readonly string[] = ['prisma', 'drizzle']\n\n/**\n * Print a note when a generator is asked for a repo that used to be a preset.\n * No-op for every other name. Returns whether a note was printed.\n */\nexport function warnIfDeprecatedRepo(repo: string): boolean {\n  if (!DEPRECATED_REPO_TYPES.includes(repo)) return false\n  console.warn(\n    `  Note: '${repo}' is no longer a built-in repository preset — a repository ` +\n      `shaped to it is that library's interface, not KickJS's.\\n` +\n      `  Scaffolding a generic custom-repository stub instead; wire it to ${repo} yourself.`,\n  )\n  return true\n}\n\n/** Custom repository type — generates a stub with TODO markers */\nexport interface CustomRepoType {\n  name: string\n}\n\n/** Repository type — built-in string or custom object */\nexport type RepoTypeConfig = BuiltinRepoType | CustomRepoType\n\n/**\n * Supported schema validators for `kick typegen` body/query/params\n * type extraction.\n *\n * - `'zod'` — emits `import('zod').infer<typeof schema>` (default)\n * - `'kickjs-schema'` — emits `InferSchemaOutput<typeof schema>` from\n *   `@forinda/kickjs-schema`, works with Zod, Valibot, Yup, and any\n *   Standard Schema v1 or KickSchema adapter\n * - `false` — disables schema-driven body typing (fields stay `unknown`)\n */\nexport type SchemaValidator = 'zod' | 'kickjs-schema' | false\n\n/**\n * One entry in the typed `assetMap` config record.\n * Each entry names a source directory whose files become addressable\n * via the `assets.<name>.*` typed accessor at runtime.\n */\nexport interface AssetMapEntry {\n  /**\n   * Source directory, relative to project root. Required. The directory\n   * must exist when `kick build` runs — `loadKickConfig` warns when an\n   * entry points at a missing directory but doesn't fail the load\n   * (the typegen + build steps surface the error in context instead).\n   */\n  src: string\n  /**\n   * Destination directory inside `dist/`. Defaults to `dist/<name>/`\n   * where `<name>` is the assetMap key. Override when the consumer of\n   * the assets expects a non-standard layout (e.g. an existing\n   * downstream tool reads from `dist/templates/...`).\n   */\n  dest?: string\n  /**\n   * Glob pattern for which files to include. Defaults to `**\\/*` (all\n   * files). Files that don't match are NOT copied — `assetMap` is\n   * selective by design (unlike `copyDirs` which copies everything).\n   */\n  glob?: string\n  /**\n   * How file extensions feed into manifest keys. Default `'auto'`.\n   *\n   * - `'strip'` — drop the extension. `pages/index.pug` →\n   *   `'pages/index'`. Two siblings with the same basename collide;\n   *   last-walk-order wins, others are silently dropped. Opt-in\n   *   only — kept for backward compatibility with projects that\n   *   relied on this contract.\n   * - `'with-extension'` — keep every extension on every key. Best\n   *   when the namespace holds extension siblings (`index.pug` +\n   *   `index.html` + `index.css` in `src/pages/`); every file\n   *   reaches the manifest under its full path.\n   * - `'auto'` — strip when basenames are unique, keep extensions\n   *   on collision groups. Singleton files keep their short key;\n   *   `pages/index.{pug,html,css}` becomes\n   *   `pages/index.pug` / `pages/index.html` / `pages/index.css`.\n   *   No data loss; non-colliding namespaces stay on the short\n   *   keys they had before.\n   *\n   * @default 'auto'\n   */\n  keys?: 'auto' | 'strip' | 'with-extension'\n}\n\n/**\n * Database settings consumed by `kick db generate`, `kick db migrate`,\n * and the M4.C composite-type detection gate. Mirrors the runtime\n * `DbConfig` shape from `@forinda/kickjs-db` — duplicated here so\n * adopters who only install `@forinda/kickjs-cli` can set the block\n * without pulling `@forinda/kickjs-db` types into their kick.config.ts\n * resolution. The CLI loads kick.config.ts through `loadKickConfig`,\n * then `resolveDbConfig` re-reads this block from the same module and\n * normalises defaults (`schemaPath` / `migrationsDir` / `dialect`).\n *\n * @example\n * ```ts\n * defineConfig({\n *   db: {\n *     schemaPath: 'src/db/schema.ts',\n *     migrationsDir: 'db/migrations',\n *     dialect: 'postgres',\n *     connectionString: process.env.DATABASE_URL,\n *   },\n * })\n * ```\n */\nexport interface KickDbConfigBlock {\n  /**\n   * Path to the schema module (`pgEnum` / `table` declarations).\n   * Defaults to `'src/db/schema.ts'`.\n   */\n  schemaPath?: string\n  /**\n   * Where `kick db generate` writes migration directories. Defaults\n   * to `'db/migrations'`.\n   */\n  migrationsDir?: string\n  /** Where `kick db seed` finds seed files. Defaults to `'db/seeds'`. */\n  seedsDir?: string\n  /** SQL dialect. Defaults to `'postgres'`. */\n  dialect?: 'postgres' | 'sqlite' | 'mysql'\n  /**\n   * Postgres connection string for the built-in pgAdapter path. Read\n   * from the `DATABASE_URL` env var when omitted. Used by\n   * `kick db migrate*` and the M4.C composite-type gate at\n   * `kick db generate`.\n   */\n  connectionString?: string\n  /**\n   * Escape hatch: a factory returning a fully-constructed\n   * MigrationAdapter (typed loosely here so the CLI types don't pull\n   * `@forinda/kickjs-db` into adopter projects that don't import it).\n   * Takes precedence over `connectionString` when both are set.\n   */\n  adapter?: () => unknown | Promise<unknown>\n}\n\n/** Typegen settings — controls .kickjs/types/* generation */\nexport interface TypegenConfig {\n  /**\n   * Source directory to scan for controllers and decorators.\n   * Defaults to `'src'`.\n   */\n  srcDir?: string\n  /**\n   * Output directory for generated `.d.ts` files.\n   * Defaults to `'.kickjs/types'`.\n   */\n  outDir?: string\n  /**\n   * Schema validator used to derive `body` types from route metadata.\n   *\n   * - `'zod'` — emit `z.infer<typeof <importedSchema>>` for any schema\n   *   referenced as a named identifier in `@Get/@Post/...({ body, query, params })`.\n   * - `false` — disable schema-driven body typing.\n   *\n   * Future: `'joi' | 'yup' | 'json-schema'` plus a `{ name; module }`\n   * escape hatch for custom adapters.\n   *\n   * @default 'zod'\n   */\n  schemaValidator?: SchemaValidator\n  /**\n   * Path to the project's env schema file (relative to project root).\n   * Must default-export a `defineEnv(...)` schema for typegen to emit\n   * the typed `KickEnv` global registry.\n   *\n   * Set to `false` to disable env typing entirely.\n   *\n   * @default 'src/env.ts'\n   */\n  envFile?: string | false\n  /**\n   * Built-in or user typegen plugin ids to skip during `kick typegen`,\n   * `kick dev`, and `kick typegen --watch`.\n   *\n   * The plugin still loads and merge-time conflict detection still\n   * runs — only the `generate()` invocation is skipped — so adopters\n   * who want to hand-write `KickDbRegister` (manual typeof-schema\n   * augmentation) can disable `'kick/db'` and keep the rest:\n   *\n   * @example\n   * typegen: {\n   *   disable: ['kick/db'],   // hand-written register.ts owns the type\n   * }\n   *\n   * Unrecognised ids are ignored — the list is treated as a wishlist,\n   * not a strict registry.\n   */\n  disable?: string[]\n\n  /**\n   * Generate `.kickjs/types/kick__client.d.ts`, the self-contained route map\n   * a frontend consumes without compiling the server.\n   *\n   * Producing it means building a whole TypeScript program over the server —\n   * measured at 1.1 GB and ~7.6s on a 1,940-route app, against ~130ms for\n   * every other typegen plugin combined. An API with no frontend should not\n   * pay that for a file nothing reads, so this is not on for everyone.\n   *\n   * Off unless set. `kick new --template fullstack` writes `true`, since its\n   * web app reads the map; anything else opts in here.\n   *\n   * A map already on disk does NOT turn this on — that would put the switch\n   * somewhere nobody looks. It does get a warning, since a map left to rot is\n   * how a frontend ends up type-checking against routes the server no longer\n   * serves.\n   *\n   * Pass an object to tune the expansion. `{ maxDepth }` sets how deeply a\n   * response type nests inline before the type at that point is hoisted to a\n   * declaration of its own. Hoists spend a per-route budget of 1,000; a route\n   * that exhausts it — an endlessly growing generic, or a very large response\n   * — is emitted as `unknown` with a warning:\n   *\n   * ```ts\n   * typegen: { client: { maxDepth: 24 } }\n   * ```\n   */\n  client?: boolean | ClientTypegenConfig\n}\n\n/** Tuning for the client route map — see `TypegenConfig.client`. */\nexport interface ClientTypegenConfig {\n  /** On, unless explicitly false. Lets `{ maxDepth }` alone mean \"on\". */\n  enabled?: boolean\n  /**\n   * Levels of inline nesting before a type is hoisted to its own declaration\n   * (`interface __Tn` / `type __Tn`). Each hoist spends from a per-route budget\n   * of 1,000, so a higher value hoists fewer types and lets a larger response\n   * through. Default 12.\n   */\n  maxDepth?: number\n}\n\n/** Module generation settings — controls how `kick g module` produces code */\nexport interface ModuleConfig {\n  /** Where modules live (default: 'src/modules') */\n  dir?: string\n  /**\n   * Default repository implementation for generators.\n   *\n   * @deprecated The name no longer changes the generated code. Only\n   * `'inmemory'` produces a distinct file — the one built-in with a real\n   * working implementation. Every other value scaffolds the SAME\n   * unimplemented stub, named for the module rather than the store, since a\n   * `PostgresUserRepository` that is not yet Postgres asserts something the\n   * file does not honour.\n   *\n   * The value survives only as prose: the store appears in the stub's comments\n   * and in its \"not implemented\" errors, as a note to the person writing the\n   * query. Set it for that hint, or leave it unset and get the in-memory\n   * implementation.\n   *\n   * Kept working, and there is no plan to remove it without a replacement.\n   *\n   * @example\n   * // unset            → InMemoryUserRepository, a working store\n   * repo: { name: 'postgres' }  // → UserRepository, unimplemented, \"write the postgres query\"\n   */\n  repo?: RepoTypeConfig\n  /** Schema output directory (e.g. 'src/db/schema') */\n  schemaDir?: string\n  /**\n   * Whether to pluralize module folder and file names.\n   * When false (default), `kick g module user` creates `src/modules/user/` and\n   * uses the name as typed throughout. When true, it creates `src/modules/users/`.\n   * The route path is controlled separately by {@link ModuleConfig.pluralizeRoutes}.\n   */\n  pluralize?: boolean\n  /**\n   * Whether the generated route path is the plural of the name. Default `true`:\n   * `kick g module task` mounts at `/tasks`, `user-profile` at `/user-profiles`;\n   * uncountables stay (`auth` → `/auth`). Set `false` to mount at the name as\n   * typed (`/task`). `--pluralize-routes` / `--no-pluralize-routes` override it.\n   */\n  pluralizeRoutes?: boolean\n  /**\n   * Module declaration style emitted by `kick g module` and the\n   * project scaffold.\n   *\n   * - `'define'` (default) — `defineModule({ name, build: () => ({...}) })`\n   *   factory form. Mirrors `defineAdapter` / `definePlugin` /\n   *   `defineContextDecorator`.\n   * - `'class'` — legacy `class FooModule implements AppModule { ... }`\n   *   form. Still fully supported by the framework loader; pin to this\n   *   value for projects that prefer the class shape (existing-codebase\n   *   consistency, class-decorator setups, etc).\n   *\n   * The framework runtime accepts both shapes regardless of this\n   * setting — the flag controls codegen output only. `kick g module`\n   * inserts the matching call form into `src/modules/index.ts`\n   * (`Module()` vs `Module`); `kick rm module` matches both.\n   *\n   * @default 'define'\n   */\n  style?: 'define' | 'class'\n}\n\n/** Configuration for the kick.config.ts file */\n/**\n * `deploy` block — overrides for the detected serverless layout.\n *\n * @example\n * ```ts\n * defineConfig({\n *   // API-only project that should keep its routes under /api\n *   deploy: { apiPath: '/api' },\n * })\n * ```\n */\nexport interface DeployConfig {\n  /** Serverless entry exporting `handler = createHandler(...)`. Default `src/serverless.ts`. */\n  entry?: string\n  /** Where the bundle is written, under the project. Default `dist/serverless`. */\n  outDir?: string\n  /**\n   * Built frontend to publish next to the API. Detected as `../web/dist` in a\n   * fullstack workspace; `false` forces an API-only deploy.\n   */\n  staticDir?: string | false\n  /**\n   * Directory the platform deploys from, relative to the project — where\n   * `.netlify/` and `.vercel/` are written. Detected: `..` for a fullstack\n   * workspace member, `.` otherwise.\n   */\n  siteRoot?: string\n  /**\n   * Empty directory for Netlify's `publish` when there is no frontend; the\n   * build creates it. Default `dist/public`.\n   */\n  publishDir?: string\n  /**\n   * URL prefix routed to the function. Detected: `/api` alongside a frontend,\n   * `''` (every path) for an API-only project.\n   */\n  apiPath?: string\n  /** Optional peers to leave out of the bundle when not installed. Default `['valibot', 'yup']`. */\n  external?: string[]\n  /** Vercel Node runtime. Default `nodejs22.x`. */\n  vercelRuntime?: string\n  /**\n   * Files and directories the app reads at runtime, relative to the project —\n   * packaged with the function at the same paths. Detected for an Inertia\n   * app: the client build manifest and the SSR bundle.\n   */\n  include?: string[]\n}\n\nexport interface KickConfig {\n  /**\n   * Project pattern — the module shape `kick g module` produces by default.\n   * `--pattern` overrides it per call.\n   * - 'rest' — flat module: controller, service, DTOs, repository (default)\n   * - 'minimal' — controller + module only\n   */\n  pattern?: ProjectPattern\n  /**\n   * Module generation settings — directory, repo type, pluralization, schema dir.\n   *\n   * @example\n   * modules: {\n   *   dir: 'src/modules',\n   *   repo: 'postgres',\n   *   pluralize: false,\n   *   schemaDir: 'src/db/schema',\n   * }\n   */\n  modules?: ModuleConfig\n  /**\n   * Package manager used by `kick add` (and any future dep-installing command)\n   * to install dependencies. When set, overrides lockfile auto-detection so\n   * commands always use the project's intended package manager.\n   *\n   * Priority (highest first):\n   * 1. `--pm` flag on the CLI\n   * 2. `packageManager` in kick.config\n   * 3. `packageManager` field in package.json (corepack convention)\n   * 4. Lockfile detection (pnpm-lock.yaml → pnpm, yarn.lock → yarn)\n   * 5. `'npm'`\n   *\n   * @example\n   * packageManager: 'pnpm'\n   */\n  packageManager?: PackageManager\n\n  /**\n   * The HTTP runtime the app boots on — the engine passed to\n   * `bootstrap({ runtime })`. Written by `kick new --runtime`, and read by\n   * dep-aware commands so they install / validate the engine-correct peers:\n   * - `kick add upload` picks the multipart driver (express → `multer`,\n   *   fastify → `@fastify/multipart`, h3 → built-in, no driver)\n   * - `kick doctor` checks the engine peers + upload driver are present\n   * - the `kick/runtime` typegen emits the `KickRuntimeRegister` augmentation\n   *   that flips the runtime-typed escape hatches (`AdapterContext.app`,\n   *   `getRuntimeApp()`) to the engine's native types\n   *\n   * Defaults to `'express'` when unset (the default engine).\n   *\n   * @example\n   * runtime: 'fastify'\n   */\n  runtime?: 'express' | 'fastify' | 'h3'\n\n  /**\n   * DI token scope prefix used by code generators. Every scaffolded\n   * `createToken<T>('<scope>/<area>/<key>')` substitutes this string\n   * for `<scope>`. Generators emit org-scoped tokens out of the box\n   * so adopter projects pass `kick-lint`'s `token-reserved-prefix`\n   * rule (which forbids the reserved `kick/` prefix on third-party\n   * code) without manual rename.\n   *\n   * Resolution order (highest first):\n   * 1. This field, when set\n   * 2. `package.json` `name` field — `@scope/pkg` → `'scope'`,\n   *    bare `pkg` → `'pkg'`\n   * 3. Fallback `'app'`\n   *\n   * @example\n   * tokenScope: 'mycorp'\n   * // → createToken<...>('mycorp/users/repository')\n   */\n  tokenScope?: string\n\n  /**\n   * Directories to copy to dist/ after build.\n   * Useful for EJS templates, email templates, static assets, etc.\n   *\n   * @example\n   * ```ts\n   * copyDirs: [\n   *   'src/views',                          // copies to dist/src/views\n   *   { src: 'src/views', dest: 'dist/views' }, // custom dest\n   *   'src/emails',\n   * ]\n   * ```\n   */\n  copyDirs?: Array<string | { src: string; dest?: string }>\n  /**\n   * Build output settings. The asset manager + `kick build`'s copy\n   * steps honour these — adopters who use Vite's `build.outDir =\n   * 'out'` (or any non-default) should mirror the value here so\n   * `assets.x.y()` paths line up with where Vite actually wrote.\n   *\n   * @example\n   * ```ts\n   * build: { outDir: 'out' }\n   * ```\n   */\n  build?: {\n    /**\n     * Output directory, relative to project root. Defaults to\n     * `'dist'`. The asset manager emits its manifest + copies\n     * assetMap entries into this directory (under a per-namespace\n     * subdirectory by default; override per-entry via `dest`).\n     */\n    outDir?: string\n  }\n  /**\n   * Typed, addressable assets — see https://kickjs.app/guide/asset-manager. Each entry maps\n   * a logical namespace name to a source directory. The build pipeline\n   * auto-derives the necessary copy step + emits a manifest at\n   * `dist/.kickjs-assets.json`; the runtime exposes\n   * `import { assets } from '@forinda/kickjs'` so adopters can resolve\n   * paths without dev/prod branching.\n   *\n   * `copyDirs` is unchanged — `assetMap` is a separate, opt-in surface.\n   * Adopters who want raw directory copies keep using `copyDirs`; those\n   * who want typed addressable assets add `assetMap` entries.\n   *\n   * @example\n   * ```ts\n   * assetMap: {\n   *   mails: { src: 'src/templates/mails' },\n   *   reports: { src: 'src/templates/reports', glob: '**\\/*.{ejs,html}' },\n   *   schemas: { src: 'src/schemas', glob: '**\\/*.json' },\n   * }\n   * ```\n   */\n  assetMap?: Record<string, AssetMapEntry>\n  /**\n   * Typegen settings — controls `.kickjs/types/*` generation including\n   * the schema validator used for body type extraction.\n   *\n   * @example\n   * ```ts\n   * typegen: {\n   *   schemaValidator: 'zod',\n   * }\n   * ```\n   */\n  typegen?: TypegenConfig\n  /**\n   * Dev-server (`kick dev`) settings.\n   */\n  dev?: {\n    /**\n     * Run the project's TypeScript checker (`tsgo --noEmit`, falling\n     * back to `tsc --noEmit`) after each debounced change and surface\n     * diagnostics in the dev console + a `kickjs:typecheck` HMR event.\n     * Equivalent to the `kick dev --typecheck` flag.\n     *\n     * @default false\n     */\n    typecheck?: boolean\n  }\n  /**\n   * Database settings — schema path, migrations dir, dialect,\n   * connection string, optional adapter factory. Consumed by\n   * `kick db generate` / `kick db migrate*`. See {@link KickDbConfigBlock}.\n   */\n  db?: KickDbConfigBlock\n  /** Custom commands that extend the CLI */\n  commands?: KickCommandDefinition[]\n  /**\n   * CLI plugins — bundled commands + typegens contributed by external\n   * packages (e.g. `@forinda/kickjs-cli-drizzle`). Plugin commands\n   * appear first; adopter `commands` overrides plugin commands of the\n   * same name. Duplicate commands or typegen ids across two plugins\n   * fail-fast at CLI startup.\n   *\n   * @example\n   * import { drizzlePlugin } from '@forinda/kickjs-cli-drizzle'\n   * export default defineConfig({\n   *   plugins: [drizzlePlugin({ schemaPath: 'src/db/schema' })],\n   * })\n   */\n  plugins?: KickCliPlugin[]\n  /**\n   * Serverless build targets for `kick build:netlify` / `kick build:vercel`.\n   * Every field is optional: the layout is detected from the project (a\n   * workspace member with a sibling `web` package is fullstack, anything\n   * else is API-only). See {@link DeployConfig}.\n   */\n  deploy?: DeployConfig\n  /** Code style overrides (auto-detected from prettier when possible) */\n  style?: {\n    semicolons?: boolean\n    quotes?: 'single' | 'double'\n    trailingComma?: 'all' | 'es5' | 'none'\n    indent?: number\n  }\n\n  /**\n   * Extensibility hook for `kick doctor`. Adopters add their own\n   * environment / project-shape checks here; each function receives\n   * the same context the built-in checks see and returns a result (or\n   * `null` to skip).\n   *\n   * The framework stays ORM- and stack-agnostic — Prisma-specific,\n   * Drizzle-specific, deploy-target-specific checks belong in adopter\n   * config (or in adapter packages that ship doctor extensions),\n   * never in core.\n   *\n   * @example\n   * ```ts\n   * import { existsSync } from 'node:fs'\n   * import { join } from 'node:path'\n   * import { defineConfig } from '@forinda/kickjs-cli'\n   *\n   * export default defineConfig({\n   *   doctor: {\n   *     checks: [\n   *       (ctx) => {\n   *         if (!existsSync(join(ctx.cwd, 'prisma/schema.prisma'))) return null\n   *         const generated = join(ctx.cwd, 'node_modules/@prisma/client/default.js')\n   *         return existsSync(generated)\n   *           ? { name: 'Prisma client generated', status: 'pass' }\n   *           : {\n   *               name: 'Prisma client generated',\n   *               status: 'fail',\n   *               fix: 'Run: pnpm exec prisma generate',\n   *             }\n   *       },\n   *     ],\n   *   },\n   * })\n   * ```\n   */\n  doctor?: import('./commands/doctor').DoctorExtension\n}\n\n/** Helper to define a type-safe kick.config.ts */\nexport function defineConfig(config: KickConfig): KickConfig {\n  return config\n}\n\n/** Resolve module config from `modules.*` block. */\n/**\n * Resolve the project's DI token scope for code generators.\n * Falls back through kick.config.ts → package.json → `'app'`.\n *\n * @param config Loaded `kick.config.ts` (null when not present)\n * @param cwd Project root — used to read package.json\n */\n/**\n * Whether this project actually depends on `@forinda/kickjs-swagger`.\n *\n * The REST generator decorates controllers with `@ApiTags`, which comes from\n * that package. Emitting it unconditionally put an import of a package the\n * project does not have into every generated controller — five decorators and\n * a broken build, in a file the adopter did not write.\n *\n * Reading package.json rather than resolving the module: a generator should\n * emit what the project DECLARES it uses. A transitively-present copy in\n * node_modules is not a dependency this code may import.\n */\nexport function hasDependency(\n  cwd: string,\n  name: string,\n  /**\n   * Where the dependency must be declared. Default `'runtime'`: generated\n   * code that *imports a value* — `@ApiTags` is a decorator, evaluated at\n   * boot — needs the package present in a production install, and\n   * `npm install --omit=dev` drops devDependencies. Pass `'any'` only for\n   * something used at build or test time.\n   */\n  scope: 'runtime' | 'any' = 'runtime',\n): boolean {\n  try {\n    const pkgPath = join(cwd, 'package.json')\n    if (!existsSync(pkgPath)) return false\n    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8')) as {\n      dependencies?: Record<string, string>\n      devDependencies?: Record<string, string>\n    }\n    if (pkg.dependencies?.[name]) return true\n    return scope === 'any' ? Boolean(pkg.devDependencies?.[name]) : false\n  } catch {\n    // An unreadable package.json means we cannot prove the dependency —\n    // and emitting an import we cannot justify is the failure being fixed.\n    return false\n  }\n}\n\n/**\n * Whether the project declares the swagger package `@ApiTags` comes from.\n *\n * Runtime scope: the decorator is evaluated when the controller class is\n * defined, so a devDependency-only install would emit controllers that import\n * a package a production install does not have.\n */\nexport function hasSwagger(cwd: string): boolean {\n  return hasDependency(cwd, '@forinda/kickjs-swagger', 'runtime')\n}\n\n/** Schema library a generated schema file is written against. */\nexport type SchemaLib = 'zod' | 'valibot' | 'yup'\n\n/**\n * Which validation library the project actually depends on, so generated\n * schema files import something that is installed.\n *\n * `kick new --schema valibot|yup` installs exactly one of these — the chosen\n * library and no other — so an emitted `import { z } from 'zod'` is a file that\n * cannot resolve. Read from package.json rather than `kick.config.ts` because\n * the dependency IS the fact; nothing has to be declared twice, and projects\n * scaffolded before this existed are covered without a config migration.\n *\n * Valibot and Yup are checked first: `kick new` installs one deliberately,\n * whereas `zod` is common enough to appear alongside it for unrelated reasons.\n * A project that genuinely needs to override the pick can gain a config field\n * when someone hits that; until then the dependency answers it.\n *\n * Runtime scope, same reasoning as {@link hasSwagger}: a DTO schema is\n * evaluated when the module loads, so a devDependency-only install would break\n * in production.\n */\nexport function resolveSchemaLib(cwd: string): SchemaLib {\n  if (hasDependency(cwd, 'valibot', 'runtime')) return 'valibot'\n  if (hasDependency(cwd, 'yup', 'runtime')) return 'yup'\n  return 'zod'\n}\n\nexport function resolveTokenScope(config: KickConfig | null, cwd: string): string {\n  if (config?.tokenScope && typeof config.tokenScope === 'string' && config.tokenScope.length > 0) {\n    const sanitised = sanitizeScope(config.tokenScope)\n    // Configured tokenScope can sanitise down to an empty string (e.g.\n    // '___' or '!!') — falling through to the package.json chain is\n    // safer than emitting an invalid `'/users/repository'` token.\n    if (sanitised.length > 0) return sanitised\n  }\n\n  // Read package.json synchronously — this runs once per generator\n  // invocation, so a sync read is cheaper than the async dance + lets\n  // the call sites (template builders) stay synchronous.\n  try {\n    const pkgPath = join(cwd, 'package.json')\n    if (existsSync(pkgPath)) {\n      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8')) as { name?: unknown }\n      if (typeof pkg.name === 'string' && pkg.name.length > 0) {\n        const scoped = pkg.name.match(/^@([^/]+)\\//)\n        const candidate = scoped ? sanitizeScope(scoped[1]) : sanitizeScope(pkg.name)\n        if (candidate.length > 0) return candidate\n        // Same empty-after-sanitize guard.\n      }\n    }\n  } catch {\n    // package.json missing or malformed — fall through to default\n  }\n\n  return 'app'\n}\n\n/** Lowercase + strip characters that would break a token literal. */\nfunction sanitizeScope(raw: string): string {\n  return raw\n    .toLowerCase()\n    .replace(/[^a-z0-9-]/g, '-') // collapse anything weird to a hyphen\n    .replace(/^-+|-+$/g, '') // trim leading/trailing hyphens\n    .replace(/-{2,}/g, '-') // collapse runs of hyphens\n}\n\n/** Module names are used as typed unless a project or a flag asks for plurals. */\nexport const PLURALIZE_DEFAULT = false\n\n/** `--pluralize` / `--no-pluralize`, else `modules.pluralize` in kick.config.ts, else `false`. */\nexport function resolvePluralize(flag: boolean | undefined, mc?: ModuleConfig): boolean {\n  return flag ?? mc?.pluralize ?? PLURALIZE_DEFAULT\n}\n\n/**\n * `--pluralize-routes` / `--no-pluralize-routes`, else `modules.pluralizeRoutes`,\n * else `true` — routes name a collection (`/tasks`) whatever the folder is called.\n */\nexport function resolvePluralizeRoutes(flag: boolean | undefined, mc?: ModuleConfig): boolean {\n  return flag ?? mc?.pluralizeRoutes ?? true\n}\n\nexport function resolveModuleConfig(config: KickConfig | null): ModuleConfig {\n  if (!config) return {}\n  const mc: ModuleConfig = {\n    dir: config.modules?.dir,\n    repo: config.modules?.repo,\n    schemaDir: config.modules?.schemaDir,\n    pluralize: config.modules?.pluralize,\n    pluralizeRoutes: config.modules?.pluralizeRoutes,\n    style: config.modules?.style,\n  }\n  // Validate `style` — silently coerce unknown values to the default.\n  // The CLI surface only documents 'define' and 'class'; anything else\n  // is a typo (e.g. 'defineModule') we'd rather see than silently\n  // emit class form.\n  if (mc.style !== undefined && mc.style !== 'define' && mc.style !== 'class') {\n    console.warn(\n      `  Warning: modules.style '${mc.style as string}' is not a valid value ` +\n        `(expected 'define' or 'class'). Falling back to 'define'.`,\n    )\n    mc.style = 'define'\n  }\n\n  // Warn if a string repo value isn't a known built-in. Deprecated ORM\n  // presets get their own note; any other bare string suggests the\n  // `{ name }` form to silence the stub-repo warning.\n  if (mc.repo && typeof mc.repo === 'string' && !BUILTIN_REPO_TYPES.includes(mc.repo)) {\n    if (!warnIfDeprecatedRepo(mc.repo)) {\n      console.warn(\n        `  Warning: modules.repo '${mc.repo}' is not a built-in type (${BUILTIN_REPO_TYPES.join(', ')}).` +\n          ` It will generate a stub repository. Use { name: '${mc.repo}' } to silence this warning.`,\n      )\n    }\n  }\n\n  return mc\n}\n\nconst CONFIG_FILES = ['kick.config.ts', 'kick.config.js', 'kick.config.mjs', 'kick.config.json']\n\n/**\n * Load `kick.config.*` starting from `startDir` and walking up toward\n * the filesystem root until a config file is found. Returns `null`\n * when no config exists anywhere on the way up.\n *\n * Walking up means adopters can run `kick <cmd>` from any subdirectory\n * (e.g. `src/modules/users/`) and still pick up the project's config —\n * before this change a nested-cwd invocation silently saw `null` and\n * fell back to framework defaults.\n *\n * TypeScript configs (`.ts`) are loaded via `jiti` when available;\n * `.js` / `.mjs` use native `import()`; `.json` uses `JSON.parse`. The\n * jiti import is dynamic + best-effort: if the dep is missing we\n * surface a warning telling the adopter how to install it, instead of\n * silently dropping the config (which is what the previous bare-catch\n * did).\n */\n/**\n * When the project can't resolve `@forinda/kickjs-cli` itself — a fresh\n * `kick new` before install, or a global `kick` in a project whose deps\n * aren't installed — map it to this CLI, so `import { defineConfig } from\n * '@forinda/kickjs-cli'` in kick.config.ts still loads. The config is read by\n * this CLI either way; an installed copy is left to normal resolution.\n */\nfunction selfAlias(root: string): Record<string, string> {\n  for (let dir = root; ; dir = dirname(dir)) {\n    if (existsSync(join(dir, 'node_modules', '@forinda', 'kickjs-cli', 'package.json'))) return {}\n    if (dirname(dir) === dir) break\n  }\n  // One level below the package root in source (src/) and in the bundle (dist/).\n  const pkgRoot = join(dirname(fileURLToPath(import.meta.url)), '..')\n  const entry = [join(pkgRoot, 'dist', 'index.mjs'), join(pkgRoot, 'src', 'index.ts')].find(\n    existsSync,\n  )\n  return entry ? { '@forinda/kickjs-cli': entry } : {}\n}\n\nexport async function loadKickConfig(startDir: string): Promise<KickConfig | null> {\n  const { findProjectRoot } = await import('./utils/project-root')\n  const root = findProjectRoot(startDir)\n\n  for (const filename of CONFIG_FILES) {\n    const filepath = join(root, filename)\n    try {\n      await access(filepath)\n    } catch {\n      continue\n    }\n\n    if (filename.endsWith('.json')) {\n      const content = await readFile(filepath, 'utf-8')\n      return JSON.parse(content)\n    }\n\n    const isTs = filename.endsWith('.ts')\n\n    if (isTs) {\n      // Split the import-jiti step from the load-user-config step so the\n      // diagnostic blames the right thing. Both surface as Node module-\n      // resolution errors with similar shapes (`Cannot find package …`,\n      // `ERR_MODULE_NOT_FOUND`), but the remedies differ:\n      //\n      // - Missing jiti  → adopter needs to install jiti.\n      // - Missing dep referenced from kick.config.ts → adopter needs to\n      //   install THAT package; telling them to install jiti would send\n      //   them to the wrong fix and bury the real missing module.\n      let jitiModule: typeof import('jiti')\n      try {\n        jitiModule = await import('jiti')\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : String(err)\n        if (msg.includes(\"Cannot find package 'jiti'\") || msg.includes('ERR_MODULE_NOT_FOUND')) {\n          console.warn(\n            `Warning: Failed to load ${filename} — 'jiti' is required for TypeScript configs. ` +\n              'Install jiti as a dev dependency, or rename the file ' +\n              'to kick.config.js / kick.config.mjs / kick.config.json.',\n          )\n        } else {\n          console.warn(`Warning: Failed to initialize jiti for ${filename}: ${msg}`)\n        }\n        continue\n      }\n\n      try {\n        const jiti = jitiModule.createJiti(root, {\n          interopDefault: true,\n          fsCache: false,\n          alias: selfAlias(root),\n          // The project's tsconfig `paths` (`@/*` → `src/*`), for what the\n          // config imports — eagerly or lazily, like a `db.adapter()` that\n          // loads `src/db/client.ts`, which imports `@/config`. Outside Vite\n          // nothing else resolves the alias.\n          tsconfigPaths: true,\n        })\n        const config = (await jiti.import(filepath, { default: true })) as KickConfig\n        const warnings = validateAssetMap(config, root)\n        for (const warning of warnings) console.warn(`  Warning: ${warning}`)\n        writeAssetConfigSnapshot(root, config)\n        return config\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : String(err)\n        console.warn(`Warning: Failed to load ${filename}: ${msg}`)\n        continue\n      }\n    }\n\n    try {\n      const { pathToFileURL } = await import('node:url')\n      const mod = await import(pathToFileURL(filepath).href)\n      const config = (mod.default ?? mod) as KickConfig\n      const warnings = validateAssetMap(config, root)\n      for (const warning of warnings) console.warn(`  Warning: ${warning}`)\n      writeAssetConfigSnapshot(root, config)\n      return config\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err)\n      console.warn(`Warning: Failed to load ${filename}: ${msg}`)\n      continue\n    }\n  }\n  return null\n}\n\n/**\n * Mirror the JSON-serialisable slice of a TS/JS `kick.config` that the\n * runtime asset resolver needs (`assetMap` + `build.outDir`) into\n * `.kickjs/kick.config.json`.\n *\n * Why: the runtime resolver in `@forinda/kickjs` reads its config\n * *synchronously* (it sits on the hot path of `assets.x.y()` /\n * `resolveAsset()`), so it can only parse `kick.config.{json,js,cjs}` —\n * it deliberately can't transpile `kick.config.ts`. For a `.ts`-config\n * project in dev (no built `dist/.kickjs-assets.json` yet), that left\n * the resolver with no config to synthesise a manifest from, so\n * `assets.x.y()` threw `UnknownAssetError` until the first build.\n *\n * The CLI already transpiles the `.ts` config here, so it drops this\n * tiny snapshot the runtime can read with a plain `JSON.parse`. Best\n * effort: any failure (read-only fs, etc.) is swallowed — a missing\n * snapshot just falls back to the previous behaviour.\n */\nexport function writeAssetConfigSnapshot(root: string, config: KickConfig | null): void {\n  // Only meaningful for asset-manager users — don't litter `.kickjs/`\n  // for projects that never declare an assetMap.\n  if (!config?.assetMap || Object.keys(config.assetMap).length === 0) return\n  try {\n    const dir = join(root, '.kickjs')\n    mkdirSync(dir, { recursive: true })\n    const snapshot = {\n      // Marker so a future shape change can be detected/migrated.\n      version: 1 as const,\n      assetMap: config.assetMap,\n      ...(config.build?.outDir ? { build: { outDir: config.build.outDir } } : {}),\n    }\n    writeFileSync(join(dir, 'kick.config.json'), JSON.stringify(snapshot, null, 2) + '\\n', 'utf-8')\n  } catch {\n    // Best effort — snapshot is an optimisation, not a correctness\n    // requirement. Production reads the real dist manifest.\n  }\n}\n\n/**\n * Validate `assetMap` entries on a loaded config. Returns a list of\n * human-readable warnings; the caller decides how to surface them\n * (typically `console.warn`). Never throws — `kick g` and other\n * unrelated commands should keep working even when the assetMap is\n * misconfigured.\n *\n * Checks:\n *\n * - Each entry's `src` is a non-empty string.\n * - The `src` directory exists on disk (otherwise the typegen + build\n *   steps will fail later with cryptic errors).\n * - `dest` doesn't escape the project root (defensive — a `dest:\n *   '../../etc'` typo could write files outside the workspace).\n * - The namespace key is a non-empty string and doesn't include a\n *   `/` (would conflict with the `<namespace>/<key>` manifest format).\n */\nexport function validateAssetMap(config: KickConfig | null, cwd: string): string[] {\n  const warnings: string[] = []\n  if (!config?.assetMap) return warnings\n\n  const root = resolve(cwd)\n  for (const [namespace, entry] of Object.entries(config.assetMap)) {\n    if (!namespace || namespace.includes('/')) {\n      warnings.push(\n        `assetMap key '${namespace}' is invalid — must be a non-empty string without '/'`,\n      )\n      continue\n    }\n    if (typeof entry?.src !== 'string' || entry.src.length === 0) {\n      warnings.push(`assetMap.${namespace} is missing a non-empty 'src' field`)\n      continue\n    }\n    const srcAbs = resolve(cwd, entry.src)\n    if (!existsSync(srcAbs)) {\n      warnings.push(\n        `assetMap.${namespace}.src ('${entry.src}') does not exist — typegen + build will fail`,\n      )\n    }\n    if (entry.dest) {\n      const destAbs = resolve(cwd, entry.dest)\n      // path.relative is the right primitive for \"is X inside Y?\" —\n      // a raw startsWith() prefix match has two failure modes the\n      // earlier version hit: (a) `/app` is a prefix of `/app2/...`\n      // even though they're different directories, and (b) it's\n      // case-sensitive on filesystems that aren't (macOS default,\n      // Windows). path.relative handles both correctly + accounts\n      // for `..` traversal in the destination.\n      if (escapesRoot(destAbs, root)) {\n        warnings.push(\n          `assetMap.${namespace}.dest ('${entry.dest}') resolves outside the project root — refusing to copy`,\n        )\n      }\n    }\n  }\n  return warnings\n}\n\n/**\n * Returns true when `path` (absolute) resolves outside of `root`\n * (also absolute). Uses `path.relative` for accuracy:\n *\n * - The result is empty when paths are identical (inside).\n * - It starts with `..` when the path traverses outside the root.\n * - It's absolute (Windows: cross-drive) when there's no relative\n *   path between them.\n *\n * Avoids the prefix-match pitfalls of `startsWith` (e.g. `/app`\n * matching `/app2/...`, or case-mismatches on macOS / Windows).\n */\nfunction escapesRoot(path: string, root: string): boolean {\n  const rel = relative(root, path)\n  return rel === '' ? false : rel.startsWith('..') || isAbsolute(rel)\n}\n"],"mappings":"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"}

package/dist/config-DhzyaY1S.mjs

@@ -0,0 +1,12 @@
+/**
+ * @forinda/kickjs-cli v8.11.0
+ *
+ * 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{t as e}from"./rolldown-runtime-DAPeToCs.mjs";import{existsSync as t,mkdirSync as n,readFileSync as r,writeFileSync as i}from"node:fs";import{dirname as a,isAbsolute as o,join as s,relative as c,resolve as l}from"node:path";import{fileURLToPath as u}from"node:url";import{access as d,readFile as f}from"node:fs/promises";var p=/* @__PURE__ */ e({BUILTIN_REPO_TYPES:()=>_,DEPRECATED_REPO_TYPES:()=>v,PACKAGE_MANAGERS:()=>m,PLURALIZE_DEFAULT:()=>!1,defineConfig:()=>b,execBin:()=>g,hasDependency:()=>x,hasSwagger:()=>S,loadKickConfig:()=>j,resolveModuleConfig:()=>O,resolvePluralize:()=>E,resolvePluralizeRoutes:()=>D,resolveSchemaLib:()=>C,resolveTokenScope:()=>w,runScript:()=>h,validateAssetMap:()=>N,warnIfDeprecatedRepo:()=>y,writeAssetConfigSnapshot:()=>M});const m=[`pnpm`,`npm`,`yarn`,`bun`];function h(e,t){return e===`npm`||e===`bun`?`${e} run ${t}`:`${e} ${t}`}function g(e,t){return{npm:`npx ${t}`,pnpm:`pnpm exec ${t}`,yarn:`yarn ${t}`,bun:`bunx ${t}`}[e]}const _=[`inmemory`],v=[`prisma`,`drizzle`];function y(e){return v.includes(e)?(console.warn(`  Note: '${e}' is no longer a built-in repository preset — a repository shaped to it is that library's interface, not KickJS's.\n  Scaffolding a generic custom-repository stub instead; wire it to ${e} yourself.`),!0):!1}function b(e){return e}function x(e,n,i=`runtime`){try{let a=s(e,`package.json`);if(!t(a))return!1;let o=JSON.parse(r(a,`utf-8`));return o.dependencies?.[n]?!0:i===`any`&&!!o.devDependencies?.[n]}catch{return!1}}function S(e){return x(e,`@forinda/kickjs-swagger`,`runtime`)}function C(e){return x(e,`valibot`,`runtime`)?`valibot`:x(e,`yup`,`runtime`)?`yup`:`zod`}function w(e,n){if(e?.tokenScope&&typeof e.tokenScope==`string`&&e.tokenScope.length>0){let t=T(e.tokenScope);if(t.length>0)return t}try{let e=s(n,`package.json`);if(t(e)){let t=JSON.parse(r(e,`utf-8`));if(typeof t.name==`string`&&t.name.length>0){let e=t.name.match(/^@([^/]+)\//),n=T(e?e[1]:t.name);if(n.length>0)return n}}}catch{}return`app`}function T(e){return e.toLowerCase().replace(/[^a-z0-9-]/g,`-`).replace(/^-+|-+$/g,``).replace(/-{2,}/g,`-`)}function E(e,t){return e??t?.pluralize??!1}function D(e,t){return e??t?.pluralizeRoutes??!0}function O(e){if(!e)return{};let t={dir:e.modules?.dir,repo:e.modules?.repo,schemaDir:e.modules?.schemaDir,pluralize:e.modules?.pluralize,pluralizeRoutes:e.modules?.pluralizeRoutes,style:e.modules?.style};return t.style!==void 0&&t.style!==`define`&&t.style!==`class`&&(console.warn(`  Warning: modules.style '${t.style}' is not a valid value (expected 'define' or 'class'). Falling back to 'define'.`),t.style=`define`),t.repo&&typeof t.repo==`string`&&!_.includes(t.repo)&&(y(t.repo)||console.warn(`  Warning: modules.repo '${t.repo}' is not a built-in type (${_.join(`, `)}). It will generate a stub repository. Use { name: '${t.repo}' } to silence this warning.`)),t}const k=[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`,`kick.config.json`];function A(e){for(let n=e;;n=a(n)){if(t(s(n,`node_modules`,`@forinda`,`kickjs-cli`,`package.json`)))return{};if(a(n)===n)break}let n=s(a(u(import.meta.url)),`..`),r=[s(n,`dist`,`index.mjs`),s(n,`src`,`index.ts`)].find(t);return r?{"@forinda/kickjs-cli":r}:{}}async function j(e){let{findProjectRoot:t}=await import(`./project-root-Da2aMneY.mjs`).then(e=>e.n),n=t(e);for(let e of k){let t=s(n,e);try{await d(t)}catch{continue}if(e.endsWith(`.json`)){let e=await f(t,`utf-8`);return JSON.parse(e)}if(e.endsWith(`.ts`)){let r;try{r=await import(`jiti`)}catch(t){let n=t instanceof Error?t.message:String(t);n.includes(`Cannot find package 'jiti'`)||n.includes(`ERR_MODULE_NOT_FOUND`)?console.warn(`Warning: Failed to load ${e} — 'jiti' is required for TypeScript configs. Install jiti as a dev dependency, or rename the file to kick.config.js / kick.config.mjs / kick.config.json.`):console.warn(`Warning: Failed to initialize jiti for ${e}: ${n}`);continue}try{let e=await r.createJiti(n,{interopDefault:!0,fsCache:!1,alias:A(n),tsconfigPaths:!0}).import(t,{default:!0}),i=N(e,n);for(let e of i)console.warn(`  Warning: ${e}`);return M(n,e),e}catch(t){let n=t instanceof Error?t.message:String(t);console.warn(`Warning: Failed to load ${e}: ${n}`);continue}}try{let{pathToFileURL:e}=await import(`node:url`),r=await import(e(t).href),i=r.default??r,a=N(i,n);for(let e of a)console.warn(`  Warning: ${e}`);return M(n,i),i}catch(t){let n=t instanceof Error?t.message:String(t);console.warn(`Warning: Failed to load ${e}: ${n}`);continue}}return null}function M(e,t){if(t?.assetMap&&Object.keys(t.assetMap).length!==0)try{let r=s(e,`.kickjs`);n(r,{recursive:!0});let a={version:1,assetMap:t.assetMap,...t.build?.outDir?{build:{outDir:t.build.outDir}}:{}};i(s(r,`kick.config.json`),JSON.stringify(a,null,2)+`
+`,`utf-8`)}catch{}}function N(e,n){let r=[];if(!e?.assetMap)return r;let i=l(n);for(let[a,o]of Object.entries(e.assetMap)){if(!a||a.includes(`/`)){r.push(`assetMap key '${a}' is invalid — must be a non-empty string without '/'`);continue}if(typeof o?.src!=`string`||o.src.length===0){r.push(`assetMap.${a} is missing a non-empty 'src' field`);continue}let e=l(n,o.src);t(e)||r.push(`assetMap.${a}.src ('${o.src}') does not exist — typegen + build will fail`),o.dest&&P(l(n,o.dest),i)&&r.push(`assetMap.${a}.dest ('${o.dest}') resolves outside the project root — refusing to copy`)}return r}function P(e,t){let n=c(t,e);return n===``?!1:n.startsWith(`..`)||o(n)}export{S as a,E as c,w as d,h as f,x as i,D as l,p as n,j as o,y as p,g as r,O as s,m as t,C as u};