@blue-repository/types 1.0.0-rc.7 → 1.1.0

package/dist/packages/paynote/contents/PaymentMandate.d.ts

@@ -0,0 +1,503 @@
+export declare const PaymentMandate: {
+    readonly allowedPaymentCounterparties: {
+        readonly description: "Optional payment counterparty allowlist. Missing list means wildcard (any counterparty is allowed).\n";
+        readonly itemType: {
+            readonly counterpartyId: {
+                readonly description: "Counterparty identifier interpreted according to counterpartyType.";
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+            };
+            readonly counterpartyType: {
+                readonly description: "Allowed payment counterparty identifier type:\n- merchantId\n- customerId\n- accountNumber\n";
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+            };
+        };
+        readonly type: {
+            readonly blueId: "6aehfNAxHLC1PHHoDr3tYtFH3RWNbiWdFancJ1bypXEY";
+        };
+    };
+    readonly allowedPayNotes: {
+        readonly description: "Optional linked PayNote allowlist. Used only when allowLinkedPayNote is true. Missing list means wildcard (any linked PayNote is allowed). Each entry must set exactly one selector: typeBlueId or documentBlueId.\n";
+        readonly itemType: {
+            readonly documentBlueId: {
+                readonly description: "Optional blue-id of an allowed concrete PayNote document. Mutually exclusive with typeBlueId.\n";
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+            };
+            readonly typeBlueId: {
+                readonly description: "Optional blue-id of an allowed PayNote type. Mutually exclusive with documentBlueId.\n";
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+            };
+        };
+        readonly type: {
+            readonly blueId: "6aehfNAxHLC1PHHoDr3tYtFH3RWNbiWdFancJ1bypXEY";
+        };
+    };
+    readonly allowLinkedPayNote: {
+        readonly description: "Whether this mandate allows linked PayNote startup after charge execution.";
+        readonly type: {
+            readonly blueId: "4EzhSubEimSQD3zrYHRtobfPPWntUuhEz8YcdxHsi12u";
+        };
+    };
+    readonly amountCaptured: {
+        readonly description: "Running captured amount in minor currency units. Increased after successful capture.\n";
+        readonly type: {
+            readonly blueId: "5WNMiV9Knz63B4dVY5JtMyh3FB4FSGqv7ceScvuapdE1";
+        };
+    };
+    readonly amountLimit: {
+        readonly description: "Maximum amount in minor currency units allowed by this mandate.";
+        readonly type: {
+            readonly blueId: "5WNMiV9Knz63B4dVY5JtMyh3FB4FSGqv7ceScvuapdE1";
+        };
+    };
+    readonly amountReserved: {
+        readonly description: "Running reserved amount in minor currency units. Increased after successful reserve/authorize, decreased after release/capture.\n";
+        readonly type: {
+            readonly blueId: "5WNMiV9Knz63B4dVY5JtMyh3FB4FSGqv7ceScvuapdE1";
+        };
+    };
+    readonly chargeAttempts: {
+        readonly description: "Stateful map of authorizationId -> authorization state (authorization + settlement).";
+        readonly keyType: {
+            readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+        };
+        readonly type: {
+            readonly blueId: "G7fBT9PSod1RfHLHkpafAGBDVAJMrMhAMY51ERcyXNrj";
+        };
+        readonly valueType: {
+            readonly amountMinor: {
+                readonly description: "Requested amount in minor currency units.";
+                readonly type: {
+                    readonly blueId: "5WNMiV9Knz63B4dVY5JtMyh3FB4FSGqv7ceScvuapdE1";
+                };
+            };
+            readonly authorizationReason: {
+                readonly description: "Optional authorization rejection reason.";
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+            };
+            readonly authorizationRespondedAt: {
+                readonly description: "Timestamp of authorization decision response.";
+                readonly type: {
+                    readonly blueId: "GQaGqFxHDz64L1c9QkCbz52ths6bMVtpHnw4QDngzQYs";
+                };
+            };
+            readonly authorizationStatus: {
+                readonly description: "Authorization decision status (\"approved\" | \"rejected\").";
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+            };
+            readonly authorizedAmountMinor: {
+                readonly description: "Authorized amount reserved against mandate capacity for this attempt.";
+                readonly type: {
+                    readonly blueId: "5WNMiV9Knz63B4dVY5JtMyh3FB4FSGqv7ceScvuapdE1";
+                };
+            };
+            readonly capturedDeltaMinor: {
+                readonly description: "Captured delta applied for accepted settlement.";
+                readonly type: {
+                    readonly blueId: "5WNMiV9Knz63B4dVY5JtMyh3FB4FSGqv7ceScvuapdE1";
+                };
+            };
+            readonly chargeMode: {
+                readonly description: "Requested charge mode (\"authorize_only\" | \"authorize_and_capture\").";
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+            };
+            readonly counterpartyId: {
+                readonly description: "Counterparty identifier interpreted according to counterpartyType.";
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+            };
+            readonly counterpartyType: {
+                readonly description: "Counterparty identifier type (\"merchantId\" | \"customerId\" | \"accountNumber\").";
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+            };
+            readonly currency: {
+                readonly description: "Requested currency.";
+                readonly type: {
+                    readonly blueId: "CBnZ7aaNetj9KEqXpUWj5jvjKbmviLivP98T2EiyxiYc";
+                };
+            };
+            readonly holdId: {
+                readonly description: "Optional hold id associated with settlement.";
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+            };
+            readonly lastSettlementId: {
+                readonly description: "Optional last applied settlement id for idempotency tracking.";
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+            };
+            readonly lastSettlementProcessingStatus: {
+                readonly description: "Mandate processing status for last settlement (\"accepted\" | \"rejected\").";
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+            };
+            readonly lastSettlementRequestStatus: {
+                readonly description: "Last settlement request status received from bank (\"succeeded\" | \"failed\").";
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+            };
+            readonly reservedDeltaMinor: {
+                readonly description: "Reserved delta applied for accepted settlement.";
+                readonly type: {
+                    readonly blueId: "5WNMiV9Knz63B4dVY5JtMyh3FB4FSGqv7ceScvuapdE1";
+                };
+            };
+            readonly settled: {
+                readonly description: "Whether mandate accepted settlement for this attempt.";
+                readonly type: {
+                    readonly blueId: "4EzhSubEimSQD3zrYHRtobfPPWntUuhEz8YcdxHsi12u";
+                };
+            };
+            readonly settlementReason: {
+                readonly description: "Optional settlement rejection/info reason.";
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+            };
+            readonly settlementRespondedAt: {
+                readonly description: "Timestamp of last settlement processing response.";
+                readonly type: {
+                    readonly blueId: "GQaGqFxHDz64L1c9QkCbz52ths6bMVtpHnw4QDngzQYs";
+                };
+            };
+            readonly transactionId: {
+                readonly description: "Optional transaction id associated with settlement.";
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+            };
+        };
+    };
+    readonly contracts: {
+        readonly authorizeSpend: {
+            readonly channel: {
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+                readonly value: "guarantorChannel";
+            };
+            readonly description: "Validate a charge attempt against mandate policy and reserve capacity.";
+            readonly request: {
+                readonly type: {
+                    readonly blueId: "7EKvVzbT63C2taKWfLf9J2BiVL7BCL6Ld86tH8b9kmxF";
+                };
+            };
+            readonly type: {
+                readonly blueId: "BoAiqVUZv9Fum3wFqaX2JnQMBHJLxJSo2V9U2UBmCfsC";
+            };
+        };
+        readonly authorizeSpendImpl: {
+            readonly operation: {
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+                readonly value: "authorizeSpend";
+            };
+            readonly steps: {
+                readonly items: readonly [{
+                    readonly code: {
+                        readonly type: {
+                            readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                        };
+                        readonly value: "const documentCanonical = document.canonical('/');\nconst requestCanonical = eventCanonical\n  ? canon.at(eventCanonical, '/message/request')\n  : undefined;\n\nconst requestedAtNode = requestCanonical\n  ? canon.at(requestCanonical, '/requestedAt')\n  : undefined;\nconst requestedAtRaw = requestedAtNode ? canon.unwrap(requestedAtNode) : '';\nconst requestedAt = typeof requestedAtRaw === 'string' ? requestedAtRaw : '';\nconst nowIso =\n  requestedAt ||\n  (typeof event.timestamp === 'string' ? event.timestamp : '');\n\nconst normalizeTimestamp = function (value) {\n  if (typeof value !== 'string' || !value) {\n    return '';\n  }\n  let digits = '';\n  let index = 0;\n  while (index < value.length) {\n    const code = value.charCodeAt(index);\n    if (code >= 48 && code <= 57) {\n      digits += value.charAt(index);\n    }\n    index += 1;\n  }\n  if (digits.length < 14) {\n    return '';\n  }\n  return digits.slice(0, 14);\n};\n\nconst authorizationIdNode = requestCanonical\n  ? canon.at(requestCanonical, '/authorizationId')\n  : undefined;\nconst authorizationIdRaw = authorizationIdNode\n  ? canon.unwrap(authorizationIdNode)\n  : '';\nconst authorizationId =\n  typeof authorizationIdRaw === 'string' ? authorizationIdRaw : '';\n\nconst amountMinorNode = requestCanonical\n  ? canon.at(requestCanonical, '/amountMinor')\n  : undefined;\nconst amountMinorRaw = amountMinorNode ? canon.unwrap(amountMinorNode) : 0;\nconst amountMinor = typeof amountMinorRaw === 'number' ? amountMinorRaw : 0;\n\nconst counterpartyTypeNode = requestCanonical\n  ? canon.at(requestCanonical, '/counterpartyType')\n  : undefined;\nconst counterpartyTypeRaw = counterpartyTypeNode\n  ? canon.unwrap(counterpartyTypeNode)\n  : '';\nconst counterpartyType =\n  typeof counterpartyTypeRaw === 'string' ? counterpartyTypeRaw : '';\n\nconst counterpartyIdNode = requestCanonical\n  ? canon.at(requestCanonical, '/counterpartyId')\n  : undefined;\nconst counterpartyIdRaw = counterpartyIdNode\n  ? canon.unwrap(counterpartyIdNode)\n  : '';\nconst counterpartyId =\n  typeof counterpartyIdRaw === 'string' ? counterpartyIdRaw : '';\n\nconst requestedCurrencyNode = requestCanonical\n  ? canon.at(requestCanonical, '/currency')\n  : undefined;\nconst requestedCurrencyRaw = requestedCurrencyNode\n  ? canon.unwrap(requestedCurrencyNode)\n  : '';\nconst requestedCurrency =\n  typeof requestedCurrencyRaw === 'string' ? requestedCurrencyRaw : '';\n\nconst chargeAttemptsNode = canon.at(documentCanonical, '/chargeAttempts');\nconst chargeAttemptsRaw = chargeAttemptsNode\n  ? canon.unwrap(chargeAttemptsNode)\n  : {};\nconst chargeAttempts =\n  chargeAttemptsRaw &&\n  typeof chargeAttemptsRaw === 'object' &&\n  !Array.isArray(chargeAttemptsRaw)\n    ? chargeAttemptsRaw\n    : {};\nconst nextChargeAttempts = { ...chargeAttempts };\n\nconst existingAttemptRaw = authorizationId\n  ? chargeAttempts[authorizationId]\n  : undefined;\nconst existingAttempt =\n  existingAttemptRaw &&\n  typeof existingAttemptRaw === 'object' &&\n  !Array.isArray(existingAttemptRaw)\n    ? existingAttemptRaw\n    : null;\nconst existingDecision =\n  existingAttempt &&\n  typeof existingAttempt.authorizationStatus === 'string'\n    ? existingAttempt.authorizationStatus\n    : '';\nconst existingReason =\n  existingAttempt && typeof existingAttempt.authorizationReason === 'string'\n    ? existingAttempt.authorizationReason\n    : '';\n\nconst amountLimitNode = canon.at(documentCanonical, '/amountLimit');\nconst amountLimitRaw = amountLimitNode ? canon.unwrap(amountLimitNode) : 0;\nconst amountLimit = typeof amountLimitRaw === 'number' ? amountLimitRaw : 0;\n\nconst amountReservedNode = canon.at(documentCanonical, '/amountReserved');\nconst amountReservedRaw = amountReservedNode\n  ? canon.unwrap(amountReservedNode)\n  : 0;\nconst amountReserved =\n  typeof amountReservedRaw === 'number' ? amountReservedRaw : 0;\n\nconst amountCapturedNode = canon.at(documentCanonical, '/amountCaptured');\nconst amountCapturedRaw = amountCapturedNode\n  ? canon.unwrap(amountCapturedNode)\n  : 0;\nconst amountCaptured =\n  typeof amountCapturedRaw === 'number' ? amountCapturedRaw : 0;\n\nconst mandateCurrencyNode = canon.at(documentCanonical, '/currency');\nconst mandateCurrencyRaw = mandateCurrencyNode\n  ? canon.unwrap(mandateCurrencyNode)\n  : '';\nconst mandateCurrency =\n  typeof mandateCurrencyRaw === 'string' ? mandateCurrencyRaw : '';\n\nconst expiresAtNode = canon.at(documentCanonical, '/expiresAt');\nconst expiresAtRaw = expiresAtNode ? canon.unwrap(expiresAtNode) : '';\nconst expiresAt = typeof expiresAtRaw === 'string' ? expiresAtRaw : '';\n\nconst revokedAtNode = canon.at(documentCanonical, '/revokedAt');\nconst revokedAtRaw = revokedAtNode ? canon.unwrap(revokedAtNode) : '';\nconst revokedAt = typeof revokedAtRaw === 'string' ? revokedAtRaw : '';\n\nconst nowComparable = normalizeTimestamp(nowIso);\n\nconst allowedCounterpartiesNode = canon.at(\n  documentCanonical,\n  '/allowedPaymentCounterparties'\n);\nconst allowedCounterpartiesRaw = allowedCounterpartiesNode\n  ? canon.unwrap(allowedCounterpartiesNode)\n  : [];\nconst allowedCounterparties = Array.isArray(allowedCounterpartiesRaw)\n  ? allowedCounterpartiesRaw\n  : [];\nconst isCounterpartyAllowed =\n  allowedCounterparties.length === 0 ||\n  allowedCounterparties.some(function (item) {\n    const itemType =\n      item && typeof item.counterpartyType === 'string'\n        ? item.counterpartyType\n        : '';\n    const itemId =\n      item && typeof item.counterpartyId === 'string'\n        ? item.counterpartyId\n        : '';\n    return (\n      item &&\n      itemType === counterpartyType &&\n      itemId === counterpartyId\n    );\n  });\n\nlet status = 'rejected';\nlet reason = '';\nlet nextAmountReserved = amountReserved;\n\nif (existingDecision === 'approved' || existingDecision === 'rejected') {\n  status = existingDecision;\n  reason = existingDecision === 'rejected' ? existingReason : '';\n} else if (!authorizationId) {\n  reason = 'Missing authorizationId.';\n} else if (amountMinor <= 0) {\n  reason = 'Amount must be greater than zero.';\n} else if (!requestedCurrency || requestedCurrency !== mandateCurrency) {\n  reason = 'Currency does not match mandate currency.';\n} else if (revokedAt) {\n  reason = 'Mandate is revoked.';\n} else if (\n  expiresAt &&\n  normalizeTimestamp(expiresAt) &&\n  nowComparable &&\n  normalizeTimestamp(expiresAt) < nowComparable\n) {\n  reason = 'Mandate is expired.';\n} else if (!isCounterpartyAllowed) {\n  reason = 'Counterparty is not allowed by mandate.';\n} else if (amountReserved + amountCaptured + amountMinor > amountLimit) {\n  reason = 'Mandate amount limit exceeded.';\n} else {\n  status = 'approved';\n  nextAmountReserved = amountReserved + amountMinor;\n}\n\nif (authorizationId && !existingDecision) {\n  const chargeModeNode = requestCanonical\n    ? canon.at(requestCanonical, '/chargeMode')\n    : undefined;\n  const chargeModeRaw = chargeModeNode ? canon.unwrap(chargeModeNode) : '';\n  const chargeMode = typeof chargeModeRaw === 'string' ? chargeModeRaw : '';\n\n  nextChargeAttempts[authorizationId] = {\n    amountMinor,\n    currency: requestedCurrency,\n    counterpartyType,\n    counterpartyId,\n    chargeMode,\n    authorizationStatus: status,\n    authorizationReason: reason,\n    authorizationRespondedAt: nowIso,\n    authorizedAmountMinor: status === 'approved' ? amountMinor : 0,\n    settled: false,\n    lastSettlementRequestStatus: '',\n    lastSettlementProcessingStatus: '',\n    settlementReason: '',\n    settlementRespondedAt: '',\n    reservedDeltaMinor: 0,\n    capturedDeltaMinor: 0,\n    holdId: '',\n    transactionId: ''\n  };\n}\n\nconst remainingAmountMinor = Math.max(\n  0,\n  amountLimit - (nextAmountReserved + amountCaptured)\n);\n\nconst responseEvent = {\n  type: 'PayNote/Payment Mandate Spend Authorization Responded',\n  authorizationId,\n  status,\n  remainingAmountMinor,\n  respondedAt: nowIso\n};\n\nif (reason) {\n  responseEvent.reason = reason;\n}\n\nreturn {\n  nextChargeAttempts: nextChargeAttempts,\n  nextAmountReserved: nextAmountReserved,\n  events: [responseEvent]\n};\n";
+                    };
+                    readonly name: "Decide Spend Authorization";
+                    readonly type: {
+                        readonly blueId: "ExZxT61PSpWHpEAtP2WKMXXqxEYN7Z13j7Zv36Dp99kS";
+                    };
+                }, {
+                    readonly changeset: {
+                        readonly items: readonly [{
+                            readonly op: {
+                                readonly type: {
+                                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                                };
+                                readonly value: "replace";
+                            };
+                            readonly path: {
+                                readonly type: {
+                                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                                };
+                                readonly value: "/chargeAttempts";
+                            };
+                            readonly val: {
+                                readonly type: {
+                                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                                };
+                                readonly value: "${steps['Decide Spend Authorization'].nextChargeAttempts}";
+                            };
+                        }, {
+                            readonly op: {
+                                readonly type: {
+                                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                                };
+                                readonly value: "replace";
+                            };
+                            readonly path: {
+                                readonly type: {
+                                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                                };
+                                readonly value: "/amountReserved";
+                            };
+                            readonly val: {
+                                readonly type: {
+                                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                                };
+                                readonly value: "${steps['Decide Spend Authorization'].nextAmountReserved}";
+                            };
+                        }];
+                    };
+                    readonly name: "Persist Authorization Decision";
+                    readonly type: {
+                        readonly blueId: "FtHZJzH4hqAoGxFBjsmy1svfT4BwEBB4aHpFSZycZLLa";
+                    };
+                }];
+            };
+            readonly type: {
+                readonly blueId: "CGdxkNjPcsdescqLPz6SNLsMyak6demQQr7RoKNHbCyv";
+            };
+        };
+        readonly granteeChannel: {
+            readonly description: "Grantee timeline channel (party allowed to use the mandate).";
+            readonly type: {
+                readonly blueId: "HCF8mXnX3dFjQ8osjxb4Wzm2Nm1DoXnTYuA5sPnV7NTs";
+            };
+        };
+        readonly granterChannel: {
+            readonly description: "Granting party timeline channel.";
+            readonly type: {
+                readonly blueId: "HCF8mXnX3dFjQ8osjxb4Wzm2Nm1DoXnTYuA5sPnV7NTs";
+            };
+        };
+        readonly guarantorChannel: {
+            readonly description: "Bank/admin channel executing mandate checks and settlement updates.";
+            readonly type: {
+                readonly blueId: "HCF8mXnX3dFjQ8osjxb4Wzm2Nm1DoXnTYuA5sPnV7NTs";
+            };
+        };
+        readonly initialize: {
+            readonly channel: {
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+                readonly value: "initLifecycleChannel";
+            };
+            readonly steps: {
+                readonly items: readonly [{
+                    readonly changeset: {
+                        readonly items: readonly [{
+                            readonly op: {
+                                readonly type: {
+                                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                                };
+                                readonly value: "replace";
+                            };
+                            readonly path: {
+                                readonly type: {
+                                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                                };
+                                readonly value: "/chargeAttempts";
+                            };
+                            readonly val: {};
+                        }];
+                    };
+                    readonly name: "Initialize mandate runtime state";
+                    readonly type: {
+                        readonly blueId: "FtHZJzH4hqAoGxFBjsmy1svfT4BwEBB4aHpFSZycZLLa";
+                    };
+                }];
+            };
+            readonly type: {
+                readonly blueId: "7X3LkN54Yp88JgZbppPhP6hM3Jqiqv8Z2i4kS7phXtQe";
+            };
+        };
+        readonly initLifecycleChannel: {
+            readonly event: {
+                readonly type: {
+                    readonly blueId: "BrpmpNt5JkapeUvPqYcxgXZrHNZX3R757dRwuXXdfNM2";
+                };
+            };
+            readonly type: {
+                readonly blueId: "H2aCCTUcLMTJozWkn7HPUjyFBFxamraw1q8DyWk87zxr";
+            };
+        };
+        readonly settleSpend: {
+            readonly channel: {
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+                readonly value: "guarantorChannel";
+            };
+            readonly description: "Apply final reserve/capture deltas for a previously authorized charge attempt.";
+            readonly request: {
+                readonly type: {
+                    readonly blueId: "6aPqmL9AQV31CCV576ZmEcUgysbdbQAfAig9J5VYeR6v";
+                };
+            };
+            readonly type: {
+                readonly blueId: "BoAiqVUZv9Fum3wFqaX2JnQMBHJLxJSo2V9U2UBmCfsC";
+            };
+        };
+        readonly settleSpendImpl: {
+            readonly operation: {
+                readonly type: {
+                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                };
+                readonly value: "settleSpend";
+            };
+            readonly steps: {
+                readonly items: readonly [{
+                    readonly code: {
+                        readonly type: {
+                            readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                        };
+                        readonly value: "const documentCanonical = document.canonical('/');\nconst requestCanonical = eventCanonical\n  ? canon.at(eventCanonical, '/message/request')\n  : undefined;\n\nconst settledAtNode = requestCanonical\n  ? canon.at(requestCanonical, '/settledAt')\n  : undefined;\nconst settledAtRaw = settledAtNode ? canon.unwrap(settledAtNode) : '';\nconst settledAt = typeof settledAtRaw === 'string' ? settledAtRaw : '';\nconst nowIso =\n  settledAt || (typeof event.timestamp === 'string' ? event.timestamp : '');\n\nconst authorizationIdNode = requestCanonical\n  ? canon.at(requestCanonical, '/authorizationId')\n  : undefined;\nconst authorizationIdRaw = authorizationIdNode\n  ? canon.unwrap(authorizationIdNode)\n  : '';\nconst authorizationId =\n  typeof authorizationIdRaw === 'string' ? authorizationIdRaw : '';\n\nconst settlementStatusNode = requestCanonical\n  ? canon.at(requestCanonical, '/status')\n  : undefined;\nconst settlementStatusRaw = settlementStatusNode\n  ? canon.unwrap(settlementStatusNode)\n  : '';\nconst settlementStatus =\n  typeof settlementStatusRaw === 'string' ? settlementStatusRaw : '';\n\nconst reservedDeltaNode = requestCanonical\n  ? canon.at(requestCanonical, '/reservedDeltaMinor')\n  : undefined;\nconst reservedDeltaRaw = reservedDeltaNode ? canon.unwrap(reservedDeltaNode) : 0;\nconst reservedDeltaMinor =\n  typeof reservedDeltaRaw === 'number' ? reservedDeltaRaw : 0;\n\nconst capturedDeltaNode = requestCanonical\n  ? canon.at(requestCanonical, '/capturedDeltaMinor')\n  : undefined;\nconst capturedDeltaRaw = capturedDeltaNode ? canon.unwrap(capturedDeltaNode) : 0;\nconst capturedDeltaMinor =\n  typeof capturedDeltaRaw === 'number' ? capturedDeltaRaw : 0;\n\nconst amountLimitNode = canon.at(documentCanonical, '/amountLimit');\nconst amountLimitRaw = amountLimitNode ? canon.unwrap(amountLimitNode) : 0;\nconst amountLimit = typeof amountLimitRaw === 'number' ? amountLimitRaw : 0;\n\nconst amountReservedNode = canon.at(documentCanonical, '/amountReserved');\nconst amountReservedRaw = amountReservedNode\n  ? canon.unwrap(amountReservedNode)\n  : 0;\nconst amountReserved =\n  typeof amountReservedRaw === 'number' ? amountReservedRaw : 0;\n\nconst amountCapturedNode = canon.at(documentCanonical, '/amountCaptured');\nconst amountCapturedRaw = amountCapturedNode\n  ? canon.unwrap(amountCapturedNode)\n  : 0;\nconst amountCaptured =\n  typeof amountCapturedRaw === 'number' ? amountCapturedRaw : 0;\n\nconst chargeAttemptsNode = canon.at(documentCanonical, '/chargeAttempts');\nconst chargeAttemptsRaw = chargeAttemptsNode\n  ? canon.unwrap(chargeAttemptsNode)\n  : {};\nconst chargeAttempts =\n  chargeAttemptsRaw &&\n  typeof chargeAttemptsRaw === 'object' &&\n  !Array.isArray(chargeAttemptsRaw)\n    ? chargeAttemptsRaw\n    : {};\nconst nextChargeAttempts = { ...chargeAttempts };\n\nconst existingAttemptRaw = authorizationId\n  ? chargeAttempts[authorizationId]\n  : undefined;\nconst existingAttempt =\n  existingAttemptRaw &&\n  typeof existingAttemptRaw === 'object' &&\n  !Array.isArray(existingAttemptRaw)\n    ? existingAttemptRaw\n    : null;\n\nconst alreadySettled = !!existingAttempt && existingAttempt.settled === true;\nconst approved =\n  !!existingAttempt &&\n  typeof existingAttempt.authorizationStatus === 'string' &&\n  existingAttempt.authorizationStatus === 'approved';\nconst authorizedAmount =\n  existingAttempt && typeof existingAttempt.authorizedAmountMinor === 'number'\n    ? existingAttempt.authorizedAmountMinor\n    : 0;\n\nconst holdIdNode = requestCanonical\n  ? canon.at(requestCanonical, '/holdId')\n  : undefined;\nconst holdIdRaw = holdIdNode ? canon.unwrap(holdIdNode) : '';\nconst holdId = typeof holdIdRaw === 'string' ? holdIdRaw : '';\n\nconst transactionIdNode = requestCanonical\n  ? canon.at(requestCanonical, '/transactionId')\n  : undefined;\nconst transactionIdRaw = transactionIdNode\n  ? canon.unwrap(transactionIdNode)\n  : '';\nconst transactionId =\n  typeof transactionIdRaw === 'string' ? transactionIdRaw : '';\n\nconst settlementIdNode = requestCanonical\n  ? canon.at(requestCanonical, '/settlementId')\n  : undefined;\nconst settlementIdRaw = settlementIdNode\n  ? canon.unwrap(settlementIdNode)\n  : '';\nconst settlementId =\n  typeof settlementIdRaw === 'string' ? settlementIdRaw : '';\n\nconst requestReasonNode = requestCanonical\n  ? canon.at(requestCanonical, '/reason')\n  : undefined;\nconst requestReasonRaw = requestReasonNode\n  ? canon.unwrap(requestReasonNode)\n  : '';\nconst requestReason =\n  typeof requestReasonRaw === 'string' ? requestReasonRaw : '';\n\nlet status = 'rejected';\nlet reason = '';\nlet nextAmountReserved = amountReserved;\nlet nextAmountCaptured = amountCaptured;\nlet nextAttempt = existingAttempt ? { ...existingAttempt } : null;\n\nif (!authorizationId) {\n  reason = 'Missing authorizationId.';\n} else if (alreadySettled) {\n  status = 'accepted';\n  reason = 'Authorization already settled.';\n} else if (!approved) {\n  reason = 'Authorization is not approved.';\n} else if (\n  settlementStatus !== 'succeeded' &&\n  settlementStatus !== 'failed'\n) {\n  reason = 'Unsupported settlement status.';\n} else if (capturedDeltaMinor < 0) {\n  reason = 'capturedDeltaMinor cannot be negative.';\n} else if (\n  settlementStatus === 'failed' &&\n  capturedDeltaMinor !== 0\n) {\n  reason = 'capturedDeltaMinor must be 0 for failed settlement.';\n} else if (capturedDeltaMinor > authorizedAmount) {\n  reason = 'capturedDeltaMinor exceeds authorized amount.';\n} else {\n  const candidateAmountReserved = amountReserved + reservedDeltaMinor;\n  const candidateAmountCaptured = amountCaptured + capturedDeltaMinor;\n  const candidateUsed = candidateAmountReserved + candidateAmountCaptured;\n\n  if (candidateAmountReserved < 0) {\n    reason = 'Settlement would make amountReserved negative.';\n  } else if (candidateAmountCaptured < 0) {\n    reason = 'Settlement would make amountCaptured negative.';\n  } else if (candidateUsed > amountLimit) {\n    reason = 'Settlement would exceed amountLimit.';\n  } else {\n    status = 'accepted';\n    nextAmountReserved = candidateAmountReserved;\n    nextAmountCaptured = candidateAmountCaptured;\n    nextAttempt = { ...existingAttempt };\n    nextAttempt.settled = true;\n    nextAttempt.lastSettlementRequestStatus = settlementStatus;\n    nextAttempt.lastSettlementProcessingStatus = 'accepted';\n    nextAttempt.settlementReason = requestReason;\n    nextAttempt.settlementRespondedAt = nowIso;\n    nextAttempt.reservedDeltaMinor = reservedDeltaMinor;\n    nextAttempt.capturedDeltaMinor = capturedDeltaMinor;\n    nextAttempt.holdId = holdId;\n    nextAttempt.transactionId = transactionId;\n    nextAttempt.lastSettlementId = settlementId;\n    nextChargeAttempts[authorizationId] = nextAttempt;\n  }\n}\n\nif (nextAttempt && status === 'rejected') {\n  nextAttempt = { ...nextAttempt };\n  nextAttempt.lastSettlementRequestStatus = settlementStatus;\n  nextAttempt.lastSettlementProcessingStatus = 'rejected';\n  nextAttempt.settlementReason = reason;\n  nextAttempt.settlementRespondedAt = nowIso;\n  nextAttempt.lastSettlementId = settlementId;\n  nextChargeAttempts[authorizationId] = nextAttempt;\n}\n\nconst responseEvent = {\n  type: 'PayNote/Payment Mandate Spend Settlement Responded',\n  authorizationId,\n  settlementId,\n  status,\n  amountReserved: nextAmountReserved,\n  amountCaptured: nextAmountCaptured,\n  respondedAt: nowIso\n};\n\nif (reason) {\n  responseEvent.reason = reason;\n}\n\nreturn {\n  nextChargeAttempts: nextChargeAttempts,\n  nextAmountReserved: nextAmountReserved,\n  nextAmountCaptured: nextAmountCaptured,\n  events: [responseEvent]\n};\n";
+                    };
+                    readonly name: "Validate and Apply Settlement";
+                    readonly type: {
+                        readonly blueId: "ExZxT61PSpWHpEAtP2WKMXXqxEYN7Z13j7Zv36Dp99kS";
+                    };
+                }, {
+                    readonly changeset: {
+                        readonly items: readonly [{
+                            readonly op: {
+                                readonly type: {
+                                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                                };
+                                readonly value: "replace";
+                            };
+                            readonly path: {
+                                readonly type: {
+                                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                                };
+                                readonly value: "/chargeAttempts";
+                            };
+                            readonly val: {
+                                readonly type: {
+                                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                                };
+                                readonly value: "${steps['Validate and Apply Settlement'].nextChargeAttempts}";
+                            };
+                        }, {
+                            readonly op: {
+                                readonly type: {
+                                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                                };
+                                readonly value: "replace";
+                            };
+                            readonly path: {
+                                readonly type: {
+                                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                                };
+                                readonly value: "/amountReserved";
+                            };
+                            readonly val: {
+                                readonly type: {
+                                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                                };
+                                readonly value: "${steps['Validate and Apply Settlement'].nextAmountReserved}";
+                            };
+                        }, {
+                            readonly op: {
+                                readonly type: {
+                                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                                };
+                                readonly value: "replace";
+                            };
+                            readonly path: {
+                                readonly type: {
+                                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                                };
+                                readonly value: "/amountCaptured";
+                            };
+                            readonly val: {
+                                readonly type: {
+                                    readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+                                };
+                                readonly value: "${steps['Validate and Apply Settlement'].nextAmountCaptured}";
+                            };
+                        }];
+                    };
+                    readonly name: "Persist Settlement";
+                    readonly type: {
+                        readonly blueId: "FtHZJzH4hqAoGxFBjsmy1svfT4BwEBB4aHpFSZycZLLa";
+                    };
+                }];
+            };
+            readonly type: {
+                readonly blueId: "CGdxkNjPcsdescqLPz6SNLsMyak6demQQr7RoKNHbCyv";
+            };
+        };
+    };
+    readonly currency: {
+        readonly description: "Currency code used for amountLimit validation.";
+        readonly type: {
+            readonly blueId: "CBnZ7aaNetj9KEqXpUWj5jvjKbmviLivP98T2EiyxiYc";
+        };
+    };
+    readonly description: "Payment mandate authorizing a grantee to execute payment requests on behalf of a granter, under explicit limits, with deterministic spend tracking and optional linked PayNote bootstrap rules.\n";
+    readonly expiresAt: {
+        readonly description: "Optional mandate expiry timestamp.";
+        readonly type: {
+            readonly blueId: "GQaGqFxHDz64L1c9QkCbz52ths6bMVtpHnw4QDngzQYs";
+        };
+    };
+    readonly granteeId: {
+        readonly description: "Identifier interpreted according to granteeType.";
+        readonly type: {
+            readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+        };
+    };
+    readonly granteeType: {
+        readonly description: "Party allowed to invoke this mandate:\n- documentId\n- merchantId\n- customerId\n";
+        readonly type: {
+            readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+        };
+    };
+    readonly granterId: {
+        readonly description: "Identifier of the granting party:\n- merchantId when granterType is merchant\n- customerId (bank user id) when granterType is customer\n";
+        readonly type: {
+            readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+        };
+    };
+    readonly granterType: {
+        readonly description: "Party granting authority to use funds:\n- merchant\n- customer\n";
+        readonly type: {
+            readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+        };
+    };
+    readonly name: "Payment Mandate";
+    readonly revokedAt: {
+        readonly description: "Optional revocation timestamp. When set, mandate is inactive.";
+        readonly type: {
+            readonly blueId: "GQaGqFxHDz64L1c9QkCbz52ths6bMVtpHnw4QDngzQYs";
+        };
+    };
+    readonly sourceAccount: {
+        readonly description: "Funds source to use when this mandate executes: - root (uses root account context; for merchant this maps to active credit line) - specific account number\n";
+        readonly type: {
+            readonly blueId: "DLRQwz7MQeCrzjy9bohPNwtCxKEBbKaMK65KBrwjfG6K";
+        };
+    };
+};
+//# sourceMappingURL=PaymentMandate.d.ts.map

package/dist/packages/paynote/contents/PaymentMandate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaymentMandate.d.ts","sourceRoot":"","sources":["../../../../src/packages/paynote/contents/PaymentMandate.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyiBjB,CAAC"}