@forinda/kickjs 2.2.4 → 2.3.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/README.md +70 -18
- package/dist/{application-CLkVCFWJ.mjs → application-B91xATK0.mjs} +15 -15
- package/dist/application-B91xATK0.mjs.map +1 -0
- package/dist/{bootstrap-cTXpK1QK.mjs → bootstrap-Dqw-_Yix.mjs} +17 -30
- package/dist/bootstrap-Dqw-_Yix.mjs.map +1 -0
- package/dist/{chunk-DnmL-75g.mjs → chunk-Cl8sPHRO.mjs} +1 -1
- package/dist/config/index.mjs +3 -3
- package/dist/{config-Cc29Xd0g.mjs → config-CQCVrxpN.mjs} +3 -3
- package/dist/{config-Cc29Xd0g.mjs.map → config-CQCVrxpN.mjs.map} +1 -1
- package/dist/{container-CMuZkVRS.mjs → container-0sTWvL-c.mjs} +3 -3
- package/dist/{container-CMuZkVRS.mjs.map → container-0sTWvL-c.mjs.map} +1 -1
- package/dist/core/adapter.mjs +1 -1
- package/dist/core/app-module.mjs +1 -1
- package/dist/core/cache.mjs +1 -1
- package/dist/core/container.mjs +2 -2
- package/dist/core/cron.mjs +2 -2
- package/dist/core/decorators.mjs +3 -3
- package/dist/core/errors.mjs +1 -1
- package/dist/core/interfaces.mjs +1 -1
- package/dist/core/logger.mjs +1 -1
- package/dist/core/path.mjs +1 -1
- package/dist/core/plugin.mjs +1 -1
- package/dist/core/reactivity.mjs +1 -1
- package/dist/{core-D-167yQ4.mjs → core-YLypdG22.mjs} +4 -4
- package/dist/{core-D-167yQ4.mjs.map → core-YLypdG22.mjs.map} +1 -1
- package/dist/{env-C9zCAyMW.mjs → env-X5N7dpDg.mjs} +4 -4
- package/dist/{env-C9zCAyMW.mjs.map → env-X5N7dpDg.mjs.map} +1 -1
- package/dist/http/application.mjs +2 -2
- package/dist/http/bootstrap.d.mts +6 -21
- package/dist/http/bootstrap.d.mts.map +1 -1
- package/dist/http/bootstrap.mjs +2 -2
- package/dist/http/context.mjs +2 -2
- package/dist/http/middleware/cors.mjs +1 -1
- package/dist/http/middleware/csrf.mjs +1 -1
- package/dist/http/middleware/error-handler.mjs +2 -2
- package/dist/http/middleware/helmet.mjs +1 -1
- package/dist/http/middleware/rate-limit.mjs +1 -1
- package/dist/http/middleware/request-id.mjs +1 -1
- package/dist/http/middleware/request-logger.mjs +2 -2
- package/dist/http/middleware/session.mjs +1 -1
- package/dist/http/middleware/spa.mjs +4 -4
- package/dist/http/middleware/spa.mjs.map +1 -1
- package/dist/http/middleware/upload.mjs +1 -1
- package/dist/http/middleware/validate.mjs +1 -1
- package/dist/http/middleware/views.mjs +3 -3
- package/dist/http/middleware/views.mjs.map +1 -1
- package/dist/http/query/index.mjs +2 -2
- package/dist/http/router-builder.mjs +4 -4
- package/dist/{index-BGnxOrN2.d.mts → index-CwqjAF6I.d.mts} +7 -2
- package/dist/index-CwqjAF6I.d.mts.map +1 -0
- package/dist/index.d.mts +1 -1
- package/dist/index.mjs +9 -9
- package/dist/{metadata-DaP_5Q0Y.mjs → metadata-zDHf1djN.mjs} +2 -2
- package/dist/metadata-zDHf1djN.mjs.map +1 -0
- package/dist/{query-CnxrNfxU.mjs → query-CMgddGGI.mjs} +2 -2
- package/dist/{query-CnxrNfxU.mjs.map → query-CMgddGGI.mjs.map} +1 -1
- package/package.json +1 -1
- package/dist/application-CLkVCFWJ.mjs.map +0 -1
- package/dist/bootstrap-cTXpK1QK.mjs.map +0 -1
- package/dist/index-BGnxOrN2.d.mts.map +0 -1
- package/dist/metadata-DaP_5Q0Y.mjs.map +0 -1
package/README.md
CHANGED
|
@@ -34,26 +34,78 @@ kick new my-api && cd my-api && kick dev
|
|
|
34
34
|
|
|
35
35
|
## Hello World
|
|
36
36
|
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
37
|
+
A fresh `kick new my-api` scaffolds a complete project. Here are the files
|
|
38
|
+
that matter, exactly as the CLI generates them:
|
|
39
|
+
|
|
40
|
+
```ts
|
|
41
|
+
// src/modules/hello/hello.service.ts
|
|
42
|
+
import { Service } from '@forinda/kickjs'
|
|
40
43
|
|
|
41
44
|
@Service()
|
|
42
|
-
class
|
|
43
|
-
greet(name: string) {
|
|
45
|
+
export class HelloService {
|
|
46
|
+
greet(name: string) {
|
|
47
|
+
return { message: `Hello ${name} from KickJS!`, timestamp: new Date().toISOString() }
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
healthCheck() {
|
|
51
|
+
return { status: 'ok', uptime: process.uptime() }
|
|
52
|
+
}
|
|
44
53
|
}
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
```ts
|
|
57
|
+
// src/modules/hello/hello.controller.ts
|
|
58
|
+
import { Controller, Get, Autowired, type Ctx } from '@forinda/kickjs'
|
|
59
|
+
import { HelloService } from './hello.service'
|
|
45
60
|
|
|
46
61
|
@Controller()
|
|
47
|
-
class HelloController {
|
|
48
|
-
@Autowired() private
|
|
62
|
+
export class HelloController {
|
|
63
|
+
@Autowired() private readonly helloService!: HelloService
|
|
49
64
|
|
|
50
65
|
@Get('/')
|
|
51
|
-
|
|
52
|
-
ctx.json(
|
|
66
|
+
index(ctx: Ctx<KickRoutes.HelloController['index']>) {
|
|
67
|
+
ctx.json(this.helloService.greet('World'))
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
@Get('/health')
|
|
71
|
+
health(ctx: Ctx<KickRoutes.HelloController['health']>) {
|
|
72
|
+
ctx.json(this.helloService.healthCheck())
|
|
53
73
|
}
|
|
54
74
|
}
|
|
75
|
+
```
|
|
55
76
|
|
|
56
|
-
|
|
77
|
+
```ts
|
|
78
|
+
// src/modules/hello/hello.module.ts
|
|
79
|
+
import { type AppModule, type ModuleRoutes, buildRoutes } from '@forinda/kickjs'
|
|
80
|
+
import { HelloController } from './hello.controller'
|
|
81
|
+
|
|
82
|
+
export class HelloModule implements AppModule {
|
|
83
|
+
routes(): ModuleRoutes {
|
|
84
|
+
return {
|
|
85
|
+
path: '/hello',
|
|
86
|
+
router: buildRoutes(HelloController),
|
|
87
|
+
controller: HelloController,
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
```ts
|
|
94
|
+
// src/modules/index.ts
|
|
95
|
+
import type { AppModuleClass } from '@forinda/kickjs'
|
|
96
|
+
import { HelloModule } from './hello/hello.module'
|
|
97
|
+
|
|
98
|
+
export const modules: AppModuleClass[] = [HelloModule]
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
```ts
|
|
102
|
+
// src/index.ts
|
|
103
|
+
import 'reflect-metadata'
|
|
104
|
+
import './config' // registers env schema before bootstrap
|
|
105
|
+
import { bootstrap } from '@forinda/kickjs'
|
|
106
|
+
import { modules } from './modules'
|
|
107
|
+
|
|
108
|
+
export const app = await bootstrap({ modules })
|
|
57
109
|
```
|
|
58
110
|
|
|
59
111
|
## What's Included
|
|
@@ -90,23 +142,23 @@ import {
|
|
|
90
142
|
|
|
91
143
|
## Typed Routes, Body, Query, and Env
|
|
92
144
|
|
|
93
|
-
|
|
94
|
-
your codebase.
|
|
95
|
-
|
|
145
|
+
`kick typegen` (auto-runs on `kick dev`) generates `KickRoutes` and `KickEnv`
|
|
146
|
+
from your codebase. Route handlers, request bodies, query strings, and
|
|
147
|
+
`@Value` injections are all type-checked end-to-end:
|
|
96
148
|
|
|
97
|
-
```
|
|
98
|
-
import { Controller, Post,
|
|
149
|
+
```ts
|
|
150
|
+
import { Controller, Post, Value, type Ctx } from '@forinda/kickjs'
|
|
99
151
|
import { z } from 'zod'
|
|
100
152
|
|
|
101
153
|
const createUserBody = z.object({ name: z.string(), email: z.string().email() })
|
|
102
154
|
|
|
103
155
|
@Controller('/users')
|
|
104
156
|
class UserController {
|
|
105
|
-
// Typed env injection — keys come from KickEnv (your src/
|
|
157
|
+
// Typed env injection — keys come from KickEnv (your src/config/index.ts)
|
|
106
158
|
@Value('DATABASE_URL') private dbUrl!: string
|
|
107
159
|
|
|
108
|
-
@Post('/', { body: createUserBody })
|
|
109
|
-
create(ctx: Ctx<KickRoutes['
|
|
160
|
+
@Post('/', { body: createUserBody, name: 'CreateUser' })
|
|
161
|
+
create(ctx: Ctx<KickRoutes.UserController['create']>) {
|
|
110
162
|
ctx.body.email // ✅ string — inferred from the Zod schema
|
|
111
163
|
ctx.created({ id: '1', ...ctx.body })
|
|
112
164
|
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v2.
|
|
2
|
+
* @forinda/kickjs v2.3.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -10,10 +10,10 @@
|
|
|
10
10
|
*/
|
|
11
11
|
import { METADATA } from "./core/interfaces.mjs";
|
|
12
12
|
import { Logger, createLogger } from "./core/logger.mjs";
|
|
13
|
-
import { t as getClassMeta } from "./metadata-
|
|
14
|
-
import { t as Container } from "./container-
|
|
13
|
+
import { t as getClassMeta } from "./metadata-zDHf1djN.mjs";
|
|
14
|
+
import { t as Container } from "./container-0sTWvL-c.mjs";
|
|
15
15
|
import { normalizePath } from "./core/path.mjs";
|
|
16
|
-
import "./core-
|
|
16
|
+
import "./core-YLypdG22.mjs";
|
|
17
17
|
import { requestId } from "./http/middleware/request-id.mjs";
|
|
18
18
|
import { errorHandler, notFoundHandler } from "./http/middleware/error-handler.mjs";
|
|
19
19
|
import http from "node:http";
|
|
@@ -155,7 +155,7 @@ var Application = class {
|
|
|
155
155
|
}
|
|
156
156
|
}
|
|
157
157
|
async setup() {
|
|
158
|
-
log.
|
|
158
|
+
log.debug("Bootstrapping application...");
|
|
159
159
|
const adapterMw = this.collectAdapterMiddleware();
|
|
160
160
|
this.app.__kickApp = this;
|
|
161
161
|
const ctx = this.adapterCtx();
|
|
@@ -225,7 +225,7 @@ var Application = class {
|
|
|
225
225
|
return i === -1 ? 99 : i;
|
|
226
226
|
};
|
|
227
227
|
let totalRoutes = 0;
|
|
228
|
-
log.
|
|
228
|
+
log.debug("Routes:");
|
|
229
229
|
for (const { controller, mountPath } of mountedRoutes) {
|
|
230
230
|
const defs = getClassMeta(METADATA.ROUTES, controller, []);
|
|
231
231
|
if (defs.length === 0) continue;
|
|
@@ -237,9 +237,9 @@ var Application = class {
|
|
|
237
237
|
totalRoutes += defs.length;
|
|
238
238
|
const methods = Object.entries(counts).sort(([a], [b]) => methodRank(a) - methodRank(b)).map(([m, n]) => `${n} ${m}`).join(", ");
|
|
239
239
|
const name = controller.name || "Controller";
|
|
240
|
-
log.
|
|
240
|
+
log.debug(` ${name.padEnd(30)} ${mountPath.padEnd(25)} ${defs.length} routes (${methods})`);
|
|
241
241
|
}
|
|
242
|
-
log.
|
|
242
|
+
log.debug(` Total: ${totalRoutes} routes`);
|
|
243
243
|
}
|
|
244
244
|
this.mountMiddlewareList(adapterMw.afterRoutes);
|
|
245
245
|
this.app.use(this.options.onNotFound ?? notFoundHandler());
|
|
@@ -264,7 +264,7 @@ var Application = class {
|
|
|
264
264
|
const g = globalThis;
|
|
265
265
|
if (g.__kickjs_httpServer) {
|
|
266
266
|
this.httpServer = g.__kickjs_httpServer;
|
|
267
|
-
log.
|
|
267
|
+
log.debug("Attached to Vite dev server");
|
|
268
268
|
for (const adapter of this.adapters) {
|
|
269
269
|
const ctx = this.adapterCtx(this.httpServer);
|
|
270
270
|
await this.callHook(adapter.afterStart?.bind(adapter), ctx);
|
|
@@ -315,7 +315,7 @@ var Application = class {
|
|
|
315
315
|
if (this.httpServer) {
|
|
316
316
|
this.httpServer.removeAllListeners("request");
|
|
317
317
|
this.httpServer.on("request", this.app);
|
|
318
|
-
log.
|
|
318
|
+
log.debug("HMR: Express app rebuilt and swapped");
|
|
319
319
|
}
|
|
320
320
|
}
|
|
321
321
|
/**
|
|
@@ -330,12 +330,12 @@ var Application = class {
|
|
|
330
330
|
*/
|
|
331
331
|
async shutdown() {
|
|
332
332
|
if (this._shutdownInitiated) {
|
|
333
|
-
log.
|
|
333
|
+
log.debug("Shutdown already in progress, skipping duplicate call");
|
|
334
334
|
return;
|
|
335
335
|
}
|
|
336
336
|
this._shutdownInitiated = true;
|
|
337
337
|
this._draining = true;
|
|
338
|
-
log.
|
|
338
|
+
log.debug("Shutting down — draining in-flight requests...");
|
|
339
339
|
const timeoutMs = this.options.shutdownTimeout ?? 3e4;
|
|
340
340
|
let timer;
|
|
341
341
|
const forceExitPromise = timeoutMs > 0 ? new Promise((resolve) => {
|
|
@@ -345,12 +345,12 @@ var Application = class {
|
|
|
345
345
|
try {
|
|
346
346
|
if (this.httpServer) this.httpServer.close(() => {});
|
|
347
347
|
if (this._inFlightRequests > 0) {
|
|
348
|
-
log.
|
|
348
|
+
log.debug(`Waiting for ${this._inFlightRequests} in-flight request(s) to complete...`);
|
|
349
349
|
const drainPromise = new Promise((resolve) => {
|
|
350
350
|
this._drainResolvers.push(() => resolve("drained"));
|
|
351
351
|
});
|
|
352
352
|
if (await Promise.race([drainPromise, forceExitPromise]) === "timeout") log.warn(`Shutdown timeout (${timeoutMs}ms) reached with ${this._inFlightRequests} request(s) still in-flight, forcing shutdown`);
|
|
353
|
-
else log.
|
|
353
|
+
else log.debug("All in-flight requests completed");
|
|
354
354
|
}
|
|
355
355
|
const results = await Promise.allSettled([...this.plugins.map((plugin) => Promise.resolve(plugin.shutdown?.())), ...this.adapters.map((adapter) => Promise.resolve(adapter.shutdown?.()))]);
|
|
356
356
|
for (const result of results) if (result.status === "rejected") log.error({ err: result.reason }, "Adapter shutdown failed");
|
|
@@ -446,4 +446,4 @@ var Application = class {
|
|
|
446
446
|
//#endregion
|
|
447
447
|
export { requestStore as i, requestScopeMiddleware as n, getRequestStore as r, Application as t };
|
|
448
448
|
|
|
449
|
-
//# sourceMappingURL=application-
|
|
449
|
+
//# sourceMappingURL=application-B91xATK0.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"application-B91xATK0.mjs","names":[],"sources":["../src/http/request-store.ts","../src/http/middleware/request-scope.ts","../src/http/application.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks'\n\n/** Per-request storage for REQUEST-scoped DI and request context propagation */\nexport interface RequestStore {\n /** Unique request identifier */\n requestId: string\n /** Per-request singleton cache for REQUEST-scoped services */\n instances: Map<any, any>\n /** Per-request values set by middleware (auth user, tenant, etc.) */\n values: Map<any, any>\n}\n\n/** AsyncLocalStorage instance shared across the framework */\nexport const requestStore = new AsyncLocalStorage<RequestStore>()\n\n/**\n * Get the current request store. Throws if called outside a request context.\n * Used by the Container to resolve REQUEST-scoped dependencies.\n */\nexport function getRequestStore(): RequestStore {\n const store = requestStore.getStore()\n if (!store) {\n throw new Error(\n 'No active request context. REQUEST-scoped services can only be resolved during an HTTP request.',\n )\n }\n return store\n}\n","import crypto from 'node:crypto'\nimport type { Request, Response, NextFunction } from 'express'\nimport { requestStore, type RequestStore } from '../request-store'\n\n/**\n * Wraps each request in an AsyncLocalStorage context.\n * Enables REQUEST-scoped DI and automatic requestId propagation to logs.\n *\n * Should be mounted early in the middleware pipeline (before route handlers).\n */\nexport function requestScopeMiddleware() {\n return (req: Request, _res: Response, next: NextFunction) => {\n const requestIdHeader = req.headers['x-request-id']\n const requestId =\n (Array.isArray(requestIdHeader) ? requestIdHeader[0] : requestIdHeader) || crypto.randomUUID()\n const store: RequestStore = {\n requestId,\n instances: new Map(),\n values: new Map(),\n }\n requestStore.run(store, () => next())\n }\n}\n","import http from 'node:http'\nimport express, { type Express, type RequestHandler } from 'express'\nimport {\n Container,\n createLogger,\n Logger,\n normalizePath,\n METADATA,\n type AppModuleClass,\n type AppAdapter,\n type AdapterContext,\n type AdapterMiddleware,\n type KickPlugin,\n type RouteDefinition,\n} from '../core'\nimport { getClassMeta } from '../core/metadata'\nimport { requestId } from './middleware/request-id'\nimport { notFoundHandler, errorHandler } from './middleware/error-handler'\nimport { requestScopeMiddleware } from './middleware/request-scope'\nimport { requestStore, getRequestStore } from './request-store'\n\nconst log = createLogger('Application')\n\n/**\n * A middleware entry in the declarative pipeline.\n * Can be a bare handler or an object with path scoping.\n */\nexport type MiddlewareEntry = RequestHandler | { path: string; handler: RequestHandler }\n\nexport interface ApplicationOptions {\n /** Feature modules to load */\n modules: AppModuleClass[]\n /** Adapters that hook into the lifecycle (DB, Redis, Swagger, etc.) */\n adapters?: AppAdapter[]\n /** Server port (falls back to PORT env var, then 3000) */\n port?: number\n /** Global API prefix (default: '/api') */\n apiPrefix?: string\n /** Default API version (default: 1) — routes become /{prefix}/v{version}/{path} */\n defaultVersion?: number\n\n /**\n * Global middleware pipeline. Declared in order.\n * Replaces the hardcoded middleware stack — you control exactly what runs.\n *\n * @example\n * ```ts\n * bootstrap({\n * modules,\n * middleware: [\n * helmet(),\n * cors(),\n * compression(),\n * morgan('dev'),\n * express.json({ limit: '1mb' }),\n * ],\n * })\n * ```\n *\n * If omitted, a sensible default is applied:\n * requestId(), express.json({ limit: '100kb' })\n */\n middleware?: MiddlewareEntry[]\n\n /** Plugins that bundle modules, adapters, middleware, and DI bindings */\n plugins?: KickPlugin[]\n\n /** Express `trust proxy` setting */\n trustProxy?: boolean | number | string | ((ip: string, hopIndex: number) => boolean)\n /** Maximum JSON body size (only used when middleware is not provided) */\n jsonLimit?: string | number\n /**\n * Log route summary on startup. Default: true in dev, false in production.\n * Set to `true` to always log, `false` to always suppress.\n */\n logRoutesTable?: boolean\n /**\n * Maximum time (ms) to wait for graceful shutdown before forcing exit.\n * Default: 30000 (30 seconds). Set to 0 to disable forced exit.\n */\n shutdownTimeout?: number\n\n /**\n * Enable cluster mode for multi-core utilization.\n *\n * When enabled, the primary process forks worker processes that share the\n * same port via Node's built-in `cluster` module (OS load balancing).\n *\n * - `true` — use all available CPU cores\n * - `{ workers: N }` — use exactly N workers\n *\n * Workers are auto-restarted on crash. SIGTERM/SIGINT on the primary is\n * forwarded to all workers.\n *\n * @example\n * ```ts\n * bootstrap({ modules, cluster: true })\n * bootstrap({ modules, cluster: { workers: 4 } })\n * ```\n */\n cluster?: boolean | { workers?: number }\n\n /**\n * Custom 404 handler for unmatched routes. Receives the raw Express\n * `(req, res, next)` args. When omitted, the built-in handler returns\n * `{ message: 'Not Found' }` with status 404.\n *\n * @example\n * ```ts\n * bootstrap({\n * modules,\n * onNotFound: (req, res) => {\n * res.status(404).json({ error: 'Route not found', path: req.originalUrl })\n * },\n * })\n * ```\n */\n onNotFound?: (req: any, res: any, next: any) => void\n\n /**\n * Custom global error handler. Receives `(err, req, res, next)` — the\n * standard Express error-handling signature. When omitted, the built-in\n * handler formats ZodError, HttpException, and unexpected errors.\n *\n * @example\n * ```ts\n * bootstrap({\n * modules,\n * onError: (err, req, res, next) => {\n * logger.error(err)\n * res.status(err.status ?? 500).json({ error: err.message })\n * },\n * })\n * ```\n */\n onError?: (err: any, req: any, res: any, next: any) => void\n}\n\n/**\n * The main application class. Wires together Express, the DI container,\n * feature modules, adapters, and the middleware pipeline.\n */\nexport class Application {\n private app: Express\n private container: Container\n private httpServer: http.Server | null = null\n private adapters: AppAdapter[]\n\n private plugins: KickPlugin[]\n\n /** Number of HTTP requests currently being processed */\n private _inFlightRequests = 0\n /** Whether the application is draining (shutting down gracefully) */\n private _draining = false\n /** Whether shutdown has already been initiated (prevents double-shutdown) */\n private _shutdownInitiated = false\n /** Resolvers waiting for in-flight requests to reach zero */\n private _drainResolvers: Array<() => void> = []\n\n constructor(private readonly options: ApplicationOptions) {\n this.app = express()\n this.container = Container.getInstance()\n this.plugins = options.plugins ?? []\n this.adapters = [\n // Plugin adapters first\n ...this.plugins.flatMap((p) => p.adapters?.() ?? []),\n ...(options.adapters ?? []),\n ]\n // Wire the request store provider so Container can resolve REQUEST-scoped deps\n Container._requestStoreProvider = () => requestStore.getStore() ?? null\n // Wire logger context provider so logs auto-include requestId\n Logger._contextProvider = () => {\n const store = requestStore.getStore()\n if (!store) return null\n const ctx: Record<string, any> = { requestId: store.requestId }\n const traceId = store.values.get('traceId')\n if (traceId) ctx.traceId = traceId\n const spanId = store.values.get('spanId')\n if (spanId) ctx.spanId = spanId\n return ctx\n }\n }\n\n /** Whether the application is currently draining in-flight requests */\n get isDraining(): boolean {\n return this._draining\n }\n\n /** Number of HTTP requests currently being processed */\n get inFlightRequests(): number {\n return this._inFlightRequests\n }\n\n /** Get the DI container instance */\n getContainer(): Container {\n return this.container\n }\n\n /**\n * Express request handler — delegates to the internal Express app.\n *\n * Used by the Vite dev-server plugin to route requests through KickJS:\n * ```ts\n * const mod = await ssrLoadModule('virtual:kickjs/app')\n * mod.app.handle(req, res, next)\n * ```\n *\n * Also works as a standard Node.js request handler for production:\n * ```ts\n * http.createServer(app.handle.bind(app))\n * ```\n */\n handle(req: http.IncomingMessage, res: http.ServerResponse, next?: (err?: any) => void): void {\n if (next) {\n this.app(req as any, res as any, next)\n } else {\n this.app(req as any, res as any)\n }\n }\n\n /**\n * Full setup pipeline:\n * 1. Adapter beforeMount hooks (early routes — docs, health)\n * 2. Adapter middleware (phase: beforeGlobal)\n * 3. Global middleware (user-declared or defaults)\n * 4. Adapter middleware (phase: afterGlobal)\n * 5. Module registration + DI bootstrap\n * 6. Adapter middleware (phase: beforeRoutes)\n * 7. Module route mounting\n * 8. Adapter middleware (phase: afterRoutes)\n * 9. Error handlers (notFound + global)\n * 10. Adapter beforeStart hooks\n */\n /** Build the adapter context object (shared across all hooks) */\n private adapterCtx(server?: any): AdapterContext {\n const env = process.env.NODE_ENV ?? 'development'\n return {\n app: this.app,\n container: this.container,\n server,\n env,\n isProduction: env === 'production',\n }\n }\n\n /** Call an adapter hook, awaiting async hooks and catching errors */\n private async callHook(\n hook: ((ctx: AdapterContext) => void | Promise<void>) | undefined,\n ctx: AdapterContext,\n ): Promise<void> {\n if (!hook) return\n try {\n const result = hook(ctx)\n if (result && typeof (result as Promise<void>).then === 'function') {\n await result\n }\n } catch (err) {\n log.error(err, 'Adapter hook failed')\n }\n }\n\n async setup(): Promise<void> {\n log.debug('Bootstrapping application...')\n\n // Collect adapter middleware by phase\n const adapterMw = this.collectAdapterMiddleware()\n\n // Expose the Application instance on the Express app for adapter discovery\n ;(this.app as any).__kickApp = this\n\n const ctx = this.adapterCtx()\n\n // ── 1. Adapter beforeMount hooks ──────────────────────────────────\n for (const adapter of this.adapters) {\n await this.callHook(adapter.beforeMount?.bind(adapter), ctx)\n }\n\n // ── 2. Hardened defaults ──────────────────────────────────────────\n this.app.disable('x-powered-by')\n this.app.set('trust proxy', this.options.trustProxy ?? false)\n\n // ── 2a. In-flight request tracking ──────────────────────────────\n this.app.use(this.requestTrackingMiddleware())\n\n // ── 2b. Health check endpoints (before middleware, at root) ──────\n this.mountHealthEndpoints()\n\n // ── 2c. Request scope (AsyncLocalStorage) ────────────────────────\n this.app.use(requestScopeMiddleware())\n\n // ── 3. Adapter middleware: beforeGlobal ───────────────────────────\n this.mountMiddlewareList(adapterMw.beforeGlobal)\n\n // ── 3b. Plugin registration ──────────────────────────────────────\n for (const plugin of this.plugins) {\n plugin.register?.(this.container)\n }\n\n // ── 3c. Plugin middleware ─────────────────────────────────────────\n for (const plugin of this.plugins) {\n try {\n const mw = plugin.middleware?.() ?? []\n for (const handler of mw) {\n this.app.use(handler)\n }\n } catch (err) {\n log.error(err, `Plugin middleware failed: ${(plugin as any).name ?? 'unknown'}`)\n }\n }\n\n // ── 4. Global middleware ─────────────────────────────────────────\n if (this.options.middleware) {\n // User-declared pipeline — full control\n for (const entry of this.options.middleware) {\n this.mountMiddlewareEntry(entry)\n }\n } else {\n // Sensible defaults when no middleware declared\n this.app.use(requestId())\n this.app.use(express.json({ limit: this.options.jsonLimit ?? '100kb' }))\n }\n\n // ── 5. Adapter middleware: afterGlobal ────────────────────────────\n this.mountMiddlewareList(adapterMw.afterGlobal)\n\n // ── 6. Module registration + DI bootstrap ────────────────────────\n // Plugin modules first, then user modules\n const allModuleClasses = [\n ...this.plugins.flatMap((p) => p.modules?.() ?? []),\n ...this.options.modules,\n ]\n const modules = allModuleClasses.map((ModuleClass) => {\n const mod = new ModuleClass()\n // `register()` is optional — modules whose classes are entirely\n // decorator-managed (@Service, @Controller, @Repository) don't need it.\n mod.register?.(this.container)\n return mod\n })\n this.container.bootstrap()\n\n // ── 7. Adapter middleware: beforeRoutes ───────────────────────────\n this.mountMiddlewareList(adapterMw.beforeRoutes)\n\n // ── 8. Mount module routes with versioning ───────────────────────\n const apiPrefix = this.options.apiPrefix ?? '/api'\n const defaultVersion = this.options.defaultVersion ?? 1\n const shouldLogRoutes = this.options.logRoutesTable ?? process.env.NODE_ENV !== 'production'\n\n // Collect route metadata during mounting (avoids calling mod.routes() twice)\n const mountedRoutes: Array<{ controller: any; mountPath: string }> = []\n\n for (const mod of modules) {\n const result = mod.routes()\n if (!result) continue // Non-HTTP modules (queues, cron) may return null\n\n const routeSets = Array.isArray(result) ? result : [result]\n\n for (const route of routeSets) {\n const version = route.version ?? defaultVersion\n const mountPath = `${apiPrefix}/v${version}${normalizePath(route.path)}`\n this.app.use(mountPath, route.router)\n\n // Notify adapters (e.g. SwaggerAdapter for OpenAPI spec generation)\n if (route.controller) {\n for (const adapter of this.adapters) {\n try {\n adapter.onRouteMount?.(route.controller, mountPath)\n } catch (err) {\n log.error(err, `adapter.onRouteMount() failed for ${mountPath}`)\n }\n }\n if (shouldLogRoutes) {\n mountedRoutes.push({ controller: route.controller, mountPath })\n }\n }\n }\n }\n\n // ── 8b. Log route summary ─────────────────────────────────────────\n if (shouldLogRoutes && mountedRoutes.length > 0) {\n const methodOrder = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS']\n const methodRank = (m: string) => {\n const i = methodOrder.indexOf(m)\n return i === -1 ? 99 : i\n }\n\n let totalRoutes = 0\n log.debug('Routes:')\n\n for (const { controller, mountPath } of mountedRoutes) {\n const defs: RouteDefinition[] = getClassMeta<RouteDefinition[]>(\n METADATA.ROUTES,\n controller,\n [],\n )\n if (defs.length === 0) continue\n\n const counts: Record<string, number> = {}\n for (const def of defs) {\n const m = def.method.toUpperCase()\n counts[m] = (counts[m] || 0) + 1\n }\n totalRoutes += defs.length\n\n const methods = Object.entries(counts)\n .sort(([a], [b]) => methodRank(a) - methodRank(b))\n .map(([m, n]) => `${n} ${m}`)\n .join(', ')\n const name = controller.name || 'Controller'\n log.debug(` ${name.padEnd(30)} ${mountPath.padEnd(25)} ${defs.length} routes (${methods})`)\n }\n\n log.debug(` Total: ${totalRoutes} routes`)\n }\n\n // ── 9. Adapter middleware: afterRoutes ────────────────────────────\n this.mountMiddlewareList(adapterMw.afterRoutes)\n\n // ── 10. Error handlers ───────────────────────────────────────────\n this.app.use(this.options.onNotFound ?? notFoundHandler())\n this.app.use(this.options.onError ?? errorHandler())\n\n // ── 11. Adapter beforeStart hooks ────────────────────────────────\n for (const adapter of this.adapters) {\n await this.callHook(adapter.beforeStart?.bind(adapter), ctx)\n }\n }\n\n /** Register modules and DI without starting the HTTP server (used by kick tinker) */\n async registerOnly(): Promise<void> {\n await this.setup()\n }\n\n /**\n * Start the HTTP server.\n *\n * In **dev mode** (Vite plugin active): reuses `globalThis.__kickjs_httpServer`\n * created by Vite. Adapters (WsAdapter, Socket.IO, etc.) receive the real\n * `http.Server` through `afterStart({ server })` — zero adapter changes needed.\n *\n * In **production**: creates its own `http.Server` and binds to the port.\n */\n async start(): Promise<void> {\n await this.setup()\n\n const g = globalThis as any\n\n if (g.__kickjs_httpServer) {\n // ── DEV MODE: Vite owns the http.Server ──────────────────────\n // Don't create a new server or listen — Vite is already listening.\n // Just wire up adapters with the Vite-created server.\n this.httpServer = g.__kickjs_httpServer\n log.debug('Attached to Vite dev server')\n\n for (const adapter of this.adapters) {\n const ctx = this.adapterCtx(this.httpServer!)\n await this.callHook(adapter.afterStart?.bind(adapter), ctx)\n }\n\n for (const plugin of this.plugins) {\n await plugin.onReady?.(this.container)\n }\n\n return\n }\n\n // ── PRODUCTION: Create and own the http.Server ─────────────────\n const port = this.options.port ?? parseInt(process.env.PORT || '3000', 10)\n this.httpServer = http.createServer(this.app)\n\n this.httpServer.on('error', (err: NodeJS.ErrnoException) => {\n if (err.code === 'EADDRINUSE') {\n log.error(\n `Port ${port} is already in use. Kill the existing process or use a different port:\\n` +\n ` PORT=${port + 1} kick dev\\n` +\n ` lsof -i :${port} # find what's using it\\n` +\n ` kill <PID> # stop it`,\n )\n process.exit(1)\n }\n throw err\n })\n\n // Wrap listen in a Promise so afterStart/onReady errors propagate\n await new Promise<void>((resolve, reject) => {\n this.httpServer!.listen(port, async () => {\n try {\n log.info(`Server running on http://localhost:${port}`)\n\n for (const adapter of this.adapters) {\n const afterCtx = this.adapterCtx(this.httpServer!)\n await this.callHook(adapter.afterStart?.bind(adapter), afterCtx)\n }\n\n // Plugin onReady hooks\n for (const plugin of this.plugins) {\n await plugin.onReady?.(this.container)\n }\n\n resolve()\n } catch (err) {\n reject(err)\n }\n })\n })\n }\n\n /** HMR rebuild: swap Express handler without restarting the server */\n async rebuild(): Promise<void> {\n // Build the new app fully before swapping — if setup() throws,\n // the old app keeps running so the server stays responsive.\n const prevApp = this.app\n const prevContainer = this.container\n\n try {\n Container.reset()\n this.container = Container.getInstance()\n this.app = express()\n await this.setup()\n } catch (err) {\n log.error(err, 'HMR rebuild failed, keeping previous app')\n // Restore previous state so the server stays responsive\n this.app = prevApp\n this.container = prevContainer\n return\n }\n\n if (this.httpServer) {\n this.httpServer.removeAllListeners('request')\n this.httpServer.on('request', this.app)\n log.debug('HMR: Express app rebuilt and swapped')\n }\n }\n\n /**\n * Graceful shutdown with request draining.\n *\n * 1. Stops accepting new connections (server.close())\n * 2. Waits for in-flight requests to complete (up to shutdownTimeout)\n * 3. Calls adapter.shutdown() for all registered adapters\n * 4. Force-closes after timeout\n *\n * Safe to call multiple times — subsequent calls return the same promise.\n */\n async shutdown(): Promise<void> {\n // Prevent double-shutdown — return immediately if already initiated\n if (this._shutdownInitiated) {\n log.debug('Shutdown already in progress, skipping duplicate call')\n return\n }\n this._shutdownInitiated = true\n this._draining = true\n\n log.debug('Shutting down — draining in-flight requests...')\n\n const timeoutMs = this.options.shutdownTimeout ?? 30_000\n let timer: ReturnType<typeof setTimeout> | undefined\n\n // Start a force-exit timer if timeout is configured\n const forceExitPromise =\n timeoutMs > 0\n ? new Promise<'timeout'>((resolve) => {\n timer = setTimeout(() => resolve('timeout'), timeoutMs)\n timer.unref()\n })\n : new Promise<never>(() => {}) // never resolves — no forced exit\n\n try {\n // Step 1: Stop accepting new connections.\n // server.close() prevents new connections. Its callback fires only when\n // ALL existing connections are fully closed, so we do NOT await it here —\n // we track request draining separately via the tracking middleware.\n if (this.httpServer) {\n this.httpServer.close(() => {})\n }\n\n // Step 2: Wait for in-flight requests to drain (or timeout)\n if (this._inFlightRequests > 0) {\n log.debug(`Waiting for ${this._inFlightRequests} in-flight request(s) to complete...`)\n const drainPromise = new Promise<'drained'>((resolve) => {\n this._drainResolvers.push(() => resolve('drained'))\n })\n\n const result = await Promise.race([drainPromise, forceExitPromise])\n if (result === 'timeout') {\n log.warn(\n `Shutdown timeout (${timeoutMs}ms) reached with ${this._inFlightRequests} request(s) still in-flight, forcing shutdown`,\n )\n } else {\n log.debug('All in-flight requests completed')\n }\n }\n\n // Step 3: Run all plugin + adapter shutdowns concurrently\n const results = await Promise.allSettled([\n ...this.plugins.map((plugin) => Promise.resolve(plugin.shutdown?.())),\n ...this.adapters.map((adapter) => Promise.resolve(adapter.shutdown?.())),\n ])\n for (const result of results) {\n if (result.status === 'rejected') {\n log.error({ err: result.reason }, 'Adapter shutdown failed')\n }\n }\n } finally {\n if (timer) clearTimeout(timer)\n }\n }\n\n getExpressApp(): Express {\n return this.app\n }\n\n /** Get registered adapters — used by DevToolsAdapter for peer discovery */\n getAdapters(): AppAdapter[] {\n return this.adapters\n }\n\n getHttpServer(): http.Server | null {\n return this.httpServer\n }\n\n // ── Internal helpers ────────────────────────────────────────────────\n\n private collectAdapterMiddleware() {\n const result = {\n beforeGlobal: [] as AdapterMiddleware[],\n afterGlobal: [] as AdapterMiddleware[],\n beforeRoutes: [] as AdapterMiddleware[],\n afterRoutes: [] as AdapterMiddleware[],\n }\n\n for (const adapter of this.adapters) {\n const entries = adapter.middleware?.() ?? []\n for (const entry of entries) {\n const phase = entry.phase ?? 'afterGlobal'\n result[phase].push(entry)\n }\n }\n\n return result\n }\n\n private mountMiddlewareList(entries: AdapterMiddleware[]): void {\n for (const entry of entries) {\n if (entry.path) {\n this.app.use(entry.path, entry.handler)\n } else {\n this.app.use(entry.handler)\n }\n }\n }\n\n private mountMiddlewareEntry(entry: MiddlewareEntry): void {\n if (typeof entry === 'function') {\n this.app.use(entry)\n } else {\n this.app.use(entry.path, entry.handler)\n }\n }\n\n /** Middleware that tracks in-flight requests for graceful draining */\n private requestTrackingMiddleware(): RequestHandler {\n return (_req, res, next) => {\n this._inFlightRequests++\n const onFinish = () => {\n res.removeListener('finish', onFinish)\n res.removeListener('close', onFinish)\n this._inFlightRequests--\n // If draining and no more in-flight requests, resolve all waiters\n if (this._draining && this._inFlightRequests === 0) {\n for (const resolve of this._drainResolvers) {\n resolve()\n }\n this._drainResolvers = []\n }\n }\n res.on('finish', onFinish)\n res.on('close', onFinish)\n next()\n }\n }\n\n /** Mount /health/live and /health/ready endpoints at the root (no API prefix) */\n private mountHealthEndpoints(): void {\n this.app.get('/health/live', (_req, res) => {\n if (this._draining) {\n res.status(503).json({ status: 'draining', uptime: process.uptime() })\n } else {\n res.json({ status: 'ok', uptime: process.uptime() })\n }\n })\n\n this.app.get('/health/ready', async (_req, res) => {\n if (this._draining) {\n res.status(503).json({ status: 'draining', checks: [] })\n return\n }\n const adaptersWithHealth = this.adapters.filter((a) => a.onHealthCheck)\n const checks = await Promise.allSettled(adaptersWithHealth.map((a) => a.onHealthCheck!()))\n const results = checks.map((c, i) => {\n if (c.status === 'fulfilled') return c.value\n return { name: adaptersWithHealth[i].name ?? 'unknown', status: 'down' as const }\n })\n const healthy = results.every((r) => r.status === 'up')\n res.status(healthy ? 200 : 503).json({\n status: healthy ? 'ready' : 'degraded',\n checks: results,\n })\n })\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAaA,MAAa,eAAe,IAAI,mBAAiC;;;;;AAMjE,SAAgB,kBAAgC;CAC9C,MAAM,QAAQ,aAAa,UAAU;AACrC,KAAI,CAAC,MACH,OAAM,IAAI,MACR,kGACD;AAEH,QAAO;;;;;;;;;;AChBT,SAAgB,yBAAyB;AACvC,SAAQ,KAAc,MAAgB,SAAuB;EAC3D,MAAM,kBAAkB,IAAI,QAAQ;EAGpC,MAAM,QAAsB;GAC1B,YAFC,MAAM,QAAQ,gBAAgB,GAAG,gBAAgB,KAAK,oBAAoB,OAAO,YAAY;GAG9F,2BAAW,IAAI,KAAK;GACpB,wBAAQ,IAAI,KAAK;GAClB;AACD,eAAa,IAAI,aAAa,MAAM,CAAC;;;;;ACCzC,MAAM,MAAM,aAAa,cAAc;;;;;AAyHvC,IAAa,cAAb,MAAyB;CACvB;CACA;CACA,aAAyC;CACzC;CAEA;;CAGA,oBAA4B;;CAE5B,YAAoB;;CAEpB,qBAA6B;;CAE7B,kBAA6C,EAAE;CAE/C,YAAY,SAA8C;AAA7B,OAAA,UAAA;AAC3B,OAAK,MAAM,SAAS;AACpB,OAAK,YAAY,UAAU,aAAa;AACxC,OAAK,UAAU,QAAQ,WAAW,EAAE;AACpC,OAAK,WAAW,CAEd,GAAG,KAAK,QAAQ,SAAS,MAAM,EAAE,YAAY,IAAI,EAAE,CAAC,EACpD,GAAI,QAAQ,YAAY,EAAE,CAC3B;AAED,YAAU,8BAA8B,aAAa,UAAU,IAAI;AAEnE,SAAO,yBAAyB;GAC9B,MAAM,QAAQ,aAAa,UAAU;AACrC,OAAI,CAAC,MAAO,QAAO;GACnB,MAAM,MAA2B,EAAE,WAAW,MAAM,WAAW;GAC/D,MAAM,UAAU,MAAM,OAAO,IAAI,UAAU;AAC3C,OAAI,QAAS,KAAI,UAAU;GAC3B,MAAM,SAAS,MAAM,OAAO,IAAI,SAAS;AACzC,OAAI,OAAQ,KAAI,SAAS;AACzB,UAAO;;;;CAKX,IAAI,aAAsB;AACxB,SAAO,KAAK;;;CAId,IAAI,mBAA2B;AAC7B,SAAO,KAAK;;;CAId,eAA0B;AACxB,SAAO,KAAK;;;;;;;;;;;;;;;;CAiBd,OAAO,KAA2B,KAA0B,MAAkC;AAC5F,MAAI,KACF,MAAK,IAAI,KAAY,KAAY,KAAK;MAEtC,MAAK,IAAI,KAAY,IAAW;;;;;;;;;;;;;;;;CAkBpC,WAAmB,QAA8B;EAC/C,MAAM,MAAM,QAAQ,IAAI,YAAY;AACpC,SAAO;GACL,KAAK,KAAK;GACV,WAAW,KAAK;GAChB;GACA;GACA,cAAc,QAAQ;GACvB;;;CAIH,MAAc,SACZ,MACA,KACe;AACf,MAAI,CAAC,KAAM;AACX,MAAI;GACF,MAAM,SAAS,KAAK,IAAI;AACxB,OAAI,UAAU,OAAQ,OAAyB,SAAS,WACtD,OAAM;WAED,KAAK;AACZ,OAAI,MAAM,KAAK,sBAAsB;;;CAIzC,MAAM,QAAuB;AAC3B,MAAI,MAAM,+BAA+B;EAGzC,MAAM,YAAY,KAAK,0BAA0B;AAG/C,OAAK,IAAY,YAAY;EAE/B,MAAM,MAAM,KAAK,YAAY;AAG7B,OAAK,MAAM,WAAW,KAAK,SACzB,OAAM,KAAK,SAAS,QAAQ,aAAa,KAAK,QAAQ,EAAE,IAAI;AAI9D,OAAK,IAAI,QAAQ,eAAe;AAChC,OAAK,IAAI,IAAI,eAAe,KAAK,QAAQ,cAAc,MAAM;AAG7D,OAAK,IAAI,IAAI,KAAK,2BAA2B,CAAC;AAG9C,OAAK,sBAAsB;AAG3B,OAAK,IAAI,IAAI,wBAAwB,CAAC;AAGtC,OAAK,oBAAoB,UAAU,aAAa;AAGhD,OAAK,MAAM,UAAU,KAAK,QACxB,QAAO,WAAW,KAAK,UAAU;AAInC,OAAK,MAAM,UAAU,KAAK,QACxB,KAAI;GACF,MAAM,KAAK,OAAO,cAAc,IAAI,EAAE;AACtC,QAAK,MAAM,WAAW,GACpB,MAAK,IAAI,IAAI,QAAQ;WAEhB,KAAK;AACZ,OAAI,MAAM,KAAK,6BAA8B,OAAe,QAAQ,YAAY;;AAKpF,MAAI,KAAK,QAAQ,WAEf,MAAK,MAAM,SAAS,KAAK,QAAQ,WAC/B,MAAK,qBAAqB,MAAM;OAE7B;AAEL,QAAK,IAAI,IAAI,WAAW,CAAC;AACzB,QAAK,IAAI,IAAI,QAAQ,KAAK,EAAE,OAAO,KAAK,QAAQ,aAAa,SAAS,CAAC,CAAC;;AAI1E,OAAK,oBAAoB,UAAU,YAAY;EAQ/C,MAAM,UAJmB,CACvB,GAAG,KAAK,QAAQ,SAAS,MAAM,EAAE,WAAW,IAAI,EAAE,CAAC,EACnD,GAAG,KAAK,QAAQ,QACjB,CACgC,KAAK,gBAAgB;GACpD,MAAM,MAAM,IAAI,aAAa;AAG7B,OAAI,WAAW,KAAK,UAAU;AAC9B,UAAO;IACP;AACF,OAAK,UAAU,WAAW;AAG1B,OAAK,oBAAoB,UAAU,aAAa;EAGhD,MAAM,YAAY,KAAK,QAAQ,aAAa;EAC5C,MAAM,iBAAiB,KAAK,QAAQ,kBAAkB;EACtD,MAAM,kBAAkB,KAAK,QAAQ,kBAAkB,QAAQ,IAAI,aAAa;EAGhF,MAAM,gBAA+D,EAAE;AAEvE,OAAK,MAAM,OAAO,SAAS;GACzB,MAAM,SAAS,IAAI,QAAQ;AAC3B,OAAI,CAAC,OAAQ;GAEb,MAAM,YAAY,MAAM,QAAQ,OAAO,GAAG,SAAS,CAAC,OAAO;AAE3D,QAAK,MAAM,SAAS,WAAW;IAE7B,MAAM,YAAY,GAAG,UAAU,IADf,MAAM,WAAW,iBACY,cAAc,MAAM,KAAK;AACtE,SAAK,IAAI,IAAI,WAAW,MAAM,OAAO;AAGrC,QAAI,MAAM,YAAY;AACpB,UAAK,MAAM,WAAW,KAAK,SACzB,KAAI;AACF,cAAQ,eAAe,MAAM,YAAY,UAAU;cAC5C,KAAK;AACZ,UAAI,MAAM,KAAK,qCAAqC,YAAY;;AAGpE,SAAI,gBACF,eAAc,KAAK;MAAE,YAAY,MAAM;MAAY;MAAW,CAAC;;;;AAOvE,MAAI,mBAAmB,cAAc,SAAS,GAAG;GAC/C,MAAM,cAAc;IAAC;IAAO;IAAQ;IAAO;IAAS;IAAU;IAAQ;IAAU;GAChF,MAAM,cAAc,MAAc;IAChC,MAAM,IAAI,YAAY,QAAQ,EAAE;AAChC,WAAO,MAAM,KAAK,KAAK;;GAGzB,IAAI,cAAc;AAClB,OAAI,MAAM,UAAU;AAEpB,QAAK,MAAM,EAAE,YAAY,eAAe,eAAe;IACrD,MAAM,OAA0B,aAC9B,SAAS,QACT,YACA,EAAE,CACH;AACD,QAAI,KAAK,WAAW,EAAG;IAEvB,MAAM,SAAiC,EAAE;AACzC,SAAK,MAAM,OAAO,MAAM;KACtB,MAAM,IAAI,IAAI,OAAO,aAAa;AAClC,YAAO,MAAM,OAAO,MAAM,KAAK;;AAEjC,mBAAe,KAAK;IAEpB,MAAM,UAAU,OAAO,QAAQ,OAAO,CACnC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,EAAE,GAAG,WAAW,EAAE,CAAC,CACjD,KAAK,CAAC,GAAG,OAAO,GAAG,EAAE,GAAG,IAAI,CAC5B,KAAK,KAAK;IACb,MAAM,OAAO,WAAW,QAAQ;AAChC,QAAI,MAAM,KAAK,KAAK,OAAO,GAAG,CAAC,GAAG,UAAU,OAAO,GAAG,CAAC,GAAG,KAAK,OAAO,WAAW,QAAQ,GAAG;;AAG9F,OAAI,MAAM,YAAY,YAAY,SAAS;;AAI7C,OAAK,oBAAoB,UAAU,YAAY;AAG/C,OAAK,IAAI,IAAI,KAAK,QAAQ,cAAc,iBAAiB,CAAC;AAC1D,OAAK,IAAI,IAAI,KAAK,QAAQ,WAAW,cAAc,CAAC;AAGpD,OAAK,MAAM,WAAW,KAAK,SACzB,OAAM,KAAK,SAAS,QAAQ,aAAa,KAAK,QAAQ,EAAE,IAAI;;;CAKhE,MAAM,eAA8B;AAClC,QAAM,KAAK,OAAO;;;;;;;;;;;CAYpB,MAAM,QAAuB;AAC3B,QAAM,KAAK,OAAO;EAElB,MAAM,IAAI;AAEV,MAAI,EAAE,qBAAqB;AAIzB,QAAK,aAAa,EAAE;AACpB,OAAI,MAAM,8BAA8B;AAExC,QAAK,MAAM,WAAW,KAAK,UAAU;IACnC,MAAM,MAAM,KAAK,WAAW,KAAK,WAAY;AAC7C,UAAM,KAAK,SAAS,QAAQ,YAAY,KAAK,QAAQ,EAAE,IAAI;;AAG7D,QAAK,MAAM,UAAU,KAAK,QACxB,OAAM,OAAO,UAAU,KAAK,UAAU;AAGxC;;EAIF,MAAM,OAAO,KAAK,QAAQ,QAAQ,SAAS,QAAQ,IAAI,QAAQ,QAAQ,GAAG;AAC1E,OAAK,aAAa,KAAK,aAAa,KAAK,IAAI;AAE7C,OAAK,WAAW,GAAG,UAAU,QAA+B;AAC1D,OAAI,IAAI,SAAS,cAAc;AAC7B,QAAI,MACF,QAAQ,KAAK,iFACD,OAAO,EAAE,wBACL,KAAK,4DAEtB;AACD,YAAQ,KAAK,EAAE;;AAEjB,SAAM;IACN;AAGF,QAAM,IAAI,SAAe,SAAS,WAAW;AAC3C,QAAK,WAAY,OAAO,MAAM,YAAY;AACxC,QAAI;AACF,SAAI,KAAK,sCAAsC,OAAO;AAEtD,UAAK,MAAM,WAAW,KAAK,UAAU;MACnC,MAAM,WAAW,KAAK,WAAW,KAAK,WAAY;AAClD,YAAM,KAAK,SAAS,QAAQ,YAAY,KAAK,QAAQ,EAAE,SAAS;;AAIlE,UAAK,MAAM,UAAU,KAAK,QACxB,OAAM,OAAO,UAAU,KAAK,UAAU;AAGxC,cAAS;aACF,KAAK;AACZ,YAAO,IAAI;;KAEb;IACF;;;CAIJ,MAAM,UAAyB;EAG7B,MAAM,UAAU,KAAK;EACrB,MAAM,gBAAgB,KAAK;AAE3B,MAAI;AACF,aAAU,OAAO;AACjB,QAAK,YAAY,UAAU,aAAa;AACxC,QAAK,MAAM,SAAS;AACpB,SAAM,KAAK,OAAO;WACX,KAAK;AACZ,OAAI,MAAM,KAAK,2CAA2C;AAE1D,QAAK,MAAM;AACX,QAAK,YAAY;AACjB;;AAGF,MAAI,KAAK,YAAY;AACnB,QAAK,WAAW,mBAAmB,UAAU;AAC7C,QAAK,WAAW,GAAG,WAAW,KAAK,IAAI;AACvC,OAAI,MAAM,uCAAuC;;;;;;;;;;;;;CAcrD,MAAM,WAA0B;AAE9B,MAAI,KAAK,oBAAoB;AAC3B,OAAI,MAAM,wDAAwD;AAClE;;AAEF,OAAK,qBAAqB;AAC1B,OAAK,YAAY;AAEjB,MAAI,MAAM,iDAAiD;EAE3D,MAAM,YAAY,KAAK,QAAQ,mBAAmB;EAClD,IAAI;EAGJ,MAAM,mBACJ,YAAY,IACR,IAAI,SAAoB,YAAY;AAClC,WAAQ,iBAAiB,QAAQ,UAAU,EAAE,UAAU;AACvD,SAAM,OAAO;IACb,GACF,IAAI,cAAqB,GAAG;AAElC,MAAI;AAKF,OAAI,KAAK,WACP,MAAK,WAAW,YAAY,GAAG;AAIjC,OAAI,KAAK,oBAAoB,GAAG;AAC9B,QAAI,MAAM,eAAe,KAAK,kBAAkB,sCAAsC;IACtF,MAAM,eAAe,IAAI,SAAoB,YAAY;AACvD,UAAK,gBAAgB,WAAW,QAAQ,UAAU,CAAC;MACnD;AAGF,QADe,MAAM,QAAQ,KAAK,CAAC,cAAc,iBAAiB,CAAC,KACpD,UACb,KAAI,KACF,qBAAqB,UAAU,mBAAmB,KAAK,kBAAkB,+CAC1E;QAED,KAAI,MAAM,mCAAmC;;GAKjD,MAAM,UAAU,MAAM,QAAQ,WAAW,CACvC,GAAG,KAAK,QAAQ,KAAK,WAAW,QAAQ,QAAQ,OAAO,YAAY,CAAC,CAAC,EACrE,GAAG,KAAK,SAAS,KAAK,YAAY,QAAQ,QAAQ,QAAQ,YAAY,CAAC,CAAC,CACzE,CAAC;AACF,QAAK,MAAM,UAAU,QACnB,KAAI,OAAO,WAAW,WACpB,KAAI,MAAM,EAAE,KAAK,OAAO,QAAQ,EAAE,0BAA0B;YAGxD;AACR,OAAI,MAAO,cAAa,MAAM;;;CAIlC,gBAAyB;AACvB,SAAO,KAAK;;;CAId,cAA4B;AAC1B,SAAO,KAAK;;CAGd,gBAAoC;AAClC,SAAO,KAAK;;CAKd,2BAAmC;EACjC,MAAM,SAAS;GACb,cAAc,EAAE;GAChB,aAAa,EAAE;GACf,cAAc,EAAE;GAChB,aAAa,EAAE;GAChB;AAED,OAAK,MAAM,WAAW,KAAK,UAAU;GACnC,MAAM,UAAU,QAAQ,cAAc,IAAI,EAAE;AAC5C,QAAK,MAAM,SAAS,QAElB,QADc,MAAM,SAAS,eACf,KAAK,MAAM;;AAI7B,SAAO;;CAGT,oBAA4B,SAAoC;AAC9D,OAAK,MAAM,SAAS,QAClB,KAAI,MAAM,KACR,MAAK,IAAI,IAAI,MAAM,MAAM,MAAM,QAAQ;MAEvC,MAAK,IAAI,IAAI,MAAM,QAAQ;;CAKjC,qBAA6B,OAA8B;AACzD,MAAI,OAAO,UAAU,WACnB,MAAK,IAAI,IAAI,MAAM;MAEnB,MAAK,IAAI,IAAI,MAAM,MAAM,MAAM,QAAQ;;;CAK3C,4BAAoD;AAClD,UAAQ,MAAM,KAAK,SAAS;AAC1B,QAAK;GACL,MAAM,iBAAiB;AACrB,QAAI,eAAe,UAAU,SAAS;AACtC,QAAI,eAAe,SAAS,SAAS;AACrC,SAAK;AAEL,QAAI,KAAK,aAAa,KAAK,sBAAsB,GAAG;AAClD,UAAK,MAAM,WAAW,KAAK,gBACzB,UAAS;AAEX,UAAK,kBAAkB,EAAE;;;AAG7B,OAAI,GAAG,UAAU,SAAS;AAC1B,OAAI,GAAG,SAAS,SAAS;AACzB,SAAM;;;;CAKV,uBAAqC;AACnC,OAAK,IAAI,IAAI,iBAAiB,MAAM,QAAQ;AAC1C,OAAI,KAAK,UACP,KAAI,OAAO,IAAI,CAAC,KAAK;IAAE,QAAQ;IAAY,QAAQ,QAAQ,QAAQ;IAAE,CAAC;OAEtE,KAAI,KAAK;IAAE,QAAQ;IAAM,QAAQ,QAAQ,QAAQ;IAAE,CAAC;IAEtD;AAEF,OAAK,IAAI,IAAI,iBAAiB,OAAO,MAAM,QAAQ;AACjD,OAAI,KAAK,WAAW;AAClB,QAAI,OAAO,IAAI,CAAC,KAAK;KAAE,QAAQ;KAAY,QAAQ,EAAE;KAAE,CAAC;AACxD;;GAEF,MAAM,qBAAqB,KAAK,SAAS,QAAQ,MAAM,EAAE,cAAc;GAEvE,MAAM,WADS,MAAM,QAAQ,WAAW,mBAAmB,KAAK,MAAM,EAAE,eAAgB,CAAC,CAAC,EACnE,KAAK,GAAG,MAAM;AACnC,QAAI,EAAE,WAAW,YAAa,QAAO,EAAE;AACvC,WAAO;KAAE,MAAM,mBAAmB,GAAG,QAAQ;KAAW,QAAQ;KAAiB;KACjF;GACF,MAAM,UAAU,QAAQ,OAAO,MAAM,EAAE,WAAW,KAAK;AACvD,OAAI,OAAO,UAAU,MAAM,IAAI,CAAC,KAAK;IACnC,QAAQ,UAAU,UAAU;IAC5B,QAAQ;IACT,CAAC;IACF"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v2.
|
|
2
|
+
* @forinda/kickjs v2.3.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -9,11 +9,11 @@
|
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
11
|
import { createLogger } from "./core/logger.mjs";
|
|
12
|
-
import { t as Container } from "./container-
|
|
13
|
-
import "./core-
|
|
12
|
+
import { t as Container } from "./container-0sTWvL-c.mjs";
|
|
13
|
+
import "./core-YLypdG22.mjs";
|
|
14
14
|
import { reactive, ref } from "./core/reactivity.mjs";
|
|
15
|
-
import { t as Application } from "./application-
|
|
16
|
-
import { a as reloadEnv } from "./env-
|
|
15
|
+
import { t as Application } from "./application-B91xATK0.mjs";
|
|
16
|
+
import { a as reloadEnv } from "./env-X5N7dpDg.mjs";
|
|
17
17
|
import cluster from "node:cluster";
|
|
18
18
|
import os from "node:os";
|
|
19
19
|
//#region src/http/cluster.ts
|
|
@@ -124,28 +124,14 @@ function tryReloadEnv() {
|
|
|
124
124
|
}
|
|
125
125
|
const log = createLogger("Process");
|
|
126
126
|
/**
|
|
127
|
-
* Bootstrap a KickJS application
|
|
127
|
+
* Bootstrap a KickJS application.
|
|
128
128
|
*
|
|
129
|
-
*
|
|
129
|
+
* Creates the Express app, registers modules and adapters, and starts
|
|
130
|
+
* the HTTP server. In dev mode (`kick dev`), the Vite plugin manages
|
|
131
|
+
* the server and HMR — source changes are picked up instantly without
|
|
132
|
+
* losing database connections or WebSocket state.
|
|
130
133
|
*
|
|
131
|
-
*
|
|
132
|
-
* `bootstrap()` sets up the Express app and adapters but does NOT start
|
|
133
|
-
* the HTTP server — Vite owns the port. The returned `app` object has a
|
|
134
|
-
* `.handle(req, res, next)` method that the Vite dev-server plugin calls
|
|
135
|
-
* on each request via `ssrLoadModule()`.
|
|
136
|
-
*
|
|
137
|
-
* ## Production Mode
|
|
138
|
-
*
|
|
139
|
-
* Without the Vite plugin, `bootstrap()` creates its own `http.Server`,
|
|
140
|
-
* binds to the port, and starts listening — same behavior as before.
|
|
141
|
-
*
|
|
142
|
-
* ## HMR
|
|
143
|
-
*
|
|
144
|
-
* On subsequent calls (module re-evaluation), `bootstrap()` rebuilds the
|
|
145
|
-
* Express app and swaps the request handler without restarting the server.
|
|
146
|
-
*
|
|
147
|
-
* @returns The Application instance. In Vite dev mode, the Express handler
|
|
148
|
-
* is accessible at `app.handle` for the dev-server plugin to use.
|
|
134
|
+
* @returns The {@link Application} instance.
|
|
149
135
|
*
|
|
150
136
|
* @example
|
|
151
137
|
* ```ts
|
|
@@ -154,12 +140,13 @@ const log = createLogger("Process");
|
|
|
154
140
|
* import { bootstrap } from '@forinda/kickjs'
|
|
155
141
|
* import { modules } from './modules'
|
|
156
142
|
*
|
|
157
|
-
* // Export for Vite plugin (dev) — also works standalone (prod)
|
|
158
143
|
* export const app = await bootstrap({ modules })
|
|
159
144
|
* ```
|
|
160
145
|
*/
|
|
161
146
|
async function bootstrap(options) {
|
|
162
|
-
|
|
147
|
+
const isViteDev = !!globalThis.__kickjs_httpServer;
|
|
148
|
+
if (options.cluster && isViteDev) log.warn("Cluster mode is ignored in dev — Vite owns the server. Cluster applies in production (kick start).");
|
|
149
|
+
if (options.cluster && cluster.isPrimary && !isViteDev) {
|
|
163
150
|
setupClusterPrimary(typeof options.cluster === "object" ? options.cluster : {});
|
|
164
151
|
return new Application(options);
|
|
165
152
|
}
|
|
@@ -179,14 +166,14 @@ async function bootstrap(options) {
|
|
|
179
166
|
g.__kickBootstrapped = true;
|
|
180
167
|
}
|
|
181
168
|
if (g.__app) {
|
|
182
|
-
log.
|
|
169
|
+
log.debug("HMR rebuild triggered");
|
|
183
170
|
tryReloadEnv();
|
|
184
171
|
Container.reset();
|
|
185
172
|
const freshApp = new Application(options);
|
|
186
173
|
g.__app = freshApp;
|
|
187
174
|
g.__kickjs_container = freshApp.getContainer();
|
|
188
175
|
await freshApp.start();
|
|
189
|
-
log.
|
|
176
|
+
log.debug("HMR rebuild complete");
|
|
190
177
|
return freshApp;
|
|
191
178
|
}
|
|
192
179
|
const app = new Application(options);
|
|
@@ -202,4 +189,4 @@ async function bootstrap(options) {
|
|
|
202
189
|
//#endregion
|
|
203
190
|
export { isClusterPrimary as n, bootstrap as t };
|
|
204
191
|
|
|
205
|
-
//# sourceMappingURL=bootstrap-
|
|
192
|
+
//# sourceMappingURL=bootstrap-Dqw-_Yix.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bootstrap-Dqw-_Yix.mjs","names":["log"],"sources":["../src/http/cluster.ts","../src/http/bootstrap.ts"],"sourcesContent":["import cluster from 'node:cluster'\nimport os from 'node:os'\nimport { createLogger } from '../core'\nimport { reactive, ref } from '../core/reactivity'\n\nconst log = createLogger('Cluster')\n\nexport interface ClusterOptions {\n /** Number of worker processes (default: os.cpus().length) */\n workers?: number\n /** Delay before forcefully killing a worker during shutdown (ms), default: 5000 */\n gracefulShutdownTimeout?: number\n /** Delay between worker restarts (ms), default: 1000 */\n restartDelay?: number\n /** Max failures in restartWindow before refusing to restart, default: 5 */\n maxFailures?: number\n /** Time window for counting failures (ms), default: 30000 */\n restartWindow?: number\n}\n\n/** Returns true if the current process is the cluster primary */\nexport function isClusterPrimary(): boolean {\n return cluster.isPrimary\n}\n\n/**\n * Fork worker processes and manage the cluster lifecycle.\n *\n * The primary process forks `workers` child processes. Each worker\n * shares the same port via Node's built-in `cluster` module (OS\n * round-robin load balancing).\n *\n * Features:\n * - Graceful shutdown with timeout fallback to forceful kill\n * - Auto-restart dead workers (respects voluntary disconnects)\n * - Startup timeout detection (stuck workers)\n * - Crash loop prevention (backoff on rapid failures)\n * - Comprehensive lifecycle logging\n */\nexport function setupClusterPrimary(opts: ClusterOptions): void {\n const numWorkers = opts.workers ?? os.cpus().length\n const gracefulTimeout = opts.gracefulShutdownTimeout ?? 5000\n const restartDelay = opts.restartDelay ?? 1000\n const maxFailures = opts.maxFailures ?? 5\n const restartWindow = opts.restartWindow ?? 30000\n\n const startupTimeouts = new Map<number, NodeJS.Timeout>()\n const state = reactive({\n failureTimestamps: [] as number[],\n shuttingDown: false,\n })\n const activeWorkers = ref(0)\n\n log.info(`Primary ${process.pid} starting ${numWorkers} worker(s)`)\n\n // Initial fork\n for (let i = 0; i < numWorkers; i++) {\n cluster.fork()\n }\n\n // Detect stuck workers (no 'listening' event within timeout)\n cluster.on('fork', (worker) => {\n const timeout = setTimeout(() => {\n log.error(`Worker ${worker.process.pid} did not respond within 10s, killing...`)\n worker.kill()\n }, 10000)\n\n startupTimeouts.set(worker.id, timeout)\n activeWorkers.value++\n log.debug(`Worker ${worker.process.pid} forked (id=${worker.id})`)\n })\n\n // Clear startup timeout when worker is ready\n cluster.on('listening', (worker, address) => {\n const timeout = startupTimeouts.get(worker.id)\n if (timeout) {\n clearTimeout(timeout)\n startupTimeouts.delete(worker.id)\n }\n log.info(`Worker ${worker.process.pid} listening on ${address.address}:${address.port}`)\n })\n\n // Log when worker comes online\n cluster.on('online', (worker) => {\n log.debug(`Worker ${worker.process.pid} online (id=${worker.id})`)\n })\n\n // Auto-restart dead workers (unless intentionally disconnected)\n cluster.on('exit', (worker, code, signal) => {\n // Clear startup timeout if still pending\n const timeout = startupTimeouts.get(worker.id)\n if (timeout) {\n clearTimeout(timeout)\n startupTimeouts.delete(worker.id)\n }\n\n // Don't restart if worker was intentionally disconnected\n activeWorkers.value--\n\n if (worker.exitedAfterDisconnect) {\n log.info(`Worker ${worker.process.pid} exited gracefully (id=${worker.id})`)\n return\n }\n\n // Track crash history globally (worker IDs change on restart)\n const now = Date.now()\n // Remove timestamps outside the window, then add the current failure\n while (\n state.failureTimestamps.length > 0 &&\n now - state.failureTimestamps[0] >= restartWindow\n ) {\n state.failureTimestamps.shift()\n }\n state.failureTimestamps.push(now)\n\n // Prevent restart loops\n if (state.failureTimestamps.length > maxFailures) {\n log.error(\n `${state.failureTimestamps.length} worker failures in ${restartWindow}ms, giving up`,\n )\n // Optionally exit the primary if too many workers are crashing\n if (activeWorkers.value === 0) {\n log.error('All workers have crashed, exiting primary')\n process.exit(1)\n }\n return\n }\n\n log.warn(\n `Worker ${worker.process.pid} died (code=${code}, signal=${signal}), restarting in ${restartDelay}ms... (failures: ${state.failureTimestamps.length}/${maxFailures})`,\n )\n\n setTimeout(() => {\n // Only restart if we still need more workers\n if (activeWorkers.value < numWorkers) {\n cluster.fork()\n }\n }, restartDelay)\n })\n\n // Log when worker disconnects (can happen before exit)\n cluster.on('disconnect', (worker) => {\n log.debug(`Worker ${worker.process.pid} disconnected (id=${worker.id})`)\n })\n\n // Forward shutdown signals to workers (disconnect so exitedAfterDisconnect is set)\n for (const signal of ['SIGTERM', 'SIGINT'] as const) {\n process.on(signal, () => {\n if (state.shuttingDown) return\n state.shuttingDown = true\n log.info(`Primary received ${signal}, disconnecting workers...`)\n cluster.disconnect(() => {\n log.info('All workers disconnected, exiting primary')\n process.exit(0)\n })\n // Force kill after graceful timeout\n setTimeout(() => {\n log.warn('Graceful shutdown timed out, forcing exit')\n process.exit(1)\n }, gracefulTimeout).unref()\n })\n }\n}\n","import cluster from 'node:cluster'\nimport { createLogger, Container } from '../core'\nimport { reloadEnv } from '../config/env'\nimport { Application, type ApplicationOptions } from './application'\nimport { setupClusterPrimary, type ClusterOptions } from './cluster'\n\n/** Reload env from .env file (HMR rebuild) — config now lives in-tree. */\nfunction tryReloadEnv(): void {\n try {\n reloadEnv()\n } catch {\n // Best-effort: never crash bootstrap because env reload failed.\n }\n}\n\nconst log = createLogger('Process')\n\n/**\n * Bootstrap a KickJS application.\n *\n * Creates the Express app, registers modules and adapters, and starts\n * the HTTP server. In dev mode (`kick dev`), the Vite plugin manages\n * the server and HMR — source changes are picked up instantly without\n * losing database connections or WebSocket state.\n *\n * @returns The {@link Application} instance.\n *\n * @example\n * ```ts\n * // src/index.ts\n * import 'reflect-metadata'\n * import { bootstrap } from '@forinda/kickjs'\n * import { modules } from './modules'\n *\n * export const app = await bootstrap({ modules })\n * ```\n */\nexport async function bootstrap(options: ApplicationOptions): Promise<Application> {\n // ── Cluster mode ─────────────────────────────────────────────────────\n // In cluster mode the primary process forks workers and never runs the\n // Express application itself. Only workers proceed past this block.\n // Cluster is disabled in Vite dev mode — Vite owns the HTTP server and\n // forked workers would each create their own Vite instance on separate ports.\n const isViteDev = !!(globalThis as any).__kickjs_httpServer\n if (options.cluster && isViteDev) {\n log.warn(\n 'Cluster mode is ignored in dev — Vite owns the server. Cluster applies in production (kick start).',\n )\n }\n if (options.cluster && cluster.isPrimary && !isViteDev) {\n const clusterOpts: ClusterOptions = typeof options.cluster === 'object' ? options.cluster : {}\n setupClusterPrimary(clusterOpts)\n\n // Return a placeholder — the primary never serves HTTP traffic.\n // The Application is created only so callers get a valid reference.\n return new Application(options)\n }\n\n // Internal: globalThis stores the app instance and Vite's HTTP server\n // reference across HMR rebuilds. When __kickjs_httpServer is set, the\n // Vite plugin owns the port and bootstrap() skips server creation.\n // On subsequent calls (HMR), the Express handler is swapped without\n // restarting the server — preserving DB connections and port bindings.\n const g = globalThis as any\n\n // ── Global error handlers ────────────────────────────────────────────\n if (!g.__kickBootstrapped) {\n process.on('uncaughtException', (err) => {\n log.error(err, 'Uncaught exception')\n })\n\n process.on('unhandledRejection', (reason) => {\n log.error(reason as any, 'Unhandled rejection')\n })\n\n if (!g.__kickjs_httpServer) {\n for (const signal of ['SIGINT', 'SIGTERM'] as const) {\n process.on(signal, async () => {\n log.info(`Received ${signal}, shutting down...`)\n if (g.__app) await g.__app.shutdown()\n process.exit(0)\n })\n }\n }\n\n g.__kickBootstrapped = true\n }\n\n // ── HMR rebuild ──────────────────────────────────────────────────────\n if (g.__app) {\n log.debug('HMR rebuild triggered')\n tryReloadEnv()\n Container.reset()\n\n const freshApp = new Application(options)\n g.__app = freshApp\n g.__kickjs_container = freshApp.getContainer()\n\n await freshApp.start()\n log.debug('HMR rebuild complete')\n return freshApp\n }\n\n // ── First boot ───────────────────────────────────────────────────────\n const app = new Application(options)\n g.__app = app\n g.__kickjs_container = app.getContainer()\n\n if (process.env.KICK_TINKER) {\n await app.registerOnly()\n return app\n }\n\n await app.start()\n\n return app\n}\n"],"mappings":"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"}
|
package/dist/config/index.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v2.
|
|
2
|
+
* @forinda/kickjs v2.3.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,6 +8,6 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import { a as reloadEnv, i as loadEnv, n as defineEnv, o as resetEnvCache, r as getEnv, t as baseEnvSchema } from "../env-
|
|
12
|
-
import { n as createConfigService, t as ConfigService } from "../config-
|
|
11
|
+
import { a as reloadEnv, i as loadEnv, n as defineEnv, o as resetEnvCache, r as getEnv, t as baseEnvSchema } from "../env-X5N7dpDg.mjs";
|
|
12
|
+
import { n as createConfigService, t as ConfigService } from "../config-CQCVrxpN.mjs";
|
|
13
13
|
export { ConfigService, baseEnvSchema, createConfigService, defineEnv, getEnv, loadEnv, reloadEnv, resetEnvCache };
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v2.
|
|
2
|
+
* @forinda/kickjs v2.3.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
11
|
import { Service } from "./core/decorators.mjs";
|
|
12
|
-
import { a as reloadEnv, i as loadEnv } from "./env-
|
|
12
|
+
import { a as reloadEnv, i as loadEnv } from "./env-X5N7dpDg.mjs";
|
|
13
13
|
//#region \0@oxc-project+runtime@0.122.0/helpers/decorate.js
|
|
14
14
|
function __decorate(decorators, target, key, desc) {
|
|
15
15
|
var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
|
|
@@ -132,4 +132,4 @@ function createConfigService(schema) {
|
|
|
132
132
|
//#endregion
|
|
133
133
|
export { createConfigService as n, ConfigService as t };
|
|
134
134
|
|
|
135
|
-
//# sourceMappingURL=config-
|
|
135
|
+
//# sourceMappingURL=config-CQCVrxpN.mjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config-
|
|
1
|
+
{"version":3,"file":"config-CQCVrxpN.mjs","names":[],"sources":["../src/config/config-service.ts"],"sourcesContent":["import type { z } from 'zod'\nimport { Service } from '../core/decorators'\nimport type { EnvKey } from '../core/decorators'\nimport { loadEnv, reloadEnv } from './env'\n\n/**\n * Constraint that locks the `key` argument to known `EnvKey` literals\n * once `kick typegen` has populated `KickEnv`. Mirrors the same trick\n * used by the `@Value` decorator: when `EnvKey` resolves to `never`\n * (no schema yet), accept any string for back-compat; once typegen\n * has run, require a known key.\n */\ntype ConfigKey<K extends string> = [EnvKey] extends [never] ? K : K & EnvKey\n\n/**\n * Resolve the return type for a `ConfigService.get(key)` call. When\n * `KickEnv` is populated and the key is a known one, returns the\n * schema-inferred type. Otherwise falls back to the caller-provided\n * generic `T` (default `any`) so existing call sites keep working.\n */\ntype ConfigValue<K extends string, T> = K extends EnvKey ? KickEnv[K] : T\n\n/**\n * Injectable service for accessing typed environment configuration.\n *\n * Once `kick typegen` has run against your `src/env.ts`, both `get()`\n * and `getAll()` are fully typed against the schema with **no extra\n * setup** — you just inject `ConfigService` and call it:\n *\n * ```ts\n * @Service()\n * class DatabaseService {\n * @Autowired() private readonly config!: ConfigService\n *\n * connect() {\n * const url = this.config.get('DATABASE_URL') // typed string\n * const port = this.config.get('PORT') // typed number\n * // const bad = this.config.get('NOPE') // tsc error\n * }\n * }\n * ```\n *\n * Without typegen the previous `<T = any>` generic still works, so\n * legacy code calling `config.get<string>('DATABASE_URL')` keeps\n * compiling.\n */\n@Service()\nexport class ConfigService {\n /**\n * Read the current parsed env on every access. We deliberately do **not**\n * snapshot in the constructor: if `ConfigService` is instantiated before\n * the user's `defineEnv()` schema has been registered (e.g. DI wires it\n * eagerly, or HMR's `reloadEnv()` cleared the cache between rebuilds),\n * an eager snapshot would freeze the base shape and never see the\n * extended values — even though `@Value()` (which reads lazily through\n * `Container._envResolver`) would resolve them correctly.\n *\n * `loadEnv()` is sticky: once an extended schema has been parsed it\n * keeps returning that schema's values, so this getter is cheap (one\n * cached lookup) and always consistent with `@Value`.\n */\n private get env(): Record<string, any> {\n return loadEnv() as Record<string, any>\n }\n\n /**\n * Get an env variable by key.\n *\n * - When `kick typegen` has run, `key` is constrained to known\n * `KickEnv` keys and the return type is inferred from the schema.\n * - When `KickEnv` is empty (no typegen run yet), any string is\n * accepted and `T` falls back to the explicit generic for\n * back-compat.\n */\n get<K extends string, T = any>(key: ConfigKey<K>): ConfigValue<K, T> {\n return this.env[key] as ConfigValue<K, T>\n }\n\n /**\n * Get all env config as a readonly object. When `KickEnv` is\n * populated by typegen, returns `Readonly<KickEnv>` so the caller\n * gets autocomplete on every key.\n */\n getAll(): [EnvKey] extends [never] ? Readonly<Record<string, any>> : Readonly<KickEnv> {\n return Object.freeze({ ...this.env }) as any\n }\n\n /** Reload env from .env file (for HMR / file-watch scenarios) */\n reload(): void {\n reloadEnv()\n // Touch loadEnv() so the resolver + cache are repopulated immediately.\n loadEnv()\n }\n\n isProduction(): boolean {\n return this.env.NODE_ENV === 'production'\n }\n\n isDevelopment(): boolean {\n return this.env.NODE_ENV === 'development'\n }\n\n isTest(): boolean {\n return this.env.NODE_ENV === 'test'\n }\n}\n\n/**\n * Typed config service interface — provides autocomplete for env keys.\n * Use with `createConfigService()` for full type safety.\n */\nexport interface TypedConfigService<TEnv extends Record<string, any>> {\n get<K extends string & keyof TEnv>(key: K): TEnv[K]\n getAll(): Readonly<TEnv>\n reload(): void\n isProduction(): boolean\n isDevelopment(): boolean\n isTest(): boolean\n}\n\n/**\n * Create a typed ConfigService class bound to a specific Zod env schema.\n * The returned class is DI-injectable via `@Service()` and provides\n * fully typed `get()` with key autocomplete.\n *\n * @example\n * ```ts\n * const envSchema = defineEnv((base) =>\n * base.extend({\n * DATABASE_URL: z.string().url(),\n * JWT_SECRET: z.string().min(32),\n * })\n * )\n *\n * // Create a typed, injectable config service\n * export const AppConfigService = createConfigService(envSchema)\n * export type AppConfigService = InstanceType<typeof AppConfigService>\n *\n * // In a controller or service — inject it:\n * @Controller('/users')\n * class UserController {\n * constructor(@Inject(AppConfigService) private config: AppConfigService) {\n * const dbUrl = config.get('DATABASE_URL') // string — autocompletes!\n * const bad = config.get('NOPE') // TS error\n * }\n * }\n * ```\n */\nexport function createConfigService<T extends z.ZodObject<any>>(schema: T) {\n type TEnv = z.infer<T>\n\n @Service()\n class SchemaConfigService implements TypedConfigService<TEnv> {\n /** See note on `ConfigService.env` — same eager-snapshot hazard. */\n private get env(): TEnv {\n return loadEnv(schema)\n }\n\n get<K extends string & keyof TEnv>(key: K): TEnv[K] {\n return this.env[key]\n }\n\n getAll(): Readonly<TEnv> {\n return Object.freeze({ ...this.env })\n }\n\n reload(): void {\n reloadEnv()\n loadEnv(schema)\n }\n\n isProduction(): boolean {\n return this.env.NODE_ENV === 'production'\n }\n\n isDevelopment(): boolean {\n return this.env.NODE_ENV === 'development'\n }\n\n isTest(): boolean {\n return this.env.NODE_ENV === 'test'\n }\n }\n\n return SchemaConfigService as {\n new (): TypedConfigService<TEnv>\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA+CO,IAAA,gBAAA,MAAM,cAAc;;;;;;;;;;;;;;CAczB,IAAY,MAA2B;AACrC,SAAO,SAAS;;;;;;;;;;;CAYlB,IAA+B,KAAsC;AACnE,SAAO,KAAK,IAAI;;;;;;;CAQlB,SAAuF;AACrF,SAAO,OAAO,OAAO,EAAE,GAAG,KAAK,KAAK,CAAC;;;CAIvC,SAAe;AACb,aAAW;AAEX,WAAS;;CAGX,eAAwB;AACtB,SAAO,KAAK,IAAI,aAAa;;CAG/B,gBAAyB;AACvB,SAAO,KAAK,IAAI,aAAa;;CAG/B,SAAkB;AAChB,SAAO,KAAK,IAAI,aAAa;;;4BAzDhC,SAAS,CAAA,EAAA,cAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsGV,SAAgB,oBAAgD,QAAW;CAGzE,IAAA,sBAAA,MACM,oBAAwD;;EAE5D,IAAY,MAAY;AACtB,UAAO,QAAQ,OAAO;;EAGxB,IAAmC,KAAiB;AAClD,UAAO,KAAK,IAAI;;EAGlB,SAAyB;AACvB,UAAO,OAAO,OAAO,EAAE,GAAG,KAAK,KAAK,CAAC;;EAGvC,SAAe;AACb,cAAW;AACX,WAAQ,OAAO;;EAGjB,eAAwB;AACtB,UAAO,KAAK,IAAI,aAAa;;EAG/B,gBAAyB;AACvB,UAAO,KAAK,IAAI,aAAa;;EAG/B,SAAkB;AAChB,UAAO,KAAK,IAAI,aAAa;;;mCA7BhC,SAAS,CAAA,EAAA,oBAAA;AAiCV,QAAO"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v2.
|
|
2
|
+
* @forinda/kickjs v2.3.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
*/
|
|
11
11
|
import { METADATA, Scope } from "./core/interfaces.mjs";
|
|
12
12
|
import { createLogger } from "./core/logger.mjs";
|
|
13
|
-
import { i as getMetaRecord, n as getClassMetaOrUndefined, o as getMethodMetaOrUndefined, r as getMetaMap, t as getClassMeta } from "./metadata-
|
|
13
|
+
import { i as getMetaRecord, n as getClassMetaOrUndefined, o as getMethodMetaOrUndefined, r as getMetaMap, t as getClassMeta } from "./metadata-zDHf1djN.mjs";
|
|
14
14
|
import "reflect-metadata";
|
|
15
15
|
//#region src/core/token.ts
|
|
16
16
|
/**
|
|
@@ -493,4 +493,4 @@ var Container = class Container {
|
|
|
493
493
|
//#endregion
|
|
494
494
|
export { isInjectionToken as a, createToken as i, tokenName as n, INJECTION_TOKEN as r, Container as t };
|
|
495
495
|
|
|
496
|
-
//# sourceMappingURL=container-
|
|
496
|
+
//# sourceMappingURL=container-0sTWvL-c.mjs.map
|