declastruct 1.0.0 → 1.1.0

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

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const domain_objects_1 = require("domain-objects");
+const helpful_errors_1 = require("helpful-errors");
+const DeclastructProvider_1 = require("../../domain.objects/DeclastructProvider");
+const getDaoByResource_1 = require("./getDaoByResource");
+describe('getDaoByResource', () => {
+    class DemoResource extends domain_objects_1.DomainEntity {
+    }
+    DemoResource.unique = ['id'];
+    it('should return DAO when exactly one provider matches', () => {
+        const demoDao = {
+            get: {
+                byUnique: async () => null,
+                byRef: async () => null,
+            },
+            set: {
+                finsert: async (input) => input,
+            },
+        };
+        const provider = new DeclastructProvider_1.DeclastructProvider({
+            name: 'test-provider',
+            daos: { DemoResource: demoDao },
+            context: {},
+            hooks: {
+                beforeAll: async () => { },
+                afterAll: async () => { },
+            },
+        });
+        const resource = new DemoResource({ id: 'test-1', name: 'Test' });
+        const result = (0, getDaoByResource_1.getDaoByResource)({
+            resource,
+            providers: [provider],
+        });
+        expect(result).toBe(demoDao);
+    });
+    it('should throw UnexpectedCodePathError when multiple providers support same resource', () => {
+        const dao1 = {
+            get: {
+                byUnique: async () => null,
+                byRef: async () => null,
+            },
+            set: {
+                finsert: async (input) => input,
+            },
+        };
+        const dao2 = {
+            get: {
+                byUnique: async () => null,
+                byRef: async () => null,
+            },
+            set: {
+                finsert: async (input) => input,
+            },
+        };
+        const provider1 = new DeclastructProvider_1.DeclastructProvider({
+            name: 'provider-1',
+            daos: { DemoResource: dao1 },
+            context: {},
+            hooks: {
+                beforeAll: async () => { },
+                afterAll: async () => { },
+            },
+        });
+        const provider2 = new DeclastructProvider_1.DeclastructProvider({
+            name: 'provider-2',
+            daos: { DemoResource: dao2 },
+            context: {},
+            hooks: {
+                beforeAll: async () => { },
+                afterAll: async () => { },
+            },
+        });
+        const resource = new DemoResource({ id: 'test-1', name: 'Test' });
+        const error = (0, helpful_errors_1.getError)(() => (0, getDaoByResource_1.getDaoByResource)({
+            resource,
+            providers: [provider1, provider2],
+        }));
+        expect(error.message).toContain('multiple providers support same resource');
+    });
+    it('should throw UnexpectedCodePathError when no provider supports resource', () => {
+        const provider = new DeclastructProvider_1.DeclastructProvider({
+            name: 'empty-provider',
+            daos: {},
+            context: {},
+            hooks: {
+                beforeAll: async () => { },
+                afterAll: async () => { },
+            },
+        });
+        const resource = new DemoResource({ id: 'test-1', name: 'Test' });
+        const error = (0, helpful_errors_1.getError)(() => (0, getDaoByResource_1.getDaoByResource)({
+            resource,
+            providers: [provider],
+        }));
+        expect(error.message).toContain('no DAO found for resource');
+    });
+});
+//# sourceMappingURL=getDaoByResource.test.js.map

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

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

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

@@ -0,0 +1,7 @@
+import { DeclastructChange } from '../../domain.objects/DeclastructChange';
+/**
+ * .what = computes deterministic hash of changes
+ * .why = enables plan comparison and staleness detection
+ * .note = uses SHA-256 for consistency
+ */
+export declare const hashChanges: (changes: DeclastructChange[]) => string;

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

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashChanges = void 0;
+const crypto_1 = require("crypto");
+/**
+ * .what = computes deterministic hash of changes
+ * .why = enables plan comparison and staleness detection
+ * .note = uses SHA-256 for consistency
+ */
+const hashChanges = (changes) => {
+    // serialize changes to deterministic JSON
+    const serialized = JSON.stringify(changes, null, 0);
+    // compute SHA-256 hash
+    const hash = (0, crypto_1.createHash)('sha256').update(serialized).digest('hex');
+    return hash;
+};
+exports.hashChanges = hashChanges;
+//# sourceMappingURL=hashChanges.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hashChanges.js","sourceRoot":"","sources":["../../../src/domain.operations/plan/hashChanges.ts"],"names":[],"mappings":";;;AAAA,mCAAoC;AAIpC;;;;GAIG;AACI,MAAM,WAAW,GAAG,CAAC,OAA4B,EAAU,EAAE;IAClE,0CAA0C;IAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEpD,uBAAuB;IACvB,MAAM,IAAI,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEnE,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AARW,QAAA,WAAW,eAQtB"}

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

@@ -0,0 +1,15 @@
+import { DomainEntity } from 'domain-objects';
+import { ContextLogTrail } from 'simple-log-methods';
+import { ContextDeclastruct } from '../../domain.objects/ContextDeclastruct';
+import { DeclastructPlan } from '../../domain.objects/DeclastructPlan';
+import { DeclastructProvider } from '../../domain.objects/DeclastructProvider';
+/**
+ * .what = generates a plan of changes required to achieve desired state
+ * .why = enables users to review infrastructure changes before applying them
+ * .note = idempotent - calling multiple times produces the same plan
+ */
+export declare const planChanges: (input: {
+    resources: DomainEntity<any>[];
+    providers: DeclastructProvider<any, any>[];
+    wishFilePath: string;
+}, context: ContextLogTrail & ContextDeclastruct) => Promise<DeclastructPlan>;

package/dist/domain.operations/plan/planChanges.integration.test.d.ts

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

package/dist/domain.operations/plan/planChanges.integration.test.js

@@ -0,0 +1,197 @@
+"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 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("./planChanges");
+describe('planChanges', () => {
+    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: 10 }),
+        log: {
+            info: jest.fn(),
+            error: jest.fn(),
+            warn: jest.fn(),
+            debug: jest.fn(),
+        },
+    });
+    it('should plan CREATE actions for resources that do not exist remotely', async () => {
+        // define desired 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());
+        // verify plan structure
+        expect(plan.hash).toBeDefined();
+        expect(plan.createdAt).toBeDefined();
+        expect(plan.wish.uri).toBe(wishFilePath);
+        expect(plan.changes.length).toBe(2);
+        // verify all changes are CREATE
+        plan.changes.forEach((change) => {
+            expect(change.action).toBe(DeclastructChange_1.DeclastructChangeAction.CREATE);
+            expect(change.forResource.class).toBe('DemoResource');
+            expect(change.state.desired).toBeDefined();
+            expect(change.state.remote).toBeNull();
+        });
+        // verify specific resources (slug includes full format with hash)
+        const slugs = plan.changes.map((c) => c.forResource.slug);
+        expect(slugs[0]).toContain(resources[0].exid);
+        expect(slugs[1]).toContain(resources[1].exid);
+    });
+    it('should plan KEEP actions for resources that exist unchanged remotely', async () => {
+        // define resources
+        const resources = [
+            (0, demo_provider_1.genSampleDemoResource)({ name: 'First Test' }),
+            (0, demo_provider_1.genSampleDemoResource)({ name: 'Second Test' }),
+        ];
+        // create remote state
+        const dao = demo_provider_1.demoProvider.daos.DemoResource;
+        await dao.set.finsert(resources[0], {});
+        await dao.set.finsert(resources[1], {});
+        // plan changes
+        const plan = await (0, planChanges_1.planChanges)({
+            resources,
+            providers: [demo_provider_1.demoProvider],
+            wishFilePath,
+        }, createContext());
+        // verify all changes are KEEP
+        expect(plan.changes.length).toBe(2);
+        plan.changes.forEach((change) => {
+            expect(change.action).toBe(DeclastructChange_1.DeclastructChangeAction.KEEP);
+            expect(change.forResource.class).toBe('DemoResource');
+            expect(change.state.desired).toBeDefined();
+            expect(change.state.remote).toBeDefined();
+        });
+    });
+    it('should plan UPDATE actions for resources that changed remotely', async () => {
+        // create remote state
+        const remoteResource = (0, demo_provider_1.genSampleDemoResource)({ name: 'Old Name' });
+        const dao = demo_provider_1.demoProvider.daos.DemoResource;
+        await dao.set.finsert(remoteResource, {});
+        // define desired resource with new name (same exid)
+        const resources = [remoteResource.clone({ name: 'New Name' })];
+        // plan changes
+        const plan = await (0, planChanges_1.planChanges)({
+            resources,
+            providers: [demo_provider_1.demoProvider],
+            wishFilePath,
+        }, createContext());
+        // verify UPDATE action
+        expect(plan.changes.length).toBe(1);
+        const change = plan.changes[0];
+        expect(change.action).toBe(DeclastructChange_1.DeclastructChangeAction.UPDATE);
+        expect(change.forResource.class).toBe('DemoResource');
+        expect(change.forResource.slug).toContain(remoteResource.exid);
+        expect(change.state.desired.name).toBe('New Name');
+        expect(change.state.remote?.name).toBe('Old Name');
+        expect(change.toString()).toBeDefined();
+    });
+    it('should plan DELETE actions for resources that exist remotely but not in desired state', async () => {
+        // create remote state
+        const resource1 = (0, demo_provider_1.genSampleDemoResource)({ name: 'To Delete' });
+        const resource2 = (0, demo_provider_1.genSampleDemoResource)({ name: 'To Keep' });
+        const dao = demo_provider_1.demoProvider.daos.DemoResource;
+        await dao.set.finsert(resource1, {});
+        await dao.set.finsert(resource2, {});
+        // define desired resources (only resource2)
+        const resources = [resource2];
+        // Note: planChanges only looks at desired resources, not remote state
+        // DELETE actions would need to be detected by comparing remote state to desired
+        // This is a design limitation - planChanges only processes desired resources
+        const plan = await (0, planChanges_1.planChanges)({
+            resources,
+            providers: [demo_provider_1.demoProvider],
+            wishFilePath,
+        }, createContext());
+        // verify only resource2 is in plan
+        expect(plan.changes.length).toBe(1);
+        expect(plan.changes[0].forResource.slug).toContain(resource2.exid);
+        expect(plan.changes[0].action).toBe(DeclastructChange_1.DeclastructChangeAction.KEEP);
+    });
+    it('should emit real-time logs as resources are planned', async () => {
+        // define resources
+        const resources = [
+            (0, demo_provider_1.genSampleDemoResource)({ name: 'First Test' }),
+            (0, demo_provider_1.genSampleDemoResource)({ name: 'Second Test' }),
+        ];
+        // plan with spy on log
+        const context = createContext();
+        await (0, planChanges_1.planChanges)({
+            resources,
+            providers: [demo_provider_1.demoProvider],
+            wishFilePath,
+        }, 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 actions in single plan', async () => {
+        // create remote resources
+        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
+            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
+        expect(plan.changes.length).toBe(3);
+        // verify we have one of each action
+        const actions = plan.changes.map((c) => c.action);
+        expect(actions).toContain(DeclastructChange_1.DeclastructChangeAction.KEEP);
+        expect(actions).toContain(DeclastructChange_1.DeclastructChangeAction.UPDATE);
+        expect(actions).toContain(DeclastructChange_1.DeclastructChangeAction.CREATE);
+        // verify exids are in slugs
+        const slugString = plan.changes.map((c) => c.forResource.slug).join(',');
+        expect(slugString).toContain(resource1.exid);
+        expect(slugString).toContain(resource2.exid);
+        expect(slugString).toContain(resources[2].exid);
+    });
+    it('should produce deterministic plans for same input', async () => {
+        // define resources
+        const resources = [
+            (0, demo_provider_1.genSampleDemoResource)({ name: 'First Test' }),
+            (0, demo_provider_1.genSampleDemoResource)({ name: 'Second Test' }),
+        ];
+        // plan twice
+        const plan1 = await (0, planChanges_1.planChanges)({
+            resources,
+            providers: [demo_provider_1.demoProvider],
+            wishFilePath,
+        }, createContext());
+        const plan2 = await (0, planChanges_1.planChanges)({
+            resources,
+            providers: [demo_provider_1.demoProvider],
+            wishFilePath,
+        }, createContext());
+        // verify plans have same hash (deterministic)
+        expect(plan1.hash).toBe(plan2.hash);
+        expect(plan1.changes.length).toBe(plan2.changes.length);
+    });
+});
+//# sourceMappingURL=planChanges.integration.test.js.map

package/dist/domain.operations/plan/planChanges.integration.test.js.map

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

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

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planChanges = void 0;
+const DeclastructChange_1 = require("../../domain.objects/DeclastructChange");
+const DeclastructPlan_1 = require("../../domain.objects/DeclastructPlan");
+const asIsoTimestamp_1 = require("../../infra/asIsoTimestamp");
+const computeChange_1 = require("./computeChange");
+const getDaoByResource_1 = require("./getDaoByResource");
+const hashChanges_1 = require("./hashChanges");
+/**
+ * .what = generates a plan of changes required to achieve desired state
+ * .why = enables users to review infrastructure changes before applying them
+ * .note = idempotent - calling multiple times produces the same plan
+ */
+const planChanges = async (input, context) => {
+    // extract bottleneck for planning
+    const bottleneck = 'onPlan' in context.bottleneck
+        ? context.bottleneck.onPlan
+        : context.bottleneck;
+    // compute change for each resource with real-time logging
+    const changes = await Promise.all(input.resources.map((resource) => bottleneck.schedule(async () => {
+        // find DAO for this resource
+        const dao = (0, getDaoByResource_1.getDaoByResource)({
+            resource,
+            providers: input.providers,
+        });
+        // fetch current remote state
+        const remoteState = await dao.get.byUnique(resource, context);
+        // compute change
+        const change = (0, computeChange_1.computeChange)({
+            desired: resource,
+            remote: remoteState,
+        });
+        // log change as it's computed
+        const symbol = change.action === DeclastructChange_1.DeclastructChangeAction.KEEP ? '↓' : '○';
+        context.log.info(`${symbol} [${change.action}] ${change.forResource.slug}`, {});
+        return change;
+    })));
+    // return plan
+    return new DeclastructPlan_1.DeclastructPlan({
+        hash: (0, hashChanges_1.hashChanges)(changes),
+        createdAt: (0, asIsoTimestamp_1.asIsoTimestamp)(new Date()),
+        wish: {
+            uri: input.wishFilePath,
+        },
+        changes,
+    });
+};
+exports.planChanges = planChanges;
+//# sourceMappingURL=planChanges.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planChanges.js","sourceRoot":"","sources":["../../../src/domain.operations/plan/planChanges.ts"],"names":[],"mappings":";;;AAIA,8EAAiF;AACjF,0EAAuE;AAEvE,+DAA4D;AAC5D,mDAAgD;AAChD,yDAAsD;AACtD,+CAA4C;AAE5C;;;;GAIG;AACI,MAAM,WAAW,GAAG,KAAK,EAC9B,KAIC,EACD,OAA6C,EACnB,EAAE;IAC5B,kCAAkC;IAClC,MAAM,UAAU,GACd,QAAQ,IAAI,OAAO,CAAC,UAAU;QAC5B,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM;QAC3B,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAEzB,0DAA0D;IAC1D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC/B,UAAU,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;QAC7B,6BAA6B;QAC7B,MAAM,GAAG,GAAG,IAAA,mCAAgB,EAAC;YAC3B,QAAQ;YACR,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;QAEH,6BAA6B;QAC7B,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAE9D,iBAAiB;QACjB,MAAM,MAAM,GAAG,IAAA,6BAAa,EAAC;YAC3B,OAAO,EAAE,QAAQ;YACjB,MAAM,EAAE,WAAW;SACpB,CAAC,CAAC;QAEH,8BAA8B;QAC9B,MAAM,MAAM,GACV,MAAM,CAAC,MAAM,KAAK,2CAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,IAAI,CACd,GAAG,MAAM,KAAK,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,EACzD,EAAE,CACH,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CACH,CACF,CAAC;IAEF,cAAc;IACd,OAAO,IAAI,iCAAe,CAAC;QACzB,IAAI,EAAE,IAAA,yBAAW,EAAC,OAAO,CAAC;QAC1B,SAAS,EAAE,IAAA,+BAAc,EAAC,IAAI,IAAI,EAAE,CAAC;QACrC,IAAI,EAAE;YACJ,GAAG,EAAE,KAAK,CAAC,YAAY;SACxB;QACD,OAAO;KACR,CAAC,CAAC;AACL,CAAC,CAAC;AAvDW,QAAA,WAAW,eAuDtB"}

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

@@ -0,0 +1,10 @@
+import { DeclastructPlan } from '../../domain.objects/DeclastructPlan';
+/**
+ * .what = validates that a plan hasn't become stale
+ * .why = prevents applying outdated changes to infrastructure
+ * .note = compares plan hashes to detect drift
+ */
+export declare const assertPlanStillValid: ({ originalPlan, currentPlan, }: {
+    originalPlan: DeclastructPlan;
+    currentPlan: DeclastructPlan;
+}) => void;

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

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertPlanStillValid = void 0;
+const helpful_errors_1 = require("helpful-errors");
+/**
+ * .what = validates that a plan hasn't become stale
+ * .why = prevents applying outdated changes to infrastructure
+ * .note = compares plan hashes to detect drift
+ */
+const assertPlanStillValid = ({ originalPlan, currentPlan, }) => {
+    // reject if plan hashes differ
+    if (originalPlan.hash !== currentPlan.hash) {
+        throw new helpful_errors_1.BadRequestError('plan is stale', {
+            originalHash: originalPlan.hash,
+            currentHash: currentPlan.hash,
+            message: 'The infrastructure state has changed since this plan was created. Please review and create a new plan.',
+        });
+    }
+};
+exports.assertPlanStillValid = assertPlanStillValid;
+//# sourceMappingURL=validate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/domain.operations/plan/validate.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAIjD;;;;GAIG;AACI,MAAM,oBAAoB,GAAG,CAAC,EACnC,YAAY,EACZ,WAAW,GAIZ,EAAQ,EAAE;IACT,+BAA+B;IAC/B,IAAI,YAAY,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI,EAAE,CAAC;QAC3C,MAAM,IAAI,gCAAe,CAAC,eAAe,EAAE;YACzC,YAAY,EAAE,YAAY,CAAC,IAAI;YAC/B,WAAW,EAAE,WAAW,CAAC,IAAI;YAC7B,OAAO,EACL,wGAAwG;SAC3G,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC;AAhBW,QAAA,oBAAoB,wBAgB/B"}

package/dist/infra/asIsoTimestamp.d.ts

@@ -0,0 +1,6 @@
+import { IsoTimestamp } from '../domain.objects/IsoTimestamp';
+/**
+ * .what = converts a Date to ISO 8601 timestamp string
+ * .why = ensures consistent timestamp format across the system
+ */
+export declare const asIsoTimestamp: (date: Date) => IsoTimestamp;

package/dist/infra/asIsoTimestamp.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asIsoTimestamp = void 0;
+/**
+ * .what = converts a Date to ISO 8601 timestamp string
+ * .why = ensures consistent timestamp format across the system
+ */
+const asIsoTimestamp = (date) => {
+    return date.toISOString();
+};
+exports.asIsoTimestamp = asIsoTimestamp;
+//# sourceMappingURL=asIsoTimestamp.js.map

package/dist/infra/asIsoTimestamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asIsoTimestamp.js","sourceRoot":"","sources":["../../src/infra/asIsoTimestamp.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACI,MAAM,cAAc,GAAG,CAAC,IAAU,EAAgB,EAAE;IACzD,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;AAC5B,CAAC,CAAC;AAFW,QAAA,cAAc,kBAEzB"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "declastruct",
   "author": "ehmpathy",
   "description": "Add declarative control to any resource constructs. Declare, plan, and apply within an observable pit-of-success.",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "repository": "ehmpathy/declastruct",
   "homepage": "https://github.com/ehmpathy/declastruct",
   "keywords": [
@@ -49,22 +49,14 @@
     "prepare:husky": "npx husky install && chmod ug+x .husky/*"
   },
   "dependencies": {
-    "@ehmpathy/error-fns": "1.3.7",
-    "@ehmpathy/number-fns": "1.0.1",
     "bottleneck": "2.19.5",
-    "chalk": "5.4.1",
-    "deep-object-diff": "1.1.9",
-    "domain-objects": "0.24.3",
-    "flattie": "1.1.1",
-    "indent-string": "5.0.0",
+    "commander": "14.0.2",
+    "domain-objects": "0.25.7",
+    "helpful-errors": "1.4.0",
     "jest-diff": "30.0.2",
-    "joi": "17.13.3",
-    "ora": "5.4.1",
-    "simple-in-memory-cache": "0.4.0",
+    "simple-log-methods": "0.6.1",
     "type-fns": "1.19.0",
-    "uuid-fns": "1.0.0",
-    "visualogic": "1.3.2",
-    "with-simple-caching": "0.14.1"
+    "uuid-fns": "1.0.2"
   },
   "devDependencies": {
     "@commitlint/cli": "19.3.0",
@@ -87,7 +79,8 @@
     "husky": "8.0.3",
     "jest": "29.3.1",
     "prettier": "2.8.1",
-    "simple-leveled-log-methods": "0.4.1",
+    "rhachet": "1.12.1",
+    "rhachet-roles-ehmpathy": "1.9.1",
     "ts-jest": "29.1.3",
     "ts-node": "10.9.2",
     "typescript": "5.4.5"

package/readme.md

@@ -7,50 +7,70 @@ Add declarative control to any resource constructs. Declare, plan, and apply wit
 
 Declare the structures you want. Plan to see the changes required. Apply to make it so 🪄
 
-# benefits
+# install
 
-- no dedicated state required
-  - looks at the source of truth directly
-  - leverages unique keys of resources to understand remote state automatically and eliminate the middleman
+```sh
+npm install declastruct --save-dev
+```
 
-- no new language syntax required
-  - no awkward new-language limitations
-  - reuse your existing domain language to manage your resources
+# use
+
+### 1. declare ✨
 
-# features
+declare the resources you wish to have and how you wish to have them
 
-- flexible resource references
-  - eliminate primary-key constraint; enable declaration of resources via unique-key references
-  - eliminate single-key constraint; enable usage of whichever key is accessible
+```ts
+import { getDeclastructAwsProvider, DeclaredAwsS3Bucket } from 'declastruct-aws';
 
-- declarative resource structures
-  - manage resource states declaratively
+// declare the providers that support your resources
+export const getProviders = async () => [
+    await getDeclastructAwsProvider({
+      profile: process.env.AWS_PROFILE,
+    })
+  ]
 
-- declarative persistence structures
-  - standard shape for any operation for interaction with resources
-  - plug and play handlers of resources (interface w/ many remote state stores for the same resource via prebuilt providers)
+// declare the resources in the states you want them
+export const getResources = async () => {
+  const bucket = DeclaredAwsS3Bucket.as({
+    name: 'your-s3-bucket',
+  });
+  // declare other resources you wish to have
 
-- declarative instructions
-  - declare desired state
-  - plan changes required to get to desired state
-  - apply changes to get to desired state
+  return [
+    bucket,
+    // ... all the resources you wish for will go here
+  ],
+}
+```
 
+### 2. plan 🔮
 
-# install
+plan how to achieve the wish of resources you've declared
 
 ```sh
-npm install -s declastruct
+npx declastruct plan --wish provision/resources.ts --into provision/.temp/plan.json
 ```
 
-# use
+### 3. apply 🪄
 
-### `declare`
+apply the plan to fulfill the wish
 
-### `plan`
+```sh
+npx declastruct apply --plan provision/.temp/plan.json
+```
 
-### `apply`
+# benefits
 
+- no dedicated state required
+  - looks at the source of truth directly
+  - leverages unique keys of resources to understand remote state automatically and eliminate the middleman
 
-# todo
+- no new language syntax required
+  - no awkward new-language limitations
+  - reuse your existing domain language to manage your resources
 
-swap to domain-objects.Refs
+- pit of success adapters
+  - each repo that implements a declastruct adapter to control their remote state follows a pit of success
+  - idempotency is required on operations, to guarantee they operate safely
+  - clear declaration of unique and primary keys is required, to guarantee readability, composability, and true comparisons against reality
+  - not only can you use them via declastruct, you can leverage them directly as well