@fjall/generator 7.2.0 → 7.3.0

package/dist/.build-source-hash

@@ -9,7 +9,7 @@
     "package.json",
     "tsconfig.json"
   ],
-  "hash": "0baa26e2a704915b32867832ebb1fd741502646d6d1466be1ea84a7a685d901a",
+  "hash": "940dd689f74de4aba85a336a7c2c2f48358a0b9740fabec971c03be2294e0714",
   "files": {
     "src/ast/astTestHelpers.ts": "026cac849eb88bdb",
     "src/ast/domain/astDomainParser.ts": "bac0b16eb2e62552",
@@ -41,10 +41,10 @@
     "src/codemod/drift/merge.ts": "29093929befa9abd",
     "src/codemod/drift/snapshot.ts": "f8ef6b4097aa3d10",
     "src/codemod/drift/types.ts": "7f1d7899e420e4d7",
-    "src/codemod/edits/addResource.ts": "bad55550ecff2f72",
+    "src/codemod/edits/addResource.ts": "c8fe476d5ef589fe",
     "src/codemod/edits/addResource/appBinding.ts": "3553fdb30fe06335",
     "src/codemod/edits/addResource/bodyIndex.ts": "3e179eac10d7bcf4",
-    "src/codemod/edits/addResource/propertyBuilder.ts": "18022f8899ba4b38",
+    "src/codemod/edits/addResource/propertyBuilder.ts": "9102dff7e9fab376",
     "src/codemod/edits/appendAccountToStage.ts": "2b92f93734497303",
     "src/codemod/edits/controlFlowPolicy.ts": "e32bbe2894f76c65",
     "src/codemod/edits/crossPlanConnection.ts": "54a4ecb7b3368160",
@@ -52,7 +52,7 @@
     "src/codemod/edits/ensureImports.ts": "3ca0b6d446c4333c",
     "src/codemod/edits/findInsertionPosition.ts": "20cd34fdcf781017",
     "src/codemod/edits/index.ts": "bea5ed7c3983342b",
-    "src/codemod/edits/modifyResource.ts": "578412079d63ab60",
+    "src/codemod/edits/modifyResource.ts": "8f19d8c272c2613e",
     "src/codemod/edits/modifyResource/literalConversion.ts": "31295cccd59131b7",
     "src/codemod/edits/removeResource.ts": "2c7c8fe67bc3a866",
     "src/codemod/edits/removeResource/commentHeuristic.ts": "90b6ce7ba5aa2a48",
@@ -60,7 +60,8 @@
     "src/codemod/edits/unmanagedShapeErrors.ts": "47a2644913c8e619",
     "src/codemod/edits/vpcPeer.ts": "0bcf90c2e6d16ca4",
     "src/codemod/edits/vpcPeerAccepter.ts": "c9eace933e9e2345",
-    "src/codemod/emitGuard.ts": "cbe270e04e1fea1a",
+    "src/codemod/emitGuard.ts": "652d9b188276acf8",
+    "src/codemod/emitProjection.ts": "9a47ef44995be65f",
     "src/codemod/fileRewriter/builders.ts": "46a0d43240ff0818",
     "src/codemod/fileRewriter/index.ts": "fd715b41176a7999",
     "src/codemod/fileRewriter/locateByRange.ts": "889ee6256201c1fe",
@@ -82,7 +83,7 @@
     "src/codemod/llmFallback/telemetryEvents.ts": "33a85939739693ab",
     "src/codemod/llmFallback/tierRunner.ts": "a26094accd78cf15",
     "src/codemod/llmFallback/types.ts": "14af8d2bd9afae12",
-    "src/codemod/registry.ts": "ab1869907bcb957b",
+    "src/codemod/registry.ts": "bb0d629f33e5bf59",
     "src/codemod/semanticIndex/classifyControlFlow.ts": "ed96215d91a3cae3",
     "src/codemod/semanticIndex/findReferences.ts": "96aea37418d1e91a",
     "src/codemod/semanticIndex/index.ts": "cfcd212d34ab20fb",
@@ -106,7 +107,7 @@
     "src/dns/domainRecords.ts": "17f895ff9a7b719b",
     "src/dns/index.ts": "b476ef3d7b381dc8",
     "src/dns/types.ts": "82d6db9d7d26dbc2",
-    "src/generation/common.ts": "4b63724600c726de",
+    "src/generation/common.ts": "73fa0ad5ffeeeed4",
     "src/generation/compute.ts": "4029a0d8e3197686",
     "src/generation/compute/ec2.ts": "4d8187d293a57fb1",
     "src/generation/compute/ecs.ts": "72190132fdaa1847",
@@ -117,15 +118,15 @@
     "src/generation/index.ts": "fd58a833e13bcf07",
     "src/generation/infrastructure.ts": "6381d502f4733926",
     "src/generation/messagingConnections.ts": "1f070088c39e9749",
-    "src/generation/storage.ts": "68fa78401bbcf8a5",
+    "src/generation/storage.ts": "2c0171aeeec3d79e",
     "src/generation/storageConnections.ts": "db1ab6ccdc19afab",
     "src/index.ts": "fc8f27b8ffade9ef",
     "src/planning/generateResourceChange.ts": "1c6411f9a12e7acb",
-    "src/planning/index.ts": "5caacb699eed31ba",
+    "src/planning/index.ts": "64c4a88a38e9956d",
     "src/planning/openNextPlanning.ts": "4af9cb9061f7d21e",
     "src/planning/resourceAddition.ts": "45b010d2eaf96522",
     "src/planning/resourceConnections.ts": "a6b7db8f733e560f",
-    "src/planning/resourcePlanning.ts": "85038ad65bda976f",
+    "src/planning/resourcePlanning.ts": "6c966fe586fff080",
     "src/planning/staticSitePlanning.ts": "242af1e9618821ab",
     "src/presets/clickhouseTierPreset.ts": "72b2b8a8caf4bdb4",
     "src/presets/index.ts": "8332c0198b2a6fe9",
@@ -133,6 +134,10 @@
     "src/presets/storagePresets.ts": "5df2d4d7d21a66d8",
     "src/presets/tierPresets.ts": "c0148771bffbef9b",
     "src/presets/tierTypes.ts": "96d33201ebddf6e6",
+    "src/projection/index.ts": "f46e0e482bb33565",
+    "src/projection/project.ts": "2104026f10a27264",
+    "src/projection/tables.ts": "00904da382c06cf5",
+    "src/projection/types.ts": "da0845cb34bfd12b",
     "src/schemas/alarmSchemas.ts": "9016095d8031f006",
     "src/schemas/applicationSchemas.ts": "d85771a4607cf2da",
     "src/schemas/baseSchemas.ts": "93d9bd1c0adfcaa0",
@@ -157,11 +162,11 @@
     "src/validation/patterns.ts": "f9629eafdad7ac3e",
     "src/validation/validationMessages.ts": "c727ade4690274f4",
     "src/validation/validationPatterns.ts": "865f3d688975b7c8",
-    "src/version.ts": "0e8c8d5ddae4f56f",
+    "src/version.ts": "cb82d9efdb80e56a",
     "../scripts/minify-dist.mjs": "6b2e4b0df8aec601",
-    "package.json": "f4b1c9b80d0dbdc7",
+    "package.json": "7b8ea09642d00081",
     "tsconfig.json": "1929cf3f99fe9b1e"
   },
-  "outputHash": "f4cd7140916d1965092b898aae1c66a849628b3d65177ab511f1207b09329c8f",
-  "outputFileCount": 295
+  "outputHash": "fbeb7c7236155acb29d05407d96d62c5e210f2478b90d1809a51fc9c2c96cd02",
+  "outputFileCount": 305
 }

package/dist/.minified

@@ -1 +1 @@
-147 files minified at 2026-08-06T02:33:58.009Z
+152 files minified at 2026-08-06T23:10:36.463Z

package/dist/src/codemod/edits/addResource/propertyBuilder.d.ts

@@ -1,7 +1,14 @@
 import { type namedTypes as n } from "ast-types";
 import { type Result } from "../../../types/Result.js";
 import { type ObjectPropertyInput, type QuoteStyle } from "../../fileRewriter/index.js";
+import type { LiteralProp } from "../../emitProjection.js";
 import type { InvalidPropertyError } from "../../types.js";
-export declare function buildPropertyInputs(properties: Record<string, unknown>, quoteStyle: QuoteStyle): Result<ObjectPropertyInput[], InvalidPropertyError>;
+/**
+ * Build the emitted object literal from CONSTRUCT-vocabulary props.
+ *
+ * The caller has already run the plan fragment through the projection, so
+ * every key here is one a construct reads, in emission order.
+ */
+export declare function buildPropertyInputs(properties: ReadonlyArray<LiteralProp>, quoteStyle: QuoteStyle): Result<ObjectPropertyInput[], InvalidPropertyError>;
 export declare function toAstValue(value: unknown, quoteStyle: QuoteStyle): n.Property["value"] | undefined;
 export declare function makeStringLiteral(value: string, quote: QuoteStyle): n.StringLiteral;

package/dist/src/codemod/edits/addResource/propertyBuilder.js

@@ -1 +1 @@
-var c=Object.defineProperty;var f=(r,e)=>c(r,"name",{value:e,configurable:!0});import{builders as i}from"ast-types";import{failure as u,success as a}from"../../../types/Result.js";import{buildObjectProperty as d}from"../../fileRewriter/index.js";function j(r,e){const n=[];for(const[t,o]of Object.entries(r)){const s=p(o,e);if(s===void 0)return u({kind:"InvalidPropertyError",property:t,reason:`Unsupported property value for "${t}" (accepts string/number/boolean/null/array/object of the same).`});n.push({key:t,value:s})}return a(n)}f(j,"buildPropertyInputs");function p(r,e){if(typeof r=="string")return l(r,e);if(typeof r=="number"&&Number.isFinite(r))return i.numericLiteral(r);if(typeof r=="boolean")return i.booleanLiteral(r);if(r===null)return i.nullLiteral();if(Array.isArray(r)){const n=[];for(const t of r){const o=p(t,e);if(o===void 0)return;n.push(o)}return i.arrayExpression(n)}if(typeof r=="object"&&r!==null){const n=[];for(const[t,o]of Object.entries(r)){const s=p(o,e);if(s===void 0)return;n.push(d(t,s,e))}return i.objectExpression(n)}}f(p,"toAstValue");function l(r,e){const n=e==="single"?"'":'"',t=e==="single"?r.replace(/\\/g,"\\\\").replace(/'/g,"\\'"):r.replace(/\\/g,"\\\\").replace(/"/g,'\\"'),o=`${n}${t}${n}`;return i.stringLiteral.from({value:r,extra:{rawValue:r,raw:o}})}f(l,"makeStringLiteral");export{j as buildPropertyInputs,l as makeStringLiteral,p as toAstValue};
+var c=Object.defineProperty;var f=(r,e)=>c(r,"name",{value:e,configurable:!0});import{builders as i}from"ast-types";import{failure as u,success as a}from"../../../types/Result.js";import{buildObjectProperty as d}from"../../fileRewriter/index.js";function x(r,e){const n=[];for(const{key:t,value:o}of r){const s=p(o,e);if(s===void 0)return u({kind:"InvalidPropertyError",property:t,reason:`Unsupported property value for "${t}" (accepts string/number/boolean/null/array/object of the same).`});n.push({key:t,value:s})}return a(n)}f(x,"buildPropertyInputs");function p(r,e){if(typeof r=="string")return l(r,e);if(typeof r=="number"&&Number.isFinite(r))return i.numericLiteral(r);if(typeof r=="boolean")return i.booleanLiteral(r);if(r===null)return i.nullLiteral();if(Array.isArray(r)){const n=[];for(const t of r){const o=p(t,e);if(o===void 0)return;n.push(o)}return i.arrayExpression(n)}if(typeof r=="object"&&r!==null){const n=[];for(const[t,o]of Object.entries(r)){const s=p(o,e);if(s===void 0)return;n.push(d(t,s,e))}return i.objectExpression(n)}}f(p,"toAstValue");function l(r,e){const n=e==="single"?"'":'"',t=e==="single"?r.replace(/\\/g,"\\\\").replace(/'/g,"\\'"):r.replace(/\\/g,"\\\\").replace(/"/g,'\\"'),o=`${n}${t}${n}`;return i.stringLiteral.from({value:r,extra:{rawValue:r,raw:o}})}f(l,"makeStringLiteral");export{x as buildPropertyInputs,l as makeStringLiteral,p as toAstValue};

package/dist/src/codemod/edits/addResource.js

@@ -1 +1 @@
-var A=Object.defineProperty;var u=(r,e)=>A(r,"name",{value:e,configurable:!0});import{failure as a,success as g}from"../../types/Result.js";import{DEFAULT_FILE_PATH as D,computeLinesDelta as F,extractProgramBody as M,isRecord as C}from"../_internal.js";import{evaluateEmitGuard as v}from"../emitGuard.js";import{appendSpecifier as x,buildAppMethodWrappedStatement as w,buildFactoryStatement as G,buildImportDeclaration as N,detectQuoteStyle as Q,parse as B,printFile as U}from"../fileRewriter/index.js";import{STATEMENT_REGISTRY as _}from"../registry.js";import{locateAllShapes as O,locateByShape as W}from"../semanticIndex/index.js";import{checkControlFlowPolicy as Y}from"./controlFlowPolicy.js";import{driftGate as j,runPipeline as q,schemaGate as H}from"../validationGate/index.js";import{resolveAppBindingName as $}from"./addResource/appBinding.js";import{buildUnmanagedDuplicateError as z}from"./unmanagedShapeErrors.js";import{buildResourceLocations as J,indexBody as K,orderByEndPos as V,resolveInsertIndex as X}from"./addResource/bodyIndex.js";import{buildPropertyInputs as Z}from"./addResource/propertyBuilder.js";import{findInsertionPosition as ee}from"./findInsertionPosition.js";const k="@fjall/components-infrastructure";function he(r,e,m={}){const s=e.filePath??D,n=B(r,s);if(!n.success)return a(n.error);const t=W(r,{type:e.type,name:e.name},s);if(!t.success)return t.error.kind==="TemplateLiteralNameError"?a(t.error):a({kind:"SemanticQueryError",reason:t.error.reason,cause:t.error.cause});if(t.data!==void 0){if(t.data.managed===!1)return a(z(e.type,t.data.symbolName));const d=Y({ast:n.data,target:t.data,resource:{type:e.type,name:e.name},op:"add"});if(d.refusal!==void 0)return a(d.refusal);const E=q([H,j],{content:r,plan:{type:e.type,name:e.name,properties:e.properties,op:"add"},baseline:m.baseline,policy:e.driftPolicy});return E.success?E.data.action==="skip"?g({content:r,linesChanged:{added:0,removed:0},skipped:!0}):a({kind:"DuplicateResourceError",type:e.type,name:e.name}):a(re(E.error))}const l=Q(n.data),f=Z(e.properties,l);if(!f.success)return a(f.error);const c=M(n.data);if(c===void 0)return a({kind:"SemanticQueryError",reason:"recast File is missing program.body"});const o=_[e.type],h=v(o.emitGuard,e.properties);if(h!==void 0)return a(h);const I={factory:o.factoryIdentifier,name:e.name,properties:f.data,quoteStyle:l};let y;if(o.emitWrapper!==void 0){const d=$(c);if(d===void 0)return a({kind:"MissingAppInitError",type:e.type,appMethod:o.emitWrapper.appMethod});y=w({...I,appIdentifier:d,appMethod:o.emitWrapper.appMethod})}else y=G(I);const p=K(c,r),i=O(r,s);if(!i.success)return i.error.kind==="TemplateLiteralNameError"?a(i.error):a({kind:"SemanticQueryError",reason:i.error.reason,cause:i.error.cause});const P=J(p.anchors,i.data),L=V([...p.appInitLocations,...P]),R=ee(p.importInfos,L,e.type,p.programEnd),b=X(p.anchors,R);c.splice(b,0,y),te(c,o.factoryIdentifier,l);const S=U(n.data,r),T=F(r,S);return g({content:S,linesChanged:T})}u(he,"addResource");function re(r){switch(r.kind){case"ParseError":case"TemplateLiteralNameError":case"DuplicateResourceError":case"InvalidPropertyError":case"SemanticQueryError":case"MissingAppInitError":case"DriftConflictError":case"ControlFlowClassifierError":return r;default:return{kind:"SemanticQueryError",reason:`Unexpected codemod error in validation-gate pipeline: ${r.kind}`}}}u(re,"narrowGateError");function te(r,e,m){for(const n of r){if(n.type!=="ImportDeclaration")continue;const t=n.source;if(!(!C(t)||t.type!=="StringLiteral")&&t.value===k){x(n,e);return}}const s=N([e],k,m);r.unshift(s)}u(te,"ensureFactoryImport");export{he as addResource};
+var D=Object.defineProperty;var u=(r,e)=>D(r,"name",{value:e,configurable:!0});import{failure as t,success as P}from"../../types/Result.js";import{DEFAULT_FILE_PATH as F,computeLinesDelta as M,extractProgramBody as C,isRecord as v}from"../_internal.js";import{evaluateEmitGuard as x}from"../emitGuard.js";import{projectEmittedProperties as w}from"../emitProjection.js";import{appendSpecifier as G,buildAppMethodWrappedStatement as N,buildFactoryStatement as Q,buildImportDeclaration as B,detectQuoteStyle as U,parse as _,printFile as O}from"../fileRewriter/index.js";import{STATEMENT_REGISTRY as W}from"../registry.js";import{locateAllShapes as j,locateByShape as Y}from"../semanticIndex/index.js";import{checkControlFlowPolicy as q}from"./controlFlowPolicy.js";import{driftGate as H,runPipeline as $,schemaGate as z}from"../validationGate/index.js";import{resolveAppBindingName as J}from"./addResource/appBinding.js";import{buildUnmanagedDuplicateError as K}from"./unmanagedShapeErrors.js";import{buildResourceLocations as V,indexBody as X,orderByEndPos as Z,resolveInsertIndex as ee}from"./addResource/bodyIndex.js";import{buildPropertyInputs as re}from"./addResource/propertyBuilder.js";import{findInsertionPosition as te}from"./findInsertionPosition.js";const k="@fjall/components-infrastructure";function ge(r,e,m={}){const s=e.filePath??F,o=_(r,s);if(!o.success)return t(o.error);const a=Y(r,{type:e.type,name:e.name},s);if(!a.success)return a.error.kind==="TemplateLiteralNameError"?t(a.error):t({kind:"SemanticQueryError",reason:a.error.reason,cause:a.error.cause});if(a.data!==void 0){if(a.data.managed===!1)return t(K(e.type,a.data.symbolName));const d=q({ast:o.data,target:a.data,resource:{type:e.type,name:e.name},op:"add"});if(d.refusal!==void 0)return t(d.refusal);const h=$([z,H],{content:r,plan:{type:e.type,name:e.name,properties:e.properties,op:"add"},baseline:m.baseline,policy:e.driftPolicy});return h.success?h.data.action==="skip"?P({content:r,linesChanged:{added:0,removed:0},skipped:!0}):t({kind:"DuplicateResourceError",type:e.type,name:e.name}):t(ae(h.error))}const f=U(o.data),l=w(e.type,e.properties);if("refusal"in l)return t(l.refusal);const y=re(l.props,f);if(!y.success)return t(y.error);const c=C(o.data);if(c===void 0)return t({kind:"SemanticQueryError",reason:"recast File is missing program.body"});const i=W[e.type],I=x(i.emitGuard,e.properties);if(I!==void 0)return t(I);const S={factory:i.factoryIdentifier,name:e.name,properties:y.data,quoteStyle:f};let E;if(i.emitWrapper!==void 0){const d=J(c);if(d===void 0)return t({kind:"MissingAppInitError",type:e.type,appMethod:i.emitWrapper.appMethod});E=N({...S,appIdentifier:d,appMethod:i.emitWrapper.appMethod})}else E=Q(S);const p=X(c,r),n=j(r,s);if(!n.success)return n.error.kind==="TemplateLiteralNameError"?t(n.error):t({kind:"SemanticQueryError",reason:n.error.reason,cause:n.error.cause});const L=V(p.anchors,n.data),R=Z([...p.appInitLocations,...L]),b=te(p.importInfos,R,e.type,p.programEnd),T=ee(p.anchors,b);c.splice(T,0,E),oe(c,i.factoryIdentifier,f);const g=O(o.data,r),A=M(r,g);return P({content:g,linesChanged:A})}u(ge,"addResource");function ae(r){switch(r.kind){case"ParseError":case"TemplateLiteralNameError":case"DuplicateResourceError":case"InvalidPropertyError":case"SemanticQueryError":case"MissingAppInitError":case"DriftConflictError":case"ControlFlowClassifierError":return r;default:return{kind:"SemanticQueryError",reason:`Unexpected codemod error in validation-gate pipeline: ${r.kind}`}}}u(ae,"narrowGateError");function oe(r,e,m){for(const o of r){if(o.type!=="ImportDeclaration")continue;const a=o.source;if(!(!v(a)||a.type!=="StringLiteral")&&a.value===k){G(o,e);return}}const s=B([e],k,m);r.unshift(s)}u(oe,"ensureFactoryImport");export{ge as addResource};

package/dist/src/codemod/edits/modifyResource.js

@@ -1 +1 @@
-var T=Object.defineProperty;var c=(r,e)=>T(r,"name",{value:e,configurable:!0});import{failure as s,success as m}from"../../types/Result.js";import{DEFAULT_FILE_PATH as A,computeLinesDelta as F,extractProgramBody as L,isRecord as y}from"../_internal.js";import{buildObjectProperty as j,detectQuoteStyle as G,parse as O,printFile as Q}from"../fileRewriter/index.js";import{STATEMENT_REGISTRY as P}from"../registry.js";import{locateAllShapes as U,locateByShape as I}from"../semanticIndex/index.js";import{buildUnmanagedEditRefusal as D}from"./unmanagedShapeErrors.js";import{checkControlFlowPolicy as K}from"./controlFlowPolicy.js";import{driftGate as V,runPipeline as B,schemaGate as _}from"../validationGate/index.js";import{toAstValue as M}from"./addResource/propertyBuilder.js";import{buildMergedLiteral as v,collectPropertyKeys as $,isNodeShape as S,readKeyName as H}from"./modifyResource/literalConversion.js";import{evaluateEmitGuard as w,UNRESOLVED as Y}from"../emitGuard.js";function pe(r,e,t={}){const n=e.filePath??A,a=O(r,n);if(!a.success)return s(a.error);const i=I(r,{type:e.type,name:e.name},n);if(!i.success)return i.error.kind==="TemplateLiteralNameError"?s(i.error):s({kind:"SemanticQueryError",reason:i.error.reason,cause:i.error.cause});if(i.data===void 0)return s({kind:"ResourceNotFoundError",type:e.type,name:e.name,knownNames:Z(r,e.type,n)});if(i.data.managed===!1)return s(D(e.type,"modify"));const o=K({ast:a.data,target:i.data,resource:{type:e.type,name:e.name},op:"modify"});if(o.refusal!==void 0)return s(o.refusal);const u=B([_,V],{content:r,plan:{type:e.type,name:e.name,properties:e.properties,op:"modify"},baseline:t.baseline,policy:e.driftPolicy});if(!u.success)return s(q(u.error));if(u.data.action==="skip")return m({content:r,linesChanged:{added:0,removed:0},skipped:!0});const d=L(a.data);if(d===void 0)return s({kind:"SemanticQueryError",reason:"recast File is missing program.body"});const f=z(d,i.data);if(f===void 0)return s({kind:"SemanticQueryError",reason:"Unable to resolve config ObjectExpression for the located resource."});const N=G(a.data),g=v(f,e.properties),E=P[e.type].emitGuard,R=w(E,C(f,v(f,{}))),p=w(E,C(f,g));if(p!==void 0&&p.property!==R?.property)return s(p);const h=P[e.type].schemaFragment.safeParse(g);if(!h.success){const l=h.error.issues[0];return s({kind:"InvalidPropertyError",property:l!==void 0&&l.path.length>0?String(l.path[0]):Object.keys(e.properties)[0]??"<unknown>",reason:l?.message??"Schema validation failed"})}const k=J(f,e.properties,N);if(!k.success)return s(k.error);const b=Q(a.data,r),x=o.warning!==void 0?[o.warning.message]:void 0;return m({content:b,linesChanged:F(r,b),warnings:x})}c(pe,"modifyResource");function C(r,e){const t={...e};for(const n of $(r))n in t||(t[n]=Y);return t}c(C,"buildGuardView");function q(r){switch(r.kind){case"ParseError":case"ResourceNotFoundError":case"InvalidPropertyError":case"TemplateLiteralNameError":case"SemanticQueryError":case"DriftConflictError":case"ControlFlowClassifierError":return r;default:return{kind:"SemanticQueryError",reason:`Unexpected codemod error in validation-gate pipeline: ${r.kind}`}}}c(q,"narrowGateError");function z(r,e){const t=e.start+e.length;let n;const a=c(i=>{if(n!==void 0||i.type!=="CallExpression")return;const o=i.arguments;if(!Array.isArray(o)||o.length<2)return;const u=o[0];if(!S(u)||u.type!=="StringLiteral"||u.start!==e.start||u.end!==t)return;const d=o[1];S(d)&&d.type==="ObjectExpression"&&(n=d)},"visitor");for(const i of r)if(ee(i,a),n!==void 0)break;return n}c(z,"findConfigObject");function J(r,e,t){const n=X(r);for(const[a,i]of Object.entries(e)){const o=M(i,t);if(o===void 0)return s({kind:"InvalidPropertyError",property:a,reason:`Unsupported property value for "${a}" (accepts string/number/boolean/null/array/object of the same).`});const u=W(r,a);if(u!==void 0){u.value=o;continue}const d=j(a,o,t);n&&(d.extra={...d.extra??{},trailingComma:!0}),r.properties.push(d)}return m(void 0)}c(J,"applyPropertyEdits");function W(r,e){return r.properties.find(t=>(t.type==="Property"||t.type==="ObjectProperty")&&t.shorthand!==!0&&t.computed!==!0&&H(t.key)===e)}c(W,"findPropertyByKey");function X(r){return r.properties[r.properties.length-1]?.extra?.trailingComma===!0}c(X,"detectTrailingCommaStyle");function Z(r,e,t){const n=U(r,t);return n.success?n.data.filter(a=>a.type===e).map(a=>a.symbolName):[]}c(Z,"collectKnownNames");function ee(r,e){const t=[r];for(;t.length>0;){const n=t.pop();if(y(n)){typeof n.type=="string"&&e(n);for(const a of Object.keys(n)){if(a==="loc"||a==="comments"||a==="tokens")continue;const i=n[a];if(Array.isArray(i))for(const o of i)y(o)&&t.push(o);else y(i)&&t.push(i)}}}}c(ee,"visit");export{pe as modifyResource};
+var T=Object.defineProperty;var u=(r,e)=>T(r,"name",{value:e,configurable:!0});import{failure as s,success as y}from"../../types/Result.js";import{DEFAULT_FILE_PATH as A,computeLinesDelta as F,extractProgramBody as L,isRecord as g}from"../_internal.js";import{buildObjectProperty as G,detectQuoteStyle as O,parse as Q,printFile as U}from"../fileRewriter/index.js";import{STATEMENT_REGISTRY as b}from"../registry.js";import{locateAllShapes as I,locateByShape as D}from"../semanticIndex/index.js";import{buildUnmanagedEditRefusal as K}from"./unmanagedShapeErrors.js";import{checkControlFlowPolicy as V}from"./controlFlowPolicy.js";import{driftGate as B,runPipeline as _,schemaGate as M}from"../validationGate/index.js";import{toAstValue as $}from"./addResource/propertyBuilder.js";import{buildMergedLiteral as v,collectPropertyKeys as H,isNodeShape as S,readKeyName as Y}from"./modifyResource/literalConversion.js";import{evaluateEmitGuard as q,UNRESOLVED as z}from"../emitGuard.js";import{projectEmittedProperties as J,projectionRefusal as W}from"../emitProjection.js";function he(r,e,t={}){const n=e.filePath??A,i=Q(r,n);if(!i.success)return s(i.error);const a=D(r,{type:e.type,name:e.name},n);if(!a.success)return a.error.kind==="TemplateLiteralNameError"?s(a.error):s({kind:"SemanticQueryError",reason:a.error.reason,cause:a.error.cause});if(a.data===void 0)return s({kind:"ResourceNotFoundError",type:e.type,name:e.name,knownNames:ne(r,e.type,n)});if(a.data.managed===!1)return s(K(e.type,"modify"));const o=V({ast:i.data,target:a.data,resource:{type:e.type,name:e.name},op:"modify"});if(o.refusal!==void 0)return s(o.refusal);const c=_([M,B],{content:r,plan:{type:e.type,name:e.name,properties:e.properties,op:"modify"},baseline:t.baseline,policy:e.driftPolicy});if(!c.success)return s(X(c.error));if(c.data.action==="skip")return y({content:r,linesChanged:{added:0,removed:0},skipped:!0});const d=L(i.data);if(d===void 0)return s({kind:"SemanticQueryError",reason:"recast File is missing program.body"});const l=Z(d,a.data);if(l===void 0)return s({kind:"SemanticQueryError",reason:"Unable to resolve config ObjectExpression for the located resource."});const R=O(i.data),x=v(l,e.properties),C=b[e.type].emitGuard,E=u(f=>q(C,f)??W(e.type,f),"judge"),N=E(w(l,v(l,{}))),p=E(w(l,x));if(p!==void 0&&p.property!==N?.property)return s(p);const h=b[e.type].schemaFragment.safeParse(e.properties);if(!h.success){const f=h.error.issues[0];return s({kind:"InvalidPropertyError",property:f!==void 0&&f.path.length>0?String(f.path[0]):Object.keys(e.properties)[0]??"<unknown>",reason:f?.message??"Schema validation failed"})}const m=J(e.type,e.properties,{editingExisting:!0});if("refusal"in m)return s(m.refusal);const k=ee(l,m.props,R);if(!k.success)return s(k.error);const P=U(i.data,r),j=o.warning!==void 0?[o.warning.message]:void 0;return y({content:P,linesChanged:F(r,P),warnings:j})}u(he,"modifyResource");function w(r,e){const t={...e};for(const n of H(r))n in t||(t[n]=z);return t}u(w,"buildGuardView");function X(r){switch(r.kind){case"ParseError":case"ResourceNotFoundError":case"InvalidPropertyError":case"TemplateLiteralNameError":case"SemanticQueryError":case"DriftConflictError":case"ControlFlowClassifierError":return r;default:return{kind:"SemanticQueryError",reason:`Unexpected codemod error in validation-gate pipeline: ${r.kind}`}}}u(X,"narrowGateError");function Z(r,e){const t=e.start+e.length;let n;const i=u(a=>{if(n!==void 0||a.type!=="CallExpression")return;const o=a.arguments;if(!Array.isArray(o)||o.length<2)return;const c=o[0];if(!S(c)||c.type!=="StringLiteral"||c.start!==e.start||c.end!==t)return;const d=o[1];S(d)&&d.type==="ObjectExpression"&&(n=d)},"visitor");for(const a of r)if(ie(a,i),n!==void 0)break;return n}u(Z,"findConfigObject");function ee(r,e,t){const n=te(r);for(const{key:i,value:a}of e){const o=$(a,t);if(o===void 0)return s({kind:"InvalidPropertyError",property:i,reason:`Unsupported property value for "${i}" (accepts string/number/boolean/null/array/object of the same).`});const c=re(r,i);if(c!==void 0){c.value=o;continue}const d=G(i,o,t);n&&(d.extra={...d.extra??{},trailingComma:!0}),r.properties.push(d)}return y(void 0)}u(ee,"applyPropertyEdits");function re(r,e){return r.properties.find(t=>(t.type==="Property"||t.type==="ObjectProperty")&&t.shorthand!==!0&&t.computed!==!0&&Y(t.key)===e)}u(re,"findPropertyByKey");function te(r){return r.properties[r.properties.length-1]?.extra?.trailingComma===!0}u(te,"detectTrailingCommaStyle");function ne(r,e,t){const n=I(r,t);return n.success?n.data.filter(i=>i.type===e).map(i=>i.symbolName):[]}u(ne,"collectKnownNames");function ie(r,e){const t=[r];for(;t.length>0;){const n=t.pop();if(g(n)){typeof n.type=="string"&&e(n);for(const i of Object.keys(n)){if(i==="loc"||i==="comments"||i==="tokens")continue;const a=n[i];if(Array.isArray(a))for(const o of a)g(o)&&t.push(o);else g(a)&&t.push(a)}}}}u(ie,"visit");export{he as modifyResource};

package/dist/src/codemod/emitProjection.d.ts

@@ -0,0 +1,29 @@
+import { type ProjectionContext } from "../projection/index.js";
+import { type EmitGuardProperties } from "./emitGuard.js";
+import type { InvalidPropertyError, StatementType } from "./types.js";
+/** One emitted construct prop, resolved to a serialisable value. */
+export interface LiteralProp {
+    key: string;
+    value: unknown;
+}
+/**
+ * The first plan key in `properties` that this type cannot turn into a
+ * construct prop, as the codebase's actionable error shape.
+ *
+ * Values are passed through verbatim, `UNRESOLVED` included: a plan-only key
+ * is inert whatever it holds, which is exactly the presence test the
+ * `silentlyDropped` rules applied.
+ */
+export declare function projectionRefusal(type: StatementType, properties: EmitGuardProperties): InvalidPropertyError | undefined;
+/**
+ * The construct props to write for `properties`, or the refusal that stops
+ * the write.
+ *
+ * A non-projectable type is emitted as it always was — its plan keys go into
+ * the file verbatim and its `emitGuard` is what decides whether that is safe.
+ */
+export declare function projectEmittedProperties(type: StatementType, properties: Readonly<Record<string, unknown>>, context?: ProjectionContext): {
+    props: LiteralProp[];
+} | {
+    refusal: InvalidPropertyError;
+};

package/dist/src/codemod/emitProjection.js

@@ -0,0 +1 @@
+var y=Object.defineProperty;var n=(e,r)=>y(e,"name",{value:r,configurable:!0});import{isProjectableType as u,projectPlanToConstructProps as a}from"../projection/index.js";import{AUTHOR_BY_HAND as p}from"./emitGuard.js";function l(e,r){return{kind:"InvalidPropertyError",property:e,reason:`${r} \`fjall add\` would write it into the factory call and the resource would deploy without it. ${p}`}}n(l,"unprojectableRefusal");function v(e,r){if(!u(e))return;const[t]=a(e,r).unprojectable;if(t!==void 0)return l(t.key,t.reason)}n(v,"projectionRefusal");function h(e,r,t={}){if(!u(e))return{props:Object.entries(r).map(([o,d])=>({key:o,value:d}))};const{props:c,unprojectable:f}=a(e,r,t),[i]=f;if(i!==void 0)return{refusal:l(i.key,i.reason)};const s=[];for(const o of c){if(o.value.kind==="expression")return{refusal:{kind:"InvalidPropertyError",property:o.key,reason:`\`${o.key}\` needs a live construct expression, which this command cannot resolve against a file it did not write. ${p}`}};s.push({key:o.key,value:o.value.value})}return{props:s}}n(h,"projectEmittedProperties");export{h as projectEmittedProperties,v as projectionRefusal};

package/dist/src/codemod/registry.d.ts

@@ -61,13 +61,16 @@ export interface StatementTypeEntry {
      * Property shapes the ADD and MODIFY paths must REFUSE to write, checked
      * before any file is touched. Declared here, beside `emitWrapper`, because
      * `emitWrapper` is precisely what creates the hazard: wrapping makes the
-     * emitted props load-bearing at synth, and the codemod writes resource-PLAN
-     * vocabulary verbatim into a file the constructs read as CONSTRUCT
-     * vocabulary. The generator scaffold has a translation layer for that seam
-     * (`generation/compute/lambda.ts` turns `codePath` into
-     * `Code.fromAsset(...)`); the codemod has none, so where the two
-     * vocabularies disagree the statement either takes the whole app's synth
-     * down or deploys infrastructure that is not what was asked for.
+     * emitted props load-bearing at synth, and the plan and construct
+     * vocabularies disagree.
+     *
+     * ONLY for types the plan→construct projection cannot describe. Where it
+     * can (`src/projection/tables.ts`), the disagreement is TRANSLATED at
+     * emission and no rule belongs here — `emitProjection.ts` reports what is
+     * left from the projection's own `unprojectable` list. What survives is
+     * props needing a live sibling construct (`cdn`'s origin, `compute`'s
+     * connection expansion) and cross-key conditions no per-key table can
+     * state.
      *
      * Rules cover exactly two classes, and nothing else:
      *
@@ -88,9 +91,11 @@ export interface StatementTypeEntry {
      * through (a separate, recorded gap).
      *
      * Absent = every expressible property shape for this type reaches a
-     * synthesising statement. That is a claim, not an oversight: `network`,
-     * `vpc-peer` and `buildkite` each have full plan/construct parity, and the
-     * components-infrastructure materialisation contract pins it.
+     * synthesising statement. That is a claim, not an oversight, and it is now
+     * true two ways: `network` and `buildkite` have outright plan/construct
+     * parity, while `database`, `storage` and `messaging` reach it through the
+     * projection. The components-infrastructure materialisation contract pins
+     * both.
      */
     emitGuard?: ReadonlyArray<EmitGuardRule>;
 }

package/dist/src/codemod/registry.js

@@ -1 +1 @@
-var v=Object.defineProperty;var a=(e,t)=>v(e,"name",{value:t,configurable:!0});import{z as u}from"zod";import{BuildkitePropsObjectSchema as E,CDNResourcePlanSchema as R,ComputeResourcePlanSchema as k,CrossPlanConnectionResourcePlanSchema as T,DatabaseResourcePlanSchema as w,NetworkResourcePlanSchema as A,NextJSPatternConfigSchema as F,OrganisationResourcePlanSchema as N,PayloadPatternConfigSchema as M,S3ResourcePlanSchema as D,SQSResourcePlanSchema as x,StaticSitePatternConfigSchema as G,VpcPeerAccepterResourcePlanSchema as W,VpcPeerResourcePlanSchema as _}from"../schemas/index.js";import{failure as O}from"../types/Result.js";import{isRecord as I}from"./_internal.js";import{AUTHOR_BY_HAND as c,requiresLiveValue as f,silentlyDropped as n,UNRESOLVED as h,whenAbsent as p}from"./emitGuard.js";const r={database:"DatabaseFactory",storage:"StorageFactory",compute:"ComputeFactory",messaging:"MessagingFactory",cdn:"CdnFactory",network:"NetworkFactory",pattern:"PatternFactory","vpc-peer":"VpcPeerFactory","vpc-peer-accepter":"VpcPeerAccepterFactory","cross-plan-connection":"CrossPlanConnectionFactory",organisation:"OrganisationFactory",buildkite:"BuildkiteFactory"};function s(e){const{name:t,...i}=e.shape;return u.object(i).partial().strict()}a(s,"fragmentOf");const B=s(w),j=s(D),q=(()=>{const{name:e,...t}=k.shape;return u.object(t).partial().strict()})(),L=s(x),V=s(R),Y=s(A),K=(()=>{const{name:e,type:t,cdn:i,...b}=M.shape,{name:se,type:ie,cdn:ce,...P}=F.shape,{name:pe,type:de,domain:ue,cdn:S,...C}=G.shape;return u.object({...b,...P,...C,cdn:u.union([i,S])}).partial().strict()})(),U=s(_),z=s(W),H=s(T),Q=s(N),$=s(E);function g(e,t){return O({kind:"SemanticQueryError",reason:`StatementTypeEntry.${e} for ${t} is not wired; existing types dispatch through the shared locator/generator.`})}a(g,"notWiredError");function J(e){return{factoryIdentifier:e,findByShape:a(()=>g("locator.findByShape",e),"findByShape"),validateContext:a(()=>g("locator.validateContext",e),"validateContext")}}a(J,"createLocator");function X(e){return{build:a(()=>{const t=g("generator.build",e);throw new Error(t.success?"unreachable":t.error.reason)},"build")}}a(X,"createGenerator");const m=n("variableName","`variableName` is a plan-only round-trip key naming the `const <var> =` binding the scaffold emits; no construct reads it."),d=n("extraProperties","`extraProperties` is a plan-only round-trip key: the scaffold flattens each `{ key, sourceText }` entry into a sibling property, and no construct reads the array."),Z=[n("engineExpression","`engineExpression` carries a raw CDK engine expression for the scaffold to inline; the construct reads `databaseEngine` instead, so a cluster pinned to `DatabaseClusterEngine.auroraMysql(...)` still deploys as aurora-postgresql."),m,d],ee=[m,d],l="the connection keys are scaffold inputs, not construct props: the scaffold expands them into environment variables and a `connections: [...]` array, and the compute constructs read none of them.",te=[{property:"deployment",refuseWhen:a(e=>(e.type==="lambda"||e.deployment!==void 0)&&e.deployment!=="container"&&e.code!==h,"refuseWhen"),reason:"a code-deployed Lambda requires `code: Code`, a CDK object built by `Code.fromAsset(...)` that no flag value can carry, so the statement takes the whole app's synth down with `Cannot read properties of undefined (reading 'bind')` \u2014 naming no resource. Use `--deployment container`, which is fully expressible, or write this compute in infrastructure.ts by hand."},n("codePath","`codePath` is the scaffold's input to `Code.fromAsset(...)`; no compute construct reads it, and a container Lambda takes its code from the image."),f("runtime","the construct expects a CDK `Runtime`, not a version string, and a container Lambda takes its runtime from the image (`Runtime.FROM_IMAGE`) regardless."),f("architecture","the construct expects a CDK `Architecture`, not a string: `--architecture ARM_64` emits an EMPTY `Architectures` list, whereas omitting the flag emits the correct default."),n("memory","the Lambda construct reads `memorySize`, so `--memory 1024` deploys a function at the 128 MB default."),n("ssmSecrets","the Lambda construct reads `secrets`, so `--ssmSecrets` deploys a function with no SSM wiring and no secrets environment at all."),n("scheduleExpression","`scheduleExpression` is not a compute prop: the scaffold turns it into a SEPARATE `app.addSchedule(...)` statement, which this command cannot emit."),n("needsConnection",l),n("connectedDatabase",l),n("connectedStorage",l),n("connectedMessaging",l),m,d],ae=[{property:"type",refuseWhen:p("type"),reason:"`MessagingFactory.build` selects queue/topic/eventBus from a `type` discriminator that the messaging vocabulary does not carry, so a queue built from messaging properties throws `Unsupported messaging type: undefined` the moment `app.addMessaging` materialises it. "+c},n("retentionPeriod","the queue construct reads `messageRetentionPeriod`, so `--retentionPeriod` deploys a queue at the 4-day default."),m,d],ne=[{property:"originType",refuseWhen:p("originType"),reason:"`Cdn` selects its origin implementation from an `originType` discriminator that the CDN vocabulary does not carry, so a distribution built from CDN properties throws `Unsupported CDN origin type: undefined` the moment `app.addCdn` materialises it. "+c},{property:"originType",refuseWhen:a(e=>e.originType==="s3"&&e.bucket!==h,"refuseWhen"),reason:"an s3 origin needs `bucket` to be an `IBucket` or a Fjall `Storage` \u2014 a live construct, not a name, and not a string; omitting it throws `Cannot read properties of undefined (reading 'bucketRegionalDomainName')` at synth. "+c},{property:"originType",refuseWhen:a(e=>e.originType==="alb"&&e.loadBalancer!==h,"refuseWhen"),reason:'an alb origin needs `loadBalancer` to be an `IApplicationLoadBalancer` or an ECS compute \u2014 a live construct, not a name, and not a string; a string reaches CloudFormation as `Supplied properties not correct for "OriginProperty"`. '+c},{property:"behaviours",refuseWhen:a(e=>Array.isArray(e.behaviours)&&e.behaviours.some(t=>I(t)&&t.originRef!==void 0),"refuseWhen"),reason:"the plan's `behaviours[].originRef` names another planned resource, while the construct's behaviour takes a live origin object; the plan shape throws `Cannot read properties of undefined (reading 'computeType')` at synth. "+c},n("customDomain","the distribution reads `domainNames`, so `--customDomain` deploys a distribution with no alias."),n("defaultOriginRef","`defaultOriginRef` names another planned resource for the scaffold to resolve into a live origin; no CDN construct reads it."),d],re=[{property:"name",refuseWhen:p("name"),reason:"every pattern construct requires a `name` PROPERTY in addition to its construct id, and `fjall add --name` binds the construct id, so no invocation can deliver it \u2014 `toPascalCase(props.name)` throws at synth and takes the whole app down. "+c},{property:"type",refuseWhen:p("type"),reason:"`PatternFactory.build` reads `PATTERN_REGISTRY[props.type]` before it even returns the thunk, and the pattern vocabulary carries no `type` discriminator. "+c}],oe=[{property:"peerAppName",refuseWhen:p("peerAppName"),reason:"`peerAppName` is required: it is the SSM prefix every remote lookup is built from, and omitting it does NOT fail \u2014 synth succeeds and the app deploys a peering connection pointed at `/fjall/default/undefined/vpc-id`. Pass `--peerAppName <remote app>`."},{property:"peerAccountId",refuseWhen:p("peerAccountId"),reason:"`peerAccountId` is required: omitting it does NOT fail, it deploys a VPC peering connection with no `PeerOwnerId`. Pass `--peerAccountId <12-digit account>`."}];function o(e,t,i={}){return{factoryIdentifier:e,locator:J(e),generator:X(e),schemaFragment:t,...i}}a(o,"createEntry");const y={database:o(r.database,B,{emitWrapper:{appMethod:"addDatabase"},emitGuard:Z}),storage:o(r.storage,j,{emitWrapper:{appMethod:"addStorage"},emitGuard:ee}),compute:o(r.compute,q,{emitWrapper:{appMethod:"addCompute"},emitGuard:te}),messaging:o(r.messaging,L,{emitWrapper:{appMethod:"addMessaging"},emitGuard:ae}),cdn:o(r.cdn,V,{emitWrapper:{appMethod:"addCdn"},emitGuard:ne}),network:o(r.network,Y,{emitWrapper:{appMethod:"addNetwork"}}),pattern:o(r.pattern,K,{emitWrapper:{appMethod:"addPattern"},emitGuard:re}),"vpc-peer":o(r["vpc-peer"],U,{emitWrapper:{appMethod:"addVpcPeer"},emitGuard:oe}),"vpc-peer-accepter":o(r["vpc-peer-accepter"],z,{emitWrapper:{appMethod:"addVpcPeerAccepter"}}),"cross-plan-connection":o(r["cross-plan-connection"],H),organisation:o(r.organisation,Q),buildkite:o(r.buildkite,$,{emitWrapper:{appMethod:"addBuildkite",propsOverloadConstructId:"Buildkite"}})},be=Object.keys(y);function Pe(e){const t=Object.keys(y);for(const i of t)if(y[i].factoryIdentifier===e)return i}a(Pe,"findTypeByIdentifier");export{be as REGISTERED_STATEMENT_TYPES,y as STATEMENT_REGISTRY,Pe as findTypeByIdentifier};
+var C=Object.defineProperty;var n=(e,t)=>C(e,"name",{value:t,configurable:!0});import{z as d}from"zod";import{BuildkitePropsObjectSchema as v,CDNResourcePlanSchema as R,ComputeResourcePlanSchema as k,CrossPlanConnectionResourcePlanSchema as T,DatabaseResourcePlanSchema as A,NetworkResourcePlanSchema as E,NextJSPatternConfigSchema as w,OrganisationResourcePlanSchema as F,PayloadPatternConfigSchema as N,S3ResourcePlanSchema as M,SQSResourcePlanSchema as D,StaticSitePatternConfigSchema as _,VpcPeerAccepterResourcePlanSchema as O,VpcPeerResourcePlanSchema as W}from"../schemas/index.js";import{failure as x}from"../types/Result.js";import{isRecord as G}from"./_internal.js";import{AUTHOR_BY_HAND as c,requiresLiveValue as g,silentlyDropped as a,UNRESOLVED as m,whenAbsent as p}from"./emitGuard.js";const r={database:"DatabaseFactory",storage:"StorageFactory",compute:"ComputeFactory",messaging:"MessagingFactory",cdn:"CdnFactory",network:"NetworkFactory",pattern:"PatternFactory","vpc-peer":"VpcPeerFactory","vpc-peer-accepter":"VpcPeerAccepterFactory","cross-plan-connection":"CrossPlanConnectionFactory",organisation:"OrganisationFactory",buildkite:"BuildkiteFactory"};function s(e){const{name:t,...i}=e.shape;return d.object(i).partial().strict()}n(s,"fragmentOf");const I=s(A),B=s(M),j=(()=>{const{name:e,...t}=k.shape;return d.object(t).partial().strict()})(),L=s(D),V=s(R),Y=s(E),q=(()=>{const{name:e,type:t,cdn:i,...f}=N.shape,{name:ae,type:re,cdn:oe,...b}=w.shape,{name:se,type:ie,domain:ce,cdn:S,...P}=_.shape;return d.object({...f,...b,...P,cdn:d.union([i,S])}).partial().strict()})(),K=s(W),U=s(O),z=s(T),H=s(F),Q=s(v);function l(e,t){return x({kind:"SemanticQueryError",reason:`StatementTypeEntry.${e} for ${t} is not wired; existing types dispatch through the shared locator/generator.`})}n(l,"notWiredError");function $(e){return{factoryIdentifier:e,findByShape:n(()=>l("locator.findByShape",e),"findByShape"),validateContext:n(()=>l("locator.validateContext",e),"validateContext")}}n($,"createLocator");function J(e){return{build:n(()=>{const t=l("generator.build",e);throw new Error(t.success?"unreachable":t.error.reason)},"build")}}n(J,"createGenerator");const X=a("variableName","`variableName` is a plan-only round-trip key naming the `const <var> =` binding the scaffold emits; no construct reads it."),y=a("extraProperties","`extraProperties` is a plan-only round-trip key: the scaffold flattens each `{ key, sourceText }` entry into a sibling property, and no construct reads the array."),u="the connection keys are scaffold inputs, not construct props: the scaffold expands them into environment variables and a `connections: [...]` array, and the compute constructs read none of them.",Z=[{property:"deployment",refuseWhen:n(e=>(e.type==="lambda"||e.deployment!==void 0)&&e.deployment!=="container"&&e.code!==m,"refuseWhen"),reason:"a code-deployed Lambda requires `code: Code`, a CDK object built by `Code.fromAsset(...)` that no flag value can carry, so the statement takes the whole app's synth down with `Cannot read properties of undefined (reading 'bind')` \u2014 naming no resource. Use `--deployment container`, which is fully expressible, or write this compute in infrastructure.ts by hand."},a("codePath","`codePath` is the scaffold's input to `Code.fromAsset(...)`; no compute construct reads it, and a container Lambda takes its code from the image."),g("runtime","the construct expects a CDK `Runtime`, not a version string, and a container Lambda takes its runtime from the image (`Runtime.FROM_IMAGE`) regardless."),g("architecture","the construct expects a CDK `Architecture`, not a string: `--architecture ARM_64` emits an EMPTY `Architectures` list, whereas omitting the flag emits the correct default."),a("memory","the Lambda construct reads `memorySize`, so `--memory 1024` deploys a function at the 128 MB default."),a("ssmSecrets","the Lambda construct reads `secrets`, so `--ssmSecrets` deploys a function with no SSM wiring and no secrets environment at all."),a("scheduleExpression","`scheduleExpression` is not a compute prop: the scaffold turns it into a SEPARATE `app.addSchedule(...)` statement, which this command cannot emit."),a("needsConnection",u),a("connectedDatabase",u),a("connectedStorage",u),a("connectedMessaging",u),X,y],ee=[{property:"originType",refuseWhen:p("originType"),reason:"`Cdn` selects its origin implementation from an `originType` discriminator that the CDN vocabulary does not carry, so a distribution built from CDN properties throws `Unsupported CDN origin type: undefined` the moment `app.addCdn` materialises it. "+c},{property:"originType",refuseWhen:n(e=>e.originType==="s3"&&e.bucket!==m,"refuseWhen"),reason:"an s3 origin needs `bucket` to be an `IBucket` or a Fjall `Storage` \u2014 a live construct, not a name, and not a string; omitting it throws `Cannot read properties of undefined (reading 'bucketRegionalDomainName')` at synth. "+c},{property:"originType",refuseWhen:n(e=>e.originType==="alb"&&e.loadBalancer!==m,"refuseWhen"),reason:'an alb origin needs `loadBalancer` to be an `IApplicationLoadBalancer` or an ECS compute \u2014 a live construct, not a name, and not a string; a string reaches CloudFormation as `Supplied properties not correct for "OriginProperty"`. '+c},{property:"behaviours",refuseWhen:n(e=>Array.isArray(e.behaviours)&&e.behaviours.some(t=>G(t)&&t.originRef!==void 0),"refuseWhen"),reason:"the plan's `behaviours[].originRef` names another planned resource, while the construct's behaviour takes a live origin object; the plan shape throws `Cannot read properties of undefined (reading 'computeType')` at synth. "+c},a("customDomain","the distribution reads `domainNames`, so `--customDomain` deploys a distribution with no alias."),a("defaultOriginRef","`defaultOriginRef` names another planned resource for the scaffold to resolve into a live origin; no CDN construct reads it."),y],te=[{property:"name",refuseWhen:p("name"),reason:"every pattern construct requires a `name` PROPERTY in addition to its construct id, and `fjall add --name` binds the construct id, so no invocation can deliver it \u2014 `toPascalCase(props.name)` throws at synth and takes the whole app down. "+c},{property:"type",refuseWhen:p("type"),reason:"`PatternFactory.build` reads `PATTERN_REGISTRY[props.type]` before it even returns the thunk, and the pattern vocabulary carries no `type` discriminator. "+c}],ne=[{property:"peerAppName",refuseWhen:p("peerAppName"),reason:"`peerAppName` is required: it is the SSM prefix every remote lookup is built from, and omitting it does NOT fail \u2014 synth succeeds and the app deploys a peering connection pointed at `/fjall/default/undefined/vpc-id`. Pass `--peerAppName <remote app>`."},{property:"peerAccountId",refuseWhen:p("peerAccountId"),reason:"`peerAccountId` is required: omitting it does NOT fail, it deploys a VPC peering connection with no `PeerOwnerId`. Pass `--peerAccountId <12-digit account>`."}];function o(e,t,i={}){return{factoryIdentifier:e,locator:$(e),generator:J(e),schemaFragment:t,...i}}n(o,"createEntry");const h={database:o(r.database,I,{emitWrapper:{appMethod:"addDatabase"}}),storage:o(r.storage,B,{emitWrapper:{appMethod:"addStorage"}}),compute:o(r.compute,j,{emitWrapper:{appMethod:"addCompute"},emitGuard:Z}),messaging:o(r.messaging,L,{emitWrapper:{appMethod:"addMessaging"}}),cdn:o(r.cdn,V,{emitWrapper:{appMethod:"addCdn"},emitGuard:ee}),network:o(r.network,Y,{emitWrapper:{appMethod:"addNetwork"}}),pattern:o(r.pattern,q,{emitWrapper:{appMethod:"addPattern"},emitGuard:te}),"vpc-peer":o(r["vpc-peer"],K,{emitWrapper:{appMethod:"addVpcPeer"},emitGuard:ne}),"vpc-peer-accepter":o(r["vpc-peer-accepter"],U,{emitWrapper:{appMethod:"addVpcPeerAccepter"}}),"cross-plan-connection":o(r["cross-plan-connection"],z),organisation:o(r.organisation,H),buildkite:o(r.buildkite,Q,{emitWrapper:{appMethod:"addBuildkite",propsOverloadConstructId:"Buildkite"}})},ge=Object.keys(h);function ye(e){const t=Object.keys(h);for(const i of t)if(h[i].factoryIdentifier===e)return i}n(ye,"findTypeByIdentifier");export{ge as REGISTERED_STATEMENT_TYPES,h as STATEMENT_REGISTRY,ye as findTypeByIdentifier};

package/dist/src/generation/common.d.ts

@@ -3,6 +3,7 @@
  *
  * Shared helper functions used across all generation modules.
  */
+import type { ProjectedProp } from "../projection/types.js";
 import type { IdentifierValue, ExpressionValue, CallValue, SpecialValue } from "../schemas/resourceSchemas.js";
 export type { IdentifierValue, ExpressionValue, CallValue, SpecialValue };
 export { toPascalCase, toKebab, toValidDatabaseName } from "@fjall/util";
@@ -76,6 +77,12 @@ export declare function resolveResourceVariable(plan: {
  * Simple objects (few primitive values) are kept on one line.
  */
 export declare function formatValue(value: unknown, baseIndent?: string): string;
+/**
+ * Render projected construct props as the body of an object literal —
+ * `\n<indent>key: value` per prop, comma-separated, no trailing comma. The
+ * caller supplies the surrounding braces and whatever it appends after.
+ */
+export declare function emitProjectedProps(props: ReadonlyArray<ProjectedProp>, indent?: string): string;
 type PropertyFormat = "raw" | "string" | "object" | "boolean-or-object";
 /**
  * Build a property string for code generation.

package/dist/src/generation/common.js

@@ -1,7 +1,8 @@
-var b=Object.defineProperty;var n=(r,e)=>b(r,"name",{value:e,configurable:!0});import{toPascalCase as O,toKebab as T,toValidDatabaseName as h}from"@fjall/util";function c(r){return JSON.stringify(r)}n(c,"escapeStringLiteral");function y(r){return r.map(c).join(", ")}n(y,"formatStringArray");const u="import:SharedAlarmTopicArn";function _(r="    "){return`
-${r}...(getConfig().environment === "production" ? { alertsTopic: ${c(u)} } : {}),`}n(_,"emitProductionAlertsTopicSpread");function l(r){if(typeof r!="object"||r===null)return!1;const e=r;return typeof e.__identifier=="string"||typeof e.__expression=="string"||typeof e.__call=="string"}n(l,"isSpecialValue");function p(r){return r.replace(/[^a-zA-Z0-9]/g," ").split(" ").map((e,t)=>t===0?e.charAt(0).toLowerCase()+e.slice(1):e.charAt(0).toUpperCase()+e.slice(1)).join("")}n(p,"toVariableName");function x(r){return r.variableName??p(r.name)}n(x,"getVariableName");function $(r,e){for(const t of r.database)if(t.name===e&&t.variableName)return t.variableName;for(const t of r.s3)if(t.name===e&&t.variableName)return t.variableName;for(const t of r.compute)if(t.name===e&&t.variableName)return t.variableName;for(const t of r.dynamodb??[])if(t.name===e&&t.variableName)return t.variableName;for(const t of r.sqs??[])if(t.name===e&&t.variableName)return t.variableName;return p(e)}n($,"resolveResourceVariable");function d(r){const e=Object.entries(r);return e.length===0?!0:e.length>1?!1:e.every(([,t])=>typeof t=="string"||typeof t=="number"||typeof t=="boolean"||t===null)}n(d,"isSimpleObject");function f(r,e="    "){if(r==null)return"undefined";if(typeof r=="string")return JSON.stringify(r);if(typeof r=="number"||typeof r=="boolean")return String(r);if(l(r)){if("__identifier"in r)return r.__identifier;if("__expression"in r)return r.__expression;if("__call"in r)return r.__call}if(Array.isArray(r))return`[${r.map(t=>f(t,e)).join(", ")}]`;if(typeof r=="object"){const t=Object.entries(r).filter(([,o])=>o!==void 0);if(d(r)){const o=t.map(([s,m])=>`${s}: ${f(m,e)}`).join(", ");return o?`{ ${o} }`:"{}"}const a=e+"  ",i=t.map(([o,s])=>`${a}${o}: ${f(s,a)}`).join(`,
+var u=Object.defineProperty;var n=(e,t)=>u(e,"name",{value:t,configurable:!0});import{toPascalCase as P,toKebab as T,toValidDatabaseName as h}from"@fjall/util";function c(e){return JSON.stringify(e)}n(c,"escapeStringLiteral");function g(e){return e.map(c).join(", ")}n(g,"formatStringArray");const b="import:SharedAlarmTopicArn";function _(e="    "){return`
+${e}...(getConfig().environment === "production" ? { alertsTopic: ${c(b)} } : {}),`}n(_,"emitProductionAlertsTopicSpread");function l(e){if(typeof e!="object"||e===null)return!1;const t=e;return typeof t.__identifier=="string"||typeof t.__expression=="string"||typeof t.__call=="string"}n(l,"isSpecialValue");function m(e){return e.replace(/[^a-zA-Z0-9]/g," ").split(" ").map((t,r)=>r===0?t.charAt(0).toLowerCase()+t.slice(1):t.charAt(0).toUpperCase()+t.slice(1)).join("")}n(m,"toVariableName");function $(e){return e.variableName??m(e.name)}n($,"getVariableName");function x(e,t){for(const r of e.database)if(r.name===t&&r.variableName)return r.variableName;for(const r of e.s3)if(r.name===t&&r.variableName)return r.variableName;for(const r of e.compute)if(r.name===t&&r.variableName)return r.variableName;for(const r of e.dynamodb??[])if(r.name===t&&r.variableName)return r.variableName;for(const r of e.sqs??[])if(r.name===t&&r.variableName)return r.variableName;return m(t)}n(x,"resolveResourceVariable");function d(e){const t=Object.entries(e);return t.length===0?!0:t.length>1?!1:t.every(([,r])=>typeof r=="string"||typeof r=="number"||typeof r=="boolean"||r===null)}n(d,"isSimpleObject");function f(e,t="    "){if(e==null)return"undefined";if(typeof e=="string")return JSON.stringify(e);if(typeof e=="number"||typeof e=="boolean")return String(e);if(l(e)){if("__identifier"in e)return e.__identifier;if("__expression"in e)return e.__expression;if("__call"in e)return e.__call}if(Array.isArray(e))return`[${e.map(r=>f(r,t)).join(", ")}]`;if(typeof e=="object"){const r=Object.entries(e).filter(([,a])=>a!==void 0);if(d(e)){const a=r.map(([s,p])=>`${s}: ${f(p,t)}`).join(", ");return a?`{ ${a} }`:"{}"}const o=t+"  ",i=r.map(([a,s])=>`${o}${a}: ${f(s,o)}`).join(`,
 `);return i?`{
 ${i}
-${e}}`:"{}"}return JSON.stringify(r)}n(f,"formatValue");function j(r,e,t,a="raw"){if(!r)return"";let i;switch(a){case"string":i=c(String(t));break;case"object":i=f(t);break;case"boolean-or-object":i=t===!1?"false":f(t);break;default:i=String(t)}return`
-    ${e}: ${i},`}n(j,"buildProperty");function N(r,e="    "){return r?.length?r.map(t=>`
-${e}${t.key}: ${t.sourceText},`).join(""):""}n(N,"emitExtraProperties");export{u as PRODUCTION_ALERTS_TOPIC_IMPORT,j as buildProperty,N as emitExtraProperties,_ as emitProductionAlertsTopicSpread,c as escapeStringLiteral,y as formatStringArray,f as formatValue,x as getVariableName,l as isSpecialValue,$ as resolveResourceVariable,T as toKebab,O as toPascalCase,h as toValidDatabaseName,p as toVariableName};
+${t}}`:"{}"}return JSON.stringify(e)}n(f,"formatValue");function j(e,t="    "){return e.map(r=>{const o=r.value.kind==="expression"?r.value.source:f(r.value.value,t);return`
+${t}${r.key}: ${o}`}).join(",")}n(j,"emitProjectedProps");function N(e,t,r,o="raw"){if(!e)return"";let i;switch(o){case"string":i=c(String(r));break;case"object":i=f(r);break;case"boolean-or-object":i=r===!1?"false":f(r);break;default:i=String(r)}return`
+    ${t}: ${i},`}n(N,"buildProperty");function S(e,t="    "){return e?.length?e.map(r=>`
+${t}${r.key}: ${r.sourceText},`).join(""):""}n(S,"emitExtraProperties");export{b as PRODUCTION_ALERTS_TOPIC_IMPORT,N as buildProperty,S as emitExtraProperties,_ as emitProductionAlertsTopicSpread,j as emitProjectedProps,c as escapeStringLiteral,g as formatStringArray,f as formatValue,$ as getVariableName,l as isSpecialValue,x as resolveResourceVariable,T as toKebab,P as toPascalCase,h as toValidDatabaseName,m as toVariableName};

package/dist/src/generation/storage.js

@@ -1,50 +1,44 @@
-var g=Object.defineProperty;var s=(e,t)=>g(e,"name",{value:t,configurable:!0});import{buildProperty as o,getVariableName as u,emitExtraProperties as l,emitProductionAlertsTopicSpread as $,escapeStringLiteral as r}from"./common.js";function b(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}s(b,"generateS3BucketProps");function x(e,t){return!!(t.compute.some(i=>i.connectedStorage?.includes(e.name))||t.cdn&&(t.cdn.defaultOriginRef===e.name||t.cdn.behaviours?.some(i=>i.originRef===e.name)))}s(x,"s3NeedsVariable");function h(e){if(e.s3.length===0)return"";let t="";for(let n=0;n<e.s3.length;n++){const i=e.s3[n],d=u(i),a=x(i,e),m=e.database.length>0||n>0?`
-`:"",y=b(i),f=a?`const ${d} = `:"",p=l(i.extraProperties);y||p?t+=`${m}${f}app.addStorage(
-  StorageFactory.build(${r(i.name)}, {${y}${p}
+var g=Object.defineProperty;var s=(e,t)=>g(e,"name",{value:t,configurable:!0});import{projectPlanToConstructProps as $}from"../projection/index.js";import{buildProperty as i,getVariableName as m,emitExtraProperties as u,emitProductionAlertsTopicSpread as b,emitProjectedProps as P,escapeStringLiteral as o}from"./common.js";function x(e){let t="";return t+=i(e.bucketName!==void 0,"bucketName",e.bucketName,"string"),t+=i(e.stackPlacement!==void 0&&e.stackPlacement!=="storage","stackPlacement",e.stackPlacement,"string"),t+=i(e.publicReadAccess===!0,"publicReadAccess",!0),t+=i(e.websiteHosting!==void 0,"websiteHosting",e.websiteHosting,"object"),t+=i(e.backupVaultTier!==void 0,"backupVaultTier",e.backupVaultTier,"string"),t+=i(e.versioned!==void 0,"versioned",e.versioned),t+=i(e.encryption!==void 0,"encryption",e.encryption,"string"),t+=i(e.kmsKeyArn!==void 0,"kmsKeyArn",e.kmsKeyArn,"string"),t+=i(e.cors!==void 0&&e.cors.length>0,"cors",e.cors,"object"),t+=i(e.deployment!==void 0,"deployment",e.deployment,"object"),t+=i(e.retain===!0,"retain",!0),t}s(x,"generateS3BucketProps");function K(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)))}s(K,"s3NeedsVariable");function R(e){if(e.s3.length===0)return"";let t="";for(let n=0;n<e.s3.length;n++){const r=e.s3[n],c=m(r),a=K(r,e),l=e.database.length>0||n>0?`
+`:"",p=x(r),y=a?`const ${c} = `:"",f=u(r.extraProperties);p||f?t+=`${l}${y}app.addStorage(
+  StorageFactory.build(${o(r.name)}, {${p}${f}
   })
 );
-`:t+=`${m}${f}app.addStorage(
-  StorageFactory.build(${r(i.name)}, {})
+`:t+=`${l}${y}app.addStorage(
+  StorageFactory.build(${o(r.name)}, {})
 );
-`}return t}s(h,"generateS3Code");function N(e){if(!e.dynamodb||e.dynamodb.length===0)return"";let t="";for(const n of e.dynamodb){const i=u(n);if(t+=`
-const ${i} = app.addDatabase(
-  DatabaseFactory.build(${r(n.name)}, {
+`}return t}s(R,"generateS3Code");function T(e){if(!e.dynamodb||e.dynamodb.length===0)return"";let t="";for(const n of e.dynamodb){const r=m(n);if(t+=`
+const ${r} = app.addDatabase(
+  DatabaseFactory.build(${o(n.name)}, {
     type: "DynamoDB",
     partitionKey: {
-      name: ${r(n.partitionKey.name)},
-      type: ${r(n.partitionKey.type)},
+      name: ${o(n.partitionKey.name)},
+      type: ${o(n.partitionKey.type)},
     }`,n.sortKey&&(t+=`,
     sortKey: {
-      name: ${r(n.sortKey.name)},
-      type: ${r(n.sortKey.type)},
-    }`),n.globalSecondaryIndexes&&n.globalSecondaryIndexes.length>0){const d=n.globalSecondaryIndexes.map(a=>{let c=`{
-        indexName: ${r(a.indexName)},
+      name: ${o(n.sortKey.name)},
+      type: ${o(n.sortKey.type)},
+    }`),n.globalSecondaryIndexes&&n.globalSecondaryIndexes.length>0){const c=n.globalSecondaryIndexes.map(a=>{let d=`{
+        indexName: ${o(a.indexName)},
         partitionKey: {
-          name: ${r(a.partitionKey.name)},
-          type: ${r(a.partitionKey.type)},
-        },`;return a.sortKey&&(c+=`
+          name: ${o(a.partitionKey.name)},
+          type: ${o(a.partitionKey.type)},
+        },`;return a.sortKey&&(d+=`
         sortKey: {
-          name: ${r(a.sortKey.name)},
-          type: ${r(a.sortKey.type)},
-        },`),c+=`
-      }`,c}).join(`,
+          name: ${o(a.sortKey.name)},
+          type: ${o(a.sortKey.type)},
+        },`),d+=`
+      }`,d}).join(`,
       `);t+=`,
     globalSecondaryIndexes: [
-      ${d}
+      ${c}
     ]`}n.ttlAttribute&&(t+=`,
-    ttlAttribute: ${r(n.ttlAttribute)}`),n.stream&&(t+=`,
-    stream: true`),t+=l(n.extraProperties),t+=`
+    ttlAttribute: ${o(n.ttlAttribute)}`),n.stream&&(t+=`,
+    stream: true`),t+=u(n.extraProperties),t+=`
   })
 );
-`}return t}s(N,"generateDynamoDBCode");function P(e,t){return t.compute.some(n=>n.connectedMessaging?.includes(e.name))}s(P,"sqsNeedsVariable");function v(e){if(!e.sqs||e.sqs.length===0)return"";let t="";for(const n of e.sqs){const i=u(n),a=P(n,e)?`const ${i} = `:"";t+=`
+`}return t}s(T,"generateDynamoDBCode");function S(e,t){return t.compute.some(n=>n.connectedMessaging?.includes(e.name))}s(S,"sqsNeedsVariable");function V(e){if(!e.sqs||e.sqs.length===0)return"";let t="";for(const n of e.sqs){const r=m(n),a=S(n,e)?`const ${r} = `:"",{props:d}=$("messaging",{queueType:n.queueType,visibilityTimeout:n.visibilityTimeout,retentionPeriod:n.retentionPeriod,...n.contentBasedDeduplication===!0&&{contentBasedDeduplication:!0},removalPolicy:n.removalPolicy});t+=`
 ${a}app.addMessaging(
-  MessagingFactory.build(${r(n.name)}, {
-    type: "queue",
-    queueType: ${r(n.queueType)}`,n.visibilityTimeout!==void 0&&(t+=`,
-    visibilityTimeout: ${n.visibilityTimeout}`),n.retentionPeriod!==void 0&&(t+=`,
-    messageRetentionPeriod: ${n.retentionPeriod}`),n.contentBasedDeduplication&&(t+=`,
-    contentBasedDeduplication: true`),n.removalPolicy!==void 0&&(t+=`,
-    removalPolicy: ${r(n.removalPolicy)}`),t+=",",t+=l(n.extraProperties),t+=$(),t+=`
+  MessagingFactory.build(${o(n.name)}, {${P(d)}`,t+=",",t+=u(n.extraProperties),t+=b(),t+=`
   })
 );
-`}return t}s(v,"generateSQSCode");export{N as generateDynamoDBCode,h as generateS3Code,v as generateSQSCode,x as s3NeedsVariable,P as sqsNeedsVariable};
+`}return t}s(V,"generateSQSCode");export{T as generateDynamoDBCode,R as generateS3Code,V as generateSQSCode,K as s3NeedsVariable,S as sqsNeedsVariable};

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

@@ -1,4 +1,4 @@
-export { planApplicationResources, toUserServiceConfigs, type GenerationOptions, generateInfrastructureFromPlan, } from "./resourcePlanning.js";
+export { planApplicationResources, planServiceFromTierPreset, toUserServiceConfigs, type GenerationOptions, generateInfrastructureFromPlan, } from "./resourcePlanning.js";
 export { type OpenNextResourceOptions, planOpenNextResources, } from "./openNextPlanning.js";
 export { type StaticSiteResourceOptions, planStaticSiteResources, } from "./staticSitePlanning.js";
 export { type ConnectionType, applyComputeConnections, applyServiceConnections, } from "./resourceConnections.js";

package/dist/src/planning/index.js

@@ -1 +1 @@
-import{planApplicationResources as r,toUserServiceConfigs as t,generateInfrastructureFromPlan as n}from"./resourcePlanning.js";import{planOpenNextResources as p}from"./openNextPlanning.js";import{planStaticSiteResources as c}from"./staticSitePlanning.js";import{applyComputeConnections as l,applyServiceConnections as u}from"./resourceConnections.js";import{addResourceToPlan as m,validateResourceAddition as x,listAvailableResources as R}from"./resourceAddition.js";import{generateResourceChange as C}from"./generateResourceChange.js";export{m as addResourceToPlan,l as applyComputeConnections,u as applyServiceConnections,n as generateInfrastructureFromPlan,C as generateResourceChange,R as listAvailableResources,r as planApplicationResources,p as planOpenNextResources,c as planStaticSiteResources,t as toUserServiceConfigs,x as validateResourceAddition};
+import{planApplicationResources as o,planServiceFromTierPreset as t,toUserServiceConfigs as n,generateInfrastructureFromPlan as a}from"./resourcePlanning.js";import{planOpenNextResources as s}from"./openNextPlanning.js";import{planStaticSiteResources as c}from"./staticSitePlanning.js";import{applyComputeConnections as u,applyServiceConnections as m}from"./resourceConnections.js";import{addResourceToPlan as x,validateResourceAddition as R,listAvailableResources as d}from"./resourceAddition.js";import{generateResourceChange as C}from"./generateResourceChange.js";export{x as addResourceToPlan,u as applyComputeConnections,m as applyServiceConnections,a as generateInfrastructureFromPlan,C as generateResourceChange,d as listAvailableResources,o as planApplicationResources,s as planOpenNextResources,t as planServiceFromTierPreset,c as planStaticSiteResources,n as toUserServiceConfigs,R as validateResourceAddition};

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

@@ -1,6 +1,6 @@
-import { type UserServiceConfig, type AppType } from "../presets/tierPresets.js";
+import { type TierEcsServiceConfig, type UserServiceConfig, type AppType } from "../presets/tierPresets.js";
 import { type Result } from "../types/Result.js";
-import type { ApplicationResourcePlan } from "../schemas/resourceSchemas.js";
+import type { ApplicationResourcePlan, EcsServiceConfig } from "../schemas/resourceSchemas.js";
 import type { ApplicationServiceConfig } from "../schemas/computeSchemas.js";
 /**
  * Adapt the wire-level service config (`ApplicationServiceConfig`, validated by
@@ -14,6 +14,18 @@ export declare function planApplicationResources(appName: string, appType: AppTy
     snapshotIdentifier?: string;
     snapshotUsername?: string;
 }): ApplicationResourcePlan;
+/**
+ * The one translation from a tier preset's service entry to the plan shape.
+ *
+ * The two differ in exactly one place: the preset carries `minCapacity` /
+ * `maxCapacity` flat, the plan nests them under `scaling`. Every other key
+ * passes through, so a new preset field reaches the plan without touching this
+ * function. Exported because anything deriving a plan from a tier — the app
+ * planner below, the dogfood deploy-test suites — must apply the same rule, and
+ * a second copy of it would drift silently: an unnested `minCapacity` is an
+ * excess property the plan schema rejects only at parse time.
+ */
+export declare function planServiceFromTierPreset(tierService: TierEcsServiceConfig): EcsServiceConfig;
 export interface GenerationOptions {
     /** Resource name mapping from old names to new names (for custom code repositioning) */
     resourceMapping?: Map<string, string>;

package/dist/src/planning/resourcePlanning.js

@@ -1 +1 @@
-var b=Object.defineProperty;var a=(e,n)=>b(e,"name",{value:n,configurable:!0});import{TIER_PRESETS as l,getDefaultDatabaseTypeForTier as k,applyTierDefaultsToServices as P}from"../presets/tierPresets.js";import{COMPUTE_TYPE as D,DEFAULT_CONTAINER_PORT as T}from"../schemas/constants.js";import{success as f,failure as h}from"../types/Result.js";import{injectCustomCodeBlocks as p}from"../ast/mutation/astCodeInjection.js";import{toVariableName as m,toValidDatabaseName as v,generateImports as E,generateAppInit as R,generateTags as S,generateNetworkCode as C,generateDatabaseCode as y,generateClickHouseCode as I,generateS3Code as w,generateDynamoDBCode as A,generateSQSCode as B,generateComputeCode as U,generateCDNCode as x,collectCdnReferencedResources as j,usesPatternApproach as _,generatePatternCodeWithComments as $}from"../generation/index.js";function G(e){return e?.map(n=>({name:n.name,...n.serviceType!==void 0&&{serviceType:n.serviceType},...n.docker!==void 0&&{docker:n.docker},...n.containerPort!==void 0&&{containerPort:n.containerPort},...n.needsDatabaseConnection!==void 0&&{needsDatabaseConnection:n.needsDatabaseConnection},...n.routing!==void 0&&{routing:n.routing}}))}a(G,"toUserServiceConfigs");function J(e,n,r=!0,c,t){const i={appName:e,type:n,database:[],s3:[],compute:[]};if(n==="custom")return i;const s=n,o=l[s];return{...i,database:F(e,o,s,r,t),compute:V(e,o,s,r,c),network:o.network,backup:o.backup}}a(J,"planApplicationResources");function F(e,n,r,c,t){const i=k(r),s=n.database[i];return!c||s===null?[]:[{name:e,type:i,databaseName:v(e),variableName:`${m(e)}Database`,...s,...t?.snapshotIdentifier!==void 0&&{snapshotIdentifier:t.snapshotIdentifier},...t?.snapshotUsername!==void 0&&{snapshotUsername:t.snapshotUsername}}]}a(F,"buildDatabasePlan");function N(e,n){if(!(e===void 0&&n===void 0))return{scaling:{...e!==void 0&&{minCapacity:e},...n!==void 0&&{maxCapacity:n}}}}a(N,"buildScalingConfig");function H(e,n){const{minCapacity:r,maxCapacity:c,...t}=e,i=n?.serviceType==="worker",s=n?.containerPort??T,o=n?.docker;return{...t,...o?.path!==void 0&&{docker:{path:o.path,...o.context!==void 0&&{context:o.context},...o.target!==void 0&&{target:o.target}}},...n?.needsDatabaseConnection!==void 0&&{needsDatabaseConnection:n.needsDatabaseConnection},containers:i?[{}]:[{port:s}],...N(r,c)}}a(H,"buildServiceEntry");function M(e,n){return n||e?.directAccess===!0?e:{...e,loadBalancer:!1}}a(M,"resolveClusterConfig");function V(e,n,r,c,t){const i=n.compute.ecs,o=(t&&t.length>0?P(r,t):i.services.map((u,d)=>({...u,name:d===0?"api":`service-${d+1}`}))).map((u,d)=>H(u,t?.[d])),g=o.some(u=>u.containers?.some(d=>d.port!==void 0));return[{name:e,type:D.ECS,needsConnection:c,connectedDatabase:c?[e]:void 0,variableName:`${m(e)}Compute`,cluster:M(i.cluster,g),services:o}]}a(V,"buildComputePlan");function K(e,n){const r=[E(e),R(e),S(e)];if(_(e))r.push($(e),C(e));else{const t=j(e);r.push(C(e),y(e),I(e),w(e),A(e),B(e),U(e,t),x(e))}const c=r.join("");if(e.customCodeBlocks&&e.customCodeBlocks.length>0){const t=p(c,e.customCodeBlocks,n?.resourceMapping);return t.success?f(t.content):h(new Error(`Custom code injection failed: ${t.error??"unknown error"}`))}return f(c)}a(K,"generateInfrastructureFromPlan");export{K as generateInfrastructureFromPlan,J as planApplicationResources,G as toUserServiceConfigs};
+var b=Object.defineProperty;var i=(e,n)=>b(e,"name",{value:n,configurable:!0});import{TIER_PRESETS as l,getDefaultDatabaseTypeForTier as P,applyTierDefaultsToServices as k}from"../presets/tierPresets.js";import{COMPUTE_TYPE as D,DEFAULT_CONTAINER_PORT as T}from"../schemas/constants.js";import{success as f,failure as h}from"../types/Result.js";import{injectCustomCodeBlocks as p}from"../ast/mutation/astCodeInjection.js";import{toVariableName as m,toValidDatabaseName as v,generateImports as S,generateAppInit as E,generateTags as R,generateNetworkCode as C,generateDatabaseCode as y,generateClickHouseCode as I,generateS3Code as w,generateDynamoDBCode as x,generateSQSCode as A,generateComputeCode as B,generateCDNCode as U,collectCdnReferencedResources as j,usesPatternApproach as F,generatePatternCodeWithComments as _}from"../generation/index.js";function J(e){return e?.map(n=>({name:n.name,...n.serviceType!==void 0&&{serviceType:n.serviceType},...n.docker!==void 0&&{docker:n.docker},...n.containerPort!==void 0&&{containerPort:n.containerPort},...n.needsDatabaseConnection!==void 0&&{needsDatabaseConnection:n.needsDatabaseConnection},...n.routing!==void 0&&{routing:n.routing}}))}i(J,"toUserServiceConfigs");function K(e,n,r=!0,c,t){const o={appName:e,type:n,database:[],s3:[],compute:[]};if(n==="custom")return o;const s=n,a=l[s];return{...o,database:$(e,a,s,r,t),compute:W(e,a,s,r,c),network:a.network,backup:a.backup}}i(K,"planApplicationResources");function $(e,n,r,c,t){const o=P(r),s=n.database[o];return!c||s===null?[]:[{name:e,type:o,databaseName:v(e),variableName:`${m(e)}Database`,...s,...t?.snapshotIdentifier!==void 0&&{snapshotIdentifier:t.snapshotIdentifier},...t?.snapshotUsername!==void 0&&{snapshotUsername:t.snapshotUsername}}]}i($,"buildDatabasePlan");function N(e,n){if(!(e===void 0&&n===void 0))return{scaling:{...e!==void 0&&{minCapacity:e},...n!==void 0&&{maxCapacity:n}}}}i(N,"buildScalingConfig");function H(e){const{minCapacity:n,maxCapacity:r,...c}=e;return{...c,...N(n,r)}}i(H,"planServiceFromTierPreset");function M(e,n){const r=H(e),c=n?.serviceType==="worker",t=n?.containerPort??T,o=n?.docker;return{...r,...o?.path!==void 0&&{docker:{path:o.path,...o.context!==void 0&&{context:o.context},...o.target!==void 0&&{target:o.target}}},...n?.needsDatabaseConnection!==void 0&&{needsDatabaseConnection:n.needsDatabaseConnection},containers:c?[{}]:[{port:t}]}}i(M,"buildServiceEntry");function V(e,n){return n||e?.directAccess===!0?e:{...e,loadBalancer:!1}}i(V,"resolveClusterConfig");function W(e,n,r,c,t){const o=n.compute.ecs,a=(t&&t.length>0?k(r,t):o.services.map((u,d)=>({...u,name:d===0?"api":`service-${d+1}`}))).map((u,d)=>M(u,t?.[d])),g=a.some(u=>u.containers?.some(d=>d.port!==void 0));return[{name:e,type:D.ECS,needsConnection:c,connectedDatabase:c?[e]:void 0,variableName:`${m(e)}Compute`,cluster:V(o.cluster,g),services:a}]}i(W,"buildComputePlan");function O(e,n){const r=[S(e),E(e),R(e)];if(F(e))r.push(_(e),C(e));else{const t=j(e);r.push(C(e),y(e),I(e),w(e),x(e),A(e),B(e,t),U(e))}const c=r.join("");if(e.customCodeBlocks&&e.customCodeBlocks.length>0){const t=p(c,e.customCodeBlocks,n?.resourceMapping);return t.success?f(t.content):h(new Error(`Custom code injection failed: ${t.error??"unknown error"}`))}return f(c)}i(O,"generateInfrastructureFromPlan");export{O as generateInfrastructureFromPlan,K as planApplicationResources,H as planServiceFromTierPreset,J as toUserServiceConfigs};

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

@@ -0,0 +1,3 @@
+export { projectPlanToConstructProps } from "./project.js";
+export { isProjectableType, TYPE_PROJECTIONS, type ProjectableType, } from "./tables.js";
+export type { PlanKeyRule, Projection, ProjectionContext, ProjectedProp, ProjectedValue, TypeProjection, UnprojectableProp, } from "./types.js";

package/dist/src/projection/index.js

@@ -0,0 +1 @@
+import{projectPlanToConstructProps as e}from"./project.js";import{isProjectableType as p,TYPE_PROJECTIONS as P}from"./tables.js";export{P as TYPE_PROJECTIONS,p as isProjectableType,e as projectPlanToConstructProps};

package/dist/src/projection/project.d.ts

@@ -0,0 +1,22 @@
+import { type ProjectableType } from "./tables.js";
+import type { Projection, ProjectionContext } from "./types.js";
+/**
+ * Project a resource-plan fragment onto its construct's props.
+ *
+ * Keys with no rule pass through under their own name — the two vocabularies
+ * agree far more often than they disagree, and enumerating the agreements
+ * would be a second inventory to keep in step with the schemas.
+ *
+ * `undefined` values are skipped rather than emitted: a construct prop
+ * explicitly set to `undefined` is not the same as an absent one for a
+ * `.strict()` Zod props schema, and the plan's optional keys arrive as
+ * `undefined` routinely.
+ *
+ * A fragment key landing on a constant's construct key REPLACES it, in the
+ * constant's position. Constants exist to supply what the plan vocabulary
+ * cannot say; a caller who says it anyway (a hand-written `type: "queue"`,
+ * a round-tripped statement) is not disagreeing with the projection, and
+ * emitting the key twice would be a syntax-level duplicate that the last
+ * writer silently wins.
+ */
+export declare function projectPlanToConstructProps(type: ProjectableType, fragment: Readonly<Record<string, unknown>>, context?: ProjectionContext): Projection;

package/dist/src/projection/project.js

@@ -0,0 +1 @@
+var k=Object.defineProperty;var f=(o,s)=>k(o,"name",{value:s,configurable:!0});import{TYPE_PROJECTIONS as y}from"./tables.js";function O(o,s,r={}){const u=y[o],l=r.editingExisting===!0?[]:u.constants??[],t=new Map(l.map(n=>[n.key,n])),i=[];for(const[n,c]of Object.entries(s)){if(c===void 0)continue;const e=u.keys?.[n];if(e===void 0||e.kind==="prop"){const d=e?.as??n;t.set(d,{key:d,value:{kind:"literal",value:c}});continue}if(e.kind==="planOnly"){i.push({key:n,reason:e.reason});continue}const a=e.bind(c,r);if(a===void 0){i.push({key:n,reason:e.reason});continue}const p=e.as??n;t.set(p,{key:p,value:{kind:"expression",source:a}})}return{props:[...t.values()],unprojectable:i}}f(O,"projectPlanToConstructProps");export{O as projectPlanToConstructProps};

package/dist/src/projection/tables.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Per-type plan→construct projections.
+ *
+ * Every entry here was, before this module, a `silentlyDropped` /
+ * `requiresLiveValue` rule in `codemod/registry.ts` describing a translation
+ * the scaffold generator performed and the codemod could not. The reasons are
+ * carried over verbatim where they still apply, because they record what was
+ * actually observed to happen at synth — not what the vocabulary suggests.
+ *
+ * Two plan keys recur on nearly every type and are declared once:
+ * `variableName` (the `const <var> =` binding the scaffold emits) and
+ * `extraProperties` (round-trip preservation the scaffold flattens into
+ * sibling properties). Neither is a construct prop anywhere.
+ *
+ * `compute`, `cdn`, `pattern` and `vpc-peer` are deliberately ABSENT. Their
+ * disagreements are not renames: a CDN origin needs the live `IBucket` or
+ * load balancer its sibling resource became, and a compute's four connection
+ * keys expand into environment variables plus a whole second statement
+ * (`app.addSchedule(...)`). Both need a projection that can carry bindings
+ * and emit more than one statement, which is the next increment; until then
+ * they keep their `emitGuard` tables and a type is projected or guarded,
+ * never both.
+ */
+import type { TypeProjection } from "./types.js";
+export declare const TYPE_PROJECTIONS: {
+    readonly messaging: TypeProjection;
+    readonly storage: TypeProjection;
+    readonly database: TypeProjection;
+    readonly network: TypeProjection;
+};
+export type ProjectableType = keyof typeof TYPE_PROJECTIONS;
+export declare function isProjectableType(value: string): value is ProjectableType;

package/dist/src/projection/tables.js

@@ -0,0 +1 @@
+var s=Object.defineProperty;var a=(n,t)=>s(n,"name",{value:t,configurable:!0});const r={kind:"planOnly",reason:"`variableName` is a plan-only round-trip key naming the `const <var> =` binding the scaffold emits; no construct reads it."},o={kind:"planOnly",reason:"`extraProperties` is a plan-only round-trip key: the scaffold flattens each `{ key, sourceText }` entry into a sibling property, and no construct reads the array."},e={variableName:r,extraProperties:o},i={constants:[{key:"type",value:{kind:"literal",value:"queue"}}],keys:{retentionPeriod:{kind:"prop",as:"messageRetentionPeriod"},...e}},l={keys:{...e}},p={keys:{engineExpression:{kind:"planOnly",reason:"`engineExpression` carries a raw CDK engine expression for the scaffold to inline; the construct reads `databaseEngine` instead, so a cluster pinned to `DatabaseClusterEngine.auroraMysql(...)` still deploys as aurora-postgresql."},...e}},c={keys:{...e}},y={messaging:i,storage:l,database:p,network:c};function u(n){return Object.prototype.hasOwnProperty.call(y,n)}a(u,"isProjectableType");export{y as TYPE_PROJECTIONS,u as isProjectableType};

package/dist/src/projection/types.d.ts

@@ -0,0 +1,108 @@
+/**
+ * The plan→construct projection vocabulary.
+ *
+ * A resource PLAN and a CDK construct's PROPS are two different vocabularies
+ * for the same resource. They agree on most keys and disagree on a handful,
+ * and every disagreement has been, until now, encoded twice: once in the
+ * scaffold generator (which translates on the way out) and once in the
+ * codemod's `emitGuard` tables (which refuse what they cannot translate).
+ * Two encodings of one fact is drift waiting to happen — and it happened, in
+ * the direction that hurts: the guards are what stop `fjall add messaging`
+ * and `fjall add cdn` working at all.
+ *
+ * This module is that encoding, and the codemod reads it for every type in
+ * TYPE_PROJECTIONS. The scaffold does NOT yet, except for `messaging`
+ * (generation/storage.ts) — storage, database and network still emit their
+ * props by hand there, so for those three this is one of two encodings still.
+ * Converging the scaffold's remaining emitters is what makes the "single"
+ * claim true; until then, a table entry proves the codemod's behaviour and
+ * only documents the scaffold's.
+ */
+/**
+ * A construct prop's value. `literal` is a plain JS value the emitter
+ * serialises; `expression` is TypeScript source spliced in verbatim, which
+ * only a caller that can supply live bindings may ask for.
+ */
+export type ProjectedValue = {
+    kind: "literal";
+    value: unknown;
+} | {
+    kind: "expression";
+    source: string;
+};
+/** One construct prop, in construct vocabulary. */
+export interface ProjectedProp {
+    key: string;
+    value: ProjectedValue;
+}
+/**
+ * A plan key this context cannot turn into a construct prop, and why. The
+ * scaffold ignores these — it consumes such keys through its own paths. The
+ * codemod refuses the whole statement, because writing the key would either
+ * take synth down or deploy something other than what was asked for.
+ */
+export interface UnprojectableProp {
+    key: string;
+    reason: string;
+}
+export interface Projection {
+    props: ProjectedProp[];
+    unprojectable: UnprojectableProp[];
+}
+/**
+ * What the caller can offer beyond the plan fragment itself.
+ *
+ * `resolveBinding` is the whole difference between the two emission paths: the
+ * scaffold knows the identifier it bound each planned resource to, so it can
+ * answer; a codemod appending to a file someone else wrote generally cannot,
+ * and a key needing a live sibling is unprojectable for it.
+ */
+export interface ProjectionContext {
+    resolveBinding?: (planResourceName: string) => string | undefined;
+    /**
+     * The fragment is an EDIT to an existing statement rather than a whole
+     * resource. Constants describe the statement, so an edit must not carry
+     * them: `fjall modify messaging --retentionPeriod` asked to change the
+     * retention, not to write a `type` discriminator its author never mentioned.
+     */
+    editingExisting?: boolean;
+}
+/**
+ * How one plan key becomes (or fails to become) a construct prop.
+ *
+ * - `prop` — carried through as a literal, under `as` when the two
+ *   vocabularies name it differently.
+ * - `planOnly` — never a construct prop. The scaffold consumes it (a
+ *   `const <var> =` binding, flattened extra properties); anywhere else it is
+ *   inert, so it is reported rather than silently dropped.
+ * - `live` — the construct wants an object, not a value. `bind` gets the plan
+ *   value and the context and returns the source text of an expression, or
+ *   undefined when this context cannot produce one.
+ */
+export type PlanKeyRule = {
+    kind: "prop";
+    as?: string;
+} | {
+    kind: "planOnly";
+    reason: string;
+} | {
+    kind: "live";
+    as?: string;
+    reason: string;
+    bind: (value: unknown, context: ProjectionContext) => string | undefined;
+};
+/**
+ * One resource type's projection.
+ *
+ * `constants` are props every statement of the type carries no matter what
+ * the plan says — the discriminators the constructs switch on and the plan
+ * vocabulary never carried.
+ *
+ * `keys` is consulted per plan key; a key with no entry passes through under
+ * its own name, which is the common case and is why the tables stay short
+ * enough to read as the specification they are.
+ */
+export interface TypeProjection {
+    constants?: ProjectedProp[];
+    keys?: Record<string, PlanKeyRule>;
+}

package/dist/src/version.d.ts

@@ -1 +1 @@
-export declare const GENERATOR_VERSION = "7.2.0";
+export declare const GENERATOR_VERSION = "7.3.0";

package/dist/src/version.js

@@ -1 +1 @@
-const E="7.2.0";export{E as GENERATOR_VERSION};
+const E="7.3.0";export{E as GENERATOR_VERSION};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fjall/generator",
-  "version": "7.2.0",
+  "version": "7.3.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fjall-tech/fjall.git",
@@ -53,7 +53,7 @@
   },
   "license": "SEE LICENSE IN LICENSE",
   "dependencies": {
-    "@fjall/util": "^7.2.0",
+    "@fjall/util": "^7.3.0",
     "ast-types": "^0.16.1",
     "recast": "^0.23.12",
     "ts-morph": "^28.0.0",