@ingenx-io/valets-schema-mcp-server 0.2.2 → 0.2.3

package/data/docs/models/site-payment.md

@@ -1,7 +1,7 @@
 ---
 title: "SitePayment"
 sidebar_label: "SitePayment"
-sidebar_position: 24
+sidebar_position: 25
 ---
 
 # 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-27 at 14:03:20 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 15:51:05 +0000

package/data/docs/models/site.md

@@ -1,7 +1,7 @@
 ---
 title: "Site"
 sidebar_label: "Site"
-sidebar_position: 23
+sidebar_position: 24
 ---
 
 # 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-27 at 14:03:20 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 15:51:05 +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: 26
+sidebar_position: 27
 ---
 
 # 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-27 at 14:03:20 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 15:51:05 +0000

package/data/docs/models/stocktake.md

@@ -1,7 +1,7 @@
 ---
 title: "Stocktake"
 sidebar_label: "Stocktake"
-sidebar_position: 25
+sidebar_position: 26
 ---
 
 # 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-27 at 14:03:20 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 15:51:05 +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: 27
+sidebar_position: 28
 ---
 
 # 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-27 at 14:03:20 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 15:51:05 +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/whatsapp-inbound-message.md

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

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

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappOutboundLifecycleEvent"
 sidebar_label: "WhatsappOutboundLifecycleEvent"
-sidebar_position: 29
+sidebar_position: 30
 ---
 
 # 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 14:03:20 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 15:51:06 +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: 30
+sidebar_position: 31
 ---
 
 # WhatsappOutboundMessage
@@ -582,7 +582,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 14:03:20 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 15:51:06 +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: 31
+sidebar_position: 32
 ---
 
 # WhatsappTemplate
@@ -287,7 +287,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 14:03:20 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 15:51:06 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/static/llms.txt

@@ -46,6 +46,18 @@ Values: PREPARING, PARTIALLY_SHIPPED, SHIPPED, IN_TRANSIT, DELIVERED, PICKED_UP
 Loyalty point transaction type (D07). SCREAMING_SNAKE past tense.
 Values: EARNED, REDEEMED, ADJUSTED, EXPIRED, BONUS, REFUND
 
+### NotificationChannel
+Delivery channel of a NotificationRecord (GH#48).
+Values: email, whatsapp, sms, push
+
+### NotificationEntityType
+Type of entity a NotificationRecord relates to. When `order`, the record is dual-written to the order-scoped subcollection (GH#48).
+Values: order, booking, customer, digest, magic_link, other
+
+### NotificationStatus
+Delivery status of a NotificationRecord, set by the Cloud Function after a send attempt (GH#48).
+Values: sent, failed, pending
+
 ### OrderStatus
 Core order lifecycle status (D03, D34). Universal across all business types. Replaces the Dashboard's legacy 20-value flat enum (MIG-11).
 Values: PENDING, CONFIRMED, PROCESSING, READY, COMPLETED, CANCELLED, EXPIRED
@@ -1092,6 +1104,66 @@ Example:
 }
 ```
 
+### NotificationRecord
+Fields: 12 (6 required)
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| id | ['string', 'null'] | no | (Read-only) Firestore document ID, auto-generated. Same ID is used in both the company-wide and order-scoped copies. |
+| type | NotificationChannel | yes | (Read-only) Delivery channel. |
+| status | NotificationStatus | yes | (Read-only) Delivery status after the send attempt. |
+| subject | ['string', 'null'] | no | (Read-only) Subject line. Present for email notifications only. |
+| recipients | object | yes | (Read-only) Recipients of the notification. |
+| recipients.to | array<object> | yes | Primary recipients. |
+| recipients.to[].email | string | no | Recipient email address. Present for email notifications. |
+| recipients.to[].phone | string | no | Recipient phone number (E.164). Present for whatsapp/sms notifications. |
+| recipients.to[].name | string | no | Recipient display name. |
+| recipients.to[].role | string | no | Recipient role (e.g. organizer, customer). |
+| recipients.cc | array<object> | no | CC recipients (email). |
+| recipients.cc[].email | string | no | Recipient email address. Present for email notifications. |
+| recipients.cc[].phone | string | no | Recipient phone number (E.164). Present for whatsapp/sms notifications. |
+| recipients.cc[].name | string | no | Recipient display name. |
+| recipients.cc[].role | string | no | Recipient role (e.g. organizer, customer). |
+| recipients.bcc | array<object> | no | BCC recipients (email). |
+| recipients.bcc[].email | string | no | Recipient email address. Present for email notifications. |
+| recipients.bcc[].phone | string | no | Recipient phone number (E.164). Present for whatsapp/sms notifications. |
+| recipients.bcc[].name | string | no | Recipient display name. |
+| recipients.bcc[].role | string | no | Recipient role (e.g. organizer, customer). |
+| relatedEntity | object | yes | (Read-only) Entity that triggered the notification. type=order triggers the dual-write to the order subcollection. |
+| relatedEntity.type | NotificationEntityType | yes | Entity type this notification relates to. |
+| relatedEntity.id | string | yes | Entity document ID (e.g. orderId when type=order). |
+| wamid | ['string', 'null'] | no | (Read-only) WhatsApp message ID from the Meta API response. Present on successful whatsapp sends only. |
+| templateParams | ['object', 'null'] | no | (Read-only) Filled-in template variable values at send time. Allows reconstructing the sent message without fetching from Meta. |
+| metadata | ['object', 'null'] | no | (Read-only) Channel-specific extras (e.g. senderPhoneId, templateName, orderNumber). |
+| error | ['string', 'null'] | no | (Read-only) Failure reason. Present on status=failed. |
+| sentAt | FirestoreTimestamp | yes | (Read-only) When the send was attempted. |
+| createdAt | FirestoreTimestamp | yes | (Read-only) When the record was created. |
+
+Example:
+```json
+{
+  "id": null,
+  "type": "phone",
+  "status": "status",
+  "subject": null,
+  "recipients": {
+    "to": [
+      {}
+    ]
+  },
+  "relatedEntity": {
+    "type": "phone",
+    "id": "bk_abc123def456"
+  },
+  "wamid": null,
+  "templateParams": null,
+  "metadata": null,
+  "error": null,
+  "sentAt": "sentAt",
+  "createdAt": "createdAt"
+}
+```
+
 ### Order
 Fields: 48 (8 required)
 

package/data/static/openapi.yaml

@@ -110,6 +110,33 @@ components:
       - BONUS
       - REFUND
       description: Loyalty point transaction type (D07). SCREAMING_SNAKE past tense.
+    NotificationChannel:
+      type: string
+      enum:
+      - email
+      - whatsapp
+      - sms
+      - push
+      description: Delivery channel of a NotificationRecord (GH#48).
+    NotificationEntityType:
+      type: string
+      enum:
+      - order
+      - booking
+      - customer
+      - digest
+      - magic_link
+      - other
+      description: Type of entity a NotificationRecord relates to. When `order`, the
+        record is dual-written to the order-scoped subcollection (GH#48).
+    NotificationStatus:
+      type: string
+      enum:
+      - sent
+      - failed
+      - pending
+      description: Delivery status of a NotificationRecord, set by the Cloud Function
+        after a send attempt (GH#48).
     OrderStatus:
       type: string
       enum:
@@ -3074,6 +3101,171 @@ components:
       description: Write payload for partial update (PATCH) of a MetricsMonthly document.
         All fields optional. Fields marked `readOnly` or `x-immutable` must not be
         sent.
+    NotificationRecord:
+      type: object
+      properties:
+        id:
+          readOnly: true
+          description: (Read-only) Firestore document ID, auto-generated. Same ID
+            is used in both the company-wide and order-scoped copies.
+          type:
+          - string
+          - 'null'
+        type:
+          $ref: '#/components/schemas/NotificationChannel'
+          description: (Read-only) Delivery channel.
+          readOnly: true
+        status:
+          $ref: '#/components/schemas/NotificationStatus'
+          description: (Read-only) Delivery status after the send attempt.
+          readOnly: true
+        subject:
+          readOnly: true
+          description: (Read-only) Subject line. Present for email notifications only.
+          type:
+          - string
+          - 'null'
+        recipients:
+          type: object
+          properties:
+            to:
+              type: array
+              items:
+                type: object
+                properties:
+                  email:
+                    description: Recipient email address. Present for email notifications.
+                    type: string
+                  phone:
+                    description: Recipient phone number (E.164). Present for whatsapp/sms
+                      notifications.
+                    type: string
+                  name:
+                    description: Recipient display name.
+                    type: string
+                  role:
+                    description: Recipient role (e.g. organizer, customer).
+                    type: string
+                additionalProperties: false
+                description: A notification recipient (GH#48).
+              description: Primary recipients.
+            cc:
+              description: CC recipients (email).
+              type: array
+              items:
+                type: object
+                properties:
+                  email:
+                    description: Recipient email address. Present for email notifications.
+                    type: string
+                  phone:
+                    description: Recipient phone number (E.164). Present for whatsapp/sms
+                      notifications.
+                    type: string
+                  name:
+                    description: Recipient display name.
+                    type: string
+                  role:
+                    description: Recipient role (e.g. organizer, customer).
+                    type: string
+                additionalProperties: false
+                description: A notification recipient (GH#48).
+            bcc:
+              description: BCC recipients (email).
+              type: array
+              items:
+                type: object
+                properties:
+                  email:
+                    description: Recipient email address. Present for email notifications.
+                    type: string
+                  phone:
+                    description: Recipient phone number (E.164). Present for whatsapp/sms
+                      notifications.
+                    type: string
+                  name:
+                    description: Recipient display name.
+                    type: string
+                  role:
+                    description: Recipient role (e.g. organizer, customer).
+                    type: string
+                additionalProperties: false
+                description: A notification recipient (GH#48).
+          required:
+          - to
+          additionalProperties: false
+          readOnly: true
+          description: (Read-only) Recipients of the notification.
+        relatedEntity:
+          type: object
+          properties:
+            type:
+              $ref: '#/components/schemas/NotificationEntityType'
+              description: Entity type this notification relates to.
+            id:
+              type: string
+              description: Entity document ID (e.g. orderId when type=order).
+          required:
+          - type
+          - id
+          additionalProperties: false
+          readOnly: true
+          description: (Read-only) Entity that triggered the notification. type=order
+            triggers the dual-write to the order subcollection.
+        wamid:
+          readOnly: true
+          description: (Read-only) WhatsApp message ID from the Meta API response.
+            Present on successful whatsapp sends only.
+          type:
+          - string
+          - 'null'
+        templateParams:
+          readOnly: true
+          description: (Read-only) Filled-in template variable values at send time.
+            Allows reconstructing the sent message without fetching from Meta.
+          type:
+          - object
+          - 'null'
+          propertyNames:
+            type: string
+          additionalProperties:
+            type: string
+        metadata:
+          readOnly: true
+          description: (Read-only) Channel-specific extras (e.g. senderPhoneId, templateName,
+            orderNumber).
+          type:
+          - object
+          - 'null'
+          propertyNames:
+            type: string
+          additionalProperties: {}
+        error:
+          readOnly: true
+          description: (Read-only) Failure reason. Present on status=failed.
+          type:
+          - string
+          - 'null'
+        sentAt:
+          $ref: '#/components/schemas/FirestoreTimestamp'
+          description: (Read-only) When the send was attempted.
+          readOnly: true
+        createdAt:
+          $ref: '#/components/schemas/FirestoreTimestamp'
+          description: (Read-only) When the record was created.
+          readOnly: true
+      required:
+      - type
+      - status
+      - recipients
+      - relatedEntity
+      - sentAt
+      - createdAt
+      additionalProperties: false
+      description: 'NotificationRecord — backend-written, multi-channel notification
+        audit log (GH#48). Paths: companies/{cid}/notifications/{id} (always) and
+        companies/{cid}/orders/{oid}/notifications/{id} (dual-write when relatedEntity.type=order).
+        Consumers read only. Distinct from WhatsappOutboundMessage (GH#43).'
     Order:
       type: object
       properties: