@reventlessdev/reventless-aws 3.0.0-alpha.302 → 3.0.0-alpha.304

package/tests/stateChangeDescriptorParity.mjs

@@ -49,6 +49,59 @@ const CASES = [
     entityKey: "p3",
     state: { id: "p3", blob: "x".repeat(70 * 1024), updatedAt: "2026-05-19T12:00:00Z" },
   },
+  // Retirement: the row is withdrawn, so every implementation must publish the
+  // metadata-only shape — no state, and no sortKeyValue either, even though this
+  // row carries an updatedAt that the same row would publish while live.
+  {
+    name: "retired row degrades to metadata only",
+    changeKind: "Updated",
+    entityKey: "p4",
+    state: { id: "p4", name: "Widget", archived: true, updatedAt: "2026-05-19T12:00:00Z" },
+    retiredField: "archived",
+  },
+  // The control: same field declared, flag false, so nothing changes. Without
+  // this, an implementation that dropped the payload unconditionally whenever a
+  // retiredField was configured would still pass the case above.
+  {
+    name: "live row with a retirement flag carries the row",
+    changeKind: "Updated",
+    entityKey: "p5",
+    state: { id: "p5", name: "Widget", archived: false, updatedAt: "2026-05-19T12:00:00Z" },
+    retiredField: "archived",
+  },
+  // The state form, and the reason it is a set: a lifecycle may end in more than
+  // one way, and both ways withdraw the row identically. Two cases rather than
+  // one so an implementation comparing against only the first member fails.
+  {
+    name: "row in the first retired state degrades to metadata only",
+    changeKind: "Updated",
+    entityKey: "p6",
+    state: { id: "p6", name: "Widget", shelfStatus: "Archived", updatedAt: "2026-05-19T12:00:00Z" },
+    retiredField: "shelfStatus",
+    retiredValues: ["Archived", "Discontinued"],
+  },
+  {
+    name: "row in the second retired state degrades to metadata only",
+    changeKind: "Updated",
+    entityKey: "p7",
+    state: {
+      id: "p7",
+      name: "Widget",
+      shelfStatus: "Discontinued",
+      updatedAt: "2026-05-19T12:00:00Z",
+    },
+    retiredField: "shelfStatus",
+    retiredValues: ["Archived", "Discontinued"],
+  },
+  // The state-form control: a live state on the same declared lifecycle.
+  {
+    name: "row in a live state carries the row",
+    changeKind: "Updated",
+    entityKey: "p8",
+    state: { id: "p8", name: "Widget", shelfStatus: "Listed", updatedAt: "2026-05-19T12:00:00Z" },
+    retiredField: "shelfStatus",
+    retiredValues: ["Archived", "Discontinued"],
+  },
   {
     name: "delete carries no row",
     changeKind: "Removed",
@@ -79,10 +132,17 @@ export async function buildAll() {
     return { ...descriptor, seq: "<seq>" };
   };
 
-  return CASES.map(({ name, changeKind, entityKey, state }) => ({
+  return CASES.map(({ name, changeKind, entityKey, state, retiredField, retiredValues }) => ({
     name,
     local: normalise(
-      local.make(changeKind, entityKey, state === undefined ? undefined : state, local.nextSequence()),
+      local.make(
+        changeKind,
+        entityKey,
+        state === undefined ? undefined : state,
+        local.nextSequence(),
+        retiredField,
+        retiredValues,
+      ),
     ),
     relay: normalise(
       relay.makeDescriptor(
@@ -93,10 +153,19 @@ export async function buildAll() {
         // OldImage, which makeDescriptor then drops.
         state === undefined ? { id: entityKey } : state,
         "49590300000000016818000000",
+        retiredField,
+        retiredValues,
       ),
     ),
     postgres: normalise(
-      postgres.makeDescriptor({ changeKind, entityKey, state, seq: postgres.nextSequence() }),
+      postgres.makeDescriptor({
+        changeKind,
+        entityKey,
+        state,
+        seq: postgres.nextSequence(),
+        retiredField,
+        retiredValues,
+      }),
     ),
   }));
 }