@fjall/generator 0.89.5 → 0.94.0

package/dist/src/generation/storage.js

@@ -1,182 +1,49 @@
-/**
- * Storage Code Generation
- *
- * Functions for generating storage infrastructure code including
- * S3 buckets, DynamoDB tables, and SQS queues.
- */
-import { buildProperty, getVariableName, emitExtraProperties, } from "./common.js";
-/**
- * Generate S3 bucket configuration properties using buildProperty for consistent formatting
- */
-function generateS3BucketProps(bucket) {
-    let code = "";
-    code += buildProperty(bucket.bucketName !== undefined, "bucketName", bucket.bucketName, "string");
-    code += buildProperty(bucket.stackPlacement !== undefined && bucket.stackPlacement !== "storage", "stackPlacement", bucket.stackPlacement, "string");
-    code += buildProperty(bucket.publicReadAccess === true, "publicReadAccess", true);
-    code += buildProperty(bucket.websiteHosting !== undefined, "websiteHosting", bucket.websiteHosting, "object");
-    code += buildProperty(bucket.backupVaultTier !== undefined, "backupVaultTier", bucket.backupVaultTier, "string");
-    code += buildProperty(bucket.versioned !== undefined, "versioned", bucket.versioned);
-    code += buildProperty(bucket.encryption !== undefined, "encryption", bucket.encryption, "string");
-    code += buildProperty(bucket.kmsKeyArn !== undefined, "kmsKeyArn", bucket.kmsKeyArn, "string");
-    code += buildProperty(bucket.cors !== undefined && bucket.cors.length > 0, "cors", bucket.cors, "object");
-    code += buildProperty(bucket.deployment !== undefined, "deployment", bucket.deployment, "object");
-    return code;
-}
-/**
- * Check if an S3 bucket needs a variable assignment (referenced by compute or CDN)
- */
-export function s3NeedsVariable(bucket, plan) {
-    // Referenced by compute via connectedStorage
-    const computeRef = plan.compute.some((compute) => compute.connectedStorage?.includes(bucket.name));
-    if (computeRef)
-        return true;
-    // Referenced by CDN as an origin
-    if (plan.cdn) {
-        if (plan.cdn.defaultOriginRef === bucket.name)
-            return true;
-        if (plan.cdn.behaviours?.some((b) => b.originRef === bucket.name))
-            return true;
-    }
-    return false;
-}
-/**
- * Generate S3 bucket infrastructure code
- */
-export function generateS3Code(plan) {
-    if (plan.s3.length === 0)
-        return "";
-    let code = "";
-    for (let i = 0; i < plan.s3.length; i++) {
-        const bucket = plan.s3[i];
-        const bucketVariable = getVariableName(bucket);
-        const hasReferences = s3NeedsVariable(bucket, plan);
-        const needsLeadingNewline = plan.database.length > 0 || i > 0;
-        const leadingNewline = needsLeadingNewline ? "\n" : "";
-        const props = generateS3BucketProps(bucket);
-        const prefix = hasReferences ? `const ${bucketVariable} = ` : "";
-        const extraPropsStr = emitExtraProperties(bucket.extraProperties);
-        if (props || extraPropsStr) {
-            code += `${leadingNewline}${prefix}app.addStorage(
-  StorageFactory.build("${bucket.name}", {${props}${extraPropsStr}
+import{buildProperty as o,getVariableName as d,emitExtraProperties as c}from"./common.js";function f(e){let t="";return t+=o(e.bucketName!==void 0,"bucketName",e.bucketName,"string"),t+=o(e.stackPlacement!==void 0&&e.stackPlacement!=="storage","stackPlacement",e.stackPlacement,"string"),t+=o(e.publicReadAccess===!0,"publicReadAccess",!0),t+=o(e.websiteHosting!==void 0,"websiteHosting",e.websiteHosting,"object"),t+=o(e.backupVaultTier!==void 0,"backupVaultTier",e.backupVaultTier,"string"),t+=o(e.versioned!==void 0,"versioned",e.versioned),t+=o(e.encryption!==void 0,"encryption",e.encryption,"string"),t+=o(e.kmsKeyArn!==void 0,"kmsKeyArn",e.kmsKeyArn,"string"),t+=o(e.cors!==void 0&&e.cors.length>0,"cors",e.cors,"object"),t+=o(e.deployment!==void 0,"deployment",e.deployment,"object"),t+=o(e.retain===!0,"retain",!0),t}function p(e,t){return!!(t.compute.some(r=>r.connectedStorage?.includes(e.name))||t.cdn&&(t.cdn.defaultOriginRef===e.name||t.cdn.behaviours?.some(r=>r.originRef===e.name)))}function b(e){if(e.s3.length===0)return"";let t="";for(let n=0;n<e.s3.length;n++){const r=e.s3[n],a=d(r),i=p(r,e),u=e.database.length>0||n>0?`
+`:"",m=f(r),y=i?`const ${a} = `:"",l=c(r.extraProperties);m||l?t+=`${u}${y}app.addStorage(
+  StorageFactory.build("${r.name}", {${m}${l}
   })
 );
-`;
-        }
-        else {
-            code += `${leadingNewline}${prefix}app.addStorage(
-  StorageFactory.build("${bucket.name}", {})
+`:t+=`${u}${y}app.addStorage(
+  StorageFactory.build("${r.name}", {})
 );
-`;
-        }
-    }
-    return code;
-}
-/**
- * Generate DynamoDB table infrastructure code
- */
-export function generateDynamoDBCode(plan) {
-    if (!plan.dynamodb || plan.dynamodb.length === 0)
-        return "";
-    let code = "";
-    for (const table of plan.dynamodb) {
-        const tableVariable = getVariableName(table);
-        code += `
-const ${tableVariable} = app.addDatabase(
-  DatabaseFactory.build("${table.name}", {
+`}return t}function x(e){if(!e.dynamodb||e.dynamodb.length===0)return"";let t="";for(const n of e.dynamodb){const r=d(n);if(t+=`
+const ${r} = app.addDatabase(
+  DatabaseFactory.build("${n.name}", {
     type: "DynamoDB",
     partitionKey: {
-      name: "${table.partitionKey.name}",
-      type: "${table.partitionKey.type}",
-    }`;
-        if (table.sortKey) {
-            code += `,
+      name: "${n.partitionKey.name}",
+      type: "${n.partitionKey.type}",
+    }`,n.sortKey&&(t+=`,
     sortKey: {
-      name: "${table.sortKey.name}",
-      type: "${table.sortKey.type}",
-    }`;
-        }
-        if (table.globalSecondaryIndexes &&
-            table.globalSecondaryIndexes.length > 0) {
-            const gsiStr = table.globalSecondaryIndexes
-                .map((gsi) => {
-                let gsiCode = `{
-        indexName: "${gsi.indexName}",
+      name: "${n.sortKey.name}",
+      type: "${n.sortKey.type}",
+    }`),n.globalSecondaryIndexes&&n.globalSecondaryIndexes.length>0){const a=n.globalSecondaryIndexes.map(i=>{let s=`{
+        indexName: "${i.indexName}",
         partitionKey: {
-          name: "${gsi.partitionKey.name}",
-          type: "${gsi.partitionKey.type}",
-        },`;
-                if (gsi.sortKey) {
-                    gsiCode += `
+          name: "${i.partitionKey.name}",
+          type: "${i.partitionKey.type}",
+        },`;return i.sortKey&&(s+=`
         sortKey: {
-          name: "${gsi.sortKey.name}",
-          type: "${gsi.sortKey.type}",
-        },`;
-                }
-                gsiCode += `
-      }`;
-                return gsiCode;
-            })
-                .join(",\n      ");
-            code += `,
+          name: "${i.sortKey.name}",
+          type: "${i.sortKey.type}",
+        },`),s+=`
+      }`,s}).join(`,
+      `);t+=`,
     globalSecondaryIndexes: [
-      ${gsiStr}
-    ]`;
-        }
-        if (table.ttlAttribute) {
-            code += `,
-    ttlAttribute: "${table.ttlAttribute}"`;
-        }
-        if (table.stream) {
-            code += `,
-    stream: true`;
-        }
-        code += emitExtraProperties(table.extraProperties);
-        code += `
+      ${a}
+    ]`}n.ttlAttribute&&(t+=`,
+    ttlAttribute: "${n.ttlAttribute}"`),n.stream&&(t+=`,
+    stream: true`),t+=c(n.extraProperties),t+=`
   })
 );
-`;
-    }
-    return code;
-}
-/**
- * Check if an SQS queue needs a variable assignment (referenced by compute)
- */
-export function sqsNeedsVariable(queue, plan) {
-    return plan.compute.some((compute) => compute.connectedMessaging?.includes(queue.name));
-}
-/**
- * Generate SQS queue infrastructure code
- */
-export function generateSQSCode(plan) {
-    if (!plan.sqs || plan.sqs.length === 0)
-        return "";
-    let code = "";
-    for (const queue of plan.sqs) {
-        const queueVariable = getVariableName(queue);
-        const hasReferences = sqsNeedsVariable(queue, plan);
-        const prefix = hasReferences ? `const ${queueVariable} = ` : "";
-        code += `
-${prefix}app.addMessaging(
-  MessagingFactory.build("${queue.name}", {
+`}return t}function g(e,t){return t.compute.some(n=>n.connectedMessaging?.includes(e.name))}function K(e){if(!e.sqs||e.sqs.length===0)return"";let t="";for(const n of e.sqs){const r=d(n),i=g(n,e)?`const ${r} = `:"";t+=`
+${i}app.addMessaging(
+  MessagingFactory.build("${n.name}", {
     type: "queue",
-    queueType: "${queue.queueType}"`;
-        if (queue.visibilityTimeout !== undefined) {
-            code += `,
-    visibilityTimeout: ${queue.visibilityTimeout}`;
-        }
-        if (queue.retentionPeriod !== undefined) {
-            code += `,
-    messageRetentionPeriod: ${queue.retentionPeriod}`;
-        }
-        if (queue.contentBasedDeduplication) {
-            code += `,
-    contentBasedDeduplication: true`;
-        }
-        code += emitExtraProperties(queue.extraProperties);
-        code += `
+    queueType: "${n.queueType}"`,n.visibilityTimeout!==void 0&&(t+=`,
+    visibilityTimeout: ${n.visibilityTimeout}`),n.retentionPeriod!==void 0&&(t+=`,
+    messageRetentionPeriod: ${n.retentionPeriod}`),n.contentBasedDeduplication&&(t+=`,
+    contentBasedDeduplication: true`),t+=c(n.extraProperties),t+=`
   })
 );
-`;
-    }
-    return code;
-}
+`}return t}export{x as generateDynamoDBCode,b as generateS3Code,K as generateSQSCode,p as s3NeedsVariable,g as sqsNeedsVariable};

package/dist/src/generation/storageConnections.js

@@ -1,75 +1 @@
-/**
- * Storage Connection Code Generation
- *
- * Functions for generating storage connection code (env vars, connections array)
- * following the same pattern as database connections.
- */
-import { getVariableName } from "./common.js";
-export const STORAGE_ENV_VARS = Object.freeze({
-    NAME: "BUCKET_NAME",
-});
-/**
- * Get S3 buckets connected to a compute resource
- */
-export function getConnectedStorage(plan, compute) {
-    const { connectedStorage } = compute;
-    if (!connectedStorage?.length)
-        return [];
-    return plan.s3.filter((bucket) => connectedStorage.includes(bucket.name));
-}
-/**
- * Generate storage environment variable entries for a list of connected buckets.
- * S3 uses IAM-based access, so there are no secrets — only BUCKET_NAME env vars.
- */
-export function generateStorageEnvVarEntries(connectedStorage) {
-    const entries = [];
-    if (connectedStorage.length === 1) {
-        const bucket = connectedStorage[0];
-        if (!bucket)
-            return entries;
-        const bucketVar = getVariableName(bucket);
-        entries.push({
-            key: STORAGE_ENV_VARS.NAME,
-            expression: `${bucketVar}.getBucketName()`,
-        });
-    }
-    else {
-        for (const [index, bucket] of connectedStorage.entries()) {
-            const bucketVar = getVariableName(bucket);
-            const suffix = index === 0 ? "" : `_${index + 1}`;
-            entries.push({
-                key: `${STORAGE_ENV_VARS.NAME}${suffix}`,
-                expression: `${bucketVar}.getBucketName()`,
-            });
-        }
-    }
-    return entries;
-}
-/**
- * Build storage environment variables for a compute resource.
- * S3 always uses IAM — secrets is always empty.
- */
-export function buildStorageEnvVars(plan, compute) {
-    const env = {};
-    const secrets = {};
-    if (!compute.connectedStorage?.length) {
-        return { env, secrets };
-    }
-    const connectedStorage = getConnectedStorage(plan, compute);
-    const entries = generateStorageEnvVarEntries(connectedStorage);
-    for (const entry of entries) {
-        env[entry.key] = { __expression: entry.expression };
-    }
-    return { env, secrets };
-}
-/**
- * Format combined connections array for generated infrastructure code.
- * Merges database, storage, and messaging variable names into a single connections line.
- */
-export function formatAllConnectionsCode(connectedDatabases, connectedStorage, connectedMessaging = []) {
-    const dbVars = connectedDatabases.map((db) => getVariableName(db));
-    const storageVars = connectedStorage.map((b) => getVariableName(b));
-    const messagingVars = connectedMessaging.map((q) => getVariableName(q));
-    const allVars = [...dbVars, ...storageVars, ...messagingVars].join(", ");
-    return `connections: [${allVars}],`;
-}
+import{getVariableName as a}from"./common.js";const u=Object.freeze({NAME:"BUCKET_NAME"});function f(r,t){const{connectedStorage:e}=t;return e?.length?r.s3.filter(n=>e.includes(n.name)):[]}function g(r){const t=[];if(r.length===1){const e=r[0];if(!e)return t;const n=a(e);t.push({key:u.NAME,expression:`${n}.getBucketName()`})}else for(const[e,n]of r.entries()){const o=a(n),s=e===0?"":`_${e+1}`;t.push({key:`${u.NAME}${s}`,expression:`${o}.getBucketName()`})}return t}function p(r,t){const e={},n={};if(!t.connectedStorage?.length)return{env:e,secrets:n};const o=f(r,t),s=g(o);for(const i of s)e[i.key]={__expression:i.expression};return{env:e,secrets:n}}function V(r,t,e=[]){const n=r.map(c=>a(c)),o=t.map(c=>a(c)),s=e.map(c=>a(c));return`connections: [${[...n,...o,...s].join(", ")}],`}export{u as STORAGE_ENV_VARS,p as buildStorageEnvVars,V as formatAllConnectionsCode,g as generateStorageEnvVarEntries,f as getConnectedStorage};

package/dist/src/planning/generateResourceChange.d.ts

@@ -0,0 +1,21 @@
+import { type Result } from "../types/Result.js";
+import { type AddResourceOptions } from "./resourceAddition.js";
+export interface ResourceChangeResult {
+    /** Original infrastructure.ts content */
+    readonly originalContent: string;
+    /** Modified infrastructure.ts content with resource added */
+    readonly modifiedContent: string;
+    /** Details of the added resource */
+    readonly addedResource: {
+        readonly type: string;
+        readonly name: string;
+    };
+}
+/**
+ * Generates a resource change by parsing existing infrastructure code,
+ * adding a resource to the plan, and regenerating the code.
+ *
+ * Custom code blocks in infrastructure.ts are preserved through the
+ * parse → modify → regenerate cycle via `extractCustomCode: true`.
+ */
+export declare function generateResourceChange(infrastructureContent: string, appName: string, options: AddResourceOptions): Result<ResourceChangeResult, Error>;

package/dist/src/planning/generateResourceChange.js

@@ -0,0 +1 @@
+import{parseInfrastructure as d,convertToResourcePlan as l}from"../ast/index.js";import{success as m,failure as n}from"../types/Result.js";import{generateInfrastructureFromPlan as f}from"./resourcePlanning.js";import{addResourceToPlan as g,validateResourceAddition as p}from"./resourceAddition.js";function h(c,i,t){let r;try{r=d(c,{extractCustomCode:!0})}catch(e){return n(new Error(`Failed to parse infrastructure.ts: ${e instanceof Error?e.message:String(e)}`))}let o;try{o=l(r,i,{skipValidation:!0})}catch(e){return n(new Error(`Failed to build resource plan: ${e instanceof Error?e.message:String(e)}`))}r.customCodeBlocks&&r.customCodeBlocks.length>0&&(o.customCodeBlocks=r.customCodeBlocks);const u=p(o,t);if(!u.success)return u;const s=g(o,t);if(!s.success)return s;const a=f(s.data);return a.success?m({originalContent:c,modifiedContent:a.data,addedResource:{type:t.type,name:t.resourceName}}):n(new Error(`Code generation failed: ${a.error.message}`))}export{h as generateResourceChange};

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

@@ -1 +1,4 @@
 export { planApplicationResources, type OpenNextResourceOptions, planOpenNextResources, type GenerationOptions, generateInfrastructureFromPlan, } from "./resourcePlanning.js";
+export { type ConnectionType, applyComputeConnections, applyServiceConnections, } from "./resourceConnections.js";
+export { type AddableResourceType, type AddResourceOptions, type DatabaseAddOptions, type ProxyAddOptions, type S3AddOptions, type NetworkAddOptions, type EcsComputeAddOptions, type LambdaComputeAddOptions, type CdnAddOptions, type TunnelAddOptions, addResourceToPlan, validateResourceAddition, listAvailableResources, } from "./resourceAddition.js";
+export { type ResourceChangeResult, generateResourceChange, } from "./generateResourceChange.js";

package/dist/src/planning/index.js

@@ -1 +1 @@
-export { planApplicationResources, planOpenNextResources, generateInfrastructureFromPlan, } from "./resourcePlanning.js";
+import{planApplicationResources as r,planOpenNextResources as n,generateInfrastructureFromPlan as a}from"./resourcePlanning.js";import{applyComputeConnections as p,applyServiceConnections as s}from"./resourceConnections.js";import{addResourceToPlan as l,validateResourceAddition as i,listAvailableResources as u}from"./resourceAddition.js";import{generateResourceChange as R}from"./generateResourceChange.js";export{l as addResourceToPlan,p as applyComputeConnections,s as applyServiceConnections,a as generateInfrastructureFromPlan,R as generateResourceChange,u as listAvailableResources,r as planApplicationResources,n as planOpenNextResources,i as validateResourceAddition};

package/dist/src/planning/resourceAddition.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Pure resource addition functions for manipulating ApplicationResourcePlan.
+ * Shared by both CLI generators and webapp API routes.
+ * No I/O, no Tree, no prompts — pure plan manipulation.
+ */
+import type { ApplicationResourcePlan } from "../schemas/resourceSchemas.js";
+import { type Result } from "../types/Result.js";
+export type AddableResourceType = "database" | "database:proxy" | "storage:s3" | "network" | "compute:ecs" | "compute:lambda" | "cdn" | "tunnel";
+export type AddResourceOptions = DatabaseAddOptions | ProxyAddOptions | S3AddOptions | NetworkAddOptions | EcsComputeAddOptions | LambdaComputeAddOptions | CdnAddOptions | TunnelAddOptions;
+export interface DatabaseAddOptions {
+    readonly type: "database";
+    readonly resourceName: string;
+    readonly databaseType: "Instance" | "Aurora" | "GlobalAurora";
+    readonly databaseName?: string;
+    readonly engine?: "postgres" | "mysql";
+    readonly instanceType?: string;
+    readonly multiAz?: boolean;
+    readonly readReplica?: false | {
+        instanceType?: string;
+        availabilityZone?: string;
+    };
+    readonly publiclyAccessible?: boolean;
+    readonly writer?: {
+        enableDatabaseInsights?: boolean;
+        identifierSuffix?: string;
+        availabilityZone?: string;
+    };
+    readonly readers?: false | {
+        instances?: Array<{
+            scaleWithWriter?: boolean;
+            enableDatabaseInsights?: boolean;
+            identifierSuffix?: string;
+            availabilityZone?: string;
+        }>;
+    };
+    readonly backupRetention?: number;
+    readonly preferredMaintenanceWindow?: string;
+    readonly primaryRegion?: string;
+    readonly secondaryRegions?: string[];
+    readonly connectToCompute?: string[];
+    readonly connectToServices?: string[];
+}
+export interface ProxyAddOptions {
+    readonly type: "database:proxy";
+    readonly resourceName: string;
+    readonly targetDatabase: string;
+    readonly maxConnections?: number;
+    readonly maxIdleConnections?: number;
+    readonly connectionBorrowTimeout?: number;
+    readonly requireTLS?: boolean;
+}
+export interface S3AddOptions {
+    readonly type: "storage:s3";
+    readonly resourceName: string;
+    readonly bucketName?: string;
+    readonly publicReadAccess?: boolean;
+    readonly websiteHosting?: boolean;
+    readonly versioned?: boolean;
+    readonly encryption?: "AES256" | "KMS";
+    readonly connectToCompute?: string[];
+    readonly connectToServices?: string[];
+}
+export interface NetworkAddOptions {
+    readonly type: "network";
+    readonly resourceName: string;
+    /** If provided, creates a named additional network. Otherwise merges into default network. */
+    readonly networkName?: string;
+    readonly maxAzs?: number;
+    /** NAT gateway config — false to disable, or config object */
+    readonly natGateways?: false | {
+        count?: number;
+    };
+    /** Flow logs config — false to disable, or config object */
+    readonly flowLogs?: false | {
+        destination?: "cloudwatch" | "s3";
+        retentionDays?: number;
+    };
+    /** VPC endpoints config — false to disable */
+    readonly vpcEndpoints?: false | {
+        gateway?: false | {
+            s3?: boolean;
+            dynamodb?: boolean;
+        };
+        interface?: false | {
+            ecr?: boolean;
+            logs?: boolean;
+            sts?: boolean;
+        };
+    };
+}
+export interface EcsComputeAddOptions {
+    readonly type: "compute:ecs";
+    readonly resourceName: string;
+    readonly services: ReadonlyArray<{
+        name: string;
+        port?: number;
+        cpu?: number;
+        memory?: number;
+        capacityProvider?: "FARGATE" | "FARGATE_SPOT" | "EC2";
+    }>;
+    readonly loadBalancer?: false | "public" | "internal";
+    readonly dockerfilePath?: string;
+    readonly connectedDatabase?: string[];
+}
+export interface LambdaComputeAddOptions {
+    readonly type: "compute:lambda";
+    readonly resourceName: string;
+    readonly timeout?: number;
+    readonly memory?: number;
+    readonly handler?: string;
+    readonly runtime?: string;
+    readonly connectedDatabase?: string[];
+}
+export interface CdnAddOptions {
+    readonly type: "cdn";
+    readonly resourceName: string;
+    readonly defaultOriginRef: string;
+    readonly customDomain?: string;
+    readonly certificateArn?: string;
+    readonly behaviours?: ReadonlyArray<{
+        pathPattern: string;
+        originRef: string;
+        cachePolicy?: "CACHING_OPTIMIZED" | "CACHING_DISABLED";
+    }>;
+}
+export interface TunnelAddOptions {
+    readonly type: "tunnel";
+    readonly resourceName: string;
+    readonly instanceType?: string;
+}
+interface AvailableResource {
+    readonly type: AddableResourceType;
+    readonly label: string;
+    readonly available: boolean;
+    readonly reason?: string;
+}
+/**
+ * Lists which resource types can be added to the given plan,
+ * with reasons for any unavailable types.
+ */
+export declare function listAvailableResources(plan: ApplicationResourcePlan): AvailableResource[];
+/**
+ * Validates that a resource can be added to the plan without actually modifying it.
+ */
+export declare function validateResourceAddition(plan: ApplicationResourcePlan, options: AddResourceOptions): Result<void, Error>;
+/**
+ * Adds a resource to an ApplicationResourcePlan. Returns a new plan with the
+ * resource added. Validates before modifying. Pure function — no I/O.
+ *
+ * For database and storage resources, optional `connectToCompute` / `connectToServices`
+ * fields wire the new resource to existing compute resources in the plan.
+ */
+export declare function addResourceToPlan(plan: ApplicationResourcePlan, options: AddResourceOptions): Result<ApplicationResourcePlan, Error>;
+export {};

package/dist/src/planning/resourceAddition.js

@@ -0,0 +1 @@
+import{success as d,failure as u}from"../types/Result.js";import{toPascalCase as l}from"../generation/common.js";import{applyComputeConnections as b,applyServiceConnections as o}from"./resourceConnections.js";function $(a){const e=a.database.length>0,n=a.cdn!==void 0;return[{type:"database",label:"Database (RDS)",available:!0},{type:"database:proxy",label:"RDS Proxy",available:e,reason:e?void 0:"Requires at least one database"},{type:"storage:s3",label:"S3 Bucket",available:!0},{type:"network",label:"Network (VPC)",available:!0},{type:"compute:ecs",label:"Compute (ECS)",available:!0},{type:"compute:lambda",label:"Compute (Lambda)",available:!0},{type:"cdn",label:"CDN (CloudFront)",available:!n,reason:n?"A CDN is already configured. Remove existing CDN first.":void 0},{type:"tunnel",label:"Database Tunnel",available:e&&!a.tunnel,reason:e?a.tunnel?"Tunnel is already enabled":void 0:"Requires at least one database"}]}function y(a,e){if(E(a,e.resourceName))return u(new Error(`Resource name '${e.resourceName}' is already used in this application.`));switch(e.type){case"database":return w(a,e);case"database:proxy":return g(a,e);case"storage:s3":return d(void 0);case"network":return d(void 0);case"compute:ecs":return!e.services||e.services.length===0?u(new Error("ECS compute requires at least one service.")):d(void 0);case"compute:lambda":return d(void 0);case"cdn":return v(a,e);case"tunnel":return h(a);default:return e}}function w(a,e){const n=e.databaseName??e.resourceName.toLowerCase();return a.database.some(t=>t.databaseName===n)?u(new Error(`Database name '${n}' already exists. Choose a different database name.`)):e.databaseType==="GlobalAurora"&&!e.primaryRegion?u(new Error("GlobalAurora databases require a primaryRegion.")):d(void 0)}function g(a,e){const n=a.database.find(r=>r.name===e.targetDatabase||r.databaseName===e.targetDatabase);if(!n){const r=a.database.map(t=>t.name).join(", ")||"none";return u(new Error(`Database '${e.targetDatabase}' not found. Available databases: ${r}`))}return n.proxy!==void 0&&n.proxy!==!1?u(new Error(`Database '${n.name}' already has RDS Proxy enabled.`)):d(void 0)}function v(a,e){if(a.cdn)return u(new Error("A CDN is already configured for this application. Remove the existing CDN first."));if(!m(a,e.defaultOriginRef))return u(new Error(`Origin '${e.defaultOriginRef}' not found in plan. CDN origin must reference an existing resource.`));if(e.behaviours){for(const n of e.behaviours)if(!m(a,n.originRef))return u(new Error(`Behaviour origin '${n.originRef}' not found in plan.`))}return d(void 0)}function h(a){return a.tunnel&&typeof a.tunnel=="object"?u(new Error("Tunnel is already enabled for this application.")):a.database.length===0?u(new Error("No databases found \u2014 tunnel requires at least one relational database.")):d(void 0)}function q(a,e){const n=y(a,e);if(!n.success)return n;switch(e.type){case"database":return C(a,e);case"database:proxy":return R(a,e);case"storage:s3":return x(a,e);case"network":return D(a,e);case"compute:ecs":return k(a,e);case"compute:lambda":return N(a,e);case"cdn":return A(a,e);case"tunnel":return T(a,e);default:return e}}function C(a,e){const n=e.databaseName??e.resourceName.toLowerCase(),r={name:e.resourceName,type:e.databaseType,databaseName:n};let t;switch(e.databaseType){case"Instance":t={...r,...e.instanceType!==void 0?{instanceType:e.instanceType}:{},...e.multiAz!==void 0?{multiAz:e.multiAz}:{},...e.readReplica!==void 0?{readReplica:e.readReplica}:{},...e.publiclyAccessible!==void 0?{publiclyAccessible:e.publiclyAccessible}:{},...e.backupRetention!==void 0?{backupRetention:e.backupRetention}:{}};break;case"Aurora":t={...r,...e.writer!==void 0?{writer:e.writer}:{},...e.readers!==void 0?{readers:e.readers}:{},...e.backupRetention!==void 0?{backupRetention:e.backupRetention}:{},...e.preferredMaintenanceWindow!==void 0?{preferredMaintenanceWindow:e.preferredMaintenanceWindow}:{}};break;case"GlobalAurora":t={...r,primaryRegion:e.primaryRegion,...e.secondaryRegions!==void 0?{secondaryRegions:e.secondaryRegions}:{}};break;default:{const i=e.databaseType;return u(new Error(`Unknown database type: ${String(i)}`))}}const c={...a,database:[...a.database,t]};return f(c,e.resourceName,"database",e),d(c)}function R(a,e){const n=a.database.map(c=>({...c})),r=n.find(c=>c.name===e.targetDatabase||c.databaseName===e.targetDatabase);if(!r)return u(new Error(`Database '${e.targetDatabase}' not found.`));const t={};return e.maxConnections!==void 0&&(t.maxConnections=e.maxConnections),e.maxIdleConnections!==void 0&&(t.maxIdleConnections=e.maxIdleConnections),e.connectionBorrowTimeout!==void 0&&(t.connectionBorrowTimeout=e.connectionBorrowTimeout),e.requireTLS!==void 0&&(t.requireTLS=e.requireTLS),r.proxy=Object.keys(t).length>0?t:{},d({...a,database:n})}function x(a,e){const n=e.bucketName??e.resourceName.toLowerCase(),r=l(n),t=a.s3.length,c=t===0?"":`${t+1}`,i={name:r,bucketName:n,variableName:`bucket${c}`,...e.publicReadAccess!==void 0?{publicReadAccess:e.publicReadAccess}:{},...e.versioned!==void 0?{versioned:e.versioned}:{},...e.encryption!==void 0?{encryption:e.encryption}:{},...e.websiteHosting?{websiteHosting:{indexDocument:"index.html"}}:{}},s={...a,s3:[...a.s3,i]};return f(s,r,"storage",e),d(s)}function D(a,e){const n={};if(e.maxAzs!==void 0&&(n.maxAzs=e.maxAzs),e.natGateways!==void 0&&(n.natGateways=e.natGateways),e.flowLogs!==void 0&&(n.flowLogs=e.flowLogs),e.vpcEndpoints!==void 0&&(n.vpcEndpoints=e.vpcEndpoints),e.networkName){const r={name:e.networkName,...n};return d({...a,additionalNetworks:[...a.additionalNetworks??[],r]})}return d({...a,network:{...a.network??{},...n}})}function k(a,e){const n=e.connectedDatabase??[],r={name:e.resourceName,type:"ecs",needsConnection:n.length>0,connectedDatabase:n,...e.loadBalancer!==void 0?{cluster:{loadBalancer:e.loadBalancer}}:{},services:e.services.map(t=>({name:t.name,capacityProvider:t.capacityProvider??"FARGATE",...t.port!==void 0?{containers:[{port:t.port}]}:{},...t.cpu!==void 0?{cpu:t.cpu}:{},...t.memory!==void 0?{memory:t.memory}:{}})),dockerfilePath:e.dockerfilePath};return d({...a,compute:[...a.compute,r]})}function N(a,e){const n=e.connectedDatabase??[],r={name:e.resourceName,type:"lambda",needsConnection:n.length>0,connectedDatabase:n,...e.timeout!==void 0?{timeout:e.timeout}:{},...e.memory!==void 0?{memory:e.memory}:{},...e.handler!==void 0?{handler:e.handler}:{},...e.runtime!==void 0?{runtime:e.runtime}:{}};return d({...a,compute:[...a.compute,r]})}function A(a,e){const n={name:e.resourceName,defaultOriginRef:e.defaultOriginRef,...e.customDomain!==void 0?{customDomain:e.customDomain}:{},...e.certificateArn!==void 0?{certificateArn:e.certificateArn}:{},...e.behaviours&&e.behaviours.length>0?{behaviours:[...e.behaviours].map(r=>({pathPattern:r.pathPattern,originRef:r.originRef,...r.cachePolicy!==void 0?{cachePolicy:r.cachePolicy}:{}}))}:{}};return d({...a,cdn:n})}function T(a,e){const n=e.instanceType?{instanceType:e.instanceType}:{};return d({...a,tunnel:n})}function E(a,e){const n=[...a.database.map(r=>r.name),...a.s3.map(r=>r.name),...a.compute.map(r=>r.name),...(a.dynamodb??[]).map(r=>r.name),...(a.sqs??[]).map(r=>r.name)];return a.cdn&&n.push(a.cdn.name),n.includes(e)}function m(a,e){return a.database.some(n=>n.name===e)||a.s3.some(n=>n.name===e)||a.compute.some(n=>n.name===e)||(a.dynamodb??[]).some(n=>n.name===e)||(a.sqs??[]).some(n=>n.name===e)}function f(a,e,n,r){r.connectToCompute&&r.connectToCompute.length>0&&b(a,[...r.connectToCompute],e,n),r.connectToServices&&r.connectToServices.length>0&&o(a,[...r.connectToServices],e,n)}export{q as addResourceToPlan,$ as listAvailableResources,y as validateResourceAddition};

package/dist/src/planning/resourceConnections.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Pure resource connection functions extracted from CLI connectionHelpers.
+ * These wire new resources (databases, S3 buckets) to existing compute resources
+ * in the application resource plan. No I/O, no prompts — pure plan manipulation.
+ */
+import type { ApplicationResourcePlan } from "../schemas/resourceSchemas.js";
+export type ConnectionType = "database" | "storage";
+/**
+ * Apply connections at the service level within ECS clusters.
+ * Service references use the format "ClusterName/ServiceName".
+ * Mutates the plan in place (same as CLI pattern).
+ */
+export declare function applyServiceConnections(currentPlan: ApplicationResourcePlan, connectToServices: string[], resourceName: string, type: ConnectionType): void;
+/**
+ * Apply connections at the compute resource level.
+ * Flags all services within matched compute resources.
+ * Mutates the plan in place (same as CLI pattern).
+ */
+export declare function applyComputeConnections(currentPlan: ApplicationResourcePlan, connectToCompute: string[], resourceName: string, type: ConnectionType): void;

package/dist/src/planning/resourceConnections.js

@@ -0,0 +1 @@
+function u(e){const n=e.split("/");if(n.length!==2||!n[0]||!n[1])throw new Error(`Invalid service reference format: '${e}'. Expected 'ClusterName/ServiceName'.`);return n[0]}function f(e,n,o){o==="database"?(e.needsConnection=!0,e.connectedDatabase=[...new Set([...e.connectedDatabase??[],n])]):e.connectedStorage=[...new Set([...e.connectedStorage??[],n])]}function l(e,n,o,s){const t=new Set(n),a=[...new Set(n.map(u))];for(const i of a){const r=e.compute.find(c=>c.name===i);if(r?.services){f(r,o,s);for(const c of r.services){const d=`${i}/${c.name}`;t.has(d)&&(s==="database"?c.needsDatabaseConnection=!0:c.needsStorageConnection=!0)}}}}function v(e,n,o,s){for(const t of e.compute)if(n.includes(t.name)&&(f(t,o,s),t.services))for(const a of t.services)s==="database"?a.needsDatabaseConnection=!0:a.needsStorageConnection=!0}export{v as applyComputeConnections,l as applyServiceConnections};