@fjall/generator 0.88.4

package/dist/src/validation/patterns.js

@@ -0,0 +1,360 @@
+export const VALIDATION_PATTERNS = Object.freeze({
+    // User-facing identifiers: app names, org names, service names, cluster names
+    IDENTIFIER: /^[a-zA-Z][a-zA-Z0-9-]*$/,
+    // CDK construct names: database, storage, network resource labels
+    RESOURCE_NAME: /^[a-zA-Z][a-zA-Z0-9]*$/,
+    // ECS service names: allow hyphens for kebab-case service identifiers
+    ECS_SERVICE_NAME: /^[a-zA-Z][a-zA-Z0-9-]*$/,
+    // AWS-native patterns
+    BUCKET_NAME: /^[a-z][a-z0-9-]*[a-z0-9]$|^[a-z][a-z0-9]*$/,
+    DATABASE_NAME: /^[a-zA-Z][a-zA-Z0-9_]*$/,
+    // Resource type patterns
+    RESOURCE_TYPE: /^[a-z]+(:[a-z]+)?$/,
+    // Path patterns
+    SSM_PATH: /^\/[a-zA-Z][a-zA-Z0-9-]*(\/[a-zA-Z][a-zA-Z0-9-]*)*$/,
+    // Secrets patterns (matches SSM Parameter Store allowed characters)
+    SECRET_NAME: /^[a-zA-Z_][a-zA-Z0-9._-]*$/,
+    // SSM namespace component pattern (more permissive for CDK-generated names)
+    SSM_COMPONENT: /^[a-zA-Z][a-zA-Z0-9._-]*$/,
+    // Email pattern (basic validation)
+    EMAIL: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
+    // Docker image pattern
+    DOCKER_IMAGE: /^[a-z0-9][a-z0-9._-]*[a-z0-9](:[a-z0-9._-]+)?$/,
+    // Domain pattern (e.g., cms.example.com)
+    DOMAIN: /^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$/i,
+});
+export const VALIDATION_MESSAGES = Object.freeze({
+    // User-facing identifier (app, org, service, cluster names)
+    IDENTIFIER: "Must start with a letter, contain only letters, numbers, and hyphens",
+    IDENTIFIER_MIN_LENGTH: "Must be at least 2 characters",
+    IDENTIFIER_NO_TRAILING_HYPHEN: "Must not end with a hyphen",
+    IDENTIFIER_NO_CONSECUTIVE_HYPHENS: "Must not contain consecutive hyphens",
+    // CDK construct names
+    RESOURCE_NAME: "Must start with a letter and contain only letters and numbers (PascalCase recommended)",
+    // ECS service names
+    ECS_SERVICE_NAME: "Service name must start with a letter and contain only letters, numbers, and hyphens",
+    // AWS-native
+    BUCKET_NAME: "Bucket name must start with a lowercase letter and contain only lowercase letters, numbers, and hyphens",
+    DATABASE_NAME: "Database name must start with a letter and contain only letters, numbers, and underscores",
+    // Resource type messages
+    RESOURCE_TYPE: "Resource type must be in format 'category' or 'category:type'",
+    // Path messages
+    SSM_PATH: "SSM path must start with / and contain valid namespace segments (e.g., /myapp/ApiCluster/service)",
+    // Secrets messages
+    SECRET_NAME: "Secret name must start with a letter or underscore and contain only letters, numbers, underscores, hyphens, or periods",
+    // SSM component messages
+    SSM_COMPONENT: "Must start with a letter and contain only letters, numbers, periods, hyphens, or underscores",
+    // Email messages
+    EMAIL: "Please enter a valid email address",
+    // Domain messages
+    DOMAIN: "Please enter a valid domain (e.g., cms.example.com)",
+    // Docker messages
+    DOCKER_IMAGE: "Invalid Docker image name format",
+    // Required field messages
+    REQUIRED: {
+        APP_NAME: "Application name is required",
+        RESOURCE_NAME: "Resource name is required",
+        BUCKET_NAME: "Bucket name is required",
+        SERVICE_NAME: "Service name is required",
+        NETWORK_NAME: "Network name is required",
+        DATABASE_NAME: "Database name is required",
+        ORGANISATION_NAME: "Organisation name is required",
+        EMAIL: "Email is required",
+        NAME: "Name is required",
+        USERNAME: "Username is required",
+        CONTAINER_NAME: "Container name is required",
+        FIRST_NAME: "First name is required",
+        LAST_NAME: "Last name is required",
+        GROUP: "Group is required",
+        PATTERN_NAME: "Pattern name is required",
+        ROUTING_PATH: "Routing path is required",
+        RESOURCE_TYPE: "Resource type is required",
+        VARIANT: "Variant is required",
+        SUBTYPE: "Subtype is required",
+        DEPLOY_TARGET: "Deploy target is required",
+        DESTROY_TARGET: "Destroy target is required",
+    },
+    // Length constraint messages
+    MAX_LENGTH: {
+        APP_NAME: "Application name must be 50 characters or less",
+        RESOURCE_NAME: "Resource name must be 63 characters or less",
+        BUCKET_NAME: "Bucket name must be 63 characters or less",
+        SERVICE_NAME: "Service name must be 255 characters or less",
+        NETWORK_NAME: "Network name must be 50 characters or less",
+        DATABASE_NAME: "Database name must be 63 characters or less",
+        ORGANISATION_NAME: "Organisation name must be 50 characters or less",
+    },
+    // Port validation messages
+    PORT: {
+        INTEGER: "Port must be an integer",
+        MIN: "Port must be at least 1",
+        MAX: "Port cannot exceed 65535",
+    },
+    // Username validation messages
+    USERNAME: {
+        MAX_LENGTH: "Username cannot exceed 63 characters",
+    },
+    // Lambda validation messages
+    LAMBDA: {
+        MEMORY: {
+            INTEGER: "Lambda memory must be an integer",
+            MIN: "Memory must be at least 128 MB",
+            MAX: "Memory cannot exceed 10240 MB",
+            MULTIPLE: "Memory must be 128 MB or a multiple of 64 MB",
+        },
+        TIMEOUT: {
+            INTEGER: "Timeout must be an integer",
+            MIN: "Timeout must be at least 1 second",
+            MAX: "Timeout cannot exceed 900 seconds",
+        },
+    },
+    // Priority validation messages (ALB routing rules)
+    PRIORITY: {
+        INTEGER: "Priority must be an integer",
+        MIN: "Priority must be at least 1",
+        MAX: "Priority cannot exceed 50000",
+    },
+    // Capacity validation messages (ECS scaling)
+    CAPACITY: {
+        MIN: {
+            INTEGER: "Minimum capacity must be an integer",
+            MIN_0: "Minimum capacity must be at least 0",
+            MIN_1: "Minimum capacity must be at least 1",
+            MAX: "Minimum capacity cannot exceed 100",
+        },
+        MAX: {
+            INTEGER: "Maximum capacity must be an integer",
+            MIN_0: "Maximum capacity must be at least 0",
+            MIN_1: "Maximum capacity must be at least 1",
+            MAX: "Maximum capacity cannot exceed 100",
+        },
+        DESIRED: {
+            INTEGER: "Desired count must be an integer",
+            MIN: "Desired count must be at least 0",
+            MAX: "Desired count cannot exceed 100",
+        },
+    },
+    // Memory limit validation messages (ECS)
+    MEMORY_LIMIT: {
+        INTEGER: "Memory limit must be an integer",
+        MIN_512: "Memory limit must be at least 512 MiB",
+        MIN_128: "Memory limit must be at least 128 MiB",
+        MAX: "Memory limit cannot exceed 30720 MiB",
+    },
+    // Database validation messages
+    DATABASE: {
+        PORT: {
+            INTEGER: "Database port must be an integer",
+            MIN: "Database port must be at least 1024",
+            MAX: "Database port cannot exceed 65535",
+        },
+        NAME: {
+            REQUIRED: "Database name is required",
+            MAX_LENGTH: "Database name cannot exceed 64 characters",
+        },
+    },
+    // Backup retention validation messages
+    BACKUP_RETENTION: {
+        INTEGER: "Backup retention must be an integer",
+        MIN: "Backup retention must be at least 1 day",
+        MAX: "Backup retention cannot exceed 35 days",
+    },
+    // SQS validation messages
+    SQS: {
+        VISIBILITY_TIMEOUT: {
+            INTEGER: "Visibility timeout must be an integer",
+            MIN: "Visibility timeout must be at least 0 seconds",
+            MAX: "Visibility timeout cannot exceed 43200 seconds (12 hours)",
+        },
+        RETENTION_PERIOD: {
+            INTEGER: "Retention period must be an integer",
+            MIN: "Retention period must be at least 60 seconds",
+            MAX: "Retention period cannot exceed 1209600 seconds (14 days)",
+        },
+    },
+    // Reader validation messages (Aurora)
+    READER: {
+        COUNT: {
+            INTEGER: "Reader count must be an integer",
+            MIN: "Reader count must be at least 0",
+            MAX: "Reader count cannot exceed 15",
+        },
+    },
+    // Identifier suffix validation messages
+    IDENTIFIER_SUFFIX: {
+        REQUIRED: "Identifier suffix is required when specified",
+        MAX_LENGTH: "Identifier suffix cannot exceed 50 characters",
+    },
+    // Rotation validation messages
+    ROTATION: {
+        INTEGER: "Rotation days must be an integer",
+        MIN: "Rotation interval must be at least 1 day",
+        MAX: "Rotation interval cannot exceed 365 days",
+    },
+    // Max connections validation messages
+    MAX_CONNECTIONS: {
+        INTEGER: "Max connections must be an integer",
+        MIN: "Max connections must be at least 1",
+        MAX: "Max connections cannot exceed 100",
+    },
+    // Monitoring interval validation messages
+    MONITORING_INTERVAL: {
+        INTEGER: "Monitoring interval must be an integer",
+        MIN: "Monitoring interval must be at least 0",
+        MAX: "Monitoring interval cannot exceed 60 seconds",
+        VALUES: "Monitoring interval must be 0, 1, 5, 10, 15, 30, or 60 seconds",
+    },
+    // Retention days validation messages (Performance Insights)
+    RETENTION_DAYS: {
+        INTEGER: "Retention days must be an integer",
+        MIN: "Retention days must be at least 1",
+        MAX: "Retention days cannot exceed 365",
+    },
+    // Batch size validation messages
+    BATCH_SIZE: {
+        INTEGER: "Batch size must be an integer",
+        MIN: "Batch size must be at least 1",
+        MAX: "Batch size cannot exceed 10000",
+    },
+    // Service validation messages
+    SERVICE: {
+        UNIQUE_WITHIN_CLUSTER: "Service names must be unique within a cluster",
+        MIN_REQUIRED: "At least one service is required",
+        ROUTING_REQUIRED: "Multiple services with ports require routing config (path or host)",
+    },
+    // RDS Proxy configuration messages
+    PROXY_CONFIG: {
+        MAX_IDLE_CONNECTIONS: {
+            INTEGER: "Max idle connections must be an integer",
+            MIN: "Max idle connections must be at least 0",
+            MAX: "Max idle connections cannot exceed 100",
+        },
+        BORROW_TIMEOUT: {
+            INTEGER: "Connection borrow timeout must be an integer",
+            MIN: "Connection borrow timeout must be at least 1 second",
+            MAX: "Connection borrow timeout cannot exceed 3600 seconds",
+        },
+    },
+    // Network availability zone messages
+    MAX_AZS: {
+        INTEGER: "Max AZs must be an integer",
+        MIN: "Max AZs must be at least 1",
+        MAX: "Max AZs cannot exceed 3",
+    },
+    // SQS batching window messages
+    BATCHING_WINDOW: {
+        INTEGER: "Max batching window must be an integer",
+        MIN: "Max batching window must be at least 0",
+        MAX: "Max batching window cannot exceed 300 seconds",
+    },
+    // Health check validation messages
+    HEALTH_CHECK: {
+        INTERVAL: {
+            INTEGER: "Health check interval must be an integer",
+            MIN: "Health check interval must be at least 5 seconds",
+            MAX: "Health check interval cannot exceed 300 seconds",
+        },
+        TIMEOUT: {
+            INTEGER: "Health check timeout must be an integer",
+            MIN: "Health check timeout must be at least 2 seconds",
+            MAX: "Health check timeout cannot exceed 60 seconds",
+        },
+        RETRIES: {
+            INTEGER: "Health check retries must be an integer",
+            MIN: "Health check retries must be at least 1",
+            MAX: "Health check retries cannot exceed 10",
+        },
+        START_PERIOD: {
+            INTEGER: "Health check start period must be an integer",
+            MIN: "Health check start period must be at least 0 seconds",
+            MAX: "Health check start period cannot exceed 300 seconds",
+        },
+    },
+    // Ephemeral storage messages
+    EPHEMERAL_STORAGE: {
+        INTEGER: "Ephemeral storage size must be an integer",
+        MIN: "Ephemeral storage size must be at least 512 MB",
+        MAX: "Ephemeral storage size cannot exceed 10240 MB",
+    },
+    // SQS max message size messages
+    MAX_MESSAGE_SIZE: {
+        INTEGER: "Max message size must be an integer",
+        MIN: "Max message size must be at least 1024 bytes",
+        MAX: "Max message size cannot exceed 262144 bytes (256 KB)",
+    },
+    // Capacity constraint messages
+    CAPACITY_CONSTRAINT: {
+        MIN_LTE_MAX: "minCapacity must be less than or equal to maxCapacity",
+    },
+    // Direct access constraint messages
+    DIRECT_ACCESS: {
+        NO_DOMAIN: "directAccess cannot be used with domain (no ALB for HTTPS)",
+        NO_LOAD_BALANCER: "directAccess cannot be used with loadBalancer (mutually exclusive)",
+    },
+    // Global Aurora messages
+    GLOBAL_AURORA: {
+        PRIMARY_REGION_REQUIRED: "primaryRegion is required for GlobalAurora databases",
+    },
+    // NAT gateway messages
+    NAT_GATEWAY: {
+        INTEGER: "NAT gateway count must be an integer",
+        MIN: "NAT gateway count must be at least 0",
+        MAX: "NAT gateway count cannot exceed 3",
+    },
+    // CIDR mask messages
+    CIDR_MASK: {
+        INTEGER: "CIDR mask must be an integer",
+        MIN: "CIDR mask must be at least 16",
+        MAX: "CIDR mask cannot exceed 28",
+    },
+    // CPU units messages
+    CPU: {
+        INTEGER: "CPU must be an integer",
+        MIN: "CPU must be at least 256 units",
+        MAX: "CPU cannot exceed 4096 units",
+    },
+    // KMS encryption messages
+    KMS: {
+        KEY_REQUIRED: "KMS key ARN is required when using KMS encryption",
+    },
+    // Website bucket messages
+    WEBSITE_BUCKET: {
+        DOCUMENTS_REQUIRED: "Website index and error documents are required for website buckets",
+    },
+    // Aurora reader instances messages
+    READER_INSTANCES: {
+        MAX: "Cannot have more than 15 reader instances",
+        COUNT_OR_INSTANCES: "Cannot specify both 'count' and 'instances' - use one or the other",
+    },
+    // Generator capacity messages (1-1000 range for ECS/EC2 generators)
+    GENERATOR_CAPACITY: {
+        MIN: {
+            MIN: "Minimum capacity must be at least 1",
+            MAX: "Minimum capacity cannot exceed 1000",
+        },
+        MAX: {
+            MIN: "Maximum capacity must be at least 1",
+            MAX: "Maximum capacity cannot exceed 1000",
+        },
+    },
+    // Instance type messages
+    INSTANCE_TYPE: "Unknown instance type. Common types include: t4g.micro, t4g.small, m5.large",
+    // Architecture mismatch messages
+    ARCHITECTURE_MISMATCH: "Architecture mismatch between instance type and AMI",
+    // Allocated storage messages (RDS Instance)
+    ALLOCATED_STORAGE: {
+        INTEGER: "Allocated storage must be an integer",
+        MIN: "Allocated storage must be at least 20 GB",
+        MAX: "Allocated storage cannot exceed 65536 GB",
+    },
+    // DLQ (dead-letter queue) messages
+    DLQ: {
+        MAX_RECEIVE_COUNT: {
+            INTEGER: "Max receive count must be an integer",
+            MIN: "Max receive count must be at least 1",
+            MAX: "Max receive count cannot exceed 1000",
+        },
+    },
+    // Region messages
+    REGION: "Invalid AWS region",
+});

package/dist/src/version.d.ts

@@ -0,0 +1 @@
+export declare const GENERATOR_VERSION = "0.88.3";

package/dist/src/version.js

@@ -0,0 +1 @@
+export const GENERATOR_VERSION = "0.88.3";

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@fjall/generator",
+  "version": "0.88.4",
+  "description": "Pure infrastructure generation logic for Fjall",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "clean": "rm -rf ./dist",
+    "build": "npm run clean && tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\""
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "ISC",
+  "dependencies": {
+    "typescript": "^5.8.2",
+    "zod": "^4.0.14"
+  },
+  "devDependencies": {
+    "vitest": "^3.2.3"
+  },
+  "gitHead": "bae02efe8e447ef008c7bc3eef3398ded4872f42"
+}