@forinda/kickjs 2.0.1 → 2.2.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 +63 -20
- package/dist/adapter-wuoBNkNs.d.mts +122 -0
- package/dist/adapter-wuoBNkNs.d.mts.map +1 -0
- package/dist/app-module-DOBmxARW.d.mts +40 -0
- package/dist/app-module-DOBmxARW.d.mts.map +1 -0
- package/dist/application-C5Q720a2.mjs +449 -0
- package/dist/application-C5Q720a2.mjs.map +1 -0
- package/dist/bootstrap-dEN6SjBl.mjs +205 -0
- package/dist/bootstrap-dEN6SjBl.mjs.map +1 -0
- package/dist/{core/cache.d.ts → cache-PufEhr0n.d.mts} +33 -31
- package/dist/cache-PufEhr0n.d.mts.map +1 -0
- package/dist/chunk-C9tIbwLT.mjs +15 -0
- package/dist/container-B7jFEbPE.mjs +496 -0
- package/dist/container-B7jFEbPE.mjs.map +1 -0
- package/dist/container-CcgV8eHL.d.mts +253 -0
- package/dist/container-CcgV8eHL.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 +12 -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 +219 -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-CMgIoRvg.mjs +121 -0
- package/dist/core-CMgIoRvg.mjs.map +1 -0
- package/dist/{core/cron.d.ts → cron-C29iHvHT.d.mts} +16 -14
- package/dist/cron-C29iHvHT.d.mts.map +1 -0
- package/dist/decorators-D3lBlmud.d.mts +204 -0
- package/dist/decorators-D3lBlmud.d.mts.map +1 -0
- package/dist/errors-BZUdxtjC.d.mts +68 -0
- package/dist/errors-BZUdxtjC.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 +190 -0
- package/dist/http/context.d.mts.map +1 -0
- package/dist/http/context.mjs +225 -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-4VM4dUJf.d.mts +107 -0
- package/dist/index-4VM4dUJf.d.mts.map +1 -0
- package/dist/index-rnK23QBD.d.mts +184 -0
- package/dist/index-rnK23QBD.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-D5ohYl6D.d.mts +52 -0
- package/dist/interfaces-D5ohYl6D.d.mts.map +1 -0
- package/dist/logger-BLdfUF5b.d.mts +119 -0
- package/dist/logger-BLdfUF5b.d.mts.map +1 -0
- package/dist/metadata-BqXgNTOf.mjs +76 -0
- package/dist/metadata-BqXgNTOf.mjs.map +1 -0
- package/dist/{core/path.d.ts → path-Dq5V-i-x.d.mts} +7 -3
- package/dist/path-Dq5V-i-x.d.mts.map +1 -0
- package/dist/plugin-D20muJwC.d.mts +95 -0
- package/dist/plugin-D20muJwC.d.mts.map +1 -0
- package/dist/query-vljPDFaZ.mjs +164 -0
- package/dist/query-vljPDFaZ.mjs.map +1 -0
- package/dist/{core/reactivity.d.ts → reactivity-CMAQh0gi.d.mts} +21 -20
- package/dist/reactivity-CMAQh0gi.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,76 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @forinda/kickjs v2.2.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 "reflect-metadata";
|
|
12
|
+
//#region src/core/metadata.ts
|
|
13
|
+
/** Set metadata on a class (or prototype for property decorators) */
|
|
14
|
+
function setClassMeta(key, value, target) {
|
|
15
|
+
Reflect.defineMetadata(key, value, target);
|
|
16
|
+
}
|
|
17
|
+
/** Set metadata on a specific method */
|
|
18
|
+
function setMethodMeta(key, value, target, method) {
|
|
19
|
+
Reflect.defineMetadata(key, value, target, method);
|
|
20
|
+
}
|
|
21
|
+
/** Get metadata from a class, returning `fallback` if not set */
|
|
22
|
+
function getClassMeta(key, target, fallback) {
|
|
23
|
+
return Reflect.getMetadata(key, target) ?? fallback;
|
|
24
|
+
}
|
|
25
|
+
/** Get metadata from a specific method, returning `fallback` if not set */
|
|
26
|
+
function getMethodMeta(key, target, method, fallback) {
|
|
27
|
+
return Reflect.getMetadata(key, target, method) ?? fallback;
|
|
28
|
+
}
|
|
29
|
+
/** Check if metadata exists on a class */
|
|
30
|
+
function hasClassMeta(key, target) {
|
|
31
|
+
return Reflect.hasMetadata(key, target);
|
|
32
|
+
}
|
|
33
|
+
/** Get metadata from a class with no default (returns undefined if absent) */
|
|
34
|
+
function getClassMetaOrUndefined(key, target) {
|
|
35
|
+
return Reflect.getMetadata(key, target);
|
|
36
|
+
}
|
|
37
|
+
/** Get metadata from a method with no default (returns undefined if absent) */
|
|
38
|
+
function getMethodMetaOrUndefined(key, target, method) {
|
|
39
|
+
return Reflect.getMetadata(key, target, method);
|
|
40
|
+
}
|
|
41
|
+
/** Append items to an array stored in class metadata */
|
|
42
|
+
function pushClassMeta(key, target, ...items) {
|
|
43
|
+
const existing = Reflect.getOwnMetadata(key, target) ?? [];
|
|
44
|
+
Reflect.defineMetadata(key, [...existing, ...items], target);
|
|
45
|
+
}
|
|
46
|
+
/** Append items to an array stored in method metadata */
|
|
47
|
+
function pushMethodMeta(key, target, method, ...items) {
|
|
48
|
+
const existing = Reflect.getOwnMetadata(key, target, method) ?? [];
|
|
49
|
+
Reflect.defineMetadata(key, [...existing, ...items], target, method);
|
|
50
|
+
}
|
|
51
|
+
/** Set a key/value in a Map stored in class metadata */
|
|
52
|
+
function setInMetaMap(key, target, mapKey, mapValue) {
|
|
53
|
+
const inherited = Reflect.getOwnMetadata(key, target);
|
|
54
|
+
const map = inherited ? new Map(inherited) : /* @__PURE__ */ new Map();
|
|
55
|
+
map.set(mapKey, mapValue);
|
|
56
|
+
Reflect.defineMetadata(key, map, target);
|
|
57
|
+
}
|
|
58
|
+
/** Get a Map from class metadata (returns empty Map if absent) */
|
|
59
|
+
function getMetaMap(key, target) {
|
|
60
|
+
return Reflect.getMetadata(key, target) ?? /* @__PURE__ */ new Map();
|
|
61
|
+
}
|
|
62
|
+
/** Set a key/value in a Record stored in class metadata */
|
|
63
|
+
function setInMetaRecord(key, target, recKey, recValue) {
|
|
64
|
+
const inherited = Reflect.getOwnMetadata(key, target);
|
|
65
|
+
const rec = inherited ? { ...inherited } : {};
|
|
66
|
+
rec[recKey] = recValue;
|
|
67
|
+
Reflect.defineMetadata(key, rec, target);
|
|
68
|
+
}
|
|
69
|
+
/** Get a Record from class metadata (returns empty object if absent) */
|
|
70
|
+
function getMetaRecord(key, target) {
|
|
71
|
+
return Reflect.getMetadata(key, target) ?? {};
|
|
72
|
+
}
|
|
73
|
+
//#endregion
|
|
74
|
+
export { getMethodMeta as a, pushClassMeta as c, setInMetaMap as d, setInMetaRecord as f, getMetaRecord as i, pushMethodMeta as l, getClassMetaOrUndefined as n, getMethodMetaOrUndefined as o, setMethodMeta as p, getMetaMap as r, hasClassMeta as s, getClassMeta as t, setClassMeta as u };
|
|
75
|
+
|
|
76
|
+
//# sourceMappingURL=metadata-BqXgNTOf.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"metadata-BqXgNTOf.mjs","names":[],"sources":["../src/core/metadata.ts"],"sourcesContent":["import 'reflect-metadata'\n\n/**\n * Typed utilities for reflect-metadata operations.\n *\n * Replaces scattered Reflect.defineMetadata/getMetadata calls with a single\n * source of truth. If we later move to Stage 3 decorators or a WeakMap-based\n * store, only this file changes — all 24+ consumer files stay untouched.\n */\n\ntype MetaKey = symbol | string\n\n// ── Setters ─────────────────────────────────────────────────────\n\n/** Set metadata on a class (or prototype for property decorators) */\nexport function setClassMeta<T>(key: MetaKey, value: T, target: object): void {\n Reflect.defineMetadata(key, value, target)\n}\n\n/** Set metadata on a specific method */\nexport function setMethodMeta<T>(key: MetaKey, value: T, target: object, method: string): void {\n Reflect.defineMetadata(key, value, target, method)\n}\n\n// ── Getters ─────────────────────────────────────────────────────\n\n/** Get metadata from a class, returning `fallback` if not set */\nexport function getClassMeta<T>(key: MetaKey, target: object, fallback: T): T {\n return (Reflect.getMetadata(key, target) as T) ?? fallback\n}\n\n/** Get metadata from a specific method, returning `fallback` if not set */\nexport function getMethodMeta<T>(key: MetaKey, target: object, method: string, fallback: T): T {\n return (Reflect.getMetadata(key, target, method) as T) ?? fallback\n}\n\n/** Check if metadata exists on a class */\nexport function hasClassMeta(key: MetaKey, target: object): boolean {\n return Reflect.hasMetadata(key, target)\n}\n\n/** Get metadata from a class with no default (returns undefined if absent) */\nexport function getClassMetaOrUndefined<T>(key: MetaKey, target: object): T | undefined {\n return Reflect.getMetadata(key, target) as T | undefined\n}\n\n/** Get metadata from a method with no default (returns undefined if absent) */\nexport function getMethodMetaOrUndefined<T>(\n key: MetaKey,\n target: object,\n method: string,\n): T | undefined {\n return Reflect.getMetadata(key, target, method) as T | undefined\n}\n\n// ── Accumulate: Arrays ──────────────────────────────────────────\n\n/** Append items to an array stored in class metadata */\nexport function pushClassMeta<T>(key: MetaKey, target: object, ...items: T[]): void {\n const existing: T[] = Reflect.getOwnMetadata(key, target) ?? []\n Reflect.defineMetadata(key, [...existing, ...items], target)\n}\n\n/** Append items to an array stored in method metadata */\nexport function pushMethodMeta<T>(\n key: MetaKey,\n target: object,\n method: string,\n ...items: T[]\n): void {\n const existing: T[] = Reflect.getOwnMetadata(key, target, method) ?? []\n Reflect.defineMetadata(key, [...existing, ...items], target, method)\n}\n\n// ── Accumulate: Maps ────────────────────────────────────────────\n\n/** Set a key/value in a Map stored in class metadata */\nexport function setInMetaMap<K, V>(key: MetaKey, target: object, mapKey: K, mapValue: V): void {\n const inherited: Map<K, V> | undefined = Reflect.getOwnMetadata(key, target)\n const map = inherited ? new Map(inherited) : new Map<K, V>()\n map.set(mapKey, mapValue)\n Reflect.defineMetadata(key, map, target)\n}\n\n/** Get a Map from class metadata (returns empty Map if absent) */\nexport function getMetaMap<K, V>(key: MetaKey, target: object): Map<K, V> {\n return Reflect.getMetadata(key, target) ?? new Map()\n}\n\n// ── Accumulate: Records ─────────────────────────────────────────\n\n/** Set a key/value in a Record stored in class metadata */\nexport function setInMetaRecord<V>(\n key: MetaKey,\n target: object,\n recKey: string | number,\n recValue: V,\n): void {\n const inherited: Record<string | number, V> | undefined = Reflect.getOwnMetadata(key, target)\n const rec = inherited ? { ...inherited } : {}\n rec[recKey] = recValue\n Reflect.defineMetadata(key, rec, target)\n}\n\n/** Get a Record from class metadata (returns empty object if absent) */\nexport function getMetaRecord<V>(key: MetaKey, target: object): Record<string | number, V> {\n return Reflect.getMetadata(key, target) ?? {}\n}\n"],"mappings":";;;;;;;;;;;;;AAeA,SAAgB,aAAgB,KAAc,OAAU,QAAsB;AAC5E,SAAQ,eAAe,KAAK,OAAO,OAAO;;;AAI5C,SAAgB,cAAiB,KAAc,OAAU,QAAgB,QAAsB;AAC7F,SAAQ,eAAe,KAAK,OAAO,QAAQ,OAAO;;;AAMpD,SAAgB,aAAgB,KAAc,QAAgB,UAAgB;AAC5E,QAAQ,QAAQ,YAAY,KAAK,OAAO,IAAU;;;AAIpD,SAAgB,cAAiB,KAAc,QAAgB,QAAgB,UAAgB;AAC7F,QAAQ,QAAQ,YAAY,KAAK,QAAQ,OAAO,IAAU;;;AAI5D,SAAgB,aAAa,KAAc,QAAyB;AAClE,QAAO,QAAQ,YAAY,KAAK,OAAO;;;AAIzC,SAAgB,wBAA2B,KAAc,QAA+B;AACtF,QAAO,QAAQ,YAAY,KAAK,OAAO;;;AAIzC,SAAgB,yBACd,KACA,QACA,QACe;AACf,QAAO,QAAQ,YAAY,KAAK,QAAQ,OAAO;;;AAMjD,SAAgB,cAAiB,KAAc,QAAgB,GAAG,OAAkB;CAClF,MAAM,WAAgB,QAAQ,eAAe,KAAK,OAAO,IAAI,EAAE;AAC/D,SAAQ,eAAe,KAAK,CAAC,GAAG,UAAU,GAAG,MAAM,EAAE,OAAO;;;AAI9D,SAAgB,eACd,KACA,QACA,QACA,GAAG,OACG;CACN,MAAM,WAAgB,QAAQ,eAAe,KAAK,QAAQ,OAAO,IAAI,EAAE;AACvE,SAAQ,eAAe,KAAK,CAAC,GAAG,UAAU,GAAG,MAAM,EAAE,QAAQ,OAAO;;;AAMtE,SAAgB,aAAmB,KAAc,QAAgB,QAAW,UAAmB;CAC7F,MAAM,YAAmC,QAAQ,eAAe,KAAK,OAAO;CAC5E,MAAM,MAAM,YAAY,IAAI,IAAI,UAAU,mBAAG,IAAI,KAAW;AAC5D,KAAI,IAAI,QAAQ,SAAS;AACzB,SAAQ,eAAe,KAAK,KAAK,OAAO;;;AAI1C,SAAgB,WAAiB,KAAc,QAA2B;AACxE,QAAO,QAAQ,YAAY,KAAK,OAAO,oBAAI,IAAI,KAAK;;;AAMtD,SAAgB,gBACd,KACA,QACA,QACA,UACM;CACN,MAAM,YAAoD,QAAQ,eAAe,KAAK,OAAO;CAC7F,MAAM,MAAM,YAAY,EAAE,GAAG,WAAW,GAAG,EAAE;AAC7C,KAAI,UAAU;AACd,SAAQ,eAAe,KAAK,KAAK,OAAO;;;AAI1C,SAAgB,cAAiB,KAAc,QAA4C;AACzF,QAAO,QAAQ,YAAY,KAAK,OAAO,IAAI,EAAE"}
|
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
|
|
2
|
+
//#region src/core/path.d.ts
|
|
1
3
|
/**
|
|
2
4
|
* Normalize a URL path segment:
|
|
3
5
|
* - '/' or '' or undefined → ''
|
|
@@ -5,7 +7,7 @@
|
|
|
5
7
|
* - Strips trailing '/'
|
|
6
8
|
* - Collapses consecutive '//' into single '/'
|
|
7
9
|
*/
|
|
8
|
-
|
|
10
|
+
declare function normalizePath(path?: string): string;
|
|
9
11
|
/**
|
|
10
12
|
* Join path segments into a single normalized path.
|
|
11
13
|
* Handles leading/trailing slashes and prevents double slashes.
|
|
@@ -17,5 +19,7 @@ export declare function normalizePath(path?: string): string;
|
|
|
17
19
|
* joinPaths('/api/v1', '') // '/api/v1'
|
|
18
20
|
* joinPaths('/api/v1', 'users') // '/api/v1/users'
|
|
19
21
|
*/
|
|
20
|
-
|
|
21
|
-
//#
|
|
22
|
+
declare function joinPaths(...segments: (string | undefined)[]): string;
|
|
23
|
+
//#endregion
|
|
24
|
+
export { normalizePath as n, joinPaths as t };
|
|
25
|
+
//# sourceMappingURL=path-Dq5V-i-x.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"path-Dq5V-i-x.d.mts","names":[],"sources":["../src/core/path.ts"],"mappings":";;;AAOA;;;;;AAsBA;iBAtBgB,aAAA,CAAc,IAAA;;;;;;;;;;;;iBAsBd,SAAA,CAAA,GAAa,QAAA"}
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
|
|
2
|
+
import { t as Container } from "./container-CcgV8eHL.mjs";
|
|
3
|
+
import { r as AppAdapter } from "./adapter-wuoBNkNs.mjs";
|
|
4
|
+
import { n as AppModuleClass } from "./app-module-DOBmxARW.mjs";
|
|
5
|
+
|
|
6
|
+
//#region src/core/plugin.d.ts
|
|
7
|
+
/**
|
|
8
|
+
* Plugin interface for extending KickJS applications.
|
|
9
|
+
*
|
|
10
|
+
* Plugins bundle modules, adapters, middleware, and DI bindings into a single
|
|
11
|
+
* reusable unit. They run before the application bootstraps, so they can
|
|
12
|
+
* register services and configure the app before any module loads.
|
|
13
|
+
*
|
|
14
|
+
* @example
|
|
15
|
+
* ```ts
|
|
16
|
+
* import type { KickPlugin } from '@forinda/kickjs-core'
|
|
17
|
+
*
|
|
18
|
+
* export class CorsPlugin implements KickPlugin {
|
|
19
|
+
* name = 'CorsPlugin'
|
|
20
|
+
*
|
|
21
|
+
* middleware() {
|
|
22
|
+
* return [cors({ origin: '*' })]
|
|
23
|
+
* }
|
|
24
|
+
* }
|
|
25
|
+
*
|
|
26
|
+
* // Usage:
|
|
27
|
+
* bootstrap({
|
|
28
|
+
* modules,
|
|
29
|
+
* plugins: [new CorsPlugin()],
|
|
30
|
+
* })
|
|
31
|
+
* ```
|
|
32
|
+
*
|
|
33
|
+
* @example
|
|
34
|
+
* ```ts
|
|
35
|
+
* // A more complex plugin that bundles modules and adapters
|
|
36
|
+
* export class AuthPlugin implements KickPlugin {
|
|
37
|
+
* name = 'AuthPlugin'
|
|
38
|
+
*
|
|
39
|
+
* constructor(private config: AuthConfig) {}
|
|
40
|
+
*
|
|
41
|
+
* register(container: Container) {
|
|
42
|
+
* container.registerFactory(AUTH_SERVICE, () => new JwtAuthService(this.config))
|
|
43
|
+
* }
|
|
44
|
+
*
|
|
45
|
+
* modules() {
|
|
46
|
+
* return [AuthModule]
|
|
47
|
+
* }
|
|
48
|
+
*
|
|
49
|
+
* adapters() {
|
|
50
|
+
* return [new AuthGuardAdapter(this.config)]
|
|
51
|
+
* }
|
|
52
|
+
*
|
|
53
|
+
* middleware() {
|
|
54
|
+
* return [passport.initialize()]
|
|
55
|
+
* }
|
|
56
|
+
* }
|
|
57
|
+
* ```
|
|
58
|
+
*/
|
|
59
|
+
interface KickPlugin {
|
|
60
|
+
/** Human-readable name for logging and debugging */
|
|
61
|
+
name: string;
|
|
62
|
+
/**
|
|
63
|
+
* Register DI bindings before modules load.
|
|
64
|
+
* Use this to provide services that modules depend on.
|
|
65
|
+
*/
|
|
66
|
+
register?(container: Container): void;
|
|
67
|
+
/**
|
|
68
|
+
* Return module classes to be loaded alongside user modules.
|
|
69
|
+
* Plugin modules are loaded before user modules.
|
|
70
|
+
*/
|
|
71
|
+
modules?(): AppModuleClass[];
|
|
72
|
+
/**
|
|
73
|
+
* Return adapter instances to be added to the application.
|
|
74
|
+
* Plugin adapters are added before user adapters.
|
|
75
|
+
*/
|
|
76
|
+
adapters?(): AppAdapter[];
|
|
77
|
+
/**
|
|
78
|
+
* Return Express middleware to be added to the global pipeline.
|
|
79
|
+
* Plugin middleware runs before user-defined middleware.
|
|
80
|
+
*/
|
|
81
|
+
middleware?(): any[];
|
|
82
|
+
/**
|
|
83
|
+
* Called after the application has fully bootstrapped.
|
|
84
|
+
* Use for post-startup logic like logging, health registration, etc.
|
|
85
|
+
*/
|
|
86
|
+
onReady?(container: Container): void | Promise<void>;
|
|
87
|
+
/**
|
|
88
|
+
* Called during application shutdown.
|
|
89
|
+
* Clean up plugin resources (connections, intervals, etc.).
|
|
90
|
+
*/
|
|
91
|
+
shutdown?(): void | Promise<void>;
|
|
92
|
+
}
|
|
93
|
+
//#endregion
|
|
94
|
+
export { KickPlugin as t };
|
|
95
|
+
//# sourceMappingURL=plugin-D20muJwC.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"plugin-D20muJwC.d.mts","names":[],"sources":["../src/core/plugin.ts"],"mappings":";;;;;;;;AAwDA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAAiB,UAAA;;EAEf,IAAA;;;;;EAMA,QAAA,EAAU,SAAA,EAAW,SAAA;;;;;EAMrB,OAAA,KAAY,cAAA;;;;;EAMZ,QAAA,KAAa,UAAA;;;;;EAMb,UAAA;;;;;EAMA,OAAA,EAAS,SAAA,EAAW,SAAA,UAAmB,OAAA;;;;;EAMvC,QAAA,YAAoB,OAAA;AAAA"}
|
|
@@ -0,0 +1,164 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @forinda/kickjs v2.2.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/http/query/types.ts
|
|
12
|
+
const FILTER_OPERATORS = new Set([
|
|
13
|
+
"eq",
|
|
14
|
+
"neq",
|
|
15
|
+
"gt",
|
|
16
|
+
"gte",
|
|
17
|
+
"lt",
|
|
18
|
+
"lte",
|
|
19
|
+
"between",
|
|
20
|
+
"in",
|
|
21
|
+
"contains",
|
|
22
|
+
"starts",
|
|
23
|
+
"ends"
|
|
24
|
+
]);
|
|
25
|
+
//#endregion
|
|
26
|
+
//#region src/http/query/parse-query.ts
|
|
27
|
+
const MAX_SEARCH_LENGTH = 200;
|
|
28
|
+
const DEFAULT_PAGE = 1;
|
|
29
|
+
const DEFAULT_LIMIT = 20;
|
|
30
|
+
const MAX_LIMIT = 100;
|
|
31
|
+
/** Parse filter strings like "status:eq:active" into structured objects */
|
|
32
|
+
function parseFilters(filterParam, allowedFields) {
|
|
33
|
+
if (!filterParam) return [];
|
|
34
|
+
const items = Array.isArray(filterParam) ? filterParam : [filterParam];
|
|
35
|
+
const results = [];
|
|
36
|
+
const allowed = allowedFields ? new Set(allowedFields) : null;
|
|
37
|
+
for (const item of items) {
|
|
38
|
+
const firstColon = item.indexOf(":");
|
|
39
|
+
if (firstColon === -1) continue;
|
|
40
|
+
const secondColon = item.indexOf(":", firstColon + 1);
|
|
41
|
+
if (secondColon === -1) continue;
|
|
42
|
+
const field = item.slice(0, firstColon);
|
|
43
|
+
const operator = item.slice(firstColon + 1, secondColon);
|
|
44
|
+
const value = item.slice(secondColon + 1);
|
|
45
|
+
if (!field || !value) continue;
|
|
46
|
+
if (!FILTER_OPERATORS.has(operator)) continue;
|
|
47
|
+
if (allowed && !allowed.has(field)) continue;
|
|
48
|
+
results.push({
|
|
49
|
+
field,
|
|
50
|
+
operator,
|
|
51
|
+
value
|
|
52
|
+
});
|
|
53
|
+
}
|
|
54
|
+
return results;
|
|
55
|
+
}
|
|
56
|
+
/** Parse sort strings like "firstName:asc" into structured objects */
|
|
57
|
+
function parseSort(sortParam, allowedFields) {
|
|
58
|
+
if (!sortParam) return [];
|
|
59
|
+
const items = Array.isArray(sortParam) ? sortParam : [sortParam];
|
|
60
|
+
const results = [];
|
|
61
|
+
const allowed = allowedFields ? new Set(allowedFields) : null;
|
|
62
|
+
for (const item of items) {
|
|
63
|
+
const lastColon = item.lastIndexOf(":");
|
|
64
|
+
if (lastColon === -1) continue;
|
|
65
|
+
const field = item.slice(0, lastColon);
|
|
66
|
+
const dir = item.slice(lastColon + 1).toLowerCase();
|
|
67
|
+
if (!field) continue;
|
|
68
|
+
if (dir !== "asc" && dir !== "desc") continue;
|
|
69
|
+
if (allowed && !allowed.has(field)) continue;
|
|
70
|
+
results.push({
|
|
71
|
+
field,
|
|
72
|
+
direction: dir
|
|
73
|
+
});
|
|
74
|
+
}
|
|
75
|
+
return results;
|
|
76
|
+
}
|
|
77
|
+
/** Parse page/limit into pagination with computed offset */
|
|
78
|
+
function parsePagination(params) {
|
|
79
|
+
let page = typeof params.page === "string" ? Number.parseInt(params.page, 10) : params.page ?? DEFAULT_PAGE;
|
|
80
|
+
let limit = typeof params.limit === "string" ? Number.parseInt(params.limit, 10) : params.limit ?? DEFAULT_LIMIT;
|
|
81
|
+
if (Number.isNaN(page) || page < 1) page = DEFAULT_PAGE;
|
|
82
|
+
if (Number.isNaN(limit) || limit < 1) limit = DEFAULT_LIMIT;
|
|
83
|
+
if (limit > MAX_LIMIT) limit = MAX_LIMIT;
|
|
84
|
+
return {
|
|
85
|
+
page,
|
|
86
|
+
limit,
|
|
87
|
+
offset: (page - 1) * limit
|
|
88
|
+
};
|
|
89
|
+
}
|
|
90
|
+
/** Sanitize and truncate search query */
|
|
91
|
+
function parseSearchQuery(q) {
|
|
92
|
+
if (!q) return "";
|
|
93
|
+
return q.trim().slice(0, MAX_SEARCH_LENGTH);
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* Normalize a QueryFieldConfig into the string-based form.
|
|
97
|
+
* Detects column-object-based configs (DrizzleQueryParamsConfig) by checking
|
|
98
|
+
* for a `columns` property and extracts `Object.keys()`.
|
|
99
|
+
*/
|
|
100
|
+
function normalizeFieldConfig(config) {
|
|
101
|
+
if (!config) return void 0;
|
|
102
|
+
if ("columns" in config && config.columns && typeof config.columns === "object") return {
|
|
103
|
+
filterable: Object.keys(config.columns),
|
|
104
|
+
sortable: config.sortable ? Object.keys(config.sortable) : void 0,
|
|
105
|
+
searchable: void 0
|
|
106
|
+
};
|
|
107
|
+
return config;
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* Parse a raw Express query object into a structured, ORM-agnostic ParsedQuery.
|
|
111
|
+
*
|
|
112
|
+
* @param query - Raw query string object from `req.query` or Zod-validated object
|
|
113
|
+
* @param fieldConfig - Optional field restrictions (whitelist filterable/sortable/searchable).
|
|
114
|
+
* Accepts both string-based configs (`{ filterable, sortable, searchable }`) and
|
|
115
|
+
* column-object configs (`{ columns, sortable, searchColumns }`).
|
|
116
|
+
*
|
|
117
|
+
* @example
|
|
118
|
+
* ```ts
|
|
119
|
+
* // String-based config
|
|
120
|
+
* const parsed = parseQuery(ctx.query, {
|
|
121
|
+
* filterable: ['status', 'priority'],
|
|
122
|
+
* sortable: ['createdAt', 'title'],
|
|
123
|
+
* })
|
|
124
|
+
*
|
|
125
|
+
* // Column-object config (DrizzleQueryParamsConfig)
|
|
126
|
+
* const parsed = parseQuery(ctx.query, TASK_QUERY_CONFIG)
|
|
127
|
+
* ```
|
|
128
|
+
*
|
|
129
|
+
* Query string format:
|
|
130
|
+
* - Filters: `?filter=field:operator:value` (repeatable)
|
|
131
|
+
* - Sort: `?sort=field:asc|desc` (repeatable)
|
|
132
|
+
* - Pagination: `?page=1&limit=20`
|
|
133
|
+
* - Search: `?q=search+term`
|
|
134
|
+
*
|
|
135
|
+
* Filter operators: eq, neq, gt, gte, lt, lte, between, in, contains, starts, ends
|
|
136
|
+
*/
|
|
137
|
+
function parseQuery(query, fieldConfig) {
|
|
138
|
+
const normalized = normalizeFieldConfig(fieldConfig);
|
|
139
|
+
return {
|
|
140
|
+
filters: parseFilters(query.filter, normalized?.filterable),
|
|
141
|
+
sort: parseSort(query.sort, normalized?.sortable),
|
|
142
|
+
pagination: parsePagination({
|
|
143
|
+
page: query.page,
|
|
144
|
+
limit: query.limit
|
|
145
|
+
}),
|
|
146
|
+
search: parseSearchQuery(query.q)
|
|
147
|
+
};
|
|
148
|
+
}
|
|
149
|
+
/** Convert ParsedQuery back into query string parameters */
|
|
150
|
+
function buildQueryParams(parsed) {
|
|
151
|
+
const params = {};
|
|
152
|
+
if (parsed.filters?.length) params.filter = parsed.filters.map((f) => `${f.field}:${f.operator}:${f.value}`);
|
|
153
|
+
if (parsed.sort?.length) params.sort = parsed.sort.map((s) => `${s.field}:${s.direction}`);
|
|
154
|
+
if (parsed.pagination) {
|
|
155
|
+
params.page = parsed.pagination.page;
|
|
156
|
+
params.limit = parsed.pagination.limit;
|
|
157
|
+
}
|
|
158
|
+
if (parsed.search) params.q = parsed.search;
|
|
159
|
+
return params;
|
|
160
|
+
}
|
|
161
|
+
//#endregion
|
|
162
|
+
export { parseSearchQuery as a, parseQuery as i, parseFilters as n, parseSort as o, parsePagination as r, FILTER_OPERATORS as s, buildQueryParams as t };
|
|
163
|
+
|
|
164
|
+
//# sourceMappingURL=query-vljPDFaZ.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"query-vljPDFaZ.mjs","names":[],"sources":["../src/http/query/types.ts","../src/http/query/parse-query.ts"],"sourcesContent":["/** Supported filter operators for query string parsing */\nexport type FilterOperator =\n | 'eq'\n | 'neq'\n | 'gt'\n | 'gte'\n | 'lt'\n | 'lte'\n | 'between'\n | 'in'\n | 'contains'\n | 'starts'\n | 'ends'\n\nexport const FILTER_OPERATORS = new Set<string>([\n 'eq',\n 'neq',\n 'gt',\n 'gte',\n 'lt',\n 'lte',\n 'between',\n 'in',\n 'contains',\n 'starts',\n 'ends',\n])\n\nexport interface FilterItem {\n field: string\n operator: FilterOperator\n value: string\n}\n\nexport interface SortItem {\n field: string\n direction: 'asc' | 'desc'\n}\n\nexport interface PaginationParams {\n page: number\n limit: number\n offset: number\n}\n\n/**\n * The result of parsing a query string. ORM-agnostic — pass this to\n * a query builder adapter (Drizzle, Prisma, Sequelize, etc.) to produce\n * database-specific query objects.\n */\nexport interface ParsedQuery {\n filters: FilterItem[]\n sort: SortItem[]\n pagination: PaginationParams\n search: string\n}\n\n/**\n * Helper that extracts the literal field union from a `QueryFieldConfig`\n * key. When the user passes `{ filterable: ['status', 'category'] } as const`,\n * `FieldsOf<typeof config, 'filterable'>` resolves to `'status' | 'category'`.\n *\n * Without `as const`, the arrays widen to `string[]` and the union falls\n * back to `string`. This is the documented escape hatch.\n */\nexport type FieldsOf<\n TConfig extends QueryFieldConfig | undefined,\n K extends 'filterable' | 'sortable' | 'searchable',\n> = TConfig extends { readonly [P in K]: readonly (infer F)[] }\n ? F extends string\n ? F\n : string\n : TConfig extends { columns: infer C }\n ? K extends 'filterable'\n ? keyof C & string\n : string\n : string\n\n/**\n * Narrowed `ParsedQuery` whose `filters[].field` and `sort[].field`\n * unions are constrained to the literal whitelist passed to\n * `ctx.qs()` / `parseQuery()`. Extends `ParsedQuery`, so any function\n * accepting `ParsedQuery` accepts a `TypedParsedQuery<X>` automatically\n * (subtype assignment, no codegen, backward compatible).\n *\n * @example\n * ```ts\n * const parsed = ctx.qs({\n * filterable: ['status', 'priority'],\n * sortable: ['createdAt'],\n * } as const)\n * parsed.filters[0]?.field // 'status' | 'priority'\n * parsed.sort[0]?.field // 'createdAt'\n * ```\n */\nexport interface TypedParsedQuery<\n TConfig extends QueryFieldConfig | undefined,\n> extends ParsedQuery {\n filters: Array<FilterItem & { field: FieldsOf<TConfig, 'filterable'> }>\n sort: Array<SortItem & { field: FieldsOf<TConfig, 'sortable'> }>\n}\n\n/**\n * Restrict which fields can be filtered, sorted, or searched.\n * Fields not in the allow-list are silently ignored.\n *\n * Accepts two forms:\n * 1. **String arrays** (standard): `{ filterable: ['name', 'status'], sortable: ['createdAt'] }`\n * 2. **Column-object maps** (Drizzle-style): `{ columns: { name: col, status: col }, sortable: { createdAt: col } }`\n *\n * When column-object maps are provided, `Object.keys()` is used to derive the field names.\n */\nexport type QueryFieldConfig = StringQueryFieldConfig | ColumnQueryFieldConfig\n\nexport interface StringQueryFieldConfig {\n filterable?: string[]\n sortable?: string[]\n searchable?: string[]\n}\n\n/**\n * Column-object-based field config (e.g., from DrizzleQueryParamsConfig).\n * Keys are the field names used in query strings; values are ORM column references.\n */\nexport interface ColumnQueryFieldConfig {\n columns: Record<string, any>\n sortable?: Record<string, any>\n searchColumns?: any[]\n [key: string]: any\n}\n\n/** Standardized paginated response shape */\nexport interface PaginatedResponse<T = any> {\n data: T[]\n meta: {\n page: number\n limit: number\n total: number\n totalPages: number\n hasNext: boolean\n hasPrev: boolean\n }\n}\n\n/**\n * Interface for ORM-specific query builder adapters.\n * Implement this to translate a `ParsedQuery` into your ORM's query format.\n *\n * @example\n * ```ts\n * // Drizzle adapter\n * class DrizzleQueryAdapter implements QueryBuilderAdapter<DrizzleQueryResult> {\n * build(parsed: ParsedQuery, config: DrizzleConfig): DrizzleQueryResult {\n * // Convert filters → Drizzle SQL conditions\n * // Convert sort → Drizzle orderBy\n * return { where, orderBy, limit, offset }\n * }\n * }\n *\n * // Prisma adapter\n * class PrismaQueryAdapter implements QueryBuilderAdapter<PrismaQueryResult> {\n * build(parsed: ParsedQuery, config: PrismaConfig): PrismaQueryResult {\n * return { where, orderBy, skip, take }\n * }\n * }\n * ```\n */\nexport interface QueryBuilderAdapter<TResult = any, TConfig = any> {\n /** Human-readable name for debugging */\n readonly name: string\n\n /**\n * Convert a ParsedQuery into an ORM-specific query object.\n * @param parsed - The ORM-agnostic parsed query\n * @param config - ORM-specific configuration (column maps, search columns, etc.)\n */\n build(parsed: ParsedQuery, config: TConfig): TResult\n}\n","import {\n FILTER_OPERATORS,\n type FilterItem,\n type FilterOperator,\n type SortItem,\n type PaginationParams,\n type ParsedQuery,\n type QueryFieldConfig,\n type StringQueryFieldConfig,\n type TypedParsedQuery,\n} from './types'\n\nconst MAX_SEARCH_LENGTH = 200\nconst DEFAULT_PAGE = 1\nconst DEFAULT_LIMIT = 20\nconst MAX_LIMIT = 100\n\n// ── Individual parsers ──────────────────────────────────────────────────\n\n/** Parse filter strings like \"status:eq:active\" into structured objects */\nexport function parseFilters(\n filterParam: string | string[] | undefined,\n allowedFields?: string[],\n): FilterItem[] {\n if (!filterParam) return []\n\n const items = Array.isArray(filterParam) ? filterParam : [filterParam]\n const results: FilterItem[] = []\n const allowed = allowedFields ? new Set(allowedFields) : null\n\n for (const item of items) {\n // Split on first two colons only — value may contain colons (e.g. timestamps)\n const firstColon = item.indexOf(':')\n if (firstColon === -1) continue\n\n const secondColon = item.indexOf(':', firstColon + 1)\n if (secondColon === -1) continue\n\n const field = item.slice(0, firstColon)\n const operator = item.slice(firstColon + 1, secondColon)\n const value = item.slice(secondColon + 1)\n\n if (!field || !value) continue\n if (!FILTER_OPERATORS.has(operator)) continue\n if (allowed && !allowed.has(field)) continue\n\n results.push({ field, operator: operator as FilterOperator, value })\n }\n\n return results\n}\n\n/** Parse sort strings like \"firstName:asc\" into structured objects */\nexport function parseSort(\n sortParam: string | string[] | undefined,\n allowedFields?: string[],\n): SortItem[] {\n if (!sortParam) return []\n\n const items = Array.isArray(sortParam) ? sortParam : [sortParam]\n const results: SortItem[] = []\n const allowed = allowedFields ? new Set(allowedFields) : null\n\n for (const item of items) {\n // Split on last colon so field names with colons work\n const lastColon = item.lastIndexOf(':')\n if (lastColon === -1) continue\n\n const field = item.slice(0, lastColon)\n const dir = item.slice(lastColon + 1).toLowerCase()\n\n if (!field) continue\n if (dir !== 'asc' && dir !== 'desc') continue\n if (allowed && !allowed.has(field)) continue\n\n results.push({ field, direction: dir })\n }\n\n return results\n}\n\n/** Parse page/limit into pagination with computed offset */\nexport function parsePagination(params: {\n page?: string | number\n limit?: string | number\n}): PaginationParams {\n let page =\n typeof params.page === 'string'\n ? Number.parseInt(params.page, 10)\n : (params.page ?? DEFAULT_PAGE)\n let limit =\n typeof params.limit === 'string'\n ? Number.parseInt(params.limit, 10)\n : (params.limit ?? DEFAULT_LIMIT)\n\n if (Number.isNaN(page) || page < 1) page = DEFAULT_PAGE\n if (Number.isNaN(limit) || limit < 1) limit = DEFAULT_LIMIT\n if (limit > MAX_LIMIT) limit = MAX_LIMIT\n\n return { page, limit, offset: (page - 1) * limit }\n}\n\n/** Sanitize and truncate search query */\nexport function parseSearchQuery(q: string | undefined): string {\n if (!q) return ''\n return q.trim().slice(0, MAX_SEARCH_LENGTH)\n}\n\n// ── Config normalizer ───────────────────────────────────────────────────\n\n/**\n * Normalize a QueryFieldConfig into the string-based form.\n * Detects column-object-based configs (DrizzleQueryParamsConfig) by checking\n * for a `columns` property and extracts `Object.keys()`.\n */\nfunction normalizeFieldConfig(config?: QueryFieldConfig): StringQueryFieldConfig | undefined {\n if (!config) return undefined\n\n // Column-object-based config (e.g., DrizzleQueryParamsConfig)\n if ('columns' in config && config.columns && typeof config.columns === 'object') {\n return {\n filterable: Object.keys(config.columns),\n sortable: config.sortable ? Object.keys(config.sortable) : undefined,\n searchable: undefined, // searchColumns are Column objects, not used for string filtering\n }\n }\n\n // Already string-based\n return config as StringQueryFieldConfig\n}\n\n// ── Combined parser ─────────────────────────────────────────────────────\n\n/**\n * Parse a raw Express query object into a structured, ORM-agnostic ParsedQuery.\n *\n * @param query - Raw query string object from `req.query` or Zod-validated object\n * @param fieldConfig - Optional field restrictions (whitelist filterable/sortable/searchable).\n * Accepts both string-based configs (`{ filterable, sortable, searchable }`) and\n * column-object configs (`{ columns, sortable, searchColumns }`).\n *\n * @example\n * ```ts\n * // String-based config\n * const parsed = parseQuery(ctx.query, {\n * filterable: ['status', 'priority'],\n * sortable: ['createdAt', 'title'],\n * })\n *\n * // Column-object config (DrizzleQueryParamsConfig)\n * const parsed = parseQuery(ctx.query, TASK_QUERY_CONFIG)\n * ```\n *\n * Query string format:\n * - Filters: `?filter=field:operator:value` (repeatable)\n * - Sort: `?sort=field:asc|desc` (repeatable)\n * - Pagination: `?page=1&limit=20`\n * - Search: `?q=search+term`\n *\n * Filter operators: eq, neq, gt, gte, lt, lte, between, in, contains, starts, ends\n */\nexport function parseQuery<TConfig extends QueryFieldConfig | undefined = undefined>(\n query: Record<string, any>,\n fieldConfig?: TConfig,\n): TypedParsedQuery<TConfig> {\n const normalized = normalizeFieldConfig(fieldConfig)\n return {\n filters: parseFilters(query.filter, normalized?.filterable),\n sort: parseSort(query.sort, normalized?.sortable),\n pagination: parsePagination({ page: query.page, limit: query.limit }),\n search: parseSearchQuery(query.q),\n } as TypedParsedQuery<TConfig>\n}\n\n// ── Query URL builder (for client-side or testing) ──────────────────────\n\n/** Convert ParsedQuery back into query string parameters */\nexport function buildQueryParams(\n parsed: Partial<ParsedQuery>,\n): Record<string, string | string[] | number> {\n const params: Record<string, string | string[] | number> = {}\n\n if (parsed.filters?.length) {\n params.filter = parsed.filters.map((f) => `${f.field}:${f.operator}:${f.value}`)\n }\n\n if (parsed.sort?.length) {\n params.sort = parsed.sort.map((s) => `${s.field}:${s.direction}`)\n }\n\n if (parsed.pagination) {\n params.page = parsed.pagination.page\n params.limit = parsed.pagination.limit\n }\n\n if (parsed.search) {\n params.q = parsed.search\n }\n\n return params\n}\n"],"mappings":";;;;;;;;;;;AAcA,MAAa,mBAAmB,IAAI,IAAY;CAC9C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;ACdF,MAAM,oBAAoB;AAC1B,MAAM,eAAe;AACrB,MAAM,gBAAgB;AACtB,MAAM,YAAY;;AAKlB,SAAgB,aACd,aACA,eACc;AACd,KAAI,CAAC,YAAa,QAAO,EAAE;CAE3B,MAAM,QAAQ,MAAM,QAAQ,YAAY,GAAG,cAAc,CAAC,YAAY;CACtE,MAAM,UAAwB,EAAE;CAChC,MAAM,UAAU,gBAAgB,IAAI,IAAI,cAAc,GAAG;AAEzD,MAAK,MAAM,QAAQ,OAAO;EAExB,MAAM,aAAa,KAAK,QAAQ,IAAI;AACpC,MAAI,eAAe,GAAI;EAEvB,MAAM,cAAc,KAAK,QAAQ,KAAK,aAAa,EAAE;AACrD,MAAI,gBAAgB,GAAI;EAExB,MAAM,QAAQ,KAAK,MAAM,GAAG,WAAW;EACvC,MAAM,WAAW,KAAK,MAAM,aAAa,GAAG,YAAY;EACxD,MAAM,QAAQ,KAAK,MAAM,cAAc,EAAE;AAEzC,MAAI,CAAC,SAAS,CAAC,MAAO;AACtB,MAAI,CAAC,iBAAiB,IAAI,SAAS,CAAE;AACrC,MAAI,WAAW,CAAC,QAAQ,IAAI,MAAM,CAAE;AAEpC,UAAQ,KAAK;GAAE;GAAiB;GAA4B;GAAO,CAAC;;AAGtE,QAAO;;;AAIT,SAAgB,UACd,WACA,eACY;AACZ,KAAI,CAAC,UAAW,QAAO,EAAE;CAEzB,MAAM,QAAQ,MAAM,QAAQ,UAAU,GAAG,YAAY,CAAC,UAAU;CAChE,MAAM,UAAsB,EAAE;CAC9B,MAAM,UAAU,gBAAgB,IAAI,IAAI,cAAc,GAAG;AAEzD,MAAK,MAAM,QAAQ,OAAO;EAExB,MAAM,YAAY,KAAK,YAAY,IAAI;AACvC,MAAI,cAAc,GAAI;EAEtB,MAAM,QAAQ,KAAK,MAAM,GAAG,UAAU;EACtC,MAAM,MAAM,KAAK,MAAM,YAAY,EAAE,CAAC,aAAa;AAEnD,MAAI,CAAC,MAAO;AACZ,MAAI,QAAQ,SAAS,QAAQ,OAAQ;AACrC,MAAI,WAAW,CAAC,QAAQ,IAAI,MAAM,CAAE;AAEpC,UAAQ,KAAK;GAAE;GAAO,WAAW;GAAK,CAAC;;AAGzC,QAAO;;;AAIT,SAAgB,gBAAgB,QAGX;CACnB,IAAI,OACF,OAAO,OAAO,SAAS,WACnB,OAAO,SAAS,OAAO,MAAM,GAAG,GAC/B,OAAO,QAAQ;CACtB,IAAI,QACF,OAAO,OAAO,UAAU,WACpB,OAAO,SAAS,OAAO,OAAO,GAAG,GAChC,OAAO,SAAS;AAEvB,KAAI,OAAO,MAAM,KAAK,IAAI,OAAO,EAAG,QAAO;AAC3C,KAAI,OAAO,MAAM,MAAM,IAAI,QAAQ,EAAG,SAAQ;AAC9C,KAAI,QAAQ,UAAW,SAAQ;AAE/B,QAAO;EAAE;EAAM;EAAO,SAAS,OAAO,KAAK;EAAO;;;AAIpD,SAAgB,iBAAiB,GAA+B;AAC9D,KAAI,CAAC,EAAG,QAAO;AACf,QAAO,EAAE,MAAM,CAAC,MAAM,GAAG,kBAAkB;;;;;;;AAU7C,SAAS,qBAAqB,QAA+D;AAC3F,KAAI,CAAC,OAAQ,QAAO,KAAA;AAGpB,KAAI,aAAa,UAAU,OAAO,WAAW,OAAO,OAAO,YAAY,SACrE,QAAO;EACL,YAAY,OAAO,KAAK,OAAO,QAAQ;EACvC,UAAU,OAAO,WAAW,OAAO,KAAK,OAAO,SAAS,GAAG,KAAA;EAC3D,YAAY,KAAA;EACb;AAIH,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCT,SAAgB,WACd,OACA,aAC2B;CAC3B,MAAM,aAAa,qBAAqB,YAAY;AACpD,QAAO;EACL,SAAS,aAAa,MAAM,QAAQ,YAAY,WAAW;EAC3D,MAAM,UAAU,MAAM,MAAM,YAAY,SAAS;EACjD,YAAY,gBAAgB;GAAE,MAAM,MAAM;GAAM,OAAO,MAAM;GAAO,CAAC;EACrE,QAAQ,iBAAiB,MAAM,EAAE;EAClC;;;AAMH,SAAgB,iBACd,QAC4C;CAC5C,MAAM,SAAqD,EAAE;AAE7D,KAAI,OAAO,SAAS,OAClB,QAAO,SAAS,OAAO,QAAQ,KAAK,MAAM,GAAG,EAAE,MAAM,GAAG,EAAE,SAAS,GAAG,EAAE,QAAQ;AAGlF,KAAI,OAAO,MAAM,OACf,QAAO,OAAO,OAAO,KAAK,KAAK,MAAM,GAAG,EAAE,MAAM,GAAG,EAAE,YAAY;AAGnE,KAAI,OAAO,YAAY;AACrB,SAAO,OAAO,OAAO,WAAW;AAChC,SAAO,QAAQ,OAAO,WAAW;;AAGnC,KAAI,OAAO,OACT,QAAO,IAAI,OAAO;AAGpB,QAAO"}
|
|
@@ -1,12 +1,14 @@
|
|
|
1
|
+
|
|
2
|
+
//#region src/core/reactivity.d.ts
|
|
1
3
|
/**
|
|
2
4
|
* Lightweight reactivity system inspired by Vue 3's composition API.
|
|
3
5
|
* Provides ref(), computed(), watch(), and reactive() for observable
|
|
4
6
|
* backend state — config, metrics, health, circuit breakers.
|
|
5
7
|
*/
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
8
|
+
interface Ref<T = any> {
|
|
9
|
+
value: T;
|
|
10
|
+
/** Subscribe to changes. Returns unsubscribe function. */
|
|
11
|
+
subscribe(fn: (newValue: T, oldValue: T) => void): () => void;
|
|
10
12
|
}
|
|
11
13
|
/**
|
|
12
14
|
* Create a reactive reference. Reading `.value` tracks the dependency,
|
|
@@ -18,9 +20,9 @@ export interface Ref<T = any> {
|
|
|
18
20
|
* count.value++ // triggers watchers
|
|
19
21
|
* ```
|
|
20
22
|
*/
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
23
|
+
declare function ref<T>(initialValue: T): Ref<T>;
|
|
24
|
+
interface ComputedRef<T = any> {
|
|
25
|
+
readonly value: T;
|
|
24
26
|
}
|
|
25
27
|
/**
|
|
26
28
|
* Create a computed value that auto-recalculates when its reactive
|
|
@@ -34,10 +36,10 @@ export interface ComputedRef<T = any> {
|
|
|
34
36
|
* console.log(doubled.value) // 10
|
|
35
37
|
* ```
|
|
36
38
|
*/
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
39
|
+
declare function computed<T>(getter: () => T): ComputedRef<T>;
|
|
40
|
+
interface WatchOptions {
|
|
41
|
+
/** Run the callback immediately with the current value (default: false) */
|
|
42
|
+
immediate?: boolean;
|
|
41
43
|
}
|
|
42
44
|
type WatchSource<T> = Ref<T> | ComputedRef<T> | (() => T);
|
|
43
45
|
/**
|
|
@@ -54,7 +56,7 @@ type WatchSource<T> = Ref<T> | ComputedRef<T> | (() => T);
|
|
|
54
56
|
* stop() // no more callbacks
|
|
55
57
|
* ```
|
|
56
58
|
*/
|
|
57
|
-
|
|
59
|
+
declare function watch<T>(source: WatchSource<T>, callback: (newValue: T, oldValue: T) => void, options?: WatchOptions): () => void;
|
|
58
60
|
/**
|
|
59
61
|
* Create a deeply reactive proxy around a plain object. Property reads
|
|
60
62
|
* are tracked, property writes trigger watchers and computed recalculations.
|
|
@@ -70,14 +72,13 @@ export declare function watch<T>(source: WatchSource<T>, callback: (newValue: T,
|
|
|
70
72
|
* console.log(errorRate.value) // 0.05
|
|
71
73
|
* ```
|
|
72
74
|
*/
|
|
73
|
-
|
|
75
|
+
declare function reactive<T extends Record<string, any>>(target: T): T;
|
|
74
76
|
/** Check if a value is a Ref */
|
|
75
|
-
|
|
77
|
+
declare function isRef(value: any): value is Ref;
|
|
76
78
|
/** Unwrap a ref or return the value as-is */
|
|
77
|
-
|
|
79
|
+
declare function unref<T>(value: Ref<T> | T): T;
|
|
78
80
|
/** Convert all properties of an object to refs */
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
};
|
|
82
|
-
|
|
83
|
-
//# sourceMappingURL=reactivity.d.ts.map
|
|
81
|
+
declare function toRefs<T extends Record<string, any>>(obj: T): { [K in keyof T]: Ref<T[K]> };
|
|
82
|
+
//#endregion
|
|
83
|
+
export { isRef as a, toRefs as c, computed as i, unref as l, Ref as n, reactive as o, WatchOptions as r, ref as s, ComputedRef as t, watch as u };
|
|
84
|
+
//# sourceMappingURL=reactivity-CMAQh0gi.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"reactivity-CMAQh0gi.d.mts","names":[],"sources":["../src/core/reactivity.ts"],"mappings":";;;AAuCA;;;;UAAiB,GAAA;EACf,KAAA,EAAO,CAAA;EAEgC;EAAvC,SAAA,CAAU,EAAA,GAAK,QAAA,EAAU,CAAA,EAAG,QAAA,EAAU,CAAA;AAAA;;;;;;;;;;;iBAaxB,GAAA,GAAA,CAAO,YAAA,EAAc,CAAA,GAAI,GAAA,CAAI,CAAA;AAAA,UA2B5B,WAAA;EAAA,SACN,KAAA,EAAO,CAAA;AAAA;;;;;;;;;;;;AADlB;iBAgBgB,QAAA,GAAA,CAAY,MAAA,QAAc,CAAA,GAAI,WAAA,CAAY,CAAA;AAAA,UA+BzC,YAAA;EA9CE;EAgDjB,SAAA;AAAA;AAAA,KAGG,WAAA,MAAiB,GAAA,CAAI,CAAA,IAAK,WAAA,CAAY,CAAA,WAAY,CAAA;;;AApCvD;;;;;;;;;;;;iBAoDgB,KAAA,GAAA,CACd,MAAA,EAAQ,WAAA,CAAY,CAAA,GACpB,QAAA,GAAW,QAAA,EAAU,CAAA,EAAG,QAAA,EAAU,CAAA,WAClC,OAAA,GAAU,YAAA;;;AAxBZ;;;;;AAGC;;;;;;;;iBAwEe,QAAA,WAAmB,MAAA,cAAA,CAAqB,MAAA,EAAQ,CAAA,GAAI,CAAA;;iBA0BpD,KAAA,CAAM,KAAA,QAAa,KAAA,IAAS,GAAA;;iBAK5B,KAAA,GAAA,CAAS,KAAA,EAAO,GAAA,CAAI,CAAA,IAAK,CAAA,GAAI,CAAA;;iBAK7B,MAAA,WAAiB,MAAA,cAAA,CAAqB,GAAA,EAAK,CAAA,iBAAkB,CAAA,GAAI,GAAA,CAAI,CAAA,CAAE,CAAA"}
|