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

package/data/docs/models/app.md

@@ -0,0 +1,585 @@
+---
+title: "App"
+sidebar_label: "App"
+sidebar_position: 6
+---
+
+# App
+
+<details>
+<summary>Example JSON</summary>
+
+```json
+{
+  "id": null,
+  "companyId": "comp_xyz789",
+  "name": "Amadou Diallo",
+  "description": null,
+  "status": "status",
+  "deploymentLinks": [
+    {
+      "label": "label",
+      "url": "https://storage.example.com/url.jpg",
+      "type": "phone"
+    }
+  ],
+  "expiresAt": "expiresAt",
+  "isExpired": null,
+  "createdAt": "createdAt",
+  "updatedAt": "updatedAt",
+  "createdBy": "staff_k0f1",
+  "analyticsEnabled": true,
+  "lastAnalyticsSync": "lastAnalyticsSync",
+  "cachedMetrics": null
+}
+```
+
+</details>
+
+
+- [1. Property `id`](#id)
+- [2. Property `companyId`](#companyId)
+- [3. Property `name`](#name)
+- [4. Property `description`](#description)
+- [5. Property `status`](#status)
+  - [5.1. Property `app-status`](#status_anyOf_i0)
+  - [5.2. Property `item 1`](#status_anyOf_i1)
+- [6. Property `deploymentLinks`](#deploymentLinks)
+  - [6.1. deploymentLinks items](#deploymentLinks_items)
+    - [6.1.1. Property `label`](#deploymentLinks_items_label)
+    - [6.1.2. Property `url`](#deploymentLinks_items_url)
+    - [6.1.3. Property `type`](#deploymentLinks_items_type)
+    - [6.1.4. Property `isPrimary`](#deploymentLinks_items_isPrimary)
+- [7. Property `expiresAt`](#expiresAt)
+  - [7.1. Property `firestore-timestamp`](#expiresAt_anyOf_i0)
+    - [7.1.1. Property `_seconds`](#expiresAt_anyOf_i0__seconds)
+    - [7.1.2. Property `_nanoseconds`](#expiresAt_anyOf_i0__nanoseconds)
+  - [7.2. Property `item 1`](#expiresAt_anyOf_i1)
+- [8. Property `isExpired`](#isExpired)
+- [9. Property `createdAt`](#createdAt)
+  - [9.1. Property `firestore-timestamp`](#createdAt_anyOf_i0)
+  - [9.2. Property `item 1`](#createdAt_anyOf_i1)
+- [10. Property `updatedAt`](#updatedAt)
+  - [10.1. Property `firestore-timestamp`](#updatedAt_anyOf_i0)
+  - [10.2. Property `item 1`](#updatedAt_anyOf_i1)
+- [11. Property `createdBy`](#createdBy)
+- [12. Property `analyticsEnabled`](#analyticsEnabled)
+- [13. Property `lastAnalyticsSync`](#lastAnalyticsSync)
+  - [13.1. Property `firestore-timestamp`](#lastAnalyticsSync_anyOf_i0)
+  - [13.2. Property `item 1`](#lastAnalyticsSync_anyOf_i1)
+- [14. Property `cachedMetrics`](#cachedMetrics)
+  - [14.1. Property `totalEvents`](#cachedMetrics_totalEvents)
+  - [14.2. Property `totalPageViews`](#cachedMetrics_totalPageViews)
+  - [14.3. Property `totalSessions`](#cachedMetrics_totalSessions)
+  - [14.4. Property `totalOrders`](#cachedMetrics_totalOrders)
+  - [14.5. Property `lastEventAt`](#cachedMetrics_lastEventAt)
+
+|                           |                   |
+| ------------------------- | ----------------- |
+| **Type**                  | `object`          |
+| **Required**              | No                |
+| **Additional properties** | Not allowed       |
+| **Defined in**            | #/definitions/app |
+
+**Description:** App model (D41 / ING-304). Collection: companies/\{companyId\}/apps/\{appId\}. Per-company product surface. Sub-collections (magic_link_requests, allowed_users, payments, analytics_events, analytics_daily, analytics_hourly, analytics_backfills) live under this document per D40/D42.
+
+| 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. Scopes all app sub-collections.                                                                   |
+| + [name](#name )                           | No      | string          | No         | -          | Human-readable app name shown in dashboards.                                                                                            |
+| - [description](#description )             | No      | string or null  | No         | -          | Optional freeform description.                                                                                                          |
+| - [status](#status )                       | No      | Combination     | No         | -          | Lifecycle status (D41/D44). Optional pending backfill of pre-existing records (#26) — treat absent as ACTIVE. Clients filter by ACTIVE. |
+| + [deploymentLinks](#deploymentLinks )     | No      | array of object | No         | -          | Ordered list of deployment URLs (web, mobile, PWA, store links).                                                                        |
+| - [expiresAt](#expiresAt )                 | No      | Combination     | No         | -          | Optional expiration timestamp. When set and elapsed, \`isExpired\` flips true and status typically moves to EXPIRED.                    |
+| - [isExpired](#isExpired )                 | No      | boolean or null | No         | -          | (Read-only) Derived — true when \`expiresAt\` is in the past. Maintained by server trigger.                                             |
+| - [createdAt](#createdAt )                 | No      | Combination     | No         | -          | (Read-only) Server-generated creation timestamp.                                                                                        |
+| - [updatedAt](#updatedAt )                 | No      | Combination     | No         | -          | (Read-only) Server-generated update timestamp.                                                                                          |
+| + [createdBy](#createdBy )                 | No      | string          | No         | -          | (Immutable) FK → User/staff UID who created the app.                                                                                    |
+| + [analyticsEnabled](#analyticsEnabled )   | No      | boolean         | No         | -          | Feature flag — when false, clients should not emit analytics events for this app.                                                       |
+| - [lastAnalyticsSync](#lastAnalyticsSync ) | No      | Combination     | No         | -          | (Read-only) Last time the analytics rollup pipeline refreshed \`cachedMetrics\`.                                                        |
+| - [cachedMetrics](#cachedMetrics )         | No      | object or null  | No         | -          | (Read-only, Denormalized) Cached metrics snapshot for quick dashboard rendering.                                                        |
+
+## <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. Scopes all app sub-collections.
+
+:::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="name"></a>3. Property `name`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Human-readable app name shown in dashboards.
+
+## <a name="description"></a>4. Property `description`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+**Description:** Optional freeform description.
+
+## <a name="status"></a>5. Property `status`
+
+|                           |                  |
+| ------------------------- | ---------------- |
+| **Type**                  | `combining`      |
+| **Required**              | No               |
+| **Additional properties** | Any type allowed |
+
+**Description:** Lifecycle status (D41/D44). Optional pending backfill of pre-existing records (#26) — treat absent as ACTIVE. Clients filter by ACTIVE.
+
+| Any of(Option)                 |
+| ------------------------------ |
+| [app-status](#status_anyOf_i0) |
+| [item 1](#status_anyOf_i1)     |
+
+### <a name="status_anyOf_i0"></a>5.1. Property `app-status`
+
+|                |                          |
+| -------------- | ------------------------ |
+| **Type**       | `enum (of string)`       |
+| **Required**   | No                       |
+| **Defined in** | #/definitions/app-status |
+
+**Description:** Lifecycle status for an App (formerly Site — renamed per decision #40 / D44). Drives whether the app is reachable and whether analytics/payments flow.
+
+Must be one of:
+* "ACTIVE"
+* "INACTIVE"
+* "EXPIRED"
+* "ARCHIVED"
+
+### <a name="status_anyOf_i1"></a>5.2. Property `item 1`
+
+|              |        |
+| ------------ | ------ |
+| **Type**     | `null` |
+| **Required** | No     |
+
+:::note
+Real Firestore documents may be missing this field on pre-backfill records (#26). Treat absent as ACTIVE. A backfill script will populate status=ACTIVE on all existing documents; once confirmed, this field will be promoted to required.
+:::
+
+:::tip When to set
+Written by operators via dashboard or by server triggers (expiration). Clients must not use server-side `where(status == ACTIVE)` until backfill is complete — filter client-side instead, treating absent as ACTIVE.
+:::
+
+:::info See also
+**Decisions:** `D41` · `D44`
+:::
+
+## <a name="deploymentLinks"></a>6. Property `deploymentLinks`
+
+|              |                   |
+| ------------ | ----------------- |
+| **Type**     | `array of object` |
+| **Required** | Yes               |
+
+**Description:** Ordered list of deployment URLs (web, mobile, PWA, store links).
+
+|                      | Array restrictions |
+| -------------------- | ------------------ |
+| **Min items**        | N/A                |
+| **Max items**        | N/A                |
+| **Items unicity**    | False              |
+| **Additional items** | False              |
+| **Tuple validation** | See below          |
+
+| Each item of this array must be                 | Description                                                    |
+| ----------------------------------------------- | -------------------------------------------------------------- |
+| [deploymentLinks items](#deploymentLinks_items) | Deployment link entry embedded on App.deploymentLinks[] (D41). |
+
+### <a name="deploymentLinks_items"></a>6.1. deploymentLinks items
+
+|                           |             |
+| ------------------------- | ----------- |
+| **Type**                  | `object`    |
+| **Required**              | No          |
+| **Additional properties** | Not allowed |
+
+**Description:** Deployment link entry embedded on App.deploymentLinks[] (D41).
+
+| Property                                         | Pattern | Type             | Deprecated | Definition                            | Title/Description                                                        |
+| ------------------------------------------------ | ------- | ---------------- | ---------- | ------------------------------------- | ------------------------------------------------------------------------ |
+| + [label](#deploymentLinks_items_label )         | No      | string           | No         | -                                     | Human-readable label shown in dashboards (e.g. "Production", "Staging"). |
+| + [url](#deploymentLinks_items_url )             | No      | string           | No         | -                                     | Absolute URL or store link.                                              |
+| + [type](#deploymentLinks_items_type )           | No      | enum (of string) | No         | In #/definitions/deployment-link-type | Link category — drives icon/handler selection.                           |
+| - [isPrimary](#deploymentLinks_items_isPrimary ) | No      | boolean          | No         | -                                     | If true, this link is used as the canonical deployment URL for the App.  |
+
+#### <a name="deploymentLinks_items_label"></a>6.1.1. Property `label`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Human-readable label shown in dashboards (e.g. "Production", "Staging").
+
+#### <a name="deploymentLinks_items_url"></a>6.1.2. Property `url`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Absolute URL or store link.
+
+#### <a name="deploymentLinks_items_type"></a>6.1.3. Property `type`
+
+|                |                                    |
+| -------------- | ---------------------------------- |
+| **Type**       | `enum (of string)`                 |
+| **Required**   | Yes                                |
+| **Defined in** | #/definitions/deployment-link-type |
+
+**Description:** Link category — drives icon/handler selection.
+
+Must be one of:
+* "web"
+* "mobile"
+* "pwa"
+* "app-store"
+* "play-store"
+* "other"
+
+#### <a name="deploymentLinks_items_isPrimary"></a>6.1.4. Property `isPrimary`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `boolean` |
+| **Required** | No        |
+
+**Description:** If true, this link is used as the canonical deployment URL for the App.
+
+## <a name="expiresAt"></a>7. Property `expiresAt`
+
+|                           |                  |
+| ------------------------- | ---------------- |
+| **Type**                  | `combining`      |
+| **Required**              | No               |
+| **Additional properties** | Any type allowed |
+
+**Description:** Optional expiration timestamp. When set and elapsed, `isExpired` flips true and status typically moves to EXPIRED.
+
+| Any of(Option)                             |
+| ------------------------------------------ |
+| [firestore-timestamp](#expiresAt_anyOf_i0) |
+| [item 1](#expiresAt_anyOf_i1)              |
+
+### <a name="expiresAt_anyOf_i0"></a>7.1. Property `firestore-timestamp`
+
+|                           |                                   |
+| ------------------------- | --------------------------------- |
+| **Type**                  | `object`                          |
+| **Required**              | No                                |
+| **Additional properties** | Not allowed                       |
+| **Defined in**            | #/definitions/firestore-timestamp |
+
+**Description:** Firestore Timestamp — Admin SDK form: \{ _seconds, _nanoseconds \}. See types/firestore.ts for REST API v1 and client SDK serialization notes (#10).
+
+| Property                                            | Pattern | Type    | Deprecated | Definition | Title/Description |
+| --------------------------------------------------- | ------- | ------- | ---------- | ---------- | ----------------- |
+| + [_seconds](#expiresAt_anyOf_i0__seconds )         | No      | integer | No         | -          | -                 |
+| + [_nanoseconds](#expiresAt_anyOf_i0__nanoseconds ) | No      | integer | No         | -          | -                 |
+
+#### <a name="expiresAt_anyOf_i0__seconds"></a>7.1.1. Property `_seconds`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+#### <a name="expiresAt_anyOf_i0__nanoseconds"></a>7.1.2. Property `_nanoseconds`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+### <a name="expiresAt_anyOf_i1"></a>7.2. Property `item 1`
+
+|              |        |
+| ------------ | ------ |
+| **Type**     | `null` |
+| **Required** | No     |
+
+## <a name="isExpired"></a>8. Property `isExpired`
+
+|              |                   |
+| ------------ | ----------------- |
+| **Type**     | `boolean or null` |
+| **Required** | No                |
+
+**Description:** (Read-only) Derived — true when `expiresAt` is in the past. Maintained by server trigger.
+
+:::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="createdAt"></a>9. Property `createdAt`
+
+|                           |                  |
+| ------------------------- | ---------------- |
+| **Type**                  | `combining`      |
+| **Required**              | No               |
+| **Additional properties** | Any type allowed |
+
+**Description:** (Read-only) Server-generated creation timestamp.
+
+| Any of(Option)                             |
+| ------------------------------------------ |
+| [firestore-timestamp](#createdAt_anyOf_i0) |
+| [item 1](#createdAt_anyOf_i1)              |
+
+### <a name="createdAt_anyOf_i0"></a>9.1. Property `firestore-timestamp`
+
+|                           |                                           |
+| ------------------------- | ----------------------------------------- |
+| **Type**                  | `object`                                  |
+| **Required**              | No                                        |
+| **Additional properties** | Not allowed                               |
+| **Same definition as**    | [expiresAt_anyOf_i0](#expiresAt_anyOf_i0) |
+
+**Description:** Firestore Timestamp — Admin SDK form: \{ _seconds, _nanoseconds \}. See types/firestore.ts for REST API v1 and client SDK serialization notes (#10).
+
+### <a name="createdAt_anyOf_i1"></a>9.2. Property `item 1`
+
+|              |        |
+| ------------ | ------ |
+| **Type**     | `null` |
+| **Required** | No     |
+
+:::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="updatedAt"></a>10. Property `updatedAt`
+
+|                           |                  |
+| ------------------------- | ---------------- |
+| **Type**                  | `combining`      |
+| **Required**              | No               |
+| **Additional properties** | Any type allowed |
+
+**Description:** (Read-only) Server-generated update timestamp.
+
+| Any of(Option)                             |
+| ------------------------------------------ |
+| [firestore-timestamp](#updatedAt_anyOf_i0) |
+| [item 1](#updatedAt_anyOf_i1)              |
+
+### <a name="updatedAt_anyOf_i0"></a>10.1. Property `firestore-timestamp`
+
+|                           |                                           |
+| ------------------------- | ----------------------------------------- |
+| **Type**                  | `object`                                  |
+| **Required**              | No                                        |
+| **Additional properties** | Not allowed                               |
+| **Same definition as**    | [expiresAt_anyOf_i0](#expiresAt_anyOf_i0) |
+
+**Description:** Firestore Timestamp — Admin SDK form: \{ _seconds, _nanoseconds \}. See types/firestore.ts for REST API v1 and client SDK serialization notes (#10).
+
+### <a name="updatedAt_anyOf_i1"></a>10.2. Property `item 1`
+
+|              |        |
+| ------------ | ------ |
+| **Type**     | `null` |
+| **Required** | No     |
+
+:::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="createdBy"></a>11. Property `createdBy`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** (Immutable) FK → User/staff UID who created the app.
+
+:::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="analyticsEnabled"></a>12. Property `analyticsEnabled`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `boolean` |
+| **Required** | Yes       |
+
+**Description:** Feature flag — when false, clients should not emit analytics events for this app.
+
+## <a name="lastAnalyticsSync"></a>13. Property `lastAnalyticsSync`
+
+|                           |                  |
+| ------------------------- | ---------------- |
+| **Type**                  | `combining`      |
+| **Required**              | No               |
+| **Additional properties** | Any type allowed |
+
+**Description:** (Read-only) Last time the analytics rollup pipeline refreshed `cachedMetrics`.
+
+| Any of(Option)                                     |
+| -------------------------------------------------- |
+| [firestore-timestamp](#lastAnalyticsSync_anyOf_i0) |
+| [item 1](#lastAnalyticsSync_anyOf_i1)              |
+
+### <a name="lastAnalyticsSync_anyOf_i0"></a>13.1. Property `firestore-timestamp`
+
+|                           |                                           |
+| ------------------------- | ----------------------------------------- |
+| **Type**                  | `object`                                  |
+| **Required**              | No                                        |
+| **Additional properties** | Not allowed                               |
+| **Same definition as**    | [expiresAt_anyOf_i0](#expiresAt_anyOf_i0) |
+
+**Description:** Firestore Timestamp — Admin SDK form: \{ _seconds, _nanoseconds \}. See types/firestore.ts for REST API v1 and client SDK serialization notes (#10).
+
+### <a name="lastAnalyticsSync_anyOf_i1"></a>13.2. Property `item 1`
+
+|              |        |
+| ------------ | ------ |
+| **Type**     | `null` |
+| **Required** | No     |
+
+:::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="cachedMetrics"></a>14. Property `cachedMetrics`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `object or null` |
+| **Required** | No               |
+
+**Description:** (Read-only, Denormalized) Cached metrics snapshot for quick dashboard rendering.
+
+| Property                                           | Pattern | Type    | Deprecated | Definition                                         | Title/Description                                                       |
+| -------------------------------------------------- | ------- | ------- | ---------- | -------------------------------------------------- | ----------------------------------------------------------------------- |
+| + [totalEvents](#cachedMetrics_totalEvents )       | No      | integer | No         | -                                                  | All-time event count cached on the App.                                 |
+| + [totalPageViews](#cachedMetrics_totalPageViews ) | No      | integer | No         | -                                                  | All-time \`page_view\` + \`screen_view\` count.                         |
+| + [totalSessions](#cachedMetrics_totalSessions )   | No      | integer | No         | -                                                  | All-time distinct session count.                                        |
+| + [totalOrders](#cachedMetrics_totalOrders )       | No      | integer | No         | -                                                  | All-time order count attributed to this app (via \`Order.appId\`, D43). |
+| - [lastEventAt](#cachedMetrics_lastEventAt )       | No      | object  | No         | Same as [expiresAt_anyOf_i0](#expiresAt_anyOf_i0 ) | Timestamp of the most recent analytics event seen for this app.         |
+
+### <a name="cachedMetrics_totalEvents"></a>14.1. Property `totalEvents`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+**Description:** All-time event count cached on the App.
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+### <a name="cachedMetrics_totalPageViews"></a>14.2. Property `totalPageViews`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+**Description:** All-time `page_view` + `screen_view` count.
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+### <a name="cachedMetrics_totalSessions"></a>14.3. Property `totalSessions`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+**Description:** All-time distinct session count.
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+### <a name="cachedMetrics_totalOrders"></a>14.4. Property `totalOrders`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+**Description:** All-time order count attributed to this app (via `Order.appId`, D43).
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+### <a name="cachedMetrics_lastEventAt"></a>14.5. Property `lastEventAt`
+
+|                           |                                           |
+| ------------------------- | ----------------------------------------- |
+| **Type**                  | `object`                                  |
+| **Required**              | No                                        |
+| **Additional properties** | Not allowed                               |
+| **Same definition as**    | [expiresAt_anyOf_i0](#expiresAt_anyOf_i0) |
+
+**Description:** Timestamp of the most recent analytics event seen for this app.
+
+----------------------------------------------------------------------------------------------------------------------------
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:44 +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.
+:::
+
+:::note
+Updated by the rollup pipeline (D42). Readers should treat this as a hint; authoritative counts live in analytics_daily/analytics_hourly.
+:::
+
+:::info See also
+**Decisions:** `D41` · `D42`
+:::

package/data/docs/models/booking-version.md

@@ -1,7 +1,7 @@
 ---
 title: "BookingVersion"
 sidebar_label: "BookingVersion"
-sidebar_position: 7
+sidebar_position: 9
 ---
 
 # BookingVersion
@@ -270,7 +270,7 @@ Dot-notation paths for nested fields (e.g. "bookingDates.0.status"). Populated b
 | **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 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.