@ingenx-io/valets-schema-mcp-server 0.2.6 → 0.2.8

package/data/docs/collections/firestore-paths.md

@@ -94,6 +94,26 @@ Orders live at the existing company-scoped path `companies/{companyId}/orders/{o
 - **Composite index:** `(companyId, appId, createdAt)` for per-site recency queries.
 - **Physical relocation** of Order under `apps/{appId}/orders/` is explicitly deferred (ADR-004, not approved).
 
+## Payment webhooks — top-level collections (GH#41 / GH#42)
+
+Both collections are **top-level** (not tenant-scoped). The backend resolves an endpoint by the unguessable `token` path segment before the company is known.
+
+```
+payment_webhook_endpoints/{token}    ← GH#41 — provisioned endpoint; token = base64url 24 random bytes
+payment_webhooks/{deliveryId}        ← GH#42 — received delivery log; one doc per provider callback
+```
+
+| Collection | Doc ID | Writer | Notes |
+|---|---|---|---|
+| `payment_webhook_endpoints` | `{token}` (base64url 24 bytes) | Superadmin / dashboard provisioning | `x-internal`. Backend caches lookups ~60s. `secret` = provider HMAC signing secret (plaintext today — KMS tracked in #42). |
+| `payment_webhooks` | auto | Backend (webhook receiver) | `x-internal`. Raw payload + verification outcome. `processed` flips when reconciled to AppPayment ledger. PII in `payload`/`rawBody` (customer phone) — retention/TTL TBD (#42). |
+
+**Public webhook URL pattern** (handed to operators): `https://backend.valets.app/payments/<provider>/webhook/<token>`
+
+:::caution PII and retention (#42)
+`payment_webhooks.payload` stores customer phone numbers (`counterpartIdentifier`, `counterpartLabel`). `payment_webhooks.rawBody` contains the same PII. `payment_webhook_endpoints.secret` is stored as plaintext. A retention/TTL policy and KMS encryption plan for secrets are not yet defined — tracked in [#42](https://github.com/IngenX-IO/valets-data-architecture/issues/42).
+:::
+
 ## WhatsApp messaging — top-level collections (GH#36 / GH#43)
 
 WhatsApp message collections are **top-level**, not under `companies/{companyId}/`: company context is not known at message time (a webhook arrives before the sender is resolved to a company). They form the symmetric inbound/outbound pair the dashboard renders as a conversation thread.

package/data/docs/enums/app-status.md

@@ -21,4 +21,4 @@ Must be one of:
 * "ARCHIVED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:44 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/attention-status.md

@@ -21,4 +21,4 @@ Must be one of:
 * "ESCALATED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/booking-status.md

@@ -23,4 +23,4 @@ Must be one of:
 * "COMPLETED_MIXED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/contract-status.md

@@ -21,4 +21,4 @@ Must be one of:
 * "TERMINATED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/customer-payment-status.md

@@ -23,4 +23,4 @@ Must be one of:
 * "CANCELLED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/customer-payment-target-type.md

@@ -20,4 +20,4 @@ Must be one of:
 * "PURCHASE"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/delivery-type.md

@@ -20,4 +20,4 @@ Must be one of:
 * "DELIVERY"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/deployment-link-type.md

@@ -23,4 +23,4 @@ Must be one of:
 * "other"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/event-status.md

@@ -21,7 +21,7 @@ Must be one of:
 * "COMPLETED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000
 
 ## Related Decisions
 

package/data/docs/enums/expense-payment-status.md

@@ -0,0 +1,24 @@
+---
+title: "ExpensePaymentStatus"
+sidebar_label: "ExpensePaymentStatus"
+sidebar_position: 10
+---
+
+# ExpensePaymentStatus
+
+|                |                                      |
+| -------------- | ------------------------------------ |
+| **Type**       | `enum (of string)`                   |
+| **Required**   | No                                   |
+| **Defined in** | #/definitions/expense-payment-status |
+
+**Description:** Payment status of an Expense. Stored enum — OVERDUE is not stored, it is derived at read time from dueDate (#13).
+
+Must be one of:
+* "PENDING"
+* "PARTIALLY_PAID"
+* "PAID"
+* "FAILED"
+
+----------------------------------------------------------------------------------------------------------------------------
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/fulfillment-status.md

@@ -1,7 +1,7 @@
 ---
 title: "FulfillmentStatus"
 sidebar_label: "FulfillmentStatus"
-sidebar_position: 10
+sidebar_position: 11
 ---
 
 # FulfillmentStatus
@@ -23,7 +23,7 @@ Must be one of:
 * "PICKED_UP"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000
 
 ## Related Decisions
 

package/data/docs/enums/loyalty-transaction-type.md

@@ -1,7 +1,7 @@
 ---
 title: "LoyaltyTransactionType"
 sidebar_label: "LoyaltyTransactionType"
-sidebar_position: 11
+sidebar_position: 12
 ---
 
 # LoyaltyTransactionType
@@ -23,7 +23,7 @@ Must be one of:
 * "REFUND"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000
 
 ## Related Decisions
 

package/data/docs/enums/milestone-status.md

@@ -1,7 +1,7 @@
 ---
 title: "MilestoneStatus"
 sidebar_label: "MilestoneStatus"
-sidebar_position: 12
+sidebar_position: 13
 ---
 
 # MilestoneStatus
@@ -20,4 +20,4 @@ Must be one of:
 * "PAID"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/notification-channel.md

@@ -1,7 +1,7 @@
 ---
 title: "NotificationChannel"
 sidebar_label: "NotificationChannel"
-sidebar_position: 13
+sidebar_position: 14
 ---
 
 # NotificationChannel
@@ -21,4 +21,4 @@ Must be one of:
 * "push"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/notification-entity-type.md

@@ -1,7 +1,7 @@
 ---
 title: "NotificationEntityType"
 sidebar_label: "NotificationEntityType"
-sidebar_position: 14
+sidebar_position: 15
 ---
 
 # NotificationEntityType
@@ -23,4 +23,4 @@ Must be one of:
 * "other"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/notification-status.md

@@ -1,7 +1,7 @@
 ---
 title: "NotificationStatus"
 sidebar_label: "NotificationStatus"
-sidebar_position: 15
+sidebar_position: 16
 ---
 
 # NotificationStatus
@@ -20,4 +20,4 @@ Must be one of:
 * "pending"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/order-status.md

@@ -1,7 +1,7 @@
 ---
 title: "OrderStatus"
 sidebar_label: "OrderStatus"
-sidebar_position: 16
+sidebar_position: 17
 ---
 
 # OrderStatus
@@ -24,7 +24,7 @@ Must be one of:
 * "EXPIRED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000
 
 ## Related Decisions
 

package/data/docs/enums/outbound-message-format.md

@@ -1,7 +1,7 @@
 ---
 title: "OutboundMessageFormat"
 sidebar_label: "OutboundMessageFormat"
-sidebar_position: 17
+sidebar_position: 18
 ---
 
 # OutboundMessageFormat
@@ -19,4 +19,4 @@ Must be one of:
 * "template"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/outbound-message-purpose.md

@@ -1,7 +1,7 @@
 ---
 title: "OutboundMessagePurpose"
 sidebar_label: "OutboundMessagePurpose"
-sidebar_position: 18
+sidebar_position: 19
 ---
 
 # OutboundMessagePurpose
@@ -21,4 +21,4 @@ Must be one of:
 * "conversational"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/outbound-message-status.md

@@ -1,7 +1,7 @@
 ---
 title: "OutboundMessageStatus"
 sidebar_label: "OutboundMessageStatus"
-sidebar_position: 19
+sidebar_position: 20
 ---
 
 # OutboundMessageStatus
@@ -22,4 +22,4 @@ Must be one of:
 * "failed"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/payment-method.md

@@ -1,7 +1,7 @@
 ---
 title: "PaymentMethod"
 sidebar_label: "PaymentMethod"
-sidebar_position: 20
+sidebar_position: 21
 ---
 
 # PaymentMethod
@@ -12,7 +12,7 @@ sidebar_position: 20
 | **Required**   | No                           |
 | **Defined in** | #/definitions/payment-method |
 
-**Description:** Unified payment method set with African + global methods (D02).
+**Description:** Unified payment method set with African + global methods (D02). Note: the metrics writer historically emits "OM" instead of "ORANGE_MONEY" as a paymentsByMethod map key — treat OM as deprecated; canonical value is ORANGE_MONEY (#21).
 
 Must be one of:
 * "CASH"
@@ -25,9 +25,10 @@ Must be one of:
 * "PAYPAL"
 * "STRIPE"
 * "OTHER"
+* "OM"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000
 
 ## Related Decisions
 

package/data/docs/enums/payment-proof-status.md

@@ -1,7 +1,7 @@
 ---
 title: "PaymentProofStatus"
 sidebar_label: "PaymentProofStatus"
-sidebar_position: 21
+sidebar_position: 22
 ---
 
 # PaymentProofStatus
@@ -20,4 +20,4 @@ Must be one of:
 * "REJECTED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/payment-status.md

@@ -1,7 +1,7 @@
 ---
 title: "PaymentStatus"
 sidebar_label: "PaymentStatus"
-sidebar_position: 22
+sidebar_position: 23
 ---
 
 # PaymentStatus
@@ -24,7 +24,7 @@ Must be one of:
 * "PARTIALLY_REFUNDED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000
 
 ## Related Decisions
 

package/data/docs/enums/pending-issue.md

@@ -1,7 +1,7 @@
 ---
 title: "PendingIssue"
 sidebar_label: "PendingIssue"
-sidebar_position: 23
+sidebar_position: 24
 ---
 
 # PendingIssue
@@ -28,4 +28,4 @@ Must be one of:
 * "NO_SHOW_UNRESOLVED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/return-status.md

@@ -1,7 +1,7 @@
 ---
 title: "ReturnStatus"
 sidebar_label: "ReturnStatus"
-sidebar_position: 24
+sidebar_position: 25
 ---
 
 # ReturnStatus
@@ -23,7 +23,7 @@ Must be one of:
 * "EXCHANGE_COMPLETED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000
 
 ## Related Decisions
 

package/data/docs/enums/session-status.md

@@ -1,7 +1,7 @@
 ---
 title: "SessionStatus"
 sidebar_label: "SessionStatus"
-sidebar_position: 25
+sidebar_position: 26
 ---
 
 # SessionStatus
@@ -23,7 +23,7 @@ Must be one of:
 * "CANCELLED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000
 
 ## Related Decisions
 

package/data/docs/enums/site-status.md

@@ -1,7 +1,7 @@
 ---
 title: "SiteStatus"
 sidebar_label: "SiteStatus"
-sidebar_position: 26
+sidebar_position: 27
 ---
 
 # SiteStatus
@@ -21,4 +21,4 @@ Must be one of:
 * "ARCHIVED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/enums/stocktake-frequency.md

@@ -1,7 +1,7 @@
 ---
 title: "StocktakeFrequency"
 sidebar_label: "StocktakeFrequency"
-sidebar_position: 27
+sidebar_position: 28
 ---
 
 # StocktakeFrequency
@@ -21,4 +21,4 @@ Must be one of:
 * "AD_HOC"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:11 +0000

package/data/docs/enums/stocktake-item-status.md

@@ -1,7 +1,7 @@
 ---
 title: "StocktakeItemStatus"
 sidebar_label: "StocktakeItemStatus"
-sidebar_position: 28
+sidebar_position: 29
 ---
 
 # StocktakeItemStatus
@@ -21,4 +21,4 @@ Must be one of:
 * "ADJUSTED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:11 +0000

package/data/docs/enums/stocktake-status.md

@@ -1,7 +1,7 @@
 ---
 title: "StocktakeStatus"
 sidebar_label: "StocktakeStatus"
-sidebar_position: 29
+sidebar_position: 30
 ---
 
 # StocktakeStatus
@@ -21,4 +21,4 @@ Must be one of:
 * "CANCELLED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:11 +0000

package/data/docs/enums/ticket-status.md

@@ -1,7 +1,7 @@
 ---
 title: "TicketStatus"
 sidebar_label: "TicketStatus"
-sidebar_position: 30
+sidebar_position: 31
 ---
 
 # TicketStatus
@@ -20,7 +20,7 @@ Must be one of:
 * "CANCELLED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:11 +0000
 
 ## Related Decisions
 

package/data/docs/enums/waba-label.md

@@ -1,7 +1,7 @@
 ---
 title: "WabaLabel"
 sidebar_label: "WabaLabel"
-sidebar_position: 31
+sidebar_position: 32
 ---
 
 # WabaLabel
@@ -19,4 +19,4 @@ Must be one of:
 * "val"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:11 +0000

package/data/docs/enums/whatsapp-button-sub-type.md

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappButtonSubType"
 sidebar_label: "WhatsappButtonSubType"
-sidebar_position: 32
+sidebar_position: 33
 ---
 
 # WhatsappButtonSubType
@@ -19,4 +19,4 @@ Must be one of:
 * "quick_reply"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:11 +0000

package/data/docs/enums/whatsapp-template-component.md

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappTemplateComponent"
 sidebar_label: "WhatsappTemplateComponent"
-sidebar_position: 33
+sidebar_position: 34
 ---
 
 # WhatsappTemplateComponent
@@ -20,4 +20,4 @@ Must be one of:
 * "button"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:11 +0000

package/data/docs/enums/whatsapp-template-status.md

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappTemplateStatus"
 sidebar_label: "WhatsappTemplateStatus"
-sidebar_position: 34
+sidebar_position: 35
 ---
 
 # WhatsappTemplateStatus
@@ -23,4 +23,4 @@ Must be one of:
 * "IN_APPEAL"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:11 +0000

package/data/docs/index.md

@@ -19,7 +19,7 @@ Developers own the Zod source in `packages/schema/src/`. When schemas change, th
 
 ## What's documented
 
-### Enums (34)
+### Enums (35)
 
 Status enums that drive business logic across Order, Booking, Event, and Loyalty domains:
 
@@ -34,6 +34,7 @@ Status enums that drive business logic across Order, Booking, Event, and Loyalty
 | [DeliveryType](enums/delivery-type) | 3 values | Fulfillment channel for an order. Determines whether the customer comes to the business (ON_SITE), collects their order themselves (PICK_UP), or receives a physical delivery (DELIVERY). Drives whether fulfillmentStatus is relevant. |
 | [DeploymentLinkType](enums/deployment-link-type) | 6 values | Category of a Site deployment link (D41). Used for UI icon/labelling and deep-link handling. |
 | [EventStatus](enums/event-status) | 4 values | Ticketed event lifecycle (D32). Mobile-only today; Dashboard in Wave 4. |
+| [ExpensePaymentStatus](enums/expense-payment-status) | 4 values | Payment status of an Expense. Stored enum — OVERDUE is not stored, it is derived at read time from dueDate (#13). |
 | [FulfillmentStatus](enums/fulfillment-status) | 6 values | Delivery/fulfillment lifecycle (D34). Optional — null for in-person orders. |
 | [LoyaltyTransactionType](enums/loyalty-transaction-type) | 6 values | Loyalty point transaction type (D07). SCREAMING_SNAKE past tense. |
 | [MilestoneStatus](enums/milestone-status) | 3 values | Status of a ContractMilestone (#17). PENDING = created, not yet invoiced. INVOICED = invoice issued, awaiting payment. PAID = payment received. |
@@ -44,7 +45,7 @@ Status enums that drive business logic across Order, Booking, Event, and Loyalty
 | [OutboundMessageFormat](enums/outbound-message-format) | 2 values | Outbound WhatsApp message format. `text` is a free-form body (only valid inside the 24h customer-care window); `template` is a pre-approved WhatsApp template send. The backend is the authority on which is allowed (GH#43). |
 | [OutboundMessagePurpose](enums/outbound-message-purpose) | 4 values | Business purpose of an outbound WhatsApp message — orthogonal to its format (see OutboundMessageFormat). `otp`/`review_request`/`adhoc` are system-originated; `conversational` is a human agent reply from the dashboard inbox. Optional signal carried for analytics/triggers (GH#43; supersedes the GH#38 OutboundMessageKind). |
 | [OutboundMessageStatus](enums/outbound-message-status) | 5 values | Outbound WhatsApp message delivery status. Lifecycle: queued → sent → delivered → read, or queued → failed. The dashboard creates the message with status `queued`; the whatsapp-server backend owns every transition after, updating in place from Meta delivery callbacks (GH#43). |
-| [PaymentMethod](enums/payment-method) | 10 values | Unified payment method set with African + global methods (D02). |
+| [PaymentMethod](enums/payment-method) | 11 values | Unified payment method set with African + global methods (D02). Note: the metrics writer historically emits "OM" instead of "ORANGE_MONEY" as a paymentsByMethod map key — treat OM as deprecated; canonical value is ORANGE_MONEY (#21). |
 | [PaymentProofStatus](enums/payment-proof-status) | 3 values | Payment proof review status. Used by Order and Booking payment proof workflows. |
 | [PaymentStatus](enums/payment-status) | 7 values | Payment lifecycle status (D01 amended). Used by Order, Sale/Purchase, Booking. |
 | [PendingIssue](enums/pending-issue) | 11 values | Specific detected conditions on an Order or Booking requiring human action (D39). Stored as an array — multiple issues can be active simultaneously. Server-owned. |
@@ -61,7 +62,7 @@ Status enums that drive business logic across Order, Booking, Event, and Loyalty
 | [WhatsappTemplateStatus](enums/whatsapp-template-status) | 6 values | Meta review status of a WhatsApp message template, synced from the WhatsApp Business API. Only APPROVED templates can be sent. The fuller Meta status set is used deliberately (vs just APPROVED/PENDING/REJECTED) so this enum has a distinct value signature from PaymentProofStatus in the JSON-Schema $ref matcher (GH#43). |
 
 
-### Models (39)
+### Models (41)
 
 Core Firestore document schemas:
 
@@ -81,6 +82,7 @@ Core Firestore document schemas:
 | [CustomerPayment](models/customer-payment) | 17 | 12 | — |
 | [CustomerPaymentAllocation](models/customer-payment-allocation) | 14 | 8 | — |
 | [Event](models/event) | 15 | 9 | — |
+| [Expense](models/expense) | 17 | 6 | — |
 | [LoyaltyConfig](models/loyalty-config) | 11 | 2 | — |
 | [LoyaltyReward](models/loyalty-reward) | 11 | 5 | — |
 | [LoyaltyStatus](models/loyalty-status) | 9 | 2 | — |
@@ -94,6 +96,7 @@ Core Firestore document schemas:
 | [OrderItem](models/order-item) | 12 | 3 | — |
 | [OutboundPayment](models/outbound-payment) | 13 | 7 | — |
 | [OutboundPaymentAllocation](models/outbound-payment-allocation) | 7 | 4 | — |
+| [PaymentWebhookDelivery](models/payment-webhook-delivery) | 15 | 13 | — |
 | [PaymentWebhookEndpoint](models/payment-webhook-endpoint) | 6 | 5 | — |
 | [Sale](models/sale) | 12 | 1 | — |
 | [Site](models/site) | 14 | 6 | — |
@@ -102,9 +105,9 @@ Core Firestore document schemas:
 | [StocktakeItem](models/stocktake-item) | 16 | 8 | — |
 | [Ticket](models/ticket) | 16 | 6 | — |
 | [User](models/user) | 9 | 0 | — |
-| [WhatsappInboundMessage](models/whatsapp-inbound-message) | 13 | 7 | — |
+| [WhatsappInboundMessage](models/whatsapp-inbound-message) | 14 | 7 | — |
 | [WhatsappOutboundLifecycleEvent](models/whatsapp-outbound-lifecycle-event) | 11 | 2 | — |
-| [WhatsappOutboundMessage](models/whatsapp-outbound-message) | 18 | 7 | — |
+| [WhatsappOutboundMessage](models/whatsapp-outbound-message) | 19 | 7 | — |
 | [WhatsappTemplate](models/whatsapp-template) | 9 | 8 | — |
 
 

package/data/docs/models/allowed-user.md

@@ -185,4 +185,4 @@ Set at creation only. This field cannot be modified after the document is create
 | **Maximum**  | ≤ 9007199254740991  |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:44 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000

package/data/docs/models/analytics-backfill.md

@@ -391,7 +391,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:44 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:10 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.