@forinda/kickjs-cli 8.4.0 → 8.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/{project-docs-Ck3uzaEG.mjs → agent-docs-BFOgLbXq.mjs} +81 -71
- package/dist/agent-docs-BFOgLbXq.mjs.map +1 -0
- package/dist/{project-docs-8d5GNDIw.mjs → agent-docs-BU1rORKA.mjs} +75 -67
- package/dist/{build-Bw_SFnBG.mjs → build-CdIpRyfy.mjs} +3 -3
- package/dist/{build-Bw_SFnBG.mjs.map → build-CdIpRyfy.mjs.map} +1 -1
- package/dist/{build-BrNa6gYZ.mjs → build-DlfIkjcw.mjs} +2 -2
- package/dist/{builtins-DHjV84lv.mjs → builtins-CfAXBoIM.mjs} +2 -2
- package/dist/{builtins-CNZ4QP-z.mjs → builtins-CmuUgcIq.mjs} +36 -31
- package/dist/cli.mjs +2 -2
- package/dist/config-SvlcF3Ls.mjs +12 -0
- package/dist/config-ndsVdO8u.mjs +13 -0
- package/dist/config-ndsVdO8u.mjs.map +1 -0
- package/dist/{doctor-DzqvC6jF.mjs → doctor-D3RMXkxE.mjs} +6 -6
- package/dist/{doctor-DzqvC6jF.mjs.map → doctor-D3RMXkxE.mjs.map} +1 -1
- package/dist/fs-DdNMcW_P.mjs +12 -0
- package/dist/fs-DdNMcW_P.mjs.map +1 -0
- package/dist/fs-v57MCgpH.mjs +11 -0
- package/dist/fullstack-DOufUeMv.mjs +95 -0
- package/dist/fullstack-LJwhodT-.mjs +96 -0
- package/dist/fullstack-LJwhodT-.mjs.map +1 -0
- package/dist/index.d.mts +15 -24
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +2 -2
- package/dist/{plugin-C11bSFtE.mjs → plugin-Dighdqh-.mjs} +2 -2
- package/dist/{plugin-BdN4scZR.mjs → plugin-Dn67elEZ.mjs} +2 -2
- package/dist/project-AXCA1hD9.mjs +45 -0
- package/dist/project-Cb_NLUWI.mjs +46 -0
- package/dist/project-Cb_NLUWI.mjs.map +1 -0
- package/dist/{project-root-DORRVmte.mjs → project-root-C7TrLJlZ.mjs} +3 -3
- package/dist/{project-root-DORRVmte.mjs.map → project-root-C7TrLJlZ.mjs.map} +1 -1
- package/dist/{project-root-D_rrQbpy.mjs → project-root-Dgvy5kYG.mjs} +2 -2
- package/dist/{prompts-DHHDYxLL.mjs → prompts-CSATvwXw.mjs} +2 -2
- package/dist/{prompts-DHHDYxLL.mjs.map → prompts-CSATvwXw.mjs.map} +1 -1
- package/dist/{rolldown-runtime-LCdccCoI.mjs → rolldown-runtime-BhxEEqxa.mjs} +1 -1
- package/dist/{run-plugins-DSYGn4AC.mjs → run-plugins-Cf_6BgGZ.mjs} +34 -29
- package/dist/run-plugins-Cf_6BgGZ.mjs.map +1 -0
- package/dist/{typegen-Bv9EzadE.mjs → typegen-97E_RYNp.mjs} +4 -4
- package/dist/typegen-CYhFNfIu.mjs +132 -0
- package/dist/{typegen-COTKpuqW.mjs.map → typegen-CYhFNfIu.mjs.map} +1 -1
- package/dist/{types-CW4qiwB1.mjs → types-lHwt_SNI.mjs} +1 -1
- package/package.json +10 -9
- package/templates/base/feature.json +18 -0
- package/templates/base/files/README.md +61 -0
- package/templates/base/files/_dot_editorconfig +13 -0
- package/templates/base/files/_dot_env +2 -0
- package/templates/base/files/_dot_env.example +2 -0
- package/templates/base/files/_dot_env.test +9 -0
- package/templates/base/files/_dot_env.test.example +11 -0
- package/templates/base/files/_dot_gitattributes +18 -0
- package/templates/base/files/_dot_gitignore +14 -0
- package/templates/base/files/_dot_oxfmtrc.json +9 -0
- package/templates/base/files/kick.config.ts +58 -0
- package/templates/base/files/src/modules/hello/hello.controller.ts +26 -0
- package/templates/base/files/src/modules/hello/hello.module.ts +21 -0
- package/templates/base/files/src/modules/hello/hello.service.ts +12 -0
- package/templates/base/files/src/modules/index.ts +7 -0
- package/templates/base/files/tsconfig.json +21 -0
- package/templates/base/files/vite.config.ts +31 -0
- package/templates/base/files/vitest.config.ts +18 -0
- package/templates/feature-devtools/feature.json +13 -0
- package/templates/feature-queue/feature.json +16 -0
- package/templates/feature-queue/files/_dot_env.append +2 -0
- package/templates/feature-queue/files/_dot_env.example.append +2 -0
- package/templates/feature-swagger/feature.json +16 -0
- package/templates/feature-ws/feature.json +13 -0
- package/templates/fullstack-root/files/_dot_gitignore +8 -0
- package/templates/fullstack-root/files/netlify.toml +13 -0
- package/templates/fullstack-root/files/vercel.json +5 -0
- package/templates/host-config/files/netlify.toml +6 -0
- package/templates/host-config/files/vercel.json +5 -0
- package/templates/runtime-express/feature.json +22 -0
- package/templates/runtime-fastify/feature.json +13 -0
- package/templates/runtime-h3/feature.json +13 -0
- package/templates/schema-valibot/feature.json +3 -0
- package/templates/schema-valibot/files/src/config/index.ts +41 -0
- package/templates/schema-yup/feature.json +3 -0
- package/templates/schema-yup/files/src/config/index.ts +43 -0
- package/templates/schema-zod/feature.json +3 -0
- package/templates/schema-zod/files/src/config/index.ts +41 -0
- package/templates/server-fullstack/feature.json +13 -0
- package/templates/template-minimal/feature.json +10 -0
- package/templates/template-minimal/files/src/index.ts +17 -0
- package/templates/template-rest/feature.json +10 -0
- package/templates/template-rest/files/src/index.ts +28 -0
- package/templates/web-kick/files/web/index.html +12 -0
- package/templates/web-kick/files/web/src/App.tsx +45 -0
- package/templates/web-kick/files/web/src/api.ts +14 -0
- package/templates/web-kick/files/web/src/main.tsx +9 -0
- package/templates/web-kick/files/web/tsconfig.json +15 -0
- package/templates/web-kick/files/web/vite.config.ts +13 -0
- package/dist/agent-docs-BIYv2Od-.mjs +0 -11
- package/dist/agent-docs-DWRW_0cn.mjs +0 -12
- package/dist/agent-docs-DWRW_0cn.mjs.map +0 -1
- package/dist/config-B6LRxtE1.mjs +0 -13
- package/dist/config-B6LRxtE1.mjs.map +0 -1
- package/dist/config-DIH8bQUO.mjs +0 -12
- package/dist/fullstack-BwdcyVD3.mjs +0 -195
- package/dist/fullstack-BwdcyVD3.mjs.map +0 -1
- package/dist/fullstack-CkAO5DhE.mjs +0 -194
- package/dist/project--WiWkarb.mjs +0 -450
- package/dist/project-JoccwqS2.mjs +0 -451
- package/dist/project-JoccwqS2.mjs.map +0 -1
- package/dist/project-docs-8d5GNDIw.mjs.map +0 -1
- package/dist/run-plugins-DSYGn4AC.mjs.map +0 -1
- package/dist/typegen-COTKpuqW.mjs +0 -132
|
@@ -1,451 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @forinda/kickjs-cli v8.4.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{l as e,o as t}from"./project-docs-8d5GNDIw.mjs";import{o as n,t as r}from"./config-B6LRxtE1.mjs";import{dirname as i,join as a,resolve as o}from"node:path";import{existsSync as s,readFileSync as c,writeFileSync as l}from"node:fs";import{execFile as u,execFileSync as d,execSync as f,spawnSync as p}from"node:child_process";import{fileURLToPath as m}from"node:url";import{promisify as h}from"node:util";const g={express:{from:`@forinda/kickjs`,name:`expressRuntime`},fastify:{from:`@forinda/kickjs/fastify`,name:`fastifyRuntime`},h3:{from:`@forinda/kickjs/h3`,name:`h3Runtime`}};function _(e,t,n,r=[],i=`express`,a){let o=g[i],s=i===`express`;switch(t){case`minimal`:{let t=[],i=[],c=s?`import { bootstrap, ${o.name} } from '@forinda/kickjs'`:`import { bootstrap } from '@forinda/kickjs'\nimport { ${o.name} } from '${o.from}'`;r.includes(`swagger`)&&(t.push(`import { SwaggerAdapter } from '@forinda/kickjs-swagger'`),i.push(` SwaggerAdapter({ info: { title: '${e}', version: '${n}' } }),`)),r.includes(`devtools`)&&(t.push(`import { DevToolsAdapter } from '@forinda/kickjs-devtools'`),i.push(` DevToolsAdapter(),`)),a&&(t.push(`import { SpaAdapter } from '@forinda/kickjs/spa'`),i.push(` // Serves the built frontend from this origin in production.
|
|
12
|
-
// Inert until the client build exists, so \`kick dev\` (where Vite
|
|
13
|
-
// serves the client and proxies /api here) is unaffected.
|
|
14
|
-
SpaAdapter({ clientDir: ${JSON.stringify(a)} }),`));let l=t.length?t.join(`
|
|
15
|
-
`)+`
|
|
16
|
-
`:``,u=i.length?`,\n adapters: [\n${i.join(`
|
|
17
|
-
`)}\n ]`:``;return`import 'reflect-metadata'
|
|
18
|
-
// Side-effect import — registers the extended env schema with kickjs
|
|
19
|
-
// **before** any controller / service / @Value gets resolved. Without
|
|
20
|
-
// this line ConfigService.get('YOUR_KEY') returns undefined because the
|
|
21
|
-
// cached schema would still be the base shape. See guide/configuration.
|
|
22
|
-
import './config'
|
|
23
|
-
${c}
|
|
24
|
-
${l}import { modules } from './modules'
|
|
25
|
-
|
|
26
|
-
// Export the app for the Vite plugin (dev mode)
|
|
27
|
-
export const app = await bootstrap({ modules, runtime: ${o.name}()${u} })
|
|
28
|
-
`}default:{let t=[],i=[];r.includes(`devtools`)&&(t.push(`import { DevToolsAdapter } from '@forinda/kickjs-devtools'`),i.push(` DevToolsAdapter(),`)),r.includes(`swagger`)&&(t.push(`import { SwaggerAdapter } from '@forinda/kickjs-swagger'`),i.push(` SwaggerAdapter({\n info: { title: '${e}', version: '${n}' },\n }),`));let a=t.length?t.join(`
|
|
29
|
-
`)+`
|
|
30
|
-
`:``,c=i.length?`\n adapters: [\n${i.join(`
|
|
31
|
-
`)}\n ],`:``,l=[`bootstrap`,`requestId`,`requestLogger`,`helmet`,`cors`];s&&l.push(o.name);let u=s?`import express from 'express'\nimport {\n ${l.join(`,
|
|
32
|
-
`)},\n} from '@forinda/kickjs'`:`import {\n ${l.join(`,
|
|
33
|
-
`)},\n} from '@forinda/kickjs'\nimport { ${o.name} } from '${o.from}'`,d=s?`
|
|
34
|
-
express.json(),`:``;return`import 'reflect-metadata'
|
|
35
|
-
// Side-effect import — registers the extended env schema with kickjs
|
|
36
|
-
// **before** any controller / service / @Value gets resolved. Without
|
|
37
|
-
// this line ConfigService.get('YOUR_KEY') returns undefined because the
|
|
38
|
-
// cached schema would still be the base shape. See guide/configuration.
|
|
39
|
-
import './config'
|
|
40
|
-
${u}
|
|
41
|
-
${a}import { modules } from './modules'
|
|
42
|
-
|
|
43
|
-
// Export the app for the Vite plugin (dev mode)
|
|
44
|
-
export const app = await bootstrap({
|
|
45
|
-
modules,
|
|
46
|
-
runtime: ${o.name}(),${c}
|
|
47
|
-
middlewares: [
|
|
48
|
-
// Security headers. The framework injects helmet() with these defaults
|
|
49
|
-
// anyway — declaring it here is what lets you CHANGE them, e.g.
|
|
50
|
-
// helmet({ frameguard: 'SAMEORIGIN' }) or helmet({ hsts: false }).
|
|
51
|
-
// Auto-injection stands down as soon as this line is present.
|
|
52
|
-
helmet(),
|
|
53
|
-
cors({ origin: '*' }),
|
|
54
|
-
requestId(),
|
|
55
|
-
requestLogger(),${d}
|
|
56
|
-
],
|
|
57
|
-
})
|
|
58
|
-
`}}}function v(){return`import { defineModules } from '@forinda/kickjs'
|
|
59
|
-
import { HelloModule } from './hello/hello.module'
|
|
60
|
-
|
|
61
|
-
// Remove HelloModule and run: kick g module <name>
|
|
62
|
-
// \`defineModules()\` returns a chainable list — \`kick g module\` appends
|
|
63
|
-
// \`.mount(NewModule())\` to the chain on every generation.
|
|
64
|
-
export const modules = defineModules().mount(HelloModule())
|
|
65
|
-
`}function y(e=`zod`){return e===`valibot`?`import { loadEnvFromSchema } from '@forinda/kickjs/config'
|
|
66
|
-
import { fromValibot } from '@forinda/kickjs-schema/valibot'
|
|
67
|
-
import * as v from 'valibot'
|
|
68
|
-
|
|
69
|
-
/**
|
|
70
|
-
* Project environment schema (Valibot).
|
|
71
|
-
*
|
|
72
|
-
* \`fromValibot\` wraps the Valibot schema as a \`KickSchema\` so the
|
|
73
|
-
* env loader, validate middleware, and swagger spec generator all see
|
|
74
|
-
* the same shape. The default export is the contract \`kick typegen\`
|
|
75
|
-
* reads to populate \`KickEnv\` via \`InferSchemaOutput<typeof _envSchema>\`
|
|
76
|
-
* — that's what makes \`@Value('FOO')\` autocomplete and
|
|
77
|
-
* \`process.env.FOO\` typed.
|
|
78
|
-
*
|
|
79
|
-
* @example
|
|
80
|
-
* DATABASE_URL: v.pipe(v.string(), v.url()),
|
|
81
|
-
* JWT_SECRET: v.pipe(v.string(), v.minLength(32)),
|
|
82
|
-
* REDIS_URL: v.optional(v.pipe(v.string(), v.url())),
|
|
83
|
-
*/
|
|
84
|
-
const envSchema = fromValibot(
|
|
85
|
-
v.object({
|
|
86
|
-
PORT: v.optional(v.pipe(v.string(), v.transform(Number)), '3000'),
|
|
87
|
-
NODE_ENV: v.optional(v.picklist(['development', 'production', 'test']), 'development'),
|
|
88
|
-
LOG_LEVEL: v.optional(v.string(), 'info'),
|
|
89
|
-
// DATABASE_URL: v.pipe(v.string(), v.url()),
|
|
90
|
-
}),
|
|
91
|
-
)
|
|
92
|
-
|
|
93
|
-
/**
|
|
94
|
-
* IMPORTANT — side effect: register the schema with kickjs's env cache
|
|
95
|
-
* **at module-load time**. \`ConfigService\` and \`@Value()\` both consume
|
|
96
|
-
* this cache, and they will fall back to the base schema (or undefined)
|
|
97
|
-
* if no extended schema has been registered before they're resolved.
|
|
98
|
-
*
|
|
99
|
-
* As long as \`src/index.ts\` imports this file (\`import './config'\`) at
|
|
100
|
-
* the top — before \`bootstrap()\` runs — every controller and service
|
|
101
|
-
* in the app sees the typed extended values.
|
|
102
|
-
*/
|
|
103
|
-
export const env = loadEnvFromSchema(envSchema)
|
|
104
|
-
|
|
105
|
-
export default envSchema
|
|
106
|
-
`:e===`yup`?`import { loadEnvFromSchema } from '@forinda/kickjs/config'
|
|
107
|
-
import { fromYup } from '@forinda/kickjs-schema/yup'
|
|
108
|
-
import * as yup from 'yup'
|
|
109
|
-
|
|
110
|
-
/**
|
|
111
|
-
* Project environment schema (Yup).
|
|
112
|
-
*
|
|
113
|
-
* \`fromYup\` wraps the Yup schema as a \`KickSchema\` so the env loader,
|
|
114
|
-
* validate middleware, and swagger spec generator all see the same
|
|
115
|
-
* shape. The default export is the contract \`kick typegen\` reads to
|
|
116
|
-
* populate \`KickEnv\` via \`InferSchemaOutput<typeof _envSchema>\`.
|
|
117
|
-
*
|
|
118
|
-
* Note: Yup's \`.url()\` defaults to http/https; database connection
|
|
119
|
-
* strings like \`postgres://\` use \`.matches(/^[a-z]+:\\/\\/.+/i)\` or
|
|
120
|
-
* a plain \`.string().required()\`.
|
|
121
|
-
*
|
|
122
|
-
* @example
|
|
123
|
-
* DATABASE_URL: yup.string().required(),
|
|
124
|
-
* JWT_SECRET: yup.string().min(32).required(),
|
|
125
|
-
* REDIS_URL: yup.string().url().optional(),
|
|
126
|
-
*/
|
|
127
|
-
const envSchema = fromYup(
|
|
128
|
-
yup.object({
|
|
129
|
-
PORT: yup.number().default(3000),
|
|
130
|
-
NODE_ENV: yup
|
|
131
|
-
.string()
|
|
132
|
-
.oneOf(['development', 'production', 'test'])
|
|
133
|
-
.default('development'),
|
|
134
|
-
LOG_LEVEL: yup.string().default('info'),
|
|
135
|
-
// DATABASE_URL: yup.string().required(),
|
|
136
|
-
}),
|
|
137
|
-
)
|
|
138
|
-
|
|
139
|
-
/**
|
|
140
|
-
* IMPORTANT — side effect: register the schema with kickjs's env cache
|
|
141
|
-
* **at module-load time**. \`ConfigService\` and \`@Value()\` both consume
|
|
142
|
-
* this cache, and they will fall back to the base schema (or undefined)
|
|
143
|
-
* if no extended schema has been registered before they're resolved.
|
|
144
|
-
*
|
|
145
|
-
* As long as \`src/index.ts\` imports this file (\`import './config'\`) at
|
|
146
|
-
* the top — before \`bootstrap()\` runs — every controller and service
|
|
147
|
-
* in the app sees the typed extended values.
|
|
148
|
-
*/
|
|
149
|
-
export const env = loadEnvFromSchema(envSchema)
|
|
150
|
-
|
|
151
|
-
export default envSchema
|
|
152
|
-
`:`import { loadEnvFromSchema } from '@forinda/kickjs/config'
|
|
153
|
-
import { fromZod } from '@forinda/kickjs-schema/zod'
|
|
154
|
-
import { z } from 'zod'
|
|
155
|
-
|
|
156
|
-
/**
|
|
157
|
-
* Project environment schema (Zod).
|
|
158
|
-
*
|
|
159
|
-
* \`fromZod\` wraps the Zod schema as a \`KickSchema\` so the env loader,
|
|
160
|
-
* validate middleware, and swagger spec generator all see the same
|
|
161
|
-
* shape. The default export is the contract \`kick typegen\` reads to
|
|
162
|
-
* populate \`KickEnv\` via \`InferSchemaOutput<typeof _envSchema>\` —
|
|
163
|
-
* that's what makes \`@Value('FOO')\` autocomplete and
|
|
164
|
-
* \`process.env.FOO\` typed.
|
|
165
|
-
*
|
|
166
|
-
* @example
|
|
167
|
-
* DATABASE_URL: z.string().url(),
|
|
168
|
-
* JWT_SECRET: z.string().min(32),
|
|
169
|
-
* REDIS_URL: z.string().url().optional(),
|
|
170
|
-
*/
|
|
171
|
-
const envSchema = fromZod(
|
|
172
|
-
z.object({
|
|
173
|
-
PORT: z.coerce.number().default(3000),
|
|
174
|
-
NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
|
|
175
|
-
LOG_LEVEL: z.string().default('info'),
|
|
176
|
-
// DATABASE_URL: z.string().url(),
|
|
177
|
-
}),
|
|
178
|
-
)
|
|
179
|
-
|
|
180
|
-
/**
|
|
181
|
-
* IMPORTANT — side effect: register the schema with kickjs's env cache
|
|
182
|
-
* **at module-load time**. \`ConfigService\` and \`@Value()\` both consume
|
|
183
|
-
* this cache, and they will fall back to the base schema (or undefined)
|
|
184
|
-
* if no extended schema has been registered before they're resolved.
|
|
185
|
-
*
|
|
186
|
-
* As long as \`src/index.ts\` imports this file (\`import './config'\`) at
|
|
187
|
-
* the top — before \`bootstrap()\` runs — every controller and service
|
|
188
|
-
* in the app sees the typed extended values.
|
|
189
|
-
*/
|
|
190
|
-
export const env = loadEnvFromSchema(envSchema)
|
|
191
|
-
|
|
192
|
-
export default envSchema
|
|
193
|
-
`}function b(){return`import { Service } from '@forinda/kickjs'
|
|
194
|
-
|
|
195
|
-
@Service()
|
|
196
|
-
export class HelloService {
|
|
197
|
-
greet(name: string) {
|
|
198
|
-
return { message: \`Hello \${name} from KickJS!\`, timestamp: new Date().toISOString() }
|
|
199
|
-
}
|
|
200
|
-
|
|
201
|
-
healthCheck() {
|
|
202
|
-
return { status: 'ok', uptime: process.uptime() }
|
|
203
|
-
}
|
|
204
|
-
}
|
|
205
|
-
`}function ee(){return`import { Controller, Get, Autowired, type Ctx } from '@forinda/kickjs'
|
|
206
|
-
import { HelloService } from './hello.service'
|
|
207
|
-
|
|
208
|
-
// \`Ctx<KickRoutes.HelloController['<method>']>\` is generated by
|
|
209
|
-
// \`kick typegen\` (auto-run on \`kick dev\`). The first run after a fresh
|
|
210
|
-
// scaffold creates \`.kickjs/types/routes.ts\` so this file typechecks.
|
|
211
|
-
// See https://kickjs.app/guide/typegen.
|
|
212
|
-
|
|
213
|
-
@Controller()
|
|
214
|
-
export class HelloController {
|
|
215
|
-
@Autowired() private readonly helloService!: HelloService
|
|
216
|
-
|
|
217
|
-
// Return-value handlers: the runtime sends the returned payload as
|
|
218
|
-
// 200 json, and \`kick typegen\` infers the response type into
|
|
219
|
-
// \`KickRoutes.Api\` — which is what makes the typed client
|
|
220
|
-
// (@forinda/kickjs-client) end-to-end type-safe.
|
|
221
|
-
@Get('/')
|
|
222
|
-
index(_ctx: Ctx<KickRoutes.HelloController['index']>) {
|
|
223
|
-
return this.helloService.greet('World')
|
|
224
|
-
}
|
|
225
|
-
|
|
226
|
-
@Get('/health')
|
|
227
|
-
health(_ctx: Ctx<KickRoutes.HelloController['health']>) {
|
|
228
|
-
return this.helloService.healthCheck()
|
|
229
|
-
}
|
|
230
|
-
}
|
|
231
|
-
`}function te(){return`import { defineModule } from '@forinda/kickjs'
|
|
232
|
-
import { HelloController } from './hello.controller'
|
|
233
|
-
|
|
234
|
-
export const HelloModule = defineModule({
|
|
235
|
-
name: 'HelloModule',
|
|
236
|
-
build: () => ({
|
|
237
|
-
// \`register(container)\` is optional — only implement it when you need
|
|
238
|
-
// to bind a token to a concrete implementation, e.g.
|
|
239
|
-
// register(container) {
|
|
240
|
-
// container.registerFactory(USER_REPOSITORY, () => container.resolve(InMemoryUserRepository))
|
|
241
|
-
// }
|
|
242
|
-
// The HelloService uses @Service() so the decorator handles registration.
|
|
243
|
-
|
|
244
|
-
routes() {
|
|
245
|
-
return {
|
|
246
|
-
path: '/hello',
|
|
247
|
-
controller: HelloController,
|
|
248
|
-
}
|
|
249
|
-
},
|
|
250
|
-
}),
|
|
251
|
-
})
|
|
252
|
-
`}function ne(e,t=`inmemory`,n=`pnpm`,r=`express`,i=!1){return`import { defineConfig } from '@forinda/kickjs-cli'
|
|
253
|
-
|
|
254
|
-
export default defineConfig({
|
|
255
|
-
pattern: '${e}',
|
|
256
|
-
// The HTTP engine this app boots on (matches \`bootstrap({ runtime })\` in
|
|
257
|
-
// src/index.ts). Dep-aware commands read it: \`kick add upload\` installs the
|
|
258
|
-
// engine's multipart driver, \`kick doctor\` checks the engine peers, and
|
|
259
|
-
// \`kick typegen\` flips the runtime escape-hatch types to this engine.
|
|
260
|
-
runtime: '${r}',
|
|
261
|
-
// Pinned so \`kick add\` and other dep-installing commands always use the
|
|
262
|
-
// project's intended package manager, regardless of which lockfile exists.
|
|
263
|
-
packageManager: '${n}',
|
|
264
|
-
modules: {
|
|
265
|
-
dir: 'src/modules',
|
|
266
|
-
repo: ${t===`inmemory`?`'inmemory'`:`{ name: '${t}' }`},
|
|
267
|
-
pluralize: true,
|
|
268
|
-
},
|
|
269
|
-
|
|
270
|
-
// \`kick typegen\` populates \`.kickjs/types/\` so \`Ctx<KickRoutes.X['method']>\`
|
|
271
|
-
// resolves to fully-typed params/body/query. Auto-runs on \`kick dev\`.
|
|
272
|
-
// \`'kickjs-schema'\` routes inference through \`InferSchemaOutput\` so the
|
|
273
|
-
// typegen works for any wrapped schema (Zod / Valibot / Yup). Switch
|
|
274
|
-
// to \`'zod'\` if you ship Zod schemas without \`fromZod()\` wrapping, or
|
|
275
|
-
// set \`schemaValidator: false\` to skip schema-driven body typing.
|
|
276
|
-
typegen: {
|
|
277
|
-
schemaValidator: 'kickjs-schema',${i?`
|
|
278
|
-
// web/ reads this map from the ambient KickClientApi namespace. Producing
|
|
279
|
-
// it builds a TypeScript program over the server, so it stays off unless a
|
|
280
|
-
// project actually consumes it.
|
|
281
|
-
client: true,`:``}
|
|
282
|
-
},
|
|
283
|
-
|
|
284
|
-
commands: [
|
|
285
|
-
{
|
|
286
|
-
name: 'test',
|
|
287
|
-
description: 'Run tests with Vitest',
|
|
288
|
-
steps: 'vitest run',
|
|
289
|
-
},
|
|
290
|
-
{
|
|
291
|
-
name: 'lint',
|
|
292
|
-
description: 'Lint with oxlint',
|
|
293
|
-
steps: 'oxlint src/',
|
|
294
|
-
},
|
|
295
|
-
{
|
|
296
|
-
name: 'format',
|
|
297
|
-
description: 'Format code with oxfmt',
|
|
298
|
-
steps: 'oxfmt src/',
|
|
299
|
-
},
|
|
300
|
-
{
|
|
301
|
-
name: 'format:check',
|
|
302
|
-
description: 'Check formatting without writing',
|
|
303
|
-
steps: 'oxfmt --check src/',
|
|
304
|
-
},
|
|
305
|
-
{
|
|
306
|
-
name: 'ci:check',
|
|
307
|
-
description: 'Run typecheck + lint + format check',
|
|
308
|
-
steps: ['kick typecheck', 'oxlint src/', 'oxfmt --check src/'],
|
|
309
|
-
aliases: ['verify'],
|
|
310
|
-
},
|
|
311
|
-
],
|
|
312
|
-
})
|
|
313
|
-
`}const x=h(u),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 d(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 T(e,t,n={}){let r=C(e,t);if(!r)throw Error(`Refusing to run '${e}': unsafe arguments`);d(r[0],r[1],{cwd:n.cwd,stdio:`inherit`,windowsHide:!0})}function E(e,t,n){let r=p(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={swagger:`@forinda/kickjs-swagger`,ws:`@forinda/kickjs-ws`,queue:`@forinda/kickjs-queue`,devtools:`@forinda/kickjs-devtools`},ae={zod:`zod`,valibot:`valibot`,yup:`yup`};function D(e,t){let n=e[t];if(!n)throw Error(`generatePackageJson: missing resolved version for ${t}. Add it to SIBLING_PACKAGES in generators/project.ts.`);return n}function oe(e,t,n,r=[],i=`zod`,a=`express`,o=!1){let s=ae[i],c={"@forinda/kickjs":D(n,`@forinda/kickjs`),"@forinda/kickjs-schema":D(n,`@forinda/kickjs-schema`),dotenv:D(n,`dotenv`),"reflect-metadata":D(n,`reflect-metadata`),[s]:D(n,s)};a===`express`?c.express=D(n,`express`):a===`fastify`?(c.fastify=D(n,`fastify`),c[`@fastify/middie`]=D(n,`@fastify/middie`),c[`serve-static`]=D(n,`serve-static`)):a===`h3`&&(c.h3=D(n,`h3`),c[`serve-static`]=D(n,`serve-static`));for(let e of r){let t=ie[e];t&&!c[t]&&(c[t]=D(n,t))}return JSON.stringify({name:e,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`},dependencies:c,devDependencies:{"@forinda/kickjs-cli":D(n,`@forinda/kickjs-cli`),"@forinda/kickjs-testing":D(n,`@forinda/kickjs-testing`),"@forinda/kickjs-vite":D(n,`@forinda/kickjs-vite`),"@types/supertest":D(n,`@types/supertest`),"@swc/core":D(n,`@swc/core`),...a===`express`?{"@types/express":D(n,`@types/express`)}:{},"@types/node":D(n,`@types/node`),"unplugin-swc":D(n,`unplugin-swc`),vite:D(n,`vite`),supertest:D(n,`supertest`),vitest:D(n,`vitest`),typescript:D(n,`typescript`),...o?{"@typescript/typescript6":D(n,`@typescript/typescript6`)}:{},oxfmt:D(n,`oxfmt`),oxlint:D(n,`oxlint`)}},null,2)}function se(e={}){return`import { defineConfig } from 'vite'
|
|
314
|
-
import { fileURLToPath } from 'node:url'
|
|
315
|
-
import swc from 'unplugin-swc'
|
|
316
|
-
import { kickjsVitePlugin, envWatchPlugin } from '@forinda/kickjs-vite'
|
|
317
|
-
|
|
318
|
-
export default defineConfig({
|
|
319
|
-
oxc: false,
|
|
320
|
-
plugins: [
|
|
321
|
-
swc.vite(),
|
|
322
|
-
kickjsVitePlugin({ entry: 'src/index.ts' }),
|
|
323
|
-
// Watches .env files and triggers a full reload on change so the
|
|
324
|
-
// dev server picks up env tweaks without a manual restart.
|
|
325
|
-
envWatchPlugin(),
|
|
326
|
-
],
|
|
327
|
-
${e.strictPort?` server: {
|
|
328
|
-
// web/vite.config.ts proxies /api to this port — fail instead of moving
|
|
329
|
-
// to another port when it's taken, or the proxy would reach the wrong process.
|
|
330
|
-
strictPort: true,
|
|
331
|
-
},
|
|
332
|
-
`:``} resolve: {
|
|
333
|
-
alias: {
|
|
334
|
-
'@': fileURLToPath(new URL('./src', import.meta.url)),
|
|
335
|
-
},
|
|
336
|
-
},
|
|
337
|
-
build: {
|
|
338
|
-
target: 'node20',
|
|
339
|
-
ssr: true,
|
|
340
|
-
outDir: 'dist',
|
|
341
|
-
sourcemap: true,
|
|
342
|
-
rollupOptions: {
|
|
343
|
-
input: fileURLToPath(new URL('./src/index.ts', import.meta.url)),
|
|
344
|
-
output: { format: 'esm' },
|
|
345
|
-
},
|
|
346
|
-
},
|
|
347
|
-
})
|
|
348
|
-
`}function O(e){let t=e.spa?`
|
|
349
|
-
# Client-side routes fall back to the app shell. The function claims /api/*
|
|
350
|
-
# through its own \`config.path\`, so this rule never sees those requests.
|
|
351
|
-
[[redirects]]
|
|
352
|
-
from = "/*"
|
|
353
|
-
to = "/index.html"
|
|
354
|
-
status = 200
|
|
355
|
-
`:``;return`[build]
|
|
356
|
-
command = "${e.command}"
|
|
357
|
-
publish = "${e.publish}"
|
|
358
|
-
|
|
359
|
-
[build.environment]
|
|
360
|
-
NODE_VERSION = "22"
|
|
361
|
-
${t}`}function k(e){return`${JSON.stringify({$schema:`https://openapi.vercel.sh/vercel.json`,framework:null,buildCommand:e},null,2)}\n`}function ce(e,t){let n=Object.entries(t);if(n.length===0)return e;let r=e===``?[]:e.replace(/\n$/,``).split(`
|
|
362
|
-
`),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(`
|
|
363
|
-
`)}\n`}function le(){return JSON.stringify({compilerOptions:{target:`ES2022`,module:`ESNext`,moduleResolution:`bundler`,lib:[`ES2022`],types:[`node`,`vite/client`],strict:!0,esModuleInterop:!0,skipLibCheck:!0,sourceMap:!0,declaration:!0,experimentalDecorators:!0,emitDecoratorMetadata:!0,outDir:`dist`,paths:{"@/*":[`./src/*`]}},include:[`src`,`.kickjs/types/**/*.d.ts`,`.kickjs/types/**/*.ts`]},null,2)}function ue(){return JSON.stringify({$schema:`./node_modules/oxfmt/configuration_schema.json`,semi:!1,singleQuote:!0,trailingComma:`all`,printWidth:100,tabWidth:2,ignorePatterns:[`**/dist/`,`**/.kickjs/`,`**/node_modules/`]},null,2)}function de(){return`# https://editorconfig.org
|
|
364
|
-
root = true
|
|
365
|
-
|
|
366
|
-
[*]
|
|
367
|
-
indent_style = space
|
|
368
|
-
indent_size = 2
|
|
369
|
-
end_of_line = lf
|
|
370
|
-
charset = utf-8
|
|
371
|
-
trim_trailing_whitespace = true
|
|
372
|
-
insert_final_newline = true
|
|
373
|
-
|
|
374
|
-
[*.md]
|
|
375
|
-
trim_trailing_whitespace = false
|
|
376
|
-
`}function fe(){return`node_modules/
|
|
377
|
-
dist/
|
|
378
|
-
.env
|
|
379
|
-
# Machine-specific: each developer's test env differs (database names, ports).
|
|
380
|
-
# The shared template is the committed \`.env.test.example\`.
|
|
381
|
-
.env.test
|
|
382
|
-
*.local
|
|
383
|
-
coverage/
|
|
384
|
-
.DS_Store
|
|
385
|
-
*.tsbuildinfo
|
|
386
|
-
.kickjs/
|
|
387
|
-
# Platform build output — written by \`kick build:netlify\` / \`kick build:vercel\`.
|
|
388
|
-
.netlify/
|
|
389
|
-
.vercel/
|
|
390
|
-
`}function pe(){return`# Auto-detect text files and normalise line endings to LF
|
|
391
|
-
* text=auto eol=lf
|
|
392
|
-
|
|
393
|
-
# Explicitly mark generated / binary files
|
|
394
|
-
*.png binary
|
|
395
|
-
*.jpg binary
|
|
396
|
-
*.jpeg binary
|
|
397
|
-
*.gif binary
|
|
398
|
-
*.ico binary
|
|
399
|
-
*.woff binary
|
|
400
|
-
*.woff2 binary
|
|
401
|
-
*.ttf binary
|
|
402
|
-
*.eot binary
|
|
403
|
-
|
|
404
|
-
# Lock files — treat as generated
|
|
405
|
-
pnpm-lock.yaml -diff linguist-generated
|
|
406
|
-
yarn.lock -diff linguist-generated
|
|
407
|
-
package-lock.json -diff linguist-generated
|
|
408
|
-
`}function A(){return`PORT=3000
|
|
409
|
-
NODE_ENV=development
|
|
410
|
-
`}function j(){return`PORT=3000
|
|
411
|
-
NODE_ENV=development
|
|
412
|
-
`}function M(){return`# Read INSTEAD of .env when NODE_ENV=test (or under vitest).
|
|
413
|
-
# No fallback to .env — declare here everything the suite needs, so a
|
|
414
|
-
# missing var fails the run instead of silently resolving to your dev value.
|
|
415
|
-
#
|
|
416
|
-
# Not committed. Add new keys to .env.test.example too, with placeholder
|
|
417
|
-
# values — never real endpoints or credentials.
|
|
418
|
-
NODE_ENV=test
|
|
419
|
-
PORT=0
|
|
420
|
-
LOG_LEVEL=silent
|
|
421
|
-
`}function N(){return`# Template for .env.test. Copy it and fill in your machine's values:
|
|
422
|
-
# cp .env.test.example .env.test
|
|
423
|
-
${M()}`}function P(){return`import { defineConfig, mergeConfig } from 'vitest/config'
|
|
424
|
-
import viteConfig from './vite.config.ts'
|
|
425
|
-
|
|
426
|
-
// A \`vitest.config.ts\` OVERRIDES \`vite.config.ts\` outright — vitest does not
|
|
427
|
-
// merge the two, and it never reads tsconfig \`paths\`. Restating settings here
|
|
428
|
-
// would mean the \`@\` alias lives in three files and drifts in two of them, so
|
|
429
|
-
// merge the real config instead: the alias, plugins, and ssr externals all come
|
|
430
|
-
// from one place.
|
|
431
|
-
export default mergeConfig(
|
|
432
|
-
viteConfig,
|
|
433
|
-
defineConfig({
|
|
434
|
-
test: {
|
|
435
|
-
globals: true,
|
|
436
|
-
environment: 'node',
|
|
437
|
-
include: ['src/**/*.test.ts'],
|
|
438
|
-
},
|
|
439
|
-
}),
|
|
440
|
-
)
|
|
441
|
-
`}const F={kickjs:{pkg:`@forinda/kickjs`,peers:[],enginePeers:!0,description:`Unified framework: DI, decorators, routing, middleware`,core:!0},vite:{pkg:`@forinda/kickjs-vite`,peers:[`vite`],description:`Vite plugin: dev server, HMR, module discovery`,dev:!0,core:!0},cli:{pkg:`@forinda/kickjs-cli`,peers:[],description:`CLI tool and code generators`,dev:!0,core:!0},zod:{pkg:`zod`,peers:[],description:`Zod schema validation (env, DTOs, OpenAPI) — wrap with fromZod()`},valibot:{pkg:`valibot`,peers:[],description:`Valibot schema validation — wrap with fromValibot()`},yup:{pkg:`yup`,peers:[],description:`Yup schema validation — wrap with fromYup()`},ai:{pkg:`@forinda/kickjs-ai`,peers:[`zod`],description:`AI toolkit — LLM providers, tool definitions from controllers`},swagger:{pkg:`@forinda/kickjs-swagger`,peers:[],description:`OpenAPI spec + Swagger UI + ReDoc`,builds:{"@scarf/scarf":!0}},db:{pkg:`@forinda/kickjs-db`,peers:[],description:`kick/db core — schema DSL, migrations, KickDbClient, customType`},pg:{pkg:`@forinda/kickjs-db`,peers:[`pg`],description:`kick/db + PostgreSQL driver (use @forinda/kickjs-db/pg)`},sqlite:{pkg:`@forinda/kickjs-db`,peers:[`better-sqlite3`],description:`kick/db + SQLite driver (use @forinda/kickjs-db/sqlite)`},mysql:{pkg:`@forinda/kickjs-db`,peers:[`mysql2`],description:`kick/db + MySQL driver (use @forinda/kickjs-db/mysql)`},ws:{pkg:`@forinda/kickjs-ws`,peers:[`ws`],description:`WebSocket with @WsController decorators`},devtools:{pkg:`@forinda/kickjs-devtools`,peers:[],description:`Development dashboard — routes, DI, metrics, health`,dev:!0},queue:{pkg:`@forinda/kickjs-queue`,peers:[],description:`Queue adapter (BullMQ/RabbitMQ/Kafka)`},"queue:bullmq":{pkg:`@forinda/kickjs-queue`,peers:[`bullmq`,`ioredis`],description:`Queue with BullMQ + Redis`},"queue:rabbitmq":{pkg:`@forinda/kickjs-queue`,peers:[`amqplib`],description:`Queue with RabbitMQ`},"queue:kafka":{pkg:`@forinda/kickjs-queue`,peers:[`kafkajs`],description:`Queue with Kafka`},"queue:redis-pubsub":{pkg:`@forinda/kickjs-queue`,peers:[`ioredis`],description:`Lightweight pub/sub via Redis (no persistence)`},mcp:{pkg:`@forinda/kickjs-mcp`,peers:[`@modelcontextprotocol/sdk`],description:`Model Context Protocol server — expose @Controller endpoints as AI tools`},testing:{pkg:`@forinda/kickjs-testing`,peers:[],description:`Test utilities and TestModule builder`,dev:!0}},I=Object.entries(F).filter(([e,t])=>!t.core&&!t.deprecated&&!e.includes(`:`)&&![`pg`,`sqlite`,`mysql`,`zod`,`valibot`,`yup`].includes(e)).map(([e])=>e).join(`, `),L={express:[`express`],fastify:[`fastify`,`@fastify/middie`,`serve-static`],h3:[`h3`,`serve-static`]},R={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 z(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 B(e=process.cwd()){return(await V(e)).runtime}async function V(e=process.cwd()){let t=(await n(e))?.runtime;return t===`express`||t===`fastify`||t===`h3`?{runtime:t,candidates:[t],ambiguous:!1,fromConfig:!0}:{...me(e),fromConfig:!1}}const H=[[`express`,`express`],[`fastify`,`fastify`],[`h3`,`h3`]];function me(e=process.cwd()){let t=U(`package.json`,e);if(!t)return{runtime:`express`,candidates:[],ambiguous:!1};let n={},r={};try{let e=JSON.parse(c(o(t,`package.json`),`utf-8`));n=e.dependencies??{},r=e.devDependencies??{}}catch{return{runtime:`express`,candidates:[],ambiguous:!1}}let i=H.filter(([e])=>e in n).map(([,e])=>e),a=H.filter(([e])=>e in r&&!(e in n)).map(([,e])=>e),s=[...i,...a];return i.length===1?{runtime:i[0],candidates:s,ambiguous:!1}:i.length===0&&a.length===1?{runtime:a[0],candidates:s,ambiguous:!1}:s.length===0?{runtime:`express`,candidates:s,ambiguous:!1}:{runtime:`express`,candidates:s,ambiguous:!0}}function U(e,t=process.cwd()){let n=t;for(;;){if(s(o(n,e)))return n;let t=i(n);if(t===n)return null;n=t}}function he(){return U(`pnpm-lock.yaml`)?`pnpm`:U(`yarn.lock`)?`yarn`:U(`bun.lockb`)||U(`bun.lock`)?`bun`:U(`package-lock.json`)?`npm`:null}function ge(){let e=process.cwd();for(;e;){let t=o(e,`package.json`);if(s(t))try{let e=JSON.parse(c(t,`utf-8`)).packageManager;if(typeof e==`string`){let t=e.split(`@`)[0];if(r.includes(t))return t}}catch{}let n=i(e);if(n===e)return null;e=n}return null}async function W(e){if(e&&r.includes(e))return{pm:e,source:`flag`};let t=await n(process.cwd());if(t?.packageManager&&r.includes(t.packageManager))return{pm:t.packageManager,source:`config`};let i=ge();if(i)return{pm:i,source:`package.json`};let a=he();return a?{pm:a,source:`lockfile`}:{pm:`npm`,source:`default`}}async function _e(e){let{pm:t}=await W(e);return t}function G(e=!1,t){let n=Object.entries(F),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,...L[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(`
|
|
442
|
-
Core packages (always installed by \`kick new\`):
|
|
443
|
-
`);for(let e of i)console.log(o(e));if(e){console.log(`
|
|
444
|
-
Optional packages (add as needed):
|
|
445
|
-
`);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(`
|
|
446
|
-
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 K={"@swc/core":!0,esbuild:!0};function q(e,t,n){if(e===`pnpm`){let e=o(t,`pnpm-workspace.yaml`),r=s(e)?c(e,`utf-8`):``,i=ce(r,n);return i===r?void 0:(l(e,i),e)}if(e!==`npm`&&e!==`bun`)return;let r=o(t,`package.json`);if(!s(r))return;let i=JSON.parse(c(r,`utf-8`)),a=!1;if(e===`npm`){let e=i.allowScripts??{};for(let[t,r]of Object.entries(n))Object.keys(e).some(e=>e===t||e.startsWith(`${t}@`))||(e[t]=r,a=!0);i.allowScripts=e}else{let e=i.trustedDependencies??[];for(let[t,r]of Object.entries(n))r&&!e.includes(t)&&(e.push(t),a=!0);i.trustedDependencies=e}if(a)return l(r,`${JSON.stringify(i,null,2)}\n`),r}function ve(e){if(e===`pnpm`)return U(`pnpm-workspace.yaml`)??process.cwd();for(let e=process.cwd();;e=i(e)){try{if(JSON.parse(c(o(e,`package.json`),`utf-8`)).workspaces)return e}catch{}if(i(e)===e)return process.cwd()}}function J(e){return Object.assign({},...e.map(e=>F[e]?.builds??{}))}function ye(e,t,n=`express`){let r=new Set,i=new Set,a=[],o=[],s=[];for(let c of e){if(c===`upload`){let e=R[n];s.push(`upload (${n}): ${e.note}`),e.prod&&(t?i:r).add(e.prod),e.dev&&i.add(e.dev);continue}let e=F[c];if(!e){a.push(c);continue}e.deprecated&&o.push(`'${c}' (${e.pkg}) is deprecated — ${e.deprecated}`);let l=t||e.dev?i:r;l.add(e.pkg);for(let t of e.peers)l.add(t);if(e.enginePeers){let e=L[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 be(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=>{G(!!e.all,z(e.runtime)??await B())})}function xe(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`).action(async(e,t)=>{if(t.list||e.length===0){G(!!t.all,z(t.runtime)??await B());return}let{pm:n,source:r}=await W(t.pm);console.log(`\n Using ${n} (resolved from ${r})`);let i=z(t.runtime),a=await V(process.cwd()),o=i??a.runtime;if(!i&&a.ambiguous){console.error(`\n Cannot tell which HTTP engine this app boots on: found ${a.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 <${a.candidates.join(`|`)}> for this command\n`),process.exitCode=1;return}let{prodDeps:s,devDeps:c,unknown:l,warnings:u,notices:d}=ye(e,!!t.dev,o);for(let e of u)console.warn(`\n WARNING: ${e}`);for(let e of d)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.
|
|
447
|
-
`),s.length===0&&c.length===0))return;let p=J(e);if(Object.keys(p).length>0){let e=q(n,ve(n),p);e&&console.log(`\n Approved install scripts in ${e}`)}if(s.length>0){let e=s,t=`${n} add ${e.join(` `)}`;console.log(`\n Installing ${e.length} dependency(ies):`);for(let t of e)console.log(` + ${t}`);console.log();try{f(t,{stdio:`inherit`})}catch{console.log(`\n Installation failed. Run manually:\n ${t}\n`)}}if(c.length>0){let e=c,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{f(t,{stdio:`inherit`})}catch{console.log(`\n Installation failed. Run manually:\n ${t}\n`)}}console.log(` Done!
|
|
448
|
-
`)})}const Y=i(m(import.meta.url)),X=JSON.parse(c([a(Y,`..`,`package.json`),a(Y,`..`,`..`,`package.json`)].find(s),`utf-8`)),Se=[`@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`],Z={react:{fallback:`^19.0.0`},"react-dom":{fallback:`^19.0.0`},"@types/react":{fallback:`^19.0.0`},"@types/react-dom":{fallback:`^19.0.0`},"@vitejs/plugin-react":{fallback:`^5.0.0`},"@types/node":{fallback:`^25.0.0`},"@types/supertest":{fallback:`^7.2.1`},supertest:{fallback:`^7.2.2`},vitest:{fallback:`^4.1.2`},"@swc/core":{fallback:`^1.15.21`},"unplugin-swc":{fallback:`^1.5.9`},oxfmt:{fallback:`^0.65.0`},oxlint:{fallback:`^1.80.0`},dotenv:{fallback:`^17.3.1`},"reflect-metadata":{fallback:`^0.2.2`},vite:{fallback:`^8.0.3`,cap:`^8`},typescript:{fallback:`^7.0.2`,cap:`^7`},"@typescript/typescript6":{fallback:`^6.0.2`,cap:`^6`},express:{fallback:`^5.1.0`,cap:`^5`},"@types/express":{fallback:`^5.0.6`,cap:`^5`},fastify:{fallback:`^5.0.0`,cap:`^5`},"@fastify/middie":{fallback:`^9.0.0`,cap:`^9`},h3:{fallback:`^1.0.0`,cap:`^1`},"serve-static":{fallback:`^2.2.0`,cap:`^2`},zod:{fallback:`^4.3.6`,cap:`^4`},valibot:{fallback:`^1.4.1`,cap:`^1`},yup:{fallback:`^1.7.1`,cap:`^1`}};function Ce(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 we(e){return e===`@forinda/kickjs-cli`?`^${X.version}`:`latest`}async function Te(e,t,n){let r=Array.from({length:e.length}),i=0,a=Array.from({length:Math.min(t,e.length)},async()=>{for(;i<e.length;){let t=i++;r[t]=await n(e[t])}});return await Promise.all(a),r}async function Q(){let e=[...Se.map(e=>({name:e,fallback:we(e),cap:void 0})),...Object.entries(Z).map(([e,t])=>({name:e,...t}))],t=Date.now()+2e4,n=await Te(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=Ce(await re(`npm`,r?[`view`,a,`version`,`--json`]:[`view`,a,`version`],{timeout:i}));return[e,o?`^${o}`:n]});return Object.fromEntries(n)}function Ee(e,t){let n=w(`npm`,[`view`,`${e}@${t}`,`version`],{timeout:2e4});return n&&/^\d+\.\d+\.\d+/.test(n)?n:null}function $(e){return(e??``).replace(/^[\^~>=<\s]+/,``)}function De(e,t){let n=e=>$(e).split(`-`)[0].split(`.`).map(e=>Number.parseInt(e,10)||0),[r=0,i=0,a=0]=n(e),[o=0,s=0,c=0]=n(t);return r===o?i===s?a>=c:i>s:r>o}function Oe(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 ke(n){let{name:r,directory:i,packageManager:o=`pnpm`,template:s=`rest`,defaultRepo:c=`inmemory`,packages:l=[],schemaLib:u=`zod`,runtime:d=`express`}=n,p=i,m=e=>console.log(` ${e}`);console.log(`\n Creating KickJS project: ${r}\n`),n.versions||m(`Resolving package versions...`);let h=n.versions??await Q(),g=Object.keys(h).filter(e=>h[e]===`latest`);if(g.length>0&&m(`WARNING: could not reach npm for ${g.join(`, `)} — pinned to 'latest'`),d!==`express`){if(Oe(`@forinda/kickjs`,`latest`,`./${d}`))m(`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=Ee(r,`alpha`);e&&De(e,$(h[r]))&&(h[r]=`^${e}`,t.push(`${r}@^${e}`),r===`@forinda/kickjs`&&(n=!0))}m(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: ${o} add @forinda/kickjs@alpha`)}}await e(a(p,`package.json`),oe(r,s,h,l,u,d,n.withClientMap)),await e(a(p,`vite.config.ts`),se({strictPort:n.strictPort})),await e(a(p,`tsconfig.json`),le()),await e(a(p,`.oxfmtrc.json`),ue()),await e(a(p,`.editorconfig`),de()),await e(a(p,`.gitignore`),fe()),await e(a(p,`.gitattributes`),pe()),await e(a(p,`.env`),A()),await e(a(p,`.env.example`),j()),await e(a(p,`.env.test`),M()),await e(a(p,`.env.test.example`),N()),await e(a(p,`src/config/index.ts`),y(u)),await e(a(p,`src/index.ts`),_(r,s,X.version,l,d,n.spaClientDir)),await e(a(p,`src/modules/index.ts`),v()),await e(a(p,`src/modules/hello/hello.service.ts`),b()),await e(a(p,`src/modules/hello/hello.controller.ts`),ee()),await e(a(p,`src/modules/hello/hello.module.ts`),te()),await e(a(p,`kick.config.ts`),ne(s,c,o,d,n.withClientMap)),await e(a(p,`vitest.config.ts`),P()),await e(a(p,`README.md`),t(r,s,o));let{generateAgentDocs:x}=await import(`./agent-docs-DWRW_0cn.mjs`).then(e=>e.t);if(await x({outDir:p,name:r,pm:o,template:s,only:`all`,force:!0}),n.platformConfig!==!1&&(await e(a(p,`netlify.toml`),O({command:`${o} run build:netlify`,publish:`dist/public`,spa:!1})),await e(a(p,`vercel.json`),k(`${o} run build:vercel`))),n.approveInstallScripts!==!1&&q(o,p,{...K,...J(l)}),n.installDeps){console.log(`\n Installing dependencies with ${o}...\n`);try{f(`${o} install`,{cwd:p,stdio:`inherit`}),console.log(`
|
|
449
|
-
Dependencies installed successfully!`)}catch{console.log(`\n Warning: ${o} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-COTKpuqW.mjs`).then(e=>e.n);await e({cwd:p,allowDuplicates:!0,silent:!0})}catch{}if(n.initGit)try{f(`git init`,{cwd:p,stdio:`pipe`}),f(`git branch -M main`,{cwd:p,stdio:`pipe`}),f(`git add -A`,{cwd:p,stdio:`pipe`}),f(`git commit -m "chore: initial commit from kick new"`,{cwd:p,stdio:`pipe`}),m(`Git repository initialized`)}catch{m(`Warning: git init failed (git may not be installed)`)}console.log(`
|
|
450
|
-
Project scaffolded successfully!`),console.log();let S=p!==process.cwd();m(`Next steps:`),S&&m(` cd ${r}`),n.installDeps||m(` ${o} install`);let C={rest:`kick g module user`,minimal:`# add your routes to src/index.ts`};m(` ${C[s]??C.rest}`),m(` kick dev`),m(``),m(`Commands:`),m(` kick dev Start dev server with Vite HMR`),m(` kick build Production build via Vite`),m(` kick start Run production build`),m(``),m(`Generators:`),m(` kick g module <name> REST module (controller, service, DTOs, repository)`),m(` kick g scaffold <n> <f..> CRUD module from field definitions`),m(` kick g controller <name> Standalone controller`),m(` kick g service <name> @Service() class`),m(` kick g middleware <name> Global connect-style middleware`),m(` kick g guard <name> Route guard (auth, roles, etc.)`),m(` kick g adapter <name> AppAdapter with lifecycle hooks`),m(` kick g dto <name> DTO schema (Zod / Valibot / Yup)`),m(` kick g config Generate kick.config.ts`),m(``),m(`Add packages:`),m(` kick add <pkg> Install a KickJS package + peers`),m(` kick add --list Show all available packages`),m(``),m(`Available: ${I}`),m(``)}export{R as a,be as c,O as d,k as f,K as i,B as l,E as m,Q as n,q as o,T as p,F as r,xe as s,ke as t,_e as u};
|
|
451
|
-
//# sourceMappingURL=project-JoccwqS2.mjs.map
|