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

package/data/docs/models/loyalty-reward.md

@@ -1,7 +1,7 @@
 ---
 title: "LoyaltyReward"
 sidebar_label: "LoyaltyReward"
-sidebar_position: 16
+sidebar_position: 17
 ---
 
 # LoyaltyReward
@@ -229,7 +229,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:28 +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/loyalty-status.md

@@ -1,7 +1,7 @@
 ---
 title: "LoyaltyStatus"
 sidebar_label: "LoyaltyStatus"
-sidebar_position: 17
+sidebar_position: 18
 ---
 
 # LoyaltyStatus
@@ -315,7 +315,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:28 +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/loyalty-transaction.md

@@ -1,7 +1,7 @@
 ---
 title: "LoyaltyTransaction"
 sidebar_label: "LoyaltyTransaction"
-sidebar_position: 18
+sidebar_position: 19
 ---
 
 # LoyaltyTransaction
@@ -313,7 +313,7 @@ Set at creation only. This field cannot be modified after the document is create
 **Description:** (Immutable, Denormalized) From User display name at creation time.
 
 ----------------------------------------------------------------------------------------------------------------------------
-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:28 +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/magic-link-request.md

@@ -1,7 +1,7 @@
 ---
 title: "MagicLinkRequest"
 sidebar_label: "MagicLinkRequest"
-sidebar_position: 19
+sidebar_position: 20
 ---
 
 # MagicLinkRequest
@@ -282,4 +282,4 @@ Set at creation only. This field cannot be modified after the document is create
 | **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:28 +0000

package/data/docs/models/metrics-current.md

@@ -1,7 +1,7 @@
 ---
 title: "MetricsCurrent"
 sidebar_label: "MetricsCurrent"
-sidebar_position: 20
+sidebar_position: 21
 ---
 
 # MetricsCurrent
@@ -172,6 +172,10 @@ Do not include in write requests. This field is set exclusively by the server (F
 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.
 :::
 
+:::note
+Firestore REST API v1 writes integerValue when the stored value is whole (e.g. 0), doubleValue when fractional (e.g. 82.17). Admin SDK smooths this to a JS number; REST clients must coerce the union (#11).
+:::
+
 ## <a name="todayPurchasesCount"></a>4. Property `todayPurchasesCount`
 
 |              |           |
@@ -216,6 +220,10 @@ Do not include in write requests. This field is set exclusively by the server (F
 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.
 :::
 
+:::note
+Firestore REST API v1 writes integerValue when whole (e.g. 10070), doubleValue when fractional (e.g. 10006.5). Admin SDK smooths this; REST clients must coerce (#11).
+:::
+
 ## <a name="monthlyRevenue"></a>7. Property `monthlyRevenue`
 
 |              |          |
@@ -229,6 +237,10 @@ Do not include in write requests. This field is set exclusively by the server (F
 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.
 :::
 
+:::note
+Observed as integerValue on all sampled tenants (whole XOF amounts). Will be doubleValue if fractional. REST clients must coerce (#11).
+:::
+
 ## <a name="monthlyPurchasesCount"></a>8. Property `monthlyPurchasesCount`
 
 |              |           |
@@ -322,6 +334,10 @@ Do not include in write requests. This field is set exclusively by the server (F
 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.
 :::
 
+:::note
+Observed as integerValue "0" on all sampled tenants. Will be doubleValue if fractional payments occur. REST clients must coerce (#11).
+:::
+
 ## <a name="todayRevenue"></a>14. Property `todayRevenue`
 
 |              |          |
@@ -438,6 +454,10 @@ Do not include in write requests. This field is set exclusively by the server (F
 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.
 :::
 
+:::note
+Observed as integerValue "0" on all tenants (no reviews yet). Will be doubleValue once real ratings exist. REST clients must coerce (#11).
+:::
+
 ## <a name="lowStockItemsCount"></a>21. Property `lowStockItemsCount`
 
 |              |           |
@@ -657,7 +677,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Maximum**  | &le; 9007199254740991  |
 
 ----------------------------------------------------------------------------------------------------------------------------
-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:28 +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/metrics-daily.md

@@ -1,7 +1,7 @@
 ---
 title: "MetricsDaily"
 sidebar_label: "MetricsDaily"
-sidebar_position: 21
+sidebar_position: 22
 ---
 
 # MetricsDaily
@@ -77,6 +77,8 @@ sidebar_position: 21
 - [27. Property `onHoldOrdersCount`](#onHoldOrdersCount)
 - [28. Property `paymentsByMethod`](#paymentsByMethod)
   - [28.1. Property `additionalProperties`](#paymentsByMethod_additionalProperties)
+    - [28.1.1. Property `total`](#paymentsByMethod_additionalProperties_total)
+    - [28.1.2. Property `count`](#paymentsByMethod_additionalProperties_count)
 - [29. Property `computedForDay`](#computedForDay)
 - [30. Property `generatedAt`](#generatedAt)
   - [30.1. Property `_seconds`](#generatedAt__seconds)
@@ -90,41 +92,41 @@ sidebar_position: 21
 | **Additional properties** | Not allowed                 |
 | **Defined in**            | #/definitions/metrics-daily |
 
-**Description:** Daily metrics snapshot. Collection: companies/\{companyId\}/metrics_daily/\{YYYY-MM-DD\}. Same fields as MetricsCurrent plus `date`. Written by computeDailyCompanyMetrics cron (02:00 UTC) and inline after full recalcs.
-
-| Property                                                                     | Pattern | Type            | Deprecated | Definition                           | Title/Description                                                                                                                                     |
-| ---------------------------------------------------------------------------- | ------- | --------------- | ---------- | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
-| + [todayOrdersCount](#todayOrdersCount )                                     | No      | integer         | No         | -                                    | (Read-only) Orders created today (UTC). Resets at midnight.                                                                                           |
-| + [pendingOrdersCount](#pendingOrdersCount )                                 | No      | integer         | No         | -                                    | (Read-only) Orders currently in PENDING status (all-time cumulative). Corrected by full recalc on order updates.                                      |
-| + [orderCompletionRate30d](#orderCompletionRate30d )                         | No      | number          | No         | -                                    | (Read-only) Percentage of orders completed or delivered in the last 30 days. Always full recalc.                                                      |
-| + [todayPurchasesCount](#todayPurchasesCount )                               | No      | integer         | No         | -                                    | (Read-only) Purchases created today (UTC). Resets at midnight.                                                                                        |
-| + [todayPurchasesSum](#todayPurchasesSum )                                   | No      | number          | No         | -                                    | (Read-only) Total value of purchases created today (UTC). Resets at midnight.                                                                         |
-| + [averagePurchaseAmount](#averagePurchaseAmount )                           | No      | number          | No         | -                                    | (Read-only) Average purchase value across last 200 purchases (rolling, not time-windowed).                                                            |
-| + [monthlyRevenue](#monthlyRevenue )                                         | No      | number          | No         | -                                    | (Read-only) Total purchase value in the current calendar month (UTC).                                                                                 |
-| + [monthlyPurchasesCount](#monthlyPurchasesCount )                           | No      | integer         | No         | -                                    | (Read-only) Number of purchases in the current calendar month (UTC).                                                                                  |
-| + [todayBookingsCount](#todayBookingsCount )                                 | No      | integer         | No         | -                                    | (Read-only) Bookings with date == today AND status in [PENDING, CONFIRMED]. Resets at midnight.                                                       |
-| + [bookingsCreatedToday](#bookingsCreatedToday )                             | No      | integer         | No         | -                                    | (Read-only) Bookings with createdAt today (all statuses). Resets at midnight.                                                                         |
-| + [todayBookingsConfirmedAmount](#todayBookingsConfirmedAmount )             | No      | number          | No         | -                                    | (Read-only) Sum of totalAmount for bookings created today with status CONFIRMED or COMPLETED. Resets at midnight.                                     |
-| + [monthlyBookingsConfirmedAmount](#monthlyBookingsConfirmedAmount )         | No      | number          | No         | -                                    | (Read-only) Sum of totalAmount for bookings created this month with status CONFIRMED or COMPLETED.                                                    |
-| + [todayCollectedAmount](#todayCollectedAmount )                             | No      | number          | No         | -                                    | (Read-only) Sum of totalAmount for bookings where PAYMENT_PAID_AT is today. Resets at midnight.                                                       |
-| + [todayRevenue](#todayRevenue )                                             | No      | number          | No         | -                                    | (Read-only) Sum of totalAmount for COMPLETED bookings where startDate == endDate == today (numeric YYYYMMDD). Resets at midnight.                     |
-| + [bookingsPendingPaymentVerification](#bookingsPendingPaymentVerification ) | No      | integer         | No         | -                                    | (Read-only) Bookings with status PENDING/CANCELLATION_REQUESTED and a payment proof uploaded but not yet verified. Current state, always full recalc. |
-| + [bookingsPendingValidation](#bookingsPendingValidation )                   | No      | integer         | No         | -                                    | (Read-only) PENDING bookings with startDate within ±30 days of today. Rolling window, always full recalc.                                             |
-| + [bookingsPendingValidation24h](#bookingsPendingValidation24h )             | No      | integer         | No         | -                                    | (Read-only) PENDING bookings created in the last 24h with startDate >= tomorrow. Always full recalc.                                                  |
-| + [customersCount](#customersCount )                                         | No      | integer         | No         | -                                    | (Read-only) Total customer count (all-time cumulative).                                                                                               |
-| + [newCustomersThisMonth](#newCustomersThisMonth )                           | No      | integer         | No         | -                                    | (Read-only) Customers with createdAt in the current calendar month (UTC).                                                                             |
-| + [averageRating](#averageRating )                                           | No      | number          | No         | -                                    | (Read-only) Average rating from the last 200 reviews (rolling). Always full recalc.                                                                   |
-| + [lowStockItemsCount](#lowStockItemsCount )                                 | No      | integer         | No         | -                                    | (Read-only) Active stock items where currentQuantity <= minimumQuantity. Current state, always full recalc.                                           |
-| + [activeRecurringPaymentsCount](#activeRecurringPaymentsCount )             | No      | integer         | No         | -                                    | (Read-only) Recurring payments with status ACTIVE. Current state, always full recalc.                                                                 |
-| + [monthlyRecurringRevenue](#monthlyRecurringRevenue )                       | No      | number          | No         | -                                    | (Read-only) Sum of amount for ACTIVE + MONTHLY recurring payments. Always full recalc.                                                                |
-| - [escalatedOrdersCount](#escalatedOrdersCount )                             | No      | integer or null | No         | -                                    | (Read-only, Optional) Orders currently in an escalated state. Present once the current aggregator rewrites the document.                              |
-| - [staleOrdersCount](#staleOrdersCount )                                     | No      | integer or null | No         | -                                    | (Read-only, Optional) Orders that have been in an incomplete status beyond the stale threshold.                                                       |
-| - [staleBookingsCount](#staleBookingsCount )                                 | No      | integer or null | No         | -                                    | (Read-only, Optional) Bookings that have been in an incomplete status beyond the stale threshold.                                                     |
-| - [onHoldOrdersCount](#onHoldOrdersCount )                                   | No      | integer or null | No         | -                                    | (Read-only, Optional) Orders currently in an on-hold state.                                                                                           |
-| - [paymentsByMethod](#paymentsByMethod )                                     | No      | object or null  | No         | -                                    | (Read-only, Optional) Map of PaymentMethod → total amount for the current day. Empty map \{\} until first payment.                                      |
-| + [computedForDay](#computedForDay )                                         | No      | string          | No         | -                                    | (Read-only) YYYY-MM-DD string indicating which day these metrics reflect. Used to detect day boundaries and trigger midnight resets.                  |
-| + [generatedAt](#generatedAt )                                               | No      | object          | No         | In #/definitions/firestore-timestamp | (Read-only) Server timestamp of the last metrics write.                                                                                               |
-| + [date](#date )                                                             | No      | string          | No         | -                                    | (Read-only) YYYY-MM-DD document ID repeated as a field. Identifies the day this snapshot covers.                                                      |
+**Description:** Daily metrics snapshot. Collection: companies/\{companyId\}/metrics_daily/\{YYYY-MM-DD\}. Same fields as MetricsCurrent plus `date`. Written by computeDailyCompanyMetrics cron (02:00 UTC) when the company had activity that day; zero-activity days may produce no document (#9).
+
+| Property                                                                     | Pattern | Type            | Deprecated | Definition                           | Title/Description                                                                                                                                                                  |
+| ---------------------------------------------------------------------------- | ------- | --------------- | ---------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| + [todayOrdersCount](#todayOrdersCount )                                     | No      | integer         | No         | -                                    | (Read-only) Orders created today (UTC). Resets at midnight.                                                                                                                        |
+| + [pendingOrdersCount](#pendingOrdersCount )                                 | No      | integer         | No         | -                                    | (Read-only) Orders currently in PENDING status (all-time cumulative). Corrected by full recalc on order updates.                                                                   |
+| + [orderCompletionRate30d](#orderCompletionRate30d )                         | No      | number          | No         | -                                    | (Read-only) Percentage of orders completed or delivered in the last 30 days. Always full recalc.                                                                                   |
+| + [todayPurchasesCount](#todayPurchasesCount )                               | No      | integer         | No         | -                                    | (Read-only) Purchases created today (UTC). Resets at midnight.                                                                                                                     |
+| + [todayPurchasesSum](#todayPurchasesSum )                                   | No      | number          | No         | -                                    | (Read-only) Total value of purchases created today (UTC). Resets at midnight.                                                                                                      |
+| + [averagePurchaseAmount](#averagePurchaseAmount )                           | No      | number          | No         | -                                    | (Read-only) Average purchase value across last 200 purchases (rolling, not time-windowed).                                                                                         |
+| + [monthlyRevenue](#monthlyRevenue )                                         | No      | number          | No         | -                                    | (Read-only) Total purchase value in the current calendar month (UTC).                                                                                                              |
+| + [monthlyPurchasesCount](#monthlyPurchasesCount )                           | No      | integer         | No         | -                                    | (Read-only) Number of purchases in the current calendar month (UTC).                                                                                                               |
+| + [todayBookingsCount](#todayBookingsCount )                                 | No      | integer         | No         | -                                    | (Read-only) Bookings with date == today AND status in [PENDING, CONFIRMED]. Resets at midnight.                                                                                    |
+| + [bookingsCreatedToday](#bookingsCreatedToday )                             | No      | integer         | No         | -                                    | (Read-only) Bookings with createdAt today (all statuses). Resets at midnight.                                                                                                      |
+| + [todayBookingsConfirmedAmount](#todayBookingsConfirmedAmount )             | No      | number          | No         | -                                    | (Read-only) Sum of totalAmount for bookings created today with status CONFIRMED or COMPLETED. Resets at midnight.                                                                  |
+| + [monthlyBookingsConfirmedAmount](#monthlyBookingsConfirmedAmount )         | No      | number          | No         | -                                    | (Read-only) Sum of totalAmount for bookings created this month with status CONFIRMED or COMPLETED.                                                                                 |
+| + [todayCollectedAmount](#todayCollectedAmount )                             | No      | number          | No         | -                                    | (Read-only) Sum of totalAmount for bookings where PAYMENT_PAID_AT is today. Resets at midnight.                                                                                    |
+| + [todayRevenue](#todayRevenue )                                             | No      | number          | No         | -                                    | (Read-only) Sum of totalAmount for COMPLETED bookings where startDate == endDate == today (numeric YYYYMMDD). Resets at midnight.                                                  |
+| + [bookingsPendingPaymentVerification](#bookingsPendingPaymentVerification ) | No      | integer         | No         | -                                    | (Read-only) Bookings with status PENDING/CANCELLATION_REQUESTED and a payment proof uploaded but not yet verified. Current state, always full recalc.                              |
+| + [bookingsPendingValidation](#bookingsPendingValidation )                   | No      | integer         | No         | -                                    | (Read-only) PENDING bookings with startDate within ±30 days of today. Rolling window, always full recalc.                                                                          |
+| + [bookingsPendingValidation24h](#bookingsPendingValidation24h )             | No      | integer         | No         | -                                    | (Read-only) PENDING bookings created in the last 24h with startDate >= tomorrow. Always full recalc.                                                                               |
+| + [customersCount](#customersCount )                                         | No      | integer         | No         | -                                    | (Read-only) Total customer count (all-time cumulative).                                                                                                                            |
+| + [newCustomersThisMonth](#newCustomersThisMonth )                           | No      | integer         | No         | -                                    | (Read-only) Customers with createdAt in the current calendar month (UTC).                                                                                                          |
+| + [averageRating](#averageRating )                                           | No      | number          | No         | -                                    | (Read-only) Average rating from the last 200 reviews (rolling). Always full recalc.                                                                                                |
+| + [lowStockItemsCount](#lowStockItemsCount )                                 | No      | integer         | No         | -                                    | (Read-only) Active stock items where currentQuantity <= minimumQuantity. Current state, always full recalc.                                                                        |
+| + [activeRecurringPaymentsCount](#activeRecurringPaymentsCount )             | No      | integer         | No         | -                                    | (Read-only) Recurring payments with status ACTIVE. Current state, always full recalc.                                                                                              |
+| + [monthlyRecurringRevenue](#monthlyRecurringRevenue )                       | No      | number          | No         | -                                    | (Read-only) Sum of amount for ACTIVE + MONTHLY recurring payments. Always full recalc.                                                                                             |
+| - [escalatedOrdersCount](#escalatedOrdersCount )                             | No      | integer or null | No         | -                                    | (Read-only, Optional) Orders currently in an escalated state. Present once the current aggregator rewrites the document.                                                           |
+| - [staleOrdersCount](#staleOrdersCount )                                     | No      | integer or null | No         | -                                    | (Read-only, Optional) Orders that have been in an incomplete status beyond the stale threshold.                                                                                    |
+| - [staleBookingsCount](#staleBookingsCount )                                 | No      | integer or null | No         | -                                    | (Read-only, Optional) Bookings that have been in an incomplete status beyond the stale threshold.                                                                                  |
+| - [onHoldOrdersCount](#onHoldOrdersCount )                                   | No      | integer or null | No         | -                                    | (Read-only, Optional) Orders currently in an on-hold state.                                                                                                                        |
+| - [paymentsByMethod](#paymentsByMethod )                                     | No      | object or 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](#computedForDay )                                         | No      | string          | No         | -                                    | (Read-only) YYYY-MM-DD string indicating which day these metrics reflect. Used to detect day boundaries and trigger midnight resets.                                               |
+| + [generatedAt](#generatedAt )                                               | No      | object          | No         | In #/definitions/firestore-timestamp | (Read-only) Server timestamp of the last metrics write.                                                                                                                            |
+| + [date](#date )                                                             | No      | string          | No         | -                                    | (Read-only) YYYY-MM-DD document ID repeated as a field. Identifies the day this snapshot covers.                                                                                   |
 
 ## <a name="todayOrdersCount"></a>1. Property `todayOrdersCount`
 
@@ -175,6 +177,10 @@ Do not include in write requests. This field is set exclusively by the server (F
 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.
 :::
 
+:::note
+Firestore REST API v1 writes integerValue when the stored value is whole (e.g. 0), doubleValue when fractional (e.g. 82.17). Admin SDK smooths this to a JS number; REST clients must coerce the union (#11).
+:::
+
 ## <a name="todayPurchasesCount"></a>4. Property `todayPurchasesCount`
 
 |              |           |
@@ -219,6 +225,10 @@ Do not include in write requests. This field is set exclusively by the server (F
 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.
 :::
 
+:::note
+Firestore REST API v1 writes integerValue when whole (e.g. 10070), doubleValue when fractional (e.g. 10006.5). Admin SDK smooths this; REST clients must coerce (#11).
+:::
+
 ## <a name="monthlyRevenue"></a>7. Property `monthlyRevenue`
 
 |              |          |
@@ -232,6 +242,10 @@ Do not include in write requests. This field is set exclusively by the server (F
 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.
 :::
 
+:::note
+Observed as integerValue on all sampled tenants (whole XOF amounts). Will be doubleValue if fractional. REST clients must coerce (#11).
+:::
+
 ## <a name="monthlyPurchasesCount"></a>8. Property `monthlyPurchasesCount`
 
 |              |           |
@@ -325,6 +339,10 @@ Do not include in write requests. This field is set exclusively by the server (F
 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.
 :::
 
+:::note
+Observed as integerValue "0" on all sampled tenants. Will be doubleValue if fractional payments occur. REST clients must coerce (#11).
+:::
+
 ## <a name="todayRevenue"></a>14. Property `todayRevenue`
 
 |              |          |
@@ -441,6 +459,10 @@ Do not include in write requests. This field is set exclusively by the server (F
 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.
 :::
 
+:::note
+Observed as integerValue "0" on all tenants (no reviews yet). Will be doubleValue once real ratings exist. REST clients must coerce (#11).
+:::
+
 ## <a name="lowStockItemsCount"></a>21. Property `lowStockItemsCount`
 
 |              |           |
@@ -585,25 +607,54 @@ Absent on tenants whose metrics/current was last written before aggregator v2. B
 | **Type**     | `object or null` |
 | **Required** | No               |
 
-**Description:** (Read-only, Optional) Map of PaymentMethod → total amount for the current day. Empty map \{\} until first payment.
+**Description:** (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 \}.
 
 | Property                                      | Pattern | Type   | Deprecated | Definition | Title/Description |
 | --------------------------------------------- | ------- | ------ | ---------- | ---------- | ----------------- |
-| - [](#paymentsByMethod_additionalProperties ) | No      | number | No         | -          | -                 |
+| - [](#paymentsByMethod_additionalProperties ) | No      | object | No         | -          | -                 |
 
 ### <a name="paymentsByMethod_additionalProperties"></a>28.1. Property `additionalProperties`
 
+|                           |             |
+| ------------------------- | ----------- |
+| **Type**                  | `object`    |
+| **Required**              | No          |
+| **Additional properties** | Not allowed |
+
+| Property                                                 | Pattern | Type    | Deprecated | Definition | Title/Description                                              |
+| -------------------------------------------------------- | ------- | ------- | ---------- | ---------- | -------------------------------------------------------------- |
+| + [total](#paymentsByMethod_additionalProperties_total ) | No      | number  | No         | -          | Sum of payment amounts for this method on the given day (XOF). |
+| + [count](#paymentsByMethod_additionalProperties_count ) | No      | integer | No         | -          | Number of payments using this method on the given day.         |
+
+#### <a name="paymentsByMethod_additionalProperties_total"></a>28.1.1. Property `total`
+
 |              |          |
 | ------------ | -------- |
 | **Type**     | `number` |
-| **Required** | No       |
+| **Required** | Yes      |
+
+**Description:** Sum of payment amounts for this method on the given day (XOF).
+
+#### <a name="paymentsByMethod_additionalProperties_count"></a>28.1.2. Property `count`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+**Description:** Number of payments using this method on the given day.
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
 
 :::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.
 :::
 
 :::note
-Always \{\} until the first real payment is recorded. Present on all tenants once rewritten by current aggregator (#8).
+Map keys use short codes in practice (OM, CASH, WAVE) — OM is a non-canonical alias for ORANGE_MONEY emitted by the metrics writer (#21). Value shape \{ total, count \} differs from MetricsCurrent.paymentsByMethod (bare number).
 :::
 
 ## <a name="computedForDay"></a>29. Property `computedForDay`
@@ -673,7 +724,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Read-only) YYYY-MM-DD document ID repeated as a field. Identifies the day this snapshot covers.
 
 ----------------------------------------------------------------------------------------------------------------------------
-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:28 +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/metrics-monthly.md

@@ -1,7 +1,7 @@
 ---
 title: "MetricsMonthly"
 sidebar_label: "MetricsMonthly"
-sidebar_position: 22
+sidebar_position: 23
 ---
 
 # MetricsMonthly
@@ -175,6 +175,10 @@ Do not include in write requests. This field is set exclusively by the server (F
 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.
 :::
 
+:::note
+Firestore REST API v1 writes integerValue when the stored value is whole (e.g. 0), doubleValue when fractional (e.g. 82.17). Admin SDK smooths this to a JS number; REST clients must coerce the union (#11).
+:::
+
 ## <a name="todayPurchasesCount"></a>4. Property `todayPurchasesCount`
 
 |              |           |
@@ -219,6 +223,10 @@ Do not include in write requests. This field is set exclusively by the server (F
 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.
 :::
 
+:::note
+Firestore REST API v1 writes integerValue when whole (e.g. 10070), doubleValue when fractional (e.g. 10006.5). Admin SDK smooths this; REST clients must coerce (#11).
+:::
+
 ## <a name="monthlyRevenue"></a>7. Property `monthlyRevenue`
 
 |              |          |
@@ -232,6 +240,10 @@ Do not include in write requests. This field is set exclusively by the server (F
 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.
 :::
 
+:::note
+Observed as integerValue on all sampled tenants (whole XOF amounts). Will be doubleValue if fractional. REST clients must coerce (#11).
+:::
+
 ## <a name="monthlyPurchasesCount"></a>8. Property `monthlyPurchasesCount`
 
 |              |           |
@@ -325,6 +337,10 @@ Do not include in write requests. This field is set exclusively by the server (F
 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.
 :::
 
+:::note
+Observed as integerValue "0" on all sampled tenants. Will be doubleValue if fractional payments occur. REST clients must coerce (#11).
+:::
+
 ## <a name="todayRevenue"></a>14. Property `todayRevenue`
 
 |              |          |
@@ -441,6 +457,10 @@ Do not include in write requests. This field is set exclusively by the server (F
 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.
 :::
 
+:::note
+Observed as integerValue "0" on all tenants (no reviews yet). Will be doubleValue once real ratings exist. REST clients must coerce (#11).
+:::
+
 ## <a name="lowStockItemsCount"></a>21. Property `lowStockItemsCount`
 
 |              |           |
@@ -673,7 +693,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Read-only) YYYY-MM document ID repeated as a field. Identifies the month this rollup covers.
 
 ----------------------------------------------------------------------------------------------------------------------------
-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:28 +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/notification-record.md

@@ -1,7 +1,7 @@
 ---
 title: "NotificationRecord"
 sidebar_label: "NotificationRecord"
-sidebar_position: 23
+sidebar_position: 24
 ---
 
 # NotificationRecord
@@ -612,7 +612,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Maximum**  | ≤ 9007199254740991  |
 
 ----------------------------------------------------------------------------------------------------------------------------
-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:28 +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/order-item.md

@@ -1,7 +1,7 @@
 ---
 title: "OrderItem"
 sidebar_label: "OrderItem"
-sidebar_position: 25
+sidebar_position: 26
 ---
 
 # OrderItem
@@ -350,7 +350,7 @@ TBD/WIP — Originally from the archived Couchbase Lite (CBL) restaurant flow. C
 | **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:28 +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.