@fjall/generator 0.89.4 → 0.89.6

package/dist/src/aws/regions.js

@@ -1,254 +1 @@
-export const DEFAULT_REGION = "us-east-2";
-export const regions = Object.freeze([
-    "us-east-2",
-    "us-west-2",
-    "us-east-1",
-    "eu-west-1",
-    "eu-central-1",
-    "ap-southeast-1",
-    "ap-northeast-1",
-    "ap-southeast-2",
-    "us-west-1",
-    "ca-central-1",
-    "af-south-1",
-    "ap-east-1",
-    "ap-northeast-2",
-    "ap-northeast-3",
-    "ap-south-1",
-    "ap-south-2",
-    "ap-southeast-3",
-    "ap-southeast-4",
-    "eu-central-2",
-    "eu-north-1",
-    "eu-south-1",
-    "eu-south-2",
-    "eu-west-2",
-    "eu-west-3",
-    "me-central-1",
-    "me-south-1",
-    "sa-east-1",
-]);
-export const AWS_REGIONS_METADATA = Object.freeze([
-    { code: "us-east-2", name: "US East", city: "Ohio", country: "USA" },
-    { code: "us-west-2", name: "US West", city: "Oregon", country: "USA" },
-    { code: "us-east-1", name: "US East", city: "N. Virginia", country: "USA" },
-    { code: "eu-west-1", name: "EU West", city: "Ireland", country: "Ireland" },
-    {
-        code: "eu-central-1",
-        name: "EU Central",
-        city: "Frankfurt",
-        country: "Germany",
-    },
-    {
-        code: "ap-southeast-1",
-        name: "Asia Pacific",
-        city: "Singapore",
-        country: "Singapore",
-    },
-    {
-        code: "ap-northeast-1",
-        name: "Asia Pacific",
-        city: "Tokyo",
-        country: "Japan",
-    },
-    {
-        code: "ap-southeast-2",
-        name: "Asia Pacific",
-        city: "Sydney",
-        country: "Australia",
-    },
-    { code: "us-west-1", name: "US West", city: "N. California", country: "USA" },
-    { code: "ca-central-1", name: "Canada", city: "Central", country: "Canada" },
-    {
-        code: "af-south-1",
-        name: "Africa",
-        city: "Cape Town",
-        country: "South Africa",
-    },
-    {
-        code: "ap-east-1",
-        name: "Asia Pacific",
-        city: "Hong Kong",
-        country: "China",
-    },
-    {
-        code: "ap-northeast-2",
-        name: "Asia Pacific",
-        city: "Seoul",
-        country: "South Korea",
-    },
-    {
-        code: "ap-northeast-3",
-        name: "Asia Pacific",
-        city: "Osaka",
-        country: "Japan",
-    },
-    {
-        code: "ap-south-1",
-        name: "Asia Pacific",
-        city: "Mumbai",
-        country: "India",
-    },
-    {
-        code: "ap-south-2",
-        name: "Asia Pacific",
-        city: "Hyderabad",
-        country: "India",
-    },
-    {
-        code: "ap-southeast-3",
-        name: "Asia Pacific",
-        city: "Jakarta",
-        country: "Indonesia",
-    },
-    {
-        code: "ap-southeast-4",
-        name: "Asia Pacific",
-        city: "Melbourne",
-        country: "Australia",
-    },
-    {
-        code: "eu-central-2",
-        name: "EU Central",
-        city: "Zurich",
-        country: "Switzerland",
-    },
-    {
-        code: "eu-north-1",
-        name: "EU North",
-        city: "Stockholm",
-        country: "Sweden",
-    },
-    { code: "eu-south-1", name: "EU South", city: "Milan", country: "Italy" },
-    { code: "eu-south-2", name: "EU South", city: "Spain", country: "Spain" },
-    { code: "eu-west-2", name: "EU West", city: "London", country: "UK" },
-    { code: "eu-west-3", name: "EU West", city: "Paris", country: "France" },
-    { code: "me-central-1", name: "Middle East", city: "UAE", country: "UAE" },
-    {
-        code: "me-south-1",
-        name: "Middle East",
-        city: "Bahrain",
-        country: "Bahrain",
-    },
-    {
-        code: "sa-east-1",
-        name: "South America",
-        city: "S\u00e3o Paulo",
-        country: "Brazil",
-    },
-]);
-export const topRegions = Object.freeze([
-    { code: "us-east-2", name: "US East", city: "Ohio", country: "USA" },
-    { code: "us-west-2", name: "US West", city: "Oregon", country: "USA" },
-    { code: "us-east-1", name: "US East", city: "N. Virginia", country: "USA" },
-    { code: "eu-west-1", name: "EU West", city: "Ireland", country: "Ireland" },
-    {
-        code: "eu-central-1",
-        name: "EU Central",
-        city: "Frankfurt",
-        country: "Germany",
-    },
-    {
-        code: "ap-southeast-1",
-        name: "Asia Pacific",
-        city: "Singapore",
-        country: "Singapore",
-    },
-]);
-export const commonRegions = Object.freeze([
-    "us-east-2",
-    "us-west-2",
-    "us-east-1",
-    "eu-west-1",
-    "ap-southeast-1",
-]);
-export function parseRegionList(value) {
-    if (!value)
-        return [];
-    return value
-        .split(",")
-        .map((region) => region.trim())
-        .filter(Boolean);
-}
-export function isValidRegion(region) {
-    return regions.includes(region);
-}
-export function isValidRegionFormat(region) {
-    // AWS region format pattern
-    const regionRegex = /^[a-z]{2}-[a-z]+-[1-9]$/;
-    return regionRegex.test(region);
-}
-export function getSuggestions(input) {
-    // Return common regions if input is empty
-    if (!input) {
-        return commonRegions.slice(0, 3);
-    }
-    // Get prefix and direction from input
-    const parts = input.toLowerCase().split("-");
-    const prefix = parts[0];
-    const direction = parts.length > 1 ? parts[1] : "";
-    // First try to match both prefix and direction
-    let matches = [];
-    if (prefix && direction) {
-        matches = regions.filter((region) => region.startsWith(`${prefix}-${direction}`));
-    }
-    // If no matches, try just the prefix
-    if (matches.length === 0 && prefix) {
-        matches = regions.filter((region) => region.startsWith(`${prefix}-`));
-    }
-    // If still no matches, return common regions
-    return matches.length > 0 ? matches.slice(0, 3) : commonRegions.slice(0, 3);
-}
-export function validateRegion(region) {
-    // Check if the region is valid
-    if (isValidRegion(region)) {
-        return true;
-    }
-    // Get suggestions for invalid region
-    const suggestions = getSuggestions(region);
-    // If format is invalid, return format error
-    if (!isValidRegionFormat(region)) {
-        return `Invalid format. Try: ${suggestions.join(", ")}`;
-    }
-    // If format is valid but region not recognized
-    return `Unknown region. Try: ${suggestions.join(", ")}`;
-}
-export function validateRegionList(value) {
-    if (!value || value.trim() === "")
-        return true;
-    const regionsList = parseRegionList(value);
-    for (const region of regionsList) {
-        const regionValidation = validateRegion(region);
-        if (regionValidation !== true) {
-            return regionValidation;
-        }
-    }
-    return true;
-}
-export function filterDuplicateRegions(regions, primaryRegion) {
-    return regions.filter((region) => region !== primaryRegion);
-}
-export function getRegionOptions() {
-    return AWS_REGIONS_METADATA.map((region) => ({
-        label: region.city,
-        value: region.code,
-        description: region.code,
-    }));
-}
-export function getRegionOptionsExcluding(excludeCode) {
-    return AWS_REGIONS_METADATA.filter((region) => region.code !== excludeCode).map((region) => ({
-        label: region.city,
-        value: region.code,
-        description: region.code,
-    }));
-}
-export function getRegionName(code) {
-    const region = AWS_REGIONS_METADATA.find((r) => r.code === code);
-    return region ? region.city : code;
-}
-export function createRegionFormatter(primaryRegion) {
-    return (value) => {
-        const secondaryRegions = parseRegionList(value);
-        return filterDuplicateRegions(secondaryRegions, primaryRegion);
-    };
-}
+const f="us-east-2",i=Object.freeze(["us-east-2","us-west-2","us-east-1","eu-west-1","eu-central-1","ap-southeast-1","ap-northeast-1","ap-southeast-2","us-west-1","ca-central-1","af-south-1","ap-east-1","ap-northeast-2","ap-northeast-3","ap-south-1","ap-south-2","ap-southeast-3","ap-southeast-4","eu-central-2","eu-north-1","eu-south-1","eu-south-2","eu-west-2","eu-west-3","me-central-1","me-south-1","sa-east-1"]),r=Object.freeze([{code:"us-east-2",name:"US East",city:"Ohio",country:"USA"},{code:"us-west-2",name:"US West",city:"Oregon",country:"USA"},{code:"us-east-1",name:"US East",city:"N. Virginia",country:"USA"},{code:"eu-west-1",name:"EU West",city:"Ireland",country:"Ireland"},{code:"eu-central-1",name:"EU Central",city:"Frankfurt",country:"Germany"},{code:"ap-southeast-1",name:"Asia Pacific",city:"Singapore",country:"Singapore"},{code:"ap-northeast-1",name:"Asia Pacific",city:"Tokyo",country:"Japan"},{code:"ap-southeast-2",name:"Asia Pacific",city:"Sydney",country:"Australia"},{code:"us-west-1",name:"US West",city:"N. California",country:"USA"},{code:"ca-central-1",name:"Canada",city:"Central",country:"Canada"},{code:"af-south-1",name:"Africa",city:"Cape Town",country:"South Africa"},{code:"ap-east-1",name:"Asia Pacific",city:"Hong Kong",country:"China"},{code:"ap-northeast-2",name:"Asia Pacific",city:"Seoul",country:"South Korea"},{code:"ap-northeast-3",name:"Asia Pacific",city:"Osaka",country:"Japan"},{code:"ap-south-1",name:"Asia Pacific",city:"Mumbai",country:"India"},{code:"ap-south-2",name:"Asia Pacific",city:"Hyderabad",country:"India"},{code:"ap-southeast-3",name:"Asia Pacific",city:"Jakarta",country:"Indonesia"},{code:"ap-southeast-4",name:"Asia Pacific",city:"Melbourne",country:"Australia"},{code:"eu-central-2",name:"EU Central",city:"Zurich",country:"Switzerland"},{code:"eu-north-1",name:"EU North",city:"Stockholm",country:"Sweden"},{code:"eu-south-1",name:"EU South",city:"Milan",country:"Italy"},{code:"eu-south-2",name:"EU South",city:"Spain",country:"Spain"},{code:"eu-west-2",name:"EU West",city:"London",country:"UK"},{code:"eu-west-3",name:"EU West",city:"Paris",country:"France"},{code:"me-central-1",name:"Middle East",city:"UAE",country:"UAE"},{code:"me-south-1",name:"Middle East",city:"Bahrain",country:"Bahrain"},{code:"sa-east-1",name:"South America",city:"S\xE3o Paulo",country:"Brazil"}]),h=Object.freeze([{code:"us-east-2",name:"US East",city:"Ohio",country:"USA"},{code:"us-west-2",name:"US West",city:"Oregon",country:"USA"},{code:"us-east-1",name:"US East",city:"N. Virginia",country:"USA"},{code:"eu-west-1",name:"EU West",city:"Ireland",country:"Ireland"},{code:"eu-central-1",name:"EU Central",city:"Frankfurt",country:"Germany"},{code:"ap-southeast-1",name:"Asia Pacific",city:"Singapore",country:"Singapore"}]),s=Object.freeze(["us-east-2","us-west-2","us-east-1","eu-west-1","ap-southeast-1"]);function u(t){return t?t.split(",").map(e=>e.trim()).filter(Boolean):[]}function y(t){return i.includes(t)}function d(t){return/^[a-z]{2}-[a-z]+-[1-9]$/.test(t)}function p(t){if(!t)return s.slice(0,3);const e=t.toLowerCase().split("-"),a=e[0],n=e.length>1?e[1]:"";let o=[];return a&&n&&(o=i.filter(c=>c.startsWith(`${a}-${n}`))),o.length===0&&a&&(o=i.filter(c=>c.startsWith(`${a}-`))),o.length>0?o.slice(0,3):s.slice(0,3)}function l(t){if(y(t))return!0;const e=p(t);return d(t)?`Unknown region. Try: ${e.join(", ")}`:`Invalid format. Try: ${e.join(", ")}`}function g(t){if(!t||t.trim()==="")return!0;const e=u(t);for(const a of e){const n=l(a);if(n!==!0)return n}return!0}function m(t,e){return t.filter(a=>a!==e)}function S(){return r.map(t=>({label:t.city,value:t.code,description:t.code}))}function A(t){return r.filter(e=>e.code!==t).map(e=>({label:e.city,value:e.code,description:e.code}))}function U(t){const e=r.find(a=>a.code===t);return e?e.city:t}function E(t){return e=>{const a=u(e);return m(a,t)}}export{r as AWS_REGIONS_METADATA,f as DEFAULT_REGION,s as commonRegions,E as createRegionFormatter,m as filterDuplicateRegions,U as getRegionName,S as getRegionOptions,A as getRegionOptionsExcluding,p as getSuggestions,y as isValidRegion,d as isValidRegionFormat,u as parseRegionList,i as regions,h as topRegions,l as validateRegion,g as validateRegionList};

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

@@ -0,0 +1,12 @@
+import type { LinesChanged } from "./types.js";
+export declare const DEFAULT_FILE_PATH = "/__codemod__/input.ts";
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function extractProgramBody<T>(file: unknown): T[] | undefined;
+/**
+ * Bidirectional line-count delta between `before` and `after`. The source's
+ * dominant line terminator is detected once; positive deltas map to
+ * `added`, negative deltas to `removed`. Add-only orchestrators never
+ * observe a negative delta in practice, but the bidirectional form keeps
+ * the contract honest for `removeResource` and `modifyResource`.
+ */
+export declare function computeLinesDelta(before: string, after: string): LinesChanged;

package/dist/src/codemod/_internal.js

@@ -0,0 +1 @@
+import{detectLineTerminator as i}from"./fileRewriter/index.js";const c="/__codemod__/input.ts";function o(r){return typeof r=="object"&&r!==null&&!Array.isArray(r)}function f(r){if(!o(r))return;const t=r.program;if(!o(t))return;const e=t.body;if(Array.isArray(e)&&e.every(n=>o(n)))return e}function d(r,t){return r.length===0?0:r.split(t).length}function a(r,t){const e=i(r),n=d(t,e)-d(r,e);return n>=0?{added:n,removed:0}:{added:0,removed:-n}}export{c as DEFAULT_FILE_PATH,a as computeLinesDelta,f as extractProgramBody,o as isRecord};

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

@@ -0,0 +1,34 @@
+import type { StatementType } from "../../types.js";
+import type { ImportInfo, InsertionStatementType, ResourceLocation } from "../findInsertionPosition.js";
+export interface StatementNodeLike {
+    type: string;
+    start?: number | null;
+    end?: number | null;
+    [key: string]: unknown;
+}
+export interface BodyAnchor {
+    index: number;
+    start: number;
+    end: number;
+    type: InsertionStatementType | undefined;
+}
+export interface IndexedBody {
+    anchors: BodyAnchor[];
+    importInfos: ImportInfo[];
+    appInitLocations: ResourceLocation[];
+    programEnd: number;
+}
+export declare function indexBody(body: StatementNodeLike[], source: string, factoryIdentifierByType: Record<StatementType, string>): IndexedBody;
+export declare function buildResourceLocations(anchors: BodyAnchor[], shapes: Array<{
+    start: number;
+    length: number;
+    type: StatementType;
+}>): ResourceLocation[];
+export declare function orderByEndPos(locations: ResourceLocation[]): ResourceLocation[];
+/**
+ * Translate an insertion byte-offset into a body-array index. The offset
+ * is the end byte of the anchor that should come BEFORE the new
+ * statement. If no anchor matches (empty body or offset equals program
+ * end), append at the end — the legacy algorithm's EOF fallback.
+ */
+export declare function resolveInsertIndex(anchors: BodyAnchor[], offset: number): number;

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

@@ -0,0 +1 @@
+import{isRecord as u}from"../../_internal.js";function x(n,r,t){const e=[],o=[],i=[];let s=r.length;for(let c=0;c<n.length;c+=1){const f=n[c];if(f===void 0)continue;const a=typeof f.start=="number"?f.start:0,p=typeof f.end=="number"?f.end:a;p>s&&(s=p);const d=y(f,t);e.push({index:c,start:a,end:p,type:d}),d==="import"?o.push({endPos:p}):(d==="app-init"||d==="tags")&&i.push({endPos:p,type:d})}return{anchors:e,importInfos:o,appInitLocations:i,programEnd:s}}function y(n,r){if(n.type==="ImportDeclaration")return"import";if(n.type!=="ExpressionStatement")return;const t=n.expression;if(!u(t)||t.type!=="CallExpression")return;const e=t.callee;if(!u(e)||e.type!=="MemberExpression")return;const o=e.object,i=e.property;if(!u(o)||o.type!=="Identifier"||!u(i)||i.type!=="Identifier"||i.name!=="build")return;const s=o.name;if(typeof s=="string")return s==="AppFactory"?"app-init":l(s,r)}function l(n,r){for(const[t,e]of Object.entries(r))if(e===n)return t}function h(n,r){const t=[];for(const e of r){const o=n.find(i=>i.start<=e.start&&i.end>=e.start+e.length);o!==void 0&&t.push({endPos:o.end,type:e.type})}return t}function I(n){return[...n].sort((r,t)=>r.endPos-t.endPos)}function b(n,r){const t=n.find(e=>e.end===r);return t!==void 0?t.index+1:n.length}export{h as buildResourceLocations,x as indexBody,I as orderByEndPos,b as resolveInsertIndex};

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

@@ -0,0 +1,7 @@
+import { type namedTypes as n } from "ast-types";
+import { type Result } from "../../../types/Result.js";
+import type { ObjectPropertyInput, QuoteStyle } from "../../fileRewriter/index.js";
+import type { InvalidPropertyError } from "../../types.js";
+export declare function buildPropertyInputs(properties: Record<string, unknown>, 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

@@ -0,0 +1 @@
+import{builders as o}from"ast-types";import{failure as p,success as u}from"../../../types/Result.js";function d(r,e){const n=[];for(const[t,i]of Object.entries(r)){const s=a(i,e);if(s===void 0)return p({kind:"InvalidPropertyError",property:t,reason:`Unsupported property value for "${t}" (Phase 1 accepts string/number/boolean/null only).`});n.push({key:t,value:s})}return u(n)}function a(r,e){if(typeof r=="string")return l(r,e);if(typeof r=="number"&&Number.isFinite(r))return o.numericLiteral(r);if(typeof r=="boolean")return o.booleanLiteral(r);if(r===null)return o.nullLiteral()}function l(r,e){const n=e==="single"?"'":'"',t=e==="single"?r.replace(/\\/g,"\\\\").replace(/'/g,"\\'"):r.replace(/\\/g,"\\\\").replace(/"/g,'\\"'),i=`${n}${t}${n}`;return o.stringLiteral.from({value:r,extra:{rawValue:r,raw:i}})}export{d as buildPropertyInputs,l as makeStringLiteral,a as toAstValue};

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

@@ -0,0 +1,9 @@
+import { type Result } from "../../types/Result.js";
+import type { AddOptions, DuplicateResourceError, InvalidPropertyError, LinesChanged, ParseError, SemanticQueryError, TemplateLiteralNameError } from "../types.js";
+export type { AddOptions, LinesChanged } from "../types.js";
+export type AddResourceError = ParseError | TemplateLiteralNameError | DuplicateResourceError | InvalidPropertyError | SemanticQueryError;
+export interface AddResourceSuccess {
+    content: string;
+    linesChanged: LinesChanged;
+}
+export declare function addResource(content: string, options: AddOptions): Result<AddResourceSuccess, AddResourceError>;

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

@@ -0,0 +1 @@
+import{failure as o,success as L}from"../../types/Result.js";import{DEFAULT_FILE_PATH as h,computeLinesDelta as P,extractProgramBody as k,isRecord as D}from"../_internal.js";import{appendSpecifier as R,buildFactoryStatement as T,buildImportDeclaration as b,detectQuoteStyle as _,parse as x,printFile as C}from"../fileRewriter/index.js";import{locateAllShapes as A,locateByShape as B}from"../semanticIndex/index.js";import{buildResourceLocations as O,indexBody as w,orderByEndPos as N,resolveInsertIndex as Q}from"./addResource/bodyIndex.js";import{buildPropertyInputs as Y}from"./addResource/propertyBuilder.js";import{findInsertionPosition as U}from"./findInsertionPosition.js";const f="@fjall/components-infrastructure",l={database:"DatabaseFactory",storage:"StorageFactory",compute:"ComputeFactory",messaging:"MessagingFactory",cdn:"CdnFactory",network:"NetworkFactory",pattern:"PatternFactory"};function K(t,r){const c=r.filePath??h,a=x(t,c);if(!a.success)return o(a.error);const e=B(t,{type:r.type,name:r.name},c);if(!e.success)return e.error.kind==="TemplateLiteralNameError"?o(e.error):o({kind:"SemanticQueryError",reason:e.error.reason,cause:e.error.cause});if(e.data!==void 0)return o({kind:"DuplicateResourceError",type:r.type,name:r.name});const n=_(a.data),d=Y(r.properties,n);if(!d.success)return o(d.error);const m=l[r.type],y=T({factory:m,name:r.name,properties:d.data,quoteStyle:n}),u=k(a.data);if(u===void 0)return o({kind:"SemanticQueryError",reason:"recast File is missing program.body"});const i=w(u,t,l),s=A(t,c);if(!s.success)return s.error.kind==="TemplateLiteralNameError"?o(s.error):o({kind:"SemanticQueryError",reason:s.error.reason,cause:s.error.cause});const F=O(i.anchors,s.data),E=N([...i.appInitLocations,...F]),I=U(i.importInfos,E,r.type,i.programEnd),S=Q(i.anchors,I);u.splice(S,0,y),v(u,m,n);const p=C(a.data,t),g=P(t,p);return L({content:p,linesChanged:g})}function v(t,r,c){for(const e of t){if(e.type!=="ImportDeclaration")continue;const n=e.source;if(!(!D(n)||n.type!=="StringLiteral")&&n.value===f){R(e,r);return}}const a=b([r],f,c);t.unshift(a)}export{K as addResource};

package/dist/src/codemod/edits/ensureImports.d.ts

@@ -0,0 +1,26 @@
+import type * as recast from "recast";
+import { type Result } from "../../types/Result.js";
+import type { SemanticQueryError } from "../types.js";
+type ParsedFile = ReturnType<typeof recast.parse>;
+export interface EnsureImportsAddition {
+    module: string;
+    specifiers: string[];
+}
+export interface EnsureImportsSuccess {
+    mutated: boolean;
+}
+export type EnsureImportsError = SemanticQueryError;
+/**
+ * Ensure every `(module, specifiers[])` addition is represented as a
+ * named import in the recast-parsed `file`. Mutates `file` in place.
+ *
+ * Dedupes by the IMPORTED identifier (not the local alias): `import { a
+ * as b }` + requested `a` is a no-op. New specifiers append to the END
+ * of the existing clause — no alphabetical sort. New declarations land
+ * immediately after the last existing import, or at body[0] when the
+ * file has none.
+ *
+ * Never throws — every failure path returns `failure(EnsureImportsError)`.
+ */
+export declare function ensureImports(file: ParsedFile, additions: EnsureImportsAddition[]): Result<EnsureImportsSuccess, EnsureImportsError>;
+export {};

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

@@ -0,0 +1 @@
+import{failure as m,success as f}from"../../types/Result.js";import{extractProgramBody as l,isRecord as d}from"../_internal.js";import{appendSpecifier as y,buildImportDeclaration as I,detectQuoteStyle as g}from"../fileRewriter/index.js";function L(t,r){const e=l(t);if(e===void 0)return m({kind:"SemanticQueryError",reason:"recast File is missing program.body"});if(r.length===0)return f({mutated:!1});const n=g(t);let o=!1;for(const i of r){const s=S(e,i.module);if(s!==void 0){for(const p of i.specifiers){const a=c(s);y(s,p),c(s)>a&&(o=!0)}continue}if(i.specifiers.length===0)continue;const u=I(i.specifiers,i.module,n);x(e,u),o=!0}return f({mutated:o})}function S(t,r){for(const e of t){if(e.type!=="ImportDeclaration")continue;const n=e.source;if(d(n)&&!(n.type!=="StringLiteral"&&n.type!=="Literal")&&n.value===r)return e}}function x(t,r){let e=-1;for(let o=0;o<t.length;o+=1){const i=t[o];i!==void 0&&i.type==="ImportDeclaration"&&(e=o)}const n=e===-1?0:e+1;t.splice(n,0,r)}function c(t){if(!Array.isArray(t.specifiers))return 0;let r=0;for(const e of t.specifiers)e!==null&&typeof e=="object"&&"type"in e&&e.type==="ImportSpecifier"&&(r+=1);return r}export{L as ensureImports};

package/dist/src/codemod/edits/findInsertionPosition.d.ts

@@ -0,0 +1,39 @@
+import type { StatementType } from "../types.js";
+/** Byte range of a classified statement, tagged with its type. */
+export interface ResourceLocation {
+    /** Byte offset where the statement ends (exclusive). */
+    endPos: number;
+    /** Statement kind relevant to the insertion-order algorithm. */
+    type: InsertionStatementType;
+}
+/** Byte range of an import declaration. */
+export interface ImportInfo {
+    /** Byte offset where the import declaration ends (exclusive). */
+    endPos: number;
+}
+/**
+ * Ordering superset of {@link StatementType}. The codemod engine only
+ * manipulates the 7 factory-call kinds declared in `StatementType`, but
+ * the legacy algorithm also recognises `import`, `app-init`, and `tags`
+ * as positioning anchors. Callers pass `import` entries via the
+ * dedicated {@link ImportInfo} list; `app-init` and `tags` are currently
+ * unreachable in Phase 1 (no managed-statement detection for them) and
+ * retained here purely so the ordering matches the legacy source.
+ */
+export type InsertionStatementType = StatementType | "import" | "app-init" | "tags";
+/**
+ * Returns the byte offset at which a new statement of `newType` should
+ * be inserted. Mirrors legacy `findInsertionPositionByType` verbatim.
+ *
+ * Algorithm (unchanged from the legacy port):
+ *   1. Look up `newType`'s index in the canonical order.
+ *   2. Walk `existingImports` and `existingResources` in document order.
+ *      Track the last entry whose type index is <= the target index.
+ *   3. If found, return its `endPos`.
+ *   4. Otherwise fall back to `fileEnd` (end-of-file offset).
+ *
+ * Callers supply `fileEnd` explicitly because this helper does not see
+ * the source text — pure-data boundary. The orchestrator computes it
+ * from the parsed AST (typically `ast.program.end`).
+ */
+export declare function findInsertionPosition(existingImports: readonly ImportInfo[], existingResources: readonly ResourceLocation[], newType: StatementType, fileEnd: number): number;

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

@@ -0,0 +1 @@
+const s=["import","app-init","tags","database","storage","messaging","compute","network","cdn","pattern"];function d(i,a,c,r){const t=s.indexOf(c);if(t===-1)return r;let e;for(const n of i)s.indexOf("import")<=t&&(e=n.endPos);for(const n of a){const o=s.indexOf(n.type);o!==-1&&o<=t&&(e=n.endPos)}return e??r}export{d as findInsertionPosition};

package/dist/src/codemod/edits/index.d.ts

@@ -0,0 +1,6 @@
+export { SCHEMA_FRAGMENTS } from "./schemaFragments.js";
+export { addResource, type AddOptions, type AddResourceError, type AddResourceSuccess, } from "./addResource.js";
+export { findInsertionPosition, type ImportInfo, type InsertionStatementType, type ResourceLocation, } from "./findInsertionPosition.js";
+export { removeResource, type LinesChanged, type RemoveOptions, type RemoveResourceError, type RemoveResourceSuccess, } from "./removeResource.js";
+export { modifyResource, type ModifyOptions, type ModifyResourceError, type ModifyResourceSuccess, } from "./modifyResource.js";
+export { ensureImports, type EnsureImportsAddition, type EnsureImportsError, type EnsureImportsSuccess, } from "./ensureImports.js";

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

@@ -0,0 +1 @@
+import{SCHEMA_FRAGMENTS as e}from"./schemaFragments.js";import{addResource as t}from"./addResource.js";import{findInsertionPosition as p}from"./findInsertionPosition.js";import{removeResource as x}from"./removeResource.js";import{modifyResource as n}from"./modifyResource.js";import{ensureImports as u}from"./ensureImports.js";export{e as SCHEMA_FRAGMENTS,t as addResource,u as ensureImports,p as findInsertionPosition,n as modifyResource,x as removeResource};

package/dist/src/codemod/edits/modifyResource/literalConversion.d.ts

@@ -0,0 +1,37 @@
+export interface NodeShapeLike {
+    type: string;
+    start?: number | null;
+    end?: number | null;
+    [key: string]: unknown;
+}
+export interface PropertyNodeLike extends NodeShapeLike {
+    type: string;
+    key?: NodeShapeLike;
+    value?: NodeShapeLike;
+    shorthand?: boolean;
+    computed?: boolean;
+    extra?: {
+        trailingComma?: boolean;
+        [key: string]: unknown;
+    };
+}
+export interface ObjectExpressionNodeLike extends NodeShapeLike {
+    type: "ObjectExpression";
+    properties: PropertyNodeLike[];
+}
+/**
+ * Sentinel distinct from `null`/`undefined` so callers can distinguish
+ * "literal null" from "not a literal".
+ */
+export declare const NON_LITERAL: unique symbol;
+export type LiteralValue = unknown;
+/**
+ * Build a literal shadow of `configObject` for fragment validation.
+ * Non-literal expressions in the existing object are skipped so
+ * `.strict()` does not reject real call sites that pass runtime handles
+ * (`vpc: app.getVpc()`).
+ */
+export declare function buildMergedLiteral(configObject: ObjectExpressionNodeLike, requestedProperties: Record<string, unknown>): Record<string, unknown>;
+export declare function astToLiteral(node: NodeShapeLike): LiteralValue | typeof NON_LITERAL;
+export declare function readKeyName(key: NodeShapeLike | undefined): string | undefined;
+export declare function isNodeShape(value: unknown): value is NodeShapeLike;

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

@@ -0,0 +1 @@
+const n=Symbol("non-literal");function y(e,r){const o={};for(const t of e.properties){if(t.type!=="Property"&&t.type!=="ObjectProperty"||t.shorthand===!0||t.computed===!0)continue;const i=f(t.key);if(i===void 0||t.value===void 0)continue;const u=a(t.value);u!==n&&(o[i]=u)}return{...o,...r}}function a(e){const r=e.value;switch(e.type){case"StringLiteral":return typeof r=="string"?r:n;case"NumericLiteral":return typeof r=="number"?r:n;case"BooleanLiteral":return typeof r=="boolean"?r:n;case"NullLiteral":return null;case"ArrayExpression":return p(e);case"ObjectExpression":return l(e);default:return n}}function p(e){const r=e.elements;if(!Array.isArray(r))return n;const o=[];for(const t of r){if(!c(t))return n;const i=a(t);if(i===n)return n;o.push(i)}return o}function l(e){const r=e.properties;if(!Array.isArray(r))return n;const o={};for(const t of r){if(!c(t)||t.type!=="Property"&&t.type!=="ObjectProperty")return n;const i=f(t.key),u=t.value;if(i===void 0||u===void 0)return n;const s=a(u);if(s===n)return n;o[i]=s}return o}function f(e){if(e===void 0)return;const r=e;if(e.type==="Identifier"&&typeof r.name=="string")return r.name;if(e.type==="StringLiteral"&&typeof r.value=="string")return r.value}function c(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)&&typeof e.type=="string"}export{n as NON_LITERAL,a as astToLiteral,y as buildMergedLiteral,c as isNodeShape,f as readKeyName};

package/dist/src/codemod/edits/modifyResource.d.ts

@@ -0,0 +1,9 @@
+import { type Result } from "../../types/Result.js";
+import type { InvalidPropertyError, LinesChanged, ModifyOptions, ParseError, ResourceNotFoundError, SemanticQueryError, TemplateLiteralNameError } from "../types.js";
+export type { LinesChanged, ModifyOptions } from "../types.js";
+export type ModifyResourceError = ParseError | ResourceNotFoundError | InvalidPropertyError | TemplateLiteralNameError | SemanticQueryError;
+export interface ModifyResourceSuccess {
+    content: string;
+    linesChanged: LinesChanged;
+}
+export declare function modifyResource(content: string, options: ModifyOptions): Result<ModifyResourceSuccess, ModifyResourceError>;

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

@@ -0,0 +1 @@
+import{failure as c,success as y}from"../../types/Result.js";import{DEFAULT_FILE_PATH as g,computeLinesDelta as k,extractProgramBody as E,isRecord as d}from"../_internal.js";import{buildObjectProperty as b,detectQuoteStyle as P,parse as S,printFile as v}from"../fileRewriter/index.js";import{locateAllShapes as A,locateByShape as x}from"../semanticIndex/index.js";import{toAstValue as N}from"./addResource/propertyBuilder.js";import{buildMergedLiteral as C,isNodeShape as h,readKeyName as L}from"./modifyResource/literalConversion.js";import{SCHEMA_FRAGMENTS as j}from"./schemaFragments.js";function H(o,e){const t=e.filePath??g,n=S(o,t);if(!n.success)return c(n.error);const r=x(o,{type:e.type,name:e.name},t);if(!r.success)return r.error.kind==="TemplateLiteralNameError"?c(r.error):c({kind:"SemanticQueryError",reason:r.error.reason,cause:r.error.cause});if(r.data===void 0)return c({kind:"ResourceNotFoundError",type:e.type,name:e.name,knownNames:R(o,e.type,t)});const s=E(n.data);if(s===void 0)return c({kind:"SemanticQueryError",reason:"recast File is missing program.body"});const i=w(s,r.data);if(i===void 0)return c({kind:"SemanticQueryError",reason:"Unable to resolve config ObjectExpression for the located resource."});const a=P(n.data),u=C(i,e.properties),l=j[e.type].safeParse(u);if(!l.success){const f=l.error.issues[0];return c({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 p=F(i,e.properties,a);if(!p.success)return c(p.error);const m=v(n.data,o);return y({content:m,linesChanged:k(o,m)})}function w(o,e){const t=e.start+e.length;let n;const r=s=>{if(n!==void 0||s.type!=="CallExpression")return;const i=s.arguments;if(!Array.isArray(i)||i.length<2)return;const a=i[0];if(!h(a)||a.type!=="StringLiteral"||a.start!==e.start||a.end!==t)return;const u=i[1];h(u)&&u.type==="ObjectExpression"&&(n=u)};for(const s of o)if(Q(s,r),n!==void 0)break;return n}function F(o,e,t){const n=T(o);for(const[r,s]of Object.entries(e)){const i=N(s,t);if(i===void 0)return c({kind:"InvalidPropertyError",property:r,reason:`Unsupported property value for "${r}" (Phase 1 accepts string/number/boolean/null only).`});const a=O(o,r);if(a!==void 0){a.value=i;continue}const u=b(r,i,t);n&&(u.extra={...u.extra??{},trailingComma:!0}),o.properties.push(u)}return y(void 0)}function O(o,e){return o.properties.find(t=>(t.type==="Property"||t.type==="ObjectProperty")&&t.shorthand!==!0&&t.computed!==!0&&L(t.key)===e)}function T(o){return o.properties[o.properties.length-1]?.extra?.trailingComma===!0}function R(o,e,t){const n=A(o,t);return n.success?n.data.filter(r=>r.type===e).map(r=>r.symbolName):[]}function Q(o,e){const t=[o];for(;t.length>0;){const n=t.pop();if(d(n)){typeof n.type=="string"&&e(n);for(const r of Object.keys(n)){if(r==="loc"||r==="comments"||r==="tokens")continue;const s=n[r];if(Array.isArray(s))for(const i of s)d(i)&&t.push(i);else d(s)&&t.push(s)}}}}export{H as modifyResource};

package/dist/src/codemod/edits/removeResource/commentHeuristic.d.ts

@@ -0,0 +1,31 @@
+export interface StatementNodeLike {
+    type: string;
+    start?: number | null;
+    end?: number | null;
+    comments?: CommentNodeLike[] | null;
+    [key: string]: unknown;
+}
+export interface CommentNodeLike {
+    type: string;
+    value: string;
+    leading?: boolean;
+    trailing?: boolean;
+    start?: number | null;
+    end?: number | null;
+    [key: string]: unknown;
+}
+export interface ClassifiedComments {
+    preserved: CommentNodeLike[];
+    adjacent: CommentNodeLike[];
+}
+/**
+ * Partition leading comments on `statement` into:
+ *   - adjacent: <2 newlines between comment.end and statement.start
+ *     (comment belongs to the statement, removed alongside it).
+ *   - preserved: >=2 newlines (spatially independent, caller migrates
+ *     onto the next surviving statement).
+ *
+ * Trailing comments are not classified — they always drop with the
+ * statement.
+ */
+export declare function classifyLeadingComments(statement: StatementNodeLike, source: string): ClassifiedComments;

package/dist/src/codemod/edits/removeResource/commentHeuristic.js

@@ -0,0 +1 @@
+function a(n,e){const t=[],r=[],i=n.comments;if(!Array.isArray(i)||typeof n.start!="number")return{preserved:t,adjacent:r};for(const o of i){if(!f(o)||o.leading!==!0||typeof o.end!="number")continue;const s=e.slice(o.end,n.start);c(s)>=2?t.push(o):r.push(o)}return{preserved:t,adjacent:r}}function c(n){let e=0;for(let t=0;t<n.length;t+=1)n.charCodeAt(t)===10&&(e+=1);return e}function f(n){if(typeof n!="object"||n===null||Array.isArray(n))return!1;const e=n;return typeof e.type=="string"&&typeof e.value=="string"}export{a as classifyLeadingComments};

package/dist/src/codemod/edits/removeResource/importPruning.d.ts

@@ -0,0 +1,8 @@
+import type { StatementNodeLike } from "./commentHeuristic.js";
+/**
+ * Walk `body` for Identifier usage counts (excluding ImportSpecifier
+ * descendants so specifiers never self-reference) and drop any named
+ * ImportSpecifier whose local name is no longer referenced. An
+ * ImportDeclaration left with zero specifiers is removed entirely.
+ */
+export declare function pruneUnusedImports(body: StatementNodeLike[]): void;

package/dist/src/codemod/edits/removeResource/importPruning.js

@@ -0,0 +1 @@
+import{isRecord as f}from"../../_internal.js";function m(e){const r=p(e);for(let n=e.length-1;n>=0;n-=1){const t=e[n];if(t===void 0||t.type!=="ImportDeclaration")continue;const i=t.specifiers;if(!Array.isArray(i))continue;const o=i.filter(s=>{if(!u(s))return!0;const c=a(s);return(r.get(c)??0)>0});if(o.length!==i.length){if(o.length===0){e.splice(n,1);continue}t.specifiers=o}}}function p(e){const r=new Map,n=[...e];for(;n.length>0;){const t=n.pop();if(!(!f(t)||typeof t.type!="string")&&t.type!=="ImportDeclaration"){if(t.type==="Identifier"){const i=t.name;typeof i=="string"&&r.set(i,(r.get(i)??0)+1);continue}for(const i of Object.keys(t)){if(i==="loc"||i==="comments"||i==="tokens")continue;const o=t[i];if(Array.isArray(o))for(const s of o)f(s)&&typeof s.type=="string"&&n.push(s);else f(o)&&typeof o.type=="string"&&n.push(o)}}}return r}function a(e){const r=e.local;if(f(r)){const t=r.name;if(typeof t=="string")return t}const n=e.imported;if(f(n)){const t=n.name;if(typeof t=="string")return t}return""}function u(e){if(!f(e)||e.type!=="ImportSpecifier")return!1;const r=e.imported;return f(r)&&typeof r.name=="string"}export{m as pruneUnusedImports};

package/dist/src/codemod/edits/removeResource.d.ts

@@ -0,0 +1,10 @@
+import { type Result } from "../../types/Result.js";
+import type { LinesChanged, ParseError, ReferenceLocation, ReferencesRemainError, RemoveOptions, ResourceNotFoundError, SemanticQueryError, TemplateLiteralNameError } from "../types.js";
+export type { LinesChanged, RemoveOptions } from "../types.js";
+export type RemoveResourceError = ParseError | TemplateLiteralNameError | ResourceNotFoundError | ReferencesRemainError | SemanticQueryError;
+export interface RemoveResourceSuccess {
+    content: string;
+    linesChanged: LinesChanged;
+    references: ReferenceLocation[];
+}
+export declare function removeResource(content: string, options: RemoveOptions): Result<RemoveResourceSuccess, RemoveResourceError>;

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

@@ -0,0 +1 @@
+import{failure as c,success as u}from"../../types/Result.js";import{DEFAULT_FILE_PATH as l,computeLinesDelta as p,extractProgramBody as y,isRecord as d}from"../_internal.js";import{parse as g,printFile as h}from"../fileRewriter/index.js";import{findReferences as b,locateAllShapes as E,locateByShape as v}from"../semanticIndex/index.js";import{classifyLeadingComments as k}from"./removeResource/commentHeuristic.js";import{pruneUnusedImports as S}from"./removeResource/importPruning.js";function U(n,r){const a=r.filePath??l,t=g(n,a);if(!t.success)return c(t.error);const e=v(n,{type:r.type,name:r.name},a);if(!e.success)return e.error.kind==="TemplateLiteralNameError"?c(e.error):c({kind:"SemanticQueryError",reason:e.error.reason,cause:e.error.cause});if(e.data===void 0)return c({kind:"ResourceNotFoundError",type:r.type,name:r.name,knownNames:F(n,r.type,a)});const i=y(t.data);if(i===void 0)return c({kind:"SemanticQueryError",reason:"recast File is missing program.body"});const o=N(i,e.data);if(o===void 0)return c({kind:"SemanticQueryError",reason:"Unable to resolve enclosing statement for the located resource."});const s=R(n,o.statement,a);if(!s.success)return c(s.error);if(s.data.locations.length>0&&r.force!==!0)return c({kind:"ReferencesRemainError",variable:s.data.variable??r.name,references:s.data.locations});A(i,o.index,n),S(i);const f=h(t.data,n),m=p(n,f);return u({content:f,linesChanged:m,references:s.data.locations})}function N(n,r){const a=r.start+r.length;for(let t=0;t<n.length;t+=1){const e=n[t];if(e!==void 0&&!(typeof e.start!="number"||typeof e.end!="number")&&e.start<=r.start&&e.end>=a)return{index:t,statement:e}}}function R(n,r,a){const t=D(r);if(t===void 0)return u({variable:void 0,locations:[]});const e=b(n,t.location,a);return e.success?u({variable:t.name,locations:e.data}):c({kind:"SemanticQueryError",reason:e.error.reason,cause:e.error.cause})}function D(n){let r=n;if(n.type==="ExportNamedDeclaration"){const f=n.declaration;if(!d(f)||f.type!=="VariableDeclaration")return;r=f}if(r.type!=="VariableDeclaration")return;const a=r.declarations;if(!Array.isArray(a)||a.length!==1)return;const t=a[0];if(!d(t))return;const e=t.id;if(!d(e)||e.type!=="Identifier")return;const i=e.name,o=e.start,s=e.end;if(!(typeof i!="string"||typeof o!="number"||typeof s!="number"))return{name:i,location:{filePath:l,start:o,length:s-o,symbolName:i}}}function A(n,r,a){const t=n[r];if(t===void 0)return;const{preserved:e}=k(t,a);if(e.length>0){const i=n[r+1];if(i!==void 0){const o=e.map(s=>({...s,leading:!0,trailing:!1}));i.comments=[...o,...i.comments??[]]}else{const o=n[r-1];if(o!==void 0){const s=e.map(f=>({...f,leading:!1,trailing:!0}));o.comments=[...o.comments??[],...s]}}}n.splice(r,1)}function F(n,r,a){const t=E(n,a);if(!t.success)return[];const e=[];for(const i of t.data)i.type===r&&e.push(i.symbolName);return e}export{U as removeResource};

package/dist/src/codemod/edits/schemaFragments.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import { type StatementType } from "../semanticIndex/index.js";
+/**
+ * Map from `StatementType` → Zod fragment validating the config-object
+ * portion of an `XFactory.build("Name", { ... })` call. Every fragment
+ * is `.strict()` (Pitfall 3) so unknown property names fail loudly
+ * instead of being silently stripped.
+ */
+export declare const SCHEMA_FRAGMENTS: Record<StatementType, z.ZodObject>;

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

@@ -0,0 +1 @@
+import{z as n}from"zod";import{CDNResourcePlanSchema as c,ComputeResourcePlanSchema as s,DatabaseResourcePlanSchema as m,NetworkResourcePlanSchema as p,NextJSPatternConfigSchema as g,PayloadPatternConfigSchema as S,S3ResourcePlanSchema as i,SQSResourcePlanSchema as u}from"../../schemas/index.js";function e(a){const{name:t,...r}=a.shape;return n.object(r).partial().strict()}const h=e(m),l=e(i),P=(()=>{const{name:a,...t}=s.shape;return n.object(t).partial().strict()})(),F=e(u),f=e(c),R=e(p),b=(()=>{const{name:a,...t}=S.shape,{name:r,...o}=g.shape;return n.object({...t,...o}).partial().strict()})(),_={database:h,storage:l,compute:P,messaging:F,cdn:f,network:R,pattern:b};export{_ as SCHEMA_FRAGMENTS};