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

package/data/docs/models/site.md

@@ -1,7 +1,7 @@
 ---
 title: "Site"
 sidebar_label: "Site"
-sidebar_position: 30
+sidebar_position: 32
 ---
 
 # Site
@@ -546,7 +546,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** Timestamp of the most recent analytics event seen for this site.
 
 ----------------------------------------------------------------------------------------------------------------------------
-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 13:57:29 +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.

package/data/docs/models/stocktake-item.md

@@ -1,7 +1,7 @@
 ---
 title: "StocktakeItem"
 sidebar_label: "StocktakeItem"
-sidebar_position: 33
+sidebar_position: 35
 ---
 
 # StocktakeItem
@@ -497,4 +497,4 @@ Read-time hint snapshot of the verifier's display name (GH#29 §3 / Q10).
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-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 13:57:29 +0000

package/data/docs/models/stocktake.md

@@ -1,7 +1,7 @@
 ---
 title: "Stocktake"
 sidebar_label: "Stocktake"
-sidebar_position: 32
+sidebar_position: 34
 ---
 
 # Stocktake
@@ -642,7 +642,7 @@ Read-time hint snapshot of the completer's display name (GH#29 §3 / Q10).
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-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 13:57:29 +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.

package/data/docs/models/ticket.md

@@ -1,7 +1,7 @@
 ---
 title: "Ticket"
 sidebar_label: "Ticket"
-sidebar_position: 34
+sidebar_position: 36
 ---
 
 # Ticket
@@ -388,7 +388,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Immutable) FK → User/staff UID who created this ticket.
 
 ----------------------------------------------------------------------------------------------------------------------------
-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 13:57:29 +0000
 
 :::info Immutable
 Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.

package/data/docs/models/user.md

@@ -1,7 +1,7 @@
 ---
 title: "User"
 sidebar_label: "User"
-sidebar_position: 35
+sidebar_position: 37
 ---
 
 # User
@@ -242,7 +242,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:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:57:29 +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.

package/data/docs/models/whatsapp-inbound-message.md

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappInboundMessage"
 sidebar_label: "WhatsappInboundMessage"
-sidebar_position: 36
+sidebar_position: 38
 ---
 
 # WhatsappInboundMessage
@@ -370,4 +370,4 @@ Do not include in write requests. This field is set exclusively by the server (F
 Specific value: `true`
 
 ----------------------------------------------------------------------------------------------------------------------------
-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 13:57:29 +0000

package/data/docs/models/whatsapp-outbound-lifecycle-event.md

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappOutboundLifecycleEvent"
 sidebar_label: "WhatsappOutboundLifecycleEvent"
-sidebar_position: 37
+sidebar_position: 39
 ---
 
 # WhatsappOutboundLifecycleEvent
@@ -303,7 +303,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Read-only) Raw Meta error object(s).
 
 ----------------------------------------------------------------------------------------------------------------------------
-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 13:57:29 +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.

package/data/docs/models/whatsapp-outbound-message.md

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappOutboundMessage"
 sidebar_label: "WhatsappOutboundMessage"
-sidebar_position: 38
+sidebar_position: 40
 ---
 
 # WhatsappOutboundMessage
@@ -598,7 +598,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:45 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:57:29 +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.

package/data/docs/models/whatsapp-template.md

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappTemplate"
 sidebar_label: "WhatsappTemplate"
-sidebar_position: 39
+sidebar_position: 41
 ---
 
 # WhatsappTemplate
@@ -291,7 +291,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Read-only) Rendered preview text for display in the dashboard picker.
 
 ----------------------------------------------------------------------------------------------------------------------------
-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 13:57:29 +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.

package/data/static/llms.txt

@@ -46,6 +46,10 @@ Values: web, mobile, pwa, app-store, play-store, other
 Ticketed event lifecycle (D32). Mobile-only today; Dashboard in Wave 4.
 Values: DRAFT, ACTIVE, CANCELLED, COMPLETED
 
+### ExpensePaymentStatus
+Payment status of an Expense. Stored enum — OVERDUE is not stored, it is derived at read time from dueDate (#13).
+Values: PENDING, PARTIALLY_PAID, PAID, FAILED
+
 ### FulfillmentStatus
 Delivery/fulfillment lifecycle (D34). Optional — null for in-person orders.
 Values: PREPARING, PARTIALLY_SHIPPED, SHIPPED, IN_TRANSIT, DELIVERED, PICKED_UP
@@ -87,8 +91,8 @@ Outbound WhatsApp message delivery status. Lifecycle: queued → sent → delive
 Values: queued, sent, delivered, read, failed
 
 ### PaymentMethod
-Unified payment method set with African + global methods (D02).
-Values: CASH, CREDIT_CARD, ORANGE_MONEY, WAVE, MTN_MONEY, MOOV_MONEY, BANK_TRANSFER, PAYPAL, STRIPE, OTHER
+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).
+Values: CASH, CREDIT_CARD, ORANGE_MONEY, WAVE, MTN_MONEY, MOOV_MONEY, BANK_TRANSFER, PAYPAL, STRIPE, OTHER, OM
 
 ### PaymentProofStatus
 Payment proof review status. Used by Order and Booking payment proof workflows.
@@ -750,7 +754,7 @@ Fields: 17 (12 required)
 | amount | number | yes |  |
 | currency | string | yes | Currency code. Locked to XOF (West African CFA franc) for now. |
 | paymentDate | FirestoreTimestamp | yes | Firestore Timestamp — Admin SDK form: { _seconds, _nanoseconds }. See types/firestore.ts for REST API v1 and client SDK serialization notes (#10). |
-| paymentMethod | PaymentMethod | yes | Unified payment method set with African + global methods (D02). |
+| paymentMethod | PaymentMethod | yes | 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). |
 | referenceNumber | string | yes | Unique payment reference (receipt number, transaction ID, etc.). |
 | allocatedAmount | number | yes | (Read-only) Total amount allocated to bookings/orders/purchases via allocations. Server-calculated. |
 | unappliedAmount | number | yes | (Read-only) Remaining unallocated amount (amount - allocatedAmount). Server-calculated. |
@@ -866,6 +870,52 @@ Example:
 }
 ```
 
+### Expense
+Fields: 17 (6 required)
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| id | ['string', 'null'] | no | (Read-only) Firestore document ID, auto-generated. |
+| companyId | string | yes | (Immutable) FK → Company document ID. |
+| title | string | yes | Human-readable expense title (e.g. "Loyer mars 2026", "Facture EAU"). |
+| description | ['string', 'null'] | no | Optional longer description or notes. |
+| amount | number | yes | Total expense amount (XOF). |
+| currency | string | yes | Currency code. Locked to XOF. |
+| dueDate | any | no | When the expense is due. Used to compute OVERDUE state at read time (not stored in paymentStatus). |
+| paymentStatus | ExpensePaymentStatus | yes | Current payment status. OVERDUE is never stored — derive from dueDate at read time (#13). |
+| amountDue | ['number', 'null'] | no | Amount still owed. Authoritative when no OutboundPaymentAllocation records exist for this expense. |
+| amountPaid | ['number', 'null'] | no | Amount paid to date (simple tracking, no allocations). |
+| allocatedAmount | ['number', 'null'] | no | (Read-only) Total amount allocated via OutboundPaymentAllocation records. Authoritative when allocations exist. |
+| balance | ['number', 'null'] | no | (Read-only) Remaining balance: amount minus allocatedAmount. Authoritative when OutboundPaymentAllocation records exist. |
+| paidDate | any | no | When the expense was fully settled (paymentStatus = PAID). Null otherwise. |
+| paymentReference | ['string', 'null'] | no | Most recent payment transaction reference. Overwritten on each payment; not a full history. |
+| createdBy | string | yes | (Immutable) FK → User/staff UID who created this expense record. |
+| createdAt | any | no | (Read-only) Server-generated creation timestamp. |
+| updatedAt | any | no | (Read-only) Server-generated last-update timestamp. |
+
+Example:
+```json
+{
+  "id": null,
+  "companyId": "comp_xyz789",
+  "title": "title",
+  "description": null,
+  "amount": 45000,
+  "currency": "XOF",
+  "dueDate": "dueDate",
+  "paymentStatus": "paymentStatus",
+  "amountDue": null,
+  "amountPaid": null,
+  "allocatedAmount": null,
+  "balance": null,
+  "paidDate": "pai_ref123",
+  "paymentReference": null,
+  "createdBy": "staff_k0f1",
+  "createdAt": "createdAt",
+  "updatedAt": "updatedAt"
+}
+```
+
 ### LoyaltyConfig
 Fields: 11 (2 required)
 
@@ -1154,7 +1204,7 @@ Fields: 31 (26 required)
 | staleOrdersCount | ['integer', 'null'] | no | (Read-only, Optional) Orders that have been in an incomplete status beyond the stale threshold. |
 | staleBookingsCount | ['integer', 'null'] | no | (Read-only, Optional) Bookings that have been in an incomplete status beyond the stale threshold. |
 | onHoldOrdersCount | ['integer', 'null'] | no | (Read-only, Optional) Orders currently in an on-hold state. |
-| paymentsByMethod | ['object', 'null'] | no | (Read-only, Optional) Map of PaymentMethod → total amount for the current day. Empty map {} until first payment. |
+| paymentsByMethod | ['object', 'null'] | no | (Read-only, Optional) Payment breakdown by method for the day. Keys are PaymentMethod values (or legacy short code OM). Value is { total: XOF amount, count: number of payments }. |
 | computedForDay | string | yes | (Read-only) YYYY-MM-DD string indicating which day these metrics reflect. Used to detect day boundaries and trigger midnight resets. |
 | generatedAt | FirestoreTimestamp | yes | (Read-only) Server timestamp of the last metrics write. |
 | date | string | yes | (Read-only) YYYY-MM-DD document ID repeated as a field. Identifies the day this snapshot covers. |
@@ -1346,7 +1396,7 @@ Fields: 49 (8 required)
 | fulfillmentStatus | any | no | Delivery/fulfillment lifecycle (D34). |
 | returnStatus | any | no | Return/exchange lifecycle (D34). Null until a return or exchange is initiated. |
 | deliveryType | any | no | Fulfillment channel for this order (ON_SITE, PICK_UP, DELIVERY). |
-| paymentMethod | any | no | Unified payment method set with African + global methods (D02). |
+| paymentMethod | any | no | 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). |
 | invoiceId | ['string', 'null'] | no | FK → Invoice document ID. |
 | customerId | ['string', 'null'] | no | FK → Customer.id (Firestore doc ID). Used to resolve customer details. |
 | customerName | ['string', 'null'] | no | (Denormalized) From Customer.name at write time. |
@@ -1540,6 +1590,48 @@ Example:
 }
 ```
 
+### PaymentWebhookDelivery
+Fields: 15 (13 required)
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| id | ['string', 'null'] | no | (Read-only) Firestore document ID, auto-generated. |
+| company | string | yes | (Immutable) Company document ID (e.g. "gerko_studios"). Resolved from the matched endpoint at delivery time. |
+| provider | string | yes | Payment provider that sent this webhook (e.g. "jeko", "wave"). |
+| eventType | string | yes | Provider-defined event type. Observed: "transaction.payment". Full set per provider TBD (#42). |
+| status | string | yes | Processing outcome. Observed values: "success" | "error". |
+| verified | string | yes | Signature verification result. Observed: "verified". Other values (e.g. "unverified", "error") may exist but are unconfirmed. |
+| endpointStatus | string | yes | Endpoint resolution result. Observed: "matched". Other values unconfirmed (#42). |
+| processed | boolean | yes | Whether this delivery has been reconciled to the AppPayment ledger. |
+| reference | string | yes | Provider transaction ID (= payload.id). Canonical dedup key. |
+| amount | number | yes | Payment amount, denormalized from payload.amount.amount (XOF). |
+| currency | string | yes | Currency code, denormalized from payload.amount.currency (e.g. "XOF"). |
+| payload | object | yes | Full parsed provider payload. Shape varies by provider. Contains PII (customer phone). See x-note for retention policy status. |
+| rawBody | string | yes | Verbatim raw request body — used for HMAC-SHA256 verification. Contains PII. |
+| headers | ['object', 'null'] | no | Incoming HTTP headers. Includes provider signature header and Sentry trace. Sensitive. |
+| receivedAt | FirestoreTimestamp | yes | When the webhook delivery was received by the backend. |
+
+Example:
+```json
+{
+  "id": null,
+  "company": "company",
+  "provider": "pro_ref123",
+  "eventType": "eventType",
+  "status": "status",
+  "verified": "verified",
+  "endpointStatus": "endpointStatus",
+  "processed": true,
+  "reference": "reference",
+  "amount": 45000,
+  "currency": "XOF",
+  "payload": {},
+  "rawBody": "rawBody",
+  "headers": null,
+  "receivedAt": "receivedAt"
+}
+```
+
 ### PaymentWebhookEndpoint
 Fields: 6 (5 required)