@forinda/kickjs-cli 8.10.0 → 8.10.1
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/README.md +2 -0
- package/dist/{agent-docs-CmPrfpaP.mjs → agent-docs-TdQs75ND.mjs} +65 -21
- package/dist/agent-docs-TdQs75ND.mjs.map +1 -0
- package/dist/{agent-docs-CvBsLoE4.mjs → agent-docs-uEhHT_Tq.mjs} +67 -23
- package/dist/{build-Dr7_JT3S.mjs → build-D90mecBH.mjs} +3 -3
- package/dist/{build-Dr7_JT3S.mjs.map → build-D90mecBH.mjs.map} +1 -1
- package/dist/{build-Snjzr08O.mjs → build-xfLqm9dd.mjs} +2 -2
- package/dist/{builtins-MG6t5uS3.mjs → builtins-C3BQ79nW.mjs} +2 -2
- package/dist/{builtins-BTPvizzK.mjs → builtins-CNJXXYW-.mjs} +137 -150
- package/dist/cli.mjs +2 -2
- package/dist/config-BV6rXylg.mjs +13 -0
- package/dist/config-BV6rXylg.mjs.map +1 -0
- package/dist/config-CVuSVUvw.mjs +12 -0
- package/dist/{doctor-C-VSGhJ6.mjs → doctor-a-UkOZYd.mjs} +35 -40
- package/dist/doctor-a-UkOZYd.mjs.map +1 -0
- package/dist/fullstack-BlNhq-tI.mjs +100 -0
- package/dist/fullstack-BlNhq-tI.mjs.map +1 -0
- package/dist/fullstack-Zk31eUT1.mjs +99 -0
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +2 -2
- package/dist/package-manager-BUDLqU4F.mjs +12 -0
- package/dist/package-manager-BUDLqU4F.mjs.map +1 -0
- package/dist/package-manager-Bk2uiXkV.mjs +11 -0
- package/dist/{plugin-E910l1_e.mjs → plugin-DDENlsHw.mjs} +2 -2
- package/dist/{plugin-BpfANLIW.mjs → plugin-FOqPjQ0u.mjs} +2 -2
- package/dist/project-BBiJ64ya.mjs +114 -0
- package/dist/project-fa9FRWXx.mjs +115 -0
- package/dist/project-fa9FRWXx.mjs.map +1 -0
- package/dist/{project-root-D74lbi2U.mjs → project-root-BMpUTIbO.mjs} +2 -2
- package/dist/{project-root-DO7MsZOq.mjs → project-root-BZ1wVwrr.mjs} +3 -3
- package/dist/{project-root-DO7MsZOq.mjs.map → project-root-BZ1wVwrr.mjs.map} +1 -1
- package/dist/{prompts-DKR7UZkc.mjs → prompts-C4g1xbsv.mjs} +2 -2
- package/dist/{prompts-DKR7UZkc.mjs.map → prompts-C4g1xbsv.mjs.map} +1 -1
- package/dist/{rolldown-runtime-vT0bVE76.mjs → rolldown-runtime-D8pytGn4.mjs} +1 -1
- package/dist/{run-plugins-BXNfws9R.mjs → run-plugins-CeZS2Opt.mjs} +99 -107
- package/dist/run-plugins-CeZS2Opt.mjs.map +1 -0
- package/dist/{typegen-B90QMhV8.mjs → typegen-Cj5lp0gl.mjs} +5 -5
- package/dist/{typegen-B90QMhV8.mjs.map → typegen-Cj5lp0gl.mjs.map} +1 -1
- package/dist/{typegen-BmyEoY3Z.mjs → typegen-D9opCn2d.mjs} +4 -4
- package/dist/{types-C2QNIHnD.mjs → types-BqvSIAQz.mjs} +1 -1
- package/package.json +2 -2
- package/templates/base/files/README.md +17 -15
- package/templates/base/files/kick.config.ts +1 -1
- package/templates/template-inertia/files/src/client/app.css +1 -1
- package/templates/template-inertia/files/vite.client.config.ts +1 -1
- package/dist/agent-docs-CmPrfpaP.mjs.map +0 -1
- package/dist/config-B7ZUrOl6.mjs +0 -13
- package/dist/config-B7ZUrOl6.mjs.map +0 -1
- package/dist/config-DO4J2xgV.mjs +0 -12
- package/dist/doctor-C-VSGhJ6.mjs.map +0 -1
- package/dist/fs-CT9PRuSw.mjs +0 -11
- package/dist/fs-gRPNbfZO.mjs +0 -12
- package/dist/fs-gRPNbfZO.mjs.map +0 -1
- package/dist/fullstack-CTB1yuCK.mjs +0 -95
- package/dist/fullstack-bVcLaFbj.mjs +0 -96
- package/dist/fullstack-bVcLaFbj.mjs.map +0 -1
- package/dist/project-BAmOMd-l.mjs +0 -113
- package/dist/project-D7x753R7.mjs +0 -114
- package/dist/project-D7x753R7.mjs.map +0 -1
- package/dist/run-plugins-BXNfws9R.mjs.map +0 -1
|
@@ -1,95 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @forinda/kickjs-cli v8.10.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,d as t,f as n,h as r,m as i,n as a,p as o,t as s,u as c}from"./project-BAmOMd-l.mjs";import{r as l}from"./fs-CT9PRuSw.mjs";import{join as u}from"node:path";import{execFileSync as d}from"node:child_process";const f=`https://kickjs.app/guide/fullstack-frontend.html`,p=[{value:`react-ts`,label:`React`},{value:`react-compiler-ts`,label:`React + Compiler`},{value:`vue-ts`,label:`Vue`},{value:`svelte-ts`,label:`Svelte`},{value:`solid-ts`,label:`Solid`},{value:`preact-ts`,label:`Preact`},{value:`lit-ts`,label:`Lit`},{value:`qwik-ts`,label:`Qwik`},{value:`vanilla-ts`,label:`Vanilla`}],m=`react-ts`;function h(e,t,n=m){let r=[`--template`,n,`--no-interactive`,`--no-immediate`];return e===`yarn`||e===`bun`?[e,`create`,`vite`,t,...r]:e===`npm`?[e,`create`,`vite@latest`,t,`--`,...r]:[e,`create`,`vite@latest`,t,...r]}async function g(c){let{name:p,directory:g,schemaLib:b=`zod`,runtime:x=`express`,packages:S=[],frontend:C=`kick`,viteTemplate:w=m}=c,T=[`pnpm`,`npm`,`yarn`,`bun`].includes(c.packageManager),E=T?c.packageManager:`pnpm`,D=g,O=e=>console.log(` ${e}`);c.packageManager!==void 0&&!T&&O(`Warning: unknown package manager '${String(c.packageManager)}' — falling back to pnpm.`),console.log(`\n Creating fullstack KickJS workspace: ${p}\n`),console.log(` Resolving package versions...`);let k=await a(),A=await s({name:`${p}-server`,directory:u(D,`server`),packageManager:E,template:`minimal`,schemaLib:b,runtime:x,packages:S,extraLayers:[`server-fullstack`],approveInstallScripts:!1,platformConfig:!1,initGit:!1,installDeps:!1,spaClientDir:`../web/dist`,versions:k});if(C===`vite`){console.log(`\n Handing web/ to create-vite (${w})...\n`);let[e,...t]=h(E,`web`,w);r(e,t,{cwd:D})}else await l(u(D,`web/package.json`),_(p,k));await l(u(D,`package.json`),v(p,E,k[`@forinda/kickjs-cli`])),E===`pnpm`&&await l(u(D,`pnpm-workspace.yaml`),`packages:
|
|
12
|
-
- server
|
|
13
|
-
- web
|
|
14
|
-
`),e(E,D,A.builds);let j=[`fullstack-root`,...C===`vite`?[]:[`web-kick`]],M=o(i(j).files,{name:p,packageManager:E});for(let[e,t]of M)await l(u(D,e),t);await l(u(D,`README.md`),y(p,E,C)),await l(u(D,`Dockerfile`),t(`fullstack`,E,p)),await l(u(D,`.dockerignore`),n());let{generateAgentDocs:N}=await import(`./agent-docs-CvBsLoE4.mjs`).then(e=>e.t);if(await N({outDir:D,name:p,pm:E,template:`fullstack`,only:`all`,force:!0}),c.installDeps){console.log(`\n Installing workspace dependencies with ${E}...\n`);try{r(E,[`install`],{cwd:D})}catch{console.log(`\n Warning: ${E} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-BmyEoY3Z.mjs`).then(e=>e.n);await e({cwd:u(D,`server`),allowDuplicates:!0,silent:!0})}catch{}if(c.initGit)try{d(`git`,[`init`],{cwd:D,stdio:`pipe`}),d(`git`,[`branch`,`-M`,`main`],{cwd:D,stdio:`pipe`}),d(`git`,[`add`,`-A`],{cwd:D,stdio:`pipe`}),d(`git`,[`commit`,`-m`,`chore: initial commit from kick new (fullstack)`],{cwd:D,stdio:`pipe`}),O(`Git repository initialized`)}catch{O(`Warning: git init failed (git may not be installed)`)}console.log(`
|
|
15
|
-
Fullstack workspace scaffolded!`),console.log(),O(`Next steps:`),O(` cd ${p}`),c.installDeps||O(` ${E} install`),E===`pnpm`?O(` pnpm dev # runs server (kick dev) + web (vite) together`):(O(` ${E} run dev:server # terminal 1`),O(` ${E} run dev:web # terminal 2`)),O(``),C===`vite`?(O(`web/ is create-vite output, unwired. To type it against the API:`),O(` ${f}`)):(O(`The web app calls the API through @forinda/kickjs-client —`),O("edit server/src/modules/hello, run `kick typegen` in server/, and"),O(`web/src/App.tsx's types follow.`)),O(``)}function _(e,t){let n=e=>t[e]??`latest`;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":n(`@forinda/kickjs-client`),react:n(`react`),"react-dom":n(`react-dom`)},devDependencies:{"@types/react":n(`@types/react`),"@types/react-dom":n(`@types/react-dom`),"@vitejs/plugin-react":n(`@vitejs/plugin-react`),typescript:n(`typescript`),vite:n(`vite`)}},null,2)}\n`}function v(e,t,n,r=c(t)){let i=t===`pnpm`?{dev:`pnpm --parallel -r run dev`,start:`pnpm --filter ./server run start`,"dev:server":`pnpm --filter ./server dev`,"dev:web":`pnpm --filter ./web dev`,build:`pnpm --filter ./server exec kick typegen && pnpm -r run build`,"build:netlify":`pnpm build && pnpm --filter ./server exec kick build:netlify`,"build:vercel":`pnpm build && pnpm --filter ./server exec kick build:vercel`,typecheck:`kick typecheck --cwd server && kick typecheck --cwd web`}:{start:`cd server && ${t} run start`,"dev:server":`cd server && ${t} run dev`,"dev:web":`cd web && ${t} run dev`,build:`cd server && ${t} exec kick typegen && cd .. && ${t} run build:server && ${t} run build:web`,"build:netlify":`${t} run build && cd server && ${t} exec kick build:netlify`,"build:vercel":`${t} run build && cd server && ${t} exec kick build:vercel`,"build:server":`cd server && ${t} run build`,"build:web":`cd web && ${t} run build`,typecheck:`kick typecheck --cwd server && kick typecheck --cwd web`};return`${JSON.stringify({name:e,private:!0,version:`0.0.0`,type:`module`,...r?{packageManager:r}:{},scripts:i,devDependencies:{"@forinda/kickjs-cli":n},workspaces:[`server`,`web`]},null,2)}\n`}function y(e,t,n=`kick`){let r=`# ${e}
|
|
16
|
-
|
|
17
|
-
Fullstack KickJS workspace — typed end to end.
|
|
18
|
-
|
|
19
|
-
| Package | What |
|
|
20
|
-
| --------- | ----------------------------------------------------------------- |
|
|
21
|
-
| \`server/\` | KickJS API (decorators, DI, \`kick dev\` with typegen watch) |
|
|
22
|
-
| \`web/\` | Vite + React, typed against the API via \`@forinda/kickjs-client\` |
|
|
23
|
-
|
|
24
|
-
## Develop
|
|
25
|
-
|
|
26
|
-
\`\`\`bash
|
|
27
|
-
${t} install
|
|
28
|
-
${t===`pnpm`?`pnpm dev # server (kick dev) + web (vite), in parallel`:`${t} run dev:server # terminal 1\n${t} run dev:web # terminal 2`}
|
|
29
|
-
\`\`\`
|
|
30
|
-
|
|
31
|
-
Server: http://localhost:3000 · Web: http://localhost:5173 (Vite proxies \`/api\`).
|
|
32
|
-
|
|
33
|
-
## The type loop
|
|
34
|
-
|
|
35
|
-
1. Server handlers **return** their payloads (\`return this.service.greet(...)\`).
|
|
36
|
-
2. \`kick typegen\` emits \`server/.kickjs/types/kick__client.d.ts\` — the flat
|
|
37
|
-
route map with every response type resolved to a literal shape.
|
|
38
|
-
3. \`web/tsconfig.json\` lists that file in \`types\`, so \`KickClientApi\` is
|
|
39
|
-
ambient — no import, no bridge file.
|
|
40
|
-
4. \`web/src/api.ts\`'s \`createClient<KickClientApi.Api>\` types every call site.
|
|
41
|
-
|
|
42
|
-
Because the map holds resolved types rather than references to controllers,
|
|
43
|
-
\`web\` never compiles server source: no \`experimentalDecorators\`, no path
|
|
44
|
-
aliases into \`server/src\`.
|
|
45
|
-
|
|
46
|
-
Rename a field in \`server/src/modules/hello/hello.service.ts\` → \`web/src/App.tsx\`
|
|
47
|
-
stops compiling. That's the point.
|
|
48
|
-
|
|
49
|
-
### Keeping the map fresh
|
|
50
|
-
|
|
51
|
-
\`server/.kickjs/types/kick__client.d.ts\` is generated, and \`web\` reads it as
|
|
52
|
-
an ambient type package. Two things follow.
|
|
53
|
-
|
|
54
|
-
**\`kick dev\` writes it at startup, not on save.** Resolving it builds a whole TypeScript
|
|
55
|
-
program over the server, which is a build-step cost rather than a per-save one,
|
|
56
|
-
so a renamed response field surfaces on the next \`kick typegen\` rather than on
|
|
57
|
-
save. Everything else in \`.kickjs/types\` still updates on save. Add
|
|
58
|
-
\`kick typegen --check\` to CI and a stale map fails the build.
|
|
59
|
-
|
|
60
|
-
**It needs a compiler API.** TypeScript 7 ships none, so \`server\` depends on
|
|
61
|
-
\`@typescript/typescript6\`. Remove it and typegen skips this one file, saying
|
|
62
|
-
so; \`web\` then reports \`TS2688\` because the file it lists in \`types\` is gone.
|
|
63
|
-
|
|
64
|
-
### The other way to wire it
|
|
65
|
-
|
|
66
|
-
A \`types\` entry says "this is a global type package", which is what the map is,
|
|
67
|
-
and it fails loudly when the file is missing. If you would rather it be quiet
|
|
68
|
-
when absent — say, a repo where the map is not always generated — use
|
|
69
|
-
\`include\` instead:
|
|
70
|
-
|
|
71
|
-
\`\`\`json
|
|
72
|
-
{ "include": ["src", "../server/.kickjs/types/kick__client.d.ts"] }
|
|
73
|
-
\`\`\`
|
|
74
|
-
|
|
75
|
-
That tolerates the file not existing, at the cost of \`KickClientApi\` silently
|
|
76
|
-
not resolving. Note \`types\` replaces TypeScript's automatic \`@types\`
|
|
77
|
-
inclusion, so if you add entries there, list the ones you rely on too
|
|
78
|
-
(\`"types": ["node", "../server/.kickjs/types/kick__client"]\`).
|
|
79
|
-
|
|
80
|
-
Or skip the global entirely — the same file exports the type:
|
|
81
|
-
|
|
82
|
-
\`\`\`ts
|
|
83
|
-
import type { Api } from '../../server/.kickjs/types/kick__client'
|
|
84
|
-
|
|
85
|
-
export const api = createClient<Api>({ baseUrl: '/api/v1' })
|
|
86
|
-
\`\`\`
|
|
87
|
-
|
|
88
|
-
Docs: https://kickjs.app/guide/typed-client.html
|
|
89
|
-
`;if(n!==`vite`)return r;let i=r.indexOf(`## The type loop`);return`${r.slice(0,i).replace("Vite + React, typed against the API via `@forinda/kickjs-client`",`create-vite scaffold — unwired (see below) `).replace(" (Vite proxies `/api`)",``)}## Wiring web/ to the API
|
|
90
|
-
|
|
91
|
-
\`web/\` is whatever create-vite scaffolded; nothing connects it to the API yet.
|
|
92
|
-
Four steps — typed client, \`/api\` dev proxy, route-map types, \`src/api.ts\`:
|
|
93
|
-
|
|
94
|
-
${f}
|
|
95
|
-
`}export{m as DEFAULT_VITE_TEMPLATE,p as VITE_TEMPLATES,g as initFullstackProject};
|
|
@@ -1,96 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @forinda/kickjs-cli v8.10.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{r as e}from"./fs-gRPNbfZO.mjs";import{a as t,d as n,g as r,h as i,m as a,n as o,p as s,t as c,u as l}from"./project-D7x753R7.mjs";import{join as u}from"node:path";import{execFileSync as d}from"node:child_process";const f=`https://kickjs.app/guide/fullstack-frontend.html`,p=[{value:`react-ts`,label:`React`},{value:`react-compiler-ts`,label:`React + Compiler`},{value:`vue-ts`,label:`Vue`},{value:`svelte-ts`,label:`Svelte`},{value:`solid-ts`,label:`Solid`},{value:`preact-ts`,label:`Preact`},{value:`lit-ts`,label:`Lit`},{value:`qwik-ts`,label:`Qwik`},{value:`vanilla-ts`,label:`Vanilla`}],m=`react-ts`;function h(e,t,n=m){let r=[`--template`,n,`--no-interactive`,`--no-immediate`];return e===`yarn`||e===`bun`?[e,`create`,`vite`,t,...r]:e===`npm`?[e,`create`,`vite@latest`,t,`--`,...r]:[e,`create`,`vite@latest`,t,...r]}async function g(l){let{name:p,directory:g,schemaLib:b=`zod`,runtime:x=`express`,packages:S=[],frontend:C=`kick`,viteTemplate:w=m}=l,T=[`pnpm`,`npm`,`yarn`,`bun`].includes(l.packageManager),E=T?l.packageManager:`pnpm`,D=g,O=e=>console.log(` ${e}`);l.packageManager!==void 0&&!T&&O(`Warning: unknown package manager '${String(l.packageManager)}' — falling back to pnpm.`),console.log(`\n Creating fullstack KickJS workspace: ${p}\n`),console.log(` Resolving package versions...`);let k=await o(),A=await c({name:`${p}-server`,directory:u(D,`server`),packageManager:E,template:`minimal`,schemaLib:b,runtime:x,packages:S,extraLayers:[`server-fullstack`],approveInstallScripts:!1,platformConfig:!1,initGit:!1,installDeps:!1,spaClientDir:`../web/dist`,versions:k});if(C===`vite`){console.log(`\n Handing web/ to create-vite (${w})...\n`);let[e,...t]=h(E,`web`,w);n(e,t,{cwd:D})}else await e(u(D,`web/package.json`),_(p,k));await e(u(D,`package.json`),v(p,E,k[`@forinda/kickjs-cli`])),E===`pnpm`&&await e(u(D,`pnpm-workspace.yaml`),`packages:
|
|
12
|
-
- server
|
|
13
|
-
- web
|
|
14
|
-
`),t(E,D,A.builds);let j=[`fullstack-root`,...C===`vite`?[]:[`web-kick`]],M=i(r(j).files,{name:p,packageManager:E});for(let[t,n]of M)await e(u(D,t),n);await e(u(D,`README.md`),y(p,E,C)),await e(u(D,`Dockerfile`),s(`fullstack`,E,p)),await e(u(D,`.dockerignore`),a());let{generateAgentDocs:N}=await import(`./agent-docs-CmPrfpaP.mjs`).then(e=>e.t);if(await N({outDir:D,name:p,pm:E,template:`fullstack`,only:`all`,force:!0}),l.installDeps){console.log(`\n Installing workspace dependencies with ${E}...\n`);try{n(E,[`install`],{cwd:D})}catch{console.log(`\n Warning: ${E} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-B90QMhV8.mjs`).then(e=>e.n);await e({cwd:u(D,`server`),allowDuplicates:!0,silent:!0})}catch{}if(l.initGit)try{d(`git`,[`init`],{cwd:D,stdio:`pipe`}),d(`git`,[`branch`,`-M`,`main`],{cwd:D,stdio:`pipe`}),d(`git`,[`add`,`-A`],{cwd:D,stdio:`pipe`}),d(`git`,[`commit`,`-m`,`chore: initial commit from kick new (fullstack)`],{cwd:D,stdio:`pipe`}),O(`Git repository initialized`)}catch{O(`Warning: git init failed (git may not be installed)`)}console.log(`
|
|
15
|
-
Fullstack workspace scaffolded!`),console.log(),O(`Next steps:`),O(` cd ${p}`),l.installDeps||O(` ${E} install`),E===`pnpm`?O(` pnpm dev # runs server (kick dev) + web (vite) together`):(O(` ${E} run dev:server # terminal 1`),O(` ${E} run dev:web # terminal 2`)),O(``),C===`vite`?(O(`web/ is create-vite output, unwired. To type it against the API:`),O(` ${f}`)):(O(`The web app calls the API through @forinda/kickjs-client —`),O("edit server/src/modules/hello, run `kick typegen` in server/, and"),O(`web/src/App.tsx's types follow.`)),O(``)}function _(e,t){let n=e=>t[e]??`latest`;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":n(`@forinda/kickjs-client`),react:n(`react`),"react-dom":n(`react-dom`)},devDependencies:{"@types/react":n(`@types/react`),"@types/react-dom":n(`@types/react-dom`),"@vitejs/plugin-react":n(`@vitejs/plugin-react`),typescript:n(`typescript`),vite:n(`vite`)}},null,2)}\n`}function v(e,t,n,r=l(t)){let i=t===`pnpm`?{dev:`pnpm --parallel -r run dev`,start:`pnpm --filter ./server run start`,"dev:server":`pnpm --filter ./server dev`,"dev:web":`pnpm --filter ./web dev`,build:`pnpm --filter ./server exec kick typegen && pnpm -r run build`,"build:netlify":`pnpm build && pnpm --filter ./server exec kick build:netlify`,"build:vercel":`pnpm build && pnpm --filter ./server exec kick build:vercel`,typecheck:`kick typecheck --cwd server && kick typecheck --cwd web`}:{start:`cd server && ${t} run start`,"dev:server":`cd server && ${t} run dev`,"dev:web":`cd web && ${t} run dev`,build:`cd server && ${t} exec kick typegen && cd .. && ${t} run build:server && ${t} run build:web`,"build:netlify":`${t} run build && cd server && ${t} exec kick build:netlify`,"build:vercel":`${t} run build && cd server && ${t} exec kick build:vercel`,"build:server":`cd server && ${t} run build`,"build:web":`cd web && ${t} run build`,typecheck:`kick typecheck --cwd server && kick typecheck --cwd web`};return`${JSON.stringify({name:e,private:!0,version:`0.0.0`,type:`module`,...r?{packageManager:r}:{},scripts:i,devDependencies:{"@forinda/kickjs-cli":n},workspaces:[`server`,`web`]},null,2)}\n`}function y(e,t,n=`kick`){let r=`# ${e}
|
|
16
|
-
|
|
17
|
-
Fullstack KickJS workspace — typed end to end.
|
|
18
|
-
|
|
19
|
-
| Package | What |
|
|
20
|
-
| --------- | ----------------------------------------------------------------- |
|
|
21
|
-
| \`server/\` | KickJS API (decorators, DI, \`kick dev\` with typegen watch) |
|
|
22
|
-
| \`web/\` | Vite + React, typed against the API via \`@forinda/kickjs-client\` |
|
|
23
|
-
|
|
24
|
-
## Develop
|
|
25
|
-
|
|
26
|
-
\`\`\`bash
|
|
27
|
-
${t} install
|
|
28
|
-
${t===`pnpm`?`pnpm dev # server (kick dev) + web (vite), in parallel`:`${t} run dev:server # terminal 1\n${t} run dev:web # terminal 2`}
|
|
29
|
-
\`\`\`
|
|
30
|
-
|
|
31
|
-
Server: http://localhost:3000 · Web: http://localhost:5173 (Vite proxies \`/api\`).
|
|
32
|
-
|
|
33
|
-
## The type loop
|
|
34
|
-
|
|
35
|
-
1. Server handlers **return** their payloads (\`return this.service.greet(...)\`).
|
|
36
|
-
2. \`kick typegen\` emits \`server/.kickjs/types/kick__client.d.ts\` — the flat
|
|
37
|
-
route map with every response type resolved to a literal shape.
|
|
38
|
-
3. \`web/tsconfig.json\` lists that file in \`types\`, so \`KickClientApi\` is
|
|
39
|
-
ambient — no import, no bridge file.
|
|
40
|
-
4. \`web/src/api.ts\`'s \`createClient<KickClientApi.Api>\` types every call site.
|
|
41
|
-
|
|
42
|
-
Because the map holds resolved types rather than references to controllers,
|
|
43
|
-
\`web\` never compiles server source: no \`experimentalDecorators\`, no path
|
|
44
|
-
aliases into \`server/src\`.
|
|
45
|
-
|
|
46
|
-
Rename a field in \`server/src/modules/hello/hello.service.ts\` → \`web/src/App.tsx\`
|
|
47
|
-
stops compiling. That's the point.
|
|
48
|
-
|
|
49
|
-
### Keeping the map fresh
|
|
50
|
-
|
|
51
|
-
\`server/.kickjs/types/kick__client.d.ts\` is generated, and \`web\` reads it as
|
|
52
|
-
an ambient type package. Two things follow.
|
|
53
|
-
|
|
54
|
-
**\`kick dev\` writes it at startup, not on save.** Resolving it builds a whole TypeScript
|
|
55
|
-
program over the server, which is a build-step cost rather than a per-save one,
|
|
56
|
-
so a renamed response field surfaces on the next \`kick typegen\` rather than on
|
|
57
|
-
save. Everything else in \`.kickjs/types\` still updates on save. Add
|
|
58
|
-
\`kick typegen --check\` to CI and a stale map fails the build.
|
|
59
|
-
|
|
60
|
-
**It needs a compiler API.** TypeScript 7 ships none, so \`server\` depends on
|
|
61
|
-
\`@typescript/typescript6\`. Remove it and typegen skips this one file, saying
|
|
62
|
-
so; \`web\` then reports \`TS2688\` because the file it lists in \`types\` is gone.
|
|
63
|
-
|
|
64
|
-
### The other way to wire it
|
|
65
|
-
|
|
66
|
-
A \`types\` entry says "this is a global type package", which is what the map is,
|
|
67
|
-
and it fails loudly when the file is missing. If you would rather it be quiet
|
|
68
|
-
when absent — say, a repo where the map is not always generated — use
|
|
69
|
-
\`include\` instead:
|
|
70
|
-
|
|
71
|
-
\`\`\`json
|
|
72
|
-
{ "include": ["src", "../server/.kickjs/types/kick__client.d.ts"] }
|
|
73
|
-
\`\`\`
|
|
74
|
-
|
|
75
|
-
That tolerates the file not existing, at the cost of \`KickClientApi\` silently
|
|
76
|
-
not resolving. Note \`types\` replaces TypeScript's automatic \`@types\`
|
|
77
|
-
inclusion, so if you add entries there, list the ones you rely on too
|
|
78
|
-
(\`"types": ["node", "../server/.kickjs/types/kick__client"]\`).
|
|
79
|
-
|
|
80
|
-
Or skip the global entirely — the same file exports the type:
|
|
81
|
-
|
|
82
|
-
\`\`\`ts
|
|
83
|
-
import type { Api } from '../../server/.kickjs/types/kick__client'
|
|
84
|
-
|
|
85
|
-
export const api = createClient<Api>({ baseUrl: '/api/v1' })
|
|
86
|
-
\`\`\`
|
|
87
|
-
|
|
88
|
-
Docs: https://kickjs.app/guide/typed-client.html
|
|
89
|
-
`;if(n!==`vite`)return r;let i=r.indexOf(`## The type loop`);return`${r.slice(0,i).replace("Vite + React, typed against the API via `@forinda/kickjs-client`",`create-vite scaffold — unwired (see below) `).replace(" (Vite proxies `/api`)",``)}## Wiring web/ to the API
|
|
90
|
-
|
|
91
|
-
\`web/\` is whatever create-vite scaffolded; nothing connects it to the API yet.
|
|
92
|
-
Four steps — typed client, \`/api\` dev proxy, route-map types, \`src/api.ts\`:
|
|
93
|
-
|
|
94
|
-
${f}
|
|
95
|
-
`}export{m as DEFAULT_VITE_TEMPLATE,p as VITE_TEMPLATES,g as initFullstackProject};
|
|
96
|
-
//# sourceMappingURL=fullstack-bVcLaFbj.mjs.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"fullstack-bVcLaFbj.mjs","names":["writeFileSafe","approveInstallScripts","runCommand","renderLayers","fillVars","generateDockerignore","resolveSiblingVersions","generateDockerfile","initProject","packageManagerSpec","FRONTEND_WIRING_URL","VITE_TEMPLATES","DEFAULT_VITE_TEMPLATE","createViteCommand","flags","template","pm","dir","initFullstackProject","options","pmValid","packageManager","directory","log","msg","name","versions","server","join","frontend","viteTemplate","file","args","webPackageJson","rootPackageJson","layers","files","path","contents","rootReadme","n","generateAgentDocs","runTypegen","execFileSync","dep","pkg","scripts","pmSpec","cliVersion","readme","typeLoop"],"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 KickClientApi.Api\n//\n// The type loop: server controllers use return-value handlers → `kick\n// typegen` (run here once, then by the root `build` script and `kick dev` startup — not on save) emits\n// server/.kickjs/types/kick__client.d.ts → web tsconfig `types` (ambient)\n// side-effect-imports that file (type-only, erased at runtime) → the web\n// client calls `api.get('/hello')` with the handler's actual response type.\n\nimport { join } from 'node:path'\nimport { execFileSync } from 'node:child_process'\n\nimport { writeFileSafe } from '../utils/fs'\nimport { packageManagerSpec } from './templates/project-config'\nimport { generateDockerfile, generateDockerignore } from './templates/docker'\nimport { runCommand } from '../utils/shell'\nimport { initProject, resolveSiblingVersions } from './project'\nimport { approveInstallScripts } from '../commands/add'\nimport { fillVars, renderLayers } from '../scaffold/overlay'\n\n/** Wiring a frontend we did not scaffold: typed client, proxy, route types. */\nexport const FRONTEND_WIRING_URL = 'https://kickjs.app/guide/fullstack-frontend.html'\n\n/**\n * create-vite's TypeScript templates, in the order it lists them. Only the\n * `-ts` half: the wiring is typed — the route map is a `.d.ts` and the client\n * is `createClient<KickClientApi.Api>` — so a JavaScript template would leave\n * the reader following a guide that cannot apply.\n */\nexport const VITE_TEMPLATES = [\n { value: 'react-ts', label: 'React' },\n { value: 'react-compiler-ts', label: 'React + Compiler' },\n { value: 'vue-ts', label: 'Vue' },\n { value: 'svelte-ts', label: 'Svelte' },\n { value: 'solid-ts', label: 'Solid' },\n { value: 'preact-ts', label: 'Preact' },\n { value: 'lit-ts', label: 'Lit' },\n { value: 'qwik-ts', label: 'Qwik' },\n { value: 'vanilla-ts', label: 'Vanilla' },\n] as const\n\nexport const DEFAULT_VITE_TEMPLATE = 'react-ts'\n\n/**\n * How each package manager runs create-vite, with the framework decided here\n * rather than by its prompts:\n *\n * - `--template` picks a TypeScript template, so the wiring guide applies;\n * - `--no-interactive` means it never waits for input (CI, `--yes`);\n * - `--no-immediate` stops it installing and launching a dev server — the\n * workspace install happens once, at the root, after this returns.\n */\nexport function createViteCommand(\n pm: 'pnpm' | 'npm' | 'yarn' | 'bun',\n dir: string,\n template: string = DEFAULT_VITE_TEMPLATE,\n): string[] {\n const flags = ['--template', template, '--no-interactive', '--no-immediate']\n // yarn and bun resolve `create vite` to create-vite themselves; npm and pnpm\n // take the versioned package name, and npm needs `--` before the flags or it\n // eats them itself.\n if (pm === 'yarn' || pm === 'bun') return [pm, 'create', 'vite', dir, ...flags]\n if (pm === 'npm') return [pm, 'create', 'vite@latest', dir, '--', ...flags]\n return [pm, 'create', 'vite@latest', dir, ...flags]\n}\n\nexport interface InitFullstackOptions {\n name: string\n directory: string\n packageManager?: 'pnpm' | 'npm' | 'yarn' | 'bun'\n /**\n * Who scaffolds `web/`. `'kick'` writes the wired React app (typed client,\n * dev proxy, route-map types). `'vite'` hands the directory to\n * `create-vite` and wires nothing — you pick the framework, and the guide\n * at {@link FRONTEND_WIRING_URL} covers connecting it.\n */\n frontend?: 'kick' | 'vite'\n /** create-vite template for `frontend: 'vite'`. Default `react-ts`. */\n viteTemplate?: string\n initGit?: boolean\n installDeps?: boolean\n schemaLib?: 'zod' | 'valibot' | 'yup'\n runtime?: 'express' | 'fastify' | 'h3'\n /** Optional packages (`--packages`), wired into the server like a plain scaffold. */\n packages?: string[]\n}\n\nexport async function initFullstackProject(options: InitFullstackOptions): Promise<void> {\n const {\n name,\n directory,\n schemaLib = 'zod',\n runtime = 'express',\n packages = [],\n frontend = 'kick',\n viteTemplate = DEFAULT_VITE_TEMPLATE,\n } = options\n // `--pm` arrives as a free CLI string — allowlist before it reaches a\n // process invocation (execFileSync takes an argv array, no shell, but a\n // bogus binary name is still a confusing failure).\n const pmValid = (['pnpm', 'npm', 'yarn', 'bun'] as const).includes(\n options.packageManager as never,\n )\n const packageManager = pmValid\n ? (options.packageManager as 'pnpm' | 'npm' | 'yarn' | 'bun')\n : 'pnpm'\n const dir = directory\n const log = (msg: string) => console.log(` ${msg}`)\n if (options.packageManager !== undefined && !pmValid) {\n log(\n `Warning: unknown package manager '${String(options.packageManager)}' — falling back to pnpm.`,\n )\n }\n\n console.log(`\\n Creating fullstack KickJS workspace: ${name}\\n`)\n\n // One map for both packages: the workspace shares a toolchain, so server/\n // and web/ must not end up on different vite or TypeScript majors.\n console.log(' Resolving package versions...')\n const versions = await resolveSiblingVersions()\n\n // ── server/ — the standard scaffold, deferred install/git ──────────\n const server = await initProject({\n name: `${name}-server`,\n directory: join(dir, 'server'),\n packageManager,\n template: 'minimal',\n schemaLib,\n runtime,\n packages,\n // The client route map web/ reads (with the compiler API it needs), and a\n // strict port — web/vite.config.ts proxies /api to it, so moving to\n // another port would silently reach the wrong process.\n extraLayers: ['server-fullstack'],\n // server/ is a workspace member; the root records the approvals.\n approveInstallScripts: false,\n // netlify.toml / vercel.json live at the workspace root, written below.\n platformConfig: false,\n // Root owns install + git so the lockfile/commit cover the workspace.\n initGit: false,\n installDeps: false,\n // Production single-origin serving. `web/` builds to `web/dist`, and\n // nothing served it before — `pnpm build` produced a frontend the API had\n // no way to hand out, so every deploy needed a hand-wired static host or\n // a second process. The adapter is inert until `../web/dist` exists, so\n // `dev` (Vite serves the client and proxies /api here) is untouched.\n spaClientDir: '../web/dist',\n versions,\n })\n\n // ── web/ — either our wired React app, or whatever create-vite makes ──\n if (frontend === 'vite') {\n // create-vite scaffolds it with the chosen TypeScript template. Nothing\n // is patched afterwards: a scaffold we didn't write is not ours to\n // rewrite, and the wiring is four steps in the guide.\n console.log(`\\n Handing web/ to create-vite (${viteTemplate})...\\n`)\n const [file, ...args] = createViteCommand(packageManager, 'web', viteTemplate)\n runCommand(file!, args, { cwd: dir })\n } else {\n // The wired React app (typed client, dev proxy, route-map types): its\n // package.json here, its files from the web-kick layer below.\n await writeFileSafe(join(dir, 'web/package.json'), webPackageJson(name, versions))\n }\n\n // ── workspace root ──────────────────────────────────────────────────\n await writeFileSafe(\n join(dir, 'package.json'),\n rootPackageJson(name, packageManager, versions['@forinda/kickjs-cli']),\n )\n // Only pnpm reads this file. npm / yarn / bun declare workspaces via the\n // `workspaces` field in the root package.json instead — see rootPackageJson.\n if (packageManager === 'pnpm') {\n await writeFileSafe(join(dir, 'pnpm-workspace.yaml'), 'packages:\\n - server\\n - web\\n')\n }\n // Before install, at the root every package manager reads them from.\n approveInstallScripts(packageManager, dir, server.builds)\n // .gitignore, and netlify.toml / vercel.json at the root both platforms\n // build from; plus the kick web app's files under web/.\n const layers = ['fullstack-root', ...(frontend === 'vite' ? [] : ['web-kick'])]\n const files = fillVars(renderLayers(layers).files, { name, packageManager })\n for (const [path, contents] of files) {\n await writeFileSafe(join(dir, path), contents)\n }\n await writeFileSafe(join(dir, 'README.md'), rootReadme(name, packageManager, frontend))\n await writeFileSafe(\n join(dir, 'Dockerfile'),\n generateDockerfile('fullstack', packageManager, name),\n )\n await writeFileSafe(join(dir, '.dockerignore'), generateDockerignore())\n\n // Workspace-root agent docs (CLAUDE.md + .agents/) flavored for the\n // fullstack layout — the server/ subdir keeps its own generated set.\n const { generateAgentDocs } = await import('./agent-docs')\n await generateAgentDocs({\n outDir: dir,\n name,\n pm: packageManager,\n template: 'fullstack',\n only: 'all',\n force: true,\n })\n\n // ── install (root — covers both workspace packages) ────────────────\n if (options.installDeps) {\n console.log(`\\n Installing workspace dependencies with ${packageManager}...\\n`)\n try {\n // `runCommand`, not bare execFileSync — on Windows every package\n // manager is a `.cmd` shim that execFileSync cannot spawn.\n runCommand(packageManager, ['install'], { cwd: dir })\n } catch {\n console.log(`\\n Warning: ${packageManager} install failed. Run it manually.`)\n }\n }\n\n // ── typegen (server) so web's KickClientApi.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 typegen` in server/ (or the root `build`) writes it later.\n }\n\n // ── git (root) ──────────────────────────────────────────────────────\n if (options.initGit) {\n try {\n execFileSync('git', ['init'], { cwd: dir, stdio: 'pipe' })\n execFileSync('git', ['branch', '-M', 'main'], { cwd: dir, stdio: 'pipe' })\n execFileSync('git', ['add', '-A'], { cwd: dir, stdio: 'pipe' })\n execFileSync('git', ['commit', '-m', 'chore: initial commit from kick new (fullstack)'], {\n cwd: dir,\n stdio: 'pipe',\n })\n log('Git repository initialized')\n } catch {\n log('Warning: git init failed (git may not be installed)')\n }\n }\n\n console.log('\\n Fullstack workspace scaffolded!')\n console.log()\n log('Next steps:')\n log(` cd ${name}`)\n if (!options.installDeps) log(` ${packageManager} install`)\n if (packageManager === 'pnpm') {\n log(' pnpm dev # runs server (kick dev) + web (vite) together')\n } else {\n log(` ${packageManager} run dev:server # terminal 1`)\n log(` ${packageManager} run dev:web # terminal 2`)\n }\n log('')\n if (frontend === 'vite') {\n // Nothing in web/ knows about the API yet — say so, and say where the\n // four wiring steps live rather than half-wiring someone else's scaffold.\n log('web/ is create-vite output, unwired. To type it against the API:')\n log(` ${FRONTEND_WIRING_URL}`)\n } else {\n log('The web app calls the API through @forinda/kickjs-client —')\n log('edit server/src/modules/hello, run `kick typegen` in server/, and')\n log(\"web/src/App.tsx's types follow.\")\n }\n log('')\n}\n\n// ── web templates ─────────────────────────────────────────────────────\n\nfunction webPackageJson(name: string, versions: Record<string, string>): string {\n // Every range here is resolved at scaffold time — see THIRD_PARTY_PACKAGES.\n const dep = (pkg: string) => versions[pkg] ?? 'latest'\n return `${JSON.stringify(\n {\n name: `${name}-web`,\n private: true,\n version: '0.0.0',\n type: 'module',\n scripts: {\n dev: 'vite',\n build: 'tsc --noEmit && vite build',\n preview: 'vite preview',\n typecheck: 'tsc --noEmit',\n },\n dependencies: {\n '@forinda/kickjs-client': dep('@forinda/kickjs-client'),\n react: dep('react'),\n 'react-dom': dep('react-dom'),\n },\n devDependencies: {\n '@types/react': dep('@types/react'),\n '@types/react-dom': dep('@types/react-dom'),\n '@vitejs/plugin-react': dep('@vitejs/plugin-react'),\n // Same majors as the server package: one workspace, one toolchain.\n typescript: dep('typescript'),\n vite: dep('vite'),\n },\n },\n null,\n 2,\n )}\\n`\n}\n\n// ── root templates ────────────────────────────────────────────────────\n\nfunction rootPackageJson(\n name: string,\n pm: string,\n cliVersion: string,\n pmSpec = packageManagerSpec(pm),\n): string {\n const scripts: Record<string, string> =\n pm === 'pnpm'\n ? {\n dev: 'pnpm --parallel -r run dev',\n // One origin: the server serves `web/dist` through SpaAdapter.\n start: 'pnpm --filter ./server run start',\n 'dev:server': 'pnpm --filter ./server dev',\n 'dev:web': 'pnpm --filter ./web dev',\n // Typegen first: web's `tsc` reads server/.kickjs/types, which is\n // git-ignored, so a fresh clone (CI, Netlify, Vercel) has none and\n // `pnpm -r run build` races the two packages anyway.\n build: 'pnpm --filter ./server exec kick typegen && pnpm -r run build',\n 'build:netlify': 'pnpm build && pnpm --filter ./server exec kick build:netlify',\n 'build:vercel': 'pnpm build && pnpm --filter ./server exec kick build:vercel',\n // No `npx`: the binary is `kick` but the package is\n // `@forinda/kickjs-cli`, so npx cannot map one to the other and\n // falls back to the REGISTRY — where `kick` is an unrelated\n // AngularJS scaffolder. It runs, prints its own help, and exits 0,\n // so this script would pass without type-checking anything.\n //\n // Every package manager puts `node_modules/.bin` on PATH for\n // scripts, so the bare name resolves locally, and a missing install\n // fails loudly instead of fetching a stranger.\n typecheck: 'kick typecheck --cwd server && kick typecheck --cwd web',\n }\n : {\n // cd-based scripts — the one form npm, yarn (classic AND berry),\n // and bun all run identically; workspace-filter flags differ per\n // manager (--workspace vs `yarn workspace <name>` vs --filter).\n start: `cd server && ${pm} run start`,\n 'dev:server': `cd server && ${pm} run dev`,\n 'dev:web': `cd web && ${pm} run dev`,\n // Typegen first — see the pnpm branch above.\n build: `cd server && ${pm} exec kick typegen && cd .. && ${pm} run build:server && ${pm} run build:web`,\n 'build:netlify': `${pm} run build && cd server && ${pm} exec kick build:netlify`,\n 'build:vercel': `${pm} run build && cd server && ${pm} exec kick build:vercel`,\n 'build:server': `cd server && ${pm} run build`,\n 'build:web': `cd web && ${pm} run build`,\n // No `npx`: the binary is `kick` but the package is\n // `@forinda/kickjs-cli`, so npx cannot map one to the other and\n // falls back to the REGISTRY — where `kick` is an unrelated\n // AngularJS scaffolder. It runs, prints its own help, and exits 0,\n // so this script would pass without type-checking anything.\n //\n // Every package manager puts `node_modules/.bin` on PATH for\n // scripts, so the bare name resolves locally, and a missing install\n // fails loudly instead of fetching a stranger.\n typecheck: 'kick typecheck --cwd server && kick typecheck --cwd web',\n }\n return `${JSON.stringify(\n {\n name,\n private: true,\n version: '0.0.0',\n type: 'module',\n ...(pmSpec ? { packageManager: pmSpec } : {}),\n scripts,\n // The CLI is a ROOT dependency so the bare `kick` in the scripts above\n // resolves: package managers put `node_modules/.bin` on PATH for\n // scripts, and the CLI otherwise lives only in `server/node_modules`.\n devDependencies: { '@forinda/kickjs-cli': cliVersion },\n workspaces: ['server', 'web'],\n },\n null,\n 2,\n )}\\n`\n}\n\nexport function rootReadme(name: string, pm: string, frontend: 'kick' | 'vite' = 'kick'): string {\n const readme = `# ${name}\n\nFullstack KickJS workspace — typed end to end.\n\n| Package | What |\n| --------- | ----------------------------------------------------------------- |\n| \\`server/\\` | KickJS API (decorators, DI, \\`kick dev\\` with typegen watch) |\n| \\`web/\\` | Vite + React, typed against the API via \\`@forinda/kickjs-client\\` |\n\n## Develop\n\n\\`\\`\\`bash\n${pm} install\n${pm === 'pnpm' ? 'pnpm dev # server (kick dev) + web (vite), in parallel' : `${pm} run dev:server # terminal 1\\n${pm} run dev:web # terminal 2`}\n\\`\\`\\`\n\nServer: http://localhost:3000 · Web: http://localhost:5173 (Vite proxies \\`/api\\`).\n\n## The type loop\n\n1. Server handlers **return** their payloads (\\`return this.service.greet(...)\\`).\n2. \\`kick typegen\\` emits \\`server/.kickjs/types/kick__client.d.ts\\` — the flat\n route map with every response type resolved to a literal shape.\n3. \\`web/tsconfig.json\\` lists that file in \\`types\\`, so \\`KickClientApi\\` is\n ambient — no import, no bridge file.\n4. \\`web/src/api.ts\\`'s \\`createClient<KickClientApi.Api>\\` types every call site.\n\nBecause the map holds resolved types rather than references to controllers,\n\\`web\\` never compiles server source: no \\`experimentalDecorators\\`, no path\naliases into \\`server/src\\`.\n\nRename a field in \\`server/src/modules/hello/hello.service.ts\\` → \\`web/src/App.tsx\\`\nstops compiling. That's the point.\n\n### Keeping the map fresh\n\n\\`server/.kickjs/types/kick__client.d.ts\\` is generated, and \\`web\\` reads it as\nan ambient type package. Two things follow.\n\n**\\`kick dev\\` writes it at startup, not on save.** Resolving it builds a whole TypeScript\nprogram over the server, which is a build-step cost rather than a per-save one,\nso a renamed response field surfaces on the next \\`kick typegen\\` rather than on\nsave. Everything else in \\`.kickjs/types\\` still updates on save. Add\n\\`kick typegen --check\\` to CI and a stale map fails the build.\n\n**It needs a compiler API.** TypeScript 7 ships none, so \\`server\\` depends on\n\\`@typescript/typescript6\\`. Remove it and typegen skips this one file, saying\nso; \\`web\\` then reports \\`TS2688\\` because the file it lists in \\`types\\` is gone.\n\n### The other way to wire it\n\nA \\`types\\` entry says \"this is a global type package\", which is what the map is,\nand it fails loudly when the file is missing. If you would rather it be quiet\nwhen absent — say, a repo where the map is not always generated — use\n\\`include\\` instead:\n\n\\`\\`\\`json\n{ \"include\": [\"src\", \"../server/.kickjs/types/kick__client.d.ts\"] }\n\\`\\`\\`\n\nThat tolerates the file not existing, at the cost of \\`KickClientApi\\` silently\nnot resolving. Note \\`types\\` replaces TypeScript's automatic \\`@types\\`\ninclusion, so if you add entries there, list the ones you rely on too\n(\\`\"types\": [\"node\", \"../server/.kickjs/types/kick__client\"]\\`).\n\nOr skip the global entirely — the same file exports the type:\n\n\\`\\`\\`ts\nimport type { Api } from '../../server/.kickjs/types/kick__client'\n\nexport const api = createClient<Api>({ baseUrl: '/api/v1' })\n\\`\\`\\`\n\nDocs: https://kickjs.app/guide/typed-client.html\n`\n\n if (frontend !== 'vite') return readme\n\n // create-vite's output is not ours to describe: it has no typed client, no\n // proxy and no route-map types until the reader wires them. Everything from\n // \"The type loop\" on is about files that do not exist in that scaffold.\n const typeLoop = readme.indexOf('## The type loop')\n return `${readme\n .slice(0, typeLoop)\n .replace(\n 'Vite + React, typed against the API via `@forinda/kickjs-client`',\n 'create-vite scaffold — unwired (see below) ',\n )\n .replace(' (Vite proxies `/api`)', '')}## Wiring web/ to the API\n\n\\`web/\\` is whatever create-vite scaffolded; nothing connects it to the API yet.\nFour steps — typed client, \\`/api\\` dev proxy, route-map types, \\`src/api.ts\\`:\n\n${FRONTEND_WIRING_URL}\n`\n}\n"],"mappings":"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"}
|
|
@@ -1,113 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @forinda/kickjs-cli v8.10.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,t}from"./config-DO4J2xgV.mjs";import{r as n}from"./fs-CT9PRuSw.mjs";import{existsSync as r,readFileSync as i,readdirSync as a,statSync as o,writeFileSync as s}from"node:fs";import{dirname as c,join as l,posix as u,resolve as d,sep as f}from"node:path";import{fileURLToPath as p}from"node:url";import{execFile as m,execFileSync as h,execSync as g,spawnSync as _}from"node:child_process";import{promisify as v}from"node:util";import{randomBytes as y}from"node:crypto";import{parseSync as b}from"oxc-parser";const x=v(m),S=/[&|<>^"'`(){}[\];!%\r\n\\]/;function C(e,t,n=process.platform){if(n!==`win32`)return[e,t];if(S.test(e)||t.some(e=>S.test(e)))return null;let r=[e,...t].map(e=>e.includes(` `)?`"${e}"`:e).join(` `);return[process.env.ComSpec||`cmd.exe`,[`/d`,`/s`,`/c`,r]]}function w(e,t,n={}){let r=C(e,t);if(!r)return null;try{return h(r[0],r[1],{encoding:`utf-8`,timeout:n.timeout??5e3,cwd:n.cwd,stdio:[`ignore`,`pipe`,`ignore`],windowsHide:!0}).toString().trim()||null}catch{return null}}function ee(e,t,n={}){let r=C(e,t);if(!r)throw Error(`Refusing to run '${e}': unsafe arguments`);h(r[0],r[1],{cwd:n.cwd,stdio:`inherit`,windowsHide:!0})}function te(e,t,n){g(e,{cwd:t,stdio:`inherit`,env:n?{...process.env,...n}:process.env})}function ne(e,t,n){let r=_(process.execPath,[e],{cwd:n,stdio:`inherit`,env:{...process.env,...t}});r.status!==0&&process.exit(r.status??1)}async function re(e,t,n={}){let r=C(e,t);if(!r)return null;try{let{stdout:e}=await x(r[0],r[1],{encoding:`utf-8`,timeout:n.timeout??5e3,cwd:n.cwd,windowsHide:!0});return e.toString().trim()||null}catch{return null}}const ie=c(p(import.meta.url)),T=[l(ie,`..`,`templates`),l(ie,`..`,`..`,`templates`)].find(e=>r(l(e,`base`)));function ae(e){return e.split(`/`).map(e=>e.startsWith(`_dot_`)?`.${e.slice(5)}`:e).join(`/`)}function E(e,t={}){let n=t.templatesDir??T,s=/* @__PURE__ */ new Map,c=[],u=[],d={},p=[],m={};for(let t of e){let e=l(n,t);if(!r(e))throw Error(`Unknown scaffold layer "${t}" (${e})`);let h=l(e,`feature.json`);if(r(h)){let e=JSON.parse(i(h,`utf-8`));c.push(...e.dependencies??[]),u.push(...e.devDependencies??[]),Object.assign(d,e.builds),p.push(...e.integrations??[]),Object.assign(m,e.scripts)}let g=l(e,`files`);if(r(g))for(let e of a(g,{recursive:!0,encoding:`utf-8`}).toSorted()){let t=l(g,e);if(!o(t).isFile())continue;let n=i(t,`utf-8`),r=ae(e.split(f).join(`/`));if(r.endsWith(`.append`)){let e=r.slice(0,-7);s.set(e,(s.get(e)??``)+n)}else s.set(r,n)}}p.push(...t.extra??[]);let h=t.vars??{},g=e=>e.replace(/\{\{(\w+)\}\}/g,(e,t)=>h[t]??e);for(let[e,t]of s)t.includes(`// @kick:`)&&s.set(e,oe(t,p,g));return{files:s,dependencies:[...new Set(c)],devDependencies:[...new Set(u)],builds:d,integrations:p,scripts:m}}function D(e,t){let n=e=>e.replace(/\{\{(\w+)\}\}/g,(e,n)=>n in t?t[n]:e);return new Map([...e].map(([e,t])=>[e,n(t)]))}const O=/^([ \t]*)\/\/ @kick:([\w-]+)[ \t]*$/;function oe(e,t,n=e=>e){let r=e.split(`
|
|
12
|
-
`),i=new Set(r.map(e=>O.exec(e)?.[2]).filter(Boolean)),a=t.filter(e=>!e.slot||i.has(e.slot)),o=[];for(let e=0;e<r.length;e++){let t=O.exec(r[e]);if(!t){o.push(r[e]);continue}let[,i,s]=t,c=s===`imports`?ce(a.flatMap(e=>e.import?[e.import]:[])):a.filter(e=>e.slot===s&&e.code).map(e=>se(`${n(e.code)},`,i));c.length>0?o.push(...c):o.at(-1)?.trimEnd().endsWith(`[`)&&r[e+1]?.trim().startsWith(`]`)&&(o.pop(),e++)}return o.join(`
|
|
13
|
-
`)}function se(e,t){return e.split(`
|
|
14
|
-
`).map(e=>e&&t+e).join(`
|
|
15
|
-
`)}function ce(e){let t=/* @__PURE__ */ new Map;for(let n of e){let e=t.get(n.from)??{names:[]};e.default??=n.default;for(let t of n.names??[])e.names.includes(t)||e.names.push(t);t.set(n.from,e)}return[...t].map(([e,{names:t,default:n}])=>{let r=`import ${[n,t.length?`{ ${t.join(`, `)} }`:void 0].filter(Boolean).join(`, `)} from '${e}'`;return r.length<=100||t.length===0?r:`import ${n?`${n}, `:``}{\n${t.map(e=>` ${e},`).join(`
|
|
16
|
-
`)}\n} from '${e}'`})}const k=`node:22-slim`,le={pnpm:{lockfile:`pnpm-lock.yaml`,installFiles:[`pnpm-workspace.yaml`],install:`pnpm install --frozen-lockfile`,installProd:`pnpm install --prod --frozen-lockfile`,run:e=>`pnpm run ${e}`,image:k,setup:`RUN corepack enable`},npm:{lockfile:`package-lock.json`,installFiles:[],install:`npm ci`,installProd:`npm ci --omit=dev`,run:e=>`npm run ${e}`,image:k},yarn:{lockfile:`yarn.lock`,installFiles:[],install:`yarn install --frozen-lockfile`,installProd:`yarn install --production --frozen-lockfile`,run:e=>`yarn run ${e}`,image:k,setup:`RUN corepack enable`},bun:{lockfile:`bun.lock`,installFiles:[],install:`bun install --frozen-lockfile`,installProd:`bun install --production --frozen-lockfile`,run:e=>`bun run ${e}`,image:`oven/bun:1`}},ue={api:`docker run -p 3000:3000 <name>`,inertia:`docker run -p 3000:3000 -e SESSION_SECRET=<a long random string> <name>`,fullstack:`docker run -p 3000:3000 <name>`};function A(e,t,n){let r=le[t],i=r.setup?`\n${r.setup}`:``,a=(e===`fullstack`?[`package.json`,r.lockfile,...r.installFiles,`server/package.json`,`web/package.json`]:[`package.json`,r.lockfile,...r.installFiles]).map(e=>`COPY ${e} ./${e.includes(`/`)?e.slice(0,e.lastIndexOf(`/`)+1):``}`).join(`
|
|
17
|
-
`),o=`# syntax=docker/dockerfile:1
|
|
18
|
-
# ${n} — the long-running server in one image.
|
|
19
|
-
#
|
|
20
|
-
# docker build -t ${n} .
|
|
21
|
-
# ${ue[e].replace(`<name>`,n)}
|
|
22
|
-
#
|
|
23
|
-
# Environment comes from the platform or \`docker run\`; .env files are not
|
|
24
|
-
# copied into the image. The lockfile must be committed — installs are frozen.
|
|
25
|
-
`;if(e===`fullstack`)return`${o}
|
|
26
|
-
FROM ${r.image} AS base
|
|
27
|
-
WORKDIR /app${i}
|
|
28
|
-
|
|
29
|
-
# Production dependencies of every workspace member.
|
|
30
|
-
FROM base AS deps
|
|
31
|
-
${a}
|
|
32
|
-
RUN ${r.installProd}
|
|
33
|
-
# Hoisting may leave a member without its own node_modules; the runtime copies both.
|
|
34
|
-
RUN mkdir -p node_modules server/node_modules
|
|
35
|
-
|
|
36
|
-
# The server bundle and the built web app.
|
|
37
|
-
FROM base AS build
|
|
38
|
-
${a}
|
|
39
|
-
RUN ${r.install}
|
|
40
|
-
COPY . .
|
|
41
|
-
RUN ${r.run(`build`)}
|
|
42
|
-
|
|
43
|
-
FROM ${k}
|
|
44
|
-
ENV NODE_ENV=production PORT=3000
|
|
45
|
-
WORKDIR /app
|
|
46
|
-
COPY --from=deps /app/node_modules ./node_modules
|
|
47
|
-
COPY --from=deps /app/server/node_modules ./server/node_modules
|
|
48
|
-
COPY --from=build /app/package.json ./
|
|
49
|
-
COPY --from=build /app/server/package.json ./server/
|
|
50
|
-
COPY --from=build /app/server/dist ./server/dist
|
|
51
|
-
# SpaAdapter serves ../web/dist relative to the server.
|
|
52
|
-
COPY --from=build /app/web/dist ./web/dist
|
|
53
|
-
WORKDIR /app/server
|
|
54
|
-
USER node
|
|
55
|
-
EXPOSE 3000
|
|
56
|
-
CMD ["node", "dist/index.js"]
|
|
57
|
-
`;let s=e===`inertia`?`# The server, the pages (dist/client) and the SSR bundle (dist/ssr).`:`# The server bundle.`;return`${o}
|
|
58
|
-
FROM ${r.image} AS base
|
|
59
|
-
WORKDIR /app${i}
|
|
60
|
-
|
|
61
|
-
FROM base AS deps
|
|
62
|
-
${a}
|
|
63
|
-
RUN ${r.installProd}
|
|
64
|
-
|
|
65
|
-
${s}
|
|
66
|
-
FROM base AS build
|
|
67
|
-
${a}
|
|
68
|
-
RUN ${r.install}
|
|
69
|
-
COPY . .
|
|
70
|
-
RUN ${r.run(`build`)}
|
|
71
|
-
|
|
72
|
-
FROM ${k}
|
|
73
|
-
ENV NODE_ENV=production PORT=3000
|
|
74
|
-
WORKDIR /app
|
|
75
|
-
COPY --from=deps /app/node_modules ./node_modules
|
|
76
|
-
COPY --from=build /app/package.json ./
|
|
77
|
-
COPY --from=build /app/dist ./dist
|
|
78
|
-
USER node
|
|
79
|
-
EXPOSE 3000
|
|
80
|
-
CMD ["node", "dist/index.js"]
|
|
81
|
-
`}function j(){return`${[`# Rebuilt inside the image.`,`**/node_modules`,`**/dist`,`**/.kickjs`,`# Secrets stay out of the image; pass them at run time.`,`**/.env`,`**/.env.*`,`!**/.env.example`,`# Platform and tooling output.`,`.netlify`,`.vercel`,`.git`,`**/coverage`,`*.log`].join(`
|
|
82
|
-
`)}\n`}function de(e,t){let n=e[t];if(!n)throw Error(`generatePackageJson: missing resolved version for ${t}. Add it to SIBLING_PACKAGES or THIRD_PARTY_PACKAGES in generators/project.ts.`);return n}function M(e,t){return Object.fromEntries(e.toSorted().map(e=>[e,de(t,e)]))}function N(e){try{let t=h(e,[`--version`],{encoding:`utf-8`,stdio:[`ignore`,`pipe`,`ignore`],timeout:1e4}).trim();return/^\d+\.\d+\.\d+$/.test(t)?`${e}@${t}`:void 0}catch{return}}function fe(e,t,n,r){return JSON.stringify({name:e,...r?{packageManager:r}:{},version:`0.0.0`,type:`module`,scripts:{dev:`kick dev`,build:`kick build`,start:`kick start`,test:`vitest run`,"build:netlify":`kick build && kick build:netlify`,"build:vercel":`kick build && kick build:vercel`,...n.scripts},dependencies:M(n.dependencies,t),devDependencies:M(n.devDependencies,t)},null,2)}function pe(e,t){let n=Object.entries(t);if(n.length===0)return e;let r=e===``?[]:e.replace(/\n$/,``).split(`
|
|
83
|
-
`),i=e=>e.trim().replace(/^['"]|['"]$/g,``),a=e=>/^[\w-]+$/.test(e)?e:`'${e}'`,o=(e,t)=>{let n=r.findIndex(t=>t.replace(/\s+$/,``)===`${e}:`);if(n===-1){if(!t)return;r.length>0&&r[r.length-1]!==``&&r.push(``),r.push(`${e}:`),n=r.length-1}let i=n+1;for(let e=n+1;e<r.length&&/^(\s|$)/.test(r[e]);e++)r[e].trim()!==``&&(i=e+1);return{start:n,end:i}},s=[];for(let[e,t]of n){let{start:n,end:c}=o(`allowBuilds`,!0),l=r.slice(n+1,c).findIndex(t=>i(t.split(`:`)[0])===e),u=l===-1?void 0:/:\s*(true|false)\s*$/.exec(r[n+1+l]);if(u){s.push([e,u[1]===`true`]);continue}let d=` ${a(e)}: ${t}`;l===-1?r.splice(c,0,d):r[n+1+l]=d,s.push([e,t])}let c=[`onlyBuiltDependencies`,`ignoredBuiltDependencies`];for(let[e,t]of s){if(c.some(t=>{let n=o(t,!1);return n!==void 0&&r.slice(n.start+1,n.end).some(t=>i(t.replace(/^\s*-/,``))===e)}))continue;let{end:n}=o(t?c[0]:c[1],!0);r.splice(n,0,` - ${a(e)}`)}return`${r.join(`
|
|
84
|
-
`)}\n`}const me={adapter:`adapters`,middleware:`middlewares`};function he(e,t,n=e=>e,r=`src/index.ts`){let i={source:e,added:[],present:[],manual:[]};for(let e of t){if(!e.slot||!e.code)continue;let t=me[e.slot],a=n(e.code),o=ve(a),s=b(r,i.source).program,c=t?ge(s):void 0;if(!c){i.manual.push({...e,code:a});continue}let l=c.properties.find(e=>e.type===`Property`&&(e.key?.name??e.key?.value)===t);if(l&&l.value.type!==`ArrayExpression`){i.manual.push({...e,code:a});continue}let u=o&&e.import?_e(s,e.import.from,o):o;l&&u&&i.source.slice(l.value.start,l.value.end).includes(`${u}(`)?i.present.push(o??P(a)):(i.source=l?ye(i.source,l.value,a):be(i.source,c,t,a),e.import&&(i.source=xe(i.source,e.import,r)),i.added.push(o??P(a)))}return i}function ge(e){let t,n=e=>{if(t||!e||typeof e!=`object`)return;if(Array.isArray(e))return e.forEach(n);let r=e;if(r.type===`CallExpression`&&r.callee?.type===`Identifier`&&r.callee.name===`bootstrap`&&r.arguments?.[0]?.type===`ObjectExpression`)t=r.arguments[0];else for(let e in r)n(r[e])};return n(e),t}function _e(e,t,n){for(let r of e.body)if(r.type===`ImportDeclaration`&&r.source.value===t)for(let e of r.specifiers){let t=e.imported?.name??e.imported?.value;if(e.type===`ImportSpecifier`&&t===n)return e.local.name}return n}function ve(e){let t=e.split(`
|
|
85
|
-
`).find(e=>e.trim()&&!e.trim().startsWith(`//`));return/^\s*([A-Za-z_$][\w$.]*)\s*\(/.exec(t??``)?.[1]}const P=e=>e.split(`
|
|
86
|
-
`).find(e=>e.trim()&&!e.trim().startsWith(`//`))?.trim()??e,F=(e,t)=>/^[ \t]*/.exec(e.slice(e.lastIndexOf(`
|
|
87
|
-
`,t-1)+1))[0],I=(e,t)=>e.split(`
|
|
88
|
-
`).map(e=>e&&t+e).join(`
|
|
89
|
-
`);function ye(e,t,n){let r=t.elements.filter(Boolean),i=F(e,t.start);if(r.length===0){let r=I(`${n},`,`${i} `);return`${e.slice(0,t.start)}[\n${r}\n${i}]${e.slice(t.end)}`}let a=r.at(-1),o=F(e,a.start),s=e.slice(a.end,t.end-1).match(/^\s*,/),c=s?a.end+s[0].length:a.end,l=`\n${I(`${n},`,o)}`;return s?e.slice(0,c)+l+e.slice(c):`${e.slice(0,c)},${l.replace(/,$/,``)}${e.slice(c)}`}function be(e,t,n,r){let i=t.properties.at(-1),a=i?F(e,i.start):`${F(e,t.start)} `,o=`${a}${n}: [\n${I(`${r},`,`${a} `)}\n${a}],`;if(!i)return`${e.slice(0,t.start)}{\n${o}\n${F(e,t.start)}}${e.slice(t.end)}`;let s=e.slice(i.end,t.end-1).match(/^\s*,/),c=s?i.end+s[0].length:i.end;return`${e.slice(0,c)}${s?``:`,`}\n${o}${e.slice(c)}`}function xe(e,t,n=`src/index.ts`){let r=b(n,e).program.body.filter(e=>e.type===`ImportDeclaration`),i=r.find(e=>e.source.value===t.from&&e.importKind!==`type`&&e.specifiers.length>0&&!e.specifiers.some(e=>e.type===`ImportNamespaceSpecifier`)),a=t.names??[];if(i){let t=new Set(i.specifiers.map(e=>e.local?.name)),n=a.filter(e=>!t.has(e));if(n.length===0)return e;let r=i.specifiers.filter(e=>e.type===`ImportSpecifier`);if(r.length>0){let t=r.at(-1).end;return`${e.slice(0,t)}, ${n.join(`, `)}${e.slice(t)}`}let o=i.specifiers[0];return`${e.slice(0,o.end)}, { ${n.join(`, `)} }${e.slice(o.end)}`}let o=`import ${[t.default,a.length?`{ ${a.join(`, `)} }`:void 0].filter(Boolean).join(`, `)} from '${t.from}'`,s=r.at(-1);return s?`${e.slice(0,s.end)}\n${o}${e.slice(s.end)}`:`${o}\n${e}`}const Se={swagger:`feature-swagger`,devtools:`feature-devtools`,ws:`feature-ws`,queue:`feature-queue`,"queue:bullmq":`feature-queue`,storage:`feature-storage`};function Ce(e){let t=[...new Set(e.map(e=>Se[e]).filter(Boolean))];return t.length>0?E(t):void 0}function we(e,t){return(t?[t]:[`src/index.ts`,`src/main.ts`]).find(t=>r(l(e,t)))}function Te(e,t){try{return h(`git`,[`status`,`--porcelain`,`--`,...t],{cwd:e,encoding:`utf-8`,stdio:[`ignore`,`pipe`,`ignore`]}).split(`
|
|
90
|
-
`).filter(Boolean).map(e=>e.slice(3))}catch{return[]}}const L=/\.(?:[cm]?[jt]sx?)$/;function Ee(e,t){return[...t].filter(([t,n])=>{let a=l(e,t);return L.test(t)&&r(a)&&i(a,`utf-8`)!==n}).map(([e])=>e)}async function De(e,t){let a=[];for(let[o,s]of t){let t=l(e,o);if(!r(t)){await n(t,s),a.push(o);continue}if(L.test(o))continue;let c=i(t,`utf-8`),u=new Set(c.split(`
|
|
91
|
-
`).map(e=>R(e)??e)),d=s.split(`
|
|
92
|
-
`).filter(e=>e.trim()&&!u.has(R(e)??e));if(d.length===0)continue;let f=c===``||c.endsWith(`
|
|
93
|
-
`)?``:`
|
|
94
|
-
`;await n(t,`${c}${f}${d.join(`
|
|
95
|
-
`)}\n`),a.push(o)}return a}function Oe(e,t,n){let r=e.import?.from;if(!r?.startsWith(`.`))return!1;let i=u.join(u.dirname(t.replaceAll(`\\`,`/`)),r);return n.some(e=>e.replace(L,``)===i)}const R=e=>/^\s*([A-Za-z_][\w]*)\s*=/.exec(e)?.[1];async function ke(e,t,r){let a=l(e,t),o=i(a,`utf-8`),s=he(o,r,z(e),t);return s.source!==o&&await n(a,s.source),s}function z(e){let t=Ae(e),n={name:String(t.name??`app`),version:String(t.version??`0.0.0`)};return e=>e.replace(/\{\{(\w+)\}\}/g,(e,t)=>n[t]??e)}function Ae(e){try{return JSON.parse(i(l(e,`package.json`),`utf-8`))}catch{return{}}}function B(e){let t=e.flatMap(e=>e.import?[e.import]:[]).map(e=>`import ${[e.default,e.names?.length?`{ ${e.names.join(`, `)} }`:void 0].filter(Boolean).join(`, `)} from '${e.from}'`),n=e.map(e=>`${e.code},`);return[...t,``,`// in bootstrap({ adapters: [ ... ] }):`,...n].join(`
|
|
96
|
-
`)}const V={kickjs:{pkg:`@forinda/kickjs`,peers:[],enginePeers:!0,description:`Unified framework: DI, decorators, routing, middleware`,core:!0},vite:{pkg:`@forinda/kickjs-vite`,peers:[`vite`],description:`Vite plugin: dev server, HMR, module discovery`,dev:!0,core:!0},cli:{pkg:`@forinda/kickjs-cli`,peers:[],description:`CLI tool and code generators`,dev:!0,core:!0},zod:{pkg:`zod`,peers:[],description:`Zod schema validation (env, DTOs, OpenAPI) — wrap with fromZod()`},valibot:{pkg:`valibot`,peers:[],description:`Valibot schema validation — wrap with fromValibot()`},yup:{pkg:`yup`,peers:[],description:`Yup schema validation — wrap with fromYup()`},ai:{pkg:`@forinda/kickjs-ai`,peers:[`zod`],description:`AI toolkit — LLM providers, tool definitions from controllers`},storage:{pkg:`@forinda/kickjs-storage`,peers:[],description:`File storage — memory, disk, S3-compatible buckets, signed URLs`},swagger:{pkg:`@forinda/kickjs-swagger`,peers:[],description:`OpenAPI spec + Swagger UI + ReDoc`,builds:{"@scarf/scarf":!0}},db:{pkg:`@forinda/kickjs-db`,peers:[],description:`kick/db core — schema DSL, migrations, KickDbClient, customType`},pg:{pkg:`@forinda/kickjs-db`,peers:[`pg`],typePeers:[`@types/pg`],description:`kick/db + PostgreSQL driver (use @forinda/kickjs-db/pg)`},sqlite:{pkg:`@forinda/kickjs-db`,peers:[`better-sqlite3`],builds:{"better-sqlite3":!0},typePeers:[`@types/better-sqlite3`],description:`kick/db + SQLite driver (use @forinda/kickjs-db/sqlite)`},mysql:{pkg:`@forinda/kickjs-db`,peers:[`mysql2`],description:`kick/db + MySQL driver (use @forinda/kickjs-db/mysql)`},ws:{pkg:`@forinda/kickjs-ws`,peers:[`ws`],description:`WebSocket with @WsController decorators`},devtools:{pkg:`@forinda/kickjs-devtools`,peers:[],description:`Development dashboard — routes, DI, metrics, health`,dev:!0},queue:{pkg:`@forinda/kickjs-queue`,peers:[],description:`Queue adapter (BullMQ/RabbitMQ/Kafka)`},"queue:bullmq":{pkg:`@forinda/kickjs-queue`,peers:[`bullmq`,`ioredis`],builds:{"msgpackr-extract":!1},description:`Queue with BullMQ + Redis`},"queue:rabbitmq":{pkg:`@forinda/kickjs-queue`,peers:[`amqplib`],description:`Queue with RabbitMQ`},"queue:kafka":{pkg:`@forinda/kickjs-queue`,peers:[`kafkajs`],description:`Queue with Kafka`},"queue:redis-pubsub":{pkg:`@forinda/kickjs-queue`,peers:[`ioredis`],description:`Lightweight pub/sub via Redis (no persistence)`},mcp:{pkg:`@forinda/kickjs-mcp`,peers:[`@modelcontextprotocol/server`],description:`Model Context Protocol server — expose @Controller endpoints as AI tools`},testing:{pkg:`@forinda/kickjs-testing`,peers:[],description:`Test utilities and TestModule builder`,dev:!0}},je=Object.entries(V).filter(([e,t])=>!t.core&&!t.deprecated&&!e.includes(`:`)&&![`pg`,`sqlite`,`mysql`,`zod`,`valibot`,`yup`].includes(e)).map(([e])=>e).join(`, `),H={express:[`express`],fastify:[`fastify`,`@fastify/middie`,`serve-static`],h3:[`h3@^2`,`serve-static`]},U={express:{prod:`multer`,dev:`@types/multer`,note:`Express uploads use multer (memory/disk storage, ctx.file / ctx.files).`},fastify:{prod:`@fastify/multipart`,note:`Fastify uploads use @fastify/multipart (buffered into ctx.file / ctx.files).`},h3:{note:`h3 parses multipart natively (readMultipartFormData) — no driver to install.`}};function W(e){if(e!==void 0){if(e===`express`||e===`fastify`||e===`h3`)return e;throw Error(`Invalid --runtime '${String(e)}'. Expected express, fastify or h3.`)}}async function G(e=process.cwd()){return(await K(e)).runtime}async function K(t=process.cwd()){let n=(await e(t))?.runtime;return n===`express`||n===`fastify`||n===`h3`?{runtime:n,candidates:[n],ambiguous:!1,fromConfig:!0}:{...Me(t),fromConfig:!1}}const q=[[`express`,`express`],[`fastify`,`fastify`],[`h3`,`h3`]];function Me(e=process.cwd()){let t=J(`package.json`,e);if(!t)return{runtime:`express`,candidates:[],ambiguous:!1};let n={},r={};try{let e=JSON.parse(i(d(t,`package.json`),`utf-8`));n=e.dependencies??{},r=e.devDependencies??{}}catch{return{runtime:`express`,candidates:[],ambiguous:!1}}let a=q.filter(([e])=>e in n).map(([,e])=>e),o=q.filter(([e])=>e in r&&!(e in n)).map(([,e])=>e),s=[...a,...o];return a.length===1?{runtime:a[0],candidates:s,ambiguous:!1}:a.length===0&&o.length===1?{runtime:o[0],candidates:s,ambiguous:!1}:s.length===0?{runtime:`express`,candidates:s,ambiguous:!1}:{runtime:`express`,candidates:s,ambiguous:!0}}function J(e,t=process.cwd()){let n=t;for(;;){if(r(d(n,e)))return n;let t=c(n);if(t===n)return null;n=t}}function Ne(){return J(`pnpm-lock.yaml`)?`pnpm`:J(`yarn.lock`)?`yarn`:J(`bun.lockb`)||J(`bun.lock`)?`bun`:J(`package-lock.json`)?`npm`:null}function Pe(){let e=process.cwd();for(;e;){let n=d(e,`package.json`);if(r(n))try{let e=JSON.parse(i(n,`utf-8`)).packageManager;if(typeof e==`string`){let n=e.split(`@`)[0];if(t.includes(n))return n}}catch{}let a=c(e);if(a===e)return null;e=a}return null}async function Y(n){if(n&&t.includes(n))return{pm:n,source:`flag`};let r=await e(process.cwd());if(r?.packageManager&&t.includes(r.packageManager))return{pm:r.packageManager,source:`config`};let i=Pe();if(i)return{pm:i,source:`package.json`};let a=Ne();return a?{pm:a,source:`lockfile`}:{pm:`npm`,source:`default`}}async function Fe(e){let{pm:t}=await Y(e);return t}function X(e=!1,t){let n=Object.entries(V),r=Math.max(...n.map(([e])=>e.length)),i=n.filter(([,e])=>e.core),a=n.filter(([,e])=>!e.core),o=([e,n])=>{let i=e.padEnd(r+2),a=n.enginePeers?[...n.peers,...H[t??`express`]]:n.peers,o=n.enginePeers?` [${t??`express`} engine]`:``,s=a.length?` (+ ${a.join(`, `)})${o}`:``,c=n.deprecated?` [DEPRECATED — ${n.deprecated}]`:``;return` ${i} ${n.description}${s}${c}`};console.log(`
|
|
97
|
-
Core packages (always installed by \`kick new\`):
|
|
98
|
-
`);for(let e of i)console.log(o(e));if(e){console.log(`
|
|
99
|
-
Optional packages (add as needed):
|
|
100
|
-
`);for(let e of a)console.log(o(e))}else console.log(`\n Plus ${a.length} optional packages (swagger, db, queue, …).`),console.log(" Run `kick add --list --all` for the full catalog.");console.log(`
|
|
101
|
-
Usage: kick add ai db swagger`),console.log(` kick add queue:bullmq`),console.log(` kick add upload # installs the multipart driver for your runtime`),console.log()}const Ie={"@swc/core":!0,esbuild:!0};function Z(e,t,n){if(e===`pnpm`){let e=d(t,`pnpm-workspace.yaml`),a=r(e)?i(e,`utf-8`):``,o=pe(a,n);return o===a?void 0:(s(e,o),e)}if(e!==`npm`&&e!==`bun`)return;let a=d(t,`package.json`);if(!r(a))return;let o=JSON.parse(i(a,`utf-8`)),c=!1;if(e===`npm`){let e=o.allowScripts??{};for(let[t,r]of Object.entries(n))Object.keys(e).some(e=>e===t||e.startsWith(`${t}@`))||(e[t]=r,c=!0);o.allowScripts=e}else{let e=o.trustedDependencies??[];for(let[t,r]of Object.entries(n))r&&!e.includes(t)&&(e.push(t),c=!0);o.trustedDependencies=e}if(c)return s(a,`${JSON.stringify(o,null,2)}\n`),a}function Le(e){if(e===`pnpm`)return J(`pnpm-workspace.yaml`)??process.cwd();for(let e=process.cwd();;e=c(e)){try{if(JSON.parse(i(d(e,`package.json`),`utf-8`)).workspaces)return e}catch{}if(c(e)===e)return process.cwd()}}function Q(e){return Object.assign({},...e.map(e=>V[e]?.builds??{}))}function Re(e,t,n=`express`){let r=/* @__PURE__ */ new Set,i=/* @__PURE__ */ new Set,a=[],o=[],s=[];for(let c of e){if(c===`upload`){let e=U[n];s.push(`upload (${n}): ${e.note}`),e.prod&&(t?i:r).add(e.prod),e.dev&&i.add(e.dev);continue}let e=V[c];if(!e){a.push(c);continue}e.deprecated&&o.push(`'${c}' (${e.pkg}) is deprecated — ${e.deprecated}`);let l=t||e.dev?i:r;l.add(e.pkg);for(let t of e.peers)l.add(t);for(let t of e.typePeers??[])i.add(t);if(e.enginePeers){let e=H[n];for(let t of e)l.add(t);s.push(`${c} (${n}): engine peers ${e.join(`, `)}`)}}return{prodDeps:[...r],devDeps:[...i],unknown:a,warnings:o,notices:s}}function ze(e){e.command(`list`).alias(`ls`).description(`List KickJS packages (core only; pair with --all for the full catalog)`).option(`--all`,`Include the full optional catalog`).option(`--runtime <engine>`,`HTTP engine to show peers for: express | fastify | h3`).action(async e=>{X(!!e.all,W(e.runtime)??await G())})}function Be(e){e.command(`add [packages...]`).description(`Add KickJS packages with their required dependencies`).option(`--pm <manager>`,`Package manager override`).option(`-D, --dev`,`Install as dev dependency`).option(`--list`,`List packages (core only by default; pair with --all)`).option(`--runtime <engine>`,`HTTP engine for peer resolution: express | fastify | h3 (overrides kick.config.ts)`).option(`--all`,`When listing, include the full optional catalog`).option(`--no-wire`,`Install only — do not add adapters to the entry file or .env`).option(`--entry <file>`,`Entry file to wire (default: src/index.ts, then src/main.ts)`).option(`-f, --force`,`Wire even when the files it edits have uncommitted changes`).action(async(e,t)=>{if(t.list||e.length===0){X(!!t.all,W(t.runtime)??await G());return}let{pm:n,source:i}=await Y(t.pm);console.log(`\n Using ${n} (resolved from ${i})`);let a=W(t.runtime),o=await K(process.cwd()),s=a??o.runtime;if(!a&&o.ambiguous){console.error(`\n Cannot tell which HTTP engine this app boots on: found ${o.candidates.join(`, `)} in package.json.\n\n Installing engine peers for the wrong one is worse than not installing them, so:\n • set \`runtime: '<engine>'\` in kick.config.ts (permanent, also fixes kick doctor), or\n • pass --runtime <${o.candidates.join(`|`)}> for this command\n`),process.exitCode=1;return}let c=Re(e,!!t.dev,s),{unknown:l,warnings:u,notices:f}=c,{prodDeps:p,devDeps:m}=c,h=process.cwd();if(t.entry&&!r(d(h,t.entry))){console.error(`\n --entry ${t.entry} does not exist.\n`),process.exitCode=1;return}let _=t.wire===!1?void 0:Ce(e),v=_?we(h,t.entry):void 0;if(_){p=[.../* @__PURE__ */ new Set([...p,..._.dependencies])],m=[...new Set([...m,..._.devDependencies].filter(e=>!p.includes(e)))];let e=Te(h,[...v?[v]:[],..._.files.keys()]);if(e.length>0&&!t.force){console.error(`\n ${e.join(`, `)} ${e.length===1?`has`:`have`} uncommitted changes, and kick add would edit ${e.length===1?`it`:`them`}.\n Commit or stash first, pass --force to edit anyway, or --no-wire to install only.\n`),process.exitCode=1;return}}for(let e of u)console.warn(`\n WARNING: ${e}`);for(let e of f)console.log(`\n ${e}`);if(l.length>0&&(console.log(`\n Unknown packages: ${l.join(`, `)}`),console.log(` Run "kick add --list" to see available packages.
|
|
102
|
-
`),p.length===0&&m.length===0))return;let y={...Q(e),..._?.builds};if(Object.keys(y).length>0){let e=Z(n,Le(n),y);e&&console.log(`\n Approved install scripts in ${e}`)}let b=!0;if(p.length>0){let e=p,t=`${n} add ${e.join(` `)}`;console.log(`\n Installing ${e.length} dependency(ies):`);for(let t of e)console.log(` + ${t}`);console.log();try{g(t,{stdio:`inherit`})}catch{b=!1,console.log(`\n Installation failed. Run manually:\n ${t}\n`)}}if(m.length>0){let e=m,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{g(t,{stdio:`inherit`})}catch{b=!1,console.log(`\n Installation failed. Run manually:\n ${t}\n`)}}if(_){if(!b)console.log(` Skipped wiring — the install did not finish.
|
|
103
|
-
`);else{let e=Ee(h,_.files);for(let e of await De(h,_.files))console.log(` Updated ${e}`);let t=v?_.integrations.filter(t=>Oe(t,v,e)):[],n=_.integrations.filter(e=>!t.includes(e)),r=v?await ke(h,v,n):void 0;for(let e of r?.added??[])console.log(` Added ${e} to ${v}`);for(let e of r?.present??[])console.log(` ${e} is already in ${v}`);let i=z(h),a=r?r.manual:_.integrations.filter(e=>e.slot&&e.code).map(e=>({...e,code:i(e.code)}));if(e.length>0){let n=t.map(e=>({...e,code:i(e.code??``)}));console.log(`\n ${e.join(`, `)} already exist${e.length===1?`s`:``} — left as ${e.length===1?`it is`:`they are`}. Merge in what the layer needs, then wire it yourself:
|
|
104
|
-
`),console.log(`${B(n)}`.replace(/^/gm,` `)),console.log()}a.length>0&&(console.log(`\n ${v?`Could not find bootstrap({ adapters: [...] }) in ${v}`:`No entry file found`} — add this yourself:
|
|
105
|
-
`),console.log(B(a).replace(/^/gm,` `)),console.log())}}b?console.log(` Done!
|
|
106
|
-
`):(console.log(` Finished with errors — the install above did not complete.
|
|
107
|
-
`),process.exitCode=1)})}const $=c(p(import.meta.url)),Ve=JSON.parse(i([l($,`..`,`package.json`),l($,`..`,`..`,`package.json`)].find(r),`utf-8`)),He=[`@forinda/kickjs`,`@forinda/kickjs-cli`,`@forinda/kickjs-schema`,`@forinda/kickjs-vite`,`@forinda/kickjs-swagger`,`@forinda/kickjs-ws`,`@forinda/kickjs-queue`,`@forinda/kickjs-devtools`,`@forinda/kickjs-testing`,`@forinda/kickjs-client`,`@forinda/kickjs-inertia`,`@forinda/kickjs-storage`],Ue={react:{fallback:`^19.0.0`},"react-dom":{fallback:`^19.0.0`},"@types/react":{fallback:`^19.0.0`},"@types/react-dom":{fallback:`^19.0.0`},"@vitejs/plugin-react":{fallback:`^5.0.0`},"@inertiajs/react":{fallback:`^3.9.0`,cap:`^3`},"@inertiajs/core":{fallback:`^3.9.0`,cap:`^3`},"@types/node":{fallback:`^25.0.0`},"@types/supertest":{fallback:`^7.2.1`},supertest:{fallback:`^7.2.2`},vitest:{fallback:`^4.1.2`},"@swc/core":{fallback:`^1.15.21`},"unplugin-swc":{fallback:`^1.5.9`},oxfmt:{fallback:`^0.65.0`},oxlint:{fallback:`^1.80.0`},dotenv:{fallback:`^17.3.1`,cap:`^17`},"reflect-metadata":{fallback:`^0.2.2`},vite:{fallback:`^8.0.3`,cap:`^8`},typescript:{fallback:`^7.0.2`,cap:`^7`},"@typescript/typescript6":{fallback:`^6.0.2`,cap:`^6`},express:{fallback:`^5.1.0`,cap:`^5`},"@types/express":{fallback:`^5.0.6`,cap:`^5`},fastify:{fallback:`^5.0.0`,cap:`^5`},"@fastify/middie":{fallback:`^9.0.0`,cap:`^9`},h3:{fallback:`^2.0.2`,cap:`^2`},"serve-static":{fallback:`^2.2.0`,cap:`^2`},zod:{fallback:`^4.3.6`,cap:`^4`},valibot:{fallback:`^1.4.1`,cap:`^1`},"@valibot/to-json-schema":{fallback:`^1.8.0`,cap:`^1`},yup:{fallback:`^1.7.1`,cap:`^1`},ws:{fallback:`^8.18.0`,cap:`^8`},bullmq:{fallback:`^5.0.0`,cap:`^5`},ioredis:{fallback:`^5.0.0`,cap:`^5`}};function We(e){if(!e)return null;let t=e.trim();if(/^\d+\.\d+\.\d+/.test(t))return t.split(/\s/)[0];try{let e=JSON.parse(t),n=(Array.isArray(e)?e:[e]).filter(e=>typeof e==`string`);return n.length>0?n[n.length-1]:null}catch{return null}}function Ge(e){return e===`@forinda/kickjs-cli`?`^${Ve.version}`:`latest`}async function Ke(e,t,n){let r=Array.from({length:e.length}),i=0,a=Array.from({length:Math.min(t,e.length)},async()=>{for(;i<e.length;){let t=i++;r[t]=await n(e[t])}});return await Promise.all(a),r}async function qe(){let e=[...He.map(e=>({name:e,fallback:Ge(e),cap:void 0})),...Object.entries(Ue).map(([e,t])=>({name:e,...t}))],t=Date.now()+2e4,n=await Ke(e,8,async({name:e,fallback:n,cap:r})=>{let i=t-Date.now();if(i<=0)return[e,n];let a=r?`${e}@${r}`:e,o=We(await re(`npm`,r?[`view`,a,`version`,`--json`]:[`view`,a,`version`],{timeout:i}));return[e,o?`^${o}`:n]});return Object.fromEntries(n)}function Je(e,t){let n=w(`npm`,[`view`,`${e}@${t}`,`version`],{timeout:2e4});return n&&/^\d+\.\d+\.\d+/.test(n)?n:null}function Ye(e){return(e??``).replace(/^[\^~>=<\s]+/,``)}function Xe(e,t){let n=e=>Ye(e).split(`-`)[0].split(`.`).map(e=>Number.parseInt(e,10)||0),[r=0,i=0,a=0]=n(e),[o=0,s=0,c=0]=n(t);return r===o?i===s?a>=c:i>s:r>o}function Ze(e,t,n){let r=w(`npm`,[`view`,`${e}@${t}`,`exports`,`--json`],{timeout:2e4});if(!r)return!1;try{let e=JSON.parse(r);return Object.prototype.hasOwnProperty.call(e,n)}catch{return!1}}async function Qe(e){let{name:t,directory:i,packageManager:a=`pnpm`,template:o=`rest`,defaultRepo:s=`inmemory`,packages:c=[],schemaLib:u=`zod`,runtime:d=`express`}=e,f=i,p=e=>console.log(` ${e}`);console.log(`\n Creating KickJS project: ${t}\n`),e.versions||p(`Resolving package versions...`);let m=e.versions??await qe(),h=Object.keys(m).filter(e=>m[e]===`latest`);if(h.length>0&&p(`WARNING: could not reach npm for ${h.join(`, `)} — pinned to 'latest'`),d!==`express`){if(Ze(`@forinda/kickjs`,`latest`,`./${d}`))p(`Using @forinda/kickjs@latest (stable ships the ${d} runtime)`);else{let e=[`@forinda/kickjs`,`@forinda/kickjs-cli`,`@forinda/kickjs-vite`],t=[],n=!1;for(let r of e){let e=Je(r,`alpha`);e&&Xe(e,Ye(m[r]))&&(m[r]=`^${e}`,t.push(`${r}@^${e}`),r===`@forinda/kickjs`&&(n=!0))}p(n?`Using the alpha channel for the ${d} runtime: ${t.join(`, `)}`:`WARNING: could not resolve @forinda/kickjs@alpha — the ${d} runtime subpath may be missing. After install, run: ${a} add @forinda/kickjs@alpha`)}}let _=c.filter(e=>!r(l(T,`feature-${e}`)));_.length>0&&p(`WARNING: skipping unknown package(s): ${_.join(`, `)} — add them later with kick add`);let v=E([...et({template:o,runtime:d,schemaLib:u,packages:c}),...e.platformConfig===!1?[]:[`host-config`],...e.extraLayers??[]],{vars:{name:t,version:Ve.version},extra:[{slot:`repo`,code:s===`inmemory`?`repo: 'inmemory'`:`repo: { name: '${s.replace(/\\/g,`\\\\`).replace(/'/g,`\\'`)}' }`},...e.spaClientDir?[$e(e.spaClientDir)]:[]]});await n(l(f,`package.json`),fe(t,m,v,e.platformConfig===!1?void 0:N(a)));let b=D(v.files,{name:t,template:o,runtime:d,packageManager:a,netlifyPublish:o===`inertia`?`dist/client`:`dist/public`,templateLabel:{rest:`REST API`,minimal:`Minimal`,inertia:`Inertia (React)`}[o],sessionSecret:y(32).toString(`hex`),packages:[...v.dependencies,...v.devDependencies].filter(e=>e.startsWith(`@forinda/`)).map(e=>`- \`${e}\``).join(`
|
|
108
|
-
`)});for(let[e,t]of b)await n(l(f,e),t);if(e.platformConfig!==!1){let e=o===`inertia`?`inertia`:`api`;await n(l(f,`Dockerfile`),A(e,a,t)),await n(l(f,`.dockerignore`),j())}let{generateAgentDocs:x}=await import(`./agent-docs-CvBsLoE4.mjs`).then(e=>e.t);await x({outDir:f,name:t,pm:a,template:o,only:`all`,force:!0});let S={...Ie,...Q(c),...v.builds};if(e.approveInstallScripts!==!1&&Z(a,f,S),e.installDeps){console.log(`\n Installing dependencies with ${a}...\n`);try{g(`${a} install`,{cwd:f,stdio:`inherit`}),console.log(`
|
|
109
|
-
Dependencies installed successfully!`)}catch{console.log(`\n Warning: ${a} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-BmyEoY3Z.mjs`).then(e=>e.n);await e({cwd:f,allowDuplicates:!0,silent:!0})}catch{}if(e.initGit)try{g(`git init`,{cwd:f,stdio:`pipe`}),g(`git branch -M main`,{cwd:f,stdio:`pipe`}),g(`git add -A`,{cwd:f,stdio:`pipe`}),g(`git commit -m "chore: initial commit from kick new"`,{cwd:f,stdio:`pipe`}),p(`Git repository initialized`)}catch{p(`Warning: git init failed (git may not be installed)`)}console.log(`
|
|
110
|
-
Project scaffolded successfully!`),console.log();let C=f!==process.cwd();p(`Next steps:`),C&&p(` cd ${t}`),e.installDeps||p(` ${a} install`);let w={rest:`kick g module user`,minimal:`# add your routes to src/index.ts`,inertia:`# pages: src/modules/pages + src/client/pages`};return p(` ${w[o]??w.rest}`),p(` kick dev`),p(``),p(`Commands:`),p(` kick dev Start dev server with Vite HMR`),p(` kick build Production build via Vite`),p(` kick start Run production build`),p(``),p(`Generators:`),p(` kick g module <name> REST module (controller, service, DTOs, repository)`),p(` kick g scaffold <n> <f..> CRUD module from field definitions`),p(` kick g controller <name> Standalone controller`),p(` kick g service <name> @Service() class`),p(` kick g middleware <name> Global connect-style middleware`),p(` kick g guard <name> Route guard (auth, roles, etc.)`),p(` kick g adapter <name> AppAdapter with lifecycle hooks`),p(` kick g dto <name> DTO schema (Zod / Valibot / Yup)`),p(` kick g config Generate kick.config.ts`),p(``),p(`Add packages:`),p(` kick add <pkg> Install a KickJS package + peers`),p(` kick add --list Show all available packages`),p(``),p(`Available: ${je}`),p(``),{builds:S}}function $e(e){return{import:{from:`@forinda/kickjs/spa`,names:[`SpaAdapter`]},slot:`adapter`,code:`// Serves the built frontend from this origin in production.
|
|
111
|
-
// Inert until the client build exists, so \`kick dev\` (where Vite
|
|
112
|
-
// serves the client and proxies /api here) is unaffected.
|
|
113
|
-
SpaAdapter({ clientDir: ${JSON.stringify(e)} })`}}function et(e){return[`base`,`template-${e.template}`,`runtime-${e.runtime}`,`schema-${e.schemaLib}`,...e.packages.filter(e=>r(l(T,`feature-${e}`))).map(e=>`feature-${e}`)]}export{te as _,Z as a,G as c,A as d,j as f,ne as g,ee as h,U as i,Fe as l,E as m,qe as n,Be as o,D as p,V as r,ze as s,Qe as t,N as u};
|