@forinda/kickjs 2.0.0 → 2.1.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 +85 -584
- package/dist/adapter-BqGjZCSm.d.mts +122 -0
- package/dist/adapter-BqGjZCSm.d.mts.map +1 -0
- package/dist/app-module-CcEbAVtB.d.mts +33 -0
- package/dist/app-module-CcEbAVtB.d.mts.map +1 -0
- package/dist/application-DNHj-_UL.mjs +449 -0
- package/dist/application-DNHj-_UL.mjs.map +1 -0
- package/dist/bootstrap-DLEZaJ3b.mjs +205 -0
- package/dist/bootstrap-DLEZaJ3b.mjs.map +1 -0
- package/dist/{core/cache.d.ts → cache-DJeMaGqb.d.mts} +33 -31
- package/dist/cache-DJeMaGqb.d.mts.map +1 -0
- package/dist/chunk-C5Qp-JxE.mjs +15 -0
- package/dist/container-nBSIhyqV.d.mts +141 -0
- package/dist/container-nBSIhyqV.d.mts.map +1 -0
- package/dist/core/adapter.d.mts +3 -0
- package/dist/core/adapter.mjs +11 -0
- package/dist/core/app-module.d.mts +3 -0
- package/dist/core/app-module.mjs +11 -0
- package/dist/core/cache.d.mts +3 -0
- package/dist/core/cache.mjs +113 -0
- package/dist/core/cache.mjs.map +1 -0
- package/dist/core/container.d.mts +3 -0
- package/dist/core/container.mjs +426 -0
- package/dist/core/container.mjs.map +1 -0
- package/dist/core/cron.d.mts +3 -0
- package/dist/core/cron.mjs +42 -0
- package/dist/core/cron.mjs.map +1 -0
- package/dist/core/decorators.d.mts +3 -0
- package/dist/core/decorators.mjs +213 -0
- package/dist/core/decorators.mjs.map +1 -0
- package/dist/core/errors.d.mts +3 -0
- package/dist/core/errors.mjs +97 -0
- package/dist/core/errors.mjs.map +1 -0
- package/dist/core/interfaces.d.mts +3 -0
- package/dist/core/interfaces.mjs +44 -0
- package/dist/core/interfaces.mjs.map +1 -0
- package/dist/core/logger.d.mts +3 -0
- package/dist/core/logger.mjs +217 -0
- package/dist/core/logger.mjs.map +1 -0
- package/dist/core/path.d.mts +3 -0
- package/dist/core/path.mjs +45 -0
- package/dist/core/path.mjs.map +1 -0
- package/dist/core/plugin.d.mts +3 -0
- package/dist/core/plugin.mjs +11 -0
- package/dist/core/reactivity.d.mts +3 -0
- package/dist/core/reactivity.mjs +189 -0
- package/dist/core/reactivity.mjs.map +1 -0
- package/dist/core-BL_H8fEZ.mjs +121 -0
- package/dist/core-BL_H8fEZ.mjs.map +1 -0
- package/dist/{core/cron.d.ts → cron-RKhH5TOd.d.mts} +16 -14
- package/dist/cron-RKhH5TOd.d.mts.map +1 -0
- package/dist/decorators-CQ93ak6Z.d.mts +154 -0
- package/dist/decorators-CQ93ak6Z.d.mts.map +1 -0
- package/dist/errors-te5Km00o.d.mts +68 -0
- package/dist/errors-te5Km00o.d.mts.map +1 -0
- package/dist/http/application.d.mts +220 -0
- package/dist/http/application.d.mts.map +1 -0
- package/dist/http/application.mjs +12 -0
- package/dist/http/bootstrap.d.mts +43 -0
- package/dist/http/bootstrap.d.mts.map +1 -0
- package/dist/http/bootstrap.mjs +12 -0
- package/dist/http/context.d.mts +131 -0
- package/dist/http/context.d.mts.map +1 -0
- package/dist/http/context.mjs +220 -0
- package/dist/http/context.mjs.map +1 -0
- package/dist/http/middleware/cors.d.mts +48 -0
- package/dist/http/middleware/cors.d.mts.map +1 -0
- package/dist/http/middleware/cors.mjs +83 -0
- package/dist/http/middleware/cors.mjs.map +1 -0
- package/dist/http/middleware/csrf.d.mts +52 -0
- package/dist/http/middleware/csrf.d.mts.map +1 -0
- package/dist/http/middleware/csrf.mjs +72 -0
- package/dist/http/middleware/csrf.mjs.map +1 -0
- package/dist/http/middleware/error-handler.d.mts +11 -0
- package/dist/http/middleware/error-handler.d.mts.map +1 -0
- package/dist/http/middleware/error-handler.mjs +52 -0
- package/dist/http/middleware/error-handler.mjs.map +1 -0
- package/dist/http/middleware/helmet.d.mts +41 -0
- package/dist/http/middleware/helmet.d.mts.map +1 -0
- package/dist/http/middleware/helmet.mjs +51 -0
- package/dist/http/middleware/helmet.mjs.map +1 -0
- package/dist/http/middleware/rate-limit.d.mts +56 -0
- package/dist/http/middleware/rate-limit.d.mts.map +1 -0
- package/dist/http/middleware/rate-limit.mjs +101 -0
- package/dist/http/middleware/rate-limit.mjs.map +1 -0
- package/dist/http/middleware/request-id.d.mts +10 -0
- package/dist/http/middleware/request-id.d.mts.map +1 -0
- package/dist/http/middleware/request-id.mjs +26 -0
- package/dist/http/middleware/request-id.mjs.map +1 -0
- package/dist/http/middleware/request-logger.d.mts +32 -0
- package/dist/http/middleware/request-logger.d.mts.map +1 -0
- package/dist/http/middleware/request-logger.mjs +49 -0
- package/dist/http/middleware/request-logger.mjs.map +1 -0
- package/dist/http/middleware/session.d.mts +67 -0
- package/dist/http/middleware/session.d.mts.map +1 -0
- package/dist/http/middleware/session.mjs +152 -0
- package/dist/http/middleware/session.mjs.map +1 -0
- package/dist/http/middleware/spa.d.mts +101 -0
- package/dist/http/middleware/spa.d.mts.map +1 -0
- package/dist/http/middleware/spa.mjs +108 -0
- package/dist/http/middleware/spa.mjs.map +1 -0
- package/dist/http/middleware/{upload.d.ts → upload.d.mts} +21 -17
- package/dist/http/middleware/upload.d.mts.map +1 -0
- package/dist/http/middleware/upload.mjs +191 -0
- package/dist/http/middleware/upload.mjs.map +1 -0
- package/dist/http/middleware/validate.d.mts +18 -0
- package/dist/http/middleware/validate.d.mts.map +1 -0
- package/dist/http/middleware/validate.mjs +62 -0
- package/dist/http/middleware/validate.mjs.map +1 -0
- package/dist/http/middleware/views.d.mts +62 -0
- package/dist/http/middleware/views.d.mts.map +1 -0
- package/dist/http/middleware/views.mjs +65 -0
- package/dist/http/middleware/views.mjs.map +1 -0
- package/dist/http/query/index.d.mts +3 -0
- package/dist/http/query/index.mjs +12 -0
- package/dist/http/{router-builder.d.ts → router-builder.d.mts} +9 -5
- package/dist/http/router-builder.d.mts.map +1 -0
- package/dist/http/router-builder.mjs +67 -0
- package/dist/http/router-builder.mjs.map +1 -0
- package/dist/index-C0gbnpSg.d.mts +107 -0
- package/dist/index-C0gbnpSg.d.mts.map +1 -0
- package/dist/index-Cls52etj.d.mts +148 -0
- package/dist/index-Cls52etj.d.mts.map +1 -0
- package/dist/index.d.mts +133 -0
- package/dist/index.d.mts.map +1 -0
- package/dist/index.mjs +126 -0
- package/dist/index.mjs.map +1 -0
- package/dist/interfaces-D-48zotH.d.mts +52 -0
- package/dist/interfaces-D-48zotH.d.mts.map +1 -0
- package/dist/logger-Dzj-TF0t.d.mts +119 -0
- package/dist/logger-Dzj-TF0t.d.mts.map +1 -0
- package/dist/metadata-fmvikBA0.mjs +76 -0
- package/dist/metadata-fmvikBA0.mjs.map +1 -0
- package/dist/{core/path.d.ts → path-LmwfhfyH.d.mts} +7 -3
- package/dist/path-LmwfhfyH.d.mts.map +1 -0
- package/dist/plugin-DIoPIpSm.d.mts +95 -0
- package/dist/plugin-DIoPIpSm.d.mts.map +1 -0
- package/dist/query-7cdHF6ry.mjs +164 -0
- package/dist/query-7cdHF6ry.mjs.map +1 -0
- package/dist/{core/reactivity.d.ts → reactivity-BbS-99ow.d.mts} +21 -20
- package/dist/reactivity-BbS-99ow.d.mts.map +1 -0
- package/package.json +73 -43
- package/dist/chunk-DVVP7zzD.js +0 -7
- package/dist/core/adapter.d.ts +0 -109
- package/dist/core/adapter.d.ts.map +0 -1
- package/dist/core/adapter.js +0 -0
- package/dist/core/app-module.d.ts +0 -28
- package/dist/core/app-module.d.ts.map +0 -1
- package/dist/core/app-module.js +0 -0
- package/dist/core/cache.d.ts.map +0 -1
- package/dist/core/cache.js +0 -57
- package/dist/core/container.d.ts +0 -63
- package/dist/core/container.d.ts.map +0 -1
- package/dist/core/container.js +0 -117
- package/dist/core/cron.d.ts.map +0 -1
- package/dist/core/cron.js +0 -22
- package/dist/core/decorators.d.ts +0 -153
- package/dist/core/decorators.d.ts.map +0 -1
- package/dist/core/decorators.js +0 -141
- package/dist/core/errors.d.ts +0 -64
- package/dist/core/errors.d.ts.map +0 -1
- package/dist/core/errors.js +0 -67
- package/dist/core/index.d.ts +0 -14
- package/dist/core/index.d.ts.map +0 -1
- package/dist/core/interfaces.d.ts +0 -44
- package/dist/core/interfaces.d.ts.map +0 -1
- package/dist/core/interfaces.js +0 -25
- package/dist/core/logger.d.ts +0 -43
- package/dist/core/logger.d.ts.map +0 -1
- package/dist/core/logger.js +0 -54
- package/dist/core/path.d.ts.map +0 -1
- package/dist/core/path.js +0 -12
- package/dist/core/plugin.d.ts +0 -90
- package/dist/core/plugin.d.ts.map +0 -1
- package/dist/core/plugin.js +0 -0
- package/dist/core/reactivity.d.ts.map +0 -1
- package/dist/core/reactivity.js +0 -101
- package/dist/core-B6Okew3W.js +0 -7
- package/dist/http/application.d.ts +0 -103
- package/dist/http/application.d.ts.map +0 -1
- package/dist/http/application.js +0 -167
- package/dist/http/bootstrap.d.ts +0 -22
- package/dist/http/bootstrap.d.ts.map +0 -1
- package/dist/http/bootstrap.js +0 -40
- package/dist/http/context.d.ts +0 -129
- package/dist/http/context.d.ts.map +0 -1
- package/dist/http/context.js +0 -115
- package/dist/http/index.d.ts +0 -16
- package/dist/http/index.d.ts.map +0 -1
- package/dist/http/middleware/cors.d.ts +0 -43
- package/dist/http/middleware/cors.d.ts.map +0 -1
- package/dist/http/middleware/cors.js +0 -31
- package/dist/http/middleware/csrf.d.ts +0 -47
- package/dist/http/middleware/csrf.d.ts.map +0 -1
- package/dist/http/middleware/csrf.js +0 -25
- package/dist/http/middleware/error-handler.d.ts +0 -6
- package/dist/http/middleware/error-handler.d.ts.map +0 -1
- package/dist/http/middleware/error-handler.js +0 -37
- package/dist/http/middleware/helmet.d.ts +0 -36
- package/dist/http/middleware/helmet.d.ts.map +0 -1
- package/dist/http/middleware/helmet.js +0 -20
- package/dist/http/middleware/rate-limit.d.ts +0 -51
- package/dist/http/middleware/rate-limit.d.ts.map +0 -1
- package/dist/http/middleware/rate-limit.js +0 -46
- package/dist/http/middleware/request-id.d.ts +0 -5
- package/dist/http/middleware/request-id.d.ts.map +0 -1
- package/dist/http/middleware/request-id.js +0 -12
- package/dist/http/middleware/request-logger.d.ts +0 -27
- package/dist/http/middleware/request-logger.d.ts.map +0 -1
- package/dist/http/middleware/request-logger.js +0 -16
- package/dist/http/middleware/session.d.ts +0 -62
- package/dist/http/middleware/session.d.ts.map +0 -1
- package/dist/http/middleware/session.js +0 -76
- package/dist/http/middleware/spa.d.ts +0 -93
- package/dist/http/middleware/spa.d.ts.map +0 -1
- package/dist/http/middleware/spa.js +0 -52
- package/dist/http/middleware/upload.d.ts.map +0 -1
- package/dist/http/middleware/upload.js +0 -119
- package/dist/http/middleware/validate.d.ts +0 -13
- package/dist/http/middleware/validate.d.ts.map +0 -1
- package/dist/http/middleware/validate.js +0 -45
- package/dist/http/middleware/views.d.ts +0 -56
- package/dist/http/middleware/views.d.ts.map +0 -1
- package/dist/http/middleware/views.js +0 -18
- package/dist/http/query/index.d.ts +0 -4
- package/dist/http/query/index.d.ts.map +0 -1
- package/dist/http/query/index.js +0 -10
- package/dist/http/query/parse-query.d.ts +0 -44
- package/dist/http/query/parse-query.d.ts.map +0 -1
- package/dist/http/query/types.d.ts +0 -100
- package/dist/http/query/types.d.ts.map +0 -1
- package/dist/http/router-builder.d.ts.map +0 -1
- package/dist/http/router-builder.js +0 -37
- package/dist/index.d.ts +0 -25
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js +0 -103
- package/dist/query-Bym31XRp.js +0 -88
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @forinda/kickjs v2.1.0
|
|
3
|
+
*
|
|
4
|
+
* Copyright (c) Felix Orinda
|
|
5
|
+
*
|
|
6
|
+
* This source code is licensed under the MIT license found in the
|
|
7
|
+
* LICENSE file in the root directory of this source tree.
|
|
8
|
+
*
|
|
9
|
+
* @license MIT
|
|
10
|
+
*/
|
|
11
|
+
import pino from "pino";
|
|
12
|
+
//#region src/core/logger.ts
|
|
13
|
+
const isDev = process.env.NODE_ENV !== "production";
|
|
14
|
+
/** Root pino logger instance */
|
|
15
|
+
const rootLogger = pino({
|
|
16
|
+
level: process.env.LOG_LEVEL || "info",
|
|
17
|
+
...isDev ? { transport: {
|
|
18
|
+
target: "pino-pretty",
|
|
19
|
+
options: {
|
|
20
|
+
colorize: true,
|
|
21
|
+
translateTime: "SYS:HH:MM:ss.l",
|
|
22
|
+
singleLine: true,
|
|
23
|
+
ignore: "pid,hostname,component",
|
|
24
|
+
messageFormat: "{if component}[{component}] {end}{msg}"
|
|
25
|
+
}
|
|
26
|
+
} } : {}
|
|
27
|
+
});
|
|
28
|
+
/** Default provider that delegates to the root pino instance */
|
|
29
|
+
var PinoLoggerProvider = class PinoLoggerProvider {
|
|
30
|
+
log;
|
|
31
|
+
constructor(pinoInstance) {
|
|
32
|
+
this.log = pinoInstance ?? rootLogger;
|
|
33
|
+
}
|
|
34
|
+
info(msg, ...args) {
|
|
35
|
+
this.log.info(msg, ...args);
|
|
36
|
+
}
|
|
37
|
+
warn(msg, ...args) {
|
|
38
|
+
this.log.warn(msg, ...args);
|
|
39
|
+
}
|
|
40
|
+
error(msg, ...args) {
|
|
41
|
+
this.log.error(msg, ...args);
|
|
42
|
+
}
|
|
43
|
+
debug(msg, ...args) {
|
|
44
|
+
this.log.debug(msg, ...args);
|
|
45
|
+
}
|
|
46
|
+
trace(msg, ...args) {
|
|
47
|
+
this.log.trace(msg, ...args);
|
|
48
|
+
}
|
|
49
|
+
fatal(msg, ...args) {
|
|
50
|
+
this.log.fatal(msg, ...args);
|
|
51
|
+
}
|
|
52
|
+
child(bindings) {
|
|
53
|
+
return new PinoLoggerProvider(this.log.child(bindings));
|
|
54
|
+
}
|
|
55
|
+
};
|
|
56
|
+
/**
|
|
57
|
+
* Built-in fallback provider that uses `console.*` methods.
|
|
58
|
+
* Useful for environments where pino is unavailable or undesired.
|
|
59
|
+
*/
|
|
60
|
+
var ConsoleLoggerProvider = class ConsoleLoggerProvider {
|
|
61
|
+
prefix;
|
|
62
|
+
constructor(prefix) {
|
|
63
|
+
this.prefix = prefix ?? "";
|
|
64
|
+
}
|
|
65
|
+
fmt(msg) {
|
|
66
|
+
return this.prefix ? `[${this.prefix}] ${msg}` : msg;
|
|
67
|
+
}
|
|
68
|
+
info(msg, ...args) {
|
|
69
|
+
console.log(this.fmt(msg), ...args);
|
|
70
|
+
}
|
|
71
|
+
warn(msg, ...args) {
|
|
72
|
+
console.warn(this.fmt(msg), ...args);
|
|
73
|
+
}
|
|
74
|
+
error(msg, ...args) {
|
|
75
|
+
console.error(this.fmt(msg), ...args);
|
|
76
|
+
}
|
|
77
|
+
debug(msg, ...args) {
|
|
78
|
+
console.debug(this.fmt(msg), ...args);
|
|
79
|
+
}
|
|
80
|
+
trace(msg, ...args) {
|
|
81
|
+
console.trace(this.fmt(msg), ...args);
|
|
82
|
+
}
|
|
83
|
+
fatal(msg, ...args) {
|
|
84
|
+
console.error(this.fmt(msg), ...args);
|
|
85
|
+
}
|
|
86
|
+
child(bindings) {
|
|
87
|
+
return new ConsoleLoggerProvider(bindings.component);
|
|
88
|
+
}
|
|
89
|
+
};
|
|
90
|
+
let activeProvider = new PinoLoggerProvider();
|
|
91
|
+
/** Cache of named loggers to avoid creating duplicates */
|
|
92
|
+
const loggerCache = /* @__PURE__ */ new Map();
|
|
93
|
+
/**
|
|
94
|
+
* Named logger with component context.
|
|
95
|
+
*
|
|
96
|
+
* @example
|
|
97
|
+
* ```ts
|
|
98
|
+
* // Static factory — preferred
|
|
99
|
+
* const log = Logger.for('UserService')
|
|
100
|
+
* log.info('User created')
|
|
101
|
+
* // Output: [UserService] User created
|
|
102
|
+
*
|
|
103
|
+
* // Shorthand function
|
|
104
|
+
* const log = createLogger('OrderService')
|
|
105
|
+
*
|
|
106
|
+
* // Pluggable backend
|
|
107
|
+
* Logger.setProvider(new ConsoleLoggerProvider())
|
|
108
|
+
*
|
|
109
|
+
* // Injectable — auto-named from class
|
|
110
|
+
* class MyService {
|
|
111
|
+
* @Autowired() private logger!: Logger
|
|
112
|
+
* // or inject a named one:
|
|
113
|
+
* private log = Logger.for('MyService')
|
|
114
|
+
* }
|
|
115
|
+
* ```
|
|
116
|
+
*/
|
|
117
|
+
var Logger = class Logger {
|
|
118
|
+
_provider;
|
|
119
|
+
_providerVersion;
|
|
120
|
+
_name;
|
|
121
|
+
/**
|
|
122
|
+
* Optional context provider for request-scoped log enrichment.
|
|
123
|
+
* Set by the HTTP package to inject requestId from AsyncLocalStorage.
|
|
124
|
+
* Returns extra fields to merge into every log call, or null if outside a request.
|
|
125
|
+
*/
|
|
126
|
+
static _contextProvider = null;
|
|
127
|
+
/** Incremented on every setProvider/resetProvider so instances know to refresh */
|
|
128
|
+
static _providerVersion = 0;
|
|
129
|
+
constructor(name) {
|
|
130
|
+
this._name = name;
|
|
131
|
+
this._providerVersion = Logger._providerVersion;
|
|
132
|
+
this._provider = name ? activeProvider.child({ component: name }) : activeProvider;
|
|
133
|
+
}
|
|
134
|
+
/** Re-derive the provider if setProvider() was called since construction/last access */
|
|
135
|
+
get provider() {
|
|
136
|
+
if (this._providerVersion !== Logger._providerVersion) {
|
|
137
|
+
this._providerVersion = Logger._providerVersion;
|
|
138
|
+
this._provider = this._name ? activeProvider.child({ component: this._name }) : activeProvider;
|
|
139
|
+
}
|
|
140
|
+
return this._provider;
|
|
141
|
+
}
|
|
142
|
+
/**
|
|
143
|
+
* Replace the logging backend for **all** Logger instances created after
|
|
144
|
+
* this call. Clears the logger cache so subsequent `Logger.for()` calls
|
|
145
|
+
* pick up the new provider.
|
|
146
|
+
*
|
|
147
|
+
* @example
|
|
148
|
+
* ```ts
|
|
149
|
+
* Logger.setProvider(new ConsoleLoggerProvider())
|
|
150
|
+
* ```
|
|
151
|
+
*/
|
|
152
|
+
static setProvider(provider) {
|
|
153
|
+
activeProvider = provider;
|
|
154
|
+
Logger._providerVersion++;
|
|
155
|
+
loggerCache.clear();
|
|
156
|
+
}
|
|
157
|
+
/** Return the currently active provider (useful for testing) */
|
|
158
|
+
static getProvider() {
|
|
159
|
+
return activeProvider;
|
|
160
|
+
}
|
|
161
|
+
/**
|
|
162
|
+
* Reset the provider back to the default pino-based implementation.
|
|
163
|
+
* Primarily intended for test teardown.
|
|
164
|
+
*/
|
|
165
|
+
static resetProvider() {
|
|
166
|
+
activeProvider = new PinoLoggerProvider();
|
|
167
|
+
Logger._providerVersion++;
|
|
168
|
+
loggerCache.clear();
|
|
169
|
+
}
|
|
170
|
+
/** Create or retrieve a cached named logger */
|
|
171
|
+
static for(name) {
|
|
172
|
+
let cached = loggerCache.get(name);
|
|
173
|
+
if (!cached) {
|
|
174
|
+
cached = new Logger(name);
|
|
175
|
+
loggerCache.set(name, cached);
|
|
176
|
+
}
|
|
177
|
+
return cached;
|
|
178
|
+
}
|
|
179
|
+
/** Create a child logger with a sub-component name */
|
|
180
|
+
child(name) {
|
|
181
|
+
return new Logger(name);
|
|
182
|
+
}
|
|
183
|
+
/** Get request context (requestId, etc.) if inside a request */
|
|
184
|
+
ctx() {
|
|
185
|
+
return Logger._contextProvider?.() ?? void 0;
|
|
186
|
+
}
|
|
187
|
+
info(msg, ...args) {
|
|
188
|
+
this.provider.info(msg, ...args);
|
|
189
|
+
}
|
|
190
|
+
warn(msg, ...args) {
|
|
191
|
+
this.provider.warn(msg, ...args);
|
|
192
|
+
}
|
|
193
|
+
error(msgOrObj, msg, ...args) {
|
|
194
|
+
if (typeof msgOrObj === "string") this.provider.error(msgOrObj);
|
|
195
|
+
else if (msg) this.provider.error(msg, ...args);
|
|
196
|
+
else this.provider.error(String(msgOrObj));
|
|
197
|
+
}
|
|
198
|
+
debug(msg, ...args) {
|
|
199
|
+
this.provider.debug(msg, ...args);
|
|
200
|
+
}
|
|
201
|
+
trace(msg, ...args) {
|
|
202
|
+
this.provider.trace ? this.provider.trace(msg, ...args) : this.provider.debug(msg, ...args);
|
|
203
|
+
}
|
|
204
|
+
fatal(msg, ...args) {
|
|
205
|
+
this.provider.fatal ? this.provider.fatal(msg, ...args) : this.provider.error(msg, ...args);
|
|
206
|
+
}
|
|
207
|
+
};
|
|
208
|
+
/** Shorthand for Logger.for(name) */
|
|
209
|
+
function createLogger(name) {
|
|
210
|
+
return Logger.for(name);
|
|
211
|
+
}
|
|
212
|
+
/** @deprecated Use rootLogger instead */
|
|
213
|
+
const logger = rootLogger;
|
|
214
|
+
//#endregion
|
|
215
|
+
export { ConsoleLoggerProvider, Logger, createLogger, logger, rootLogger };
|
|
216
|
+
|
|
217
|
+
//# sourceMappingURL=logger.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"logger.mjs","names":[],"sources":["../../src/core/logger.ts"],"sourcesContent":["import pino from 'pino'\n\nconst isDev = process.env.NODE_ENV !== 'production'\n\n/** Root pino logger instance */\nexport const rootLogger = pino({\n level: process.env.LOG_LEVEL || 'info',\n ...(isDev\n ? {\n transport: {\n target: 'pino-pretty',\n options: {\n colorize: true,\n translateTime: 'SYS:HH:MM:ss.l',\n singleLine: true,\n ignore: 'pid,hostname,component',\n messageFormat: '{if component}[{component}] {end}{msg}',\n },\n },\n }\n : {}),\n})\n\n// ── LoggerProvider interface ───────────────────────────────────────────\n\n/**\n * Pluggable logger backend.\n *\n * Implement this interface to replace the default pino-based logging\n * with any logging library (winston, bunyan, console, etc.).\n */\nexport interface LoggerProvider {\n info(msg: string, ...args: any[]): void\n warn(msg: string, ...args: any[]): void\n error(msg: string, ...args: any[]): void\n debug(msg: string, ...args: any[]): void\n trace?(msg: string, ...args: any[]): void\n fatal?(msg: string, ...args: any[]): void\n /** Return a child provider scoped to the given component name */\n child(bindings: { component: string }): LoggerProvider\n}\n\n// ── PinoLoggerProvider (default) ───────────────────────────────────────\n\n/** Default provider that delegates to the root pino instance */\nclass PinoLoggerProvider implements LoggerProvider {\n private log: pino.Logger\n\n constructor(pinoInstance?: pino.Logger) {\n this.log = pinoInstance ?? rootLogger\n }\n\n info(msg: string, ...args: any[]) {\n this.log.info(msg, ...args)\n }\n warn(msg: string, ...args: any[]) {\n this.log.warn(msg, ...args)\n }\n error(msg: string, ...args: any[]) {\n this.log.error(msg, ...args)\n }\n debug(msg: string, ...args: any[]) {\n this.log.debug(msg, ...args)\n }\n trace(msg: string, ...args: any[]) {\n this.log.trace(msg, ...args)\n }\n fatal(msg: string, ...args: any[]) {\n this.log.fatal(msg, ...args)\n }\n child(bindings: { component: string }): LoggerProvider {\n return new PinoLoggerProvider(this.log.child(bindings))\n }\n}\n\n// ── ConsoleLoggerProvider ──────────────────────────────────────────────\n\n/**\n * Built-in fallback provider that uses `console.*` methods.\n * Useful for environments where pino is unavailable or undesired.\n */\nexport class ConsoleLoggerProvider implements LoggerProvider {\n private prefix: string\n\n constructor(prefix?: string) {\n this.prefix = prefix ?? ''\n }\n\n private fmt(msg: string): string {\n return this.prefix ? `[${this.prefix}] ${msg}` : msg\n }\n\n info(msg: string, ...args: any[]) {\n console.log(this.fmt(msg), ...args)\n }\n warn(msg: string, ...args: any[]) {\n console.warn(this.fmt(msg), ...args)\n }\n error(msg: string, ...args: any[]) {\n console.error(this.fmt(msg), ...args)\n }\n debug(msg: string, ...args: any[]) {\n console.debug(this.fmt(msg), ...args)\n }\n trace(msg: string, ...args: any[]) {\n console.trace(this.fmt(msg), ...args)\n }\n fatal(msg: string, ...args: any[]) {\n console.error(this.fmt(msg), ...args)\n }\n child(bindings: { component: string }): LoggerProvider {\n return new ConsoleLoggerProvider(bindings.component)\n }\n}\n\n// ── Active provider ────────────────────────────────────────────────────\n\nlet activeProvider: LoggerProvider = new PinoLoggerProvider()\n\n/** Cache of named loggers to avoid creating duplicates */\nconst loggerCache = new Map<string, Logger>()\n\n/**\n * Named logger with component context.\n *\n * @example\n * ```ts\n * // Static factory — preferred\n * const log = Logger.for('UserService')\n * log.info('User created')\n * // Output: [UserService] User created\n *\n * // Shorthand function\n * const log = createLogger('OrderService')\n *\n * // Pluggable backend\n * Logger.setProvider(new ConsoleLoggerProvider())\n *\n * // Injectable — auto-named from class\n * class MyService {\n * @Autowired() private logger!: Logger\n * // or inject a named one:\n * private log = Logger.for('MyService')\n * }\n * ```\n */\nexport class Logger {\n private _provider: LoggerProvider\n private _providerVersion: number\n private _name?: string\n\n /**\n * Optional context provider for request-scoped log enrichment.\n * Set by the HTTP package to inject requestId from AsyncLocalStorage.\n * Returns extra fields to merge into every log call, or null if outside a request.\n */\n static _contextProvider: (() => Record<string, any> | null) | null = null\n\n /** Incremented on every setProvider/resetProvider so instances know to refresh */\n private static _providerVersion = 0\n\n constructor(name?: string) {\n this._name = name\n this._providerVersion = Logger._providerVersion\n this._provider = name ? activeProvider.child({ component: name }) : activeProvider\n }\n\n /** Re-derive the provider if setProvider() was called since construction/last access */\n private get provider(): LoggerProvider {\n if (this._providerVersion !== Logger._providerVersion) {\n this._providerVersion = Logger._providerVersion\n this._provider = this._name ? activeProvider.child({ component: this._name }) : activeProvider\n }\n return this._provider\n }\n\n /**\n * Replace the logging backend for **all** Logger instances created after\n * this call. Clears the logger cache so subsequent `Logger.for()` calls\n * pick up the new provider.\n *\n * @example\n * ```ts\n * Logger.setProvider(new ConsoleLoggerProvider())\n * ```\n */\n static setProvider(provider: LoggerProvider): void {\n activeProvider = provider\n Logger._providerVersion++\n loggerCache.clear()\n }\n\n /** Return the currently active provider (useful for testing) */\n static getProvider(): LoggerProvider {\n return activeProvider\n }\n\n /**\n * Reset the provider back to the default pino-based implementation.\n * Primarily intended for test teardown.\n */\n static resetProvider(): void {\n activeProvider = new PinoLoggerProvider()\n Logger._providerVersion++\n loggerCache.clear()\n }\n\n /** Create or retrieve a cached named logger */\n static for(name: string): Logger {\n let cached = loggerCache.get(name)\n if (!cached) {\n cached = new Logger(name)\n loggerCache.set(name, cached)\n }\n return cached\n }\n\n /** Create a child logger with a sub-component name */\n child(name: string): Logger {\n return new Logger(name)\n }\n\n /** Get request context (requestId, etc.) if inside a request */\n private ctx(): Record<string, any> | undefined {\n return Logger._contextProvider?.() ?? undefined\n }\n\n info(msg: string, ...args: any[]) {\n this.provider.info(msg, ...args)\n }\n\n warn(msg: string, ...args: any[]) {\n this.provider.warn(msg, ...args)\n }\n\n error(msgOrObj: any, msg?: string, ...args: any[]) {\n if (typeof msgOrObj === 'string') {\n this.provider.error(msgOrObj)\n } else if (msg) {\n this.provider.error(msg, ...args)\n } else {\n this.provider.error(String(msgOrObj))\n }\n }\n\n debug(msg: string, ...args: any[]) {\n this.provider.debug(msg, ...args)\n }\n\n trace(msg: string, ...args: any[]) {\n this.provider.trace ? this.provider.trace(msg, ...args) : this.provider.debug(msg, ...args)\n }\n\n fatal(msg: string, ...args: any[]) {\n this.provider.fatal ? this.provider.fatal(msg, ...args) : this.provider.error(msg, ...args)\n }\n}\n\n/** Shorthand for Logger.for(name) */\nexport function createLogger(name: string): Logger {\n return Logger.for(name)\n}\n\n/** @deprecated Use rootLogger instead */\nexport const logger = rootLogger\n"],"mappings":"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"}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @forinda/kickjs v2.1.0
|
|
3
|
+
*
|
|
4
|
+
* Copyright (c) Felix Orinda
|
|
5
|
+
*
|
|
6
|
+
* This source code is licensed under the MIT license found in the
|
|
7
|
+
* LICENSE file in the root directory of this source tree.
|
|
8
|
+
*
|
|
9
|
+
* @license MIT
|
|
10
|
+
*/
|
|
11
|
+
//#region src/core/path.ts
|
|
12
|
+
/**
|
|
13
|
+
* Normalize a URL path segment:
|
|
14
|
+
* - '/' or '' or undefined → ''
|
|
15
|
+
* - Ensures leading '/' if non-empty
|
|
16
|
+
* - Strips trailing '/'
|
|
17
|
+
* - Collapses consecutive '//' into single '/'
|
|
18
|
+
*/
|
|
19
|
+
function normalizePath(path) {
|
|
20
|
+
let p = path?.trim() || "";
|
|
21
|
+
if (p === "/") return "";
|
|
22
|
+
if (p && !p.startsWith("/")) p = `/${p}`;
|
|
23
|
+
p = p.replace(/\/+$/, "");
|
|
24
|
+
p = p.replace(/\/\/+/g, "/");
|
|
25
|
+
return p;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Join path segments into a single normalized path.
|
|
29
|
+
* Handles leading/trailing slashes and prevents double slashes.
|
|
30
|
+
*
|
|
31
|
+
* @example
|
|
32
|
+
* joinPaths('/api/v1', '/users') // '/api/v1/users'
|
|
33
|
+
* joinPaths('/api/v1/', '/users') // '/api/v1/users'
|
|
34
|
+
* joinPaths('/api/v1', '/') // '/api/v1'
|
|
35
|
+
* joinPaths('/api/v1', '') // '/api/v1'
|
|
36
|
+
* joinPaths('/api/v1', 'users') // '/api/v1/users'
|
|
37
|
+
*/
|
|
38
|
+
function joinPaths(...segments) {
|
|
39
|
+
const normalized = ("/" + segments.map((s) => s?.trim() || "").filter(Boolean).join("/")).replace(/\/\/+/g, "/");
|
|
40
|
+
return normalized === "/" ? "/" : normalized.replace(/\/+$/, "");
|
|
41
|
+
}
|
|
42
|
+
//#endregion
|
|
43
|
+
export { joinPaths, normalizePath };
|
|
44
|
+
|
|
45
|
+
//# sourceMappingURL=path.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"path.mjs","names":[],"sources":["../../src/core/path.ts"],"sourcesContent":["/**\n * Normalize a URL path segment:\n * - '/' or '' or undefined → ''\n * - Ensures leading '/' if non-empty\n * - Strips trailing '/'\n * - Collapses consecutive '//' into single '/'\n */\nexport function normalizePath(path?: string): string {\n let p = path?.trim() || ''\n if (p === '/') return ''\n if (p && !p.startsWith('/')) p = `/${p}`\n // Strip trailing slash\n p = p.replace(/\\/+$/, '')\n // Collapse double slashes\n p = p.replace(/\\/\\/+/g, '/')\n return p\n}\n\n/**\n * Join path segments into a single normalized path.\n * Handles leading/trailing slashes and prevents double slashes.\n *\n * @example\n * joinPaths('/api/v1', '/users') // '/api/v1/users'\n * joinPaths('/api/v1/', '/users') // '/api/v1/users'\n * joinPaths('/api/v1', '/') // '/api/v1'\n * joinPaths('/api/v1', '') // '/api/v1'\n * joinPaths('/api/v1', 'users') // '/api/v1/users'\n */\nexport function joinPaths(...segments: (string | undefined)[]): string {\n const joined = segments\n .map((s) => s?.trim() || '')\n .filter(Boolean)\n .join('/')\n // Ensure leading slash, collapse doubles\n const normalized = ('/' + joined).replace(/\\/\\/+/g, '/')\n // Strip trailing slash (unless it's just '/')\n return normalized === '/' ? '/' : normalized.replace(/\\/+$/, '')\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAOA,SAAgB,cAAc,MAAuB;CACnD,IAAI,IAAI,MAAM,MAAM,IAAI;AACxB,KAAI,MAAM,IAAK,QAAO;AACtB,KAAI,KAAK,CAAC,EAAE,WAAW,IAAI,CAAE,KAAI,IAAI;AAErC,KAAI,EAAE,QAAQ,QAAQ,GAAG;AAEzB,KAAI,EAAE,QAAQ,UAAU,IAAI;AAC5B,QAAO;;;;;;;;;;;;;AAcT,SAAgB,UAAU,GAAG,UAA0C;CAMrE,MAAM,cAAc,MALL,SACZ,KAAK,MAAM,GAAG,MAAM,IAAI,GAAG,CAC3B,OAAO,QAAQ,CACf,KAAK,IAAI,EAEsB,QAAQ,UAAU,IAAI;AAExD,QAAO,eAAe,MAAM,MAAM,WAAW,QAAQ,QAAQ,GAAG"}
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
|
|
2
|
+
import { a as isRef, c as toRefs, i as computed, l as unref, n as Ref, o as reactive, r as WatchOptions, s as ref, t as ComputedRef, u as watch } from "../reactivity-BbS-99ow.mjs";
|
|
3
|
+
export { ComputedRef, Ref, WatchOptions, computed, isRef, reactive, ref, toRefs, unref, watch };
|
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @forinda/kickjs v2.1.0
|
|
3
|
+
*
|
|
4
|
+
* Copyright (c) Felix Orinda
|
|
5
|
+
*
|
|
6
|
+
* This source code is licensed under the MIT license found in the
|
|
7
|
+
* LICENSE file in the root directory of this source tree.
|
|
8
|
+
*
|
|
9
|
+
* @license MIT
|
|
10
|
+
*/
|
|
11
|
+
//#region src/core/reactivity.ts
|
|
12
|
+
let activeEffect = null;
|
|
13
|
+
const targetMap = /* @__PURE__ */ new WeakMap();
|
|
14
|
+
function track(target, key) {
|
|
15
|
+
if (!activeEffect) return;
|
|
16
|
+
let depsMap = targetMap.get(target);
|
|
17
|
+
if (!depsMap) {
|
|
18
|
+
depsMap = /* @__PURE__ */ new Map();
|
|
19
|
+
targetMap.set(target, depsMap);
|
|
20
|
+
}
|
|
21
|
+
let deps = depsMap.get(key);
|
|
22
|
+
if (!deps) {
|
|
23
|
+
deps = /* @__PURE__ */ new Set();
|
|
24
|
+
depsMap.set(key, deps);
|
|
25
|
+
}
|
|
26
|
+
deps.add(activeEffect);
|
|
27
|
+
}
|
|
28
|
+
function trigger(target, key) {
|
|
29
|
+
const depsMap = targetMap.get(target);
|
|
30
|
+
if (!depsMap) return;
|
|
31
|
+
const deps = depsMap.get(key);
|
|
32
|
+
if (!deps) return;
|
|
33
|
+
for (const effect of deps) effect();
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* Create a reactive reference. Reading `.value` tracks the dependency,
|
|
37
|
+
* writing `.value` triggers watchers and computed recalculations.
|
|
38
|
+
*
|
|
39
|
+
* @example
|
|
40
|
+
* ```ts
|
|
41
|
+
* const count = ref(0)
|
|
42
|
+
* count.value++ // triggers watchers
|
|
43
|
+
* ```
|
|
44
|
+
*/
|
|
45
|
+
function ref(initialValue) {
|
|
46
|
+
const subscribers = /* @__PURE__ */ new Set();
|
|
47
|
+
const wrapper = { _value: initialValue };
|
|
48
|
+
return {
|
|
49
|
+
get value() {
|
|
50
|
+
track(wrapper, "_value");
|
|
51
|
+
return wrapper._value;
|
|
52
|
+
},
|
|
53
|
+
set value(newValue) {
|
|
54
|
+
const oldValue = wrapper._value;
|
|
55
|
+
if (Object.is(oldValue, newValue)) return;
|
|
56
|
+
wrapper._value = newValue;
|
|
57
|
+
trigger(wrapper, "_value");
|
|
58
|
+
for (const fn of subscribers) fn(newValue, oldValue);
|
|
59
|
+
},
|
|
60
|
+
subscribe(fn) {
|
|
61
|
+
subscribers.add(fn);
|
|
62
|
+
return () => subscribers.delete(fn);
|
|
63
|
+
}
|
|
64
|
+
};
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Create a computed value that auto-recalculates when its reactive
|
|
68
|
+
* dependencies change. Cached until a dependency triggers.
|
|
69
|
+
*
|
|
70
|
+
* @example
|
|
71
|
+
* ```ts
|
|
72
|
+
* const count = ref(0)
|
|
73
|
+
* const doubled = computed(() => count.value * 2)
|
|
74
|
+
* count.value = 5
|
|
75
|
+
* console.log(doubled.value) // 10
|
|
76
|
+
* ```
|
|
77
|
+
*/
|
|
78
|
+
function computed(getter) {
|
|
79
|
+
let cached;
|
|
80
|
+
let dirty = true;
|
|
81
|
+
const wrapper = { _value: void 0 };
|
|
82
|
+
const effect = () => {
|
|
83
|
+
dirty = true;
|
|
84
|
+
trigger(wrapper, "_value");
|
|
85
|
+
};
|
|
86
|
+
return { get value() {
|
|
87
|
+
track(wrapper, "_value");
|
|
88
|
+
if (dirty) {
|
|
89
|
+
const prev = activeEffect;
|
|
90
|
+
activeEffect = effect;
|
|
91
|
+
try {
|
|
92
|
+
cached = getter();
|
|
93
|
+
} finally {
|
|
94
|
+
activeEffect = prev;
|
|
95
|
+
}
|
|
96
|
+
wrapper._value = cached;
|
|
97
|
+
dirty = false;
|
|
98
|
+
}
|
|
99
|
+
return cached;
|
|
100
|
+
} };
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* Watch a reactive source and run a callback when it changes.
|
|
104
|
+
* Returns a stop function to unsubscribe.
|
|
105
|
+
*
|
|
106
|
+
* @example
|
|
107
|
+
* ```ts
|
|
108
|
+
* const count = ref(0)
|
|
109
|
+
* const stop = watch(count, (newVal, oldVal) => {
|
|
110
|
+
* console.log(`Changed from ${oldVal} to ${newVal}`)
|
|
111
|
+
* })
|
|
112
|
+
* count.value = 1 // logs: "Changed from 0 to 1"
|
|
113
|
+
* stop() // no more callbacks
|
|
114
|
+
* ```
|
|
115
|
+
*/
|
|
116
|
+
function watch(source, callback, options) {
|
|
117
|
+
let oldValue;
|
|
118
|
+
let stopped = false;
|
|
119
|
+
const getter = typeof source === "function" ? source : () => source.value;
|
|
120
|
+
const job = () => {
|
|
121
|
+
if (stopped) return;
|
|
122
|
+
const newValue = getter();
|
|
123
|
+
if (!Object.is(newValue, oldValue)) {
|
|
124
|
+
callback(newValue, oldValue);
|
|
125
|
+
oldValue = newValue;
|
|
126
|
+
}
|
|
127
|
+
};
|
|
128
|
+
const prev = activeEffect;
|
|
129
|
+
activeEffect = job;
|
|
130
|
+
try {
|
|
131
|
+
oldValue = getter();
|
|
132
|
+
} finally {
|
|
133
|
+
activeEffect = prev;
|
|
134
|
+
}
|
|
135
|
+
if (options?.immediate) callback(oldValue, void 0);
|
|
136
|
+
return () => {
|
|
137
|
+
stopped = true;
|
|
138
|
+
};
|
|
139
|
+
}
|
|
140
|
+
/**
|
|
141
|
+
* Create a deeply reactive proxy around a plain object. Property reads
|
|
142
|
+
* are tracked, property writes trigger watchers and computed recalculations.
|
|
143
|
+
*
|
|
144
|
+
* @example
|
|
145
|
+
* ```ts
|
|
146
|
+
* const state = reactive({ users: 0, errors: 0 })
|
|
147
|
+
* const errorRate = computed(() =>
|
|
148
|
+
* state.users > 0 ? state.errors / state.users : 0
|
|
149
|
+
* )
|
|
150
|
+
* state.users = 100
|
|
151
|
+
* state.errors = 5
|
|
152
|
+
* console.log(errorRate.value) // 0.05
|
|
153
|
+
* ```
|
|
154
|
+
*/
|
|
155
|
+
function reactive(target) {
|
|
156
|
+
return new Proxy(target, {
|
|
157
|
+
get(obj, key, receiver) {
|
|
158
|
+
const value = Reflect.get(obj, key, receiver);
|
|
159
|
+
if (typeof key === "symbol") return value;
|
|
160
|
+
track(obj, key);
|
|
161
|
+
if (value !== null && typeof value === "object" && !Array.isArray(value)) return reactive(value);
|
|
162
|
+
return value;
|
|
163
|
+
},
|
|
164
|
+
set(obj, key, value, receiver) {
|
|
165
|
+
const oldValue = Reflect.get(obj, key, receiver);
|
|
166
|
+
const result = Reflect.set(obj, key, value, receiver);
|
|
167
|
+
if (!Object.is(oldValue, value) && typeof key !== "symbol") trigger(obj, key);
|
|
168
|
+
return result;
|
|
169
|
+
}
|
|
170
|
+
});
|
|
171
|
+
}
|
|
172
|
+
/** Check if a value is a Ref */
|
|
173
|
+
function isRef(value) {
|
|
174
|
+
return value !== null && typeof value === "object" && "subscribe" in value && "value" in value;
|
|
175
|
+
}
|
|
176
|
+
/** Unwrap a ref or return the value as-is */
|
|
177
|
+
function unref(value) {
|
|
178
|
+
return isRef(value) ? value.value : value;
|
|
179
|
+
}
|
|
180
|
+
/** Convert all properties of an object to refs */
|
|
181
|
+
function toRefs(obj) {
|
|
182
|
+
const result = {};
|
|
183
|
+
for (const key in obj) result[key] = ref(obj[key]);
|
|
184
|
+
return result;
|
|
185
|
+
}
|
|
186
|
+
//#endregion
|
|
187
|
+
export { computed, isRef, reactive, ref, toRefs, unref, watch };
|
|
188
|
+
|
|
189
|
+
//# sourceMappingURL=reactivity.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"reactivity.mjs","names":[],"sources":["../../src/core/reactivity.ts"],"sourcesContent":["/**\n * Lightweight reactivity system inspired by Vue 3's composition API.\n * Provides ref(), computed(), watch(), and reactive() for observable\n * backend state — config, metrics, health, circuit breakers.\n */\n\n// ── Dependency Tracking ─────────────────────────────────────────────────\n\ntype Effect = () => void\nlet activeEffect: Effect | null = null\nconst targetMap = new WeakMap<object, Map<string | symbol, Set<Effect>>>()\n\nfunction track(target: object, key: string | symbol): void {\n if (!activeEffect) return\n let depsMap = targetMap.get(target)\n if (!depsMap) {\n depsMap = new Map()\n targetMap.set(target, depsMap)\n }\n let deps = depsMap.get(key)\n if (!deps) {\n deps = new Set()\n depsMap.set(key, deps)\n }\n deps.add(activeEffect)\n}\n\nfunction trigger(target: object, key: string | symbol): void {\n const depsMap = targetMap.get(target)\n if (!depsMap) return\n const deps = depsMap.get(key)\n if (!deps) return\n for (const effect of deps) {\n effect()\n }\n}\n\n// ── ref() ────────────────────────────────────────────────────────────────\n\nexport interface Ref<T = any> {\n value: T\n /** Subscribe to changes. Returns unsubscribe function. */\n subscribe(fn: (newValue: T, oldValue: T) => void): () => void\n}\n\n/**\n * Create a reactive reference. Reading `.value` tracks the dependency,\n * writing `.value` triggers watchers and computed recalculations.\n *\n * @example\n * ```ts\n * const count = ref(0)\n * count.value++ // triggers watchers\n * ```\n */\nexport function ref<T>(initialValue: T): Ref<T> {\n const subscribers = new Set<(newValue: T, oldValue: T) => void>()\n const wrapper = { _value: initialValue }\n\n return {\n get value(): T {\n track(wrapper, '_value')\n return wrapper._value\n },\n set value(newValue: T) {\n const oldValue = wrapper._value\n if (Object.is(oldValue, newValue)) return\n wrapper._value = newValue\n trigger(wrapper, '_value')\n for (const fn of subscribers) {\n fn(newValue, oldValue)\n }\n },\n subscribe(fn: (newValue: T, oldValue: T) => void): () => void {\n subscribers.add(fn)\n return () => subscribers.delete(fn)\n },\n }\n}\n\n// ── computed() ───────────────────────────────────────────────────────────\n\nexport interface ComputedRef<T = any> {\n readonly value: T\n}\n\n/**\n * Create a computed value that auto-recalculates when its reactive\n * dependencies change. Cached until a dependency triggers.\n *\n * @example\n * ```ts\n * const count = ref(0)\n * const doubled = computed(() => count.value * 2)\n * count.value = 5\n * console.log(doubled.value) // 10\n * ```\n */\nexport function computed<T>(getter: () => T): ComputedRef<T> {\n let cached: T\n let dirty = true\n const wrapper = { _value: undefined as T }\n\n const effect: Effect = () => {\n dirty = true\n trigger(wrapper, '_value')\n }\n\n return {\n get value(): T {\n track(wrapper, '_value')\n if (dirty) {\n const prev = activeEffect\n activeEffect = effect\n try {\n cached = getter()\n } finally {\n activeEffect = prev\n }\n wrapper._value = cached\n dirty = false\n }\n return cached\n },\n }\n}\n\n// ── watch() ──────────────────────────────────────────────────────────────\n\nexport interface WatchOptions {\n /** Run the callback immediately with the current value (default: false) */\n immediate?: boolean\n}\n\ntype WatchSource<T> = Ref<T> | ComputedRef<T> | (() => T)\n\n/**\n * Watch a reactive source and run a callback when it changes.\n * Returns a stop function to unsubscribe.\n *\n * @example\n * ```ts\n * const count = ref(0)\n * const stop = watch(count, (newVal, oldVal) => {\n * console.log(`Changed from ${oldVal} to ${newVal}`)\n * })\n * count.value = 1 // logs: \"Changed from 0 to 1\"\n * stop() // no more callbacks\n * ```\n */\nexport function watch<T>(\n source: WatchSource<T>,\n callback: (newValue: T, oldValue: T) => void,\n options?: WatchOptions,\n): () => void {\n let oldValue: T\n let stopped = false\n\n const getter = typeof source === 'function' ? source : () => source.value\n\n const job: Effect = () => {\n if (stopped) return\n const newValue = getter()\n if (!Object.is(newValue, oldValue)) {\n callback(newValue, oldValue)\n oldValue = newValue\n }\n }\n\n // Initial run to establish tracking\n const prev = activeEffect\n activeEffect = job\n try {\n oldValue = getter()\n } finally {\n activeEffect = prev\n }\n\n if (options?.immediate) {\n callback(oldValue, undefined as T)\n }\n\n return () => {\n stopped = true\n }\n}\n\n// ── reactive() ───────────────────────────────────────────────────────────\n\n/**\n * Create a deeply reactive proxy around a plain object. Property reads\n * are tracked, property writes trigger watchers and computed recalculations.\n *\n * @example\n * ```ts\n * const state = reactive({ users: 0, errors: 0 })\n * const errorRate = computed(() =>\n * state.users > 0 ? state.errors / state.users : 0\n * )\n * state.users = 100\n * state.errors = 5\n * console.log(errorRate.value) // 0.05\n * ```\n */\nexport function reactive<T extends Record<string, any>>(target: T): T {\n return new Proxy(target, {\n get(obj, key, receiver) {\n const value = Reflect.get(obj, key, receiver)\n if (typeof key === 'symbol') return value\n track(obj, key)\n // Deep reactivity for nested objects\n if (value !== null && typeof value === 'object' && !Array.isArray(value)) {\n return reactive(value)\n }\n return value\n },\n set(obj, key, value, receiver) {\n const oldValue = Reflect.get(obj, key, receiver)\n const result = Reflect.set(obj, key, value, receiver)\n if (!Object.is(oldValue, value) && typeof key !== 'symbol') {\n trigger(obj, key)\n }\n return result\n },\n })\n}\n\n// ── Utility ──────────────────────────────────────────────────────────────\n\n/** Check if a value is a Ref */\nexport function isRef(value: any): value is Ref {\n return value !== null && typeof value === 'object' && 'subscribe' in value && 'value' in value\n}\n\n/** Unwrap a ref or return the value as-is */\nexport function unref<T>(value: Ref<T> | T): T {\n return isRef(value) ? value.value : value\n}\n\n/** Convert all properties of an object to refs */\nexport function toRefs<T extends Record<string, any>>(obj: T): { [K in keyof T]: Ref<T[K]> } {\n const result = {} as any\n for (const key in obj) {\n result[key] = ref(obj[key])\n }\n return result\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @forinda/kickjs v2.1.0
|
|
3
|
+
*
|
|
4
|
+
* Copyright (c) Felix Orinda
|
|
5
|
+
*
|
|
6
|
+
* This source code is licensed under the MIT license found in the
|
|
7
|
+
* LICENSE file in the root directory of this source tree.
|
|
8
|
+
*
|
|
9
|
+
* @license MIT
|
|
10
|
+
*/
|
|
11
|
+
import "./core/interfaces.mjs";
|
|
12
|
+
import "./core/logger.mjs";
|
|
13
|
+
import "./metadata-fmvikBA0.mjs";
|
|
14
|
+
import "./core/container.mjs";
|
|
15
|
+
import "./core/decorators.mjs";
|
|
16
|
+
import "./core/cron.mjs";
|
|
17
|
+
import "./core/cache.mjs";
|
|
18
|
+
import "reflect-metadata";
|
|
19
|
+
//#region src/core/circuit-breaker.ts
|
|
20
|
+
/**
|
|
21
|
+
* Error thrown when the circuit is open and calls are being rejected.
|
|
22
|
+
*/
|
|
23
|
+
var CircuitOpenError = class extends Error {
|
|
24
|
+
constructor(breakerName) {
|
|
25
|
+
super(`Circuit breaker "${breakerName}" is open — request rejected`);
|
|
26
|
+
this.breakerName = breakerName;
|
|
27
|
+
this.name = "CircuitOpenError";
|
|
28
|
+
}
|
|
29
|
+
};
|
|
30
|
+
var CircuitBreaker = class {
|
|
31
|
+
state = "closed";
|
|
32
|
+
failures = 0;
|
|
33
|
+
successes = 0;
|
|
34
|
+
halfOpenAttempts = 0;
|
|
35
|
+
lastFailure;
|
|
36
|
+
openedAt;
|
|
37
|
+
failureThreshold;
|
|
38
|
+
resetTimeout;
|
|
39
|
+
halfOpenMax;
|
|
40
|
+
constructor(name, options) {
|
|
41
|
+
this.name = name;
|
|
42
|
+
this.failureThreshold = options.failureThreshold;
|
|
43
|
+
this.resetTimeout = options.resetTimeout;
|
|
44
|
+
this.halfOpenMax = options.halfOpenMax ?? 1;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Execute an async function through the circuit breaker.
|
|
48
|
+
* Throws `CircuitOpenError` if the circuit is open.
|
|
49
|
+
*/
|
|
50
|
+
async execute(fn) {
|
|
51
|
+
this.maybeTransitionToHalfOpen();
|
|
52
|
+
if (this.state === "open") throw new CircuitOpenError(this.name);
|
|
53
|
+
if (this.state === "half_open" && this.halfOpenAttempts >= this.halfOpenMax) throw new CircuitOpenError(this.name);
|
|
54
|
+
if (this.state === "half_open") this.halfOpenAttempts++;
|
|
55
|
+
try {
|
|
56
|
+
const result = await fn();
|
|
57
|
+
this.onSuccess();
|
|
58
|
+
return result;
|
|
59
|
+
} catch (error) {
|
|
60
|
+
this.onFailure();
|
|
61
|
+
throw error;
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
/** Returns the current circuit state. */
|
|
65
|
+
getState() {
|
|
66
|
+
this.maybeTransitionToHalfOpen();
|
|
67
|
+
return this.state;
|
|
68
|
+
}
|
|
69
|
+
/** Returns current statistics. */
|
|
70
|
+
getStats() {
|
|
71
|
+
this.maybeTransitionToHalfOpen();
|
|
72
|
+
return {
|
|
73
|
+
failures: this.failures,
|
|
74
|
+
successes: this.successes,
|
|
75
|
+
state: this.state,
|
|
76
|
+
...this.lastFailure ? { lastFailure: this.lastFailure } : {}
|
|
77
|
+
};
|
|
78
|
+
}
|
|
79
|
+
/** Manually reset the circuit breaker to CLOSED state. */
|
|
80
|
+
reset() {
|
|
81
|
+
this.state = "closed";
|
|
82
|
+
this.failures = 0;
|
|
83
|
+
this.successes = 0;
|
|
84
|
+
this.halfOpenAttempts = 0;
|
|
85
|
+
this.lastFailure = void 0;
|
|
86
|
+
this.openedAt = void 0;
|
|
87
|
+
}
|
|
88
|
+
onSuccess() {
|
|
89
|
+
if (this.state === "half_open") {
|
|
90
|
+
this.state = "closed";
|
|
91
|
+
this.failures = 0;
|
|
92
|
+
this.halfOpenAttempts = 0;
|
|
93
|
+
this.openedAt = void 0;
|
|
94
|
+
}
|
|
95
|
+
this.successes++;
|
|
96
|
+
}
|
|
97
|
+
onFailure() {
|
|
98
|
+
this.failures++;
|
|
99
|
+
this.lastFailure = /* @__PURE__ */ new Date();
|
|
100
|
+
if (this.state === "half_open") {
|
|
101
|
+
this.state = "open";
|
|
102
|
+
this.openedAt = Date.now();
|
|
103
|
+
this.halfOpenAttempts = 0;
|
|
104
|
+
} else if (this.state === "closed" && this.failures >= this.failureThreshold) {
|
|
105
|
+
this.state = "open";
|
|
106
|
+
this.openedAt = Date.now();
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
maybeTransitionToHalfOpen() {
|
|
110
|
+
if (this.state === "open" && this.openedAt != null) {
|
|
111
|
+
if (Date.now() - this.openedAt >= this.resetTimeout) {
|
|
112
|
+
this.state = "half_open";
|
|
113
|
+
this.halfOpenAttempts = 0;
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
};
|
|
118
|
+
//#endregion
|
|
119
|
+
export { CircuitOpenError as n, CircuitBreaker as t };
|
|
120
|
+
|
|
121
|
+
//# sourceMappingURL=core-BL_H8fEZ.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"core-BL_H8fEZ.mjs","names":[],"sources":["../src/core/circuit-breaker.ts"],"sourcesContent":["/**\n * Circuit Breaker pattern for external service calls.\n *\n * Protects your application from cascading failures when downstream\n * services are unhealthy by short-circuiting requests after a\n * configurable failure threshold.\n *\n * @example\n * ```ts\n * const breaker = new CircuitBreaker('payment-api', {\n * failureThreshold: 5,\n * resetTimeout: 30_000,\n * })\n *\n * const result = await breaker.execute(() => fetch('https://payment.example.com/charge'))\n * ```\n */\n\nexport type CircuitBreakerState = 'closed' | 'open' | 'half_open'\n\nexport interface CircuitBreakerOptions {\n /** Number of consecutive failures before the circuit opens. */\n failureThreshold: number\n /** Milliseconds to wait before transitioning from OPEN to HALF_OPEN. */\n resetTimeout: number\n /** Max requests allowed in HALF_OPEN state before deciding (default 1). */\n halfOpenMax?: number\n}\n\nexport interface CircuitBreakerStats {\n failures: number\n successes: number\n state: CircuitBreakerState\n lastFailure?: Date\n}\n\n/**\n * Error thrown when the circuit is open and calls are being rejected.\n */\nexport class CircuitOpenError extends Error {\n constructor(public readonly breakerName: string) {\n super(`Circuit breaker \"${breakerName}\" is open — request rejected`)\n this.name = 'CircuitOpenError'\n }\n}\n\nexport class CircuitBreaker {\n private state: CircuitBreakerState = 'closed'\n private failures = 0\n private successes = 0\n private halfOpenAttempts = 0\n private lastFailure?: Date\n private openedAt?: number\n\n private readonly failureThreshold: number\n private readonly resetTimeout: number\n private readonly halfOpenMax: number\n\n constructor(\n public readonly name: string,\n options: CircuitBreakerOptions,\n ) {\n this.failureThreshold = options.failureThreshold\n this.resetTimeout = options.resetTimeout\n this.halfOpenMax = options.halfOpenMax ?? 1\n }\n\n /**\n * Execute an async function through the circuit breaker.\n * Throws `CircuitOpenError` if the circuit is open.\n */\n async execute<T>(fn: () => Promise<T>): Promise<T> {\n this.maybeTransitionToHalfOpen()\n\n if (this.state === 'open') {\n throw new CircuitOpenError(this.name)\n }\n\n if (this.state === 'half_open' && this.halfOpenAttempts >= this.halfOpenMax) {\n throw new CircuitOpenError(this.name)\n }\n\n if (this.state === 'half_open') {\n this.halfOpenAttempts++\n }\n\n try {\n const result = await fn()\n this.onSuccess()\n return result\n } catch (error) {\n this.onFailure()\n throw error\n }\n }\n\n /** Returns the current circuit state. */\n getState(): CircuitBreakerState {\n this.maybeTransitionToHalfOpen()\n return this.state\n }\n\n /** Returns current statistics. */\n getStats(): CircuitBreakerStats {\n this.maybeTransitionToHalfOpen()\n return {\n failures: this.failures,\n successes: this.successes,\n state: this.state,\n ...(this.lastFailure ? { lastFailure: this.lastFailure } : {}),\n }\n }\n\n /** Manually reset the circuit breaker to CLOSED state. */\n reset(): void {\n this.state = 'closed'\n this.failures = 0\n this.successes = 0\n this.halfOpenAttempts = 0\n this.lastFailure = undefined\n this.openedAt = undefined\n }\n\n private onSuccess(): void {\n if (this.state === 'half_open') {\n // Recovery confirmed — close the circuit\n this.state = 'closed'\n this.failures = 0\n this.halfOpenAttempts = 0\n this.openedAt = undefined\n }\n this.successes++\n }\n\n private onFailure(): void {\n this.failures++\n this.lastFailure = new Date()\n\n if (this.state === 'half_open') {\n // Recovery failed — re-open\n this.state = 'open'\n this.openedAt = Date.now()\n this.halfOpenAttempts = 0\n } else if (this.state === 'closed' && this.failures >= this.failureThreshold) {\n this.state = 'open'\n this.openedAt = Date.now()\n }\n }\n\n private maybeTransitionToHalfOpen(): void {\n if (this.state === 'open' && this.openedAt != null) {\n if (Date.now() - this.openedAt >= this.resetTimeout) {\n this.state = 'half_open'\n this.halfOpenAttempts = 0\n }\n }\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAuCA,IAAa,mBAAb,cAAsC,MAAM;CAC1C,YAAY,aAAqC;AAC/C,QAAM,oBAAoB,YAAY,8BAA8B;AAD1C,OAAA,cAAA;AAE1B,OAAK,OAAO;;;AAIhB,IAAa,iBAAb,MAA4B;CAC1B,QAAqC;CACrC,WAAmB;CACnB,YAAoB;CACpB,mBAA2B;CAC3B;CACA;CAEA;CACA;CACA;CAEA,YACE,MACA,SACA;AAFgB,OAAA,OAAA;AAGhB,OAAK,mBAAmB,QAAQ;AAChC,OAAK,eAAe,QAAQ;AAC5B,OAAK,cAAc,QAAQ,eAAe;;;;;;CAO5C,MAAM,QAAW,IAAkC;AACjD,OAAK,2BAA2B;AAEhC,MAAI,KAAK,UAAU,OACjB,OAAM,IAAI,iBAAiB,KAAK,KAAK;AAGvC,MAAI,KAAK,UAAU,eAAe,KAAK,oBAAoB,KAAK,YAC9D,OAAM,IAAI,iBAAiB,KAAK,KAAK;AAGvC,MAAI,KAAK,UAAU,YACjB,MAAK;AAGP,MAAI;GACF,MAAM,SAAS,MAAM,IAAI;AACzB,QAAK,WAAW;AAChB,UAAO;WACA,OAAO;AACd,QAAK,WAAW;AAChB,SAAM;;;;CAKV,WAAgC;AAC9B,OAAK,2BAA2B;AAChC,SAAO,KAAK;;;CAId,WAAgC;AAC9B,OAAK,2BAA2B;AAChC,SAAO;GACL,UAAU,KAAK;GACf,WAAW,KAAK;GAChB,OAAO,KAAK;GACZ,GAAI,KAAK,cAAc,EAAE,aAAa,KAAK,aAAa,GAAG,EAAE;GAC9D;;;CAIH,QAAc;AACZ,OAAK,QAAQ;AACb,OAAK,WAAW;AAChB,OAAK,YAAY;AACjB,OAAK,mBAAmB;AACxB,OAAK,cAAc,KAAA;AACnB,OAAK,WAAW,KAAA;;CAGlB,YAA0B;AACxB,MAAI,KAAK,UAAU,aAAa;AAE9B,QAAK,QAAQ;AACb,QAAK,WAAW;AAChB,QAAK,mBAAmB;AACxB,QAAK,WAAW,KAAA;;AAElB,OAAK;;CAGP,YAA0B;AACxB,OAAK;AACL,OAAK,8BAAc,IAAI,MAAM;AAE7B,MAAI,KAAK,UAAU,aAAa;AAE9B,QAAK,QAAQ;AACb,QAAK,WAAW,KAAK,KAAK;AAC1B,QAAK,mBAAmB;aACf,KAAK,UAAU,YAAY,KAAK,YAAY,KAAK,kBAAkB;AAC5E,QAAK,QAAQ;AACb,QAAK,WAAW,KAAK,KAAK;;;CAI9B,4BAA0C;AACxC,MAAI,KAAK,UAAU,UAAU,KAAK,YAAY;OACxC,KAAK,KAAK,GAAG,KAAK,YAAY,KAAK,cAAc;AACnD,SAAK,QAAQ;AACb,SAAK,mBAAmB"}
|