declastruct 1.0.0 → 1.1.1

package/dist/domain.objects/DeclastructProvider.d.ts

@@ -0,0 +1,30 @@
+import { DomainLiteral } from 'domain-objects';
+import { DeclastructDao } from './DeclastructDao';
+export type DeclastructDaosShape<TContext> = Record<string, DeclastructDao<any, any, TContext>>;
+/**
+ * .what = bundles all DAOs and lifecycle hooks for a specific infrastructure provider
+ * .why = enables plug-and-play support for different infrastructure backends (AWS, GCP, Azure, etc)
+ */
+export interface DeclastructProvider<TDeclastructDaos extends DeclastructDaosShape<TContext> = DeclastructDaosShape<any>, TContext = any> {
+    /**
+     * unique name identifying this provider
+     */
+    name: string;
+    /**
+     * map of resource class names to their DAOs
+     */
+    daos: TDeclastructDaos;
+    /**
+     * provider-specific context (credentials, region, etc)
+     */
+    context: TContext;
+    /**
+     * lifecycle hooks for setup and teardown
+     */
+    hooks: {
+        beforeAll: () => Promise<void>;
+        afterAll: () => Promise<void>;
+    };
+}
+export declare class DeclastructProvider<TDeclastructDaos extends DeclastructDaosShape<TContext> = DeclastructDaosShape<any>, TContext = any> extends DomainLiteral<DeclastructProvider<TDeclastructDaos, TContext>> implements DeclastructProvider<TDeclastructDaos, TContext> {
+}

package/dist/domain.objects/DeclastructProvider.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeclastructProvider = void 0;
+const domain_objects_1 = require("domain-objects");
+class DeclastructProvider extends domain_objects_1.DomainLiteral {
+}
+exports.DeclastructProvider = DeclastructProvider;
+//# sourceMappingURL=DeclastructProvider.js.map

package/dist/domain.objects/DeclastructProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeclastructProvider.js","sourceRoot":"","sources":["../../src/domain.objects/DeclastructProvider.ts"],"names":[],"mappings":";;;AAAA,mDAA+C;AAyC/C,MAAa,mBAIX,SAAQ,8BAA8D;CACT;AAL/D,kDAK+D"}

package/dist/domain.objects/DeclastructProvider.test.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const DeclastructProvider_1 = require("./DeclastructProvider");
+describe('DeclastructProvider', () => {
+    it('should build a provider with all required properties', () => {
+        const provider = new DeclastructProvider_1.DeclastructProvider({
+            name: 'test-provider',
+            daos: {},
+            context: {},
+            hooks: {
+                beforeAll: async () => { },
+                afterAll: async () => { },
+            },
+        });
+        expect(provider.name).toBe('test-provider');
+        expect(provider.daos).toEqual({});
+        expect(provider.context).toEqual({});
+        expect(provider.hooks.beforeAll).toBeDefined();
+        expect(provider.hooks.afterAll).toBeDefined();
+    });
+    it('should work without explicit type arguments', () => {
+        // type verification - default type parameters should work
+        const provider = new DeclastructProvider_1.DeclastructProvider({
+            name: 'default-provider',
+            daos: {},
+            context: {},
+            hooks: {
+                beforeAll: async () => { },
+                afterAll: async () => { },
+            },
+        });
+        expect(provider).toBeDefined();
+    });
+});
+//# sourceMappingURL=DeclastructProvider.test.js.map

package/dist/domain.objects/DeclastructProvider.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeclastructProvider.test.js","sourceRoot":"","sources":["../../src/domain.objects/DeclastructProvider.test.ts"],"names":[],"mappings":";;AAAA,+DAA4D;AAE5D,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,QAAQ,GAAG,IAAI,yCAAmB,CAAC;YACvC,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,EAAE;YACR,OAAO,EAAE,EAAE;YACX,KAAK,EAAE;gBACL,SAAS,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;gBACzB,QAAQ,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;aACzB;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/C,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,0DAA0D;QAC1D,MAAM,QAAQ,GAAG,IAAI,yCAAmB,CAAC;YACvC,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,EAAE;YACR,OAAO,EAAE,EAAE;YACX,KAAK,EAAE;gBACL,SAAS,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;gBACzB,QAAQ,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;aACzB;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/domain.objects/IsoTimestamp.d.ts

@@ -0,0 +1,6 @@
+/**
+ * .what = ISO 8601 timestamp string type
+ * .why = provides type safety for timestamp strings while maintaining JSON serialization compatibility
+ * .note = represents timestamps in ISO 8601 format (e.g., "2025-11-22T10:30:00.000Z")
+ */
+export type IsoTimestamp = string;

package/dist/{domain/DeclaredResource.js → domain.objects/IsoTimestamp.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=DeclaredResource.js.map
+//# sourceMappingURL=IsoTimestamp.js.map

package/dist/domain.objects/IsoTimestamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IsoTimestamp.js","sourceRoot":"","sources":["../../src/domain.objects/IsoTimestamp.ts"],"names":[],"mappings":""}

package/dist/domain.objects/IsoTimestamp.test.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+describe('IsoTimestamp', () => {
+    it('should be a string type', () => {
+        // type verification
+        const timestamp = '2025-11-22T10:30:00.000Z';
+        expect(typeof timestamp).toBe('string');
+    });
+});
+//# sourceMappingURL=IsoTimestamp.test.js.map

package/dist/domain.objects/IsoTimestamp.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IsoTimestamp.test.js","sourceRoot":"","sources":["../../src/domain.objects/IsoTimestamp.test.ts"],"names":[],"mappings":";;AAEA,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,oBAAoB;QACpB,MAAM,SAAS,GAAiB,0BAA0B,CAAC;QAC3D,MAAM,CAAC,OAAO,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/domain.operations/apply/applyChange.d.ts

@@ -0,0 +1,14 @@
+import { DomainEntity } from 'domain-objects';
+import { DeclastructChange } from '../../domain.objects/DeclastructChange';
+import { DeclastructProvider } from '../../domain.objects/DeclastructProvider';
+/**
+ * .what = applies a single change to infrastructure
+ * .why = executes the actual infrastructure modification
+ * .note = different actions require different DAO methods; fails fast if method not available
+ */
+export declare const applyChange: <TContext = any>({ resource, change, providers, context, }: {
+    resource: DomainEntity<any>;
+    change: DeclastructChange;
+    providers: DeclastructProvider<any, TContext>[];
+    context: TContext;
+}) => Promise<DeclastructChange>;

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

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyChange = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const DeclastructChange_1 = require("../../domain.objects/DeclastructChange");
+const getDaoByResource_1 = require("../plan/getDaoByResource");
+/**
+ * .what = applies a single change to infrastructure
+ * .why = executes the actual infrastructure modification
+ * .note = different actions require different DAO methods; fails fast if method not available
+ */
+const applyChange = async ({ resource, change, providers, context, }) => {
+    // skip KEEP actions immediately
+    if (change.action === DeclastructChange_1.DeclastructChangeAction.KEEP)
+        return change;
+    // validate that the name of the resource and on the change is the same
+    if (resource.constructor.name !== change.forResource.class)
+        throw new helpful_errors_1.UnexpectedCodePathError('why were we asked to apply a change on an unrelated resource?', { resource, change });
+    const dao = (0, getDaoByResource_1.getDaoByResource)({
+        resource,
+        providers,
+    });
+    // execute action based on change type
+    switch (change.action) {
+        case DeclastructChange_1.DeclastructChangeAction.CREATE:
+            // create new resource
+            await dao.set.finsert(change.state.desired, context);
+            return change;
+        case DeclastructChange_1.DeclastructChangeAction.UPDATE:
+            // update existing resource
+            if (!dao.set.upsert) {
+                throw new helpful_errors_1.UnexpectedCodePathError('DAO does not support updates', {
+                    resourceClassName: change.forResource.class,
+                });
+            }
+            await dao.set.upsert(change.state.desired, context);
+            return change;
+        case DeclastructChange_1.DeclastructChangeAction.DESTROY:
+            // delete resource
+            if (!dao.set.delete) {
+                throw new helpful_errors_1.UnexpectedCodePathError('DAO does not support deletes', {
+                    resourceClassName: change.forResource.class,
+                });
+            }
+            await dao.set.delete(change.state.remote, context);
+            return change;
+        case DeclastructChange_1.DeclastructChangeAction.REPLACE:
+            // delete then create
+            if (!dao.set.delete) {
+                throw new helpful_errors_1.UnexpectedCodePathError('DAO does not support deletes', {
+                    resourceClassName: change.forResource.class,
+                });
+            }
+            await dao.set.delete(change.state.remote, context);
+            await dao.set.finsert(change.state.desired, context);
+            return change;
+        default:
+            throw new helpful_errors_1.UnexpectedCodePathError('unknown change action', {
+                action: change.action,
+            });
+    }
+};
+exports.applyChange = applyChange;
+//# sourceMappingURL=applyChange.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"applyChange.js","sourceRoot":"","sources":["../../../src/domain.operations/apply/applyChange.ts"],"names":[],"mappings":";;;AACA,mDAAyD;AAEzD,8EAGgD;AAEhD,+DAA4D;AAE5D;;;;GAIG;AACI,MAAM,WAAW,GAAG,KAAK,EAAkB,EAChD,QAAQ,EACR,MAAM,EACN,SAAS,EACT,OAAO,GAMR,EAA8B,EAAE;IAC/B,gCAAgC;IAChC,IAAI,MAAM,CAAC,MAAM,KAAK,2CAAuB,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IAElE,uEAAuE;IACvE,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,MAAM,CAAC,WAAW,CAAC,KAAK;QACxD,MAAM,IAAI,wCAAuB,CAC/B,+DAA+D,EAC/D,EAAE,QAAQ,EAAE,MAAM,EAAE,CACrB,CAAC;IAEJ,MAAM,GAAG,GAAG,IAAA,mCAAgB,EAAC;QAC3B,QAAQ;QACR,SAAS;KACV,CAAC,CAAC;IAEH,sCAAsC;IACtC,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,2CAAuB,CAAC,MAAM;YACjC,sBAAsB;YACtB,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAQ,EAAE,OAAO,CAAC,CAAC;YACtD,OAAO,MAAM,CAAC;QAEhB,KAAK,2CAAuB,CAAC,MAAM;YACjC,2BAA2B;YAC3B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;gBACpB,MAAM,IAAI,wCAAuB,CAAC,8BAA8B,EAAE;oBAChE,iBAAiB,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK;iBAC5C,CAAC,CAAC;YACL,CAAC;YACD,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,OAAO,MAAM,CAAC;QAEhB,KAAK,2CAAuB,CAAC,OAAO;YAClC,kBAAkB;YAClB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;gBACpB,MAAM,IAAI,wCAAuB,CAAC,8BAA8B,EAAE;oBAChE,iBAAiB,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK;iBAC5C,CAAC,CAAC;YACL,CAAC;YACD,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAa,EAAE,OAAO,CAAC,CAAC;YAC1D,OAAO,MAAM,CAAC;QAEhB,KAAK,2CAAuB,CAAC,OAAO;YAClC,qBAAqB;YACrB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;gBACpB,MAAM,IAAI,wCAAuB,CAAC,8BAA8B,EAAE;oBAChE,iBAAiB,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK;iBAC5C,CAAC,CAAC;YACL,CAAC;YACD,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAa,EAAE,OAAO,CAAC,CAAC;YAC1D,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAQ,EAAE,OAAO,CAAC,CAAC;YACtD,OAAO,MAAM,CAAC;QAEhB;YACE,MAAM,IAAI,wCAAuB,CAAC,uBAAuB,EAAE;gBACzD,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB,CAAC,CAAC;IACP,CAAC;AACH,CAAC,CAAC;AArEW,QAAA,WAAW,eAqEtB"}

package/dist/domain.operations/apply/applyChange.test.d.ts

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

package/dist/domain.operations/apply/applyChange.test.js

@@ -0,0 +1,247 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const domain_objects_1 = require("domain-objects");
+const helpful_errors_1 = require("helpful-errors");
+const DeclastructChange_1 = require("../../domain.objects/DeclastructChange");
+const DeclastructProvider_1 = require("../../domain.objects/DeclastructProvider");
+const applyChange_1 = require("./applyChange");
+describe('applyChange', () => {
+    class DemoResource extends domain_objects_1.DomainEntity {
+    }
+    DemoResource.unique = ['id'];
+    it('should return immediately for KEEP action without calling DAO', async () => {
+        const resource = new DemoResource({ id: 'keep-1', name: 'Keep Me' });
+        const change = new DeclastructChange_1.DeclastructChange({
+            forResource: {
+                class: DemoResource.name,
+                slug: 'keep-1',
+            },
+            action: DeclastructChange_1.DeclastructChangeAction.KEEP,
+            state: {
+                desired: resource,
+                remote: resource,
+                difference: null,
+            },
+        });
+        const result = await (0, applyChange_1.applyChange)({
+            resource,
+            change,
+            providers: [],
+            context: {},
+        });
+        expect(result).toBe(change);
+    });
+    it('should call finsert for CREATE action', async () => {
+        const resource = new DemoResource({ id: 'create-1', name: 'Create Me' });
+        const finsertSpy = jest.fn().mockResolvedValue(resource);
+        const dao = {
+            get: {
+                byUnique: async () => null,
+                byRef: async () => null,
+            },
+            set: {
+                finsert: finsertSpy,
+            },
+        };
+        const provider = new DeclastructProvider_1.DeclastructProvider({
+            name: 'test-provider',
+            daos: { DemoResource: dao },
+            context: {},
+            hooks: {
+                beforeAll: async () => { },
+                afterAll: async () => { },
+            },
+        });
+        const change = new DeclastructChange_1.DeclastructChange({
+            forResource: {
+                class: DemoResource.name,
+                slug: 'create-1',
+            },
+            action: DeclastructChange_1.DeclastructChangeAction.CREATE,
+            state: {
+                desired: resource,
+                remote: null,
+                difference: 'some diff',
+            },
+        });
+        await (0, applyChange_1.applyChange)({
+            resource,
+            change,
+            providers: [provider],
+            context: {},
+        });
+        expect(finsertSpy).toHaveBeenCalledWith(resource, {});
+    });
+    it('should call upsert for UPDATE action', async () => {
+        const remote = new DemoResource({ id: 'update-1', name: 'Old Name' });
+        const desired = new DemoResource({ id: 'update-1', name: 'New Name' });
+        const upsertSpy = jest.fn().mockResolvedValue(desired);
+        const dao = {
+            get: {
+                byUnique: async () => null,
+                byRef: async () => null,
+            },
+            set: {
+                finsert: async (input) => input,
+                upsert: upsertSpy,
+            },
+        };
+        const provider = new DeclastructProvider_1.DeclastructProvider({
+            name: 'test-provider',
+            daos: { DemoResource: dao },
+            context: {},
+            hooks: {
+                beforeAll: async () => { },
+                afterAll: async () => { },
+            },
+        });
+        const change = new DeclastructChange_1.DeclastructChange({
+            forResource: {
+                class: DemoResource.name,
+                slug: 'update-1',
+            },
+            action: DeclastructChange_1.DeclastructChangeAction.UPDATE,
+            state: {
+                desired,
+                remote,
+                difference: 'some diff',
+            },
+        });
+        await (0, applyChange_1.applyChange)({
+            resource: desired,
+            change,
+            providers: [provider],
+            context: {},
+        });
+        expect(upsertSpy).toHaveBeenCalledWith(desired, {});
+    });
+    it('should throw when UPDATE action but DAO does not support upsert', async () => {
+        const remote = new DemoResource({ id: 'update-1', name: 'Old Name' });
+        const desired = new DemoResource({ id: 'update-1', name: 'New Name' });
+        const dao = {
+            get: {
+                byUnique: async () => null,
+                byRef: async () => null,
+            },
+            set: {
+                finsert: async (input) => input,
+            },
+        };
+        const provider = new DeclastructProvider_1.DeclastructProvider({
+            name: 'test-provider',
+            daos: { DemoResource: dao },
+            context: {},
+            hooks: {
+                beforeAll: async () => { },
+                afterAll: async () => { },
+            },
+        });
+        const change = new DeclastructChange_1.DeclastructChange({
+            forResource: {
+                class: DemoResource.name,
+                slug: 'update-1',
+            },
+            action: DeclastructChange_1.DeclastructChangeAction.UPDATE,
+            state: {
+                desired,
+                remote,
+                difference: 'some diff',
+            },
+        });
+        const error = await (0, helpful_errors_1.getError)(() => (0, applyChange_1.applyChange)({
+            resource: desired,
+            change,
+            providers: [provider],
+            context: {},
+        }));
+        expect(error.message).toContain('DAO does not support updates');
+    });
+    it('should call delete for DESTROY action', async () => {
+        const resource = new DemoResource({ id: 'destroy-1', name: 'Delete Me' });
+        const deleteSpy = jest.fn().mockResolvedValue(undefined);
+        const dao = {
+            get: {
+                byUnique: async () => null,
+                byRef: async () => null,
+            },
+            set: {
+                finsert: async (input) => input,
+                delete: deleteSpy,
+            },
+        };
+        const provider = new DeclastructProvider_1.DeclastructProvider({
+            name: 'test-provider',
+            daos: { DemoResource: dao },
+            context: {},
+            hooks: {
+                beforeAll: async () => { },
+                afterAll: async () => { },
+            },
+        });
+        const change = new DeclastructChange_1.DeclastructChange({
+            forResource: {
+                class: DemoResource.name,
+                slug: 'destroy-1',
+            },
+            action: DeclastructChange_1.DeclastructChangeAction.DESTROY,
+            state: {
+                desired: null,
+                remote: resource,
+                difference: 'some diff',
+            },
+        });
+        await (0, applyChange_1.applyChange)({
+            resource,
+            change,
+            providers: [provider],
+            context: {},
+        });
+        expect(deleteSpy).toHaveBeenCalledWith(resource, {});
+    });
+    it('should call delete then finsert for REPLACE action', async () => {
+        const remote = new DemoResource({ id: 'replace-1', name: 'Old' });
+        const desired = new DemoResource({ id: 'replace-2', name: 'New' });
+        const deleteSpy = jest.fn().mockResolvedValue(undefined);
+        const finsertSpy = jest.fn().mockResolvedValue(desired);
+        const dao = {
+            get: {
+                byUnique: async () => null,
+                byRef: async () => null,
+            },
+            set: {
+                finsert: finsertSpy,
+                delete: deleteSpy,
+            },
+        };
+        const provider = new DeclastructProvider_1.DeclastructProvider({
+            name: 'test-provider',
+            daos: { DemoResource: dao },
+            context: {},
+            hooks: {
+                beforeAll: async () => { },
+                afterAll: async () => { },
+            },
+        });
+        const change = new DeclastructChange_1.DeclastructChange({
+            forResource: {
+                class: DemoResource.name,
+                slug: 'replace-1',
+            },
+            action: DeclastructChange_1.DeclastructChangeAction.REPLACE,
+            state: {
+                desired,
+                remote,
+                difference: 'some diff',
+            },
+        });
+        await (0, applyChange_1.applyChange)({
+            resource: desired,
+            change,
+            providers: [provider],
+            context: {},
+        });
+        expect(deleteSpy).toHaveBeenCalledWith(remote, {});
+        expect(finsertSpy).toHaveBeenCalledWith(desired, {});
+    });
+});
+//# sourceMappingURL=applyChange.test.js.map

package/dist/domain.operations/apply/applyChange.test.js.map

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

package/dist/domain.operations/apply/applyChanges.d.ts

@@ -0,0 +1,18 @@
+import { DomainEntity } from 'domain-objects';
+import { ContextLogTrail } from 'simple-log-methods';
+import { ContextDeclastruct } from '../../domain.objects/ContextDeclastruct';
+import { DeclastructChange } from '../../domain.objects/DeclastructChange';
+import { DeclastructPlan } from '../../domain.objects/DeclastructPlan';
+import { DeclastructProvider } from '../../domain.objects/DeclastructProvider';
+/**
+ * .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)
+ */
+export declare const applyChanges: (input: {
+    plan: DeclastructPlan;
+    resources: DomainEntity<any>[];
+    providers: DeclastructProvider<any, any>[];
+}, context: ContextLogTrail & ContextDeclastruct) => Promise<{
+    appliedChanges: DeclastructChange[];
+}>;

package/dist/domain.operations/apply/applyChanges.integration.test.d.ts

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