@orvello/sdk 0.4.0 → 0.5.0

package/CONTRACT_SHA256

@@ -1 +1 @@
-c3f121a094268542856384510d880bbd65a13b5b242c38e017ad5f622e3b30e2
+02a65db9ad216d195f560a2e4f7cdd7a19a38814362b4c89551188796b017768

package/README.md

@@ -426,3 +426,13 @@ reference and recipient. The amount is a decimal string. Existing invoices witho
 snapshot return HTTP 409; the SDK does not invent instructions. This read is not payment
 evidence and must not trigger provisioning. Use `getPaymentEvidence` for bank coverage.
 The matching Bills endpoint and schema must be deployed before using this operation.
+
+### Replay bank payment evidence events
+
+`client.invoices.getPaymentEvents(invoiceId, { afterVersion: 0, limit: 50 })`
+returns durable events ordered by per-invoice `version`, plus `nextVersion` and
+`hasMore`. Store the cursor atomically with inbox processing, deduplicate by event
+UUID and reject unknown schema versions. Replay does not acknowledge/delete events.
+Re-read `getPaymentEvidence(invoiceId)` before acting on historical coverage.
+A later event can revoke it. Invoices without frozen instructions are not enrolled.
+Available with Bills payment-event journal migration 0041 and the matching API deployment.

package/dist/contract.cjs

@@ -3876,6 +3876,19 @@ var apiRoutes_invoices = {
 
 // src/generated/api/features/routes.invoices_external.ts
 var apiRoutes_invoices_external = {
+  // Contract source: explicit
+  "invoices_payment_events_external": {
+    method: "GET",
+    path: "/invoices/external/:invoiceId/payment-events",
+    auth: { "type": "unified_bearer", "allowUserSession": false, "allowOAuth2": true, "allowApiKey": true, "requireRole": "viewer", "scopes": ["invoices:read"] },
+    meta: {
+      tags: ["invoices-external"],
+      summary: "Replay durable bank payment evidence events",
+      description: "Per-invoice ordered journal, afterVersion exclusive. Replay does not acknowledge or delete events. Consumers persist their cursor atomically with processing and re-read current payment evidence before commerce actions. Historical invoices without frozen instructions are not enrolled. No global cursor or delivery-order promise across invoices.",
+      validated: { "params": true, "query": true, "body": false }
+    },
+    types: null
+  },
   // Contract source: explicit
   "invoices_payment_evidence_external": {
     method: "GET",