@gem-sdk/analytics 2.0.0-dev.1 → 2.0.0

package/dist/esm/components/CardPathAnalysis/components/PathAnalysisChart.d.ts

@@ -1,5 +1,4 @@
 import type { IFunnelChartColors } from '@/shared/charts';
-import '../assets/styles/PathAnalysis.scss';
 interface PathAnalysisChartProps {
     funnelColors?: IFunnelChartColors;
     isEnabled?: boolean;

package/dist/esm/components/CardPathAnalysis/contexts/PathAnalysisConfigProvider.d.ts

@@ -13,11 +13,18 @@ export interface IPathAnalysisHeatmapConfig {
 export interface IPathAnalysisConfig {
     pricing: IPathAnalysisPricingConfig;
     heatmap: IPathAnalysisHeatmapConfig;
+    /**
+     * When enabled, the funnel auto-expands every level along the dominant path
+     * (first level → highest-traffic child → ... up to MAX_FUNNEL_ADDITIONAL_LEVEL,
+     * stopping early when a level has no further paths) and the "+" add button is hidden.
+     */
+    autoExpandLevels?: boolean;
 }
 export interface IPathAnalysisConfigProviderProps {
     children: ReactNode;
     pricing: IPathAnalysisPricingConfig;
     heatmap: IPathAnalysisHeatmapConfig;
+    autoExpandLevels?: boolean;
 }
-export declare const PathAnalysisConfigProvider: ({ children, pricing, heatmap }: IPathAnalysisConfigProviderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const PathAnalysisConfigProvider: ({ children, pricing, heatmap, autoExpandLevels, }: IPathAnalysisConfigProviderProps) => import("react/jsx-runtime").JSX.Element;
 export declare const usePathAnalysisConfig: () => IPathAnalysisConfig;

package/dist/esm/components/CardPathAnalysis/hooks/usePathAnalysisChart.d.ts

@@ -4,6 +4,7 @@ export declare const usePathAnalysisChart: () => {
     lengthDisplayedLevels: number;
     listFunnelSelection: IFunnelSelectionItem[];
     isDisabledAddICon: boolean;
+    hideAddIcon: boolean;
     funnelData: import("@shopify/polaris-viz-core").DataSeries[];
     onDeleteFunnel: (id?: string) => void;
     onAddNextFunnel: (id: string) => void;

package/dist/esm/components/CardPathAnalysis/hooks/usePathAnalysisFunnel.d.ts

@@ -6,8 +6,9 @@ interface IUsePathAnalysisFunnelProps {
     pathAnalysisCacheKey: string;
     dataFirstLevels?: IPathAnalysisFirstLevel[];
     locationPath?: string;
+    autoExpandLevels?: boolean;
 }
-export declare const usePathAnalysisFunnel: ({ pathAnalytics, pathAnalysisCacheKey, dataFirstLevels, locationPath, }: IUsePathAnalysisFunnelProps) => {
+export declare const usePathAnalysisFunnel: ({ pathAnalytics, pathAnalysisCacheKey, dataFirstLevels, locationPath, autoExpandLevels, }: IUsePathAnalysisFunnelProps) => {
     pageWithMetric: IBasePathAnalyticPageWithChild | undefined;
     dynamicLevels: IBasePathAnalyticPageWithChild[];
     nextLevelPages: IBasePathAnalyticPageWithChild[];

package/dist/esm/components/GModalOrderJourney/GModalOrderJourney.d.ts

@@ -0,0 +1,20 @@
+import type { IOrderJourneyItem, IOrderPageAnalytic, IReportCampaign } from '@/components/OrderAnalytic/types';
+import type { EAnalyticMode } from '@/types';
+import { EReportSource } from '@/components/OrderAnalytic/types';
+export interface GModalOrderJourneyProps {
+    open: boolean;
+    onClose: () => void;
+    title: string;
+    orderId: string;
+    journeyItems: IOrderJourneyItem[];
+    isLoading?: boolean;
+    hasNextPage?: boolean;
+    isFetchingNextPage?: boolean;
+    fetchNextPage?: () => void;
+    reportCampaign?: IReportCampaign;
+    pageAnalytic?: IOrderPageAnalytic;
+    mode: EAnalyticMode;
+    journeySource?: EReportSource;
+    onViewOrderDetails?: (orderId: string) => void;
+}
+export declare const GModalOrderJourney: ({ open, onClose, title, orderId, journeyItems, isLoading, hasNextPage, isFetchingNextPage, fetchNextPage, reportCampaign, pageAnalytic, mode, journeySource, onViewOrderDetails, }: GModalOrderJourneyProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/esm/components/GModalOrderJourney/components/OrderJourneySkeleton.d.ts

@@ -0,0 +1 @@
+export declare const OrderJourneySkeleton: () => import("react/jsx-runtime").JSX.Element;

package/dist/esm/components/GModalOrderJourney/components/index.d.ts

@@ -0,0 +1 @@
+export * from './OrderJourneySkeleton';

package/dist/esm/components/GModalOrderJourney/context/OrderJourneyContext.d.ts

@@ -0,0 +1,6 @@
+export interface OrderJourneyContextValue {
+    orderId: string;
+    onViewOrderDetails?: (orderId: string) => void;
+}
+export declare const OrderJourneyProvider: import("react").Provider<OrderJourneyContextValue | undefined>;
+export declare const useOrderJourneyContext: () => OrderJourneyContextValue;

package/dist/esm/components/GModalOrderJourney/context/index.d.ts

@@ -0,0 +1 @@
+export * from './OrderJourneyContext';

package/dist/esm/components/GModalOrderJourney/hooks/index.d.ts

@@ -0,0 +1 @@
+export * from './useGModalOrderJourney';

package/dist/esm/components/GModalOrderJourney/hooks/useGModalOrderJourney.d.ts

@@ -0,0 +1,7 @@
+import type { GModalOrderJourneyInitialValues } from '../types';
+export declare const useGModalOrderJourney: () => {
+    isOpen: boolean;
+    initialValues: GModalOrderJourneyInitialValues | null;
+    handleOpenModalOrderJourney: (data: GModalOrderJourneyInitialValues) => void;
+    handleCloseModalOrderJourney: () => void;
+};

package/dist/esm/components/GModalOrderJourney/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './hooks';
+export * from './context';
+export * from './GModalOrderJourney';

package/dist/esm/components/GModalOrderJourney/types/index.d.ts

@@ -0,0 +1,4 @@
+export interface GModalOrderJourneyInitialValues {
+    id: string;
+    orderId: string;
+}

package/dist/esm/components/GModalOrderJourney/utils/index.d.ts

@@ -0,0 +1,28 @@
+import type { IOrderJourneyItem, IOrderPageAnalytic } from '@/components/OrderAnalytic/types';
+import { EReportSource } from '@/components/OrderAnalytic/types';
+import { EAnalyticMode } from '@/types';
+interface SliceJourneyItemsParams {
+    journeyItems: IOrderJourneyItem[];
+    mode: EAnalyticMode;
+    source: EReportSource;
+    filteredCampaignId?: string;
+    pageAnalytic?: IOrderPageAnalytic;
+}
+/**
+ * Slices journey items based on the analytic metric mode.
+ *
+ * - FIRST_SESSION: Returns all items (no slicing)
+ * - PAGE_ONLY: Slices from the LAST matching event (most recent relevant interaction)
+ * - ALL_SESSION: Slices from the FIRST matching event (entire journey from first interaction)
+ */
+export declare const sliceJourneyItems: ({ journeyItems, mode, source, filteredCampaignId, pageAnalytic, }: SliceJourneyItemsParams) => IOrderJourneyItem[];
+export declare const getEventCampaignIdByType: ({ campaignGroupID, campaignID, }: {
+    campaignGroupID: string;
+    campaignID: string;
+}) => string;
+export declare const isCampaignOfAnother: ({ campaignGroupID, campaignID, filteredCampaignId, }: {
+    campaignGroupID: string;
+    campaignID: string;
+    filteredCampaignId?: string;
+}) => boolean | "" | undefined;
+export {};

package/dist/esm/components/GSelectableMetricChartCard/GSelectableMetricChartCard.d.ts

@@ -11,6 +11,7 @@ export interface IProps {
     currentPeriodLabel?: string;
     previousPeriodLabel?: string;
     columnTypes?: ColumnTypesMap;
+    isMockData?: boolean;
     onclickMetric?: (key: string) => void;
 }
-export declare const GSelectableMetricChartCard: ({ metricInfo, dataChart, defaultActiveTab, isLoading, isEmptyMetricData, hideComparison, currentPeriodLabel, previousPeriodLabel, columnTypes, }: IProps) => ReactElement;
+export declare const GSelectableMetricChartCard: ({ metricInfo, dataChart, defaultActiveTab, isLoading, isEmptyMetricData, hideComparison, currentPeriodLabel, previousPeriodLabel, columnTypes, isMockData, onclickMetric, }: IProps) => ReactElement;

package/dist/esm/components/GSelectableMetricChartCard/MetricChartTab.d.ts

@@ -5,7 +5,8 @@ export interface IProps {
     isActive: boolean;
     isLoading?: boolean;
     hideComparison?: boolean;
+    isMockData?: boolean;
     onSelect: (key: EMetricKey) => void;
     onClickTitle?: (key: string) => void;
 }
-export declare const MetricChartTab: ({ item, isActive, isLoading, hideComparison, onSelect, onClickTitle, }: IProps) => ReactElement;
+export declare const MetricChartTab: ({ item, isActive, isLoading, hideComparison, isMockData, onSelect, onClickTitle, }: IProps) => ReactElement;

package/dist/esm/components/MetricDonutChartCard/MetricDonutChartCard.d.ts

@@ -11,6 +11,7 @@ export interface IProps {
     isLoading?: boolean;
     isEmptyMetricData?: boolean;
     minHeight?: number;
+    isMockData?: boolean;
     onClick: () => void;
 }
-export declare const MetricDonutChartCard: ({ label, metricKey, targets, totalsRow, comparisonTotalsRow, sort, isLoading, isEmptyMetricData, minHeight, onClick, }: IProps) => ReactElement;
+export declare const MetricDonutChartCard: ({ label, metricKey, targets, totalsRow, comparisonTotalsRow, sort, isLoading, isEmptyMetricData, minHeight, isMockData, onClick, }: IProps) => ReactElement;

package/dist/esm/components/OrderAnalytic/OrderListingLatestTable.d.ts

@@ -16,6 +16,7 @@ interface OrderListingLatestTableProps {
     source: EReportSource;
     data: IOrderListingLatestData;
     callbacks?: IOrderListingLatestCallbacks;
+    isMockData?: boolean;
 }
-export declare const OrderListingLatestTable: ({ source, data, callbacks }: OrderListingLatestTableProps) => import("react/jsx-runtime").JSX.Element;
+export declare const OrderListingLatestTable: ({ source, data, callbacks, isMockData }: OrderListingLatestTableProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/esm/components/OrderAnalytic/components/OrderListing/OrderListingTable.d.ts

@@ -18,9 +18,10 @@ interface OrderListingTableProps {
     queryValue?: string;
     paginationProps?: GPaginationProps;
     tableOptions?: OrderListingTableOptions;
+    isMockData?: boolean;
     onViewAllStoreOrders?: () => void;
     onViewOrderJourney?: (orderId: string) => void;
     onViewOrderDetails?: (orderId: string) => void;
 }
-declare const _default: import("react").MemoExoticComponent<({ orders, isLoading, totalStoreOrders, queryValue, paginationProps, tableOptions, onViewAllStoreOrders, onViewOrderJourney, onViewOrderDetails, }: OrderListingTableProps) => import("react/jsx-runtime").JSX.Element>;
+declare const _default: import("react").MemoExoticComponent<({ orders, isLoading, totalStoreOrders, queryValue, paginationProps, tableOptions, isMockData, onViewAllStoreOrders, onViewOrderJourney, onViewOrderDetails, }: OrderListingTableProps) => import("react/jsx-runtime").JSX.Element>;
 export default _default;

package/dist/esm/components/OrderAnalytic/stores/order-columns-selector.d.ts

@@ -1,7 +1,5 @@
 import type { EReportColumnKey } from '@/shared/reports/ui/ReportTable/types/report-columns';
 export interface IOrderColumnsSelectorStoreState {
-    isChangeSelectedColumnsPreviously: boolean;
-    setIsChangeSelectedColumnsPreviously: (isChangeSelectedColumnsPreviously: boolean) => void;
     selectedColumns: EReportColumnKey[];
     columnsOrder: EReportColumnKey[];
     setSelectedColumns: (selectedColumns: EReportColumnKey[]) => void;

package/dist/esm/components/OrderAnalytic/types/order.d.ts

@@ -1,3 +1,4 @@
+import type { ICampaignType } from '@/types';
 export declare enum EJourneyEvent {
     ADDED_TO_CART = "ADDED_TO_CART",
     CHECKOUT_ADDRESS_INFO_SUBMITTED = "CHECKOUT_ADDRESS_INFO_SUBMITTED",
@@ -19,6 +20,37 @@ export interface IBaseJourneyEvent {
     date: string;
     eventType: EJourneyEvent;
 }
+export interface ILineItem {
+    imageURL?: string | null;
+    productID?: string | null;
+    productTitle?: string | null;
+    productVariantID?: string | null;
+    properties?: string | null;
+    quantity?: number | null;
+    title?: string | null;
+}
+export interface IOrderJourneyBase {
+    campaignID?: string | null;
+    campaignGroupID?: string | null;
+    campaignGroupName?: string | null;
+    campaignName?: string | null;
+    campaignVariantType?: string | null;
+    date: string;
+    locationPath?: string | null;
+    name?: string | null;
+    orderID: string;
+    pageTitle?: string | null;
+    shopifySessionID?: string | null;
+    items?: (ILineItem | null)[] | null;
+}
+export interface IOrderJourneyItem extends IOrderJourneyBase {
+    eventType: EJourneyEvent;
+    lineItems?: ILineItem[];
+}
+export type IOrderItemPage = Pick<IOrderJourneyBase, 'campaignID' | 'campaignGroupID' | 'campaignGroupName' | 'campaignName' | 'campaignVariantType' | 'locationPath'> & {
+    filteredCampaignId?: string;
+    filteredCampaignType?: ICampaignType;
+};
 export interface IOrderItem {
     image_url: string;
     product_title: string;

package/dist/esm/components/SingleMetricChartCard/SingleMetricChartCard.d.ts

@@ -9,6 +9,7 @@ export interface IProps {
     isEmptyMetricData?: boolean;
     lineChartData: DataSeries[];
     columnTypes?: ColumnTypesMap;
+    isMockData?: boolean;
     onClickTitle?: (key: string) => void;
 }
-export declare const SingleMetricChartCard: ({ metricInfo, lineChartData, isLoading, hideComparison, columnTypes, isEmptyMetricData, onClickTitle, }: IProps) => ReactElement;
+export declare const SingleMetricChartCard: ({ metricInfo, lineChartData, isLoading, hideComparison, columnTypes, isEmptyMetricData, isMockData, onClickTitle, }: IProps) => ReactElement;

package/dist/esm/components/common/chart/MetricInfoBlock.d.ts

@@ -8,6 +8,7 @@ export interface IProps {
     hideComparison?: boolean;
     titleVariant?: TextProps['variant'];
     titleFontWeight?: TextProps['fontWeight'];
+    isMockData?: boolean;
     onClickTitle?: (key: string) => void;
 }
-export declare const MetricInfoBlock: ({ item, isHovered, isLoading, hideComparison, titleVariant, titleFontWeight, onClickTitle, }: IProps) => ReactElement;
+export declare const MetricInfoBlock: ({ item, isHovered, isLoading, hideComparison, titleVariant, titleFontWeight, isMockData, onClickTitle, }: IProps) => ReactElement;

package/dist/esm/components/index.d.ts

@@ -6,3 +6,4 @@ export * from './CurrencySelector';
 export * from './GTimePicker';
 export * from './CardPathAnalysis';
 export * from './OrderAnalytic';
+export * from './GModalOrderJourney';

package/dist/esm/gemxql.js

@@ -4,7 +4,7 @@ import timezone from 'dayjs/plugin/timezone.js';
 import utc from 'dayjs/plugin/utc.js';
 import { useQuery } from '@tanstack/react-query';
 import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
-import { createContext, useContext, useState, useRef, useCallback, useEffect } from 'react';
+import { createContext, useContext, useState, useMemo, useRef, useCallback, useEffect } from 'react';
 import { create } from 'zustand';
 import '@shopify/polaris';
 
@@ -177,6 +177,8 @@ const CLAUSE_KEYWORD_BOUNDARY = CLAUSE_KEYWORDS.join('|');
 const DEFAULT_QUERY_LIMIT = 1000;
 
 const DEFAULT_GROUP_OPERATOR = EGroupOperator.OR;
+// Serializes a value as a single-quoted DSL string literal. Numbers are passed through unquoted.
+const quoteValue = (v) => typeof v === 'number' ? String(v) : `'${String(v).replace(/'/g, "''")}'`;
 const joinFieldClauses = (parts, groupOperator = DEFAULT_GROUP_OPERATOR) => {
     if (!parts.length)
         return '';
@@ -187,18 +189,18 @@ const joinFieldClauses = (parts, groupOperator = DEFAULT_GROUP_OPERATOR) => {
 const buildEq = ({ fields, value, groupOperator }) => {
     if (!fields.length)
         return '';
-    return joinFieldClauses(fields.map((field) => `${field} = ${value}`), groupOperator);
+    return joinFieldClauses(fields.map((field) => `${field} = ${quoteValue(value)}`), groupOperator);
 };
 const buildIn = ({ fields, values, groupOperator }) => {
     if (!fields.length || !values.length)
         return '';
-    return joinFieldClauses(fields.map((field) => `${field} IN (${values.join(', ')})`), groupOperator);
+    return joinFieldClauses(fields.map((field) => `${field} IN (${values.map(quoteValue).join(', ')})`), groupOperator);
 };
 const buildLike = ({ fields, value, groupOperator }) => {
     const trimmed = value.trim();
     if (!trimmed || !fields.length)
         return '';
-    return joinFieldClauses(fields.map((field) => `${field} LIKE '%${trimmed}%'`), groupOperator);
+    return joinFieldClauses(fields.map((field) => `${field} LIKE '%${trimmed.replace(/'/g, "''")}%'`), groupOperator);
 };
 const buildExtraCondition = (condition) => {
     switch (condition.operator) {
@@ -260,13 +262,14 @@ const filterConfigs = [
         multiField: EFilterField.GROUP_CAMPAIGN,
     },
 ];
+const quoteStr = (v) => `'${v.replace(/'/g, "''")}'`;
 const buildCondition = (data) => {
     const { operatorValue, singleValue, multiValue, fieldName } = data;
     if (operatorValue === OPERATOR_IS && singleValue) {
-        return `${fieldName} = ${singleValue}`;
+        return `${fieldName} = ${quoteStr(singleValue)}`;
     }
     else if (operatorValue === OPERATOR_IS_ONE_OF && Array.isArray(multiValue) && multiValue.length > 0) {
-        return `${fieldName} IN (${multiValue.join(', ')})`;
+        return `${fieldName} IN (${multiValue.map(quoteStr).join(', ')})`;
     }
     return '';
 };
@@ -276,7 +279,9 @@ const buildOverrideFilterConditions = (overrideFilters) => {
     return Object.fromEntries(Object.entries(overrideFilters)
         .filter(([, value]) => value !== undefined)
         .map(([key, value]) => {
-        const condition = Array.isArray(value) ? `${key} IN (${value.join(', ')})` : `${key} = ${value}`;
+        const condition = Array.isArray(value)
+            ? `${key} IN (${value.map(quoteStr).join(', ')})`
+            : `${key} = ${quoteStr(String(value))}`;
         return [key, condition];
     }));
 };
@@ -321,7 +326,7 @@ const buildVersionIdCondition = (versionIds) => {
     Object.entries(versionIds).forEach(([key, value]) => {
         if (!value)
             return;
-        conditions.push(`${key} = ${value}`);
+        conditions.push(`${key} = ${quoteStr(value)}`);
     });
     return conditions;
 };
@@ -346,13 +351,14 @@ const parse$b = (query) => {
     const conditions = (match[1] ?? '').trim().split(/\s+AND\s+/i);
     const filters = {};
     const versionIds = {};
+    const unquoteStr = (v) => v.replace(/^'(.*)'$/s, '$1').replace(/''/g, "'");
     conditions.forEach((condition) => {
         const trimmed = condition.trim();
         const inMatch = trimmed.match(/^(\S+)\s+IN\s+\((.+)\)$/i);
         if (inMatch) {
             const field = inMatch[1] ?? '';
             const valuesStr = inMatch[2] ?? '';
-            const values = valuesStr.split(',').map((v) => v.trim());
+            const values = valuesStr.split(',').map((v) => unquoteStr(v.trim()));
             const config = filterConfigs.find((c) => c.fieldName === field || c.multiField === field);
             if (config?.operator) {
                 filters[config.multiField] = values;
@@ -363,7 +369,7 @@ const parse$b = (query) => {
         const eqMatch = trimmed.match(/^(\S+)\s+=\s+(.+)$/);
         if (eqMatch) {
             const field = eqMatch[1] ?? '';
-            const value = eqMatch[2] ?? '';
+            const value = unquoteStr(eqMatch[2] ?? '');
             const config = filterConfigs.find((c) => c.fieldName === field || c.singleField === field);
             if (config) {
                 filters[config.singleField] = value;
@@ -383,7 +389,7 @@ const parse$b = (query) => {
 
 const build$9 = (sources) => `FROM ${sources.join(', ')}`;
 const parse$a = (query) => {
-    const match = query.match(new RegExp(`\\bFROM\\s+([\\s\\S]+?)(?=\\s+(?:${CLAUSE_KEYWORD_BOUNDARY})\\b)`, 'i'));
+    const match = query.match(new RegExp(`\\bFROM\\s+([\\s\\S]+?)(?=\\s+(?:${CLAUSE_KEYWORD_BOUNDARY})\\b|$)`, 'i'));
     if (!match)
         return [];
     return (match[1] ?? '')
@@ -394,27 +400,30 @@ const parse$a = (query) => {
 
 const build$8 = (dimensions, withClause = EGroupWithClause.ALL) => dimensions.length === 0 ? '' : `GROUP BY ${dimensions.join(', ')} ${withClause}`;
 const parse$9 = (query) => {
-    const match = query.match(new RegExp(`\\bGROUP BY\\s+([\\s\\S]+?)(?=\\s+(?:${CLAUSE_KEYWORD_BOUNDARY})\\b)`, 'i'));
+    const match = query.match(new RegExp(`\\bGROUP BY\\s+([\\s\\S]+?)(?=\\s+(?:${CLAUSE_KEYWORD_BOUNDARY})\\b|$)`, 'i'));
     if (!match)
         return { dimensions: [] };
-    const content = (match[1] ?? '').trim();
-    const withIdx = content.toUpperCase().indexOf(' WITH ');
-    if (withIdx === -1) {
-        return {
-            dimensions: content
-                .split(',')
-                .map((s) => s.trim())
-                .filter(Boolean),
-            groupWithClause: EGroupWithClause.NONE,
-        };
+    let content = (match[1] ?? '').trim();
+    // Detect the trailing with-clause token (e.g. `WITH GROUP_TOTALS, TOTALS` or `TOTALS`).
+    // Derive tokens from the enum and check longest-first so `ALL` is not mistaken for `TOTALS`.
+    const clauseTokens = Object.values(EGroupWithClause)
+        .filter((token) => token !== EGroupWithClause.NONE)
+        .sort((a, b) => b.length - a.length);
+    let groupWithClause = EGroupWithClause.NONE;
+    const upperContent = content.toUpperCase();
+    for (const token of clauseTokens) {
+        if (upperContent.endsWith(token)) {
+            groupWithClause = token;
+            content = content.slice(0, content.length - token.length).trim();
+            break;
+        }
     }
     return {
         dimensions: content
-            .slice(0, withIdx)
             .split(',')
             .map((s) => s.trim())
             .filter(Boolean),
-        groupWithClause: content.slice(withIdx + 1).trim(),
+        groupWithClause,
     };
 };
 
@@ -472,7 +481,7 @@ const parse$5 = (query) => {
 
 const build$3 = (metrics) => `SHOW ${metrics.join(', ')}`;
 const parse$4 = (query) => {
-    const match = query.match(new RegExp(`\\bSHOW\\s+([\\s\\S]+?)(?=\\s+(?:${CLAUSE_KEYWORD_BOUNDARY})\\b)`, 'i'));
+    const match = query.match(new RegExp(`\\bSHOW\\s+([\\s\\S]+?)(?=\\s+(?:${CLAUSE_KEYWORD_BOUNDARY})\\b|$)`, 'i'));
     if (!match)
         return [];
     return (match[1] ?? '')
@@ -524,11 +533,15 @@ const calcPercentageString = (part, total, decimals = 2) => {
 dayjs.extend(utc);
 dayjs.extend(timezone);
 dayjs.extend(quarterOfYear);
-let tz = 'UTC';
+// Stored on `globalThis` (not a module-local `let`): each entry-point bundle gets its
+// own copy of this module, so a local var would let `setTz` and the query builder read
+// different copies. A shared global slot keeps every bundle in sync.
+const TZ_GLOBAL_KEY = '__GEM_SDK_ANALYTICS_TZ__';
 function getInitialTimezone() {
-    return tz;
+    return globalThis[TZ_GLOBAL_KEY] ?? 'UTC';
 }
 const dayjsTz = (date) => {
+    const tz = getInitialTimezone();
     if (!date)
         return dayjs().tz(tz);
     return dayjs(date).tz(tz);
@@ -904,7 +917,13 @@ const parsePageItems = (value) => parseJsonObject(value);
 
 const readNumeric = (metric, key) => {
     const raw = metric?.[key];
-    return typeof raw === 'number' ? raw : 0;
+    if (typeof raw === 'number')
+        return raw;
+    if (typeof raw === 'string') {
+        const n = parseFloat(raw);
+        return isNaN(n) ? 0 : n;
+    }
+    return 0;
 };
 const createNumericRowReader = (row, mode = ERowReaderMode.DEFAULT) => (key) => {
     const { prefix, suffix } = ROW_READER_MODE_CONFIG[mode];
@@ -1165,6 +1184,11 @@ var ICampaignType;
     ICampaignType["TEMPLATE_BUNDLE"] = "TEMPLATE_BUNDLE";
     // THEME = 'THEME',
 })(ICampaignType || (ICampaignType = {}));
+var IVariantType;
+(function (IVariantType) {
+    IVariantType["VARIANT_A"] = "A";
+    IVariantType["VARIANT_B"] = "B";
+})(IVariantType || (IVariantType = {}));
 
 [
     { value: EVisitorType.NEW, label: 'New' },
@@ -1230,8 +1254,19 @@ var GPaginationDirection;
 
 const useGemXQlPagination = ({ resetKey, itemsPerPage, }) => {
     const [currentPage, setCurrentPage] = useState(1);
+    // Serialize so object/array reset keys compare by value, not by reference.
+    const serializedResetKey = useMemo(() => {
+        if (resetKey === undefined)
+            return undefined;
+        try {
+            return JSON.stringify(resetKey);
+        }
+        catch {
+            return String(resetKey);
+        }
+    }, [resetKey]);
     const previousResetKeyRef = useRef();
-    const shouldResetPagination = currentPage > 1 && previousResetKeyRef.current !== undefined && previousResetKeyRef.current !== resetKey;
+    const shouldResetPagination = currentPage > 1 && previousResetKeyRef.current !== undefined && previousResetKeyRef.current !== serializedResetKey;
     const effectivePage = shouldResetPagination ? 1 : currentPage;
     const offset = (effectivePage - 1) * itemsPerPage;
     const handlePageChange = useCallback((totalPages) => (direction) => {
@@ -1242,11 +1277,11 @@ const useGemXQlPagination = ({ resetKey, itemsPerPage, }) => {
         });
     }, []);
     useEffect(() => {
-        if (previousResetKeyRef.current !== resetKey) {
-            previousResetKeyRef.current = resetKey;
+        if (previousResetKeyRef.current !== serializedResetKey) {
+            previousResetKeyRef.current = serializedResetKey;
             setCurrentPage(1);
         }
-    }, [resetKey]);
+    }, [serializedResetKey]);
     const buildPagination = useCallback(({ totalRecords, isLoading }) => {
         const totalPages = Math.max(1, Math.ceil(totalRecords / itemsPerPage));
         return {