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

package/data/docs/enums/whatsapp-template-component.md

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappTemplateComponent"
 sidebar_label: "WhatsappTemplateComponent"
-sidebar_position: 30
+sidebar_position: 31
 ---
 
 # WhatsappTemplateComponent
@@ -20,4 +20,4 @@ Must be one of:
 * "button"
 
 ----------------------------------------------------------------------------------------------------------------------------
-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 12:42:51 +0000

package/data/docs/enums/whatsapp-template-status.md

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappTemplateStatus"
 sidebar_label: "WhatsappTemplateStatus"
-sidebar_position: 31
+sidebar_position: 32
 ---
 
 # WhatsappTemplateStatus
@@ -23,4 +23,4 @@ Must be one of:
 * "IN_APPEAL"
 
 ----------------------------------------------------------------------------------------------------------------------------
-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 12:42:51 +0000

package/data/docs/index.md

@@ -19,12 +19,13 @@ Developers own the Zod source in `packages/schema/src/`. When schemas change, th
 
 ## What's documented
 
-### Enums (31)
+### Enums (32)
 
 Status enums that drive business logic across Order, Booking, Event, and Loyalty domains:
 
 | Enum | Values | Description |
 |------|--------|-------------|
+| [AppStatus](enums/app-status) | 4 values | Lifecycle status for an App (formerly Site — renamed per decision #40 / D44). Drives whether the app is reachable and whether analytics/payments flow. |
 | [AttentionStatus](enums/attention-status) | 4 values | Operational attention status for Order and Booking (D39). Controls home-page queue assignment. Server-owned — set via triggers or callable fn only. |
 | [BookingStatus](enums/booking-status) | 6 values | Booking lifecycle status. COMPLETED_MIXED = some sessions completed, others cancelled/no-show. |
 | [CustomerPaymentStatus](enums/customer-payment-status) | 6 values | Customer payment lifecycle status (D22). Tracks allocation progress of received payments. |
@@ -58,7 +59,7 @@ Status enums that drive business logic across Order, Booking, Event, and Loyalty
 | [WhatsappTemplateStatus](enums/whatsapp-template-status) | 6 values | Meta review status of a WhatsApp message template, synced from the WhatsApp Business API. Only APPROVED templates can be sent. The fuller Meta status set is used deliberately (vs just APPROVED/PENDING/REJECTED) so this enum has a distinct value signature from PaymentProofStatus in the JSON-Schema $ref matcher (GH#43). |
 
 
-### Models (32)
+### Models (35)
 
 Core Firestore document schemas:
 
@@ -69,6 +70,8 @@ Core Firestore document schemas:
 | [AnalyticsDaily](models/analytics-daily) | 16 | 14 | — |
 | [AnalyticsEvent](models/analytics-event) | 12 | 10 | — |
 | [AnalyticsHourly](models/analytics-hourly) | 17 | 15 | — |
+| [App](models/app) | 14 | 6 | — |
+| [AppPayment](models/app-payment) | 10 | 9 | — |
 | [Booking](models/booking) | 52 | 7 | — |
 | [BookingVersion](models/booking-version) | 9 | 6 | — |
 | [Customer](models/customer) | 17 | 4 | — |
@@ -80,9 +83,9 @@ Core Firestore document schemas:
 | [LoyaltyStatus](models/loyalty-status) | 9 | 2 | — |
 | [LoyaltyTransaction](models/loyalty-transaction) | 16 | 4 | — |
 | [MagicLinkRequest](models/magic-link-request) | 15 | 11 | — |
-| [MetricsCurrent](models/metrics-current) | 25 | 25 | — |
-| [MetricsDaily](models/metrics-daily) | 26 | 26 | — |
-| [MetricsMonthly](models/metrics-monthly) | 26 | 26 | — |
+| [MetricsCurrent](models/metrics-current) | 30 | 25 | — |
+| [MetricsDaily](models/metrics-daily) | 31 | 26 | — |
+| [MetricsMonthly](models/metrics-monthly) | 31 | 26 | — |
 | [NotificationRecord](models/notification-record) | 12 | 6 | — |
 | [Order](models/order) | 48 | 8 | — |
 | [OrderItem](models/order-item) | 12 | 3 | — |
@@ -92,6 +95,7 @@ Core Firestore document schemas:
 | [Stocktake](models/stocktake) | 21 | 11 | — |
 | [StocktakeItem](models/stocktake-item) | 16 | 8 | — |
 | [Ticket](models/ticket) | 16 | 6 | — |
+| [User](models/user) | 9 | 0 | — |
 | [WhatsappInboundMessage](models/whatsapp-inbound-message) | 13 | 7 | — |
 | [WhatsappOutboundLifecycleEvent](models/whatsapp-outbound-lifecycle-event) | 11 | 2 | — |
 | [WhatsappOutboundMessage](models/whatsapp-outbound-message) | 18 | 7 | — |

package/data/docs/models/allowed-user.md

@@ -13,7 +13,7 @@ sidebar_position: 1
 {
   "id": null,
   "companyId": "comp_xyz789",
-  "siteId": "sit_ref123",
+  "appId": "app_ref123",
   "contact": "contact",
   "tier": "Gold",
   "amount": 45000,
@@ -28,7 +28,7 @@ sidebar_position: 1
 
 - [1. Property `id`](#id)
 - [2. Property `companyId`](#companyId)
-- [3. Property `siteId`](#siteId)
+- [3. Property `appId`](#appId)
 - [4. Property `contact`](#contact)
 - [5. Property `tier`](#tier)
 - [6. Property `amount`](#amount)
@@ -45,13 +45,13 @@ sidebar_position: 1
 | **Additional properties** | Not allowed                |
 | **Defined in**            | #/definitions/allowed-user |
 
-**Description:** AllowedUser model (D40 / ING-304). Collection: companies/\{companyId\}/sites/\{siteId\}/allowed_users/\{contactId\}. Authoritative paid-access allowlist. Upsert semantics — tier upgrades overwrite. Source of truth for access checks and referral code resolution.
+**Description:** AllowedUser model (D40 / ING-304). Collection: companies/\{companyId\}/apps/\{appId\}/allowed_users/\{contactId\}. Authoritative paid-access allowlist. Upsert semantics — tier upgrades overwrite. Source of truth for access checks and referral code resolution.
 
 | Property                           | Pattern | Type           | Deprecated | Definition                           | Title/Description                                                                                |
 | ---------------------------------- | ------- | -------------- | ---------- | ------------------------------------ | ------------------------------------------------------------------------------------------------ |
 | - [id](#id )                       | No      | string or null | No         | -                                    | (Read-only) Firestore document ID = contact identifier (email or E.164 phone), URL-escaped.      |
 | + [companyId](#companyId )         | No      | string         | No         | -                                    | (Immutable) FK → Company document ID.                                                            |
-| + [siteId](#siteId )               | No      | string         | No         | -                                    | (Immutable) FK → Site document ID (D40 sub-tenant scope).                                        |
+| + [appId](#appId )                 | No      | string         | No         | -                                    | (Immutable) FK → App document ID (D40 sub-tenant scope, renamed per D44).                        |
 | + [contact](#contact )             | No      | string         | No         | -                                    | Email or E.164 phone number. Canonical identifier for this user within the site.                 |
 | + [tier](#tier )                   | No      | string         | No         | -                                    | Access tier. Free string per site (ING-304 open question — tier values are site-specific today). |
 | + [amount](#amount )               | No      | number         | No         | -                                    | Amount paid. Generalized from amount_xof per D40 decision.                                       |
@@ -85,14 +85,14 @@ Do not include in write requests. This field is set exclusively by the server (F
 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="siteId"></a>3. Property `siteId`
+## <a name="appId"></a>3. Property `appId`
 
 |              |          |
 | ------------ | -------- |
 | **Type**     | `string` |
 | **Required** | Yes      |
 
-**Description:** (Immutable) FK → Site document ID (D40 sub-tenant scope).
+**Description:** (Immutable) FK → App document ID (D40 sub-tenant scope, renamed per D44).
 
 :::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.
@@ -185,4 +185,4 @@ Set at creation only. This field cannot be modified after the document is create
 | **Maximum**  | &le; 9007199254740991  |
 
 ----------------------------------------------------------------------------------------------------------------------------
-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 12:42:50 +0000

package/data/docs/models/analytics-backfill.md

@@ -13,7 +13,7 @@ sidebar_position: 2
 {
   "id": null,
   "companyId": "comp_xyz789",
-  "siteId": "sit_ref123",
+  "appId": "app_ref123",
   "status": "pending",
   "from": "from",
   "to": "to",
@@ -39,7 +39,7 @@ sidebar_position: 2
 
 - [1. Property `id`](#id)
 - [2. Property `companyId`](#companyId)
-- [3. Property `siteId`](#siteId)
+- [3. Property `appId`](#appId)
 - [4. Property `status`](#status)
 - [5. Property `from`](#from)
 - [6. Property `to`](#to)
@@ -68,13 +68,13 @@ sidebar_position: 2
 | **Additional properties** | Not allowed                      |
 | **Defined in**            | #/definitions/analytics-backfill |
 
-**Description:** AnalyticsBackfill run (D42 / ING-304). Collection: companies/\{companyId\}/sites/\{siteId\}/analytics_backfills/\{runId\}. Tracks admin-triggered rollup backfill jobs; supports dry-run.
+**Description:** AnalyticsBackfill run (D42 / ING-304). Collection: companies/\{companyId\}/apps/\{appId\}/analytics_backfills/\{runId\}. Tracks admin-triggered rollup backfill jobs; supports dry-run.
 
 | Property                             | Pattern | Type             | Deprecated | Definition                           | Title/Description                                                                               |
 | ------------------------------------ | ------- | ---------------- | ---------- | ------------------------------------ | ----------------------------------------------------------------------------------------------- |
 | - [id](#id )                         | No      | string or null   | No         | -                                    | (Read-only) Firestore document ID, auto-generated.                                              |
 | + [companyId](#companyId )           | No      | string           | No         | -                                    | (Immutable) FK → Company document ID.                                                           |
-| + [siteId](#siteId )                 | No      | string           | No         | -                                    | (Immutable) FK → Site document ID (D40).                                                        |
+| + [appId](#appId )                   | No      | string           | No         | -                                    | (Immutable) FK → Site document ID (D40).                                                        |
 | + [status](#status )                 | No      | enum (of string) | No         | -                                    | Run status.                                                                                     |
 | + [from](#from )                     | No      | string           | No         | -                                    | (Immutable) Inclusive start date (\`YYYY-MM-DD\`, UTC).                                         |
 | + [to](#to )                         | No      | string           | No         | -                                    | (Immutable) Inclusive end date (\`YYYY-MM-DD\`, UTC).                                           |
@@ -111,7 +111,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 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="siteId"></a>3. Property `siteId`
+## <a name="appId"></a>3. Property `appId`
 
 |              |          |
 | ------------ | -------- |
@@ -381,7 +381,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Additional properties** | Not allowed            |
 | **Same definition as**    | [at](#errors_items_at) |
 
-**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="completedAt_anyOf_i1"></a>12.2. Property `item 1`
 
@@ -391,7 +391,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:05 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 12:42:50 +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/analytics-daily.md

@@ -23,7 +23,7 @@ sidebar_position: 3
   "eventCounts": {},
   "id": null,
   "companyId": "comp_xyz789",
-  "siteId": "sit_ref123",
+  "appId": "app_ref123",
   "date": "2026-02-15",
   "computedAt": "computedAt",
   "sourceEventCount": null
@@ -46,7 +46,7 @@ sidebar_position: 3
   - [10.1. Property `additionalProperties`](#eventCounts_additionalProperties)
 - [11. Property `id`](#id)
 - [12. Property `companyId`](#companyId)
-- [13. Property `siteId`](#siteId)
+- [13. Property `appId`](#appId)
 - [14. Property `date`](#date)
 - [15. Property `computedAt`](#computedAt)
   - [15.1. Property `_seconds`](#computedAt__seconds)
@@ -60,7 +60,7 @@ sidebar_position: 3
 | **Additional properties** | Not allowed                   |
 | **Defined in**            | #/definitions/analytics-daily |
 
-**Description:** AnalyticsDaily rollup (D42 / ING-304). Collection: companies/\{companyId\}/sites/\{siteId\}/analytics_daily/\{YYYY-MM-DD\}. Idempotent set/merge — reruns overwrite. Fall back to raw analytics_events for uncovered slices.
+**Description:** AnalyticsDaily rollup (D42 / ING-304). Collection: companies/\{companyId\}/apps/\{appId\}/analytics_daily/\{YYYY-MM-DD\}. Idempotent set/merge — reruns overwrite. Fall back to raw analytics_events for uncovered slices.
 
 | Property                                   | Pattern | Type            | Deprecated | Definition                           | Title/Description                                                                                          |
 | ------------------------------------------ | ------- | --------------- | ---------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
@@ -76,7 +76,7 @@ sidebar_position: 3
 | + [eventCounts](#eventCounts )             | No      | object          | No         | -                                    | Per-event-name counts — key is the event name (canonical or custom), value is the count within the bucket. |
 | - [id](#id )                               | No      | string or null  | No         | -                                    | (Read-only) Firestore document ID = \`YYYY-MM-DD\`.                                                        |
 | + [companyId](#companyId )                 | No      | string          | No         | -                                    | (Immutable) FK → Company document ID.                                                                      |
-| + [siteId](#siteId )                       | No      | string          | No         | -                                    | (Immutable) FK → Site document ID (D40).                                                                   |
+| + [appId](#appId )                         | No      | string          | No         | -                                    | (Immutable) FK → Site document ID (D40).                                                                   |
 | + [date](#date )                           | No      | string          | No         | -                                    | (Immutable) \`YYYY-MM-DD\` UTC — matches document ID.                                                      |
 | + [computedAt](#computedAt )               | No      | object          | No         | In #/definitions/firestore-timestamp | (Read-only) When this rollup was last (re)computed. Updated on every set/merge.                            |
 | - [sourceEventCount](#sourceEventCount )   | No      | integer or null | No         | -                                    | (Read-only, Optional) Total source events scanned when producing this rollup. Useful for dry-run diffing.  |
@@ -259,7 +259,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 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="siteId"></a>13. Property `siteId`
+## <a name="appId"></a>13. Property `appId`
 
 |              |          |
 | ------------ | -------- |
@@ -344,7 +344,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Maximum**  | &le; 9007199254740991  |
 
 ----------------------------------------------------------------------------------------------------------------------------
-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 12:42:50 +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/analytics-event.md

@@ -13,7 +13,7 @@ sidebar_position: 4
 {
   "id": null,
   "companyId": "comp_xyz789",
-  "siteId": "sit_ref123",
+  "appId": "app_ref123",
   "eventId": "eve_ref123",
   "eventName": "eventName",
   "timestamp": "timestamp",
@@ -31,7 +31,7 @@ sidebar_position: 4
 
 - [1. Property `id`](#id)
 - [2. Property `companyId`](#companyId)
-- [3. Property `siteId`](#siteId)
+- [3. Property `appId`](#appId)
 - [4. Property `eventId`](#eventId)
 - [5. Property `eventName`](#eventName)
 - [6. Property `timestamp`](#timestamp)
@@ -77,13 +77,13 @@ sidebar_position: 4
 | **Additional properties** | Not allowed                   |
 | **Defined in**            | #/definitions/analytics-event |
 
-**Description:** AnalyticsEvent model (D40 / ING-304). Collection: companies/\{companyId\}/sites/\{siteId\}/analytics_events/\{eventId\}. Append-only, immutable product/behavior event stream. Event names are free strings; canonical vocabulary in CANONICAL_ANALYTICS_EVENT_NAMES.
+**Description:** AnalyticsEvent model (D40 / ING-304). Collection: companies/\{companyId\}/apps/\{appId\}/analytics_events/\{eventId\}. Append-only, immutable product/behavior event stream. Event names are free strings; canonical vocabulary in CANONICAL_ANALYTICS_EVENT_NAMES.
 
 | Property                               | Pattern | Type           | Deprecated | Definition                           | Title/Description                                                                                                |
 | -------------------------------------- | ------- | -------------- | ---------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
 | - [id](#id )                           | No      | string or null | No         | -                                    | (Read-only) Firestore document ID. Equal to eventId.                                                             |
 | + [companyId](#companyId )             | No      | string         | No         | -                                    | (Immutable) FK → Company document ID.                                                                            |
-| + [siteId](#siteId )                   | No      | string         | No         | -                                    | (Immutable) FK → Site document ID (D40 sub-tenant scope).                                                        |
+| + [appId](#appId )                     | No      | string         | No         | -                                    | (Immutable) FK → App document ID (D40 sub-tenant scope, renamed per D44).                                        |
 | + [eventId](#eventId )                 | No      | string         | No         | -                                    | (Immutable) Client-generated UUID. Matches document ID.                                                          |
 | + [eventName](#eventName )             | No      | string         | No         | -                                    | Event name. Free string; canonical vocabulary is encouraged (see CANONICAL_ANALYTICS_EVENT_NAMES).               |
 | + [timestamp](#timestamp )             | No      | string         | No         | -                                    | Client-side ISO 8601 — "when it happened on device". Can diverge from serverTimestamp for queued offline events. |
@@ -120,14 +120,14 @@ Do not include in write requests. This field is set exclusively by the server (F
 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="siteId"></a>3. Property `siteId`
+## <a name="appId"></a>3. Property `appId`
 
 |              |          |
 | ------------ | -------- |
 | **Type**     | `string` |
 | **Required** | Yes      |
 
-**Description:** (Immutable) FK → Site document ID (D40 sub-tenant scope).
+**Description:** (Immutable) FK → App document ID (D40 sub-tenant scope, renamed per D44).
 
 :::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.
@@ -530,4 +530,4 @@ Must be one of:
 | **Additional properties** | Any type allowed |
 
 ----------------------------------------------------------------------------------------------------------------------------
-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 12:42:50 +0000

package/data/docs/models/analytics-hourly.md

@@ -23,7 +23,7 @@ sidebar_position: 5
   "eventCounts": {},
   "id": null,
   "companyId": "comp_xyz789",
-  "siteId": "sit_ref123",
+  "appId": "app_ref123",
   "date": "2026-02-15",
   "hour": 0,
   "computedAt": "computedAt",
@@ -47,7 +47,7 @@ sidebar_position: 5
   - [10.1. Property `additionalProperties`](#eventCounts_additionalProperties)
 - [11. Property `id`](#id)
 - [12. Property `companyId`](#companyId)
-- [13. Property `siteId`](#siteId)
+- [13. Property `appId`](#appId)
 - [14. Property `date`](#date)
 - [15. Property `hour`](#hour)
 - [16. Property `computedAt`](#computedAt)
@@ -62,7 +62,7 @@ sidebar_position: 5
 | **Additional properties** | Not allowed                    |
 | **Defined in**            | #/definitions/analytics-hourly |
 
-**Description:** AnalyticsHourly rollup (D42 / ING-304). Collection: companies/\{companyId\}/sites/\{siteId\}/analytics_hourly/\{YYYY-MM-DD-HH\}. Scheduled-CF writer; idempotent set/merge.
+**Description:** AnalyticsHourly rollup (D42 / ING-304). Collection: companies/\{companyId\}/apps/\{appId\}/analytics_hourly/\{YYYY-MM-DD-HH\}. Scheduled-CF writer; idempotent set/merge.
 
 | Property                                   | Pattern | Type            | Deprecated | Definition                           | Title/Description                                                                                          |
 | ------------------------------------------ | ------- | --------------- | ---------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
@@ -78,7 +78,7 @@ sidebar_position: 5
 | + [eventCounts](#eventCounts )             | No      | object          | No         | -                                    | Per-event-name counts — key is the event name (canonical or custom), value is the count within the bucket. |
 | - [id](#id )                               | No      | string or null  | No         | -                                    | (Read-only) Firestore document ID = \`YYYY-MM-DD-HH\`.                                                     |
 | + [companyId](#companyId )                 | No      | string          | No         | -                                    | (Immutable) FK → Company document ID.                                                                      |
-| + [siteId](#siteId )                       | No      | string          | No         | -                                    | (Immutable) FK → Site document ID (D40).                                                                   |
+| + [appId](#appId )                         | No      | string          | No         | -                                    | (Immutable) FK → Site document ID (D40).                                                                   |
 | + [date](#date )                           | No      | string          | No         | -                                    | (Immutable) \`YYYY-MM-DD\` UTC for the bucket day.                                                         |
 | + [hour](#hour )                           | No      | integer         | No         | -                                    | (Immutable) UTC hour of day, 0–23.                                                                         |
 | + [computedAt](#computedAt )               | No      | object          | No         | In #/definitions/firestore-timestamp | (Read-only) When this rollup was last (re)computed.                                                        |
@@ -262,7 +262,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 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="siteId"></a>13. Property `siteId`
+## <a name="appId"></a>13. Property `appId`
 
 |              |          |
 | ------------ | -------- |
@@ -365,7 +365,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Maximum**  | &le; 9007199254740991  |
 
 ----------------------------------------------------------------------------------------------------------------------------
-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 12:42:50 +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/app-payment.md

@@ -0,0 +1,200 @@
+---
+title: "AppPayment"
+sidebar_label: "AppPayment"
+sidebar_position: 7
+---
+
+# AppPayment
+
+<details>
+<summary>Example JSON</summary>
+
+```json
+{
+  "id": null,
+  "companyId": "comp_xyz789",
+  "appId": "app_ref123",
+  "contact": "contact",
+  "sessionId": "ses_ref123",
+  "transactionId": "tra_ref123",
+  "tier": "Gold",
+  "amount": 45000,
+  "currency": "XOF",
+  "paidAt": "pai_ref123"
+}
+```
+
+</details>
+
+
+- [1. Property `id`](#id)
+- [2. Property `companyId`](#companyId)
+- [3. Property `appId`](#appId)
+- [4. Property `contact`](#contact)
+- [5. Property `sessionId`](#sessionId)
+- [6. Property `transactionId`](#transactionId)
+- [7. Property `tier`](#tier)
+- [8. Property `amount`](#amount)
+- [9. Property `currency`](#currency)
+- [10. Property `paidAt`](#paidAt)
+  - [10.1. Property `_seconds`](#paidAt__seconds)
+  - [10.2. Property `_nanoseconds`](#paidAt__nanoseconds)
+
+|                           |                           |
+| ------------------------- | ------------------------- |
+| **Type**                  | `object`                  |
+| **Required**              | No                        |
+| **Additional properties** | Not allowed               |
+| **Defined in**            | #/definitions/app-payment |
+
+**Description:** AppPayment model (D40 / ING-304). Collection: companies/\{companyId\}/apps/\{appId\}/payments/\{paymentId\}. Immutable append-only transaction ledger. Distinct from AllowedUser (access state) and CustomerPayment (D22 — customer-level billing).
+
+| Property                           | Pattern | Type           | Deprecated | Definition                           | Title/Description                                                                      |
+| ---------------------------------- | ------- | -------------- | ---------- | ------------------------------------ | -------------------------------------------------------------------------------------- |
+| - [id](#id )                       | No      | string or null | No         | -                                    | (Read-only) Firestore document ID, auto-generated.                                     |
+| + [companyId](#companyId )         | No      | string         | No         | -                                    | (Immutable) FK → Company document ID.                                                  |
+| + [appId](#appId )                 | No      | string         | No         | -                                    | (Immutable) FK → App document ID (D40 sub-tenant scope, renamed from siteId per D44).  |
+| + [contact](#contact )             | No      | string         | No         | -                                    | Email or E.164 phone number. Matches AllowedUser.contact.                              |
+| + [sessionId](#sessionId )         | No      | string         | No         | -                                    | Payment provider checkout session ID (e.g. Wave). Usable for dedup across dual writes. |
+| + [transactionId](#transactionId ) | No      | string         | No         | -                                    | Payment provider transaction ID.                                                       |
+| + [tier](#tier )                   | No      | string         | No         | -                                    | Access tier. Free string per app (ING-304 open question).                              |
+| + [amount](#amount )               | No      | number         | No         | -                                    | Amount paid. Generalized from amount_xof per D40 decision.                             |
+| + [currency](#currency )           | No      | string         | No         | -                                    | Currency code (ISO 4217). Defaults to XOF for legacy SR-Single parity.                 |
+| + [paidAt](#paidAt )               | No      | object         | No         | In #/definitions/firestore-timestamp | RFC3339Nano UTC when payment was completed.                                            |
+
+## <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="companyId"></a>2. Property `companyId`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** (Immutable) FK → Company document ID.
+
+:::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="appId"></a>3. Property `appId`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** (Immutable) FK → App document ID (D40 sub-tenant scope, renamed from siteId per D44).
+
+:::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="contact"></a>4. Property `contact`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Email or E.164 phone number. Matches AllowedUser.contact.
+
+## <a name="sessionId"></a>5. Property `sessionId`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Payment provider checkout session ID (e.g. Wave). Usable for dedup across dual writes.
+
+## <a name="transactionId"></a>6. Property `transactionId`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Payment provider transaction ID.
+
+## <a name="tier"></a>7. Property `tier`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Access tier. Free string per app (ING-304 open question).
+
+## <a name="amount"></a>8. Property `amount`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `number` |
+| **Required** | Yes      |
+
+**Description:** Amount paid. Generalized from amount_xof per D40 decision.
+
+## <a name="currency"></a>9. Property `currency`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+| **Default**  | `"XOF"`  |
+
+**Description:** Currency code (ISO 4217). Defaults to XOF for legacy SR-Single parity.
+
+## <a name="paidAt"></a>10. Property `paidAt`
+
+|                           |                                   |
+| ------------------------- | --------------------------------- |
+| **Type**                  | `object`                          |
+| **Required**              | Yes                               |
+| **Additional properties** | Not allowed                       |
+| **Defined in**            | #/definitions/firestore-timestamp |
+
+**Description:** RFC3339Nano UTC when payment was completed.
+
+| Property                                | Pattern | Type    | Deprecated | Definition | Title/Description |
+| --------------------------------------- | ------- | ------- | ---------- | ---------- | ----------------- |
+| + [_seconds](#paidAt__seconds )         | No      | integer | No         | -          | -                 |
+| + [_nanoseconds](#paidAt__nanoseconds ) | No      | integer | No         | -          | -                 |
+
+### <a name="paidAt__seconds"></a>10.1. Property `_seconds`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+### <a name="paidAt__nanoseconds"></a>10.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 12:42:50 +0000