@fjall/generator 0.89.5 → 0.89.6

package/dist/src/ast/astDatabaseParser.js

@@ -1,275 +1 @@
-import * as ts from "typescript";
-import { constIncludes } from "../schemas/constants.js";
-import { asBoolean, asNumber, asString, asStringArray, asStringUnion, captureExtraProperties, collectFromAst, extractVariableName, isCallRef, isFactoryBuildCall, isFactoryMethodCall, isParsedObject, omitUndefined, parseObjectLiteral, parseOptionalConfig, parseBooleanOrConfig, resolveTemplateLiteral, typed, } from "./astCommonParser.js";
-const DYNAMODB_KEY_TYPES = ["S", "N", "B"];
-// ---- Extraction helpers ----
-/** Derive database engine from parsed config */
-function extractDatabaseEngine(config) {
-    const directEngine = asString(config.databaseEngine);
-    if (directEngine === "postgresql" || directEngine === "mysql")
-        return directEngine;
-    const engine = config.engine;
-    if (isCallRef(engine)) {
-        const callText = String(engine.__call);
-        if (callText.includes("postgres") || callText.includes("auroraPostgres")) {
-            return "postgresql";
-        }
-        if (callText.includes("mysql") || callText.includes("auroraMysql")) {
-            return "mysql";
-        }
-    }
-    return undefined;
-}
-/** Extract raw engine expression text */
-function extractEngineExpression(config) {
-    const engine = config.engine;
-    if (isCallRef(engine)) {
-        return String(engine.__call);
-    }
-    return undefined;
-}
-const DATABASE_KNOWN_KEYS = new Set([
-    "type",
-    "databaseName",
-    "databaseEngine",
-    "engine",
-    "vpc",
-    "port",
-    "deletionProtection",
-    "instanceType",
-    "multiAz",
-    "publiclyAccessible",
-    "enableSecretRotation",
-    "encryption",
-    "databaseInsights",
-    "proxy",
-    "readReplica",
-    "credentials",
-    "writer",
-    "readers",
-    "backupRetention",
-    "preferredMaintenanceWindow",
-    "primaryRegion",
-    "secondaryRegions",
-    "globalClusterIdentifier",
-    "enableGlobalWriteForwarding",
-    "snapshotIdentifier",
-    "allocatedStorage",
-    "monitoringInterval",
-    "snapshotUsername",
-]);
-function extractDatabaseResource(sourceFile, addDatabaseCall, buildCall) {
-    if (buildCall.arguments.length < 2)
-        return null;
-    const nameArg = buildCall.arguments[0];
-    const configArg = buildCall.arguments[1];
-    if (!ts.isStringLiteral(nameArg) && !ts.isTemplateExpression(nameArg)) {
-        return null;
-    }
-    const resourceName = ts.isStringLiteral(nameArg)
-        ? nameArg.text
-        : resolveTemplateLiteral(sourceFile, nameArg);
-    if (!ts.isObjectLiteralExpression(configArg)) {
-        return null;
-    }
-    const config = parseObjectLiteral(configArg);
-    const resource = {
-        resourceName,
-        type: asString(config.type) ?? "",
-        databaseName: asString(config.databaseName) ?? "",
-        databaseEngine: extractDatabaseEngine(config),
-        engineExpression: extractEngineExpression(config),
-        port: asNumber(config.port),
-        deletionProtection: asBoolean(config.deletionProtection),
-        instanceType: asString(config.instanceType),
-        multiAz: asBoolean(config.multiAz),
-        publiclyAccessible: asBoolean(config.publiclyAccessible),
-        enableSecretRotation: asBoolean(config.enableSecretRotation),
-        encryption: parseOptionalConfig(config.encryption, typed()),
-        databaseInsights: parseBooleanOrConfig(config.databaseInsights, typed()),
-        proxy: parseBooleanOrConfig(config.proxy, typed()),
-        readReplica: parseBooleanOrConfig(config.readReplica, typed()),
-        credentials: parseOptionalConfig(config.credentials, typed()),
-        writer: parseOptionalConfig(config.writer, typed()),
-        readers: parseBooleanOrConfig(config.readers, typed()),
-        backupRetention: asNumber(config.backupRetention),
-        preferredMaintenanceWindow: asString(config.preferredMaintenanceWindow),
-        primaryRegion: asString(config.primaryRegion),
-        secondaryRegions: asStringArray(config.secondaryRegions),
-        globalClusterIdentifier: asString(config.globalClusterIdentifier),
-        enableGlobalWriteForwarding: asBoolean(config.enableGlobalWriteForwarding),
-        allocatedStorage: asNumber(config.allocatedStorage),
-        monitoringInterval: asNumber(config.monitoringInterval),
-        snapshotIdentifier: asString(config.snapshotIdentifier),
-        snapshotUsername: asString(config.snapshotUsername),
-        node: addDatabaseCall,
-    };
-    const varName = extractVariableName(addDatabaseCall);
-    if (varName)
-        resource.variableName = varName;
-    const extras = captureExtraProperties(config, DATABASE_KNOWN_KEYS);
-    if (extras.length > 0)
-        resource.extraProperties = extras;
-    return resource;
-}
-// ---- DynamoDB helpers ----
-/** Parse a DynamoDB key schema from parsed AST object */
-function parseDynamoDBKey(value) {
-    if (!isParsedObject(value))
-        return undefined;
-    const name = asString(value.name);
-    const type = asStringUnion(value.type, DYNAMODB_KEY_TYPES);
-    if (!name || !type)
-        return undefined;
-    return { name, type };
-}
-/** Extract DynamoDB-specific fields from a parsed database resource */
-function extractDynamoDBFields(resource) {
-    const node = resource.node;
-    if (!ts.isCallExpression(node))
-        return null;
-    const buildCallArg = node.arguments[0];
-    if (!ts.isCallExpression(buildCallArg) || buildCallArg.arguments.length < 2)
-        return null;
-    const configArg = buildCallArg.arguments[1];
-    if (!ts.isObjectLiteralExpression(configArg))
-        return null;
-    const config = parseObjectLiteral(configArg);
-    const partitionKey = parseDynamoDBKey(config.partitionKey);
-    if (!partitionKey)
-        return null;
-    const result = {
-        resourceName: resource.resourceName,
-        partitionKey,
-        node: resource.node,
-    };
-    if (resource.variableName)
-        result.variableName = resource.variableName;
-    const sortKey = parseDynamoDBKey(config.sortKey);
-    if (sortKey)
-        result.sortKey = sortKey;
-    if (Array.isArray(config.globalSecondaryIndexes)) {
-        const gsis = config.globalSecondaryIndexes
-            .filter(isParsedObject)
-            .map((gsi) => {
-            const pk = parseDynamoDBKey(gsi.partitionKey);
-            if (!pk)
-                return null;
-            const indexName = asString(gsi.indexName);
-            if (!indexName)
-                return null;
-            const entry = { indexName, partitionKey: pk };
-            const sk = parseDynamoDBKey(gsi.sortKey);
-            if (sk)
-                entry.sortKey = sk;
-            return entry;
-        })
-            .filter((g) => g !== null);
-        if (gsis.length > 0)
-            result.globalSecondaryIndexes = gsis;
-    }
-    const ttlAttribute = asString(config.ttlAttribute);
-    if (ttlAttribute)
-        result.ttlAttribute = ttlAttribute;
-    const stream = asBoolean(config.stream);
-    if (stream !== undefined)
-        result.stream = stream;
-    const DYNAMODB_KNOWN_KEYS = new Set([
-        "type",
-        "databaseName",
-        "partitionKey",
-        "sortKey",
-        "globalSecondaryIndexes",
-        "ttlAttribute",
-        "stream",
-    ]);
-    const extras = captureExtraProperties(config, DYNAMODB_KNOWN_KEYS);
-    if (extras.length > 0)
-        result.extraProperties = extras;
-    return result;
-}
-// ---- Public API ----
-/** Find all database resources (including DynamoDB) from addDatabase calls */
-export function findDatabaseResources(sourceFile) {
-    return collectFromAst(sourceFile, (node) => {
-        if (!ts.isCallExpression(node) || !isFactoryMethodCall(node, "addDatabase"))
-            return null;
-        const databaseArg = node.arguments[0];
-        if (!isFactoryBuildCall(databaseArg, "DatabaseFactory"))
-            return null;
-        return extractDatabaseResource(sourceFile, node, databaseArg);
-    });
-}
-/** Split DynamoDB resources (type: "DynamoDB") from regular database resources */
-export function splitDynamoDBFromDatabases(allResources) {
-    const databases = [];
-    const dynamodb = [];
-    for (const resource of allResources) {
-        if (resource.type === "DynamoDB") {
-            const dynamo = extractDynamoDBFields(resource);
-            if (dynamo)
-                dynamodb.push(dynamo);
-        }
-        else {
-            databases.push(resource);
-        }
-    }
-    return { databases, dynamodb };
-}
-const VALID_DB_TYPES = ["Instance", "Aurora", "GlobalAurora"];
-/** Convert parsed database resources to plan format */
-export function convertDatabaseResources(databaseResources) {
-    return databaseResources
-        .filter((db) => db.type !== "DynamoDB")
-        .map((database) => ({
-        name: database.resourceName,
-        type: constIncludes(VALID_DB_TYPES, database.type)
-            ? database.type
-            : "Instance",
-        databaseName: database.databaseName,
-        ...omitUndefined({
-            port: database.port,
-            deletionProtection: database.deletionProtection,
-            instanceType: database.instanceType,
-            multiAz: database.multiAz,
-            publiclyAccessible: database.publiclyAccessible,
-            enableSecretRotation: database.enableSecretRotation,
-            encryption: database.encryption,
-            databaseInsights: database.databaseInsights,
-            proxy: database.proxy,
-            readReplica: database.readReplica,
-            credentials: database.credentials,
-            writer: database.writer,
-            readers: database.readers,
-            backupRetention: database.backupRetention,
-            preferredMaintenanceWindow: database.preferredMaintenanceWindow,
-            primaryRegion: database.primaryRegion,
-            secondaryRegions: database.secondaryRegions,
-            globalClusterIdentifier: database.globalClusterIdentifier,
-            enableGlobalWriteForwarding: database.enableGlobalWriteForwarding,
-            allocatedStorage: database.allocatedStorage,
-            monitoringInterval: database.monitoringInterval,
-            variableName: database.variableName,
-            databaseEngine: database.databaseEngine,
-            engineExpression: database.engineExpression,
-            extraProperties: database.extraProperties,
-        }),
-    }));
-}
-/** Convert parsed DynamoDB resources to plan format */
-export function convertDynamoDBResources(dynamodbResources) {
-    if (dynamodbResources.length === 0)
-        return undefined;
-    return dynamodbResources.map((table) => ({
-        name: table.resourceName,
-        partitionKey: table.partitionKey,
-        ...omitUndefined({
-            sortKey: table.sortKey,
-            globalSecondaryIndexes: table.globalSecondaryIndexes,
-            ttlAttribute: table.ttlAttribute,
-            stream: table.stream,
-            variableName: table.variableName,
-            extraProperties: table.extraProperties,
-        }),
-    }));
-}
+import*as l from"typescript";import{constIncludes as R}from"../schemas/constants.js";import{asBoolean as c,asNumber as p,asString as o,asStringArray as x,captureExtraProperties as I,collectFromAst as A,extractVariableName as S,isCallRef as f,isFactoryBuildCall as D,isFactoryMethodCall as E,omitUndefined as h,parseObjectLiteral as w,parseOptionalConfig as m,parseBooleanOrConfig as g,resolveTemplateLiteral as N,typed as a}from"./astCommonParser.js";import{extractDynamoDBFields as v}from"./astDynamoDBParser.js";import{convertDynamoDBResources as O}from"./astDynamoDBParser.js";function P(t){const e=o(t.databaseEngine);if(e==="postgresql"||e==="mysql")return e;const i=t.engine;if(f(i)){const r=String(i.__call);if(r.includes("postgres")||r.includes("auroraPostgres"))return"postgresql";if(r.includes("mysql")||r.includes("auroraMysql"))return"mysql"}}function W(t){const e=t.engine;if(f(e))return String(e.__call)}const B=new Set(["type","databaseName","databaseEngine","engine","vpc","port","deletionProtection","instanceType","multiAz","publiclyAccessible","enableSecretRotation","encryption","databaseInsights","proxy","readReplica","credentials","writer","readers","backupRetention","preferredMaintenanceWindow","primaryRegion","secondaryRegions","globalClusterIdentifier","enableGlobalWriteForwarding","snapshotIdentifier","allocatedStorage","monitoringInterval","snapshotUsername"]);function F(t,e,i){if(i.arguments.length<2)return null;const r=i.arguments[0],s=i.arguments[1];if(!l.isStringLiteral(r)&&!l.isTemplateExpression(r))return null;const b=l.isStringLiteral(r)?r.text:N(t,r);if(!l.isObjectLiteralExpression(s))return null;const n=w(s),u={resourceName:b,type:o(n.type)??"",databaseName:o(n.databaseName)??"",databaseEngine:P(n),engineExpression:W(n),port:p(n.port),deletionProtection:c(n.deletionProtection),instanceType:o(n.instanceType),multiAz:c(n.multiAz),publiclyAccessible:c(n.publiclyAccessible),enableSecretRotation:c(n.enableSecretRotation),encryption:m(n.encryption,a()),databaseInsights:g(n.databaseInsights,a()),proxy:g(n.proxy,a()),readReplica:g(n.readReplica,a()),credentials:m(n.credentials,a()),writer:m(n.writer,a()),readers:g(n.readers,a()),backupRetention:p(n.backupRetention),preferredMaintenanceWindow:o(n.preferredMaintenanceWindow),primaryRegion:o(n.primaryRegion),secondaryRegions:x(n.secondaryRegions),globalClusterIdentifier:o(n.globalClusterIdentifier),enableGlobalWriteForwarding:c(n.enableGlobalWriteForwarding),allocatedStorage:p(n.allocatedStorage),monitoringInterval:p(n.monitoringInterval),snapshotIdentifier:o(n.snapshotIdentifier),snapshotUsername:o(n.snapshotUsername),node:e},d=S(e);d&&(u.variableName=d);const y=I(n,B);return y.length>0&&(u.extraProperties=y),u}function q(t){return A(t,e=>{if(!l.isCallExpression(e)||!E(e,"addDatabase"))return null;const i=e.arguments[0];return D(i,"DatabaseFactory")?F(t,e,i):null})}function G(t){const e=[],i=[];for(const r of t)if(r.type==="DynamoDB"){const s=v(r);s&&i.push(s)}else e.push(r);return{databases:e,dynamodb:i}}const T=["Instance","Aurora","GlobalAurora"];function L(t){return t.filter(e=>e.type!=="DynamoDB").map(e=>({name:e.resourceName,type:R(T,e.type)?e.type:"Instance",databaseName:e.databaseName,...h({port:e.port,deletionProtection:e.deletionProtection,instanceType:e.instanceType,multiAz:e.multiAz,publiclyAccessible:e.publiclyAccessible,enableSecretRotation:e.enableSecretRotation,encryption:e.encryption,databaseInsights:e.databaseInsights,proxy:e.proxy,readReplica:e.readReplica,credentials:e.credentials,writer:e.writer,readers:e.readers,backupRetention:e.backupRetention,preferredMaintenanceWindow:e.preferredMaintenanceWindow,primaryRegion:e.primaryRegion,secondaryRegions:e.secondaryRegions,globalClusterIdentifier:e.globalClusterIdentifier,enableGlobalWriteForwarding:e.enableGlobalWriteForwarding,allocatedStorage:e.allocatedStorage,monitoringInterval:e.monitoringInterval,variableName:e.variableName,databaseEngine:e.databaseEngine,engineExpression:e.engineExpression,extraProperties:e.extraProperties})}))}export{L as convertDatabaseResources,O as convertDynamoDBResources,q as findDatabaseResources,G as splitDynamoDBFromDatabases};

package/dist/src/ast/astDomainParser.d.ts

@@ -0,0 +1,139 @@
+import * as ts from "typescript";
+import { type Result } from "../types/Result.js";
+/** One-of match for a single `new Domain(...)` call in an infrastructure file. */
+export interface DomainCallMatch {
+    readonly callExpression: ts.NewExpression;
+    /**
+     * Top-level statement containing the `new Domain(...)` call — either the
+     * bare `ExpressionStatement` (`new Domain(...);`) or the `VariableStatement`
+     * (`const domain = new Domain(...);`). Eject replaces this statement with
+     * the expanded template.
+     */
+    readonly containingStatement: ts.Statement;
+    readonly propsObjectLiteral: ts.ObjectLiteralExpression;
+    /**
+     * Variable name the call is assigned to, if any:
+     *   `const domain = new Domain(...);`  → "domain"
+     *   `new Domain(...);`                  → undefined (bare expression)
+     */
+    readonly domainVarId: string | undefined;
+    /** Raw source text of the first argument (scope expression — e.g. `app`). */
+    readonly scopeArgumentText: string;
+    /** The `id` argument — second arg — as a string literal if resolvable. */
+    readonly constructIdLiteral: string | undefined;
+}
+/** Parsed target expression for a single `AliasRecord.target`. */
+export type ParsedFjallTarget = {
+    readonly kind: "ecs";
+    readonly appName: string;
+} | {
+    readonly kind: "cdn";
+    readonly appName: string;
+} | {
+    readonly kind: "bucket";
+    readonly bucketName: string;
+} | {
+    readonly kind: "custom";
+    readonly dnsName: string;
+    readonly hostedZoneId: string;
+} | {
+    readonly kind: "unresolved";
+    readonly sourceText: string;
+} | {
+    readonly kind: "dynamic";
+    readonly sourceText: string;
+};
+export interface ParsedStandardRecord {
+    readonly kind: "standard";
+    readonly type: "A" | "AAAA" | "CNAME" | "MX" | "TXT" | "NS" | "SRV" | "CAA";
+    readonly name: string;
+    readonly value: string | string[];
+    readonly ttl?: number;
+}
+export interface ParsedAliasRecord {
+    readonly kind: "alias";
+    readonly type: "A" | "AAAA";
+    readonly name: string;
+    readonly target: ParsedFjallTarget;
+}
+export type ParsedDnsRecordFromAst = ParsedStandardRecord | ParsedAliasRecord;
+export interface ParsedCertificateFromAst {
+    readonly domainName: string;
+    readonly subjectAlternativeNames?: string[];
+    readonly transparencyLogging?: boolean;
+}
+export interface ParsedDelegationFromAst {
+    readonly subdomain: string;
+    readonly toAccount: string;
+    readonly auto?: boolean;
+}
+interface ParsedDomainCommon {
+    readonly zoneName: string;
+    readonly description: string | undefined;
+    readonly costAllocationEnvironment: string | undefined;
+    readonly tags: Record<string, string> | undefined;
+    readonly records: ParsedDnsRecordFromAst[];
+    readonly certificates: ParsedCertificateFromAst[];
+}
+export interface ParsedRoute53ApexDomainProps extends ParsedDomainCommon {
+    readonly registrar: "route53";
+    readonly hostedZoneId: string | undefined;
+    readonly delegations: ParsedDelegationFromAst[];
+}
+export interface ParsedExternalDelegatedDomainProps extends ParsedDomainCommon {
+    readonly registrar: "external-delegated";
+    readonly delegatedSubdomain: string;
+    readonly delegations: ParsedDelegationFromAst[];
+}
+export interface ParsedExternalRecordsDomainProps extends ParsedDomainCommon {
+    readonly registrar: "external-records";
+}
+export type ParsedDomainProps = ParsedRoute53ApexDomainProps | ParsedExternalDelegatedDomainProps | ParsedExternalRecordsDomainProps;
+/**
+ * Locate the single `new Domain(...)` call expression in a parsed source file.
+ * Returns:
+ *   - success(match) when exactly one call is found
+ *   - success(undefined) when no call is found (caller decides how to report)
+ *   - failure(Error) when more than one call is found (invariant: one domain per file)
+ */
+export declare function findDomainConstructCall(sourceFile: ts.SourceFile): Result<DomainCallMatch | undefined, Error>;
+/**
+ * Structured error union for `parseDomainProps`. Callers `switch` on `.kind`
+ * rather than string-matching an error message.
+ *
+ *   - `registrar_required` — `registrar` property absent entirely
+ *   - `registrar_unsupported` — `registrar` present but not one of
+ *     `route53`, `external-delegated`, `external-records`
+ *   - `missing_field` — a required field (`zoneName`, `delegatedSubdomain`,
+ *     record fields) is absent
+ *   - `invalid_literal` — a field is present but its shape/value is wrong
+ *     (array expected, type mismatch, unsupported enum value)
+ */
+export type ParseDomainError = {
+    readonly kind: "registrar_required";
+} | {
+    readonly kind: "registrar_unsupported";
+    readonly value: string;
+} | {
+    readonly kind: "missing_field";
+    readonly field: string;
+} | {
+    readonly kind: "invalid_literal";
+    readonly field: string;
+    readonly reason: string;
+};
+/**
+ * Parse the props object literal of a located `new Domain(...)` call into a
+ * discriminated union keyed on `registrar`. Returns a `Result<_, ParseDomainError>`
+ * so callers can `switch` on `.kind` structurally — see `ParseDomainError` above.
+ */
+export declare function parseDomainProps(propsObjectLiteral: ts.ObjectLiteralExpression): Result<ParsedDomainProps, ParseDomainError>;
+/** Human-readable single-line message for a `ParseDomainError`. */
+export declare function parseDomainErrorMessage(err: ParseDomainError): string;
+/**
+ * Split a comma-separated argument list into top-level args, respecting
+ * nested parens/braces/brackets and string literals. Does NOT attempt to
+ * evaluate the individual arg expressions — returns raw source slices.
+ */
+export declare function splitTopLevelArgs(argsText: string): string[];
+export {};

package/dist/src/ast/astDomainParser.js

@@ -0,0 +1 @@
+import*as l from"typescript";import{parseObjectLiteral as x,asString as c,asStringUnion as A,asStringArray as k,asBoolean as y,asNumber as N,isCallRef as $,isParsedObject as g}from"./astCommonParser.js";import{success as a,failure as u}from"../types/Result.js";const h=["route53","external-delegated","external-records"],T=["A","AAAA","CNAME","MX","TXT","NS","SRV","CAA"],I=["A","AAAA"];function J(e){const n=[],t=i=>{if(l.isNewExpression(i)&&E(i.expression)){const d=j(i);d!==void 0&&n.push(d)}l.forEachChild(i,t)};if(t(e),n.length===0)return a(void 0);if(n.length>1)return u(new Error(`Expected exactly one 'new Domain(...)' call per infrastructure file, found ${n.length}`));const r=n[0];return r?a(r):a(void 0)}function E(e){return l.isIdentifier(e)&&e.text==="Domain"}function j(e){const n=e.arguments;if(!n||n.length<3)return;const t=n[0],r=n[1],i=n[2];if(!t||!r||!i||!l.isObjectLiteralExpression(i))return;const d=v(e);if(d===void 0)return;const o=R(e),s=l.isStringLiteral(r)?r.text:void 0;return{callExpression:e,containingStatement:d,propsObjectLiteral:i,domainVarId:o,scopeArgumentText:t.getText(),constructIdLiteral:s}}function v(e){let n=e;for(;n!==void 0;){if(l.isExpressionStatement(n)||l.isVariableStatement(n))return n;n=n.parent}}function R(e){let n=e.parent;for(;n!==void 0;){if(l.isVariableDeclaration(n)&&l.isIdentifier(n.name)&&n.initializer===e)return n.name.text;n=n.parent}}function D(e){switch(e.kind){case"registrar_required":return"'registrar' property is required";case"registrar_unsupported":return`'registrar' must be one of ${h.join(", ")}, got ${JSON.stringify(e.value)}`;case"missing_field":return`'${e.field}' property is required`;case"invalid_literal":return`'${e.field}' ${e.reason}`}}function B(e){const n=x(e),t=A(n.registrar,h);if(t===void 0){const s=n.registrar;if(s===void 0)return u({kind:"registrar_required"});const f=typeof s=="string"?s:p(s);return u({kind:"registrar_unsupported",value:f})}const r=c(n.zoneName);if(r===void 0)return u({kind:"missing_field",field:"zoneName"});const i=L(n.records);if(!i.success)return i;const d=z(n.certificates);if(!d.success)return d;const o={zoneName:r,description:c(n.description),costAllocationEnvironment:c(n.costAllocationEnvironment),tags:M(n.tags),records:i.data,certificates:d.data};switch(t){case"route53":{const s=S(n.delegations);return s.success?a({...o,registrar:t,hostedZoneId:c(n.hostedZoneId),delegations:s.data}):s}case"external-delegated":{const s=c(n.delegatedSubdomain);if(s===void 0)return u({kind:"missing_field",field:"delegatedSubdomain"});const f=S(n.delegations);return f.success?a({...o,registrar:t,delegatedSubdomain:s,delegations:f.data}):f}case"external-records":return a({...o,registrar:t})}}function X(e){return D(e)}function L(e){if(e===void 0)return a([]);if(!Array.isArray(e))return u({kind:"invalid_literal",field:"records",reason:"must be an array"});const n=[];for(let t=0;t<e.length;t++){const r=e[t];if(!g(r))return u({kind:"invalid_literal",field:`records[${t}]`,reason:"must be an object literal"});const i=O(r,t);if(!i.success)return i;n.push(i.data)}return a(n)}function O(e,n){const t=c(e.type),r=c(e.name);if(t===void 0)return u({kind:"missing_field",field:`records[${n}].type`});if(r===void 0)return u({kind:"missing_field",field:`records[${n}].name`});if(e.target!==void 0){if(!I.some(f=>f===t))return u({kind:"invalid_literal",field:`records[${n}]`,reason:`alias records must have type 'A' or 'AAAA', got '${t}'`});const s=V(e.target);return a({kind:"alias",type:t,name:r,target:s})}if(!T.some(s=>s===t))return u({kind:"invalid_literal",field:`records[${n}]`,reason:`unsupported record type '${t}'`});const i=C(e.value);if(i===void 0)return u({kind:"invalid_literal",field:`records[${n}].value`,reason:`must be a string or array of strings (got ${JSON.stringify(e.value)})`});const d=N(e.ttl),o={kind:"standard",type:t,name:r,value:i,...d!==void 0?{ttl:d}:{}};return a(o)}function C(e){if(e===void 0)return;if(typeof e=="string")return e;const n=k(e);if(n!==void 0)return n}function V(e){if($(e))return Z(e);if(g(e)){const n=A(e.kind,["ecs","cdn","bucket","custom"]);if(n==="ecs"||n==="cdn"){const t=c(e.appName);if(t!==void 0)return{kind:n,appName:t}}if(n==="bucket"){const t=c(e.bucketName);if(t!==void 0)return{kind:n,bucketName:t}}if(n==="custom"){const t=c(e.dnsName),r=c(e.hostedZoneId);if(t!==void 0&&r!==void 0)return{kind:n,dnsName:t,hostedZoneId:r}}}return{kind:"unresolved",sourceText:p(e)}}function Z(e){const n=e.__call.trim(),t=n.match(/^([A-Za-z_][\w$]*)\s*\(([\s\S]*)\)\s*$/);if(!t)return{kind:"unresolved",sourceText:n};const r=t[1],i=t[2]??"",d=_(i);switch(r){case"fjallApp":{const o=m(d,0);return o===void 0?{kind:"dynamic",sourceText:n}:{kind:"ecs",appName:o}}case"fjallCdn":{const o=m(d,0);return o===void 0?{kind:"dynamic",sourceText:n}:{kind:"cdn",appName:o}}case"fjallBucket":{const o=m(d,0);return o===void 0?{kind:"dynamic",sourceText:n}:{kind:"bucket",bucketName:o}}case"aliasTo":{if(d.length>=2){const o=m(d,0),s=m(d,1);return o!==void 0&&s!==void 0?{kind:"custom",dnsName:o,hostedZoneId:s}:{kind:"dynamic",sourceText:n}}if(d.length===1){const o=d[0]?.trim()??"",s=b(o,"dnsName"),f=b(o,"hostedZoneId");return s!==void 0&&f!==void 0?{kind:"custom",dnsName:s,hostedZoneId:f}:{kind:"dynamic",sourceText:n}}return{kind:"unresolved",sourceText:n}}default:return{kind:"unresolved",sourceText:n}}}function _(e){const n=[];let t=0,r=null,i="";for(let o=0;o<e.length;o++){const s=e[o];if(r!==null){if(i+=s,s==="\\"&&o+1<e.length){const f=e[o+1];f!==void 0&&(i+=f,o+=1);continue}s===r&&(r=null);continue}if(s==='"'||s==="'"||s==="`"){r=s,i+=s;continue}if(s==="("||s==="{"||s==="["){t+=1,i+=s;continue}if(s===")"||s==="}"||s==="]"){t-=1,i+=s;continue}if(s===","&&t===0){n.push(i.trim()),i="";continue}i+=s}const d=i.trim();return d.length>0&&n.push(d),n}function m(e,n){const t=e[n];if(t===void 0)return;const r=t.trim();if(r.length<2)return;const i=r[0],d=r[r.length-1];if(i===d&&!(i!=='"'&&i!=="'"&&i!=="`"))return r.slice(1,-1)}function b(e,n){const t=e.trim().replace(/^\{|\}$/g,""),r=_(t);for(const i of r){const d=i.indexOf(":");if(d<0||i.slice(0,d).trim().replace(/["'`]/g,"")!==n)continue;const s=i.slice(d+1).trim();return m([s],0)}}function z(e){if(e===void 0)return a([]);if(!Array.isArray(e))return u({kind:"invalid_literal",field:"certificates",reason:"must be an array"});const n=[];for(let t=0;t<e.length;t++){const r=e[t];if(typeof r=="string"){n.push({domainName:r});continue}if(!g(r))return u({kind:"invalid_literal",field:`certificates[${t}]`,reason:"must be a string or object literal"});const i=c(r.domainName);if(i===void 0)return u({kind:"missing_field",field:`certificates[${t}].domainName`});const d=k(r.subjectAlternativeNames),o=y(r.transparencyLogging);n.push({domainName:i,...d!==void 0?{subjectAlternativeNames:d}:{},...o!==void 0?{transparencyLogging:o}:{}})}return a(n)}function S(e){if(e===void 0)return a([]);if(!Array.isArray(e))return u({kind:"invalid_literal",field:"delegations",reason:"must be an array"});const n=[];for(let t=0;t<e.length;t++){const r=e[t];if(!g(r))return u({kind:"invalid_literal",field:`delegations[${t}]`,reason:"must be an object literal"});const i=c(r.subdomain),d=c(r.toAccount);if(i===void 0)return u({kind:"missing_field",field:`delegations[${t}].subdomain`});if(d===void 0)return u({kind:"missing_field",field:`delegations[${t}].toAccount`});const o=y(r.auto);n.push({subdomain:i,toAccount:d,...o!==void 0?{auto:o}:{}})}return a(n)}function M(e){if(e===void 0||!g(e))return;const n={};for(const[t,r]of Object.entries(e)){const i=c(r);i!==void 0&&(n[t]=i)}return Object.keys(n).length===0?void 0:n}function p(e){if(e===void 0)return"undefined";if(e===null)return"null";if(typeof e=="string")return JSON.stringify(e);if(typeof e=="number"||typeof e=="boolean")return String(e);if(Array.isArray(e))return`[${e.map(n=>p(n)).join(", ")}]`;if(typeof e=="object"){if("__call"in e)return String(e.__call);if("__identifier"in e)return String(e.__identifier);if("__expression"in e)return String(e.__expression);if("__unknown"in e)return String(e.__unknown)}return String(e)}export{J as findDomainConstructCall,X as parseDomainErrorMessage,B as parseDomainProps,_ as splitTopLevelArgs};

package/dist/src/ast/astDynamoDBParser.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Read-only AST parser for DynamoDB tables declared via addDatabase with
+ * type: "DynamoDB". Split out of astDatabaseParser.ts to keep both files
+ * within the 400-line budget. Write paths live in src/codemod/. Do not add
+ * mutation helpers here.
+ */
+import * as ts from "typescript";
+import type { ApplicationResourcePlan, ExtraProperty } from "../schemas/resourceSchemas.js";
+import type { ParsedDatabaseResource } from "./astDatabaseParser.js";
+declare const DYNAMODB_KEY_TYPES: readonly ["S", "N", "B"];
+type DynamoDBKeyType = (typeof DYNAMODB_KEY_TYPES)[number];
+interface DynamoDBKey {
+    name: string;
+    type: DynamoDBKeyType;
+}
+export interface ParsedDynamoDBResource {
+    variableName?: string;
+    resourceName: string;
+    partitionKey: DynamoDBKey;
+    sortKey?: DynamoDBKey;
+    globalSecondaryIndexes?: Array<{
+        indexName: string;
+        partitionKey: DynamoDBKey;
+        sortKey?: DynamoDBKey;
+    }>;
+    ttlAttribute?: string;
+    stream?: boolean;
+    extraProperties?: ExtraProperty[];
+    node: ts.Node;
+}
+/** Extract DynamoDB-specific fields from a parsed database resource */
+export declare function extractDynamoDBFields(resource: ParsedDatabaseResource): ParsedDynamoDBResource | null;
+/** Convert parsed DynamoDB resources to plan format */
+export declare function convertDynamoDBResources(dynamodbResources: ParsedDynamoDBResource[]): ApplicationResourcePlan["dynamodb"];
+export {};

package/dist/src/ast/astDynamoDBParser.js

@@ -0,0 +1 @@
+import*as s from"typescript";import{asBoolean as A,asString as l,asStringUnion as S,captureExtraProperties as D,isParsedObject as b,omitUndefined as B,parseObjectLiteral as E}from"./astCommonParser.js";const O=["S","N","B"];function a(t){if(!b(t))return;const e=l(t.name),i=S(t.type,O);if(!(!e||!i))return{name:e,type:i}}function P(t){const e=t.node;if(!s.isCallExpression(e))return null;const i=e.arguments[0];if(!s.isCallExpression(i)||i.arguments.length<2)return null;const u=i.arguments[1];if(!s.isObjectLiteralExpression(u))return null;const r=E(u),c=a(r.partitionKey);if(!c)return null;const n={resourceName:t.resourceName,partitionKey:c,node:t.node};t.variableName&&(n.variableName=t.variableName);const m=a(r.sortKey);if(m&&(n.sortKey=m),Array.isArray(r.globalSecondaryIndexes)){const p=r.globalSecondaryIndexes.filter(b).map(o=>{const K=a(o.partitionKey);if(!K)return null;const x=l(o.indexName);if(!x)return null;const N={indexName:x,partitionKey:K},g=a(o.sortKey);return g&&(N.sortKey=g),N}).filter(o=>o!==null);p.length>0&&(n.globalSecondaryIndexes=p)}const f=l(r.ttlAttribute);f&&(n.ttlAttribute=f);const d=A(r.stream);d!==void 0&&(n.stream=d);const y=D(r,new Set(["type","databaseName","partitionKey","sortKey","globalSecondaryIndexes","ttlAttribute","stream"]));return y.length>0&&(n.extraProperties=y),n}function _(t){if(t.length!==0)return t.map(e=>({name:e.resourceName,partitionKey:e.partitionKey,...B({sortKey:e.sortKey,globalSecondaryIndexes:e.globalSecondaryIndexes,ttlAttribute:e.ttlAttribute,stream:e.stream,variableName:e.variableName,extraProperties:e.extraProperties})}))}export{_ as convertDynamoDBResources,P as extractDynamoDBFields};

package/dist/src/ast/astExpressionEvaluator.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Read-only AST expression evaluator. Splits parse/evaluate helpers out of
+ * astCommonParser.ts to keep both files within the 400-line budget. Write
+ * paths live in src/codemod/. Do not add mutation helpers here.
+ */
+import * as ts from "typescript";
+import { type ParsedObject, type ParsedValue } from "./astCommonParser.js";
+/** Parse an object literal expression into a ParsedObject */
+export declare function parseObjectLiteral(node: ts.ObjectLiteralExpression): ParsedObject;
+/** Evaluate a TypeScript AST expression to a ParsedValue */
+export declare function evaluateExpression(node: ts.Expression): ParsedValue;
+/** Find a string variable value by name */
+export declare function findVariableValue(sourceFile: ts.SourceFile, varName: string): string | undefined;
+/** Find an object variable declaration by name */
+export declare function findObjectDeclaration(sourceFile: ts.SourceFile, objName: string): ParsedObject | undefined;
+/** Evaluate a property access expression to a string */
+export declare function evaluatePropertyAccess(sourceFile: ts.SourceFile, node: ts.PropertyAccessExpression): string | undefined;
+/**
+ * Resolve a template literal expression to its string value.
+ * Walks spans: head.text + resolve each span.expression + span.literal.text.
+ * Falls back to stripping backticks from getText() if resolution fails.
+ */
+export declare function resolveTemplateLiteral(sourceFile: ts.SourceFile, templateExpr: ts.TemplateExpression): string;

package/dist/src/ast/astExpressionEvaluator.js

@@ -0,0 +1 @@
+import*as t from"typescript";import{findFirstInAst as l}from"./astCommonParser.js";function f(e){const n={};for(const i of e.properties){if(!t.isPropertyAssignment(i))continue;const r=t.isIdentifier(i.name)||t.isStringLiteral(i.name)?i.name.text:void 0;r!==void 0&&(n[r]=a(i.initializer))}return n}function a(e){if(t.isStringLiteral(e))return e.text;if(t.isNumericLiteral(e))return Number(e.text);if(e.kind===t.SyntaxKind.TrueKeyword)return!0;if(e.kind===t.SyntaxKind.FalseKeyword)return!1;if(t.isArrayLiteralExpression(e))return e.elements.map(n=>a(n));if(t.isObjectLiteralExpression(e))return f(e);if(t.isIdentifier(e))return{__identifier:e.text};if(t.isPropertyAccessExpression(e))return{__expression:e.getText()};if(t.isCallExpression(e))return{__call:e.getText()};if(t.isBinaryExpression(e)&&e.operatorToken.kind===t.SyntaxKind.BarBarToken){const n=a(e.left),i=a(e.right);return typeof i=="string"?i:n}else if(t.isConditionalExpression(e)){const n=a(e.whenTrue),i=a(e.whenFalse);return typeof i=="string"||typeof i=="number"?i:n}else if(t.isTemplateExpression(e)||t.isNoSubstitutionTemplateLiteral(e))return{__expression:e.getText()};return{__unknown:e.getText()}}function u(e,n){return l(e,i=>{if(t.isVariableStatement(i)){for(const r of i.declarationList.declarations)if(t.isIdentifier(r.name)&&r.name.text===n&&r.initializer){if(t.isStringLiteral(r.initializer))return r.initializer.text;if(t.isObjectLiteralExpression(r.initializer)){const s=f(r.initializer);return JSON.stringify(s)}}}})}function o(e,n){return l(e,i=>{if(t.isVariableStatement(i)){for(const r of i.declarationList.declarations)if(t.isIdentifier(r.name)&&r.name.text===n&&r.initializer&&t.isObjectLiteralExpression(r.initializer))return f(r.initializer)}})}function p(e,n){if(!t.isIdentifier(n.expression))return;const i=o(e,n.expression.text),r=n.name.text;if(i&&i[r]!==void 0)return String(i[r])}function c(e,n){let i=n.head.text;for(const r of n.templateSpans){if(t.isIdentifier(r.expression)){const s=u(e,r.expression.text);if(s)i+=s;else return n.getText(e).replace(/^`|`$/g,"")}else if(t.isPropertyAccessExpression(r.expression)){const s=p(e,r.expression);if(s)i+=s;else return n.getText(e).replace(/^`|`$/g,"")}else return n.getText(e).replace(/^`|`$/g,"");i+=r.literal.text}return i}export{a as evaluateExpression,p as evaluatePropertyAccess,o as findObjectDeclaration,u as findVariableValue,f as parseObjectLiteral,c as resolveTemplateLiteral};

package/dist/src/ast/astInfrastructureParser.d.ts

@@ -1,5 +1,10 @@
+/**
+ * Read-only AST parser for infrastructure.ts. Used by fjall list and by the
+ * deploy-worker's convertToResourcePlan. Write paths live in src/codemod/.
+ * Do not add mutation helpers here.
+ */
 import * as ts from "typescript";
-import { type ApplicationResourcePlan, type StatementType, type CustomCodeBlock } from "../schemas/resourceSchemas.js";
+import type { CustomCodeBlock } from "../schemas/resourceSchemas.js";
 export { type IdentifierRef, type ExpressionRef, type CallRef, type ParsedValue, type ParsedObject, isPlainObject, isIdentifierRef, isExpressionRef, isCallRef, isParsedObject, asString, asNumber, asBoolean, asStringArray, asStringUnion, captureExtraProperties, } from "./astCommonParser.js";
 export { type ParsedDatabaseResource } from "./astDatabaseParser.js";
 export { type ParsedDynamoDBResource } from "./astDatabaseParser.js";
@@ -9,7 +14,13 @@ export { type ParsedSQSResource } from "./astMessagingParser.js";
 export { type ParsedCDNResource } from "./astCdnParser.js";
 export { type ParsedNetworkResource } from "./astNetworkParser.js";
 export { type ParsedLambdaConfig, type ParsedPatternResource, } from "./astPatternParser.js";
+export { type StatementType } from "../schemas/resourceSchemas.js";
+export { type CustomCodeBlock } from "../schemas/resourceSchemas.js";
+export { type ClassifiedStatement, classifyStatements, } from "./astStatementClassifier.js";
+export { extractCustomCodeBlocks, findManagedResourcePosition, getLastManagedStatementOfType, getManagedResourcesByType, } from "./astStatementQueries.js";
+export { convertToResourcePlan } from "./astPlanConverter.js";
 import { type ParsedNetworkConfig } from "./astNetworkParser.js";
+import { type ClassifiedStatement } from "./astStatementClassifier.js";
 import type { ParsedDatabaseResource } from "./astDatabaseParser.js";
 import type { ParsedDynamoDBResource } from "./astDatabaseParser.js";
 import type { ParsedS3Resource } from "./astStorageParser.js";
@@ -53,51 +64,3 @@ export interface ParsedInfrastructure {
 export declare function parseInfrastructure(content: string, options?: {
     extractCustomCode?: boolean;
 }): ParsedInfrastructure;
-export declare function convertToResourcePlan(parsed: ParsedInfrastructure, appName: string, options?: {
-    skipValidation?: boolean;
-}): ApplicationResourcePlan;
-/** Re-export for downstream consumers (e.g. astSurgicalModification) */
-export type { StatementType } from "../schemas/resourceSchemas.js";
-/**
- * A classified statement with its type and metadata.
- */
-export interface ClassifiedStatement {
-    /** The statement type */
-    type: StatementType;
-    /** The AST node */
-    node: ts.Statement;
-    /** For managed resources, the resource name (e.g., "MyDatabase") */
-    resourceName?: string;
-    /** Start position in source text */
-    startPos: number;
-    /** End position in source text */
-    endPos: number;
-    /** Whether the statement is classified as managed by Fjall */
-    isManaged: boolean;
-}
-/** Re-export for downstream consumers (e.g. astSurgicalModification) */
-export type { CustomCodeBlock } from "../schemas/resourceSchemas.js";
-/**
- * Classify all top-level statements in an infrastructure file.
- */
-export declare function classifyStatements(sourceFile: ts.SourceFile): ClassifiedStatement[];
-/**
- * Extract custom code blocks from an infrastructure file.
- */
-export declare function extractCustomCodeBlocks(sourceFile: ts.SourceFile, precomputedClassifications?: ClassifiedStatement[]): CustomCodeBlock[];
-/**
- * Find the position information for a specific managed resource.
- */
-export declare function findManagedResourcePosition(sourceFile: ts.SourceFile, resourceType: StatementType, resourceName: string, precomputedClassifications?: ClassifiedStatement[]): {
-    startPos: number;
-    endPos: number;
-    node: ts.Statement;
-} | null;
-/**
- * Get the last managed statement of a specific type.
- */
-export declare function getLastManagedStatementOfType(sourceFile: ts.SourceFile, type: StatementType, precomputedClassifications?: ClassifiedStatement[]): ClassifiedStatement | null;
-/**
- * Get all managed resources grouped by type.
- */
-export declare function getManagedResourcesByType(sourceFile: ts.SourceFile, precomputedClassifications?: ClassifiedStatement[]): Record<StatementType, ClassifiedStatement[]>;