@openhi/constructs 0.0.110 → 0.0.112

package/lib/delete-chunk.handler.d.mts

@@ -0,0 +1,29 @@
+import { C as CascadeChunkInput } from './events-CjS-sm0W.mjs';
+
+/**
+ * @see sites/www-docs/content/packages/@openhi/constructs/workflows/control-plane/owning-delete-cascade/delete-chunk-handler.md
+ *
+ * Cascade Step Functions Map-iteration handler. Receives one chunk of
+ * <=100 projection rows from the list-and-chunk step and issues a
+ * single `TransactWriteItems` via `executeMultiWrite` (#1010).
+ *
+ * Idempotency: ElectroDB / DynamoDB SDK forwards the `chunkToken` as
+ * the `ClientRequestToken` for the transaction, so a Map iteration
+ * replayed by Step Functions retry lands on the same transaction id.
+ * The state machine's `Catch` block also absorbs
+ * `TransactionCanceledException` as a no-op success — common when a
+ * prior replay already removed the rows.
+ *
+ * The handler never touches the canonical owning record; the finalize
+ * step owns the canonical delete.
+ */
+
+interface DeleteChunkOutput {
+    readonly ownerType: string;
+    readonly ownerId: string;
+    readonly tenantId?: string;
+    readonly rowsDeleted: number;
+}
+declare const handler: (input: CascadeChunkInput) => Promise<DeleteChunkOutput>;
+
+export { type DeleteChunkOutput, handler };

package/lib/delete-chunk.handler.d.ts

@@ -0,0 +1,29 @@
+import { C as CascadeChunkInput } from './events-CjS-sm0W.js';
+
+/**
+ * @see sites/www-docs/content/packages/@openhi/constructs/workflows/control-plane/owning-delete-cascade/delete-chunk-handler.md
+ *
+ * Cascade Step Functions Map-iteration handler. Receives one chunk of
+ * <=100 projection rows from the list-and-chunk step and issues a
+ * single `TransactWriteItems` via `executeMultiWrite` (#1010).
+ *
+ * Idempotency: ElectroDB / DynamoDB SDK forwards the `chunkToken` as
+ * the `ClientRequestToken` for the transaction, so a Map iteration
+ * replayed by Step Functions retry lands on the same transaction id.
+ * The state machine's `Catch` block also absorbs
+ * `TransactionCanceledException` as a no-op success — common when a
+ * prior replay already removed the rows.
+ *
+ * The handler never touches the canonical owning record; the finalize
+ * step owns the canonical delete.
+ */
+
+interface DeleteChunkOutput {
+    readonly ownerType: string;
+    readonly ownerId: string;
+    readonly tenantId?: string;
+    readonly rowsDeleted: number;
+}
+declare const handler: (input: CascadeChunkInput) => Promise<DeleteChunkOutput>;
+
+export { type DeleteChunkOutput, handler };