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

package/data/docs/models/payment-webhook-delivery.md

@@ -0,0 +1,321 @@
+---
+title: "PaymentWebhookDelivery"
+sidebar_label: "PaymentWebhookDelivery"
+sidebar_position: 29
+---
+
+# PaymentWebhookDelivery
+
+<details>
+<summary>Example JSON</summary>
+
+```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"
+}
+```
+
+</details>
+
+
+- [1. Property `id`](#id)
+- [2. Property `company`](#company)
+- [3. Property `provider`](#provider)
+- [4. Property `eventType`](#eventType)
+- [5. Property `status`](#status)
+- [6. Property `verified`](#verified)
+- [7. Property `endpointStatus`](#endpointStatus)
+- [8. Property `processed`](#processed)
+- [9. Property `reference`](#reference)
+- [10. Property `amount`](#amount)
+- [11. Property `currency`](#currency)
+- [12. Property `payload`](#payload)
+  - [12.1. Property `additionalProperties`](#payload_additionalProperties)
+- [13. Property `rawBody`](#rawBody)
+- [14. Property `headers`](#headers)
+  - [14.1. Property `additionalProperties`](#headers_additionalProperties)
+- [15. Property `receivedAt`](#receivedAt)
+  - [15.1. Property `_seconds`](#receivedAt__seconds)
+  - [15.2. Property `_nanoseconds`](#receivedAt__nanoseconds)
+
+|                           |                                        |
+| ------------------------- | -------------------------------------- |
+| **Type**                  | `object`                               |
+| **Required**              | No                                     |
+| **Additional properties** | Not allowed                            |
+| **Defined in**            | #/definitions/payment-webhook-delivery |
+
+**Description:** PaymentWebhookDelivery (GH#42). Collection: payment_webhooks/\{deliveryId\} (top-level). One document per received provider callback. Contains raw payload + verification outcome. x-internal: written/read only by backend; dashboard reads via admin UI. PII in payload/rawBody — retention policy TBD.
+
+| Property                             | Pattern | Type           | Deprecated | Definition                           | Title/Description                                                                                                              |
+| ------------------------------------ | ------- | -------------- | ---------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
+| - [id](#id )                         | No      | string or null | No         | -                                    | (Read-only) Firestore document ID, auto-generated.                                                                             |
+| + [company](#company )               | No      | string         | No         | -                                    | (Immutable) Company document ID (e.g. "gerko_studios"). Resolved from the matched endpoint at delivery time.                   |
+| + [provider](#provider )             | No      | string         | No         | -                                    | Payment provider that sent this webhook (e.g. "jeko", "wave").                                                                 |
+| + [eventType](#eventType )           | No      | string         | No         | -                                    | Provider-defined event type. Observed: "transaction.payment". Full set per provider TBD (#42).                                 |
+| + [status](#status )                 | No      | string         | No         | -                                    | Processing outcome. Observed values: "success" \| "error".                                                                     |
+| + [verified](#verified )             | No      | string         | No         | -                                    | Signature verification result. Observed: "verified". Other values (e.g. "unverified", "error") may exist but are unconfirmed.  |
+| + [endpointStatus](#endpointStatus ) | No      | string         | No         | -                                    | Endpoint resolution result. Observed: "matched". Other values unconfirmed (#42).                                               |
+| + [processed](#processed )           | No      | boolean        | No         | -                                    | Whether this delivery has been reconciled to the AppPayment ledger.                                                            |
+| + [reference](#reference )           | No      | string         | No         | -                                    | Provider transaction ID (= payload.id). Canonical dedup key.                                                                   |
+| + [amount](#amount )                 | No      | number         | No         | -                                    | Payment amount, denormalized from payload.amount.amount (XOF).                                                                 |
+| + [currency](#currency )             | No      | string         | No         | -                                    | Currency code, denormalized from payload.amount.currency (e.g. "XOF").                                                         |
+| + [payload](#payload )               | No      | object         | No         | -                                    | Full parsed provider payload. Shape varies by provider. Contains PII (customer phone). See x-note for retention policy status. |
+| + [rawBody](#rawBody )               | No      | string         | No         | -                                    | Verbatim raw request body — used for HMAC-SHA256 verification. Contains PII.                                                   |
+| - [headers](#headers )               | No      | object or null | No         | -                                    | Incoming HTTP headers. Includes provider signature header and Sentry trace. Sensitive.                                         |
+| + [receivedAt](#receivedAt )         | No      | object         | No         | In #/definitions/firestore-timestamp | When the webhook delivery was received by the backend.                                                                         |
+
+## <a name="id"></a>1. Property `id`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+**Description:** (Read-only) Firestore document ID, auto-generated.
+
+:::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.
+:::
+
+## <a name="company"></a>2. Property `company`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** (Immutable) Company document ID (e.g. "gerko_studios"). Resolved from the matched endpoint at delivery time.
+
+:::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.
+:::
+
+## <a name="provider"></a>3. Property `provider`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Payment provider that sent this webhook (e.g. "jeko", "wave").
+
+:::note
+Observed value: "jeko". The inner payload.paymentMethod may differ (e.g. "wave") — provider here is the webhook sender, not the payment rail (#42).
+:::
+
+## <a name="eventType"></a>4. Property `eventType`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Provider-defined event type. Observed: "transaction.payment". Full set per provider TBD (#42).
+
+:::note
+Observed value: "transaction.payment". Jeko docs say "transaction.completed" — full set per provider unconfirmed (#42). Use z.string() to avoid rejecting unseen values.
+:::
+
+## <a name="status"></a>5. Property `status`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Processing outcome. Observed values: "success" | "error".
+
+:::note
+Observed values: "success", "error". Indicates whether the webhook was processed without errors.
+:::
+
+## <a name="verified"></a>6. Property `verified`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Signature verification result. Observed: "verified". Other values (e.g. "unverified", "error") may exist but are unconfirmed.
+
+:::note
+Observed value: "verified". Indicates HMAC-SHA256 signature verification result. Full set of failure values unconfirmed (#42).
+:::
+
+## <a name="endpointStatus"></a>7. Property `endpointStatus`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Endpoint resolution result. Observed: "matched". Other values unconfirmed (#42).
+
+:::note
+Observed value: "matched". Indicates whether the token resolved to a known PaymentWebhookEndpoint. Other values (e.g. "not_found", "inactive") unconfirmed (#42).
+:::
+
+## <a name="processed"></a>8. Property `processed`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `boolean` |
+| **Required** | Yes       |
+
+**Description:** Whether this delivery has been reconciled to the AppPayment ledger.
+
+:::note
+Set to true once the delivery has been reconciled to the AppPayment ledger (companies/\{cid\}/apps/\{appId\}/payments). Back-reference FK not stored on this doc — reconciliation is tracked on the AppPayment side.
+:::
+
+## <a name="reference"></a>9. Property `reference`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Provider transaction ID (= payload.id). Canonical dedup key.
+
+:::note
+Equals payload.id (provider transaction ID). Used as dedup key — the backend checks this before processing (#42 ask 3).
+:::
+
+## <a name="amount"></a>10. Property `amount`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `number` |
+| **Required** | Yes      |
+
+**Description:** Payment amount, denormalized from payload.amount.amount (XOF).
+
+## <a name="currency"></a>11. Property `currency`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Currency code, denormalized from payload.amount.currency (e.g. "XOF").
+
+## <a name="payload"></a>12. Property `payload`
+
+|                           |                                                                                      |
+| ------------------------- | ------------------------------------------------------------------------------------ |
+| **Type**                  | `object`                                                                             |
+| **Required**              | Yes                                                                                  |
+| **Additional properties** | [Each additional property must conform to the schema](#payload_additionalProperties) |
+
+**Description:** Full parsed provider payload. Shape varies by provider. Contains PII (customer phone). See x-note for retention policy status.
+
+| Property                             | Pattern | Type   | Deprecated | Definition | Title/Description |
+| ------------------------------------ | ------- | ------ | ---------- | ---------- | ----------------- |
+| - [](#payload_additionalProperties ) | No      | object | No         | -          | -                 |
+
+### <a name="payload_additionalProperties"></a>12.1. Property `additionalProperties`
+
+|                           |                  |
+| ------------------------- | ---------------- |
+| **Type**                  | `object`         |
+| **Required**              | No               |
+| **Additional properties** | Any type allowed |
+
+:::note
+Parsed provider request body. Contains PII: counterpartIdentifier and counterpartLabel hold customer phone numbers. Retention/TTL policy TBD (#42 ask 5).
+:::
+
+## <a name="rawBody"></a>13. Property `rawBody`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Verbatim raw request body — used for HMAC-SHA256 verification. Contains PII.
+
+:::note
+Verbatim request body string used for HMAC-SHA256 signature verification. Contains same PII as payload. Retention/TTL policy TBD (#42 ask 5).
+:::
+
+## <a name="headers"></a>14. Property `headers`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `object or null` |
+| **Required** | No               |
+
+**Description:** Incoming HTTP headers. Includes provider signature header and Sentry trace. Sensitive.
+
+| Property                             | Pattern | Type   | Deprecated | Definition | Title/Description |
+| ------------------------------------ | ------- | ------ | ---------- | ---------- | ----------------- |
+| - [](#headers_additionalProperties ) | No      | string | No         | -          | -                 |
+
+### <a name="headers_additionalProperties"></a>14.1. Property `additionalProperties`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | No       |
+
+:::note
+Request headers including provider signature (e.g. "jeko-signature") and tracing headers. Sensitive — do not expose to clients.
+:::
+
+## <a name="receivedAt"></a>15. Property `receivedAt`
+
+|                           |                                   |
+| ------------------------- | --------------------------------- |
+| **Type**                  | `object`                          |
+| **Required**              | Yes                               |
+| **Additional properties** | Not allowed                       |
+| **Defined in**            | #/definitions/firestore-timestamp |
+
+**Description:** When the webhook delivery was received by the backend.
+
+| Property                                    | Pattern | Type    | Deprecated | Definition | Title/Description |
+| ------------------------------------------- | ------- | ------- | ---------- | ---------- | ----------------- |
+| + [_seconds](#receivedAt__seconds )         | No      | integer | No         | -          | -                 |
+| + [_nanoseconds](#receivedAt__nanoseconds ) | No      | integer | No         | -          | -                 |
+
+### <a name="receivedAt__seconds"></a>15.1. Property `_seconds`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+### <a name="receivedAt__nanoseconds"></a>15.2. Property `_nanoseconds`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+----------------------------------------------------------------------------------------------------------------------------
+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/payment-webhook-endpoint.md

@@ -0,0 +1,191 @@
+---
+title: "PaymentWebhookEndpoint"
+sidebar_label: "PaymentWebhookEndpoint"
+sidebar_position: 30
+---
+
+# PaymentWebhookEndpoint
+
+<details>
+<summary>Example JSON</summary>
+
+```json
+{
+  "token": "token",
+  "company": "company",
+  "provider": "wave",
+  "secret": "secret",
+  "active": true,
+  "createdAt": "createdAt"
+}
+```
+
+</details>
+
+
+- [1. Property `token`](#token)
+- [2. Property `company`](#company)
+- [3. Property `provider`](#provider)
+- [4. Property `secret`](#secret)
+- [5. Property `active`](#active)
+- [6. Property `createdAt`](#createdAt)
+  - [6.1. Property `firestore-timestamp`](#createdAt_anyOf_i0)
+    - [6.1.1. Property `_seconds`](#createdAt_anyOf_i0__seconds)
+    - [6.1.2. Property `_nanoseconds`](#createdAt_anyOf_i0__nanoseconds)
+  - [6.2. Property `item 1`](#createdAt_anyOf_i1)
+
+|                           |                                        |
+| ------------------------- | -------------------------------------- |
+| **Type**                  | `object`                               |
+| **Required**              | No                                     |
+| **Additional properties** | Not allowed                            |
+| **Defined in**            | #/definitions/payment-webhook-endpoint |
+
+**Description:** PaymentWebhookEndpoint (GH#41). Collection: payment_webhook_endpoints/\{token\}. Top-level, not tenant-scoped. Provisioned by superadmin; used by the backend to verify inbound payment webhooks from Wave and Jeko. The delivery log collection (raw webhook payloads + verification outcomes) is tracked in GH#41 — shape TBD.
+
+| Property                   | Pattern | Type             | Deprecated | Definition | Title/Description                                                                                            |
+| -------------------------- | ------- | ---------------- | ---------- | ---------- | ------------------------------------------------------------------------------------------------------------ |
+| + [token](#token )         | No      | string           | No         | -          | (Immutable) base64url-encoded 24-byte random token. Also the Firestore document ID and the URL path segment. |
+| + [company](#company )     | No      | string           | No         | -          | (Immutable) Company slug (e.g. gerko_studios). Identifies the tenant that owns this endpoint.                |
+| + [provider](#provider )   | No      | enum (of string) | No         | -          | (Immutable) Payment provider whose webhooks this endpoint accepts.                                           |
+| + [secret](#secret )       | No      | string           | No         | -          | Webhook signing secret for HMAC verification. Backend-only — never returned to dashboard or mobile clients.  |
+| + [active](#active )       | No      | boolean          | No         | -          | Whether this endpoint is currently active. Inactive endpoints reject incoming webhooks.                      |
+| - [createdAt](#createdAt ) | No      | Combination      | No         | -          | (Read-only) When this endpoint was provisioned.                                                              |
+
+## <a name="token"></a>1. Property `token`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** (Immutable) base64url-encoded 24-byte random token. Also the Firestore document ID and the URL path segment.
+
+:::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.
+:::
+
+## <a name="company"></a>2. Property `company`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** (Immutable) Company slug (e.g. gerko_studios). Identifies the tenant that owns this endpoint.
+
+:::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.
+:::
+
+## <a name="provider"></a>3. Property `provider`
+
+|              |                    |
+| ------------ | ------------------ |
+| **Type**     | `enum (of string)` |
+| **Required** | Yes                |
+
+**Description:** (Immutable) Payment provider whose webhooks this endpoint accepts.
+
+Must be one of:
+* "wave"
+* "jeko"
+
+:::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.
+:::
+
+## <a name="secret"></a>4. Property `secret`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Webhook signing secret for HMAC verification. Backend-only — never returned to dashboard or mobile clients.
+
+:::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
+Provider-specific webhook signing secret. Used to verify HMAC-SHA256 signatures on inbound payloads. Never expose to clients.
+:::
+
+## <a name="active"></a>5. Property `active`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `boolean` |
+| **Required** | Yes       |
+
+**Description:** Whether this endpoint is currently active. Inactive endpoints reject incoming webhooks.
+
+## <a name="createdAt"></a>6. Property `createdAt`
+
+|                           |                  |
+| ------------------------- | ---------------- |
+| **Type**                  | `combining`      |
+| **Required**              | No               |
+| **Additional properties** | Any type allowed |
+
+**Description:** (Read-only) When this endpoint was provisioned.
+
+| Any of(Option)                             |
+| ------------------------------------------ |
+| [firestore-timestamp](#createdAt_anyOf_i0) |
+| [item 1](#createdAt_anyOf_i1)              |
+
+### <a name="createdAt_anyOf_i0"></a>6.1. Property `firestore-timestamp`
+
+|                           |                                   |
+| ------------------------- | --------------------------------- |
+| **Type**                  | `object`                          |
+| **Required**              | No                                |
+| **Additional properties** | Not allowed                       |
+| **Defined in**            | #/definitions/firestore-timestamp |
+
+**Description:** Firestore Timestamp — Admin SDK form: \{ _seconds, _nanoseconds \}. See types/firestore.ts for REST API v1 and client SDK serialization notes (#10).
+
+| Property                                            | Pattern | Type    | Deprecated | Definition | Title/Description |
+| --------------------------------------------------- | ------- | ------- | ---------- | ---------- | ----------------- |
+| + [_seconds](#createdAt_anyOf_i0__seconds )         | No      | integer | No         | -          | -                 |
+| + [_nanoseconds](#createdAt_anyOf_i0__nanoseconds ) | No      | integer | No         | -          | -                 |
+
+#### <a name="createdAt_anyOf_i0__seconds"></a>6.1.1. Property `_seconds`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+#### <a name="createdAt_anyOf_i0__nanoseconds"></a>6.1.2. Property `_nanoseconds`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+### <a name="createdAt_anyOf_i1"></a>6.2. Property `item 1`
+
+|              |        |
+| ------------ | ------ |
+| **Type**     | `null` |
+| **Required** | No     |
+
+----------------------------------------------------------------------------------------------------------------------------
+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/sale.md

@@ -1,7 +1,7 @@
 ---
 title: "Sale"
 sidebar_label: "Sale"
-sidebar_position: 25
+sidebar_position: 31
 ---
 
 # Sale
@@ -524,7 +524,7 @@ 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 12:42:51 +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/site-payment.md

@@ -1,7 +1,7 @@
 ---
 title: "SitePayment"
 sidebar_label: "SitePayment"
-sidebar_position: 27
+sidebar_position: 33
 ---
 
 # SitePayment
@@ -197,4 +197,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 12:42:51 +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/site.md

@@ -1,7 +1,7 @@
 ---
 title: "Site"
 sidebar_label: "Site"
-sidebar_position: 26
+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 12:42:51 +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: 29
+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 12:42:51 +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: 28
+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 12:42:51 +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: 30
+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 12:42:51 +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: 31
+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 12:42:51 +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: 32
+sidebar_position: 38
 ---
 
 # WhatsappInboundMessage
@@ -122,6 +122,10 @@ Must be one of:
 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.
 :::
 
+:::note
+cmz = "IngenX - Chez Miss Zahoui", phone number ID 446424085225188, used for chez_miss_zahoui_* companies. val = "IngenX - Valets", phone number ID 425582173979125, used for all other companies. Templates are approved at WABA level — if cmz and val share a WABA ID, all templates are available to both. Routing logic: functions/src/orders/order.ts#isSender2Company. See messaging/whatsapp-platform-constraints (#50).
+:::
+
 ## <a name="messageId"></a>4. Property `messageId`
 
 |              |          |
@@ -366,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 12:42:51 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:57:29 +0000