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

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

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

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

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappOutboundLifecycleEvent"
 sidebar_label: "WhatsappOutboundLifecycleEvent"
-sidebar_position: 30
+sidebar_position: 37
 ---
 
 # 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-27 at 15:51:06 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +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: 31
+sidebar_position: 38
 ---
 
 # WhatsappOutboundMessage
@@ -83,26 +83,26 @@ sidebar_position: 31
 
 **Description:** WhatsappOutboundMessage — Firestore-as-the-bus outbox doc (GH#43). Collection: whatsapp_outbound_messages/\{docId\}. Top-level scope; mirrors WhatsappInboundMessage. Dashboard enqueues `queued`; backend sends and owns the lifecycle.
 
-| Property                       | Pattern | Type             | Deprecated | Definition                               | Title/Description                                                                                                                       |
-| ------------------------------ | ------- | ---------------- | ---------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
-| - [id](#id )                   | No      | string or null   | No         | -                                        | (Read-only) Firestore document ID — auto-generated at enqueue time.                                                                     |
-| + [to](#to )                   | No      | string           | No         | -                                        | (Immutable) Recipient phone number in E.164 format. Must match the inbound \`from\` for the same conversation.                          |
-| + [waba](#waba )               | No      | enum (of string) | No         | In #/definitions/waba-label              | (Immutable) WABA that will send the message. Mirrors inbound \`waba\`.                                                                  |
-| + [wabaId](#wabaId )           | No      | string           | No         | -                                        | (Immutable) Meta WABA ID. Mirrors inbound \`wabaId\`.                                                                                   |
-| + [kind](#kind )               | No      | enum (of string) | No         | In #/definitions/outbound-message-format | (Immutable) Message format: \`text\` or \`template\`. Set \`text\` xor \`template\` to match.                                           |
-| - [text](#text )               | No      | string or null   | No         | -                                        | Free-form message body. Present only when kind=text.                                                                                    |
-| - [template](#template )       | No      | object or null   | No         | -                                        | Template send payload. Present only when kind=template.                                                                                 |
-| - [purpose](#purpose )         | No      | Combination      | No         | -                                        | Business purpose (otp \| review_request \| adhoc \| conversational). Optional.                                                          |
-| - [orderUuid](#orderUuid )     | No      | string or null   | No         | -                                        | Order reference. Present on review_request messages.                                                                                    |
-| + [sentBy](#sentBy )           | No      | object           | No         | -                                        | (Immutable) Dashboard actor who enqueued the message.                                                                                   |
-| + [createdAt](#createdAt )     | No      | object           | No         | In #/definitions/firestore-timestamp     | (Immutable) Enqueue timestamp, set by the dashboard at create.                                                                          |
-| + [status](#status )           | No      | enum (of string) | No         | In #/definitions/outbound-message-status | Delivery status. Created as \`queued\` by the dashboard; updated in place by the backend.                                               |
-| - [wamid](#wamid )             | No      | string or null   | No         | -                                        | (Read-only) WhatsApp message ID returned by Meta once the backend sends. Absent while queued or on failure.                             |
-| - [error](#error )             | No      | string or null   | No         | -                                        | (Read-only) Human-readable failure reason. Present on status=failed. Raw Meta error detail lives in the lifecycle_events subcollection. |
-| - [sentAt](#sentAt )           | No      | Combination      | No         | -                                        | (Read-only) When the backend sent the message to Meta.                                                                                  |
-| - [deliveredAt](#deliveredAt ) | No      | Combination      | No         | -                                        | (Read-only) When Meta reported delivery.                                                                                                |
-| - [readAt](#readAt )           | No      | Combination      | No         | -                                        | (Read-only) When Meta reported the recipient read the message.                                                                          |
-| - [failedAt](#failedAt )       | No      | Combination      | No         | -                                        | (Read-only) When the send failed.                                                                                                       |
+| Property                       | Pattern | Type             | Deprecated | Definition                               | Title/Description                                                                                                                                                              |
+| ------------------------------ | ------- | ---------------- | ---------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| - [id](#id )                   | No      | string or null   | No         | -                                        | (Read-only) Firestore document ID — auto-generated at enqueue time.                                                                                                            |
+| + [to](#to )                   | No      | string           | No         | -                                        | (Immutable) Recipient Meta wa_id — digits only, no leading + (e.g. 22577471485). Equal to the inbound \`from\` for the same conversation. NOT literal E.164; see x-note (#54). |
+| + [waba](#waba )               | No      | enum (of string) | No         | In #/definitions/waba-label              | (Immutable) WABA that will send the message. Mirrors inbound \`waba\`.                                                                                                         |
+| + [wabaId](#wabaId )           | No      | string           | No         | -                                        | (Immutable) Meta WABA ID. Mirrors inbound \`wabaId\`.                                                                                                                          |
+| + [kind](#kind )               | No      | enum (of string) | No         | In #/definitions/outbound-message-format | (Immutable) Message format: \`text\` or \`template\`. Set \`text\` xor \`template\` to match.                                                                                  |
+| - [text](#text )               | No      | string or null   | No         | -                                        | Free-form message body. Present only when kind=text.                                                                                                                           |
+| - [template](#template )       | No      | object or null   | No         | -                                        | Template send payload. Present only when kind=template.                                                                                                                        |
+| - [purpose](#purpose )         | No      | Combination      | No         | -                                        | Business purpose (otp \| review_request \| adhoc \| conversational). Optional.                                                                                                 |
+| - [orderUuid](#orderUuid )     | No      | string or null   | No         | -                                        | Order reference. Present on review_request messages.                                                                                                                           |
+| + [sentBy](#sentBy )           | No      | object           | No         | -                                        | (Immutable) Dashboard actor who enqueued the message.                                                                                                                          |
+| + [createdAt](#createdAt )     | No      | object           | No         | In #/definitions/firestore-timestamp     | (Immutable) Enqueue timestamp, set by the dashboard at create.                                                                                                                 |
+| + [status](#status )           | No      | enum (of string) | No         | In #/definitions/outbound-message-status | Delivery status. Created as \`queued\` by the dashboard; updated in place by the backend.                                                                                      |
+| - [wamid](#wamid )             | No      | string or null   | No         | -                                        | (Read-only) WhatsApp message ID returned by Meta once the backend sends. Absent while queued or on failure.                                                                    |
+| - [error](#error )             | No      | string or null   | No         | -                                        | (Read-only) Human-readable failure reason. Present on status=failed. Raw Meta error detail lives in the lifecycle_events subcollection.                                        |
+| - [sentAt](#sentAt )           | No      | Combination      | No         | -                                        | (Read-only) When the backend sent the message to Meta.                                                                                                                         |
+| - [deliveredAt](#deliveredAt ) | No      | Combination      | No         | -                                        | (Read-only) When Meta reported delivery.                                                                                                                                       |
+| - [readAt](#readAt )           | No      | Combination      | No         | -                                        | (Read-only) When Meta reported the recipient read the message.                                                                                                                 |
+| - [failedAt](#failedAt )       | No      | Combination      | No         | -                                        | (Read-only) When the send failed.                                                                                                                                              |
 
 ## <a name="id"></a>1. Property `id`
 
@@ -124,12 +124,20 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Type**     | `string` |
 | **Required** | Yes      |
 
-**Description:** (Immutable) Recipient phone number in E.164 format. Must match the inbound `from` for the same conversation.
+**Description:** (Immutable) Recipient Meta wa_id — digits only, no leading + (e.g. 22577471485). Equal to the inbound `from` for the same conversation. NOT literal E.164; see x-note (#54).
 
 :::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.
 :::
 
+:::note
+This is the Meta wa_id (digits only, no leading +), NOT a literal E.164 string. Meta normalizes phone numbers in non-obvious ways (e.g. +2250777471485 → wa_id 22577471485, dropping the trunk zero). The only reliable source is Meta's contacts[].wa_id from the send response — do not derive from E.164 by stripping + alone. The dashboard conversational sends and the whatsapp-server OTP path both use the wa_id form. Confirmed in prod: ING-368.
+:::
+
+:::tip When to set
+Set at enqueue time to the recipient's Meta wa_id. Use inbound WhatsappInboundMessage.from (also wa_id) as the join key for the conversation thread.
+:::
+
 ## <a name="waba"></a>3. Property `waba`
 
 |                |                          |
@@ -148,6 +156,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="wabaId"></a>4. Property `wabaId`
 
 |              |          |
@@ -424,6 +436,10 @@ Dashboard must create with `queued`. The backend owns every transition after (se
 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
+Useful for audit and dedup. Does NOT enable reply-threading for template messages — Meta silently ignores context.message_id on templates. Threading only works for kind=text within the 24-hour service window (#50).
+:::
+
 ## <a name="error"></a>14. Property `error`
 
 |              |                  |
@@ -461,7 +477,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Additional properties** | Not allowed             |
 | **Same definition as**    | [createdAt](#createdAt) |
 
-**Description:** Firestore Timestamp serialized representation
+**Description:** Firestore Timestamp — Admin SDK form: \{ _seconds, _nanoseconds \}. See types/firestore.ts for REST API v1 and client SDK serialization notes (#10).
 
 ### <a name="sentAt_anyOf_i1"></a>15.2. Property `item 1`
 
@@ -498,7 +514,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Additional properties** | Not allowed             |
 | **Same definition as**    | [createdAt](#createdAt) |
 
-**Description:** Firestore Timestamp serialized representation
+**Description:** Firestore Timestamp — Admin SDK form: \{ _seconds, _nanoseconds \}. See types/firestore.ts for REST API v1 and client SDK serialization notes (#10).
 
 ### <a name="deliveredAt_anyOf_i1"></a>16.2. Property `item 1`
 
@@ -535,7 +551,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Additional properties** | Not allowed             |
 | **Same definition as**    | [createdAt](#createdAt) |
 
-**Description:** Firestore Timestamp serialized representation
+**Description:** Firestore Timestamp — Admin SDK form: \{ _seconds, _nanoseconds \}. See types/firestore.ts for REST API v1 and client SDK serialization notes (#10).
 
 ### <a name="readAt_anyOf_i1"></a>17.2. Property `item 1`
 
@@ -572,7 +588,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Additional properties** | Not allowed             |
 | **Same definition as**    | [createdAt](#createdAt) |
 
-**Description:** Firestore Timestamp serialized representation
+**Description:** Firestore Timestamp — Admin SDK form: \{ _seconds, _nanoseconds \}. See types/firestore.ts for REST API v1 and client SDK serialization notes (#10).
 
 ### <a name="failedAt_anyOf_i1"></a>18.2. Property `item 1`
 
@@ -582,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-27 at 15:51:06 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +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: 32
+sidebar_position: 39
 ---
 
 # WhatsappTemplate
@@ -99,6 +99,10 @@ Must be one of:
 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
+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="wabaId"></a>3. Property `wabaId`
 
 |              |          |
@@ -287,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-27 at 15:51:06 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +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.