@forinda/kickjs-cli 6.4.0 → 6.6.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-CqRWMHZ-.mjs +12 -0
- package/dist/agent-docs-CqRWMHZ-.mjs.map +1 -0
- package/dist/{build-CBRWV98i.mjs → build-C6c_h-27.mjs} +3 -3
- package/dist/{build-CBRWV98i.mjs.map → build-C6c_h-27.mjs.map} +1 -1
- package/dist/{builtins-1-t8nFZe.mjs → builtins-BvKA9kzi.mjs} +2 -2
- package/dist/cli.mjs +60 -24
- package/dist/{config-C6Na808n.mjs → config-BOArOJm-.mjs} +3 -3
- package/dist/{config-C6Na808n.mjs.map → config-BOArOJm-.mjs.map} +1 -1
- package/dist/doctor-BJWjI_wt.mjs +860 -0
- package/dist/doctor-BJWjI_wt.mjs.map +1 -0
- package/dist/fullstack-BgwfRTCN.mjs +138 -0
- package/dist/fullstack-BgwfRTCN.mjs.map +1 -0
- package/dist/fullstack-CHO-Us7Y.mjs +137 -0
- package/dist/index.d.mts +7 -0
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +2 -2
- package/dist/index.mjs.map +1 -1
- package/dist/{plugin-DlIRWEfP.mjs → plugin-IyD9yXBm.mjs} +3 -3
- package/dist/{plugin-DlIRWEfP.mjs.map → plugin-IyD9yXBm.mjs.map} +1 -1
- package/dist/project-QWNGOwFX.mjs +390 -0
- package/dist/project-QWNGOwFX.mjs.map +1 -0
- package/dist/{project-docs-Dr75Phev.mjs → project-docs-BSNKPfLT.mjs} +37 -11
- package/dist/project-docs-BSNKPfLT.mjs.map +1 -0
- package/dist/{project-root-BKYv-vPf.mjs → project-root-2PIpqSzM.mjs} +3 -3
- package/dist/{project-root-BKYv-vPf.mjs.map → project-root-2PIpqSzM.mjs.map} +1 -1
- package/dist/prompts-CeLdg6XF.mjs +12 -0
- package/dist/prompts-CeLdg6XF.mjs.map +1 -0
- package/dist/{rolldown-runtime-DLwMHNw-.mjs → rolldown-runtime-CCuSuZBc.mjs} +1 -1
- package/dist/{run-plugins-DaN0MHlX.mjs → run-plugins-B-_RJ-JV.mjs} +60 -54
- package/dist/run-plugins-B-_RJ-JV.mjs.map +1 -0
- package/dist/{typegen-DJGvcWVf.mjs → typegen-BTfDyerr.mjs} +17 -17
- package/dist/typegen-BTfDyerr.mjs.map +1 -0
- package/dist/{types-CmiWgylI.mjs → types-SeFJ8umm.mjs} +1 -1
- package/package.json +2 -2
- package/dist/agent-docs-lDM1Nx6J.mjs +0 -12
- package/dist/agent-docs-lDM1Nx6J.mjs.map +0 -1
- package/dist/doctor-DlWMC_2O.mjs +0 -1234
- package/dist/doctor-DlWMC_2O.mjs.map +0 -1
- package/dist/project-docs-Dr75Phev.mjs.map +0 -1
- package/dist/run-plugins-DaN0MHlX.mjs.map +0 -1
- package/dist/typegen-DJGvcWVf.mjs.map +0 -1
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @forinda/kickjs-cli v6.6.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
|
+
import{a as e,i as t,r as n}from"./cli.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
|
+
- server
|
|
13
|
+
- web
|
|
14
|
+
`),await e(r(C,`.gitignore`),h()),await e(r(C,`README.md`),g(_,S));let{generateAgentDocs:E}=await import(`./cli.mjs`).then(e=>e.n);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(`./cli.mjs`).then(e=>e.t);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
|
+
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
|
+
import react from '@vitejs/plugin-react'
|
|
17
|
+
|
|
18
|
+
export default defineConfig({
|
|
19
|
+
plugins: [react()],
|
|
20
|
+
server: {
|
|
21
|
+
// The KickJS server (kick dev) listens on 3000; the client's baseUrl is
|
|
22
|
+
// the relative '/api/v1', so the browser hits Vite and Vite forwards.
|
|
23
|
+
proxy: {
|
|
24
|
+
'/api': 'http://localhost:3000',
|
|
25
|
+
},
|
|
26
|
+
},
|
|
27
|
+
})
|
|
28
|
+
`}function c(){return`${JSON.stringify({compilerOptions:{target:`ES2022`,lib:[`ES2022`,`DOM`,`DOM.Iterable`],module:`ESNext`,moduleResolution:`bundler`,jsx:`react-jsx`,strict:!0,skipLibCheck:!0,noEmit:!0,isolatedModules:!0,experimentalDecorators:!0,types:[]},include:[`src`]},null,2)}\n`}function l(e){return`<!doctype html>
|
|
29
|
+
<html lang="en">
|
|
30
|
+
<head>
|
|
31
|
+
<meta charset="UTF-8" />
|
|
32
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
33
|
+
<title>${e}</title>
|
|
34
|
+
</head>
|
|
35
|
+
<body>
|
|
36
|
+
<div id="root"></div>
|
|
37
|
+
<script type="module" src="/src/main.tsx"><\/script>
|
|
38
|
+
</body>
|
|
39
|
+
</html>
|
|
40
|
+
`}function u(){return`import { StrictMode } from 'react'
|
|
41
|
+
import { createRoot } from 'react-dom/client'
|
|
42
|
+
import { App } from './App'
|
|
43
|
+
|
|
44
|
+
createRoot(document.getElementById('root')!).render(
|
|
45
|
+
<StrictMode>
|
|
46
|
+
<App />
|
|
47
|
+
</StrictMode>,
|
|
48
|
+
)
|
|
49
|
+
`}function d(){return`import { useEffect, useState } from 'react'
|
|
50
|
+
import { api } from './api'
|
|
51
|
+
|
|
52
|
+
// The response types below are INFERRED from the server's handlers —
|
|
53
|
+
// change server/src/modules/hello/hello.service.ts and these types follow
|
|
54
|
+
// on the next \`kick typegen\` (automatic under \`kick dev\`).
|
|
55
|
+
type Greeting = Awaited<ReturnType<typeof fetchGreeting>>
|
|
56
|
+
|
|
57
|
+
function fetchGreeting() {
|
|
58
|
+
return api.get('/hello')
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
export function App() {
|
|
62
|
+
const [greeting, setGreeting] = useState<Greeting | null>(null)
|
|
63
|
+
const [health, setHealth] = useState<string>('checking…')
|
|
64
|
+
|
|
65
|
+
useEffect(() => {
|
|
66
|
+
fetchGreeting().then(setGreeting).catch(console.error)
|
|
67
|
+
api
|
|
68
|
+
.get('/hello/health')
|
|
69
|
+
.then((h) => setHealth(h.status))
|
|
70
|
+
.catch(() => setHealth('down'))
|
|
71
|
+
}, [])
|
|
72
|
+
|
|
73
|
+
return (
|
|
74
|
+
<main style={{ fontFamily: 'system-ui', maxWidth: 640, margin: '4rem auto', padding: '0 1rem' }}>
|
|
75
|
+
<h1>KickJS fullstack</h1>
|
|
76
|
+
<p>
|
|
77
|
+
<strong>{greeting?.message ?? 'loading…'}</strong>
|
|
78
|
+
</p>
|
|
79
|
+
<p>
|
|
80
|
+
Server said hello at <code>{greeting?.timestamp ?? '…'}</code> — health:{' '}
|
|
81
|
+
<code>{health}</code>
|
|
82
|
+
</p>
|
|
83
|
+
<p style={{ color: '#666' }}>
|
|
84
|
+
This call is typed end to end: <code>api.get('/hello')</code> returns the exact shape
|
|
85
|
+
<code> HelloService.greet()</code> produces. Rename a field on the server and this file
|
|
86
|
+
stops compiling.
|
|
87
|
+
</p>
|
|
88
|
+
</main>
|
|
89
|
+
)
|
|
90
|
+
}
|
|
91
|
+
`}function f(){return`import { createClient } from '@forinda/kickjs-client'
|
|
92
|
+
|
|
93
|
+
// KickApi (alias of KickRoutes.Api) is ambient — populated by server/.kickjs/types (see
|
|
94
|
+
// src/types/kick-routes.d.ts). Keys are module-mount-relative paths;
|
|
95
|
+
// the bootstrap-level '/api/v1' prefix lives here in baseUrl, and the
|
|
96
|
+
// Vite dev proxy forwards it to the KickJS server.
|
|
97
|
+
export const api = createClient<KickApi>({ baseUrl: '/api/v1' })
|
|
98
|
+
`}function p(){return`// Type-only bridge to the server's generated route types. The import is
|
|
99
|
+
// erased at build time — no server code ever enters the web bundle.
|
|
100
|
+
// Regenerate with \`kick typegen\` in server/ (automatic under \`kick dev\`).
|
|
101
|
+
import '../../../server/.kickjs/types/kick__routes'
|
|
102
|
+
`}function m(e,t){let n=t===`pnpm`?{dev:`pnpm --parallel -r run dev`,"dev:server":`pnpm --filter ./server dev`,"dev:web":`pnpm --filter ./web dev`,build:`pnpm -r run build`,typecheck:`pnpm -r run typecheck`}:{"dev:server":`cd server && ${t} run dev`,"dev:web":`cd web && ${t} run dev`,build:`${t} run build:server && ${t} run build:web`,"build:server":`cd server && ${t} run build`,"build:web":`cd web && ${t} run build`,typecheck:`cd web && ${t} run typecheck`};return`${JSON.stringify({name:e,private:!0,version:`0.0.0`,type:`module`,scripts:n,workspaces:[`server`,`web`]},null,2)}\n`}function h(){return`node_modules/
|
|
103
|
+
dist/
|
|
104
|
+
.env
|
|
105
|
+
*.log
|
|
106
|
+
.DS_Store
|
|
107
|
+
`}function g(e,t){return`# ${e}
|
|
108
|
+
|
|
109
|
+
Fullstack KickJS workspace — typed end to end.
|
|
110
|
+
|
|
111
|
+
| Package | What |
|
|
112
|
+
| --------- | ----------------------------------------------------------------- |
|
|
113
|
+
| \`server/\` | KickJS API (decorators, DI, \`kick dev\` with typegen watch) |
|
|
114
|
+
| \`web/\` | Vite + React, typed against the API via \`@forinda/kickjs-client\` |
|
|
115
|
+
|
|
116
|
+
## Develop
|
|
117
|
+
|
|
118
|
+
\`\`\`bash
|
|
119
|
+
${t} install
|
|
120
|
+
${t===`pnpm`?`pnpm dev # server (kick dev) + web (vite), in parallel`:`${t} run dev:server # terminal 1\n${t} run dev:web # terminal 2`}
|
|
121
|
+
\`\`\`
|
|
122
|
+
|
|
123
|
+
Server: http://localhost:3000 · Web: http://localhost:5173 (Vite proxies \`/api\`).
|
|
124
|
+
|
|
125
|
+
## The type loop
|
|
126
|
+
|
|
127
|
+
1. Server handlers **return** their payloads (\`return this.service.greet(...)\`).
|
|
128
|
+
2. \`kick typegen\` (auto under \`kick dev\`) emits \`server/.kickjs/types/kick__routes.ts\` —
|
|
129
|
+
including the flat \`KickRoutes.Api\` map with inferred response types.
|
|
130
|
+
3. \`web/src/types/kick-routes.d.ts\` imports that file type-only.
|
|
131
|
+
4. \`web/src/api.ts\`'s \`createClient<KickRoutes.Api>\` types every call site.
|
|
132
|
+
|
|
133
|
+
Rename a field in \`server/src/modules/hello/hello.service.ts\` → \`web/src/App.tsx\`
|
|
134
|
+
stops compiling. That's the point.
|
|
135
|
+
|
|
136
|
+
Docs: https://kickjs.app/guide/typed-client.html
|
|
137
|
+
`}export{a as initFullstackProject};
|
package/dist/index.d.mts
CHANGED
|
@@ -867,6 +867,13 @@ interface DiscoveredRoute {
|
|
|
867
867
|
bodySchema: SchemaRef | null;
|
|
868
868
|
querySchema: SchemaRef | null;
|
|
869
869
|
paramsSchema: SchemaRef | null;
|
|
870
|
+
/**
|
|
871
|
+
* Declared response contract from the route decorator
|
|
872
|
+
* (`@Get('/', { response: schema })`). When present it WINS over
|
|
873
|
+
* return-type inference in the emitted `response` field — and the same
|
|
874
|
+
* declaration drives the Swagger success-response schema.
|
|
875
|
+
*/
|
|
876
|
+
responseSchema?: SchemaRef | null;
|
|
870
877
|
/** Absolute file path of the controller */
|
|
871
878
|
filePath: string;
|
|
872
879
|
/** Path relative to scan root, with forward slashes */
|
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;EACA,QAAA;EAMmB;AAGrB;;;;EAHE,OAAA,EAAS,UAAU;AAAA;AAAA,UAGJ,YAAA;EAOf;EALA,IAAA;EACA,MAAA;EAOU;EALV,OAAA;;EAEA,GAAA;AAAA;AAAA,KAGU,WAAA,IACV,GAAA,EAAK,aAAA,KACF,YAAA,GAAe,YAAA,YAAwB,OAAA,CAAQ,YAAA,GAAe,YAAA;;;;;;UAOlD,eAAA;EARf;EAUA,MAAA,GAAS,WAAW;AAAA;;;;;AATyD;AAO/E;;;;AAEsB;AAqCtB;;;;;;;;AAA4E;AA0B5E;;;;;;;;AAAkE;;;;AC1FlE;;;iBDgEgB,qBAAA,CAAsB,GAAA,EAAK,eAAA,GAAkB,eAAe;AChEX;AAGjE;;;;AAAmD;;;;AC7BnD;;;;;;;;;AAeS;AAIT;;;ADOiE,iBD0FjD,iBAAA,CAAkB,KAAA,EAAO,WAAA,GAAc,WAAW;;;;KC1FtD,oBAAA,GAAuB,sBAAmB,CAAC,UAAA;;KAG3C,aAAA,GAAgB,eAAY,CAAC,UAAA;;;;UC7BxB,qBAAA;;EAEf,IAAA;EHmOoB;EGjOpB,WAAA;EHiOoB;AAAA;;;;ACjNtB;;;EEPE,KAAA;EFQA;EENA,OAAA;AAAA;;KAIU,cAAA;;KAGA,cAAA;;;;;;;;;AFiBP;KEJO,iBAAA;;UA2BK,cAAA;EACf,IAAI;AAAA;;KAIM,cAAA,GAAiB,iBAAA,GAAkB,cAAc;AFhB7D;;;;AAEsB;AAqCtB;;;;;AAvCA,KE4BY,eAAA;;;AFWgE;AA0B5E;;UE9BiB,aAAA;EF8BiD;;;;;AAAA;EEvBhE,GAAA;;;ADnEF;;;;EC0EE,IAAA;EDvEU;;;;AAAuC;EC6EjD,IAAA;;;AA1GF;;;;;;;;;AAeS;AAIT;;;;AAA0B;AAG1B;;;;EA0GE,IAAA;AAAA;;;;AA7FyB;AA2B3B;;;;AACM;AAIN;;;;AAA6D;AAY7D;;;;AAA2B;AAO3B;;;UAmEiB,iBAAA;EA5Df;;;;EAiEA,UAAA;EA9BI;AAyBN;;;EAUE,aAAA;EALA;EAOA,OAAA;EAAA;;;;;AAciC;EAPjC,gBAAA;EAW4B;;;;;;EAJ5B,OAAA,mBAA0B,OAAO;AAAA;;UAIlB,aAAA;EAmDR;AAIT;;;EAlDE,MAAA;EAoDA;;;;EA/CA,MAAA;EA+EA;;;AAoBK;AAIP;;;;;;;;EA1FE,eAAA,GAAkB,eAAe;EAyOvB;;;;;;;;;EA/NV,OAAA;EAoGU;;;;;;;;;;;;;;;;;EAlFV,OAAA;AAAA;;UAIe,YAAA;EA+NJ;EA7NX,GAAA;EA2OU;;;;;;;;;AA6CJ;AAIR;;;EA9QE,IAAA,GAAO,cAAc;EA8Qc;EA5QnC,SAAA;EA4QgD;;AAAU;AA2G5D;;EAjXE,SAAA;EAiX6D;;;;;AAAW;;;;EAvWxE,gBAAA;ECvQqB;;;AAAA;;;;ACJvB;;;;AAA2B;AAC3B;;;;AAAsC;AAOrC;;EFuRC,KAAA;AAAA;;UAIe,UAAA;EE9PI;;;;;;;EFsQnB,OAAA,GAAU,cAAA;EE3RV;;;;;;;;;;;EFuSA,OAAA,GAAU,YAAA;EExQU;;;;;;;;AAAuD;;;;;;;EFwR3E,cAAA,GAAiB,cAAA;EG7UX;AAcR;;;;;;;;AAA+E;;;;AChBhC;;;EJiW7C,OAAA;EI9VA;;;;;;;;AAKS;AAGX;;;;;;;;AAAqF;EJ0WnF,UAAA;;;AKrX6C;;;;;;;;;;;ELoY7C,QAAA,GAAW,KAAA;IAAiB,GAAA;IAAa,IAAA;EAAA;;;;;;;AKzXgC;;;;ACX5B;ENgZ7C,KAAA;IMzYU;;;;;;INgZR,MAAA;EAAA;EM/YF;;AAAS;AAGX;;;;;;;;AAA+E;;;;ACXhC;;;;;;EP8a7C,QAAA,GAAW,MAAA,SAAe,aAAA;EOxa1B;;;;;AAES;AAGX;;;;;EP+aE,OAAA,GAAU,aAAA;EO/akE;;AAAO;EPmbnF,GAAA;;;AQ9b6C;;;;;;IRuc3C,SAAA;EAAA;EQhcF;;;;AACS;ERscT,EAAA,GAAK,iBAAA;EQnc0B;ERqc/B,QAAA,GAAW,qBAAA;EQrc0D;;;;;AAAA
|
|
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.6.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{
|
|
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-BJWjI_wt.mjs";import{t as _}from"./project-QWNGOwFX.mjs";import{i as v,r as y}from"./config-BOArOJm-.mjs";import{t as b}from"./project-root-2PIpqSzM.mjs";import{n as x,t as S}from"./types-SeFJ8umm.mjs";function C(e){return e}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};
|
|
12
12
|
//# sourceMappingURL=index.mjs.map
|
package/dist/index.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.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'\n outFile?: string\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":";;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"index.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'\n outFile?: string\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":";;;;;;;;;;sVAsGA,SAAgB,EAAc,EAAoC,CAChE,OAAO,CACT"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs-cli v6.
|
|
2
|
+
* @forinda/kickjs-cli v6.6.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-CCuSuZBc.mjs";import{t}from"./types-SeFJ8umm.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-2PIpqSzM.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-IyD9yXBm.mjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"plugin-
|
|
1
|
+
{"version":3,"file":"plugin-IyD9yXBm.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"}
|