@worktif/runtime 0.3.0-edge.0 → 0.3.0-edge.10

package/out/dist/src/core/services/index.d.ts

@@ -0,0 +1,4 @@
+import 'reflect-metadata';
+export * from '@worktif/purenow/lambda';
+export * from './runtime-extensions';
+//# sourceMappingURL=index.d.ts.map

package/out/dist/src/core/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/services/index.ts"],"names":[],"mappings":"AAgBA,OAAO,kBAAkB,CAAC;AAG1B,cAAc,yBAAyB,CAAC;AAGxC,cAAc,sBAAsB,CAAC"}

package/out/dist/src/core/services/runtime-extensions/index.d.ts

@@ -0,0 +1,4 @@
+import 'reflect-metadata';
+export * from './runtime-extensions.service';
+export * from './runtime-extensions.types';
+//# sourceMappingURL=index.d.ts.map

package/out/dist/src/core/services/runtime-extensions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/core/services/runtime-extensions/index.ts"],"names":[],"mappings":"AAgBA,OAAO,kBAAkB,CAAC;AAE1B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC"}

package/out/dist/src/core/services/runtime-extensions/runtime-extensions.service.d.ts

@@ -0,0 +1,98 @@
+import 'reflect-metadata';
+import { BeforeInstance, Maybe } from '@worktif/utils';
+import type { RuntimeConfig, RuntimeStackConfig } from './runtime-extensions.types';
+/**
+ * RuntimeExtensions service provides runtime-specific functionality that extends
+ * purenow's base capabilities. This service follows purenow's architectural patterns
+ * for AWS integrations and dependency injection.
+ *
+ * Key responsibilities:
+ * - Enhance development server with runtime-specific features
+ * - Provide runtime-specific build optimizations
+ * - Configure Runtime Core stack deployment
+ * - Extend purenow functionality without replacing it
+ */
+export declare class RuntimeExtensions {
+    /**
+     * Runtime configuration with default values.
+     * Extends purenow configuration rather than replacing it.
+     */
+    private runtimeConfig;
+    /**
+     * Constructor for RuntimeExtensions service.
+     * Uses dependency injection pattern consistent with purenow services.
+     */
+    constructor();
+    /**
+     * Initialize runtime extensions with default configuration.
+     * Sets up runtime-specific features that extend purenow functionality.
+     */
+    private initializeRuntimeExtensions;
+    /**
+     * Enhance development server with runtime-specific features.
+     * Extends purenow's development server without replacing it.
+     *
+     * @param serverConfig - Base server configuration from purenow
+     * @param beforeInstance - Logger instance for tracking
+     * @returns Runtime Core server configuration
+     */
+    enhanceDevServer(serverConfig: Record<string, any>, beforeInstance?: BeforeInstance): Promise<Record<string, any>>;
+    /**
+     * Optimize build process with runtime-specific optimizations.
+     * Extends purenow's build process without replacing it.
+     *
+     * @param buildConfig - Base build configuration from purenow
+     * @param beforeInstance - Logger instance for tracking
+     * @returns Optimized build configuration
+     */
+    optimizeBuild(buildConfig: Record<string, any>, beforeInstance?: BeforeInstance): Promise<Record<string, any>>;
+    /**
+     * Configure Runtime Core stack for runtime deployment.
+     * Extends purenow's two-stack architecture to three stacks.
+     *
+     * @param baseStackConfig - Base stack configuration from purenow
+     * @param beforeInstance - Logger instance for tracking
+     * @returns Runtime stack configuration for Runtime Core stack
+     */
+    configureRuntimeCoreStack(baseStackConfig: Record<string, any>, beforeInstance?: BeforeInstance): Promise<Maybe<RuntimeStackConfig>>;
+    /**
+     * Update runtime configuration.
+     * Allows dynamic configuration of runtime features.
+     *
+     * @param config - New runtime configuration
+     * @param beforeInstance - Logger instance for tracking
+     */
+    updateConfiguration(config: Partial<RuntimeConfig>, beforeInstance?: BeforeInstance): Promise<void>;
+    /**
+     * Get current runtime configuration.
+     * Provides read-only access to runtime configuration.
+     *
+     * @returns Current runtime configuration
+     */
+    getConfiguration(): Readonly<RuntimeConfig>;
+    /**
+     * Check if runtime feature is enabled.
+     * Utility method for checking feature flags.
+     *
+     * @param feature - Feature name to check
+     * @returns True if feature is enabled
+     */
+    isFeatureEnabled(feature: string): boolean;
+    /**
+     * Enable runtime feature.
+     * Adds feature to the list of enabled features.
+     *
+     * @param feature - Feature name to enable
+     * @param beforeInstance - Logger instance for tracking
+     */
+    enableFeature(feature: string, beforeInstance?: BeforeInstance): Promise<void>;
+    /**
+     * Disable runtime feature.
+     * Removes feature from the list of enabled features.
+     *
+     * @param feature - Feature name to disable
+     * @param beforeInstance - Logger instance for tracking
+     */
+    disableFeature(feature: string, beforeInstance?: BeforeInstance): Promise<void>;
+}
+//# sourceMappingURL=runtime-extensions.service.d.ts.map

package/out/dist/src/core/services/runtime-extensions/runtime-extensions.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-extensions.service.d.ts","sourceRoot":"","sources":["../../../../../../src/core/services/runtime-extensions/runtime-extensions.service.ts"],"names":[],"mappings":"AAgBA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EACL,cAAc,EAKd,KAAK,EAEN,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEpF;;;;;;;;;;GAUG;AACH,qBACa,iBAAiB;IAY5B;;;OAGG;IACH,OAAO,CAAC,aAAa,CAcnB;IAEF;;;OAGG;;IAMH;;;OAGG;YAKW,2BAA2B;IAazC;;;;;;;OAOG;IAKU,gBAAgB,CAC3B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IA0B/B;;;;;;;OAOG;IAKU,aAAa,CACxB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChC,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IA0B/B;;;;;;;OAOG;IAKU,yBAAyB,CACpC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACpC,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IA6CrC;;;;;;OAMG;IAKU,mBAAmB,CAC9B,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,EAC9B,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,IAAI,CAAC;IA0BhB;;;;;OAKG;IACI,gBAAgB,IAAI,QAAQ,CAAC,aAAa,CAAC;IAIlD;;;;;;OAMG;IACI,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIjD;;;;;;OAMG;IAKU,aAAa,CACxB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,IAAI,CAAC;IAmBhB;;;;;;OAMG;IAKU,cAAc,CACzB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,IAAI,CAAC;CAgBjB"}

package/out/dist/src/core/services/runtime-extensions/runtime-extensions.types.d.ts

@@ -0,0 +1,71 @@
+import 'reflect-metadata';
+/**
+ * Configuration options for runtime-specific features.
+ */
+export interface RuntimeConfig {
+    /** Enable Runtime Core stack deployment */
+    enableRuntimeCoreStack?: boolean;
+    /** Runtime web mode configuration */
+    runtimeWebMode?: 'development' | 'production';
+    /** Additional runtime features to enable */
+    additionalFeatures?: string[];
+    /** Development server enhancements */
+    devServerEnhancements?: {
+        hotReload?: boolean;
+        debugMode?: boolean;
+        performanceMonitoring?: boolean;
+    };
+    /** Build optimizations */
+    buildOptimizations?: {
+        bundleAnalysis?: boolean;
+        treeshaking?: boolean;
+        codeMinification?: boolean;
+    };
+}
+/**
+ * Runtime stack configuration for the Runtime Core stack.
+ */
+export interface RuntimeStackConfig {
+    /** Name of the runtime stack */
+    stackName: string;
+    /** AWS resources to include in the stack */
+    resources: RuntimeResource[];
+    /** Dependencies on other stacks */
+    dependencies: string[];
+    /** Stack outputs to export */
+    outputs: Record<string, string>;
+}
+/**
+ * Runtime-specific AWS resource configuration.
+ */
+export interface RuntimeResource {
+    /** Resource type (e.g., 'Lambda', 'DynamoDB', 'S3') */
+    type: string;
+    /** Resource name */
+    name: string;
+    /** Resource configuration */
+    config: Record<string, any>;
+}
+/**
+ * Development server enhancement options.
+ */
+export interface DevServerEnhancements {
+    /** Enable hot module replacement */
+    hotReload: boolean;
+    /** Enable debug mode with additional logging */
+    debugMode: boolean;
+    /** Enable performance monitoring */
+    performanceMonitoring: boolean;
+}
+/**
+ * Build optimization configuration.
+ */
+export interface BuildOptimizations {
+    /** Enable bundle analysis */
+    bundleAnalysis: boolean;
+    /** Enable tree shaking */
+    treeshaking: boolean;
+    /** Enable code minification */
+    codeMinification: boolean;
+}
+//# sourceMappingURL=runtime-extensions.types.d.ts.map

package/out/dist/src/core/services/runtime-extensions/runtime-extensions.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-extensions.types.d.ts","sourceRoot":"","sources":["../../../../../../src/core/services/runtime-extensions/runtime-extensions.types.ts"],"names":[],"mappings":"AAgBA,OAAO,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,qCAAqC;IACrC,cAAc,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;IAC9C,4CAA4C;IAC5C,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,sCAAsC;IACtC,qBAAqB,CAAC,EAAE;QACtB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,qBAAqB,CAAC,EAAE,OAAO,CAAC;KACjC,CAAC;IACF,0BAA0B;IAC1B,kBAAkB,CAAC,EAAE;QACnB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,mCAAmC;IACnC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,cAAc,EAAE,OAAO,CAAC;IACxB,0BAA0B;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,+BAA+B;IAC/B,gBAAgB,EAAE,OAAO,CAAC;CAC3B"}

package/out/dist/src/infra/index.d.ts

@@ -0,0 +1,3 @@
+export * from '@worktif/purenow/infra';
+export * from './runtime-web';
+//# sourceMappingURL=index.d.ts.map

package/out/dist/src/infra/runtime-web/constructs/api-gateway-builder.d.ts

@@ -0,0 +1,157 @@
+import { Construct } from 'constructs';
+import * as lambda from 'aws-cdk-lib/aws-lambda';
+import * as apigatewayv2 from 'aws-cdk-lib/aws-apigatewayv2';
+import type { HttpMethod } from '../../../lib/runtime-web/types';
+import { PurenowInfraResourceOptions, PurenowInfraResources } from '@worktif/purenow/infra';
+import { RuntimeWebStackProps } from '../../runtime-web';
+/**
+ * Properties for ApiGatewayBuilder construct
+ */
+export interface ApiGatewayBuilderProps {
+    /**
+     * Deployment stage
+     */
+    stage: 'dev' | 'staging' | 'prod';
+    /**
+     * Service name for resource naming
+     */
+    serviceName: string;
+    /**
+     * Allowed origins for CORS
+     * @default ['*'] for dev/staging, specific domains for prod
+     */
+    allowedOrigins?: string[];
+    /**
+     * Custom domain configuration
+     */
+    domain?: {
+        rootDomain: string;
+        subdomain?: string;
+        certificateArn?: string;
+        hostedZoneId?: string;
+    };
+}
+/**
+ * ApiGatewayBuilder - CDK construct for building API Gateway from Lambda definitions.
+ *
+ * Creates HTTP API Gateway with routes for Lambda functions based on their
+ * HttpIntegration configuration. Supports CORS, authentication, and custom domains.
+ *
+ * **Features**:
+ * - Automatic route creation from HttpIntegration
+ * - CORS configuration based on stage
+ * - Authentication mapping (none, jwt, iam, cognito, custom)
+ * - Custom domain support
+ * - Named stages (not $default)
+ *
+ * **Requirements**: REQ-14
+ *
+ * @example
+ * ```typescript
+ * const builder = new ApiGatewayBuilder(this, 'ApiGatewayBuilder', {
+ *   stage: 'dev',
+ *   serviceName: 'my-app'
+ * });
+ *
+ * const { api, stage } = builder.createApiGateway(lambdaFunctions, register);
+ * ```
+ */
+export declare class ApiGatewayBuilder extends Construct implements PurenowInfraResources {
+    private readonly props;
+    /**
+     * Microservice registrar for DI container management
+     */
+    private readonly registrar;
+    constructor(scope: Construct, id: string, props: ApiGatewayBuilderProps);
+    /**
+     * Create API Gateway with routes for all Lambda functions.
+     *
+     * Creates an HTTP API with routes based on the HttpIntegration configuration
+     * of each Lambda definition. Only creates routes for Lambdas with HTTP config.
+     *
+     * @param lambdaFunctions - Map of Lambda functions by ID
+     * @param props
+     * @returns Object with API Gateway and stage
+     *
+     * @example
+     * ```typescript
+     * const { api, stage } = builder.createApiGateway(lambdaFunctions, {
+     *   payments: {
+     *     ties: [PaymentsTies],
+     *     lambdas: [
+     *       {
+     *         id: 'charge',
+     *         http: { method: 'POST', path: '/api/payments/charge' }
+     *       }
+     *     ]
+     *   }
+     * });
+     * ```
+     */
+    createApiGateway(lambdaFunctions: Map<string, lambda.Function>, props: RuntimeWebStackProps): {
+        api: apigatewayv2.HttpApi;
+        stage: apigatewayv2.HttpStage;
+    };
+    /**
+     * Create a route for a Lambda function.
+     *
+     * Creates an API Gateway route with Lambda integration based on the
+     * HttpIntegration configuration.
+     *
+     * @param api - HTTP API instance
+     * @param lambdaFn - Lambda function to integrate
+     * @param http - HTTP integration configuration
+     * @param lambdaId - Lambda ID for naming
+     * @private
+     */
+    private createRoute;
+    /**
+     * Map high-level HTTP method to CDK HttpMethod.
+     *
+     * @param method - High-level HTTP method string
+     * @returns CDK HttpMethod enum value
+     */
+    mapHttpMethod(method: HttpMethod): apigatewayv2.HttpMethod;
+    /**
+     * Create authorizer based on auth type.
+     *
+     * Maps high-level auth types to CDK authorizer configurations.
+     * Currently supports 'none' (no auth). JWT, IAM, Cognito, and custom
+     * authorizers can be added in future iterations.
+     *
+     * @param authType - Authentication type
+     * @returns Authorizer or undefined for no auth
+     * @private
+     */
+    private createAuthorizer;
+    /**
+     * Create CORS configuration for API Gateway.
+     *
+     * Creates CORS preflight options based on stage and allowed origins.
+     *
+     * @param allowedOrigins - Array of allowed origins
+     * @returns CORS preflight options
+     * @private
+     */
+    private createCorsConfig;
+    /**
+     * Generates a signature for the provided region by extracting the first character of each segment in the region string, delimited by hyphens.
+     *
+     * @param {string} region - The region string to generate the signature from. It is expected to be a hyphen-separated string.
+     * @return {string} The generated region signature, formed by concatenating the first character of each valid segment. Returns an empty string if the input is invalid or empty.
+     */
+    private getRegionSignature;
+    /**
+     * Generates a resource name by concatenating service name, resource name,
+     * simplified region, and stage with hyphens as separators.
+     *
+     * @param {Object} params - An object containing the required parameters.
+     * @param {string} params.name - The name of the resource.
+     * @param {string} params.serviceName - The name of the service associated with the resource.
+     * @param {string} params.regionSimplified - The simplified region identifier.
+     * @param {string} params.stage - The deployment stage of the resource.
+     * @returns {string} The concatenated resource name.
+     */
+    resourceName({ name, serviceName, stage, region }: PurenowInfraResourceOptions): string;
+}
+//# sourceMappingURL=api-gateway-builder.d.ts.map

package/out/dist/src/infra/runtime-web/constructs/index.d.ts

@@ -0,0 +1,3 @@
+export { LambdaBuilder, LambdaBuilderProps } from './lambda-builder';
+export { ApiGatewayBuilder, ApiGatewayBuilderProps } from './api-gateway-builder';
+//# sourceMappingURL=index.d.ts.map

package/out/dist/src/infra/runtime-web/constructs/lambda-builder.d.ts

@@ -0,0 +1,158 @@
+import { Construct } from 'constructs';
+import * as lambda from 'aws-cdk-lib/aws-lambda';
+import * as iam from 'aws-cdk-lib/aws-iam';
+import type { LambdaDefinition, VpcConfig } from '../../../lib/runtime-web/types';
+import { PurenowInfraResourceOptions, PurenowInfraResources } from '@worktif/purenow/infra';
+import { RuntimeWebStackProps } from '../../runtime-web';
+/**
+ * Properties for LambdaBuilder construct
+ */
+export interface LambdaBuilderProps {
+    /**
+     * Deployment stage
+     */
+    stage: 'dev' | 'staging' | 'prod';
+    /**
+     * Service name for resource naming
+     */
+    serviceName: string;
+    /**
+     * IAM role for Lambda execution
+     */
+    lambdaRole: iam.IRole;
+    /**
+     * Default memory size in MB
+     * @default 512
+     */
+    defaultMemorySize?: number;
+    /**
+     * Default timeout in seconds
+     * @default 30
+     */
+    defaultTimeout?: number;
+    /**
+     * Global environment variables
+     */
+    globalEnvironment?: Record<string, string>;
+    /**
+     * VPC configuration
+     */
+    vpc?: VpcConfig;
+}
+/**
+ * LambdaBuilder - CDK construct for building Lambda functions from definitions.
+ *
+ * Creates Lambda functions with proper configuration, environment variables,
+ * IAM permissions, and CloudWatch log groups. Supports VPC deployment and
+ * X-Ray tracing.
+ *
+ * **Features**:
+ * - Automatic Lambda function creation from LambdaDefinition
+ * - Environment variable injection (LAMBDA_ID, SERVICE_NAME, STAGE)
+ * - CloudWatch log group with retention policy
+ * - X-Ray tracing support
+ * - VPC deployment support
+ * - AWS SDK v3 externalization for bundle size optimization
+ *
+ * **Requirements**: REQ-11, REQ-13
+ *
+ * @example
+ * ```typescript
+ * const builder = new LambdaBuilder(this, 'LambdaBuilder', {
+ *   stage: 'dev',
+ *   serviceName: 'my-app',
+ *   lambdaRole,
+ *   defaultMemorySize: 512,
+ *   defaultTimeout: 30
+ * });
+ *
+ * const lambdaFn = builder.buildLambda('payments.charge', 'payments', lambdaDef);
+ * ```
+ */
+export declare class LambdaBuilder extends Construct implements PurenowInfraResources {
+    private readonly props;
+    private readonly vpc?;
+    private readonly securityGroups?;
+    private readonly subnets?;
+    constructor(scope: Construct, id: string, props: LambdaBuilderProps);
+    /**
+     * Build a Lambda function from a LambdaDefinition.
+     *
+     * Creates a Lambda function with proper configuration, environment variables,
+     * and CloudWatch log group. The function is configured for Runtime Web Core
+     * with DI support.
+     *
+     * @param props
+     * @param lambdaId - Full Lambda ID (e.g., 'payments.charge')
+     * @param serviceName - Name of the parent microservice
+     * @param definition - Lambda definition with handler and configuration
+     * @returns Lambda Function instance
+     *
+     * @example
+     * ```typescript
+     * const lambdaFn = builder.buildLambda('payments.charge', 'payments', {
+     *   id: 'charge',
+     *   ties: [PaymentsService],
+     *   handler: (deps) => async (event) => { ... },
+     *   http: { method: 'POST', path: '/api/payments/charge' },
+     *   config: { memorySize: 1024, timeout: 60 }
+     * });
+     * ```
+     */
+    buildLambda(props: RuntimeWebStackProps, lambdaId: string, serviceName: string, definition: LambdaDefinition): lambda.Function;
+    /**
+     * Build environment variables for Lambda function.
+     *
+     * Combines global environment variables with Lambda-specific variables
+     * including LAMBDA_ID, SERVICE_NAME, and STAGE.
+     *
+     * @param lambdaId - Full Lambda ID
+     * @param serviceName - Name of the parent microservice
+     * @param definition - Lambda definition
+     * @returns Environment variables record
+     * @private
+     */
+    private buildEnvironment;
+    /**
+     * Get Lambda code asset.
+     *
+     * Returns the Lambda code asset for the function. For Runtime Web Core,
+     * this uses inline code that imports from the Lambda Layer.
+     *
+     * // @todp: here smth wrong I see
+     *
+     * @param definition - Lambda definition
+     * @returns Lambda Code asset
+     * @private
+     */
+    private getLambdaCode;
+    /**
+     * Add IAM permissions to Lambda function.
+     *
+     * Adds additional IAM permissions to the Lambda function's execution role.
+     *
+     * @param lambdaFunction - Lambda function to add permissions to
+     * @param permissions - Array of IAM policy statements
+     */
+    addPermissions(lambdaFunction: lambda.Function, permissions: iam.PolicyStatement[]): void;
+    /**
+     * Generates a signature for the provided region by extracting the first character of each segment in the region string, delimited by hyphens.
+     *
+     * @param {string} region - The region string to generate the signature from. It is expected to be a hyphen-separated string.
+     * @return {string} The generated region signature, formed by concatenating the first character of each valid segment. Returns an empty string if the input is invalid or empty.
+     */
+    private getRegionSignature;
+    /**
+     * Generates a resource name by concatenating service name, resource name,
+     * simplified region, and stage with hyphens as separators.
+     *
+     * @param {Object} params - An object containing the required parameters.
+     * @param {string} params.name - The name of the resource.
+     * @param {string} params.serviceName - The name of the service associated with the resource.
+     * @param {string} params.regionSimplified - The simplified region identifier.
+     * @param {string} params.stage - The deployment stage of the resource.
+     * @returns {string} The concatenated resource name.
+     */
+    resourceName({ name, serviceName, stage, region }: PurenowInfraResourceOptions): string;
+}
+//# sourceMappingURL=lambda-builder.d.ts.map

package/out/dist/src/infra/runtime-web/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Runtime Web Core - Infrastructure (CDK)
+ *
+ * **ARCHITECTURE NOTE**: This module contains CDK-only code that:
+ * - Runs ONLY during `cdk synth` and `cdk deploy`
+ * - Imports from `@infra/*` (CDK constructs, stacks)
+ * - Uses `aws-cdk-lib` (build-time dependency)
+ * - NEVER runs in Lambda or browser
+ * - NEVER bundled into Lambda or browser builds
+ *
+ * **Exports**:
+ * - CDKPipeline: Synthesizes CloudFormation templates from microservice definitions
+ * - RuntimeWebStack: CDK stack for Lambda functions and API Gateway
+ * - LambdaBuilder: Construct for creating Lambda functions
+ * - ApiGatewayBuilder: Construct for creating API Gateway
+ */
+export * from './constructs';
+export * from './pipelines';
+export * from './stacks';
+export * from './validation';
+//# sourceMappingURL=index.d.ts.map

package/out/dist/src/infra/runtime-web/pipelines/cdk-pipeline.d.ts

@@ -0,0 +1,112 @@
+import type { CDKMetadata, RuntimeWebConfig } from '../../../lib/runtime-web/types';
+/**
+ * CDK execution pipeline for Runtime Target Core.
+ *
+ * **ARCHITECTURE NOTE**: This file is in `src/infra/` because it:
+ * - Imports from `@infra/*` (CDK constructs, stacks)
+ * - Uses `aws-cdk-lib` (build-time only)
+ * - Synthesizes CloudFormation templates (local execution only)
+ * - NEVER runs in Lambda or browser
+ *
+ * Handles CloudFormation template synthesis from microservice definitions.
+ * Creates CDK App, infrastructure stack (S3, CloudFront, DynamoDB), and
+ * runtime stack (Lambda functions, API Gateway) based on the configuration.
+ *
+ * **Execution Flow**:
+ * 1. Create CDK App instance
+ * 2. Create PurenowInfraStack for S3/CloudFront/DynamoDB
+ * 3. Create RuntimeWebStack for Lambda/API Gateway
+ * 4. Call app.synth() to synthesize CloudFormation
+ *
+ * **Requirements**: REQ-06, REQ-11
+ */
+export declare class CDKPipeline {
+    private readonly logger;
+    /**
+     * Execute CDK pipeline for infrastructure synthesis.
+     *
+     * Creates CDK App and stacks based on the configuration, then synthesizes
+     * CloudFormation templates. The infrastructure configuration is required
+     * for CDK context execution.
+     *
+     * @param config - Purenow configuration with infrastructure options
+     * @param context - CDK environment context with metadata
+     *
+     * @example
+     * ```typescript
+     * const pipeline = new CDKPipeline();
+     * await pipeline.execute(config, {
+     *   type: 'cdk',
+     *   metadata: {
+     *     account: '123456789012',
+     *     region: 'us-east-1',
+     *     cdkVersion: '2.100.0',
+     *     nodeVersion: '18.17.0'
+     *   }
+     * });
+     * ```
+     */
+    execute(config: RuntimeWebConfig, context: {
+        type: 'cdk';
+        metadata: CDKMetadata;
+    }): Promise<void>;
+    /**
+     * Create CDK App instance.
+     *
+     * Creates the root CDK App that will contain all stacks.
+     *
+     * @returns CDK App instance
+     * @private
+     */
+    private createCDKApp;
+    /**
+     * Create infrastructure stack for S3, CloudFront, and DynamoDB.
+     *
+     * Creates the PurenowInfraStack with all the foundational AWS resources
+     * needed for the application (storage, CDN, database).
+     *
+     * @param app - CDK App instance
+     * @param config - Purenow configuration
+     * @param infraOptions - Infrastructure configuration
+     * @returns PurenowInfraStack instance
+     * @private
+     */
+    private createInfraStack;
+    /**
+     * Create runtime stack for Lambda functions and API Gateway.
+     *
+     * Creates the RuntimeWebStack with all the Lambda functions and API Gateway
+     * based on the microservice definitions. This stack depends on the
+     * infrastructure stack for shared resources.
+     *
+     * @param app - CDK App instance
+     * @param config - Purenow configuration
+     * @param infraOptions - Infrastructure configuration
+     * @param infraStack - Infrastructure stack instance
+     * @returns RuntimeWebStack instance or undefined if no microservices
+     * @private
+     */
+    private createRuntimeStack;
+    /**
+     * Synthesize CDK App to CloudFormation templates.
+     *
+     * Calls app.synth() to generate CloudFormation templates from the
+     * defined stacks. This is the final step that produces the deployable
+     * infrastructure code.
+     *
+     * @param app - CDK App instance with stacks
+     * @private
+     */
+    private synthesizeApp;
+    /**
+     * Get RuntimeWebStack class.
+     *
+     * Returns the RuntimeWebStack class for creating runtime stacks
+     * with microservice support.
+     *
+     * @returns RuntimeWebStack class constructor
+     * @private
+     */
+    private getRuntimeWebStackClass;
+}
+//# sourceMappingURL=cdk-pipeline.d.ts.map

package/out/dist/src/infra/runtime-web/pipelines/index.d.ts

@@ -0,0 +1,2 @@
+export { CDKPipeline } from './cdk-pipeline';
+//# sourceMappingURL=index.d.ts.map

package/out/dist/src/infra/runtime-web/stacks/index.d.ts

@@ -0,0 +1,2 @@
+export { RuntimeWebStack, RuntimeWebStackProps } from './runtime-web-stack';
+//# sourceMappingURL=index.d.ts.map