takomo 8.0.3 → 9.0.0-alpha.1

package/dist/custom-stacks/custom-stack-handler.d.ts

@@ -0,0 +1,401 @@
+import { StacksContext } from "../index.js";
+import { CustomStack, CustomStackStatus } from "../stacks/custom-stack.js";
+import { CustomStackType, StackPath } from "../stacks/stack.js";
+import { TkmLogger } from "../utils/logging.js";
+export type ParameterName = string;
+export type ParameterValue = string;
+export type Parameters = Record<ParameterName, ParameterValue>;
+export type TagName = string;
+export type TagValue = string;
+export type Tags = Record<TagName, TagValue>;
+export type OutputName = string;
+export type OutputValue = string;
+export type Outputs = Record<OutputName, OutputValue>;
+/**
+ * Represents the state of a custom stack. All properties are optional to allow
+ * flexibility for different custom stack implementations.
+ */
+export type CustomStackState = {
+    /**
+     * The status of the custom stack. This property is mandatory and is
+     * used to represent the current status of the custom stack.
+     */
+    status: CustomStackStatus;
+    /**
+     * Optional property representing the last updated time of the custom stack.
+     */
+    lastUpdatedTime?: Date;
+    /**
+     * Optional property representing the creation time of the custom stack.
+     */
+    creationTime?: Date;
+    /**
+     * Optional property representing the parameters of the custom stack.
+     */
+    parameters?: Parameters;
+    /**
+     * Optional property representing the tags of the custom stack.
+     */
+    tags?: Tags;
+    /**
+     * Optional property representing the outputs of the custom stack.
+     */
+    outputs?: Outputs;
+};
+/**
+ * Represents the properties passed to get the current state of a custom stack.
+ */
+export type GetCurrentStateProps<CONFIG> = {
+    /**
+     * The logger instance to be used for logging.
+     */
+    readonly logger: TkmLogger;
+    /**
+     * The configuration object for the custom stack.
+     */
+    readonly config: CONFIG;
+    /**
+     * The custom stack for which the current state is being retrieved.
+     */
+    readonly stack: CustomStack;
+    /**
+     * The stacks context.
+     */
+    readonly ctx: StacksContext;
+};
+/**
+ * Represents a successful result of getting the current state of a custom stack.
+ */
+export type SuccessfulGetCurrentStateResult<CONFIG> = {
+    readonly success: true;
+    /**
+     * The current state of the custom stack.
+     */
+    readonly state: CONFIG;
+};
+/**
+ * Represents a failed result of getting the current state of a custom stack.
+ */
+export type FailedGetCurrentStateResult = {
+    readonly success: false;
+    /**
+     * An optional error object if the operation failed.
+     */
+    readonly error?: Error;
+    /**
+     * An optional message providing additional information about the operation result.
+     */
+    readonly message?: string;
+};
+/**
+ * Represents the result of getting the current state of a custom stack.
+ */
+export type GetCurrentStateResult<STATE extends CustomStackState> = SuccessfulGetCurrentStateResult<STATE> | FailedGetCurrentStateResult;
+/**
+ * Represents the properties passed to create a custom stack operation.
+ */
+export type CreateCustomStackProps<CONFIG> = {
+    /**
+     * The logger instance to be used for logging.
+     */
+    readonly logger: TkmLogger;
+    /**
+     * The configuration object for the custom stack.
+     */
+    readonly config: CONFIG;
+    /**
+     * The parameters to be used for the create operation.
+     */
+    readonly parameters: Parameters;
+    /**
+     * The tags to be used for the create operation.
+     */
+    readonly tags: Tags;
+    /**
+     * The custom stack to be created.
+     */
+    readonly stack: CustomStack;
+    /**
+     * The stacks context.
+     */
+    readonly ctx: StacksContext;
+};
+/**
+ * Represents a successful result of creating a custom stack.
+ */
+export type SuccessfulCreateCustomStackResult<STATE extends CustomStackState> = {
+    readonly success: true;
+    /**
+     * The state of the custom stack after creation.
+     */
+    readonly state: STATE;
+};
+/**
+ * Represents a failed result of creating a custom stack.
+ */
+export type FailedCreateCustomStackResult = {
+    readonly success: false;
+    /**
+     * An optional error object if the operation failed.
+     */
+    readonly error?: Error;
+    /**
+     * An optional message providing additional information about the operation result.
+     */
+    readonly message?: string;
+};
+/**
+ * Represents the result of creating a custom stack.
+ */
+export type CreateCustomStackResult<STATE extends CustomStackState> = SuccessfulCreateCustomStackResult<STATE> | FailedCreateCustomStackResult;
+/**
+ * Represents the properties passed to update a custom stack operation.
+ */
+export type UpdateCustomStackProps<CONFIG, STATE extends CustomStackState> = {
+    /**
+     * The logger instance to be used for logging.
+     */
+    readonly logger: TkmLogger;
+    /**
+     * The current state of the custom stack.
+     */
+    readonly state: STATE;
+    /**
+     * The configuration object for the custom stack.
+     */
+    readonly config: CONFIG;
+    /**
+     * The parameters to be used for the update operation.
+     */
+    readonly parameters: Parameters;
+    /**
+     * The tags to be used for the update operation.
+     */
+    readonly tags: Tags;
+    /**
+     * The custom stack to be updated.
+     */
+    readonly stack: CustomStack;
+    /**
+     * The stacks context.
+     */
+    readonly ctx: StacksContext;
+};
+export type SuccessfulUpdateCustomStackResult<STATE extends CustomStackState> = {
+    readonly success: true;
+    /**
+     * The updated state of the custom stack.
+     */
+    readonly state: STATE;
+};
+export type FailedUpdateCustomStackResult = {
+    readonly success: false;
+    /**
+     * An optional error object if the operation failed.
+     */
+    readonly error?: Error;
+    /**
+     * An optional message providing additional information about the operation result.
+     */
+    readonly message?: string;
+};
+/**
+ * Represents the result of updating a custom stack.
+ */
+export type UpdateCustomStackResult<STATE extends CustomStackState> = SuccessfulUpdateCustomStackResult<STATE> | FailedUpdateCustomStackResult;
+/**
+ * Represents the properties passed to parse a custom stack configuration function.
+ */
+export type ParseConfigProps = {
+    /**
+     * The logger instance to be used for logging.
+     */
+    readonly logger: TkmLogger;
+    /**
+     * The raw configuration object to be parsed.
+     */
+    readonly config: unknown;
+    /**
+     * The stack path of the custom stack.
+     */
+    readonly stackPath: StackPath;
+};
+/**
+ * Represents a successful result of parsing a custom stack configuration.
+ */
+export type SuccessfulParseConfigResult<CONFIG> = {
+    readonly success: true;
+    readonly config: CONFIG;
+};
+/**
+ * Represents a failed result of parsing a custom stack configuration.
+ */
+export type FailedParseConfigResult = {
+    readonly success: false;
+    /**
+     * An optional error object if the parsing failed.
+     */
+    readonly error?: Error;
+    /**
+     * An optional message providing additional information about the parsing result.
+     */
+    readonly message?: string;
+};
+/**
+ * Represents the result of parsing a custom stack configuration.
+ */
+export type ParseConfigResult<CONFIG> = SuccessfulParseConfigResult<CONFIG> | FailedParseConfigResult;
+/**
+ * Represents the properties passed to delete a custom stack operation.
+ */
+export type DeleteCustomStackProps<CONFIG, STATE extends CustomStackState> = {
+    /**
+     * The logger instance to be used for logging.
+     */
+    readonly logger: TkmLogger;
+    /**
+     * The current state of the custom stack.
+     */
+    readonly state: STATE;
+    /**
+     * The configuration object for the custom stack.
+     */
+    readonly config: CONFIG;
+    /**
+     * The custom stack to be deleted.
+     */
+    readonly stack: CustomStack;
+    /**
+     * The stacks context.
+     */
+    readonly ctx: StacksContext;
+};
+/**
+ * Represents a successful result of deleting a custom stack.
+ */
+export type SuccessFullDeleteCustomStackResult = {
+    readonly success: true;
+};
+/**
+ * Represents a failed result of deleting a custom stack.
+ */
+export type FailedDeleteCustomStackResult = {
+    readonly success: false;
+    /**
+     * An optional message providing additional information about the operation result.
+     */
+    readonly message?: string;
+    /**
+     * An optional error object if the operation failed.
+     */
+    readonly error?: Error;
+};
+/**
+ * Represents the result of deleting a custom stack.
+ */
+export type DeleteCustomStackResult = SuccessFullDeleteCustomStackResult | FailedDeleteCustomStackResult;
+/**
+ * Represents the properties passed to get changes of a custom stack operation.
+ */
+export type GetChangesProps<CONFIG, STATE extends CustomStackState> = {
+    /**
+     * The logger instance to be used for logging.
+     */
+    readonly logger: TkmLogger;
+    /**
+     * The current state of the custom stack.
+     */
+    readonly state: STATE;
+    /**
+     * The configuration object for the custom stack.
+     */
+    readonly config: CONFIG;
+    /**
+     * The parameters to be used for the update operation.
+     */
+    readonly parameters: Parameters;
+    /**
+     * The tags to be used for the update operation.
+     */
+    readonly tags: Tags;
+    /**
+     * The custom stack to be updated.
+     */
+    readonly stack: CustomStack;
+    /**
+     * The stacks context.
+     */
+    readonly ctx: StacksContext;
+};
+/**
+ * Represents a change in a custom stack.
+ */
+export type CustomStackChange = {
+    readonly description: string;
+};
+/**
+ * Represents a successful result of getting changes of a custom stack.
+ */
+export type SuccessfulGetChangesResult = {
+    success: true;
+    /**
+     * The list of changes detected in the custom stack.
+     */
+    changes?: ReadonlyArray<CustomStackChange>;
+};
+/**
+ * Represents a failed result of getting changes of a custom stack.
+ */
+export type FailedGetChangesResult = {
+    success: false;
+    /**
+     * An optional message providing additional information about the operation result.
+     */
+    message?: string;
+    /**
+     * An optional error object if the operation failed.
+     */
+    error?: Error;
+};
+/**
+ * Represents the result of getting changes of a custom stack.
+ */
+export type GetChangesResult = SuccessfulGetChangesResult | FailedGetChangesResult;
+/**
+ * Interface defining the contract for handling custom stack operations.
+ */
+export interface CustomStackHandler<CONFIG, STATE extends CustomStackState> {
+    /**
+     * The type of the custom stack this handler manages.
+     */
+    readonly type: CustomStackType;
+    /**
+     * Gets the current state of the custom stack.
+     *
+     * During deploy operation, the existence of the stack determines whether to create
+     * or update the stack. During undeploy operation, the existence of the stack determines
+     * whether to attempt deletion or skip it.
+     */
+    readonly getCurrentState: (props: GetCurrentStateProps<CONFIG>) => Promise<GetCurrentStateResult<STATE>>;
+    /**
+     * Gets the changes between the current state and the desired state of the custom stack.
+     * Invoked during deploy of an existing stack to determine whether there would be any changes in the stack.
+     */
+    readonly getChanges: (props: GetChangesProps<CONFIG, STATE>) => Promise<GetChangesResult>;
+    /**
+     * Parses the custom stack configuration.
+     */
+    readonly parseConfig: (props: ParseConfigProps) => Promise<ParseConfigResult<CONFIG>>;
+    /**
+     * Creates a new custom stack.
+     */
+    readonly create: (props: CreateCustomStackProps<CONFIG>) => Promise<CreateCustomStackResult<STATE>>;
+    /**
+     * Updates an existing custom stack.
+     */
+    readonly update: (props: UpdateCustomStackProps<CONFIG, STATE>) => Promise<UpdateCustomStackResult<STATE>>;
+    /**
+     * Deletes an existing custom stack.
+     */
+    readonly delete: (props: DeleteCustomStackProps<CONFIG, STATE>) => Promise<DeleteCustomStackResult>;
+}

package/dist/custom-stacks/custom-stack-handler.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=custom-stack-handler.js.map

package/dist/custom-stacks/custom-stack-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-stack-handler.js","sourceRoot":"","sources":["../../src/custom-stacks/custom-stack-handler.ts"],"names":[],"mappings":""}

package/dist/extensions/config-customizer.d.ts

@@ -1,3 +1,4 @@
+import { CustomStackHandler } from "../custom-stacks/custom-stack-handler.js";
 import { HookProvider } from "../hooks/hook-provider.js";
 import { ResolverProvider } from "../resolvers/resolver-provider.js";
 import { SchemaProvider } from "../takomo-stacks-model/schemas.js";
@@ -7,6 +8,10 @@ import { FilePath } from "../utils/files.js";
  * Takomo custom configuration.
  */
 export interface TakomoConfig {
+    /**
+     * List of custom stack handler providers.
+     */
+    readonly customStackHandlers?: Array<CustomStackHandler<any, any>>;
     /**
      * List of hook providers.
      */

package/dist/hooks/execute.d.ts

@@ -1,13 +1,13 @@
 import { CloudFormationStack } from "../aws/cloudformation/model.js";
 import { StackOperationVariables } from "../command/command-model.js";
 import { InternalStacksContext } from "../context/stacks-context.js";
-import { Stack } from "../stacks/stack.js";
+import { StandardStack } from "../stacks/standard-stack.js";
 import { TkmLogger } from "../utils/logging.js";
 import { HookExecutor } from "./hook-executor.js";
 import { HookOperation, HooksExecutionOutput, HookStage, HookStatus } from "./hook.js";
 interface ExecuteHooksProps {
     readonly ctx: InternalStacksContext;
-    readonly stack: Stack;
+    readonly stack: StandardStack;
     readonly variables: StackOperationVariables;
     readonly hooks: ReadonlyArray<HookExecutor>;
     readonly operation: HookOperation;

package/dist/hooks/execute.js

@@ -34,6 +34,7 @@ export const executeHooks = async ({ ctx, stack, variables, hooks, operation, st
                     result: "skip",
                 };
             }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
         }
         catch (error) {
             logger.error(`An error occurred while executing hook (name: ${hook.config.name}, type: ${hook.config.type})`, error);

package/dist/hooks/execute.js.map

@@ -1 +1 @@
-{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/hooks/execute.ts"],"names":[],"mappings":"AAyBA,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,EACjC,GAAG,EACH,KAAK,EACL,SAAS,EACT,KAAK,EACL,SAAS,EACT,KAAK,EACL,MAAM,EACN,MAAM,EACN,YAAY,GACM,EAAiC,EAAE;IACrD,MAAM,CAAC,KAAK,CACV,sCAAsC,SAAS,YAAY,KAAK,aAAa,MAAM,GAAG,CACvF,CAAA;IAED,MAAM,KAAK,GAAG;QACZ,GAAG;QACH,KAAK;QACL,SAAS;QACT,KAAK;QACL,SAAS;QACT,MAAM;QACN,MAAM;QACN,YAAY;KACb,CAAA;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;IAE1D,MAAM,CAAC,KAAK,CAAC,SAAS,cAAc,CAAC,MAAM,mBAAmB,CAAC,CAAA;IAE/D,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,CAAC,KAAK,CACV,uBAAuB,IAAI,CAAC,MAAM,CAAC,IAAI,WAAW,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,CACtE,CAAA;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;gBAChC,GAAG,KAAK;gBACR,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;aAChE,CAAC,CAAA;YAEF,MAAM,CAAC,KAAK,CACV,eAAe,IAAI,CAAC,MAAM,CAAC,IAAI,WAAW,IAAI,CAAC,MAAM,CAAC,IAAI,4BAA4B,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC,IAAI,aAAa,MAAM,CAAC,OAAO,EAAE,CACxJ,CAAA;YAED,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAA;YAEhD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,QAAQ;oBACnC,MAAM,EAAE,OAAO;oBACf,KAAK,EAAE,MAAM,CAAC,KAAK;iBACpB,CAAA;YACH,CAAC;YAED,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACzB,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,MAAM;oBACjC,MAAM,EAAE,MAAM;iBACf,CAAA;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,CAAC,KAAK,CACV,iDAAiD,IAAI,CAAC,MAAM,CAAC,IAAI,WAAW,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,EAC/F,KAAK,CACN,CAAA;YACD,OAAO;gBACL,KAAK;gBACL,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,OAAO;aAClC,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,SAAS;QAClB,MAAM,EAAE,UAAU;KACnB,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/hooks/execute.ts"],"names":[],"mappings":"AAyBA,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,EACjC,GAAG,EACH,KAAK,EACL,SAAS,EACT,KAAK,EACL,SAAS,EACT,KAAK,EACL,MAAM,EACN,MAAM,EACN,YAAY,GACM,EAAiC,EAAE;IACrD,MAAM,CAAC,KAAK,CACV,sCAAsC,SAAS,YAAY,KAAK,aAAa,MAAM,GAAG,CACvF,CAAA;IAED,MAAM,KAAK,GAAG;QACZ,GAAG;QACH,KAAK;QACL,SAAS;QACT,KAAK;QACL,SAAS;QACT,MAAM;QACN,MAAM;QACN,YAAY;KACb,CAAA;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;IAE1D,MAAM,CAAC,KAAK,CAAC,SAAS,cAAc,CAAC,MAAM,mBAAmB,CAAC,CAAA;IAE/D,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,CAAC,KAAK,CACV,uBAAuB,IAAI,CAAC,MAAM,CAAC,IAAI,WAAW,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,CACtE,CAAA;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;gBAChC,GAAG,KAAK;gBACR,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;aAChE,CAAC,CAAA;YAEF,MAAM,CAAC,KAAK,CACV,eAAe,IAAI,CAAC,MAAM,CAAC,IAAI,WAAW,IAAI,CAAC,MAAM,CAAC,IAAI,4BAA4B,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC,IAAI,aAAa,MAAM,CAAC,OAAO,EAAE,CACxJ,CAAA;YAED,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAA;YAEhD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,QAAQ;oBACnC,MAAM,EAAE,OAAO;oBACf,KAAK,EAAE,MAAM,CAAC,KAAK;iBACpB,CAAA;YACH,CAAC;YAED,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACzB,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,MAAM;oBACjC,MAAM,EAAE,MAAM;iBACf,CAAA;YACH,CAAC;YACD,8DAA8D;QAChE,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,CAAC,KAAK,CACV,iDAAiD,IAAI,CAAC,MAAM,CAAC,IAAI,WAAW,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,EAC/F,KAAK,CACN,CAAA;YACD,OAAO;gBACL,KAAK;gBACL,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,OAAO;aAClC,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,SAAS;QAClB,MAAM,EAAE,UAAU;KACnB,CAAA;AACH,CAAC,CAAA"}

package/dist/hooks/hook.d.ts

@@ -1,6 +1,6 @@
 import { CloudFormationStack } from "../aws/cloudformation/model.js";
 import { StacksContext } from "../context/stacks-context.js";
-import { Stack } from "../stacks/stack.js";
+import { StandardStack } from "../stacks/standard-stack.js";
 import { StackOperationVariables } from "../takomo-stacks-context/model.js";
 import { TkmLogger } from "../utils/logging.js";
 export type HookType = string;
@@ -38,7 +38,7 @@ export interface HooksExecutionOutput {
  */
 export interface HookInput {
     readonly ctx: StacksContext;
-    readonly stack: Stack;
+    readonly stack: StandardStack;
     readonly variables: StackOperationVariables;
     readonly stage: HookStage;
     readonly operation: HookOperation;

package/dist/index.d.ts

@@ -17,7 +17,7 @@ export type { HookProvider } from "./hooks/hook-provider.js";
 export type { Hook, HookConfig, HookInput, HookName, HookOperation, HookOutput, HookOutputObject, HookStage, HookStatus, HookType, } from "./hooks/hook.js";
 export type { ResolverConfig, ResolverProvider, ResolverProviderSchemaProps, } from "./resolvers/resolver-provider.js";
 export type { Resolver, ResolverInput } from "./resolvers/resolver.js";
-export type { Stack } from "./stacks/stack.js";
+export type { StandardStack as Stack } from "./stacks/standard-stack.js";
 export type { CommandRole, OutputFormat } from "./takomo-core/command.js";
 export type { InitSchemaProps, SchemaProvider, } from "./takomo-stacks-model/schemas.js";
 export type { DeploymentStatus, Label } from "./targets/targets-model.js";
@@ -32,3 +32,7 @@ export { HandlebarsSafeString } from "./templating/handlebars/handlebars-templat
 export type { RenderTemplateFileProps, RenderTemplateProps, TemplateEngine, } from "./templating/template-engine.js";
 export type { FilePath } from "./utils/files.js";
 export type { LogLevel, TkmLogger } from "./utils/logging.js";
+export { isCustomStack } from "./stacks/custom-stack.js";
+export { isStandardStack } from "./stacks/standard-stack.js";
+export type { CustomStack } from "./stacks/custom-stack.js";
+export type { StandardStack } from "./stacks/standard-stack.js";

package/dist/index.js

@@ -3,4 +3,6 @@ export { run } from "./cli/index.js";
 export { EjsTemplateEngineProvider } from "./templating/ejs/ejs-template-engine-provider.js";
 export { HandlebarsTemplateEngineProvider } from "./templating/handlebars/handlebars-template-engine-provider.js";
 export { HandlebarsSafeString } from "./templating/handlebars/handlebars-template-engine.js";
+export { isCustomStack } from "./stacks/custom-stack.js";
+export { isStandardStack } from "./stacks/standard-stack.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,gCAAgC,CAAA;AAavC,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AA0DpC,OAAO,EAAE,yBAAyB,EAAE,MAAM,kDAAkD,CAAA;AAM5F,OAAO,EAAE,gCAAgC,EAAE,MAAM,gEAAgE,CAAA;AAWjH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uDAAuD,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,gCAAgC,CAAA;AAavC,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AA0DpC,OAAO,EAAE,yBAAyB,EAAE,MAAM,kDAAkD,CAAA;AAM5F,OAAO,EAAE,gCAAgC,EAAE,MAAM,gEAAgE,CAAA;AAWjH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uDAAuD,CAAA;AAQ5F,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/parser/stacks/build-custom-stack-config.d.ts

@@ -0,0 +1,5 @@
+import { Result } from "neverthrow";
+import { CommandContext } from "../../context/command-context.js";
+import { ValidationError } from "../../utils/errors.js";
+import { CustomStackConfig } from "../../config/custom-stack-config.js";
+export declare const buildCustomStackConfig: (ctx: CommandContext, record: Record<string, unknown>) => Result<CustomStackConfig, ValidationError>;

package/dist/parser/stacks/build-custom-stack-config.js

@@ -0,0 +1,51 @@
+import { err, ok } from "neverthrow";
+import { ValidationError } from "../../utils/errors.js";
+import { parseCommandRole, parseOptionalBoolean, parseOptionalString, parseOptionalStringArray, parseStringArray, } from "../common-parser.js";
+import { parseAccountIds } from "./parse-account-ids.js";
+import { parseData } from "./parse-data.js";
+import { parseHooks } from "./parse-hooks.js";
+import { parseParameters } from "./parse-parameters.js";
+import { parseSchemas } from "./parse-schemas.js";
+import { parseTags } from "./parse-tags.js";
+import { parseTimeout } from "./parse-timeout.js";
+import { parseCustomStackType } from "./parse-custom-stack-type.js";
+import { createCustomStackConfigSchema } from "../../schema/custom-stack-config-schema.js";
+export const buildCustomStackConfig = (ctx, record) => {
+    const { error } = createCustomStackConfigSchema({
+        regions: ctx.regions,
+    }).validate(record, {
+        abortEarly: false,
+        convert: false,
+    });
+    if (error) {
+        const details = error.details.map((d) => d.message);
+        return err(new ValidationError("Validation errors in custom stack configuration", details));
+    }
+    const customType = parseCustomStackType(record.customType);
+    const schemas = parseSchemas(record.schemas);
+    const data = parseData(record.data);
+    const hooks = parseHooks(record.hooks);
+    const accountIds = parseAccountIds(record.accountIds);
+    return ok({
+        stackType: "custom",
+        customConfig: record.customConfig ?? {},
+        customType,
+        accountIds,
+        data,
+        hooks,
+        schemas,
+        ignore: parseOptionalBoolean(record.ignore),
+        obsolete: parseOptionalBoolean(record.obsolete),
+        terminationProtection: parseOptionalBoolean(record.terminationProtection),
+        project: parseOptionalString(record.project),
+        commandRole: parseCommandRole(record.commandRole),
+        regions: parseStringArray(record.regions),
+        name: parseOptionalString(record.name),
+        timeout: parseTimeout(record.timeout),
+        depends: parseOptionalStringArray(record.depends),
+        tags: parseTags(record.tags),
+        inheritTags: parseOptionalBoolean(record.inheritTags),
+        parameters: parseParameters(record.parameters),
+    });
+};
+//# sourceMappingURL=build-custom-stack-config.js.map

package/dist/parser/stacks/build-custom-stack-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-custom-stack-config.js","sourceRoot":"","sources":["../../../src/parser/stacks/build-custom-stack-config.ts"],"names":[],"mappings":"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"}

package/dist/parser/stacks/build-standard-stack-config.d.ts

@@ -0,0 +1,6 @@
+import { Result } from "neverthrow";
+import { CommandContext } from "../../context/command-context.js";
+import { ValidationError } from "../../utils/errors.js";
+import { ParsedYamlDocument } from "../../utils/yaml.js";
+import { StandardStackConfig } from "../../config/standard-stack-config.js";
+export declare const buildStandardStackConfig: (ctx: CommandContext, record: ParsedYamlDocument, configType: "stack" | "blueprint") => Result<StandardStackConfig, ValidationError>;

package/dist/parser/stacks/{build-stack-config.js → build-standard-stack-config.js}

@@ -1,5 +1,5 @@
 import { err, ok } from "neverthrow";
-import { createStackConfigSchema } from "../../schema/stack-config-schema.js";
+import { createStandardStackConfigSchema } from "../../schema/standard-stack-config-schema.js";
 import { ValidationError } from "../../utils/errors.js";
 import { parseCommandRole, parseOptionalBoolean, parseOptionalString, parseOptionalStringArray, parseStringArray, } from "../common-parser.js";
 import { parseAccountIds } from "./parse-account-ids.js";
@@ -12,8 +12,8 @@ import { parseTags } from "./parse-tags.js";
 import { parseTemplateBucket } from "./parse-template-bucket.js";
 import { parseTemplate } from "./parse-template.js";
 import { parseTimeout } from "./parse-timeout.js";
-export const buildStackConfig = (ctx, record, configType) => {
-    const { error } = createStackConfigSchema({
+export const buildStandardStackConfig = (ctx, record, configType) => {
+    const { error } = createStandardStackConfigSchema({
         regions: ctx.regions,
         configType,
     }).validate(record, {
@@ -35,6 +35,7 @@ export const buildStackConfig = (ctx, record, configType) => {
     const stackPolicy = parseStackPolicy(record.stackPolicy);
     const stackPolicyDuringUpdate = parseStackPolicy(record.stackPolicyDuringUpdate);
     return ok({
+        stackType: "standard",
         accountIds,
         data,
         hooks,
@@ -59,4 +60,4 @@ export const buildStackConfig = (ctx, record, configType) => {
         blueprint: parseOptionalString(record.blueprint),
     });
 };
-//# sourceMappingURL=build-stack-config.js.map
+//# sourceMappingURL=build-standard-stack-config.js.map

package/dist/parser/stacks/build-standard-stack-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-standard-stack-config.js","sourceRoot":"","sources":["../../../src/parser/stacks/build-standard-stack-config.ts"],"names":[],"mappings":"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"}

package/dist/parser/stacks/parse-custom-stack-type.d.ts

@@ -0,0 +1,2 @@
+import { CustomStackType } from "../../stacks/stack.js";
+export declare const parseCustomStackType: (value: unknown) => CustomStackType;

package/dist/parser/stacks/parse-custom-stack-type.js

@@ -0,0 +1,10 @@
+export const parseCustomStackType = (value) => {
+    if (value === null || value === undefined) {
+        throw new Error(`Custom stack type must be defined`);
+    }
+    if (typeof value !== "string") {
+        throw new Error(`Invalid custom stack type: expected a string but got: ${typeof value}`);
+    }
+    return value;
+};
+//# sourceMappingURL=parse-custom-stack-type.js.map

package/dist/parser/stacks/parse-custom-stack-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-custom-stack-type.js","sourceRoot":"","sources":["../../../src/parser/stacks/parse-custom-stack-type.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAmB,EAAE;IACtE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;IACtD,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,yDAAyD,OAAO,KAAK,EAAE,CACxE,CAAA;IACH,CAAC;IAED,OAAO,KAAwB,CAAA;AACjC,CAAC,CAAA"}

package/dist/resolvers/stack-output-resolver.js

@@ -1,5 +1,6 @@
 import { createAwsSchemas } from "../schema/aws-schema.js";
 import { createStacksSchemas } from "../schema/stacks-schema.js";
+import { isStandardStack } from "../stacks/standard-stack.js";
 const init = async (props) => ({
     dependencies: () => [props.stack],
     resolve: async ({ ctx, logger, parameterName, stack: stackConfig, }) => {
@@ -9,6 +10,9 @@ const init = async (props) => ({
             // TODO: We should be able to detect this earlier - when the configuration is being built
             throw new Error(`Stack not found with path: ${props.stack}`);
         }
+        if (!isStandardStack(referencedStack)) {
+            throw new Error(`Stack with path ${props.stack} is not a standard stack. Stack output resolver can only be used with standard stacks`);
+        }
         if (rest.length > 0) {
             // TODO: We should be able to detect this earlier - when the configuration is being built
             throw new Error(`More than one stack found with path: ${props.stack}`);