@fjall/generator 0.88.4

package/dist/src/presets/patternTierPresets.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Pattern Tier Presets
+ *
+ * Defines configuration presets for OpenNext patterns (Payload, Next.js).
+ * Mirrors the application TIER_PRESETS structure for consistency.
+ *
+ * Architecture:
+ * - PATTERN_TIER_PRESETS defines what each tier means for patterns
+ * - planOpenNextResources() uses these during `fjall create`
+ * - CreateScreen uses these for pattern tier selection
+ * - Custom mode bypasses presets and prompts for each parameter
+ */
+import type { NetworkTierPreset } from "./tierPresets.js";
+import type { BackupVaultTier } from "../schemas/constants.js";
+/**
+ * Pattern tier names - ordered from least to most capable/expensive
+ * Tinkerer and Enterprise are deferred for future implementation.
+ */
+export declare const PATTERN_TIER_NAMES: readonly ["lightweight", "standard", "resilient"];
+export type PatternTierName = (typeof PATTERN_TIER_NAMES)[number];
+export declare const PATTERN_TYPES_WITH_CUSTOM: readonly ["lightweight", "standard", "resilient", "custom"];
+export type PatternTypeWithCustom = (typeof PATTERN_TYPES_WITH_CUSTOM)[number];
+/**
+ * Database preset for pattern tiers.
+ */
+export interface PatternDatabasePreset {
+    /** Database type: RDS Instance or Aurora (Serverless V2) */
+    type: "Instance" | "Aurora";
+    /** Instance type for RDS Instance databases */
+    instanceType?: string;
+    /** Backup retention in days */
+    backupRetention?: number;
+    /** Enable deletion protection */
+    deletionProtection?: boolean;
+    /** KMS encryption configuration */
+    encryption?: {
+        useCMK: true;
+    } | false;
+}
+/**
+ * Compute preset for pattern tiers (Lambda configuration).
+ */
+export interface PatternComputePreset {
+    /** Lambda memory size in MB */
+    memorySize: number;
+    /** Lambda timeout in seconds */
+    timeout: number;
+}
+/**
+ * Complete pattern tier preset configuration.
+ */
+export interface PatternTierPreset {
+    /** Human-readable name for UI display */
+    displayName: string;
+    /** Brief description of what this tier is for */
+    description: string;
+    /** Database configuration */
+    database: PatternDatabasePreset;
+    /** Compute (Lambda) configuration */
+    compute: PatternComputePreset;
+    /** Network configuration */
+    network: NetworkTierPreset;
+    /** Backup configuration. Object = enrol in AWS Backup, false = no backup. */
+    backup: {
+        tier: BackupVaultTier;
+    } | false;
+}
+/**
+ * Master configuration for all pattern tiers.
+ *
+ * | Tier        | Database              | Lambda Memory | Lambda Timeout | Network          |
+ * |-------------|----------------------|---------------|----------------|------------------|
+ * | Lightweight | Instance (t4g.small) | 512 MB        | 30s            | 2 AZ, 1 NAT      |
+ * | Standard    | Instance (t4g.large) | 1536 MB       | 60s            | 3 AZ, 1 NAT      |
+ * | Resilient   | Aurora V2 + KMS      | 2048 MB       | 120s           | 3 AZ, 3 NAT      |
+ */
+export declare const PATTERN_TIER_PRESETS: Readonly<Record<PatternTierName, PatternTierPreset>>;
+/**
+ * Get pattern tier preset by name.
+ */
+export declare function getPatternTierPreset(tier: PatternTierName): PatternTierPreset;
+/**
+ * Get tier options formatted for UI Select component.
+ */
+export declare function getPatternTierOptions(): Array<{
+    label: string;
+    value: PatternTierName | "custom";
+    description: string;
+}>;
+/**
+ * Check if a tier name is a valid pattern tier.
+ */
+export declare function isPatternTierName(tier: string): tier is PatternTierName;

package/dist/src/presets/patternTierPresets.js

@@ -0,0 +1,131 @@
+/**
+ * Pattern Tier Presets
+ *
+ * Defines configuration presets for OpenNext patterns (Payload, Next.js).
+ * Mirrors the application TIER_PRESETS structure for consistency.
+ *
+ * Architecture:
+ * - PATTERN_TIER_PRESETS defines what each tier means for patterns
+ * - planOpenNextResources() uses these during `fjall create`
+ * - CreateScreen uses these for pattern tier selection
+ * - Custom mode bypasses presets and prompts for each parameter
+ */
+/**
+ * Pattern tier names - ordered from least to most capable/expensive
+ * Tinkerer and Enterprise are deferred for future implementation.
+ */
+export const PATTERN_TIER_NAMES = [
+    "lightweight",
+    "standard",
+    "resilient",
+];
+export const PATTERN_TYPES_WITH_CUSTOM = [
+    ...PATTERN_TIER_NAMES,
+    "custom",
+];
+/**
+ * Master configuration for all pattern tiers.
+ *
+ * | Tier        | Database              | Lambda Memory | Lambda Timeout | Network          |
+ * |-------------|----------------------|---------------|----------------|------------------|
+ * | Lightweight | Instance (t4g.small) | 512 MB        | 30s            | 2 AZ, 1 NAT      |
+ * | Standard    | Instance (t4g.large) | 1536 MB       | 60s            | 3 AZ, 1 NAT      |
+ * | Resilient   | Aurora V2 + KMS      | 2048 MB       | 120s           | 3 AZ, 3 NAT      |
+ */
+export const PATTERN_TIER_PRESETS = Object.freeze({
+    lightweight: {
+        displayName: "Lightweight",
+        description: "Cost-effective · Instance DB, minimal Lambda",
+        database: {
+            type: "Instance",
+            instanceType: "t4g.small",
+            backupRetention: 7,
+            deletionProtection: false,
+        },
+        compute: {
+            memorySize: 512,
+            timeout: 30,
+        },
+        network: { maxAzs: 2, natGateways: { count: 1 }, flowLogs: false },
+        backup: false,
+    },
+    standard: {
+        displayName: "Standard",
+        description: "Production-ready · Instance DB, balanced Lambda",
+        database: {
+            type: "Instance",
+            instanceType: "t4g.large",
+            backupRetention: 14,
+            deletionProtection: true,
+        },
+        compute: {
+            memorySize: 1536,
+            timeout: 60,
+        },
+        network: { maxAzs: 3, natGateways: { count: 1 }, flowLogs: {} },
+        backup: { tier: "standard" },
+    },
+    resilient: {
+        displayName: "Resilient",
+        description: "High-availability · Aurora V2, KMS encryption",
+        database: {
+            type: "Aurora",
+            backupRetention: 30,
+            deletionProtection: true,
+            encryption: { useCMK: true },
+        },
+        compute: {
+            memorySize: 2048,
+            timeout: 120,
+        },
+        network: {
+            maxAzs: 3,
+            natGateways: { count: 3 },
+            flowLogs: { retentionDays: 90 },
+        },
+        backup: { tier: "resilient" },
+    },
+});
+/**
+ * Get pattern tier preset by name.
+ */
+export function getPatternTierPreset(tier) {
+    return PATTERN_TIER_PRESETS[tier];
+}
+/**
+ * Get tier options formatted for UI Select component.
+ */
+export function getPatternTierOptions() {
+    return [
+        {
+            label: PATTERN_TIER_PRESETS.standard.displayName,
+            value: "standard",
+            description: PATTERN_TIER_PRESETS.standard.description,
+        },
+        {
+            label: PATTERN_TIER_PRESETS.lightweight.displayName,
+            value: "lightweight",
+            description: PATTERN_TIER_PRESETS.lightweight.description,
+        },
+        {
+            label: PATTERN_TIER_PRESETS.resilient.displayName,
+            value: "resilient",
+            description: PATTERN_TIER_PRESETS.resilient.description,
+        },
+        {
+            label: "Custom",
+            value: "custom",
+            description: "Full control · Configure everything",
+        },
+    ];
+}
+/**
+ * Set of pattern tier names for O(1) lookup.
+ */
+const PATTERN_TIER_NAMES_SET = new Set(PATTERN_TIER_NAMES);
+/**
+ * Check if a tier name is a valid pattern tier.
+ */
+export function isPatternTierName(tier) {
+    return PATTERN_TIER_NAMES_SET.has(tier);
+}

package/dist/src/presets/storagePresets.d.ts

@@ -0,0 +1,11 @@
+import type { S3ResourcePlan } from "../schemas/resourceSchemas.js";
+import type { STORAGE_PRESET_TYPES } from "../schemas/constants.js";
+export type StoragePreset = (typeof STORAGE_PRESET_TYPES)[number];
+type S3PresetOverrides = Partial<Omit<S3ResourcePlan, "name" | "variableName" | "extraProperties">>;
+export declare const STORAGE_PRESETS: Readonly<Record<StoragePreset, S3PresetOverrides>>;
+export declare function getStoragePreset(preset: StoragePreset): S3PresetOverrides;
+export declare function getStoragePresetOptions(): ReadonlyArray<{
+    readonly label: string;
+    readonly value: StoragePreset;
+}>;
+export {};

package/dist/src/presets/storagePresets.js

@@ -0,0 +1,36 @@
+export const STORAGE_PRESETS = Object.freeze({
+    standard: {},
+    assets: {
+        versioned: true,
+        deployment: {
+            source: "./assets",
+        },
+    },
+    upload: {
+        versioned: true,
+        cors: [
+            {
+                allowedOrigins: ["*"],
+                allowedMethods: ["GET", "PUT", "POST"],
+            },
+        ],
+    },
+    website: {
+        publicReadAccess: true,
+        websiteHosting: {
+            indexDocument: "index.html",
+            errorDocument: "error.html",
+        },
+    },
+});
+export function getStoragePreset(preset) {
+    return { ...STORAGE_PRESETS[preset] };
+}
+export function getStoragePresetOptions() {
+    return [
+        { label: "Standard", value: "standard" },
+        { label: "Assets", value: "assets" },
+        { label: "Upload", value: "upload" },
+        { label: "Website Hosting", value: "website" },
+    ];
+}

package/dist/src/presets/tierPresets.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Tier Presets
+ *
+ * This file defines the configuration presets for each tier (Tinkerer, Standard,
+ * Resilient, Enterprise) across all resource types. Both the `create` flow and
+ * `add` flow consume these presets to ensure consistency.
+ *
+ * Architecture:
+ * - TIER_PRESETS defines what each tier means for each resource type
+ * - planApplicationResources() uses these during `fjall create`
+ * - AddResourceScreen uses these during `fjall add`
+ * - Custom mode bypasses presets and prompts for each parameter
+ *
+ * Type definitions live in ./tierTypes.ts and are re-exported here.
+ */
+import type { DatabaseType } from "../schemas/constants.js";
+import type { TierProxyConfig, TierReadReplicaConfig, TierCredentialsConfig, TierAuroraReadersConfig, TierDatabaseInsightsConfig, TierEncryptionConfig, DatabaseTierPreset, TierEc2CapacityConfig, TierClusterConfig, TierEcsServiceConfig, EcsTierPreset, LambdaTierPreset, TierNatConfig, TierFlowLogConfig, TierGatewayEndpointsConfig, TierInterfaceEndpointsConfig, TierVpcEndpointsConfig, NetworkTierPreset, TierPreset, UserServiceConfig } from "./tierTypes.js";
+export type { TierProxyConfig, TierReadReplicaConfig, TierCredentialsConfig, TierAuroraReadersConfig, TierDatabaseInsightsConfig, TierEncryptionConfig, DatabaseTierPreset, TierEc2CapacityConfig, TierClusterConfig, TierEcsServiceConfig, EcsTierPreset, LambdaTierPreset, TierNatConfig, TierFlowLogConfig, TierGatewayEndpointsConfig, TierInterfaceEndpointsConfig, TierVpcEndpointsConfig, NetworkTierPreset, TierPreset, UserServiceConfig, };
+/**
+ * Tier names - ordered from least to most capable/expensive
+ * This is the single source of truth for all tier-based configuration.
+ */
+export declare const TIER_NAMES: readonly ["tinkerer", "lightweight", "standard", "resilient", "enterprise"];
+export type TierName = (typeof TIER_NAMES)[number];
+export declare const CUSTOM_TIER: "custom";
+export declare const APP_TYPES: readonly ["tinkerer", "lightweight", "standard", "resilient", "enterprise", "custom"];
+export type AppType = (typeof APP_TYPES)[number];
+/**
+ * Master configuration for all tiers
+ */
+export declare const TIER_PRESETS: Record<TierName, TierPreset>;
+export declare function getDatabasePreset(tier: TierName, databaseType: DatabaseType): DatabaseTierPreset | null;
+/**
+ * Get ECS preset for a specific tier
+ */
+export declare function getEcsPreset(tier: TierName): EcsTierPreset;
+/**
+ * Get network preset for a specific tier
+ */
+export declare function getNetworkPreset(tier: TierName): NetworkTierPreset;
+export declare function getAvailableTiersForDatabase(databaseType: DatabaseType): TierName[];
+/**
+ * Get tier options formatted for UI Select component
+ */
+export declare function getTierOptionsForDatabase(databaseType: DatabaseType): Array<{
+    label: string;
+    value: TierName;
+    description: string;
+}>;
+/**
+ * Get the default database type for a tier
+ */
+export declare function getDefaultDatabaseTypeForTier(tier: TierName): DatabaseType;
+/**
+ * Apply tier defaults to user-provided services.
+ * Takes user service names and applies the tier's cpu, memory, scaling,
+ * capacityProvider, and ec2Config defaults.
+ */
+export declare function applyTierDefaultsToServices(tier: TierName, userServices: UserServiceConfig[]): TierEcsServiceConfig[];