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

package/dist/esm/gemxql.mjs

@@ -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 {

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

@@ -4,3 +4,4 @@ export { useFormatLineChartData } from './useFormatLineChartData';
 export { usePopoverResizeObserver } from './usePopoverResizeObserver';
 export { useToggle } from './useToggle';
 export { useWindowSize } from './publish/useWindowSize';
+export { usePreventBodyScroll } from './usePreventBodyScroll';

package/dist/esm/hooks/useFetchCurrencyRates.d.ts

@@ -1 +1,4 @@
-export declare const useFetchCurrencyRates: () => void;
+export declare const useFetchCurrencyRates: () => {
+    isError: boolean;
+    error: Error | null;
+};

package/dist/esm/hooks/usePreventBodyScroll.d.ts

@@ -0,0 +1,3 @@
+export declare const usePreventBodyScroll: ({ enable }: {
+    enable: boolean;
+}) => void;