@aifeatures/admin-react 0.15.0 → 0.17.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
@@ -842,6 +842,16 @@ interface BusinessVisitors {
842
842
  from: string;
843
843
  to: string;
844
844
  };
845
+ /**
846
+ * The zone those local days were bucketed in.
847
+ *
848
+ * On the payload for the same reason every analytics report carries it: this
849
+ * client asks for a zone per request, and the server may not use the one it
850
+ * asked for — it falls back to the site's stored zone for a value it cannot
851
+ * read. The `date`s above are local days, so nothing can label them without
852
+ * this.
853
+ */
854
+ timezone: string;
845
855
  }
846
856
  /**
847
857
  * Response from GET /api/v1/summary — the merchant's one-look business
@@ -1355,6 +1365,17 @@ type AnalyticsSourced<T> = {
1355
1365
  from: string;
1356
1366
  to: string;
1357
1367
  };
1368
+ /**
1369
+ * The IANA zone this report's local days were bucketed in.
1370
+ *
1371
+ * ON THE ENVELOPE, so every report has it and none has to be paired with
1372
+ * /status — they are separate requests that fail separately, and pairing
1373
+ * them lets a status failure silently relabel a loaded report. It is also
1374
+ * not guaranteed to be the zone that was ASKED for: the server falls back
1375
+ * to the site's stored zone for an unusable value. This field, never the
1376
+ * request, is what the numbers are in.
1377
+ */
1378
+ timezone: string;
1358
1379
  } | {
1359
1380
  status: 'unreachable';
1360
1381
  };
@@ -1463,14 +1484,7 @@ interface AnalyticsChannelRow {
1463
1484
  */
1464
1485
  type AnalyticsBreakdownRow = Record<string, string | number | null | string[]>;
1465
1486
  type AnalyticsSummary = AnalyticsSourced<AnalyticsSummaryData>;
1466
- type AnalyticsTimeseries = AnalyticsSourced<AnalyticsTimeseriesRow[]> & {
1467
- /**
1468
- * The zone the dates are bucketed in, present on the OK branch. Read it from
1469
- * here rather than from /status: the two are separate requests, and pairing
1470
- * them means a status failure silently reburies the chart in UTC.
1471
- */
1472
- timezone?: string;
1473
- };
1487
+ type AnalyticsTimeseries = AnalyticsSourced<AnalyticsTimeseriesRow[]>;
1474
1488
  /**
1475
1489
  * One goal's conversions for the window.
1476
1490
  *
@@ -1522,6 +1536,7 @@ type AnalyticsConversions = {
1522
1536
  from: string;
1523
1537
  to: string;
1524
1538
  };
1539
+ timezone: string;
1525
1540
  denominator: number;
1526
1541
  first_seen: string | null;
1527
1542
  first_seen_unavailable: boolean;
@@ -2085,9 +2100,16 @@ interface ViewShellProps {
2085
2100
  }
2086
2101
  /**
2087
2102
  * The view strip + content wrapper every merchant view mounts inside
2088
- * (plan D13). The strip is the sole view indicator: title on the left,
2089
- * "Back to website" on the right, pinned to the top on small screens (D9) so
2090
- * the way out is always reachable.
2103
+ * (plan D13). The strip is the sole view indicator, pinned to the top on
2104
+ * small screens (D9) so the way out is always reachable.
2105
+ *
2106
+ * THE WAY OUT SITS LEFT OF THE TITLE — the back arrow points left, so it
2107
+ * belongs left of the thing it goes back from, and it reads as one phrase
2108
+ * with the view it is leaving. It was on the far right, which put the two
2109
+ * halves of the same sentence at opposite ends of the strip and left the
2110
+ * button's distance from the title depending on how wide the panel happened
2111
+ * to be. It is placed there with flex `order`, for the keyboard reason
2112
+ * written at the button itself.
2091
2113
  *
2092
2114
  * Accessibility: the panel's content is replaced out from under screen-reader
2093
2115
  * users when a view opens, so the heading is an `aria-live="polite"` region
@@ -2772,6 +2794,21 @@ interface UseAnalyticsReturn {
2772
2794
  */
2773
2795
  conversions: ReportSlot<AnalyticsConversions>;
2774
2796
  breakdowns: Record<string, ReportSlot<AnalyticsBreakdown>>;
2797
+ /**
2798
+ * The zone the server actually answered in, from whichever report has
2799
+ * loaded, or undefined before any has.
2800
+ *
2801
+ * COMPUTED HERE because this is where every response lands. A consumer that
2802
+ * picked its own subset of the slots would be wrong the moment a report was
2803
+ * added — which is exactly what happened: a list naming three of the five
2804
+ * ignored Channels and the breakdowns, so with only one of those loaded the
2805
+ * picker named a zone nothing on screen was counted in.
2806
+ *
2807
+ * It is not guaranteed to be the zone that was ASKED for: the server falls
2808
+ * back to the site's stored zone, and then UTC, for a value it cannot use.
2809
+ * Only the response says which.
2810
+ */
2811
+ reportedZone: string | undefined;
2775
2812
  /** True until every report has settled, for the initial skeleton only. */
2776
2813
  isLoading: boolean;
2777
2814
  refetch: () => Promise<void>;
@@ -2924,6 +2961,94 @@ declare function toMinorUnits(major: string | number, currency: string): number
2924
2961
  */
2925
2962
  declare function toMajorUnits(minor: number, currency: string): number;
2926
2963
 
2964
+ /**
2965
+ * THE CONVERSION THIS SITE IS JUDGED ON, said in one line.
2966
+ *
2967
+ * A MARKER, not a classification. Every site reports on the same tracked
2968
+ * conversions; this says which one of them is the business's own measure of a
2969
+ * good day, so the Dashboard can lead with it and the conversions table can
2970
+ * lift it out of the list.
2971
+ *
2972
+ * ITS GRAIN IS A GOAL PLUS AN OPTIONAL TARGET, which is the whole reason this
2973
+ * replaced an earlier five-value `SiteGoal` enum. "A form submission" is not
2974
+ * specific enough to be a business's goal once a site has more than one form:
2975
+ * on landingsite.ai the conversion that matters is the form that CREATES A
2976
+ * SITE, and `Form: Submission` aggregates every form on the page. For another
2977
+ * site the same goal means a newsletter sign-up, and for a third the answer is
2978
+ * an order instead. Five archetypes cannot express any of that.
2979
+ *
2980
+ * `target` ABSENT IS A REAL STATE, not a missing one — "this goal, any target".
2981
+ * It has to be, because a specific target is not always knowable: measured
2982
+ * 2026-10-11, 97.3% of sites have no form target recorded at all, since the
2983
+ * instrumentation is newer than the trackers most sites have cached. So a site
2984
+ * is markable from its first day at goal level, and narrowing to one target is
2985
+ * a refinement for the sites that can.
2986
+ *
2987
+ * WHY `label` IS THE HOST'S TO SUPPLY, AND OPTIONAL. The conversions targets
2988
+ * report already resolves a target to a human name where one exists — a form's
2989
+ * current name, else the raw endpoint. Only the host knows which of those it
2990
+ * got, and the difference decides the copy: "Your main conversion is Create a
2991
+ * site" reads as intended, while "Your main conversion is
2992
+ * api.example.com/f/3b2a" is worse than saying nothing specific. So the host
2993
+ * passes `label` ONLY when it holds a name a person wrote, and this component
2994
+ * never has to guess whether a string is a name or a URL.
2995
+ */
2996
+ interface PrimaryConversion {
2997
+ /**
2998
+ * The tracked goal's name, spelled as the conversions report spells it —
2999
+ * `Form: Submission`, `Contact`, `Outbound Link: Click`, `File Download`,
3000
+ * `Purchase`, `Form: Received`, or a goal the merchant created.
3001
+ *
3002
+ * Deliberately an open string rather than a union. The merchant can create
3003
+ * goals, so a closed set here would be wrong the moment one does.
3004
+ *
3005
+ * THE NAME IS THE REPORT'S OWN KEY, not a label beside an id: "matching is
3006
+ * query-time and the display name is the key reports are keyed by", and a
3007
+ * conversions row carries no id at all. So matching on it is not a shortcut
3008
+ * — it is the only join the report offers.
3009
+ *
3010
+ * WHICH MAKES A BUILT-IN SAFE AND A CUSTOM GOAL NOT, and a host persisting
3011
+ * this needs to know the difference. The six built-ins "are not rows and
3012
+ * cannot be renamed or deleted", so their names are permanent. A goal the
3013
+ * merchant created can be renamed through `PATCH /analytics/goals/{id}`,
3014
+ * which keeps its id and relabels every historical report — so a stored
3015
+ * marker naming the old one stops matching any row, and because goal names
3016
+ * are unique per site rather than reserved, a NEW goal can later take the
3017
+ * freed name and inherit the mark silently.
3018
+ *
3019
+ * Until the conversions report exposes a goal id, a host should therefore
3020
+ * either mark only built-ins, or re-validate a custom marker against the
3021
+ * current conversions and drop it when it no longer matches. Dropping is
3022
+ * safe here: an unset marker renders nothing by design.
3023
+ */
3024
+ goal: string;
3025
+ /**
3026
+ * Whether this is one of the six BUILT-IN goals, as the conversions row
3027
+ * reports it.
3028
+ *
3029
+ * It decides whether curated copy may be used at all, and it has to, because
3030
+ * a name is not proof of a built-in. The goals API shipped hours before
3031
+ * these names were reserved, so a merchant could already have created a
3032
+ * PAGEVIEW goal called `Purchase` — and when that happens the API keeps
3033
+ * theirs and drops the derived one, reporting `implicit: false`. Trusting
3034
+ * the name alone would tell that merchant "This site is set up to sell"
3035
+ * about a goal that counts visits to `/thanks`.
3036
+ *
3037
+ * Absent means "not established", and curated copy is withheld rather than
3038
+ * guessed: a host that forgets this gets the generic line, which is less
3039
+ * specific but never wrong. The opposite default would be wrong exactly
3040
+ * where it is hardest to notice.
3041
+ */
3042
+ implicit?: boolean;
3043
+ /** One target under that goal, or null/undefined for "any target". */
3044
+ target?: string | null;
3045
+ /**
3046
+ * A human name for what is marked, when the host has one. Omit it rather
3047
+ * than passing an endpoint or a URL — see the note above.
3048
+ */
3049
+ label?: string;
3050
+ }
3051
+
2927
3052
  interface AnalyticsViewProps {
2928
3053
  /**
2929
3054
  * Filters, when the HOST wants to own them — to put them in its URL, say.
@@ -2939,6 +3064,16 @@ interface AnalyticsViewProps {
2939
3064
  /** Bump to force a refetch, matching the other views. */
2940
3065
  refreshKey?: number;
2941
3066
  onBackToWebsite?: () => void;
3067
+ /**
3068
+ * The conversion this business is judged on, so its row in the conversions
3069
+ * table reads as the one that matters.
3070
+ *
3071
+ * THE SAME SHAPE THE DASHBOARD TAKES, so a host passes one object for one
3072
+ * fact rather than two differently-shaped things. This view uses only
3073
+ * `goal`: it has no headline to name a target in, and the table has one row
3074
+ * per goal.
3075
+ */
3076
+ primaryConversion?: PrimaryConversion | null;
2942
3077
  className?: string;
2943
3078
  /**
2944
3079
  * Publish state, supplied by the host: aifeatures has none of its own.
@@ -2968,26 +3103,7 @@ interface AnalyticsViewProps {
2968
3103
  * `published === false` overrides a collecting status: an unpublished site
2969
3104
  * with nothing ever seen is the first row above, not the third.
2970
3105
  */
2971
- declare function AnalyticsView({ filters: filtersProp, onFiltersChange, refreshKey, onBackToWebsite, className, published, lastPublishedAt, }: AnalyticsViewProps): react_jsx_runtime.JSX.Element;
2972
-
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";
3106
+ declare function AnalyticsView({ filters: filtersProp, onFiltersChange, refreshKey, onBackToWebsite, primaryConversion, className, published, lastPublishedAt, }: AnalyticsViewProps): react_jsx_runtime.JSX.Element;
2991
3107
 
2992
3108
  interface DashboardViewProps {
2993
3109
  /** Bumped by the host after any turn that touched business data. */
@@ -2998,8 +3114,12 @@ interface DashboardViewProps {
2998
3114
  * Facts the package cannot know, supplied by the host — the same contract
2999
3115
  * the analytics view already uses.
3000
3116
  */
3001
- /** What the site is for. `unknown` until the derivation ships; renders nothing. */
3002
- goal?: SiteGoal;
3117
+ /**
3118
+ * Which tracked conversion this business is judged on — a goal, optionally
3119
+ * narrowed to one target. Absent renders nothing, which is the state of a
3120
+ * site nobody has marked yet.
3121
+ */
3122
+ primaryConversion?: PrimaryConversion | null;
3003
3123
  /**
3004
3124
  * Host callback to change the active surface. Without it the storefront
3005
3125
  * entries render nothing, because a panel that claims to lead somewhere and
@@ -3033,6 +3153,6 @@ interface DashboardViewProps {
3033
3153
  * own call and fails alone. Nothing here claims per-panel isolation it does
3034
3154
  * not have.
3035
3155
  */
3036
- declare function DashboardView({ refreshKey, onBackToWebsite, goal, onOpenSurface, needsPaidPlan, onUpgradePlan, onConnectStripe, }: DashboardViewProps): react_jsx_runtime.JSX.Element;
3156
+ declare function DashboardView({ refreshKey, onBackToWebsite, primaryConversion, onOpenSurface, needsPaidPlan, onUpgradePlan, onConnectStripe, }: DashboardViewProps): react_jsx_runtime.JSX.Element;
3037
3157
 
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 };
3158
+ 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 PrimaryConversion, 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
@@ -842,6 +842,16 @@ interface BusinessVisitors {
842
842
  from: string;
843
843
  to: string;
844
844
  };
845
+ /**
846
+ * The zone those local days were bucketed in.
847
+ *
848
+ * On the payload for the same reason every analytics report carries it: this
849
+ * client asks for a zone per request, and the server may not use the one it
850
+ * asked for — it falls back to the site's stored zone for a value it cannot
851
+ * read. The `date`s above are local days, so nothing can label them without
852
+ * this.
853
+ */
854
+ timezone: string;
845
855
  }
846
856
  /**
847
857
  * Response from GET /api/v1/summary — the merchant's one-look business
@@ -1355,6 +1365,17 @@ type AnalyticsSourced<T> = {
1355
1365
  from: string;
1356
1366
  to: string;
1357
1367
  };
1368
+ /**
1369
+ * The IANA zone this report's local days were bucketed in.
1370
+ *
1371
+ * ON THE ENVELOPE, so every report has it and none has to be paired with
1372
+ * /status — they are separate requests that fail separately, and pairing
1373
+ * them lets a status failure silently relabel a loaded report. It is also
1374
+ * not guaranteed to be the zone that was ASKED for: the server falls back
1375
+ * to the site's stored zone for an unusable value. This field, never the
1376
+ * request, is what the numbers are in.
1377
+ */
1378
+ timezone: string;
1358
1379
  } | {
1359
1380
  status: 'unreachable';
1360
1381
  };
@@ -1463,14 +1484,7 @@ interface AnalyticsChannelRow {
1463
1484
  */
1464
1485
  type AnalyticsBreakdownRow = Record<string, string | number | null | string[]>;
1465
1486
  type AnalyticsSummary = AnalyticsSourced<AnalyticsSummaryData>;
1466
- type AnalyticsTimeseries = AnalyticsSourced<AnalyticsTimeseriesRow[]> & {
1467
- /**
1468
- * The zone the dates are bucketed in, present on the OK branch. Read it from
1469
- * here rather than from /status: the two are separate requests, and pairing
1470
- * them means a status failure silently reburies the chart in UTC.
1471
- */
1472
- timezone?: string;
1473
- };
1487
+ type AnalyticsTimeseries = AnalyticsSourced<AnalyticsTimeseriesRow[]>;
1474
1488
  /**
1475
1489
  * One goal's conversions for the window.
1476
1490
  *
@@ -1522,6 +1536,7 @@ type AnalyticsConversions = {
1522
1536
  from: string;
1523
1537
  to: string;
1524
1538
  };
1539
+ timezone: string;
1525
1540
  denominator: number;
1526
1541
  first_seen: string | null;
1527
1542
  first_seen_unavailable: boolean;
@@ -2085,9 +2100,16 @@ interface ViewShellProps {
2085
2100
  }
2086
2101
  /**
2087
2102
  * The view strip + content wrapper every merchant view mounts inside
2088
- * (plan D13). The strip is the sole view indicator: title on the left,
2089
- * "Back to website" on the right, pinned to the top on small screens (D9) so
2090
- * the way out is always reachable.
2103
+ * (plan D13). The strip is the sole view indicator, pinned to the top on
2104
+ * small screens (D9) so the way out is always reachable.
2105
+ *
2106
+ * THE WAY OUT SITS LEFT OF THE TITLE — the back arrow points left, so it
2107
+ * belongs left of the thing it goes back from, and it reads as one phrase
2108
+ * with the view it is leaving. It was on the far right, which put the two
2109
+ * halves of the same sentence at opposite ends of the strip and left the
2110
+ * button's distance from the title depending on how wide the panel happened
2111
+ * to be. It is placed there with flex `order`, for the keyboard reason
2112
+ * written at the button itself.
2091
2113
  *
2092
2114
  * Accessibility: the panel's content is replaced out from under screen-reader
2093
2115
  * users when a view opens, so the heading is an `aria-live="polite"` region
@@ -2772,6 +2794,21 @@ interface UseAnalyticsReturn {
2772
2794
  */
2773
2795
  conversions: ReportSlot<AnalyticsConversions>;
2774
2796
  breakdowns: Record<string, ReportSlot<AnalyticsBreakdown>>;
2797
+ /**
2798
+ * The zone the server actually answered in, from whichever report has
2799
+ * loaded, or undefined before any has.
2800
+ *
2801
+ * COMPUTED HERE because this is where every response lands. A consumer that
2802
+ * picked its own subset of the slots would be wrong the moment a report was
2803
+ * added — which is exactly what happened: a list naming three of the five
2804
+ * ignored Channels and the breakdowns, so with only one of those loaded the
2805
+ * picker named a zone nothing on screen was counted in.
2806
+ *
2807
+ * It is not guaranteed to be the zone that was ASKED for: the server falls
2808
+ * back to the site's stored zone, and then UTC, for a value it cannot use.
2809
+ * Only the response says which.
2810
+ */
2811
+ reportedZone: string | undefined;
2775
2812
  /** True until every report has settled, for the initial skeleton only. */
2776
2813
  isLoading: boolean;
2777
2814
  refetch: () => Promise<void>;
@@ -2924,6 +2961,94 @@ declare function toMinorUnits(major: string | number, currency: string): number
2924
2961
  */
2925
2962
  declare function toMajorUnits(minor: number, currency: string): number;
2926
2963
 
2964
+ /**
2965
+ * THE CONVERSION THIS SITE IS JUDGED ON, said in one line.
2966
+ *
2967
+ * A MARKER, not a classification. Every site reports on the same tracked
2968
+ * conversions; this says which one of them is the business's own measure of a
2969
+ * good day, so the Dashboard can lead with it and the conversions table can
2970
+ * lift it out of the list.
2971
+ *
2972
+ * ITS GRAIN IS A GOAL PLUS AN OPTIONAL TARGET, which is the whole reason this
2973
+ * replaced an earlier five-value `SiteGoal` enum. "A form submission" is not
2974
+ * specific enough to be a business's goal once a site has more than one form:
2975
+ * on landingsite.ai the conversion that matters is the form that CREATES A
2976
+ * SITE, and `Form: Submission` aggregates every form on the page. For another
2977
+ * site the same goal means a newsletter sign-up, and for a third the answer is
2978
+ * an order instead. Five archetypes cannot express any of that.
2979
+ *
2980
+ * `target` ABSENT IS A REAL STATE, not a missing one — "this goal, any target".
2981
+ * It has to be, because a specific target is not always knowable: measured
2982
+ * 2026-10-11, 97.3% of sites have no form target recorded at all, since the
2983
+ * instrumentation is newer than the trackers most sites have cached. So a site
2984
+ * is markable from its first day at goal level, and narrowing to one target is
2985
+ * a refinement for the sites that can.
2986
+ *
2987
+ * WHY `label` IS THE HOST'S TO SUPPLY, AND OPTIONAL. The conversions targets
2988
+ * report already resolves a target to a human name where one exists — a form's
2989
+ * current name, else the raw endpoint. Only the host knows which of those it
2990
+ * got, and the difference decides the copy: "Your main conversion is Create a
2991
+ * site" reads as intended, while "Your main conversion is
2992
+ * api.example.com/f/3b2a" is worse than saying nothing specific. So the host
2993
+ * passes `label` ONLY when it holds a name a person wrote, and this component
2994
+ * never has to guess whether a string is a name or a URL.
2995
+ */
2996
+ interface PrimaryConversion {
2997
+ /**
2998
+ * The tracked goal's name, spelled as the conversions report spells it —
2999
+ * `Form: Submission`, `Contact`, `Outbound Link: Click`, `File Download`,
3000
+ * `Purchase`, `Form: Received`, or a goal the merchant created.
3001
+ *
3002
+ * Deliberately an open string rather than a union. The merchant can create
3003
+ * goals, so a closed set here would be wrong the moment one does.
3004
+ *
3005
+ * THE NAME IS THE REPORT'S OWN KEY, not a label beside an id: "matching is
3006
+ * query-time and the display name is the key reports are keyed by", and a
3007
+ * conversions row carries no id at all. So matching on it is not a shortcut
3008
+ * — it is the only join the report offers.
3009
+ *
3010
+ * WHICH MAKES A BUILT-IN SAFE AND A CUSTOM GOAL NOT, and a host persisting
3011
+ * this needs to know the difference. The six built-ins "are not rows and
3012
+ * cannot be renamed or deleted", so their names are permanent. A goal the
3013
+ * merchant created can be renamed through `PATCH /analytics/goals/{id}`,
3014
+ * which keeps its id and relabels every historical report — so a stored
3015
+ * marker naming the old one stops matching any row, and because goal names
3016
+ * are unique per site rather than reserved, a NEW goal can later take the
3017
+ * freed name and inherit the mark silently.
3018
+ *
3019
+ * Until the conversions report exposes a goal id, a host should therefore
3020
+ * either mark only built-ins, or re-validate a custom marker against the
3021
+ * current conversions and drop it when it no longer matches. Dropping is
3022
+ * safe here: an unset marker renders nothing by design.
3023
+ */
3024
+ goal: string;
3025
+ /**
3026
+ * Whether this is one of the six BUILT-IN goals, as the conversions row
3027
+ * reports it.
3028
+ *
3029
+ * It decides whether curated copy may be used at all, and it has to, because
3030
+ * a name is not proof of a built-in. The goals API shipped hours before
3031
+ * these names were reserved, so a merchant could already have created a
3032
+ * PAGEVIEW goal called `Purchase` — and when that happens the API keeps
3033
+ * theirs and drops the derived one, reporting `implicit: false`. Trusting
3034
+ * the name alone would tell that merchant "This site is set up to sell"
3035
+ * about a goal that counts visits to `/thanks`.
3036
+ *
3037
+ * Absent means "not established", and curated copy is withheld rather than
3038
+ * guessed: a host that forgets this gets the generic line, which is less
3039
+ * specific but never wrong. The opposite default would be wrong exactly
3040
+ * where it is hardest to notice.
3041
+ */
3042
+ implicit?: boolean;
3043
+ /** One target under that goal, or null/undefined for "any target". */
3044
+ target?: string | null;
3045
+ /**
3046
+ * A human name for what is marked, when the host has one. Omit it rather
3047
+ * than passing an endpoint or a URL — see the note above.
3048
+ */
3049
+ label?: string;
3050
+ }
3051
+
2927
3052
  interface AnalyticsViewProps {
2928
3053
  /**
2929
3054
  * Filters, when the HOST wants to own them — to put them in its URL, say.
@@ -2939,6 +3064,16 @@ interface AnalyticsViewProps {
2939
3064
  /** Bump to force a refetch, matching the other views. */
2940
3065
  refreshKey?: number;
2941
3066
  onBackToWebsite?: () => void;
3067
+ /**
3068
+ * The conversion this business is judged on, so its row in the conversions
3069
+ * table reads as the one that matters.
3070
+ *
3071
+ * THE SAME SHAPE THE DASHBOARD TAKES, so a host passes one object for one
3072
+ * fact rather than two differently-shaped things. This view uses only
3073
+ * `goal`: it has no headline to name a target in, and the table has one row
3074
+ * per goal.
3075
+ */
3076
+ primaryConversion?: PrimaryConversion | null;
2942
3077
  className?: string;
2943
3078
  /**
2944
3079
  * Publish state, supplied by the host: aifeatures has none of its own.
@@ -2968,26 +3103,7 @@ interface AnalyticsViewProps {
2968
3103
  * `published === false` overrides a collecting status: an unpublished site
2969
3104
  * with nothing ever seen is the first row above, not the third.
2970
3105
  */
2971
- declare function AnalyticsView({ filters: filtersProp, onFiltersChange, refreshKey, onBackToWebsite, className, published, lastPublishedAt, }: AnalyticsViewProps): react_jsx_runtime.JSX.Element;
2972
-
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";
3106
+ declare function AnalyticsView({ filters: filtersProp, onFiltersChange, refreshKey, onBackToWebsite, primaryConversion, className, published, lastPublishedAt, }: AnalyticsViewProps): react_jsx_runtime.JSX.Element;
2991
3107
 
2992
3108
  interface DashboardViewProps {
2993
3109
  /** Bumped by the host after any turn that touched business data. */
@@ -2998,8 +3114,12 @@ interface DashboardViewProps {
2998
3114
  * Facts the package cannot know, supplied by the host — the same contract
2999
3115
  * the analytics view already uses.
3000
3116
  */
3001
- /** What the site is for. `unknown` until the derivation ships; renders nothing. */
3002
- goal?: SiteGoal;
3117
+ /**
3118
+ * Which tracked conversion this business is judged on — a goal, optionally
3119
+ * narrowed to one target. Absent renders nothing, which is the state of a
3120
+ * site nobody has marked yet.
3121
+ */
3122
+ primaryConversion?: PrimaryConversion | null;
3003
3123
  /**
3004
3124
  * Host callback to change the active surface. Without it the storefront
3005
3125
  * entries render nothing, because a panel that claims to lead somewhere and
@@ -3033,6 +3153,6 @@ interface DashboardViewProps {
3033
3153
  * own call and fails alone. Nothing here claims per-panel isolation it does
3034
3154
  * not have.
3035
3155
  */
3036
- declare function DashboardView({ refreshKey, onBackToWebsite, goal, onOpenSurface, needsPaidPlan, onUpgradePlan, onConnectStripe, }: DashboardViewProps): react_jsx_runtime.JSX.Element;
3156
+ declare function DashboardView({ refreshKey, onBackToWebsite, primaryConversion, onOpenSurface, needsPaidPlan, onUpgradePlan, onConnectStripe, }: DashboardViewProps): react_jsx_runtime.JSX.Element;
3037
3157
 
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 };
3158
+ 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 PrimaryConversion, 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 };