npm - declastruct - Versions diffs - 1.6.0 → 1.7.1 - Mend

declastruct 1.6.0 → 1.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (27) hide show

package/dist/contract/cli/apply.js +10 -3
package/dist/contract/cli/apply.js.map +1 -1
package/dist/contract/cli/plan.js +8 -3
package/dist/contract/cli/plan.js.map +1 -1
package/dist/contract/sdk/index.d.ts +1 -0
package/dist/contract/sdk/index.js +4 -1
package/dist/contract/sdk/index.js.map +1 -1
package/dist/domain.objects/DeclastructDao.d.ts +11 -11
package/dist/domain.objects/DeclastructDao.js.map +1 -1
package/dist/domain.objects/genDeclastructDao.d.ts +15 -7
package/dist/domain.objects/genDeclastructDao.js +25 -6
package/dist/domain.objects/genDeclastructDao.js.map +1 -1
package/dist/domain.objects/symbols.d.ts +5 -0
package/dist/domain.objects/symbols.js +9 -0
package/dist/domain.objects/symbols.js.map +1 -0
package/dist/domain.operations/apply/applyChange.js +2 -2
package/dist/domain.operations/apply/applyChange.js.map +1 -1
package/dist/domain.operations/del/del.d.ts +27 -0
package/dist/domain.operations/del/del.js +33 -0
package/dist/domain.operations/del/del.js.map +1 -0
package/dist/domain.operations/plan/planChanges.js +4 -1
package/dist/domain.operations/plan/planChanges.js.map +1 -1
package/package.json +12 -10
package/readme.md +4 -4
package/dist/domain/constants.d.ts +0 -3
package/dist/domain/constants.js +0 -5
package/dist/domain/constants.js.map +0 -1

package/dist/contract/cli/apply.js CHANGED Viewed

@@ -33,6 +33,7 @@ const fs_1 = require("fs");
 const promises_1 = require("fs/promises");
 const helpful_errors_1 = require("helpful-errors");
 const path_1 = require("path");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
 const DeclastructPlan_1 = require("../../domain.objects/DeclastructPlan");
 const applyChanges_1 = require("../../domain.operations/apply/applyChanges");
 const log = console;
@@ -76,12 +77,18 @@ const executeApplyCommand = async (input) => {
     // validate wish file exists
     if (!(0, fs_1.existsSync)(resolvedWishPath))
         throw new helpful_errors_1.BadRequestError(`Wish file not found: ${resolvedWishPath}`);
+    // get git root for relative path display
+    const gitRoot = await (0, rhachet_artifact_git_1.getGitRepoRoot)({ from: process.cwd() });
+    const relativePlanPath = resolvedPlanPath
+        ? (0, path_1.relative)(gitRoot, resolvedPlanPath)
+        : null;
+    const relativeWishPath = (0, path_1.relative)(gitRoot, resolvedWishPath);
     // log header
     log.info('');
     log.info('🌊 declastruct apply');
-    if (resolvedPlanPath)
-        log.info(`   plan: ${resolvedPlanPath}`);
-    log.info(`   wish: ${resolvedWishPath}`);
+    if (relativePlanPath)
+        log.info(`   plan: ${relativePlanPath}`);
+    log.info(`   wish: ${relativeWishPath}`);
     log.info('');
     // import wish file
     const wish = await Promise.resolve(`${resolvedWishPath}`).then(s => __importStar(require(s)));

package/dist/contract/cli/apply.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../src/contract/cli/apply.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,4DAAoC;AACpC,2BAAgC;AAChC,0CAAuC;AACvC,mDAAiD;AACjD,+~~BAA+B~~;~~AAE/B~~,0EAAuE;AACvE,6EAA0E;AAE1E,MAAM,GAAG,GAAG,OAAO,CAAC;AAEpB;;;;;;GAMG;AACI,MAAM,mBAAmB,GAAG,KAAK,EAAE,KAGzC,EAAiB,EAAE;IAClB,oCAAoC;IACpC,MAAM,UAAU,GAAG,KAAK,CAAC,YAAY,KAAK,MAAM,CAAC;IACjD,IAAI,UAAU,EAAE,CAAC;QACf,4BAA4B;QAC5B,IAAI,CAAC,KAAK,CAAC,YAAY;YACrB,MAAM,IAAI,gCAAe,CAAC,kCAAkC,CAAC,CAAC;IAClE,CAAC;SAAM,CAAC;QACN,6CAA6C;QAC7C,IAAI,CAAC,KAAK,CAAC,YAAY;YAAE,MAAM,IAAI,gCAAe,CAAC,iBAAiB,CAAC,CAAC;IACxE,CAAC;IAED,yCAAyC;IACzC,MAAM,gBAAgB,GAAG,UAAU;QACjC,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAA,cAAO,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,YAAa,CAAC,CAAC;IAEhD,2CAA2C;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAqC,EAAE;QAC9D,IAAI,CAAC,gBAAgB;YAAE,OAAO,IAAI,CAAC;QACnC,IAAI,CAAC,IAAA,eAAU,EAAC,gBAAgB,CAAC;YAC/B,MAAM,IAAI,gCAAe,CAAC,wBAAwB,gBAAgB,EAAE,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,MAAM,IAAA,mBAAQ,EAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QAC3D,OAAO,IAAI,iCAAe,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,EAAE,CAAC;IAEL,mDAAmD;IACnD,MAAM,gBAAgB,GAAG,UAAU;QACjC,CAAC,CAAC,IAAA,cAAO,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,YAAa,CAAC;QAC7C,CAAC,CAAC,IAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IAEnB,4BAA4B;IAC5B,IAAI,CAAC,IAAA,eAAU,EAAC,gBAAgB,CAAC;QAC/B,MAAM,IAAI,gCAAe,CAAC,wBAAwB,gBAAgB,EAAE,CAAC,CAAC;IAExE,aAAa;IACb,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,GAAG,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACjC,IAAI,gBAAgB;QAAE,GAAG,CAAC,IAAI,CAAC,YAAY,gBAAgB,EAAE,CAAC,CAAC;IAC/D,GAAG,CAAC,IAAI,CAAC,YAAY,gBAAgB,EAAE,CAAC,CAAC;IACzC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEb,mBAAmB;IACnB,MAAM,IAAI,GAAG,yBAAa,gBAAgB,uCAAC,CAAC;IAE5C,mBAAmB;IACnB,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,UAAU;QACzC,MAAM,IAAI,gCAAe,CAAC,+CAA+C,CAAC,CAAC;IAC7E,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,UAAU;QACzC,MAAM,IAAI,gCAAe,CAAC,+CAA+C,CAAC,CAAC;IAE7E,8BAA8B;IAC9B,MAAM,SAAS,GAAuB,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;IAChE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;IAE5C,uBAAuB;IACvB,oCAAoC;IACpC,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAElE,iBAAiB;IACjB,MAAM,OAAO,GAAG;QACd,UAAU,EAAE,IAAI,oBAAU,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;QAChD,GAAG;KACJ,CAAC;IAEF,oEAAoE;IACpE,MAAM,MAAM,GAAG,MAAM,IAAA,2BAAY,EAC/B;QACE,IAAI;QACJ,SAAS;QACT,SAAS;KACV,EACD,OAAO,CACR,CAAC;IAEF,oBAAoB;IACpB,gBAAgB;IAChB,mCAAmC;IACnC,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAEjE,cAAc;IACd,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,GAAG,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,cAAc,CAAC,MAAM,UAAU,CAAC,CAAC;IAC/D,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACf,CAAC,CAAC;~~AAvFW~~,QAAA,mBAAmB,~~uBAuF9B~~"}
1	+ {"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../src/contract/cli/apply.ts"],"names":[],"mappings":"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"}

package/dist/contract/cli/plan.js CHANGED Viewed

@@ -33,6 +33,7 @@ const fs_1 = require("fs");
 const promises_1 = require("fs/promises");
 const helpful_errors_1 = require("helpful-errors");
 const path_1 = require("path");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
 const planChanges_1 = require("../../domain.operations/plan/planChanges");
 const log = console;
 /**
@@ -44,14 +45,18 @@ const executePlanCommand = async ({ wishFilePath, planFilePath, }) => {
     // resolve paths
     const resolvedWishPath = (0, path_1.resolve)(process.cwd(), wishFilePath);
     const resolvedPlanPath = (0, path_1.resolve)(process.cwd(), planFilePath);
+    // get git root for relative path display
+    const gitRoot = await (0, rhachet_artifact_git_1.getGitRepoRoot)({ from: process.cwd() });
+    const relativeWishPath = (0, path_1.relative)(gitRoot, resolvedWishPath);
+    const relativePlanPath = (0, path_1.relative)(gitRoot, resolvedPlanPath);
     // validate wish file exists
     if (!(0, fs_1.existsSync)(resolvedWishPath)) {
         throw new helpful_errors_1.BadRequestError(`Wish file not found: ${resolvedWishPath}`);
     }
     log.info('');
     log.info('🌊 declastruct plan');
-    log.info(`   wish: ${resolvedWishPath}`);
-    log.info(`   plan: ${resolvedPlanPath}`);
+    log.info(`   wish: ${relativeWishPath}`);
+    log.info(`   plan: ${relativePlanPath}`);
     log.info('');
     // import wish file
     const wish = await Promise.resolve(`${resolvedWishPath}`).then(s => __importStar(require(s)));
@@ -91,7 +96,7 @@ const executePlanCommand = async ({ wishFilePath, planFilePath, }) => {
     // log summary
     log.info('');
     log.info(`🌊 planned for ${plan.changes.length} resources`);
-    log.info(`   into ${resolvedPlanPath}`);
+    log.info(`   into ${relativePlanPath}`);
     log.info('');
 };
 exports.executePlanCommand = executePlanCommand;

package/dist/contract/cli/plan.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/contract/cli/plan.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,4DAAoC;AACpC,2BAAgC;AAChC,0CAA+C;AAC/C,mDAAiD;AACjD,+~~BAAwC~~;~~AAExC~~,0EAAuE;AAEvE,MAAM,GAAG,GAAG,OAAO,CAAC;AAEpB;;;;GAIG;AACI,MAAM,kBAAkB,GAAG,KAAK,EAAE,EACvC,YAAY,EACZ,YAAY,GAIb,EAAiB,EAAE;IAClB,gBAAgB;IAChB,MAAM,gBAAgB,GAAG,IAAA,cAAO,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC;IAC9D,MAAM,gBAAgB,GAAG,IAAA,cAAO,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC;IAE9D,4BAA4B;IAC5B,IAAI,CAAC,IAAA,eAAU,EAAC,gBAAgB,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,gCAAe,CAAC,wBAAwB,gBAAgB,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAChC,GAAG,CAAC,IAAI,CAAC,YAAY,gBAAgB,EAAE,CAAC,CAAC;IACzC,GAAG,CAAC,IAAI,CAAC,YAAY,gBAAgB,EAAE,CAAC,CAAC;IACzC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEb,mBAAmB;IACnB,MAAM,IAAI,GAAG,yBAAa,gBAAgB,uCAAC,CAAC;IAE5C,mBAAmB;IACnB,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QAC5C,MAAM,IAAI,gCAAe,CAAC,+CAA+C,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QAC5C,MAAM,IAAI,gCAAe,CAAC,+CAA+C,CAAC,CAAC;IAC7E,CAAC;IAED,8BAA8B;IAC9B,MAAM,SAAS,GAAuB,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;IAChE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;IAE5C,uBAAuB;IACvB,oCAAoC;IACpC,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAElE,iBAAiB;IACjB,MAAM,OAAO,GAAG;QACd,UAAU,EAAE,IAAI,oBAAU,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;QAChD,GAAG;KACJ,CAAC;IAEF,0DAA0D;IAC1D,MAAM,IAAI,GAAG,MAAM,IAAA,yBAAW,EAC5B;QACE,SAAS;QACT,SAAS;QACT,YAAY,EAAE,gBAAgB;KAC/B,EACD,OAAO,CACR,CAAC;IAEF,iCAAiC;IACjC,MAAM,OAAO,GAAG,IAAA,cAAO,EAAC,gBAAgB,CAAC,CAAC;IAC1C,MAAM,IAAA,gBAAK,EAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,qBAAqB;IACrB,MAAM,IAAA,oBAAS,EAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAE1E,oBAAoB;IACpB,gBAAgB;IAChB,mCAAmC;IACnC,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAEjE,cAAc;IACd,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,OAAO,CAAC,MAAM,YAAY,CAAC,CAAC;IAC5D,GAAG,CAAC,IAAI,CAAC,WAAW,gBAAgB,EAAE,CAAC,CAAC;IACxC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACf,CAAC,CAAC;~~AA1EW~~,QAAA,kBAAkB,~~sBA0E7B~~"}
1	+ {"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/contract/cli/plan.ts"],"names":[],"mappings":"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"}

package/dist/contract/sdk/index.d.ts CHANGED Viewed

@@ -7,5 +7,6 @@ export { DeclastructProvider } from '../../domain.objects/DeclastructProvider';
 export type { DeclastructDaoInput, DeclastructDaoWithRef, DeclastructDaoWoutRef, } from '../../domain.objects/genDeclastructDao';
 export { genDeclastructDao } from '../../domain.objects/genDeclastructDao';
 export type { IsoTimestamp } from '../../domain.objects/IsoTimestamp';
+export { del, isMarkedForDeletion } from '../../domain.operations/del/del';
 export { getRefByPrimary } from '../../domain.operations/ref/getRefByPrimary';
 export { getRefByUnique } from '../../domain.operations/ref/getRefByUnique';

package/dist/contract/sdk/index.js CHANGED Viewed

@@ -1,7 +1,7 @@
 "use strict";
 // domain objects
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRefByUnique = exports.getRefByPrimary = exports.genDeclastructDao = exports.DeclastructProvider = exports.DeclastructPlan = exports.DeclastructDao = exports.DeclastructChangeAction = exports.DeclastructChange = void 0;
+exports.getRefByUnique = exports.getRefByPrimary = exports.isMarkedForDeletion = exports.del = exports.genDeclastructDao = exports.DeclastructProvider = exports.DeclastructPlan = exports.DeclastructDao = exports.DeclastructChangeAction = exports.DeclastructChange = void 0;
 var DeclastructChange_1 = require("../../domain.objects/DeclastructChange");
 Object.defineProperty(exports, "DeclastructChange", { enumerable: true, get: function () { return DeclastructChange_1.DeclastructChange; } });
 Object.defineProperty(exports, "DeclastructChangeAction", { enumerable: true, get: function () { return DeclastructChange_1.DeclastructChangeAction; } });
@@ -15,6 +15,9 @@ Object.defineProperty(exports, "DeclastructProvider", { enumerable: true, get: f
 var genDeclastructDao_1 = require("../../domain.objects/genDeclastructDao");
 Object.defineProperty(exports, "genDeclastructDao", { enumerable: true, get: function () { return genDeclastructDao_1.genDeclastructDao; } });
 // domain operations
+var del_1 = require("../../domain.operations/del/del");
+Object.defineProperty(exports, "del", { enumerable: true, get: function () { return del_1.del; } });
+Object.defineProperty(exports, "isMarkedForDeletion", { enumerable: true, get: function () { return del_1.isMarkedForDeletion; } });
 var getRefByPrimary_1 = require("../../domain.operations/ref/getRefByPrimary");
 Object.defineProperty(exports, "getRefByPrimary", { enumerable: true, get: function () { return getRefByPrimary_1.getRefByPrimary; } });
 var getRefByUnique_1 = require("../../domain.operations/ref/getRefByUnique");

package/dist/contract/sdk/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contract/sdk/index.ts"],"names":[],"mappings":";AAAA,iBAAiB;;;AAIjB,4EAGgD;AAF9C,sHAAA,iBAAiB,OAAA;AACjB,4HAAA,uBAAuB,OAAA;AAEzB,sEAAqE;AAA5D,gHAAA,cAAc,OAAA;AACvB,wEAAuE;AAA9D,kHAAA,eAAe,OAAA;AACxB,gFAA+E;AAAtE,0HAAA,mBAAmB,OAAA;AAM5B,YAAY;AACZ,4EAA2E;AAAlE,sHAAA,iBAAiB,OAAA;AAE1B,oBAAoB;AACpB,+EAA8E;AAArE,kHAAA,eAAe,OAAA;AACxB,6EAA4E;AAAnE,gHAAA,cAAc,OAAA"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contract/sdk/index.ts"],"names":[],"mappings":";AAAA,iBAAiB;;;AAIjB,4EAGgD;AAF9C,sHAAA,iBAAiB,OAAA;AACjB,4HAAA,uBAAuB,OAAA;AAEzB,sEAAqE;AAA5D,gHAAA,cAAc,OAAA;AACvB,wEAAuE;AAA9D,kHAAA,eAAe,OAAA;AACxB,gFAA+E;AAAtE,0HAAA,mBAAmB,OAAA;AAM5B,YAAY;AACZ,4EAA2E;AAAlE,sHAAA,iBAAiB,OAAA;AAE1B,oBAAoB;AACpB,uDAA2E;AAAlE,0FAAA,GAAG,OAAA;AAAE,0GAAA,mBAAmB,OAAA;AACjC,+EAA8E;AAArE,kHAAA,eAAe,OAAA;AACxB,6EAA4E;AAAnE,gHAAA,cAAc,OAAA"}

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

@@ -34,9 +34,9 @@ export interface DeclastructDao<TResourceClass extends Refable<any, any, any>, T
              * .what = fetch by primary keys
              * .why = enables efficient lookups when primary key is known
              *
-             * .note = set to null if resource lacks primary keys (forces explicit decision)
+             * .note = undefined if resource lacks primary keys; would be null, but that breaks bivariance
              */
-            byPrimary: null | ((input: RefByPrimary<TResourceClass>, context: TContext) => Promise<InstanceType<TResourceClass> | null>);
+            byPrimary?(input: RefByPrimary<TResourceClass>, context: TContext): Promise<InstanceType<TResourceClass> | null>;
             /**
              * .what = fetch by any supported reference type
              * .why = enables flexible lookups when ref type is not known at compile time
@@ -54,16 +54,16 @@ export interface DeclastructDao<TResourceClass extends Refable<any, any, any>, T
              * .what = resolve any ref to RefByPrimary
              * .why = enables getting primary key from any ref type
              *
-             * .note = set to null if resource lacks primary keys
+             * .note = undefined if resource lacks primary keys; would be null, but that breaks bivariance
              */
-            byPrimary: null | ((input: Ref<TResourceClass>, context: TContext) => Promise<RefByPrimary<TResourceClass> | null>);
+            byPrimary?(input: Ref<TResourceClass>, context: TContext): Promise<RefByPrimary<TResourceClass> | null>;
             /**
              * .what = resolve any ref to RefByUnique
              * .why = enables getting unique key from any ref type
              *
-             * .note = set to null if resource lacks primary keys
+             * .note = undefined if resource lacks primary keys; would be null, but that breaks bivariance
              */
-            byUnique: null | ((input: Ref<TResourceClass>, context: TContext) => Promise<RefByUnique<TResourceClass> | null>);
+            byUnique?(input: Ref<TResourceClass>, context: TContext): Promise<RefByUnique<TResourceClass> | null>;
         };
     };
     /**
@@ -75,21 +75,21 @@ export interface DeclastructDao<TResourceClass extends Refable<any, any, any>, T
          * .what = find or insert resource
          * .why = idempotent create - returns existing if found by unique keys, otherwise creates
          */
-        finsert(input: InstanceType<TResourceClass>, context: TContext): Promise<HasMetadata<InstanceType<TResourceClass>>>;
+        findsert(input: InstanceType<TResourceClass>, context: TContext): Promise<HasMetadata<InstanceType<TResourceClass>>>;
         /**
          * .what = create or update resource
          * .why = idempotent upsert - creates if not found, updates if found
          *
-         * .note = set to null if resource does not support updates
+         * .note = undefined if resource does not support updates; would be null, but that breaks bivariance
          */
-        upsert: null | ((input: InstanceType<TResourceClass>, context: TContext) => Promise<HasMetadata<InstanceType<TResourceClass>>>);
+        upsert?(input: InstanceType<TResourceClass>, context: TContext): Promise<HasMetadata<InstanceType<TResourceClass>>>;
         /**
          * .what = delete resource
          * .why = removes resource from remote state
          *
-         * .note = set to null if resource does not support deletion
+         * .note = undefined if resource does not support deletion; would be null, but that breaks bivariance
          */
-        delete: null | ((input: Ref<TResourceClass>, context: TContext) => Promise<void>);
+        delete?(input: Ref<TResourceClass>, context: TContext): Promise<void>;
     };
 }
 export declare class DeclastructDao<TResourceClass extends Refable<any, any, any>, TContext> extends DomainLiteral<DeclastructDao<TResourceClass, TContext>> implements DeclastructDao<TResourceClass, TContext> {

package/dist/domain.objects/DeclastructDao.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"DeclastructDao.js","sourceRoot":"","sources":["../../src/domain.objects/DeclastructDao.ts"],"names":[],"mappings":";;;AAAA,mDAMwB;~~AA0IxB~~,MAAa,cAIX,SAAQ,8BAAuD;CACT;AALxD,wCAKwD"}
1	+ {"version":3,"file":"DeclastructDao.js","sourceRoot":"","sources":["../../src/domain.objects/DeclastructDao.ts"],"names":[],"mappings":";;;AAAA,mDAMwB;AAgIxB,MAAa,cAIX,SAAQ,8BAAuD;CACT;AALxD,wCAKwD"}

package/dist/domain.objects/genDeclastructDao.d.ts CHANGED Viewed

@@ -3,10 +3,17 @@ import type { DeclastructDao } from './DeclastructDao';
 /**
  * .what = input type for genDeclastructDao without get.ref and get.one.byRef (auto-wired by factory)
  * .why = derives from DeclastructDao to stay in sync, omits auto-wired methods
+ * .note = uses `| null` syntax to force explicit decision on nullable methods
  */
-export type DeclastructDaoInput<TResourceClass extends Refable<any, any, any>, TContext> = Omit<DeclastructDao<TResourceClass, TContext>, 'get'> & {
+export type DeclastructDaoInput<TResourceClass extends Refable<any, any, any>, TContext> = Omit<DeclastructDao<TResourceClass, TContext>, 'get' | 'set'> & {
     get: {
-        one: Omit<DeclastructDao<TResourceClass, TContext>['get']['one'], 'byRef'>;
+        one: Omit<DeclastructDao<TResourceClass, TContext>['get']['one'], 'byRef' | 'byPrimary'> & {
+            byPrimary: ((input: RefByPrimary<TResourceClass>, context: TContext) => Promise<InstanceType<TResourceClass> | null>) | null;
+        };
+    };
+    set: Omit<DeclastructDao<TResourceClass, TContext>['set'], 'upsert' | 'delete'> & {
+        upsert: ((input: InstanceType<TResourceClass>, context: TContext) => Promise<InstanceType<TResourceClass>>) | null;
+        delete: ((input: Ref<TResourceClass>, context: TContext) => Promise<void>) | null;
     };
 };
 /**
@@ -34,26 +41,27 @@ export type DeclastructDaoInputWoutPrimary<TResourceClass extends Refable<any, a
 /**
  * .what = output type for daos with ref methods defined
  * .why = enables type-safe access to ref resolution methods
+ * .note = uses method syntax for bivariance (enables assignment to DeclastructDao<any>)
  */
 export type DeclastructDaoWithRef<TResourceClass extends Refable<any, any, any>, TContext> = Omit<DeclastructDao<TResourceClass, TContext>, 'get'> & {
     get: {
         one: DeclastructDao<TResourceClass, TContext>['get']['one'];
         ref: {
-            byPrimary: (input: Ref<TResourceClass>, context: TContext) => Promise<RefByPrimary<TResourceClass> | null>;
-            byUnique: (input: Ref<TResourceClass>, context: TContext) => Promise<RefByUnique<TResourceClass> | null>;
+            byPrimary(input: Ref<TResourceClass>, context: TContext): Promise<RefByPrimary<TResourceClass> | null>;
+            byUnique(input: Ref<TResourceClass>, context: TContext): Promise<RefByUnique<TResourceClass> | null>;
         };
     };
 };
 /**
  * .what = output type for daos without ref methods
- * .why = forces explicit null for ref methods when byPrimary is not supported
+ * .why = ref methods are undefined when byPrimary is not supported
  */
 export type DeclastructDaoWoutRef<TResourceClass extends Refable<any, any, any>, TContext> = Omit<DeclastructDao<TResourceClass, TContext>, 'get'> & {
     get: {
         one: DeclastructDao<TResourceClass, TContext>['get']['one'];
         ref: {
-            byPrimary: null;
-            byUnique: null;
+            byPrimary: undefined;
+            byUnique: undefined;
         };
     };
 };

package/dist/domain.objects/genDeclastructDao.js CHANGED Viewed

@@ -12,19 +12,27 @@ function genDeclastructDao(input) {
     const hasPrimary = input.get.one.byPrimary !== null;
     // build byRef from byUnique + byPrimary
     const byRef = async (ref, context) => {
-        if ((0, domain_objects_1.isRefByPrimary)({ of: input.dobj })(ref) && input.get.one.byPrimary)
+        // check primary key first (only if resource declares .primary)
+        if (hasPrimary && (0, domain_objects_1.isRefByPrimary)({ of: input.dobj })(ref))
             return input.get.one.byPrimary(ref, context);
+        // check unique key
         if ((0, domain_objects_1.isRefByUnique)({ of: input.dobj })(ref))
             return input.get.one.byUnique(ref, context);
         throw new helpful_errors_1.BadRequestError('get.one.byRef called with neither a RefByUnique nor RefByPrimary', { ref });
     };
+    // convert null → undefined for optional methods
+    const upsert = input.set.upsert ?? undefined;
+    const del = input.set.delete ?? undefined;
     if (hasPrimary) {
         // auto-wire ref methods using the helper functions
+        // convert null → undefined for byPrimary (input requires null, output uses undefined)
+        const byPrimary = input.get.one.byPrimary ?? undefined;
         const dao = {
             ...input,
             get: {
                 one: {
-                    ...input.get.one,
+                    byUnique: input.get.one.byUnique,
+                    byPrimary,
                     byRef,
                 },
                 ref: {
@@ -32,22 +40,33 @@ function genDeclastructDao(input) {
                     byUnique: (ref, context) => (0, getRefByUnique_1.getRefByUnique)({ ref }, { dao, ...context }),
                 },
             },
+            set: {
+                findsert: input.set.findsert,
+                upsert,
+                delete: del,
+            },
         };
         return dao;
     }
-    // no primary key support - ref methods are null
+    // no primary key support - ref methods are undefined
     return {
         ...input,
         get: {
             one: {
-                ...input.get.one,
+                byUnique: input.get.one.byUnique,
+                byPrimary: undefined,
                 byRef,
             },
             ref: {
-                byPrimary: null,
-                byUnique: null,
+                byPrimary: undefined,
+                byUnique: undefined,
             },
         },
+        set: {
+            findsert: input.set.findsert,
+            upsert,
+            delete: del,
+        },
     };
 }
 exports.genDeclastructDao = genDeclastructDao;

package/dist/domain.objects/genDeclastructDao.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"genDeclastructDao.js","sourceRoot":"","sources":["../../src/domain.objects/genDeclastructDao.ts"],"names":[],"mappings":";;;AAAA,mDAOwB;AACxB,mDAAiD;AAEjD,8EAA2E;AAC3E,4EAAyE;~~AAwHzE~~;;GAEG;AACH,SAAgB,iBAAiB,CAI/B,KAAoD;IAEpD,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC;IAEpD,wCAAwC;IACxC,MAAM,KAAK,GAAG,KAAK,EACjB,GAAwB,EACxB,OAAiB,EAC6B,EAAE;QAChD,IAAI,IAAA,+BAAc,EAAC,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC~~,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS~~;~~YACpE~~,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,~~SAAS~~,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;~~QAC/C~~,IAAI,IAAA,8BAAa,EAAC,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC;YACxC,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;~~QAC9C~~,MAAM,IAAI,gCAAe,CACvB,kEAAkE,EAClE,EAAE,GAAG,EAAE,CACR,CAAC;IACJ,CAAC,CAAC;IAEF,IAAI,UAAU,EAAE,CAAC;QACf,mDAAmD;QACnD,MAAM,GAAG,GAA6C;YACpD,GAAG,KAAK;YACR,GAAG,EAAE;gBACH,GAAG,EAAE;oBACH,~~GAAG~~,KAAK,CAAC,GAAG,CAAC,GAAG;~~oBAChB~~,KAAK;iBACN;gBACD,GAAG,EAAE;oBACH,SAAS,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAC1B,IAAA,iCAAe,EAAC,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;oBAC/C,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CACzB,IAAA,+BAAc,EAAC,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;iBAC/C;aACF;SACF,CAAC;QACF,OAAO,GAAG,CAAC;IACb,CAAC;IAED,~~gDAAgD~~;~~IAChD~~,OAAO;QACL,GAAG,KAAK;QACR,GAAG,EAAE;YACH,GAAG,EAAE;gBACH,~~GAAG~~,KAAK,CAAC,GAAG,CAAC,GAAG;~~gBAChB~~,KAAK;aACN;YACD,GAAG,EAAE;gBACH,SAAS,EAAE,~~IAAI~~;~~gBACf~~,QAAQ,EAAE,~~IAAI~~;~~aACf~~;SACF;KACF,CAAC;AACJ,CAAC;~~AAzDD~~,~~8CAyDC~~"}
1	+ {"version":3,"file":"genDeclastructDao.js","sourceRoot":"","sources":["../../src/domain.objects/genDeclastructDao.ts"],"names":[],"mappings":";;;AAAA,mDAOwB;AACxB,mDAAiD;AAEjD,8EAA2E;AAC3E,4EAAyE;AAqJzE;;GAEG;AACH,SAAgB,iBAAiB,CAI/B,KAAoD;IAEpD,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC;IAEpD,wCAAwC;IACxC,MAAM,KAAK,GAAG,KAAK,EACjB,GAAwB,EACxB,OAAiB,EAC6B,EAAE;QAChD,+DAA+D;QAC/D,IAAI,UAAU,IAAI,IAAA,+BAAc,EAAC,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC;YACvD,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,SAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAEhD,mBAAmB;QACnB,IAAI,IAAA,8BAAa,EAAC,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC;YACxC,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAE9C,MAAM,IAAI,gCAAe,CACvB,kEAAkE,EAClE,EAAE,GAAG,EAAE,CACR,CAAC;IACJ,CAAC,CAAC;IAEF,gDAAgD;IAChD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,IAAI,SAAS,CAAC;IAC7C,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,IAAI,SAAS,CAAC;IAE1C,IAAI,UAAU,EAAE,CAAC;QACf,mDAAmD;QACnD,sFAAsF;QACtF,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,IAAI,SAAS,CAAC;QACvD,MAAM,GAAG,GAA6C;YACpD,GAAG,KAAK;YACR,GAAG,EAAE;gBACH,GAAG,EAAE;oBACH,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ;oBAChC,SAAS;oBACT,KAAK;iBACN;gBACD,GAAG,EAAE;oBACH,SAAS,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAC1B,IAAA,iCAAe,EAAC,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;oBAC/C,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CACzB,IAAA,+BAAc,EAAC,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;iBAC/C;aACF;YACD,GAAG,EAAE;gBACH,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ;gBAC5B,MAAM;gBACN,MAAM,EAAE,GAAG;aACZ;SACF,CAAC;QACF,OAAO,GAAG,CAAC;IACb,CAAC;IAED,qDAAqD;IACrD,OAAO;QACL,GAAG,KAAK;QACR,GAAG,EAAE;YACH,GAAG,EAAE;gBACH,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ;gBAChC,SAAS,EAAE,SAAS;gBACpB,KAAK;aACN;YACD,GAAG,EAAE;gBACH,SAAS,EAAE,SAAS;gBACpB,QAAQ,EAAE,SAAS;aACpB;SACF;QACD,GAAG,EAAE;YACH,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ;YAC5B,MAAM;YACN,MAAM,EAAE,GAAG;SACZ;KACF,CAAC;AACJ,CAAC;AA/ED,8CA+EC"}

package/dist/domain.objects/symbols.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+/**
+ * .what = symbol used to mark resources for declarative deletion
+ * .why = enables del() wrapper to mark resources without polluting their interface
+ */
+export declare const DECLASTRUCT_DELETE: unique symbol;

package/dist/domain.objects/symbols.js ADDED Viewed

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DECLASTRUCT_DELETE = void 0;
+/**
+ * .what = symbol used to mark resources for declarative deletion
+ * .why = enables del() wrapper to mark resources without polluting their interface
+ */
+exports.DECLASTRUCT_DELETE = Symbol.for('declastruct.delete');
+//# sourceMappingURL=symbols.js.map

package/dist/domain.objects/symbols.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"symbols.js","sourceRoot":"","sources":["../../src/domain.objects/symbols.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC"}

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

@@ -25,7 +25,7 @@ const applyChange = async ({ resource, change, providers, }) => {
     switch (change.action) {
         case DeclastructChange_1.DeclastructChangeAction.CREATE:
             // create new resource using provider context
-            await dao.set.finsert(change.state.desired ??
+            await dao.set.findsert(change.state.desired ??
                 helpful_errors_1.UnexpectedCodePathError.throw('expected change.state.desired for CREATE', { change }), providerContext);
             return change;
         case DeclastructChange_1.DeclastructChangeAction.UPDATE:
@@ -57,7 +57,7 @@ const applyChange = async ({ resource, change, providers, }) => {
             }
             await dao.set.delete(change.state.remote ??
                 helpful_errors_1.UnexpectedCodePathError.throw('expected change.state.remote for REPLACE', { change }), providerContext);
-            await dao.set.finsert(change.state.desired ??
+            await dao.set.findsert(change.state.desired ??
                 helpful_errors_1.UnexpectedCodePathError.throw('expected change.state.desired for REPLACE', { change }), providerContext);
             return change;
         default:

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

	@@ -1 +1 @@
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,EAAE,EAChC,QAAQ,EACR,MAAM,EACN,SAAS,GAKV,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,kDAAkD;IAClD,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,IAAA,mCAAgB,EAAC;QACzD,QAAQ;QACR,SAAS;KACV,CAAC,CAAC;IAEH,sCAAsC;IACtC,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,2CAAuB,CAAC,MAAM;YACjC,6CAA6C;YAC7C,MAAM,GAAG,CAAC,GAAG,CAAC,~~OAAO~~,~~CACnB~~,MAAM,CAAC,KAAK,CAAC,OAAO;gBAClB,wCAAuB,CAAC,KAAK,CAC3B,0CAA0C,EAC1C,EAAE,MAAM,EAAE,CACX,EACH,eAAe,CAChB,CAAC;YACF,OAAO,MAAM,CAAC;QAEhB,KAAK,2CAAuB,CAAC,MAAM;YACjC,kDAAkD;YAClD,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,CAClB,MAAM,CAAC,KAAK,CAAC,OAAO;gBAClB,wCAAuB,CAAC,KAAK,CAC3B,0CAA0C,EAC1C,EAAE,MAAM,EAAE,CACX,EACH,eAAe,CAChB,CAAC;YACF,OAAO,MAAM,CAAC;QAEhB,KAAK,2CAAuB,CAAC,OAAO;YAClC,yCAAyC;YACzC,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,CAClB,MAAM,CAAC,KAAK,CAAC,MAAM;gBACjB,wCAAuB,CAAC,KAAK,CAC3B,0CAA0C,EAC1C,EAAE,MAAM,EAAE,CACX,EACH,eAAe,CAChB,CAAC;YACF,OAAO,MAAM,CAAC;QAEhB,KAAK,2CAAuB,CAAC,OAAO;YAClC,4CAA4C;YAC5C,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,CAClB,MAAM,CAAC,KAAK,CAAC,MAAM;gBACjB,wCAAuB,CAAC,KAAK,CAC3B,0CAA0C,EAC1C,EAAE,MAAM,EAAE,CACX,EACH,eAAe,CAChB,CAAC;YACF,MAAM,GAAG,CAAC,GAAG,CAAC,~~OAAO~~,~~CACnB~~,MAAM,CAAC,KAAK,CAAC,OAAO;gBAClB,wCAAuB,CAAC,KAAK,CAC3B,2CAA2C,EAC3C,EAAE,MAAM,EAAE,CACX,EACH,eAAe,CAChB,CAAC;YACF,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;AAvGW,QAAA,WAAW,eAuGtB"}
1	+ {"version":3,"file":"applyChange.js","sourceRoot":"","sources":["../../../src/domain.operations/apply/applyChange.ts"],"names":[],"mappings":"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"}

package/dist/domain.operations/del/del.d.ts ADDED Viewed

@@ -0,0 +1,27 @@
+import type { DeclaredResource } from '../../domain.objects/DeclaredResource';
+import { DECLASTRUCT_DELETE } from '../../domain.objects/symbols';
+/**
+ * .what = marks a resource for deletion via declarative instruction
+ * .why = enables users to express deletion intent
+ *
+ * .how = attaches a symbol-keyed property to the resource object
+ *
+ * @example
+ * ```ts
+ * const getResources = async () => {
+ *   const tokens = await getAllIamAuthTokens(...);
+ *   return tokens.map(token => del(token)); // mark all for deletion
+ * }
+ * ```
+ */
+export declare const del: <T extends DeclaredResource>(resource: T) => T & {
+    [DECLASTRUCT_DELETE]: true;
+};
+/**
+ * .what = checks if a resource is marked for deletion
+ * .why = enables planChanges to detect deletion intent
+ * .note = type guard narrows to the marked type for downstream type safety
+ */
+export declare const isMarkedForDeletion: <T extends DeclaredResource>(resource: T) => resource is T & {
+    [DECLASTRUCT_DELETE]: true;
+};

package/dist/domain.operations/del/del.js ADDED Viewed

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMarkedForDeletion = exports.del = void 0;
+const symbols_1 = require("../../domain.objects/symbols");
+/**
+ * .what = marks a resource for deletion via declarative instruction
+ * .why = enables users to express deletion intent
+ *
+ * .how = attaches a symbol-keyed property to the resource object
+ *
+ * @example
+ * ```ts
+ * const getResources = async () => {
+ *   const tokens = await getAllIamAuthTokens(...);
+ *   return tokens.map(token => del(token)); // mark all for deletion
+ * }
+ * ```
+ */
+const del = (resource) => {
+    return Object.assign(resource, { [symbols_1.DECLASTRUCT_DELETE]: true });
+};
+exports.del = del;
+/**
+ * .what = checks if a resource is marked for deletion
+ * .why = enables planChanges to detect deletion intent
+ * .note = type guard narrows to the marked type for downstream type safety
+ */
+const isMarkedForDeletion = (resource) => {
+    // biome-ignore lint/suspicious/noExplicitAny: symbol access requires any cast
+    return resource[symbols_1.DECLASTRUCT_DELETE] === true;
+};
+exports.isMarkedForDeletion = isMarkedForDeletion;
+//# sourceMappingURL=del.js.map

package/dist/domain.operations/del/del.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"del.js","sourceRoot":"","sources":["../../../src/domain.operations/del/del.ts"],"names":[],"mappings":";;;AACA,0DAAkE;AAElE;;;;;;;;;;;;;GAaG;AACI,MAAM,GAAG,GAAG,CACjB,QAAW,EACyB,EAAE;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,4BAAkB,CAAC,EAAE,IAAa,EAAE,CAAC,CAAC;AAC1E,CAAC,CAAC;AAJW,QAAA,GAAG,OAId;AAEF;;;;GAIG;AACI,MAAM,mBAAmB,GAAG,CACjC,QAAW,EACqC,EAAE;IAClD,8EAA8E;IAC9E,OAAQ,QAAgB,CAAC,4BAAkB,CAAC,KAAK,IAAI,CAAC;AACxD,CAAC,CAAC;AALW,QAAA,mBAAmB,uBAK9B"}

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

@@ -4,6 +4,7 @@ exports.planChanges = void 0;
 const domain_objects_1 = require("domain-objects");
 const DeclastructChange_1 = require("../../domain.objects/DeclastructChange");
 const DeclastructPlan_1 = require("../../domain.objects/DeclastructPlan");
+const del_1 = require("../../domain.operations/del/del");
 const asIsoTimestamp_1 = require("../../infra/asIsoTimestamp");
 const colorizeAction_1 = require("../../infra/colorizeAction");
 const withSpinner_1 = require("../../infra/withSpinner");
@@ -42,9 +43,11 @@ const planChanges = async (input, context) => {
             // log done (replaces spinner)
             const durationSec = (durationMs / 1000).toFixed(2);
             context.log.info(`   ├─ ✔ done in ${durationSec}s`);
+            // determine desired state - null if marked for deletion
+            const desiredState = (0, del_1.isMarkedForDeletion)(resource) ? null : resource;
             // compute change
             const computed = (0, computeChange_1.computeChange)({
-                desired: resource,
+                desired: desiredState,
                 remote: remoteState,
             });
             // log decision

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

	@@ -1 +1 @@
1	- {"version":3,"file":"planChanges.js","sourceRoot":"","sources":["../../../src/domain.operations/plan/planChanges.ts"],"names":[],"mappings":";;;AAAA,mDAA4E;AAI5E,8EAAiF;AACjF,0EAAuE;AAEvE,+DAA4D;AAC5D,+DAA4D;AAC5D,yDAAsD;AACtD,mDAAgD;AAChD,yDAAsD;AACtD,+CAA4C;AAE5C;;;;GAIG;AACI,MAAM,WAAW,GAAG,KAAK,EAC9B,KAIC,EACD,OAA6C,EACnB,EAAE;IAC5B,wBAAwB;IACxB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAErB,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,EAAE,CAAC;IACnB,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAClD,kDAAkD;YAClD,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,IAAA,mCAAgB,EAAC;gBACzD,QAAQ;gBACR,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC,CAAC;YAEH,iCAAiC;YACjC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAA,wCAAuB,EAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAE3D,iEAAiE;YACjE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,IAAA,yBAAW,EAAC;gBAC5D,OAAO,EAAE,UAAU;gBACnB,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;aACjE,CAAC,CAAC;YAEH,8BAA8B;YAC9B,MAAM,WAAW,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACnD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,mBAAmB,WAAW,GAAG,CAAC,CAAC;YAEpD,iBAAiB;YACjB,MAAM,QAAQ,GAAG,IAAA,6BAAa,EAAC;gBAC7B,OAAO,EAAE,~~QAAQ~~;~~gBACjB~~,MAAM,EAAE,WAAW;aACpB,CAAC,CAAC;YAEH,eAAe;YACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAA,+BAAc,EAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAEtE,gDAAgD;YAChD,IAAI,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;gBAC9B,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU;qBAC3C,KAAK,CAAC,IAAI,CAAC;qBACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC;qBAC9B,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjC,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAErB,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,+CAA+C;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAC7B,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,2CAAuB,CAAC,IAAI,CAC3D,CAAC;IACF,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAChD,CAAC;IAED,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;~~AAnFW~~,QAAA,WAAW,~~eAmFtB~~"}
1	+ {"version":3,"file":"planChanges.js","sourceRoot":"","sources":["../../../src/domain.operations/plan/planChanges.ts"],"names":[],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -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.6.0",
+  "version": "1.7.1",
   "repository": "ehmpathy/declastruct",
   "homepage": "https://github.com/ehmpathy/declastruct",
   "keywords": [
@@ -28,9 +28,10 @@
   "scripts": {
     "build:ts": "tsc -p ./tsconfig.build.json",
     "commit:with-cli": "npx cz",
-    "fix:format:biome": "biome check --write src",
+    "fix:format:biome": "biome check --write",
     "fix:format": "npm run fix:format:biome",
-    "fix:lint": "biome check --write src",
+    "fix:lint": "biome check --write",
+    "fix": "npm run fix:format && npm run fix:lint",
     "build:clean": "rm dist/ -rf",
     "build:compile": "tsc -p ./tsconfig.build.json",
     "build": "npm run build:clean && npm run build:compile",
@@ -38,9 +39,9 @@
     "test:types": "tsc -p ./tsconfig.json --noEmit",
     "test:format": "npm run test:format:biome",
     "test:lint:deps": "npx depcheck -c ./.depcheckrc.yml",
-    "test:format:biome": "biome format src",
-    "test:lint:biome": "biome check src --diagnostic-level=error",
-    "test:lint:biome:all": "biome check src",
+    "test:format:biome": "biome format",
+    "test:lint:biome": "biome check --diagnostic-level=error",
+    "test:lint:biome:all": "biome check",
     "test:lint": "npm run test:lint:biome && npm run test:lint:deps",
     "test:unit": "jest -c ./jest.unit.config.ts --forceExit --verbose --passWithNoTests $([ -z $THOROUGH ] && echo '--changedSince=main')",
     "test:integration": "jest -c ./jest.integration.config.ts --forceExit --verbose --passWithNoTests $([ -z $THOROUGH ] && echo '--changedSince=main')",
@@ -52,7 +53,7 @@
     "preversion": "npm run prepush",
     "postversion": "git push origin HEAD --tags --no-verify",
     "prepare:husky": "npx husky install && chmod ug+x .husky/*",
-    "prepare": "[ -d .git ] && npm run prepare:husky || exit 0"
+    "prepare": "[ -e .git ] && npm run prepare:husky || exit 0"
   },
   "dependencies": {
     "bottleneck": "2.19.5",
@@ -60,6 +61,7 @@
     "commander": "14.0.2",
     "helpful-errors": "1.5.3",
     "jest-diff": "30.0.2",
+    "rhachet-artifact-git": "1.1.3",
     "simple-log-methods": "0.6.2",
     "tsx": "4.20.6",
     "type-fns": "1.21.0",
@@ -80,9 +82,9 @@
     "@types/node": "22.15.29",
     "cz-conventional-changelog": "3.3.0",
     "declapract": "^0.13.0",
-    "declapract-typescript-ehmpathy": "^0.43.7",
-    "declastruct": "^1.5.1",
-    "declastruct-github": "^1.0.7",
+    "declapract-typescript-ehmpathy": "0.43.16",
+    "declastruct": "1.5.1",
+    "declastruct-github": "1.0.7",
     "depcheck": "1.4.3",
     "esbuild-register": "3.6.0",
     "husky": "8.0.3",

package/readme.md CHANGED Viewed

@@ -171,7 +171,7 @@ instead of HCL, YAML, or another DSL:
 declastruct providers follow a pit-of-success pattern that guarantees:
 **idempotency** — all operations can be safely retried
-- `finsert`: find-or-insert (safe create)
+- `findsert`: find-or-insert (safe create)
 - `upsert`: update-or-insert (safe update)
 - repeat any operation multiple times, get the same result each time
@@ -222,7 +222,7 @@ interface DeclastructDao<TResource, TResourceClass, TContext> {
     byRef: (ref: Ref, context) => Promise<TResource | null>;
   };
   set: {
-    finsert: (resource: TResource, context) => Promise<TResource>;
+    findsert: (resource: TResource, context) => Promise<TResource>;
     upsert?: (resource: TResource, context) => Promise<TResource>;
     delete?: (ref: Ref, context) => Promise<void>;
   };
@@ -348,7 +348,7 @@ const daoStripeCustomer = genDeclastructDao<
     },
   },
   set: {
-    finsert: async (resource, context) => {
+    findsert: async (resource, context) => {
       // find-or-insert: idempotent create
       const foundBefore = await daoStripeCustomer.get.one.byUnique(
         { email: resource.email },
@@ -374,7 +374,7 @@ const daoStripeCustomer = genDeclastructDao<
         });
         return toResource(updated);
       }
-      return daoStripeCustomer.set.finsert(resource, context);
+      return daoStripeCustomer.set.findsert(resource, context);
     },
     delete: async (ref, context) => {
       const foundBefore = await daoStripeCustomer.get.one.byRef(ref, context);

package/dist/domain/constants.d.ts DELETED Viewed

@@ -1,3 +0,0 @@
-/**
- * constants shared across the whole service but not tied to a specific domain object go in this file
- */

package/dist/domain/constants.js DELETED Viewed

@@ -1,5 +0,0 @@
-"use strict";
-/**
- * constants shared across the whole service but not tied to a specific domain object go in this file
- */
-//# sourceMappingURL=constants.js.map

package/dist/domain/constants.js.map DELETED Viewed

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