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

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

@@ -0,0 +1,182 @@
+import * as cdk from 'aws-cdk-lib';
+import { Construct } from 'constructs';
+import * as lambda from 'aws-cdk-lib/aws-lambda';
+import * as apigatewayv2 from 'aws-cdk-lib/aws-apigatewayv2';
+import type { MicroserviceDefinition, VpcConfig } from '../../../lib/runtime-web/types';
+import { MicroserviceRegistrar } from '../../../core/runtime-web/registrar';
+import type { PurenowInfraStack } from '@worktif/purenow/infra';
+/**
+ * Properties for RuntimeWebStack
+ */
+export interface RuntimeWebStackProps extends cdk.StackProps {
+    /**
+     * Deployment stage (dev, staging, prod)
+     */
+    stage: 'dev' | 'staging' | 'prod';
+    /**
+     * Service name for resource naming
+     */
+    serviceName: string;
+    /**
+     * Reference to Infra stack for cross-stack references
+     */
+    infraStack: PurenowInfraStack;
+    /**
+     * Microservice registry with service definitions
+     */
+    register: Record<string, MicroserviceDefinition>;
+    /**
+     * API exposure mode
+     * @default 'apiGateway'
+     */
+    apiMode?: 'apiGateway' | 'lambdaUrl';
+    /**
+     * Default Lambda memory size in MB
+     * @default 512
+     */
+    lambdaMemorySize?: number;
+    /**
+     * Default Lambda timeout in seconds
+     * @default 30
+     */
+    lambdaTimeout?: number;
+    /**
+     * Enable Lambda warmup
+     * @default false
+     */
+    enableWarmup?: boolean;
+    /**
+     * VPC configuration for Lambda functions
+     */
+    vpc?: VpcConfig;
+    /**
+     * Global environment variables for all Lambda functions
+     */
+    environment?: Record<string, string>;
+    /**
+     * Path to React application entry point for SSR Lambda
+     */
+    reactEntry?: string;
+}
+/**
+ * RuntimeWebStack - CDK stack for Runtime Web Core microservices.
+ *
+ * Creates Lambda functions and API Gateway from microservice definitions.
+ * Extends the existing Purenow infrastructure with microservice support.
+ *
+ * **Features**:
+ * - Automatic Lambda function creation from LambdaDefinition
+ * - API Gateway with HTTP routes for Lambda endpoints
+ * - Environment variable injection (LAMBDA_ID, SERVICE_NAME, STAGE)
+ * - VPC support for private resources
+ * - Lambda warmup for reduced cold starts
+ *
+ * **Requirements**: REQ-11, REQ-13, REQ-14
+ *
+ * @example
+ * ```typescript
+ * const runtimeStack = new RuntimeWebStack(app, 'my-app-runtime-dev', {
+ *   stage: 'dev',
+ *   serviceName: 'my-app',
+ *   infraStack,
+ *   register: {
+ *     payments: {
+ *       ties: [PaymentsTies],
+ *       lambdas: [chargeHandler, refundHandler]
+ *     }
+ *   },
+ *   apiMode: 'apiGateway',
+ *   lambdaMemorySize: 512,
+ *   lambdaTimeout: 30
+ * });
+ * ```
+ */
+export declare class RuntimeWebStack extends cdk.Stack {
+    /**
+     * Map of Lambda functions by Lambda ID
+     */
+    readonly lambdaFunctions: Map<string, lambda.Function>;
+    /**
+     * API Gateway HttpApi (if apiMode is 'apiGateway')
+     */
+    readonly apiGateway?: apigatewayv2.HttpApi;
+    /**
+     * API Gateway stage
+     */
+    readonly apiGatewayStage?: apigatewayv2.HttpStage;
+    /**
+     * Microservice registrar for DI container management
+     */
+    private readonly registrar;
+    /**
+     * Lambda builder construct
+     */
+    private readonly lambdaBuilder;
+    /**
+     * API Gateway builder construct
+     */
+    private readonly apiGatewayBuilder;
+    /**
+     * IAM role for Lambda execution
+     */
+    private readonly lambdaRole;
+    constructor(scope: Construct, id: string, props: RuntimeWebStackProps);
+    /**
+     * Register microservices and build DI containers.
+     *
+     * Processes each microservice definition to create PureContainer instances
+     * and establish Lambda-to-service mappings.
+     *
+     * @param register - Microservice registry
+     * @private
+     */
+    private registerMicroservices;
+    /**
+     * Create Lambda functions for all registered microservices.
+     *
+     * Iterates through all microservice definitions and creates Lambda
+     * functions for each LambdaDefinition with proper environment variables.
+     *
+     * @param props - Stack properties
+     * @private
+     */
+    private createLambdaFunctions;
+    /**
+     * Build global environment variables for Lambda functions.
+     *
+     * Creates environment variables that are shared across all Lambda functions
+     * including infrastructure references from the Infra stack.
+     *
+     * @param props - Stack properties
+     * @returns Environment variables record
+     * @private
+     */
+    private buildGlobalEnvironment;
+    /**
+     * Create CloudFormation outputs for stack resources.
+     *
+     * @param props - Stack properties
+     * @private
+     */
+    private createOutputs;
+    /**
+     * Get Lambda function by ID.
+     *
+     * @param lambdaId - Full Lambda ID (e.g., 'payments.charge')
+     * @returns Lambda function or undefined
+     */
+    getLambdaFunction(lambdaId: string): lambda.Function | undefined;
+    /**
+     * Get all Lambda IDs.
+     *
+     * @returns Array of Lambda IDs
+     */
+    getLambdaIds(): string[];
+    /**
+     * Get the microservice registrar.
+     *
+     * @returns MicroserviceRegistrar instance
+     */
+    getRegistrar(): MicroserviceRegistrar;
+}
+//# sourceMappingURL=runtime-web-stack.d.ts.map

package/out/dist/src/infra/runtime-web/validation/config-validator.d.ts

@@ -0,0 +1,127 @@
+import type { InfraOptions, RuntimeWebConfig } from '../../../lib/runtime-web/types';
+/**
+ * Validation result containing success status and any errors.
+ */
+export interface ConfigValidationResult {
+    /** Whether the configuration is valid */
+    valid: boolean;
+    /** Array of validation error messages */
+    errors: string[];
+}
+/**
+ * Error thrown when configuration validation fails.
+ */
+export declare class ConfigValidationError extends Error {
+    /** Array of validation error messages */
+    readonly errors: string[];
+    constructor(errors: string[]);
+}
+/**
+ * Configuration validator for Runtime Target Core.
+ *
+ * Validates PurenowConfig objects to ensure they meet all requirements
+ * before execution. Provides detailed error messages with actionable guidance.
+ *
+ * **Validation Rules**:
+ * - serviceName: Must start with letter, alphanumeric and hyphens only, max 128 chars
+ * - stage: Must be 'dev', 'staging', or 'prod'
+ * - infra: Required in CDK context, optional in browser/Lambda
+ * - register: Must have at least one microservice if provided
+ *
+ * @example
+ * ```typescript
+ * const validator = new ConfigValidator();
+ * const result = validator.validate(config);
+ *
+ * if (!result.valid) {
+ *   console.error('Configuration errors:', result.errors);
+ * }
+ * ```
+ */
+export declare class ConfigValidator {
+    /** Regex pattern for valid service names */
+    private static readonly SERVICE_NAME_PATTERN;
+    /** Valid stage values */
+    private static readonly VALID_STAGES;
+    /** AWS account ID pattern (12 digits) */
+    private static readonly AWS_ACCOUNT_PATTERN;
+    /**
+     * Validate a PurenowConfig object.
+     *
+     * Performs comprehensive validation of all configuration properties
+     * and returns a result with any validation errors.
+     *
+     * @param config - Configuration to validate
+     * @param isCDKContext - Whether running in CDK context (requires infra)
+     * @returns Validation result with errors array
+     */
+    validate(config: RuntimeWebConfig, isCDKContext?: boolean): ConfigValidationResult;
+    /**
+     * Validate configuration and throw if invalid.
+     *
+     * @param config - Configuration to validate
+     * @param isCDKContext - Whether running in CDK context
+     * @throws ConfigValidationError if validation fails
+     */
+    validateOrThrow(config: RuntimeWebConfig, isCDKContext?: boolean): void;
+    /**
+     * Validate service name format.
+     *
+     * Service name must:
+     * - Start with a letter (a-z, A-Z)
+     * - Contain only alphanumeric characters and hyphens
+     * - Be between 1 and 128 characters
+     *
+     * @param serviceName - Service name to validate
+     * @returns Array of error messages (empty if valid)
+     */
+    validateServiceName(serviceName: unknown): string[];
+    /**
+     * Validate deployment stage.
+     *
+     * Stage must be one of: 'dev', 'staging', 'prod'
+     *
+     * @param stage - Stage to validate
+     * @returns Array of error messages (empty if valid)
+     */
+    validateStage(stage: unknown): string[];
+    /**
+     * Validate app factory function.
+     *
+     * App must be a function that accepts router dependency and returns React element.
+     *
+     * @param app - App factory function to validate
+     * @returns Array of error messages (empty if valid)
+     */
+    validateApp(app: unknown): string[];
+    /**
+     * Validate router instance.
+     *
+     * Router must be a PurenowRouter instance with getRoutes method.
+     *
+     * @param router - Router to validate
+     * @returns Array of error messages (empty if valid)
+     */
+    validateRouter(router: unknown): string[];
+    /**
+     * Validate microservice register.
+     *
+     * Register must be an object with microservice definitions.
+     * Each microservice must have ties and lambdas arrays.
+     *
+     * @param register - Microservice register to validate
+     * @returns Array of error messages (empty if valid)
+     */
+    validateRegister(register: unknown): string[];
+    /**
+     * Validate infrastructure configuration.
+     *
+     * Infra is required in CDK context and must have valid env and stage.
+     *
+     * @param infra - Infrastructure options to validate
+     * @param isCDKContext - Whether running in CDK context
+     * @returns Array of error messages (empty if valid)
+     */
+    validateInfra(infra: InfraOptions | undefined, isCDKContext: boolean): string[];
+}
+//# sourceMappingURL=config-validator.d.ts.map

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

@@ -0,0 +1,2 @@
+export { ConfigValidator, ConfigValidationError, type ConfigValidationResult, } from './config-validator';
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -1,17 +1,12 @@
 /**
  * Runtime Web Core - Library (Isomorphic/Browser)
  *
- * **ARCHITECTURE NOTE**: This module contains browser-safe code that:
- * - Runs in browser environment (client-side)
- * - Uses browser APIs (window, document, hydrateRoot)
- * - Must be isomorphic-safe (no Node.js APIs)
- * - NEVER runs in Lambda
- * - Bundled into browser builds
- *
- * **Exports**:
+ * Exports:
  * - BrowserPipeline: Client-side React hydration and routing
  */
 export * from './pipelines';
 export * from './types';
 export * from './pureweb';
+export type { RuntimeConfig, } from './runtime.config.types';
+export { mergeRuntimeConfig, isRuntimeConfig, extractRuntimeConfig, createRuntimeConfig, } from './runtime.config.types';
 //# sourceMappingURL=index.d.ts.map

package/out/dist/src/lib/runtime-web/pureweb.d.ts

@@ -1,4 +1,4 @@
-import type { RuntimeWebConfig } from './types';
+import { RuntimeWebConfig } from '../runtime-web/types';
 /**
  * Error thrown when configuration validation fails.
  * Follows purenow error patterns without emoji.

package/out/dist/src/lib/runtime-web/runtime.config.types.d.ts

@@ -0,0 +1,71 @@
+import type { PurenowConfig } from '@worktif/purenow';
+/**
+ * Runtime-specific configuration that extends PurenowConfig.
+ *
+ * This interface adds runtime workspace functionality while preserving
+ * all existing purenow configuration options. The runtime configuration
+ * is merged with purenow configuration rather than replacing it.
+ */
+export interface RuntimeConfig extends PurenowConfig {
+    /**
+     * Runtime-specific configuration options.
+     * These settings extend purenow functionality without replacing it.
+     */
+    runtime?: {
+        /** Enable Runtime Core stack deployment (extends purenow's two-stack architecture) */
+        enableThirdStack?: boolean;
+        /** Runtime web mode configuration */
+        runtimeWebMode?: 'development' | 'production';
+        /** Additional runtime features to enable */
+        additionalFeatures?: string[];
+        /** Development server enhancements */
+        devServerEnhancements?: {
+            /** Enable hot module replacement */
+            hotReload?: boolean;
+            /** Enable debug mode with additional logging */
+            debugMode?: boolean;
+            /** Enable performance monitoring */
+            performanceMonitoring?: boolean;
+        };
+        /** Build optimizations */
+        buildOptimizations?: {
+            /** Enable bundle analysis */
+            bundleAnalysis?: boolean;
+            /** Enable tree shaking */
+            treeshaking?: boolean;
+            /** Enable code minification */
+            codeMinification?: boolean;
+        };
+    };
+}
+/**
+ * Configuration merging utility that preserves all purenow settings
+ * while adding runtime-specific extensions.
+ *
+ * @param purenowConfig - Base purenow configuration
+ * @param runtimeConfig - Runtime-specific configuration to merge
+ * @returns Merged configuration with all purenow settings preserved
+ */
+export declare function mergeRuntimeConfig(purenowConfig: PurenowConfig, runtimeConfig?: Partial<RuntimeConfig['runtime']>): RuntimeConfig;
+/**
+ * Type guard to check if a configuration is a RuntimeConfig.
+ *
+ * @param config - Configuration to check
+ * @returns True if the configuration has runtime-specific properties
+ */
+export declare function isRuntimeConfig(config: any): config is RuntimeConfig;
+/**
+ * Extract runtime-specific configuration from a RuntimeConfig.
+ *
+ * @param config - RuntimeConfig to extract from
+ * @returns Runtime-specific configuration or undefined
+ */
+export declare function extractRuntimeConfig(config: RuntimeConfig): RuntimeConfig['runtime'];
+/**
+ * Create a RuntimeConfig from a base PurenowConfig with default runtime settings.
+ *
+ * @param purenowConfig - Base purenow configuration
+ * @returns RuntimeConfig with default runtime settings
+ */
+export declare function createRuntimeConfig(purenowConfig: PurenowConfig): RuntimeConfig;
+//# sourceMappingURL=runtime.config.types.d.ts.map

package/package.json

@@ -1,19 +1,27 @@
 {
   "name": "@worktif/runtime",
-  "version": "0.3.0-edge.0",
+  "version": "0.3.0-edge.10",
   "description": "Serverless web framework running on AWS Lambda with support for server-side rendering, caching, and CI/CD.",
   "repository": "git@bitbucket.org:worktif/runtime-target.git",
   "author": "Raman Marozau <raman@worktif.com>",
   "license": "Elastic-2.0",
+  "readme": "README.md",
   "main": "out/dist/lib/index.js",
   "types": "out/dist/lib/index.d.ts",
   "files": [
     "out/dist/lib/**/*",
-    "out/dist/src/lib/runtime-web/**/*.d.ts",
+    "out/dist/src/lib/**/*.d.ts",
+    "out/dist/infra/**/*.js",
+    "out/dist/src/infra/**/*.d.ts",
+    "out/dist/lambda/**/*",
+    "out/dist/src/core/**/*",
+    "out/dist/src/utils/**/*",
+    "out/dist/src/types/**/*",
     "out/dist/src/bin/**/*.d.ts",
     "out/dist/bin/purenow.js",
     "out/dist/bin/index.js",
     "out/dist/bin/templates/**/*",
+    "lambda-layer/package.json",
     "package.json",
     "README.md"
   ],
@@ -22,29 +30,54 @@
       "types": "./out/dist/lib/index.d.ts",
       "default": "./out/dist/lib/index.js"
     },
-    "./runtime-web": {
-      "types": "./out/dist/src/lib/runtime-web/index.d.ts",
-      "default": "./out/dist/lib/runtime-web/index.js"
+    "./infra": {
+      "types": "./out/dist/src/infra/index.d.ts",
+      "default": "./out/dist/infra/index.js"
     },
-    "./cli": {
-      "types": "./out/dist/src/bin/index.d.ts",
-      "default": "./out/dist/bin/purenow.js"
+    "./lambda": {
+      "types": "./out/dist/src/core/index.d.ts",
+      "default": "./out/dist/lambda/bundle.js"
     },
     "./bin": {
       "types": "./out/dist/src/bin/index.d.ts",
       "default": "./out/dist/bin/index.js"
     },
+    "./cli": {
+      "types": "./out/dist/src/bin/index.d.ts",
+      "default": "./out/dist/bin/purenow.js"
+    },
+    "./core": {
+      "types": "./out/dist/src/core/index.d.ts",
+      "default": "./out/dist/src/core/index.js"
+    },
+    "./utils": {
+      "types": "./out/dist/src/utils/index.d.ts",
+      "default": "./out/dist/src/utils/index.js"
+    },
+    "./types": {
+      "types": "./out/dist/src/types/index.d.ts",
+      "default": "./out/dist/src/types/index.js"
+    },
+    "./runtime-web": {
+      "types": "./out/dist/src/lib/runtime-web/index.d.ts",
+      "default": "./out/dist/lib/runtime-web/index.js"
+    },
     "./package.json": "./package.json"
   },
   "bin": {
-    "purenow": "./out/dist/bin/purenow.js"
+    "runtime": "./out/dist/bin/purenow.js"
   },
   "scripts": {
-    "build": "rm -rf ./.docs && yarn run docs && rm -rf ./dist && rm -rf ./out && yarn run cli:build && yarn run cli:build:cli && yarn run cli:build:bin && node bin/deploy/copy-templates.js && yarn run types && node bin/deploy/generate-lib-types.js && node bin/deploy/validate-bundle-sizes.js",
+    "build": "rm -rf ./.docs && yarn run docs && rm -rf ./dist && rm -rf ./out && yarn run cli:build && yarn run cli:build:infra && yarn run cli:build:cli && yarn run cli:build:bin && node bin/deploy/copy-templates.js && yarn run types && node bin/deploy/generate-lib-types.js && node bin/deploy/validate-bundle-sizes.js",
     "clean": "rm -rf ./dist && rm -rf ./out && rm -rf ./.docs",
+    "build:lambda": "yarn run build:config && node dist/cli/build.js --target=lambda && node bin/deploy/validate-bundle-sizes.js",
     "generate:html-template": "node bin/deploy/generate-html-template.js",
+    "build:react": "yarn run build:config && node dist/cli/build.js --target=react && node bin/deploy/validate-bundle-sizes.js",
+    "build:react:verify": "yarn run build:react && node scripts/verify-browser-bundle.js",
+    "build:cdk": "yarn run build:config && node dist/cli/build.js --target=cdk",
     "build:config": "esbuild --bundle --platform=node bin/deploy/cloud.build/esbuild.build.ts --outfile=dist/cli/build.js --external:esbuild",
     "cli:build": "yarn run build:config && node dist/cli/build.js",
+    "cli:build:infra": "yarn run build:config && node dist/cli/build.js --target=infra",
     "cli:build:cli": "yarn run build:config && node dist/cli/build.js --target=cli",
     "cli:build:bin": "yarn run build:config && node dist/cli/build.js --target=bin",
     "types": "tsc --emitDeclarationOnly && tsc-alias",
@@ -68,7 +101,7 @@
     "migrate:seo:dry-run": "ts-node scripts/migrate-seo-metadata.ts --dry-run"
   },
   "dependencies": {
-    "@worktif/purenow": "^0.3.0-rc.18",
+    "@worktif/purenow": "^0.3.0-rc.24",
     "@worktif/utils": "^0.2.32"
   },
   "devDependencies": {

package/out/dist/lib/utils/index.d.ts

@@ -1,2 +0,0 @@
-export * from './types';
-//# sourceMappingURL=index.d.ts.map

package/out/dist/lib/utils/types/index.d.ts

@@ -1,3 +0,0 @@
-export type { RuntimeConfig, } from './runtime.config.types';
-export { mergeRuntimeConfig, isRuntimeConfig, extractRuntimeConfig, createRuntimeConfig, } from './runtime.config.types';
-//# sourceMappingURL=index.d.ts.map