declastruct 1.0.0 → 1.1.0

package/dist/domain.operations/apply/applyChanges.integration.test.js

@@ -0,0 +1,291 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const bottleneck_1 = __importDefault(require("bottleneck"));
+const fs_1 = require("fs");
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const demo_provider_1 = require("../../.test/assets/providers/demo.provider");
+const DeclastructChange_1 = require("../../domain.objects/DeclastructChange");
+const planChanges_1 = require("../plan/planChanges");
+const applyChanges_1 = require("./applyChanges");
+describe('applyChanges', () => {
+    const wishFilePath = (0, path_1.resolve)(process.cwd(), 'src/.test/assets/wish.fixture.ts');
+    beforeAll(async () => {
+        // initialize provider (creates temp directory)
+        await demo_provider_1.demoProvider.hooks.beforeAll();
+    });
+    const createContext = () => ({
+        bottleneck: new bottleneck_1.default({ maxConcurrent: 1 }),
+        log: {
+            info: jest.fn(),
+            error: jest.fn(),
+            warn: jest.fn(),
+            debug: jest.fn(),
+        },
+    });
+    it('should apply CREATE changes and verify files created on disk', async () => {
+        // define desired resources with automatic unique IDs
+        const resources = [
+            (0, demo_provider_1.genSampleDemoResource)({ name: 'First Test' }),
+            (0, demo_provider_1.genSampleDemoResource)({ name: 'Second Test' }),
+        ];
+        // plan changes
+        const plan = await (0, planChanges_1.planChanges)({
+            resources,
+            providers: [demo_provider_1.demoProvider],
+            wishFilePath,
+        }, createContext());
+        // verify plan has CREATE actions
+        expect(plan.changes.every((c) => c.action === DeclastructChange_1.DeclastructChangeAction.CREATE)).toBe(true);
+        // apply changes
+        const result = await (0, applyChanges_1.applyChanges)({
+            plan,
+            resources,
+            providers: [demo_provider_1.demoProvider],
+        }, createContext());
+        // verify changes were applied
+        expect(result.appliedChanges.length).toBe(2);
+        result.appliedChanges.forEach((change) => {
+            expect(change.action).toBe(DeclastructChange_1.DeclastructChangeAction.CREATE);
+        });
+        // verify files exist on disk
+        const file1Path = (0, path_1.resolve)(process.cwd(), `.test/demo/provider/.temp/${resources[0].exid}.json`);
+        const file2Path = (0, path_1.resolve)(process.cwd(), `.test/demo/provider/.temp/${resources[1].exid}.json`);
+        expect((0, fs_1.existsSync)(file1Path)).toBe(true);
+        expect((0, fs_1.existsSync)(file2Path)).toBe(true);
+        // verify file contents
+        const file1Json = await (0, promises_1.readFile)(file1Path, 'utf-8');
+        const file1Data = JSON.parse(file1Json);
+        expect(file1Data.exid).toBe(resources[0].exid);
+        expect(file1Data.name).toBe('First Test');
+        const file2Json = await (0, promises_1.readFile)(file2Path, 'utf-8');
+        const file2Data = JSON.parse(file2Json);
+        expect(file2Data.exid).toBe(resources[1].exid);
+        expect(file2Data.name).toBe('Second Test');
+    });
+    it('should apply UPDATE changes and verify files modified on disk', async () => {
+        // create initial resource
+        const initialResource = (0, demo_provider_1.genSampleDemoResource)({ name: 'Old Name' });
+        // create initial remote state
+        const dao = demo_provider_1.demoProvider.daos.DemoResource;
+        await dao.set.finsert(initialResource, {});
+        // define desired resource with updated name (same exid)
+        const resources = [initialResource.clone({ name: 'New Name' })];
+        // plan changes
+        const plan = await (0, planChanges_1.planChanges)({
+            resources,
+            providers: [demo_provider_1.demoProvider],
+            wishFilePath,
+        }, createContext());
+        // verify plan has UPDATE action
+        expect(plan.changes.length).toBe(1);
+        expect(plan.changes[0].action).toBe(DeclastructChange_1.DeclastructChangeAction.UPDATE);
+        // apply changes
+        const result = await (0, applyChanges_1.applyChanges)({
+            plan,
+            resources,
+            providers: [demo_provider_1.demoProvider],
+        }, createContext());
+        // verify update was applied
+        expect(result.appliedChanges.length).toBe(1);
+        expect(result.appliedChanges[0].action).toBe(DeclastructChange_1.DeclastructChangeAction.UPDATE);
+        // verify file was updated on disk
+        const filePath = (0, path_1.resolve)(process.cwd(), `.test/demo/provider/.temp/${initialResource.exid}.json`);
+        const fileJson = await (0, promises_1.readFile)(filePath, 'utf-8');
+        const fileData = JSON.parse(fileJson);
+        expect(fileData.name).toBe('New Name');
+    });
+    it('should skip KEEP changes without making modifications', async () => {
+        // create resource
+        const resource = (0, demo_provider_1.genSampleDemoResource)({ name: 'Unchanged' });
+        // create remote state
+        const dao = demo_provider_1.demoProvider.daos.DemoResource;
+        await dao.set.finsert(resource, {});
+        // define same resource (no changes)
+        const resources = [resource];
+        // plan changes
+        const plan = await (0, planChanges_1.planChanges)({
+            resources,
+            providers: [demo_provider_1.demoProvider],
+            wishFilePath,
+        }, createContext());
+        // verify plan has KEEP action
+        expect(plan.changes.length).toBe(1);
+        expect(plan.changes[0].action).toBe(DeclastructChange_1.DeclastructChangeAction.KEEP);
+        // apply changes
+        const context = createContext();
+        const result = await (0, applyChanges_1.applyChanges)({
+            plan,
+            resources,
+            providers: [demo_provider_1.demoProvider],
+        }, context);
+        // verify KEEP was not included in applied changes
+        expect(result.appliedChanges.length).toBe(0);
+        // verify log was emitted for KEEP
+        expect(context.log.info).toHaveBeenCalledWith(expect.stringContaining('[KEEP]'), {});
+        // verify file still exists with same content
+        const filePath = (0, path_1.resolve)(process.cwd(), `.test/demo/provider/.temp/${resource.exid}.json`);
+        const fileJson = await (0, promises_1.readFile)(filePath, 'utf-8');
+        const fileData = JSON.parse(fileJson);
+        expect(fileData.name).toBe('Unchanged');
+    });
+    it('should emit real-time logs as changes are applied', async () => {
+        // define resources
+        const resources = [
+            (0, demo_provider_1.genSampleDemoResource)({ name: 'First Test' }),
+            (0, demo_provider_1.genSampleDemoResource)({ name: 'Second Test' }),
+        ];
+        // plan changes
+        const plan = await (0, planChanges_1.planChanges)({
+            resources,
+            providers: [demo_provider_1.demoProvider],
+            wishFilePath,
+        }, createContext());
+        // apply with spy on log
+        const context = createContext();
+        await (0, applyChanges_1.applyChanges)({
+            plan,
+            resources,
+            providers: [demo_provider_1.demoProvider],
+        }, context);
+        // verify logs were emitted (logs include the full slug with hash)
+        expect(context.log.info).toHaveBeenCalledWith(expect.stringContaining(`[CREATE] DemoResource.`), {});
+        expect(context.log.info).toHaveBeenCalled();
+    });
+    it('should handle mixed CREATE, UPDATE, and KEEP actions in single apply', async () => {
+        // create initial resources for remote state
+        const resource1 = (0, demo_provider_1.genSampleDemoResource)({ name: 'Unchanged' });
+        const resource2 = (0, demo_provider_1.genSampleDemoResource)({ name: 'Old Name' });
+        // create remote state for some resources
+        const dao = demo_provider_1.demoProvider.daos.DemoResource;
+        await dao.set.finsert(resource1, {});
+        await dao.set.finsert(resource2, {});
+        // define desired resources
+        const resources = [
+            resource1, // KEEP (unchanged)
+            resource2.clone({ name: 'New Name' }), // UPDATE
+            (0, demo_provider_1.genSampleDemoResource)({ name: 'Brand New' }), // CREATE
+        ];
+        // plan changes
+        const plan = await (0, planChanges_1.planChanges)({
+            resources,
+            providers: [demo_provider_1.demoProvider],
+            wishFilePath,
+        }, createContext());
+        // verify mixed actions in plan
+        expect(plan.changes.length).toBe(3);
+        // apply changes
+        const result = await (0, applyChanges_1.applyChanges)({
+            plan,
+            resources,
+            providers: [demo_provider_1.demoProvider],
+        }, createContext());
+        // verify only CREATE and UPDATE were applied (not KEEP)
+        expect(result.appliedChanges.length).toBe(2);
+        const appliedActions = result.appliedChanges.map((c) => c.action);
+        expect(appliedActions).toContain(DeclastructChange_1.DeclastructChangeAction.UPDATE);
+        expect(appliedActions).toContain(DeclastructChange_1.DeclastructChangeAction.CREATE);
+        // verify all files exist with correct content
+        const file1Path = (0, path_1.resolve)(process.cwd(), `.test/demo/provider/.temp/${resources[0].exid}.json`);
+        const file2Path = (0, path_1.resolve)(process.cwd(), `.test/demo/provider/.temp/${resources[1].exid}.json`);
+        const file3Path = (0, path_1.resolve)(process.cwd(), `.test/demo/provider/.temp/${resources[2].exid}.json`);
+        expect((0, fs_1.existsSync)(file1Path)).toBe(true);
+        expect((0, fs_1.existsSync)(file2Path)).toBe(true);
+        expect((0, fs_1.existsSync)(file3Path)).toBe(true);
+        const file2Json = await (0, promises_1.readFile)(file2Path, 'utf-8');
+        const file2Data = JSON.parse(file2Json);
+        expect(file2Data.name).toBe('New Name');
+    });
+    it('should detect and reject stale plans', async () => {
+        // define initial resource
+        const initialResources = [(0, demo_provider_1.genSampleDemoResource)({ name: 'Original Name' })];
+        // plan changes
+        const plan = await (0, planChanges_1.planChanges)({
+            resources: initialResources,
+            providers: [demo_provider_1.demoProvider],
+            wishFilePath,
+        }, createContext());
+        // apply the plan (creates the resource)
+        await (0, applyChanges_1.applyChanges)({
+            plan,
+            resources: initialResources,
+            providers: [demo_provider_1.demoProvider],
+        }, createContext());
+        // externally modify the resource
+        const dao = demo_provider_1.demoProvider.daos.DemoResource;
+        await dao.set.upsert(initialResources[0].clone({ name: 'Externally Modified' }), {});
+        // try to reapply the stale plan
+        await expect((0, applyChanges_1.applyChanges)({
+            plan, // stale plan still shows "Original Name"
+            resources: initialResources,
+            providers: [demo_provider_1.demoProvider],
+        }, createContext())).rejects.toThrow();
+    });
+    it('should be idempotent - reapplying same plan is safe', async () => {
+        // define resource
+        const resources = [(0, demo_provider_1.genSampleDemoResource)({ name: 'Test Resource' })];
+        // plan changes
+        const plan = await (0, planChanges_1.planChanges)({
+            resources,
+            providers: [demo_provider_1.demoProvider],
+            wishFilePath,
+        }, createContext());
+        // apply first time
+        const result1 = await (0, applyChanges_1.applyChanges)({
+            plan,
+            resources,
+            providers: [demo_provider_1.demoProvider],
+        }, createContext());
+        expect(result1.appliedChanges.length).toBe(1);
+        expect(result1.appliedChanges[0].action).toBe(DeclastructChange_1.DeclastructChangeAction.CREATE);
+        // replan with same resources
+        const plan2 = await (0, planChanges_1.planChanges)({
+            resources,
+            providers: [demo_provider_1.demoProvider],
+            wishFilePath,
+        }, createContext());
+        // apply second time
+        const result2 = await (0, applyChanges_1.applyChanges)({
+            plan: plan2,
+            resources,
+            providers: [demo_provider_1.demoProvider],
+        }, createContext());
+        // verify second apply was KEEP (no changes)
+        expect(result2.appliedChanges.length).toBe(0);
+        expect(plan2.changes[0].action).toBe(DeclastructChange_1.DeclastructChangeAction.KEEP);
+        // verify file exists with correct content
+        const filePath = (0, path_1.resolve)(process.cwd(), `.test/demo/provider/.temp/${resources[0].exid}.json`);
+        const fileJson = await (0, promises_1.readFile)(filePath, 'utf-8');
+        const fileData = JSON.parse(fileJson);
+        expect(fileData.name).toBe('Test Resource');
+    });
+    it('should validate plan before applying to ensure it is still valid', async () => {
+        // define resource
+        const resources = [(0, demo_provider_1.genSampleDemoResource)({ name: 'Test Resource' })];
+        // plan changes
+        const originalPlan = await (0, planChanges_1.planChanges)({
+            resources,
+            providers: [demo_provider_1.demoProvider],
+            wishFilePath,
+        }, createContext());
+        // apply the plan (creates the resource)
+        await (0, applyChanges_1.applyChanges)({
+            plan: originalPlan,
+            resources,
+            providers: [demo_provider_1.demoProvider],
+        }, createContext());
+        // externally modify the remote resource to make original plan stale
+        const dao = demo_provider_1.demoProvider.daos.DemoResource;
+        await dao.set.upsert(resources[0].clone({ name: 'Externally Modified' }), {});
+        // try to apply the stale plan again
+        await expect((0, applyChanges_1.applyChanges)({
+            plan: originalPlan, // stale - remote state changed
+            resources,
+            providers: [demo_provider_1.demoProvider],
+        }, createContext())).rejects.toThrow('plan is stale');
+    });
+});
+//# sourceMappingURL=applyChanges.integration.test.js.map

package/dist/domain.operations/apply/applyChanges.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyChanges.integration.test.js","sourceRoot":"","sources":["../../../src/domain.operations/apply/applyChanges.integration.test.ts"],"names":[],"mappings":";;;;;AAAA,4DAAoC;AACpC,2BAAgC;AAChC,0CAAuC;AACvC,+BAA+B;AAE/B,8EAIoD;AACpD,8EAAiF;AACjF,qDAAkD;AAClD,iDAA8C;AAE9C,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,MAAM,YAAY,GAAG,IAAA,cAAO,EAC1B,OAAO,CAAC,GAAG,EAAE,EACb,kCAAkC,CACnC,CAAC;IAEF,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,+CAA+C;QAC/C,MAAM,4BAAY,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,CAAC;QAC3B,UAAU,EAAE,IAAI,oBAAU,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;QAChD,GAAG,EAAE;YACH,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;YACf,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;YAChB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;YACf,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;SACjB;KACF,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,qDAAqD;QACrD,MAAM,SAAS,GAAG;YAChB,IAAA,qCAAqB,EAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;YAC7C,IAAA,qCAAqB,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;SAC/C,CAAC;QAEF,eAAe;QACf,MAAM,IAAI,GAAG,MAAM,IAAA,yBAAW,EAC5B;YACE,SAAS;YACT,SAAS,EAAE,CAAC,4BAAY,CAAC;YACzB,YAAY;SACb,EACD,aAAa,EAAE,CAChB,CAAC;QAEF,iCAAiC;QACjC,MAAM,CACJ,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,2CAAuB,CAAC,MAAM,CAAC,CACvE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,gBAAgB;QAChB,MAAM,MAAM,GAAG,MAAM,IAAA,2BAAY,EAC/B;YACE,IAAI;YACJ,SAAS;YACT,SAAS,EAAE,CAAC,4BAAY,CAAC;SAC1B,EACD,aAAa,EAAE,CAChB,CAAC;QAEF,8BAA8B;QAC9B,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YACvC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,2CAAuB,CAAC,MAAM,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,6BAA6B;QAC7B,MAAM,SAAS,GAAG,IAAA,cAAO,EACvB,OAAO,CAAC,GAAG,EAAE,EACb,6BAA6B,SAAS,CAAC,CAAC,CAAE,CAAC,IAAI,OAAO,CACvD,CAAC;QACF,MAAM,SAAS,GAAG,IAAA,cAAO,EACvB,OAAO,CAAC,GAAG,EAAE,EACb,6BAA6B,SAAS,CAAC,CAAC,CAAE,CAAC,IAAI,OAAO,CACvD,CAAC;QAEF,MAAM,CAAC,IAAA,eAAU,EAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,IAAA,eAAU,EAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEzC,uBAAuB;QACvB,MAAM,SAAS,GAAG,MAAM,IAAA,mBAAQ,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACxC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAE1C,MAAM,SAAS,GAAG,MAAM,IAAA,mBAAQ,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACxC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,0BAA0B;QAC1B,MAAM,eAAe,GAAG,IAAA,qCAAqB,EAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAEpE,8BAA8B;QAC9B,MAAM,GAAG,GAAG,4BAAY,CAAC,IAAI,CAAC,YAAY,CAAC;QAC3C,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QAE3C,wDAAwD;QACxD,MAAM,SAAS,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;QAEhE,eAAe;QACf,MAAM,IAAI,GAAG,MAAM,IAAA,yBAAW,EAC5B;YACE,SAAS;YACT,SAAS,EAAE,CAAC,4BAAY,CAAC;YACzB,YAAY;SACb,EACD,aAAa,EAAE,CAChB,CAAC;QAEF,gCAAgC;QAChC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,2CAAuB,CAAC,MAAM,CAAC,CAAC;QAErE,gBAAgB;QAChB,MAAM,MAAM,GAAG,MAAM,IAAA,2BAAY,EAC/B;YACE,IAAI;YACJ,SAAS;YACT,SAAS,EAAE,CAAC,4BAAY,CAAC;SAC1B,EACD,aAAa,EAAE,CAChB,CAAC;QAEF,4BAA4B;QAC5B,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAC3C,2CAAuB,CAAC,MAAM,CAC/B,CAAC;QAEF,kCAAkC;QAClC,MAAM,QAAQ,GAAG,IAAA,cAAO,EACtB,OAAO,CAAC,GAAG,EAAE,EACb,6BAA6B,eAAe,CAAC,IAAI,OAAO,CACzD,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,IAAA,mBAAQ,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,kBAAkB;QAClB,MAAM,QAAQ,GAAG,IAAA,qCAAqB,EAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QAE9D,sBAAsB;QACtB,MAAM,GAAG,GAAG,4BAAY,CAAC,IAAI,CAAC,YAAY,CAAC;QAC3C,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAEpC,oCAAoC;QACpC,MAAM,SAAS,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE7B,eAAe;QACf,MAAM,IAAI,GAAG,MAAM,IAAA,yBAAW,EAC5B;YACE,SAAS;YACT,SAAS,EAAE,CAAC,4BAAY,CAAC;YACzB,YAAY;SACb,EACD,aAAa,EAAE,CAChB,CAAC;QAEF,8BAA8B;QAC9B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,2CAAuB,CAAC,IAAI,CAAC,CAAC;QAEnE,gBAAgB;QAChB,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,IAAA,2BAAY,EAC/B;YACE,IAAI;YACJ,SAAS;YACT,SAAS,EAAE,CAAC,4BAAY,CAAC;SAC1B,EACD,OAAO,CACR,CAAC;QAEF,kDAAkD;QAClD,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAE7C,kCAAkC;QAClC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAC3C,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EACjC,EAAE,CACH,CAAC;QAEF,6CAA6C;QAC7C,MAAM,QAAQ,GAAG,IAAA,cAAO,EACtB,OAAO,CAAC,GAAG,EAAE,EACb,6BAA6B,QAAQ,CAAC,IAAI,OAAO,CAClD,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,IAAA,mBAAQ,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,mBAAmB;QACnB,MAAM,SAAS,GAAG;YAChB,IAAA,qCAAqB,EAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;YAC7C,IAAA,qCAAqB,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;SAC/C,CAAC;QAEF,eAAe;QACf,MAAM,IAAI,GAAG,MAAM,IAAA,yBAAW,EAC5B;YACE,SAAS;YACT,SAAS,EAAE,CAAC,4BAAY,CAAC;YACzB,YAAY;SACb,EACD,aAAa,EAAE,CAChB,CAAC;QAEF,wBAAwB;QACxB,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;QAChC,MAAM,IAAA,2BAAY,EAChB;YACE,IAAI;YACJ,SAAS;YACT,SAAS,EAAE,CAAC,4BAAY,CAAC;SAC1B,EACD,OAAO,CACR,CAAC;QAEF,kEAAkE;QAClE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAC3C,MAAM,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,EACjD,EAAE,CACH,CAAC;QACF,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACpF,4CAA4C;QAC5C,MAAM,SAAS,GAAG,IAAA,qCAAqB,EAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QAC/D,MAAM,SAAS,GAAG,IAAA,qCAAqB,EAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAE9D,yCAAyC;QACzC,MAAM,GAAG,GAAG,4BAAY,CAAC,IAAI,CAAC,YAAY,CAAC;QAC3C,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACrC,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAErC,2BAA2B;QAC3B,MAAM,SAAS,GAAG;YAChB,SAAS,EAAE,mBAAmB;YAC9B,SAAS,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS;YAChD,IAAA,qCAAqB,EAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS;SACxD,CAAC;QAEF,eAAe;QACf,MAAM,IAAI,GAAG,MAAM,IAAA,yBAAW,EAC5B;YACE,SAAS;YACT,SAAS,EAAE,CAAC,4BAAY,CAAC;YACzB,YAAY;SACb,EACD,aAAa,EAAE,CAChB,CAAC;QAEF,+BAA+B;QAC/B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpC,gBAAgB;QAChB,MAAM,MAAM,GAAG,MAAM,IAAA,2BAAY,EAC/B;YACE,IAAI;YACJ,SAAS;YACT,SAAS,EAAE,CAAC,4BAAY,CAAC;SAC1B,EACD,aAAa,EAAE,CAChB,CAAC;QAEF,wDAAwD;QACxD,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAE7C,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAClE,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,2CAAuB,CAAC,MAAM,CAAC,CAAC;QACjE,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,2CAAuB,CAAC,MAAM,CAAC,CAAC;QAEjE,8CAA8C;QAC9C,MAAM,SAAS,GAAG,IAAA,cAAO,EACvB,OAAO,CAAC,GAAG,EAAE,EACb,6BAA6B,SAAS,CAAC,CAAC,CAAE,CAAC,IAAI,OAAO,CACvD,CAAC;QACF,MAAM,SAAS,GAAG,IAAA,cAAO,EACvB,OAAO,CAAC,GAAG,EAAE,EACb,6BAA6B,SAAS,CAAC,CAAC,CAAE,CAAC,IAAI,OAAO,CACvD,CAAC;QACF,MAAM,SAAS,GAAG,IAAA,cAAO,EACvB,OAAO,CAAC,GAAG,EAAE,EACb,6BAA6B,SAAS,CAAC,CAAC,CAAE,CAAC,IAAI,OAAO,CACvD,CAAC;QAEF,MAAM,CAAC,IAAA,eAAU,EAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,IAAA,eAAU,EAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,IAAA,eAAU,EAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEzC,MAAM,SAAS,GAAG,MAAM,IAAA,mBAAQ,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACxC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QACpD,0BAA0B;QAC1B,MAAM,gBAAgB,GAAG,CAAC,IAAA,qCAAqB,EAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;QAE5E,eAAe;QACf,MAAM,IAAI,GAAG,MAAM,IAAA,yBAAW,EAC5B;YACE,SAAS,EAAE,gBAAgB;YAC3B,SAAS,EAAE,CAAC,4BAAY,CAAC;YACzB,YAAY;SACb,EACD,aAAa,EAAE,CAChB,CAAC;QAEF,wCAAwC;QACxC,MAAM,IAAA,2BAAY,EAChB;YACE,IAAI;YACJ,SAAS,EAAE,gBAAgB;YAC3B,SAAS,EAAE,CAAC,4BAAY,CAAC;SAC1B,EACD,aAAa,EAAE,CAChB,CAAC;QAEF,iCAAiC;QACjC,MAAM,GAAG,GAAG,4BAAY,CAAC,IAAI,CAAC,YAAa,CAAC;QAC5C,MAAM,GAAG,CAAC,GAAG,CAAC,MAAO,CACnB,gBAAgB,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC,EAC3D,EAAE,CACH,CAAC;QAEF,gCAAgC;QAChC,MAAM,MAAM,CACV,IAAA,2BAAY,EACV;YACE,IAAI,EAAE,yCAAyC;YAC/C,SAAS,EAAE,gBAAgB;YAC3B,SAAS,EAAE,CAAC,4BAAY,CAAC;SAC1B,EACD,aAAa,EAAE,CAChB,CACF,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,kBAAkB;QAClB,MAAM,SAAS,GAAG,CAAC,IAAA,qCAAqB,EAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;QAErE,eAAe;QACf,MAAM,IAAI,GAAG,MAAM,IAAA,yBAAW,EAC5B;YACE,SAAS;YACT,SAAS,EAAE,CAAC,4BAAY,CAAC;YACzB,YAAY;SACb,EACD,aAAa,EAAE,CAChB,CAAC;QAEF,mBAAmB;QACnB,MAAM,OAAO,GAAG,MAAM,IAAA,2BAAY,EAChC;YACE,IAAI;YACJ,SAAS;YACT,SAAS,EAAE,CAAC,4BAAY,CAAC;SAC1B,EACD,aAAa,EAAE,CAChB,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAC5C,2CAAuB,CAAC,MAAM,CAC/B,CAAC;QAEF,6BAA6B;QAC7B,MAAM,KAAK,GAAG,MAAM,IAAA,yBAAW,EAC7B;YACE,SAAS;YACT,SAAS,EAAE,CAAC,4BAAY,CAAC;YACzB,YAAY;SACb,EACD,aAAa,EAAE,CAChB,CAAC;QAEF,oBAAoB;QACpB,MAAM,OAAO,GAAG,MAAM,IAAA,2BAAY,EAChC;YACE,IAAI,EAAE,KAAK;YACX,SAAS;YACT,SAAS,EAAE,CAAC,4BAAY,CAAC;SAC1B,EACD,aAAa,EAAE,CAChB,CAAC;QAEF,4CAA4C;QAC5C,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,2CAAuB,CAAC,IAAI,CAAC,CAAC;QAEpE,0CAA0C;QAC1C,MAAM,QAAQ,GAAG,IAAA,cAAO,EACtB,OAAO,CAAC,GAAG,EAAE,EACb,6BAA6B,SAAS,CAAC,CAAC,CAAE,CAAC,IAAI,OAAO,CACvD,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,IAAA,mBAAQ,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,kBAAkB;QAClB,MAAM,SAAS,GAAG,CAAC,IAAA,qCAAqB,EAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;QAErE,eAAe;QACf,MAAM,YAAY,GAAG,MAAM,IAAA,yBAAW,EACpC;YACE,SAAS;YACT,SAAS,EAAE,CAAC,4BAAY,CAAC;YACzB,YAAY;SACb,EACD,aAAa,EAAE,CAChB,CAAC;QAEF,wCAAwC;QACxC,MAAM,IAAA,2BAAY,EAChB;YACE,IAAI,EAAE,YAAY;YAClB,SAAS;YACT,SAAS,EAAE,CAAC,4BAAY,CAAC;SAC1B,EACD,aAAa,EAAE,CAChB,CAAC;QAEF,oEAAoE;QACpE,MAAM,GAAG,GAAG,4BAAY,CAAC,IAAI,CAAC,YAAa,CAAC;QAC5C,MAAM,GAAG,CAAC,GAAG,CAAC,MAAO,CACnB,SAAS,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC,EACpD,EAAE,CACH,CAAC;QAEF,oCAAoC;QACpC,MAAM,MAAM,CACV,IAAA,2BAAY,EACV;YACE,IAAI,EAAE,YAAY,EAAE,+BAA+B;YACnD,SAAS;YACT,SAAS,EAAE,CAAC,4BAAY,CAAC;SAC1B,EACD,aAAa,EAAE,CAChB,CACF,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/domain.operations/apply/applyChanges.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyChanges = void 0;
+const domain_objects_1 = require("domain-objects");
+const helpful_errors_1 = require("helpful-errors");
+const DeclastructChange_1 = require("../../domain.objects/DeclastructChange");
+const planChanges_1 = require("../plan/planChanges");
+const validate_1 = require("../plan/validate");
+const applyChange_1 = require("./applyChange");
+/**
+ * .what = applies a validated plan to achieve desired state
+ * .why = executes infrastructure changes in a controlled, observable manner
+ * .note = idempotent - reapplying same plan is safe (guards check if already applied)
+ */
+const applyChanges = async (input, context) => {
+    // replan to ensure plan is still valid
+    const currentPlan = await (0, planChanges_1.planChanges)({
+        resources: input.resources,
+        providers: input.providers,
+        wishFilePath: input.plan.wish.uri,
+    }, context);
+    // validate plan matches current state
+    (0, validate_1.assertPlanStillValid)({
+        originalPlan: input.plan,
+        currentPlan,
+    });
+    // apply each change with real-time logging
+    const appliedChanges = [];
+    for (const change of input.plan.changes) {
+        // log KEEP actions and skip
+        if (change.action === DeclastructChange_1.DeclastructChangeAction.KEEP) {
+            context.log.info(`↓ [KEEP] ${change.forResource.slug}`, {});
+            continue;
+        }
+        // find the desired resource
+        const resourceFound = input.resources.find((candidate) => candidate.constructor.name === change.forResource.class &&
+            (0, domain_objects_1.getUniqueIdentifierSlug)(candidate) === change.forResource.slug) ??
+            helpful_errors_1.UnexpectedCodePathError.throw('could not find resource specified in plan. was it removed and plan is no longer valid?', { change });
+        // apply the change
+        const applied = await (0, applyChange_1.applyChange)({
+            change,
+            resource: resourceFound,
+            providers: input.providers,
+            context,
+        });
+        // log success immediately
+        context.log.info(`✔ [${applied.action}] ${applied.forResource.slug}`, {});
+        appliedChanges.push(applied);
+    }
+    return { appliedChanges };
+};
+exports.applyChanges = applyChanges;
+//# sourceMappingURL=applyChanges.js.map

package/dist/domain.operations/apply/applyChanges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyChanges.js","sourceRoot":"","sources":["../../../src/domain.operations/apply/applyChanges.ts"],"names":[],"mappings":";;;AAAA,mDAAuE;AACvE,mDAAyD;AAIzD,8EAGgD;AAGhD,qDAAkD;AAClD,+CAAwD;AACxD,+CAA4C;AAE5C;;;;GAIG;AACI,MAAM,YAAY,GAAG,KAAK,EAC/B,KAIC,EACD,OAA6C,EACK,EAAE;IACpD,uCAAuC;IACvC,MAAM,WAAW,GAAG,MAAM,IAAA,yBAAW,EACnC;QACE,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;KAClC,EACD,OAAO,CACR,CAAC;IAEF,sCAAsC;IACtC,IAAA,+BAAoB,EAAC;QACnB,YAAY,EAAE,KAAK,CAAC,IAAI;QACxB,WAAW;KACZ,CAAC,CAAC;IAEH,2CAA2C;IAC3C,MAAM,cAAc,GAAwB,EAAE,CAAC;IAE/C,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACxC,4BAA4B;QAC5B,IAAI,MAAM,CAAC,MAAM,KAAK,2CAAuB,CAAC,IAAI,EAAE,CAAC;YACnD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAC5D,SAAS;QACX,CAAC;QAED,4BAA4B;QAC5B,MAAM,aAAa,GACjB,KAAK,CAAC,SAAS,CAAC,IAAI,CAClB,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS,CAAC,WAAW,CAAC,IAAI,KAAK,MAAM,CAAC,WAAW,CAAC,KAAK;YACvD,IAAA,wCAAuB,EAAC,SAAS,CAAC,KAAK,MAAM,CAAC,WAAW,CAAC,IAAI,CACjE;YACD,wCAAuB,CAAC,KAAK,CAC3B,wFAAwF,EACxF,EAAE,MAAM,EAAE,CACX,CAAC;QAEJ,mBAAmB;QACnB,MAAM,OAAO,GAAG,MAAM,IAAA,yBAAW,EAAC;YAChC,MAAM;YACN,QAAQ,EAAE,aAAa;YACvB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO;SACR,CAAC,CAAC;QAEH,0BAA0B;QAC1B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAE1E,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,EAAE,cAAc,EAAE,CAAC;AAC5B,CAAC,CAAC;AA7DW,QAAA,YAAY,gBA6DvB"}

package/dist/domain.operations/plan/computeChange.d.ts

@@ -0,0 +1,11 @@
+import { DomainEntity } from 'domain-objects';
+import { DeclastructChange } from '../../domain.objects/DeclastructChange';
+/**
+ * .what = computes a single change by comparing desired vs remote state
+ * .why = determines the action needed to achieve desired state for one resource
+ * .note = uses IIFE to compute action immutably
+ */
+export declare const computeChange: ({ desired, remote, }: {
+    desired: DomainEntity<any> | null;
+    remote: DomainEntity<any> | null;
+}) => DeclastructChange;

package/dist/domain.operations/plan/computeChange.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeChange = void 0;
+const domain_objects_1 = require("domain-objects");
+const jest_diff_1 = require("jest-diff");
+const DeclastructChange_1 = require("../../domain.objects/DeclastructChange");
+/**
+ * .what = checks if two resources are equivalent
+ * .why = determines whether a resource needs to be updated
+ * .note = uses JSON serialization for deep equality check
+ */
+const resourcesAreEquivalent = (remote, desired) => {
+    // serialize both to JSON for deep comparison
+    const remoteJson = JSON.stringify(remote);
+    const desiredJson = JSON.stringify(desired);
+    return remoteJson === desiredJson;
+};
+/**
+ * .what = computes human-readable diff between two resources
+ * .why = helps users understand what will change
+ * .note = returns null if resources are identical; for CREATE uses empty object to show all attributes
+ */
+const computeDiff = ({ from, into, }) => {
+    // no diff if both are null
+    if (from === null && into === null)
+        return null;
+    // use empty object for CREATE to show all attributes in diff
+    const fromValue = from === null ? {} : from;
+    const intoValue = into === null ? {} : into;
+    // compute diff using jest-diff
+    const difference = (0, jest_diff_1.diff)(fromValue, intoValue, {
+        aAnnotation: 'Remote',
+        bAnnotation: 'Desired',
+    });
+    return difference;
+};
+/**
+ * .what = computes a single change by comparing desired vs remote state
+ * .why = determines the action needed to achieve desired state for one resource
+ * .note = uses IIFE to compute action immutably
+ */
+const computeChange = ({ desired, remote, }) => {
+    // determine action based on state comparison
+    const action = (() => {
+        // resource doesn't exist remotely
+        if (!remote)
+            return DeclastructChange_1.DeclastructChangeAction.CREATE;
+        // resource exists but should be deleted
+        if (!desired)
+            return DeclastructChange_1.DeclastructChangeAction.DESTROY;
+        // no changes needed
+        if (resourcesAreEquivalent(remote, desired))
+            return DeclastructChange_1.DeclastructChangeAction.KEEP;
+        // resource exists and needs updating
+        return DeclastructChange_1.DeclastructChangeAction.UPDATE;
+    })();
+    // compute displayable difference
+    const difference = action === DeclastructChange_1.DeclastructChangeAction.KEEP
+        ? null
+        : computeDiff({ from: remote, into: desired });
+    // get resource info for change record
+    const resourceForChange = desired || remote;
+    // return change
+    return new DeclastructChange_1.DeclastructChange({
+        forResource: {
+            class: resourceForChange.constructor.name,
+            slug: (0, domain_objects_1.getUniqueIdentifierSlug)(resourceForChange),
+        },
+        action,
+        state: {
+            desired,
+            remote,
+            difference,
+        },
+    });
+};
+exports.computeChange = computeChange;
+//# sourceMappingURL=computeChange.js.map

package/dist/domain.operations/plan/computeChange.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeChange.js","sourceRoot":"","sources":["../../../src/domain.operations/plan/computeChange.ts"],"names":[],"mappings":";;;AAAA,mDAAuE;AACvE,yCAAiC;AAEjC,8EAGgD;AAEhD;;;;GAIG;AACH,MAAM,sBAAsB,GAAG,CAC7B,MAAyB,EACzB,OAA0B,EACjB,EAAE;IACX,6CAA6C;IAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAE5C,OAAO,UAAU,KAAK,WAAW,CAAC;AACpC,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,GAAG,CAAC,EACnB,IAAI,EACJ,IAAI,GAIL,EAAiB,EAAE;IAClB,2BAA2B;IAC3B,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhD,6DAA6D;IAC7D,MAAM,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAE5C,+BAA+B;IAC/B,MAAM,UAAU,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,SAAS,EAAE;QAC5C,WAAW,EAAE,QAAQ;QACrB,WAAW,EAAE,SAAS;KACvB,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAEF;;;;GAIG;AACI,MAAM,aAAa,GAAG,CAAC,EAC5B,OAAO,EACP,MAAM,GAIP,EAAqB,EAAE;IACtB,6CAA6C;IAC7C,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE;QACnB,kCAAkC;QAClC,IAAI,CAAC,MAAM;YAAE,OAAO,2CAAuB,CAAC,MAAM,CAAC;QAEnD,wCAAwC;QACxC,IAAI,CAAC,OAAO;YAAE,OAAO,2CAAuB,CAAC,OAAO,CAAC;QAErD,oBAAoB;QACpB,IAAI,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC;YACzC,OAAO,2CAAuB,CAAC,IAAI,CAAC;QAEtC,qCAAqC;QACrC,OAAO,2CAAuB,CAAC,MAAM,CAAC;IACxC,CAAC,CAAC,EAAE,CAAC;IAEL,iCAAiC;IACjC,MAAM,UAAU,GACd,MAAM,KAAK,2CAAuB,CAAC,IAAI;QACrC,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAEnD,sCAAsC;IACtC,MAAM,iBAAiB,GAAG,OAAO,IAAI,MAAO,CAAC;IAE7C,gBAAgB;IAChB,OAAO,IAAI,qCAAiB,CAAC;QAC3B,WAAW,EAAE;YACX,KAAK,EAAE,iBAAiB,CAAC,WAAW,CAAC,IAAI;YACzC,IAAI,EAAE,IAAA,wCAAuB,EAAC,iBAAiB,CAAC;SACjD;QACD,MAAM;QACN,KAAK,EAAE;YACL,OAAO;YACP,MAAM;YACN,UAAU;SACX;KACF,CAAC,CAAC;AACL,CAAC,CAAC;AA7CW,QAAA,aAAa,iBA6CxB"}

package/dist/domain.operations/plan/computeChange.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/domain.operations/plan/computeChange.test.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const domain_objects_1 = require("domain-objects");
+const DeclastructChange_1 = require("../../domain.objects/DeclastructChange");
+const computeChange_1 = require("./computeChange");
+describe('computeChange', () => {
+    class DemoResource extends domain_objects_1.DomainEntity {
+    }
+    DemoResource.unique = ['id'];
+    it('should return CREATE when remote is null', () => {
+        const desired = new DemoResource({ id: 'new-1', name: 'New Resource' });
+        const change = (0, computeChange_1.computeChange)({
+            desired,
+            remote: null,
+        });
+        expect(change.action).toBe(DeclastructChange_1.DeclastructChangeAction.CREATE);
+        expect(change.forResource.class).toBe('DemoResource');
+        expect(change.forResource.slug).toBe((0, domain_objects_1.getUniqueIdentifierSlug)(desired));
+        expect(change.state.desired).toBe(desired);
+        expect(change.state.remote).toBeNull();
+        expect(change.state.difference).toBeTruthy();
+    });
+    it('should return DESTROY when desired is null', () => {
+        const remote = new DemoResource({ id: 'old-1', name: 'Old Resource' });
+        const change = (0, computeChange_1.computeChange)({
+            desired: null,
+            remote,
+        });
+        expect(change.action).toBe(DeclastructChange_1.DeclastructChangeAction.DESTROY);
+        expect(change.forResource.class).toBe('DemoResource');
+        expect(change.forResource.slug).toBe((0, domain_objects_1.getUniqueIdentifierSlug)(remote));
+        expect(change.state.desired).toBeNull();
+        expect(change.state.remote).toBe(remote);
+        expect(change.state.difference).toBeTruthy();
+    });
+    it('should return KEEP when resources are equivalent', () => {
+        const desired = new DemoResource({ id: 'same-1', name: 'Same Resource' });
+        const remote = new DemoResource({ id: 'same-1', name: 'Same Resource' });
+        const change = (0, computeChange_1.computeChange)({
+            desired,
+            remote,
+        });
+        expect(change.action).toBe(DeclastructChange_1.DeclastructChangeAction.KEEP);
+        expect(change.forResource.class).toBe('DemoResource');
+        expect(change.forResource.slug).toBe((0, domain_objects_1.getUniqueIdentifierSlug)(desired));
+        expect(change.state.desired).toBe(desired);
+        expect(change.state.remote).toBe(remote);
+        expect(change.state.difference).toBeNull();
+    });
+    it('should return UPDATE when resources differ', () => {
+        const desired = new DemoResource({ id: 'update-1', name: 'New Name' });
+        const remote = new DemoResource({ id: 'update-1', name: 'Old Name' });
+        const change = (0, computeChange_1.computeChange)({
+            desired,
+            remote,
+        });
+        expect(change.action).toBe(DeclastructChange_1.DeclastructChangeAction.UPDATE);
+        expect(change.forResource.class).toBe('DemoResource');
+        expect(change.forResource.slug).toBe((0, domain_objects_1.getUniqueIdentifierSlug)(desired));
+        expect(change.state.desired).toBe(desired);
+        expect(change.state.remote).toBe(remote);
+        expect(change.state.difference).toBeTruthy();
+        expect(change.state.difference).toContain('Old Name');
+        expect(change.state.difference).toContain('New Name');
+    });
+});
+//# sourceMappingURL=computeChange.test.js.map

package/dist/domain.operations/plan/computeChange.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeChange.test.js","sourceRoot":"","sources":["../../../src/domain.operations/plan/computeChange.test.ts"],"names":[],"mappings":"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"}

package/dist/domain.operations/plan/extractResourcesFromPlan.d.ts

@@ -0,0 +1,8 @@
+import { DomainEntity } from 'domain-objects';
+import { DeclastructPlan } from '../../domain.objects/DeclastructPlan';
+/**
+ * .what = extracts resources from a plan's changes
+ * .why = needed for replanning during applyChanges
+ * .note = returns desired state for each change, filtering out DESTROY-only changes
+ */
+export declare const extractResourcesFromPlan: (plan: DeclastructPlan) => DomainEntity<any>[];

package/dist/domain.operations/plan/extractResourcesFromPlan.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractResourcesFromPlan = void 0;
+/**
+ * .what = extracts resources from a plan's changes
+ * .why = needed for replanning during applyChanges
+ * .note = returns desired state for each change, filtering out DESTROY-only changes
+ */
+const extractResourcesFromPlan = (plan) => {
+    // extract desired resources from changes
+    const resources = plan.changes
+        .map((change) => change.state.desired)
+        .filter((resource) => resource !== null);
+    return resources;
+};
+exports.extractResourcesFromPlan = extractResourcesFromPlan;
+//# sourceMappingURL=extractResourcesFromPlan.js.map

package/dist/domain.operations/plan/extractResourcesFromPlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractResourcesFromPlan.js","sourceRoot":"","sources":["../../../src/domain.operations/plan/extractResourcesFromPlan.ts"],"names":[],"mappings":";;;AAIA;;;;GAIG;AACI,MAAM,wBAAwB,GAAG,CACtC,IAAqB,EACA,EAAE;IACvB,yCAAyC;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO;SAC3B,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;SACrC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,IAAI,CAAwB,CAAC;IAElE,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AATW,QAAA,wBAAwB,4BASnC"}

package/dist/domain.operations/plan/getDaoByResource.d.ts

@@ -0,0 +1,12 @@
+import { DomainEntity } from 'domain-objects';
+import { DeclastructDao } from '../../domain.objects/DeclastructDao';
+import { DeclastructProvider } from '../../domain.objects/DeclastructProvider';
+/**
+ * .what = gets the DAO for a given resource from available providers
+ * .why = enables automatic routing of operations to the correct provider
+ * .note = fails fast if multiple providers support same resource or if no provider is found
+ */
+export declare const getDaoByResource: ({ resource, providers, }: {
+    resource: DomainEntity<any>;
+    providers: DeclastructProvider<any, any>[];
+}) => DeclastructDao<DomainEntity<any>, any, any>;

package/dist/domain.operations/plan/getDaoByResource.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDaoByResource = void 0;
+const helpful_errors_1 = require("helpful-errors");
+/**
+ * .what = gets the DAO for a given resource from available providers
+ * .why = enables automatic routing of operations to the correct provider
+ * .note = fails fast if multiple providers support same resource or if no provider is found
+ */
+const getDaoByResource = ({ resource, providers, }) => {
+    // get resource class name
+    const resourceClassName = resource.constructor.name;
+    // find all DAOs applicable to this resource
+    const daosApplicable = providers
+        .map((provider) => ({
+        from: provider.name,
+        dao: provider.daos[resourceClassName],
+    }))
+        .filter((match) => match.dao);
+    // reject if multiple providers support same resource
+    if (daosApplicable.length > 1) {
+        throw new helpful_errors_1.UnexpectedCodePathError('multiple providers support same resource', {
+            resource: resourceClassName,
+            providers: daosApplicable.map((m) => m.from),
+        });
+    }
+    // reject if no DAO found
+    const [matchedDao] = daosApplicable;
+    if (!matchedDao) {
+        throw new helpful_errors_1.UnexpectedCodePathError('no DAO found for resource', {
+            resourceClassName,
+            availableProviders: providers.map((p) => ({
+                name: p.name,
+                supportedResources: Object.keys(p.daos),
+            })),
+        });
+    }
+    return matchedDao.dao;
+};
+exports.getDaoByResource = getDaoByResource;
+//# sourceMappingURL=getDaoByResource.js.map

package/dist/domain.operations/plan/getDaoByResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDaoByResource.js","sourceRoot":"","sources":["../../../src/domain.operations/plan/getDaoByResource.ts"],"names":[],"mappings":";;;AACA,mDAAyD;AAKzD;;;;GAIG;AACI,MAAM,gBAAgB,GAAG,CAAC,EAC/B,QAAQ,EACR,SAAS,GAIV,EAA+C,EAAE;IAChD,0BAA0B;IAC1B,MAAM,iBAAiB,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC;IAEpD,4CAA4C;IAC5C,MAAM,cAAc,GAAG,SAAS;SAC7B,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC;KACtC,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEhC,qDAAqD;IACrD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,wCAAuB,CAC/B,0CAA0C,EAC1C;YACE,QAAQ,EAAE,iBAAiB;YAC3B,SAAS,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAC7C,CACF,CAAC;IACJ,CAAC;IAED,yBAAyB;IACzB,MAAM,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC;IACpC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,wCAAuB,CAAC,2BAA2B,EAAE;YAC7D,iBAAiB;YACjB,kBAAkB,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACxC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;aACxC,CAAC,CAAC;SACJ,CAAC,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC,GAAG,CAAC;AACxB,CAAC,CAAC;AA1CW,QAAA,gBAAgB,oBA0C3B"}

package/dist/domain.operations/plan/getDaoByResource.test.d.ts

@@ -0,0 +1 @@
+export {};