@graph8/sdk 0.251.0 → 0.260.0

package/docs/api/revenueLifecycle.md

@@ -0,0 +1,274 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.revenueLifecycle`: Revenue Lifecycle
+
+5 operations (3 read, 2 write).
+
+No hand-written client covers this area. Call it through `g8.api.revenueLifecycle.*` as shown below, or by operationId with `g8.api.call(operationId, input)`.
+
+Every example below assumes this setup (server-side, API key):
+
+```ts
+import { g8 } from "@graph8/sdk";
+
+g8.init({ apiKey: process.env.G8_API_KEY! });
+```
+
+Example values are placeholders that match each field's type. Only required fields are shown. Every example is type-checked against the SDK in CI.
+
+Exact TypeScript types for every operation on this page, and every schema they use: [revenueLifecycle.d.ts](revenueLifecycle.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`getLifecycleStageCounts`](#op-getlifecyclestagecounts) | `GET /api/v1/lifecycle-stages/counts` | read | `deals:read` | Get Lifecycle Stage Counts |
+| [`listLifecycleStageRecords`](#op-listlifecyclestagerecords) | `GET /api/v1/lifecycle-stages/{stage}/records` | read | `deals:read` | List Lifecycle Stage Records |
+| [`listLifecycleStages`](#op-listlifecyclestages) | `GET /api/v1/lifecycle-stages` | read | `deals:read` | List Lifecycle Stages |
+| [`moveCompanyLifecycleStage`](#op-movecompanylifecyclestage) | `POST /api/v1/companies/{company_id}/lifecycle-stage` | write | `deals:write` | Move Company Lifecycle Stage |
+| [`moveContactLifecycleStage`](#op-movecontactlifecyclestage) | `POST /api/v1/contacts/{contact_id}/lifecycle-stage` | write | `deals:write` | Move Contact Lifecycle Stage |
+
+---
+
+<a id="op-getlifecyclestagecounts"></a>
+
+### `g8.api.revenueLifecycle.getLifecycleStageCounts(input?)`
+
+**Get Lifecycle Stage Counts**
+
+- HTTP: `GET /api/v1/lifecycle-stages/counts`
+- operationId: `get_lifecycle_stage_counts_lifecycle_stages_counts_get` (also callable as `g8.api.call("get_lifecycle_stage_counts_lifecycle_stages_counts_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `deals:read`
+
+Per-stage company counts — cheap enough to power a lifecycle board header.
+
+The returned map is keyed by lifecycle ENTRY ID, not slug (matches
+`GET /settings/revenue/lifecycle/counts` exactly — see
+`.claude/agent-context/lifecycle-stage-moves.md` Gotcha 4). Cross-reference
+against `GET /lifecycle-stages` to resolve an id to its slug/name. Counts
+are company-only, same as the app's nav badges — contact-stage membership
+has no counts surface yet (see the module docstring's dropped-scope note).
+
+**Input**: none.
+
+**Returns** `ApiResponse_dict_str__int__`: the envelope `{ data: Record<string, integer>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.revenueLifecycle.getLifecycleStageCounts();
+```
+
+---
+
+<a id="op-listlifecyclestagerecords"></a>
+
+### `g8.api.revenueLifecycle.listLifecycleStageRecords(input)`
+
+**List Lifecycle Stage Records**
+
+- HTTP: `GET /api/v1/lifecycle-stages/{stage}/records`
+- operationId: `list_lifecycle_stage_records_lifecycle_stages__stage__records_get` (also callable as `g8.api.call("list_lifecycle_stage_records_lifecycle_stages__stage__records_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `deals:read`
+
+List the companies currently in a lifecycle stage.
+
+Membership is resolved with the exact same predicate the Suspects/Leads/
+Trial/Customers/Churned grid and the counts endpoint use — this endpoint,
+the grid, and `GET /lifecycle-stages/counts` can never disagree about who
+is in a stage. Row visibility is additionally narrowed by the calling
+key's declared company scope (own/team/all), same as `GET /companies`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.stage` | `string` | yes | Lifecycle slug (e.g. 'leads') OR lifecycle entry UUID — either works. |
+| `query.page` | `integer` | no | Page number (1-indexed). default `1` |
+| `query.limit` | `integer` | no | Items per page (max 200). default `50` |
+
+**Returns** `ApiResponse_list_LifecycleRecordItem__`: the envelope `{ data: Array<LifecycleRecordItem>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`LifecycleRecordItem` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `company_id` | `integer` | yes |  |
+| `custom_status` | `string \| null` | no |  |
+| `domain` | `string \| null` | no |  |
+| `industry` | `string \| null` | no |  |
+| `mrr_cents` | `integer \| null` | no |  |
+| `name` | `string \| null` | no |  |
+| `owner_id` | `string \| null` | no |  |
+| `status` | `string \| null` | no |  |
+| `subscription_status` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.revenueLifecycle.listLifecycleStageRecords({ path: { stage: "example" } });
+```
+
+---
+
+<a id="op-listlifecyclestages"></a>
+
+### `g8.api.revenueLifecycle.listLifecycleStages(input?)`
+
+**List Lifecycle Stages**
+
+- HTTP: `GET /api/v1/lifecycle-stages`
+- operationId: `list_lifecycle_stages_lifecycle_stages_get` (also callable as `g8.api.call("list_lifecycle_stages_lifecycle_stages_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `deals:read`
+
+List the org's configured revenue lifecycle stages, sorted for display.
+
+Suspects/Leads/Trial/Customers/Churned ship seeded by default; an org may
+also have added custom stages via the Settings > Revenue Lifecycle editor.
+Pass either `slug` or `id` from this response to
+`GET /lifecycle-stages/{stage}/records` and
+`POST /{companies,contacts}/{id}/lifecycle-stage`.
+
+**Input**: none.
+
+**Returns** `ApiResponse_list_LifecycleStageResponse__`: the envelope `{ data: Array<LifecycleStageResponse>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`LifecycleStageResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `hidden` | `boolean` | yes |  |
+| `icon` | `string` | yes |  |
+| `id` | `string` | yes | Lifecycle entry UUID — the key `GET /lifecycle-stages/counts` uses. |
+| `name` | `string` | yes |  |
+| `slug` | `string` | yes | Stable machine slug, e.g. 'leads', 'trials'. Accepted by the /records path. |
+| `sort_order` | `integer` | yes |  |
+| `custom_status_match` | `Array<string>` | no | cb_accounts.custom_status values that also match this stage. |
+| `description` | `string \| null` | no |  |
+| `status_match` | `Array<string>` | no | cb_accounts.status values that match this stage. |
+| `subscription_filter` | `Array<string> \| null` | no | When set, cb_accounts.subscription_status must also be one of these. |
+
+**Example**
+
+```ts
+const result = await g8.api.revenueLifecycle.listLifecycleStages();
+```
+
+---
+
+<a id="op-movecompanylifecyclestage"></a>
+
+### `g8.api.revenueLifecycle.moveCompanyLifecycleStage(input)`
+
+**Move Company Lifecycle Stage**
+
+- HTTP: `POST /api/v1/companies/{company_id}/lifecycle-stage`
+- operationId: `move_company_lifecycle_stage_companies__company_id__lifecycle_stage_post` (also callable as `g8.api.call("move_company_lifecycle_stage_companies__company_id__lifecycle_stage_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `deals:write`
+
+Move a company to a different lifecycle stage.
+
+Proxies `promote_company_lifecycle_stage` — atomically writes `status` +
+`custom_status` to both the `cb_accounts` and `cb_company_extensions`
+overlays, refuses a move to `customers` when the company has no active/
+past_due Stripe subscription (400, same guard the app enforces), and
+records a `cb_lead_stage_history`-style audit row. `org_id` is always the
+authenticated key's own organisation; there is no way to target another
+org's company through this endpoint.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.company_id` | `integer` | yes | Company ID (mashup_companies.id, same as GET /companies/{company_id}). |
+| `body` | `LifecycleStageMoveRequest` | yes | Request body; fields below. |
+
+Body fields (`LifecycleStageMoveRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.target_slug` | `string` | yes | Destination lifecycle slug, e.g. 'suspects', 'leads', 'trials', 'customers', 'churned'. |
+
+**Returns** `ApiResponse_LifecycleStageMoveResponse_`: the envelope `{ data: LifecycleStageMoveResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`LifecycleStageMoveResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `target_slug` | `string` | yes |  |
+| `new_custom_status` | `string \| null` | no |  |
+| `new_status` | `string \| null` | no |  |
+| `previous_custom_status` | `string \| null` | no |  |
+| `previous_status` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.revenueLifecycle.moveCompanyLifecycleStage({ path: { company_id: 123 }, body: { target_slug: "example" } });
+```
+
+---
+
+<a id="op-movecontactlifecyclestage"></a>
+
+### `g8.api.revenueLifecycle.moveContactLifecycleStage(input)`
+
+**Move Contact Lifecycle Stage**
+
+- HTTP: `POST /api/v1/contacts/{contact_id}/lifecycle-stage`
+- operationId: `move_contact_lifecycle_stage_contacts__contact_id__lifecycle_stage_post` (also callable as `g8.api.call("move_contact_lifecycle_stage_contacts__contact_id__lifecycle_stage_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `deals:write`
+
+Move a contact to a different lifecycle stage.
+
+Proxies `promote_contact_lifecycle_stage` — writes `cb_contact_extensions
+.custom_status` (auto-creating the extension row if the contact has none
+yet, which is common for Suspects-stage contacts), and records the same
+audit trail the in-app Move-Stage dialog's contact mode does. Returns no
+contact PII (see the module docstring) — only the status transition.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.contact_id` | `integer` | yes | Contact ID — accepts mashup_contacts.CONTACT_ID or .id, same as GET /contacts/{contact_id}. |
+| `body` | `LifecycleStageMoveRequest` | yes | Request body; fields below. |
+
+Body fields (`LifecycleStageMoveRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.target_slug` | `string` | yes | Destination lifecycle slug, e.g. 'suspects', 'leads', 'trials', 'customers', 'churned'. |
+
+**Returns** `ApiResponse_LifecycleStageMoveResponse_`: the envelope `{ data: LifecycleStageMoveResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`LifecycleStageMoveResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `target_slug` | `string` | yes |  |
+| `new_custom_status` | `string \| null` | no |  |
+| `new_status` | `string \| null` | no |  |
+| `previous_custom_status` | `string \| null` | no |  |
+| `previous_status` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.revenueLifecycle.moveContactLifecycleStage({ path: { contact_id: 123 }, body: { target_slug: "example" } });
+```

package/docs/api/revenueRecords.d.ts

@@ -0,0 +1,372 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.revenueRecords` (Revenue Records): 15 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"create_revenue_plan_revenue_plans_post">;
+ *
+ * Reference with examples: revenueRecords.md
+ */
+/* eslint-disable */
+
+/** `g8.api.revenueRecords.<member>` -> the operationId it calls. */
+export interface RevenueRecordsMembers {
+  createRevenuePlan: "create_revenue_plan_revenue_plans_post";
+  deactivateRevenuePlan: "deactivate_revenue_plan_revenue_plans__plan_id__delete";
+  getActivity: "get_activity_activities__activity_id__get";
+  getActivityMetrics: "get_activity_metrics_activities_metrics_summary_get";
+  getCompanyEvents: "get_company_events_companies__company_id__events_get";
+  getCompanyLifecycleSnapshot: "get_company_lifecycle_snapshot_companies__company_id__lifecycle_snapshot_get";
+  getContactLifecycleSnapshot: "get_contact_lifecycle_snapshot_contacts__contact_id__lifecycle_snapshot_get";
+  listCompanyActivities: "list_company_activities_companies__company_id__activities_get";
+  listDealActivities: "list_deal_activities_deals__deal_id__activities_get";
+  listLifecycleContacts: "list_lifecycle_contacts_lifecycle_contacts_get";
+  listRevenuePlans: "list_revenue_plans_revenue_plans_get";
+  normalizeRevenuePlans: "normalize_revenue_plans_revenue_plans_normalize_post";
+  setDefaultPipeline: "set_default_pipeline_deals_pipelines__pipeline_id__default_put";
+  unlockLifecycleContacts: "unlock_lifecycle_contacts_lifecycle_contacts_unlock_post";
+  updateRevenuePlan: "update_revenue_plan_revenue_plans__plan_id__put";
+}
+
+/** Input and output of every `g8.api.revenueRecords` operation, keyed by operationId. */
+export interface RevenueRecordsOperations {
+  /**
+   * POST /revenue/plans
+   * Create Revenue Plan
+   * tier: write · scope: deals:write
+   */
+  create_revenue_plan_revenue_plans_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RevenuePlanCreateRequest;
+  };
+    output: ApiResponse_RevenueRecordPayload_;
+  };
+  /**
+   * DELETE /revenue/plans/{plan_id}
+   * Deactivate Revenue Plan
+   * tier: destructive · scope: deals:delete
+   */
+  deactivate_revenue_plan_revenue_plans__plan_id__delete: {
+    input: {
+    path: {
+      /** Plan id. */
+      plan_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_RevenueRecordPayload_;
+  };
+  /**
+   * GET /activities/{activity_id}
+   * Get Activity
+   * tier: read · scope: deals:read
+   */
+  get_activity_activities__activity_id__get: {
+    input: {
+    path: {
+      /** Activity id. */
+      activity_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_RevenueRecordPayload_;
+  };
+  /**
+   * GET /activities/metrics/summary
+   * Get Activity Metrics
+   * tier: read · scope: deals:read
+   */
+  get_activity_metrics_activities_metrics_summary_get: {
+    input: {
+    query?: {
+      /** Days to analyse. */
+      period_days?: number;
+      /** Only this owner's activities. */
+      owner_id?: string | null;
+      /** Only activities from this source. */
+      source?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_RevenueRecordPayload_;
+  };
+  /**
+   * GET /companies/{company_id}/events
+   * Get Company Events
+   * tier: read · scope: deals:read
+   */
+  get_company_events_companies__company_id__events_get: {
+    input: {
+    path: {
+      /** Account or company id. */
+      company_id: string;
+    };
+    query: {
+      /** Comma-separated event names. */
+      names: string;
+      window_days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_RevenueRecordPayload_;
+  };
+  /**
+   * GET /companies/{company_id}/lifecycle-snapshot
+   * Get Company Lifecycle Snapshot
+   * tier: read · scope: deals:read
+   */
+  get_company_lifecycle_snapshot_companies__company_id__lifecycle_snapshot_get: {
+    input: {
+    path: {
+      /** Account, company-extension or company id. */
+      company_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_RevenueRecordPayload_;
+  };
+  /**
+   * GET /contacts/{contact_id}/lifecycle-snapshot
+   * Get Contact Lifecycle Snapshot
+   * tier: read · scope: deals:read
+   */
+  get_contact_lifecycle_snapshot_contacts__contact_id__lifecycle_snapshot_get: {
+    input: {
+    path: {
+      /** Contact id. */
+      contact_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_RevenueRecordPayload_;
+  };
+  /**
+   * GET /companies/{company_id}/activities
+   * List Company Activities
+   * tier: read · scope: deals:read
+   */
+  list_company_activities_companies__company_id__activities_get: {
+    input: {
+    path: {
+      /** Company id. */
+      company_id: string;
+    };
+    query?: {
+      activity_type?: string | null;
+      /** Only activities from this source. */
+      source?: string | null;
+      limit?: number;
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_RevenueRecordListPayload_;
+  };
+  /**
+   * GET /deals/{deal_id}/activities
+   * List Deal Activities
+   * tier: read · scope: deals:read
+   */
+  list_deal_activities_deals__deal_id__activities_get: {
+    input: {
+    path: {
+      /** Deal id. */
+      deal_id: string;
+    };
+    query?: {
+      activity_type?: string | null;
+      /** Only activities from this source. */
+      source?: string | null;
+      limit?: number;
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_RevenueRecordListPayload_;
+  };
+  /**
+   * GET /lifecycle-contacts
+   * List Lifecycle Contacts
+   * tier: read · scope: deals:read
+   */
+  list_lifecycle_contacts_lifecycle_contacts_get: {
+    input: {
+    query: {
+      /** The lifecycle stage. */
+      lifecycle_id: string;
+      skip?: number;
+      limit?: number | null;
+      company_status?: string | null;
+      search?: string | null;
+      /** JSON grid filter model. */
+      agFilterModel?: string | null;
+      /** JSON grid sort model. */
+      agSortModel?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_RevenueRecordPayload_;
+  };
+  /**
+   * GET /revenue/plans
+   * List Revenue Plans
+   * tier: read · scope: deals:read
+   */
+  list_revenue_plans_revenue_plans_get: {
+    input: {
+    query?: {
+      include_inactive?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_RevenueRecordPayload_;
+  };
+  /**
+   * POST /revenue/plans/normalize
+   * Normalize Revenue Plans
+   * tier: write · scope: deals:write
+   */
+  normalize_revenue_plans_revenue_plans_normalize_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_RevenueRecordPayload_;
+  };
+  /**
+   * PUT /deals/pipelines/{pipeline_id}/default
+   * Set Default Pipeline
+   * tier: write · scope: deals:write
+   */
+  set_default_pipeline_deals_pipelines__pipeline_id__default_put: {
+    input: {
+    path: {
+      /** Pipeline id. */
+      pipeline_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_RevenueRecordPayload_;
+  };
+  /**
+   * POST /lifecycle-contacts/unlock
+   * Unlock Lifecycle Contacts
+   * tier: billable · scope: deals:run
+   */
+  unlock_lifecycle_contacts_lifecycle_contacts_unlock_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: LifecycleContactsUnlockRequest;
+  };
+    output: ApiResponse_RevenueRecordPayload_;
+  };
+  /**
+   * PUT /revenue/plans/{plan_id}
+   * Update Revenue Plan
+   * tier: write · scope: deals:write
+   */
+  update_revenue_plan_revenue_plans__plan_id__put: {
+    input: {
+    path: {
+      /** Plan id. */
+      plan_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RevenuePlanUpdateRequest;
+  };
+    output: ApiResponse_RevenueRecordPayload_;
+  };
+}
+
+// 8 schemas referenced above (the same as G8Contract.<Name>).
+
+export interface ApiResponse_RevenueRecordListPayload_ {
+  data: RevenueRecordListPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_RevenueRecordPayload_ {
+  data: RevenueRecordPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface LifecycleContactsUnlockRequest {
+  /** Grid filter model. With no `contact_ids`, every matching contact in the stage is unlocked; with neither, the WHOLE stage is. */
+  agFilterModel?: Record<string, unknown> | null;
+  /** Comma-separated company_status narrowing. */
+  company_status?: string | null;
+  /** Unlock exactly these. Takes precedence over `agFilterModel`. */
+  contact_ids?: Array<number> | null;
+  /** The lifecycle stage to unlock contacts in. */
+  lifecycle_id: string;
+}
+
+export interface PaginationMeta {
+  /** Whether there are more pages */
+  has_next: boolean;
+  /** Items per page */
+  limit: number;
+  /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
+  next_cursor?: string | null;
+  /** Current page number (1-indexed) */
+  page: number;
+  /** Total number of items */
+  total: number;
+}
+
+export interface RevenuePlanCreateRequest {
+  list_price_cents?: number | null;
+  mrr_band?: ("<1k" | "1k-5k" | "5k-25k" | ">25k") | null;
+  name: string;
+  /** Derived from `name` when omitted. */
+  slug?: string | null;
+}
+
+export interface RevenuePlanUpdateRequest {
+  active?: boolean | null;
+  list_price_cents?: number | null;
+  mrr_band?: ("<1k" | "1k-5k" | "5k-25k" | ">25k") | null;
+  name?: string | null;
+  slug?: string | null;
+}
+
+/** A list result under `items`. */
+export interface RevenueRecordListPayload {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/** An activity, snapshot, plan or result, as the app returns it. */
+export type RevenueRecordPayload = Record<string, unknown>;