fjall 0.96.0 → 0.99.1

package/bin/assets/src/util/index.d.ts

@@ -0,0 +1,50 @@
+export { buildCoreFjallTags } from "./awsTags.js";
+export type { FjallTag } from "./awsTags.js";
+export { toPascalCase, toKebab, capitalise } from "./caseConversion.js";
+export { parseColour, toHex, interpolateColour } from "./colourUtils.js";
+export type { RGB } from "./colourUtils.js";
+export { registerUnknownCommandHandler } from "./commandErrorHandler.js";
+export type { CommandInfo } from "./commandErrorHandler.js";
+export { SilentExitError, handleUIResult, handleServiceResult, throwOnFailure, handleCommandError, throwIfInvalidOptions, requireOption, requireArg, throwUnknownSubcommand, createCLIProgressCallback, createProgressHandler, validateRequiredArgs, throwIfMissingFields } from "./commandResult.js";
+export type { CommandResult } from "./commandResult.js";
+export { DeploymentProgressEventSchema, categoriseResource, getExpectedDuration, logEvent, toDeploymentEvent } from "./deploymentEvents.js";
+export type { DeploymentProgressEvent, ResourceCategory, CascadePhase, CascadeAccountStatus } from "./deploymentEvents.js";
+export { displayValidationError } from "./errorDisplay.js";
+export { normaliseError, getErrorMessage, hasErrorCode, getErrorCode, getErrorStack, formatErrorString } from "./errorUtils.js";
+export { isNonInteractiveMode } from "./executionMode.js";
+export type { NonInteractiveOptions } from "./executionMode.js";
+export { fuzzyMatch, fuzzyFilter } from "./fuzzyMatch.js";
+export type { FuzzyPickerOption, FuzzyMatchResult, FuzzyFilterResult } from "./fuzzyMatch.js";
+export { detectGitInfo } from "./gitDetection.js";
+export type { GitInfo } from "./gitDetection.js";
+export { LoggingControl, getLoggingControl, info, message, success, warning, error, handleError, tip, step, startSpinner, updateSpinner, stopSpinner } from "./log.js";
+export { ORGANISATION_DIRS, ORGANISATION_TARGETS } from "./organisationStructure.js";
+export type { OrganisationDir, OrganisationTarget } from "./organisationStructure.js";
+export { validateRdsPassword, validatePasswordConfirmation, validateAllPasswords, allPasswordsValid } from "./passwordValidation.js";
+export type { ValidationResult } from "./passwordValidation.js";
+export { getFjallPath, getProjectRoot, getAppNameFromInfrastructure, getAppName, getInfrastructurePath, getAppPath, getOrganisationComponentPath, getDeploymentLogsPath, getCloudFormationLogsPath, getDomainsDir, getDomainComponentPath, getDomainInfrastructurePath, getDomainZoneFilePath, INFRASTRUCTURE_FILENAME, ZONE_BIND_FILENAME, CDK_OUT_DIR, getCdkOutPath } from "./pathHelpers.js";
+export { OPENNEXT_PATTERNS, isOpenNextPattern, deriveResourcesFromManifestStacks, detectPattern, detectPayload, detectDatabase } from "./patternDetection.js";
+export type { OpenNextPattern, AppResourceFlags } from "./patternDetection.js";
+export { promptYesNo } from "./promptYesNo.js";
+export { readStdinWithTimeout } from "./readStdin.js";
+export { APP_NAME_PATTERN, SECRET_NAME_PATTERN, APP_NAME_ERROR, SECRET_NAME_ERROR, formatNamespace, buildParameterPath, parseNamespaceFromPath, isValidAppName, isValidNamespace, isValidSecretName, parseDotEnv, parseKeyValue, readSecretValueFromFile, readDotEnvFile, formatSecretsTable } from "./secretsUtils.js";
+export { withSignalCleanup } from "./signalCleanup.js";
+export { stripAnsi } from "./stripAnsi.js";
+export { truncateMiddle } from "./truncateMiddle.js";
+export { SYNC_OUTPUT_SUPPORTED, wrapSynchronizedOutput, synchronize, BSU, ESU } from "./synchronizedOutput.js";
+export { getAvailableTargets, getOrganisationTargets, getApplicationTargets, isOrganisationTarget, validateTarget } from "./targetDetection.js";
+export type { TargetType, Target, TargetValidationResult } from "./targetDetection.js";
+export { TARGET_MESSAGES, filterNonRootAccounts, loadActiveTarget, saveActiveTarget } from "./targetHelpers.js";
+export { initTerminalCapabilities, isTmux, isTmuxClamped, isXtermJsBoosted, isFullColor, is256Color, _resetTerminalCapabilities } from "./terminalCapabilities.js";
+export { CURSOR_HOME, SHOW_CURSOR, HIDE_CURSOR, CLEAR_SCREEN, CLEAR_SCROLLBACK, ENTER_ALT_BUFFER, EXIT_ALT_BUFFER, DISABLE_MOUSE_TRACKING, DISABLE_FOCUS_REPORTING, DISABLE_BRACKETED_PASTE, writeToClipboard } from "./terminalEscapes.js";
+export { enableFocusReporting, disableFocusReporting, onFocusChange, isTerminalFocused, _resetFocusReporting } from "./terminalFocus.js";
+export { theme, getActivePalette, setActivePalette, _resetPalette } from "./theme.js";
+export type { Colour, PaletteName, Theme } from "./theme.js";
+export { isStringRecord } from "./typeGuards.js";
+export { routeToUIIfInteractive, routeToUIIfInteractiveExtended } from "./uiRouter.js";
+export type { UIRouteResult } from "./uiRouter.js";
+export { removeProtocol } from "./urlHelpers.js";
+export { upgradeHint } from "./versionDisplay.js";
+export * from "./api/index.js";
+export * from "./logger/index.js";
+export * from "./nonInteractive/index.js";

package/bin/assets/src/util/index.js

@@ -0,0 +1 @@
+import{buildCoreFjallTags as t}from"./awsTags.js";import{toPascalCase as a,toKebab as i,capitalise as n}from"./caseConversion.js";import{parseColour as p,toHex as m,interpolateColour as l}from"./colourUtils.js";import{registerUnknownCommandHandler as g}from"./commandErrorHandler.js";import{SilentExitError as f,handleUIResult as c,handleServiceResult as R,throwOnFailure as T,handleCommandError as u,throwIfInvalidOptions as A,requireOption as S,requireArg as x,throwUnknownSubcommand as P,createCLIProgressCallback as C,createProgressHandler as _,validateRequiredArgs as N,throwIfMissingFields as I}from"./commandResult.js";import{DeploymentProgressEventSchema as O,categoriseResource as F,getExpectedDuration as v,logEvent as D,toDeploymentEvent as U}from"./deploymentEvents.js";import{displayValidationError as M}from"./errorDisplay.js";import{normaliseError as w,getErrorMessage as y,hasErrorCode as B,getErrorCode as G,getErrorStack as H,formatErrorString as V}from"./errorUtils.js";import{isNonInteractiveMode as z}from"./executionMode.js";import{fuzzyMatch as j,fuzzyFilter as q}from"./fuzzyMatch.js";import{detectGitInfo as W}from"./gitDetection.js";import{LoggingControl as Z,getLoggingControl as J,info as Q,message as $,success as ee,warning as re,error as te,handleError as oe,tip as ae,step as ie,startSpinner as ne,updateSpinner as se,stopSpinner as pe}from"./log.js";import{ORGANISATION_DIRS as le,ORGANISATION_TARGETS as Ee}from"./organisationStructure.js";import{validateRdsPassword as de,validatePasswordConfirmation as fe,validateAllPasswords as ce,allPasswordsValid as Re}from"./passwordValidation.js";import{getFjallPath as ue,getProjectRoot as Ae,getAppNameFromInfrastructure as Se,getAppName as xe,getInfrastructurePath as Pe,getAppPath as Ce,getOrganisationComponentPath as _e,getDeploymentLogsPath as Ne,getCloudFormationLogsPath as Ie,getDomainsDir as he,getDomainComponentPath as Oe,getDomainInfrastructurePath as Fe,getDomainZoneFilePath as ve,INFRASTRUCTURE_FILENAME as De,ZONE_BIND_FILENAME as Ue,CDK_OUT_DIR as Le,getCdkOutPath as Me}from"./pathHelpers.js";import{OPENNEXT_PATTERNS as we,isOpenNextPattern as ye,deriveResourcesFromManifestStacks as Be,detectPattern as Ge,detectPayload as He,detectDatabase as Ve}from"./patternDetection.js";import{promptYesNo as ze}from"./promptYesNo.js";import{readStdinWithTimeout as je}from"./readStdin.js";import{APP_NAME_PATTERN as Xe,SECRET_NAME_PATTERN as We,APP_NAME_ERROR as Ye,SECRET_NAME_ERROR as Ze,formatNamespace as Je,buildParameterPath as Qe,parseNamespaceFromPath as $e,isValidAppName as er,isValidNamespace as rr,isValidSecretName as tr,parseDotEnv as or,parseKeyValue as ar,readSecretValueFromFile as ir,readDotEnvFile as nr,formatSecretsTable as sr}from"./secretsUtils.js";import{withSignalCleanup as mr}from"./signalCleanup.js";import{stripAnsi as Er}from"./stripAnsi.js";import{truncateMiddle as dr}from"./truncateMiddle.js";import{SYNC_OUTPUT_SUPPORTED as cr,wrapSynchronizedOutput as Rr,synchronize as Tr,BSU as ur,ESU as Ar}from"./synchronizedOutput.js";import{getAvailableTargets as xr,getOrganisationTargets as Pr,getApplicationTargets as Cr,isOrganisationTarget as _r,validateTarget as Nr}from"./targetDetection.js";import{TARGET_MESSAGES as hr,filterNonRootAccounts as Or,loadActiveTarget as Fr,saveActiveTarget as vr}from"./targetHelpers.js";import{initTerminalCapabilities as Ur,isTmux as Lr,isTmuxClamped as Mr,isXtermJsBoosted as br,isFullColor as wr,is256Color as yr,_resetTerminalCapabilities as Br}from"./terminalCapabilities.js";import{CURSOR_HOME as Hr,SHOW_CURSOR as Vr,HIDE_CURSOR as kr,CLEAR_SCREEN as zr,CLEAR_SCROLLBACK as Kr,ENTER_ALT_BUFFER as jr,EXIT_ALT_BUFFER as qr,DISABLE_MOUSE_TRACKING as Xr,DISABLE_FOCUS_REPORTING as Wr,DISABLE_BRACKETED_PASTE as Yr,writeToClipboard as Zr}from"./terminalEscapes.js";import{enableFocusReporting as Qr,disableFocusReporting as $r,onFocusChange as et,isTerminalFocused as rt,_resetFocusReporting as tt}from"./terminalFocus.js";import{theme as at,getActivePalette as it,setActivePalette as nt,_resetPalette as st}from"./theme.js";import{isStringRecord as mt}from"./typeGuards.js";import{routeToUIIfInteractive as Et,routeToUIIfInteractiveExtended as gt}from"./uiRouter.js";import{removeProtocol as ft}from"./urlHelpers.js";import{upgradeHint as Rt}from"./versionDisplay.js";export*from"./api/index.js";export*from"./logger/index.js";export*from"./nonInteractive/index.js";export{Ye as APP_NAME_ERROR,Xe as APP_NAME_PATTERN,ur as BSU,Le as CDK_OUT_DIR,zr as CLEAR_SCREEN,Kr as CLEAR_SCROLLBACK,Hr as CURSOR_HOME,Yr as DISABLE_BRACKETED_PASTE,Wr as DISABLE_FOCUS_REPORTING,Xr as DISABLE_MOUSE_TRACKING,O as DeploymentProgressEventSchema,jr as ENTER_ALT_BUFFER,Ar as ESU,qr as EXIT_ALT_BUFFER,kr as HIDE_CURSOR,De as INFRASTRUCTURE_FILENAME,Z as LoggingControl,we as OPENNEXT_PATTERNS,le as ORGANISATION_DIRS,Ee as ORGANISATION_TARGETS,Ze as SECRET_NAME_ERROR,We as SECRET_NAME_PATTERN,Vr as SHOW_CURSOR,cr as SYNC_OUTPUT_SUPPORTED,f as SilentExitError,hr as TARGET_MESSAGES,Ue as ZONE_BIND_FILENAME,tt as _resetFocusReporting,st as _resetPalette,Br as _resetTerminalCapabilities,Re as allPasswordsValid,t as buildCoreFjallTags,Qe as buildParameterPath,n as capitalise,F as categoriseResource,C as createCLIProgressCallback,_ as createProgressHandler,Be as deriveResourcesFromManifestStacks,Ve as detectDatabase,W as detectGitInfo,Ge as detectPattern,He as detectPayload,$r as disableFocusReporting,M as displayValidationError,Qr as enableFocusReporting,te as error,Or as filterNonRootAccounts,V as formatErrorString,Je as formatNamespace,sr as formatSecretsTable,q as fuzzyFilter,j as fuzzyMatch,it as getActivePalette,xe as getAppName,Se as getAppNameFromInfrastructure,Ce as getAppPath,Cr as getApplicationTargets,xr as getAvailableTargets,Me as getCdkOutPath,Ie as getCloudFormationLogsPath,Ne as getDeploymentLogsPath,Oe as getDomainComponentPath,Fe as getDomainInfrastructurePath,ve as getDomainZoneFilePath,he as getDomainsDir,G as getErrorCode,y as getErrorMessage,H as getErrorStack,v as getExpectedDuration,ue as getFjallPath,Pe as getInfrastructurePath,J as getLoggingControl,_e as getOrganisationComponentPath,Pr as getOrganisationTargets,Ae as getProjectRoot,u as handleCommandError,oe as handleError,R as handleServiceResult,c as handleUIResult,B as hasErrorCode,Q as info,Ur as initTerminalCapabilities,l as interpolateColour,yr as is256Color,wr as isFullColor,z as isNonInteractiveMode,ye as isOpenNextPattern,_r as isOrganisationTarget,mt as isStringRecord,rt as isTerminalFocused,Lr as isTmux,Mr as isTmuxClamped,er as isValidAppName,rr as isValidNamespace,tr as isValidSecretName,br as isXtermJsBoosted,Fr as loadActiveTarget,D as logEvent,$ as message,w as normaliseError,et as onFocusChange,p as parseColour,or as parseDotEnv,ar as parseKeyValue,$e as parseNamespaceFromPath,ze as promptYesNo,nr as readDotEnvFile,ir as readSecretValueFromFile,je as readStdinWithTimeout,g as registerUnknownCommandHandler,ft as removeProtocol,x as requireArg,S as requireOption,Et as routeToUIIfInteractive,gt as routeToUIIfInteractiveExtended,vr as saveActiveTarget,nt as setActivePalette,ne as startSpinner,ie as step,pe as stopSpinner,Er as stripAnsi,ee as success,Tr as synchronize,at as theme,A as throwIfInvalidOptions,I as throwIfMissingFields,T as throwOnFailure,P as throwUnknownSubcommand,ae as tip,U as toDeploymentEvent,m as toHex,i as toKebab,a as toPascalCase,dr as truncateMiddle,se as updateSpinner,Rt as upgradeHint,ce as validateAllPasswords,fe as validatePasswordConfirmation,de as validateRdsPassword,N as validateRequiredArgs,Nr as validateTarget,re as warning,mr as withSignalCleanup,Rr as wrapSynchronizedOutput,Zr as writeToClipboard};

package/bin/assets/src/util/log.d.ts

@@ -0,0 +1,29 @@
+import { type Ora } from "ora";
+export declare class LoggingControl {
+    private static instance;
+    private _verbose;
+    private constructor();
+    static getInstance(): LoggingControl;
+    get verbose(): boolean;
+    set verbose(value: boolean);
+}
+export declare function getLoggingControl(): LoggingControl;
+export declare function info(message?: unknown, ...optionalParams: unknown[]): void;
+export declare function message(message?: unknown, ...optionalParams: unknown[]): void;
+export declare function success(message?: unknown, ...optionalParams: unknown[]): void;
+export declare function warning(message?: unknown, ...optionalParams: unknown[]): void;
+export declare function error(message?: unknown, ...optionalParams: unknown[]): void;
+/**
+ * Handles errors with consistent formatting and support information
+ */
+export declare function handleError(err: unknown, errorMessage: string, options?: {
+    tipMessage?: string;
+    supportEmail?: string;
+    learnMoreUrl?: string;
+    throwError?: boolean;
+}): unknown;
+export declare function tip(message?: unknown, ...optionalParams: unknown[]): void;
+export declare function step(message?: unknown): void;
+export declare function startSpinner(text: string): Ora | null;
+export declare function updateSpinner(text: string): Ora | null;
+export declare function stopSpinner(): void;

package/bin/assets/src/util/log.js

@@ -0,0 +1,4 @@
+import o from"chalk";import i from"ora";import{ContextManager as n}from"../contexts/index.js";const p={interval:150,frames:["\u2726","\u2727","\u2736","\u2737","\u2738","\u2739","\u273A","\u273B"]};let e=null;class u{static instance;_verbose=!0;constructor(){}static getInstance(){return u.instance||(u.instance=new u),u.instance}get verbose(){return this._verbose}set verbose(t){this._verbose=t}}function S(){return u.getInstance()}function c(r,...t){n.shouldSuppressOutput||(e&&e.stop(),console.log(r,...t),e&&e.start())}function b(r,...t){c(r,...t)}function F(r,...t){n.shouldSuppressOutput||(e?(e.succeed(o.hex("#A4C2A5")(`\u2705 ${r}`)),e=null):console.log(o.hex("#A4C2A5")(`\u2705 ${r}`),...t))}function $(r,...t){n.shouldSuppressOutput||(e?(e.warn(`\u26A0\uFE0F ${r}`),e=null):console.log(o.yellow(`\u26A0\uFE0F ${r}`),...t))}function f(r,...t){n.shouldSuppressOutput||(e?(e.fail(o.red.bold(`\u274C Error: ${r}`)),e=null):console.error(o.red.bold(`\u274C Error: ${r}`),...t))}function g(r,t,s){if(f(t),n.shouldSuppressOutput||console.error(r),s?.tipMessage&&a(s.tipMessage),s?.supportEmail&&!n.shouldSuppressOutput&&(console.log(o.yellow(`
+Please contact ${o.bold(s.supportEmail)} for assistance with this issue.`)),console.log(o.yellow("Include the error details above in your support request."))),s?.learnMoreUrl&&!n.shouldSuppressOutput&&console.log(o.blue(`
+\u{1F4D8} Learn more: ${s.learnMoreUrl}`)),s?.throwError!==!1)throw r;return r}function a(r,...t){n.shouldSuppressOutput||(e&&e.stop(),console.log(o.blue(`\u{1F4A1} Tip: ${r}`),...t),e&&e.start())}function m(r){n.shouldSuppressOutput||(e&&e.stop(),console.log(`
+${o.hex("#D9622E").bold(`--- ${r} ---`)}`),e&&e.start())}function l(){return n.shouldSuppressOutput||n.isNonInteractive}function O(r){if(l())return null;if(e)return e.text=r,e;const t=o.hex("#FF7BFF")(r);return e=i({text:t,spinner:p,color:"magenta"}).start(),e}function v(r){if(l())return null;if(e)e.text=o.hex("#FF7BFF")(r);else{const t=o.hex("#FF7BFF")(r);e=i({text:t,spinner:p,color:"magenta"}).start()}return e}function w(){l()||e&&(e.stop(),e=null)}export{u as LoggingControl,f as error,S as getLoggingControl,g as handleError,c as info,b as message,O as startSpinner,m as step,w as stopSpinner,F as success,a as tip,v as updateSpinner,$ as warning};

package/bin/assets/src/util/logger/CorrelatedLogger.d.ts

@@ -0,0 +1,15 @@
+import type { Logger } from "./Logger.js";
+/**
+ * Logger with correlation ID bound
+ */
+export declare class CorrelatedLogger {
+    private logger;
+    private correlationId;
+    constructor(logger: Logger, correlationId: string);
+    private log;
+    error(component: string, message: string, data?: Record<string, unknown>): void;
+    warn(component: string, message: string, data?: Record<string, unknown>): void;
+    info(component: string, message: string, data?: Record<string, unknown>): void;
+    debug(component: string, message: string, data?: Record<string, unknown>): void;
+    trace(component: string, message: string, data?: Record<string, unknown>): void;
+}

package/bin/assets/src/util/logger/CorrelatedLogger.js

@@ -0,0 +1 @@
+class i{logger;correlationId;constructor(o,r){this.logger=o,this.correlationId=r}log(o,r,t,e){this.logger.logWithCorrelation(o,r,t,this.correlationId,e)}error(o,r,t){this.log("error",o,r,t)}warn(o,r,t){this.log("warn",o,r,t)}info(o,r,t){this.log("info",o,r,t)}debug(o,r,t){this.log("debug",o,r,t)}trace(o,r,t){this.log("trace",o,r,t)}}export{i as CorrelatedLogger};

package/bin/assets/src/util/logger/DeploymentLogger.d.ts

@@ -0,0 +1,33 @@
+import type { DeploymentLogger, LogLevel } from "./types.js";
+export interface LoggerInterface {
+    logWithCorrelation(level: LogLevel, component: string, message: string, correlationId: string, data?: Record<string, unknown>, stackName?: string, phase?: string): void;
+}
+export declare class DeploymentLoggerImpl implements DeploymentLogger {
+    private mainLogger;
+    private appName;
+    private operationType;
+    private logStream;
+    private logPath;
+    private deploymentId;
+    private buffer;
+    private flushInterval;
+    private isClosing;
+    private readonly maxBufferSize;
+    constructor(mainLogger: LoggerInterface, appName: string, operationType: string);
+    private log;
+    private flush;
+    info(component: string, message: string, data?: Record<string, unknown>): void;
+    warn(component: string, message: string, data?: Record<string, unknown>): void;
+    error(component: string, message: string, data?: Record<string, unknown>): void;
+    debug(component: string, message: string, data?: Record<string, unknown>): void;
+    stackEvent(stackName: string, phase: string, message: string, data?: Record<string, unknown>): void;
+    dockerEvent(message: string, percentage?: number): void;
+    ecsEvent(message: string, percentage?: number, taskCount?: {
+        running: number;
+        desired: number;
+        pending?: number;
+    }): void;
+    close(): void;
+    getLogPath(): string;
+    getDeploymentId(): string;
+}

package/bin/assets/src/util/logger/DeploymentLogger.js

@@ -0,0 +1,2 @@
+import{createWriteStream as g,existsSync as f,mkdirSync as m}from"fs";import{join as n}from"path";import{LOGGER_DEFAULTS as h}from"./types.js";import{getDefaultLogDir as a}from"./logDir.js";class p{mainLogger;appName;operationType;logStream=null;logPath;deploymentId;buffer=[];flushInterval=null;isClosing=!1;maxBufferSize=h.MAX_BUFFER_SIZE;constructor(t,e,i){this.mainLogger=t,this.appName=e,this.operationType=i,this.deploymentId=`${i}-${Date.now()}`;const o=a(),l=n(o,"deployments",e);f(l)||m(l,{recursive:!0});const s=new Date().toISOString().replace(/[:.]/g,"-"),r=`${i}-${s}.jsonl`;this.logPath=n(l,r);try{this.logStream=g(this.logPath,{flags:"a"}),this.flushInterval=setInterval(()=>this.flush(),h.FLUSH_INTERVAL_MS),this.info("DeploymentLogger","Deployment logging initialised",{appName:e,operationType:i,deploymentId:this.deploymentId,logPath:this.logPath})}catch{}}log(t,e,i,o,l,s){if(this.isClosing)return;const r={timestamp:new Date().toISOString(),level:t,component:e,message:i,correlationId:this.deploymentId,...o&&Object.keys(o).length>0&&{data:o},...l&&{stackName:l},...s&&{phase:s}};this.buffer.push(r),this.mainLogger.logWithCorrelation(t,e,i,this.deploymentId,o,l,s),this.buffer.length>=this.maxBufferSize&&this.flush()}flush(){if(!(this.buffer.length===0||!this.logStream)){for(const t of this.buffer)this.logStream.write(JSON.stringify(t)+`
+`);this.buffer=[]}}info(t,e,i){this.log("info",t,e,i)}warn(t,e,i){this.log("warn",t,e,i)}error(t,e,i){this.log("error",t,e,i)}debug(t,e,i){this.log("debug",t,e,i)}stackEvent(t,e,i,o){this.log("info","StackDeployment",i,o,t,e)}dockerEvent(t,e){this.log("info","DockerOperation",t,{percentage:e})}ecsEvent(t,e,i){this.log("info","ECSDeployment",t,{percentage:e,taskCount:i})}close(){this.isClosing=!0,this.flush(),this.flushInterval&&(clearInterval(this.flushInterval),this.flushInterval=null),this.logStream&&(this.logStream.end(),this.logStream=null),this.buffer=[],this.isClosing=!1}getLogPath(){return this.logPath}getDeploymentId(){return this.deploymentId}}export{p as DeploymentLoggerImpl};

package/bin/assets/src/util/logger/FileRotator.d.ts

@@ -0,0 +1,17 @@
+import type { FileRotatorOptions } from "./types.js";
+export declare class FileRotator {
+    private maxFiles;
+    constructor(options: FileRotatorOptions);
+    /**
+     * Check if a file needs rotation based on size
+     */
+    needsRotation(filePath: string, maxFileSize: number): boolean;
+    /** Rotate log files: current -> .1 -> .2 -> delete oldest */
+    rotate(filePath: string): void;
+    /** Check if rotation is needed and perform it if so */
+    rotateIfNeeded(filePath: string, maxFileSize: number): boolean;
+    /** Get all rotated file paths for a given log file */
+    getRotatedFiles(filePath: string): string[];
+    /** Clean up all log files (main and rotated) */
+    cleanAll(filePath: string): void;
+}

package/bin/assets/src/util/logger/FileRotator.js

@@ -0,0 +1 @@
+import{existsSync as o,renameSync as m,unlinkSync as l,statSync as F,mkdirSync as y}from"fs";import{dirname as $,basename as d,extname as f,join as c}from"path";class S{maxFiles;constructor(t){this.maxFiles=t.maxFiles}needsRotation(t,s){try{return o(t)?F(t).size>s:!1}catch{return!1}}rotate(t){try{const s=$(t);if(!o(s)){y(s,{recursive:!0});return}if(!o(t))return;const e=f(t),r=d(t,e),a=c(s,`${r}.${this.maxFiles-1}${e}`);o(a)&&l(a);for(let n=this.maxFiles-2;n>=1;n--){const u=c(s,`${r}.${n}${e}`),x=c(s,`${r}.${n+1}${e}`);o(u)&&m(u,x)}const i=c(s,`${r}.1${e}`);m(t,i)}catch{}}rotateIfNeeded(t,s){return this.needsRotation(t,s)?(this.rotate(t),!0):!1}getRotatedFiles(t){const s=[],e=$(t),r=f(t),a=d(t,r);o(t)&&s.push(t);for(let i=1;i<this.maxFiles;i++){const n=c(e,`${a}.${i}${r}`);if(o(n))s.push(n);else break}return s}cleanAll(t){const s=this.getRotatedFiles(t);for(const e of s)try{l(e)}catch{}}}export{S as FileRotator};

package/bin/assets/src/util/logger/LogFileWriter.d.ts

@@ -0,0 +1,54 @@
+import type { LogEntry, LoggerConfig } from "./types.js";
+/**
+ * Manages file stream lifecycle: initialisation, buffered writing, rotation, and cleanup.
+ */
+export declare class LogFileWriter {
+    private readonly config;
+    private readonly mainLogPath;
+    private readonly debugLogPath;
+    private debugEnabled;
+    private mainLogStream;
+    private debugLogStream;
+    private buffer;
+    private debugBuffer;
+    private flushInterval;
+    private isClosing;
+    private initialised;
+    private exitHandlerRegistered;
+    private fileRotator;
+    constructor(config: LoggerConfig, mainLogPath: string, debugLogPath: string, debugEnabled: boolean);
+    /**
+     * Whether the writer has been initialised
+     */
+    get isInitialised(): boolean;
+    /**
+     * Initialise file streams for logging.
+     * Called lazily on first log.
+     */
+    initialise(): void;
+    /**
+     * Create the debug log stream (used during init and when debug is enabled at runtime)
+     */
+    initialiseDebugStream(): void;
+    /**
+     * Update the debug-enabled flag (called when debug mode is toggled at runtime)
+     */
+    setDebugEnabled(enabled: boolean): void;
+    /**
+     * Buffer a log entry for writing
+     */
+    write(entry: LogEntry, isDebugLevel: boolean): void;
+    /**
+     * Flush a single buffer to its log file with rotation support.
+     * Returns the updated stream (may be new if rotation occurred).
+     */
+    private flushBuffer;
+    /**
+     * Flush buffered entries to files
+     */
+    flush(): void;
+    /**
+     * Close all log streams and flush buffers
+     */
+    close(): void;
+}

package/bin/assets/src/util/logger/LogFileWriter.js

@@ -0,0 +1,4 @@
+import{createWriteStream as r,existsSync as a,mkdirSync as h}from"fs";import{FileRotator as n}from"./FileRotator.js";class u{config;mainLogPath;debugLogPath;debugEnabled;mainLogStream=null;debugLogStream=null;buffer=[];debugBuffer=[];flushInterval=null;isClosing=!1;initialised=!1;exitHandlerRegistered=!1;fileRotator;constructor(i,t,s,e){this.config=i,this.mainLogPath=t,this.debugLogPath=s,this.debugEnabled=e,this.fileRotator=new n({maxFiles:i.maxFiles})}get isInitialised(){return this.initialised}initialise(){if(!(this.initialised||this.isClosing))try{a(this.config.logDir)||h(this.config.logDir,{recursive:!0}),this.fileRotator.rotateIfNeeded(this.mainLogPath,this.config.maxFileSize),this.mainLogStream=r(this.mainLogPath,{flags:"a"}),this.debugEnabled&&this.initialiseDebugStream(),this.flushInterval=setInterval(()=>this.flush(),this.config.flushIntervalMs),this.exitHandlerRegistered||(process.on("exit",()=>{this.flush()}),this.exitHandlerRegistered=!0),this.initialised=!0}catch(i){process.stderr.write(`[fjall] Logger init failed: ${i instanceof Error?i.message:String(i)}
+`)}}initialiseDebugStream(){if(!this.debugLogStream)try{a(this.config.debugLogDir)||h(this.config.debugLogDir,{recursive:!0}),this.fileRotator.rotateIfNeeded(this.debugLogPath,this.config.maxFileSize),this.debugLogStream=r(this.debugLogPath,{flags:"a"})}catch(i){process.stderr.write(`[fjall] Debug log init failed: ${i instanceof Error?i.message:String(i)}
+`)}}setDebugEnabled(i){this.debugEnabled=i}write(i,t){this.isClosing||(this.initialised||this.initialise(),this.buffer.push(i),this.debugEnabled&&t&&this.debugBuffer.push(i),this.buffer.length>=this.config.maxBufferSize&&this.flush())}flushBuffer(i,t,s){if(i.length===0||!t)return{buffer:i,stream:t};let e=t;this.fileRotator.needsRotation(s,this.config.maxFileSize)&&(e.end(),this.fileRotator.rotate(s),e=r(s,{flags:"a"}));for(const f of i)e.write(JSON.stringify(f)+`
+`);return{buffer:[],stream:e}}flush(){const i=this.flushBuffer(this.buffer,this.mainLogStream,this.mainLogPath);this.buffer=i.buffer,this.mainLogStream=i.stream;const t=this.flushBuffer(this.debugBuffer,this.debugLogStream,this.debugLogPath);this.debugBuffer=t.buffer,this.debugLogStream=t.stream}close(){this.isClosing=!0,this.flush(),this.flushInterval&&(clearInterval(this.flushInterval),this.flushInterval=null),this.mainLogStream&&(this.mainLogStream.end(),this.mainLogStream=null),this.debugLogStream&&(this.debugLogStream.end(),this.debugLogStream=null),this.buffer=[],this.debugBuffer=[],this.initialised=!1,this.isClosing=!1}}export{u as LogFileWriter};

package/bin/assets/src/util/logger/Logger.d.ts

@@ -0,0 +1,43 @@
+import { CorrelatedLogger } from "./CorrelatedLogger.js";
+import { type LoggerInterface } from "./DeploymentLogger.js";
+import type { LogLevel, DeploymentLogger } from "./types.js";
+/**
+ * Core Logger class - Singleton pattern
+ */
+export declare class Logger implements LoggerInterface {
+    private static instance;
+    private config;
+    private debugEnabled;
+    private traceEnabled;
+    private minLevel;
+    private fileWriter;
+    private readonly mainLogPath;
+    private readonly debugLogPath;
+    private constructor();
+    private parseEnvInt;
+    static getInstance(): Logger;
+    private shouldLog;
+    private createEntry;
+    private log;
+    private writeConsole;
+    private getConsolePrefix;
+    error(component: string, message: string, data?: Record<string, unknown>): void;
+    warn(component: string, message: string, data?: Record<string, unknown>): void;
+    info(component: string, message: string, data?: Record<string, unknown>): void;
+    debug(component: string, message: string, data?: Record<string, unknown>): void;
+    trace(component: string, message: string, data?: Record<string, unknown>): void;
+    isDebugEnabled(): boolean;
+    isTraceEnabled(): boolean;
+    enableDebug(): void;
+    withCorrelation(correlationId: string): CorrelatedLogger;
+    forDeployment(appName: string, operationType?: string): DeploymentLogger;
+    close(): void;
+    getLogPath(): string;
+    getDebugLogPath(): string;
+    getLogDir(): string;
+    logWithCorrelation(level: LogLevel, component: string, message: string, correlationId: string, data?: Record<string, unknown>, stackName?: string, phase?: string): void;
+    /** Reset the singleton — primarily for tests. Callers that captured a
+     *  reference via `Logger.getInstance()` before reset must re-acquire it. */
+    static reset(): void;
+}
+export { CorrelatedLogger } from "./CorrelatedLogger.js";

package/bin/assets/src/util/logger/Logger.js

@@ -0,0 +1 @@
+import{join as u}from"path";import{ContextManager as h}from"../../contexts/index.js";import{CorrelatedLogger as f}from"./CorrelatedLogger.js";import{LogFileWriter as E}from"./LogFileWriter.js";import{DeploymentLoggerImpl as b}from"./DeploymentLogger.js";import{LOG_LEVEL_PRIORITY as c,LOGGER_DEFAULTS as l}from"./types.js";import{getDefaultLogDir as d}from"./logDir.js";class s{static instance=null;config;debugEnabled;traceEnabled;minLevel;fileWriter;mainLogPath;debugLogPath;constructor(){const e=d(),t=u(e,"debug"),r=this.parseEnvInt("FJALL_LOG_MAX_SIZE",l.MAX_FILE_SIZE),i=this.parseEnvInt("FJALL_LOG_MAX_FILES",l.MAX_FILES);this.config={logDir:e,debugLogDir:t,maxFileSize:r,maxFiles:i,maxBufferSize:l.MAX_BUFFER_SIZE,flushIntervalMs:l.FLUSH_INTERVAL_MS},this.mainLogPath=u(e,l.LOG_FILENAME),this.debugLogPath=u(t,l.DEBUG_LOG_FILENAME),this.debugEnabled=process.env.FJALL_DEBUG==="true"||process.env.FJALL_TRACE==="true"||process.argv.includes("--verbose")||process.argv.includes("-v"),this.traceEnabled=process.env.FJALL_TRACE==="true";const n=process.env.FJALL_LOG_LEVEL?.toLowerCase();n&&n in c?this.minLevel=n:this.traceEnabled?this.minLevel="trace":this.debugEnabled?this.minLevel="debug":this.minLevel="info",this.fileWriter=new E(this.config,this.mainLogPath,this.debugLogPath,this.debugEnabled)}parseEnvInt(e,t){const r=process.env[e];if(r){const i=parseInt(r,10);if(!isNaN(i)&&i>0)return i}return t}static getInstance(){return s.instance||(s.instance=new s),s.instance}shouldLog(e){return c[e]>=c[this.minLevel]}createEntry(e,t,r,i,n,o,a){return{timestamp:new Date().toISOString(),level:e,component:t,message:r,...n&&{correlationId:n},...i&&Object.keys(i).length>0&&{data:i},...o&&{stackName:o},...a&&{phase:a}}}log(e,t,r,i,n,o,a){if(!this.shouldLog(e))return;const g=this.createEntry(e,t,r,i,n,o,a),L=e==="debug"||e==="trace";this.fileWriter.write(g,L),this.writeConsole(g)}writeConsole(e){if(h.shouldSuppressOutput||h.isNonInteractive)return;const t=this.getConsolePrefix(e.level),r=`[${e.component}]`,i=`${t} ${r} ${e.message}`;e.level==="error"?console.error(i):e.level==="warn"?console.warn(i):console.log(i)}getConsolePrefix(e){switch(e){case"error":return"[ERROR]";case"warn":return"[WARN]";case"info":return"[INFO]";case"debug":return"[DEBUG]";case"trace":return"[TRACE]"}}error(e,t,r){this.log("error",e,t,r)}warn(e,t,r){this.log("warn",e,t,r)}info(e,t,r){this.log("info",e,t,r)}debug(e,t,r){this.log("debug",e,t,r)}trace(e,t,r){this.log("trace",e,t,r)}isDebugEnabled(){return this.debugEnabled}isTraceEnabled(){return this.traceEnabled}enableDebug(){this.debugEnabled=!0,c[this.minLevel]>c.debug&&(this.minLevel="debug"),this.fileWriter.setDebugEnabled(!0),this.fileWriter.isInitialised&&this.fileWriter.initialiseDebugStream()}withCorrelation(e){return new f(this,e)}forDeployment(e,t="deploy"){return new b(this,e,t)}close(){this.fileWriter.close()}getLogPath(){return this.mainLogPath}getDebugLogPath(){return this.debugLogPath}getLogDir(){return this.config.logDir}logWithCorrelation(e,t,r,i,n,o,a){this.log(e,t,r,n,i,o,a)}static reset(){s.instance&&(s.instance.close(),s.instance=null)}}import{CorrelatedLogger as S}from"./CorrelatedLogger.js";export{S as CorrelatedLogger,s as Logger};

package/bin/assets/src/util/logger/index.d.ts

@@ -0,0 +1,15 @@
+import { Logger, CorrelatedLogger } from "./Logger.js";
+import { FileRotator } from "./FileRotator.js";
+import type { LogEntry, LogLevel, DeploymentLogger, LoggerConfig } from "./types.js";
+export { getDefaultLogDir } from "./logDir.js";
+export declare const logger: Logger;
+export { Logger, CorrelatedLogger };
+export { FileRotator };
+export { DeploymentLoggerImpl } from "./DeploymentLogger.js";
+export type { LogLevel, LogEntry, DeploymentLogger, LoggerConfig };
+export { LOG_LEVEL_PRIORITY } from "./types.js";
+/**
+ * Write to debug file synchronously (for crash handlers)
+ * This is a fallback for emergency situations only
+ */
+export declare function writeDebugSync(message: string): void;

package/bin/assets/src/util/logger/index.js

@@ -0,0 +1,2 @@
+import{existsSync as e,mkdirSync as p,statSync as a,appendFileSync as f}from"fs";import{join as n}from"path";import{Logger as i,CorrelatedLogger as L}from"./Logger.js";import{FileRotator as m}from"./FileRotator.js";import{LOGGER_DEFAULTS as r}from"./types.js";import{getDefaultLogDir as l}from"./logDir.js";import{getDefaultLogDir as G}from"./logDir.js";const d=i.getInstance();import{DeploymentLoggerImpl as R}from"./DeploymentLogger.js";import{LOG_LEVEL_PRIORITY as M}from"./types.js";function F(g){const s=l(),o=n(s,"debug"),t=n(o,r.DEBUG_LOG_FILENAME);try{e(o)||p(o,{recursive:!0}),e(t)&&a(t).size>r.MAX_FILE_SIZE&&new m({maxFiles:r.MAX_FILES}).rotate(t);const c={timestamp:new Date().toISOString(),level:"debug",component:"Emergency",message:g};f(t,JSON.stringify(c)+`
+`)}catch{}}export{L as CorrelatedLogger,R as DeploymentLoggerImpl,m as FileRotator,M as LOG_LEVEL_PRIORITY,i as Logger,G as getDefaultLogDir,d as logger,F as writeDebugSync};

package/bin/assets/src/util/logger/logDir.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Get the default log directory path.
+ * Checks FJALL_LOG_DIR environment variable, falling back to ~/.fjall/logs.
+ */
+export declare function getDefaultLogDir(): string;

package/bin/assets/src/util/logger/logDir.js

@@ -0,0 +1 @@
+import{join as r}from"path";import{homedir as e}from"os";function t(){const o=process.env.FJALL_LOG_DIR;return o!==void 0&&o!==""?o:r(e(),".fjall","logs")}export{t as getDefaultLogDir};

package/bin/assets/src/util/logger/types.d.ts

@@ -0,0 +1,48 @@
+export type LogLevel = "trace" | "debug" | "info" | "warn" | "error";
+export declare const LOG_LEVEL_PRIORITY: Record<LogLevel, number>;
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    component: string;
+    message: string;
+    correlationId?: string;
+    data?: Record<string, unknown>;
+    stackName?: string;
+    phase?: string;
+    source?: string;
+}
+export interface LoggerConfig {
+    logDir: string;
+    debugLogDir: string;
+    maxFileSize: number;
+    maxFiles: number;
+    maxBufferSize: number;
+    flushIntervalMs: number;
+}
+export interface DeploymentLogger {
+    info(component: string, message: string, data?: Record<string, unknown>): void;
+    warn(component: string, message: string, data?: Record<string, unknown>): void;
+    error(component: string, message: string, data?: Record<string, unknown>): void;
+    debug(component: string, message: string, data?: Record<string, unknown>): void;
+    stackEvent(stackName: string, phase: string, message: string, data?: Record<string, unknown>): void;
+    dockerEvent(message: string, percentage?: number): void;
+    ecsEvent(message: string, percentage?: number, taskCount?: {
+        running: number;
+        desired: number;
+        pending?: number;
+    }): void;
+    close(): void;
+    getLogPath(): string;
+    getDeploymentId(): string;
+}
+export interface FileRotatorOptions {
+    maxFiles: number;
+}
+export declare const LOGGER_DEFAULTS: {
+    readonly MAX_FILE_SIZE: number;
+    readonly MAX_FILES: 5;
+    readonly MAX_BUFFER_SIZE: 100;
+    readonly FLUSH_INTERVAL_MS: 500;
+    readonly LOG_FILENAME: "fjall.jsonl";
+    readonly DEBUG_LOG_FILENAME: "fjall-debug.jsonl";
+};

package/bin/assets/src/util/logger/types.js

@@ -0,0 +1 @@
+const E={trace:0,debug:1,info:2,warn:3,error:4},L={MAX_FILE_SIZE:10*1024*1024,MAX_FILES:5,MAX_BUFFER_SIZE:100,FLUSH_INTERVAL_MS:500,LOG_FILENAME:"fjall.jsonl",DEBUG_LOG_FILENAME:"fjall-debug.jsonl"};export{L as LOGGER_DEFAULTS,E as LOG_LEVEL_PRIORITY};

package/bin/assets/src/util/nonInteractive/index.d.ts

@@ -0,0 +1,3 @@
+export { OutputWriter, NoopOutputWriter, STEP_STATUS, ORG_SETUP_LABELS, PREPARE_LABELS, PRE_DEPLOY_LABELS, type SummaryOptions } from "./nonInteractiveOutput.js";
+export { type NonInteractiveOutput, createNonInteractiveOutput } from "./nonInteractiveCallbacks.js";
+export { CASCADE_COLUMN_WIDTH, PARALLEL_PREFIX } from "./nonInteractiveLabels.js";

package/bin/assets/src/util/nonInteractive/index.js

@@ -0,0 +1 @@
+import{OutputWriter as E,NoopOutputWriter as L,STEP_STATUS as e,ORG_SETUP_LABELS as o,PREPARE_LABELS as A,PRE_DEPLOY_LABELS as _}from"./nonInteractiveOutput.js";import{createNonInteractiveOutput as S}from"./nonInteractiveCallbacks.js";import{CASCADE_COLUMN_WIDTH as u,PARALLEL_PREFIX as O}from"./nonInteractiveLabels.js";export{u as CASCADE_COLUMN_WIDTH,L as NoopOutputWriter,o as ORG_SETUP_LABELS,E as OutputWriter,O as PARALLEL_PREFIX,A as PREPARE_LABELS,_ as PRE_DEPLOY_LABELS,e as STEP_STATUS,S as createNonInteractiveOutput};

package/bin/assets/src/util/nonInteractive/nonInteractiveCallbacks.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Callback wiring for non-interactive output.
+ *
+ * Bridges the OutputWriter (presentation) with the CLI callback interfaces.
+ * Deployment events are streamed to the webapp via DeploymentTracker, not here.
+ */
+import type { ApplicationCallbacks, OrganisationCallbacks } from "../../types/callbacks.js";
+import { OutputWriter } from "./nonInteractiveOutput.js";
+/**
+ * Factory: returns both callbacks and writer for summary rendering.
+ */
+export interface NonInteractiveOutput {
+    callbacks: ApplicationCallbacks & OrganisationCallbacks;
+    writer: OutputWriter;
+}
+export declare function createNonInteractiveOutput(options: {
+    verbose?: boolean;
+}): NonInteractiveOutput;

package/bin/assets/src/util/nonInteractive/nonInteractiveCallbacks.js

@@ -0,0 +1 @@
+import{getReportVersionService as u}from"../../services/index.js";import{logger as p}from"../logger/index.js";import{maskSensitiveOutput as s}from"@fjall/util";import{OutputWriter as r}from"./nonInteractiveOutput.js";function P(o){p.debug("NonInteractiveOutput","createNonInteractiveOutput called",{verbose:o.verbose});const n=new r({...o,versionUpdate:u().getUpdate()});return{callbacks:d(n,o),writer:n}}function d(o,n){return{verbose:n.verbose,onProgress:e=>{const t=s(e.message);e.type==="error"||e.type==="warning"?o.log(t,"warn"):e.type!=="debug"&&o.log(t,"info")},onSSOUrl:e=>o.ssoUrl(e),onAuthComplete:()=>o.authComplete(),onStepStart:(e,t,a,c)=>{o.stepStart(e,t,a,c)},onStepComplete:(e,t,a,c,l)=>{o.stepComplete(e,t,a,c,l)},onResourceProgress:e=>{const t=e.statusReason?{...e,statusReason:s(e.statusReason)}:e;o.resourceProgress(t)},onCDKBootstrap:()=>{},onCdkOutput:e=>o.cdkOutput(s(e)),onOutput:e=>o.cdkOutput(s(e)),onLog:(e,t)=>{o.log(s(e),t)},onConfirmRequired:async()=>!0,onSecretsConfirmRequired:async e=>(o.secretsWarning(e),!0),onAccountDetected:e=>o.accountDetected(e),onConfigurationDetected:e=>o.configurationDetected(e),onPreDeploymentProgress:e=>{o.preDeploymentProgress(e)},onDockerProgress:(e,t)=>{o.dockerProgress(s(e),t)},onECSUpdate:e=>{o.ecsUpdate(s(e))},onECSProgress:(e,t)=>{o.ecsProgress(s(e),t)},onOpenNextBuildStart:()=>{o.indent("[opennext] Build starting...")},onOpenNextProgress:(e,t,a)=>{o.openNextProgress(s(e),t,a)},onOpenNextBuildComplete:()=>{o.indent("[opennext] Build completed")},onOpenNextBuildError:e=>{o.indent(`[opennext] Build failed: ${s(e)}`)},onStackCleanupProgress:(e,t)=>{o.indent(`[cleanup] ${s(e)}: ${s(t)}`)},onParallelDeployStart:e=>{o.parallelDeployStart(e)},onParallelStackStart:e=>{o.parallelStackStart(e)},onParallelStackComplete:(e,t,a)=>{o.parallelStackComplete(e,t,a)},onParallelStackProgress:(e,t)=>{const a=t.statusReason?{...t,statusReason:s(t.statusReason)}:t;o.resourceProgress(a)},onParallelDeployComplete:(e,t)=>{o.parallelDeployComplete(t)},onOrgSetupProgress:e=>{o.orgSetupProgress(e)},onChangeDetectionComplete:e=>o.changeDetectionComplete(e),onCascadeStart:()=>{},onCascadePhaseStart:e=>{o.cascadePhaseStart(e)},onCascadeAccountStart:(e,t,a)=>{o.cascadeAccountStart(e,t,a)},onCascadeAccountPhaseChange:(e,t,a)=>{o.cascadeAccountPhaseChange(e,t,a)},onCascadeAccountResourceProgress:(e,t,a)=>{o.cascadeAccountResourceProgress(e,t,a)},onCascadeAccountComplete:(e,t,a)=>{o.cascadeAccountComplete(e,t,a&&s(a))},onCascadeComplete:e=>{o.cascadeComplete(e)}}}export{P as createNonInteractiveOutput};

package/bin/assets/src/util/nonInteractive/nonInteractiveCascadeOutput.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Deployment progress, cascade, and parallel rendering for non-interactive output.
+ *
+ * Extracted from nonInteractiveOutput.ts for file-size compliance.
+ */
+import type { OrgSetupEventType, PreDeploymentEventType } from "../../types/callbacks.js";
+/** Minimal interface for output primitives that the rendering functions need. */
+export interface OutputPrimitives {
+    line(text: string): void;
+    indent(text: string, level?: number): void;
+    formatDuration(ms: number): string;
+}
+export declare function renderParallelDeployStart(out: OutputPrimitives, stacks: readonly string[]): void;
+export declare function renderParallelStackStart(out: OutputPrimitives, timers: Map<string, number>, stack: string): void;
+export declare function renderParallelStackComplete(out: OutputPrimitives, timers: Map<string, number>, stack: string, status: string, error?: string): void;
+export declare function renderParallelDeployComplete(out: OutputPrimitives, allSuccessful: boolean): void;
+export declare function renderCascadeAccountStart(out: OutputPrimitives, timers: Map<string, number>, operationKey: string, verbose: boolean): void;
+export declare function renderCascadeAccountPhaseChange(out: OutputPrimitives, operationKey: string, phase: "bootstrap" | "synth" | "deploy" | "destroy", verbose: boolean): void;
+export declare function renderCascadeAccountResourceProgress(out: OutputPrimitives, operationKey: string, event: {
+    logicalId?: string;
+    resourceType?: string;
+    status?: string;
+    statusReason?: string;
+}, verbose: boolean): void;
+export declare function renderCascadeAccountComplete(out: OutputPrimitives, timers: Map<string, number>, operationKey: string, success: boolean, verbose: boolean, error?: string): void;
+export declare function renderOrgSetupProgress(out: OutputPrimitives, event: {
+    type: OrgSetupEventType;
+    phase: string;
+    message?: string;
+    detail?: string;
+}, verbose: boolean): void;
+export declare function renderChangeDetectionComplete(out: OutputPrimitives, changes: {
+    hasOrgChanges: boolean;
+    hasPlatformChanges: boolean;
+    hasAccountChanges: boolean;
+    hasMemberAccounts: boolean;
+    hasPlatformAccount: boolean;
+    hasDomainChanges: boolean;
+    hasDomainConfiguration: boolean;
+}): void;
+export declare function renderPreDeploymentProgress(out: OutputPrimitives, event: {
+    type: PreDeploymentEventType;
+    phase: string;
+    message?: string;
+}, verbose: boolean): void;
+export declare function renderResourceProgress(out: OutputPrimitives, event: {
+    logicalId?: string;
+    resourceType?: string;
+    status?: string;
+    statusReason?: string;
+}, verbose: boolean): void;

package/bin/assets/src/util/nonInteractive/nonInteractiveCascadeOutput.js

@@ -0,0 +1 @@
+import o from"chalk";import{theme as $}from"../theme.js";import{formatResourceStatus as h,getFriendlyResourceType as u}from"../../aws/utils/cloudformationEvents.js";import{logger as p}from"../logger/index.js";import{CASCADE_COLUMN_WIDTH as m,PARALLEL_PREFIX as l,ORG_SETUP_LABELS as f,PREPARE_LABELS as g,PRE_DEPLOY_LABELS as C}from"./nonInteractiveLabels.js";const t=$.colours;function y(s,e){const r=e.join(", ");s.indent(`${l} Deploying: ${r}`)}function L(s,e,r){e.set(r,Date.now()),s.indent(`${l} ${r.padEnd(22)} starting`)}function S(s,e,r,n,i){const d=n==="complete"?o.hex(t.completed)("\u2713"):n==="failed"?o.hex(t.error)("\u2717"):o.hex(t.dim)("\u25CB"),a=e.get(r),c=a?s.formatDuration(Date.now()-a):"",x=c?` ${o.hex(t.dim)(`(${c})`)}`:"";s.indent(`${l} ${r.padEnd(22)} ${d} ${n}${x}`),i&&s.indent(o.hex(t.error)(i),2)}function T(s,e){s.indent(`${l} Phase ${e?"completed":"completed with errors"}`)}function I(s,e,r,n){e.set(r,Date.now()),p.debug("OutputWriter","cascadeAccountStart called",{operationKey:r,verbose:n}),n&&s.indent(`${r.padEnd(m)} starting`)}function O(s,e,r,n){p.debug("OutputWriter","cascadeAccountPhaseChange called",{operationKey:e,phase:r,verbose:n}),n&&s.indent(`${e.padEnd(m)} ${r}`)}function _(s,e,r,n){if(n&&r.logicalId&&r.status){const{symbol:i,colour:d}=h(r.status),a=r.resourceType?u(r.resourceType):"",c=r.statusReason&&r.status.includes("FAILED")?o.hex(t.error)(` - ${r.statusReason}`):"";s.indent(`${e.padEnd(m)} ${o.hex(d)(i)} ${a}${o.hex(t.dim)(` \xB7 ${r.logicalId}`)}${c}`)}}function b(s,e,r,n,i,d){p.debug("OutputWriter","cascadeAccountComplete called",{operationKey:r,success:n,verbose:i});const a=e.get(r),c=a?s.formatDuration(Date.now()-a):"";n?s.indent(o.hex(t.completed)("\u2713")+` ${r}`+(c?`  ${o.hex(t.dim)(c)}`:"")):(s.indent(o.hex(t.error)("\u2717")+` ${r}`+(c?`  ${o.hex(t.dim)(c)}`:"")),d&&s.indent(o.hex(t.error)(d),2))}function w(s,e,r){const n=f[e.type]??g[e.type]??e.type;e.phase==="complete"?s.indent(o.hex(t.completed)("\u2713")+` ${n}`):e.phase==="skipped"?s.indent(o.hex(t.dim)("\u2212")+` ${o.hex(t.dim)(n)}`+o.hex(t.dim)("  skipped")):e.phase==="error"?s.indent(o.hex(t.error)("\u2717")+` ${o.hex(t.error)(n)}`+(e.message?`  ${o.hex(t.error)(e.message)}`:"")):e.phase==="started"&&r&&s.indent(o.hex(t.dim)("\u25CB")+` ${n}`)}function k(s,e){const r=e.hasOrgChanges?o.hex(t.completed)("\u2713"):o.hex(t.dim)("\u2212"),n=e.hasPlatformChanges?o.hex(t.completed)("\u2713"):o.hex(t.dim)("\u2212"),i=e.hasDomainChanges?o.hex(t.completed)("\u2713"):o.hex(t.dim)("\u2212"),d=e.hasAccountChanges?o.hex(t.completed)("\u2713"):o.hex(t.dim)("\u2212"),a=[`organisation ${r}`,`platform ${n}`];e.hasDomainConfiguration&&a.push(`domains ${i}`),a.push(`accounts ${d}`),s.indent(`Changes: ${a.join("  ")}`)}function F(s,e,r){const n=C[e.type]??e.type;e.phase==="started"?r&&s.indent(o.hex(t.dim)("\u25CB")+` ${n}`):e.phase==="complete"?s.indent(o.hex(t.completed)("\u2713")+` ${n}`):e.phase==="error"?s.indent(o.hex(t.error)("\u2717")+` ${n}`+(e.message?`: ${e.message}`:"")):e.phase==="skipped"&&s.indent(o.hex(t.dim)("\u2212")+` ${o.hex(t.dim)(n)}`)}function W(s,e,r){if(r&&e.status&&e.logicalId){const{symbol:n,colour:i}=h(e.status),d=e.resourceType?u(e.resourceType):"",a=e.statusReason&&e.status.includes("FAILED")?o.hex(t.error)(` - ${e.statusReason}`):"";s.indent(`${o.hex(i)(n)} ${d}${o.hex(t.dim)(` \xB7 ${e.logicalId}`)}${a}`)}}export{b as renderCascadeAccountComplete,O as renderCascadeAccountPhaseChange,_ as renderCascadeAccountResourceProgress,I as renderCascadeAccountStart,k as renderChangeDetectionComplete,w as renderOrgSetupProgress,T as renderParallelDeployComplete,y as renderParallelDeployStart,S as renderParallelStackComplete,L as renderParallelStackStart,F as renderPreDeploymentProgress,W as renderResourceProgress};

package/bin/assets/src/util/nonInteractive/nonInteractiveLabels.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Label constants and shared types for non-interactive output.
+ *
+ * Extracted from nonInteractiveOutput.ts to keep file sizes manageable.
+ */
+import type { CascadeDeploymentResult } from "../../services/deployment/CascadeUtils.js";
+import type { OrgSetupEventType, PreDeploymentEventType } from "../../types/callbacks.js";
+export declare const CASCADE_COLUMN_WIDTH = 35;
+export declare const PARALLEL_PREFIX = "[parallel]";
+export declare const ORG_SETUP_LABELS: Readonly<Partial<Record<OrgSetupEventType, string>>>;
+export declare const PREPARE_LABELS: Readonly<Partial<Record<OrgSetupEventType, string>>>;
+export declare const PRE_DEPLOY_LABELS: Readonly<Record<PreDeploymentEventType, string>>;
+export interface SummaryOptions {
+    operation: string;
+    target: string;
+    success: boolean;
+    duration: number;
+    url?: string;
+    cascadeResult?: CascadeDeploymentResult | null;
+    details?: Record<string, string>;
+    /** Custom past tense verb (e.g. "configured", "restored"). Falls back to built-in map then "<operation> completed". */
+    verb?: string;
+}

package/bin/assets/src/util/nonInteractive/nonInteractiveLabels.js

@@ -0,0 +1 @@
+const e=35,t="[parallel]",a=Object.freeze({"org-ensure":"Organisation exists","policy-types":"Policy types enabled","service-access":"Service access enabled","ram-sharing":"RAM sharing enabled","trusted-access":"CloudFormation trusted access","ipam-delegate":"IPAM delegated admin","backup-settings":"Backup global settings","create-accounts":"Creating accounts","ensure-ous":"Organisational units",accounts:"Retrieving accounts","place-accounts":"Placing accounts in OUs","cost-tags":"Cost allocation tags","identity-centre":"Identity Centre","security-delegates":"Delegating security services","domain-setup":"Configuring domains","synth-domains":"Synthesising domains"}),n=Object.freeze({"cfn-check":"Checking infrastructure state",synth:"Synthesising organisation","synth-platform":"Synthesising platform","synth-accounts":"Synthesising accounts","hash-compare":"Comparing template hashes"}),s=Object.freeze({detect:"Detecting application pattern",config:"Configuring Payload for AWS",migrate:"Creating database migrations",importmap:"Generating Payload import map",build:"Building Next.js application",synth:"Synthesising infrastructure",hash:"Comparing template hashes",docker:"Validating Docker configuration",validate:"Validating SSM secrets"});export{e as CASCADE_COLUMN_WIDTH,a as ORG_SETUP_LABELS,t as PARALLEL_PREFIX,n as PREPARE_LABELS,s as PRE_DEPLOY_LABELS};