@fjall/generator 0.88.4

package/dist/src/schemas/constants.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Shared constants for Fjall CLI generators
+ * These defaults are designed to draw attention when not properly configured
+ */
+export declare const DEFAULTS: Readonly<{
+    RESOURCE_SUFFIXES: {
+        storage: string;
+        database: string;
+        cluster: string;
+        function: string;
+        instance: string;
+        compute: string;
+    };
+}>;
+export declare const DATABASE_TYPES: readonly ["Aurora", "Instance", "GlobalAurora"];
+export type DatabaseType = (typeof DATABASE_TYPES)[number];
+export declare const COMPUTE_TYPES: readonly ["ecs", "lambda", "ec2"];
+export type ComputeType = (typeof COMPUTE_TYPES)[number];
+export declare const COMPUTE_TYPE: Readonly<{
+    readonly ECS: "ecs";
+    readonly LAMBDA: "lambda";
+    readonly EC2: "ec2";
+}>;
+export declare const DEPLOYMENT_TYPES: readonly ["code", "container"];
+export type DeploymentType = (typeof DEPLOYMENT_TYPES)[number];
+export declare const DEPLOYMENT_TYPE: Readonly<{
+    readonly CODE: "code";
+    readonly CONTAINER: "container";
+}>;
+export declare const COMPUTE_ARCHITECTURES: readonly ["ARM_64", "X86_64"];
+export type ComputeArchitecture = (typeof COMPUTE_ARCHITECTURES)[number];
+export declare const DEFAULT_COMPUTE_ARCHITECTURE: ComputeArchitecture;
+export declare const ECS_CAPACITY_PROVIDERS: readonly ["FARGATE", "FARGATE_SPOT", "EC2"];
+export type EcsCapacityProvider = (typeof ECS_CAPACITY_PROVIDERS)[number];
+export declare const DEFAULT_CAPACITY_PROVIDER: EcsCapacityProvider;
+/**
+ * OpenNext deployment patterns.
+ * - payload: Payload CMS (always has database + migrations)
+ * - nextjs: Pure Next.js (optional database)
+ */
+export declare const PATTERN_TYPE_VALUES: readonly ["payload", "nextjs"];
+export type PatternType = (typeof PATTERN_TYPE_VALUES)[number];
+export declare const PATTERN_TYPES: ReadonlySet<string>;
+export { APP_TYPES, CUSTOM_TIER, type AppType, } from "../presets/tierPresets.js";
+export declare const EC2_INSTANCE_TYPES: readonly ["t3.nano", "t3.micro", "t3.small", "t3.medium", "t3.large", "t3.xlarge", "t3.2xlarge", "t3a.nano", "t3a.micro", "t3a.small", "t3a.medium", "t3a.large", "t3a.xlarge", "t3a.2xlarge", "t4g.nano", "t4g.micro", "t4g.small", "t4g.medium", "t4g.large", "t4g.xlarge", "t4g.2xlarge", "c5.large", "c5.xlarge", "c5.2xlarge", "c5.4xlarge", "c5.9xlarge", "c5.12xlarge", "c5.18xlarge", "c5.24xlarge", "c5a.large", "c5a.xlarge", "c5a.2xlarge", "c5a.4xlarge", "c5a.8xlarge", "c5a.12xlarge", "c5a.16xlarge", "c5a.24xlarge", "c6g.medium", "c6g.large", "c6g.xlarge", "c6g.2xlarge", "c6g.4xlarge", "c6g.8xlarge", "c6g.12xlarge", "c6g.16xlarge", "r5.large", "r5.xlarge", "r5.2xlarge", "r5.4xlarge", "r5.8xlarge", "r5.12xlarge", "r5.16xlarge", "r5.24xlarge", "r5a.large", "r5a.xlarge", "r5a.2xlarge", "r5a.4xlarge", "r5a.8xlarge", "r5a.12xlarge", "r5a.16xlarge", "r5a.24xlarge", "r6g.medium", "r6g.large", "r6g.xlarge", "r6g.2xlarge", "r6g.4xlarge", "r6g.8xlarge", "r6g.12xlarge", "r6g.16xlarge", "i3.large", "i3.xlarge", "i3.2xlarge", "i3.4xlarge", "i3.8xlarge", "i3.16xlarge", "p3.2xlarge", "p3.8xlarge", "p3.16xlarge", "g4dn.xlarge", "g4dn.2xlarge", "g4dn.4xlarge", "g4dn.8xlarge", "g4dn.12xlarge", "g4dn.16xlarge", "m5.large", "m5.xlarge", "m5.2xlarge", "m5.4xlarge", "m5.8xlarge", "m5.12xlarge", "m5.16xlarge", "m5.24xlarge", "m5a.large", "m5a.xlarge", "m5a.2xlarge", "m5a.4xlarge", "m5a.8xlarge", "m5a.12xlarge", "m5a.16xlarge", "m5a.24xlarge"];
+export type EC2InstanceType = (typeof EC2_INSTANCE_TYPES)[number];
+export declare const VALID_MONITORING_INTERVALS: readonly [0, 1, 5, 10, 15, 30, 60];
+/** Includes check for `as const` arrays (centralises the widening cast) */
+export declare function constIncludes<T extends ReadonlyArray<string | number>>(arr: T, value: string | number): boolean;
+export declare const MIN_PORT = 1;
+export declare const MAX_PORT = 65535;
+/**
+ * Default database port: 35255 (FJALL on phone keypad)
+ * Used when no explicit port is specified in tier presets or configuration.
+ */
+export declare const DEFAULT_DATABASE_PORT = 35255;
+export declare const MIN_LAMBDA_MEMORY = 128;
+export declare const MAX_LAMBDA_MEMORY = 10240;
+export declare const MIN_LAMBDA_TIMEOUT = 1;
+export declare const MAX_LAMBDA_TIMEOUT = 900;
+export declare const MIN_ECS_CAPACITY = 1;
+export declare const MAX_ECS_CAPACITY = 1000;
+export declare const DEFAULT_CONTAINER_PORT = 3000;
+export declare const DEFAULT_EC2_INSTANCE_TYPE: "t4g.micro";
+/** AWS Secrets Manager recommended rotation interval (days) */
+export declare const DEFAULT_SECRET_ROTATION_DAYS = 30;
+export declare const HTTP_METHODS: readonly ["GET", "POST", "PUT", "DELETE", "HEAD", "OPTIONS", "PATCH"];
+export type HttpMethod = (typeof HTTP_METHODS)[number];
+export declare const STORAGE_PRESET_TYPES: readonly ["standard", "assets", "upload", "website"];
+export type StoragePresetType = (typeof STORAGE_PRESET_TYPES)[number];
+export declare const S3_ENCRYPTION_TYPES: readonly ["AES256", "KMS"];
+export type S3EncryptionType = (typeof S3_ENCRYPTION_TYPES)[number];
+export declare const BACKUP_VAULT_TIERS: readonly ["standard", "resilient", "enterprise"];
+export type BackupVaultTier = (typeof BACKUP_VAULT_TIERS)[number];

package/dist/src/schemas/constants.js

@@ -0,0 +1,208 @@
+/**
+ * Shared constants for Fjall CLI generators
+ * These defaults are designed to draw attention when not properly configured
+ */
+export const DEFAULTS = Object.freeze({
+    // Resource naming conventions
+    RESOURCE_SUFFIXES: {
+        storage: "Storage",
+        database: "Database",
+        cluster: "Cluster",
+        function: "Function",
+        instance: "Instance",
+        compute: "Compute",
+    },
+});
+// Resource type constants for validation
+export const DATABASE_TYPES = ["Aurora", "Instance", "GlobalAurora"];
+export const COMPUTE_TYPES = ["ecs", "lambda", "ec2"];
+// Object form for cleaner comparisons: COMPUTE_TYPE.ECS, COMPUTE_TYPE.LAMBDA, etc.
+export const COMPUTE_TYPE = Object.freeze({
+    ECS: "ecs",
+    LAMBDA: "lambda",
+    EC2: "ec2",
+});
+// Deployment types for Lambda compute resources
+export const DEPLOYMENT_TYPES = ["code", "container"];
+export const DEPLOYMENT_TYPE = Object.freeze({
+    CODE: "code",
+    CONTAINER: "container",
+});
+export const COMPUTE_ARCHITECTURES = ["ARM_64", "X86_64"];
+export const DEFAULT_COMPUTE_ARCHITECTURE = "ARM_64";
+export const ECS_CAPACITY_PROVIDERS = [
+    "FARGATE",
+    "FARGATE_SPOT",
+    "EC2",
+];
+export const DEFAULT_CAPACITY_PROVIDER = "FARGATE";
+/**
+ * OpenNext deployment patterns.
+ * - payload: Payload CMS (always has database + migrations)
+ * - nextjs: Pure Next.js (optional database)
+ */
+export const PATTERN_TYPE_VALUES = ["payload", "nextjs"];
+export const PATTERN_TYPES = new Set(PATTERN_TYPE_VALUES);
+export { APP_TYPES, CUSTOM_TIER, } from "../presets/tierPresets.js";
+// Common EC2 instance types (not exhaustive, but covers common cases)
+export const EC2_INSTANCE_TYPES = [
+    // General purpose
+    "t3.nano",
+    "t3.micro",
+    "t3.small",
+    "t3.medium",
+    "t3.large",
+    "t3.xlarge",
+    "t3.2xlarge",
+    "t3a.nano",
+    "t3a.micro",
+    "t3a.small",
+    "t3a.medium",
+    "t3a.large",
+    "t3a.xlarge",
+    "t3a.2xlarge",
+    "t4g.nano",
+    "t4g.micro",
+    "t4g.small",
+    "t4g.medium",
+    "t4g.large",
+    "t4g.xlarge",
+    "t4g.2xlarge",
+    // Compute optimised
+    "c5.large",
+    "c5.xlarge",
+    "c5.2xlarge",
+    "c5.4xlarge",
+    "c5.9xlarge",
+    "c5.12xlarge",
+    "c5.18xlarge",
+    "c5.24xlarge",
+    "c5a.large",
+    "c5a.xlarge",
+    "c5a.2xlarge",
+    "c5a.4xlarge",
+    "c5a.8xlarge",
+    "c5a.12xlarge",
+    "c5a.16xlarge",
+    "c5a.24xlarge",
+    "c6g.medium",
+    "c6g.large",
+    "c6g.xlarge",
+    "c6g.2xlarge",
+    "c6g.4xlarge",
+    "c6g.8xlarge",
+    "c6g.12xlarge",
+    "c6g.16xlarge",
+    // Memory optimised
+    "r5.large",
+    "r5.xlarge",
+    "r5.2xlarge",
+    "r5.4xlarge",
+    "r5.8xlarge",
+    "r5.12xlarge",
+    "r5.16xlarge",
+    "r5.24xlarge",
+    "r5a.large",
+    "r5a.xlarge",
+    "r5a.2xlarge",
+    "r5a.4xlarge",
+    "r5a.8xlarge",
+    "r5a.12xlarge",
+    "r5a.16xlarge",
+    "r5a.24xlarge",
+    "r6g.medium",
+    "r6g.large",
+    "r6g.xlarge",
+    "r6g.2xlarge",
+    "r6g.4xlarge",
+    "r6g.8xlarge",
+    "r6g.12xlarge",
+    "r6g.16xlarge",
+    // Storage optimised
+    "i3.large",
+    "i3.xlarge",
+    "i3.2xlarge",
+    "i3.4xlarge",
+    "i3.8xlarge",
+    "i3.16xlarge",
+    // Accelerated computing
+    "p3.2xlarge",
+    "p3.8xlarge",
+    "p3.16xlarge",
+    "g4dn.xlarge",
+    "g4dn.2xlarge",
+    "g4dn.4xlarge",
+    "g4dn.8xlarge",
+    "g4dn.12xlarge",
+    "g4dn.16xlarge",
+    // Previous generation (still common)
+    "m5.large",
+    "m5.xlarge",
+    "m5.2xlarge",
+    "m5.4xlarge",
+    "m5.8xlarge",
+    "m5.12xlarge",
+    "m5.16xlarge",
+    "m5.24xlarge",
+    "m5a.large",
+    "m5a.xlarge",
+    "m5a.2xlarge",
+    "m5a.4xlarge",
+    "m5a.8xlarge",
+    "m5a.12xlarge",
+    "m5a.16xlarge",
+    "m5a.24xlarge",
+];
+// Valid monitoring intervals for enhanced monitoring (in seconds)
+export const VALID_MONITORING_INTERVALS = [0, 1, 5, 10, 15, 30, 60];
+/** Includes check for `as const` arrays (centralises the widening cast) */
+export function constIncludes(arr, value) {
+    return arr.includes(value);
+}
+// Port constraints
+export const MIN_PORT = 1;
+export const MAX_PORT = 65535;
+/**
+ * Default database port: 35255 (FJALL on phone keypad)
+ * Used when no explicit port is specified in tier presets or configuration.
+ */
+export const DEFAULT_DATABASE_PORT = 35255;
+// Lambda constraints — AWS service hard limits
+export const MIN_LAMBDA_MEMORY = 128;
+export const MAX_LAMBDA_MEMORY = 10240;
+export const MIN_LAMBDA_TIMEOUT = 1;
+export const MAX_LAMBDA_TIMEOUT = 900;
+// ECS constraints — AWS service hard limits
+export const MIN_ECS_CAPACITY = 1;
+export const MAX_ECS_CAPACITY = 1000;
+// Default container port for ECS clusters and services
+export const DEFAULT_CONTAINER_PORT = 3000;
+// Default EC2 instance type — Graviton-based, free-tier eligible
+export const DEFAULT_EC2_INSTANCE_TYPE = "t4g.micro";
+/** AWS Secrets Manager recommended rotation interval (days) */
+export const DEFAULT_SECRET_ROTATION_DAYS = 30;
+// Valid HTTP methods for Lambda CORS
+export const HTTP_METHODS = [
+    "GET",
+    "POST",
+    "PUT",
+    "DELETE",
+    "HEAD",
+    "OPTIONS",
+    "PATCH",
+];
+// S3 storage preset types (generator-level concept, resolved to params before plan creation)
+export const STORAGE_PRESET_TYPES = [
+    "standard",
+    "assets",
+    "upload",
+    "website",
+];
+// S3 encryption types
+export const S3_ENCRYPTION_TYPES = ["AES256", "KMS"];
+// Backup vault tiers for disaster recovery
+export const BACKUP_VAULT_TIERS = [
+    "standard",
+    "resilient",
+    "enterprise",
+];

package/dist/src/schemas/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./resourceSchemas.js";
+export * from "./constants.js";
+export { type AmiHardwareType, getArchitectureForInstanceType, validateArchitectureMatch, isArchitectureCompatible, } from "./instanceTypeArchitecture.js";

package/dist/src/schemas/index.js

@@ -0,0 +1,3 @@
+export * from "./resourceSchemas.js";
+export * from "./constants.js";
+export { getArchitectureForInstanceType, validateArchitectureMatch, isArchitectureCompatible, } from "./instanceTypeArchitecture.js";

package/dist/src/schemas/instanceTypeArchitecture.d.ts

@@ -0,0 +1,35 @@
+/**
+ * EC2 Instance Type Architecture Mapping
+ *
+ * Maps EC2 instance type prefixes to their required CPU architecture.
+ * Used for early validation to prevent architecture mismatches between
+ * instance types and AMI hardware types.
+ */
+export type AmiHardwareType = "ARM" | "STANDARD";
+/**
+ * Get the required architecture for an EC2 instance type.
+ *
+ * @param instanceType - EC2 instance type (e.g., "t4g.micro", "t3.small")
+ * @returns "ARM" for Graviton instances, "STANDARD" for Intel/AMD
+ */
+export declare function getArchitectureForInstanceType(instanceType: string): AmiHardwareType;
+/**
+ * Validate that an EC2 instance type is compatible with the specified AMI hardware type.
+ *
+ * @param instanceType - EC2 instance type (e.g., "t4g.micro")
+ * @param amiHardwareType - AMI hardware type ("ARM" or "STANDARD")
+ * @returns Validation result with optional error message
+ */
+export declare function validateArchitectureMatch(instanceType: string, amiHardwareType: AmiHardwareType): {
+    valid: boolean;
+    message?: string;
+};
+/**
+ * Check if an instance type is compatible with a given AMI hardware type.
+ * Simpler boolean version of validateArchitectureMatch.
+ *
+ * @param instanceType - EC2 instance type
+ * @param amiHardwareType - AMI hardware type
+ * @returns true if compatible, false otherwise
+ */
+export declare function isArchitectureCompatible(instanceType: string, amiHardwareType: AmiHardwareType): boolean;

package/dist/src/schemas/instanceTypeArchitecture.js

@@ -0,0 +1,75 @@
+/**
+ * EC2 Instance Type Architecture Mapping
+ *
+ * Maps EC2 instance type prefixes to their required CPU architecture.
+ * Used for early validation to prevent architecture mismatches between
+ * instance types and AMI hardware types.
+ */
+/**
+ * Instance type prefixes that use ARM64 architecture (Graviton processors).
+ * All other prefixes are assumed to be x86-64 (STANDARD).
+ */
+const ARM_INSTANCE_PREFIXES = new Set([
+    "t4g",
+    "c6g",
+    "c6gd",
+    "c6gn",
+    "c7g",
+    "c7gd",
+    "c7gn",
+    "r6g",
+    "r6gd",
+    "r7g",
+    "r7gd",
+    "m6g",
+    "m6gd",
+    "m7g",
+    "m7gd",
+    "a1",
+    "x2gd",
+    "im4gn",
+    "is4gen",
+    "i4g",
+    "hpc7g",
+]);
+/**
+ * Get the required architecture for an EC2 instance type.
+ *
+ * @param instanceType - EC2 instance type (e.g., "t4g.micro", "t3.small")
+ * @returns "ARM" for Graviton instances, "STANDARD" for Intel/AMD
+ */
+export function getArchitectureForInstanceType(instanceType) {
+    const prefix = instanceType.split(".")[0];
+    return ARM_INSTANCE_PREFIXES.has(prefix) ? "ARM" : "STANDARD";
+}
+/**
+ * Validate that an EC2 instance type is compatible with the specified AMI hardware type.
+ *
+ * @param instanceType - EC2 instance type (e.g., "t4g.micro")
+ * @param amiHardwareType - AMI hardware type ("ARM" or "STANDARD")
+ * @returns Validation result with optional error message
+ */
+export function validateArchitectureMatch(instanceType, amiHardwareType) {
+    const required = getArchitectureForInstanceType(instanceType);
+    if (required !== amiHardwareType) {
+        const suggestion = required === "ARM"
+            ? "Graviton instance (t4g, c6g, r6g, m6g, etc.)"
+            : "Intel/AMD instance (t3, c5, r5, m5, etc.)";
+        return {
+            valid: false,
+            message: `Instance type '${instanceType}' requires ${required} architecture, but '${amiHardwareType}' AMI was specified. Use a ${suggestion} instead.`,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Check if an instance type is compatible with a given AMI hardware type.
+ * Simpler boolean version of validateArchitectureMatch.
+ *
+ * @param instanceType - EC2 instance type
+ * @param amiHardwareType - AMI hardware type
+ * @returns true if compatible, false otherwise
+ */
+export function isArchitectureCompatible(instanceType, amiHardwareType) {
+    return getArchitectureForInstanceType(instanceType) === amiHardwareType;
+}