@forinda/kickjs 5.2.0 → 5.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/application-mir5CSWO.mjs +12 -0
- package/dist/{application-Bw87drVl.mjs.map → application-mir5CSWO.mjs.map} +1 -1
- package/dist/bootstrap-B7j_-dOg.mjs +12 -0
- package/dist/{bootstrap-CsQ7LE-W.mjs.map → bootstrap-B7j_-dOg.mjs.map} +1 -1
- package/dist/config/index.d.mts +1 -1
- package/dist/config/index.mjs +2 -4
- package/dist/config-Dk5RVTnD.mjs +12 -0
- package/dist/{config-DKRN5fqC.mjs.map → config-Dk5RVTnD.mjs.map} +1 -1
- package/dist/container-DArhTDQQ.mjs +12 -0
- package/dist/{container-C0FlgLNH.mjs.map → container-DArhTDQQ.mjs.map} +1 -1
- package/dist/{context-Ymvv-85x.d.mts → context-BAdAV-zO.d.mts} +48 -11
- package/dist/context-BAdAV-zO.d.mts.map +1 -0
- package/dist/context-CIoXqpAX.mjs +12 -0
- package/dist/context-CIoXqpAX.mjs.map +1 -0
- package/dist/core/adapter.mjs +2 -2
- package/dist/core/app-module.mjs +2 -2
- package/dist/core/cache.mjs +2 -103
- package/dist/core/cache.mjs.map +1 -1
- package/dist/core/container.mjs +2 -3
- package/dist/core/cron.mjs +2 -32
- package/dist/core/cron.mjs.map +1 -1
- package/dist/core/decorators.d.mts +2 -2
- package/dist/core/decorators.mjs +2 -241
- package/dist/core/decorators.mjs.map +1 -1
- package/dist/core/errors.mjs +2 -110
- package/dist/core/errors.mjs.map +1 -1
- package/dist/core/interfaces.mjs +2 -53
- package/dist/core/interfaces.mjs.map +1 -1
- package/dist/core/logger.mjs +2 -207
- package/dist/core/logger.mjs.map +1 -1
- package/dist/core/path.mjs +2 -35
- package/dist/core/path.mjs.map +1 -1
- package/dist/core/plugin.mjs +2 -2
- package/dist/core/reactivity.mjs +2 -179
- package/dist/core/reactivity.mjs.map +1 -1
- package/dist/core-BQZyB8Wv.mjs +12 -0
- package/dist/{core-K0J8AH_4.mjs.map → core-BQZyB8Wv.mjs.map} +1 -1
- package/dist/{decorators-CRmHuzxz.d.mts → decorators-J5mC7D-6.d.mts} +44 -4
- package/dist/{decorators-CRmHuzxz.d.mts.map → decorators-J5mC7D-6.d.mts.map} +1 -1
- package/dist/env-BL0xOTyi.mjs +12 -0
- package/dist/{env-CDMCT10_.mjs.map → env-BL0xOTyi.mjs.map} +1 -1
- package/dist/http/application.mjs +2 -3
- package/dist/http/bootstrap.mjs +2 -3
- package/dist/http/context.d.mts +2 -2
- package/dist/http/context.mjs +2 -3
- package/dist/http/middleware/cors.mjs +2 -73
- package/dist/http/middleware/cors.mjs.map +1 -1
- package/dist/http/middleware/csrf.mjs +2 -62
- package/dist/http/middleware/csrf.mjs.map +1 -1
- package/dist/http/middleware/error-handler.mjs +2 -54
- package/dist/http/middleware/error-handler.mjs.map +1 -1
- package/dist/http/middleware/helmet.mjs +2 -41
- package/dist/http/middleware/helmet.mjs.map +1 -1
- package/dist/http/middleware/rate-limit.mjs +2 -91
- package/dist/http/middleware/rate-limit.mjs.map +1 -1
- package/dist/http/middleware/request-id.mjs +2 -25
- package/dist/http/middleware/request-id.mjs.map +1 -1
- package/dist/http/middleware/request-logger.mjs +2 -39
- package/dist/http/middleware/request-logger.mjs.map +1 -1
- package/dist/http/middleware/session.mjs +2 -167
- package/dist/http/middleware/session.mjs.map +1 -1
- package/dist/http/middleware/spa.mjs +2 -98
- package/dist/http/middleware/spa.mjs.map +1 -1
- package/dist/http/middleware/upload.d.mts +1 -1
- package/dist/http/middleware/upload.mjs +2 -181
- package/dist/http/middleware/upload.mjs.map +1 -1
- package/dist/http/middleware/validate.mjs +2 -68
- package/dist/http/middleware/validate.mjs.map +1 -1
- package/dist/http/middleware/views.d.mts +1 -1
- package/dist/http/middleware/views.mjs +2 -56
- package/dist/http/middleware/views.mjs.map +1 -1
- package/dist/http/query/index.mjs +2 -3
- package/dist/http/router-builder.mjs +2 -105
- package/dist/http/router-builder.mjs.map +1 -1
- package/dist/{index-DhNglXyS.d.mts → index-BbtF8kIr.d.mts} +2 -2
- package/dist/{index-DhNglXyS.d.mts.map → index-BbtF8kIr.d.mts.map} +1 -1
- package/dist/index.d.mts +6 -6
- package/dist/index.mjs +2 -171
- package/dist/index.mjs.map +1 -1
- package/dist/metadata-Dn6kNT82.mjs +12 -0
- package/dist/{metadata-DPLdmj1w.mjs.map → metadata-Dn6kNT82.mjs.map} +1 -1
- package/dist/query-B7n5isk_.mjs +12 -0
- package/dist/{query-CD0AMqxx.mjs.map → query-B7n5isk_.mjs.map} +1 -1
- package/dist/{upload-BM9uyR6Y.d.mts → upload-tGMrlhEB.d.mts} +2 -2
- package/dist/{upload-BM9uyR6Y.d.mts.map → upload-tGMrlhEB.d.mts.map} +1 -1
- package/dist/{views-DkNp9JJs.d.mts → views-oKRSw0Op.d.mts} +2 -2
- package/dist/{views-DkNp9JJs.d.mts.map → views-oKRSw0Op.d.mts.map} +1 -1
- package/package.json +1 -1
- package/dist/application-Bw87drVl.mjs +0 -574
- package/dist/bootstrap-CsQ7LE-W.mjs +0 -195
- package/dist/config-DKRN5fqC.mjs +0 -135
- package/dist/container-C0FlgLNH.mjs +0 -897
- package/dist/context-CDFiXWcV.mjs +0 -348
- package/dist/context-CDFiXWcV.mjs.map +0 -1
- package/dist/context-Ymvv-85x.d.mts.map +0 -1
- package/dist/core-K0J8AH_4.mjs +0 -820
- package/dist/env-CDMCT10_.mjs +0 -137
- package/dist/metadata-DPLdmj1w.mjs +0 -76
- package/dist/query-CD0AMqxx.mjs +0 -164
package/dist/env-CDMCT10_.mjs
DELETED
|
@@ -1,137 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @forinda/kickjs v5.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 { h as __require, t as Container } from "./container-C0FlgLNH.mjs";
|
|
12
|
-
import { z } from "zod";
|
|
13
|
-
//#region src/config/env.ts
|
|
14
|
-
/**
|
|
15
|
-
* Lazily load `.env` via dotenv if it is installed in the consumer app.
|
|
16
|
-
* `dotenv` is an **optional peer dependency** of `@forinda/kickjs` —
|
|
17
|
-
* apps that want `.env` file support install it themselves (the CLI
|
|
18
|
-
* generators add it to every scaffolded `package.json`). Apps that
|
|
19
|
-
* inject env via the shell, Docker, or a secret manager can skip it
|
|
20
|
-
* entirely and `process.env` is read as-is.
|
|
21
|
-
*
|
|
22
|
-
* We call `dotenv.config()` directly rather than `require('dotenv/config')`
|
|
23
|
-
* so that a re-evaluation of this module (e.g. Vite SSR full-reload after
|
|
24
|
-
* editing `.env`) can re-read the file. `dotenv/config` is a side-effect
|
|
25
|
-
* shim that CJS caches aggressively, so the second `require` is a no-op
|
|
26
|
-
* and new keys never reach `process.env` — the root cause of the
|
|
27
|
-
* "DATABASE_URL undefined until restart" bug on Windows dev.
|
|
28
|
-
*/
|
|
29
|
-
function tryLoadDotenv() {
|
|
30
|
-
try {
|
|
31
|
-
__require("dotenv").config({
|
|
32
|
-
override: false,
|
|
33
|
-
quiet: true
|
|
34
|
-
});
|
|
35
|
-
} catch {}
|
|
36
|
-
}
|
|
37
|
-
tryLoadDotenv();
|
|
38
|
-
/**
|
|
39
|
-
* Base environment schema with common server variables.
|
|
40
|
-
* Users extend this with their own application-specific vars.
|
|
41
|
-
*/
|
|
42
|
-
const baseEnvSchema = z.object({
|
|
43
|
-
PORT: z.coerce.number().default(3e3),
|
|
44
|
-
NODE_ENV: z.enum([
|
|
45
|
-
"development",
|
|
46
|
-
"production",
|
|
47
|
-
"test"
|
|
48
|
-
]).default("development"),
|
|
49
|
-
LOG_LEVEL: z.string().default("info")
|
|
50
|
-
});
|
|
51
|
-
/** Cached env config to avoid re-parsing — keyed by schema reference */
|
|
52
|
-
let cachedEnv = null;
|
|
53
|
-
let cachedSchema = null;
|
|
54
|
-
/**
|
|
55
|
-
* Define a custom env schema. The base schema (`PORT`, `NODE_ENV`,
|
|
56
|
-
* `LOG_LEVEL`) is always merged in, so users never need to remember to
|
|
57
|
-
* extend it themselves — both styles below produce the same result and
|
|
58
|
-
* both surface the base keys in `KickEnv`.
|
|
59
|
-
*
|
|
60
|
-
* Returns a Zod schema that validates `process.env`.
|
|
61
|
-
*
|
|
62
|
-
* @example
|
|
63
|
-
* ```ts
|
|
64
|
-
* // Style A — return a fresh object; base fields are merged automatically
|
|
65
|
-
* export default defineEnv(() =>
|
|
66
|
-
* z.object({
|
|
67
|
-
* DATABASE_URL: z.string().url(),
|
|
68
|
-
* JWT_SECRET: z.string().min(32),
|
|
69
|
-
* })
|
|
70
|
-
* )
|
|
71
|
-
*
|
|
72
|
-
* // Style B — explicitly extend `base` (still works, identical result)
|
|
73
|
-
* export default defineEnv((base) =>
|
|
74
|
-
* base.extend({
|
|
75
|
-
* DATABASE_URL: z.string().url(),
|
|
76
|
-
* })
|
|
77
|
-
* )
|
|
78
|
-
* ```
|
|
79
|
-
*
|
|
80
|
-
* User-defined keys override base keys when they collide, so a project
|
|
81
|
-
* can re-type `PORT` or tighten `NODE_ENV` without losing the rest of
|
|
82
|
-
* the base shape.
|
|
83
|
-
*/
|
|
84
|
-
function defineEnv(extend) {
|
|
85
|
-
const userSchema = extend(baseEnvSchema);
|
|
86
|
-
return baseEnvSchema.extend(userSchema.shape);
|
|
87
|
-
}
|
|
88
|
-
function loadEnv(schema) {
|
|
89
|
-
const s = schema ?? cachedSchema ?? baseEnvSchema;
|
|
90
|
-
if (cachedEnv && cachedSchema === s) return cachedEnv;
|
|
91
|
-
cachedSchema = s;
|
|
92
|
-
cachedEnv = s.parse(process.env);
|
|
93
|
-
Container._envResolver = (key) => cachedEnv?.[key];
|
|
94
|
-
return cachedEnv;
|
|
95
|
-
}
|
|
96
|
-
function getEnv(key, schema) {
|
|
97
|
-
return (schema ? loadEnv(schema) : loadEnv())[key];
|
|
98
|
-
}
|
|
99
|
-
/**
|
|
100
|
-
* Reload env from `process.env`. Re-reads `.env` via dotenv (if
|
|
101
|
-
* installed), then re-parses the result against the **same** schema
|
|
102
|
-
* the project registered at startup. Called during HMR rebuild and by
|
|
103
|
-
* `envWatchPlugin` to pick up `.env` file changes mid-session.
|
|
104
|
-
*
|
|
105
|
-
* Crucially, this preserves the registered schema. Wiping it would
|
|
106
|
-
* silently downgrade `ConfigService` and `@Value()` back to the base
|
|
107
|
-
* schema on the next read, so every user-defined key would start
|
|
108
|
-
* resolving as `undefined` after the first `.env` save — which was the
|
|
109
|
-
* original "config disappears in dev" bug.
|
|
110
|
-
*
|
|
111
|
-
* If you need to fully forget the schema (e.g. tests that swap schemas
|
|
112
|
-
* between cases), call {@link resetEnvCache} instead.
|
|
113
|
-
*/
|
|
114
|
-
function reloadEnv() {
|
|
115
|
-
try {
|
|
116
|
-
__require("dotenv").config({
|
|
117
|
-
override: true,
|
|
118
|
-
quiet: true
|
|
119
|
-
});
|
|
120
|
-
} catch {}
|
|
121
|
-
cachedEnv = null;
|
|
122
|
-
if (cachedSchema) loadEnv(cachedSchema);
|
|
123
|
-
}
|
|
124
|
-
/**
|
|
125
|
-
* Fully reset the env cache, including the registered schema. Use this
|
|
126
|
-
* in tests that need to swap schemas between cases — `reloadEnv()`
|
|
127
|
-
* deliberately preserves the schema to avoid the "user keys vanish on
|
|
128
|
-
* `.env` reload" footgun.
|
|
129
|
-
*/
|
|
130
|
-
function resetEnvCache() {
|
|
131
|
-
cachedEnv = null;
|
|
132
|
-
cachedSchema = null;
|
|
133
|
-
}
|
|
134
|
-
//#endregion
|
|
135
|
-
export { reloadEnv as a, loadEnv as i, defineEnv as n, resetEnvCache as o, getEnv as r, baseEnvSchema as t };
|
|
136
|
-
|
|
137
|
-
//# sourceMappingURL=env-CDMCT10_.mjs.map
|
|
@@ -1,76 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @forinda/kickjs v5.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-DPLdmj1w.mjs.map
|
package/dist/query-CD0AMqxx.mjs
DELETED
|
@@ -1,164 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @forinda/kickjs v5.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-CD0AMqxx.mjs.map
|