@fjall/deploy-core 0.89.5 → 0.94.0

package/dist/src/types/events.js

@@ -1,5 +0,0 @@
-/**
- * Progress event types emitted by the deployment engine.
- * These flow to the caller via DeployCallbacks.
- */
-export {};

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

@@ -0,0 +1,96 @@
+/**
+ * FrameworkBuilder interface and supporting types.
+ *
+ * Defines the detect/plan/build lifecycle for framework-specific builders
+ * (e.g., OpenNext, Docker). Builders are checked in priority order during
+ * detection and produce serialisable build plans.
+ */
+import type { Result } from "@fjall/generator";
+import type { PatternType } from "@fjall/generator";
+import type { ApplicationStack } from "./operations.js";
+import type { AppResourceFlags } from "./patternTypes.js";
+/** Result of a builder's detect() phase */
+export interface FrameworkDetection {
+    /** Whether this builder can handle the app */
+    readonly detected: boolean;
+    /** The pattern type for backwards compatibility with existing pipeline */
+    readonly pattern: PatternType | null;
+    /** Human-readable reason for the match/rejection */
+    readonly reason: string;
+    /** Infrastructure resources this framework requires */
+    readonly resources: AppResourceFlags;
+    /** Whether a database was detected */
+    readonly hasDatabase: boolean;
+    /** Whether a Dockerfile was found in the app directory */
+    readonly hasDockerfile: boolean;
+}
+/** Build plan produced by a builder's plan() phase — inspectable, serialisable */
+export interface BuildPlan {
+    /** The builder that created this plan */
+    readonly builderName: string;
+    /** Stack deployment order */
+    readonly deployOrder: readonly ApplicationStack[];
+    /** Stack destroy order (reverse dependency) */
+    readonly destroyOrder: readonly ApplicationStack[];
+    /** Whether destroy should use parallel groups */
+    readonly parallelDestroy: boolean;
+    /** Pre-build commands (e.g., Payload import map generation) */
+    readonly preBuildCommands: readonly BuildCommand[];
+    /** Main build command (e.g., open-next build) */
+    readonly buildCommand: BuildCommand | null;
+    /** Whether this plan requires a Docker build (standard apps with Dockerfile) */
+    readonly requiresDockerBuild: boolean;
+    /** Infrastructure requirements */
+    readonly resources: AppResourceFlags;
+}
+/** A command to execute during the build phase */
+export interface BuildCommand {
+    readonly name: string;
+    readonly binary: string;
+    readonly args: readonly string[];
+    /** Timeout in milliseconds */
+    readonly timeoutMs: number;
+    /** Working directory (relative to app path) */
+    readonly cwd?: string;
+}
+/** Callbacks for build progress reporting */
+export interface BuildCallbacks {
+    readonly onBuildStart?: (builderName: string) => void;
+    readonly onBuildProgress?: (builderName: string, message: string) => void;
+    readonly onBuildComplete?: (builderName: string) => void;
+    readonly onBuildError?: (builderName: string, error: string) => void;
+}
+/** Context passed to detect() — lightweight filesystem info */
+export interface DetectionContext {
+    /** Absolute path to the application source */
+    readonly appPath: string;
+}
+/** Options for build execution */
+export interface BuildOptions {
+    /** Skip the build phase entirely */
+    readonly skipBuild?: boolean;
+    /** Only deploy infrastructure, skip application build */
+    readonly infraOnly?: boolean;
+}
+/** The FrameworkBuilder interface — detect/plan/build lifecycle */
+export interface FrameworkBuilder {
+    /** Unique identifier (e.g., "opennext", "docker") */
+    readonly name: string;
+    /** Lower number = higher priority. Checked in ascending order. */
+    readonly priority: number;
+    /**
+     * Fast detection: can this builder handle the app?
+     * Examines filesystem markers. Must not perform heavy I/O.
+     */
+    detect(context: DetectionContext): FrameworkDetection;
+    /**
+     * Produce a build plan without executing anything.
+     * Inspectable and serialisable for testing/debugging.
+     */
+    plan(context: DetectionContext, detection: FrameworkDetection): BuildPlan;
+    /**
+     * Execute the build according to the plan.
+     * Reports progress via callbacks.
+     */
+    build(appPath: string, plan: BuildPlan, callbacks: BuildCallbacks, options?: BuildOptions): Promise<Result<void>>;
+}

package/dist/src/types/frameworkBuilder.js

@@ -0,0 +1,8 @@
+/**
+ * FrameworkBuilder interface and supporting types.
+ *
+ * Defines the detect/plan/build lifecycle for framework-specific builders
+ * (e.g., OpenNext, Docker). Builders are checked in priority order during
+ * detection and produce serialisable build plans.
+ */
+export {};

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

@@ -1,10 +1,15 @@
+export { DeploymentEventSchema, DEPLOYMENT_EVENT_TYPES, DEPLOYMENT_EVENT_RESOURCE_CATEGORIES, CASCADE_PHASES, CASCADE_ACCOUNT_STATUSES, toCascadePhase } from "./deploymentEventSchema.js";
+export type { DeploymentEvent, DeploymentEventType, DeploymentEventResourceCategory, DeploymentEventCascadePhase, DeploymentEventCascadeAccountStatus } from "./deploymentEventSchema.js";
 export type { AwsCredentials, DeployIdentity } from "./credentials.js";
 export type { DeployCallbacks, StepCompleteStatus } from "./callbacks.js";
 export type { ProgressEvent, ProgressEventType, ResourceEvent, AwsAuthResult, CascadeDeploymentResult, CascadePhase } from "./events.js";
 export type { ApiClientInterface, EntitlementsData } from "./apiClient.js";
-export type { DeployParams, DeployOptions, DeploymentType, DeployResult } from "./params.js";
+export type { DeployParams, DeployOptions, DeploymentType, DeployResult, DestroyParams, DestroyOptions, DestroyResult } from "./params.js";
 export type { OrgConfig, ProviderAccount, SSOSession } from "./orgConfig.js";
+export type { Entitlements } from "./entitlements.js";
 export type { StackOutput, StackOutputsRecord, DeploymentContext, StepOutput, ApplicationDeploymentContext, CallerIdentity } from "./deployment/index.js";
+export { stubCallerIdentity } from "./deployment/index.js";
+export type { DetectionResult } from "./detection.js";
 export type { ValidationResult } from "./validation.js";
 export type { ProgressCallbacks } from "./ProgressEvent.js";
 export { ProgressReporter } from "./ProgressEvent.js";
@@ -12,9 +17,19 @@ export type { ApplicationStack, OrganisationType, DeploymentOperation, Applicati
 export { APPLICATION_STACKS, ORGANISATION_TYPES, APPLICATION_DEPLOY_ORDER, APPLICATION_DESTROY_ORDER, OPENNEXT_DEPLOY_ORDER, OPENNEXT_DESTROY_ORDER, PARALLEL_DEPLOY_GROUPS, PARALLEL_DESTROY_GROUPS, OPENNEXT_PARALLEL_GROUPS, isApplicationOperation, isOrganisationOperation, getParallelDeployGroups, getParallelDestroyGroups, getApplicationDeployOrder, getApplicationDestroyOrder, getApplicationStackName, getOrganisationStackName, isApplicationStack, getApplicationStepName, getApplicationStepId, toPascalCase } from "./operations.js";
 export type { ParallelDeploymentResult, ParallelDeployGroup, ParallelOperation, ParallelOperationType, ParallelOperationState } from "./deployment/index.js";
 export { PARALLEL_OPERATION_TYPES } from "./deployment/index.js";
-export type { OpenNextPattern, AppResourceFlags } from "./patternDetection.js";
-export { isOpenNextPattern, OPENNEXT_PATTERNS, detectPattern, detectPayloadPattern, detectDatabase, deriveResourcesFromManifestStacks } from "./patternDetection.js";
-export { STACK_NOT_FOUND_PATTERN, CDK_NO_STACKS_MATCH, INFRASTRUCTURE_FILENAME } from "./constants.js";
+export type { OpenNextPattern, AppResourceFlags } from "./patternTypes.js";
+export { isOpenNextPattern, OPENNEXT_PATTERNS } from "./patternTypes.js";
+export { deriveResourcesFromManifestStacks } from "./patternDetection.js";
+/** @deprecated Use FrameworkRegistry.resolve() instead */
+export { detectPattern } from "./patternDetection.js";
+/** @deprecated Use FrameworkRegistry.resolve() instead */
+export { detectPayloadPattern } from "./patternDetection.js";
+/** @deprecated Use FrameworkRegistry.resolve() instead */
+export { detectDatabase } from "./patternDetection.js";
+export { STACK_NOT_FOUND_PATTERN, STACK_FAILED_STATE_PATTERN, CDK_NO_STACKS_MATCH, INFRASTRUCTURE_FILENAME } from "./constants.js";
 export { ApplicationError, wrapApplicationError, type ApplicationErrorType, type StackDeploymentData, type StackDeploymentOptions, type ApplicationDeploymentData, type ApplicationDestructionData } from "./application/index.js";
 export type { FjallStateFile, TemplateHashEntry } from "./FjallState.js";
 export { FjallStateFileSchema, readStateFile, writeStateFile, createEmptyState, deleteStateFile, updateTemplateHash, getStateFilePath } from "./FjallState.js";
+export type { FrameworkBuilder, FrameworkDetection, BuildPlan, BuildCommand, BuildCallbacks, DetectionContext, BuildOptions } from "./frameworkBuilder.js";
+export { STEP_IDS, STEP_NAMES, INFRASTRUCTURE_STEP_NAMES, INFRA_STEP_NAME } from "./stepDefinitions.js";
+export type { StepId, InfrastructureStepName, StepDefinition, StepDeploymentType, Operation, StepContext } from "./stepDefinitions.js";

package/dist/src/types/index.js

@@ -1,9 +1 @@
-export { ProgressReporter } from "./ProgressEvent.js";
-export { APPLICATION_STACKS, ORGANISATION_TYPES, APPLICATION_DEPLOY_ORDER, APPLICATION_DESTROY_ORDER, OPENNEXT_DEPLOY_ORDER, OPENNEXT_DESTROY_ORDER, PARALLEL_DEPLOY_GROUPS, PARALLEL_DESTROY_GROUPS, OPENNEXT_PARALLEL_GROUPS, isApplicationOperation, isOrganisationOperation, getParallelDeployGroups, getParallelDestroyGroups, getApplicationDeployOrder, getApplicationDestroyOrder, getApplicationStackName, getOrganisationStackName, isApplicationStack, getApplicationStepName, getApplicationStepId, toPascalCase } from "./operations.js";
-export { PARALLEL_OPERATION_TYPES } from "./deployment/index.js";
-export { isOpenNextPattern, OPENNEXT_PATTERNS, detectPattern, detectPayloadPattern, detectDatabase, deriveResourcesFromManifestStacks } from "./patternDetection.js";
-// Constants
-export { STACK_NOT_FOUND_PATTERN, CDK_NO_STACKS_MATCH, INFRASTRUCTURE_FILENAME } from "./constants.js";
-// Application types
-export { ApplicationError, wrapApplicationError } from "./application/index.js";
-export { FjallStateFileSchema, readStateFile, writeStateFile, createEmptyState, deleteStateFile, updateTemplateHash, getStateFilePath } from "./FjallState.js";
+import{DeploymentEventSchema as r,DEPLOYMENT_EVENT_TYPES as E,DEPLOYMENT_EVENT_RESOURCE_CATEGORIES as a,CASCADE_PHASES as o,CASCADE_ACCOUNT_STATUSES as A,toCascadePhase as S}from"./deploymentEventSchema.js";import{stubCallerIdentity as T}from"./deployment/index.js";import{ProgressReporter as _}from"./ProgressEvent.js";import{APPLICATION_STACKS as i,ORGANISATION_TYPES as N,APPLICATION_DEPLOY_ORDER as R,APPLICATION_DESTROY_ORDER as l,OPENNEXT_DEPLOY_ORDER as D,OPENNEXT_DESTROY_ORDER as m,PARALLEL_DEPLOY_GROUPS as n,PARALLEL_DESTROY_GROUPS as s,OPENNEXT_PARALLEL_GROUPS as c,isApplicationOperation as C,isOrganisationOperation as L,getParallelDeployGroups as I,getParallelDestroyGroups as f,getApplicationDeployOrder as x,getApplicationDestroyOrder as d,getApplicationStackName as F,getOrganisationStackName as g,isApplicationStack as U,getApplicationStepName as Y,getApplicationStepId as y,toPascalCase as M}from"./operations.js";import{PARALLEL_OPERATION_TYPES as h}from"./deployment/index.js";import{isOpenNextPattern as K,OPENNEXT_PATTERNS as k}from"./patternTypes.js";import{deriveResourcesFromManifestStacks as H}from"./patternDetection.js";import{detectPattern as v}from"./patternDetection.js";import{detectPayloadPattern as V}from"./patternDetection.js";import{detectDatabase as q}from"./patternDetection.js";import{STACK_NOT_FOUND_PATTERN as B,STACK_FAILED_STATE_PATTERN as J,CDK_NO_STACKS_MATCH as Q,INFRASTRUCTURE_FILENAME as W}from"./constants.js";import{ApplicationError as $,wrapApplicationError as ee}from"./application/index.js";import{FjallStateFileSchema as re,readStateFile as Ee,writeStateFile as ae,createEmptyState as oe,deleteStateFile as Ae,updateTemplateHash as Se,getStateFilePath as pe}from"./FjallState.js";import{STEP_IDS as Pe,STEP_NAMES as _e,INFRASTRUCTURE_STEP_NAMES as Oe,INFRA_STEP_NAME as ie}from"./stepDefinitions.js";export{R as APPLICATION_DEPLOY_ORDER,l as APPLICATION_DESTROY_ORDER,i as APPLICATION_STACKS,$ as ApplicationError,A as CASCADE_ACCOUNT_STATUSES,o as CASCADE_PHASES,Q as CDK_NO_STACKS_MATCH,a as DEPLOYMENT_EVENT_RESOURCE_CATEGORIES,E as DEPLOYMENT_EVENT_TYPES,r as DeploymentEventSchema,re as FjallStateFileSchema,W as INFRASTRUCTURE_FILENAME,Oe as INFRASTRUCTURE_STEP_NAMES,ie as INFRA_STEP_NAME,D as OPENNEXT_DEPLOY_ORDER,m as OPENNEXT_DESTROY_ORDER,c as OPENNEXT_PARALLEL_GROUPS,k as OPENNEXT_PATTERNS,N as ORGANISATION_TYPES,n as PARALLEL_DEPLOY_GROUPS,s as PARALLEL_DESTROY_GROUPS,h as PARALLEL_OPERATION_TYPES,_ as ProgressReporter,J as STACK_FAILED_STATE_PATTERN,B as STACK_NOT_FOUND_PATTERN,Pe as STEP_IDS,_e as STEP_NAMES,oe as createEmptyState,Ae as deleteStateFile,H as deriveResourcesFromManifestStacks,q as detectDatabase,v as detectPattern,V as detectPayloadPattern,x as getApplicationDeployOrder,d as getApplicationDestroyOrder,F as getApplicationStackName,y as getApplicationStepId,Y as getApplicationStepName,g as getOrganisationStackName,I as getParallelDeployGroups,f as getParallelDestroyGroups,pe as getStateFilePath,C as isApplicationOperation,U as isApplicationStack,K as isOpenNextPattern,L as isOrganisationOperation,Ee as readStateFile,T as stubCallerIdentity,S as toCascadePhase,M as toPascalCase,Se as updateTemplateHash,ee as wrapApplicationError,ae as writeStateFile};

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

@@ -1,4 +1,5 @@
-import { type AppResourceFlags } from "./patternDetection.js";
+import { type AppResourceFlags } from "./patternTypes.js";
+import { type StepId } from "./stepDefinitions.js";
 import { toPascalCase } from "@fjall/util";
 /**
  * Application infrastructure stacks
@@ -190,4 +191,4 @@ export declare function getApplicationStepName(stack: ApplicationStack, action:
 /**
  * Step ID generators for tracking
  */
-export declare function getApplicationStepId(stack: ApplicationStack, action: "deploy" | "destroy"): string;
+export declare function getApplicationStepId(stack: ApplicationStack, action: "deploy" | "destroy"): StepId;

package/dist/src/types/operations.js

@@ -1,285 +1 @@
-import { isOpenNextPattern } from "./patternDetection.js";
-import { toPascalCase } from "@fjall/util";
-/**
- * Application infrastructure stacks
- */
-export const APPLICATION_STACKS = {
-    NETWORK: "Network",
-    DATABASE: "Database",
-    STORAGE: "Storage",
-    COMPUTE: "Compute",
-    CDN: "Cdn",
-    MESSAGING: "Messaging"
-};
-/**
- * Organisation infrastructure types
- * Note: These are deployment types, not stacks - each maps to a single CDK stack
- */
-export const ORGANISATION_TYPES = {
-    ORGANISATION: "organisation",
-    PLATFORM: "platform",
-    ACCOUNT: "account"
-};
-/**
- * Type guards for safe type narrowing
- */
-export function isApplicationOperation(op) {
-    return op.kind === "application";
-}
-export function isOrganisationOperation(op) {
-    return op.kind === "organisation";
-}
-/**
- * Stack ordering for application deployments
- */
-export const APPLICATION_DEPLOY_ORDER = [
-    APPLICATION_STACKS.NETWORK,
-    APPLICATION_STACKS.DATABASE,
-    APPLICATION_STACKS.COMPUTE
-];
-export const APPLICATION_DESTROY_ORDER = [
-    APPLICATION_STACKS.COMPUTE,
-    APPLICATION_STACKS.DATABASE,
-    APPLICATION_STACKS.NETWORK
-];
-/**
- * Stack ordering for OpenNext (Next.js/Payload) deployments
- * These patterns require additional infrastructure: S3, DynamoDB, SQS, CloudFront
- */
-export const OPENNEXT_DEPLOY_ORDER = [
-    APPLICATION_STACKS.NETWORK,
-    APPLICATION_STACKS.STORAGE,
-    APPLICATION_STACKS.MESSAGING,
-    APPLICATION_STACKS.DATABASE,
-    APPLICATION_STACKS.COMPUTE,
-    APPLICATION_STACKS.CDN
-];
-/**
- * Stack ordering for OpenNext destroy operations (reverse of deploy order)
- * CDN must be destroyed first as it depends on Compute, then work backwards
- */
-export const OPENNEXT_DESTROY_ORDER = [
-    APPLICATION_STACKS.CDN,
-    APPLICATION_STACKS.COMPUTE,
-    APPLICATION_STACKS.DATABASE,
-    APPLICATION_STACKS.MESSAGING,
-    APPLICATION_STACKS.STORAGE,
-    APPLICATION_STACKS.NETWORK
-];
-/**
- * Parallel deployment groups for concurrent stack deployment
- * Stacks within each phase can be deployed in parallel.
- *
- * Dependency structure:
- * - Phase 1: Network (required by all other stacks)
- * - Phase 2: Storage, Messaging, Database (independent of each other, only need Network)
- * - Phase 3: Compute (needs Database outputs)
- * - Phase 4: CDN (needs Compute outputs)
- */
-export const PARALLEL_DEPLOY_GROUPS = {
-    PHASE_1: {
-        phase: 1,
-        stacks: [APPLICATION_STACKS.NETWORK],
-        description: "Network infrastructure"
-    },
-    PHASE_2: {
-        phase: 2,
-        stacks: [
-            APPLICATION_STACKS.STORAGE,
-            APPLICATION_STACKS.MESSAGING,
-            APPLICATION_STACKS.DATABASE
-        ],
-        description: "Storage and database resources (parallel)"
-    },
-    PHASE_3: {
-        phase: 3,
-        stacks: [APPLICATION_STACKS.COMPUTE],
-        description: "Compute resources"
-    },
-    PHASE_4: {
-        phase: 4,
-        stacks: [APPLICATION_STACKS.CDN],
-        description: "CDN distribution"
-    }
-};
-/**
- * Parallel deployment groups for OpenNext (Next.js/Payload) deployments
- * Optimised to run BUILD in parallel with infrastructure stacks.
- */
-export const OPENNEXT_PARALLEL_GROUPS = {
-    /** Regular Next.js: BUILD + all Phase 2 stacks in parallel */
-    NEXTJS_PARALLEL: {
-        stacks: [
-            APPLICATION_STACKS.STORAGE,
-            APPLICATION_STACKS.MESSAGING,
-            APPLICATION_STACKS.DATABASE
-        ],
-        includeBuild: true,
-        description: "Build + Storage/Messaging/Database (parallel)"
-    },
-    /** Payload: BUILD + remaining stacks (after Database + migrations) */
-    PAYLOAD_PARALLEL: {
-        stacks: [APPLICATION_STACKS.STORAGE, APPLICATION_STACKS.MESSAGING],
-        includeBuild: true,
-        description: "Build + Storage/Messaging (parallel)"
-    }
-};
-/**
- * Get all parallel deploy groups as an ordered array
- */
-export function getParallelDeployGroups() {
-    return [
-        PARALLEL_DEPLOY_GROUPS.PHASE_1,
-        PARALLEL_DEPLOY_GROUPS.PHASE_2,
-        PARALLEL_DEPLOY_GROUPS.PHASE_3,
-        PARALLEL_DEPLOY_GROUPS.PHASE_4
-    ];
-}
-/**
- * Parallel destroy groups for OpenNext destroy operations.
- * Reverse of deploy order to respect dependencies.
- */
-export const PARALLEL_DESTROY_GROUPS = {
-    PHASE_1: {
-        phase: 1,
-        stacks: [APPLICATION_STACKS.CDN],
-        description: "CDN distribution"
-    },
-    PHASE_2: {
-        phase: 2,
-        stacks: [APPLICATION_STACKS.COMPUTE],
-        description: "Compute resources"
-    },
-    PHASE_3: {
-        phase: 3,
-        stacks: [
-            APPLICATION_STACKS.DATABASE,
-            APPLICATION_STACKS.MESSAGING,
-            APPLICATION_STACKS.STORAGE
-        ],
-        description: "Database, messaging, and storage (parallel)"
-    },
-    PHASE_4: {
-        phase: 4,
-        stacks: [APPLICATION_STACKS.NETWORK],
-        description: "Network infrastructure"
-    }
-};
-/**
- * Get all parallel destroy groups as an ordered array
- */
-export function getParallelDestroyGroups() {
-    return [
-        PARALLEL_DESTROY_GROUPS.PHASE_1,
-        PARALLEL_DESTROY_GROUPS.PHASE_2,
-        PARALLEL_DESTROY_GROUPS.PHASE_3,
-        PARALLEL_DESTROY_GROUPS.PHASE_4
-    ];
-}
-/**
- * Deploy tier priority — lower number deploys first, higher destroys first.
- * Used for dynamic ordering based on manifest-detected resources.
- */
-const STACK_DEPLOY_TIER = {
-    Network: 1,
-    Storage: 2,
-    Messaging: 2,
-    Database: 2,
-    Compute: 3,
-    Cdn: 4
-};
-/**
- * Get deployment order based on application configuration.
- *
- * Strategies:
- * 1. OpenNext (pattern = "payload" or "nextjs"): Predefined order (build orchestration)
- * 2. Dynamic: Include only detected stacks, ordered by tier
- * 3. Fallback: Standard order (no manifest available)
- */
-export function getApplicationDeployOrder(options) {
-    const { pattern, resources } = options ?? {};
-    if (isOpenNextPattern(pattern)) {
-        return OPENNEXT_DEPLOY_ORDER;
-    }
-    if (resources) {
-        return buildOrderFromResources(resources, "asc");
-    }
-    return APPLICATION_DEPLOY_ORDER;
-}
-/**
- * Get destroy order based on application configuration.
- * Destroy order respects dependencies (reverse of deploy order).
- */
-export function getApplicationDestroyOrder(options) {
-    const { pattern, resources } = options ?? {};
-    if (isOpenNextPattern(pattern)) {
-        return OPENNEXT_DESTROY_ORDER;
-    }
-    if (resources) {
-        return buildOrderFromResources(resources, "desc");
-    }
-    return APPLICATION_DESTROY_ORDER;
-}
-/**
- * Build a stack order from resource flags, sorted by tier priority.
- */
-function buildOrderFromResources(resources, direction) {
-    const stacks = [];
-    if (resources.hasNetwork)
-        stacks.push(APPLICATION_STACKS.NETWORK);
-    if (resources.hasStorage)
-        stacks.push(APPLICATION_STACKS.STORAGE);
-    if (resources.hasMessaging)
-        stacks.push(APPLICATION_STACKS.MESSAGING);
-    if (resources.hasDatabase)
-        stacks.push(APPLICATION_STACKS.DATABASE);
-    if (resources.hasCompute)
-        stacks.push(APPLICATION_STACKS.COMPUTE);
-    if (resources.hasCdn)
-        stacks.push(APPLICATION_STACKS.CDN);
-    return stacks.sort((a, b) => {
-        const diff = STACK_DEPLOY_TIER[a] - STACK_DEPLOY_TIER[b];
-        return direction === "asc" ? diff : -diff;
-    });
-}
-/**
- * Helper functions for stack operations
- */
-export { toPascalCase };
-export function getApplicationStackName(appName, stack) {
-    return `${toPascalCase(appName)}${stack}`;
-}
-export function getOrganisationStackName(type) {
-    switch (type) {
-        case "organisation":
-            return "Organisation";
-        case "platform":
-            return "Platform";
-        case "account":
-            return "Account";
-        default: {
-            const _exhaustive = type;
-            throw new Error(`Unsupported organisation type: ${String(_exhaustive)}`);
-        }
-    }
-}
-/**
- * Type guard for ApplicationStack
- */
-export function isApplicationStack(value) {
-    return Object.values(APPLICATION_STACKS).includes(value);
-}
-/**
- * Step name generators for UI display
- */
-export function getApplicationStepName(stack, action) {
-    const verb = action === "deploy" ? "Deploying" : "Destroying";
-    return `${verb} ${stack.toLowerCase()} infrastructure`;
-}
-/**
- * Step ID generators for tracking
- */
-export function getApplicationStepId(stack, action) {
-    const suffix = action === "destroy" ? "-destroy" : "";
-    return `${stack.toLowerCase()}${suffix}`;
-}
+import{isOpenNextPattern as i}from"./patternTypes.js";import{STEP_IDS as s}from"./stepDefinitions.js";import{toPascalCase as E}from"@fjall/util";const t={NETWORK:"Network",DATABASE:"Database",STORAGE:"Storage",COMPUTE:"Compute",CDN:"Cdn",MESSAGING:"Messaging"},C={ORGANISATION:"organisation",PLATFORM:"platform",ACCOUNT:"account"};function G(e){return e.kind==="application"}function g(e){return e.kind==="organisation"}const T=[t.NETWORK,t.DATABASE,t.COMPUTE],u=[t.COMPUTE,t.DATABASE,t.NETWORK],P=[t.NETWORK,t.STORAGE,t.MESSAGING,t.DATABASE,t.COMPUTE,t.CDN],N=[t.CDN,t.COMPUTE,t.DATABASE,t.MESSAGING,t.STORAGE,t.NETWORK],n={PHASE_1:{phase:1,stacks:[t.NETWORK],description:"Network infrastructure"},PHASE_2:{phase:2,stacks:[t.STORAGE,t.MESSAGING,t.DATABASE],description:"Storage and database resources (parallel)"},PHASE_3:{phase:3,stacks:[t.COMPUTE],description:"Compute resources"},PHASE_4:{phase:4,stacks:[t.CDN],description:"CDN distribution"}},f={NEXTJS_PARALLEL:{stacks:[t.STORAGE,t.MESSAGING,t.DATABASE],includeBuild:!0,description:"Build + Storage/Messaging/Database (parallel)"},PAYLOAD_PARALLEL:{stacks:[t.STORAGE,t.MESSAGING],includeBuild:!0,description:"Build + Storage/Messaging (parallel)"}};function I(){return[n.PHASE_1,n.PHASE_2,n.PHASE_3,n.PHASE_4]}const a={PHASE_1:{phase:1,stacks:[t.CDN],description:"CDN distribution"},PHASE_2:{phase:2,stacks:[t.COMPUTE],description:"Compute resources"},PHASE_3:{phase:3,stacks:[t.DATABASE,t.MESSAGING,t.STORAGE],description:"Database, messaging, and storage (parallel)"},PHASE_4:{phase:4,stacks:[t.NETWORK],description:"Network infrastructure"}};function L(){return[a.PHASE_1,a.PHASE_2,a.PHASE_3,a.PHASE_4]}const S={Network:1,Storage:2,Messaging:2,Database:2,Compute:3,Cdn:4};function M(e){const{pattern:o,resources:r}=e??{};return i(o)?P:r?p(r,"asc"):T}function h(e){const{pattern:o,resources:r}=e??{};return i(o)?N:r?p(r,"desc"):u}function p(e,o){const r=[];return e.hasNetwork&&r.push(t.NETWORK),e.hasStorage&&r.push(t.STORAGE),e.hasMessaging&&r.push(t.MESSAGING),e.hasDatabase&&r.push(t.DATABASE),e.hasCompute&&r.push(t.COMPUTE),e.hasCdn&&r.push(t.CDN),r.sort((c,O)=>{const A=S[c]-S[O];return o==="asc"?A:-A})}function x(e,o){return`${E(e)}${o}`}function k(e){switch(e){case"organisation":return"Organisation";case"platform":return"Platform";case"account":return"Account";default:{const o=e;throw new Error(`Unsupported organisation type: ${String(o)}`)}}}const D=new Set(Object.values(t));function m(e){return D.has(e)}function y(e,o){return`${o==="deploy"?"Deploying":"Destroying"} ${e.toLowerCase()} infrastructure`}const R={[t.NETWORK]:{deploy:s.NETWORK,destroy:s.NETWORK_DESTROY},[t.DATABASE]:{deploy:s.DATABASE,destroy:s.DATABASE_DESTROY},[t.STORAGE]:{deploy:s.STORAGE,destroy:s.STORAGE_DESTROY},[t.COMPUTE]:{deploy:s.COMPUTE,destroy:s.COMPUTE_DESTROY},[t.CDN]:{deploy:s.CDN,destroy:s.CDN_DESTROY},[t.MESSAGING]:{deploy:s.MESSAGING,destroy:s.MESSAGING_DESTROY}};function U(e,o){return R[e][o]}export{T as APPLICATION_DEPLOY_ORDER,u as APPLICATION_DESTROY_ORDER,t as APPLICATION_STACKS,P as OPENNEXT_DEPLOY_ORDER,N as OPENNEXT_DESTROY_ORDER,f as OPENNEXT_PARALLEL_GROUPS,C as ORGANISATION_TYPES,n as PARALLEL_DEPLOY_GROUPS,a as PARALLEL_DESTROY_GROUPS,M as getApplicationDeployOrder,h as getApplicationDestroyOrder,x as getApplicationStackName,U as getApplicationStepId,y as getApplicationStepName,k as getOrganisationStackName,I as getParallelDeployGroups,L as getParallelDestroyGroups,G as isApplicationOperation,m as isApplicationStack,g as isOrganisationOperation,E as toPascalCase};

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

@@ -8,6 +8,8 @@
  * Passed to CDK via -c orgConfig=<json> context at synthesis time.
  * See: investigations/2026-03-16-config-split-investigation.md
  */
+import type { ProviderAccount, SSOSession } from "@fjall/util/config";
+export type { ProviderAccount, SSOSession };
 export interface OrgConfig {
     providerAccounts: ProviderAccount[];
     primaryRegion?: string;
@@ -16,13 +18,3 @@ export interface OrgConfig {
     rootOidcRoleArn?: string;
     ssoSessions?: Record<string, SSOSession>;
 }
-export interface ProviderAccount {
-    id: string;
-    name: string;
-    environment: string;
-    managed?: boolean;
-}
-export interface SSOSession {
-    ssoRegion: string;
-    ssoStartUrl: string;
-}

package/dist/src/types/orgConfig.js

@@ -1,11 +0,0 @@
-/**
- * Organisation-level configuration.
- *
- * This config is injected by the caller, not read from disk:
- * - CLI: fetches from GET /api/organisation-config (cached locally with TTL)
- * - Worker: reads from DB (Organization + ConnectedAwsAccount models)
- *
- * Passed to CDK via -c orgConfig=<json> context at synthesis time.
- * See: investigations/2026-03-16-config-split-investigation.md
- */
-export {};

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

@@ -60,7 +60,7 @@ export interface DeployOptions {
     deployOnly?: boolean;
     passThroughCDK?: boolean;
     environment?: string;
-    /** Skip OIDC provider creation — set when OIDC is already configured (webapp Quick Create). */
+    /** Skip OIDC connector deployment in the Account stack — set when the OIDC connector was already provisioned separately (e.g. via the webapp CloudFormation quick-create flow). */
     skipOidc?: boolean;
 }
 export type DeploymentType = "application" | "organisation";
@@ -69,8 +69,67 @@ export interface DeployResult {
     deploymentType: DeploymentType;
     /** Stack outputs (website URL, OIDC role ARN, etc.) */
     outputs?: Record<string, string>;
+    /** Per-account outputs from cascade deploys (accountId → stack outputs). */
+    cascadeOutputs?: Array<{
+        accountId: string;
+        outputs: Record<string, string>;
+    }>;
     /** Duration in milliseconds */
     durationMs?: number;
+    /** Non-fatal warnings (e.g. cascade account failures) */
+    warnings?: string[];
+}
+/**
+ * Parameters for the destroy entry point.
+ *
+ * Mirrors DeployParams but excludes deploy-only concerns (Docker,
+ * detection, deployOnly/infraOnly). Destroy needs credentials,
+ * working directory, and callbacks — nothing more.
+ */
+export interface DestroyParams {
+    /** Target name (e.g., "my-app", "organisation", "platform", "account-prod") */
+    target: string;
+    /** Absolute path to the repository root containing fjall-config.json */
+    workingDirectory: string;
+    /** AWS credentials for the operation. deploy-core never resolves these itself. */
+    awsCredentials: AwsCredentials;
+    /** Typed callbacks for progress events. CLI and worker implement differently. */
+    callbacks: DeployCallbacks;
+    /** Destroy options */
+    options?: DestroyOptions;
+    /**
+     * Org-level config (accounts, regions, OIDC).
+     * Passed to CDK via -c orgConfig=<json> context.
+     */
+    orgConfig?: OrgConfig;
+    /**
+     * Pre-fetched identity for org deployments.
+     * CLI: omit this, provide apiClient instead.
+     * Worker: provide this from DB, omit apiClient.
+     */
+    identity?: DeployIdentity;
+}
+export interface DestroyOptions {
+    /** Skip interactive confirmation prompts */
+    skipConfirmation?: boolean;
+    /** Force destroy even when stacks are in unusual states */
+    force?: boolean;
+    /** Cascade destroy to child accounts (org type only) */
+    cascade?: boolean;
+    /** Verbose output */
+    verbose?: boolean;
+}
+export interface DestroyResult {
+    target: string;
+    deploymentType: DeploymentType;
+    /** Duration in milliseconds */
+    durationMs?: number;
+    /** Stacks that were successfully destroyed */
+    stacksDestroyed?: string[];
+    /** Stacks that were skipped (already deleted) */
+    skippedStacks?: string[];
+    /** Non-fatal warnings (e.g. cascade account failures) */
+    warnings?: string[];
 }
 /** Re-export Result from generator for consumers. */
 export type { Result };

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

@@ -1,24 +1,20 @@
 /**
- * Pattern detection types and functions.
+ * Filesystem-based pattern detection functions.
  *
- * Contains both pure predicates used by operations.ts and
- * filesystem-based detection functions used by orchestration services.
+ * Pure types and predicates live in patternTypes.ts (browser-safe).
+ * This file contains only functions that require Node fs access.
  */
 import type { PatternType } from "@fjall/generator";
-declare const OPENNEXT_PATTERNS_ARRAY: readonly ["payload", "nextjs"];
-export type OpenNextPattern = (typeof OPENNEXT_PATTERNS_ARRAY)[number];
-export declare const OPENNEXT_PATTERNS: Set<string>;
-export declare function isOpenNextPattern(pattern: string | undefined | null): pattern is OpenNextPattern;
-export interface AppResourceFlags {
-    hasNetwork: boolean;
-    hasCompute: boolean;
-    hasDatabase: boolean;
-    hasStorage: boolean;
-    hasMessaging: boolean;
-    hasCdn: boolean;
-}
+export type { OpenNextPattern, AppResourceFlags } from "./patternTypes.js";
+export { OPENNEXT_PATTERNS, isOpenNextPattern } from "./patternTypes.js";
+import type { AppResourceFlags } from "./patternTypes.js";
 /** Derive resource flags from manifest stack names (authoritative, post-synth) */
 export declare function deriveResourcesFromManifestStacks(stackNames: string[]): AppResourceFlags;
+/**
+ * Read infrastructure.ts content from an app path.
+ * Returns null if file doesn't exist or can't be read.
+ */
+export declare function readInfrastructureContent(appPath: string): string | null;
 /**
  * Detect the application pattern (Payload, Next.js, or none) from infrastructure.ts.
  *
@@ -26,6 +22,9 @@ export declare function deriveResourcesFromManifestStacks(stackNames: string[]):
  * project files like package.json. This ensures accurate detection even
  * when multiple apps coexist in the same project directory.
  *
+ * @deprecated Use FrameworkRegistry.resolve() instead. This function is retained
+ * for backwards compatibility with consumers that have not yet migrated.
+ *
  * @param appPath - The fjall app path (e.g., "fjall/app8" or absolute path)
  */
 export declare function detectPattern(appPath: string): {
@@ -40,4 +39,3 @@ export declare function detectPayloadPattern(appPath: string): boolean;
  * Detect if infrastructure.ts contains a database resource.
  */
 export declare function detectDatabase(appPath: string): boolean;
-export {};