@forinda/kickjs-cli 6.7.0 → 6.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{agent-docs-tlau7tZv.mjs → agent-docs-fKQUJYgz.mjs} +3 -3
- package/dist/{agent-docs-tlau7tZv.mjs.map → agent-docs-fKQUJYgz.mjs.map} +1 -1
- package/dist/{build-CDi72mKz.mjs → build-BDx9kJD_.mjs} +3 -3
- package/dist/{build-CDi72mKz.mjs.map → build-BDx9kJD_.mjs.map} +1 -1
- package/dist/{builtins-BiTg6p4D.mjs → builtins-5XvbxXOT.mjs} +2 -2
- package/dist/cli.mjs +153 -103
- package/dist/{config-D6C74vFp.mjs → config-13M-pdRz.mjs} +3 -3
- package/dist/{config-D6C74vFp.mjs.map → config-13M-pdRz.mjs.map} +1 -1
- package/dist/{doctor-BHnei8KS.mjs → doctor-ebixckGm.mjs} +28 -28
- package/dist/{doctor-BHnei8KS.mjs.map → doctor-ebixckGm.mjs.map} +1 -1
- package/dist/{fullstack-Cmedpn8G.mjs → fullstack-1pSNtZTQ.mjs} +4 -4
- package/dist/{fullstack-Cmedpn8G.mjs.map → fullstack-1pSNtZTQ.mjs.map} +1 -1
- package/dist/{fullstack-e-wuEMD0.mjs → fullstack-DkQrZR8Y.mjs} +1 -1
- package/dist/index.d.mts +45 -2
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +2 -3
- package/dist/plugin-CQ0NPO0o.mjs +13 -0
- package/dist/plugin-CQ0NPO0o.mjs.map +1 -0
- package/dist/{plugin-BlWy4Nbd.mjs → plugin-CYc-Ejd5.mjs} +3 -3
- package/dist/{plugin-BlWy4Nbd.mjs.map → plugin-CYc-Ejd5.mjs.map} +1 -1
- package/dist/{project-CnU7KcYI.mjs → project-BX9P1ntp.mjs} +5 -5
- package/dist/{project-CnU7KcYI.mjs.map → project-BX9P1ntp.mjs.map} +1 -1
- package/dist/{project-docs-BV-h5EmP.mjs → project-docs-ZT5I_aDa.mjs} +47 -11
- package/dist/project-docs-ZT5I_aDa.mjs.map +1 -0
- package/dist/{project-root-CdqXle6R.mjs → project-root-DYE4IdOm.mjs} +3 -3
- package/dist/{project-root-CdqXle6R.mjs.map → project-root-DYE4IdOm.mjs.map} +1 -1
- package/dist/{prompts-D7bKHNce.mjs → prompts-DWyN3rhd.mjs} +2 -2
- package/dist/{prompts-D7bKHNce.mjs.map → prompts-DWyN3rhd.mjs.map} +1 -1
- package/dist/{rolldown-runtime-DiP_G7eI.mjs → rolldown-runtime-BhiQ_pHx.mjs} +1 -1
- package/dist/{run-plugins-C5kGYAsD.mjs → run-plugins-EHBKYR0W.mjs} +55 -42
- package/dist/run-plugins-EHBKYR0W.mjs.map +1 -0
- package/dist/typegen-BFMgqlSf.mjs +114 -0
- package/dist/typegen-BFMgqlSf.mjs.map +1 -0
- package/dist/{types-BNOSmSFj.mjs → types-BCWqa1Q6.mjs} +1 -1
- package/package.json +3 -3
- package/dist/index.mjs.map +0 -1
- package/dist/project-docs-BV-h5EmP.mjs.map +0 -1
- package/dist/run-plugins-C5kGYAsD.mjs.map +0 -1
- package/dist/typegen-qeQ5co2C.mjs +0 -114
- package/dist/typegen-qeQ5co2C.mjs.map +0 -1
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs-cli v6.
|
|
2
|
+
* @forinda/kickjs-cli v6.8.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,10 +8,10 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{l as e}from"./project-docs-
|
|
11
|
+
import{l as e}from"./project-docs-ZT5I_aDa.mjs";import{n as t,t as n}from"./project-BX9P1ntp.mjs";import{join as r}from"node:path";import{execFileSync as i}from"node:child_process";async function a(a){let{name:_,directory:v,schemaLib:y=`zod`,runtime:b=`express`}=a,x=[`pnpm`,`npm`,`yarn`,`bun`].includes(a.packageManager),S=x?a.packageManager:`pnpm`,C=v,w=e=>console.log(` ${e}`);a.packageManager!==void 0&&!x&&w(`Warning: unknown package manager '${String(a.packageManager)}' — falling back to pnpm.`),console.log(`\n Creating fullstack KickJS workspace: ${_}\n`),await n({name:`${_}-server`,directory:r(C,`server`),packageManager:S,template:`minimal`,schemaLib:y,runtime:b,initGit:!1,installDeps:!1});let T=(await t())[`@forinda/kickjs-client`]??`^0.1.0`;await e(r(C,`web/package.json`),o(_,T)),await e(r(C,`web/vite.config.ts`),s()),await e(r(C,`web/tsconfig.json`),c()),await e(r(C,`web/index.html`),l(_)),await e(r(C,`web/src/main.tsx`),u()),await e(r(C,`web/src/App.tsx`),d()),await e(r(C,`web/src/api.ts`),f()),await e(r(C,`web/src/types/kick-routes.d.ts`),p()),await e(r(C,`package.json`),m(_,S)),await e(r(C,`pnpm-workspace.yaml`),`packages:
|
|
12
12
|
- server
|
|
13
13
|
- web
|
|
14
|
-
`),await e(r(C,`.gitignore`),h()),await e(r(C,`README.md`),g(_,S));let{generateAgentDocs:E}=await import(`./agent-docs-
|
|
14
|
+
`),await e(r(C,`.gitignore`),h()),await e(r(C,`README.md`),g(_,S));let{generateAgentDocs:E}=await import(`./agent-docs-fKQUJYgz.mjs`).then(e=>e.t);if(await E({outDir:C,name:_,pm:S,template:`fullstack`,only:`all`,force:!0}),a.installDeps){console.log(`\n Installing workspace dependencies with ${S}...\n`);try{i(S,[`install`],{cwd:C,stdio:`inherit`})}catch{console.log(`\n Warning: ${S} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-BFMgqlSf.mjs`).then(e=>e.n);await e({cwd:r(C,`server`),allowDuplicates:!0,silent:!0})}catch{}if(a.initGit)try{i(`git`,[`init`],{cwd:C,stdio:`pipe`}),i(`git`,[`branch`,`-M`,`main`],{cwd:C,stdio:`pipe`}),i(`git`,[`add`,`-A`],{cwd:C,stdio:`pipe`}),i(`git`,[`commit`,`-m`,`chore: initial commit from kick new (fullstack)`],{cwd:C,stdio:`pipe`}),w(`Git repository initialized`)}catch{w(`Warning: git init failed (git may not be installed)`)}console.log(`
|
|
15
15
|
Fullstack workspace scaffolded!`),console.log(),w(`Next steps:`),w(` cd ${_}`),a.installDeps||w(` ${S} install`),S===`pnpm`?w(` pnpm dev # runs server (kick dev) + web (vite) together`):(w(` ${S} run dev:server # terminal 1`),w(` ${S} run dev:web # terminal 2`)),w(``),w(`The web app calls the API through @forinda/kickjs-client —`),w(`edit server/src/modules/hello and watch web/src/App.tsx's types follow.`),w(``)}function o(e,t){return`${JSON.stringify({name:`${e}-web`,private:!0,version:`0.0.0`,type:`module`,scripts:{dev:`vite`,build:`tsc --noEmit && vite build`,preview:`vite preview`,typecheck:`tsc --noEmit`},dependencies:{"@forinda/kickjs-client":t,react:`^19.0.0`,"react-dom":`^19.0.0`},devDependencies:{"@types/react":`^19.0.0`,"@types/react-dom":`^19.0.0`,"@vitejs/plugin-react":`^5.0.0`,typescript:`^5.9.0`,vite:`^7.0.0`}},null,2)}\n`}function s(){return`import { defineConfig } from 'vite'
|
|
16
16
|
import react from '@vitejs/plugin-react'
|
|
17
17
|
|
|
@@ -135,4 +135,4 @@ stops compiling. That's the point.
|
|
|
135
135
|
|
|
136
136
|
Docs: https://kickjs.app/guide/typed-client.html
|
|
137
137
|
`}export{a as initFullstackProject};
|
|
138
|
-
//# sourceMappingURL=fullstack-
|
|
138
|
+
//# sourceMappingURL=fullstack-1pSNtZTQ.mjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fullstack-Cmedpn8G.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__routes.ts → web/src/types/kick-routes.d.ts\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 { initProject, resolveSiblingVersions } from './project'\n\nexport interface InitFullstackOptions {\n name: string\n directory: string\n packageManager?: 'pnpm' | 'npm' | 'yarn' | 'bun'\n initGit?: boolean\n installDeps?: boolean\n schemaLib?: 'zod' | 'valibot' | 'yup'\n runtime?: 'express' | 'fastify' | 'h3'\n}\n\nexport async function initFullstackProject(options: InitFullstackOptions): Promise<void> {\n const { name, directory, schemaLib = 'zod', runtime = 'express' } = 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 // ── server/ — the standard scaffold, deferred install/git ──────────\n await initProject({\n name: `${name}-server`,\n directory: join(dir, 'server'),\n packageManager,\n template: 'minimal',\n schemaLib,\n runtime,\n // Root owns install + git so the lockfile/commit cover the workspace.\n initGit: false,\n installDeps: false,\n })\n\n // ── web/ — Vite + React, typed client ──────────────────────────────\n const versions = await resolveSiblingVersions()\n const clientVersion = versions['@forinda/kickjs-client'] ?? '^0.1.0'\n\n await writeFileSafe(join(dir, 'web/package.json'), webPackageJson(name, clientVersion))\n await writeFileSafe(join(dir, 'web/vite.config.ts'), webViteConfig())\n await writeFileSafe(join(dir, 'web/tsconfig.json'), webTsConfig())\n await writeFileSafe(join(dir, 'web/index.html'), webIndexHtml(name))\n await writeFileSafe(join(dir, 'web/src/main.tsx'), webMain())\n await writeFileSafe(join(dir, 'web/src/App.tsx'), webApp())\n await writeFileSafe(join(dir, 'web/src/api.ts'), webApi())\n await writeFileSafe(join(dir, 'web/src/types/kick-routes.d.ts'), webRouteTypes())\n\n // ── workspace root ──────────────────────────────────────────────────\n await writeFileSafe(join(dir, 'package.json'), rootPackageJson(name, packageManager))\n await writeFileSafe(join(dir, 'pnpm-workspace.yaml'), `packages:\\n - server\\n - web\\n`)\n await writeFileSafe(join(dir, '.gitignore'), rootGitignore())\n await writeFileSafe(join(dir, 'README.md'), rootReadme(name, packageManager))\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 execFileSync(packageManager, ['install'], { cwd: dir, stdio: 'inherit' })\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 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 log('')\n}\n\n// ── web templates ─────────────────────────────────────────────────────\n\nfunction webPackageJson(name: string, clientVersion: string): string {\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': clientVersion,\n react: '^19.0.0',\n 'react-dom': '^19.0.0',\n },\n devDependencies: {\n '@types/react': '^19.0.0',\n '@types/react-dom': '^19.0.0',\n '@vitejs/plugin-react': '^5.0.0',\n typescript: '^5.9.0',\n vite: '^7.0.0',\n },\n },\n null,\n 2,\n )}\\n`\n}\n\nfunction webViteConfig(): string {\n return `import { defineConfig } from 'vite'\nimport react from '@vitejs/plugin-react'\n\nexport default defineConfig({\n plugins: [react()],\n server: {\n // The KickJS server (kick dev) listens on 3000; the client's baseUrl is\n // the relative '/api/v1', so the browser hits Vite and Vite forwards.\n proxy: {\n '/api': 'http://localhost:3000',\n },\n },\n})\n`\n}\n\nfunction webTsConfig(): string {\n return `${JSON.stringify(\n {\n compilerOptions: {\n target: 'ES2022',\n lib: ['ES2022', 'DOM', 'DOM.Iterable'],\n module: 'ESNext',\n moduleResolution: 'bundler',\n jsx: 'react-jsx',\n strict: true,\n skipLibCheck: true,\n noEmit: true,\n isolatedModules: true,\n // The type bridge pulls server controller sources into this\n // program — they use legacy TS decorators.\n experimentalDecorators: true,\n // The KickRoutes ambient types come from the server's generated\n // typegen output via src/types/kick-routes.d.ts.\n types: [],\n },\n include: ['src'],\n },\n null,\n 2,\n )}\\n`\n}\n\nfunction webIndexHtml(name: string): string {\n return `<!doctype html>\n<html lang=\"en\">\n <head>\n <meta charset=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>${name}</title>\n </head>\n <body>\n <div id=\"root\"></div>\n <script type=\"module\" src=\"/src/main.tsx\"></script>\n </body>\n</html>\n`\n}\n\nfunction webMain(): string {\n return `import { StrictMode } from 'react'\nimport { createRoot } from 'react-dom/client'\nimport { App } from './App'\n\ncreateRoot(document.getElementById('root')!).render(\n <StrictMode>\n <App />\n </StrictMode>,\n)\n`\n}\n\nfunction webApp(): string {\n return `import { useEffect, useState } from 'react'\nimport { api } from './api'\n\n// The response types below are INFERRED from the server's handlers —\n// change server/src/modules/hello/hello.service.ts and these types follow\n// on the next \\`kick typegen\\` (automatic under \\`kick dev\\`).\ntype Greeting = Awaited<ReturnType<typeof fetchGreeting>>\n\nfunction fetchGreeting() {\n return api.get('/hello')\n}\n\nexport function App() {\n const [greeting, setGreeting] = useState<Greeting | null>(null)\n const [health, setHealth] = useState<string>('checking…')\n\n useEffect(() => {\n fetchGreeting().then(setGreeting).catch(console.error)\n api\n .get('/hello/health')\n .then((h) => setHealth(h.status))\n .catch(() => setHealth('down'))\n }, [])\n\n return (\n <main style={{ fontFamily: 'system-ui', maxWidth: 640, margin: '4rem auto', padding: '0 1rem' }}>\n <h1>KickJS fullstack</h1>\n <p>\n <strong>{greeting?.message ?? 'loading…'}</strong>\n </p>\n <p>\n Server said hello at <code>{greeting?.timestamp ?? '…'}</code> — health:{' '}\n <code>{health}</code>\n </p>\n <p style={{ color: '#666' }}>\n This call is typed end to end: <code>api.get('/hello')</code> returns the exact shape\n <code> HelloService.greet()</code> produces. Rename a field on the server and this file\n stops compiling.\n </p>\n </main>\n )\n}\n`\n}\n\nfunction webApi(): string {\n return `import { createClient } from '@forinda/kickjs-client'\n\n// KickApi (alias of KickRoutes.Api) is ambient — populated by server/.kickjs/types (see\n// src/types/kick-routes.d.ts). Keys are module-mount-relative paths;\n// the bootstrap-level '/api/v1' prefix lives here in baseUrl, and the\n// Vite dev proxy forwards it to the KickJS server.\nexport const api = createClient<KickApi>({ baseUrl: '/api/v1' })\n`\n}\n\nfunction webRouteTypes(): string {\n return `// Type-only bridge to the server's generated route types. The import is\n// erased at build time — no server code ever enters the web bundle.\n// Regenerate with \\`kick typegen\\` in server/ (automatic under \\`kick dev\\`).\nimport '../../../server/.kickjs/types/kick__routes'\n`\n}\n\n// ── root templates ────────────────────────────────────────────────────\n\nfunction rootPackageJson(name: string, pm: string): string {\n const scripts: Record<string, string> =\n pm === 'pnpm'\n ? {\n dev: 'pnpm --parallel -r run dev',\n 'dev:server': 'pnpm --filter ./server dev',\n 'dev:web': 'pnpm --filter ./web dev',\n build: 'pnpm -r run build',\n typecheck: 'pnpm -r run typecheck',\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 'dev:server': `cd server && ${pm} run dev`,\n 'dev:web': `cd web && ${pm} run dev`,\n build: `${pm} run build:server && ${pm} run build:web`,\n 'build:server': `cd server && ${pm} run build`,\n 'build:web': `cd web && ${pm} run build`,\n typecheck: `cd web && ${pm} run typecheck`,\n }\n return `${JSON.stringify(\n {\n name,\n private: true,\n version: '0.0.0',\n type: 'module',\n scripts,\n workspaces: ['server', 'web'],\n },\n null,\n 2,\n )}\\n`\n}\n\nfunction rootGitignore(): string {\n return `node_modules/\ndist/\n.env\n*.log\n.DS_Store\n`\n}\n\nfunction rootReadme(name: string, pm: string): string {\n return `# ${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\\` (auto under \\`kick dev\\`) emits \\`server/.kickjs/types/kick__routes.ts\\` —\n including the flat \\`KickRoutes.Api\\` map with inferred response types.\n3. \\`web/src/types/kick-routes.d.ts\\` imports that file type-only.\n4. \\`web/src/api.ts\\`'s \\`createClient<KickRoutes.Api>\\` types every call site.\n\nRename a field in \\`server/src/modules/hello/hello.service.ts\\` → \\`web/src/App.tsx\\`\nstops compiling. That's the point.\n\nDocs: https://kickjs.app/guide/typed-client.html\n`\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"fullstack-1pSNtZTQ.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__routes.ts → web/src/types/kick-routes.d.ts\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 { initProject, resolveSiblingVersions } from './project'\n\nexport interface InitFullstackOptions {\n name: string\n directory: string\n packageManager?: 'pnpm' | 'npm' | 'yarn' | 'bun'\n initGit?: boolean\n installDeps?: boolean\n schemaLib?: 'zod' | 'valibot' | 'yup'\n runtime?: 'express' | 'fastify' | 'h3'\n}\n\nexport async function initFullstackProject(options: InitFullstackOptions): Promise<void> {\n const { name, directory, schemaLib = 'zod', runtime = 'express' } = 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 // ── server/ — the standard scaffold, deferred install/git ──────────\n await initProject({\n name: `${name}-server`,\n directory: join(dir, 'server'),\n packageManager,\n template: 'minimal',\n schemaLib,\n runtime,\n // Root owns install + git so the lockfile/commit cover the workspace.\n initGit: false,\n installDeps: false,\n })\n\n // ── web/ — Vite + React, typed client ──────────────────────────────\n const versions = await resolveSiblingVersions()\n const clientVersion = versions['@forinda/kickjs-client'] ?? '^0.1.0'\n\n await writeFileSafe(join(dir, 'web/package.json'), webPackageJson(name, clientVersion))\n await writeFileSafe(join(dir, 'web/vite.config.ts'), webViteConfig())\n await writeFileSafe(join(dir, 'web/tsconfig.json'), webTsConfig())\n await writeFileSafe(join(dir, 'web/index.html'), webIndexHtml(name))\n await writeFileSafe(join(dir, 'web/src/main.tsx'), webMain())\n await writeFileSafe(join(dir, 'web/src/App.tsx'), webApp())\n await writeFileSafe(join(dir, 'web/src/api.ts'), webApi())\n await writeFileSafe(join(dir, 'web/src/types/kick-routes.d.ts'), webRouteTypes())\n\n // ── workspace root ──────────────────────────────────────────────────\n await writeFileSafe(join(dir, 'package.json'), rootPackageJson(name, packageManager))\n await writeFileSafe(join(dir, 'pnpm-workspace.yaml'), `packages:\\n - server\\n - web\\n`)\n await writeFileSafe(join(dir, '.gitignore'), rootGitignore())\n await writeFileSafe(join(dir, 'README.md'), rootReadme(name, packageManager))\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 execFileSync(packageManager, ['install'], { cwd: dir, stdio: 'inherit' })\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 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 log('')\n}\n\n// ── web templates ─────────────────────────────────────────────────────\n\nfunction webPackageJson(name: string, clientVersion: string): string {\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': clientVersion,\n react: '^19.0.0',\n 'react-dom': '^19.0.0',\n },\n devDependencies: {\n '@types/react': '^19.0.0',\n '@types/react-dom': '^19.0.0',\n '@vitejs/plugin-react': '^5.0.0',\n typescript: '^5.9.0',\n vite: '^7.0.0',\n },\n },\n null,\n 2,\n )}\\n`\n}\n\nfunction webViteConfig(): string {\n return `import { defineConfig } from 'vite'\nimport react from '@vitejs/plugin-react'\n\nexport default defineConfig({\n plugins: [react()],\n server: {\n // The KickJS server (kick dev) listens on 3000; the client's baseUrl is\n // the relative '/api/v1', so the browser hits Vite and Vite forwards.\n proxy: {\n '/api': 'http://localhost:3000',\n },\n },\n})\n`\n}\n\nfunction webTsConfig(): string {\n return `${JSON.stringify(\n {\n compilerOptions: {\n target: 'ES2022',\n lib: ['ES2022', 'DOM', 'DOM.Iterable'],\n module: 'ESNext',\n moduleResolution: 'bundler',\n jsx: 'react-jsx',\n strict: true,\n skipLibCheck: true,\n noEmit: true,\n isolatedModules: true,\n // The type bridge pulls server controller sources into this\n // program — they use legacy TS decorators.\n experimentalDecorators: true,\n // The KickRoutes ambient types come from the server's generated\n // typegen output via src/types/kick-routes.d.ts.\n types: [],\n },\n include: ['src'],\n },\n null,\n 2,\n )}\\n`\n}\n\nfunction webIndexHtml(name: string): string {\n return `<!doctype html>\n<html lang=\"en\">\n <head>\n <meta charset=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>${name}</title>\n </head>\n <body>\n <div id=\"root\"></div>\n <script type=\"module\" src=\"/src/main.tsx\"></script>\n </body>\n</html>\n`\n}\n\nfunction webMain(): string {\n return `import { StrictMode } from 'react'\nimport { createRoot } from 'react-dom/client'\nimport { App } from './App'\n\ncreateRoot(document.getElementById('root')!).render(\n <StrictMode>\n <App />\n </StrictMode>,\n)\n`\n}\n\nfunction webApp(): string {\n return `import { useEffect, useState } from 'react'\nimport { api } from './api'\n\n// The response types below are INFERRED from the server's handlers —\n// change server/src/modules/hello/hello.service.ts and these types follow\n// on the next \\`kick typegen\\` (automatic under \\`kick dev\\`).\ntype Greeting = Awaited<ReturnType<typeof fetchGreeting>>\n\nfunction fetchGreeting() {\n return api.get('/hello')\n}\n\nexport function App() {\n const [greeting, setGreeting] = useState<Greeting | null>(null)\n const [health, setHealth] = useState<string>('checking…')\n\n useEffect(() => {\n fetchGreeting().then(setGreeting).catch(console.error)\n api\n .get('/hello/health')\n .then((h) => setHealth(h.status))\n .catch(() => setHealth('down'))\n }, [])\n\n return (\n <main style={{ fontFamily: 'system-ui', maxWidth: 640, margin: '4rem auto', padding: '0 1rem' }}>\n <h1>KickJS fullstack</h1>\n <p>\n <strong>{greeting?.message ?? 'loading…'}</strong>\n </p>\n <p>\n Server said hello at <code>{greeting?.timestamp ?? '…'}</code> — health:{' '}\n <code>{health}</code>\n </p>\n <p style={{ color: '#666' }}>\n This call is typed end to end: <code>api.get('/hello')</code> returns the exact shape\n <code> HelloService.greet()</code> produces. Rename a field on the server and this file\n stops compiling.\n </p>\n </main>\n )\n}\n`\n}\n\nfunction webApi(): string {\n return `import { createClient } from '@forinda/kickjs-client'\n\n// KickApi (alias of KickRoutes.Api) is ambient — populated by server/.kickjs/types (see\n// src/types/kick-routes.d.ts). Keys are module-mount-relative paths;\n// the bootstrap-level '/api/v1' prefix lives here in baseUrl, and the\n// Vite dev proxy forwards it to the KickJS server.\nexport const api = createClient<KickApi>({ baseUrl: '/api/v1' })\n`\n}\n\nfunction webRouteTypes(): string {\n return `// Type-only bridge to the server's generated route types. The import is\n// erased at build time — no server code ever enters the web bundle.\n// Regenerate with \\`kick typegen\\` in server/ (automatic under \\`kick dev\\`).\nimport '../../../server/.kickjs/types/kick__routes'\n`\n}\n\n// ── root templates ────────────────────────────────────────────────────\n\nfunction rootPackageJson(name: string, pm: string): string {\n const scripts: Record<string, string> =\n pm === 'pnpm'\n ? {\n dev: 'pnpm --parallel -r run dev',\n 'dev:server': 'pnpm --filter ./server dev',\n 'dev:web': 'pnpm --filter ./web dev',\n build: 'pnpm -r run build',\n typecheck: 'pnpm -r run typecheck',\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 'dev:server': `cd server && ${pm} run dev`,\n 'dev:web': `cd web && ${pm} run dev`,\n build: `${pm} run build:server && ${pm} run build:web`,\n 'build:server': `cd server && ${pm} run build`,\n 'build:web': `cd web && ${pm} run build`,\n typecheck: `cd web && ${pm} run typecheck`,\n }\n return `${JSON.stringify(\n {\n name,\n private: true,\n version: '0.0.0',\n type: 'module',\n scripts,\n workspaces: ['server', 'web'],\n },\n null,\n 2,\n )}\\n`\n}\n\nfunction rootGitignore(): string {\n return `node_modules/\ndist/\n.env\n*.log\n.DS_Store\n`\n}\n\nfunction rootReadme(name: string, pm: string): string {\n return `# ${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\\` (auto under \\`kick dev\\`) emits \\`server/.kickjs/types/kick__routes.ts\\` —\n including the flat \\`KickRoutes.Api\\` map with inferred response types.\n3. \\`web/src/types/kick-routes.d.ts\\` imports that file type-only.\n4. \\`web/src/api.ts\\`'s \\`createClient<KickRoutes.Api>\\` types every call site.\n\nRename a field in \\`server/src/modules/hello/hello.service.ts\\` → \\`web/src/App.tsx\\`\nstops compiling. That's the point.\n\nDocs: https://kickjs.app/guide/typed-client.html\n`\n}\n"],"mappings":"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"}
|
package/dist/index.d.mts
CHANGED
|
@@ -23,7 +23,13 @@ type AppRuntime = 'express' | 'fastify' | 'h3';
|
|
|
23
23
|
interface DoctorContext {
|
|
24
24
|
cwd: string;
|
|
25
25
|
pkg: any | null;
|
|
26
|
-
|
|
26
|
+
/**
|
|
27
|
+
* The project's tsconfig with its full `extends` chain already merged
|
|
28
|
+
* into `compilerOptions`. `undefined` = no tsconfig.json; `null` = one
|
|
29
|
+
* exists but couldn't be parsed. Checks should distinguish the two —
|
|
30
|
+
* they call for different advice.
|
|
31
|
+
*/
|
|
32
|
+
tsconfig: any | null | undefined;
|
|
27
33
|
/**
|
|
28
34
|
* The project's HTTP runtime — from kick.config `runtime`, else sniffed from
|
|
29
35
|
* deps, else `express`. Lets engine-aware checks (engine peers, the upload
|
|
@@ -892,6 +898,31 @@ interface DiscoveredRoute {
|
|
|
892
898
|
* against real URLs. Optional for old fixtures; falls back to `path`.
|
|
893
899
|
*/
|
|
894
900
|
mountedPath?: string;
|
|
901
|
+
/**
|
|
902
|
+
* Every decorator applied to this route's method or its controller
|
|
903
|
+
* class, minus the HTTP verb decorators. Unclassified on purpose — the
|
|
904
|
+
* join phase decides which are context contributors, which are known
|
|
905
|
+
* framework decorators, and which are unrecognised (and therefore make
|
|
906
|
+
* the route's key set unprovable).
|
|
907
|
+
*/
|
|
908
|
+
appliedDecorators?: DecoratorRef[];
|
|
909
|
+
/**
|
|
910
|
+
* Union of context keys proven populated for this route, or `null` when
|
|
911
|
+
* completeness could not be established. `null` is emitted as `string`
|
|
912
|
+
* (no narrowing) — never as an empty union, which would wrongly reject
|
|
913
|
+
* every `ctx.require()` call on the route.
|
|
914
|
+
*/
|
|
915
|
+
contextKeys?: string[] | null;
|
|
916
|
+
}
|
|
917
|
+
/** A decorator as written at a call site, with its import resolved. */
|
|
918
|
+
interface DecoratorRef {
|
|
919
|
+
/** The decorator's local binding name, e.g. `LoadTenant`. */
|
|
920
|
+
identifier: string;
|
|
921
|
+
/**
|
|
922
|
+
* Module specifier it was imported from; `''` when declared in the same
|
|
923
|
+
* file, `null` when the binding could not be resolved at all.
|
|
924
|
+
*/
|
|
925
|
+
source: string | null;
|
|
895
926
|
}
|
|
896
927
|
/** A statically-resolved schema identifier reference */
|
|
897
928
|
interface SchemaRef {
|
|
@@ -973,6 +1004,18 @@ interface DiscoveredPluginOrAdapter {
|
|
|
973
1004
|
interface DiscoveredContextKey {
|
|
974
1005
|
/** The literal `key:` value the contributor writes. */
|
|
975
1006
|
key: string;
|
|
1007
|
+
/**
|
|
1008
|
+
* The binding the decorator was assigned to — `LoadTenant` for
|
|
1009
|
+
* `export const LoadTenant = defineHttpContextDecorator({ key: 'tenant' })`.
|
|
1010
|
+
*
|
|
1011
|
+
* `null` when the call isn't a simple `const X = …` initialiser (inline
|
|
1012
|
+
* in an array, returned from a factory, …). Needed to map an applied
|
|
1013
|
+
* `@LoadTenant` decorator back to the key it populates, which is what
|
|
1014
|
+
* lets per-route context-key narrowing work at all; a `null` binding
|
|
1015
|
+
* simply can't be resolved from a decorator site, so routes using it
|
|
1016
|
+
* degrade to unnarrowed rather than guessing.
|
|
1017
|
+
*/
|
|
1018
|
+
exportName: string | null;
|
|
976
1019
|
/** Absolute file path. */
|
|
977
1020
|
filePath: string;
|
|
978
1021
|
/** Path relative to scan root, with forward slashes. */
|
|
@@ -1132,7 +1175,7 @@ interface TypegenPlugin {
|
|
|
1132
1175
|
}
|
|
1133
1176
|
interface TypegenPluginResult {
|
|
1134
1177
|
id: string;
|
|
1135
|
-
status: 'written' | 'unchanged' | 'skipped' | 'error';
|
|
1178
|
+
status: 'written' | 'unchanged' | 'skipped' | 'error' | 'drifted';
|
|
1136
1179
|
outFile?: string;
|
|
1137
1180
|
}
|
|
1138
1181
|
/**
|
package/dist/index.d.mts.map
CHANGED
|
@@ -1 +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":";;;KA4OY,UAAA;;;;;AAAZ;;;;AAAsB;;;;ACjNtB;;;;;;UAAiB,aAAA;EACf,GAAA;EACA,GAAA;
|
|
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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"}
|
package/dist/index.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs-cli v6.
|
|
2
|
+
* @forinda/kickjs-cli v6.8.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,5 +8,4 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{M as e,N as t,c as n,d as r,f as i,g as a,j as o,k as s,l as c,m as l,n as u,o as d,p as f,s as p,t as m,u as h,y as g}from"./doctor-
|
|
12
|
-
//# sourceMappingURL=index.mjs.map
|
|
11
|
+
import{M as e,N as t,c as n,d as r,f as i,g as a,j as o,k as s,l as c,m as l,n as u,o as d,p as f,s as p,t as m,u as h,y as g}from"./doctor-ebixckGm.mjs";import{t as _}from"./project-BX9P1ntp.mjs";import{i as v,r as y}from"./config-13M-pdRz.mjs";import{t as b}from"./project-root-DYE4IdOm.mjs";import{n as x,t as S}from"./types-BCWqa1Q6.mjs";import{n as C}from"./plugin-CQ0NPO0o.mjs";export{S as KickPluginConflictError,n as TYPEGEN_OWNER_KEY,d as buildGeneratorContext,c as createTypegenDevWatcher,x as defineCliPlugin,y as defineConfig,m as defineDoctorCheck,u as defineDoctorExtension,p as defineGenerator,C as defineTypegen,b as findProjectRoot,a as generateAdapter,r as generateController,h as generateDto,f as generateGuard,l as generateMiddleware,g as generateModule,i as generateService,_ as initProject,v as loadKickConfig,s as pluralize,o as toCamelCase,e as toKebabCase,t as toPascalCase};
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @forinda/kickjs-cli v6.8.0
|
|
3
|
+
*
|
|
4
|
+
* Copyright (c) Felix Orinda
|
|
5
|
+
*
|
|
6
|
+
* This source code is licensed under the MIT license found in the
|
|
7
|
+
* LICENSE file in the root directory of this source tree.
|
|
8
|
+
*
|
|
9
|
+
* @license MIT
|
|
10
|
+
*/
|
|
11
|
+
var e=class extends Error{drifted;constructor(e){let t=e.map(e=>` ${e.id} → ${e.outFile}`).join(`
|
|
12
|
+
`);super(`kick typegen --check: ${e.length} generated file(s) are out of date:\n${t}\n Run \`kick typegen\` and commit the result.`),this.name=`TypegenDriftError`,this.drifted=e}};function t(e){return e}export{t as n,e as t};
|
|
13
|
+
//# sourceMappingURL=plugin-CQ0NPO0o.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"plugin-CQ0NPO0o.mjs","names":[],"sources":["../src/typegen/plugin.ts"],"sourcesContent":["// TypegenPlugin contract — M2.B-T7.\n//\n// Each plugin owns a single `.kickjs/types/<id>.d.ts` file. The runner\n// invokes `generate(ctx)` per plugin, prepends a banner, writes only on\n// content change, and surfaces drift in --check mode (CI gate).\n//\n// Built-in plugins (kick/routes, kick/env, kick/assets, kick/db) live under\n// `./builtin`. Adopters register additional plugins via kick.config.ts.\n\nimport type { KickConfig } from '../config'\nimport type { ScanOptions, ScanResult } from './scanner'\n\nexport interface TypegenLogger {\n info(msg: string): void\n warn(msg: string): void\n error(msg: string): void\n}\n\nexport interface TypegenContext {\n cwd: string\n config: KickConfig\n /** Dynamic-import a TS module (Node loader). Used by plugins that need to\n * read the adopter's schema / route map / asset registry at generate time. */\n importTs<T = unknown>(absPath: string): Promise<T>\n /** Write under `cwd`. Caller passes a relPath (e.g. `.kickjs/types/foo.d.ts`). */\n writeFile(relPath: string, contents: string): Promise<void>\n /**\n * Run `scanProject` once per typegen pass, memoizing the result so\n * multiple plugins (`kick/routes`, `kick/env`, future adopter plugins)\n * share a single fs walk + AST extraction.\n *\n * The runner uses an order-independent cache key derived from the\n * resolved options (`root`, `cwd`, `extensions`, `exclude`, `envFile`)\n * — semantically equal options hit the cache regardless of how the\n * caller built the literal. (We deliberately don't `JSON.stringify`\n * the options for caching since that would be sensitive to property\n * insertion order.) Plugins that don't need scanner data can ignore\n * this method entirely.\n *\n * Implementation lives in the runner so test harnesses can inject\n * a stub scanner; plugins only see the function.\n */\n getScanResult(opts: ScanOptions): Promise<ScanResult>\n log: TypegenLogger\n}\n\nexport interface TypegenPlugin {\n /** Stable id — used as filename: `.kickjs/types/${id}<outExtension>` (slashes → `__`). */\n id: string\n /** Glob patterns the Vite watcher subscribes to; change → re-run this plugin. */\n inputs: string[]\n /**\n * Output filename extension. Default `.d.ts` — the right choice for\n * pure module-augmentation plugins (kick/db, kick/assets) since\n * declaration files don't need the runtime-import dance.\n *\n * `kick/routes` overrides to `.ts` because it emits hoisted\n * `import type {...} from '...'` lines at the top of the file. Inline\n * `import('...').X` references inside `.d.ts` silently degrade to\n * `unknown` under `moduleResolution: 'bundler'`; emitting `.ts`\n * sidesteps that quirk and gets full type resolution.\n *\n * Adopter-supplied plugins should leave this unset unless they hit\n * the same hoisted-import constraint.\n */\n outExtension?: string\n /**\n * Return the augmentation source (without banner — runner prepends).\n * Return null to skip emission (e.g. no schema file present).\n */\n generate(ctx: TypegenContext): Promise<string | null>\n}\n\nexport interface TypegenPluginResult {\n id: string\n status: 'written' | 'unchanged' | 'skipped' | 'error' | 'drifted'\n outFile?: string\n}\n\n/**\n * Thrown by the runner under `--check` when a plugin's generated output\n * differs from what's on disk. Carries every drifted plugin, not just\n * the first, so one CI run reports the full list.\n *\n * This has its own class for a load-bearing reason: `runAllPluginTypegens`\n * wraps the pass in a catch that downgrades plugin failures to a warning\n * so a transiently-broken plugin can't crash the `kick dev` loop. That\n * catch used to swallow this error too, which made `--check` exit 0 on\n * *every* drift — the gate silently passed while printing \"skipped\".\n * The catch now rethrows this type. Do not make it a plain `Error`.\n */\nexport class TypegenDriftError extends Error {\n /** Plugin ids whose output drifted, in run order. */\n readonly drifted: readonly { id: string; outFile: string }[]\n\n constructor(drifted: readonly { id: string; outFile: string }[]) {\n const list = drifted.map((d) => ` ${d.id} → ${d.outFile}`).join('\\n')\n super(\n `kick typegen --check: ${drifted.length} generated file(s) are out of date:\\n${list}\\n` +\n ` Run \\`kick typegen\\` and commit the result.`,\n )\n this.name = 'TypegenDriftError'\n this.drifted = drifted\n }\n}\n\n/**\n * Identity factory for {@link TypegenPlugin}. Returns the spec verbatim.\n * Exists for type inference and forward-compatibility — future\n * fields can be added with defaults without breaking adopters.\n *\n * Mirrors {@link defineGenerator} ergonomics. Use at the call site so\n * the plugin's `generate(ctx)` body gets a fully-typed `ctx` without\n * an explicit annotation:\n *\n * @example\n * ```ts\n * import { defineTypegen } from '@forinda/kickjs-cli'\n *\n * export const drizzleTypegen = defineTypegen({\n * id: 'drizzle',\n * inputs: ['src/db/schema.ts'],\n * async generate(ctx) {\n * const schema = await ctx.importTs(`${ctx.cwd}/src/db/schema.ts`)\n * return `// declare module …`\n * },\n * })\n * ```\n */\nexport function defineTypegen(spec: TypegenPlugin): TypegenPlugin {\n return spec\n}\n"],"mappings":";;;;;;;;;;AA2FA,IAAa,EAAb,cAAuC,KAAM,CAE3C,QAEA,YAAY,EAAqD,CAC/D,IAAM,EAAO,EAAQ,IAAK,GAAM,OAAO,EAAE,GAAG,KAAK,EAAE,SAAS,CAAC,CAAC,KAAK;CAAI,EACvE,MACE,yBAAyB,EAAQ,OAAO,uCAAuC,EAAK,gDAEtF,EACA,KAAK,KAAO,oBACZ,KAAK,QAAU,CACjB,CACF,EAyBA,SAAgB,EAAc,EAAoC,CAChE,OAAO,CACT"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs-cli v6.
|
|
2
|
+
* @forinda/kickjs-cli v6.8.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,5 +8,5 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{t as e}from"./rolldown-runtime-
|
|
12
|
-
//# sourceMappingURL=plugin-
|
|
11
|
+
import{t as e}from"./rolldown-runtime-BhiQ_pHx.mjs";import{t}from"./types-BCWqa1Q6.mjs";function n(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-DYE4IdOm.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 r=e({mergeCliPlugins:()=>n});export{n,r as t};
|
|
12
|
+
//# sourceMappingURL=plugin-CYc-Ejd5.mjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"plugin-
|
|
1
|
+
{"version":3,"file":"plugin-CYc-Ejd5.mjs","names":[],"sources":["../src/plugin/merge.ts","../src/plugin/index.ts"],"sourcesContent":["// Plugin → unified registry merge.\n//\n// Resolution rules (per the v1 spec + dogfood pivot):\n// - duplicate plugin `name` across the input array → conflict error.\n// Catches the double-install case (built-in shipped twice, or\n// adopter requiring the same plugin twice).\n// - plugin commands appear first in the merged list, then adopter\n// commands; adopter `commands` of the same name override the\n// plugin entry (filter pass).\n// - duplicate command name across two plugins → conflict error\n// listing both plugin names. Adopter overriding a plugin is\n// allowed and not an error.\n// - duplicate typegen id across two plugins → same error. Typegens\n// have no adopter override path; only plugins contribute them.\n// - register() functions are collected in input order; the caller\n// invokes each one against the same Command program. They have no\n// id-level conflict surface — owners are responsible for picking\n// non-colliding command names inside their own register().\n// - plugin order = array order. No implicit precedence rules.\n\nimport type { Command } from 'commander'\n\nimport type { KickCommandDefinition } from '../config'\nimport type { TypegenPlugin } from '../typegen/plugin'\nimport type { GeneratorSpec } from '../generator-extension/define'\nimport type { DiscoveredGenerator } from '../generator-extension/discover'\nimport { KickPluginConflictError, type KickCliPlugin, type KickCliPluginContext } from './types'\n\nexport interface MergedPlugins {\n commands: KickCommandDefinition[]\n typegens: TypegenPlugin[]\n /** DiscoveredGenerator shape so this list slots into the existing\n * dispatch path next to package.json-discovered entries. `source`\n * carries the plugin name for error attribution. */\n generators: DiscoveredGenerator[]\n /**\n * Apply every plugin's register() in input order. ctx is optional so\n * tests + lightweight callers can invoke `register(program)` without\n * constructing a full context; it falls back to cwd=process.cwd(),\n * config=null, log=no-op.\n */\n register: (program: Command, ctx?: KickCliPluginContext) => Promise<void>\n}\n\nexport function mergeCliPlugins(\n plugins: readonly KickCliPlugin[],\n adopterCommands: readonly KickCommandDefinition[] = [],\n): MergedPlugins {\n // Plugin-name dedup — catches double-install.\n const seenPluginNames = new Map<string, number>()\n for (const p of plugins) {\n const count = (seenPluginNames.get(p.name) ?? 0) + 1\n seenPluginNames.set(p.name, count)\n if (count === 2) {\n throw new KickPluginConflictError('plugin', p.name, [p.name, p.name])\n }\n }\n\n const commandOwners = new Map<string, string>()\n const pluginCommands: KickCommandDefinition[] = []\n for (const p of plugins) {\n for (const cmd of p.commands ?? []) {\n const prior = commandOwners.get(cmd.name)\n if (prior) {\n throw new KickPluginConflictError('command', cmd.name, [prior, p.name])\n }\n commandOwners.set(cmd.name, p.name)\n pluginCommands.push(cmd)\n }\n }\n\n const adopterNames = new Set(adopterCommands.map((c) => c.name))\n const filteredPlugin = pluginCommands.filter((c) => !adopterNames.has(c.name))\n const commands = [...filteredPlugin, ...adopterCommands]\n\n const typegenOwners = new Map<string, string>()\n const typegens: TypegenPlugin[] = []\n for (const p of plugins) {\n for (const tg of p.typegens ?? []) {\n const prior = typegenOwners.get(tg.id)\n if (prior) {\n throw new KickPluginConflictError('typegen', tg.id, [prior, p.name])\n }\n typegenOwners.set(tg.id, p.name)\n typegens.push(tg)\n }\n }\n\n const generatorOwners = new Map<string, string>()\n const generators: DiscoveredGenerator[] = []\n for (const p of plugins) {\n for (const spec of p.generators ?? []) {\n const prior = generatorOwners.get(spec.name)\n if (prior) {\n throw new KickPluginConflictError('generator', spec.name, [prior, p.name])\n }\n generatorOwners.set(spec.name, p.name)\n generators.push({ source: p.name, spec: spec satisfies GeneratorSpec })\n }\n }\n\n /**\n * Apply every plugin's `register()` callback in input order against the\n * given Commander program. Each callback receives a {@link KickCliPluginContext}:\n * caller-supplied ctx wins (test fixtures can inject a different\n * workspace boundary); otherwise a default ctx is built with\n * `findProjectRoot(process.cwd())` as the project root, `cwd` matching\n * `process.cwd()`, null config, no-op log, and the merged generator set\n * threaded through so the `kick/generate` built-in can surface each as\n * a Commander subcommand. The dynamic import of `findProjectRoot` keeps\n * the caller-supplied fast path zero-cost.\n */\n const register = async (program: Command, ctx?: KickCliPluginContext): Promise<void> => {\n let resolved: KickCliPluginContext\n if (ctx) {\n resolved = { generators, ...ctx }\n } else {\n const { findProjectRoot } = await import('../utils/project-root')\n const cwd = process.cwd()\n resolved = {\n cwd,\n projectRoot: findProjectRoot(cwd),\n config: null,\n log: () => {},\n generators,\n }\n }\n for (const p of plugins) {\n if (p.register) await p.register(program, resolved)\n }\n }\n\n return { commands, typegens, generators, register }\n}\n","// Barrel intentionally omits `./builtins` — that module top-level-imports\n// every register*Command, which pulls heavy modules (project scaffolders,\n// fs reads at import time) into the graph. Importers that need the\n// builtin list go through `./plugin/builtins` directly; tests + adopter\n// plugins consuming only the contract types import from here.\n\nexport type { KickCliPlugin } from './types'\nexport { defineCliPlugin, KickPluginConflictError } from './types'\nexport { mergeCliPlugins, type MergedPlugins } from './merge'\n"],"mappings":";;;;;;;;;;wFA4CA,SAAgB,EACd,EACA,EAAoD,CAAC,EACtC,CAEf,IAAM,EAAkB,IAAI,IAC5B,IAAK,IAAM,KAAK,EAAS,CACvB,IAAM,GAAS,EAAgB,IAAI,EAAE,IAAI,GAAK,GAAK,EAEnD,GADA,EAAgB,IAAI,EAAE,KAAM,CAAK,EAC7B,IAAU,EACZ,MAAM,IAAI,EAAwB,SAAU,EAAE,KAAM,CAAC,EAAE,KAAM,EAAE,IAAI,CAAC,CAExE,CAEA,IAAM,EAAgB,IAAI,IACpB,EAA0C,CAAC,EACjD,IAAK,IAAM,KAAK,EACd,IAAK,IAAM,KAAO,EAAE,UAAY,CAAC,EAAG,CAClC,IAAM,EAAQ,EAAc,IAAI,EAAI,IAAI,EACxC,GAAI,EACF,MAAM,IAAI,EAAwB,UAAW,EAAI,KAAM,CAAC,EAAO,EAAE,IAAI,CAAC,EAExE,EAAc,IAAI,EAAI,KAAM,EAAE,IAAI,EAClC,EAAe,KAAK,CAAG,CACzB,CAGF,IAAM,EAAe,IAAI,IAAI,EAAgB,IAAK,GAAM,EAAE,IAAI,CAAC,EAEzD,EAAW,CAAC,GADK,EAAe,OAAQ,GAAM,CAAC,EAAa,IAAI,EAAE,IAAI,CAC1C,EAAG,GAAG,CAAe,EAEjD,EAAgB,IAAI,IACpB,EAA4B,CAAC,EACnC,IAAK,IAAM,KAAK,EACd,IAAK,IAAM,KAAM,EAAE,UAAY,CAAC,EAAG,CACjC,IAAM,EAAQ,EAAc,IAAI,EAAG,EAAE,EACrC,GAAI,EACF,MAAM,IAAI,EAAwB,UAAW,EAAG,GAAI,CAAC,EAAO,EAAE,IAAI,CAAC,EAErE,EAAc,IAAI,EAAG,GAAI,EAAE,IAAI,EAC/B,EAAS,KAAK,CAAE,CAClB,CAGF,IAAM,EAAkB,IAAI,IACtB,EAAoC,CAAC,EAC3C,IAAK,IAAM,KAAK,EACd,IAAK,IAAM,KAAQ,EAAE,YAAc,CAAC,EAAG,CACrC,IAAM,EAAQ,EAAgB,IAAI,EAAK,IAAI,EAC3C,GAAI,EACF,MAAM,IAAI,EAAwB,YAAa,EAAK,KAAM,CAAC,EAAO,EAAE,IAAI,CAAC,EAE3E,EAAgB,IAAI,EAAK,KAAM,EAAE,IAAI,EACrC,EAAW,KAAK,CAAE,OAAQ,EAAE,KAAY,MAA6B,CAAC,CACxE,CAkCF,MAAO,CAAE,WAAU,WAAU,aAAY,eApBjB,EAAkB,IAA8C,CACtF,IAAI,EACJ,GAAI,EACF,EAAW,CAAE,aAAY,GAAG,CAAI,MAC3B,CACL,GAAM,CAAE,mBAAoB,MAAM,OAAO,8BAAwB,CAAA,KAAA,GAAA,EAAA,CAAA,EAC3D,EAAM,QAAQ,IAAI,EACxB,EAAW,CACT,MACA,YAAa,EAAgB,CAAG,EAChC,OAAQ,KACR,QAAW,CAAC,EACZ,YACF,CACF,CACA,IAAK,IAAM,KAAK,EACV,EAAE,UAAU,MAAM,EAAE,SAAS,EAAS,CAAQ,CAEtD,CAEkD,CACpD"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs-cli v6.
|
|
2
|
+
* @forinda/kickjs-cli v6.8.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{l as e,o as t}from"./project-docs-
|
|
11
|
+
import{l as e,o as t}from"./project-docs-ZT5I_aDa.mjs";import{i as n,t as r}from"./config-13M-pdRz.mjs";import{dirname as i,join as a,resolve as o}from"node:path";import{existsSync as s,readFileSync as c}from"node:fs";import{execFileSync as l,execSync as u}from"node:child_process";import{fileURLToPath as d}from"node:url";const f={express:{from:`@forinda/kickjs`,name:`expressRuntime`},fastify:{from:`@forinda/kickjs/fastify`,name:`fastifyRuntime`},h3:{from:`@forinda/kickjs/h3`,name:`h3Runtime`}};function p(e,t,n,r=[],i=`express`){let a=f[i],o=i===`express`;switch(t){case`minimal`:{let t=[],i=[],s=o?`import { bootstrap, ${a.name} } from '@forinda/kickjs'`:`import { bootstrap } from '@forinda/kickjs'\nimport { ${a.name} } from '${a.from}'`;r.includes(`swagger`)&&(t.push(`import { SwaggerAdapter } from '@forinda/kickjs-swagger'`),i.push(` SwaggerAdapter({ info: { title: '${e}', version: '${n}' } }),`)),r.includes(`devtools`)&&(t.push(`import { DevToolsAdapter } from '@forinda/kickjs-devtools'`),i.push(` DevToolsAdapter(),`));let c=t.length?t.join(`
|
|
12
12
|
`)+`
|
|
13
13
|
`:``,l=i.length?`,\n adapters: [\n${i.join(`
|
|
14
14
|
`)}\n ]`:``;return`import 'reflect-metadata'
|
|
@@ -384,7 +384,7 @@ export default defineConfig({
|
|
|
384
384
|
`);for(let e of i)console.log(a(e))}else console.log(`\n Plus ${i.length} optional packages (auth, swagger, db, queue, …).`),console.log(" Run `kick add --list --all` for the full catalog.");console.log(`
|
|
385
385
|
Usage: kick add ai db swagger`),console.log(` kick add queue:bullmq`),console.log(` kick add upload # installs the multipart driver for your runtime`),console.log()}function W(e,t,n=`express`){let r=new Set,i=new Set,a=[],o=[],s=[];for(let c of e){if(c===`upload`){let e=F[n];s.push(`upload (${n}): ${e.note}`),e.prod&&(t?i:r).add(e.prod),e.dev&&i.add(e.dev);continue}let e=N[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)}return{prodDeps:[...r],devDeps:[...i],unknown:a,warnings:o,notices:s}}function G(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`).action(e=>{U(!!e.all)})}function K(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(`--all`,`When listing, include the full optional catalog`).action(async(e,t)=>{if(t.list||e.length===0){U(!!t.all);return}let{pm:n,source:r}=await V(t.pm);console.log(`\n Using ${n} (resolved from ${r})`);let i=await I(process.cwd()),{prodDeps:a,devDeps:o,unknown:s,warnings:c,notices:l}=W(e,!!t.dev,i);for(let e of c)console.warn(`\n WARNING: ${e}`);for(let e of l)console.log(`\n ${e}`);if(!(s.length>0&&(console.log(`\n Unknown packages: ${s.join(`, `)}`),console.log(` Run "kick add --list" to see available packages.
|
|
386
386
|
`),a.length===0&&o.length===0))){if(a.length>0){let e=a,t=`${n} add ${e.join(` `)}`;console.log(`\n Installing ${e.length} dependency(ies):`);for(let t of e)console.log(` + ${t}`);console.log();try{u(t,{stdio:`inherit`})}catch{console.log(`\n Installation failed. Run manually:\n ${t}\n`)}}if(o.length>0){let e=o,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{u(t,{stdio:`inherit`})}catch{console.log(`\n Installation failed. Run manually:\n ${t}\n`)}}console.log(` Done!
|
|
387
|
-
`)}})}const q=i(d(import.meta.url)),J=JSON.parse(c(a(q,`..`,`package.json`),`utf-8`)),Y=`^${J.version}`,X=[`@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`];async function Z(){let e=await Promise.all(X.map(async e=>{try{let t=l(`npm`,[`view`,e,`version`],{encoding:`utf-8`,timeout:5e3,stdio:[`ignore`,`pipe`,`ignore`]}).toString().trim();if(t&&/^\d+\.\d+\.\d+/.test(t))return[e,`^${t}`]}catch{}return[e,Y]}));return Object.fromEntries(e)}function Q(e,t){try{let n=l(`npm`,[`view`,`${e}@${t}`,`version`],{encoding:`utf-8`,timeout:5e3,stdio:[`ignore`,`pipe`,`ignore`]}).toString().trim();return n&&/^\d+\.\d+\.\d+/.test(n)?n:null}catch{return null}}function $(e){return(e??``).replace(/^[\^~>=<\s]+/,``)}function ee(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 te(e,t,n){try{let r=l(`npm`,[`view`,`${e}@${t}`,`exports`,`--json`],{encoding:`utf-8`,timeout:5e3,stdio:[`ignore`,`pipe`,`ignore`]}).toString().trim();if(!r)return!1;let i=JSON.parse(r);return Object.prototype.hasOwnProperty.call(i,n)}catch{return!1}}async function ne(n){let{name:r,directory:i,packageManager:o=`pnpm`,template:s=`rest`,defaultRepo:c=`inmemory`,packages:l=[],schemaLib:d=`zod`,runtime:f=`express`}=n,b=i,x=e=>console.log(` ${e}`);console.log(`\n Creating KickJS project: ${r}\n`),x(`Resolving package versions...`);let S=await Z();if(f!==`express`)if(te(`@forinda/kickjs`,`latest`,`./${f}`))x(`Using @forinda/kickjs@latest (stable ships the ${f} runtime)`);else{let e=[`@forinda/kickjs`,`@forinda/kickjs-cli`,`@forinda/kickjs-vite`],t=[],n=!1;for(let r of e){let e=Q(r,`alpha`);e&&ee(e,$(S[r]))&&(S[r]=`^${e}`,t.push(`${r}@^${e}`),r===`@forinda/kickjs`&&(n=!0))}x(n?`Using the alpha channel for the ${f} runtime: ${t.join(`, `)}`:`WARNING: could not resolve @forinda/kickjs@alpha — the ${f} runtime subpath may be missing. After install, run: ${o} add @forinda/kickjs@alpha`)}await e(a(b,`package.json`),C(r,s,S,l,d,f)),await e(a(b,`vite.config.ts`),w()),await e(a(b,`tsconfig.json`),T()),await e(a(b,`.prettierrc`),E()),await e(a(b,`.editorconfig`),D()),await e(a(b,`.gitignore`),O()),await e(a(b,`.gitattributes`),k()),await e(a(b,`.env`),A()),await e(a(b,`.env.example`),j()),await e(a(b,`src/config/index.ts`),h(d)),await e(a(b,`src/index.ts`),p(r,s,J.version,l,f)),await e(a(b,`src/modules/index.ts`),m()),await e(a(b,`src/modules/hello/hello.service.ts`),g()),await e(a(b,`src/modules/hello/hello.controller.ts`),_()),await e(a(b,`src/modules/hello/hello.module.ts`),v()),await e(a(b,`kick.config.ts`),y(s,c,o,f)),await e(a(b,`vitest.config.ts`),M()),await e(a(b,`README.md`),t(r,s,o));let{generateAgentDocs:N}=await import(`./agent-docs-
|
|
388
|
-
Dependencies installed successfully!`)}catch{console.log(`\n Warning: ${o} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-
|
|
387
|
+
`)}})}const q=i(d(import.meta.url)),J=JSON.parse(c(a(q,`..`,`package.json`),`utf-8`)),Y=`^${J.version}`,X=[`@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`];async function Z(){let e=await Promise.all(X.map(async e=>{try{let t=l(`npm`,[`view`,e,`version`],{encoding:`utf-8`,timeout:5e3,stdio:[`ignore`,`pipe`,`ignore`]}).toString().trim();if(t&&/^\d+\.\d+\.\d+/.test(t))return[e,`^${t}`]}catch{}return[e,Y]}));return Object.fromEntries(e)}function Q(e,t){try{let n=l(`npm`,[`view`,`${e}@${t}`,`version`],{encoding:`utf-8`,timeout:5e3,stdio:[`ignore`,`pipe`,`ignore`]}).toString().trim();return n&&/^\d+\.\d+\.\d+/.test(n)?n:null}catch{return null}}function $(e){return(e??``).replace(/^[\^~>=<\s]+/,``)}function ee(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 te(e,t,n){try{let r=l(`npm`,[`view`,`${e}@${t}`,`exports`,`--json`],{encoding:`utf-8`,timeout:5e3,stdio:[`ignore`,`pipe`,`ignore`]}).toString().trim();if(!r)return!1;let i=JSON.parse(r);return Object.prototype.hasOwnProperty.call(i,n)}catch{return!1}}async function ne(n){let{name:r,directory:i,packageManager:o=`pnpm`,template:s=`rest`,defaultRepo:c=`inmemory`,packages:l=[],schemaLib:d=`zod`,runtime:f=`express`}=n,b=i,x=e=>console.log(` ${e}`);console.log(`\n Creating KickJS project: ${r}\n`),x(`Resolving package versions...`);let S=await Z();if(f!==`express`)if(te(`@forinda/kickjs`,`latest`,`./${f}`))x(`Using @forinda/kickjs@latest (stable ships the ${f} runtime)`);else{let e=[`@forinda/kickjs`,`@forinda/kickjs-cli`,`@forinda/kickjs-vite`],t=[],n=!1;for(let r of e){let e=Q(r,`alpha`);e&&ee(e,$(S[r]))&&(S[r]=`^${e}`,t.push(`${r}@^${e}`),r===`@forinda/kickjs`&&(n=!0))}x(n?`Using the alpha channel for the ${f} runtime: ${t.join(`, `)}`:`WARNING: could not resolve @forinda/kickjs@alpha — the ${f} runtime subpath may be missing. After install, run: ${o} add @forinda/kickjs@alpha`)}await e(a(b,`package.json`),C(r,s,S,l,d,f)),await e(a(b,`vite.config.ts`),w()),await e(a(b,`tsconfig.json`),T()),await e(a(b,`.prettierrc`),E()),await e(a(b,`.editorconfig`),D()),await e(a(b,`.gitignore`),O()),await e(a(b,`.gitattributes`),k()),await e(a(b,`.env`),A()),await e(a(b,`.env.example`),j()),await e(a(b,`src/config/index.ts`),h(d)),await e(a(b,`src/index.ts`),p(r,s,J.version,l,f)),await e(a(b,`src/modules/index.ts`),m()),await e(a(b,`src/modules/hello/hello.service.ts`),g()),await e(a(b,`src/modules/hello/hello.controller.ts`),_()),await e(a(b,`src/modules/hello/hello.module.ts`),v()),await e(a(b,`kick.config.ts`),y(s,c,o,f)),await e(a(b,`vitest.config.ts`),M()),await e(a(b,`README.md`),t(r,s,o));let{generateAgentDocs:N}=await import(`./agent-docs-fKQUJYgz.mjs`).then(e=>e.t);if(await N({outDir:b,name:r,pm:o,template:s,only:`all`,force:!0}),n.installDeps){console.log(`\n Installing dependencies with ${o}...\n`);try{u(`${o} install`,{cwd:b,stdio:`inherit`}),console.log(`
|
|
388
|
+
Dependencies installed successfully!`)}catch{console.log(`\n Warning: ${o} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-BFMgqlSf.mjs`).then(e=>e.n);await e({cwd:b,allowDuplicates:!0,silent:!0})}catch{}if(n.initGit)try{u(`git init`,{cwd:b,stdio:`pipe`}),u(`git branch -M main`,{cwd:b,stdio:`pipe`}),u(`git add -A`,{cwd:b,stdio:`pipe`}),u(`git commit -m "chore: initial commit from kick new"`,{cwd:b,stdio:`pipe`}),x(`Git repository initialized`)}catch{x(`Warning: git init failed (git may not be installed)`)}console.log(`
|
|
389
389
|
Project scaffolded successfully!`),console.log();let F=b!==process.cwd();x(`Next steps:`),F&&x(` cd ${r}`),n.installDeps||x(` ${o} install`);let I={rest:`kick g module user`,ddd:`kick g module user --repo drizzle`,cqrs:`kick g module user --pattern cqrs`,minimal:`# add your routes to src/index.ts`};x(` ${I[s]??I.rest}`),x(` kick dev`),x(``),x(`Commands:`),x(` kick dev Start dev server with Vite HMR`),x(` kick build Production build via Vite`),x(` kick start Run production build`),x(``),x(`Generators:`),x(` kick g module <name> Full DDD module (controller, DTOs, use-cases, repo)`),x(` kick g scaffold <n> <f..> CRUD module from field definitions`),x(` kick g controller <name> Standalone controller`),x(` kick g service <name> @Service() class`),x(` kick g middleware <name> Express middleware`),x(` kick g guard <name> Route guard (auth, roles, etc.)`),x(` kick g adapter <name> AppAdapter with lifecycle hooks`),x(` kick g dto <name> Zod DTO schema`),x(` kick g config Generate kick.config.ts`),x(``),x(`Add packages:`),x(` kick add <pkg> Install a KickJS package + peers`),x(` kick add --list Show all available packages`),x(``),x(`Available: ${P}`),x(``)}export{K as a,H as c,F as i,Z as n,G as o,N as r,I as s,ne as t};
|
|
390
|
-
//# sourceMappingURL=project-
|
|
390
|
+
//# sourceMappingURL=project-BX9P1ntp.mjs.map
|