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

package/dist/{errors.js → handler/errors.js}

@@ -1,16 +1,12 @@
-"use strict";
 /**
  * VentureKit Runtime Errors
  *
  * Standardized error types for consistent error handling across handlers.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ServiceUnavailableError = exports.InternalError = exports.RateLimitError = exports.ValidationError = exports.ConflictError = exports.NotFoundError = exports.ForbiddenError = exports.UnauthorizedError = exports.BadRequestError = exports.VentureError = void 0;
-exports.isVentureError = isVentureError;
 /**
  * Base error class for all VentureKit errors
  */
-class VentureError extends Error {
+export class VentureError extends Error {
     code;
     statusCode;
     details;
@@ -31,62 +27,56 @@ class VentureError extends Error {
         };
     }
 }
-exports.VentureError = VentureError;
 /**
  * 400 Bad Request - Invalid input
  */
-class BadRequestError extends VentureError {
+export class BadRequestError extends VentureError {
     constructor(message, details) {
         super('BAD_REQUEST', message, 400, details);
         this.name = 'BadRequestError';
     }
 }
-exports.BadRequestError = BadRequestError;
 /**
  * 401 Unauthorized - Missing or invalid authentication
  */
-class UnauthorizedError extends VentureError {
+export class UnauthorizedError extends VentureError {
     constructor(message = 'Authentication required') {
         super('UNAUTHORIZED', message, 401);
         this.name = 'UnauthorizedError';
     }
 }
-exports.UnauthorizedError = UnauthorizedError;
 /**
  * 403 Forbidden - Authenticated but not allowed
  */
-class ForbiddenError extends VentureError {
+export class ForbiddenError extends VentureError {
     constructor(message = 'Access denied') {
         super('FORBIDDEN', message, 403);
         this.name = 'ForbiddenError';
     }
 }
-exports.ForbiddenError = ForbiddenError;
 /**
  * 404 Not Found - Resource doesn't exist
  */
-class NotFoundError extends VentureError {
+export class NotFoundError extends VentureError {
     constructor(resource, id) {
         const message = id ? `${resource} '${id}' not found` : `${resource} not found`;
         super('NOT_FOUND', message, 404, { resource, id });
         this.name = 'NotFoundError';
     }
 }
-exports.NotFoundError = NotFoundError;
 /**
  * 409 Conflict - Resource already exists or state conflict
  */
-class ConflictError extends VentureError {
+export class ConflictError extends VentureError {
     constructor(message, details) {
         super('CONFLICT', message, 409, details);
         this.name = 'ConflictError';
     }
 }
-exports.ConflictError = ConflictError;
 /**
  * 422 Unprocessable Entity - Validation failed
  */
-class ValidationError extends VentureError {
+export class ValidationError extends VentureError {
     fieldErrors;
     constructor(message, fieldErrors) {
         super('VALIDATION_ERROR', message, 422, { fields: fieldErrors });
@@ -94,41 +84,37 @@ class ValidationError extends VentureError {
         this.name = 'ValidationError';
     }
 }
-exports.ValidationError = ValidationError;
 /**
  * 429 Too Many Requests - Rate limited
  */
-class RateLimitError extends VentureError {
+export class RateLimitError extends VentureError {
     constructor(retryAfterSec) {
         super('RATE_LIMITED', 'Too many requests', 429, retryAfterSec ? { retryAfterSec } : undefined);
         this.name = 'RateLimitError';
     }
 }
-exports.RateLimitError = RateLimitError;
 /**
  * 500 Internal Server Error - Unexpected error
  */
-class InternalError extends VentureError {
+export class InternalError extends VentureError {
     constructor(message = 'Internal server error') {
         super('INTERNAL_ERROR', message, 500);
         this.name = 'InternalError';
     }
 }
-exports.InternalError = InternalError;
 /**
  * 503 Service Unavailable - Dependency failure
  */
-class ServiceUnavailableError extends VentureError {
+export class ServiceUnavailableError extends VentureError {
     constructor(service) {
         super('SERVICE_UNAVAILABLE', `${service} is currently unavailable`, 503, { service });
         this.name = 'ServiceUnavailableError';
     }
 }
-exports.ServiceUnavailableError = ServiceUnavailableError;
 /**
  * Check if an error is a VentureError
  */
-function isVentureError(error) {
+export function isVentureError(error) {
     return error instanceof VentureError;
 }
 //# sourceMappingURL=errors.js.map

package/dist/handler/errors.js.map

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

package/dist/{handler.d.ts → handler/handler.d.ts}

@@ -8,8 +8,8 @@
  */
 import type { APIGatewayProxyEventV2, APIGatewayProxyResultV2, Context } from 'aws-lambda';
 import { RequestContext } from './context.js';
-import { Logger } from './logger.js';
-import { Middleware } from './middleware.js';
+import { Logger } from '../logging/logger.js';
+import { Middleware } from '../middleware/middleware.js';
 /**
  * Handler function signature
  */
@@ -18,10 +18,27 @@ export type HandlerFn<TBody = unknown, TResult = unknown> = (body: TBody, ctx: R
  * HTTP Status codes
  */
 export type StatusCode = 200 | 201 | 204;
+/**
+ * Zod-like schema interface (compatible with Zod without hard dependency)
+ */
+export interface ZodLikeSchema<T = unknown> {
+    safeParse(data: unknown): {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        error: {
+            issues: Array<{
+                path: (string | number)[];
+                message: string;
+            }>;
+        };
+    };
+}
 /**
  * Handler configuration
  */
-export interface HandlerConfig {
+export interface HandlerConfig<TBody = unknown, TQuery = unknown, TParams = unknown> {
     /**
      * Required OAuth scopes
      * - Empty array or undefined = public endpoint (no auth)
@@ -46,6 +63,22 @@ export interface HandlerConfig {
      * Requires @venturekit/data to be installed.
      */
     transactional?: boolean;
+    /**
+     * Zod schema for request body validation.
+     * If provided, the body is parsed and validated before the handler runs.
+     * On failure, a 422 ValidationError is thrown with structured field errors.
+     */
+    body?: ZodLikeSchema<TBody>;
+    /**
+     * Zod schema for query parameter validation.
+     * Query params are extracted from the event and validated.
+     */
+    query?: ZodLikeSchema<TQuery>;
+    /**
+     * Zod schema for path parameter validation.
+     * Path params are extracted from the event and validated.
+     */
+    params?: ZodLikeSchema<TParams>;
 }
 /**
  * VentureKit unified handler

package/dist/handler/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/handler/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAgB,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAgB,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EAAW,UAAU,EAA8C,MAAM,6BAA6B,CAAC;AAG9G;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,CAC1D,IAAI,EAAE,KAAK,EACX,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE;YAAE,MAAM,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;CACrJ;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACjF;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IAEpB,iCAAiC;IACjC,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;IAE1B,gBAAgB;IAChB,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAE/C;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAE5B;;;OAGG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAE9B;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACjC;AAoDD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,OAAO,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACxD,EAAE,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,EAC7B,MAAM,GAAE,aAAkB,GACzB,CAAC,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAgHvF"}

package/dist/{handler.js → handler/handler.js}

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * VentureKit Handler
  *
@@ -7,13 +6,11 @@
  * - With scopes = authenticated + scope check
  * - Status code auto-detected from HTTP method or explicitly set
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.handler = handler;
-const context_js_1 = require("./context.js");
-const logger_js_1 = require("./logger.js");
-const response_js_1 = require("./response.js");
-const middleware_js_1 = require("./middleware.js");
-const errors_js_1 = require("./errors.js");
+import { buildContext } from './context.js';
+import { createLogger } from '../logging/logger.js';
+import { success, created, noContent, errorResponse } from './response.js';
+import { compose, loggingMiddleware, errorBoundaryMiddleware } from '../middleware/middleware.js';
+import { UnauthorizedError, ForbiddenError, ValidationError } from './errors.js';
 /**
  * Parse request body
  */
@@ -45,6 +42,20 @@ function getStatusCode(method, explicit) {
             return 200;
     }
 }
+/**
+ * Convert Zod-like issues to a ValidationError
+ */
+function zodToValidationError(source, issues) {
+    const fieldErrors = {};
+    for (const issue of issues) {
+        const field = issue.path.length > 0 ? issue.path.join('.') : source;
+        if (!fieldErrors[field]) {
+            fieldErrors[field] = [];
+        }
+        fieldErrors[field].push(issue.message);
+    }
+    return new ValidationError(`Validation failed on ${source}`, fieldErrors);
+}
 /**
  * VentureKit unified handler
  *
@@ -66,39 +77,64 @@ function getStatusCode(method, explicit) {
  * }, { scopes: ['projects.write'] });
  * ```
  */
-function handler(fn, config = {}) {
+export function handler(fn, config = {}) {
     const { scopes = [], status, middleware = [], logLevel = 'info', } = config;
     const requiresAuth = scopes.length > 0;
-    const logger = (0, logger_js_1.createLogger)({ minLevel: logLevel });
+    const logger = createLogger({ minLevel: logLevel });
     // Build middleware stack
     const middlewareStack = [
         // Error boundary (outermost)
-        (0, middleware_js_1.errorBoundaryMiddleware)((error, ctx) => (0, response_js_1.errorResponse)(error, { requestId: ctx.requestId })),
+        errorBoundaryMiddleware((error, ctx) => errorResponse(error, { requestId: ctx.requestId })),
         // Logging
-        (0, middleware_js_1.loggingMiddleware)(logger),
+        loggingMiddleware(logger),
         // Custom middleware
         ...middleware,
     ];
-    const composedMiddleware = (0, middleware_js_1.compose)(middlewareStack);
+    const composedMiddleware = compose(middlewareStack);
     return async (event, _context) => {
         // Build request context
-        const ctx = (0, context_js_1.buildContext)(event, { supportedLocales: ['en'], defaultLocale: 'en' });
+        const ctx = buildContext(event, { supportedLocales: ['en'], defaultLocale: 'en' });
         logger.setContext(ctx);
         // Run through middleware and handler
         return composedMiddleware(ctx, async () => {
             // Auth check (only if scopes provided)
             if (requiresAuth) {
                 if (!ctx.user) {
-                    throw new errors_js_1.UnauthorizedError();
+                    throw new UnauthorizedError();
                 }
                 // Scope check
                 const hasAllScopes = scopes.every(scope => ctx.user.scopes.includes(scope));
                 if (!hasAllScopes) {
-                    throw new errors_js_1.ForbiddenError('Insufficient permissions');
+                    throw new ForbiddenError('Insufficient permissions');
                 }
             }
             // Parse body
-            const body = parseBody(event);
+            let body = parseBody(event);
+            // Validate body with Zod schema if provided
+            if (config.body) {
+                const result = config.body.safeParse(body);
+                if (!result.success) {
+                    throw zodToValidationError('body', result.error.issues);
+                }
+                body = result.data;
+            }
+            // Validate query params with Zod schema if provided
+            if (config.query) {
+                const rawQuery = event.queryStringParameters || {};
+                const result = config.query.safeParse(rawQuery);
+                if (!result.success) {
+                    throw zodToValidationError('query', result.error.issues);
+                }
+                ctx.queryParams = result.data;
+            }
+            // Validate path params with Zod schema if provided
+            if (config.params) {
+                const rawParams = event.pathParameters || {};
+                const result = config.params.safeParse(rawParams);
+                if (!result.success) {
+                    throw zodToValidationError('params', result.error.issues);
+                }
+            }
             // Transaction support
             if (config.transactional) {
                 const data = await import('@venturekit/data');
@@ -109,13 +145,13 @@ function handler(fn, config = {}) {
                     await tx.commit();
                     const statusCode = getStatusCode(event.requestContext.http.method, status);
                     if (statusCode === 204) {
-                        return (0, response_js_1.noContent)({ requestId: ctx.requestId });
+                        return noContent({ requestId: ctx.requestId });
                     }
                     else if (statusCode === 201) {
-                        return (0, response_js_1.created)(result, { requestId: ctx.requestId });
+                        return created(result, { requestId: ctx.requestId });
                     }
                     else {
-                        return (0, response_js_1.success)(result, { requestId: ctx.requestId });
+                        return success(result, { requestId: ctx.requestId });
                     }
                 }
                 catch (txError) {
@@ -129,13 +165,13 @@ function handler(fn, config = {}) {
             const statusCode = getStatusCode(event.requestContext.http.method, status);
             // Return response based on status
             if (statusCode === 204) {
-                return (0, response_js_1.noContent)({ requestId: ctx.requestId });
+                return noContent({ requestId: ctx.requestId });
             }
             else if (statusCode === 201) {
-                return (0, response_js_1.created)(result, { requestId: ctx.requestId });
+                return created(result, { requestId: ctx.requestId });
             }
             else {
-                return (0, response_js_1.success)(result, { requestId: ctx.requestId });
+                return success(result, { requestId: ctx.requestId });
             }
         });
     };

package/dist/handler/handler.js.map

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

package/dist/handler/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/handler/response.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAiC,MAAM,aAAa,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE;YACX,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC;YACjB,KAAK,EAAE,MAAM,CAAC;YACd,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;IACF,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,IAAI,EAAE,CAAC,EACP,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,uBAAuB,CAqBzB;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,IAAI,EAAE,CAAC,EACP,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACrE,uBAAuB,CAEzB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,uBAAuB,CAMvF;AAED;;GAEG;AACH,wBAAgB,KAAK,CACnB,GAAG,EAAE,YAAY,EACjB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,uBAAuB,CAwBzB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACvD,uBAAuB,CAczB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,OAAe,GACzB,uBAAuB,CAQzB"}

package/dist/{response.js → handler/response.js}

@@ -1,21 +1,13 @@
-"use strict";
 /**
  * VentureKit Response Utilities
  *
  * Standardized response formatting for API Gateway.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.success = success;
-exports.created = created;
-exports.noContent = noContent;
-exports.error = error;
-exports.errorResponse = errorResponse;
-exports.redirect = redirect;
-const errors_js_1 = require("./errors.js");
+import { isVentureError, InternalError } from './errors.js';
 /**
  * Create a success response
  */
-function success(data, options = {}) {
+export function success(data, options = {}) {
     const { statusCode = 200, headers = {}, requestId } = options;
     const body = {
         data,
@@ -38,13 +30,13 @@ function success(data, options = {}) {
 /**
  * Create a created response (201)
  */
-function created(data, options = {}) {
+export function created(data, options = {}) {
     return success(data, { ...options, statusCode: 201 });
 }
 /**
  * Create a no content response (204)
  */
-function noContent(options = {}) {
+export function noContent(options = {}) {
     return {
         statusCode: 204,
         body: '',
@@ -54,7 +46,7 @@ function noContent(options = {}) {
 /**
  * Create an error response from a VentureError
  */
-function error(err, options = {}) {
+export function error(err, options = {}) {
     const { requestId } = options;
     const body = {
         error: {
@@ -80,9 +72,9 @@ function error(err, options = {}) {
 /**
  * Convert any error to an API Gateway response
  */
-function errorResponse(err, options = {}) {
+export function errorResponse(err, options = {}) {
     const { requestId, logError = true } = options;
-    if ((0, errors_js_1.isVentureError)(err)) {
+    if (isVentureError(err)) {
         return error(err, { requestId });
     }
     // Log unexpected errors
@@ -90,12 +82,12 @@ function errorResponse(err, options = {}) {
         console.error('Unexpected error:', err);
     }
     // Wrap in InternalError for consistent response
-    return error(new errors_js_1.InternalError(), { requestId });
+    return error(new InternalError(), { requestId });
 }
 /**
  * Create a redirect response
  */
-function redirect(location, permanent = false) {
+export function redirect(location, permanent = false) {
     return {
         statusCode: permanent ? 301 : 302,
         headers: {

package/dist/handler/response.js.map

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

package/dist/handler/task-handler.d.ts

@@ -0,0 +1,192 @@
+/**
+ * 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 type { Context } from 'aws-lambda';
+import type { BaseContext } from './context.js';
+import type { Middleware } from '../middleware/middleware.js';
+import { Logger } from '../logging/logger.js';
+/**
+ * Context for task (non-HTTP) handlers.
+ * Extends BaseContext so middleware written against BaseContext works here too.
+ */
+export interface TaskContext extends BaseContext {
+    /** Lambda function name */
+    functionName: string;
+    /** Remaining time in ms before Lambda timeout */
+    getRemainingTimeInMillis: () => number;
+    /** Raw Lambda context */
+    rawContext: Context;
+    /** The raw event payload (available to middleware) */
+    event: unknown;
+    /** Logger instance (available to middleware) */
+    logger: Logger;
+}
+/**
+ * Task handler function signature.
+ */
+export type TaskHandlerFn<TEvent = unknown, TResult = unknown> = (event: TEvent, ctx: TaskContext, logger: Logger) => Promise<TResult>;
+/**
+ * Zod-like schema interface (compatible with Zod without hard dependency)
+ */
+interface ZodLikeSchema<T = unknown> {
+    safeParse(data: unknown): {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        error: {
+            issues: Array<{
+                path: (string | number)[];
+                message: string;
+            }>;
+        };
+    };
+}
+/**
+ * Task handler configuration.
+ */
+export interface TaskHandlerConfig<TEvent = unknown> {
+    /** Custom middleware to apply (same Middleware type as HTTP handlers) */
+    middleware?: Middleware<TaskContext>[];
+    /** Log level (default: 'info') */
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+    /**
+     * Wrap execution in a database transaction.
+     * Requires @venturekit/data. Auto-commits on success, rolls back on error.
+     */
+    transactional?: boolean;
+    /**
+     * Zod schema for event validation.
+     * If provided, the event payload is validated before the handler runs.
+     * On failure, an error is thrown with structured validation details.
+     */
+    event?: ZodLikeSchema<TEvent>;
+    /**
+     * Timeout in milliseconds. If the handler exceeds this, an error is thrown.
+     * By default, no timeout is enforced (Lambda's own timeout applies).
+     */
+    timeout?: number;
+    /**
+     * Maximum number of application-level retries within a single Lambda invocation
+     * (default: 0 = no retry). Only retries on non-validation errors.
+     *
+     * This is separate from infrastructure retries (SQS re-delivery, EventBridge
+     * retry policy) which happen outside your code when the Lambda returns an error.
+     *
+     * Recommended: use 1–3 for transient errors (network, throttle).
+     * Do NOT set high values for queue consumers — let the message return
+     * to the queue instead so other consumers can pick it up.
+     */
+    retries?: number;
+    /**
+     * Initial delay in ms between retries (default: 1000).
+     * Doubles on each subsequent retry (exponential backoff).
+     */
+    retryDelayMs?: number;
+}
+/**
+ * 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 declare function taskHandler<TEvent = unknown, TResult = unknown>(fn: TaskHandlerFn<TEvent, TResult>, config?: TaskHandlerConfig<TEvent>): (event: TEvent, context: Context) => Promise<TResult>;
+/**
+ * Validation error for task events.
+ */
+export declare class TaskValidationError extends Error {
+    readonly issues: Array<{
+        path: (string | number)[];
+        message: string;
+    }>;
+    constructor(message: string, issues: Array<{
+        path: (string | number)[];
+        message: string;
+    }>);
+}
+export {};
+//# sourceMappingURL=task-handler.d.ts.map

package/dist/handler/task-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-handler.d.ts","sourceRoot":"","sources":["../../src/handler/task-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,cAAc,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAgB,MAAM,sBAAsB,CAAC;AAG5D;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,wBAAwB,EAAE,MAAM,MAAM,CAAC;IACvC,yBAAyB;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,sDAAsD;IACtD,KAAK,EAAE,OAAO,CAAC;IACf,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,CAC/D,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;GAEG;AACH,UAAU,aAAa,CAAC,CAAC,GAAG,OAAO;IACjC,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE;YAAE,MAAM,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;CACrJ;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,MAAM,GAAG,OAAO;IACjD,yEAAyE;IACzE,UAAU,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;IACvC,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA4CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,WAAW,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC7D,EAAE,EAAE,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,MAAM,GAAE,iBAAiB,CAAC,MAAM,CAAM,GACrC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAmJvD;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAgB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;gBAG5E,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAMhE"}