@forinda/kickjs 3.0.6 → 3.0.7
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-BM6D-XfE.mjs → application-BwLUFfQy.mjs} +5 -5
- package/dist/{application-BM6D-XfE.mjs.map → application-BwLUFfQy.mjs.map} +1 -1
- package/dist/{bootstrap-CJyg9CPG.mjs → bootstrap-DV13o-cB.mjs} +6 -6
- package/dist/{bootstrap-CJyg9CPG.mjs.map → bootstrap-DV13o-cB.mjs.map} +1 -1
- package/dist/{chunk-BTWanSMO.mjs → chunk-DXYGQY5w.mjs} +1 -1
- package/dist/config/index.mjs +3 -3
- package/dist/{config-C1rdn7CK.mjs → config-BizkbnKi.mjs} +3 -3
- package/dist/{config-C1rdn7CK.mjs.map → config-BizkbnKi.mjs.map} +1 -1
- package/dist/{container-BtS6YTUQ.mjs → container-DrJQ6Zgx.mjs} +3 -3
- package/dist/{container-BtS6YTUQ.mjs.map → container-DrJQ6Zgx.mjs.map} +1 -1
- package/dist/core/adapter.mjs +1 -1
- package/dist/core/app-module.mjs +1 -1
- package/dist/core/cache.mjs +1 -1
- package/dist/core/container.mjs +2 -2
- package/dist/core/cron.mjs +2 -2
- package/dist/core/decorators.mjs +3 -3
- package/dist/core/errors.mjs +1 -1
- package/dist/core/interfaces.mjs +1 -1
- package/dist/core/logger.mjs +1 -1
- package/dist/core/path.mjs +1 -1
- package/dist/core/plugin.mjs +1 -1
- package/dist/core/reactivity.mjs +1 -1
- package/dist/{core-BpjG7LwH.mjs → core-DEFm-pvP.mjs} +4 -4
- package/dist/{core-BpjG7LwH.mjs.map → core-DEFm-pvP.mjs.map} +1 -1
- package/dist/{env-BCTYaGL7.mjs → env-BDN9v7Yx.mjs} +4 -4
- package/dist/{env-BCTYaGL7.mjs.map → env-BDN9v7Yx.mjs.map} +1 -1
- package/dist/http/application.mjs +2 -2
- package/dist/http/bootstrap.mjs +2 -2
- package/dist/http/context.mjs +2 -2
- package/dist/http/middleware/cors.mjs +1 -1
- package/dist/http/middleware/csrf.mjs +1 -1
- package/dist/http/middleware/error-handler.mjs +2 -2
- package/dist/http/middleware/helmet.mjs +1 -1
- package/dist/http/middleware/rate-limit.mjs +1 -1
- package/dist/http/middleware/request-id.mjs +1 -1
- package/dist/http/middleware/request-logger.mjs +2 -2
- package/dist/http/middleware/session.d.mts +5 -2
- package/dist/http/middleware/session.d.mts.map +1 -1
- package/dist/http/middleware/session.mjs +29 -4
- package/dist/http/middleware/session.mjs.map +1 -1
- package/dist/http/middleware/spa.mjs +3 -3
- package/dist/http/middleware/upload.mjs +1 -1
- package/dist/http/middleware/validate.mjs +1 -1
- package/dist/http/middleware/views.mjs +2 -2
- package/dist/http/query/index.mjs +2 -2
- package/dist/http/router-builder.mjs +4 -4
- package/dist/index.mjs +9 -9
- package/dist/{metadata-BqprlGid.mjs → metadata-CGOLNICI.mjs} +2 -2
- package/dist/{metadata-BqprlGid.mjs.map → metadata-CGOLNICI.mjs.map} +1 -1
- package/dist/{query-CwDaqZ_O.mjs → query-Baxld1NB.mjs} +2 -2
- package/dist/{query-CwDaqZ_O.mjs.map → query-Baxld1NB.mjs.map} +1 -1
- package/package.json +1 -1
package/dist/core/adapter.mjs
CHANGED
package/dist/core/app-module.mjs
CHANGED
package/dist/core/cache.mjs
CHANGED
package/dist/core/container.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v3.0.
|
|
2
|
+
* @forinda/kickjs v3.0.7
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,5 +8,5 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import { n as tokenName, t as Container } from "../container-
|
|
11
|
+
import { n as tokenName, t as Container } from "../container-DrJQ6Zgx.mjs";
|
|
12
12
|
export { Container, tokenName };
|
package/dist/core/cron.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v3.0.
|
|
2
|
+
* @forinda/kickjs v3.0.7
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import { c as pushClassMeta, t as getClassMeta } from "../metadata-
|
|
11
|
+
import { c as pushClassMeta, t as getClassMeta } from "../metadata-CGOLNICI.mjs";
|
|
12
12
|
//#region src/core/cron.ts
|
|
13
13
|
const CRON_META = Symbol("kick:cron");
|
|
14
14
|
/**
|
package/dist/core/decorators.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v3.0.
|
|
2
|
+
* @forinda/kickjs v3.0.7
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -9,8 +9,8 @@
|
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
11
|
import { METADATA, Scope } from "./interfaces.mjs";
|
|
12
|
-
import { c as pushClassMeta, d as setInMetaMap, f as setInMetaRecord, l as pushMethodMeta, p as setMethodMeta, u as setClassMeta } from "../metadata-
|
|
13
|
-
import { t as Container } from "../container-
|
|
12
|
+
import { c as pushClassMeta, d as setInMetaMap, f as setInMetaRecord, l as pushMethodMeta, p as setMethodMeta, u as setClassMeta } from "../metadata-CGOLNICI.mjs";
|
|
13
|
+
import { t as Container } from "../container-DrJQ6Zgx.mjs";
|
|
14
14
|
import "reflect-metadata";
|
|
15
15
|
//#region src/core/decorators.ts
|
|
16
16
|
const pendingRegistrations = [];
|
package/dist/core/errors.mjs
CHANGED
package/dist/core/interfaces.mjs
CHANGED
package/dist/core/logger.mjs
CHANGED
package/dist/core/path.mjs
CHANGED
package/dist/core/plugin.mjs
CHANGED
package/dist/core/reactivity.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v3.0.
|
|
2
|
+
* @forinda/kickjs v3.0.7
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -10,8 +10,8 @@
|
|
|
10
10
|
*/
|
|
11
11
|
import "./core/interfaces.mjs";
|
|
12
12
|
import "./core/logger.mjs";
|
|
13
|
-
import "./metadata-
|
|
14
|
-
import "./container-
|
|
13
|
+
import "./metadata-CGOLNICI.mjs";
|
|
14
|
+
import "./container-DrJQ6Zgx.mjs";
|
|
15
15
|
import "./core/decorators.mjs";
|
|
16
16
|
import "./core/cron.mjs";
|
|
17
17
|
import "./core/cache.mjs";
|
|
@@ -118,4 +118,4 @@ var CircuitBreaker = class {
|
|
|
118
118
|
//#endregion
|
|
119
119
|
export { CircuitOpenError as n, CircuitBreaker as t };
|
|
120
120
|
|
|
121
|
-
//# sourceMappingURL=core-
|
|
121
|
+
//# sourceMappingURL=core-DEFm-pvP.mjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"core-
|
|
1
|
+
{"version":3,"file":"core-DEFm-pvP.mjs","names":[],"sources":["../src/core/circuit-breaker.ts"],"sourcesContent":["/**\n * Circuit Breaker pattern for external service calls.\n *\n * Protects your application from cascading failures when downstream\n * services are unhealthy by short-circuiting requests after a\n * configurable failure threshold.\n *\n * @example\n * ```ts\n * const breaker = new CircuitBreaker('payment-api', {\n * failureThreshold: 5,\n * resetTimeout: 30_000,\n * })\n *\n * const result = await breaker.execute(() => fetch('https://payment.example.com/charge'))\n * ```\n */\n\nexport type CircuitBreakerState = 'closed' | 'open' | 'half_open'\n\nexport interface CircuitBreakerOptions {\n /** Number of consecutive failures before the circuit opens. */\n failureThreshold: number\n /** Milliseconds to wait before transitioning from OPEN to HALF_OPEN. */\n resetTimeout: number\n /** Max requests allowed in HALF_OPEN state before deciding (default 1). */\n halfOpenMax?: number\n}\n\nexport interface CircuitBreakerStats {\n failures: number\n successes: number\n state: CircuitBreakerState\n lastFailure?: Date\n}\n\n/**\n * Error thrown when the circuit is open and calls are being rejected.\n */\nexport class CircuitOpenError extends Error {\n constructor(public readonly breakerName: string) {\n super(`Circuit breaker \"${breakerName}\" is open — request rejected`)\n this.name = 'CircuitOpenError'\n }\n}\n\nexport class CircuitBreaker {\n private state: CircuitBreakerState = 'closed'\n private failures = 0\n private successes = 0\n private halfOpenAttempts = 0\n private lastFailure?: Date\n private openedAt?: number\n\n private readonly failureThreshold: number\n private readonly resetTimeout: number\n private readonly halfOpenMax: number\n\n constructor(\n public readonly name: string,\n options: CircuitBreakerOptions,\n ) {\n this.failureThreshold = options.failureThreshold\n this.resetTimeout = options.resetTimeout\n this.halfOpenMax = options.halfOpenMax ?? 1\n }\n\n /**\n * Execute an async function through the circuit breaker.\n * Throws `CircuitOpenError` if the circuit is open.\n */\n async execute<T>(fn: () => Promise<T>): Promise<T> {\n this.maybeTransitionToHalfOpen()\n\n if (this.state === 'open') {\n throw new CircuitOpenError(this.name)\n }\n\n if (this.state === 'half_open' && this.halfOpenAttempts >= this.halfOpenMax) {\n throw new CircuitOpenError(this.name)\n }\n\n if (this.state === 'half_open') {\n this.halfOpenAttempts++\n }\n\n try {\n const result = await fn()\n this.onSuccess()\n return result\n } catch (error) {\n this.onFailure()\n throw error\n }\n }\n\n /** Returns the current circuit state. */\n getState(): CircuitBreakerState {\n this.maybeTransitionToHalfOpen()\n return this.state\n }\n\n /** Returns current statistics. */\n getStats(): CircuitBreakerStats {\n this.maybeTransitionToHalfOpen()\n return {\n failures: this.failures,\n successes: this.successes,\n state: this.state,\n ...(this.lastFailure ? { lastFailure: this.lastFailure } : {}),\n }\n }\n\n /** Manually reset the circuit breaker to CLOSED state. */\n reset(): void {\n this.state = 'closed'\n this.failures = 0\n this.successes = 0\n this.halfOpenAttempts = 0\n this.lastFailure = undefined\n this.openedAt = undefined\n }\n\n private onSuccess(): void {\n if (this.state === 'half_open') {\n // Recovery confirmed — close the circuit\n this.state = 'closed'\n this.failures = 0\n this.halfOpenAttempts = 0\n this.openedAt = undefined\n }\n this.successes++\n }\n\n private onFailure(): void {\n this.failures++\n this.lastFailure = new Date()\n\n if (this.state === 'half_open') {\n // Recovery failed — re-open\n this.state = 'open'\n this.openedAt = Date.now()\n this.halfOpenAttempts = 0\n } else if (this.state === 'closed' && this.failures >= this.failureThreshold) {\n this.state = 'open'\n this.openedAt = Date.now()\n }\n }\n\n private maybeTransitionToHalfOpen(): void {\n if (this.state === 'open' && this.openedAt != null) {\n if (Date.now() - this.openedAt >= this.resetTimeout) {\n this.state = 'half_open'\n this.halfOpenAttempts = 0\n }\n }\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAuCA,IAAa,mBAAb,cAAsC,MAAM;CAC1C,YAAY,aAAqC;AAC/C,QAAM,oBAAoB,YAAY,8BAA8B;AAD1C,OAAA,cAAA;AAE1B,OAAK,OAAO;;;AAIhB,IAAa,iBAAb,MAA4B;CAC1B,QAAqC;CACrC,WAAmB;CACnB,YAAoB;CACpB,mBAA2B;CAC3B;CACA;CAEA;CACA;CACA;CAEA,YACE,MACA,SACA;AAFgB,OAAA,OAAA;AAGhB,OAAK,mBAAmB,QAAQ;AAChC,OAAK,eAAe,QAAQ;AAC5B,OAAK,cAAc,QAAQ,eAAe;;;;;;CAO5C,MAAM,QAAW,IAAkC;AACjD,OAAK,2BAA2B;AAEhC,MAAI,KAAK,UAAU,OACjB,OAAM,IAAI,iBAAiB,KAAK,KAAK;AAGvC,MAAI,KAAK,UAAU,eAAe,KAAK,oBAAoB,KAAK,YAC9D,OAAM,IAAI,iBAAiB,KAAK,KAAK;AAGvC,MAAI,KAAK,UAAU,YACjB,MAAK;AAGP,MAAI;GACF,MAAM,SAAS,MAAM,IAAI;AACzB,QAAK,WAAW;AAChB,UAAO;WACA,OAAO;AACd,QAAK,WAAW;AAChB,SAAM;;;;CAKV,WAAgC;AAC9B,OAAK,2BAA2B;AAChC,SAAO,KAAK;;;CAId,WAAgC;AAC9B,OAAK,2BAA2B;AAChC,SAAO;GACL,UAAU,KAAK;GACf,WAAW,KAAK;GAChB,OAAO,KAAK;GACZ,GAAI,KAAK,cAAc,EAAE,aAAa,KAAK,aAAa,GAAG,EAAE;GAC9D;;;CAIH,QAAc;AACZ,OAAK,QAAQ;AACb,OAAK,WAAW;AAChB,OAAK,YAAY;AACjB,OAAK,mBAAmB;AACxB,OAAK,cAAc,KAAA;AACnB,OAAK,WAAW,KAAA;;CAGlB,YAA0B;AACxB,MAAI,KAAK,UAAU,aAAa;AAE9B,QAAK,QAAQ;AACb,QAAK,WAAW;AAChB,QAAK,mBAAmB;AACxB,QAAK,WAAW,KAAA;;AAElB,OAAK;;CAGP,YAA0B;AACxB,OAAK;AACL,OAAK,8BAAc,IAAI,MAAM;AAE7B,MAAI,KAAK,UAAU,aAAa;AAE9B,QAAK,QAAQ;AACb,QAAK,WAAW,KAAK,KAAK;AAC1B,QAAK,mBAAmB;aACf,KAAK,UAAU,YAAY,KAAK,YAAY,KAAK,kBAAkB;AAC5E,QAAK,QAAQ;AACb,QAAK,WAAW,KAAK,KAAK;;;CAI9B,4BAA0C;AACxC,MAAI,KAAK,UAAU,UAAU,KAAK,YAAY;OACxC,KAAK,KAAK,GAAG,KAAK,YAAY,KAAK,cAAc;AACnD,SAAK,QAAQ;AACb,SAAK,mBAAmB"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v3.0.
|
|
2
|
+
* @forinda/kickjs v3.0.7
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,8 +8,8 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import { t as __require } from "./chunk-
|
|
12
|
-
import { t as Container } from "./container-
|
|
11
|
+
import { t as __require } from "./chunk-DXYGQY5w.mjs";
|
|
12
|
+
import { t as Container } from "./container-DrJQ6Zgx.mjs";
|
|
13
13
|
import { z } from "zod";
|
|
14
14
|
//#region src/config/env.ts
|
|
15
15
|
/**
|
|
@@ -129,4 +129,4 @@ function resetEnvCache() {
|
|
|
129
129
|
//#endregion
|
|
130
130
|
export { reloadEnv as a, loadEnv as i, defineEnv as n, resetEnvCache as o, getEnv as r, baseEnvSchema as t };
|
|
131
131
|
|
|
132
|
-
//# sourceMappingURL=env-
|
|
132
|
+
//# sourceMappingURL=env-BDN9v7Yx.mjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"env-
|
|
1
|
+
{"version":3,"file":"env-BDN9v7Yx.mjs","names":[],"sources":["../src/config/env.ts"],"sourcesContent":["import { z } from 'zod'\nimport { Container } from '../core/container'\nimport type { EnvKey } from '../core/decorators'\n\n/**\n * Lazily load `.env` via dotenv if it is installed in the consumer app.\n * `dotenv` is an **optional peer dependency** of `@forinda/kickjs` —\n * apps that want `.env` file support install it themselves (the CLI\n * generators add it to every scaffolded `package.json`). Apps that\n * inject env via the shell, Docker, or a secret manager can skip it\n * entirely and `process.env` is read as-is.\n *\n * We call `dotenv.config()` directly rather than `require('dotenv/config')`\n * so that a re-evaluation of this module (e.g. Vite SSR full-reload after\n * editing `.env`) can re-read the file. `dotenv/config` is a side-effect\n * shim that CJS caches aggressively, so the second `require` is a no-op\n * and new keys never reach `process.env` — the root cause of the\n * \"DATABASE_URL undefined until restart\" bug on Windows dev.\n */\nfunction tryLoadDotenv(): void {\n try {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n const dotenv = require('dotenv')\n dotenv.config({ override: false })\n } catch {\n // dotenv not installed — fall through, env vars must come from\n // the environment directly. This is a valid deployment style.\n }\n}\ntryLoadDotenv()\n\n/**\n * Base environment schema with common server variables.\n * Users extend this with their own application-specific vars.\n */\nexport const baseEnvSchema = z.object({\n // Server\n PORT: z.coerce.number().default(3000),\n NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),\n LOG_LEVEL: z.string().default('info'),\n})\n\n/** Cached env config to avoid re-parsing — keyed by schema reference */\nlet cachedEnv: any = null\nlet cachedSchema: any = null\n\n/**\n * Define a custom env schema. The base schema (`PORT`, `NODE_ENV`,\n * `LOG_LEVEL`) is always merged in, so users never need to remember to\n * extend it themselves — both styles below produce the same result and\n * both surface the base keys in `KickEnv`.\n *\n * Returns a Zod schema that validates `process.env`.\n *\n * @example\n * ```ts\n * // Style A — return a fresh object; base fields are merged automatically\n * export default defineEnv(() =>\n * z.object({\n * DATABASE_URL: z.string().url(),\n * JWT_SECRET: z.string().min(32),\n * })\n * )\n *\n * // Style B — explicitly extend `base` (still works, identical result)\n * export default defineEnv((base) =>\n * base.extend({\n * DATABASE_URL: z.string().url(),\n * })\n * )\n * ```\n *\n * User-defined keys override base keys when they collide, so a project\n * can re-type `PORT` or tighten `NODE_ENV` without losing the rest of\n * the base shape.\n */\nexport function defineEnv<T extends z.ZodRawShape>(\n extend: (base: typeof baseEnvSchema) => z.ZodObject<T>,\n): z.ZodObject<typeof baseEnvSchema.shape & T> {\n const userSchema = extend(baseEnvSchema)\n // Always merge the base in. `extend` lets the user's shape override\n // any colliding base keys, which preserves the escape hatch for\n // projects that want to re-type `PORT` etc.\n return baseEnvSchema.extend(userSchema.shape) as z.ZodObject<typeof baseEnvSchema.shape & T>\n}\n\n/**\n * Parse and validate `process.env` against a Zod schema. Caches result per schema.\n *\n * **No-arg behaviour is sticky.** The first time `loadEnv(schema)` is called\n * with an extended schema, the cache holds that schema. Subsequent\n * `loadEnv()` calls (no arg) will reuse the cached extended schema rather\n * than falling back to `baseEnvSchema`.\n *\n * Stickiness matters because `ConfigService` and the `@Value()` decorator\n * both read through the no-arg form internally. Without it, resolving\n * either of them after a `loadEnv(extendedSchema)` call would silently\n * downgrade the env to the base shape and drop every user-defined key.\n *\n * To force a re-parse with a different schema, pass the new schema explicitly.\n * To start fresh, call `resetEnvCache()` (full reset) or `reloadEnv()`\n * (re-parse against the same schema after a `.env` file change).\n *\n * **Typing:**\n * - With an explicit schema → returns `z.infer<typeof schema>`.\n * - With no schema and `KickEnv` populated by typegen → returns\n * `KickEnv` (the project-wide typed env shape).\n * - With no schema and `KickEnv` empty → returns the base `Env`.\n */\nexport function loadEnv<T extends z.ZodObject<any>>(schema: T): z.infer<T>\nexport function loadEnv(): [EnvKey] extends [never] ? Env : KickEnv\nexport function loadEnv<T extends z.ZodObject<any>>(schema?: T): any {\n // Sticky: when called with no arg, prefer the most recently cached\n // schema over re-parsing with the base schema.\n const s = schema ?? cachedSchema ?? baseEnvSchema\n // Re-parse if schema changed or no cache yet\n if (cachedEnv && cachedSchema === s) return cachedEnv\n cachedSchema = s\n cachedEnv = s.parse(process.env)\n\n // Register env resolver so @Value() reads validated values\n Container._envResolver = (key: string) => cachedEnv?.[key]\n\n return cachedEnv\n}\n\n/**\n * Get a single typed environment variable value.\n *\n * Three forms:\n * - **No-arg, KickEnv populated** (`kick typegen` has run) → key is\n * constrained to known `KickEnv` keys; return type inferred from\n * the schema.\n * - **With explicit schema** → key constrained to that schema's keys;\n * return type is `z.infer<typeof schema>[K]`.\n * - **No-arg, KickEnv empty** → loose `string` key, `any` return.\n *\n * @example\n * ```ts\n * // After `kick typegen` (KickEnv populated):\n * const port = getEnv('PORT') // typed as number\n * const url = getEnv('DATABASE_URL') // typed as string\n *\n * // With an inline schema (legacy / one-off):\n * const dbUrl = getEnv('DATABASE_URL', envSchema)\n * ```\n */\nexport function getEnv<K extends EnvKey>(key: K): KickEnv[K]\nexport function getEnv<T extends z.ZodObject<any>, K extends string & keyof z.infer<T>>(\n key: K,\n schema: T,\n): z.infer<T>[K]\nexport function getEnv(key: string, schema?: z.ZodObject<any>): any {\n const env = schema ? loadEnv(schema) : (loadEnv() as Record<string, any>)\n return env[key]\n}\n\n/**\n * Reload env from `process.env`. Re-reads `.env` via dotenv (if\n * installed), then re-parses the result against the **same** schema\n * the project registered at startup. Called during HMR rebuild and by\n * `envWatchPlugin` to pick up `.env` file changes mid-session.\n *\n * Crucially, this preserves the registered schema. Wiping it would\n * silently downgrade `ConfigService` and `@Value()` back to the base\n * schema on the next read, so every user-defined key would start\n * resolving as `undefined` after the first `.env` save — which was the\n * original \"config disappears in dev\" bug.\n *\n * If you need to fully forget the schema (e.g. tests that swap schemas\n * between cases), call {@link resetEnvCache} instead.\n */\nexport function reloadEnv(): void {\n // Re-read .env file into process.env if dotenv is installed.\n try {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n require('dotenv').config({ override: true })\n } catch {\n // dotenv not installed — nothing to reload, env comes from the\n // environment directly.\n }\n\n // Drop the parsed snapshot but keep the schema. Re-parse eagerly so\n // existing consumers (including ConfigService getters and @Value\n // resolvers that may already hold references to the env state) see\n // the new values on their very next read instead of having to\n // re-trigger any cache-population step.\n cachedEnv = null\n if (cachedSchema) {\n loadEnv(cachedSchema)\n }\n}\n\n/**\n * Fully reset the env cache, including the registered schema. Use this\n * in tests that need to swap schemas between cases — `reloadEnv()`\n * deliberately preserves the schema to avoid the \"user keys vanish on\n * `.env` reload\" footgun.\n */\nexport function resetEnvCache(): void {\n cachedEnv = null\n cachedSchema = null\n}\n\nexport type Env = z.infer<typeof baseEnvSchema>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmBA,SAAS,gBAAsB;AAC7B,KAAI;AAGF,YADuB,SAAS,CACzB,OAAO,EAAE,UAAU,OAAO,CAAC;SAC5B;;AAKV,eAAe;;;;;AAMf,MAAa,gBAAgB,EAAE,OAAO;CAEpC,MAAM,EAAE,OAAO,QAAQ,CAAC,QAAQ,IAAK;CACrC,UAAU,EAAE,KAAK;EAAC;EAAe;EAAc;EAAO,CAAC,CAAC,QAAQ,cAAc;CAC9E,WAAW,EAAE,QAAQ,CAAC,QAAQ,OAAO;CACtC,CAAC;;AAGF,IAAI,YAAiB;AACrB,IAAI,eAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCxB,SAAgB,UACd,QAC6C;CAC7C,MAAM,aAAa,OAAO,cAAc;AAIxC,QAAO,cAAc,OAAO,WAAW,MAAM;;AA4B/C,SAAgB,QAAoC,QAAiB;CAGnE,MAAM,IAAI,UAAU,gBAAgB;AAEpC,KAAI,aAAa,iBAAiB,EAAG,QAAO;AAC5C,gBAAe;AACf,aAAY,EAAE,MAAM,QAAQ,IAAI;AAGhC,WAAU,gBAAgB,QAAgB,YAAY;AAEtD,QAAO;;AA6BT,SAAgB,OAAO,KAAa,QAAgC;AAElE,SADY,SAAS,QAAQ,OAAO,GAAI,SAAS,EACtC;;;;;;;;;;;;;;;;;AAkBb,SAAgB,YAAkB;AAEhC,KAAI;AAEF,YAAQ,SAAS,CAAC,OAAO,EAAE,UAAU,MAAM,CAAC;SACtC;AAUR,aAAY;AACZ,KAAI,aACF,SAAQ,aAAa;;;;;;;;AAUzB,SAAgB,gBAAsB;AACpC,aAAY;AACZ,gBAAe"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v3.0.
|
|
2
|
+
* @forinda/kickjs v3.0.7
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,5 +8,5 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import { t as Application } from "../application-
|
|
11
|
+
import { t as Application } from "../application-BwLUFfQy.mjs";
|
|
12
12
|
export { Application };
|
package/dist/http/bootstrap.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v3.0.
|
|
2
|
+
* @forinda/kickjs v3.0.7
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,5 +8,5 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import { t as bootstrap } from "../bootstrap-
|
|
11
|
+
import { t as bootstrap } from "../bootstrap-DV13o-cB.mjs";
|
|
12
12
|
export { bootstrap };
|
package/dist/http/context.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v3.0.
|
|
2
|
+
* @forinda/kickjs v3.0.7
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import { i as parseQuery } from "../query-
|
|
11
|
+
import { i as parseQuery } from "../query-Baxld1NB.mjs";
|
|
12
12
|
//#region src/http/context.ts
|
|
13
13
|
/**
|
|
14
14
|
* Unified request/response abstraction passed to every controller method.
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v3.0.
|
|
2
|
+
* @forinda/kickjs v3.0.7
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
*/
|
|
11
11
|
import { createLogger } from "../../core/logger.mjs";
|
|
12
12
|
import { HttpException } from "../../core/errors.mjs";
|
|
13
|
-
import "../../core-
|
|
13
|
+
import "../../core-DEFm-pvP.mjs";
|
|
14
14
|
//#region src/http/middleware/error-handler.ts
|
|
15
15
|
const log = createLogger("ErrorHandler");
|
|
16
16
|
/** Catch-all for unmatched routes */
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v3.0.
|
|
2
|
+
* @forinda/kickjs v3.0.7
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
11
|
import { createLogger } from "../../core/logger.mjs";
|
|
12
|
-
import "../../core-
|
|
12
|
+
import "../../core-DEFm-pvP.mjs";
|
|
13
13
|
//#region src/http/middleware/request-logger.ts
|
|
14
14
|
/**
|
|
15
15
|
* Middleware that logs every request with method, URL, status, duration, and request ID.
|
|
@@ -47,14 +47,17 @@ interface SessionOptions {
|
|
|
47
47
|
* `destroy()`, and `save()` methods. Session IDs are signed with
|
|
48
48
|
* HMAC-SHA256 to prevent cookie tampering.
|
|
49
49
|
*
|
|
50
|
+
* Reads the session cookie from `req.cookies` when an upstream cookie
|
|
51
|
+
* parser is present; otherwise parses `req.headers.cookie` directly, so
|
|
52
|
+
* no cookie parser is required upstream.
|
|
53
|
+
*
|
|
50
54
|
* @example
|
|
51
55
|
* ```ts
|
|
52
|
-
* import { session } from '@forinda/kickjs
|
|
56
|
+
* import { session } from '@forinda/kickjs'
|
|
53
57
|
*
|
|
54
58
|
* bootstrap({
|
|
55
59
|
* modules,
|
|
56
60
|
* middleware: [
|
|
57
|
-
* cookieParser(),
|
|
58
61
|
* session({ secret: process.env.SESSION_SECRET! }),
|
|
59
62
|
* // ... other middleware
|
|
60
63
|
* ],
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"session.d.mts","names":[],"sources":["../../../src/http/middleware/session.ts"],"mappings":";;;;UAGiB,WAAA;EAAA,CACd,GAAA;AAAA;AAAA,UAGc,YAAA;EACf,GAAA,CAAI,GAAA,WAAc,OAAA,CAAQ,WAAA;EAC1B,GAAA,CAAI,GAAA,UAAa,IAAA,EAAM,WAAA,EAAa,MAAA,WAAiB,OAAA;EACrD,OAAA,CAAQ,GAAA,WAAc,OAAA;EACtB,KAAA,EAAO,GAAA,UAAa,MAAA,WAAiB,OAAA;AAAA;AAAA,UAGtB,OAAA;EACf,EAAA;EACA,IAAA,EAAM,WAAA;EACN,UAAA,IAAc,OAAA;EACd,OAAA,IAAW,OAAA;EACX,IAAA,IAAQ,OAAA;AAAA;AAAA,UAGO,cAAA;EAX6B;EAa5C,MAAA;EAhBI;EAkBJ,UAAA;EAlB0B;EAoB1B,MAAA;EAnBI;EAqBJ,OAAA;EArBiB;EAuBjB,iBAAA;EAvBqD;EAyBrD,MAAA;IACE,QAAA;IACA,MAAA;IACA,QAAA;IACA,IAAA;IACA,MAAA;EAAA;EA5B0C;EA+B5C,KAAA,GAAQ,YAAA;AAAA;;;;;;;;;;;;;;;;;;;;AApBV
|
|
1
|
+
{"version":3,"file":"session.d.mts","names":[],"sources":["../../../src/http/middleware/session.ts"],"mappings":";;;;UAGiB,WAAA;EAAA,CACd,GAAA;AAAA;AAAA,UAGc,YAAA;EACf,GAAA,CAAI,GAAA,WAAc,OAAA,CAAQ,WAAA;EAC1B,GAAA,CAAI,GAAA,UAAa,IAAA,EAAM,WAAA,EAAa,MAAA,WAAiB,OAAA;EACrD,OAAA,CAAQ,GAAA,WAAc,OAAA;EACtB,KAAA,EAAO,GAAA,UAAa,MAAA,WAAiB,OAAA;AAAA;AAAA,UAGtB,OAAA;EACf,EAAA;EACA,IAAA,EAAM,WAAA;EACN,UAAA,IAAc,OAAA;EACd,OAAA,IAAW,OAAA;EACX,IAAA,IAAQ,OAAA;AAAA;AAAA,UAGO,cAAA;EAX6B;EAa5C,MAAA;EAhBI;EAkBJ,UAAA;EAlB0B;EAoB1B,MAAA;EAnBI;EAqBJ,OAAA;EArBiB;EAuBjB,iBAAA;EAvBqD;EAyBrD,MAAA;IACE,QAAA;IACA,MAAA;IACA,QAAA;IACA,IAAA;IACA,MAAA;EAAA;EA5B0C;EA+B5C,KAAA,GAAQ,YAAA;AAAA;;;;;;;;;;;;;;;;;;;;AApBV;;;;;iBAiJgB,OAAA,CAAQ,OAAA,EAAS,cAAA,IAoBjB,GAAA,EAAK,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,IAAA,EAAM,YAAA,KAAY,OAAA"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v3.0.
|
|
2
|
+
* @forinda/kickjs v3.0.7
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -44,6 +44,23 @@ var MemoryStore = class {
|
|
|
44
44
|
for (const [sid, entry] of this.sessions) if (now > entry.expires) this.sessions.delete(sid);
|
|
45
45
|
}
|
|
46
46
|
};
|
|
47
|
+
function parseCookieHeader(header) {
|
|
48
|
+
const out = {};
|
|
49
|
+
for (const pair of header.split(";")) {
|
|
50
|
+
const eq = pair.indexOf("=");
|
|
51
|
+
if (eq === -1) continue;
|
|
52
|
+
const key = pair.slice(0, eq).trim();
|
|
53
|
+
if (!key) continue;
|
|
54
|
+
let value = pair.slice(eq + 1).trim();
|
|
55
|
+
if (value.startsWith("\"") && value.endsWith("\"")) value = value.slice(1, -1);
|
|
56
|
+
try {
|
|
57
|
+
out[key] = decodeURIComponent(value);
|
|
58
|
+
} catch {
|
|
59
|
+
out[key] = value;
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
return out;
|
|
63
|
+
}
|
|
47
64
|
function sign(value, secret) {
|
|
48
65
|
return `s:${value}.${createHmac("sha256", secret).update(value).digest("base64url")}`;
|
|
49
66
|
}
|
|
@@ -67,14 +84,17 @@ function unsign(signed, secret) {
|
|
|
67
84
|
* `destroy()`, and `save()` methods. Session IDs are signed with
|
|
68
85
|
* HMAC-SHA256 to prevent cookie tampering.
|
|
69
86
|
*
|
|
87
|
+
* Reads the session cookie from `req.cookies` when an upstream cookie
|
|
88
|
+
* parser is present; otherwise parses `req.headers.cookie` directly, so
|
|
89
|
+
* no cookie parser is required upstream.
|
|
90
|
+
*
|
|
70
91
|
* @example
|
|
71
92
|
* ```ts
|
|
72
|
-
* import { session } from '@forinda/kickjs
|
|
93
|
+
* import { session } from '@forinda/kickjs'
|
|
73
94
|
*
|
|
74
95
|
* bootstrap({
|
|
75
96
|
* modules,
|
|
76
97
|
* middleware: [
|
|
77
|
-
* cookieParser(),
|
|
78
98
|
* session({ secret: process.env.SESSION_SECRET! }),
|
|
79
99
|
* // ... other middleware
|
|
80
100
|
* ],
|
|
@@ -92,7 +112,12 @@ function session(options) {
|
|
|
92
112
|
maxAge
|
|
93
113
|
};
|
|
94
114
|
return async (req, res, next) => {
|
|
95
|
-
|
|
115
|
+
let cookies = req.cookies;
|
|
116
|
+
if (!cookies) {
|
|
117
|
+
const header = req.headers.cookie;
|
|
118
|
+
cookies = header ? parseCookieHeader(header) : {};
|
|
119
|
+
}
|
|
120
|
+
const signedCookie = cookies[cookieName];
|
|
96
121
|
let sid = false;
|
|
97
122
|
let sessionData = null;
|
|
98
123
|
let isNew = false;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"session.mjs","names":[],"sources":["../../../src/http/middleware/session.ts"],"sourcesContent":["import { randomUUID, createHmac, timingSafeEqual } from 'node:crypto'\nimport type { Request, Response, NextFunction } from 'express'\n\nexport interface SessionData {\n [key: string]: unknown\n}\n\nexport interface SessionStore {\n get(sid: string): Promise<SessionData | null>\n set(sid: string, data: SessionData, maxAge: number): Promise<void>\n destroy(sid: string): Promise<void>\n touch?(sid: string, maxAge: number): Promise<void>\n}\n\nexport interface Session {\n id: string\n data: SessionData\n regenerate(): Promise<void>\n destroy(): Promise<void>\n save(): Promise<void>\n}\n\nexport interface SessionOptions {\n /** Secret used to sign the session cookie (required) */\n secret: string\n /** Cookie name (default: 'kick.sid') */\n cookieName?: string\n /** Session max age in milliseconds (default: 86400000 = 24h) */\n maxAge?: number\n /** Reset maxAge on every response (default: false) */\n rolling?: boolean\n /** Save new sessions that have not been modified (default: true) */\n saveUninitialized?: boolean\n /** Cookie options */\n cookie?: {\n httpOnly?: boolean\n secure?: boolean\n sameSite?: 'strict' | 'lax' | 'none'\n path?: string\n domain?: string\n }\n /** Custom session store (default: in-memory store with TTL cleanup) */\n store?: SessionStore\n}\n\n// ── In-Memory Store ───────────────────────────────────────────────────\n\nclass MemoryStore implements SessionStore {\n private sessions = new Map<string, { data: SessionData; expires: number }>()\n private cleanupInterval: ReturnType<typeof setInterval>\n\n constructor() {\n // Purge expired sessions every 60 seconds\n this.cleanupInterval = setInterval(() => this.purge(), 60_000)\n this.cleanupInterval.unref()\n }\n\n async get(sid: string): Promise<SessionData | null> {\n const entry = this.sessions.get(sid)\n if (!entry) return null\n if (Date.now() > entry.expires) {\n this.sessions.delete(sid)\n return null\n }\n return entry.data\n }\n\n async set(sid: string, data: SessionData, maxAge: number): Promise<void> {\n this.sessions.set(sid, { data, expires: Date.now() + maxAge })\n }\n\n async destroy(sid: string): Promise<void> {\n this.sessions.delete(sid)\n }\n\n async touch(sid: string, maxAge: number): Promise<void> {\n const entry = this.sessions.get(sid)\n if (entry) {\n entry.expires = Date.now() + maxAge\n }\n }\n\n private purge() {\n const now = Date.now()\n for (const [sid, entry] of this.sessions) {\n if (now > entry.expires) {\n this.sessions.delete(sid)\n }\n }\n }\n}\n\n// ── Cookie Signing ────────────────────────────────────────────────────\n\nfunction sign(value: string, secret: string): string {\n const signature = createHmac('sha256', secret).update(value).digest('base64url')\n return `s:${value}.${signature}`\n}\n\nfunction unsign(signed: string, secret: string): string | false {\n if (!signed.startsWith('s:')) return false\n const raw = signed.slice(2)\n const dotIndex = raw.lastIndexOf('.')\n if (dotIndex === -1) return false\n\n const value = raw.slice(0, dotIndex)\n const providedSig = raw.slice(dotIndex + 1)\n const expectedSig = createHmac('sha256', secret).update(value).digest('base64url')\n\n const a = Buffer.from(providedSig)\n const b = Buffer.from(expectedSig)\n\n if (a.length !== b.length || !timingSafeEqual(a, b)) {\n return false\n }\n\n return value\n}\n\n// ── Middleware Factory ────────────────────────────────────────────────\n\n/**\n * Session management middleware.\n *\n * Attaches a `req.session` object with `id`, `data`, `regenerate()`,\n * `destroy()`, and `save()` methods. Session IDs are signed with\n * HMAC-SHA256 to prevent cookie tampering.\n *\n * @example\n * ```ts\n * import { session } from '@forinda/kickjs-http'\n *\n * bootstrap({\n * modules,\n * middleware: [\n * cookieParser(),\n * session({ secret: process.env.SESSION_SECRET! }),\n * // ... other middleware\n * ],\n * })\n * ```\n */\nexport function session(options: SessionOptions) {\n const {\n secret,\n cookieName = 'kick.sid',\n maxAge = 86_400_000,\n rolling = false,\n saveUninitialized = true,\n store = new MemoryStore(),\n cookie: cookieOpts = {},\n } = options\n\n const cookieDefaults = {\n httpOnly: cookieOpts.httpOnly ?? true,\n secure: cookieOpts.secure ?? process.env.NODE_ENV === 'production',\n sameSite: cookieOpts.sameSite ?? ('lax' as const),\n path: cookieOpts.path ?? '/',\n ...(cookieOpts.domain ? { domain: cookieOpts.domain } : {}),\n maxAge,\n }\n\n return async (req: Request, res: Response, next: NextFunction) => {\n const cookies = (req as any).cookies || {}\n const signedCookie = cookies[cookieName]\n let sid: string | false = false\n let sessionData: SessionData | null = null\n let isNew = false\n\n // Attempt to recover existing session\n if (signedCookie) {\n sid = unsign(signedCookie, secret)\n if (sid) {\n sessionData = await store.get(sid)\n }\n }\n\n // Create new session if none found\n if (!sid || !sessionData) {\n sid = randomUUID()\n sessionData = {}\n isNew = true\n }\n\n let currentSid = sid as string\n let currentData = { ...sessionData }\n let destroyed = false\n\n const sessionObj: Session = {\n get id() {\n return currentSid\n },\n data: currentData,\n\n async regenerate() {\n await store.destroy(currentSid)\n currentSid = randomUUID()\n currentData = {}\n sessionObj.data = currentData\n await store.set(currentSid, currentData, maxAge)\n res.cookie(cookieName, sign(currentSid, secret), cookieDefaults)\n },\n\n async destroy() {\n await store.destroy(currentSid)\n destroyed = true\n currentData = {}\n sessionObj.data = currentData\n res.clearCookie(cookieName, { path: cookieDefaults.path })\n },\n\n async save() {\n if (!destroyed) {\n await store.set(currentSid, currentData, maxAge)\n }\n },\n }\n\n ;(req as any).session = sessionObj\n\n // Set cookie for new sessions\n if (isNew) {\n res.cookie(cookieName, sign(currentSid, secret), cookieDefaults)\n }\n\n // Auto-save on response finish\n res.on('finish', async () => {\n if (destroyed) return\n if (isNew && !saveUninitialized && Object.keys(currentData).length === 0) return\n\n await store.set(currentSid, currentData, maxAge)\n\n if (rolling && !isNew) {\n if (store.touch) {\n await store.touch(currentSid, maxAge)\n }\n }\n })\n\n // Rolling: refresh cookie on every response\n if (rolling && !isNew) {\n res.cookie(cookieName, sign(currentSid, secret), cookieDefaults)\n }\n\n next()\n }\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"session.mjs","names":[],"sources":["../../../src/http/middleware/session.ts"],"sourcesContent":["import { randomUUID, createHmac, timingSafeEqual } from 'node:crypto'\nimport type { Request, Response, NextFunction } from 'express'\n\nexport interface SessionData {\n [key: string]: unknown\n}\n\nexport interface SessionStore {\n get(sid: string): Promise<SessionData | null>\n set(sid: string, data: SessionData, maxAge: number): Promise<void>\n destroy(sid: string): Promise<void>\n touch?(sid: string, maxAge: number): Promise<void>\n}\n\nexport interface Session {\n id: string\n data: SessionData\n regenerate(): Promise<void>\n destroy(): Promise<void>\n save(): Promise<void>\n}\n\nexport interface SessionOptions {\n /** Secret used to sign the session cookie (required) */\n secret: string\n /** Cookie name (default: 'kick.sid') */\n cookieName?: string\n /** Session max age in milliseconds (default: 86400000 = 24h) */\n maxAge?: number\n /** Reset maxAge on every response (default: false) */\n rolling?: boolean\n /** Save new sessions that have not been modified (default: true) */\n saveUninitialized?: boolean\n /** Cookie options */\n cookie?: {\n httpOnly?: boolean\n secure?: boolean\n sameSite?: 'strict' | 'lax' | 'none'\n path?: string\n domain?: string\n }\n /** Custom session store (default: in-memory store with TTL cleanup) */\n store?: SessionStore\n}\n\n// ── In-Memory Store ───────────────────────────────────────────────────\n\nclass MemoryStore implements SessionStore {\n private readonly sessions = new Map<string, { data: SessionData; expires: number }>()\n private readonly cleanupInterval: ReturnType<typeof setInterval>\n\n constructor() {\n // Purge expired sessions every 60 seconds\n this.cleanupInterval = setInterval(() => this.purge(), 60_000)\n this.cleanupInterval.unref()\n }\n\n async get(sid: string): Promise<SessionData | null> {\n const entry = this.sessions.get(sid)\n if (!entry) return null\n if (Date.now() > entry.expires) {\n this.sessions.delete(sid)\n return null\n }\n return entry.data\n }\n\n async set(sid: string, data: SessionData, maxAge: number): Promise<void> {\n this.sessions.set(sid, { data, expires: Date.now() + maxAge })\n }\n\n async destroy(sid: string): Promise<void> {\n this.sessions.delete(sid)\n }\n\n async touch(sid: string, maxAge: number): Promise<void> {\n const entry = this.sessions.get(sid)\n if (entry) {\n entry.expires = Date.now() + maxAge\n }\n }\n\n private purge() {\n const now = Date.now()\n for (const [sid, entry] of this.sessions) {\n if (now > entry.expires) {\n this.sessions.delete(sid)\n }\n }\n }\n}\n\n// ── Cookie Header Parsing ─────────────────────────────────────────────\n\nfunction parseCookieHeader(header: string): Record<string, string> {\n const out: Record<string, string> = {}\n for (const pair of header.split(';')) {\n const eq = pair.indexOf('=')\n if (eq === -1) continue\n const key = pair.slice(0, eq).trim()\n if (!key) continue\n let value = pair.slice(eq + 1).trim()\n if (value.startsWith('\"') && value.endsWith('\"')) {\n value = value.slice(1, -1)\n }\n try {\n out[key] = decodeURIComponent(value)\n } catch {\n out[key] = value\n }\n }\n return out\n}\n\n// ── Cookie Signing ────────────────────────────────────────────────────\n\nfunction sign(value: string, secret: string): string {\n const signature = createHmac('sha256', secret).update(value).digest('base64url')\n return `s:${value}.${signature}`\n}\n\nfunction unsign(signed: string, secret: string): string | false {\n if (!signed.startsWith('s:')) return false\n const raw = signed.slice(2)\n const dotIndex = raw.lastIndexOf('.')\n if (dotIndex === -1) return false\n\n const value = raw.slice(0, dotIndex)\n const providedSig = raw.slice(dotIndex + 1)\n const expectedSig = createHmac('sha256', secret).update(value).digest('base64url')\n\n const a = Buffer.from(providedSig)\n const b = Buffer.from(expectedSig)\n\n if (a.length !== b.length || !timingSafeEqual(a, b)) {\n return false\n }\n\n return value\n}\n\n// ── Middleware Factory ────────────────────────────────────────────────\n\n/**\n * Session management middleware.\n *\n * Attaches a `req.session` object with `id`, `data`, `regenerate()`,\n * `destroy()`, and `save()` methods. Session IDs are signed with\n * HMAC-SHA256 to prevent cookie tampering.\n *\n * Reads the session cookie from `req.cookies` when an upstream cookie\n * parser is present; otherwise parses `req.headers.cookie` directly, so\n * no cookie parser is required upstream.\n *\n * @example\n * ```ts\n * import { session } from '@forinda/kickjs'\n *\n * bootstrap({\n * modules,\n * middleware: [\n * session({ secret: process.env.SESSION_SECRET! }),\n * // ... other middleware\n * ],\n * })\n * ```\n */\nexport function session(options: SessionOptions) {\n const {\n secret,\n cookieName = 'kick.sid',\n maxAge = 86_400_000,\n rolling = false,\n saveUninitialized = true,\n store = new MemoryStore(),\n cookie: cookieOpts = {},\n } = options\n\n const cookieDefaults = {\n httpOnly: cookieOpts.httpOnly ?? true,\n secure: cookieOpts.secure ?? process.env.NODE_ENV === 'production',\n sameSite: cookieOpts.sameSite ?? ('lax' as const),\n path: cookieOpts.path ?? '/',\n ...(cookieOpts.domain ? { domain: cookieOpts.domain } : {}),\n maxAge,\n }\n\n return async (req: Request, res: Response, next: NextFunction) => {\n let cookies = (req as any).cookies as Record<string, string> | undefined\n if (!cookies) {\n const header = req.headers.cookie\n cookies = header ? parseCookieHeader(header) : {}\n }\n const signedCookie = cookies[cookieName]\n let sid: string | false = false\n let sessionData: SessionData | null = null\n let isNew = false\n\n // Attempt to recover existing session\n if (signedCookie) {\n sid = unsign(signedCookie, secret)\n if (sid) {\n sessionData = await store.get(sid)\n }\n }\n\n // Create new session if none found\n if (!sid || !sessionData) {\n sid = randomUUID()\n sessionData = {}\n isNew = true\n }\n\n let currentSid = sid\n let currentData = { ...sessionData }\n let destroyed = false\n\n const sessionObj: Session = {\n get id() {\n return currentSid\n },\n data: currentData,\n\n async regenerate() {\n await store.destroy(currentSid)\n currentSid = randomUUID()\n currentData = {}\n sessionObj.data = currentData\n await store.set(currentSid, currentData, maxAge)\n res.cookie(cookieName, sign(currentSid, secret), cookieDefaults)\n },\n\n async destroy() {\n await store.destroy(currentSid)\n destroyed = true\n currentData = {}\n sessionObj.data = currentData\n res.clearCookie(cookieName, { path: cookieDefaults.path })\n },\n\n async save() {\n if (!destroyed) {\n await store.set(currentSid, currentData, maxAge)\n }\n },\n }\n\n ;(req as any).session = sessionObj\n\n // Set cookie for new sessions\n if (isNew) {\n res.cookie(cookieName, sign(currentSid, secret), cookieDefaults)\n }\n\n // Auto-save on response finish\n res.on('finish', async () => {\n if (destroyed) return\n if (isNew && !saveUninitialized && Object.keys(currentData).length === 0) return\n\n await store.set(currentSid, currentData, maxAge)\n\n if (rolling && !isNew) {\n if (store.touch) {\n await store.touch(currentSid, maxAge)\n }\n }\n })\n\n // Rolling: refresh cookie on every response\n if (rolling && !isNew) {\n res.cookie(cookieName, sign(currentSid, secret), cookieDefaults)\n }\n\n next()\n }\n}\n"],"mappings":"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"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v3.0.
|
|
2
|
+
* @forinda/kickjs v3.0.7
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,9 +8,9 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import { t as __require } from "../../chunk-
|
|
11
|
+
import { t as __require } from "../../chunk-DXYGQY5w.mjs";
|
|
12
12
|
import { Logger } from "../../core/logger.mjs";
|
|
13
|
-
import "../../core-
|
|
13
|
+
import "../../core-DEFm-pvP.mjs";
|
|
14
14
|
import { join, resolve } from "node:path";
|
|
15
15
|
import { existsSync, readFileSync } from "node:fs";
|
|
16
16
|
//#region src/http/middleware/spa.ts
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v3.0.
|
|
2
|
+
* @forinda/kickjs v3.0.7
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
11
|
import { Logger } from "../../core/logger.mjs";
|
|
12
|
-
import "../../core-
|
|
12
|
+
import "../../core-DEFm-pvP.mjs";
|
|
13
13
|
import { resolve } from "node:path";
|
|
14
14
|
//#region src/http/middleware/views.ts
|
|
15
15
|
const log = Logger.for("ViewEngine");
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v3.0.
|
|
2
|
+
* @forinda/kickjs v3.0.7
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,5 +8,5 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import { a as parseSearchQuery, i as parseQuery, n as parseFilters, o as parseSort, r as parsePagination, s as FILTER_OPERATORS, t as buildQueryParams } from "../../query-
|
|
11
|
+
import { a as parseSearchQuery, i as parseQuery, n as parseFilters, o as parseSort, r as parsePagination, s as FILTER_OPERATORS, t as buildQueryParams } from "../../query-Baxld1NB.mjs";
|
|
12
12
|
export { FILTER_OPERATORS, buildQueryParams, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort };
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v3.0.
|
|
2
|
+
* @forinda/kickjs v3.0.7
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -9,9 +9,9 @@
|
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
11
|
import { METADATA } from "../core/interfaces.mjs";
|
|
12
|
-
import { a as getMethodMeta, o as getMethodMetaOrUndefined, t as getClassMeta } from "../metadata-
|
|
13
|
-
import { t as Container } from "../container-
|
|
14
|
-
import "../core-
|
|
12
|
+
import { a as getMethodMeta, o as getMethodMetaOrUndefined, t as getClassMeta } from "../metadata-CGOLNICI.mjs";
|
|
13
|
+
import { t as Container } from "../container-DrJQ6Zgx.mjs";
|
|
14
|
+
import "../core-DEFm-pvP.mjs";
|
|
15
15
|
import { RequestContext } from "./context.mjs";
|
|
16
16
|
import { validate } from "./middleware/validate.mjs";
|
|
17
17
|
import { buildUploadMiddleware } from "./middleware/upload.mjs";
|