@aifeatures/admin-react 0.13.0 → 0.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -129,11 +129,38 @@ interface ApiError {
129
129
  * request, which makes showing an outage and a Retry actively misleading —
130
130
  * the retry repeats the same 400 forever, and the thing to change is a goal.
131
131
  *
132
- * All four are EXPECTED consequences of the request, never outages, so a
132
+ * `goal_not_found` says the named goal does not exist on this site. Emitted
133
+ * by the goals CRUD and by the conversions drill-down, which resolves a goal
134
+ * by display name.
135
+ *
136
+ * `goal_has_no_targets` is the drill-down's own, and it is a fact about the
137
+ * GOAL rather than the request: the goal matches events that carry no link,
138
+ * so there are no values to break down. `Form: Submission` has thousands of
139
+ * conversions and no recorded targets, because nothing says WHICH form. A
140
+ * client must not render this as "no conversions" — the number above it says
141
+ * otherwise — and must not offer a Retry.
142
+ *
143
+ * `filters_unsupported` (plural) is NOT `filter_unsupported` above. The
144
+ * singular one says a filter cannot be answered for this site and period;
145
+ * this one says the report refuses filters outright, because answering an
146
+ * unfiltered report under a filtered request is indistinguishable from
147
+ * honouring it. Conversions and its drill-down both emit it.
148
+ *
149
+ * `invalid_limit` is an ordinary bad parameter, included because a consumer
150
+ * narrowing on this union otherwise cannot name it.
151
+ *
152
+ * All of these are EXPECTED consequences of the request, never outages, so a
133
153
  * client that cannot tell them apart from an unreachable source shows the
134
154
  * wrong recovery for every one of them.
155
+ *
156
+ * NOT EXHAUSTIVE, and worth knowing before you narrow on it: the API emits
157
+ * several more codes this union has never listed — `goal_invalid`,
158
+ * `goal_conflict`, `goal_name_taken`, `goal_limit_reached`,
159
+ * `funnel_not_found`, `funnel_step_missing` and
160
+ * `funnel_window_precedes_coverage` among them. They belong here, but adding
161
+ * them is a change to the goals and funnels surfaces rather than this one.
135
162
  */
136
- code?: 'filter_unsupported' | 'range_invalid' | 'dimension_unsupported' | 'goals_exceed_report_budget';
163
+ code?: 'filter_unsupported' | 'filters_unsupported' | 'range_invalid' | 'dimension_unsupported' | 'goals_exceed_report_budget' | 'goal_not_found' | 'goal_has_no_targets' | 'invalid_limit';
137
164
  }
138
165
  /**
139
166
  * A site's payment readiness (sites.paymentsStatus)
@@ -836,6 +863,25 @@ interface BusinessSummary {
836
863
  count: number;
837
864
  low_stock: LowStockProduct[];
838
865
  };
866
+ /**
867
+ * Durable commerce capabilities, unbounded in time. Neither is derivable
868
+ * from the fields above:
869
+ *
870
+ * invoicing an unpaid invoice is `pending`, outside the revenue
871
+ * family, and a service business has no catalogue — so
872
+ * nothing else here sees it.
873
+ * storefront_orders `revenue.*.orders` counts invoice-sourced rows too,
874
+ * while GET /orders excludes them by default, so a site
875
+ * whose only sale is a paid invoice reads as selling
876
+ * while the orders list it opens is empty.
877
+ *
878
+ * Optional: an older API omits it, and absent means "unknown", which callers
879
+ * must treat as no rather than yes.
880
+ */
881
+ commerce?: {
882
+ invoicing: boolean;
883
+ storefront_orders: boolean;
884
+ };
839
885
  visitors: BusinessVisitors | null;
840
886
  }
841
887
  /** Options for fetching the business summary. */
@@ -1845,8 +1891,44 @@ interface OrdersListProps {
1845
1891
  * two stacked back buttons taught nobody anything.
1846
1892
  */
1847
1893
  onDetailOpenChange?: (open: boolean) => void;
1894
+ /**
1895
+ * COMPACT MODE: cap the rows and drop this list's own chrome, so it can sit
1896
+ * inside a summary surface instead of owning a page.
1897
+ *
1898
+ * The point is that the EMPTY, LOADING and ERROR states come along
1899
+ * unchanged. A dashboard that hand-rolled its own "no orders yet" would be a
1900
+ * second copy of copy that already exists here, drifting from it — so the
1901
+ * summary borrows this list rather than imitating it.
1902
+ *
1903
+ * Suppressed while set: the saved-view tabs, search, filters, abandoned
1904
+ * toggle, CSV export and pagination. All of those are ways of ASKING a
1905
+ * question, and a summary is not where questions get asked.
1906
+ */
1907
+ maxRows?: number;
1908
+ /**
1909
+ * Where "view all" goes, and what a row click does in compact mode. Rows do
1910
+ * not open a detail inside a summary card: the card is a pointer at the
1911
+ * full surface, and swapping it for an order detail in place would strand
1912
+ * the reader somewhere they did not ask to be.
1913
+ */
1914
+ onViewAll?: () => void;
1848
1915
  }
1849
- declare function OrdersList({ onRefund, className, refreshKey, initialOrderId, showFulfillment, emptyMessage, onDetailOpenChange, }: OrdersListProps): react_jsx_runtime.JSX.Element;
1916
+ /**
1917
+ * A MODE CHANGE REMOUNTS, rather than being reconciled state by state.
1918
+ *
1919
+ * Compact and standalone are different views sharing an implementation:
1920
+ * different scope, different chrome, different navigation. Reconciling them
1921
+ * meant every piece of state the standalone view owns had to answer to the
1922
+ * mode, and that list is not enumerable from outside — two members were found
1923
+ * only by review, a one-time fallback LATCH in a ref and a scope owned by an
1924
+ * effect keyed on something else.
1925
+ *
1926
+ * Keying the implementation on the mode makes all of them correct by
1927
+ * construction, including the ones nobody has named, and deletes the reset
1928
+ * effects that were guessing at them. In-flight requests are cancelled by the
1929
+ * ordinary unmount cleanup.
1930
+ */
1931
+ declare function OrdersList(props: OrdersListProps): react_jsx_runtime.JSX.Element;
1850
1932
 
1851
1933
  interface PaymentsDashboardProps {
1852
1934
  /** Optional className */
@@ -2082,16 +2164,31 @@ interface LeadsViewProps {
2082
2164
  /** Host-app callback that swaps the panel back to the website preview (plan D13). */
2083
2165
  onBackToWebsite?: () => void;
2084
2166
  className?: string;
2167
+ /**
2168
+ * COMPACT MODE: cap the rows and render WITHOUT this view's shell, for a
2169
+ * summary surface. See the note in `OrdersList` — the point is that the
2170
+ * empty, loading and failure states are reused rather than reimplemented.
2171
+ */
2172
+ maxRows?: number;
2173
+ /** Where "view all" goes. */
2174
+ onViewAll?: () => void;
2085
2175
  }
2086
2176
  /**
2087
- * LeadsView — the merged people list (customers ∪ form leads) with in-view
2088
- * detail navigation (plan Unit 5). All lead-authored content renders as plain
2089
- * text and is labeled unverified (plan D7/D15). Ephemeral (plan D12).
2177
+ * A MODE CHANGE REMOUNTS, rather than being reconciled state by state.
2178
+ *
2179
+ * Compact and standalone are different views sharing an implementation:
2180
+ * different scope, different chrome, different navigation. Reconciling them
2181
+ * meant every piece of state the standalone view owns had to answer to the
2182
+ * mode, and that list is not enumerable from outside — two members were found
2183
+ * only by review, a one-time fallback LATCH in a ref and a scope owned by an
2184
+ * effect keyed on something else.
2090
2185
  *
2091
- * The one thing it does beyond looking: hand a reply to the merchant's own mail
2092
- * client. Nothing is ever sent from here.
2186
+ * Keying the implementation on the mode makes all of them correct by
2187
+ * construction, including the ones nobody has named, and deletes the reset
2188
+ * effects that were guessing at them. In-flight requests are cancelled by the
2189
+ * ordinary unmount cleanup.
2093
2190
  */
2094
- declare function LeadsView({ refreshKey, onBackToWebsite, className, }: LeadsViewProps): react_jsx_runtime.JSX.Element;
2191
+ declare function LeadsView(props: LeadsViewProps): react_jsx_runtime.JSX.Element;
2095
2192
 
2096
2193
  interface SubscriptionsViewProps {
2097
2194
  /**
@@ -2213,8 +2310,35 @@ interface InvoicesListProps {
2213
2310
  label: string;
2214
2311
  } | null;
2215
2312
  onClearRetainerFilter?: () => void;
2313
+ /**
2314
+ * COMPACT MODE: cap the rows and drop this list's chrome for a summary
2315
+ * surface. Same contract as `OrdersList` — the empty, loading and failure
2316
+ * states are reused rather than reimplemented alongside.
2317
+ */
2318
+ maxRows?: number;
2319
+ /** Where "view all" goes, and what a row click does in compact mode. */
2320
+ onViewAll?: () => void;
2216
2321
  }
2217
- declare function InvoicesList({ className, refreshKey, initialInvoiceId, onDetailOpenChange, onConnectStripe, onUpgradePlan, needsPaidPlan, retainerFilter, onClearRetainerFilter }: InvoicesListProps): react_jsx_runtime.JSX.Element;
2322
+ /**
2323
+ * A MODE CHANGE REMOUNTS, rather than being reconciled state by state.
2324
+ *
2325
+ * Compact and standalone are different views that happen to share an
2326
+ * implementation: different scope, different chrome, different navigation.
2327
+ * Reconciling them meant every piece of state the standalone view owns had to
2328
+ * answer to the mode — and that list is not enumerable from the outside. Two
2329
+ * of its members were found only by review: a one-time fallback LATCH held in
2330
+ * a ref, and a retainer scope owned by an effect keyed on something else
2331
+ * entirely. Neither could a mode-change effect have known about.
2332
+ *
2333
+ * Keying the implementation on the mode makes every one of them correct by
2334
+ * construction, including the ones nobody has named, and deletes the reset
2335
+ * effects that were trying to guess at them. In-flight requests are cancelled
2336
+ * by the ordinary unmount cleanup.
2337
+ *
2338
+ * No host switches today — all three remount already — so this costs nothing
2339
+ * live and makes the published contract honest.
2340
+ */
2341
+ declare function InvoicesList(props: InvoicesListProps): react_jsx_runtime.JSX.Element;
2218
2342
  interface InvoiceDetailProps {
2219
2343
  invoice: Invoice;
2220
2344
  onBack: () => void;
@@ -2846,4 +2970,69 @@ interface AnalyticsViewProps {
2846
2970
  */
2847
2971
  declare function AnalyticsView({ filters: filtersProp, onFiltersChange, refreshKey, onBackToWebsite, className, published, lastPublishedAt, }: AnalyticsViewProps): react_jsx_runtime.JSX.Element;
2848
2972
 
2849
- export { type AdjustInventoryInput, type AifeaturesApiClient, AifeaturesApiError, type AifeaturesContextValue, AifeaturesProvider, type AifeaturesProviderProps, type AnalyticsBreakdown, type AnalyticsBreakdownName, type AnalyticsBreakdownRow, type AnalyticsChannelRow, type AnalyticsChannels, type AnalyticsConversionRow, type AnalyticsConversions, type AnalyticsFilter, type AnalyticsFilterDimension, type AnalyticsPeriod, type AnalyticsRealtime, type AnalyticsSourced, type AnalyticsStatus, type AnalyticsSummary, type AnalyticsSummaryData, type AnalyticsSummaryMetrics, type AnalyticsTimeseries, type AnalyticsTimeseriesRow, AnalyticsView, type AnalyticsViewProps, type ApiError, type Attachment, type BusinessSummary, type BusinessVisitors, type CreateEventDestinationInput, type CreateFormInput, type CreateOptionInput, type CreateProductInput, type CreatePromoInput, type CreateVariantInput, type Customer, type CustomerAddress, CustomerDetail, type CustomerDetail$1 as CustomerDetailData, type CustomerDetailProps, CustomersList, type CustomersListProps, type CustomersListResponse, type EmailDelivery, type EmailSideStatus, type EventDeliveriesListResponse, type EventDelivery, type EventDestination, type EventDestinationSecretResponse, type EventDestinationsListResponse, type Form, FormSettings, type FormSettingsProps, FormSubmissions, type FormSubmissionsProps, FormsDashboard, type FormsDashboardProps, FormsList, type FormsListProps, type FormsListResponse, type GetBusinessSummaryOptions, type GetCustomersOptions, type GetInvoicesOptions, type GetOrdersOptions, type GetPeopleOptions, type GetProductsOptions, type GetSubmissionsOptions, type GetSubscriptionsOptions, type Invoice, type InvoiceAggregates, type InvoiceBillTo, type InvoiceDeliveryState, InvoiceDetail, type InvoiceDetailProps, type InvoiceLabel, InvoiceLabelBadge, type InvoiceLineItem, type InvoicePreview, type InvoiceSettings, InvoicesList, type InvoicesListProps, InvoicesView, type InvoicesViewProps, LeadsView, type LeadsViewProps, type LowStockProduct, MAX_ANALYTICS_FILTERS, MAX_ANALYTICS_FILTER_VALUES, type NeedsAttentionItem, type NeedsAttentionType, type Order, OrderDetail, type OrderDetailProps, type OrderStatus, OrderStatusBadge, OrdersList, type OrdersListProps, OrdersView, type OrdersViewProps, type PaginatedInvoices, type PaginatedOrders, type PaginatedSubmissions, type PaginatedSubscriptions, PaymentsDashboard, type PaymentsDashboardProps, PaymentsSetup, type PaymentsSetupProps, type PaymentsStatus, type PaymentsStatusReason, type PaymentsStatusResponse, type PeopleListResponse, type Person, type PersonDetail, type PersonOrder, type PersonSource, type PersonSubmission, type Product, type ProductDetail, type ProductFulfillment, type ProductFulfillmentType, type ProductOption, ProductSettings, type ProductSettingsProps, type ProductStats, type ProductVariant, ProductsList, type ProductsListProps, type ProductsListResponse, ProductsView, type ProductsViewProps, type Promo, type PromosListResponse, PromosPanel, REALTIME_FAILURES_BEFORE_ERROR, REALTIME_POLL_MS, type RefundRequest, type ReportSlot, RetainerStatusBadge, RetainersPanel, type RetainersPanelProps, type RevenueCurrencyTotal, type RevenuePeriod, type SetInventoryInput, type SetOrderFulfillmentInput, type SettledRevenue, type Submission, SubmissionDetail, type SubmissionDetailProps, type SubmissionMetadata, type Subscription, SubscriptionsView, type SubscriptionsViewProps, type UpdateEventDestinationInput, type UpdateFormInput, type UpdateOptionInput, type UpdateProductInput, type UpdateVariantInput, type UseAnalyticsOptions, type UseAnalyticsReturn, type UseBusinessSummaryOptions, type UseBusinessSummaryReturn, type UseCustomersOptions, type UseCustomersReturn, type UseEventDestinationsReturn, type UseFormsReturn, type UseInvoicesOptions, type UseInvoicesReturn, type UseOrdersOptions, type UseOrdersReturn, type UsePaymentsStatusReturn, type UsePeopleOptions, type UsePeopleReturn, type UsePersonOptions, type UsePersonReturn, type UseProductsOptions, type UseProductsReturn, type UseRealtimeVisitorsReturn, type UseSubmissionsOptions, type UseSubmissionsReturn, type UseSubscriptionsOptions, type UseSubscriptionsReturn, type VariantInventory, type VariantOptionValue, VariantsEditor, type VariantsEditorProps, ViewShell, type ViewShellProps, WebhookDeliveries, type WebhookDeliveriesProps, WebhookSettings, type WebhookSettingsProps, chargedTotal, createApiClient, formatPrice, isZeroDecimalCurrency, toMajorUnits, toMinorUnits, useAifeaturesContext as useAifeatures, useAifeaturesContext, useAnalytics, useBusinessSummary, useCustomers, useEventDestinations, useForms, useInvoices, useOrders, usePaymentsStatus, usePeople, usePerson, useProducts, useRealtimeVisitors, useRetainers, useSubmissions, useSubscriptions };
2973
+ /**
2974
+ * What this site is trying to get its visitors to do, said in one line.
2975
+ *
2976
+ * The site builder already decides this: picking a conversion mechanism is a
2977
+ * gated first step of every build — form, external link, phone-first, or
2978
+ * native payments — and the CTA it writes is the artifact of that decision.
2979
+ * This names it back to the owner.
2980
+ *
2981
+ * The vocabulary deliberately matches the conversion goals that already
2982
+ * report on these events, so the headline and the numbers under it describe
2983
+ * the same thing in the same words rather than two vocabularies for one site.
2984
+ *
2985
+ * `unknown` renders NOTHING. The derivation is lazy and improvable, so a site
2986
+ * it cannot settle yet is normal rather than broken — and naming the wrong
2987
+ * goal on a merchant's own dashboard is worse than naming none. An
2988
+ * undetermined goal costs this line, never the screen.
2989
+ */
2990
+ type SiteGoal = "calls" | "enquiries" | "sales" | "outbound" | "unknown";
2991
+
2992
+ interface DashboardViewProps {
2993
+ /** Bumped by the host after any turn that touched business data. */
2994
+ refreshKey?: number;
2995
+ /** Host owns the panel swap; this view only asks. */
2996
+ onBackToWebsite?: () => void;
2997
+ /**
2998
+ * Facts the package cannot know, supplied by the host — the same contract
2999
+ * the analytics view already uses.
3000
+ */
3001
+ /** What the site is for. `unknown` until the derivation ships; renders nothing. */
3002
+ goal?: SiteGoal;
3003
+ /**
3004
+ * Host callback to change the active surface. Without it the storefront
3005
+ * entries render nothing, because a panel that claims to lead somewhere and
3006
+ * cannot is worse than one that does not claim it.
3007
+ */
3008
+ onOpenSurface?: (surface: "analytics" | "leads" | "orders" | "invoices") => void;
3009
+ /**
3010
+ * INVOICE ELIGIBILITY, forwarded verbatim to the compact list.
3011
+ *
3012
+ * The host already computes these for the full view, and the list already
3013
+ * renders the three teaching empties that depend on them. Without them the
3014
+ * compact list defaults to `needsPaidPlan: false` and tells a free-plan
3015
+ * merchant to send an invoice from the chat — advice their plan cannot act
3016
+ * on, in the one place meant to tell them what to do next.
3017
+ */
3018
+ needsPaidPlan?: boolean;
3019
+ onUpgradePlan?: () => void;
3020
+ onConnectStripe?: () => void;
3021
+ }
3022
+ /**
3023
+ * The post-publish Dashboard: what the site is for, and how it is doing
3024
+ * against that.
3025
+ *
3026
+ * Two panels every published site gets. A site that actually sells also gets
3027
+ * orders and the way into products and invoices — not built yet, and the
3028
+ * absence is deliberate: a brochure site must not be shown an empty
3029
+ * storefront, and most published sites are brochure sites.
3030
+ *
3031
+ * The two data sources fail independently and say so. Visitors, orders and
3032
+ * products all come from one summary call, so they share a fate; leads has its
3033
+ * own call and fails alone. Nothing here claims per-panel isolation it does
3034
+ * not have.
3035
+ */
3036
+ declare function DashboardView({ refreshKey, onBackToWebsite, goal, onOpenSurface, needsPaidPlan, onUpgradePlan, onConnectStripe, }: DashboardViewProps): react_jsx_runtime.JSX.Element;
3037
+
3038
+ export { type AdjustInventoryInput, type AifeaturesApiClient, AifeaturesApiError, type AifeaturesContextValue, AifeaturesProvider, type AifeaturesProviderProps, type AnalyticsBreakdown, type AnalyticsBreakdownName, type AnalyticsBreakdownRow, type AnalyticsChannelRow, type AnalyticsChannels, type AnalyticsConversionRow, type AnalyticsConversions, type AnalyticsFilter, type AnalyticsFilterDimension, type AnalyticsPeriod, type AnalyticsRealtime, type AnalyticsSourced, type AnalyticsStatus, type AnalyticsSummary, type AnalyticsSummaryData, type AnalyticsSummaryMetrics, type AnalyticsTimeseries, type AnalyticsTimeseriesRow, AnalyticsView, type AnalyticsViewProps, type ApiError, type Attachment, type BusinessSummary, type BusinessVisitors, type CreateEventDestinationInput, type CreateFormInput, type CreateOptionInput, type CreateProductInput, type CreatePromoInput, type CreateVariantInput, type Customer, type CustomerAddress, CustomerDetail, type CustomerDetail$1 as CustomerDetailData, type CustomerDetailProps, CustomersList, type CustomersListProps, type CustomersListResponse, DashboardView, type DashboardViewProps, type EmailDelivery, type EmailSideStatus, type EventDeliveriesListResponse, type EventDelivery, type EventDestination, type EventDestinationSecretResponse, type EventDestinationsListResponse, type Form, FormSettings, type FormSettingsProps, FormSubmissions, type FormSubmissionsProps, FormsDashboard, type FormsDashboardProps, FormsList, type FormsListProps, type FormsListResponse, type GetBusinessSummaryOptions, type GetCustomersOptions, type GetInvoicesOptions, type GetOrdersOptions, type GetPeopleOptions, type GetProductsOptions, type GetSubmissionsOptions, type GetSubscriptionsOptions, type Invoice, type InvoiceAggregates, type InvoiceBillTo, type InvoiceDeliveryState, InvoiceDetail, type InvoiceDetailProps, type InvoiceLabel, InvoiceLabelBadge, type InvoiceLineItem, type InvoicePreview, type InvoiceSettings, InvoicesList, type InvoicesListProps, InvoicesView, type InvoicesViewProps, LeadsView, type LeadsViewProps, type LowStockProduct, MAX_ANALYTICS_FILTERS, MAX_ANALYTICS_FILTER_VALUES, type NeedsAttentionItem, type NeedsAttentionType, type Order, OrderDetail, type OrderDetailProps, type OrderStatus, OrderStatusBadge, OrdersList, type OrdersListProps, OrdersView, type OrdersViewProps, type PaginatedInvoices, type PaginatedOrders, type PaginatedSubmissions, type PaginatedSubscriptions, PaymentsDashboard, type PaymentsDashboardProps, PaymentsSetup, type PaymentsSetupProps, type PaymentsStatus, type PaymentsStatusReason, type PaymentsStatusResponse, type PeopleListResponse, type Person, type PersonDetail, type PersonOrder, type PersonSource, type PersonSubmission, type Product, type ProductDetail, type ProductFulfillment, type ProductFulfillmentType, type ProductOption, ProductSettings, type ProductSettingsProps, type ProductStats, type ProductVariant, ProductsList, type ProductsListProps, type ProductsListResponse, ProductsView, type ProductsViewProps, type Promo, type PromosListResponse, PromosPanel, REALTIME_FAILURES_BEFORE_ERROR, REALTIME_POLL_MS, type RefundRequest, type ReportSlot, RetainerStatusBadge, RetainersPanel, type RetainersPanelProps, type RevenueCurrencyTotal, type RevenuePeriod, type SetInventoryInput, type SetOrderFulfillmentInput, type SettledRevenue, type Submission, SubmissionDetail, type SubmissionDetailProps, type SubmissionMetadata, type Subscription, SubscriptionsView, type SubscriptionsViewProps, type UpdateEventDestinationInput, type UpdateFormInput, type UpdateOptionInput, type UpdateProductInput, type UpdateVariantInput, type UseAnalyticsOptions, type UseAnalyticsReturn, type UseBusinessSummaryOptions, type UseBusinessSummaryReturn, type UseCustomersOptions, type UseCustomersReturn, type UseEventDestinationsReturn, type UseFormsReturn, type UseInvoicesOptions, type UseInvoicesReturn, type UseOrdersOptions, type UseOrdersReturn, type UsePaymentsStatusReturn, type UsePeopleOptions, type UsePeopleReturn, type UsePersonOptions, type UsePersonReturn, type UseProductsOptions, type UseProductsReturn, type UseRealtimeVisitorsReturn, type UseSubmissionsOptions, type UseSubmissionsReturn, type UseSubscriptionsOptions, type UseSubscriptionsReturn, type VariantInventory, type VariantOptionValue, VariantsEditor, type VariantsEditorProps, ViewShell, type ViewShellProps, WebhookDeliveries, type WebhookDeliveriesProps, WebhookSettings, type WebhookSettingsProps, chargedTotal, createApiClient, formatPrice, isZeroDecimalCurrency, toMajorUnits, toMinorUnits, useAifeaturesContext as useAifeatures, useAifeaturesContext, useAnalytics, useBusinessSummary, useCustomers, useEventDestinations, useForms, useInvoices, useOrders, usePaymentsStatus, usePeople, usePerson, useProducts, useRealtimeVisitors, useRetainers, useSubmissions, useSubscriptions };
package/dist/index.d.ts CHANGED
@@ -129,11 +129,38 @@ interface ApiError {
129
129
  * request, which makes showing an outage and a Retry actively misleading —
130
130
  * the retry repeats the same 400 forever, and the thing to change is a goal.
131
131
  *
132
- * All four are EXPECTED consequences of the request, never outages, so a
132
+ * `goal_not_found` says the named goal does not exist on this site. Emitted
133
+ * by the goals CRUD and by the conversions drill-down, which resolves a goal
134
+ * by display name.
135
+ *
136
+ * `goal_has_no_targets` is the drill-down's own, and it is a fact about the
137
+ * GOAL rather than the request: the goal matches events that carry no link,
138
+ * so there are no values to break down. `Form: Submission` has thousands of
139
+ * conversions and no recorded targets, because nothing says WHICH form. A
140
+ * client must not render this as "no conversions" — the number above it says
141
+ * otherwise — and must not offer a Retry.
142
+ *
143
+ * `filters_unsupported` (plural) is NOT `filter_unsupported` above. The
144
+ * singular one says a filter cannot be answered for this site and period;
145
+ * this one says the report refuses filters outright, because answering an
146
+ * unfiltered report under a filtered request is indistinguishable from
147
+ * honouring it. Conversions and its drill-down both emit it.
148
+ *
149
+ * `invalid_limit` is an ordinary bad parameter, included because a consumer
150
+ * narrowing on this union otherwise cannot name it.
151
+ *
152
+ * All of these are EXPECTED consequences of the request, never outages, so a
133
153
  * client that cannot tell them apart from an unreachable source shows the
134
154
  * wrong recovery for every one of them.
155
+ *
156
+ * NOT EXHAUSTIVE, and worth knowing before you narrow on it: the API emits
157
+ * several more codes this union has never listed — `goal_invalid`,
158
+ * `goal_conflict`, `goal_name_taken`, `goal_limit_reached`,
159
+ * `funnel_not_found`, `funnel_step_missing` and
160
+ * `funnel_window_precedes_coverage` among them. They belong here, but adding
161
+ * them is a change to the goals and funnels surfaces rather than this one.
135
162
  */
136
- code?: 'filter_unsupported' | 'range_invalid' | 'dimension_unsupported' | 'goals_exceed_report_budget';
163
+ code?: 'filter_unsupported' | 'filters_unsupported' | 'range_invalid' | 'dimension_unsupported' | 'goals_exceed_report_budget' | 'goal_not_found' | 'goal_has_no_targets' | 'invalid_limit';
137
164
  }
138
165
  /**
139
166
  * A site's payment readiness (sites.paymentsStatus)
@@ -836,6 +863,25 @@ interface BusinessSummary {
836
863
  count: number;
837
864
  low_stock: LowStockProduct[];
838
865
  };
866
+ /**
867
+ * Durable commerce capabilities, unbounded in time. Neither is derivable
868
+ * from the fields above:
869
+ *
870
+ * invoicing an unpaid invoice is `pending`, outside the revenue
871
+ * family, and a service business has no catalogue — so
872
+ * nothing else here sees it.
873
+ * storefront_orders `revenue.*.orders` counts invoice-sourced rows too,
874
+ * while GET /orders excludes them by default, so a site
875
+ * whose only sale is a paid invoice reads as selling
876
+ * while the orders list it opens is empty.
877
+ *
878
+ * Optional: an older API omits it, and absent means "unknown", which callers
879
+ * must treat as no rather than yes.
880
+ */
881
+ commerce?: {
882
+ invoicing: boolean;
883
+ storefront_orders: boolean;
884
+ };
839
885
  visitors: BusinessVisitors | null;
840
886
  }
841
887
  /** Options for fetching the business summary. */
@@ -1845,8 +1891,44 @@ interface OrdersListProps {
1845
1891
  * two stacked back buttons taught nobody anything.
1846
1892
  */
1847
1893
  onDetailOpenChange?: (open: boolean) => void;
1894
+ /**
1895
+ * COMPACT MODE: cap the rows and drop this list's own chrome, so it can sit
1896
+ * inside a summary surface instead of owning a page.
1897
+ *
1898
+ * The point is that the EMPTY, LOADING and ERROR states come along
1899
+ * unchanged. A dashboard that hand-rolled its own "no orders yet" would be a
1900
+ * second copy of copy that already exists here, drifting from it — so the
1901
+ * summary borrows this list rather than imitating it.
1902
+ *
1903
+ * Suppressed while set: the saved-view tabs, search, filters, abandoned
1904
+ * toggle, CSV export and pagination. All of those are ways of ASKING a
1905
+ * question, and a summary is not where questions get asked.
1906
+ */
1907
+ maxRows?: number;
1908
+ /**
1909
+ * Where "view all" goes, and what a row click does in compact mode. Rows do
1910
+ * not open a detail inside a summary card: the card is a pointer at the
1911
+ * full surface, and swapping it for an order detail in place would strand
1912
+ * the reader somewhere they did not ask to be.
1913
+ */
1914
+ onViewAll?: () => void;
1848
1915
  }
1849
- declare function OrdersList({ onRefund, className, refreshKey, initialOrderId, showFulfillment, emptyMessage, onDetailOpenChange, }: OrdersListProps): react_jsx_runtime.JSX.Element;
1916
+ /**
1917
+ * A MODE CHANGE REMOUNTS, rather than being reconciled state by state.
1918
+ *
1919
+ * Compact and standalone are different views sharing an implementation:
1920
+ * different scope, different chrome, different navigation. Reconciling them
1921
+ * meant every piece of state the standalone view owns had to answer to the
1922
+ * mode, and that list is not enumerable from outside — two members were found
1923
+ * only by review, a one-time fallback LATCH in a ref and a scope owned by an
1924
+ * effect keyed on something else.
1925
+ *
1926
+ * Keying the implementation on the mode makes all of them correct by
1927
+ * construction, including the ones nobody has named, and deletes the reset
1928
+ * effects that were guessing at them. In-flight requests are cancelled by the
1929
+ * ordinary unmount cleanup.
1930
+ */
1931
+ declare function OrdersList(props: OrdersListProps): react_jsx_runtime.JSX.Element;
1850
1932
 
1851
1933
  interface PaymentsDashboardProps {
1852
1934
  /** Optional className */
@@ -2082,16 +2164,31 @@ interface LeadsViewProps {
2082
2164
  /** Host-app callback that swaps the panel back to the website preview (plan D13). */
2083
2165
  onBackToWebsite?: () => void;
2084
2166
  className?: string;
2167
+ /**
2168
+ * COMPACT MODE: cap the rows and render WITHOUT this view's shell, for a
2169
+ * summary surface. See the note in `OrdersList` — the point is that the
2170
+ * empty, loading and failure states are reused rather than reimplemented.
2171
+ */
2172
+ maxRows?: number;
2173
+ /** Where "view all" goes. */
2174
+ onViewAll?: () => void;
2085
2175
  }
2086
2176
  /**
2087
- * LeadsView — the merged people list (customers ∪ form leads) with in-view
2088
- * detail navigation (plan Unit 5). All lead-authored content renders as plain
2089
- * text and is labeled unverified (plan D7/D15). Ephemeral (plan D12).
2177
+ * A MODE CHANGE REMOUNTS, rather than being reconciled state by state.
2178
+ *
2179
+ * Compact and standalone are different views sharing an implementation:
2180
+ * different scope, different chrome, different navigation. Reconciling them
2181
+ * meant every piece of state the standalone view owns had to answer to the
2182
+ * mode, and that list is not enumerable from outside — two members were found
2183
+ * only by review, a one-time fallback LATCH in a ref and a scope owned by an
2184
+ * effect keyed on something else.
2090
2185
  *
2091
- * The one thing it does beyond looking: hand a reply to the merchant's own mail
2092
- * client. Nothing is ever sent from here.
2186
+ * Keying the implementation on the mode makes all of them correct by
2187
+ * construction, including the ones nobody has named, and deletes the reset
2188
+ * effects that were guessing at them. In-flight requests are cancelled by the
2189
+ * ordinary unmount cleanup.
2093
2190
  */
2094
- declare function LeadsView({ refreshKey, onBackToWebsite, className, }: LeadsViewProps): react_jsx_runtime.JSX.Element;
2191
+ declare function LeadsView(props: LeadsViewProps): react_jsx_runtime.JSX.Element;
2095
2192
 
2096
2193
  interface SubscriptionsViewProps {
2097
2194
  /**
@@ -2213,8 +2310,35 @@ interface InvoicesListProps {
2213
2310
  label: string;
2214
2311
  } | null;
2215
2312
  onClearRetainerFilter?: () => void;
2313
+ /**
2314
+ * COMPACT MODE: cap the rows and drop this list's chrome for a summary
2315
+ * surface. Same contract as `OrdersList` — the empty, loading and failure
2316
+ * states are reused rather than reimplemented alongside.
2317
+ */
2318
+ maxRows?: number;
2319
+ /** Where "view all" goes, and what a row click does in compact mode. */
2320
+ onViewAll?: () => void;
2216
2321
  }
2217
- declare function InvoicesList({ className, refreshKey, initialInvoiceId, onDetailOpenChange, onConnectStripe, onUpgradePlan, needsPaidPlan, retainerFilter, onClearRetainerFilter }: InvoicesListProps): react_jsx_runtime.JSX.Element;
2322
+ /**
2323
+ * A MODE CHANGE REMOUNTS, rather than being reconciled state by state.
2324
+ *
2325
+ * Compact and standalone are different views that happen to share an
2326
+ * implementation: different scope, different chrome, different navigation.
2327
+ * Reconciling them meant every piece of state the standalone view owns had to
2328
+ * answer to the mode — and that list is not enumerable from the outside. Two
2329
+ * of its members were found only by review: a one-time fallback LATCH held in
2330
+ * a ref, and a retainer scope owned by an effect keyed on something else
2331
+ * entirely. Neither could a mode-change effect have known about.
2332
+ *
2333
+ * Keying the implementation on the mode makes every one of them correct by
2334
+ * construction, including the ones nobody has named, and deletes the reset
2335
+ * effects that were trying to guess at them. In-flight requests are cancelled
2336
+ * by the ordinary unmount cleanup.
2337
+ *
2338
+ * No host switches today — all three remount already — so this costs nothing
2339
+ * live and makes the published contract honest.
2340
+ */
2341
+ declare function InvoicesList(props: InvoicesListProps): react_jsx_runtime.JSX.Element;
2218
2342
  interface InvoiceDetailProps {
2219
2343
  invoice: Invoice;
2220
2344
  onBack: () => void;
@@ -2846,4 +2970,69 @@ interface AnalyticsViewProps {
2846
2970
  */
2847
2971
  declare function AnalyticsView({ filters: filtersProp, onFiltersChange, refreshKey, onBackToWebsite, className, published, lastPublishedAt, }: AnalyticsViewProps): react_jsx_runtime.JSX.Element;
2848
2972
 
2849
- export { type AdjustInventoryInput, type AifeaturesApiClient, AifeaturesApiError, type AifeaturesContextValue, AifeaturesProvider, type AifeaturesProviderProps, type AnalyticsBreakdown, type AnalyticsBreakdownName, type AnalyticsBreakdownRow, type AnalyticsChannelRow, type AnalyticsChannels, type AnalyticsConversionRow, type AnalyticsConversions, type AnalyticsFilter, type AnalyticsFilterDimension, type AnalyticsPeriod, type AnalyticsRealtime, type AnalyticsSourced, type AnalyticsStatus, type AnalyticsSummary, type AnalyticsSummaryData, type AnalyticsSummaryMetrics, type AnalyticsTimeseries, type AnalyticsTimeseriesRow, AnalyticsView, type AnalyticsViewProps, type ApiError, type Attachment, type BusinessSummary, type BusinessVisitors, type CreateEventDestinationInput, type CreateFormInput, type CreateOptionInput, type CreateProductInput, type CreatePromoInput, type CreateVariantInput, type Customer, type CustomerAddress, CustomerDetail, type CustomerDetail$1 as CustomerDetailData, type CustomerDetailProps, CustomersList, type CustomersListProps, type CustomersListResponse, type EmailDelivery, type EmailSideStatus, type EventDeliveriesListResponse, type EventDelivery, type EventDestination, type EventDestinationSecretResponse, type EventDestinationsListResponse, type Form, FormSettings, type FormSettingsProps, FormSubmissions, type FormSubmissionsProps, FormsDashboard, type FormsDashboardProps, FormsList, type FormsListProps, type FormsListResponse, type GetBusinessSummaryOptions, type GetCustomersOptions, type GetInvoicesOptions, type GetOrdersOptions, type GetPeopleOptions, type GetProductsOptions, type GetSubmissionsOptions, type GetSubscriptionsOptions, type Invoice, type InvoiceAggregates, type InvoiceBillTo, type InvoiceDeliveryState, InvoiceDetail, type InvoiceDetailProps, type InvoiceLabel, InvoiceLabelBadge, type InvoiceLineItem, type InvoicePreview, type InvoiceSettings, InvoicesList, type InvoicesListProps, InvoicesView, type InvoicesViewProps, LeadsView, type LeadsViewProps, type LowStockProduct, MAX_ANALYTICS_FILTERS, MAX_ANALYTICS_FILTER_VALUES, type NeedsAttentionItem, type NeedsAttentionType, type Order, OrderDetail, type OrderDetailProps, type OrderStatus, OrderStatusBadge, OrdersList, type OrdersListProps, OrdersView, type OrdersViewProps, type PaginatedInvoices, type PaginatedOrders, type PaginatedSubmissions, type PaginatedSubscriptions, PaymentsDashboard, type PaymentsDashboardProps, PaymentsSetup, type PaymentsSetupProps, type PaymentsStatus, type PaymentsStatusReason, type PaymentsStatusResponse, type PeopleListResponse, type Person, type PersonDetail, type PersonOrder, type PersonSource, type PersonSubmission, type Product, type ProductDetail, type ProductFulfillment, type ProductFulfillmentType, type ProductOption, ProductSettings, type ProductSettingsProps, type ProductStats, type ProductVariant, ProductsList, type ProductsListProps, type ProductsListResponse, ProductsView, type ProductsViewProps, type Promo, type PromosListResponse, PromosPanel, REALTIME_FAILURES_BEFORE_ERROR, REALTIME_POLL_MS, type RefundRequest, type ReportSlot, RetainerStatusBadge, RetainersPanel, type RetainersPanelProps, type RevenueCurrencyTotal, type RevenuePeriod, type SetInventoryInput, type SetOrderFulfillmentInput, type SettledRevenue, type Submission, SubmissionDetail, type SubmissionDetailProps, type SubmissionMetadata, type Subscription, SubscriptionsView, type SubscriptionsViewProps, type UpdateEventDestinationInput, type UpdateFormInput, type UpdateOptionInput, type UpdateProductInput, type UpdateVariantInput, type UseAnalyticsOptions, type UseAnalyticsReturn, type UseBusinessSummaryOptions, type UseBusinessSummaryReturn, type UseCustomersOptions, type UseCustomersReturn, type UseEventDestinationsReturn, type UseFormsReturn, type UseInvoicesOptions, type UseInvoicesReturn, type UseOrdersOptions, type UseOrdersReturn, type UsePaymentsStatusReturn, type UsePeopleOptions, type UsePeopleReturn, type UsePersonOptions, type UsePersonReturn, type UseProductsOptions, type UseProductsReturn, type UseRealtimeVisitorsReturn, type UseSubmissionsOptions, type UseSubmissionsReturn, type UseSubscriptionsOptions, type UseSubscriptionsReturn, type VariantInventory, type VariantOptionValue, VariantsEditor, type VariantsEditorProps, ViewShell, type ViewShellProps, WebhookDeliveries, type WebhookDeliveriesProps, WebhookSettings, type WebhookSettingsProps, chargedTotal, createApiClient, formatPrice, isZeroDecimalCurrency, toMajorUnits, toMinorUnits, useAifeaturesContext as useAifeatures, useAifeaturesContext, useAnalytics, useBusinessSummary, useCustomers, useEventDestinations, useForms, useInvoices, useOrders, usePaymentsStatus, usePeople, usePerson, useProducts, useRealtimeVisitors, useRetainers, useSubmissions, useSubscriptions };
2973
+ /**
2974
+ * What this site is trying to get its visitors to do, said in one line.
2975
+ *
2976
+ * The site builder already decides this: picking a conversion mechanism is a
2977
+ * gated first step of every build — form, external link, phone-first, or
2978
+ * native payments — and the CTA it writes is the artifact of that decision.
2979
+ * This names it back to the owner.
2980
+ *
2981
+ * The vocabulary deliberately matches the conversion goals that already
2982
+ * report on these events, so the headline and the numbers under it describe
2983
+ * the same thing in the same words rather than two vocabularies for one site.
2984
+ *
2985
+ * `unknown` renders NOTHING. The derivation is lazy and improvable, so a site
2986
+ * it cannot settle yet is normal rather than broken — and naming the wrong
2987
+ * goal on a merchant's own dashboard is worse than naming none. An
2988
+ * undetermined goal costs this line, never the screen.
2989
+ */
2990
+ type SiteGoal = "calls" | "enquiries" | "sales" | "outbound" | "unknown";
2991
+
2992
+ interface DashboardViewProps {
2993
+ /** Bumped by the host after any turn that touched business data. */
2994
+ refreshKey?: number;
2995
+ /** Host owns the panel swap; this view only asks. */
2996
+ onBackToWebsite?: () => void;
2997
+ /**
2998
+ * Facts the package cannot know, supplied by the host — the same contract
2999
+ * the analytics view already uses.
3000
+ */
3001
+ /** What the site is for. `unknown` until the derivation ships; renders nothing. */
3002
+ goal?: SiteGoal;
3003
+ /**
3004
+ * Host callback to change the active surface. Without it the storefront
3005
+ * entries render nothing, because a panel that claims to lead somewhere and
3006
+ * cannot is worse than one that does not claim it.
3007
+ */
3008
+ onOpenSurface?: (surface: "analytics" | "leads" | "orders" | "invoices") => void;
3009
+ /**
3010
+ * INVOICE ELIGIBILITY, forwarded verbatim to the compact list.
3011
+ *
3012
+ * The host already computes these for the full view, and the list already
3013
+ * renders the three teaching empties that depend on them. Without them the
3014
+ * compact list defaults to `needsPaidPlan: false` and tells a free-plan
3015
+ * merchant to send an invoice from the chat — advice their plan cannot act
3016
+ * on, in the one place meant to tell them what to do next.
3017
+ */
3018
+ needsPaidPlan?: boolean;
3019
+ onUpgradePlan?: () => void;
3020
+ onConnectStripe?: () => void;
3021
+ }
3022
+ /**
3023
+ * The post-publish Dashboard: what the site is for, and how it is doing
3024
+ * against that.
3025
+ *
3026
+ * Two panels every published site gets. A site that actually sells also gets
3027
+ * orders and the way into products and invoices — not built yet, and the
3028
+ * absence is deliberate: a brochure site must not be shown an empty
3029
+ * storefront, and most published sites are brochure sites.
3030
+ *
3031
+ * The two data sources fail independently and say so. Visitors, orders and
3032
+ * products all come from one summary call, so they share a fate; leads has its
3033
+ * own call and fails alone. Nothing here claims per-panel isolation it does
3034
+ * not have.
3035
+ */
3036
+ declare function DashboardView({ refreshKey, onBackToWebsite, goal, onOpenSurface, needsPaidPlan, onUpgradePlan, onConnectStripe, }: DashboardViewProps): react_jsx_runtime.JSX.Element;
3037
+
3038
+ export { type AdjustInventoryInput, type AifeaturesApiClient, AifeaturesApiError, type AifeaturesContextValue, AifeaturesProvider, type AifeaturesProviderProps, type AnalyticsBreakdown, type AnalyticsBreakdownName, type AnalyticsBreakdownRow, type AnalyticsChannelRow, type AnalyticsChannels, type AnalyticsConversionRow, type AnalyticsConversions, type AnalyticsFilter, type AnalyticsFilterDimension, type AnalyticsPeriod, type AnalyticsRealtime, type AnalyticsSourced, type AnalyticsStatus, type AnalyticsSummary, type AnalyticsSummaryData, type AnalyticsSummaryMetrics, type AnalyticsTimeseries, type AnalyticsTimeseriesRow, AnalyticsView, type AnalyticsViewProps, type ApiError, type Attachment, type BusinessSummary, type BusinessVisitors, type CreateEventDestinationInput, type CreateFormInput, type CreateOptionInput, type CreateProductInput, type CreatePromoInput, type CreateVariantInput, type Customer, type CustomerAddress, CustomerDetail, type CustomerDetail$1 as CustomerDetailData, type CustomerDetailProps, CustomersList, type CustomersListProps, type CustomersListResponse, DashboardView, type DashboardViewProps, type EmailDelivery, type EmailSideStatus, type EventDeliveriesListResponse, type EventDelivery, type EventDestination, type EventDestinationSecretResponse, type EventDestinationsListResponse, type Form, FormSettings, type FormSettingsProps, FormSubmissions, type FormSubmissionsProps, FormsDashboard, type FormsDashboardProps, FormsList, type FormsListProps, type FormsListResponse, type GetBusinessSummaryOptions, type GetCustomersOptions, type GetInvoicesOptions, type GetOrdersOptions, type GetPeopleOptions, type GetProductsOptions, type GetSubmissionsOptions, type GetSubscriptionsOptions, type Invoice, type InvoiceAggregates, type InvoiceBillTo, type InvoiceDeliveryState, InvoiceDetail, type InvoiceDetailProps, type InvoiceLabel, InvoiceLabelBadge, type InvoiceLineItem, type InvoicePreview, type InvoiceSettings, InvoicesList, type InvoicesListProps, InvoicesView, type InvoicesViewProps, LeadsView, type LeadsViewProps, type LowStockProduct, MAX_ANALYTICS_FILTERS, MAX_ANALYTICS_FILTER_VALUES, type NeedsAttentionItem, type NeedsAttentionType, type Order, OrderDetail, type OrderDetailProps, type OrderStatus, OrderStatusBadge, OrdersList, type OrdersListProps, OrdersView, type OrdersViewProps, type PaginatedInvoices, type PaginatedOrders, type PaginatedSubmissions, type PaginatedSubscriptions, PaymentsDashboard, type PaymentsDashboardProps, PaymentsSetup, type PaymentsSetupProps, type PaymentsStatus, type PaymentsStatusReason, type PaymentsStatusResponse, type PeopleListResponse, type Person, type PersonDetail, type PersonOrder, type PersonSource, type PersonSubmission, type Product, type ProductDetail, type ProductFulfillment, type ProductFulfillmentType, type ProductOption, ProductSettings, type ProductSettingsProps, type ProductStats, type ProductVariant, ProductsList, type ProductsListProps, type ProductsListResponse, ProductsView, type ProductsViewProps, type Promo, type PromosListResponse, PromosPanel, REALTIME_FAILURES_BEFORE_ERROR, REALTIME_POLL_MS, type RefundRequest, type ReportSlot, RetainerStatusBadge, RetainersPanel, type RetainersPanelProps, type RevenueCurrencyTotal, type RevenuePeriod, type SetInventoryInput, type SetOrderFulfillmentInput, type SettledRevenue, type Submission, SubmissionDetail, type SubmissionDetailProps, type SubmissionMetadata, type Subscription, SubscriptionsView, type SubscriptionsViewProps, type UpdateEventDestinationInput, type UpdateFormInput, type UpdateOptionInput, type UpdateProductInput, type UpdateVariantInput, type UseAnalyticsOptions, type UseAnalyticsReturn, type UseBusinessSummaryOptions, type UseBusinessSummaryReturn, type UseCustomersOptions, type UseCustomersReturn, type UseEventDestinationsReturn, type UseFormsReturn, type UseInvoicesOptions, type UseInvoicesReturn, type UseOrdersOptions, type UseOrdersReturn, type UsePaymentsStatusReturn, type UsePeopleOptions, type UsePeopleReturn, type UsePersonOptions, type UsePersonReturn, type UseProductsOptions, type UseProductsReturn, type UseRealtimeVisitorsReturn, type UseSubmissionsOptions, type UseSubmissionsReturn, type UseSubscriptionsOptions, type UseSubscriptionsReturn, type VariantInventory, type VariantOptionValue, VariantsEditor, type VariantsEditorProps, ViewShell, type ViewShellProps, WebhookDeliveries, type WebhookDeliveriesProps, WebhookSettings, type WebhookSettingsProps, chargedTotal, createApiClient, formatPrice, isZeroDecimalCurrency, toMajorUnits, toMinorUnits, useAifeaturesContext as useAifeatures, useAifeaturesContext, useAnalytics, useBusinessSummary, useCustomers, useEventDestinations, useForms, useInvoices, useOrders, usePaymentsStatus, usePeople, usePerson, useProducts, useRealtimeVisitors, useRetainers, useSubmissions, useSubscriptions };