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

package/dist/patterns/idempotency.js.map

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

package/dist/patterns/invoke.d.ts

@@ -0,0 +1,279 @@
+/**
+ * VentureKit Lambda-to-Lambda Invocation
+ *
+ * Type-safe invocation of other VentureKit Lambda functions.
+ * Supports sync (RequestResponse) and async (Event) invocation.
+ * Automatically propagates trace context, tenant, and user info.
+ *
+ * ## Quick Start
+ *
+ * ```typescript
+ * import { invoke, invokeDirect } from '@venturekit/runtime';
+ *
+ * // Invoke another VentureKit route handler (builds API Gateway event)
+ * const result = await invoke('users/{id}', {
+ *   method: 'GET',
+ *   pathParams: { id: '42' },
+ * });
+ *
+ * // Invoke any Lambda function directly with a custom payload
+ * const result = await invokeDirect('my-worker-function', {
+ *   task: 'processImage',
+ *   imageUrl: 'https://...',
+ * });
+ * ```
+ */
+import type { TraceContext } from '../logging/tracing.js';
+import type { CircuitBreakerOptions } from './circuit-breaker.js';
+/**
+ * Invocation mode
+ */
+export type InvokeMode = 'sync' | 'async';
+/**
+ * Invoke options
+ */
+export interface InvokeOptions {
+    /** HTTP method (default: POST) */
+    method?: string;
+    /** Request body */
+    body?: unknown;
+    /** Path parameters */
+    pathParams?: Record<string, string>;
+    /** Query parameters */
+    queryParams?: Record<string, string>;
+    /** Additional headers */
+    headers?: Record<string, string>;
+    /** Invocation mode: 'sync' (default) or 'async' (fire-and-forget) */
+    mode?: InvokeMode;
+    /** Trace context to propagate */
+    trace?: TraceContext;
+    /** Tenant ID to propagate */
+    tenantId?: string;
+    /** User ID to propagate */
+    userId?: string;
+    /**
+     * Fallback result returned when the circuit breaker is open or the
+     * failure threshold is reached. When provided, the built-in circuit
+     * breaker is automatically enabled for this call.
+     *
+     * @example
+     * ```typescript
+     * const users = await invoke<User[]>('users/list', {
+     *   method: 'GET',
+     *   fallback: { statusCode: 503, data: [], headers: {} },
+     * });
+     * ```
+     */
+    fallback?: InvokeResult<any>;
+}
+/**
+ * Invoke result
+ */
+export interface InvokeResult<T = unknown> {
+    statusCode: number;
+    data: T;
+    headers: Record<string, string>;
+}
+/**
+ * Lambda invoker function type.
+ * This is the low-level function that actually calls AWS Lambda.
+ * Users provide this so the runtime doesn't hard-depend on AWS SDK.
+ */
+export interface LambdaInvoker {
+    (params: {
+        functionName: string;
+        payload: string;
+        invocationType: 'RequestResponse' | 'Event';
+    }): Promise<{
+        statusCode?: number;
+        payload?: string;
+    }>;
+}
+/**
+ * Route-to-function-name resolver.
+ * Converts a VentureKit route path to an AWS Lambda function name.
+ */
+export type FunctionNameResolver = (route: string) => string;
+/**
+ * Default function name resolver.
+ * Converts 'users/get' → '{prefix}-users-get'
+ */
+export declare function defaultFunctionNameResolver(prefix: string): FunctionNameResolver;
+/**
+ * Create a VentureKit service invoker
+ */
+export declare function createInvoker(options: {
+    /** Low-level Lambda invoker function */
+    invoker: LambdaInvoker;
+    /** Function name resolver (route → Lambda function name) */
+    resolver: FunctionNameResolver;
+}): <T = unknown>(route: string, invokeOptions?: InvokeOptions) => Promise<InvokeResult<T>>;
+/**
+ * Configure the shared circuit breaker used by `invoke()`.
+ * Call this at startup if you need custom thresholds.
+ *
+ * @example
+ * ```typescript
+ * configureCircuitBreaker({ failureThreshold: 3, resetTimeoutMs: 60_000 });
+ * ```
+ */
+export declare function configureCircuitBreaker(options: CircuitBreakerOptions): void;
+/**
+ * Create a LambdaInvoker backed by the AWS SDK v3.
+ * Lazily loads `@aws-sdk/client-lambda` to avoid hard dependency.
+ */
+export declare function createLambdaInvoker(options?: {
+    /** AWS region (default: process.env.AWS_REGION || 'us-east-1') */
+    region?: string;
+}): Promise<LambdaInvoker>;
+/**
+ * Create a LambdaInvoker that routes calls to the local dev server via HTTP.
+ * Used automatically when VENTURE_LOCAL=true.
+ *
+ * Route invocations are forwarded as real HTTP requests to localhost.
+ * Function invocations are forwarded to /_dev/invoke/{name}.
+ *
+ * ### Cross-project calls
+ *
+ * By default all calls go to the current project's dev server. To call
+ * functions in another local project, set `VENTURE_LOCAL_URLS`:
+ *
+ * ```bash
+ * VENTURE_LOCAL_URLS="app=http://localhost:3000,billing=http://localhost:3001"
+ * ```
+ *
+ * The invoker matches the function name prefix against the registry
+ * and routes accordingly.
+ */
+export declare function createLocalInvoker(): LambdaInvoker;
+/**
+ * Target for direct function invocation.
+ *
+ * Use this object form when calling standalone Lambda functions
+ * (not API Gateway routes) like saga workers, processors, etc.
+ */
+export interface FunctionInvokeTarget {
+    /**
+     * Function name as defined in your project.
+     * This is the short name (e.g. 'process-orders'), NOT the full AWS name.
+     * VentureKit resolves it to `{project}-{stage}-fn-{name}` automatically.
+     *
+     * For functions in subdirectories under src/functions/:
+     * - `src/functions/process-orders.ts` → `'process-orders'`
+     * - `src/functions/order/create-order.ts` → `'order-create-order'`
+     */
+    function: string;
+    /**
+     * Target project name. Omit to invoke a function in the current project.
+     * Set this when calling a function in a different microservice / project.
+     *
+     * The resolved name becomes `{project}-{stage}-fn-{name}`.
+     *
+     * In local dev, the request is routed to the project's dev server
+     * as configured in `VENTURE_LOCAL_URLS`.
+     *
+     * @example
+     * ```typescript
+     * // Call 'send-invoice' in the 'billing' project
+     * await invoke({ function: 'send-invoice', project: 'billing' }, {
+     *   payload: { orderId: '123' },
+     * });
+     * ```
+     */
+    project?: string;
+}
+/**
+ * Options for direct function invocation (via object form).
+ */
+export interface FunctionInvokeOptions {
+    /** Payload to send to the function */
+    payload?: unknown;
+    /** Invocation mode: 'sync' (default) or 'async' (fire-and-forget) */
+    mode?: InvokeMode;
+    /**
+     * Fallback result returned when the circuit breaker is open.
+     * See `InvokeOptions.fallback` for details.
+     */
+    fallback?: InvokeResult<any>;
+}
+/**
+ * Resolve a standalone function name to its full AWS Lambda name.
+ * Convention: `{project}-{stage}-fn-{name}`
+ *
+ * @param name - Short function name (e.g. 'process-orders')
+ * @param project - Target project name. Defaults to the current project.
+ */
+export declare function resolveFunctionName(name: string, project?: string): string;
+/**
+ * Invoke another VentureKit Lambda function.
+ *
+ * **Unified API** — supports both route handlers and standalone functions:
+ *
+ * ### Route invocation (string first param)
+ * Calls another VentureKit route handler. Builds an API Gateway V2 event,
+ * calls Lambda directly (skips API Gateway), and parses the response.
+ *
+ * ### Function invocation (object first param)
+ * Calls a standalone function (saga worker, processor, etc.) with a raw payload.
+ * Auto-resolves the full Lambda name from your short function name.
+ *
+ * @example Route invocation
+ * ```typescript
+ * import { invoke } from '@venturekit/runtime';
+ *
+ * // Call a route handler
+ * const users = await invoke<User[]>('users/list', { method: 'GET' });
+ *
+ * // POST with body
+ * const created = await invoke<User>('users/create', {
+ *   body: { name: 'Alice' },
+ * });
+ *
+ * // Fire-and-forget
+ * await invoke('notifications/send', { mode: 'async', body: { userId: '42' } });
+ * ```
+ *
+ * @example Function invocation
+ * ```typescript
+ * import { invoke } from '@venturekit/runtime';
+ *
+ * // Call a standalone function (src/functions/process-orders.ts)
+ * const result = await invoke<{ jobId: string }>(
+ *   { function: 'process-orders' },
+ *   { payload: { orderId: 'abc', items: [...] } },
+ * );
+ *
+ * // Fire-and-forget
+ * await invoke(
+ *   { function: 'send-email' },
+ *   { payload: { to: 'user@example.com' }, mode: 'async' },
+ * );
+ * ```
+ */
+export declare function invoke<T = unknown>(target: string | FunctionInvokeTarget, options?: InvokeOptions | FunctionInvokeOptions): Promise<InvokeResult<T>>;
+/**
+ * Options for direct Lambda invocation (non-API-gateway functions).
+ * @deprecated Use `invoke({ function: 'name' }, { payload, mode })` instead.
+ */
+export interface DirectInvokeOptions {
+    /** Invocation mode: 'sync' (default) or 'async' (fire-and-forget) */
+    mode?: InvokeMode;
+    /** AWS region override */
+    region?: string;
+}
+/**
+ * Invoke result for direct invocations.
+ * @deprecated Use `invoke({ function: 'name' })` instead — returns InvokeResult.
+ */
+export interface DirectInvokeResult<T = unknown> {
+    statusCode: number;
+    data: T;
+}
+/**
+ * Invoke any Lambda function directly with a custom payload.
+ *
+ * @deprecated Use the unified `invoke({ function: 'name' }, { payload })` API instead.
+ * This function requires the full AWS Lambda name; the new API auto-resolves it.
+ */
+export declare function invokeDirect<T = unknown>(functionName: string, payload?: unknown, options?: DirectInvokeOptions): Promise<DirectInvokeResult<T>>;
+//# sourceMappingURL=invoke.d.ts.map

package/dist/patterns/invoke.d.ts.map

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