@withpotter/lib 0.13.0-next.101

package/dist/api/types/payables.d.ts

@@ -0,0 +1,140 @@
+/**
+ * What the business owes.
+ *
+ * The half of the merchant's morning question Box could not answer: it knew
+ * what came in and who still owed the merchant, and had no supplier, no bill
+ * and no due date anywhere.
+ */
+export type VendorKind = 'supplier' | 'staff' | 'contractor' | 'landlord' | 'utility' | 'government' | 'other';
+export type BillStatus = 'draft' | 'open' | 'partially_paid' | 'paid' | 'cancelled';
+export type BillPaymentMethod = 'cash' | 'bank_transfer' | 'card' | 'cheque' | 'other';
+/**
+ * How the merchant pays this party — read, never used to move money.
+ *
+ * Box has no transfer rail. These are here so an account number lives in the
+ * product instead of in a chat thread.
+ */
+export interface VendorBankDetails {
+    accountName?: string | null;
+    accountNumber?: string | null;
+    bankCode?: string | null;
+    bankName?: string | null;
+}
+export interface Vendor {
+    id: string;
+    name: string;
+    kind: VendorKind;
+    email: string | null;
+    phone: string | null;
+    bankDetails: VendorBankDetails | null;
+    notes: string | null;
+    isArchived: boolean;
+    createdAt: string;
+}
+/** The vendor record, with what the relationship has actually cost. */
+export interface VendorDetail extends Vendor {
+    totalPaid: number;
+    outstanding: number;
+}
+export interface BillRecurrence {
+    interval: 'weekly' | 'monthly' | 'quarterly' | 'yearly';
+    nextRunOn: string;
+    endsOn?: string | null;
+    issued?: number;
+}
+export interface BillPayment {
+    id: string;
+    billId: string;
+    amount: number;
+    currency: string;
+    paidOn: string;
+    method: BillPaymentMethod;
+    reference: string | null;
+    note: string | null;
+    createdAt: string;
+}
+export interface Bill {
+    id: string;
+    vendorId: string;
+    vendor: Vendor | null;
+    reference: string | null;
+    status: BillStatus;
+    /**
+     * Derived by the API from the due date, never stored.
+     *
+     * `overdue` is not a status for the reason it failed as one on invoices: a
+     * stored state only changes when something runs, so a bill whose date passed
+     * on a quiet Sunday reads as open until a sweep touches it.
+     */
+    isOverdue: boolean;
+    category: string | null;
+    description: string | null;
+    currency: string;
+    total: number;
+    amountPaid: number;
+    amountDue: number;
+    issueDate: string | null;
+    dueDate: string;
+    paidAt: string | null;
+    cancelledAt: string | null;
+    recurrence: BillRecurrence | null;
+    notes: string | null;
+    payments?: BillPayment[];
+    createdAt: string;
+}
+export interface PayablesStats {
+    totalDue: number;
+    dueCount: number;
+    overdueAmount: number;
+    overdueCount: number;
+    dueThisWeekAmount: number;
+    dueThisWeekCount: number;
+    paidThisMonth: number;
+    currency: string;
+}
+export interface VendorsQuery {
+    kind?: VendorKind;
+    search?: string;
+    includeArchived?: boolean;
+    page?: number;
+    limit?: number;
+}
+export interface BillsQuery {
+    vendorId?: string;
+    /** `outstanding` and `overdue` are shorthands the API resolves. */
+    status?: BillStatus | 'outstanding' | 'overdue';
+    category?: string;
+    dueBefore?: string;
+    dueAfter?: string;
+    search?: string;
+    page?: number;
+    limit?: number;
+}
+export interface CreateVendorInput {
+    name: string;
+    kind?: VendorKind;
+    email?: string | null;
+    phone?: string | null;
+    bankDetails?: VendorBankDetails | null;
+    notes?: string | null;
+}
+export interface CreateBillInput {
+    vendorId: string;
+    total: number;
+    dueDate: string;
+    currency?: string;
+    reference?: string | null;
+    category?: string | null;
+    description?: string | null;
+    issueDate?: string | null;
+    notes?: string | null;
+    status?: BillStatus;
+    recurrence?: BillRecurrence | null;
+}
+export interface RecordBillPaymentInput {
+    amount: number;
+    paidOn: string;
+    method?: BillPaymentMethod;
+    reference?: string | null;
+    note?: string | null;
+}

package/dist/api/types/payables.js

@@ -0,0 +1 @@
+//# sourceMappingURL=payables.js.map

package/dist/api/types/payables.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/api/types/pos.d.ts

@@ -0,0 +1,121 @@
+export interface PosSettlement {
+    id: string;
+    reference: string;
+    orderId: string;
+    operatorId: string;
+    amount: number;
+    currency: string;
+    state: string;
+    terminal?: {
+        mid?: string;
+        tid?: string;
+    } | null;
+    authorization?: {
+        last4?: string;
+        scheme?: string;
+        authorizationCode?: string;
+    } | null;
+    createdAt: string;
+    reviewedAt?: string | null;
+    rejectionReason?: string | null;
+}
+export declare const POS_OPERATOR_ROLES: readonly ["cashier", "manager", "admin"];
+export type PosOperatorRole = (typeof POS_OPERATOR_ROLES)[number];
+export interface PosTill {
+    id: string;
+    label: string;
+    state: string;
+    /** Live and usable — enrolled and not temporarily disconnected. */
+    connected: boolean;
+    operatorId: string | null;
+    /** Operators allowed to sign in here. Null = open till (whole roster). */
+    assignedOperatorIds: string[] | null;
+    specs: Record<string, unknown> | null;
+    lastSeenAt: string | null;
+    linkedAt: string;
+    disconnectedAt: string | null;
+    revokedAt: string | null;
+}
+export interface PosOperator {
+    operatorId: string;
+    state: string;
+    role: PosOperatorRole;
+    label: string | null;
+    shiftDurationMinutes: number;
+    updatedAt: string;
+}
+export interface PendingEnrollment {
+    userCode: string;
+    deviceLabel: string | null;
+    requestedAt: string;
+    expiresAt: string;
+}
+export interface PosSession {
+    id: string;
+    deviceId: string;
+    deviceLabel: string;
+    operatorId: string | null;
+    operatorLabel: string | null;
+    state: 'open' | 'closed';
+    openedAt: string;
+    expiresAt: string;
+    lastSeenAt: string;
+    revokedAt: string | null;
+    closedReason: string | null;
+    replacedBySessionId: string | null;
+    flagged: boolean;
+    flagReason: string | null;
+}
+export interface PosOperatorEvent {
+    id: string;
+    type: 'shift.open' | 'shift.close' | 'shift.revoked' | 'sale.created' | 'sale.settled' | 'product.updated' | 'device.approved';
+    summary: string;
+    data: Record<string, unknown> | null;
+    deviceId: string | null;
+    sessionId: string | null;
+    at: string;
+}
+export interface PosOperatorAuditShift {
+    sessionId: string;
+    deviceId: string;
+    state: string;
+    openedAt: string;
+    lastSeenAt: string | null;
+}
+export interface PosOperatorAudit {
+    operatorId: string;
+    label: string | null;
+    role: string | null;
+    events: PosOperatorEvent[];
+    shifts: PosOperatorAuditShift[];
+}
+export interface PosTillAuditEvent {
+    id: string;
+    type: 'shift.open' | 'shift.revoked' | 'sale.created' | 'sale.settled' | 'product.updated' | 'device.approved' | 'device.enrolled' | 'till.renamed' | 'till.assigned' | 'till.disconnected' | 'till.reconnected' | 'till.unpaired';
+    summary: string;
+    data: Record<string, unknown> | null;
+    operatorId: string | null;
+    operatorLabel: string | null;
+    sessionId: string | null;
+    at: string;
+}
+export interface PosTillAudit {
+    deviceId: string;
+    label: string;
+    state: string;
+    linkedAt: string;
+    events: PosTillAuditEvent[];
+}
+export interface TillRequest {
+    id: string;
+    tenantId: string;
+    tenantName: string;
+    quantity: number;
+    note: string | null;
+    status: 'pending' | 'approved' | 'rejected' | 'fulfilled';
+    decidedBy: string | null;
+    decisionNote: string | null;
+    decidedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}

package/dist/api/types/pos.js

@@ -0,0 +1,5 @@
+const POS_OPERATOR_ROLES = ["cashier", "manager", "admin"];
+export {
+  POS_OPERATOR_ROLES
+};
+//# sourceMappingURL=pos.js.map

package/dist/api/types/pos.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/api/types/pos.ts"],"sourcesContent":["// POS settlements (card charges captured on the merchant's tills). The engine's\n// GET /pos/settlements is state-scoped; confirm/reject carry the host-asserted\n// reviewer identity (Factor 4).\nexport interface PosSettlement {\n  id: string;\n  reference: string;\n  orderId: string;\n  operatorId: string;\n  amount: number; // minor units (kobo)\n  currency: string;\n  state: string; // 'pending_review' | 'confirmed' | 'rejected'\n  terminal?: { mid?: string; tid?: string } | null;\n  authorization?: {\n    last4?: string;\n    scheme?: string;\n    authorizationCode?: string;\n  } | null;\n  createdAt: string;\n  reviewedAt?: string | null;\n  rejectionReason?: string | null;\n}\n\nexport const POS_OPERATOR_ROLES = ['cashier', 'manager', 'admin'] as const;\nexport type PosOperatorRole = (typeof POS_OPERATOR_ROLES)[number];\n\n// A till (paired POS device) as seen from the dashboard registry.\nexport interface PosTill {\n  id: string;\n  label: string;\n  state: string; // 'enrolled' | 'revoked' | …\n  /** Live and usable — enrolled and not temporarily disconnected. */\n  connected: boolean;\n  operatorId: string | null;\n  /** Operators allowed to sign in here. Null = open till (whole roster). */\n  assignedOperatorIds: string[] | null;\n  specs: Record<string, unknown> | null;\n  lastSeenAt: string | null;\n  linkedAt: string;\n  disconnectedAt: string | null;\n  revokedAt: string | null;\n}\n\n// An operator (cashier/manager) in the roster. The PIN verifier is never exposed.\nexport interface PosOperator {\n  operatorId: string;\n  state: string;\n  role: PosOperatorRole;\n  label: string | null;\n  shiftDurationMinutes: number;\n  updatedAt: string;\n}\n\n// A device code awaiting a manager's approval in the enrollment queue.\nexport interface PendingEnrollment {\n  userCode: string;\n  deviceLabel: string | null;\n  requestedAt: string;\n  expiresAt: string;\n}\n\n// A POS shift (sign-in) as seen from the dashboard, with labels resolved.\nexport interface PosSession {\n  id: string;\n  deviceId: string;\n  deviceLabel: string;\n  operatorId: string | null;\n  operatorLabel: string | null;\n  state: 'open' | 'closed';\n  openedAt: string;\n  expiresAt: string;\n  lastSeenAt: string;\n  revokedAt: string | null;\n  closedReason: string | null;\n  replacedBySessionId: string | null;\n  flagged: boolean;\n  flagReason: string | null;\n}\n\n// One attributed action in the operator audit trail (append-only, engine-side).\nexport interface PosOperatorEvent {\n  id: string;\n  type:\n    | 'shift.open'\n    | 'shift.close'\n    | 'shift.revoked'\n    | 'sale.created'\n    | 'sale.settled'\n    | 'product.updated'\n    | 'device.approved';\n  summary: string;\n  data: Record<string, unknown> | null;\n  deviceId: string | null;\n  sessionId: string | null;\n  at: string;\n}\n\n// A shift referenced by audit events — lets the UI label per-shift groups.\nexport interface PosOperatorAuditShift {\n  sessionId: string;\n  deviceId: string;\n  state: string;\n  openedAt: string;\n  lastSeenAt: string | null;\n}\n\nexport interface PosOperatorAudit {\n  operatorId: string;\n  label: string | null;\n  role: string | null;\n  events: PosOperatorEvent[];\n  shifts: PosOperatorAuditShift[];\n}\n\n// One event in a till's usage trail (operator resolved to a label).\nexport interface PosTillAuditEvent {\n  id: string;\n  type:\n    | 'shift.open'\n    | 'shift.revoked'\n    | 'sale.created'\n    | 'sale.settled'\n    | 'product.updated'\n    | 'device.approved'\n    | 'device.enrolled'\n    | 'till.renamed'\n    | 'till.assigned'\n    | 'till.disconnected'\n    | 'till.reconnected'\n    | 'till.unpaired';\n  summary: string;\n  data: Record<string, unknown> | null;\n  operatorId: string | null;\n  operatorLabel: string | null;\n  sessionId: string | null;\n  at: string;\n}\n\nexport interface PosTillAudit {\n  deviceId: string;\n  label: string;\n  state: string;\n  linkedAt: string;\n  events: PosTillAuditEvent[];\n}\n\nexport interface TillRequest {\n  id: string;\n  tenantId: string;\n  tenantName: string;\n  quantity: number;\n  note: string | null;\n  status: 'pending' | 'approved' | 'rejected' | 'fulfilled';\n  decidedBy: string | null;\n  decisionNote: string | null;\n  decidedAt: string | null;\n  createdAt: string;\n  updatedAt: string;\n}\n"],"mappings":"AAsBO,MAAM,qBAAqB,CAAC,WAAW,WAAW,OAAO;","names":[]}

package/dist/api/types/record-analytics.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Analytics scoped to ONE record, rather than to the workspace.
+ *
+ * Everything in `analytics.ts` next door is a workspace-wide aggregate — the
+ * hub's twenty-odd numbers, traffic, attribution, cohorts. These two are a
+ * different question with a different shape: they take a `contentId` and
+ * answer "what did THIS one do", which is the return leg of the loop a
+ * merchant runs. They were split out when the second one arrived and pushed
+ * the barrel past 500 lines; the cut is by meaning, not by size.
+ */
+/**
+ * One event's ticketing, from the bookings behind it.
+ *
+ * Nine measurements the API has always computed and the dashboard has never
+ * asked for — the endpoint had no client wrapper at all.
+ */
+export interface EventAnalytics {
+    totalBookings: number;
+    /** Bookings by status: confirmed, cancelled, no_show, checked_in… */
+    byStatus: Record<string, number>;
+    /** Heads, not bookings — one booking can bring a party. */
+    totalGuests: number;
+    totalRevenue: number;
+    checkedInCount: number;
+    noShowCount: number;
+    /** Already a percentage server-side; do not multiply it again. */
+    checkInRate: number;
+    soldByTier: Array<{
+        tierId: string;
+        tierName: string;
+        count: number;
+    }>;
+    totalTickets: number;
+}
+/** One row of "where the buyers came from" for a single item. */
+export interface ProductSourceRow {
+    /** `direct` is the bucket for orders carrying no attribution at all. */
+    source: string;
+    units: number;
+    revenue: number;
+    orders: number;
+    /** Share of THIS item's revenue, not the workspace's. */
+    share: number;
+}
+/**
+ * What one item did over a window: the ordinary-product counterpart to
+ * `EventAnalytics` above, which has answered the same question for a ticketed
+ * event since event-tickets shipped and left every other archetype with an
+ * item screen that could describe a record and never say what it earned.
+ *
+ * `bySource` is source-AGNOSTIC by design — see the note in
+ * `product-performance-panel.tsx` for why a fixed platform list here would be
+ * wrong for most of the world.
+ */
+/** The top of the funnel: what the posts carrying this item's links reached. */
+export interface ItemReach {
+    /** Posts carrying one of this item's share links. */
+    posts: number;
+    /**
+     * People reached. NULL, never zero, when no post reported a figure —
+     * YouTube counts views rather than people and reports no reach at all.
+     */
+    reach: number | null;
+    views: number | null;
+    /** How many of those posts reported reach, so "none" can be told from "unknown". */
+    reachKnown: number;
+    lastPostedAt: string | null;
+}
+export interface ProductPerformance {
+    contentId: string;
+    from: string;
+    to: string;
+    units: number;
+    revenue: number;
+    orders: number;
+    /** Distinct buyers. Somebody who bought it four times is one. */
+    customers: number;
+    /** Null when it has never sold in the window. */
+    firstSoldAt: string | null;
+    lastSoldAt: string | null;
+    /** The same length of time immediately before this window. */
+    priorRevenue: number;
+    priorUnits: number;
+    priorOrders: number;
+    bySource: ProductSourceRow[];
+    /** How much of this item's money carries no source at all. */
+    unattributedRevenue: number;
+    unattributedOrders: number;
+    /**
+     * Null when no post carries one of this item's links — which is NOT zero
+     * reach. A workspace that has connected nothing was not reached by nobody;
+     * Box simply cannot see.
+     */
+    socialReach: ItemReach | null;
+}

package/dist/api/types/record-analytics.js

@@ -0,0 +1 @@
+//# sourceMappingURL=record-analytics.js.map

package/dist/api/types/record-analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/api/types/sales-patterns.d.ts

@@ -0,0 +1,58 @@
+/** Orders and money for one weekday (0 Sunday to 6) or one hour (0 to 23). */
+export interface PatternBucket {
+    key: number;
+    orders: number;
+    revenue: number;
+}
+/** One channel or one category, and what it brought in. */
+export interface MixRow {
+    key: string;
+    orders: number;
+    units: number;
+    revenue: number;
+}
+/** The window's sales split by whether the buyer had ordered before it. */
+export interface NewReturning {
+    newOrders: number;
+    newRevenue: number;
+    returningOrders: number;
+    returningRevenue: number;
+}
+export interface LocationOption {
+    id: string;
+    name: string;
+}
+/** When the money comes in, who it comes from, and through what. */
+export interface SalesPatterns {
+    /** Seven entries, Sunday first, in the workspace's timezone. */
+    byWeekday: PatternBucket[];
+    /** Twenty-four entries, midnight first. */
+    byHour: PatternBucket[];
+    newVsReturning: NewReturning;
+    byChannel: MixRow[];
+    byCategory: MixRow[];
+    /** Every channel the workspace has used, for the filter. */
+    channels: string[];
+    locations: LocationOption[];
+}
+/** The month's sales goal, or null when none is set. */
+export interface SalesTarget {
+    monthly: number | null;
+}
+/** What the owner says they spent on one campaign. */
+export interface CampaignSpendRow {
+    campaign: string;
+    amount: number;
+}
+export interface CampaignSpend {
+    items: CampaignSpendRow[];
+}
+/** One bucket: sales that carried a source, and sales that did not. */
+export interface AttributionBucket {
+    date: string;
+    known: number;
+    unknown: number;
+}
+export interface AttributionSeries {
+    buckets: AttributionBucket[];
+}

package/dist/api/types/sales-patterns.js

@@ -0,0 +1 @@
+//# sourceMappingURL=sales-patterns.js.map

package/dist/api/types/sales-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/api/types/tabs.d.ts

@@ -0,0 +1,210 @@
+import { type Member } from './orders';
+import { type TabItem, type TabStatus } from './customers';
+/**
+ * Tabs (Reserve & Seat: running cafe/restaurant tabs) — as the API sends it.
+ *
+ * One slice of what was a 4,164-line `types.ts`. The sections were already
+ * here as comment fences; they are files now, so a type is found by the
+ * endpoint it belongs to rather than by scrolling.
+ */
+export interface Tab {
+    id: string;
+    tenantId: string;
+    tableLabel?: string | null;
+    /** Bookable resource (physical table) this tab is seated at. */
+    resourceId?: string | null;
+    /** Reservation (booking) this tab was opened from. */
+    bookingId?: string | null;
+    customerName?: string | null;
+    customerPhone?: string | null;
+    customerEmail?: string | null;
+    status: TabStatus;
+    items: TabItem[];
+    total: number;
+    currency: string;
+    /** Set once the tab is settled into a payable order. */
+    orderId?: string | null;
+    settledAt?: string | null;
+    createdAt: string;
+}
+export interface OpenTabInput {
+    tableLabel?: string;
+    resourceId?: string;
+    bookingId?: string;
+    customerName?: string;
+    customerPhone?: string;
+    customerEmail?: string;
+    items?: TabItem[];
+    metadata?: Record<string, unknown>;
+}
+export interface AddToTabInput {
+    items: TabItem[];
+}
+export interface SettleTabInput {
+    /** Needed only for pay-later settles (so the guest gets a payment link). */
+    customerEmail?: string;
+    paymentMethod?: string;
+    /** Mark the settling order paid immediately (in-person cash/transfer). */
+    markPaid?: boolean;
+    /** How an in-person payment was collected (when markPaid). */
+    paymentChannel?: 'cash' | 'bank_transfer';
+    /** External reference for the in-person payment (e.g. transfer code). */
+    paymentReference?: string;
+    /** Order provenance channel; defaults to 'cafe' server-side. */
+    channel?: string;
+}
+export interface SettleTabResult {
+    tab: Tab;
+    /** The order to be paid via the normal order payment flow. */
+    orderId: string;
+    orderNumber: string;
+}
+export interface DigitalFileInfo {
+    id: string;
+    contentId: string;
+    filename: string;
+    originalName: string;
+    mimeType: string | null;
+    fileSize: number | null;
+    downloadLimit: number | null;
+    position: number;
+    isActive: boolean;
+    createdAt: string;
+}
+/** Mirrors DownloadToken in potter-api. */
+export interface OrderDownloadToken {
+    id: string;
+    digitalFileId: string;
+    orderId: string;
+    token: string;
+    downloadCount: number;
+    downloadLimit: number | null;
+    expiresAt: string | null;
+    lastDownloadedAt: string | null;
+}
+export interface SegmentFilters {
+    type?: string;
+    status?: string;
+    source?: string;
+    tags?: string[];
+    minSpent?: number;
+    maxSpent?: number;
+    minOrders?: number;
+    maxOrders?: number;
+    acceptsMarketing?: boolean;
+    emailVerified?: boolean;
+    lastOrderBefore?: string;
+    lastOrderAfter?: string;
+    createdAfter?: string;
+    createdBefore?: string;
+    city?: string;
+    state?: string;
+    country?: string;
+    subscriptionStatus?: 'active' | 'churned' | 'never';
+}
+export interface CustomerSegment {
+    id: string;
+    name: string;
+    description: string | null;
+    filters: SegmentFilters;
+    customerCount: number;
+    /**
+     * What the people in this segment have spent between them.
+     *
+     * Always a number: the API coerces before it leaves, because the column is
+     * DECIMAL and pg returns those as strings.
+     */
+    totalValue: number;
+    /** When the size was last worked out; null before the first refresh. */
+    refreshedAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateSegmentInput {
+    name: string;
+    description?: string;
+    filters: SegmentFilters;
+}
+export interface UpdateSegmentInput {
+    name?: string;
+    description?: string;
+    filters?: SegmentFilters;
+}
+export interface SegmentPreviewResult {
+    members: Member[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+}
+export interface CustomerOverview {
+    totalCustomers: number;
+    activeCustomers: number;
+    /**
+     * Customers acquired in the requested period and in the equal-length window
+     * before it. Ask without a period and these fall back to this calendar month
+     * against last, with `periodScoped` false to say so.
+     */
+    newInPeriod: number;
+    newInPriorPeriod: number;
+    periodScoped: boolean;
+    growthRate: number;
+    byType: Record<string, number>;
+    bySource: Record<string, number>;
+    averageOrderValue: number;
+    averageLifetimeValue: number;
+    marketingOptInRate: number;
+}
+export interface AcquisitionDataPoint {
+    date: string;
+    total: number;
+    bySource: Record<string, number>;
+}
+export interface RetentionCohort {
+    cohort: string;
+    totalCustomers: number;
+    withOrders: number;
+    withRepeatOrders: number;
+    retentionRate: number;
+}
+export interface RetentionMetrics {
+    repeatPurchaseRate: number;
+    averageOrdersPerCustomer: number;
+    churnedCustomers: number;
+    atRiskCustomers: number;
+    loyalCustomers: number;
+    cohorts: RetentionCohort[];
+    /**
+     * What these figures are measured over, said by the API rather than assumed
+     * here.
+     *
+     * None of them is scoped to a date range: they are lifetime (repeat rate,
+     * orders per customer, loyal, cohorts) or a rolling window counted back from
+     * today (at risk, churned). A customer is not churned *during* a period,
+     * they are churned *as of* a date, which is why the hub's period picker
+     * cannot move them and why this frame is labelled "On the books".
+     *
+     * Optional: a build that predates it sends nothing, and the tiles fall back
+     * to saying no window rather than inventing one.
+     */
+    window?: {
+        basis: 'lifetime-and-rolling';
+        churnedAfterDays: number;
+        atRiskAfterDays: number;
+        cohortMonths: number;
+        asOf: string;
+    };
+}
+export interface LtvBucket {
+    range: string;
+    min: number;
+    max: number;
+    count: number;
+    percentage: number;
+}
+export interface LtvDistribution {
+    averageLtv: number;
+    medianLtv: number;
+    topPercentile: number;
+    buckets: LtvBucket[];
+}

package/dist/api/types/tabs.js

@@ -0,0 +1 @@
+//# sourceMappingURL=tabs.js.map

package/dist/api/types/tabs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}