@ingenx-io/valets-schema-mcp-server 0.1.7 → 0.1.9

package/data/static/openapi.yaml

@@ -122,6 +122,24 @@ components:
       - EXPIRED
       description: Core order lifecycle status (D03, D34). Universal across all business
         types. Replaces the Dashboard's legacy 20-value flat enum (MIG-11).
+    OutboundMessageKind:
+      type: string
+      enum:
+      - otp
+      - review_request
+      description: Outbound WhatsApp message kind. Strict enum — new kinds require
+        a schema version bump (GH#38).
+    OutboundMessageStatus:
+      type: string
+      enum:
+      - accepted
+      - sent
+      - delivered
+      - read
+      - failed
+      description: 'Outbound WhatsApp message delivery status. Lifecycle: accepted
+        → sent → delivered → read, or accepted → failed. Updated in-place by Meta
+        delivery callbacks (GH#38).'
     PaymentMethod:
       type: string
       enum:
@@ -4433,7 +4451,7 @@ components:
           x-immutable: true
         receivedAt:
           $ref: '#/components/schemas/FirestoreTimestamp'
-          description: (Read-only) Server-side ingestion time set by the Cloud Function.
+          description: (Read-only) Server-side ingestion timestamp.
           readOnly: true
         text:
           description: Message body text. Present on type=text messages only.
@@ -4453,7 +4471,7 @@ components:
           - 'null'
         storageUrl:
           description: Durable Cloud Storage URL for the downloaded media binary.
-            Present after the CF downloads and stores the media.
+            Present after the media has been fetched and stored server-side.
           type:
           - string
           - 'null'
@@ -4484,8 +4502,8 @@ components:
       - receivedAt
       additionalProperties: false
       description: 'WhatsappInboundMessage — inbound WhatsApp message persisted from
-        Meta Cloud API webhook (GH#36). Collection: whatsapp_inbound_messages/{docId}
-        in ratenplate project. Top-level scope: company resolution happens post-ingestion.'
+        Meta Cloud API webhook (GH#36). Collection: whatsapp_inbound_messages/{docId}.
+        Top-level scope: company resolution happens post-ingestion.'
     WhatsappInboundMessageCreate:
       allOf:
       - $ref: '#/components/schemas/WhatsappInboundMessage'
@@ -4505,6 +4523,123 @@ components:
       description: Write payload for partial update (PATCH) of a WhatsappInboundMessage
         document. All fields optional. Fields marked `readOnly` or `x-immutable` must
         not be sent.
+    WhatsappOutboundMessage:
+      type: object
+      properties:
+        id:
+          readOnly: true
+          description: (Read-only) Firestore document ID — wamid on success, generated
+            UUID on failure.
+          type:
+          - string
+          - 'null'
+        messageId:
+          type: string
+          x-immutable: true
+          description: (Immutable) WhatsApp message ID (wamid) on success; generated
+            UUID on send failure.
+        to:
+          type: string
+          x-immutable: true
+          description: (Immutable) Recipient phone number in E.164 format. Mirrors
+            inbound `from`.
+        waba:
+          $ref: '#/components/schemas/WabaLabel'
+          description: (Immutable) WABA that sent the message. Mirrors inbound `waba`.
+          x-immutable: true
+        wabaId:
+          type: string
+          x-immutable: true
+          description: (Immutable) Meta WABA ID. Mirrors inbound `wabaId`.
+        sentAt:
+          $ref: '#/components/schemas/FirestoreTimestamp'
+          description: (Read-only) Server-side send timestamp. Mirrors inbound `receivedAt`.
+          readOnly: true
+        phoneNumberId:
+          type: string
+          x-immutable: true
+          description: (Immutable) Meta phone number ID used for the send (specific
+            line within the WABA).
+        kind:
+          $ref: '#/components/schemas/OutboundMessageKind'
+          description: (Immutable) Message kind.
+          x-immutable: true
+        templateName:
+          type: string
+          x-immutable: true
+          description: (Immutable) WhatsApp template name used for the send.
+        status:
+          $ref: '#/components/schemas/OutboundMessageStatus'
+          description: Delivery status. Updated in-place by Meta delivery callbacks.
+        contactWaId:
+          description: Normalized wa_id returned by Meta on success. May differ from
+            `to`.
+          type:
+          - string
+          - 'null'
+        appId:
+          description: Tenant appId when applicable.
+          type:
+          - string
+          - 'null'
+        orderUuid:
+          description: Order reference. Present on review_request messages only.
+          type:
+          - string
+          - 'null'
+        statusUpdatedAt:
+          anyOf:
+          - $ref: '#/components/schemas/FirestoreTimestamp'
+          - type: 'null'
+          description: Timestamp of the last status update from a Meta delivery callback.
+        failureCode:
+          description: Meta error code. Present on failed sends only.
+          type:
+          - integer
+          - 'null'
+          minimum: -9007199254740991
+          maximum: 9007199254740991
+        failureErrors:
+          description: Raw Meta error objects. Present on failed sends only.
+          type:
+          - array
+          - 'null'
+          items: {}
+      required:
+      - messageId
+      - to
+      - waba
+      - wabaId
+      - sentAt
+      - phoneNumberId
+      - kind
+      - templateName
+      - status
+      additionalProperties: false
+      description: 'WhatsappOutboundMessage — outbound WhatsApp message persisted
+        at send time (GH#38). Collection: whatsapp_outbound_messages/{docId}. Top-level
+        scope. Symmetric counterpart to WhatsappInboundMessage (GH#36).'
+    WhatsappOutboundMessageCreate:
+      allOf:
+      - $ref: '#/components/schemas/WhatsappOutboundMessage'
+      description: Write payload for creating a new WhatsappOutboundMessage document.
+        Fields marked `readOnly` are server-set and must not be included. Fields marked
+        `x-immutable` may be set once at creation.
+      required:
+      - messageId
+      - to
+      - waba
+      - wabaId
+      - phoneNumberId
+      - kind
+      - templateName
+      - status
+    WhatsappOutboundMessageUpdate:
+      allOf:
+      - $ref: '#/components/schemas/WhatsappOutboundMessage'
+      description: Write payload for partial update (PATCH) of a WhatsappOutboundMessage
+        document. All fields optional. Fields marked `readOnly` or `x-immutable` must
+        not be sent.
     PaymentSummary:
       type: object
       properties:

package/data/static/schemas.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "description": "@valets/schema \u2014 consolidated schema bundle",
-  "generated": "2026-05-15T16:32:39.367964+00:00",
+  "generated": "2026-05-16T00:18:16.324105+00:00",
   "schemas": {
     "allowed-user": {
       "type": "object",
@@ -4394,6 +4394,25 @@
         ]
       }
     },
+    "outbound-message-kind": {
+      "type": "string",
+      "enum": [
+        "otp",
+        "review_request"
+      ],
+      "description": "Outbound WhatsApp message kind. Strict enum \u2014 new kinds require a schema version bump (GH#38)."
+    },
+    "outbound-message-status": {
+      "type": "string",
+      "enum": [
+        "accepted",
+        "sent",
+        "delivered",
+        "read",
+        "failed"
+      ],
+      "description": "Outbound WhatsApp message delivery status. Lifecycle: accepted \u2192 sent \u2192 delivered \u2192 read, or accepted \u2192 failed. Updated in-place by Meta delivery callbacks (GH#38)."
+    },
     "payment-method": {
       "type": "string",
       "enum": [
@@ -5602,7 +5621,7 @@
         },
         "receivedAt": {
           "$ref": "#/definitions/firestore-timestamp",
-          "description": "(Read-only) Server-side ingestion time set by the Cloud Function.",
+          "description": "(Read-only) Server-side ingestion timestamp.",
           "readOnly": true
         },
         "text": {
@@ -5627,7 +5646,7 @@
           ]
         },
         "storageUrl": {
-          "description": "Durable Cloud Storage URL for the downloaded media binary. Present after the CF downloads and stores the media.",
+          "description": "Durable Cloud Storage URL for the downloaded media binary. Present after the media has been fetched and stored server-side.",
           "type": [
             "string",
             "null"
@@ -5667,7 +5686,7 @@
         "receivedAt"
       ],
       "additionalProperties": false,
-      "description": "WhatsappInboundMessage \u2014 inbound WhatsApp message persisted from Meta Cloud API webhook (GH#36). Collection: whatsapp_inbound_messages/{docId} in ratenplate project. Top-level scope: company resolution happens post-ingestion.",
+      "description": "WhatsappInboundMessage \u2014 inbound WhatsApp message persisted from Meta Cloud API webhook (GH#36). Collection: whatsapp_inbound_messages/{docId}. Top-level scope: company resolution happens post-ingestion.",
       "example": {
         "id": null,
         "wabaId": "wab_ref123",
@@ -5684,6 +5703,143 @@
         "context": null
       }
     },
+    "whatsapp-outbound-message": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "description": "(Read-only) Firestore document ID \u2014 wamid on success, generated UUID on failure.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "messageId": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) WhatsApp message ID (wamid) on success; generated UUID on send failure."
+        },
+        "to": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) Recipient phone number in E.164 format. Mirrors inbound `from`."
+        },
+        "waba": {
+          "$ref": "#/definitions/waba-label",
+          "description": "(Immutable) WABA that sent the message. Mirrors inbound `waba`.",
+          "x-immutable": true
+        },
+        "wabaId": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) Meta WABA ID. Mirrors inbound `wabaId`."
+        },
+        "sentAt": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "(Read-only) Server-side send timestamp. Mirrors inbound `receivedAt`.",
+          "readOnly": true
+        },
+        "phoneNumberId": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) Meta phone number ID used for the send (specific line within the WABA)."
+        },
+        "kind": {
+          "$ref": "#/definitions/outbound-message-kind",
+          "description": "(Immutable) Message kind.",
+          "x-immutable": true
+        },
+        "templateName": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) WhatsApp template name used for the send."
+        },
+        "status": {
+          "$ref": "#/definitions/outbound-message-status",
+          "description": "Delivery status. Updated in-place by Meta delivery callbacks."
+        },
+        "contactWaId": {
+          "description": "Normalized wa_id returned by Meta on success. May differ from `to`.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "appId": {
+          "description": "Tenant appId when applicable.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "orderUuid": {
+          "description": "Order reference. Present on review_request messages only.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "statusUpdatedAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Timestamp of the last status update from a Meta delivery callback."
+        },
+        "failureCode": {
+          "description": "Meta error code. Present on failed sends only.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        "failureErrors": {
+          "description": "Raw Meta error objects. Present on failed sends only.",
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {}
+        }
+      },
+      "required": [
+        "messageId",
+        "to",
+        "waba",
+        "wabaId",
+        "sentAt",
+        "phoneNumberId",
+        "kind",
+        "templateName",
+        "status"
+      ],
+      "additionalProperties": false,
+      "description": "WhatsappOutboundMessage \u2014 outbound WhatsApp message persisted at send time (GH#38). Collection: whatsapp_outbound_messages/{docId}. Top-level scope. Symmetric counterpart to WhatsappInboundMessage (GH#36).",
+      "example": {
+        "id": null,
+        "messageId": "mes_ref123",
+        "to": "to",
+        "waba": "waba",
+        "wabaId": "wab_ref123",
+        "sentAt": "sentAt",
+        "phoneNumberId": "pho_ref123",
+        "kind": "kind",
+        "templateName": "templateName",
+        "status": "status",
+        "contactWaId": null,
+        "appId": null,
+        "orderUuid": null,
+        "statusUpdatedAt": "statusUpdatedAt",
+        "failureCode": null,
+        "failureErrors": null
+      }
+    },
     "payment-summary": {
       "type": "object",
       "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ingenx-io/valets-schema-mcp-server",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "MCP server exposing @valets/schema documentation to AI agents",
   "type": "module",
   "main": "index.js",