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

package/data/docs/models/sale.md

@@ -1,7 +1,7 @@
 ---
 title: "Sale"
 sidebar_label: "Sale"
-sidebar_position: 19
+sidebar_position: 22
 ---
 
 # Sale
@@ -524,7 +524,7 @@ Set at creation only. This field cannot be modified after the document is create
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-05 at 12:09:28 +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/site-payment.md

@@ -1,7 +1,7 @@
 ---
 title: "SitePayment"
 sidebar_label: "SitePayment"
-sidebar_position: 20
+sidebar_position: 24
 ---
 
 # 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-04-18 at 21:21:09 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-05 at 12:09:28 +0000

package/data/docs/models/site.md

@@ -0,0 +1,561 @@
+---
+title: "Site"
+sidebar_label: "Site"
+sidebar_position: 23
+---
+
+# Site
+
+<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)
+- [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/site |
+
+**Description:** Site model (D41 / ING-304). Collection: companies/\{companyId\}/sites/\{siteId\}. 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 site sub-collections.                                               |
+| + [name](#name )                           | No      | string           | No         | -                            | Human-readable site name shown in dashboards.                                                                        |
+| - [description](#description )             | No      | string or null   | No         | -                            | Optional freeform description.                                                                                       |
+| + [status](#status )                       | No      | enum (of string) | No         | In #/definitions/site-status | Lifecycle status (D41). 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 site.                                                                |
+| + [analyticsEnabled](#analyticsEnabled )   | No      | boolean          | No         | -                            | Feature flag — when false, clients should not emit analytics events for this site.                                   |
+| - [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 site 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 site 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**       | `enum (of string)`        |
+| **Required**   | Yes                       |
+| **Defined in** | #/definitions/site-status |
+
+**Description:** Lifecycle status (D41). Clients filter by ACTIVE.
+
+Must be one of:
+* "ACTIVE"
+* "INACTIVE"
+* "EXPIRED"
+* "ARCHIVED"
+
+:::note
+ACTIVE = live and serving traffic. INACTIVE = intentionally disabled by operators. EXPIRED = past expiresAt (derived when isExpired is true; may also be stored explicitly). ARCHIVED = soft-deleted; retained for audit but not listed by default.
+:::
+
+:::tip When to set
+Written by operators via dashboard or by server triggers (expiration). Clients filter by ACTIVE.
+:::
+
+:::info See also
+**Decisions:** `D41`
+:::
+
+## <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 Site.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 Site.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 Site. |
+
+#### <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 Site.
+
+## <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 serialized representation
+
+| 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 serialized representation
+
+### <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 serialized representation
+
+### <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 site.
+
+:::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 site.
+
+## <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 serialized representation
+
+### <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 Site.                                  |
+| + [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 site (via \`Order.siteId\`, 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 site.          |
+
+### <a name="cachedMetrics_totalEvents"></a>14.1. Property `totalEvents`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+**Description:** All-time event count cached on the Site.
+
+| 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 site (via `Order.siteId`, 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 site.
+
+----------------------------------------------------------------------------------------------------------------------------
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-05 at 12:09:28 +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`
+:::