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

package/dist/middleware/rate-limit-store.js

@@ -0,0 +1,182 @@
+/**
+ * VentureKit Rate Limit Stores
+ *
+ * Pluggable backends for the rateLimitMiddleware.
+ *
+ * - `createDynamoDBRateLimitStore()` — production-ready, distributed
+ * - `createMemoryRateLimitStore()` — for local dev/testing only
+ * - `createDefaultRateLimiter()` — zero-config rate limiter with sensible defaults
+ */
+/**
+ * Built-in rate limit presets covering common requirements.
+ *
+ * | Preset     | Limit   | Window | Use Case                              |
+ * |------------|---------|--------|---------------------------------------|
+ * | `relaxed`  | 200/min | 60s    | Internal APIs, dev environments       |
+ * | `standard` | 100/min | 60s    | Public APIs, most production needs    |
+ * | `strict`   | 20/min  | 60s    | Auth endpoints, sensitive operations  |
+ * | `api-key`  | 1000/min| 60s    | Authenticated API-key consumers       |
+ */
+export const RATE_LIMIT_PRESETS = {
+    relaxed: { limit: 200, windowMs: 60_000 },
+    standard: { limit: 100, windowMs: 60_000 },
+    strict: { limit: 20, windowMs: 60_000 },
+    'api-key': { limit: 1000, windowMs: 60_000 },
+};
+// ---------------------------------------------------------------------------
+// In-memory store (dev / testing only)
+// ---------------------------------------------------------------------------
+/**
+ * Create an in-memory rate limit check function.
+ *
+ * **WARNING:** This stores counters in the Lambda process memory.
+ * It does NOT work correctly with multiple Lambda instances.
+ * Use only for local development and testing.
+ *
+ * For production, use `createDynamoDBRateLimitStore()`.
+ */
+export function createMemoryRateLimitStore(options) {
+    const presetConfig = options?.preset ? RATE_LIMIT_PRESETS[options.preset] : undefined;
+    const limit = options?.limit ?? presetConfig?.limit ?? 100;
+    const windowMs = options?.windowMs ?? presetConfig?.windowMs ?? 60_000;
+    const counters = new Map();
+    return async (key) => {
+        const now = Date.now();
+        let entry = counters.get(key);
+        // Reset expired window
+        if (!entry || now >= entry.resetAt) {
+            entry = { count: 0, resetAt: now + windowMs };
+            counters.set(key, entry);
+        }
+        entry.count++;
+        const allowed = entry.count <= limit;
+        const remaining = Math.max(0, limit - entry.count);
+        return { allowed, remaining, limit, resetAt: entry.resetAt };
+    };
+}
+/**
+ * Create a DynamoDB-backed rate limit check function.
+ *
+ * Uses atomic `UpdateItem` with `ADD` to safely increment counters
+ * across multiple Lambda instances. Expired entries are automatically
+ * cleaned up via DynamoDB TTL.
+ *
+ * ### DynamoDB Table Schema
+ *
+ * The table must have:
+ * - **Partition key:** `pk` (String) — the rate limit key
+ * - **TTL attribute:** `ttl` (Number) — epoch seconds for auto-cleanup
+ *
+ * You can create this table via infrastructure intents or manually:
+ *
+ * ```bash
+ * aws dynamodb create-table \
+ *   --table-name venturekit-rate-limits \
+ *   --attribute-definitions AttributeName=pk,AttributeType=S \
+ *   --key-schema AttributeName=pk,KeyType=HASH \
+ *   --billing-mode PAY_PER_REQUEST
+ *
+ * aws dynamodb update-time-to-live \
+ *   --table-name venturekit-rate-limits \
+ *   --time-to-live-specification "Enabled=true, AttributeName=ttl"
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import { rateLimitMiddleware } from '@venturekit/runtime';
+ * import { createDynamoDBRateLimitStore } from '@venturekit/runtime';
+ *
+ * const rateLimit = rateLimitMiddleware({
+ *   check: await createDynamoDBRateLimitStore({ preset: 'standard' }),
+ * });
+ * ```
+ */
+export async function createDynamoDBRateLimitStore(options = {}) {
+    const tableName = options.tableName
+        || process.env.VENTURE_RATE_LIMIT_TABLE
+        || 'venturekit-rate-limits';
+    const presetConfig = options.preset ? RATE_LIMIT_PRESETS[options.preset] : undefined;
+    const limit = options.limit ?? presetConfig?.limit ?? 100;
+    const windowMs = options.windowMs ?? presetConfig?.windowMs ?? 60_000;
+    const region = options.region || process.env.AWS_REGION || process.env.AWS_DEFAULT_REGION || 'us-east-1';
+    // Lazy-load AWS SDK
+    const { DynamoDBClient, UpdateItemCommand } = await import('@aws-sdk/client-dynamodb');
+    const client = new DynamoDBClient({ region });
+    return async (key) => {
+        const now = Date.now();
+        const windowStart = Math.floor(now / windowMs) * windowMs;
+        const resetAt = windowStart + windowMs;
+        const ttl = Math.ceil(resetAt / 1000) + 60; // TTL: window end + 60s buffer
+        // Composite key includes the window to auto-rotate
+        const pk = `${key}#${windowStart}`;
+        try {
+            const result = await client.send(new UpdateItemCommand({
+                TableName: tableName,
+                Key: { pk: { S: pk } },
+                UpdateExpression: 'ADD #count :inc SET #ttl = if_not_exists(#ttl, :ttl), #resetAt = if_not_exists(#resetAt, :resetAt)',
+                ExpressionAttributeNames: {
+                    '#count': 'count',
+                    '#ttl': 'ttl',
+                    '#resetAt': 'resetAt',
+                },
+                ExpressionAttributeValues: {
+                    ':inc': { N: '1' },
+                    ':ttl': { N: String(ttl) },
+                    ':resetAt': { N: String(resetAt) },
+                },
+                ReturnValues: 'ALL_NEW',
+            }));
+            const count = parseInt(result.Attributes?.count?.N || '1', 10);
+            const allowed = count <= limit;
+            const remaining = Math.max(0, limit - count);
+            return { allowed, remaining, limit, resetAt };
+        }
+        catch (err) {
+            // On DynamoDB failure, fail open (allow the request)
+            // This prevents rate limiter outages from blocking all traffic
+            console.error('[VentureKit] Rate limit DynamoDB error (failing open):', err);
+            return { allowed: true, remaining: limit, limit, resetAt: now + windowMs };
+        }
+    };
+}
+/**
+ * Create a rate limit check function with sensible defaults.
+ *
+ * - In production (Lambda): uses DynamoDB for distributed rate limiting
+ * - In local dev: uses in-memory store
+ *
+ * This is the recommended way to add rate limiting with minimal configuration.
+ *
+ * @example
+ * ```typescript
+ * import { rateLimitMiddleware } from '@venturekit/runtime';
+ * import { createDefaultRateLimiter } from '@venturekit/runtime';
+ *
+ * // Zero-config — uses 'standard' preset (100 req/min)
+ * const rateLimit = rateLimitMiddleware({
+ *   check: await createDefaultRateLimiter(),
+ * });
+ *
+ * // Strict for auth endpoints
+ * const authRateLimit = rateLimitMiddleware({
+ *   check: await createDefaultRateLimiter({ preset: 'strict' }),
+ * });
+ * ```
+ */
+export async function createDefaultRateLimiter(options = {}) {
+    const isLocal = !process.env.AWS_LAMBDA_FUNCTION_NAME && !process.env.AWS_EXECUTION_ENV;
+    if (isLocal || options.forceMemory) {
+        return createMemoryRateLimitStore({
+            preset: options.preset,
+            limit: options.limit,
+            windowMs: options.windowMs,
+        });
+    }
+    return createDynamoDBRateLimitStore({
+        preset: options.preset,
+        limit: options.limit,
+        windowMs: options.windowMs,
+        tableName: options.tableName,
+    });
+}
+//# sourceMappingURL=rate-limit-store.js.map

package/dist/middleware/rate-limit-store.js.map

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

package/dist/openapi/openapi.d.ts

@@ -0,0 +1,147 @@
+/**
+ * VentureKit OpenAPI Spec Generator
+ *
+ * Generates OpenAPI 3.1 specs from route definitions.
+ * Works with file-based routing convention:
+ *   src/routes/<path>/<method>.ts → <METHOD> /<path>
+ *
+ * Supports Zod-like schema extraction for request/response docs.
+ */
+/**
+ * HTTP methods supported by VentureKit
+ */
+export type HttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete';
+/**
+ * JSON Schema subset for OpenAPI
+ */
+export interface JsonSchema {
+    type?: string;
+    properties?: Record<string, JsonSchema>;
+    items?: JsonSchema;
+    required?: string[];
+    description?: string;
+    enum?: (string | number)[];
+    format?: string;
+    example?: unknown;
+    nullable?: boolean;
+    oneOf?: JsonSchema[];
+    anyOf?: JsonSchema[];
+    allOf?: JsonSchema[];
+    $ref?: string;
+    additionalProperties?: boolean | JsonSchema;
+    default?: unknown;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+}
+/**
+ * Route definition for OpenAPI generation
+ */
+export interface RouteDefinition {
+    /** HTTP method */
+    method: HttpMethod;
+    /** Path (e.g., "/tasks", "/tasks/{id}") */
+    path: string;
+    /** Operation summary */
+    summary?: string;
+    /** Operation description */
+    description?: string;
+    /** Operation tags */
+    tags?: string[];
+    /** Required scopes (maps to security) */
+    scopes?: string[];
+    /** Request body schema */
+    requestBody?: JsonSchema;
+    /** Query parameter schemas (key → schema; mark required via `queryRequired` array) */
+    queryParams?: Record<string, JsonSchema>;
+    /** Which query params are required */
+    queryRequired?: string[];
+    /** Path parameter schemas */
+    pathParams?: Record<string, JsonSchema>;
+    /** Response schema (for success response) */
+    response?: JsonSchema;
+    /** Response status code */
+    statusCode?: number;
+    /** Whether the route is deprecated */
+    deprecated?: boolean;
+}
+/**
+ * OpenAPI info block
+ */
+export interface OpenAPIInfo {
+    title: string;
+    version: string;
+    description?: string;
+    contact?: {
+        name?: string;
+        email?: string;
+        url?: string;
+    };
+    license?: {
+        name: string;
+        url?: string;
+    };
+}
+/**
+ * OpenAPI server block
+ */
+export interface OpenAPIServer {
+    url: string;
+    description?: string;
+}
+/**
+ * OpenAPI generator options
+ */
+export interface OpenAPIGeneratorOptions {
+    info: OpenAPIInfo;
+    servers?: OpenAPIServer[];
+    /** Security scheme name for authenticated routes */
+    securitySchemeName?: string;
+    /** Default tags applied to all routes */
+    defaultTags?: string[];
+}
+/**
+ * OpenAPI 3.1 document (simplified)
+ */
+export interface OpenAPIDocument {
+    openapi: string;
+    info: OpenAPIInfo;
+    servers?: OpenAPIServer[];
+    paths: Record<string, Record<string, unknown>>;
+    components?: {
+        securitySchemes?: Record<string, unknown>;
+        schemas?: Record<string, JsonSchema>;
+    };
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+}
+/**
+ * Generate an OpenAPI 3.1 document from route definitions
+ */
+export declare function generateOpenAPISpec(routes: RouteDefinition[], options: OpenAPIGeneratorOptions): OpenAPIDocument;
+/**
+ * Convert file-based route paths to OpenAPI paths.
+ *
+ * Converts:
+ *   "tasks" → "/tasks"
+ *   "tasks/[id]" → "/tasks/{id}"
+ *   "users/[userId]/posts" → "/users/{userId}/posts"
+ */
+export declare function filePathToOpenAPI(filePath: string): string;
+/**
+ * Infer route tag from path (first segment)
+ */
+export declare function inferTag(path: string): string;
+/**
+ * Serialize OpenAPI document to JSON
+ */
+export declare function serializeOpenAPI(doc: OpenAPIDocument, pretty?: boolean): string;
+/**
+ * Serialize OpenAPI document to YAML-like format (simple, no dependency)
+ */
+export declare function serializeOpenAPIYaml(doc: OpenAPIDocument): string;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/openapi/openapi.d.ts.map

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

package/dist/openapi/openapi.js

@@ -0,0 +1,235 @@
+/**
+ * VentureKit OpenAPI Spec Generator
+ *
+ * Generates OpenAPI 3.1 specs from route definitions.
+ * Works with file-based routing convention:
+ *   src/routes/<path>/<method>.ts → <METHOD> /<path>
+ *
+ * Supports Zod-like schema extraction for request/response docs.
+ */
+/**
+ * Build a parameter object for OpenAPI
+ */
+function buildParameter(name, location, schema, isRequired) {
+    return {
+        name,
+        in: location,
+        required: location === 'path' ? true : isRequired ?? false,
+        schema: { type: schema.type ?? 'string', ...(schema.enum ? { enum: schema.enum } : {}), ...(schema.description ? { description: schema.description } : {}) },
+        ...(schema.description ? { description: schema.description } : {}),
+    };
+}
+/**
+ * Build a request body object for OpenAPI
+ */
+function buildRequestBody(schema) {
+    return {
+        required: true,
+        content: {
+            'application/json': {
+                schema,
+            },
+        },
+    };
+}
+/**
+ * Build response objects for OpenAPI
+ */
+function buildResponses(route) {
+    const statusCode = route.statusCode ?? (route.method === 'post' ? 201 : route.method === 'delete' ? 204 : 200);
+    const responses = {};
+    if (statusCode === 204) {
+        responses['204'] = { description: 'No Content' };
+    }
+    else {
+        const responseObj = {
+            description: statusCode === 201 ? 'Created' : 'OK',
+        };
+        if (route.response) {
+            responseObj.content = {
+                'application/json': {
+                    schema: route.response,
+                },
+            };
+        }
+        responses[String(statusCode)] = responseObj;
+    }
+    // Standard error responses
+    if (route.scopes && route.scopes.length > 0) {
+        responses['401'] = { description: 'Unauthorized' };
+        responses['403'] = { description: 'Forbidden' };
+    }
+    return responses;
+}
+/**
+ * Generate an OpenAPI 3.1 document from route definitions
+ */
+export function generateOpenAPISpec(routes, options) {
+    const { info, servers, securitySchemeName = 'bearerAuth', defaultTags, } = options;
+    const paths = {};
+    const tagSet = new Set();
+    let hasAuthRoutes = false;
+    for (const route of routes) {
+        const openapiPath = route.path;
+        if (!paths[openapiPath]) {
+            paths[openapiPath] = {};
+        }
+        // Build parameters
+        const parameters = [];
+        // Path parameters (always required)
+        if (route.pathParams) {
+            for (const [name, schema] of Object.entries(route.pathParams)) {
+                parameters.push(buildParameter(name, 'path', schema));
+            }
+        }
+        // Query parameters
+        if (route.queryParams) {
+            for (const [name, schema] of Object.entries(route.queryParams)) {
+                const isRequired = route.queryRequired?.includes(name) ?? false;
+                parameters.push(buildParameter(name, 'query', schema, isRequired));
+            }
+        }
+        // Build operation
+        const operation = {};
+        if (route.summary)
+            operation.summary = route.summary;
+        if (route.description)
+            operation.description = route.description;
+        if (route.deprecated)
+            operation.deprecated = true;
+        // Tags
+        const tags = [...(defaultTags ?? []), ...(route.tags ?? [])];
+        if (tags.length > 0) {
+            operation.tags = tags;
+            for (const tag of tags)
+                tagSet.add(tag);
+        }
+        // Parameters
+        if (parameters.length > 0) {
+            operation.parameters = parameters;
+        }
+        // Request body
+        if (route.requestBody && ['post', 'put', 'patch'].includes(route.method)) {
+            operation.requestBody = buildRequestBody(route.requestBody);
+        }
+        // Responses
+        operation.responses = buildResponses(route);
+        // Security
+        if (route.scopes && route.scopes.length > 0) {
+            hasAuthRoutes = true;
+            operation.security = [{ [securitySchemeName]: route.scopes }];
+        }
+        paths[openapiPath][route.method] = operation;
+    }
+    // Build document
+    const doc = {
+        openapi: '3.1.0',
+        info,
+        paths,
+    };
+    if (servers && servers.length > 0) {
+        doc.servers = servers;
+    }
+    // Tags
+    if (tagSet.size > 0) {
+        doc.tags = Array.from(tagSet)
+            .sort()
+            .map(name => ({ name }));
+    }
+    // Security schemes
+    if (hasAuthRoutes) {
+        doc.components = {
+            securitySchemes: {
+                [securitySchemeName]: {
+                    type: 'http',
+                    scheme: 'bearer',
+                    bearerFormat: 'JWT',
+                },
+            },
+        };
+    }
+    return doc;
+}
+/**
+ * Convert file-based route paths to OpenAPI paths.
+ *
+ * Converts:
+ *   "tasks" → "/tasks"
+ *   "tasks/[id]" → "/tasks/{id}"
+ *   "users/[userId]/posts" → "/users/{userId}/posts"
+ */
+export function filePathToOpenAPI(filePath) {
+    let result = filePath
+        .replace(/\[([^\]]+)\]/g, '{$1}') // [id] → {id}
+        .replace(/\\/g, '/'); // backslash → forward slash
+    if (!result.startsWith('/')) {
+        result = '/' + result;
+    }
+    return result;
+}
+/**
+ * Infer route tag from path (first segment)
+ */
+export function inferTag(path) {
+    const segments = path.replace(/^\//, '').split('/');
+    return segments[0] || 'default';
+}
+/**
+ * Serialize OpenAPI document to JSON
+ */
+export function serializeOpenAPI(doc, pretty = true) {
+    return JSON.stringify(doc, null, pretty ? 2 : undefined);
+}
+/**
+ * Serialize OpenAPI document to YAML-like format (simple, no dependency)
+ */
+export function serializeOpenAPIYaml(doc) {
+    return toYaml(doc, 0);
+}
+function toYaml(value, indent) {
+    const pad = '  '.repeat(indent);
+    if (value === null || value === undefined)
+        return 'null';
+    if (typeof value === 'boolean')
+        return String(value);
+    if (typeof value === 'number')
+        return String(value);
+    if (typeof value === 'string') {
+        if (value.includes('\n') || value.includes(':') || value.includes('#') || value.includes('"')) {
+            return `"${value.replace(/"/g, '\\"')}"`;
+        }
+        return value;
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return '[]';
+        const items = value.map(item => {
+            const serialized = toYaml(item, indent + 1);
+            if (typeof item === 'object' && item !== null && !Array.isArray(item)) {
+                return `${pad}- ${serialized.trimStart()}`;
+            }
+            return `${pad}- ${serialized}`;
+        });
+        return '\n' + items.join('\n');
+    }
+    if (typeof value === 'object') {
+        const obj = value;
+        const keys = Object.keys(obj);
+        if (keys.length === 0)
+            return '{}';
+        const lines = keys.map(key => {
+            const val = obj[key];
+            const serialized = toYaml(val, indent + 1);
+            if (typeof val === 'object' && val !== null && !Array.isArray(val) && Object.keys(val).length > 0) {
+                return `${pad}${key}:\n${serialized}`;
+            }
+            if (Array.isArray(val) && val.length > 0) {
+                return `${pad}${key}:${serialized}`;
+            }
+            return `${pad}${key}: ${serialized}`;
+        });
+        return lines.join('\n');
+    }
+    return String(value);
+}
+//# sourceMappingURL=openapi.js.map

package/dist/openapi/openapi.js.map

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

package/dist/openapi.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @venturekit/runtime/openapi
+ *
+ * OpenAPI spec generation from VentureKit route definitions.
+ *
+ * Import via: `import { generateOpenAPISpec } from '@venturekit/runtime/openapi'`
+ */
+export { generateOpenAPISpec, filePathToOpenAPI, inferTag, serializeOpenAPI, serializeOpenAPIYaml, } from './openapi/openapi.js';
+export type { HttpMethod, JsonSchema, RouteDefinition, OpenAPIInfo, OpenAPIServer, OpenAPIGeneratorOptions, OpenAPIDocument, } from './openapi/openapi.js';
+//# sourceMappingURL=openapi.d.ts.map

package/dist/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,QAAQ,EACR,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,UAAU,EACV,UAAU,EACV,eAAe,EACf,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,eAAe,GAChB,MAAM,sBAAsB,CAAC"}

package/dist/openapi.js

@@ -0,0 +1,9 @@
+/**
+ * @venturekit/runtime/openapi
+ *
+ * OpenAPI spec generation from VentureKit route definitions.
+ *
+ * Import via: `import { generateOpenAPISpec } from '@venturekit/runtime/openapi'`
+ */
+export { generateOpenAPISpec, filePathToOpenAPI, inferTag, serializeOpenAPI, serializeOpenAPIYaml, } from './openapi/openapi.js';
+//# sourceMappingURL=openapi.js.map

package/dist/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,QAAQ,EACR,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC"}