@venturekit/runtime 0.0.0-dev.20260312012510 → 0.0.0-dev.20260329093916

package/dist/handler/task-handler.js

@@ -0,0 +1,262 @@
+/**
+ * VentureKit Task Handler
+ *
+ * Unified handler for non-HTTP Lambda functions:
+ *   - Standalone functions (src/functions/)
+ *   - Queue consumers (src/queues/)
+ *   - Scheduled tasks / cron handlers (src/crons/)
+ *
+ * Provides the same developer experience as handler() for routes:
+ *   - Middleware pipeline
+ *   - Structured logging
+ *   - Error handling with structured responses
+ *   - Transaction support (auto-commit / auto-rollback)
+ *   - Input validation (Zod schemas)
+ *   - Automatic trace context propagation
+ *
+ * ## Retry Architecture (Two Layers)
+ *
+ * **Layer 1 — Infrastructure retries (managed by AWS, outside your code):**
+ *   - SQS queues: failed invocations return the message to the queue after
+ *     `visibilityTimeout`. After `maxReceiveCount` failures → dead-letter queue.
+ *   - EventBridge crons: 2 automatic retries with exponential backoff.
+ *   - Async Lambda invocations: 2 automatic retries by default.
+ *
+ * **Layer 2 — Application retries (managed by taskHandler, inside one invocation):**
+ *   - `retries: N` retries the handler within a single Lambda invocation.
+ *   - Useful for transient errors (network blips, DB connection resets, throttles).
+ *   - Uses exponential backoff: `retryDelayMs * 2^attempt`.
+ *   - Validation errors (TaskValidationError) are never retried.
+ *
+ * The two layers are complementary: application retries handle transient glitches
+ * before the function fails. If all application retries are exhausted, the error
+ * propagates to the infrastructure layer (SQS visibility timeout / DLQ, etc.).
+ *
+ * @example
+ * ```typescript
+ * import { taskHandler } from '@venturekit/runtime';
+ *
+ * export const main = taskHandler<MyEvent, MyResult>(
+ *   async (event, ctx, logger) => {
+ *     logger.info('Processing', { event });
+ *     return { processed: true };
+ *   },
+ *   { timeout: 30_000 },
+ * );
+ * ```
+ */
+import { createLogger } from '../logging/logger.js';
+import { generateId } from '../logging/tracing.js';
+/**
+ * Build a TaskContext from a Lambda Context and event.
+ */
+function buildTaskContext(event, lambdaContext) {
+    // Extract trace from event.__trace headers (propagated by invoke())
+    let traceId;
+    if (typeof event === 'object' && event !== null && '__trace' in event) {
+        const trace = event.__trace;
+        if (typeof trace === 'object' && trace !== null) {
+            traceId = trace['x-trace-id'];
+        }
+    }
+    // Generate a fresh traceId if none was propagated — never read from process.env
+    // to keep Lambda stateless across warm-start invocations.
+    if (!traceId) {
+        traceId = generateId();
+    }
+    // Hydrate intent outputs
+    let intentOutputs;
+    try {
+        const raw = process.env.VENTURE_INTENT_OUTPUTS;
+        if (raw) {
+            intentOutputs = JSON.parse(raw);
+        }
+    }
+    catch {
+        // ignore
+    }
+    return {
+        requestId: lambdaContext.awsRequestId,
+        timestamp: new Date(),
+        functionName: lambdaContext.functionName,
+        getRemainingTimeInMillis: () => lambdaContext.getRemainingTimeInMillis(),
+        traceId,
+        rawContext: lambdaContext,
+        intentOutputs,
+        event,
+        logger: undefined, // set immediately after construction
+    };
+}
+/**
+ * VentureKit task handler for non-HTTP Lambda functions.
+ *
+ * Provides middleware, logging, validation, transactions, and error handling
+ * for standalone functions, queue consumers, and scheduled tasks.
+ *
+ * @example Basic usage
+ * ```typescript
+ * export const main = taskHandler<MyEvent, MyResult>(async (event, ctx, logger) => {
+ *   logger.info('Processing event', { event });
+ *   return { processed: true };
+ * });
+ * ```
+ *
+ * @example With validation and transactions
+ * ```typescript
+ * export const main = taskHandler<OrderEvent, OrderResult>(
+ *   async (event, ctx, logger) => {
+ *     const result = await ctx.tx!.query('INSERT INTO orders ...');
+ *     return { orderId: result.id };
+ *   },
+ *   {
+ *     event: OrderEventSchema,
+ *     transactional: true,
+ *     retries: 2,
+ *   },
+ * );
+ * ```
+ *
+ * @example With middleware (same Middleware type as HTTP handlers)
+ * ```typescript
+ * export const main = taskHandler(
+ *   async (event, ctx, logger) => { ... },
+ *   {
+ *     middleware: [
+ *       { name: 'audit', fn: async (ctx, next) => {
+ *         ctx.logger.info('Audit: start');
+ *         const result = await next();
+ *         ctx.logger.info('Audit: done');
+ *         return result;
+ *       }},
+ *     ],
+ *   },
+ * );
+ * ```
+ */
+export function taskHandler(fn, config = {}) {
+    const { middleware = [], logLevel = 'info', transactional = false, timeout, retries = 0, retryDelayMs = 1000, } = config;
+    return async (event, lambdaContext) => {
+        const ctx = buildTaskContext(event, lambdaContext);
+        const logger = createLogger({ minLevel: logLevel });
+        ctx.logger = logger;
+        ctx.event = event;
+        logger.info('Task started', {
+            functionName: ctx.functionName,
+            requestId: ctx.requestId,
+            traceId: ctx.traceId,
+        });
+        const start = Date.now();
+        // Build the core execution function
+        const execute = async () => {
+            // Validate event with Zod schema if provided
+            if (config.event) {
+                // If the event has a `body` field that is a JSON string (e.g. from
+                // API Gateway or SQS), parse it so Zod validates the actual payload.
+                let dataToValidate = event;
+                if (typeof event === 'object' && event !== null
+                    && 'body' in event
+                    && typeof event.body === 'string') {
+                    try {
+                        dataToValidate = JSON.parse(event.body);
+                    }
+                    catch {
+                        throw new TaskValidationError('Event validation failed: body is not valid JSON', [{ path: ['body'], message: 'body is not valid JSON' }]);
+                    }
+                }
+                const result = config.event.safeParse(dataToValidate);
+                if (!result.success) {
+                    const issues = result.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`);
+                    throw new TaskValidationError(`Event validation failed: ${issues.join('; ')}`, result.error.issues);
+                }
+                event = result.data;
+            }
+            // Transaction support
+            if (transactional) {
+                const data = await import('@venturekit/data');
+                const tx = await data.beginTransaction();
+                ctx.tx = tx;
+                try {
+                    const result = await fn(event, ctx, logger);
+                    await tx.commit();
+                    return result;
+                }
+                catch (txError) {
+                    await tx.rollback();
+                    throw txError;
+                }
+            }
+            return fn(event, ctx, logger);
+        };
+        // Compose middleware around the execution function
+        // Middleware uses the unified (ctx, next) signature
+        let chain = execute;
+        for (let i = middleware.length - 1; i >= 0; i--) {
+            const mw = middleware[i];
+            const next = chain;
+            chain = () => mw.fn(ctx, next);
+        }
+        // Timeout wrapper
+        const executeWithTimeout = async () => {
+            if (!timeout)
+                return chain();
+            return Promise.race([
+                chain(),
+                new Promise((_, reject) => {
+                    setTimeout(() => reject(new Error(`Task timeout after ${timeout}ms`)), timeout);
+                }),
+            ]);
+        };
+        // Retry wrapper
+        let lastError;
+        for (let attempt = 0; attempt <= retries; attempt++) {
+            try {
+                const result = await executeWithTimeout();
+                const duration = Date.now() - start;
+                logger.info('Task completed', {
+                    functionName: ctx.functionName,
+                    requestId: ctx.requestId,
+                    durationMs: duration,
+                    attempt: attempt + 1,
+                });
+                return result;
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err : new Error(String(err));
+                // Don't retry validation errors
+                if (err instanceof TaskValidationError) {
+                    throw err;
+                }
+                if (attempt < retries) {
+                    const delay = retryDelayMs * Math.pow(2, attempt);
+                    logger.warn('Task failed, retrying', {
+                        attempt: attempt + 1,
+                        maxRetries: retries,
+                        delayMs: delay,
+                        error: lastError.message,
+                    });
+                    await new Promise((resolve) => setTimeout(resolve, delay));
+                }
+            }
+        }
+        const duration = Date.now() - start;
+        logger.error('Task failed', {
+            functionName: ctx.functionName,
+            requestId: ctx.requestId,
+            durationMs: duration,
+            error: lastError.message,
+        });
+        throw lastError;
+    };
+}
+/**
+ * Validation error for task events.
+ */
+export class TaskValidationError extends Error {
+    issues;
+    constructor(message, issues) {
+        super(message);
+        this.name = 'TaskValidationError';
+        this.issues = issues;
+    }
+}
+//# sourceMappingURL=task-handler.js.map

package/dist/handler/task-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-handler.js","sourceRoot":"","sources":["../../src/handler/task-handler.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -2,19 +2,38 @@
  * @venturekit/runtime
  *
  * Runtime utilities for VentureKit Lambda functions.
+ *
+ * This is the core entry point — it only loads lightweight modules.
+ * Heavy optional features are available via subpath imports:
+ *
+ *   @venturekit/runtime/ws          — WebSocket connection store (DynamoDB)
+ *   @venturekit/runtime/patterns    — invoke, saga, circuit-breaker, idempotency
+ *   @venturekit/runtime/rate-limit  — DynamoDB-backed rate limit stores
+ *   @venturekit/runtime/secrets     — SSM / Secrets Manager client
+ *   @venturekit/runtime/openapi     — OpenAPI spec generation
+ *   @venturekit/runtime/testing     — Test utilities (mockEvent, mockContext, etc.)
+ *
+ * This ensures `import { handler } from '@venturekit/runtime'` never triggers
+ * loading of AWS SDK or other heavy optional dependencies.
  */
-export { handler } from './handler.js';
-export type { HandlerFn, HandlerConfig, StatusCode } from './handler.js';
-export { buildContext, extractUserContext, extractLocale, } from './context.js';
-export type { RequestContext, UserContext, TenantContext } from './context.js';
-export { success, created, noContent, error, errorResponse, redirect, } from './response.js';
-export type { SuccessResponse, ErrorResponse } from './response.js';
-export { VentureError, BadRequestError, UnauthorizedError, ForbiddenError, NotFoundError, ConflictError, ValidationError, RateLimitError, InternalError, ServiceUnavailableError, isVentureError, } from './errors.js';
-export { Logger, createLogger, logger, } from './logger.js';
-export type { LogLevel, LogEntry, LoggerConfig } from './logger.js';
-export { compose, loggingMiddleware, corsMiddleware, timeoutMiddleware, errorBoundaryMiddleware, } from './middleware.js';
-export type { MiddlewareFn, Middleware } from './middleware.js';
-export { connectionStore } from './ws.js';
-export type { ConnectionRecord, ConnectionMetadata } from './ws.js';
-export { httpToLambdaEvent, createLocalContext, lambdaResultToHttp, adaptHandler, } from './adapter.js';
+export { handler } from './handler/handler.js';
+export type { HandlerFn, HandlerConfig, StatusCode, ZodLikeSchema } from './handler/handler.js';
+export { taskHandler, TaskValidationError } from './handler/task-handler.js';
+export type { TaskHandlerFn, TaskContext, TaskHandlerConfig, } from './handler/task-handler.js';
+export { buildContext, extractUserContext, extractLocale, } from './handler/context.js';
+export type { BaseContext, RequestContext, UserContext, TenantContext, Transaction } from './handler/context.js';
+export { success, created, noContent, error, errorResponse, redirect, } from './handler/response.js';
+export type { SuccessResponse, ErrorResponse } from './handler/response.js';
+export { VentureError, BadRequestError, UnauthorizedError, ForbiddenError, NotFoundError, ConflictError, ValidationError, RateLimitError, InternalError, ServiceUnavailableError, isVentureError, } from './handler/errors.js';
+export { Logger, createLogger, logger, } from './logging/logger.js';
+export type { LogLevel, LogEntry, LoggerConfig } from './logging/logger.js';
+export { compose, loggingMiddleware, corsMiddleware, timeoutMiddleware, errorBoundaryMiddleware, rateLimitMiddleware, requestIdMiddleware, timingMiddleware, apiKeyAuthMiddleware, } from './middleware/middleware.js';
+export type { MiddlewareFn, Middleware, RateLimitCheck, RateLimitOptions } from './middleware/middleware.js';
+export { createMemoryRateLimitStore, RATE_LIMIT_PRESETS, } from './middleware/rate-limit-store.js';
+export type { RateLimitPreset, RateLimitPresetConfig, } from './middleware/rate-limit-store.js';
+export { httpToLambdaEvent, createLocalContext, lambdaResultToHttp, adaptHandler, } from './handler/adapter.js';
+export { extractTraceContext, injectTraceHeaders, createChildTrace, traceFromRequest, generateId, TRACE_HEADERS, } from './logging/tracing.js';
+export type { TraceContext } from './logging/tracing.js';
+export { createEnvClient, env, } from './config/env.js';
+export type { EnvGetOptions, EnvClient, } from './config/env.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAGzE,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG/E,OAAO,EACL,OAAO,EACP,OAAO,EACP,SAAS,EACT,KAAK,EACL,aAAa,EACb,QAAQ,GACT,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGpE,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,cAAc,EACd,aAAa,EACb,uBAAuB,EACvB,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,MAAM,EACN,YAAY,EACZ,MAAM,GACP,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGpE,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGhE,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGpE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,GACb,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGhG,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAC7E,YAAY,EACV,aAAa,EACb,WAAW,EACX,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGjH,OAAO,EACL,OAAO,EACP,OAAO,EACP,SAAS,EACT,KAAK,EACL,aAAa,EACb,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG5E,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,cAAc,EACd,aAAa,EACb,uBAAuB,EACvB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,MAAM,EACN,YAAY,EACZ,MAAM,GACP,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAG5E,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG7G,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,eAAe,EACf,qBAAqB,GACtB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,EACL,eAAe,EACf,GAAG,GACJ,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,aAAa,EACb,SAAS,GACV,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,59 +1,41 @@
-"use strict";
 /**
  * @venturekit/runtime
  *
  * Runtime utilities for VentureKit Lambda functions.
+ *
+ * This is the core entry point — it only loads lightweight modules.
+ * Heavy optional features are available via subpath imports:
+ *
+ *   @venturekit/runtime/ws          — WebSocket connection store (DynamoDB)
+ *   @venturekit/runtime/patterns    — invoke, saga, circuit-breaker, idempotency
+ *   @venturekit/runtime/rate-limit  — DynamoDB-backed rate limit stores
+ *   @venturekit/runtime/secrets     — SSM / Secrets Manager client
+ *   @venturekit/runtime/openapi     — OpenAPI spec generation
+ *   @venturekit/runtime/testing     — Test utilities (mockEvent, mockContext, etc.)
+ *
+ * This ensures `import { handler } from '@venturekit/runtime'` never triggers
+ * loading of AWS SDK or other heavy optional dependencies.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.adaptHandler = exports.lambdaResultToHttp = exports.createLocalContext = exports.httpToLambdaEvent = exports.connectionStore = exports.errorBoundaryMiddleware = exports.timeoutMiddleware = exports.corsMiddleware = exports.loggingMiddleware = exports.compose = exports.logger = exports.createLogger = exports.Logger = exports.isVentureError = exports.ServiceUnavailableError = exports.InternalError = exports.RateLimitError = exports.ValidationError = exports.ConflictError = exports.NotFoundError = exports.ForbiddenError = exports.UnauthorizedError = exports.BadRequestError = exports.VentureError = exports.redirect = exports.errorResponse = exports.error = exports.noContent = exports.created = exports.success = exports.extractLocale = exports.extractUserContext = exports.buildContext = exports.handler = void 0;
-// Handler
-var handler_js_1 = require("./handler.js");
-Object.defineProperty(exports, "handler", { enumerable: true, get: function () { return handler_js_1.handler; } });
+// Handler (HTTP routes)
+export { handler } from './handler/handler.js';
+// Task Handler (functions, queues, crons)
+export { taskHandler, TaskValidationError } from './handler/task-handler.js';
 // Context
-var context_js_1 = require("./context.js");
-Object.defineProperty(exports, "buildContext", { enumerable: true, get: function () { return context_js_1.buildContext; } });
-Object.defineProperty(exports, "extractUserContext", { enumerable: true, get: function () { return context_js_1.extractUserContext; } });
-Object.defineProperty(exports, "extractLocale", { enumerable: true, get: function () { return context_js_1.extractLocale; } });
+export { buildContext, extractUserContext, extractLocale, } from './handler/context.js';
 // Response utilities
-var response_js_1 = require("./response.js");
-Object.defineProperty(exports, "success", { enumerable: true, get: function () { return response_js_1.success; } });
-Object.defineProperty(exports, "created", { enumerable: true, get: function () { return response_js_1.created; } });
-Object.defineProperty(exports, "noContent", { enumerable: true, get: function () { return response_js_1.noContent; } });
-Object.defineProperty(exports, "error", { enumerable: true, get: function () { return response_js_1.error; } });
-Object.defineProperty(exports, "errorResponse", { enumerable: true, get: function () { return response_js_1.errorResponse; } });
-Object.defineProperty(exports, "redirect", { enumerable: true, get: function () { return response_js_1.redirect; } });
+export { success, created, noContent, error, errorResponse, redirect, } from './handler/response.js';
 // Errors
-var errors_js_1 = require("./errors.js");
-Object.defineProperty(exports, "VentureError", { enumerable: true, get: function () { return errors_js_1.VentureError; } });
-Object.defineProperty(exports, "BadRequestError", { enumerable: true, get: function () { return errors_js_1.BadRequestError; } });
-Object.defineProperty(exports, "UnauthorizedError", { enumerable: true, get: function () { return errors_js_1.UnauthorizedError; } });
-Object.defineProperty(exports, "ForbiddenError", { enumerable: true, get: function () { return errors_js_1.ForbiddenError; } });
-Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return errors_js_1.NotFoundError; } });
-Object.defineProperty(exports, "ConflictError", { enumerable: true, get: function () { return errors_js_1.ConflictError; } });
-Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_js_1.ValidationError; } });
-Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return errors_js_1.RateLimitError; } });
-Object.defineProperty(exports, "InternalError", { enumerable: true, get: function () { return errors_js_1.InternalError; } });
-Object.defineProperty(exports, "ServiceUnavailableError", { enumerable: true, get: function () { return errors_js_1.ServiceUnavailableError; } });
-Object.defineProperty(exports, "isVentureError", { enumerable: true, get: function () { return errors_js_1.isVentureError; } });
+export { VentureError, BadRequestError, UnauthorizedError, ForbiddenError, NotFoundError, ConflictError, ValidationError, RateLimitError, InternalError, ServiceUnavailableError, isVentureError, } from './handler/errors.js';
 // Logger
-var logger_js_1 = require("./logger.js");
-Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_js_1.Logger; } });
-Object.defineProperty(exports, "createLogger", { enumerable: true, get: function () { return logger_js_1.createLogger; } });
-Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_js_1.logger; } });
-// Middleware
-var middleware_js_1 = require("./middleware.js");
-Object.defineProperty(exports, "compose", { enumerable: true, get: function () { return middleware_js_1.compose; } });
-Object.defineProperty(exports, "loggingMiddleware", { enumerable: true, get: function () { return middleware_js_1.loggingMiddleware; } });
-Object.defineProperty(exports, "corsMiddleware", { enumerable: true, get: function () { return middleware_js_1.corsMiddleware; } });
-Object.defineProperty(exports, "timeoutMiddleware", { enumerable: true, get: function () { return middleware_js_1.timeoutMiddleware; } });
-Object.defineProperty(exports, "errorBoundaryMiddleware", { enumerable: true, get: function () { return middleware_js_1.errorBoundaryMiddleware; } });
-// WebSocket connection store
-var ws_js_1 = require("./ws.js");
-Object.defineProperty(exports, "connectionStore", { enumerable: true, get: function () { return ws_js_1.connectionStore; } });
+export { Logger, createLogger, logger, } from './logging/logger.js';
+// Middleware (core — no heavy deps)
+export { compose, loggingMiddleware, corsMiddleware, timeoutMiddleware, errorBoundaryMiddleware, rateLimitMiddleware, requestIdMiddleware, timingMiddleware, apiKeyAuthMiddleware, } from './middleware/middleware.js';
+// In-memory rate limit store (no AWS deps — safe for core)
+export { createMemoryRateLimitStore, RATE_LIMIT_PRESETS, } from './middleware/rate-limit-store.js';
 // Local dev adapter (HTTP ↔ Lambda event conversion)
-var adapter_js_1 = require("./adapter.js");
-Object.defineProperty(exports, "httpToLambdaEvent", { enumerable: true, get: function () { return adapter_js_1.httpToLambdaEvent; } });
-Object.defineProperty(exports, "createLocalContext", { enumerable: true, get: function () { return adapter_js_1.createLocalContext; } });
-Object.defineProperty(exports, "lambdaResultToHttp", { enumerable: true, get: function () { return adapter_js_1.lambdaResultToHttp; } });
-Object.defineProperty(exports, "adaptHandler", { enumerable: true, get: function () { return adapter_js_1.adaptHandler; } });
+export { httpToLambdaEvent, createLocalContext, lambdaResultToHttp, adaptHandler, } from './handler/adapter.js';
+// Tracing
+export { extractTraceContext, injectTraceHeaders, createChildTrace, traceFromRequest, generateId, TRACE_HEADERS, } from './logging/tracing.js';
+// Environment variables (no AWS deps)
+export { createEnvClient, env, } from './config/env.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,UAAU;AACV,2CAAuC;AAA9B,qGAAA,OAAO,OAAA;AAGhB,UAAU;AACV,2CAIsB;AAHpB,0GAAA,YAAY,OAAA;AACZ,gHAAA,kBAAkB,OAAA;AAClB,2GAAA,aAAa,OAAA;AAIf,qBAAqB;AACrB,6CAOuB;AANrB,sGAAA,OAAO,OAAA;AACP,sGAAA,OAAO,OAAA;AACP,wGAAA,SAAS,OAAA;AACT,oGAAA,KAAK,OAAA;AACL,4GAAA,aAAa,OAAA;AACb,uGAAA,QAAQ,OAAA;AAIV,SAAS;AACT,yCAYqB;AAXnB,yGAAA,YAAY,OAAA;AACZ,4GAAA,eAAe,OAAA;AACf,8GAAA,iBAAiB,OAAA;AACjB,2GAAA,cAAc,OAAA;AACd,0GAAA,aAAa,OAAA;AACb,0GAAA,aAAa,OAAA;AACb,4GAAA,eAAe,OAAA;AACf,2GAAA,cAAc,OAAA;AACd,0GAAA,aAAa,OAAA;AACb,oHAAA,uBAAuB,OAAA;AACvB,2GAAA,cAAc,OAAA;AAGhB,SAAS;AACT,yCAIqB;AAHnB,mGAAA,MAAM,OAAA;AACN,yGAAA,YAAY,OAAA;AACZ,mGAAA,MAAM,OAAA;AAIR,aAAa;AACb,iDAMyB;AALvB,wGAAA,OAAO,OAAA;AACP,kHAAA,iBAAiB,OAAA;AACjB,+GAAA,cAAc,OAAA;AACd,kHAAA,iBAAiB,OAAA;AACjB,wHAAA,uBAAuB,OAAA;AAIzB,6BAA6B;AAC7B,iCAA0C;AAAjC,wGAAA,eAAe,OAAA;AAGxB,qDAAqD;AACrD,2CAKsB;AAJpB,+GAAA,iBAAiB,OAAA;AACjB,gHAAA,kBAAkB,OAAA;AAClB,gHAAA,kBAAkB,OAAA;AAClB,0GAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,wBAAwB;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C,0CAA0C;AAC1C,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAO7E,UAAU;AACV,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,aAAa,GACd,MAAM,sBAAsB,CAAC;AAG9B,qBAAqB;AACrB,OAAO,EACL,OAAO,EACP,OAAO,EACP,SAAS,EACT,KAAK,EACL,aAAa,EACb,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAG/B,SAAS;AACT,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,cAAc,EACd,aAAa,EACb,uBAAuB,EACvB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,SAAS;AACT,OAAO,EACL,MAAM,EACN,YAAY,EACZ,MAAM,GACP,MAAM,qBAAqB,CAAC;AAG7B,oCAAoC;AACpC,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AAGpC,2DAA2D;AAC3D,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,kCAAkC,CAAC;AAM1C,qDAAqD;AACrD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,UAAU;AACV,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,aAAa,GACd,MAAM,sBAAsB,CAAC;AAG9B,sCAAsC;AACtC,OAAO,EACL,eAAe,EACf,GAAG,GACJ,MAAM,iBAAiB,CAAC"}

package/dist/{logger.d.ts → logging/logger.d.ts}

@@ -10,7 +10,7 @@
  * - Child logger support with bound fields
  * - Lambda-optimized (no worker threads, synchronous output)
  */
-import { RequestContext } from './context.js';
+import { RequestContext } from '../handler/context.js';
 /**
  * Log levels
  */

package/dist/logging/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,QAAQ,EAAE,QAAQ,CAAC;IACnB,0CAA0C;IAC1C,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAmB9C;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAUzC;;OAEG;IACH,YAAY,IAAI,IAAI;IAapB;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAO9C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAG7D;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,QAAe,CAAC;AAEnC;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,CAEnE"}

package/dist/{logger.js → logging/logger.js}

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * VentureKit Logger
  *
@@ -11,17 +10,11 @@
  * - Child logger support with bound fields
  * - Lambda-optimized (no worker threads, synchronous output)
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.logger = exports.Logger = void 0;
-exports.createLogger = createLogger;
-const pino_1 = __importDefault(require("pino"));
+import pino from 'pino';
 /**
  * Logger instance — thin wrapper over pino
  */
-class Logger {
+export class Logger {
     pinoLogger;
     context = null;
     config;
@@ -30,11 +23,11 @@ class Logger {
             minLevel: config.minLevel ?? 'info',
             includeContext: config.includeContext ?? true,
         };
-        this.pinoLogger = (0, pino_1.default)({
+        this.pinoLogger = pino({
             level: this.config.minLevel,
             // Lambda-friendly: no worker threads, flat JSON, fast
             transport: undefined,
-            timestamp: pino_1.default.stdTimeFunctions.isoTime,
+            timestamp: pino.stdTimeFunctions.isoTime,
             formatters: {
                 level(label) {
                     return { level: label };
@@ -59,9 +52,9 @@ class Logger {
      */
     clearContext() {
         this.context = null;
-        this.pinoLogger = (0, pino_1.default)({
+        this.pinoLogger = pino({
             level: this.config.minLevel,
-            timestamp: pino_1.default.stdTimeFunctions.isoTime,
+            timestamp: pino.stdTimeFunctions.isoTime,
             formatters: {
                 level(label) {
                     return { level: label };
@@ -91,15 +84,14 @@ class Logger {
         data ? this.pinoLogger.error(data, message) : this.pinoLogger.error(message);
     }
 }
-exports.Logger = Logger;
 /**
  * Default logger instance
  */
-exports.logger = new Logger();
+export const logger = new Logger();
 /**
  * Create a new logger with custom config
  */
-function createLogger(config) {
+export function createLogger(config) {
     return new Logger(config);
 }
 //# sourceMappingURL=logger.js.map

package/dist/logging/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"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"}

package/dist/logging/tracing.d.ts

@@ -0,0 +1,51 @@
+/**
+ * VentureKit Distributed Tracing
+ *
+ * Correlation ID / trace ID propagation across Lambda invocations.
+ * Integrates with X-Ray trace IDs and custom trace context.
+ */
+import type { RequestContext } from '../handler/context.js';
+/**
+ * Trace context propagated across service boundaries
+ */
+export interface TraceContext {
+    /** Root trace ID (created at the entry point) */
+    traceId: string;
+    /** Current span ID */
+    spanId: string;
+    /** Parent span ID (undefined for root span) */
+    parentSpanId?: string;
+    /** Baggage — arbitrary key-value pairs propagated across all spans */
+    baggage: Record<string, string>;
+}
+/**
+ * Trace headers used for propagation
+ */
+export declare const TRACE_HEADERS: {
+    readonly TRACE_ID: "x-trace-id";
+    readonly SPAN_ID: "x-span-id";
+    readonly PARENT_SPAN_ID: "x-parent-span-id";
+    readonly BAGGAGE: "x-trace-baggage";
+};
+/**
+ * Generate a random ID (16 hex chars)
+ */
+export declare function generateId(): string;
+/**
+ * Extract trace context from request headers
+ */
+export declare function extractTraceContext(headers: Record<string, string | undefined>): TraceContext;
+/**
+ * Serialize trace context into headers for outbound requests
+ */
+export declare function injectTraceHeaders(trace: TraceContext): Record<string, string>;
+/**
+ * Create a child trace context (for outbound calls)
+ */
+export declare function createChildTrace(parent: TraceContext): TraceContext;
+/**
+ * Extract trace context from a RequestContext
+ * (reads from rawEvent headers)
+ */
+export declare function traceFromRequest(ctx: RequestContext): TraceContext;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/logging/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../src/logging/tracing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAInC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,YAAY,CAgB7F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAe9E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAOnE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,GAAG,YAAY,CAElE"}