@geekmidas/constructs 3.0.6 → 3.0.8

package/dist/lazyAccessors-DM6HcXQk.mjs

@@ -1,175 +0,0 @@
-import { getCookie } from "hono/cookie";
-
-//#region src/endpoints/lazyAccessors.ts
-/**
-* Create a lazy header accessor for Hono.
-* Uses `c.req.header(name)` for single lookups (native, case-insensitive).
-* Only calls `c.req.header()` to get all headers when needed.
-*/
-function createHonoHeaders(c) {
-	let allHeaders = null;
-	return (key) => {
-		if (key !== void 0) return c.req.header(key);
-		if (!allHeaders) allHeaders = c.req.header();
-		return allHeaders;
-	};
-}
-/**
-* Create a lazy cookie accessor for Hono.
-* Uses `getCookie(c, name)` for single lookups (native).
-* Only parses the cookie header when all cookies are requested.
-*/
-function createHonoCookies(c) {
-	let allCookies = null;
-	return (name) => {
-		if (name !== void 0) return getCookie(c, name);
-		if (!allCookies) {
-			allCookies = {};
-			const cookieHeader = c.req.header("cookie");
-			if (cookieHeader) for (const part of cookieHeader.split(";")) {
-				const trimmed = part.trim();
-				const eqIndex = trimmed.indexOf("=");
-				if (eqIndex > 0) {
-					const key = trimmed.slice(0, eqIndex);
-					const value = trimmed.slice(eqIndex + 1);
-					allCookies[key] = value;
-				}
-			}
-		}
-		return allCookies;
-	};
-}
-/**
-* Create a lazy header accessor for API Gateway events.
-* Handles case-insensitive lookups.
-*/
-function createApiGatewayHeaders(headers) {
-	let normalizedHeaders = null;
-	const normalize = () => {
-		if (!normalizedHeaders) {
-			normalizedHeaders = {};
-			if (headers) {
-				for (const [k, v] of Object.entries(headers)) if (v !== void 0) normalizedHeaders[k.toLowerCase()] = v;
-			}
-		}
-		return normalizedHeaders;
-	};
-	return (key) => {
-		if (key !== void 0) {
-			if (headers) {
-				const direct = headers[key] ?? headers[key.toLowerCase()];
-				if (direct !== void 0) return direct;
-				return normalize()[key.toLowerCase()];
-			}
-			return void 0;
-		}
-		return normalize();
-	};
-}
-/**
-* Create a lazy cookie accessor for API Gateway events.
-* Decodes URL-encoded values to match browser behavior.
-*/
-function createApiGatewayCookies(cookies, cookieHeader) {
-	let parsed = null;
-	const parse = () => {
-		if (!parsed) {
-			parsed = {};
-			if (cookies) for (const cookie of cookies) {
-				const eqIndex = cookie.indexOf("=");
-				if (eqIndex > 0) {
-					const key = cookie.slice(0, eqIndex);
-					const value = cookie.slice(eqIndex + 1);
-					parsed[key] = decodeURIComponent(value);
-				}
-			}
-			else if (cookieHeader) for (const part of cookieHeader.split(";")) {
-				const trimmed = part.trim();
-				const eqIndex = trimmed.indexOf("=");
-				if (eqIndex > 0) {
-					const key = trimmed.slice(0, eqIndex);
-					const value = trimmed.slice(eqIndex + 1);
-					parsed[key] = decodeURIComponent(value);
-				}
-			}
-		}
-		return parsed;
-	};
-	return (name) => {
-		if (name !== void 0) return parse()[name];
-		return parse();
-	};
-}
-/**
-* Create a lazy header accessor for plain object headers (test adaptor, etc).
-* Headers are already available as an object, just provide lazy access.
-*/
-function createObjectHeaders(headers) {
-	let normalized = null;
-	return (key) => {
-		if (key !== void 0) {
-			if (headers) {
-				const direct = headers[key] ?? headers[key.toLowerCase()];
-				if (direct !== void 0) return direct;
-			}
-			if (!normalized && headers) {
-				normalized = {};
-				for (const [k, v] of Object.entries(headers)) normalized[k.toLowerCase()] = v;
-			}
-			return normalized?.[key.toLowerCase()];
-		}
-		if (!normalized && headers) {
-			normalized = {};
-			for (const [k, v] of Object.entries(headers)) normalized[k.toLowerCase()] = v;
-		}
-		return normalized ?? {};
-	};
-}
-/**
-* Create a lazy cookie accessor from a cookie header string.
-* Decodes URL-encoded values to match browser behavior.
-*/
-function createCookieHeaderAccessor(cookieHeader) {
-	let parsed = null;
-	const parse = () => {
-		if (!parsed) {
-			parsed = {};
-			if (cookieHeader) for (const part of cookieHeader.split(";")) {
-				const trimmed = part.trim();
-				const eqIndex = trimmed.indexOf("=");
-				if (eqIndex > 0) {
-					const key = trimmed.slice(0, eqIndex);
-					const value = trimmed.slice(eqIndex + 1);
-					parsed[key] = decodeURIComponent(value);
-				}
-			}
-		}
-		return parsed;
-	};
-	return (name) => {
-		if (name !== void 0) return parse()[name];
-		return parse();
-	};
-}
-/**
-* Create a no-op header accessor (for minimal endpoints that don't use headers).
-*/
-function createNoopHeaders() {
-	return (key) => {
-		if (key !== void 0) return void 0;
-		return {};
-	};
-}
-/**
-* Create a no-op cookie accessor (for minimal endpoints that don't use cookies).
-*/
-function createNoopCookies() {
-	return (name) => {
-		if (name !== void 0) return void 0;
-		return {};
-	};
-}
-
-//#endregion
-export { createApiGatewayCookies, createApiGatewayHeaders, createCookieHeaderAccessor, createHonoCookies, createHonoHeaders, createNoopCookies, createNoopHeaders, createObjectHeaders };
-//# sourceMappingURL=lazyAccessors-DM6HcXQk.mjs.map

package/dist/lazyAccessors-DM6HcXQk.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"lazyAccessors-DM6HcXQk.mjs","names":["c: Context","allHeaders: Record<string, string> | null","key?: string","allCookies: Record<string, string> | null","name?: string","headers: Record<string, string | undefined> | null | undefined","normalizedHeaders: Record<string, string> | null","cookies: string[] | undefined","cookieHeader: string | undefined","parsed: Record<string, string> | null","headers: Record<string, string> | undefined","normalized: Record<string, string> | null"],"sources":["../src/endpoints/lazyAccessors.ts"],"sourcesContent":["/**\n * Lazy header and cookie accessors for different adaptors.\n *\n * Instead of parsing all headers/cookies upfront, these accessors\n * use native adaptor methods for single lookups and only parse\n * everything when `header()` or `cookie()` is called without arguments.\n */\nimport type { Context } from 'hono';\nimport { getCookie } from 'hono/cookie';\nimport type { CookieFn, HeaderFn } from './Endpoint';\n\n/**\n * Create a lazy header accessor for Hono.\n * Uses `c.req.header(name)` for single lookups (native, case-insensitive).\n * Only calls `c.req.header()` to get all headers when needed.\n */\nexport function createHonoHeaders(c: Context): HeaderFn {\n\tlet allHeaders: Record<string, string> | null = null;\n\n\treturn ((key?: string) => {\n\t\tif (key !== undefined) {\n\t\t\t// Single header lookup - use native Hono method (case-insensitive)\n\t\t\treturn c.req.header(key);\n\t\t}\n\t\t// Get all headers - cache the result\n\t\tif (!allHeaders) {\n\t\t\tallHeaders = c.req.header();\n\t\t}\n\t\treturn allHeaders;\n\t}) as HeaderFn;\n}\n\n/**\n * Create a lazy cookie accessor for Hono.\n * Uses `getCookie(c, name)` for single lookups (native).\n * Only parses the cookie header when all cookies are requested.\n */\nexport function createHonoCookies(c: Context): CookieFn {\n\tlet allCookies: Record<string, string> | null = null;\n\n\treturn ((name?: string) => {\n\t\tif (name !== undefined) {\n\t\t\t// Single cookie lookup - use native Hono method\n\t\t\treturn getCookie(c, name);\n\t\t}\n\t\t// Get all cookies - parse and cache\n\t\tif (!allCookies) {\n\t\t\tallCookies = {};\n\t\t\tconst cookieHeader = c.req.header('cookie');\n\t\t\tif (cookieHeader) {\n\t\t\t\tfor (const part of cookieHeader.split(';')) {\n\t\t\t\t\tconst trimmed = part.trim();\n\t\t\t\t\tconst eqIndex = trimmed.indexOf('=');\n\t\t\t\t\tif (eqIndex > 0) {\n\t\t\t\t\t\tconst key = trimmed.slice(0, eqIndex);\n\t\t\t\t\t\tconst value = trimmed.slice(eqIndex + 1);\n\t\t\t\t\t\tallCookies[key] = value;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn allCookies;\n\t}) as CookieFn;\n}\n\n/**\n * Create a lazy header accessor for API Gateway events.\n * Handles case-insensitive lookups.\n */\nexport function createApiGatewayHeaders(\n\theaders: Record<string, string | undefined> | null | undefined,\n): HeaderFn {\n\tlet normalizedHeaders: Record<string, string> | null = null;\n\n\tconst normalize = () => {\n\t\tif (!normalizedHeaders) {\n\t\t\tnormalizedHeaders = {};\n\t\t\tif (headers) {\n\t\t\t\tfor (const [k, v] of Object.entries(headers)) {\n\t\t\t\t\tif (v !== undefined) {\n\t\t\t\t\t\tnormalizedHeaders[k.toLowerCase()] = v;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn normalizedHeaders;\n\t};\n\n\treturn ((key?: string) => {\n\t\tif (key !== undefined) {\n\t\t\t// Try direct lookup first (common case: headers already lowercase)\n\t\t\tif (headers) {\n\t\t\t\tconst direct = headers[key] ?? headers[key.toLowerCase()];\n\t\t\t\tif (direct !== undefined) return direct;\n\t\t\t\t// Fall back to normalized lookup\n\t\t\t\treturn normalize()[key.toLowerCase()];\n\t\t\t}\n\t\t\treturn undefined;\n\t\t}\n\t\treturn normalize();\n\t}) as HeaderFn;\n}\n\n/**\n * Create a lazy cookie accessor for API Gateway events.\n * Decodes URL-encoded values to match browser behavior.\n */\nexport function createApiGatewayCookies(\n\tcookies: string[] | undefined,\n\tcookieHeader: string | undefined,\n): CookieFn {\n\tlet parsed: Record<string, string> | null = null;\n\n\tconst parse = () => {\n\t\tif (!parsed) {\n\t\t\tparsed = {};\n\t\t\t// API Gateway v2 provides cookies as array\n\t\t\tif (cookies) {\n\t\t\t\tfor (const cookie of cookies) {\n\t\t\t\t\tconst eqIndex = cookie.indexOf('=');\n\t\t\t\t\tif (eqIndex > 0) {\n\t\t\t\t\t\tconst key = cookie.slice(0, eqIndex);\n\t\t\t\t\t\tconst value = cookie.slice(eqIndex + 1);\n\t\t\t\t\t\tparsed[key] = decodeURIComponent(value);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t} else if (cookieHeader) {\n\t\t\t\t// Fall back to parsing cookie header\n\t\t\t\tfor (const part of cookieHeader.split(';')) {\n\t\t\t\t\tconst trimmed = part.trim();\n\t\t\t\t\tconst eqIndex = trimmed.indexOf('=');\n\t\t\t\t\tif (eqIndex > 0) {\n\t\t\t\t\t\tconst key = trimmed.slice(0, eqIndex);\n\t\t\t\t\t\tconst value = trimmed.slice(eqIndex + 1);\n\t\t\t\t\t\tparsed[key] = decodeURIComponent(value);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn parsed;\n\t};\n\n\treturn ((name?: string) => {\n\t\tif (name !== undefined) {\n\t\t\treturn parse()[name];\n\t\t}\n\t\treturn parse();\n\t}) as CookieFn;\n}\n\n/**\n * Create a lazy header accessor for plain object headers (test adaptor, etc).\n * Headers are already available as an object, just provide lazy access.\n */\nexport function createObjectHeaders(\n\theaders: Record<string, string> | undefined,\n): HeaderFn {\n\tlet normalized: Record<string, string> | null = null;\n\n\treturn ((key?: string) => {\n\t\tif (key !== undefined) {\n\t\t\t// Try direct lookup first (common case)\n\t\t\tif (headers) {\n\t\t\t\tconst direct = headers[key] ?? headers[key.toLowerCase()];\n\t\t\t\tif (direct !== undefined) return direct;\n\t\t\t}\n\t\t\t// Fall back to normalized lookup for case-insensitivity\n\t\t\tif (!normalized && headers) {\n\t\t\t\tnormalized = {};\n\t\t\t\tfor (const [k, v] of Object.entries(headers)) {\n\t\t\t\t\tnormalized[k.toLowerCase()] = v;\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn normalized?.[key.toLowerCase()];\n\t\t}\n\t\t// Return all headers\n\t\tif (!normalized && headers) {\n\t\t\tnormalized = {};\n\t\t\tfor (const [k, v] of Object.entries(headers)) {\n\t\t\t\tnormalized[k.toLowerCase()] = v;\n\t\t\t}\n\t\t}\n\t\treturn normalized ?? {};\n\t}) as HeaderFn;\n}\n\n/**\n * Create a lazy cookie accessor from a cookie header string.\n * Decodes URL-encoded values to match browser behavior.\n */\nexport function createCookieHeaderAccessor(\n\tcookieHeader: string | undefined,\n): CookieFn {\n\tlet parsed: Record<string, string> | null = null;\n\n\tconst parse = () => {\n\t\tif (!parsed) {\n\t\t\tparsed = {};\n\t\t\tif (cookieHeader) {\n\t\t\t\tfor (const part of cookieHeader.split(';')) {\n\t\t\t\t\tconst trimmed = part.trim();\n\t\t\t\t\tconst eqIndex = trimmed.indexOf('=');\n\t\t\t\t\tif (eqIndex > 0) {\n\t\t\t\t\t\tconst key = trimmed.slice(0, eqIndex);\n\t\t\t\t\t\tconst value = trimmed.slice(eqIndex + 1);\n\t\t\t\t\t\t// Decode URL-encoded values to match Endpoint.createCookies behavior\n\t\t\t\t\t\tparsed[key] = decodeURIComponent(value);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn parsed;\n\t};\n\n\treturn ((name?: string) => {\n\t\tif (name !== undefined) {\n\t\t\treturn parse()[name];\n\t\t}\n\t\treturn parse();\n\t}) as CookieFn;\n}\n\n/**\n * Create a no-op header accessor (for minimal endpoints that don't use headers).\n */\nexport function createNoopHeaders(): HeaderFn {\n\treturn ((key?: string) => {\n\t\tif (key !== undefined) return undefined;\n\t\treturn {};\n\t}) as HeaderFn;\n}\n\n/**\n * Create a no-op cookie accessor (for minimal endpoints that don't use cookies).\n */\nexport function createNoopCookies(): CookieFn {\n\treturn ((name?: string) => {\n\t\tif (name !== undefined) return undefined;\n\t\treturn {};\n\t}) as CookieFn;\n}\n"],"mappings":"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"}

package/dist/parseHonoQuery-BBs8CX-H.cjs

@@ -1,24 +0,0 @@
-const require_chunk = require('./chunk-CUT6urMc.cjs');
-const qs = require_chunk.__toESM(require("qs"));
-
-//#region src/endpoints/parseHonoQuery.ts
-/**
-* Parse Hono query parameters using qs bracket notation
-* Supports nested objects, arrays, and deep nesting via standard bracket syntax
-*/
-function parseHonoQuery(c) {
-	const url = c.req.url;
-	const queryIndex = url.indexOf("?");
-	if (queryIndex === -1) return {};
-	const queryString = url.slice(queryIndex + 1);
-	return qs.default.parse(queryString);
-}
-
-//#endregion
-Object.defineProperty(exports, 'parseHonoQuery', {
-  enumerable: true,
-  get: function () {
-    return parseHonoQuery;
-  }
-});
-//# sourceMappingURL=parseHonoQuery-BBs8CX-H.cjs.map

package/dist/parseHonoQuery-BBs8CX-H.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"parseHonoQuery-BBs8CX-H.cjs","names":["c: Context"],"sources":["../src/endpoints/parseHonoQuery.ts"],"sourcesContent":["import type { Context } from 'hono';\nimport qs from 'qs';\n\n/**\n * Parse Hono query parameters using qs bracket notation\n * Supports nested objects, arrays, and deep nesting via standard bracket syntax\n */\nexport function parseHonoQuery(c: Context): Record<string, any> {\n\tconst url = c.req.url;\n\tconst queryIndex = url.indexOf('?');\n\tif (queryIndex === -1) {\n\t\treturn {};\n\t}\n\tconst queryString = url.slice(queryIndex + 1);\n\treturn qs.parse(queryString) as Record<string, any>;\n}\n"],"mappings":";;;;;;;;AAOA,SAAgB,eAAeA,GAAiC;CAC/D,MAAM,MAAM,EAAE,IAAI;CAClB,MAAM,aAAa,IAAI,QAAQ,IAAI;AACnC,KAAI,eAAe,GAClB,QAAO,CAAE;CAEV,MAAM,cAAc,IAAI,MAAM,aAAa,EAAE;AAC7C,QAAO,WAAG,MAAM,YAAY;AAC5B"}

package/dist/parseHonoQuery-Cp8CII0P.mjs

@@ -1,18 +0,0 @@
-import qs from "qs";
-
-//#region src/endpoints/parseHonoQuery.ts
-/**
-* Parse Hono query parameters using qs bracket notation
-* Supports nested objects, arrays, and deep nesting via standard bracket syntax
-*/
-function parseHonoQuery(c) {
-	const url = c.req.url;
-	const queryIndex = url.indexOf("?");
-	if (queryIndex === -1) return {};
-	const queryString = url.slice(queryIndex + 1);
-	return qs.parse(queryString);
-}
-
-//#endregion
-export { parseHonoQuery };
-//# sourceMappingURL=parseHonoQuery-Cp8CII0P.mjs.map

package/dist/parseHonoQuery-Cp8CII0P.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"parseHonoQuery-Cp8CII0P.mjs","names":["c: Context"],"sources":["../src/endpoints/parseHonoQuery.ts"],"sourcesContent":["import type { Context } from 'hono';\nimport qs from 'qs';\n\n/**\n * Parse Hono query parameters using qs bracket notation\n * Supports nested objects, arrays, and deep nesting via standard bracket syntax\n */\nexport function parseHonoQuery(c: Context): Record<string, any> {\n\tconst url = c.req.url;\n\tconst queryIndex = url.indexOf('?');\n\tif (queryIndex === -1) {\n\t\treturn {};\n\t}\n\tconst queryString = url.slice(queryIndex + 1);\n\treturn qs.parse(queryString) as Record<string, any>;\n}\n"],"mappings":";;;;;;;AAOA,SAAgB,eAAeA,GAAiC;CAC/D,MAAM,MAAM,EAAE,IAAI;CAClB,MAAM,aAAa,IAAI,QAAQ,IAAI;AACnC,KAAI,eAAe,GAClB,QAAO,CAAE;CAEV,MAAM,cAAc,IAAI,MAAM,aAAa,EAAE;AAC7C,QAAO,GAAG,MAAM,YAAY;AAC5B"}

package/dist/parseQueryParams-B4RK1za3.cjs

@@ -1,31 +0,0 @@
-const require_chunk = require('./chunk-CUT6urMc.cjs');
-const qs = require_chunk.__toESM(require("qs"));
-
-//#region src/endpoints/parseQueryParams.ts
-/**
-* Parse query parameters from a flat object into a nested structure
-* Uses qs bracket notation for standard interoperability
-*
-* @example
-* parseQueryParams({ 'tags[]': ['a', 'b'], 'filter[name]': 'john' })
-* // Returns: { tags: ['a', 'b'], filter: { name: 'john' } }
-*/
-function parseQueryParams(queryParams) {
-	if (!queryParams) return {};
-	const parts = [];
-	for (const [key, value] of Object.entries(queryParams)) {
-		if (value === void 0) continue;
-		if (Array.isArray(value)) for (const v of value) parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(v)}`);
-		else parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(value)}`);
-	}
-	return qs.default.parse(parts.join("&"));
-}
-
-//#endregion
-Object.defineProperty(exports, 'parseQueryParams', {
-  enumerable: true,
-  get: function () {
-    return parseQueryParams;
-  }
-});
-//# sourceMappingURL=parseQueryParams-B4RK1za3.cjs.map

package/dist/parseQueryParams-B4RK1za3.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"parseQueryParams-B4RK1za3.cjs","names":["queryParams: Record<string, string | string[] | undefined> | null","parts: string[]"],"sources":["../src/endpoints/parseQueryParams.ts"],"sourcesContent":["import qs from 'qs';\n\n/**\n * Parse query parameters from a flat object into a nested structure\n * Uses qs bracket notation for standard interoperability\n *\n * @example\n * parseQueryParams({ 'tags[]': ['a', 'b'], 'filter[name]': 'john' })\n * // Returns: { tags: ['a', 'b'], filter: { name: 'john' } }\n */\nexport function parseQueryParams(\n\tqueryParams: Record<string, string | string[] | undefined> | null,\n): Record<string, any> {\n\tif (!queryParams) {\n\t\treturn {};\n\t}\n\n\t// Reconstruct a query string from the flat object so qs can parse bracket notation\n\tconst parts: string[] = [];\n\tfor (const [key, value] of Object.entries(queryParams)) {\n\t\tif (value === undefined) continue;\n\t\tif (Array.isArray(value)) {\n\t\t\tfor (const v of value) {\n\t\t\t\tparts.push(`${encodeURIComponent(key)}=${encodeURIComponent(v)}`);\n\t\t\t}\n\t\t} else {\n\t\t\tparts.push(`${encodeURIComponent(key)}=${encodeURIComponent(value)}`);\n\t\t}\n\t}\n\n\treturn qs.parse(parts.join('&')) as Record<string, any>;\n}\n"],"mappings":";;;;;;;;;;;;AAUA,SAAgB,iBACfA,aACsB;AACtB,MAAK,YACJ,QAAO,CAAE;CAIV,MAAMC,QAAkB,CAAE;AAC1B,MAAK,MAAM,CAAC,KAAK,MAAM,IAAI,OAAO,QAAQ,YAAY,EAAE;AACvD,MAAI,iBAAqB;AACzB,MAAI,MAAM,QAAQ,MAAM,CACvB,MAAK,MAAM,KAAK,MACf,OAAM,MAAM,EAAE,mBAAmB,IAAI,CAAC,GAAG,mBAAmB,EAAE,CAAC,EAAE;MAGlE,OAAM,MAAM,EAAE,mBAAmB,IAAI,CAAC,GAAG,mBAAmB,MAAM,CAAC,EAAE;CAEtE;AAED,QAAO,WAAG,MAAM,MAAM,KAAK,IAAI,CAAC;AAChC"}

package/dist/parseQueryParams-DS3Qmrbd.mjs

@@ -1,25 +0,0 @@
-import qs from "qs";
-
-//#region src/endpoints/parseQueryParams.ts
-/**
-* Parse query parameters from a flat object into a nested structure
-* Uses qs bracket notation for standard interoperability
-*
-* @example
-* parseQueryParams({ 'tags[]': ['a', 'b'], 'filter[name]': 'john' })
-* // Returns: { tags: ['a', 'b'], filter: { name: 'john' } }
-*/
-function parseQueryParams(queryParams) {
-	if (!queryParams) return {};
-	const parts = [];
-	for (const [key, value] of Object.entries(queryParams)) {
-		if (value === void 0) continue;
-		if (Array.isArray(value)) for (const v of value) parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(v)}`);
-		else parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(value)}`);
-	}
-	return qs.parse(parts.join("&"));
-}
-
-//#endregion
-export { parseQueryParams };
-//# sourceMappingURL=parseQueryParams-DS3Qmrbd.mjs.map

package/dist/parseQueryParams-DS3Qmrbd.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"parseQueryParams-DS3Qmrbd.mjs","names":["queryParams: Record<string, string | string[] | undefined> | null","parts: string[]"],"sources":["../src/endpoints/parseQueryParams.ts"],"sourcesContent":["import qs from 'qs';\n\n/**\n * Parse query parameters from a flat object into a nested structure\n * Uses qs bracket notation for standard interoperability\n *\n * @example\n * parseQueryParams({ 'tags[]': ['a', 'b'], 'filter[name]': 'john' })\n * // Returns: { tags: ['a', 'b'], filter: { name: 'john' } }\n */\nexport function parseQueryParams(\n\tqueryParams: Record<string, string | string[] | undefined> | null,\n): Record<string, any> {\n\tif (!queryParams) {\n\t\treturn {};\n\t}\n\n\t// Reconstruct a query string from the flat object so qs can parse bracket notation\n\tconst parts: string[] = [];\n\tfor (const [key, value] of Object.entries(queryParams)) {\n\t\tif (value === undefined) continue;\n\t\tif (Array.isArray(value)) {\n\t\t\tfor (const v of value) {\n\t\t\t\tparts.push(`${encodeURIComponent(key)}=${encodeURIComponent(v)}`);\n\t\t\t}\n\t\t} else {\n\t\t\tparts.push(`${encodeURIComponent(key)}=${encodeURIComponent(value)}`);\n\t\t}\n\t}\n\n\treturn qs.parse(parts.join('&')) as Record<string, any>;\n}\n"],"mappings":";;;;;;;;;;;AAUA,SAAgB,iBACfA,aACsB;AACtB,MAAK,YACJ,QAAO,CAAE;CAIV,MAAMC,QAAkB,CAAE;AAC1B,MAAK,MAAM,CAAC,KAAK,MAAM,IAAI,OAAO,QAAQ,YAAY,EAAE;AACvD,MAAI,iBAAqB;AACzB,MAAI,MAAM,QAAQ,MAAM,CACvB,MAAK,MAAM,KAAK,MACf,OAAM,MAAM,EAAE,mBAAmB,IAAI,CAAC,GAAG,mBAAmB,EAAE,CAAC,EAAE;MAGlE,OAAM,MAAM,EAAE,mBAAmB,IAAI,CAAC,GAAG,mBAAmB,MAAM,CAAC,EAAE;CAEtE;AAED,QAAO,GAAG,MAAM,MAAM,KAAK,IAAI,CAAC;AAChC"}

package/dist/processAudits-CzHkPokQ.cjs

@@ -1,180 +0,0 @@
-const require_chunk = require('./chunk-CUT6urMc.cjs');
-const __geekmidas_audit = require_chunk.__toESM(require("@geekmidas/audit"));
-
-//#region src/endpoints/processAudits.ts
-/**
-* Process declarative audit definitions after successful endpoint execution.
-* Similar to publishConstructEvents for events.
-*
-* @param endpoint - The endpoint with audit configuration
-* @param response - The handler response to generate audit payloads from
-* @param serviceDiscovery - Service discovery for registering audit storage
-* @param logger - Logger for debug/error messages
-* @param ctx - Request context (session, headers, cookies, services)
-* @param existingAuditor - Optional existing auditor instance (e.g., from handler context).
-*                          If provided, uses this auditor (with its stored transaction).
-*                          If not provided, creates a new auditor.
-*/
-async function processEndpointAudits(endpoint, response, serviceDiscovery, logger, ctx, existingAuditor) {
-	try {
-		const audits = endpoint.audits;
-		const hasExistingRecords = existingAuditor && existingAuditor.getRecords().length > 0;
-		if (!audits?.length && !hasExistingRecords) {
-			logger.debug("No audits to process");
-			return;
-		}
-		if (!endpoint.auditorStorageService) {
-			if (hasExistingRecords || audits?.length) logger.warn("No auditor storage service available");
-			return;
-		}
-		let auditor;
-		if (existingAuditor) {
-			auditor = existingAuditor;
-			logger.debug("Using existing auditor from handler context");
-		} else {
-			const services = await serviceDiscovery.register([endpoint.auditorStorageService]);
-			const storage = services[endpoint.auditorStorageService.serviceName];
-			let actor = {
-				id: "system",
-				type: "system"
-			};
-			if (endpoint.actorExtractor) try {
-				actor = await endpoint.actorExtractor({
-					services: ctx.services,
-					session: ctx.session,
-					header: ctx.header,
-					cookie: ctx.cookie,
-					logger
-				});
-			} catch (error) {
-				logger.error(error, "Failed to extract actor for audits");
-			}
-			auditor = new __geekmidas_audit.DefaultAuditor({
-				actor,
-				storage,
-				metadata: {
-					endpoint: endpoint.route,
-					method: endpoint.method
-				}
-			});
-		}
-		if (audits?.length) for (const audit of audits) {
-			logger.debug({ audit: audit.type }, "Processing declarative audit");
-			if (audit.when && !audit.when(response)) {
-				logger.debug({ audit: audit.type }, "Audit skipped due to when condition");
-				continue;
-			}
-			const payload = audit.payload(response);
-			const entityId = audit.entityId?.(response);
-			auditor.audit(audit.type, payload, {
-				table: audit.table,
-				entityId
-			});
-		}
-		const recordCount = auditor.getRecords().length;
-		if (recordCount > 0) {
-			const trx = "getTransaction" in auditor ? auditor.getTransaction() : void 0;
-			logger.debug({
-				auditCount: recordCount,
-				hasTransaction: !!trx
-			}, "Flushing audits");
-			await auditor.flush();
-		}
-	} catch (error) {
-		logger.error(error, "Failed to process audits");
-	}
-}
-/**
-* Create audit context for handler execution.
-* Returns the auditor and storage for use in the handler.
-*
-* @param endpoint - The endpoint with audit configuration
-* @param serviceDiscovery - Service discovery for getting audit storage
-* @param logger - Logger for debug/error messages
-* @param ctx - Request context for actor extraction
-* @returns Audit context with auditor and storage, or undefined if not configured
-*/
-async function createAuditContext(endpoint, serviceDiscovery, logger, ctx) {
-	if (!endpoint.auditorStorageService) return void 0;
-	const services = await serviceDiscovery.register([endpoint.auditorStorageService]);
-	const storage = services[endpoint.auditorStorageService.serviceName];
-	let actor = {
-		id: "system",
-		type: "system"
-	};
-	if (endpoint.actorExtractor) try {
-		actor = await endpoint.actorExtractor({
-			services: ctx.services,
-			session: ctx.session,
-			header: ctx.header,
-			cookie: ctx.cookie,
-			logger
-		});
-	} catch (error) {
-		logger.error(error, "Failed to extract actor for audits");
-	}
-	const auditor = new __geekmidas_audit.DefaultAuditor({
-		actor,
-		storage,
-		metadata: {
-			endpoint: endpoint.route,
-			method: endpoint.method
-		}
-	});
-	return {
-		auditor,
-		storage
-	};
-}
-/**
-* Execute a handler with automatic audit transaction support.
-* If the audit storage provides a withTransaction method, wraps execution
-* in a transaction so audits are atomic with handler's database operations.
-*
-* This is database-agnostic - each storage implementation provides its own
-* transaction handling based on the underlying database (Kysely, Drizzle, etc.).
-*
-* If the db parameter is provided and is already a transaction, the storage
-* will reuse it instead of creating a nested transaction (similar to
-* packages/db/src/kysely.ts#withTransaction).
-*
-* @param auditContext - The audit context from createAuditContext
-* @param handler - The handler function to execute (receives auditor)
-* @param onComplete - Called after handler with response, to process declarative audits
-* @param options - Optional configuration including database connection
-* @returns The handler result
-*/
-async function executeWithAuditTransaction(auditContext, handler, onComplete, options) {
-	if (!auditContext) return handler(void 0);
-	const { auditor, storage } = auditContext;
-	if (storage.withTransaction) return storage.withTransaction(auditor, async () => {
-		const response$1 = await handler(auditor);
-		if (onComplete) await onComplete(response$1, auditor);
-		return response$1;
-	}, options?.db);
-	const response = await handler(auditor);
-	if (onComplete) await onComplete(response, auditor);
-	await auditor.flush();
-	return response;
-}
-
-//#endregion
-Object.defineProperty(exports, 'createAuditContext', {
-  enumerable: true,
-  get: function () {
-    return createAuditContext;
-  }
-});
-Object.defineProperty(exports, 'executeWithAuditTransaction', {
-  enumerable: true,
-  get: function () {
-    return executeWithAuditTransaction;
-  }
-});
-Object.defineProperty(exports, 'processEndpointAudits', {
-  enumerable: true,
-  get: function () {
-    return processEndpointAudits;
-  }
-});
-//# sourceMappingURL=processAudits-CzHkPokQ.cjs.map

package/dist/processAudits-CzHkPokQ.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"processAudits-CzHkPokQ.cjs","names":["endpoint: Endpoint<\n\t\tany,\n\t\tany,\n\t\tany,\n\t\tOutSchema,\n\t\tTServices,\n\t\tTLogger,\n\t\tTSession,\n\t\tany,\n\t\tany,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction\n\t>","response: InferStandardSchema<OutSchema>","serviceDiscovery: ServiceDiscovery<any>","logger: TLogger","ctx: {\n\t\tsession: TSession;\n\t\theader: HeaderFn;\n\t\tcookie: CookieFn;\n\t\tservices: Record<string, unknown>;\n\t}","existingAuditor?: Auditor<TAuditAction>","auditor: Auditor<TAuditAction>","actor: AuditActor","DefaultAuditor","endpoint: Endpoint<\n\t\tany,\n\t\tany,\n\t\tany,\n\t\tany,\n\t\tTServices,\n\t\tTLogger,\n\t\tTSession,\n\t\tany,\n\t\tany,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t>","auditContext: AuditExecutionContext<TAuditAction> | undefined","handler: (auditor?: Auditor<TAuditAction>) => Promise<T>","onComplete?: (response: T, auditor: Auditor<TAuditAction>) => Promise<void>","options?: ExecuteWithAuditTransactionOptions","response"],"sources":["../src/endpoints/processAudits.ts"],"sourcesContent":["import type {\n\tAuditActor,\n\tAuditableAction,\n\tAuditor,\n\tAuditStorage,\n} from '@geekmidas/audit';\nimport { DefaultAuditor } from '@geekmidas/audit';\nimport type { Logger } from '@geekmidas/logger';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceDiscovery } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { ActorExtractor, MappedAudit } from './audit';\nimport type { CookieFn, Endpoint, HeaderFn } from './Endpoint';\n\n/**\n * Process declarative audit definitions after successful endpoint execution.\n * Similar to publishConstructEvents for events.\n *\n * @param endpoint - The endpoint with audit configuration\n * @param response - The handler response to generate audit payloads from\n * @param serviceDiscovery - Service discovery for registering audit storage\n * @param logger - Logger for debug/error messages\n * @param ctx - Request context (session, headers, cookies, services)\n * @param existingAuditor - Optional existing auditor instance (e.g., from handler context).\n *                          If provided, uses this auditor (with its stored transaction).\n *                          If not provided, creates a new auditor.\n */\nexport async function processEndpointAudits<\n\tTServices extends Service[] = [],\n\tTSession = unknown,\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTAuditStorage extends AuditStorage | undefined = undefined,\n\tTAuditStorageServiceName extends string = string,\n\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\tstring,\n\t\tunknown\n\t>,\n>(\n\tendpoint: Endpoint<\n\t\tany,\n\t\tany,\n\t\tany,\n\t\tOutSchema,\n\t\tTServices,\n\t\tTLogger,\n\t\tTSession,\n\t\tany,\n\t\tany,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction\n\t>,\n\tresponse: InferStandardSchema<OutSchema>,\n\tserviceDiscovery: ServiceDiscovery<any>,\n\tlogger: TLogger,\n\tctx: {\n\t\tsession: TSession;\n\t\theader: HeaderFn;\n\t\tcookie: CookieFn;\n\t\tservices: Record<string, unknown>;\n\t},\n\texistingAuditor?: Auditor<TAuditAction>,\n): Promise<void> {\n\ttry {\n\t\tconst audits = endpoint.audits as MappedAudit<TAuditAction, OutSchema>[];\n\n\t\t// If we have an existing auditor (from handler context), we need to flush\n\t\t// any manual audits it collected, even if there are no declarative audits\n\t\tconst hasExistingRecords =\n\t\t\texistingAuditor && existingAuditor.getRecords().length > 0;\n\n\t\t// Skip if no declarative audits and no existing records to flush\n\t\tif (!audits?.length && !hasExistingRecords) {\n\t\t\tlogger.debug('No audits to process');\n\t\t\treturn;\n\t\t}\n\n\t\t// If no auditor storage service and we have things to process, warn\n\t\tif (!endpoint.auditorStorageService) {\n\t\t\tif (hasExistingRecords || audits?.length) {\n\t\t\t\tlogger.warn('No auditor storage service available');\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\t// Get or create auditor\n\t\tlet auditor: Auditor<TAuditAction>;\n\n\t\tif (existingAuditor) {\n\t\t\t// Use existing auditor (preserves stored transaction and manual audits)\n\t\t\tauditor = existingAuditor;\n\t\t\tlogger.debug('Using existing auditor from handler context');\n\t\t} else {\n\t\t\t// Create new auditor (backward compatibility)\n\t\t\tconst services = await serviceDiscovery.register([\n\t\t\t\tendpoint.auditorStorageService,\n\t\t\t]);\n\t\t\tconst storage = services[\n\t\t\t\tendpoint.auditorStorageService.serviceName\n\t\t\t] as AuditStorage;\n\n\t\t\t// Extract actor if configured\n\t\t\tlet actor: AuditActor = { id: 'system', type: 'system' };\n\t\t\tif (endpoint.actorExtractor) {\n\t\t\t\ttry {\n\t\t\t\t\tactor = await (\n\t\t\t\t\t\tendpoint.actorExtractor as ActorExtractor<\n\t\t\t\t\t\t\tTServices,\n\t\t\t\t\t\t\tTSession,\n\t\t\t\t\t\t\tTLogger\n\t\t\t\t\t\t>\n\t\t\t\t\t)({\n\t\t\t\t\t\tservices: ctx.services as any,\n\t\t\t\t\t\tsession: ctx.session,\n\t\t\t\t\t\theader: ctx.header,\n\t\t\t\t\t\tcookie: ctx.cookie,\n\t\t\t\t\t\tlogger,\n\t\t\t\t\t});\n\t\t\t\t} catch (error) {\n\t\t\t\t\tlogger.error(error as Error, 'Failed to extract actor for audits');\n\t\t\t\t\t// Continue with system actor\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tauditor = new DefaultAuditor<TAuditAction>({\n\t\t\t\tactor,\n\t\t\t\tstorage,\n\t\t\t\tmetadata: {\n\t\t\t\t\tendpoint: endpoint.route,\n\t\t\t\t\tmethod: endpoint.method,\n\t\t\t\t},\n\t\t\t});\n\t\t}\n\n\t\t// Process each declarative audit\n\t\tif (audits?.length) {\n\t\t\tfor (const audit of audits) {\n\t\t\t\tlogger.debug({ audit: audit.type }, 'Processing declarative audit');\n\n\t\t\t\t// Check when condition\n\t\t\t\tif (audit.when && !audit.when(response as any)) {\n\t\t\t\t\tlogger.debug(\n\t\t\t\t\t\t{ audit: audit.type },\n\t\t\t\t\t\t'Audit skipped due to when condition',\n\t\t\t\t\t);\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\t// Extract payload\n\t\t\t\tconst payload = audit.payload(response as any);\n\n\t\t\t\t// Extract entityId if configured\n\t\t\t\tconst entityId = audit.entityId?.(response as any);\n\n\t\t\t\t// Record the audit\n\t\t\t\tauditor.audit(audit.type as any, payload as any, {\n\t\t\t\t\ttable: audit.table,\n\t\t\t\t\tentityId,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\t// Flush audits to storage\n\t\t// Note: If existingAuditor has a stored transaction (via setTransaction),\n\t\t// flush() will use it automatically\n\t\tconst recordCount = auditor.getRecords().length;\n\t\tif (recordCount > 0) {\n\t\t\t// Check if auditor has a stored transaction (for logging purposes)\n\t\t\tconst trx =\n\t\t\t\t'getTransaction' in auditor\n\t\t\t\t\t? (auditor as { getTransaction(): unknown }).getTransaction()\n\t\t\t\t\t: undefined;\n\t\t\tlogger.debug(\n\t\t\t\t{ auditCount: recordCount, hasTransaction: !!trx },\n\t\t\t\t'Flushing audits',\n\t\t\t);\n\t\t\tawait auditor.flush();\n\t\t}\n\t} catch (error) {\n\t\tlogger.error(error as Error, 'Failed to process audits');\n\t\t// Don't rethrow - audit failures shouldn't fail the request\n\t}\n}\n\n/**\n * Context for audit-aware handler execution.\n */\nexport interface AuditExecutionContext<\n\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\tstring,\n\t\tunknown\n\t>,\n> {\n\t/** The auditor instance for recording audits */\n\tauditor: Auditor<TAuditAction>;\n\t/** The audit storage instance */\n\tstorage: AuditStorage;\n}\n\n/**\n * Create audit context for handler execution.\n * Returns the auditor and storage for use in the handler.\n *\n * @param endpoint - The endpoint with audit configuration\n * @param serviceDiscovery - Service discovery for getting audit storage\n * @param logger - Logger for debug/error messages\n * @param ctx - Request context for actor extraction\n * @returns Audit context with auditor and storage, or undefined if not configured\n */\nexport async function createAuditContext<\n\tTServices extends Service[] = [],\n\tTSession = unknown,\n\tTLogger extends Logger = Logger,\n\tTAuditStorage extends AuditStorage | undefined = undefined,\n\tTAuditStorageServiceName extends string = string,\n\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\tstring,\n\t\tunknown\n\t>,\n\tTDatabase = undefined,\n\tTDatabaseServiceName extends string = string,\n>(\n\tendpoint: Endpoint<\n\t\tany,\n\t\tany,\n\t\tany,\n\t\tany,\n\t\tTServices,\n\t\tTLogger,\n\t\tTSession,\n\t\tany,\n\t\tany,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t>,\n\tserviceDiscovery: ServiceDiscovery<any>,\n\tlogger: TLogger,\n\tctx: {\n\t\tsession: TSession;\n\t\theader: HeaderFn;\n\t\tcookie: CookieFn;\n\t\tservices: Record<string, unknown>;\n\t},\n): Promise<AuditExecutionContext<TAuditAction> | undefined> {\n\tif (!endpoint.auditorStorageService) {\n\t\treturn undefined;\n\t}\n\n\tconst services = await serviceDiscovery.register([\n\t\tendpoint.auditorStorageService,\n\t]);\n\tconst storage = services[\n\t\tendpoint.auditorStorageService.serviceName\n\t] as AuditStorage;\n\n\t// Extract actor if configured\n\tlet actor: AuditActor = { id: 'system', type: 'system' };\n\tif (endpoint.actorExtractor) {\n\t\ttry {\n\t\t\tactor = await (\n\t\t\t\tendpoint.actorExtractor as ActorExtractor<TServices, TSession, TLogger>\n\t\t\t)({\n\t\t\t\tservices: ctx.services as any,\n\t\t\t\tsession: ctx.session,\n\t\t\t\theader: ctx.header,\n\t\t\t\tcookie: ctx.cookie,\n\t\t\t\tlogger,\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tlogger.error(error as Error, 'Failed to extract actor for audits');\n\t\t}\n\t}\n\n\tconst auditor = new DefaultAuditor<TAuditAction>({\n\t\tactor,\n\t\tstorage,\n\t\tmetadata: {\n\t\t\tendpoint: endpoint.route,\n\t\t\tmethod: endpoint.method,\n\t\t},\n\t});\n\n\treturn { auditor, storage };\n}\n\n/**\n * Options for executeWithAuditTransaction.\n */\nexport interface ExecuteWithAuditTransactionOptions {\n\t/**\n\t * Database connection to use for the transaction.\n\t * If this is already a transaction, it will be reused instead of creating a nested one.\n\t * If not provided, the storage's internal database is used.\n\t */\n\tdb?: unknown;\n}\n\n/**\n * Execute a handler with automatic audit transaction support.\n * If the audit storage provides a withTransaction method, wraps execution\n * in a transaction so audits are atomic with handler's database operations.\n *\n * This is database-agnostic - each storage implementation provides its own\n * transaction handling based on the underlying database (Kysely, Drizzle, etc.).\n *\n * If the db parameter is provided and is already a transaction, the storage\n * will reuse it instead of creating a nested transaction (similar to\n * packages/db/src/kysely.ts#withTransaction).\n *\n * @param auditContext - The audit context from createAuditContext\n * @param handler - The handler function to execute (receives auditor)\n * @param onComplete - Called after handler with response, to process declarative audits\n * @param options - Optional configuration including database connection\n * @returns The handler result\n */\nexport async function executeWithAuditTransaction<\n\tT,\n\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\tstring,\n\t\tunknown\n\t>,\n>(\n\tauditContext: AuditExecutionContext<TAuditAction> | undefined,\n\thandler: (auditor?: Auditor<TAuditAction>) => Promise<T>,\n\tonComplete?: (response: T, auditor: Auditor<TAuditAction>) => Promise<void>,\n\toptions?: ExecuteWithAuditTransactionOptions,\n): Promise<T> {\n\t// No audit context - just run handler\n\tif (!auditContext) {\n\t\treturn handler(undefined);\n\t}\n\n\tconst { auditor, storage } = auditContext;\n\n\t// Check if storage provides a transaction wrapper\n\tif (storage.withTransaction) {\n\t\t// Wrap in transaction - audits are atomic with handler operations\n\t\t// The storage's withTransaction handles setTransaction and flush\n\t\t// Pass db so existing transactions are reused\n\t\treturn storage.withTransaction(\n\t\t\tauditor,\n\t\t\tasync () => {\n\t\t\t\tconst response = await handler(auditor);\n\n\t\t\t\t// Process declarative audits within the transaction\n\t\t\t\tif (onComplete) {\n\t\t\t\t\tawait onComplete(response, auditor);\n\t\t\t\t}\n\n\t\t\t\treturn response;\n\t\t\t},\n\t\t\toptions?.db,\n\t\t);\n\t}\n\n\t// No transaction support - run handler and flush audits after\n\tconst response = await handler(auditor);\n\n\tif (onComplete) {\n\t\tawait onComplete(response, auditor);\n\t}\n\n\t// Flush audits (no transaction)\n\tawait auditor.flush();\n\n\treturn response;\n}\n"],"mappings":"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"}