@kasuvia/sdk 0.0.8 → 0.0.9

package/src/services/wishlist.service.ts

@@ -4,67 +4,34 @@
  * Handles wishlist operations.
  * Stateless - all configuration passed as parameters.
  */
-import { GraphQLClient } from 'graphql-request'
 import type { SdkConfig } from '../config'
 import type { WishlistItem, WishlistListResponse, WishlistCheckResponse } from '../types/store'
-
-const GET_STOREFRONT_WISHLIST = `
-  query GetStorefrontWishlist($page: Int!, $pageSize: Int!) {
-    storefront_wishlist(page: $page, pageSize: $pageSize) {
-      items {
-        id
-        product_id
-        notes
-        created_at
-        product_name
-        product_slug
-        product_price
-        currency
-        product_image
-      }
-      total
-      page
-      page_size
-      total_pages
-    }
-  }
-`
-
-const CHECK_IN_STOREFRONT_WISHLIST = `
-  query CheckInStorefrontWishlist($productId: String!) {
-    check_in_storefront_wishlist(productId: $productId) {
-      in_wishlist
-    }
-  }
-`
-
-/**
- * Create GraphQL client with provided config
- */
-function createGraphQLClient(config: SdkConfig, accessToken?: string): GraphQLClient {
-  const headers: Record<string, string> = {
-    'Content-Type': 'application/json',
-    'Accept': 'application/json',
-    'X-Storefront-Key': config.storefrontApiKey,
-    'X-Business-ID': config.businessId,
-  }
-  if (accessToken) {
-    headers['Authorization'] = `Bearer ${accessToken}`
-  }
-  return new GraphQLClient(`${config.backendUrls.store}/graphql`, { headers })
-}
+import { createGraphQLClient } from '../utils/graphql-url'
+import { GetStorefrontWishlistDocument, CheckInStorefrontWishlistDocument } from '../generated/graphql'
+import { apiRequest, authHeaders, JSON_HEADERS } from '../utils/http-client'
 
 /**
  * Fetch the customer's wishlist for the current business.
  */
 export async function getWishlist(config: SdkConfig, accessToken: string, params?: { page?: number; pageSize?: number }): Promise<WishlistListResponse> {
   const client = createGraphQLClient(config, accessToken)
-  const variables = {
+  const data = await client.request(GetStorefrontWishlistDocument, {
     page: params?.page || 1,
     pageSize: params?.pageSize || 20,
+  })
+  return {
+    ...data.storefront_wishlist,
+    items: data.storefront_wishlist.items.map((item) => ({
+      ...item,
+      created_at: item.created_at as string,
+      notes: item.notes ?? undefined,
+      product_name: item.product_name ?? undefined,
+      product_slug: item.product_slug ?? undefined,
+      product_price: item.product_price ?? undefined,
+      currency: item.currency ?? undefined,
+      product_image: item.product_image ?? undefined,
+    })) satisfies WishlistItem[],
   }
-  const data = await client.request(GET_STOREFRONT_WISHLIST, variables)
-  return data.storefront_wishlist
 }
 
 /**
@@ -72,7 +39,7 @@ export async function getWishlist(config: SdkConfig, accessToken: string, params
  */
 export async function checkInWishlist(config: SdkConfig, accessToken: string, productId: string): Promise<WishlistCheckResponse> {
   const client = createGraphQLClient(config, accessToken)
-  const data = await client.request(CHECK_IN_STOREFRONT_WISHLIST, { productId })
+  const data = await client.request(CheckInStorefrontWishlistDocument, { productId })
   return data.check_in_storefront_wishlist
 }
 
@@ -80,49 +47,35 @@ export async function checkInWishlist(config: SdkConfig, accessToken: string, pr
  * Add a product to the customer's wishlist.
  */
 export async function addToWishlist(config: SdkConfig, accessToken: string, productId: string, notes?: string): Promise<WishlistItem> {
-  const response = await fetch(`${config.backendUrls.store}/wishlist/`, {
+  return apiRequest<WishlistItem>(`${config.backendUrls.store}/wishlist/`, {
     method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      'Authorization': `Bearer ${accessToken}`,
-      "X-Storefront-Key": config.storefrontApiKey,
-      "X-Business-ID": config.businessId,
-    },
+    headers: { ...JSON_HEADERS, ...authHeaders(config, accessToken) },
     body: JSON.stringify({
       product_id: productId,
       notes: notes || undefined,
     }),
+    fallbackErrorMessage: 'Failed to add to wishlist',
   })
-  if (!response.ok) throw new Error('Failed to add to wishlist')
-  return response.json()
 }
 
 /**
  * Remove an item from the customer's wishlist by item ID.
  */
 export async function removeFromWishlist(config: SdkConfig, accessToken: string, itemId: string): Promise<void> {
-  const response = await fetch(`${config.backendUrls.store}/wishlist/${itemId}`, {
+  await apiRequest(`${config.backendUrls.store}/wishlist/${itemId}`, {
     method: 'DELETE',
-    headers: {
-      'Authorization': `Bearer ${accessToken}`,
-      "X-Storefront-Key": config.storefrontApiKey,
-      "X-Business-ID": config.businessId,
-    },
+    headers: authHeaders(config, accessToken),
+    fallbackErrorMessage: 'Failed to remove from wishlist',
   })
-  if (!response.ok) throw new Error('Failed to remove from wishlist')
 }
 
 /**
  * Remove a product from the customer's wishlist by product ID.
  */
 export async function removeProductFromWishlist(config: SdkConfig, accessToken: string, productId: string): Promise<void> {
-  const response = await fetch(`${config.backendUrls.store}/wishlist/product/${productId}`, {
+  await apiRequest(`${config.backendUrls.store}/wishlist/product/${productId}`, {
     method: 'DELETE',
-    headers: {
-      'Authorization': `Bearer ${accessToken}`,
-      "X-Storefront-Key": config.storefrontApiKey,
-      "X-Business-ID": config.businessId,
-    },
+    headers: authHeaders(config, accessToken),
+    fallbackErrorMessage: 'Failed to remove product from wishlist',
   })
-  if (!response.ok) throw new Error('Failed to remove product from wishlist')
 }

package/src/types/auth/index.ts

@@ -22,6 +22,7 @@ export interface CustomerProfileFields {
 }
 
 export interface CustomerUser {
+  /** Scoped to this business only — the same email is a fully separate identity (and id) at any other business/storefront. Never a platform-wide user id. */
   id: string;
   email: string;
   firstname?: string;
@@ -51,6 +52,7 @@ export interface UpdateProfilePayload {
   firstname?: string;
   lastname?: string;
   phone?: string;
+  profile_picture?: string;
 }
 
 export interface NotificationPreferences {
@@ -73,24 +75,23 @@ export interface NotificationPreferences {
   sms_delivery_updates: boolean;
 }
 
-
-// ── Business Context (storefront is scoped to one business) ──────────────────
-
-export interface BusinessContext {
-  id: string;             // UUID
-  business_id: string;    // B-XXXXXXXX — permanent, never changes
-  name: string;
-  logo_picture?: string | null;
-  display_currency?: string;
-}
-
 // ── API Responses ─────────────────────────────────────────────────────────────
 
 export interface CustomerAuthResponse {
   access: string;
   refresh: string;
   user: CustomerUser;
-  business: BusinessContext;
+  // REAL BUG FIXED (2026-09-20): the backend used to embed the FULL business
+  // record here (tax_id, settlement_currency, notification_preferences, the
+  // full plan, postal_code, internal UUID `id`) reaching every customer's
+  // browser on login/register/passwordless-verify. Now uses the same
+  // CustomerFacingBusinessSerializer allow-list as GET /auth/storefront/
+  // business-info/ — identical shape, so reuse StorefrontBusinessInfo rather
+  // than keep a second, drifted type (the old `BusinessContext` type here
+  // had `id`/`display_currency` fields that never matched what the backend
+  // actually returned either, and had zero consumers anywhere in the SDK or
+  // storefront — confirmed via grep before removing it).
+  business: StorefrontBusinessInfo;
   is_new?: boolean;
 }
 
@@ -101,22 +102,36 @@ export interface RefreshTokenResponse {
 
 // ── Request Payloads ──────────────────────────────────────────────────────────
 
-/** POST /auth/login/customer/ — field name is `tenant_id` (the business_id) */
+/**
+ * POST /auth/login/customer/ — business is identified by the
+ * X-Storefront-Key + X-Business-ID headers (config.storefrontApiKey /
+ * config.businessId), not a body field (see plan: Customer Storefront
+ * Identity Enforcement).
+ */
 export interface CustomerLoginPayload {
-  tenant_id: string;    // config.api.storefrontBusinessId
   email: string;
   password: string;
 }
 
-/** POST /auth/register/customer/ */
+/** POST /auth/register/customer/ — business identified via headers, see CustomerLoginPayload. */
 export interface CustomerRegisterPayload {
-  tenant_id: string;    // config.api.storefrontBusinessId
   first_name?: string;
   last_name?: string;
   email: string;
   password: string;
 }
 
+/** POST /auth/login/customer/passwordless/request/ — business identified via headers, see CustomerLoginPayload. */
+export interface CustomerPasswordlessRequestPayload {
+  email: string;
+}
+
+/** POST /auth/login/customer/passwordless/verify/ — business identified via headers, see CustomerLoginPayload. */
+export interface CustomerPasswordlessVerifyPayload {
+  email: string;
+  code: string;
+}
+
 /** POST /auth/verify-otp/ */
 export interface OTPVerifyPayload {
   email: string;
@@ -134,6 +149,126 @@ export interface LogoutPayload {
   refresh?: string;
 }
 
+/** POST /auth/forgot-password/customer/ */
+export interface CustomerForgotPasswordPayload {
+  email: string;
+}
+
+/** POST /auth/reset-password/customer/ */
+export interface CustomerResetPasswordPayload {
+  email: string;
+  code: string;
+  new_password: string;
+}
+
+/** POST /auth/customer/deactivate/ */
+export interface CustomerDeactivatePayload {
+  reason?: string;
+  confirmation_code?: string;
+}
+
+/**
+ * The real backend (require_destructive_confirmation, kasuvia-auth/common/
+ * utils/destructive_confirmation.py:76) ALWAYS returns this shape with
+ * HTTP 409 on the first deactivate call (no confirmation_code yet) — this
+ * is not an error case, it's step 1 of a required two-step confirmation.
+ * The code is generated and returned by the server itself (not sent via
+ * email) — it exists to require an explicit second, deliberate action in
+ * the UI, not to verify identity out-of-band. Resubmit the identical
+ * request with `confirmation_code` set to this value to actually deactivate.
+ */
+export interface DeactivateConfirmationRequired {
+  message: string;
+  impact: string[];
+  confirmation_code: string;
+  expires_in_minutes: number;
+}
+
+export type DeactivateAccountResult =
+  | { status: 'confirmation_required'; data: DeactivateConfirmationRequired }
+  | { status: 'success'; detail: string };
+
+/** POST /auth/change-password/ — identity-mode-agnostic (owner/staff/customer). */
+export interface ChangePasswordPayload {
+  /** Omit only when the account has no password yet (social/passwordless-only). */
+  old_password?: string;
+  new_password: string;
+  confirm_password: string;
+}
+
+/** POST /auth/customer/reactivate/ */
+export interface CustomerReactivatePayload {
+  email: string;
+}
+
+/** POST /auth/customer/reactivate/verify/ */
+export interface CustomerReactivateVerifyPayload {
+  email: string;
+  code: string;
+}
+
+/**
+ * One entry in a customer's saved-address book.
+ * GET/POST /auth/profile/addresses/, PATCH/DELETE /auth/profile/addresses/{id}/.
+ * Field names mirror `DeliveryAddress`/`ShippingLocation` exactly so a saved
+ * address can be used directly at checkout with no remapping.
+ */
+export interface CustomerAddress {
+  id: string;
+  label: string;
+  first_name: string;
+  last_name: string;
+  phone: string;
+  street: string;
+  city: string;
+  state: string;
+  lga: string;
+  country: string;
+  postal: string;
+  is_default: boolean;
+  created_at: string;
+}
+
+/** Fields a caller may set when creating a saved address - `id`/`created_at` are server-assigned. */
+export type CreateCustomerAddressPayload = Omit<CustomerAddress, "id" | "created_at">;
+
+/** Partial update to an existing saved address. */
+export type UpdateCustomerAddressPayload = Partial<CreateCustomerAddressPayload>;
+
+/**
+ * GET /auth/storefront/business-info/ response.
+ * Public, unauthenticated (storefront-key-gated) business info for a
+ * storefront to render — e.g. footer/about section. An explicit allow-list
+ * on the backend (kasuvia-auth's PublicBusinessInfoView) — never owner
+ * identity, financial, or internal integration/logistics fields.
+ */
+export interface StorefrontBusinessInfo {
+  business_id: string;
+  name: string;
+  // CharField(max_length=140, blank=True, null=True) — real null on the wire
+  // when never set, unlike the blank=True-only fields below.
+  tagline: string | null;
+  business_type: string;
+  country: string;
+  // CharField/EmailField/TextField(blank=True) — always a string on the
+  // wire (possibly empty ""), never null. Only logo_picture is a real
+  // URLField(null=True) below.
+  business_contact_phone: string;
+  business_contact_email: string;
+  business_physical_address: string;
+  logo_picture: string | null;
+  social_links: Record<string, string>;
+  currency: string;
+  // Optional, business-chosen hex colors (e.g. "#RRGGBB") — null when never
+  // set. Added to PublicBusinessInfoView's allow-list 2026-09-22; previously
+  // stored on the backend but never returned here.
+  brand_color_primary: string | null;
+  brand_color_secondary: string | null;
+  brand_color_accent: string | null;
+  brand_color_tertiary: string | null;
+}
+
+
 // ── Auth Context ──────────────────────────────────────────────────────────────
 
 export interface AuthContextValue {
@@ -144,6 +279,14 @@ export interface AuthContextValue {
   closeModal: () => void;
   setCustomer: (user: CustomerUser | null) => void;
   logout: () => Promise<void>;
-  login: (payload: Omit<CustomerLoginPayload, 'tenant_id'>) => Promise<void>;
-  register: (payload: Omit<CustomerRegisterPayload, 'tenant_id'>) => Promise<{ requires_verification: boolean }>;
+  login: (payload: CustomerLoginPayload) => Promise<void>;
+  // REAL BUG FIXED (2026-09-20): `requires_verification` was never a real
+  // backend concept for customers — CustomerRegisterView never sends an
+  // email OTP and registration is instant. Removed rather than kept as an
+  // always-false field.
+  register: (payload: CustomerRegisterPayload) => Promise<void>;
+  /** Current browser's guest cart session id — pass through to any auth call (e.g. OTP verify) not already routed through login()/register(), so kasuvia-auth's server-side post-login cart merge (see loginCustomer's doc comment) actually fires. */
+  guestSessionId: string | null;
+  /** Call after any auth flow not routed through login()/register() succeeds (e.g. OTP verify), once the server-side merge above has run — rotates to a fresh guest session id. */
+  rotateGuestSessionId: () => void;
 }

package/src/types/business/index.ts

@@ -1,3 +1,10 @@
+// REAL BUG FIXED (2026-09-21): `is_verified` was never a real field on this
+// endpoint's response — kasuvia-auth's InternalBusinessDetailView
+// (internal.py) explicitly renamed it away (its own comment: "REAL BUG
+// FOUND AND FIXED... named 'is_verified' but meant 'has a name and is
+// active'... Renamed to what it actually checks") to the two real fields
+// below well before this SDK type was last touched. Not read by any current
+// storefront consumer, but a landmine for the next one.
 export interface BusinessConfig {
   business_id: string;
   storefront_business_id: string;
@@ -6,6 +13,7 @@ export interface BusinessConfig {
   settlement_currency: string;
   country: string;
   region: string;
-  is_verified: boolean;
+  has_completed_onboarding: boolean;
+  owner_kyc_verified: boolean;
   is_active: boolean;
 }

package/src/types/cms/index.ts

@@ -9,7 +9,7 @@ export interface CmsField {
   label: string
   type: string
   required: boolean
-  config: Record<string, any>
+  config: Record<string, unknown>
   sub_fields?: CmsField[]
 }
 
@@ -38,17 +38,102 @@ export interface CmsEntry {
   id: string
   business_id: string
   model_slug: string
-  data: Record<string, any>
+  data: Record<string, unknown>
   created_at: string
   updated_at: string
   created_by: string | null
 }
 
+/** Real value shape of a CmsField with type "media" (kasuvia-media-system asset reference). */
+export interface CmsMediaValue {
+  id: string
+  url: string
+  alt?: string
+}
+
+/** Real value shape of a CmsField with type "icon". */
+export interface CmsIconValue {
+  package: string
+  name: string
+}
+
+/**
+ * The "blogs" CMS model's real field shape, as created by a merchant through
+ * kasuvia-cms's dynamic model builder. Field names are merchant-defined
+ * (this is a dynamic CMS, not a fixed schema) — this type documents the
+ * specific field set kasuvia-storefront's dedicated /blog pages render,
+ * confirmed live against a real "blogs" model. A storefront whose merchant
+ * named these fields differently needs its own type — this is a rendering
+ * convenience, not a backend contract.
+ */
+export interface BlogEntryData {
+  blog_title: string
+  blog_slug: string
+  blog_content: string
+  excerpt?: string
+  author: string
+  category: string
+  tags?: string
+  featured_image?: CmsMediaValue
+  published_date: string
+  is_published: boolean
+  is_featured?: boolean
+  featured_icon?: CmsIconValue
+}
+
+/**
+ * The "store-locations" CMS model's real field shape (kasuvia-cms/scripts/
+ * seed_dummy_models.py's STORE_LOCATIONS_MODEL — merchant-defined, dynamic
+ * CMS, this documents the real shape as configured, not a fixed schema).
+ */
+export interface StoreLocationEntryData {
+  store_name: string
+  address: string
+  city: string
+  store_type: 'Flagship' | 'Outlet' | 'Pop-up' | 'Franchise'
+  phone?: string
+  is_open: boolean
+  opening_time: string
+  closing_time: string
+  store_image?: CmsMediaValue
+  store_icon?: CmsIconValue
+}
+
+/** The "flash-sales" CMS model's real field shape (same source as above). */
+export interface FlashSaleEntryData {
+  event_title: string
+  event_description: string
+  start_date: string
+  end_date: string
+  countdown_datetime: string
+  discount_percentage: number
+  is_active: boolean
+  banner_image?: CmsMediaValue
+}
+
+/** The "product-faqs" CMS model's real field shape (same source as above). */
+export interface ProductFaqEntryData {
+  category: string
+  question: string
+  answer: string
+  is_featured: boolean
+  /** Free-text merchant-typed field (e.g. "Shipping Policy: /policies/shipping, Track Your Order: /orders/track") — not structured, rendered as plain text. */
+  related_links?: string
+}
+
+// REAL BUG FIXED (2026-09-21): this used {entries, total, page, page_size} —
+// kasuvia-cms's own real response (cms_schemas.py's CmsEntryListResponse)
+// was renamed to the platform-standard paginated envelope
+// {results, count, page, page_size, total_pages} back in 2026-09-17, with
+// an explicit code comment flagging kasuvia-sdk/kasuvia-storefront as not
+// yet updated (they were frozen at the time). Every CMS list call has been
+// silently reading undefined `.entries`/`.total` since.
 export interface CmsEntryListResponse {
-  entries: CmsEntry[]
-  total: number
+  results: CmsEntry[]
+  count: number
   page: number
   page_size: number
+  total_pages: number
 }
 
 export interface CmsIcon {
@@ -69,9 +154,9 @@ export interface ListCmsEntriesParams {
 }
 
 export interface CreateCmsEntryParams {
-  data: Record<string, any>
+  data: Record<string, unknown>
 }
 
 export interface UpdateCmsEntryParams {
-  data: Record<string, any>
+  data: Record<string, unknown>
 }

package/src/types/cms/legal.ts

@@ -0,0 +1,18 @@
+/**
+ * Legal Document Types
+ *
+ * Types for merchant storefront legal pages generated by
+ * kasuvia-website-builder-system via kasuvia-cms.
+ */
+
+export interface LegalSection {
+  heading: string;
+  body: string;
+}
+
+export interface MerchantLegalDocument {
+  document_type: string;
+  template_version: string;
+  rendered_sections: LegalSection[];
+  published_at: string;
+}

package/src/types/consultations/index.ts

@@ -1,74 +1,15 @@
 /**
- * Consultation types for customer-facing storefront
+ * Bespoke commission types for the customer-facing storefront.
+ *
+ * REAL BUG FIXED (2026-09-21): this file used to also declare a fictional
+ * "Consultation" resource (ConsultationStatus/Consultation/ConsultationMessage/
+ * etc.) — confirmed there is no /social/consultations/* route or Consultation
+ * model anywhere in kasuvia-store-management. The owner confirmed the
+ * feature no longer exists there. Removed along with its dead SDK service,
+ * hooks, and storefront pages/components — only the real bespoke types
+ * (used by bespoke.service.ts against real backend endpoints) remain here.
  */
 
-export type ConsultationStatus =
-  | "pending"
-  | "quoted"
-  | "negotiating"
-  | "deposit_pending"
-  | "deposit_paid"
-  | "converting"
-  | "converted"
-  | "rejected";
-
-export type ConsultationProductType = "bespoke" | "service";
-
-export interface ConsultationMessage {
-  id: string;
-  consultation_id: string;
-  sender_id: string;
-  sender_role: "customer" | "merchant" | "system";
-  message: string;
-  attachments: string[];
-  is_read: boolean;
-  created_at: string;
-}
-
-export interface Consultation {
-  id: string;
-  business_id: string;
-  customer_id: string;
-  product_id: string | null;
-  title: string;
-  status: ConsultationStatus;
-  product_type: ConsultationProductType;
-  quote_amount: number | null;
-  agreed_price: number | null;
-  deposit_amount: number | null;
-  deposit_required: boolean;
-  is_physical_delivery: boolean;
-  expected_delivery_type: string | null;
-  structured_details: Record<string, unknown>;
-  rejection_reason: string | null;
-  converted_order_id: string | null;
-  slot_booking_id: string | null;
-  capacity_config_id: string | null;
-  created_at: string;
-  updated_at: string;
-  messages: ConsultationMessage[];
-}
-
-export interface ConsultationCreatePayload {
-  product_id?: string;
-  title: string;
-  description: string;
-  reference_images?: string[];
-  custom_measurements?: Record<string, string | number>;
-  preferred_timeline?: string;
-  special_instructions?: string;
-  product_type?: ConsultationProductType;
-}
-
-export interface ConsultationMessagePayload {
-  message: string;
-  attachments?: string[];
-}
-
-export interface ConsultationQuoteAcceptPayload {
-  agreed_price: number;
-}
-
 export interface BespokeAvailability {
   available_slots: number;
   next_available_date: string | null;
@@ -77,3 +18,54 @@ export interface BespokeAvailability {
   production_days: number;
   is_available: boolean;
 }
+
+/**
+ * Returned by all 3 bespoke deliverable-proofing action endpoints (POST
+ * .../bespoke/submit-deliverable, .../approve, .../request-revision) —
+ * matches BespokeStatusResponse (kasuvia-store-management/app/schemas/
+ * bespoke.py:120-128) exactly.
+ */
+export interface BespokeDeliverableStatus {
+  id: string;
+  order_status: string;
+  bespoke_status: string;
+  bespoke_deliverable_submitted_at: string | null;
+  bespoke_deliverable_url: string | null;
+  bespoke_deliverable_notes: string | null;
+  bespoke_buyer_approved_at: string | null;
+  bespoke_revision_count: number;
+  /**
+   * REAL GAP FIXED (2026-09-23) via the REST codegen initiative: the real
+   * backend response (BespokeStatusResponse, kasuvia-store-management's
+   * app/schemas/bespoke.py) has always included this field - this hand-
+   * written interface simply never declared it, so it was silently
+   * unavailable to every consumer even though the backend was already
+   * returning it on every deliverable-status response.
+   */
+  bespoke_revision_notes: string | null;
+}
+
+/**
+ * Embedded on an Order as `order.bespoke_fulfillment` — matches
+ * BespokeFulfillmentResponse (kasuvia-store-management/app/schemas/
+ * order.py:150-168) exactly. This is the real source of a bespoke order's
+ * current deliverable state; there is no separate list/GET endpoint for it.
+ */
+export interface BespokeFulfillment {
+  brief: string | null;
+  reference_images: string[] | null;
+  measurements: Record<string, unknown> | null;
+  preferred_timeline: string | null;
+  special_instructions: string | null;
+  deposit_ratio: number | null;
+  deposit_amount: number | null;
+  balance_amount: number | null;
+  status: string | null;
+  deliverable_submitted_at: string | null;
+  deliverable_url: string | null;
+  deliverable_notes: string | null;
+  buyer_approved_at: string | null;
+  revision_count: number;
+  revision_notes: string | null;
+  timeline_breached_at: string | null;
+}