declastruct 1.2.0 → 1.3.1

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

@@ -1,4 +1,4 @@
-import Bottleneck from 'bottleneck';
+import type Bottleneck from 'bottleneck';
 /**
  * .what = standard context for all declastruct operations
  * .why = provides concurrency control and log trail

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

@@ -1,4 +1,4 @@
-import { DomainEntity, DomainLiteral } from 'domain-objects';
+import { type DomainEntity, DomainLiteral } from 'domain-objects';
 /**
  * .what = actions that can be proposed for a resource
  * .why = clearly defines the type of change declastruct will execute

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

@@ -1 +1 @@
-{"version":3,"file":"DeclastructChange.js","sourceRoot":"","sources":["../../src/domain.objects/DeclastructChange.ts"],"names":[],"mappings":";;;AAAA,mDAA6D;AAE7D;;;GAGG;AACH,IAAY,uBAyBX;AAzBD,WAAY,uBAAuB;IACjC;;OAEG;IACH,wCAAa,CAAA;IAEb;;OAEG;IACH,4CAAiB,CAAA;IAEjB;;OAEG;IACH,4CAAiB,CAAA;IAEjB;;OAEG;IACH,8CAAmB,CAAA;IAEnB;;OAEG;IACH,8CAAmB,CAAA;AACrB,CAAC,EAzBW,uBAAuB,uCAAvB,uBAAuB,QAyBlC;AAsDD,MAAa,iBAGX,SAAQ,8BAA2C;CACT;AAJ5C,8CAI4C"}
+{"version":3,"file":"DeclastructChange.js","sourceRoot":"","sources":["../../src/domain.objects/DeclastructChange.ts"],"names":[],"mappings":";;;AAAA,mDAAkE;AAElE;;;GAGG;AACH,IAAY,uBAyBX;AAzBD,WAAY,uBAAuB;IACjC;;OAEG;IACH,wCAAa,CAAA;IAEb;;OAEG;IACH,4CAAiB,CAAA;IAEjB;;OAEG;IACH,4CAAiB,CAAA;IAEjB;;OAEG;IACH,8CAAmB,CAAA;IAEnB;;OAEG;IACH,8CAAmB,CAAA;AACrB,CAAC,EAzBW,uBAAuB,uCAAvB,uBAAuB,QAyBlC;AAsDD,MAAa,iBAGX,SAAQ,8BAA2C;CACT;AAJ5C,8CAI4C"}

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

@@ -1,5 +1,5 @@
-import { DomainEntity, DomainLiteral, Ref, Refable, RefByPrimary, RefByUnique } from 'domain-objects';
-import { HasMetadata } from 'type-fns';
+import { type DomainEntity, DomainLiteral, type Ref, type Refable, type RefByPrimary, type RefByUnique } from 'domain-objects';
+import { type HasMetadata } from 'type-fns';
 /**
  * .what = standardized data access interface for any resource type
  *

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

@@ -1,6 +1,6 @@
 import { DomainEntity } from 'domain-objects';
-import { DeclastructChange } from './DeclastructChange';
-import { IsoTimestamp } from './IsoTimestamp';
+import { type DeclastructChange } from './DeclastructChange';
+import { type IsoTimestamp } from './IsoTimestamp';
 /**
  * .what = collection of all planned changes required to fulfill a wish
  * .why = enables review, version control, and validation of infrastructure changes

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

@@ -1,5 +1,5 @@
 import { DomainLiteral } from 'domain-objects';
-import { DeclastructDao } from './DeclastructDao';
+import { type 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

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

@@ -52,14 +52,19 @@ const applyChanges = async (input, context) => {
         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?', { change });
-        // apply the change
+        // log action start
+        context.log.info(`○ [${change.action}] ${change.forResource.slug}`, {});
+        // apply the change with timing
+        const startMs = Date.now();
         const applied = await (0, applyChange_1.applyChange)({
             change,
             resource: resourceFound,
             providers: input.providers,
         });
-        // log success immediately
-        context.log.info(`✔ [${applied.action}] ${applied.forResource.slug}`, {});
+        const durationMs = Date.now() - startMs;
+        // log completion with duration
+        const durationSec = (durationMs / 1000).toFixed(2);
+        context.log.info(`   └─ ✔ done in ${durationSec}s`, {});
         appliedChanges.push(applied);
     }
     return { appliedChanges };

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

@@ -1 +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;;;;;;GAMG;AACI,MAAM,YAAY,GAAG,KAAK,EAC/B,KAIC,EACD,OAA6C,EACK,EAAE;IACpD,8BAA8B;IAC9B,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,EAAE,IAAI,CAAC,GAAG,IAAI,WAAW;KAClD,EACD,OAAO,CACR,CAAC;IAEF,iFAAiF;IACjF,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,IAAA,+BAAoB,EAAC;YACnB,YAAY,EAAE,KAAK,CAAC,IAAI;YACxB,WAAW;SACZ,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IACpD,CAAC;IAED,oDAAoD;IACpD,MAAM,WAAW,GAAG,WAAW,CAAC;IAEhC,yBAAyB;IACzB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAErB,2CAA2C;IAC3C,MAAM,cAAc,GAAwB,EAAE,CAAC;IAE/C,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACzC,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,4DAA4D,EAC5D,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;SAC3B,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;AA3EW,QAAA,YAAY,gBA2EvB"}
+{"version":3,"file":"applyChanges.js","sourceRoot":"","sources":["../../../src/domain.operations/apply/applyChanges.ts"],"names":[],"mappings":"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"}

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

@@ -3,8 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.computeChange = void 0;
 const domain_objects_1 = require("domain-objects");
 const helpful_errors_1 = require("helpful-errors");
-const jest_diff_1 = require("jest-diff");
 const DeclastructChange_1 = require("../../domain.objects/DeclastructChange");
+const getDisplayableDiff_1 = require("./getDisplayableDiff");
 /**
  * .what = checks if two resources are equivalent
  * .why = determines whether a resource needs to be updated
@@ -16,32 +16,6 @@ const checkAreResourcesEquivalent = (input) => {
     const desiredSerialized = (0, domain_objects_1.serialize)((0, domain_objects_1.omitReadonly)(input.desired));
     return remoteSerialized === desiredSerialized;
 };
-/**
- * .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; ignores readonly
- */
-const computeDiff = ({ from, into, }) => {
-    // no diff if both are null
-    if (from === null && into === null)
-        return null;
-    // check if resources are equivalent after omitting readonly
-    if (from !== null && into !== null) {
-        const fromSerialized = (0, domain_objects_1.serialize)((0, domain_objects_1.omitReadonly)(from));
-        const intoSerialized = (0, domain_objects_1.serialize)((0, domain_objects_1.omitReadonly)(into));
-        if (fromSerialized === intoSerialized)
-            return null;
-    }
-    // omit readonly before diff
-    const fromWithoutReadonly = from === null ? {} : (0, domain_objects_1.omitReadonly)(from);
-    const intoWithoutReadonly = into === null ? {} : (0, domain_objects_1.omitReadonly)(into);
-    // compute diff using jest-diff
-    const difference = (0, jest_diff_1.diff)(fromWithoutReadonly, intoWithoutReadonly, {
-        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
@@ -75,7 +49,7 @@ const computeChange = ({ desired, remote, }) => {
     // compute displayable difference
     const difference = action === DeclastructChange_1.DeclastructChangeAction.KEEP
         ? null
-        : computeDiff({ from: remote, into: desired });
+        : (0, getDisplayableDiff_1.getDisplayableDiff)({ from: remote, into: desired });
     // get resource info for change record
     const resourceForChange = desired || remote;
     // return change

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

@@ -1 +1 @@
-{"version":3,"file":"computeChange.js","sourceRoot":"","sources":["../../../src/domain.operations/plan/computeChange.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"computeChange.js","sourceRoot":"","sources":["../../../src/domain.operations/plan/computeChange.ts"],"names":[],"mappings":";;;AAAA,mDAKwB;AACxB,mDAAyD;AAEzD,8EAGgD;AAChD,6DAA0D;AAE1D;;;;GAIG;AACH,MAAM,2BAA2B,GAAG,CAAC,KAGpC,EAAW,EAAE;IACZ,0EAA0E;IAC1E,MAAM,gBAAgB,GAAG,IAAA,0BAAS,EAAC,IAAA,6BAAY,EAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,MAAM,iBAAiB,GAAG,IAAA,0BAAS,EAAC,IAAA,6BAAY,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjE,OAAO,gBAAgB,KAAK,iBAAiB,CAAC;AAChD,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,MAAM,sBAAsB,GAAG,wCAAuB,CAAC,IAAI,CACzD,GAAG,EAAE,CAAC,2BAA2B,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EACtD;YACE,OAAO,EAAE,uCAAuC;YAChD,QAAQ,EAAE;gBACR,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;gBAC1B,KAAK,EAAE;oBACL,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI;oBAClC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI;iBACjC;aACF;SACF,CACF,EAAE,CAAC;QACJ,IAAI,sBAAsB;YAAE,OAAO,2CAAuB,CAAC,IAAI,CAAC;QAEhE,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,IAAA,uCAAkB,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAE1D,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,wCAAuB,CAAC,IAAI,CAChC,GAAG,EAAE,CAAC,IAAA,wCAAuB,EAAC,iBAAiB,CAAC,EAChD;gBACE,OAAO,EAAE,mCAAmC;gBAC5C,QAAQ,EAAE;oBACR,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;oBAC1B,KAAK,EAAE;wBACL,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI;wBAClC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI;qBACjC;iBACF;aACF,CACF,EAAE;SACJ;QACD,MAAM;QACN,KAAK,EAAE;YACL,OAAO;YACP,MAAM;YACN,UAAU;SACX;KACF,CAAC,CAAC;AACL,CAAC,CAAC;AArEW,QAAA,aAAa,iBAqExB"}

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

@@ -0,0 +1,10 @@
+import { DomainEntity } from 'domain-objects';
+/**
+ * .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; ignores readonly; preserves key order from into
+ */
+export declare const getDisplayableDiff: ({ from, into, }: {
+    from: DomainEntity<any> | null;
+    into: DomainEntity<any> | null;
+}) => string | null;

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

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDisplayableDiff = void 0;
+const domain_objects_1 = require("domain-objects");
+const jest_diff_1 = require("jest-diff");
+/**
+ * .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; ignores readonly; preserves key order from into
+ */
+const getDisplayableDiff = ({ from, into, }) => {
+    // no diff if both are null
+    if (from === null && into === null)
+        return null;
+    // check if resources are equivalent after omitting readonly
+    if (from !== null && into !== null) {
+        const fromSerialized = (0, domain_objects_1.serialize)((0, domain_objects_1.omitReadonly)(from));
+        const intoSerialized = (0, domain_objects_1.serialize)((0, domain_objects_1.omitReadonly)(into));
+        if (fromSerialized === intoSerialized)
+            return null;
+    }
+    // omit readonly before diff
+    const fromWithoutReadonly = from === null ? {} : (0, domain_objects_1.omitReadonly)(from);
+    const intoWithoutReadonly = into === null ? {} : (0, domain_objects_1.omitReadonly)(into);
+    // build key order from into (desired) for stable diff output
+    const keyOrder = Object.keys(intoWithoutReadonly);
+    // compute diff using jest-diff, sorting keys by into's order
+    const difference = (0, jest_diff_1.diff)(fromWithoutReadonly, intoWithoutReadonly, {
+        aAnnotation: 'Remote',
+        bAnnotation: 'Desired',
+        compareKeys: (a, b) => {
+            const aIdx = keyOrder.indexOf(a);
+            const bIdx = keyOrder.indexOf(b);
+            return (aIdx === -1 ? Infinity : aIdx) - (bIdx === -1 ? Infinity : bIdx);
+        },
+    });
+    return difference;
+};
+exports.getDisplayableDiff = getDisplayableDiff;
+//# sourceMappingURL=getDisplayableDiff.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getDisplayableDiff.js","sourceRoot":"","sources":["../../../src/domain.operations/plan/getDisplayableDiff.ts"],"names":[],"mappings":";;;AAAA,mDAAuE;AACvE,yCAAiC;AAEjC;;;;GAIG;AACI,MAAM,kBAAkB,GAAG,CAAC,EACjC,IAAI,EACJ,IAAI,GAIL,EAAiB,EAAE;IAClB,2BAA2B;IAC3B,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhD,4DAA4D;IAC5D,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACnC,MAAM,cAAc,GAAG,IAAA,0BAAS,EAAC,IAAA,6BAAY,EAAC,IAAI,CAAC,CAAC,CAAC;QACrD,MAAM,cAAc,GAAG,IAAA,0BAAS,EAAC,IAAA,6BAAY,EAAC,IAAI,CAAC,CAAC,CAAC;QACrD,IAAI,cAAc,KAAK,cAAc;YAAE,OAAO,IAAI,CAAC;IACrD,CAAC;IAED,4BAA4B;IAC5B,MAAM,mBAAmB,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAA,6BAAY,EAAC,IAAI,CAAC,CAAC;IACpE,MAAM,mBAAmB,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAA,6BAAY,EAAC,IAAI,CAAC,CAAC;IAEpE,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAElD,6DAA6D;IAC7D,MAAM,UAAU,GAAG,IAAA,gBAAI,EAAC,mBAAmB,EAAE,mBAAmB,EAAE;QAChE,WAAW,EAAE,QAAQ;QACrB,WAAW,EAAE,SAAS;QACtB,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACpB,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACjC,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3E,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AApCW,QAAA,kBAAkB,sBAoC7B"}

package/dist/infra/asIsoTimestamp.d.ts

@@ -1,4 +1,4 @@
-import { IsoTimestamp } from '../domain.objects/IsoTimestamp';
+import { type IsoTimestamp } from '../domain.objects/IsoTimestamp';
 /**
  * .what = converts a Date to ISO 8601 timestamp string
  * .why = ensures consistent timestamp format across the system

package/license.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 ehmpathy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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.2.0",
+  "version": "1.3.1",
   "repository": "ehmpathy/declastruct",
   "homepage": "https://github.com/ehmpathy/declastruct",
   "keywords": [
@@ -38,7 +38,7 @@
     "test:types": "tsc -p ./tsconfig.build.json --noEmit",
     "test:format:prettier": "prettier --parser typescript --check 'src/**/*.ts' --config ./prettier.config.js",
     "test:format": "npm run test:format:prettier",
-    "test:lint:deps": "npx depcheck -c ./depcheckrc.yml",
+    "test:lint:deps": "npx depcheck -c ./.depcheckrc.yml",
     "test:lint:eslint": "eslint -c ./.eslintrc.js src/**/*.ts",
     "test:lint": "npm run test:lint:eslint && npm run test:lint:deps",
     "test:unit": "jest -c ./jest.unit.config.ts --forceExit --verbose --passWithNoTests $([ -z $THOROUGH ] && echo '--changedSince=main')",
@@ -50,8 +50,8 @@
     "prepublish": "npm run build",
     "preversion": "npm run prepush",
     "postversion": "git push origin HEAD --tags --no-verify",
-    "postinstall": "[ -d .git ] && npm run prepare:husky || exit 0",
-    "prepare:husky": "npx husky install && chmod ug+x .husky/*"
+    "prepare:husky": "npx husky install && chmod ug+x .husky/*",
+    "prepare": "[ -d .git ] && npm run prepare:husky || exit 0"
   },
   "dependencies": {
     "bottleneck": "2.19.5",
@@ -60,41 +60,51 @@
     "jest-diff": "30.0.2",
     "simple-log-methods": "0.6.2",
     "tsx": "4.20.6",
-    "type-fns": "1.19.0",
+    "type-fns": "1.21.0",
     "uuid-fns": "1.0.2"
   },
   "peerDependencies": {
     "domain-objects": "0.31.0"
   },
   "devDependencies": {
+    "@babel/core": "7.28.5",
+    "@babel/preset-env": "7.28.5",
     "@commitlint/cli": "19.3.0",
     "@commitlint/config-conventional": "13.1.0",
     "@trivago/prettier-plugin-sort-imports": "4.3.0",
     "@tsconfig/node-lts-strictest": "18.12.1",
     "@types/jest": "29.2.4",
+    "@types/node": "22.15.29",
     "@typescript-eslint/eslint-plugin": "7.8.0",
     "@typescript-eslint/parser": "7.8.0",
+    "babel-jest": "30.2.0",
     "core-js": "3.26.1",
     "cz-conventional-changelog": "3.3.0",
-    "declapract": "0.12.0",
-    "declapract-typescript-ehmpathy": "0.39.5",
+    "declapract": "0.12.3",
+    "declapract-typescript-ehmpathy": "0.42.2",
+    "declastruct": "1.3.0",
+    "declastruct-github": "1.0.3",
     "depcheck": "1.4.3",
     "eslint": "8.56.0",
     "eslint-config-airbnb-typescript": "18.0.0",
     "eslint-config-prettier": "8.5.0",
     "eslint-plugin-import": "2.26.0",
     "eslint-plugin-prettier": "4.2.1",
+    "eslint-plugin-unused-imports": "4.1.4",
     "husky": "8.0.3",
     "jest": "29.3.1",
     "prettier": "2.8.1",
     "rhachet": "1.12.1",
     "rhachet-roles-ehmpathy": "1.9.1",
-    "ts-jest": "29.1.3",
+    "test-fns": "1.7.2",
+    "ts-jest": "29.4.5",
+    "tsx": "4.20.6",
     "typescript": "5.4.5"
   },
   "config": {
     "commitizen": {
       "path": "./node_modules/cz-conventional-changelog"
     }
-  }
+  },
+  "packageManager": "pnpm@10.24.0"
 }

package/readme.md

@@ -3,20 +3,40 @@
 ![test](https://github.com/ehmpathy/declastruct/workflows/test/badge.svg)
 ![publish](https://github.com/ehmpathy/declastruct/workflows/publish/badge.svg)
 
-declarative control for any resource constructs, batteries included
+declarative control of any resource constructs, batteries included
 
 # intro
 
-Add declarative control to any resource construct. Declare, plan, and apply within an observable pit-of-success.
+Control any resource construct declaratively. Declare what you want ✨. Plan to see what must change 🔮. Apply to make it so 🪄
 
-Declare the structures you want. Plan to see the changes required. Apply to make it so 🪄
+## what is it?
 
+`declastruct` is a framework to control any resource construct via **declarative instructions** — you describe **what** you want the end state to be, and the system figures out **how** to get there.
 
-## what is it?
+**declarative instructions** means:
+- you declare the desired state of your resources
+- the system compares your desires against reality
+- the system computes the changes required to reconcile reality with your desires
+- you review and apply those changes
 
-`declastruct` is a framework for managing any resource construct declaratively using TypeScript.
+in contrast to **imperative instructions**, where you specify each step and _hope_ it produces what you want:
+```ts
+// imperative 👎 = you say HOW to do things, step by step
+await createBucket({ name: 'my-bucket' });
+await enableVersioning({ bucket: 'my-bucket' });
+await setEncryption({ bucket: 'my-bucket', type: 'AES256' });
+```
 
-declare what you want, plan the changes, and apply them safely — all without managing separate state files or learning a new language.
+the advantage of **declarative instructions** is that you simply declare what you want and _know_ it will work:
+```ts
+// declarative 👍 = you say WHAT you want, the system figures out how
+const bucket = DeclaredAwsS3Bucket.as({
+  name: 'my-bucket',
+  versioning: true,
+  encryption: 'AES256',
+});
+await apply({ resources: [bucket] });
+```
 
 works with:
 - **infrastructure** — AWS, GCP, Azure resources
@@ -26,7 +46,7 @@ works with:
 
 think Terraform, but:
 - **no state files to manage** — compares directly against live remote state
-- **no new language to learn** — uses TypeScript and your existing domain objects
+- **no new language to learn** — declare via TypeScript, reuse domain objects and operations
 - **pit-of-success by default** — enforces idempotency, clear unique keys, and safe operations
 - **not just infrastructure** — works with any resource construct (saas, databases, apis, etc)
 
@@ -42,7 +62,7 @@ npm install declastruct --save-dev
 
 ### 1. **declare** your desired state ✨
 
-define resource constructs with strongly-typed domain objects:
+declare your wish via strongly-typed [domain-objects](https://github.com/ehmpathy/domain-objects). these are the declarative instructions that will control your resources.
 
 ```ts
 import { getDeclastructAwsProvider, DeclaredAwsS3Bucket } from 'declastruct-aws';
@@ -78,7 +98,7 @@ export const getResources = async () => {
 
 ### 2. **plan** the required changes 🔮
 
-see exactly what will change before applying:
+see exactly what must change to make your wish come true, ahead of time
 
 ```sh
 npx declastruct plan \
@@ -102,7 +122,7 @@ planned changes:
 
 ### 3. **apply** the plan 🪄
 
-execute the plan to make your desired state reality:
+apply the plan to make your wish come true
 
 ```sh
 npx declastruct apply --plan provision/.temp/plan.json
@@ -116,11 +136,11 @@ npx declastruct apply --plan provision/.temp/plan.json
 
 ✅ **type-safe** — full TypeScript support with domain objects
 
-✅ **idempotent** — safe to run plans multiple times
+✅ **idempotent** — safe to plan and apply repeatedly
 
-✅ **observable** — see exactly what will change before applying
+✅ **observable** — see exactly what would change if you apply
 
-✅ **composable** — reuse domain objects and operations across application code and resource management
+✅ **composable** — reuse domain objects and operations across application code and declarative instructions
 
 ✅ **pit-of-success** — enforced best practices via idempotent dao interfaces
 
@@ -131,20 +151,20 @@ npx declastruct apply --plan provision/.temp/plan.json
 
 ### no state file management
 
-traditional declarative tools (like Terraform) require maintaining a separate state file that tracks what resources exist. this creates problems:
+traditional declarative tools (like Terraform) require separate state files to track resources existence. this creates problems:
 - state files can drift from reality
-- state locking issues in team environments
+- state lock issues in team environments
 - state files must be carefully secured and backed up
 
-**declastruct eliminates state files entirely.** it compares your desired resource constructs directly against live remote state using unique keys, so the source of truth is always reality itself.
+**declastruct eliminates state files entirely.** it compares your declared desires directly against live remote state via unique keys, so the source of truth is always reality itself.
 
 ### use your existing domain language
 
-instead of learning HCL, YAML, or another DSL:
-- declare resource constructs as TypeScript using `domain-objects`
-- reuse the same domain objects across your application code and remote resource management
-- leverage TypeScript's type safety, IDE autocomplete, and refactoring tools
-- compose and test resource definitions like any other code
+instead of HCL, YAML, or another DSL:
+- write declarative instructions via TypeScript with [`domain-objects`](https://github.com/ehmpathy/domain-objects)
+- reuse the domain objects and domain operations across your application code and declarative instructions
+- leverage TypeScript's type safety, IDE autocomplete, and refactor tools
+- compose and test declarative instructions like any other code
 
 ### enforced best practices
 
@@ -153,14 +173,14 @@ declastruct providers follow a pit-of-success pattern that guarantees:
 **idempotency** — all operations can be safely retried
 - `finsert`: find-or-insert (safe create)
 - `upsert`: update-or-insert (safe update)
-- running the same plan multiple times produces the same result
+- repeat any operation multiple times, get the same result each time
 
 **explicit unique keys** — every resource declares how to uniquely identify it
 - prevents accidental duplicates
 - enables accurate comparison against live state
 - makes resource relationships clear, typesafe, and composable
 
-**observable change plans** — see exactly what will change before applying
+**observable change plans** — see exactly what must change before you apply
 - diff view shows before & after for each resource
 - change actions: CREATE, UPDATE, KEEP, DESTROY
 - no surprises in production
@@ -175,14 +195,14 @@ declastruct is designed to support any resource construct through adapters:
 - `declastruct-github` — Github resources (repos, branches, protection, etc.)
 - etc
 
-**build your own provider** for any resource construct (GitHub repos, Slack channels, database records, etc.) by implementing the `DeclastructDao` and `DeclastructProvider` interfaces.
+**build your own provider** for any resource construct (GitHub repos, Slack channels, database records, etc.) via the `DeclastructDao` and `DeclastructProvider` interfaces.
 
 ## use cases
 
-- **infrastructure as code** — manage AWS, GCP, Azure resources declaratively
-- **SaaS platform management** — manage Stripe customers, GitHub repos, Slack channels, etc declaratively
-- **database state management** — control database resource states declaratively
-- **api state management** — control remote resource state through api's declaratively
+- **infrastructure as code** — control AWS, GCP, Azure resources via declarative instructions
+- **SaaS platform management** — control Stripe customers, GitHub repos, Slack channels via declarative instructions
+- **database state management** — control database resource states via declarative instructions
+- **api state management** — control remote resource state via declarative instructions
 - **multi-platform orchestration** — coordinate resources across different providers in one plan
 
 
@@ -192,7 +212,7 @@ declastruct is designed to support any resource construct through adapters:
 
 ### DeclastructDao
 
-the core abstraction that defines how to interact with a resource type:
+the core abstraction that defines how to get and set a resource type:
 
 ```ts
 interface DeclastructDao<TResource, TResourceClass, TContext> {
@@ -209,7 +229,7 @@ interface DeclastructDao<TResource, TResourceClass, TContext> {
 }
 ```
 
-every resource class gets a DeclastructDao that enforces safe, idempotent operations.
+every resource class has a DeclastructDao that enforces safe, idempotent operations.
 
 ### DeclastructProvider
 
@@ -229,7 +249,7 @@ interface DeclastructProvider<TDaos, TContext> {
 
 ### DeclastructPlan
 
-captures the changes needed to achieve desired state:
+captures the changes needed to reconcile reality with declared desires:
 
 ```ts
 interface DeclastructPlan {
@@ -249,4 +269,4 @@ each `DeclastructChange` includes:
 
 ## inspiration
 
-inspired by Terraform's declarative approach, but designed to eliminate state management overhead, work with any resource construct, and leverage TypeScript's type system for safer declarative resource management.
+inspired by Terraform's declarative approach, but designed to eliminate state file overhead, work with any resource construct, be reusable across both prod codepaths and cicd control, and leverage TypeScript's type system for safer declarative instructions.

package/dist/.test/assets/providers/demo.provider.d.ts

@@ -1,32 +0,0 @@
-import { DomainEntity } from 'domain-objects';
-import { DeclastructDao } from '../../../domain.objects/DeclastructDao';
-import { DeclastructProvider } from '../../../domain.objects/DeclastructProvider';
-/**
- * .what = demo resource for integration testing
- */
-interface DemoResource {
-    exid: string;
-    name: string;
-}
-declare class DemoResource extends DomainEntity<DemoResource> implements DemoResource {
-    static unique: readonly ["exid"];
-}
-/**
- * .what = demo provider with on-disk persistence
- * .why = enables full integration testing with real CRUD operations
- */
-export declare const demoProvider: DeclastructProvider<{
-    DemoResource: DeclastructDao<DemoResource, typeof DemoResource, any>;
-}, {}>;
-/**
- * .what = generates a sample DemoResource with automatic unique ID
- * .why = simplifies test resource creation without managing IDs manually
- * .note = use resource.clone({ name: 'New Name' }) to update properties while keeping same exid
- */
-export declare const genSampleDemoResource: (input: {
-    name: string;
-}) => import("domain-objects/dist/manipulation/immute/withImmute").WithImmute<DemoResource>;
-/**
- * .what = export DemoResource class for test usage
- */
-export { DemoResource };