@geekmidas/constructs 3.0.6 → 3.0.8

package/src/endpoints/MswEndpointAdaptor.ts

@@ -0,0 +1,226 @@
+import { EnvironmentParser } from '@geekmidas/envkit';
+import type { Service } from '@geekmidas/services';
+import { ServiceDiscovery } from '@geekmidas/services';
+import { Hono } from 'hono';
+import { type HttpHandler, http } from 'msw';
+import type { Endpoint } from './Endpoint';
+import { HonoEndpoint } from './HonoEndpointAdaptor';
+
+/**
+ * Header used to identify which test context a request belongs to.
+ * Each concurrent test registers its own context (services, db transaction, etc.)
+ * and the MSW handler looks it up by this header value.
+ */
+export const TEST_CONTEXT_HEADER = 'x-test-context-id';
+
+/**
+ * Per-test context containing an isolated ServiceDiscovery instance.
+ * Registered in the context map and looked up per-request via the context ID header.
+ */
+export interface MswTestContext {
+	serviceDiscovery: ServiceDiscovery<any>;
+}
+
+/**
+ * Options for creating MSW handlers from endpoint constructs.
+ *
+ * @example
+ * ```typescript
+ * import { createMswHandlers, registerTestContext } from '@geekmidas/constructs/testing';
+ * import { setupServer } from 'msw/node';
+ *
+ * // Create handlers once (global)
+ * const { handlers, registerContext, removeContext } = createMswHandlers(
+ *   [getUsers, createUser],
+ *   { baseURL: 'http://localhost:3000' },
+ * );
+ * const server = setupServer(...handlers);
+ *
+ * // Per test: register an isolated context with its own services/transaction
+ * it('should list users', async ({ db }) => {
+ *   const contextId = crypto.randomUUID();
+ *   registerContext(contextId, {
+ *     services: { database: db, auth: mockAuth },
+ *   });
+ *
+ *   const api = createApi({
+ *     baseURL: 'http://localhost:3000',
+ *     headers: { [TEST_CONTEXT_HEADER]: contextId },
+ *   });
+ *
+ *   const result = await api('GET /users');
+ *   expect(result).toBeDefined();
+ *
+ *   removeContext(contextId);
+ * });
+ * ```
+ */
+export interface CreateMswHandlersOptions {
+	/** Base URL the client fetches from (e.g., 'http://localhost:3000') */
+	baseURL: string;
+}
+
+/**
+ * Options for registering a per-test context.
+ * Follows the same pattern as TestRequestAdaptor — services, database,
+ * publisher, and auditorStorage are provided explicitly.
+ */
+export interface RegisterContextOptions {
+	/** Service instances keyed by serviceName */
+	services?: Record<string, unknown>;
+	/** Database instance — required when endpoints use .database() */
+	database?: unknown;
+	/** Event publisher service definition */
+	publisher?: Service;
+	/** Audit storage instance — required when endpoints use .auditor() */
+	auditorStorage?: unknown;
+}
+
+const MSW_HTTP_METHODS = [
+	'get',
+	'post',
+	'put',
+	'patch',
+	'delete',
+	'options',
+] as const;
+
+type MswHttpMethod = (typeof MSW_HTTP_METHODS)[number];
+
+/**
+ * Result of creating MSW handlers from endpoint constructs.
+ */
+export interface CreateMswHandlersResult {
+	/** MSW handlers to pass to setupServer() */
+	handlers: HttpHandler[];
+	/** Register an isolated context for a test */
+	registerContext: (id: string, options: RegisterContextOptions) => void;
+}
+
+/**
+ * Creates MSW HTTP handlers from endpoint constructs.
+ *
+ * Mounts endpoints on a Hono app and creates MSW handlers that intercept
+ * fetch requests and route them through `app.request()` — giving frontend
+ * tests full endpoint behavior (validation, auth, sessions) without HTTP.
+ *
+ * Each test registers its own isolated context via `registerContext()`,
+ * which is resolved per-request using the `x-test-context-id` header.
+ * This allows concurrent tests with their own transactions and services.
+ *
+ * @param endpoints - Array of endpoint constructs to create handlers for
+ * @param options - Configuration including baseURL
+ * @returns MSW handlers, the Hono app, and context management functions
+ */
+export function createMswHandlers(
+	endpoints: Endpoint<any, any, any, any, any, any>[],
+	options: CreateMswHandlersOptions,
+): CreateMswHandlersResult {
+	const { baseURL } = options;
+	const contexts = new Map<string, MswTestContext>();
+
+	/**
+	 * Register an isolated context for a test.
+	 * Creates a fresh ServiceDiscovery and pre-registers all provided services.
+	 */
+	function registerContext(id: string, ctxOptions: RegisterContextOptions) {
+		const envParser = new EnvironmentParser({});
+		const serviceDiscovery = new ServiceDiscovery(envParser);
+
+		const serviceDefs: Service[] = [];
+
+		// Register explicit services
+		if (ctxOptions.services) {
+			for (const [name, instance] of Object.entries(ctxOptions.services)) {
+				serviceDefs.push({
+					serviceName: name,
+					register: () => instance,
+				} as Service);
+			}
+		}
+
+		// Register database service from endpoint metadata
+		if (ctxOptions.database !== undefined) {
+			for (const endpoint of endpoints) {
+				if (endpoint.databaseService) {
+					serviceDefs.push({
+						serviceName: endpoint.databaseService.serviceName,
+						register: () => ctxOptions.database,
+					} as Service);
+					break;
+				}
+			}
+		}
+
+		// Register publisher service
+		if (ctxOptions.publisher) {
+			serviceDefs.push(ctxOptions.publisher);
+		}
+
+		// Register auditor storage service from endpoint metadata
+		if (ctxOptions.auditorStorage !== undefined) {
+			for (const endpoint of endpoints) {
+				if (endpoint.auditorStorageService) {
+					serviceDefs.push({
+						serviceName: endpoint.auditorStorageService.serviceName,
+						register: () => ctxOptions.auditorStorage,
+					} as Service);
+					break;
+				}
+			}
+		}
+
+		if (serviceDefs.length > 0) {
+			serviceDiscovery.register(serviceDefs);
+		}
+
+		contexts.set(id, { serviceDiscovery });
+	}
+
+	// Create a Hono app per-request that uses the correct ServiceDiscovery.
+	// We use a wrapper app that resolves the context from the header,
+	// then delegates to a context-specific Hono app.
+	const handlers: HttpHandler[] = [];
+
+	for (const endpoint of endpoints) {
+		const method = endpoint.method.toLowerCase() as MswHttpMethod;
+		if (!MSW_HTTP_METHODS.includes(method)) continue;
+
+		const mswUrl = `${baseURL}${endpoint.route}`;
+		const mswMethod = http[method];
+
+		handlers.push(
+			mswMethod(mswUrl, async ({ request }) => {
+				const contextId = request.headers.get(TEST_CONTEXT_HEADER);
+				const ctx = contextId ? contexts.get(contextId) : undefined;
+
+				if (!ctx) {
+					return new Response(
+						JSON.stringify({
+							error: 'Missing or unknown test context ID',
+							hint: `Set the '${TEST_CONTEXT_HEADER}' header to a registered context ID`,
+						}),
+						{ status: 500, headers: { 'content-type': 'application/json' } },
+					);
+				}
+
+				// Build a fresh Hono app with this context's ServiceDiscovery
+				const app = new Hono();
+				HonoEndpoint.addRoute(endpoint, ctx.serviceDiscovery as any, app);
+
+				const response = await app.request(request);
+
+				return new Response(response.body, {
+					status: response.status,
+					statusText: response.statusText,
+					headers: response.headers,
+				});
+			}),
+		);
+	}
+
+	return {
+		handlers,
+		registerContext,
+	};
+}

package/src/endpoints/__tests__/MswEndpointAdaptor.spec.ts

@@ -0,0 +1,211 @@
+import { setupServer } from 'msw/node';
+import { afterAll, afterEach, beforeAll, describe, expect, it } from 'vitest';
+import { z } from 'zod';
+import { e } from '../EndpointFactory';
+import { createMswHandlers, TEST_CONTEXT_HEADER } from '../MswEndpointAdaptor';
+
+const BASE_URL = 'http://localhost:3000';
+
+// --- Services ---
+
+interface UserDatabase {
+	listUsers(): { id: string; name: string }[];
+}
+
+const DatabaseService = {
+	serviceName: 'database' as const,
+	register: () => ({ listUsers: () => [] }) as UserDatabase,
+};
+
+// --- Endpoints ---
+
+const listUsers = e
+	.get('/users')
+	.services([DatabaseService])
+	.output(
+		z.object({
+			users: z.array(z.object({ id: z.string(), name: z.string() })),
+		}),
+	)
+	.handle(async ({ services }) => {
+		const users = services.database.listUsers();
+		return { users };
+	});
+
+const createUser = e
+	.post('/users')
+	.body(z.object({ name: z.string().min(1), email: z.string().email() }))
+	.output(z.object({ id: z.string(), name: z.string(), email: z.string() }))
+	.handle(async ({ body }) => ({
+		id: crypto.randomUUID(),
+		name: body.name,
+		email: body.email,
+	}));
+
+const getUser = e
+	.get('/users/:id')
+	.params(z.object({ id: z.string() }))
+	.output(z.object({ id: z.string(), name: z.string() }))
+	.handle(async ({ params }) => ({
+		id: params.id,
+		name: 'Test User',
+	}));
+
+const authorizedEndpoint = e
+	.get('/protected')
+	.output(z.object({ message: z.string() }))
+	.authorize(({ header }) => header('authorization') === 'Bearer valid-token')
+	.handle(async () => ({ message: 'secret' }));
+
+// --- Setup ---
+
+const { handlers, registerContext } = createMswHandlers(
+	[listUsers, createUser, getUser, authorizedEndpoint],
+	{ baseURL: BASE_URL },
+);
+
+const server = setupServer(...handlers);
+
+beforeAll(() => server.listen({ onUnhandledRequest: 'bypass' }));
+afterEach(() => server.resetHandlers());
+afterAll(() => server.close());
+
+// --- Tests ---
+
+describe('MswEndpointAdaptor', () => {
+	it('should handle a simple GET request', async () => {
+		const contextId = crypto.randomUUID();
+		registerContext(contextId, {
+			services: {
+				database: { listUsers: () => [{ id: '1', name: 'Alice' }] },
+			},
+		});
+
+		const response = await fetch(`${BASE_URL}/users`, {
+			headers: { [TEST_CONTEXT_HEADER]: contextId },
+		});
+
+		expect(response.status).toBe(200);
+		const body = await response.json();
+		expect(body.users).toEqual([{ id: '1', name: 'Alice' }]);
+	});
+
+	it('should handle POST with body validation', async () => {
+		const contextId = crypto.randomUUID();
+		registerContext(contextId, {});
+
+		const response = await fetch(`${BASE_URL}/users`, {
+			method: 'POST',
+			headers: {
+				'content-type': 'application/json',
+				[TEST_CONTEXT_HEADER]: contextId,
+			},
+			body: JSON.stringify({ name: 'Bob', email: 'bob@example.com' }),
+		});
+
+		expect(response.status).toBe(200);
+		const body = await response.json();
+		expect(body.name).toBe('Bob');
+		expect(body.email).toBe('bob@example.com');
+		expect(body.id).toBeDefined();
+	});
+
+	it('should reject invalid body with 422', async () => {
+		const contextId = crypto.randomUUID();
+		registerContext(contextId, {});
+
+		const response = await fetch(`${BASE_URL}/users`, {
+			method: 'POST',
+			headers: {
+				'content-type': 'application/json',
+				[TEST_CONTEXT_HEADER]: contextId,
+			},
+			body: JSON.stringify({ name: '', email: 'not-an-email' }),
+		});
+
+		expect(response.status).toBe(422);
+	});
+
+	it('should handle path params', async () => {
+		const contextId = crypto.randomUUID();
+		registerContext(contextId, {});
+
+		const response = await fetch(`${BASE_URL}/users/user-123`, {
+			headers: { [TEST_CONTEXT_HEADER]: contextId },
+		});
+
+		expect(response.status).toBe(200);
+		const body = await response.json();
+		expect(body.id).toBe('user-123');
+		expect(body.name).toBe('Test User');
+	});
+
+	it('should return 401 when authorization fails', async () => {
+		const contextId = crypto.randomUUID();
+		registerContext(contextId, {});
+
+		const response = await fetch(`${BASE_URL}/protected`, {
+			headers: {
+				[TEST_CONTEXT_HEADER]: contextId,
+				authorization: 'Bearer wrong-token',
+			},
+		});
+
+		expect(response.status).toBe(401);
+	});
+
+	it('should return 200 when authorization passes', async () => {
+		const contextId = crypto.randomUUID();
+		registerContext(contextId, {});
+
+		const response = await fetch(`${BASE_URL}/protected`, {
+			headers: {
+				[TEST_CONTEXT_HEADER]: contextId,
+				authorization: 'Bearer valid-token',
+			},
+		});
+
+		expect(response.status).toBe(200);
+		const body = await response.json();
+		expect(body.message).toBe('secret');
+	});
+
+	it('should return 500 when context ID is missing', async () => {
+		const response = await fetch(`${BASE_URL}/users`);
+
+		expect(response.status).toBe(500);
+		const body = await response.json();
+		expect(body.error).toContain('Missing or unknown test context ID');
+	});
+
+	it('should isolate concurrent contexts', async () => {
+		const contextA = crypto.randomUUID();
+		const contextB = crypto.randomUUID();
+
+		registerContext(contextA, {
+			services: {
+				database: { listUsers: () => [{ id: '1', name: 'From A' }] },
+			},
+		});
+		registerContext(contextB, {
+			services: {
+				database: { listUsers: () => [{ id: '2', name: 'From B' }] },
+			},
+		});
+
+		const [responseA, responseB] = await Promise.all([
+			fetch(`${BASE_URL}/users`, {
+				headers: { [TEST_CONTEXT_HEADER]: contextA },
+			}),
+			fetch(`${BASE_URL}/users`, {
+				headers: { [TEST_CONTEXT_HEADER]: contextB },
+			}),
+		]);
+
+		const bodyA = await responseA.json();
+		const bodyB = await responseB.json();
+
+		expect(bodyA.users).toEqual([{ id: '1', name: 'From A' }]);
+		expect(bodyB.users).toEqual([{ id: '2', name: 'From B' }]);
+	});
+});

package/tsdown.config.ts

@@ -1,3 +1,32 @@
 import { defineConfig } from 'tsdown';
 
-export default defineConfig({});
+export default defineConfig({
+	entry: [
+		'src/index.ts',
+		'src/types.ts',
+		'src/endpoints/index.ts',
+		'src/functions/index.ts',
+		'src/crons/index.ts',
+		'src/subscribers/index.ts',
+		'src/adaptors/hono.ts',
+		'src/adaptors/aws.ts',
+		'src/adaptors/testing.ts',
+	],
+	clean: true,
+	outDir: 'dist',
+	format: ['cjs', 'esm'],
+	sourcemap: true,
+	dts: true,
+	outExtensions: (ctx) => ({
+		js: ctx.format === 'es' ? '.mjs' : '.cjs',
+	}),
+	// Bundle lodash utilities — they are not hoisted to the workspace root
+	// and would fail to resolve when consumers load the dist from the root context.
+	noExternal: [
+		'lodash.compact',
+		'lodash.get',
+		'lodash.pick',
+		'lodash.set',
+		'lodash.uniqby',
+	],
+});

package/dist/AWSLambdaFunction-BF1gJJjG.d.mts

@@ -1,32 +0,0 @@
-import { Function, FunctionHandler } from "./Function-CZw1DRQ6.mjs";
-import { FunctionExecutionWrapper } from "./FunctionExecutionWrapper-C7yYXIq-.mjs";
-import { Service } from "@geekmidas/services";
-import { AuditStorage, AuditableAction } from "@geekmidas/audit";
-import { EnvironmentParser } from "@geekmidas/envkit";
-import { EventPublisher } from "@geekmidas/events";
-import { Logger } from "@geekmidas/logger";
-import { StandardSchemaV1 } from "@standard-schema/spec";
-import { Handler } from "aws-lambda";
-import { ComposableStandardSchema } from "@geekmidas/schema";
-
-//#region src/functions/AWSLambdaFunction.d.ts
-type AWSLambdaHandler<TEvent = any, TResult = any> = Handler<TEvent, TResult>;
-declare class AWSLambdaFunction<TInput extends ComposableStandardSchema | undefined = undefined, TOutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TDatabase = undefined, TDatabaseServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> extends FunctionExecutionWrapper<TInput, TOutSchema, TServices, TLogger, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction> {
-  readonly fn: Function<TInput, TServices, TLogger, TOutSchema, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction, FunctionHandler<TInput, TServices, TLogger, TOutSchema, TDatabase, TAuditStorage, TAuditAction>>;
-  constructor(envParser: EnvironmentParser<{}>, fn: Function<TInput, TServices, TLogger, TOutSchema, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction, FunctionHandler<TInput, TServices, TLogger, TOutSchema, TDatabase, TAuditStorage, TAuditAction>>);
-  private error;
-  private baseInput;
-  private input;
-  private loggerMiddleware;
-  private services;
-  private database;
-  private auditor;
-  private events;
-  private _handler;
-  get handler(): AWSLambdaHandler;
-}
-//# sourceMappingURL=AWSLambdaFunction.d.ts.map
-
-//#endregion
-export { AWSLambdaFunction, AWSLambdaHandler };
-//# sourceMappingURL=AWSLambdaFunction-BF1gJJjG.d.mts.map

package/dist/AWSLambdaFunction-BF1gJJjG.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AWSLambdaFunction-BF1gJJjG.d.mts","names":[],"sources":["../src/functions/AWSLambdaFunction.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;KAmBY,gDAAgD,QAC3D,QACA;cAuCY,iCACG,qEACI,4DACD,gCACF,SAAS,gCACD,uHAEF,kLAID,mCAAmC,0CAI/C,yBACT,QACA,YACA,WACA,SACA,iBACA,4BACA,eACA,0BACA,WACA,sBACA;EAnEW,SAAA,EAAA,EAuEY,QAvEI,CAwEzB,MAxEyB,EAyEzB,SAzEyB,EA0EzB,OA1EyB,EA2EzB,UA3EyB,EA4EzB,eA5EyB,EA6EzB,0BA7EyB,EA8EzB,aA9EyB,EA+EzB,wBA/EyB,EAgFzB,SAhFyB,EAiFzB,oBAjFyB,EAkFzB,YAlFyB,EAmFzB,eAnFyB,CAoFxB,MApFwB,EAqFxB,SArFwB,EAsFxB,OAtFwB,EAuFxB,UAvFwB,EAwFxB,SAxFwB,EAyFxB,aAzFwB,EA0FxB,YA1FwB,CAAA,CAAA;EAAA,WAAA,CAAA,SAAA,EAsEf,iBAtEe,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,EAuEJ,QAvEI,CAwEzB,MAxEyB,EAyEzB,SAzEyB,EA0EzB,OA1EyB,EA2EzB,UA3EyB,EA4EzB,eA5EyB,EA6EzB,0BA7EyB,EA8EzB,aA9EyB,EA+EzB,wBA/EyB,EAgFzB,SAhFyB,EAiFzB,oBAjFyB,EAkFzB,YAlFyB,EAmFzB,eAnFyB,CAoFxB,MApFwB,EAqFxB,SArFwB,EAsFxB,OAtFwB,EAuFxB,UAvFwB,EAwFxB,SAxFwB,EAyFxB,aAzFwB,EA0FxB,YA1FwB,CAAA,CAAA;EAAA,QAC3B,KAAA;EAAM,QACN,SAAA;EAAO,QAFoD,KAAA;EAAO,QAAA,gBAAA;EAyCtD,QAAA,QAAA;EAAiB,QAAA,QAAA;EAAA,QACd,OAAA;EAAwB,QACpB,MAAA;EAAgB,QACjB,QAAA;EAAO,IACT,OAAA,CAAA,CAAA,EAgQD,gBAhQC"}

package/dist/AWSLambdaFunction-CPEAl5nZ.cjs

@@ -1,120 +0,0 @@
-const require_chunk = require('./chunk-CUT6urMc.cjs');
-const require_FunctionBuilder = require('./FunctionBuilder-C_xG9As7.cjs');
-const require_FunctionExecutionWrapper = require('./FunctionExecutionWrapper-KKHP6fDY.cjs');
-const __middy_core = require_chunk.__toESM(require("@middy/core"));
-const __geekmidas_errors = require_chunk.__toESM(require("@geekmidas/errors"));
-const __geekmidas_services = require_chunk.__toESM(require("@geekmidas/services"));
-
-//#region src/functions/AWSLambdaFunction.ts
-var AWSLambdaFunction = class extends require_FunctionExecutionWrapper.FunctionExecutionWrapper {
-	constructor(envParser, fn) {
-		super(envParser, fn);
-		this.fn = fn;
-	}
-	error() {
-		return { onError: (req) => {
-			const logger = req.event?.logger || this.fn.logger;
-			logger.error(req.error || {}, "Error processing function");
-			throw (0, __geekmidas_errors.wrapError)(req.error);
-		} };
-	}
-	baseInput() {
-		return { before: (_req) => {} };
-	}
-	input() {
-		return { before: async (req) => {
-			try {
-				if (this.fn.input) {
-					const parsedInput = await require_FunctionBuilder.FunctionBuilder.parseComposableStandardSchema(req.event, this.fn.input);
-					req.event.parsedInput = parsedInput;
-				} else req.event.parsedInput = req.event;
-			} catch (error) {
-				this.logger.error({
-					error,
-					event: req.event
-				}, "Failed to parse input");
-				throw error;
-			}
-		} };
-	}
-	loggerMiddleware() {
-		return { before: (req) => {
-			this._logger = this.fn.logger.child({
-				fn: {
-					name: req.context.functionName,
-					version: req.context.functionVersion,
-					memory: req.context.memoryLimitInMB
-				},
-				req: { id: req.context.awsRequestId }
-			});
-			req.event.logger = this._logger;
-		} };
-	}
-	services() {
-		return { before: async (req) => {
-			req.event.services = await this.getServices();
-		} };
-	}
-	database() {
-		return { before: async (req) => {
-			req.event.db = await this.getDatabase();
-		} };
-	}
-	auditor() {
-		return {
-			before: async (req) => {
-				req.event.auditor = await this.createAuditor();
-			},
-			after: async (req) => {
-				if (req.event.auditor) {
-					const records = req.event.auditor.getRecords();
-					if (records.length > 0) {
-						this.logger.debug({ auditCount: records.length }, "Flushing function audits");
-						await req.event.auditor.flush();
-					}
-				}
-			}
-		};
-	}
-	events() {
-		return { after: async (req) => {
-			const response = req.response || void 0;
-			await this.publishEvents(response);
-		} };
-	}
-	async _handler(event) {
-		const result = await this.fn.fn({
-			input: event.parsedInput,
-			services: event.services,
-			logger: event.logger,
-			db: event.db,
-			auditor: event.auditor
-		});
-		const output = await this.fn.parseOutput(result);
-		return output;
-	}
-	get handler() {
-		const handler = this._handler.bind(this);
-		const chain = (0, __middy_core.default)(handler).use(this.loggerMiddleware()).use(this.baseInput()).use(this.error()).use(this.services()).use(this.database()).use(this.auditor()).use(this.input()).use(this.events());
-		const wrappedHandler = async (event, context) => {
-			const startTime = Date.now();
-			const requestId = context.awsRequestId;
-			const logger = this.fn.logger.child({ requestId });
-			return (0, __geekmidas_services.runWithRequestContext)({
-				logger,
-				requestId,
-				startTime
-			}, () => chain(event, context));
-		};
-		return wrappedHandler;
-	}
-};
-
-//#endregion
-Object.defineProperty(exports, 'AWSLambdaFunction', {
-  enumerable: true,
-  get: function () {
-    return AWSLambdaFunction;
-  }
-});
-//# sourceMappingURL=AWSLambdaFunction-CPEAl5nZ.cjs.map

package/dist/AWSLambdaFunction-CPEAl5nZ.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"AWSLambdaFunction-CPEAl5nZ.cjs","names":["FunctionExecutionWrapper","envParser: EnvironmentParser<{}>","fn: Function<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTAuditAction,\n\t\t\tFunctionHandler<\n\t\t\t\tTInput,\n\t\t\t\tTServices,\n\t\t\t\tTLogger,\n\t\t\t\tTOutSchema,\n\t\t\t\tTDatabase,\n\t\t\t\tTAuditStorage,\n\t\t\t\tTAuditAction\n\t\t\t>\n\t\t>","event: FunctionEvent<\n\t\t\tTEvent,\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTDatabase,\n\t\t\tTAuditAction\n\t\t>","event: unknown","context: Context"],"sources":["../src/functions/AWSLambdaFunction.ts"],"sourcesContent":["import type { AuditableAction, Auditor, AuditStorage } from '@geekmidas/audit';\nimport type { EnvironmentParser } from '@geekmidas/envkit';\nimport { wrapError } from '@geekmidas/errors';\nimport type { EventPublisher } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport type {\n\tComposableStandardSchema,\n\tInferComposableStandardSchema,\n\tInferStandardSchema,\n} from '@geekmidas/schema';\nimport type { Service, ServiceRecord } from '@geekmidas/services';\nimport { runWithRequestContext } from '@geekmidas/services';\nimport middy, { type MiddlewareObj } from '@middy/core';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { Context, Handler } from 'aws-lambda';\nimport type { Function, FunctionHandler } from './Function';\nimport { FunctionBuilder } from './FunctionBuilder';\nimport { FunctionExecutionWrapper } from './FunctionExecutionWrapper';\n\nexport type AWSLambdaHandler<TEvent = any, TResult = any> = Handler<\n\tTEvent,\n\tTResult\n>;\n\ntype FunctionEvent<\n\tTEvent,\n\tTInput extends ComposableStandardSchema | undefined,\n\tTServices extends Service[],\n\tTLogger extends Logger,\n\tTDatabase = undefined,\n\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\tstring,\n\t\tunknown\n\t>,\n> = TEvent & {\n\tparsedInput: InferComposableStandardSchema<TInput>;\n\tservices: ServiceRecord<TServices>;\n\tlogger: TLogger;\n\tdb: TDatabase | undefined;\n\tauditor: Auditor<TAuditAction> | undefined;\n};\n\ntype Middleware<\n\tTEvent,\n\tTInput extends ComposableStandardSchema | undefined,\n\tTServices extends Service[],\n\tTLogger extends Logger,\n\tTOutSchema extends StandardSchemaV1 | undefined,\n\tTDatabase = undefined,\n\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\tstring,\n\t\tunknown\n\t>,\n> = MiddlewareObj<\n\tFunctionEvent<TEvent, TInput, TServices, TLogger, TDatabase, TAuditAction>,\n\tInferComposableStandardSchema<TOutSchema>,\n\tError,\n\tContext\n>;\n\nexport class AWSLambdaFunction<\n\tTInput extends ComposableStandardSchema | undefined = undefined,\n\tTOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTAuditStorage extends AuditStorage | undefined = undefined,\n\tTAuditStorageServiceName extends string = string,\n\tTDatabase = undefined,\n\tTDatabaseServiceName extends string = string,\n\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\tstring,\n\t\tunknown\n\t>,\n> extends FunctionExecutionWrapper<\n\tTInput,\n\tTOutSchema,\n\tTServices,\n\tTLogger,\n\tTEventPublisher,\n\tTEventPublisherServiceName,\n\tTAuditStorage,\n\tTAuditStorageServiceName,\n\tTDatabase,\n\tTDatabaseServiceName,\n\tTAuditAction\n> {\n\tconstructor(\n\t\tenvParser: EnvironmentParser<{}>,\n\t\toverride readonly fn: Function<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTAuditAction,\n\t\t\tFunctionHandler<\n\t\t\t\tTInput,\n\t\t\t\tTServices,\n\t\t\t\tTLogger,\n\t\t\t\tTOutSchema,\n\t\t\t\tTDatabase,\n\t\t\t\tTAuditStorage,\n\t\t\t\tTAuditAction\n\t\t\t>\n\t\t>,\n\t) {\n\t\tsuper(envParser, fn);\n\t}\n\n\tprivate error<TEvent>(): Middleware<\n\t\tTEvent,\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tTOutSchema,\n\t\tTDatabase,\n\t\tTAuditAction\n\t> {\n\t\treturn {\n\t\t\tonError: (req) => {\n\t\t\t\tconst logger = req.event?.logger || this.fn.logger;\n\t\t\t\tlogger.error(req.error || {}, 'Error processing function');\n\n\t\t\t\t// Re-throw the wrapped error to let Lambda handle it\n\t\t\t\tthrow wrapError(req.error);\n\t\t\t},\n\t\t};\n\t}\n\n\tprivate baseInput<TEvent>(): Middleware<\n\t\tTEvent,\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tTOutSchema,\n\t\tTDatabase,\n\t\tTAuditAction\n\t> {\n\t\treturn {\n\t\t\tbefore: (_req) => {},\n\t\t};\n\t}\n\n\tprivate input<\n\t\tTEvent extends { input: InferComposableStandardSchema<TInput> },\n\t>(): Middleware<\n\t\tTEvent,\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tTOutSchema,\n\t\tTDatabase,\n\t\tTAuditAction\n\t> {\n\t\treturn {\n\t\t\tbefore: async (req) => {\n\t\t\t\ttry {\n\t\t\t\t\t// Parse input if schema is provided\n\t\t\t\t\tif (this.fn.input) {\n\t\t\t\t\t\tconst parsedInput =\n\t\t\t\t\t\t\tawait FunctionBuilder.parseComposableStandardSchema(\n\t\t\t\t\t\t\t\treq.event,\n\t\t\t\t\t\t\t\tthis.fn.input,\n\t\t\t\t\t\t\t);\n\n\t\t\t\t\t\treq.event.parsedInput =\n\t\t\t\t\t\t\tparsedInput as InferComposableStandardSchema<TInput>;\n\t\t\t\t\t} else {\n\t\t\t\t\t\t// If no schema, pass the event as-is\n\t\t\t\t\t\treq.event.parsedInput = req.event as any;\n\t\t\t\t\t}\n\t\t\t\t} catch (error) {\n\t\t\t\t\tthis.logger.error(\n\t\t\t\t\t\t{ error, event: req.event },\n\t\t\t\t\t\t'Failed to parse input',\n\t\t\t\t\t);\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t},\n\t\t};\n\t}\n\n\tprivate loggerMiddleware<TEvent>(): Middleware<\n\t\tTEvent,\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tTOutSchema,\n\t\tTDatabase,\n\t\tTAuditAction\n\t> {\n\t\treturn {\n\t\t\tbefore: (req) => {\n\t\t\t\tthis._logger = this.fn.logger.child({\n\t\t\t\t\tfn: {\n\t\t\t\t\t\tname: req.context.functionName,\n\t\t\t\t\t\tversion: req.context.functionVersion,\n\t\t\t\t\t\tmemory: req.context.memoryLimitInMB,\n\t\t\t\t\t},\n\t\t\t\t\treq: {\n\t\t\t\t\t\tid: req.context.awsRequestId,\n\t\t\t\t\t},\n\t\t\t\t}) as TLogger;\n\n\t\t\t\treq.event.logger = this._logger;\n\t\t\t},\n\t\t};\n\t}\n\n\tprivate services<TEvent>(): Middleware<\n\t\tTEvent,\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tTOutSchema,\n\t\tTDatabase,\n\t\tTAuditAction\n\t> {\n\t\treturn {\n\t\t\tbefore: async (req) => {\n\t\t\t\treq.event.services = await this.getServices();\n\t\t\t},\n\t\t};\n\t}\n\n\tprivate database<TEvent>(): Middleware<\n\t\tTEvent,\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tTOutSchema,\n\t\tTDatabase,\n\t\tTAuditAction\n\t> {\n\t\treturn {\n\t\t\tbefore: async (req) => {\n\t\t\t\treq.event.db = await this.getDatabase();\n\t\t\t},\n\t\t};\n\t}\n\n\tprivate auditor<TEvent>(): Middleware<\n\t\tTEvent,\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tTOutSchema,\n\t\tTDatabase,\n\t\tTAuditAction\n\t> {\n\t\treturn {\n\t\t\tbefore: async (req) => {\n\t\t\t\treq.event.auditor = await this.createAuditor();\n\t\t\t},\n\t\t\tafter: async (req) => {\n\t\t\t\t// Flush any pending audits after successful execution\n\t\t\t\tif (req.event.auditor) {\n\t\t\t\t\tconst records = req.event.auditor.getRecords();\n\t\t\t\t\tif (records.length > 0) {\n\t\t\t\t\t\tthis.logger.debug(\n\t\t\t\t\t\t\t{ auditCount: records.length },\n\t\t\t\t\t\t\t'Flushing function audits',\n\t\t\t\t\t\t);\n\t\t\t\t\t\tawait req.event.auditor.flush();\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t},\n\t\t};\n\t}\n\n\tprivate events<TEvent>(): Middleware<\n\t\tTEvent,\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tTOutSchema,\n\t\tTDatabase,\n\t\tTAuditAction\n\t> {\n\t\treturn {\n\t\t\tafter: async (req) => {\n\t\t\t\tconst response = (req.response ||\n\t\t\t\t\tundefined) as InferStandardSchema<TOutSchema>;\n\t\t\t\tawait this.publishEvents(response);\n\t\t\t},\n\t\t};\n\t}\n\n\tprivate async _handler<TEvent>(\n\t\tevent: FunctionEvent<\n\t\t\tTEvent,\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTDatabase,\n\t\t\tTAuditAction\n\t\t>,\n\t) {\n\t\t// Execute the function with the parsed context\n\t\tconst result = await this.fn.fn({\n\t\t\tinput: event.parsedInput,\n\t\t\tservices: event.services,\n\t\t\tlogger: event.logger,\n\t\t\tdb: event.db,\n\t\t\tauditor: event.auditor,\n\t\t} as any);\n\n\t\t// Parse output if schema is provided\n\t\tconst output = await this.fn.parseOutput(result);\n\n\t\treturn output;\n\t}\n\n\tget handler(): AWSLambdaHandler {\n\t\tconst handler = this._handler.bind(this);\n\n\t\t// Apply middleware in order\n\t\tconst chain = middy(handler)\n\t\t\t.use(this.loggerMiddleware())\n\t\t\t.use(this.baseInput())\n\t\t\t.use(this.error())\n\t\t\t.use(this.services())\n\t\t\t.use(this.database())\n\t\t\t.use(this.auditor())\n\t\t\t.use(this.input())\n\t\t\t.use(this.events());\n\n\t\t// Wrap entire Middy chain in request context for service access\n\t\tconst wrappedHandler = async (event: unknown, context: Context) => {\n\t\t\tconst startTime = Date.now();\n\t\t\tconst requestId = context.awsRequestId;\n\t\t\tconst logger = this.fn.logger.child({ requestId }) as TLogger;\n\n\t\t\treturn runWithRequestContext({ logger, requestId, startTime }, () =>\n\t\t\t\tchain(event as Parameters<typeof chain>[0], context),\n\t\t\t);\n\t\t};\n\n\t\treturn wrappedHandler as unknown as AWSLambdaHandler;\n\t}\n}\n"],"mappings":"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"}