@ingenx-io/valets-schema-mcp-server 0.1.3 → 0.1.4

package/data/docs/models/ticket.md

@@ -1,7 +1,7 @@
 ---
 title: "Ticket"
 sidebar_label: "Ticket"
-sidebar_position: 17
+sidebar_position: 21
 ---
 
 # 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-04-06 at 19:27:48 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +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/static/llms.txt

@@ -4,12 +4,16 @@
 > Source of truth: Zod schemas in packages/schema/src/
 > All Firestore documents are scoped under companies/{companyId}/
 
-> Generated: 2026-04-06
+> Generated: 2026-04-18
 
 ---
 
 ## Enums
 
+### AttentionStatus
+Operational attention status for Order and Booking (D39). Controls home-page queue assignment. Server-owned — set via triggers or callable fn only.
+Values: ACTIVE, STALE, ON_HOLD, ESCALATED
+
 ### BookingStatus
 Booking lifecycle status. COMPLETED_MIXED = some sessions completed, others cancelled/no-show.
 Values: PENDING, CONFIRMED, COMPLETED, CANCELLED, CANCELLATION_REQUESTED, COMPLETED_MIXED
@@ -54,6 +58,10 @@ Values: PENDING, APPROVED, REJECTED
 Payment lifecycle status (D01 amended). Used by Order, Sale/Purchase, Booking.
 Values: PENDING, PAID, PARTIALLY_PAID, FAILED, REFUND_PROCESSING, REFUNDED, PARTIALLY_REFUNDED
 
+### PendingIssue
+Specific detected conditions on an Order or Booking requiring human action (D39). Stored as an array — multiple issues can be active simultaneously. Server-owned.
+Values: PAYMENT_PROOF_PENDING, PAYMENT_PROOF_REJECTED, AMOUNT_DISCREPANCY, RETURN_UNRESOLVED, OVERDUE_DELIVERY, SESSION_OVERDUE, PAYMENT_INCOMPLETE, CANCELLATION_REQUESTED, UNREFUNDED_CANCELLATION, UPCOMING_UNPAID, NO_SHOW_UNRESOLVED
+
 ### ReturnStatus
 Post-sale return/exchange lifecycle (D34). Optional — null until return or exchange initiated.
 Values: RETURN_REQUESTED, RETURN_PROCESSING, RETURNED, EXCHANGE_REQUESTED, EXCHANGE_PROCESSING, EXCHANGE_COMPLETED
@@ -70,6 +78,87 @@ Values: VALID, USED, CANCELLED
 
 ## Models
 
+### AllowedUser
+Fields: 9 (8 required)
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| id | ['string', 'null'] | no | (Read-only) Firestore document ID = contact identifier (email or E.164 phone), URL-escaped. |
+| companyId | string | yes | (Immutable) FK → Company document ID. |
+| siteId | string | yes | (Immutable) FK → Site document ID (D40 sub-tenant scope). |
+| contact | string | yes | Email or E.164 phone number. Canonical identifier for this user within the site. |
+| tier | string | yes | Access tier. Free string per site (ING-304 open question — tier values are site-specific today). |
+| amount | number | yes | Amount paid. Generalized from amount_xof per D40 decision. |
+| currency | string | yes | Currency code (ISO 4217). Defaults to XOF for legacy SR-Single parity. |
+| transactionId | string | yes | Payment provider transaction ID (e.g. Wave). |
+| paidAt | FirestoreTimestamp | yes | RFC3339Nano UTC when payment was completed. |
+
+Example:
+```json
+{
+  "id": null,
+  "companyId": "comp_xyz789",
+  "siteId": "sit_ref123",
+  "contact": "contact",
+  "tier": "Gold",
+  "amount": 45000,
+  "currency": "XOF",
+  "transactionId": "tra_ref123",
+  "paidAt": "pai_ref123"
+}
+```
+
+### AnalyticsEvent
+Fields: 12 (10 required)
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| id | ['string', 'null'] | no | (Read-only) Firestore document ID. Equal to eventId. |
+| companyId | string | yes | (Immutable) FK → Company document ID. |
+| siteId | string | yes | (Immutable) FK → Site document ID (D40 sub-tenant scope). |
+| eventId | string | yes | (Immutable) Client-generated UUID. Matches document ID. |
+| eventName | string | yes | Event name. Free string; canonical vocabulary is encouraged (see CANONICAL_ANALYTICS_EVENT_NAMES). |
+| timestamp | string | yes | Client-side ISO 8601 — "when it happened on device". Can diverge from serverTimestamp for queued offline events. |
+| serverTimestamp | FirestoreTimestamp | yes | (Read-only) Firestore serverTimestamp() — authoritative for ordering. |
+| sessionId | string | yes | 30-minute rolling session identifier. |
+| userId | any | yes | Stable user ID if identified; explicitly null (not omitted) for anonymous sessions — simplifies querying. |
+| properties | object | yes | Free-form event-specific payload. Contract is at the event-name level. PII posture: follow-up issue pending. |
+| context | object | yes | Environment context at event time (nested per D40). |
+| context.url | string | no | Full URL at event time. |
+| context.origin | string | no | Protocol + host. |
+| context.hostname | string | no | Hostname only — useful for deployment identification. |
+| context.page | string | no | Current route/pathname. |
+| context.title | string | no | Page title. |
+| context.referrer | string | no | Referrer URL. |
+| context.deviceType | enum(3) | no |  |
+| context.platform | string | no | OS/platform string. |
+| context.screenWidth | integer | no | Viewport width (flattened from screen.width). |
+| context.screenHeight | integer | no | Viewport height (flattened from screen.height). |
+| context.appVersion | string | no | Consuming app version. |
+| context.online | boolean | no | Connectivity state at event time. |
+| context.locale | string | no | User locale. |
+| context.timezone | string | no | IANA timezone. |
+| context.utm | any | no | UTM parameters; null when not a campaign-landed session. |
+| userTraits | ['object', 'null'] | no | Optional — included only when includeUserTraits: true on the write. PII posture: follow-up issue pending. |
+
+Example:
+```json
+{
+  "id": null,
+  "companyId": "comp_xyz789",
+  "siteId": "sit_ref123",
+  "eventId": "eve_ref123",
+  "eventName": "eventName",
+  "timestamp": "timestamp",
+  "serverTimestamp": "serverTimestamp",
+  "sessionId": "ses_ref123",
+  "userId": "use_ref123",
+  "properties": {},
+  "context": {},
+  "userTraits": null
+}
+```
+
 ### Booking
 Fields: 52 (7 required)
 
@@ -586,6 +675,48 @@ Example:
 }
 ```
 
+### MagicLinkRequest
+Fields: 15 (11 required)
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| id | ['string', 'null'] | no | (Read-only) Firestore document ID. 16-byte random hex. |
+| companyId | string | yes | (Immutable) FK → Company document ID. |
+| siteId | string | yes | (Immutable) FK → Site document ID (D40 sub-tenant scope). |
+| email | string | yes | Populated if identifier is email; empty string if phone. Mutually exclusive with phone per document. |
+| phone | string | yes | Populated if identifier is E.164 format (starts with +); empty string if email. |
+| ip | string | yes | Client IP from X-Forwarded-For or RemoteAddr. |
+| allowed | boolean | yes | Whether the user passed the access control check. |
+| link | string | yes | Magic-link URL — non-empty only when DEV_MODE=true; empty in production (audit integrity). |
+| tier | string | yes | Access tier selected by the user. Free string per site (ING-304 open question — tier values are site-specific today). |
+| authStatusReason | string | yes | Outcome reason code: whitelist | allowed_users | payment_redirect | payment_complete | not_allowed | redirected_to_payment. |
+| referredBy | string | yes | Contact identifier of the referrer, resolved from submitted referral_code; empty if none. |
+| requestedAt | FirestoreTimestamp | yes | RFC3339Nano UTC at request time. |
+| verifyReason | ['string', 'null'] | no | Verify outcome reason: mirrors authStatusReason on success, or link_expired | link_invalid | not_allowed. |
+| verified | ['boolean', 'null'] | no | Whether the verify attempt succeeded. |
+| verifiedAt | any | no | RFC3339Nano UTC at verify time. |
+
+Example:
+```json
+{
+  "id": null,
+  "companyId": "comp_xyz789",
+  "siteId": "sit_ref123",
+  "email": "amadou@example.com",
+  "phone": "+225 07 00 11 22",
+  "ip": "ip",
+  "allowed": true,
+  "link": "link",
+  "tier": "Gold",
+  "authStatusReason": "Customer request",
+  "referredBy": "referredBy",
+  "requestedAt": "requestedAt",
+  "verifyReason": null,
+  "verified": null,
+  "verifiedAt": "verifiedAt"
+}
+```
+
 ### MetricsCurrent
 Fields: 25 (25 required)
 
@@ -954,6 +1085,38 @@ Example:
 }
 ```
 
+### SitePayment
+Fields: 10 (9 required)
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| id | ['string', 'null'] | no | (Read-only) Firestore document ID, auto-generated. |
+| companyId | string | yes | (Immutable) FK → Company document ID. |
+| siteId | string | yes | (Immutable) FK → Site document ID (D40 sub-tenant scope). |
+| contact | string | yes | Email or E.164 phone number. Matches AllowedUser.contact. |
+| sessionId | string | yes | Payment provider checkout session ID (e.g. Wave). Usable for dedup across dual writes. |
+| transactionId | string | yes | Payment provider transaction ID. |
+| tier | string | yes | Access tier. Free string per site (ING-304 open question). |
+| amount | number | yes | Amount paid. Generalized from amount_xof per D40 decision. |
+| currency | string | yes | Currency code (ISO 4217). Defaults to XOF for legacy SR-Single parity. |
+| paidAt | FirestoreTimestamp | yes | RFC3339Nano UTC when payment was completed. |
+
+Example:
+```json
+{
+  "id": null,
+  "companyId": "comp_xyz789",
+  "siteId": "sit_ref123",
+  "contact": "contact",
+  "sessionId": "ses_ref123",
+  "transactionId": "tra_ref123",
+  "tier": "Gold",
+  "amount": 45000,
+  "currency": "XOF",
+  "paidAt": "pai_ref123"
+}
+```
+
 ### Ticket
 Fields: 16 (6 required)