@forinda/kickjs 2.1.0 → 2.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +63 -20
- package/dist/{adapter-BqGjZCSm.d.mts → adapter-wuoBNkNs.d.mts} +3 -3
- package/dist/{adapter-BqGjZCSm.d.mts.map → adapter-wuoBNkNs.d.mts.map} +1 -1
- package/dist/{app-module-CcEbAVtB.d.mts → app-module-DOBmxARW.d.mts} +11 -4
- package/dist/app-module-DOBmxARW.d.mts.map +1 -0
- package/dist/{application-DNHj-_UL.mjs → application-cYhTEy84.mjs} +6 -6
- package/dist/application-cYhTEy84.mjs.map +1 -0
- package/dist/{bootstrap-DLEZaJ3b.mjs → bootstrap-8_iBHhWp.mjs} +6 -6
- package/dist/{bootstrap-DLEZaJ3b.mjs.map → bootstrap-8_iBHhWp.mjs.map} +1 -1
- package/dist/{cache-DJeMaGqb.d.mts → cache-PufEhr0n.d.mts} +1 -1
- package/dist/{cache-DJeMaGqb.d.mts.map → cache-PufEhr0n.d.mts.map} +1 -1
- package/dist/{chunk-C5Qp-JxE.mjs → chunk-Djztpsb3.mjs} +1 -1
- package/dist/container-BKiJzakw.mjs +496 -0
- package/dist/container-BKiJzakw.mjs.map +1 -0
- package/dist/{container-nBSIhyqV.d.mts → container-CcgV8eHL.d.mts} +116 -4
- package/dist/container-CcgV8eHL.d.mts.map +1 -0
- package/dist/core/adapter.d.mts +1 -1
- package/dist/core/adapter.mjs +1 -1
- package/dist/core/app-module.d.mts +1 -1
- package/dist/core/app-module.mjs +1 -1
- package/dist/core/cache.d.mts +1 -1
- package/dist/core/cache.mjs +1 -1
- package/dist/core/container.d.mts +2 -2
- package/dist/core/container.mjs +2 -416
- package/dist/core/cron.d.mts +1 -1
- package/dist/core/cron.mjs +2 -2
- package/dist/core/decorators.d.mts +2 -2
- package/dist/core/decorators.mjs +9 -3
- package/dist/core/decorators.mjs.map +1 -1
- package/dist/core/errors.d.mts +1 -1
- package/dist/core/errors.mjs +1 -1
- package/dist/core/interfaces.d.mts +1 -1
- package/dist/core/interfaces.mjs +1 -1
- package/dist/core/logger.d.mts +1 -1
- package/dist/core/logger.mjs +1 -1
- package/dist/core/path.d.mts +1 -1
- package/dist/core/path.mjs +1 -1
- package/dist/core/plugin.d.mts +1 -1
- package/dist/core/plugin.mjs +1 -1
- package/dist/core/reactivity.d.mts +1 -1
- package/dist/core/reactivity.mjs +1 -1
- package/dist/{core-BL_H8fEZ.mjs → core-CXHuViXn.mjs} +4 -4
- package/dist/{core-BL_H8fEZ.mjs.map → core-CXHuViXn.mjs.map} +1 -1
- package/dist/{cron-RKhH5TOd.d.mts → cron-C29iHvHT.d.mts} +1 -1
- package/dist/{cron-RKhH5TOd.d.mts.map → cron-C29iHvHT.d.mts.map} +1 -1
- package/dist/{decorators-CQ93ak6Z.d.mts → decorators-D3lBlmud.d.mts} +54 -4
- package/dist/decorators-D3lBlmud.d.mts.map +1 -0
- package/dist/{errors-te5Km00o.d.mts → errors-BZUdxtjC.d.mts} +1 -1
- package/dist/{errors-te5Km00o.d.mts.map → errors-BZUdxtjC.d.mts.map} +1 -1
- package/dist/http/application.d.mts +4 -4
- package/dist/http/application.d.mts.map +1 -1
- package/dist/http/application.mjs +2 -2
- package/dist/http/bootstrap.mjs +2 -2
- package/dist/http/context.d.mts +67 -8
- package/dist/http/context.d.mts.map +1 -1
- package/dist/http/context.mjs +10 -5
- package/dist/http/context.mjs.map +1 -1
- 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.d.mts +1 -1
- package/dist/http/middleware/spa.mjs +3 -3
- package/dist/http/middleware/upload.d.mts +1 -1
- package/dist/http/middleware/upload.mjs +1 -1
- package/dist/http/middleware/validate.mjs +1 -1
- package/dist/http/middleware/views.d.mts +1 -1
- package/dist/http/middleware/views.mjs +2 -2
- package/dist/http/query/index.d.mts +2 -2
- package/dist/http/query/index.mjs +2 -2
- package/dist/http/router-builder.mjs +4 -4
- package/dist/{index-C0gbnpSg.d.mts → index-4VM4dUJf.d.mts} +1 -1
- package/dist/{index-C0gbnpSg.d.mts.map → index-4VM4dUJf.d.mts.map} +1 -1
- package/dist/{index-Cls52etj.d.mts → index-rnK23QBD.d.mts} +39 -3
- package/dist/index-rnK23QBD.d.mts.map +1 -0
- package/dist/index.d.mts +16 -16
- package/dist/index.mjs +8 -8
- package/dist/{interfaces-D-48zotH.d.mts → interfaces-D5ohYl6D.d.mts} +1 -1
- package/dist/{interfaces-D-48zotH.d.mts.map → interfaces-D5ohYl6D.d.mts.map} +1 -1
- package/dist/{logger-Dzj-TF0t.d.mts → logger-BLdfUF5b.d.mts} +1 -1
- package/dist/{logger-Dzj-TF0t.d.mts.map → logger-BLdfUF5b.d.mts.map} +1 -1
- package/dist/{metadata-fmvikBA0.mjs → metadata-D5L3_cdl.mjs} +2 -2
- package/dist/{metadata-fmvikBA0.mjs.map → metadata-D5L3_cdl.mjs.map} +1 -1
- package/dist/{path-LmwfhfyH.d.mts → path-Dq5V-i-x.d.mts} +1 -1
- package/dist/path-Dq5V-i-x.d.mts.map +1 -0
- package/dist/{plugin-DIoPIpSm.d.mts → plugin-D20muJwC.d.mts} +4 -4
- package/dist/{plugin-DIoPIpSm.d.mts.map → plugin-D20muJwC.d.mts.map} +1 -1
- package/dist/{query-7cdHF6ry.mjs → query-BSIApo6Y.mjs} +6 -6
- package/dist/query-BSIApo6Y.mjs.map +1 -0
- package/dist/{reactivity-BbS-99ow.d.mts → reactivity-CMAQh0gi.d.mts} +1 -1
- package/dist/{reactivity-BbS-99ow.d.mts.map → reactivity-CMAQh0gi.d.mts.map} +1 -1
- package/package.json +16 -13
- package/dist/app-module-CcEbAVtB.d.mts.map +0 -1
- package/dist/application-DNHj-_UL.mjs.map +0 -1
- package/dist/container-nBSIhyqV.d.mts.map +0 -1
- package/dist/core/container.mjs.map +0 -1
- package/dist/decorators-CQ93ak6Z.d.mts.map +0 -1
- package/dist/index-Cls52etj.d.mts.map +0 -1
- package/dist/path-LmwfhfyH.d.mts.map +0 -1
- package/dist/query-7cdHF6ry.mjs.map +0 -1
package/README.md
CHANGED
|
@@ -36,7 +36,7 @@ kick new my-api && cd my-api && kick dev
|
|
|
36
36
|
|
|
37
37
|
```typescript
|
|
38
38
|
import 'reflect-metadata'
|
|
39
|
-
import { Controller, Get, Service, Autowired, bootstrap,
|
|
39
|
+
import { Controller, Get, Service, Autowired, bootstrap, type Ctx } from '@forinda/kickjs'
|
|
40
40
|
|
|
41
41
|
@Service()
|
|
42
42
|
class GreetService {
|
|
@@ -48,7 +48,7 @@ class HelloController {
|
|
|
48
48
|
@Autowired() private greet!: GreetService
|
|
49
49
|
|
|
50
50
|
@Get('/')
|
|
51
|
-
handle(ctx:
|
|
51
|
+
handle(ctx: Ctx) {
|
|
52
52
|
ctx.json({ message: this.greet.greet('KickJS') })
|
|
53
53
|
}
|
|
54
54
|
}
|
|
@@ -65,18 +65,22 @@ import {
|
|
|
65
65
|
// DI + Decorators
|
|
66
66
|
Controller, Get, Post, Put, Delete, Patch,
|
|
67
67
|
Service, Repository, Autowired, Inject, Value, Middleware,
|
|
68
|
+
createToken, // typed DI tokens: createToken<T>('name')
|
|
68
69
|
|
|
69
70
|
// Application
|
|
70
|
-
bootstrap, Application,
|
|
71
|
+
bootstrap, Application, buildRoutes,
|
|
72
|
+
RequestContext, type Ctx, type RouteShape,
|
|
71
73
|
|
|
72
74
|
// Middleware
|
|
73
75
|
helmet, cors, csrf, rateLimit, requestId, requestLogger,
|
|
74
|
-
validate, upload, session,
|
|
76
|
+
validate, upload, session, traceContext,
|
|
77
|
+
|
|
78
|
+
// Query parsing
|
|
79
|
+
parseQuery, type QueryFieldConfig, type ParsedQuery,
|
|
75
80
|
|
|
76
81
|
// Utilities
|
|
77
82
|
Container, HttpException, createLogger,
|
|
78
83
|
ref, computed, watch,
|
|
79
|
-
parseQuery, normalizePath,
|
|
80
84
|
|
|
81
85
|
// Types
|
|
82
86
|
type AppAdapter, type AdapterContext, type AppModule,
|
|
@@ -84,6 +88,45 @@ import {
|
|
|
84
88
|
} from '@forinda/kickjs'
|
|
85
89
|
```
|
|
86
90
|
|
|
91
|
+
## Typed Routes, Body, Query, and Env
|
|
92
|
+
|
|
93
|
+
Run `kick typegen` (via the CLI) to generate `KickRoutes` and `KickEnv` from
|
|
94
|
+
your codebase. Once generated, route handlers, request bodies, query strings,
|
|
95
|
+
and `@Value` injections are all type-checked end-to-end:
|
|
96
|
+
|
|
97
|
+
```typescript
|
|
98
|
+
import { Controller, Post, Autowired, Value, type Ctx } from '@forinda/kickjs'
|
|
99
|
+
import { z } from 'zod'
|
|
100
|
+
|
|
101
|
+
const createUserBody = z.object({ name: z.string(), email: z.string().email() })
|
|
102
|
+
|
|
103
|
+
@Controller('/users')
|
|
104
|
+
class UserController {
|
|
105
|
+
// Typed env injection — keys come from KickEnv (your src/env.ts)
|
|
106
|
+
@Value('DATABASE_URL') private dbUrl!: string
|
|
107
|
+
|
|
108
|
+
@Post('/', { body: createUserBody })
|
|
109
|
+
create(ctx: Ctx<KickRoutes['POST /users']>) {
|
|
110
|
+
ctx.body.email // ✅ string — inferred from the Zod schema
|
|
111
|
+
ctx.created({ id: '1', ...ctx.body })
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
## Typed DI Tokens
|
|
117
|
+
|
|
118
|
+
```typescript
|
|
119
|
+
import { createToken, Inject, Service } from '@forinda/kickjs'
|
|
120
|
+
|
|
121
|
+
export const USER_REPO = createToken<UserRepository>('user.repo')
|
|
122
|
+
|
|
123
|
+
@Service()
|
|
124
|
+
class UserService {
|
|
125
|
+
constructor(@Inject(USER_REPO) private readonly repo: UserRepository) {}
|
|
126
|
+
// repo is typed as UserRepository — no casts
|
|
127
|
+
}
|
|
128
|
+
```
|
|
129
|
+
|
|
87
130
|
## Typed Adapter Hooks
|
|
88
131
|
|
|
89
132
|
```typescript
|
|
@@ -111,21 +154,21 @@ class MyAdapter implements AppAdapter {
|
|
|
111
154
|
|
|
112
155
|
| Package | Description |
|
|
113
156
|
|---------|-------------|
|
|
114
|
-
| `@forinda/kickjs` | Core framework (DI, decorators, Express 5, middleware) |
|
|
115
|
-
| `@forinda/kickjs-config` | Zod-based env validation, ConfigService, `@Value` |
|
|
116
|
-
| `@forinda/kickjs-swagger` | Auto OpenAPI from decorators + Zod schemas |
|
|
117
|
-
| `@forinda/kickjs-cli` | Scaffolding, DDD generators, custom commands |
|
|
118
|
-
| `@forinda/kickjs-testing` | `createTestApp`, `createTestModule` |
|
|
119
|
-
| `@forinda/kickjs-prisma` | Prisma adapter (v5/6/7) |
|
|
120
|
-
| `@forinda/kickjs-drizzle` | Drizzle adapter, query builder |
|
|
121
|
-
| `@forinda/kickjs-auth` | JWT, API key, OAuth strategies |
|
|
122
|
-
| `@forinda/kickjs-ws` | WebSocket with `@WsController` |
|
|
123
|
-
| `@forinda/kickjs-queue` | BullMQ, RabbitMQ, Kafka |
|
|
124
|
-
| `@forinda/kickjs-cron` | `@Cron` decorator scheduling |
|
|
125
|
-
| `@forinda/kickjs-mailer` | SMTP, Resend, SES |
|
|
126
|
-
| `@forinda/kickjs-graphql` | `@Resolver`, `@Query`, `@Mutation` |
|
|
127
|
-
| `@forinda/kickjs-otel` | OpenTelemetry tracing + metrics |
|
|
128
|
-
| `@forinda/kickjs-devtools` | Debug dashboard at `/_debug` |
|
|
157
|
+
| [`@forinda/kickjs`](https://www.npmjs.com/package/@forinda/kickjs) | Core framework (DI, decorators, Express 5, middleware) |
|
|
158
|
+
| [`@forinda/kickjs-config`](https://www.npmjs.com/package/@forinda/kickjs-config) | Zod-based env validation, ConfigService, `@Value` |
|
|
159
|
+
| [`@forinda/kickjs-swagger`](https://www.npmjs.com/package/@forinda/kickjs-swagger) | Auto OpenAPI from decorators + Zod schemas |
|
|
160
|
+
| [`@forinda/kickjs-cli`](https://www.npmjs.com/package/@forinda/kickjs-cli) | Scaffolding, DDD generators, custom commands |
|
|
161
|
+
| [`@forinda/kickjs-testing`](https://www.npmjs.com/package/@forinda/kickjs-testing) | `createTestApp`, `createTestModule` |
|
|
162
|
+
| [`@forinda/kickjs-prisma`](https://www.npmjs.com/package/@forinda/kickjs-prisma) | Prisma adapter (v5/6/7) |
|
|
163
|
+
| [`@forinda/kickjs-drizzle`](https://www.npmjs.com/package/@forinda/kickjs-drizzle) | Drizzle adapter, query builder |
|
|
164
|
+
| [`@forinda/kickjs-auth`](https://www.npmjs.com/package/@forinda/kickjs-auth) | JWT, API key, OAuth strategies |
|
|
165
|
+
| [`@forinda/kickjs-ws`](https://www.npmjs.com/package/@forinda/kickjs-ws) | WebSocket with `@WsController` |
|
|
166
|
+
| [`@forinda/kickjs-queue`](https://www.npmjs.com/package/@forinda/kickjs-queue) | BullMQ, RabbitMQ, Kafka |
|
|
167
|
+
| [`@forinda/kickjs-cron`](https://www.npmjs.com/package/@forinda/kickjs-cron) | `@Cron` decorator scheduling |
|
|
168
|
+
| [`@forinda/kickjs-mailer`](https://www.npmjs.com/package/@forinda/kickjs-mailer) | SMTP, Resend, SES |
|
|
169
|
+
| [`@forinda/kickjs-graphql`](https://www.npmjs.com/package/@forinda/kickjs-graphql) | `@Resolver`, `@Query`, `@Mutation` |
|
|
170
|
+
| [`@forinda/kickjs-otel`](https://www.npmjs.com/package/@forinda/kickjs-otel) | OpenTelemetry tracing + metrics |
|
|
171
|
+
| [`@forinda/kickjs-devtools`](https://www.npmjs.com/package/@forinda/kickjs-devtools) | Debug dashboard at `/_debug` |
|
|
129
172
|
|
|
130
173
|
## CLI
|
|
131
174
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
|
|
2
|
-
import { i as Constructor, o as MaybePromise } from "./interfaces-
|
|
3
|
-
import { t as Container } from "./container-
|
|
2
|
+
import { i as Constructor, o as MaybePromise } from "./interfaces-D5ohYl6D.mjs";
|
|
3
|
+
import { t as Container } from "./container-CcgV8eHL.mjs";
|
|
4
4
|
import http from "node:http";
|
|
5
5
|
import { Express } from "express";
|
|
6
6
|
|
|
@@ -119,4 +119,4 @@ interface AppAdapter {
|
|
|
119
119
|
type AppAdapterClass = new () => AppAdapter;
|
|
120
120
|
//#endregion
|
|
121
121
|
export { MiddlewarePhase as a, AppAdapterClass as i, AdapterMiddleware as n, AppAdapter as r, AdapterContext as t };
|
|
122
|
-
//# sourceMappingURL=adapter-
|
|
122
|
+
//# sourceMappingURL=adapter-wuoBNkNs.d.mts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"adapter-
|
|
1
|
+
{"version":3,"file":"adapter-wuoBNkNs.d.mts","names":[],"sources":["../src/core/adapter.ts"],"mappings":";;;;;;;;;AAaA;;;;;AAGA;KAHY,eAAA;;UAGK,iBAAA;EAEf;EAAA,OAAA;EAEQ;EAAR,KAAA,GAAQ,eAAA;EAEJ;EAAJ,IAAA;AAAA;;;;;;;;;;;;;;UAgBe,cAAA;EAQf;EANA,GAAA,EAAK,OAAA;EAQO;EANZ,SAAA,EAAW,SAAA;EAqCI;EAnCf,MAAA,GAAS,IAAA,CAAK,MAAA;;EAEd,GAAA;EA+CkB;EA7ClB,YAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA+Be,UAAA;EAsCa;EApC5B,IAAA;EAuCA;;;;EAjCA,UAAA,KAAe,iBAAA;EAqCU;;;;EA/BzB,WAAA,EAAa,GAAA,EAAK,cAAA,UAAwB,OAAA;;;;;EAM1C,YAAA,EAAc,eAAA,EAAiB,WAAA,EAAa,SAAA;;;;;EAM5C,WAAA,EAAa,GAAA,EAAK,cAAA,UAAwB,OAAA;;;;;EAM1C,UAAA,EAAY,GAAA,EAAK,cAAA,UAAwB,OAAA;;;;;EAMzC,aAAA,KAAkB,OAAA;IAAU,IAAA;IAAc,MAAA;EAAA;;EAG1C,QAAA,KAAa,YAAA;AAAA;;KAIH,eAAA,aAA4B,UAAA"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
|
|
2
|
-
import { t as Container } from "./container-
|
|
2
|
+
import { t as Container } from "./container-CcgV8eHL.mjs";
|
|
3
3
|
|
|
4
4
|
//#region src/core/app-module.d.ts
|
|
5
5
|
/**
|
|
@@ -19,10 +19,17 @@ interface ModuleRoutes {
|
|
|
19
19
|
/**
|
|
20
20
|
* Interface that every feature module must implement.
|
|
21
21
|
* Modules register their DI bindings and declare their routes.
|
|
22
|
+
*
|
|
23
|
+
* `register` is **optional**. Modules that only contain decorated classes
|
|
24
|
+
* (`@Service`, `@Controller`, `@Repository`, `@Component`) don't need it
|
|
25
|
+
* because the decorators handle DI registration automatically. Implement
|
|
26
|
+
* `register(container)` only when you need to bind a token (typically a
|
|
27
|
+
* repository interface symbol) to a concrete implementation via
|
|
28
|
+
* `container.registerFactory()` / `container.registerInstance()`.
|
|
22
29
|
*/
|
|
23
30
|
interface AppModule {
|
|
24
|
-
/**
|
|
25
|
-
register(container: Container): void;
|
|
31
|
+
/** Optional — bind interfaces to implementations in the container */
|
|
32
|
+
register?(container: Container): void;
|
|
26
33
|
/** Return route definitions for this module, or null for non-HTTP modules */
|
|
27
34
|
routes(): ModuleRoutes | ModuleRoutes[] | null;
|
|
28
35
|
}
|
|
@@ -30,4 +37,4 @@ interface AppModule {
|
|
|
30
37
|
type AppModuleClass = new () => AppModule;
|
|
31
38
|
//#endregion
|
|
32
39
|
export { AppModuleClass as n, ModuleRoutes as r, AppModule as t };
|
|
33
|
-
//# sourceMappingURL=app-module-
|
|
40
|
+
//# sourceMappingURL=app-module-DOBmxARW.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"app-module-DOBmxARW.d.mts","names":[],"sources":["../src/core/app-module.ts"],"mappings":";;;;;;AAMA;;UAAiB,YAAA;EAAY;EAE3B,IAAA;EAEA;EAAA,MAAA;EAIA;EAFA,OAAA;EAEU;EAAV,UAAA;AAAA;;;;;;;;;;;;UAce,SAAA;EAIsB;EAFrC,QAAA,EAAU,SAAA,EAAW,SAAA;EAMX;EAJV,MAAA,IAAU,YAAA,GAAe,YAAA;AAAA;;KAIf,cAAA,aAA2B,SAAA"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v2.1
|
|
2
|
+
* @forinda/kickjs v2.2.1
|
|
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 { Container } from "./
|
|
13
|
+
import { t as getClassMeta } from "./metadata-D5L3_cdl.mjs";
|
|
14
|
+
import { t as Container } from "./container-BKiJzakw.mjs";
|
|
15
15
|
import { normalizePath } from "./core/path.mjs";
|
|
16
|
-
import "./core-
|
|
16
|
+
import "./core-CXHuViXn.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";
|
|
@@ -181,7 +181,7 @@ var Application = class {
|
|
|
181
181
|
this.mountMiddlewareList(adapterMw.afterGlobal);
|
|
182
182
|
const modules = [...this.plugins.flatMap((p) => p.modules?.() ?? []), ...this.options.modules].map((ModuleClass) => {
|
|
183
183
|
const mod = new ModuleClass();
|
|
184
|
-
mod.register(this.container);
|
|
184
|
+
mod.register?.(this.container);
|
|
185
185
|
return mod;
|
|
186
186
|
});
|
|
187
187
|
this.container.bootstrap();
|
|
@@ -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-cYhTEy84.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"application-cYhTEy84.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.info('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.info('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.info(` ${name.padEnd(30)} ${mountPath.padEnd(25)} ${defs.length} routes (${methods})`)\n }\n\n log.info(` 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.info('Attached to Vite dev server (adapters use Vite httpServer)')\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.info('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.info('Shutdown already in progress, skipping duplicate call')\n return\n }\n this._shutdownInitiated = true\n this._draining = true\n\n log.info('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.info(`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.info('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":"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"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v2.1
|
|
2
|
+
* @forinda/kickjs v2.2.1
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,12 +8,12 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import { t as __require } from "./chunk-
|
|
11
|
+
import { t as __require } from "./chunk-Djztpsb3.mjs";
|
|
12
12
|
import { createLogger } from "./core/logger.mjs";
|
|
13
|
-
import { Container } from "./
|
|
14
|
-
import "./core-
|
|
13
|
+
import { t as Container } from "./container-BKiJzakw.mjs";
|
|
14
|
+
import "./core-CXHuViXn.mjs";
|
|
15
15
|
import { reactive, ref } from "./core/reactivity.mjs";
|
|
16
|
-
import { t as Application } from "./application-
|
|
16
|
+
import { t as Application } from "./application-cYhTEy84.mjs";
|
|
17
17
|
import cluster from "node:cluster";
|
|
18
18
|
import os from "node:os";
|
|
19
19
|
//#region src/http/cluster.ts
|
|
@@ -202,4 +202,4 @@ async function bootstrap(options) {
|
|
|
202
202
|
//#endregion
|
|
203
203
|
export { isClusterPrimary as n, bootstrap as t };
|
|
204
204
|
|
|
205
|
-
//# sourceMappingURL=bootstrap-
|
|
205
|
+
//# sourceMappingURL=bootstrap-8_iBHhWp.mjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bootstrap-DLEZaJ3b.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 { Application, type ApplicationOptions } from './application'\nimport { setupClusterPrimary, type ClusterOptions } from './cluster'\n\n/** Try to reload env from .env file if config package is available */\nfunction tryReloadEnv(): void {\n try {\n const config = require('@forinda/kickjs-config')\n config.reloadEnv?.()\n } catch {\n // Config package not installed — skip\n }\n}\n\nconst log = createLogger('Process')\n\n/**\n * Bootstrap a KickJS application with zero boilerplate.\n *\n * ## Dev Mode (with @forinda/kickjs-vite)\n *\n * When the Vite plugin is active (`globalThis.__kickjs_httpServer` is set),\n * `bootstrap()` sets up the Express app and adapters but does NOT start\n * the HTTP server — Vite owns the port. The returned `app` object has a\n * `.handle(req, res, next)` method that the Vite dev-server plugin calls\n * on each request via `ssrLoadModule()`.\n *\n * ## Production Mode\n *\n * Without the Vite plugin, `bootstrap()` creates its own `http.Server`,\n * binds to the port, and starts listening — same behavior as before.\n *\n * ## HMR\n *\n * On subsequent calls (module re-evaluation), `bootstrap()` rebuilds the\n * Express app and swaps the request handler without restarting the server.\n *\n * @returns The Application instance. In Vite dev mode, the Express handler\n * is accessible at `app.handle` for the dev-server plugin to use.\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 for Vite plugin (dev) — also works standalone (prod)\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 if (options.cluster && cluster.isPrimary) {\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 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.info('HMR: Rebuilding application...')\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.info('HMR: Application rebuilt with fresh modules')\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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"}
|
|
1
|
+
{"version":3,"file":"bootstrap-8_iBHhWp.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 { Application, type ApplicationOptions } from './application'\nimport { setupClusterPrimary, type ClusterOptions } from './cluster'\n\n/** Try to reload env from .env file if config package is available */\nfunction tryReloadEnv(): void {\n try {\n const config = require('@forinda/kickjs-config')\n config.reloadEnv?.()\n } catch {\n // Config package not installed — skip\n }\n}\n\nconst log = createLogger('Process')\n\n/**\n * Bootstrap a KickJS application with zero boilerplate.\n *\n * ## Dev Mode (with @forinda/kickjs-vite)\n *\n * When the Vite plugin is active (`globalThis.__kickjs_httpServer` is set),\n * `bootstrap()` sets up the Express app and adapters but does NOT start\n * the HTTP server — Vite owns the port. The returned `app` object has a\n * `.handle(req, res, next)` method that the Vite dev-server plugin calls\n * on each request via `ssrLoadModule()`.\n *\n * ## Production Mode\n *\n * Without the Vite plugin, `bootstrap()` creates its own `http.Server`,\n * binds to the port, and starts listening — same behavior as before.\n *\n * ## HMR\n *\n * On subsequent calls (module re-evaluation), `bootstrap()` rebuilds the\n * Express app and swaps the request handler without restarting the server.\n *\n * @returns The Application instance. In Vite dev mode, the Express handler\n * is accessible at `app.handle` for the dev-server plugin to use.\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 for Vite plugin (dev) — also works standalone (prod)\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 if (options.cluster && cluster.isPrimary) {\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 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.info('HMR: Rebuilding application...')\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.info('HMR: Application rebuilt with fresh modules')\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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"}
|
|
@@ -92,4 +92,4 @@ declare function Cacheable(ttl?: number, options?: {
|
|
|
92
92
|
declare function CacheEvict(key: string): MethodDecorator;
|
|
93
93
|
//#endregion
|
|
94
94
|
export { Cacheable as a, setCacheProvider as c, CacheProvider as i, CacheEvict as n, MemoryCacheProvider as o, CacheOptions as r, getCacheProvider as s, CACHEABLE_META as t };
|
|
95
|
-
//# sourceMappingURL=cache-
|
|
95
|
+
//# sourceMappingURL=cache-PufEhr0n.d.mts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cache-
|
|
1
|
+
{"version":3,"file":"cache-PufEhr0n.d.mts","names":[],"sources":["../src/core/cache.ts"],"mappings":";;cAEM,cAAA;;AAFmB;;;;;AA8BzB;;;;;;;;;;;;;;;;;;UAAiB,aAAA;EAMX;EAJJ,GAAA,CAAI,GAAA,WAAc,OAAA;EAMlB;EAJA,GAAA,CAAI,GAAA,UAAa,KAAA,OAAY,KAAA,WAAgB,OAAA;EAIf;EAF9B,GAAA,CAAI,GAAA,WAAc,OAAA;EAIL;EAFb,WAAA,EAAa,MAAA,WAAiB,OAAA;EAEV;EAApB,QAAA,KAAa,OAAA;AAAA;;;;;;cAUF,mBAAA,YAA+B,aAAA;EAAA,QAClC,KAAA;EAEF,GAAA,CAAI,GAAA,WAAc,OAAA;EAUlB,GAAA,CAAI,GAAA,UAAa,KAAA,OAAY,KAAA,WAAgB,OAAA;EAI7C,GAAA,CAAI,GAAA,WAAc,OAAA;EAIlB,WAAA,CAAY,MAAA,WAAiB,OAAA;EAQ7B,QAAA,CAAA,GAAY,OAAA;AAAA;;;;;;;;;;;;;iBAqBJ,gBAAA,CAAiB,QAAA,EAAU,aAAA;;iBAK3B,gBAAA,CAAA,GAAoB,aAAA;AAAA,UAMnB,YAAA;EAXD;EAad,GAAA;;EAEA,GAAA;AAAA;AAVF;;;;;AAMA;;;;AANA,iBAwBgB,SAAA,CAAU,GAAA,WAAc,OAAA;EAAY,GAAA;AAAA,IAAiB,eAAA;;;;;;;iBAgCrD,UAAA,CAAW,GAAA,WAAc,eAAA"}
|