@forinda/kickjs 5.3.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.
Files changed (90) hide show
  1. package/dist/application-mir5CSWO.mjs +12 -0
  2. package/dist/{application-Cna_2gex.mjs.map → application-mir5CSWO.mjs.map} +1 -1
  3. package/dist/bootstrap-B7j_-dOg.mjs +12 -0
  4. package/dist/{bootstrap-kPcmbbWe.mjs.map → bootstrap-B7j_-dOg.mjs.map} +1 -1
  5. package/dist/config/index.mjs +2 -4
  6. package/dist/config-Dk5RVTnD.mjs +12 -0
  7. package/dist/{config-DxEREQmR.mjs.map → config-Dk5RVTnD.mjs.map} +1 -1
  8. package/dist/container-DArhTDQQ.mjs +12 -0
  9. package/dist/{container-SMnB5yeT.mjs.map → container-DArhTDQQ.mjs.map} +1 -1
  10. package/dist/{context-Ymvv-85x.d.mts → context-BAdAV-zO.d.mts} +48 -11
  11. package/dist/context-BAdAV-zO.d.mts.map +1 -0
  12. package/dist/context-CIoXqpAX.mjs +12 -0
  13. package/dist/context-CIoXqpAX.mjs.map +1 -0
  14. package/dist/core/adapter.mjs +2 -2
  15. package/dist/core/app-module.mjs +2 -2
  16. package/dist/core/cache.mjs +2 -103
  17. package/dist/core/cache.mjs.map +1 -1
  18. package/dist/core/container.mjs +2 -3
  19. package/dist/core/cron.mjs +2 -32
  20. package/dist/core/cron.mjs.map +1 -1
  21. package/dist/core/decorators.mjs +2 -285
  22. package/dist/core/decorators.mjs.map +1 -1
  23. package/dist/core/errors.mjs +2 -110
  24. package/dist/core/errors.mjs.map +1 -1
  25. package/dist/core/interfaces.mjs +2 -53
  26. package/dist/core/interfaces.mjs.map +1 -1
  27. package/dist/core/logger.mjs +2 -207
  28. package/dist/core/logger.mjs.map +1 -1
  29. package/dist/core/path.mjs +2 -35
  30. package/dist/core/path.mjs.map +1 -1
  31. package/dist/core/plugin.mjs +2 -2
  32. package/dist/core/reactivity.mjs +2 -179
  33. package/dist/core/reactivity.mjs.map +1 -1
  34. package/dist/core-BQZyB8Wv.mjs +12 -0
  35. package/dist/{core--a4XflX7.mjs.map → core-BQZyB8Wv.mjs.map} +1 -1
  36. package/dist/env-BL0xOTyi.mjs +12 -0
  37. package/dist/{env-C4Yr6nN8.mjs.map → env-BL0xOTyi.mjs.map} +1 -1
  38. package/dist/http/application.mjs +2 -3
  39. package/dist/http/bootstrap.mjs +2 -3
  40. package/dist/http/context.d.mts +2 -2
  41. package/dist/http/context.mjs +2 -3
  42. package/dist/http/middleware/cors.mjs +2 -73
  43. package/dist/http/middleware/cors.mjs.map +1 -1
  44. package/dist/http/middleware/csrf.mjs +2 -62
  45. package/dist/http/middleware/csrf.mjs.map +1 -1
  46. package/dist/http/middleware/error-handler.mjs +2 -54
  47. package/dist/http/middleware/error-handler.mjs.map +1 -1
  48. package/dist/http/middleware/helmet.mjs +2 -41
  49. package/dist/http/middleware/helmet.mjs.map +1 -1
  50. package/dist/http/middleware/rate-limit.mjs +2 -91
  51. package/dist/http/middleware/rate-limit.mjs.map +1 -1
  52. package/dist/http/middleware/request-id.mjs +2 -25
  53. package/dist/http/middleware/request-id.mjs.map +1 -1
  54. package/dist/http/middleware/request-logger.mjs +2 -39
  55. package/dist/http/middleware/request-logger.mjs.map +1 -1
  56. package/dist/http/middleware/session.mjs +2 -167
  57. package/dist/http/middleware/session.mjs.map +1 -1
  58. package/dist/http/middleware/spa.mjs +2 -98
  59. package/dist/http/middleware/spa.mjs.map +1 -1
  60. package/dist/http/middleware/upload.mjs +2 -181
  61. package/dist/http/middleware/upload.mjs.map +1 -1
  62. package/dist/http/middleware/validate.mjs +2 -68
  63. package/dist/http/middleware/validate.mjs.map +1 -1
  64. package/dist/http/middleware/views.d.mts +1 -1
  65. package/dist/http/middleware/views.mjs +2 -56
  66. package/dist/http/middleware/views.mjs.map +1 -1
  67. package/dist/http/query/index.mjs +2 -3
  68. package/dist/http/router-builder.mjs +2 -105
  69. package/dist/http/router-builder.mjs.map +1 -1
  70. package/dist/index.d.mts +3 -3
  71. package/dist/index.mjs +2 -171
  72. package/dist/index.mjs.map +1 -1
  73. package/dist/metadata-Dn6kNT82.mjs +12 -0
  74. package/dist/{metadata-CdYaU-XM.mjs.map → metadata-Dn6kNT82.mjs.map} +1 -1
  75. package/dist/query-B7n5isk_.mjs +12 -0
  76. package/dist/{query-nAYUgagU.mjs.map → query-B7n5isk_.mjs.map} +1 -1
  77. package/dist/{views-DkNp9JJs.d.mts → views-oKRSw0Op.d.mts} +2 -2
  78. package/dist/{views-DkNp9JJs.d.mts.map → views-oKRSw0Op.d.mts.map} +1 -1
  79. package/package.json +1 -1
  80. package/dist/application-Cna_2gex.mjs +0 -574
  81. package/dist/bootstrap-kPcmbbWe.mjs +0 -195
  82. package/dist/config-DxEREQmR.mjs +0 -135
  83. package/dist/container-SMnB5yeT.mjs +0 -897
  84. package/dist/context-B0B3WQft.mjs +0 -348
  85. package/dist/context-B0B3WQft.mjs.map +0 -1
  86. package/dist/context-Ymvv-85x.d.mts.map +0 -1
  87. package/dist/core--a4XflX7.mjs +0 -820
  88. package/dist/env-C4Yr6nN8.mjs +0 -137
  89. package/dist/metadata-CdYaU-XM.mjs +0 -76
  90. package/dist/query-nAYUgagU.mjs +0 -164
@@ -1,137 +0,0 @@
1
- /**
2
- * @forinda/kickjs v5.3.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-SMnB5yeT.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-C4Yr6nN8.mjs.map
@@ -1,76 +0,0 @@
1
- /**
2
- * @forinda/kickjs v5.3.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-CdYaU-XM.mjs.map
@@ -1,164 +0,0 @@
1
- /**
2
- * @forinda/kickjs v5.3.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-nAYUgagU.mjs.map