@quadnix/octo 0.0.30 → 0.1.0

package/dist/services/transaction/transaction.service.js

@@ -11,7 +11,7 @@ import { NodeType, ValidationType, } from '../../app.type.js';
 import { EventSource } from '../../decorators/event-source.decorator.js';
 import { Factory } from '../../decorators/factory.decorator.js';
 import { InputNotFoundTransactionError, InputRegistrationError, ResourceActionExceptionTransactionError, ResourceActionTimeoutTransactionError, TransactionError, ValidationTransactionError, } from '../../errors/index.js';
-import { ModelActionRegistrationEvent, ModelActionTransactionEvent, ModelDiffsTransactionEvent, ModelTransactionTransactionEvent, ResourceActionCompletedTransactionEvent, ResourceActionInformationTransactionEvent, ResourceActionInitiatedTransactionEvent, ResourceActionRegistrationEvent, ResourceActionSummaryTransactionEvent, ResourceDiffsTransactionEvent, ResourceTransactionTransactionEvent, } from '../../events/index.js';
+import { ModelActionRegistrationEvent, ModelActionTransactionEvent, ModelDiffsTransactionEvent, ModelTransactionTransactionEvent, ResourceActionCompletedTransactionEvent, ResourceActionInitiatedTransactionEvent, ResourceActionRegistrationEvent, ResourceActionSummaryTransactionEvent, ResourceDiffsTransactionEvent, ResourceTransactionTransactionEvent, } from '../../events/index.js';
 import { Container } from '../../functions/container/container.js';
 import { DiffMetadata } from '../../functions/diff/diff-metadata.js';
 import { DiffAction } from '../../functions/diff/diff.js';
@@ -21,24 +21,293 @@ import { OverlayDataRepository } from '../../overlays/overlay-data.repository.js
 import { AOverlay } from '../../overlays/overlay.abstract.js';
 import { ResourceDataRepository } from '../../resources/resource-data.repository.js';
 import { AResource } from '../../resources/resource.abstract.js';
-import { CaptureService } from '../capture/capture.service.js';
+import { ATerraformResource } from '../../resources/terraform-resource.abstract.js';
 import { EventService } from '../event/event.service.js';
 import { InputService } from '../input/input.service.js';
+import { TerraformService } from '../terraform/terraform.service.js';
+/**
+ * No-op resource action backing terraform resource diffs. Terraform manages the resource's lifecycle;
+ * octo only carries the diff for review and validation.
+ *
+ * @internal
+ */
+class TerraformNoopResourceAction {
+    /**
+     * @internal
+     */
+    filter() {
+        return true;
+    }
+    /**
+     * @internal
+     */
+    async handle() { }
+}
 /**
  * @internal
  */
 export class TransactionService {
-    constructor(captureService, eventService, inputService, moduleContainer, overlayDataRepository, resourceDataRepository) {
-        this.captureService = captureService;
+    /**
+     * @internal
+     */
+    constructor(eventService, inputService, moduleContainer, overlayDataRepository, resourceDataRepository, terraformService) {
         this.eventService = eventService;
         this.inputService = inputService;
         this.moduleContainer = moduleContainer;
         this.overlayDataRepository = overlayDataRepository;
         this.resourceDataRepository = resourceDataRepository;
+        this.terraformService = terraformService;
         this.modelActions = [];
         this.overlayActions = [];
         this.resourceActions = [];
     }
+    /**
+     * Runs the delete action of every **external** resource in `resourceDiffs` that is being deleted.
+     *
+     * Terraform cannot do this. Octo deletes a resource by removing its block from the configuration,
+     * and terraform will not run a `when = destroy` provisioner for a resource that is no longer in
+     * the configuration - it drops the `null_resource` from state and moves on. So the callback that
+     * would have told an external resource to delete itself never fires, and the real thing it created
+     * outlives both state files with nothing tracking it.
+     *
+     * Octo knows the resource was deleted, which is why this can be driven from its own diff instead.
+     * {@link commit} calls it before recording anything, so a failed delete leaves octo state untouched
+     * and the deletion is retried on the next run rather than being forgotten.
+     *
+     * Terraform-managed resources are excluded: terraform destroys those itself, and a resource action
+     * on one is rejected everywhere else in octo.
+     *
+     * @returns The diffs whose actions ran, in the order they ran.
+     */
+    async applyExternalResourceDeletes(resourceDiffs) {
+        const deleteDiffs = this.getExternalResourceDeletes(resourceDiffs);
+        if (deleteDiffs.length === 0) {
+            return [];
+        }
+        // Ordered among themselves: `applyOrder` is assigned across the whole resource diff set, and
+        // this is a subset of it, so the levels it carries can start anywhere. Re-basing them from zero
+        // keeps applyResources' level walk terminating.
+        const orders = [...new Set(deleteDiffs.map((d) => d.applyOrder))].sort((a, b) => a - b);
+        for (const diff of deleteDiffs) {
+            diff.applyOrder = orders.indexOf(diff.applyOrder);
+        }
+        // Stateless, like run-action: the actual resource graph is not touched here. `commit` syncs
+        // actual to new immediately afterwards, which is what records the deletion.
+        return this.applyResources(deleteDiffs, { skipActualResourceUpdate: true });
+    }
+    /**
+     * @internal
+     */
+    async *beginTransaction(diffs, { enableResourceValidation = false, filterResourceDiffsByResourceId = undefined, generateTerraform = false, skipActualResourceUpdate = false, yieldModelDiffs = false, yieldModelTransaction = false, yieldResourceDiffs = false, yieldResourceTransaction = false, } = {}) {
+        // Diff overlays and add to existing diffs.
+        const overlayDiffs = await this.overlayDataRepository.diff();
+        diffs.push(...overlayDiffs);
+        // Generate diff on models.
+        const modelDiffs = diffs.map((d) => {
+            if (d.node.constructor.NODE_TYPE === NodeType.OVERLAY) {
+                return new DiffMetadata(d, (this.overlayActions.find((a) => a.overlayClass === d.node.constructor)?.actions || []).filter((a) => a.filter(d)));
+            }
+            else {
+                return new DiffMetadata(d, (this.modelActions.find((a) => a.modelClass === d.node.constructor)?.actions || []).filter((a) => a.filter(d)));
+            }
+        });
+        // Set apply order on model diffs.
+        for (const diff of modelDiffs) {
+            this.setApplyOrder(diff, modelDiffs);
+        }
+        this.eventService.emit(new ModelDiffsTransactionEvent(undefined, [modelDiffs]));
+        if (yieldModelDiffs) {
+            yield [modelDiffs];
+        }
+        // Apply model diffs.
+        const modelTransaction = await this.applyModels(modelDiffs);
+        this.eventService.emit(new ModelTransactionTransactionEvent(undefined, modelTransaction));
+        if (yieldModelTransaction) {
+            yield modelTransaction;
+        }
+        // Generate resource diffs.
+        let newDiffs = await this.resourceDataRepository.diff();
+        let dirtyDiffs = await this.resourceDataRepository.diffDirty();
+        // Scope diffs to a single resource, e.g. when terraform invokes octo for one resource action.
+        if (filterResourceDiffsByResourceId !== undefined) {
+            newDiffs = newDiffs.filter((d) => d.node.resourceId === filterResourceDiffsByResourceId);
+            dirtyDiffs = dirtyDiffs.filter((d) => d.node.resourceId === filterResourceDiffsByResourceId);
+            // Prefer dirty diffs (actual-graph nodes) over equal new diffs (old-graph nodes) for
+            // execution: deserialized old resources are frozen and cannot receive injected inputs.
+            for (let i = newDiffs.length - 1; i >= 0; i--) {
+                const newDiff = newDiffs[i];
+                if (dirtyDiffs.some((d) => d.node.getContext() === newDiff.node.getContext() &&
+                    d.action === newDiff.action &&
+                    d.field === newDiff.field &&
+                    DiffUtility.isObjectDeepEquals(d.value, newDiff.value))) {
+                    newDiffs.splice(i, 1);
+                }
+            }
+        }
+        if (enableResourceValidation && (newDiffs.length > 0 || dirtyDiffs.length > 0)) {
+            throw new TransactionError('Cannot run resource validation with pending resource diffs!');
+        }
+        if (enableResourceValidation) {
+            const validationDiffs = this.resourceDataRepository.diffValidate();
+            newDiffs.push(...validationDiffs);
+            dirtyDiffs.push(...validationDiffs);
+        }
+        // new diffs = new - old | dirty diffs = new - actual
+        // Any new diff that is also not part of dirty diffs should be skipped, as the actual is already in desired state.
+        for (let i = newDiffs.length - 1; i >= 0; i--) {
+            const newDiff = newDiffs[i];
+            if (!dirtyDiffs.some((d) => d.node.getContext() === newDiff.node.getContext() &&
+                d.action === newDiff.action &&
+                d.field === newDiff.field &&
+                DiffUtility.isObjectDeepEquals(d.value, newDiff.value))) {
+                newDiffs.splice(i, 1);
+            }
+        }
+        // Ensure any new diffs are not operating on dirty resources.
+        this.resourceDataRepository.ensureDiffsNotOperatingOnDirtyResources(newDiffs);
+        // Skip processing dirty diffs that are already accounted for in new diffs.
+        for (let i = dirtyDiffs.length - 1; i >= 0; i--) {
+            const dirtyDiff = dirtyDiffs[i];
+            if (newDiffs.some((d) => d.node.getContext() === dirtyDiff.node.getContext() &&
+                d.action === dirtyDiff.action &&
+                d.field === dirtyDiff.field &&
+                DiffUtility.isObjectDeepEquals(d.value, dirtyDiff.value))) {
+                dirtyDiffs.splice(i, 1);
+            }
+        }
+        // Terraform resources have no resource actions - terraform owns their lifecycle. Their diffs
+        // remain part of the transaction as review artifacts, backed by a no-op action.
+        const resolveResourceActions = (d) => {
+            if (d.node instanceof ATerraformResource) {
+                return [new TerraformNoopResourceAction()];
+            }
+            return (this.resourceActions.find((a) => a.resourceClass === d.node.constructor)?.actions || []).filter((a) => a.filter(d));
+        };
+        // Generate diff on resources.
+        const resourceDiffs = newDiffs.map((d) => new DiffMetadata(d, resolveResourceActions(d)));
+        // Set apply order on resource diffs.
+        for (const diff of resourceDiffs) {
+            this.setApplyOrder(diff, resourceDiffs);
+        }
+        // Generate diff on dirty resources.
+        const dirtyResourceDiffs = dirtyDiffs.map((d) => new DiffMetadata(d, resolveResourceActions(d)));
+        // Set apply order on dirty resource diffs.
+        for (const diff of dirtyResourceDiffs) {
+            this.setApplyOrder(diff, dirtyResourceDiffs);
+        }
+        // Contribute the full desired resource graph to terraform. Deferred until after resource diffs
+        // are computed and ordered, so an author refusal (a throw in diff*) or an ordering/cycle error
+        // aborts generation before any HCL is built — diffs gate generation.
+        if (generateTerraform) {
+            await this.generateTerraform();
+        }
+        this.eventService.emit(new ResourceDiffsTransactionEvent(undefined, [[resourceDiffs], [dirtyResourceDiffs]]));
+        if (yieldResourceDiffs) {
+            yield [resourceDiffs, dirtyResourceDiffs];
+        }
+        // Apply resource diffs.
+        const resourceTransaction = await this.applyResources(resourceDiffs, { skipActualResourceUpdate });
+        // Apply dirty resource diffs.
+        const dirtyResourceTransaction = await this.applyResources(dirtyResourceDiffs, { skipActualResourceUpdate });
+        this.eventService.emit(new ResourceTransactionTransactionEvent(undefined, [resourceTransaction, dirtyResourceTransaction]));
+        if (yieldResourceTransaction) {
+            yield [...resourceTransaction, ...dirtyResourceTransaction];
+        }
+        return modelTransaction;
+    }
+    /**
+     * The diffs {@link TransactionService.applyExternalResourceDeletes} runs: the deletion of every
+     * external resource in `resourceDiffs`. A caller that has to decide whether to run them at all
+     * names them through this rather than repeating the filter.
+     *
+     * @internal
+     */
+    getExternalResourceDeletes(resourceDiffs) {
+        return resourceDiffs
+            .flat()
+            .filter((d) => d.action === DiffAction.DELETE &&
+            d.field === 'resourceId' &&
+            !(d.node instanceof ATerraformResource) &&
+            !d.applied);
+    }
+    /**
+     * @internal
+     */
+    registerModelActions(forModel, actions) {
+        const modelActions = this.modelActions.find((a) => a.modelClass === forModel);
+        if (!modelActions) {
+            this.modelActions.push({ actions: actions, modelClass: forModel });
+        }
+        else {
+            for (const action of actions) {
+                if (modelActions.actions.find((a) => a.constructor.name === action.constructor.name)) {
+                    throw new Error(`Action "${action.constructor.name}" already registered for model "${forModel.name}"!`);
+                }
+                modelActions.actions.push(action);
+            }
+        }
+    }
+    /**
+     * @internal
+     */
+    registerOverlayActions(forOverlay, actions) {
+        const overlayActions = this.overlayActions.find((a) => a.overlayClass === forOverlay);
+        if (!overlayActions) {
+            this.overlayActions.push({ actions: actions, overlayClass: forOverlay });
+        }
+        else {
+            for (const action of actions) {
+                if (overlayActions.actions.find((a) => a.constructor.name === action.constructor.name)) {
+                    throw new Error(`Action "${action.constructor.name}" already registered for overlay "${forOverlay.name}"!`);
+                }
+                overlayActions.actions.push(action);
+            }
+        }
+    }
+    /**
+     * @internal
+     */
+    registerResourceActions(forResource, actions) {
+        if (forResource.prototype instanceof ATerraformResource) {
+            throw new TransactionError(`Cannot register resource actions for terraform resource "${forResource.name}"! ` +
+                'Terraform resources are managed by terraform via toHCL().');
+        }
+        const resourceActions = this.resourceActions.find((a) => a.resourceClass === forResource);
+        if (!resourceActions) {
+            this.resourceActions.push({ actions: actions, resourceClass: forResource });
+        }
+        else {
+            for (const action of actions) {
+                if (resourceActions.actions.find((a) => a.constructor.name === action.constructor.name)) {
+                    throw new Error(`Action "${action.constructor.name}" already registered for resource "${forResource.name}"!`);
+                }
+                resourceActions.actions.push(action);
+            }
+        }
+    }
+    /**
+     * @internal
+     */
+    unregisterModelActions(forModel) {
+        const modelActions = this.modelActions.find((a) => a.modelClass === forModel);
+        if (!modelActions) {
+            return;
+        }
+        modelActions.actions = [];
+    }
+    /**
+     * @internal
+     */
+    unregisterOverlayActions(forOverlay) {
+        const overlayActions = this.overlayActions.find((a) => a.overlayClass === forOverlay);
+        if (!overlayActions) {
+            return;
+        }
+        overlayActions.actions = [];
+    }
+    /**
+     * @internal
+     */
     async applyModels(diffs) {
         const transaction = [];
         let currentApplyOrder = 0;
@@ -56,12 +325,11 @@ export class TransactionService {
                 const diffToProcess = duplicateDiffs[0].diff;
                 for (const a of diff.actions) {
                     // Find moduleId.
-                    let moduleId;
-                    if (diff.node instanceof AOverlay) {
-                        moduleId = this.inputService.getModuleIdFromOverlay(diff.node);
-                    }
-                    else {
-                        moduleId = this.inputService.getModuleIdFromModel(diff.node);
+                    const moduleId = diff.node instanceof AOverlay
+                        ? this.inputService.getModuleIdFromOverlay(diff.node)
+                        : this.inputService.getModuleIdFromModel(diff.node);
+                    if (moduleId === undefined) {
+                        throw new TransactionError(`Node "${diff.node.getContext()}" is not associated with any module!`);
                     }
                     // Resolve all keys of the module - inputs keys and nodes generated by the module keys.
                     const inputs = { inputs: {}, metadata: {}, models: {}, overlays: {}, resources: {} };
@@ -96,12 +364,11 @@ export class TransactionService {
                     // Apply all actions on the diff, then update diff metadata with inputs and outputs.
                     const outputs = await a.handle(diffToProcess, inputs, {});
                     for (const resource of Object.values(outputs)) {
-                        let moduleId;
-                        if (diffToProcess.node instanceof AOverlay) {
-                            moduleId = this.inputService.getModuleIdFromOverlay(diffToProcess.node);
-                        }
-                        else {
-                            moduleId = this.inputService.getModuleIdFromModel(diffToProcess.node);
+                        const moduleId = diffToProcess.node instanceof AOverlay
+                            ? this.inputService.getModuleIdFromOverlay(diffToProcess.node)
+                            : this.inputService.getModuleIdFromModel(diffToProcess.node);
+                        if (moduleId === undefined) {
+                            throw new TransactionError(`Node "${diffToProcess.node.getContext()}" is not associated with any module!`);
                         }
                         // Set resource tags.
                         const resourceTags = this.inputService.resolve(`${moduleId}.tag.${resource.getContext()}`);
@@ -142,34 +409,10 @@ export class TransactionService {
         }
         return transaction;
     }
-    applyResourcesDryRun(diffs, { enableResourceCapture = false } = {}) {
-        const captures = this.captureService.getAllCaptures();
-        const captureContexts = Object.keys(captures);
-        const missingCaptureContexts = [];
-        if (enableResourceCapture) {
-            for (const capturedContext of captureContexts) {
-                if (!diffs.some((d) => d.node.getContext() === capturedContext)) {
-                    missingCaptureContexts.push(capturedContext);
-                }
-            }
-        }
-        if (missingCaptureContexts.length > 0) {
-            throw new TransactionError(`Provided capture contexts do not match any resource diffs! ${missingCaptureContexts.join(', ')}`);
-        }
-        for (const diff of diffs) {
-            const capture = enableResourceCapture && captureContexts.includes(diff.node.getContext())
-                ? this.captureService.getCapture(diff.node.getContext())
-                : undefined;
-            for (const a of diff.actions) {
-                this.eventService.emit(new ResourceActionInformationTransactionEvent(a.constructor.name, {
-                    action: { name: a.constructor.name },
-                    capture: a.mock ? capture : undefined,
-                    diff,
-                }));
-            }
-        }
-    }
-    async applyResources(diffs, { enableResourceCapture = false } = {}) {
+    /**
+     * @internal
+     */
+    async applyResources(diffs, { skipActualResourceUpdate = false } = {}) {
         const transaction = [];
         const validationErrors = [];
         let currentApplyOrder = 0;
@@ -187,47 +430,66 @@ export class TransactionService {
                 const diffToProcess = duplicateDiffs[0].diff;
                 for (const a of diff.actions) {
                     this.eventService.emit(new ResourceActionInitiatedTransactionEvent(a.constructor.name, diff));
-                    const capture = this.captureService.getCapture(diff.node.getContext());
-                    if (enableResourceCapture && capture?.response && a.mock) {
-                        const response = await a.mock(diff, capture.response);
-                        this.resourceDataRepository.getNewResourceByContext(diffToProcess.node.getContext())?.setResponse(response);
-                    }
-                    else {
-                        let actionTimeoutId;
-                        try {
-                            await Promise.race([
-                                new Promise(async (resolve, reject) => {
-                                    try {
-                                        const response = await a.handle(diffToProcess);
-                                        this.resourceDataRepository
-                                            .getNewResourceByContext(diffToProcess.node.getContext())
-                                            ?.setResponse(response);
+                    // Captured before `handle()` mutates the resource, for the summary event below.
+                    const preHandleSynth = skipActualResourceUpdate
+                        ? this.resourceDataRepository.getNewResourceByContext(diffToProcess.node.getContext())?.synth()
+                        : undefined;
+                    let actionTimeoutId;
+                    try {
+                        await Promise.race([
+                            new Promise(async (resolve, reject) => {
+                                try {
+                                    const response = await a.handle(diffToProcess);
+                                    this.resourceDataRepository
+                                        .getNewResourceByContext(diffToProcess.node.getContext())
+                                        ?.setResponse(response);
+                                    resolve();
+                                }
+                                catch (error) {
+                                    if (diffToProcess.action === DiffAction.VALIDATE) {
+                                        validationErrors.push(error);
                                         resolve();
                                     }
-                                    catch (error) {
-                                        if (diffToProcess.action === DiffAction.VALIDATE) {
-                                            validationErrors.push(error);
-                                            resolve();
-                                        }
-                                        else {
-                                            reject(new ResourceActionExceptionTransactionError(error.message, error, diffToProcess, a.constructor.name));
-                                        }
+                                    else {
+                                        reject(new ResourceActionExceptionTransactionError(error.message, error, diffToProcess, a.constructor.name));
                                     }
-                                }),
-                                new Promise((_resolve, reject) => (actionTimeoutId = setTimeout(() => {
-                                    reject(new ResourceActionTimeoutTransactionError(`Resource action ${a.constructor.name} timed out after ${a.actionTimeoutInMs || 90000}ms!`, diffToProcess, a.constructor.name));
-                                }, a.actionTimeoutInMs || 90000))),
-                            ]);
-                        }
-                        finally {
-                            if (actionTimeoutId) {
-                                clearTimeout(actionTimeoutId);
-                            }
+                                }
+                            }),
+                            new Promise((_resolve, reject) => (actionTimeoutId = setTimeout(() => {
+                                reject(new ResourceActionTimeoutTransactionError(`Resource action ${a.constructor.name} timed out after ${a.actionTimeoutInMs || 90000}ms!`, diffToProcess, a.constructor.name));
+                            }, a.actionTimeoutInMs || 90000))),
+                        ]);
+                    }
+                    finally {
+                        if (actionTimeoutId) {
+                            clearTimeout(actionTimeoutId);
                         }
                     }
-                    // De-reference from actual resources.
+                    if (skipActualResourceUpdate) {
+                        // Stateless invocation (run-action): the actual resource graph is not maintained;
+                        // terraform state is the source of truth until the next commit. The summary is therefore
+                        // derived from the new-graph resource either side of `handle()`.
+                        const postHandleSynth = diffToProcess.action === DiffAction.DELETE && diffToProcess.field === 'resourceId'
+                            ? {}
+                            : this.resourceDataRepository.getNewResourceByContext(diffToProcess.node.getContext())?.synth();
+                        this.eventService.emit(new ResourceActionSummaryTransactionEvent(a.constructor.name, {
+                            diff,
+                            values: { current: postHandleSynth ?? {}, previous: preHandleSynth ?? {} },
+                        }));
+                        this.eventService.emit(new ResourceActionCompletedTransactionEvent(a.constructor.name, diff));
+                        continue;
+                    }
+                    // De-reference from actual resources. The lookup can miss when a diff references a resource
+                    // this transaction has not applied yet, so name what is missing rather than letting
+                    // `undefined` surface as a TypeError several frames away.
                     const deReferenceResource = async (context) => {
-                        return this.resourceDataRepository.getActualResourceByContext(context);
+                        const referencedResource = this.resourceDataRepository.getActualResourceByContext(context);
+                        if (!referencedResource) {
+                            throw new TransactionError(`Cannot apply "${diffToProcess.action}" on field "${String(diffToProcess.field)}" of resource ` +
+                                `"${diffToProcess.node.getContext()}": it references "${context}", which is not in the actual ` +
+                                'resource graph yet. The referenced resource is applied later in this transaction, or not at all.');
+                        }
+                        return referencedResource;
                     };
                     // Incrementally apply diff inverse to the respective actual resource.
                     let actualResource = this.resourceDataRepository.getActualResourceByContext(diffToProcess.node.getContext());
@@ -274,15 +536,52 @@ export class TransactionService {
         }
         return transaction;
     }
+    /**
+     * Contributes every resource in the new (desired) resource graph to the shared
+     * {@link TerraformService}: terraform resources via `toHCL()`, external resources via
+     * `addOctoTerraformExternalResource()`. Always processes the full desired state — terraform
+     * computes the actual create/update/delete against its own state.
+     *
+     * Order does not matter: terraform resources reference each other through deferred refs, and
+     * external resources defer their parent-input wiring — both are resolved later, once every
+     * resource is registered (see {@link TerraformService}'s wiring phase).
+     */
+    async generateTerraform() {
+        const resources = this.resourceDataRepository.getNewResourcesByProperties().filter((r) => !r.isMarkedDeleted());
+        for (const resource of resources) {
+            // Every resource is produced by a model action inside a module, so it is always module-bound.
+            // A missing attribution means the resource was registered out-of-band — a hard error.
+            const moduleId = this.inputService.getModuleIdFromResource(resource);
+            if (moduleId === undefined) {
+                throw new TransactionError(`Resource "${resource.resourceId}" is not associated with any module!`);
+            }
+            const scope = this.terraformService.scope(moduleId);
+            if (resource instanceof ATerraformResource) {
+                await resource.toHCL(scope);
+            }
+            else {
+                scope.addOctoTerraformExternalResource(resource);
+            }
+        }
+    }
+    /**
+     * @internal
+     */
     getDiffsOfSameNode(diff, diffs, diffAction) {
         return diffs.filter((d) => d.node.getContext() === diff.node.getContext() && d.action === diffAction);
     }
+    /**
+     * @internal
+     */
     getDuplicateDiffs(diff, diffs) {
         return diffs.filter((d) => d.node.getContext() === diff.node.getContext() &&
             d.field === diff.field &&
             d.action === diff.action &&
             DiffUtility.isObjectDeepEquals(d.value, diff.value));
     }
+    /**
+     * @internal
+     */
     getMatchingDiffs(diff, diffs) {
         return diffs.filter((d) => d.node.getContext() === diff.node.getContext() &&
             d.field === diff.field &&
@@ -324,8 +623,9 @@ export class TransactionService {
             }
         }
         // Get diffs of same node.
-        // Process ADD before UPDATE, and UPDATE before DELETE.
-        if (diff.action === DiffAction.UPDATE) {
+        // Process ADD before UPDATE/REPLACE, and UPDATE/REPLACE before DELETE. A REPLACE recreates the
+        // resource in place (same context), so for ordering it behaves like an UPDATE.
+        if (diff.action === DiffAction.UPDATE || diff.action === DiffAction.REPLACE) {
             const diffsOfSameNodeWithAddAction = this.getDiffsOfSameNode(diff, diffs, DiffAction.ADD);
             for (const sameNodeDiffWithAddAction of diffsOfSameNodeWithAddAction) {
                 this.setApplyOrder(sameNodeDiffWithAddAction, diffs, [...seen, diff]);
@@ -341,154 +641,6 @@ export class TransactionService {
         }
         diff.applyOrder = Math.max(...dependencyApplyOrders) + 1;
     }
-    async *beginTransaction(diffs, { enableResourceCapture = false, enableResourceValidation = false, yieldModelDiffs = false, yieldModelTransaction = false, yieldResourceDiffs = false, yieldResourceTransaction = false, } = {}) {
-        // Diff overlays and add to existing diffs.
-        const overlayDiffs = await this.overlayDataRepository.diff();
-        diffs.push(...overlayDiffs);
-        // Generate diff on models.
-        const modelDiffs = diffs.map((d) => {
-            if (d.node.constructor.NODE_TYPE === NodeType.OVERLAY) {
-                return new DiffMetadata(d, (this.overlayActions.find((a) => a.overlayClass === d.node.constructor)?.actions || []).filter((a) => a.filter(d)));
-            }
-            else {
-                return new DiffMetadata(d, (this.modelActions.find((a) => a.modelClass === d.node.constructor)?.actions || []).filter((a) => a.filter(d)));
-            }
-        });
-        // Set apply order on model diffs.
-        for (const diff of modelDiffs) {
-            this.setApplyOrder(diff, modelDiffs);
-        }
-        this.eventService.emit(new ModelDiffsTransactionEvent(undefined, [modelDiffs]));
-        if (yieldModelDiffs) {
-            yield [modelDiffs];
-        }
-        // Apply model diffs.
-        const modelTransaction = await this.applyModels(modelDiffs);
-        this.eventService.emit(new ModelTransactionTransactionEvent(undefined, modelTransaction));
-        if (yieldModelTransaction) {
-            yield modelTransaction;
-        }
-        // Generate resource diffs.
-        const newDiffs = await this.resourceDataRepository.diff();
-        const dirtyDiffs = await this.resourceDataRepository.diffDirty();
-        if (enableResourceValidation && (newDiffs.length > 0 || dirtyDiffs.length > 0)) {
-            throw new TransactionError('Cannot run resource validation with pending resource diffs!');
-        }
-        if (enableResourceValidation) {
-            const validationDiffs = this.resourceDataRepository.diffValidate();
-            newDiffs.push(...validationDiffs);
-            dirtyDiffs.push(...validationDiffs);
-        }
-        // new diffs = new - old | dirty diffs = new - actual
-        // Any new diff that is also not part of dirty diffs should be skipped, as the actual is already in desired state.
-        for (let i = newDiffs.length - 1; i >= 0; i--) {
-            const newDiff = newDiffs[i];
-            if (!dirtyDiffs.some((d) => d.node.getContext() === newDiff.node.getContext() &&
-                d.action === newDiff.action &&
-                d.field === newDiff.field &&
-                DiffUtility.isObjectDeepEquals(d.value, newDiff.value))) {
-                newDiffs.splice(i, 1);
-            }
-        }
-        // Ensure any new diffs are not operating on dirty resources.
-        this.resourceDataRepository.ensureDiffsNotOperatingOnDirtyResources(newDiffs);
-        // Skip processing dirty diffs that are already accounted for in new diffs.
-        for (let i = dirtyDiffs.length - 1; i >= 0; i--) {
-            const dirtyDiff = dirtyDiffs[i];
-            if (newDiffs.some((d) => d.node.getContext() === dirtyDiff.node.getContext() &&
-                d.action === dirtyDiff.action &&
-                d.field === dirtyDiff.field &&
-                DiffUtility.isObjectDeepEquals(d.value, dirtyDiff.value))) {
-                dirtyDiffs.splice(i, 1);
-            }
-        }
-        // Generate diff on resources.
-        const resourceDiffs = newDiffs.map((d) => new DiffMetadata(d, (this.resourceActions.find((a) => a.resourceClass === d.node.constructor)?.actions || []).filter((a) => a.filter(d))));
-        // Set apply order on resource diffs.
-        for (const diff of resourceDiffs) {
-            this.setApplyOrder(diff, resourceDiffs);
-        }
-        // Generate diff on dirty resources.
-        const dirtyResourceDiffs = dirtyDiffs.map((d) => new DiffMetadata(d, (this.resourceActions.find((a) => a.resourceClass === d.node.constructor)?.actions || []).filter((a) => a.filter(d))));
-        // Set apply order on dirty resource diffs.
-        for (const diff of dirtyResourceDiffs) {
-            this.setApplyOrder(diff, dirtyResourceDiffs);
-        }
-        this.applyResourcesDryRun([...resourceDiffs, ...dirtyResourceDiffs], { enableResourceCapture });
-        this.eventService.emit(new ResourceDiffsTransactionEvent(undefined, [[resourceDiffs], [dirtyResourceDiffs]]));
-        if (yieldResourceDiffs) {
-            yield [resourceDiffs, dirtyResourceDiffs];
-        }
-        // Apply resource diffs.
-        const resourceTransaction = await this.applyResources(resourceDiffs, {
-            enableResourceCapture,
-        });
-        // Apply dirty resource diffs.
-        const dirtyResourceTransaction = await this.applyResources(dirtyResourceDiffs, {
-            enableResourceCapture,
-        });
-        this.eventService.emit(new ResourceTransactionTransactionEvent(undefined, [resourceTransaction, dirtyResourceTransaction]));
-        if (yieldResourceTransaction) {
-            yield [...resourceTransaction, ...dirtyResourceTransaction];
-        }
-        return modelTransaction;
-    }
-    registerModelActions(forModel, actions) {
-        const modelActions = this.modelActions.find((a) => a.modelClass === forModel);
-        if (!modelActions) {
-            this.modelActions.push({ actions: actions, modelClass: forModel });
-        }
-        else {
-            for (const action of actions) {
-                if (modelActions.actions.find((a) => a.constructor.name === action.constructor.name)) {
-                    throw new Error(`Action "${action.constructor.name}" already registered for model "${forModel.name}"!`);
-                }
-                modelActions.actions.push(action);
-            }
-        }
-    }
-    registerOverlayActions(forOverlay, actions) {
-        const overlayActions = this.overlayActions.find((a) => a.overlayClass === forOverlay);
-        if (!overlayActions) {
-            this.overlayActions.push({ actions: actions, overlayClass: forOverlay });
-        }
-        else {
-            for (const action of actions) {
-                if (overlayActions.actions.find((a) => a.constructor.name === action.constructor.name)) {
-                    throw new Error(`Action "${action.constructor.name}" already registered for overlay "${forOverlay.name}"!`);
-                }
-                overlayActions.actions.push(action);
-            }
-        }
-    }
-    registerResourceActions(forResource, actions) {
-        const resourceActions = this.resourceActions.find((a) => a.resourceClass === forResource);
-        if (!resourceActions) {
-            this.resourceActions.push({ actions: actions, resourceClass: forResource });
-        }
-        else {
-            for (const action of actions) {
-                if (resourceActions.actions.find((a) => a.constructor.name === action.constructor.name)) {
-                    throw new Error(`Action "${action.constructor.name}" already registered for resource "${forResource.name}"!`);
-                }
-                resourceActions.actions.push(action);
-            }
-        }
-    }
-    unregisterModelActions(forModel) {
-        const modelActions = this.modelActions.find((a) => a.modelClass === forModel);
-        if (!modelActions) {
-            return;
-        }
-        modelActions.actions = [];
-    }
-    unregisterOverlayActions(forOverlay) {
-        const overlayActions = this.overlayActions.find((a) => a.overlayClass === forOverlay);
-        if (!overlayActions) {
-            return;
-        }
-        overlayActions.actions = [];
-    }
 }
 __decorate([
     EventSource(ModelActionRegistrationEvent),
@@ -512,18 +664,21 @@ __decorate([
  * @internal
  */
 let TransactionServiceFactory = class TransactionServiceFactory {
+    /**
+     * @internal
+     */
     static async create() {
         const container = Container.getInstance();
-        const [captureService, eventService, inputService, moduleContainer, overlayDataRepository, resourceDataRepository] = await Promise.all([
-            container.get(CaptureService),
+        const [eventService, inputService, moduleContainer, overlayDataRepository, resourceDataRepository, terraformService,] = await Promise.all([
             container.get(EventService),
             container.get(InputService),
             container.get(ModuleContainer),
             container.get(OverlayDataRepository),
             container.get(ResourceDataRepository),
+            container.get(TerraformService),
         ]);
         if (!this.instance) {
-            this.instance = new TransactionService(captureService, eventService, inputService, moduleContainer, overlayDataRepository, resourceDataRepository);
+            this.instance = new TransactionService(eventService, inputService, moduleContainer, overlayDataRepository, resourceDataRepository, terraformService);
         }
         return this.instance;
     }