@levi-gemcommerce/analytics 0.0.0-test.1

package/dist/esm/core/gemxql/builder/clauses/time-query.js

@@ -0,0 +1,46 @@
+"use client"
+import { dayjsTz } from '../../../../utils/dayjs.js';
+import '../../../../utils/analytics.js';
+import '../../../../types/template.js';
+import { getDateRangeForQuery } from '../helpers/date-query-helpers.js';
+
+const buildOverrideTimeQuery = (key, value) => `DURING (${value}, ${key})`;
+const build = (data) => {
+    const { dateRange, compareDateRange, overrideFilters, timeDimension } = data;
+    const overrideTimeValue = timeDimension
+        ? overrideFilters?.[timeDimension]
+        : undefined;
+    if (timeDimension && overrideTimeValue) {
+        return buildOverrideTimeQuery(timeDimension, overrideTimeValue);
+    }
+    if (!dateRange)
+        return '';
+    const { dateGTE, dateLTE } = getDateRangeForQuery(dateRange);
+    const { dateGTE: compareDateGTE, dateLTE: compareDateLTE } = compareDateRange
+        ? getDateRangeForQuery(compareDateRange)
+        : {};
+    const compareToClause = compareDateRange ? `COMPARE TO ${compareDateGTE} UNTIL ${compareDateLTE}` : '';
+    return `SINCE ${dateGTE} UNTIL ${dateLTE} ${compareToClause}`;
+};
+const parse = (query) => {
+    const duringMatch = query.match(/\bDURING\s+\(([^,]+),\s*([^)]+)\)/i);
+    if (duringMatch) {
+        const value = duringMatch[1] ?? '';
+        const key = duringMatch[2] ?? '';
+        return {
+            timeDimension: key.trim(),
+            overrideFilters: { [key.trim()]: value.trim() },
+        };
+    }
+    const sinceMatch = query.match(/\bSINCE\s+(\S+)\s+UNTIL\s+(\S+)/i);
+    if (!sinceMatch)
+        return {};
+    const dateRange = { startDate: dayjsTz(sinceMatch[1] ?? ''), endDate: dayjsTz(sinceMatch[2] ?? '') };
+    const compareMatch = query.match(/\bCOMPARE TO\s+(\S+)\s+UNTIL\s+(\S+)/i);
+    const compareDateRange = compareMatch
+        ? { startDate: dayjsTz(compareMatch[1] ?? ''), endDate: dayjsTz(compareMatch[2] ?? '') }
+        : undefined;
+    return { dateRange, compareDateRange };
+};
+
+export { build as buildTimeQuery, parse as parseTimeQuery };

package/dist/esm/core/gemxql/builder/clauses/time-query.mjs

@@ -0,0 +1,46 @@
+"use client"
+import { dayjsTz } from '../../../../utils/dayjs.mjs';
+import '../../../../utils/analytics.mjs';
+import '../../../../types/template.mjs';
+import { getDateRangeForQuery } from '../helpers/date-query-helpers.mjs';
+
+const buildOverrideTimeQuery = (key, value) => `DURING (${value}, ${key})`;
+const build = (data) => {
+    const { dateRange, compareDateRange, overrideFilters, timeDimension } = data;
+    const overrideTimeValue = timeDimension
+        ? overrideFilters?.[timeDimension]
+        : undefined;
+    if (timeDimension && overrideTimeValue) {
+        return buildOverrideTimeQuery(timeDimension, overrideTimeValue);
+    }
+    if (!dateRange)
+        return '';
+    const { dateGTE, dateLTE } = getDateRangeForQuery(dateRange);
+    const { dateGTE: compareDateGTE, dateLTE: compareDateLTE } = compareDateRange
+        ? getDateRangeForQuery(compareDateRange)
+        : {};
+    const compareToClause = compareDateRange ? `COMPARE TO ${compareDateGTE} UNTIL ${compareDateLTE}` : '';
+    return `SINCE ${dateGTE} UNTIL ${dateLTE} ${compareToClause}`;
+};
+const parse = (query) => {
+    const duringMatch = query.match(/\bDURING\s+\(([^,]+),\s*([^)]+)\)/i);
+    if (duringMatch) {
+        const value = duringMatch[1] ?? '';
+        const key = duringMatch[2] ?? '';
+        return {
+            timeDimension: key.trim(),
+            overrideFilters: { [key.trim()]: value.trim() },
+        };
+    }
+    const sinceMatch = query.match(/\bSINCE\s+(\S+)\s+UNTIL\s+(\S+)/i);
+    if (!sinceMatch)
+        return {};
+    const dateRange = { startDate: dayjsTz(sinceMatch[1] ?? ''), endDate: dayjsTz(sinceMatch[2] ?? '') };
+    const compareMatch = query.match(/\bCOMPARE TO\s+(\S+)\s+UNTIL\s+(\S+)/i);
+    const compareDateRange = compareMatch
+        ? { startDate: dayjsTz(compareMatch[1] ?? ''), endDate: dayjsTz(compareMatch[2] ?? '') }
+        : undefined;
+    return { dateRange, compareDateRange };
+};
+
+export { build as buildTimeQuery, parse as parseTimeQuery };

package/dist/esm/core/gemxql/builder/clauses/time-series-query.d.ts

@@ -0,0 +1,6 @@
+export interface IBuildTimeSeriesQueryParams {
+    timeDimension?: string;
+}
+declare const build: (time?: string) => string;
+declare const parse: (query: string) => string | undefined;
+export { build as buildTimeSeriesQuery, parse as parseTimeSeriesQuery };

package/dist/esm/core/gemxql/builder/clauses/time-series-query.js

@@ -0,0 +1,12 @@
+"use client"
+const build = (time) => {
+    if (!time)
+        return '';
+    return `TIMESERIES ${time}`;
+};
+const parse = (query) => {
+    const match = query.match(/\bTIMESERIES\s+(\S+)/i);
+    return match?.[1];
+};
+
+export { build as buildTimeSeriesQuery, parse as parseTimeSeriesQuery };

package/dist/esm/core/gemxql/builder/clauses/time-series-query.mjs

@@ -0,0 +1,12 @@
+"use client"
+const build = (time) => {
+    if (!time)
+        return '';
+    return `TIMESERIES ${time}`;
+};
+const parse = (query) => {
+    const match = query.match(/\bTIMESERIES\s+(\S+)/i);
+    return match?.[1];
+};
+
+export { build as buildTimeSeriesQuery, parse as parseTimeSeriesQuery };

package/dist/esm/core/gemxql/builder/clauses/timezone-query.d.ts

@@ -0,0 +1,6 @@
+export interface IBuildTimezoneQueryParams {
+    timezone?: string;
+}
+declare const build: (timezone?: string) => string;
+declare const parse: (query: string) => string | undefined;
+export { build as buildTimezoneQuery, parse as parseTimezoneQuery };

package/dist/esm/core/gemxql/builder/clauses/timezone-query.js

@@ -0,0 +1,15 @@
+"use client"
+import { getInitialTimezone } from '../../../../utils/dayjs.js';
+import '../../../../utils/analytics.js';
+import '../../../../types/template.js';
+
+const build = (timezone) => {
+    const tz = timezone ?? getInitialTimezone();
+    return tz ? `TIMEZONE ${tz}` : '';
+};
+const parse = (query) => {
+    const match = query.match(/\bTIMEZONE\s+(\S+)/i);
+    return match?.[1];
+};
+
+export { build as buildTimezoneQuery, parse as parseTimezoneQuery };

package/dist/esm/core/gemxql/builder/clauses/timezone-query.mjs

@@ -0,0 +1,15 @@
+"use client"
+import { getInitialTimezone } from '../../../../utils/dayjs.mjs';
+import '../../../../utils/analytics.mjs';
+import '../../../../types/template.mjs';
+
+const build = (timezone) => {
+    const tz = timezone ?? getInitialTimezone();
+    return tz ? `TIMEZONE ${tz}` : '';
+};
+const parse = (query) => {
+    const match = query.match(/\bTIMEZONE\s+(\S+)/i);
+    return match?.[1];
+};
+
+export { build as buildTimezoneQuery, parse as parseTimezoneQuery };

package/dist/esm/core/gemxql/builder/configs/date-formats.d.ts

@@ -0,0 +1 @@
+export declare const DATE_QUERY_FORMAT = "YYYY-MM-DDTHH:mm:ss";

package/dist/esm/core/gemxql/builder/configs/date-formats.js

@@ -0,0 +1,4 @@
+"use client"
+const DATE_QUERY_FORMAT = 'YYYY-MM-DDTHH:mm:ss';
+
+export { DATE_QUERY_FORMAT };

package/dist/esm/core/gemxql/builder/configs/date-formats.mjs

@@ -0,0 +1,4 @@
+"use client"
+const DATE_QUERY_FORMAT = 'YYYY-MM-DDTHH:mm:ss';
+
+export { DATE_QUERY_FORMAT };

package/dist/esm/core/gemxql/builder/configs/index.d.ts

@@ -0,0 +1,3 @@
+export * from './date-formats';
+export * from './keywords';
+export * from './query-defaults';

package/dist/esm/core/gemxql/builder/configs/keywords.d.ts

@@ -0,0 +1,2 @@
+export declare const CLAUSE_KEYWORDS: readonly ["MODE", "FROM", "SHOW", "GROUP BY", "TIMESERIES", "SINCE", "DURING", "TIMEZONE", "WHERE", "ORDER BY", "LIMIT", "OFFSET"];
+export declare const CLAUSE_KEYWORD_BOUNDARY: string;

package/dist/esm/core/gemxql/builder/configs/keywords.js

@@ -0,0 +1,18 @@
+"use client"
+const CLAUSE_KEYWORDS = [
+    'MODE',
+    'FROM',
+    'SHOW',
+    'GROUP BY',
+    'TIMESERIES',
+    'SINCE',
+    'DURING',
+    'TIMEZONE',
+    'WHERE',
+    'ORDER BY',
+    'LIMIT',
+    'OFFSET',
+];
+const CLAUSE_KEYWORD_BOUNDARY = CLAUSE_KEYWORDS.join('|');
+
+export { CLAUSE_KEYWORDS, CLAUSE_KEYWORD_BOUNDARY };

package/dist/esm/core/gemxql/builder/configs/keywords.mjs

@@ -0,0 +1,18 @@
+"use client"
+const CLAUSE_KEYWORDS = [
+    'MODE',
+    'FROM',
+    'SHOW',
+    'GROUP BY',
+    'TIMESERIES',
+    'SINCE',
+    'DURING',
+    'TIMEZONE',
+    'WHERE',
+    'ORDER BY',
+    'LIMIT',
+    'OFFSET',
+];
+const CLAUSE_KEYWORD_BOUNDARY = CLAUSE_KEYWORDS.join('|');
+
+export { CLAUSE_KEYWORDS, CLAUSE_KEYWORD_BOUNDARY };

package/dist/esm/core/gemxql/builder/configs/query-defaults.d.ts

@@ -0,0 +1 @@
+export declare const DEFAULT_QUERY_LIMIT = 1000;

package/dist/esm/core/gemxql/builder/configs/query-defaults.js

@@ -0,0 +1,4 @@
+"use client"
+const DEFAULT_QUERY_LIMIT = 1000;
+
+export { DEFAULT_QUERY_LIMIT };

package/dist/esm/core/gemxql/builder/configs/query-defaults.mjs

@@ -0,0 +1,4 @@
+"use client"
+const DEFAULT_QUERY_LIMIT = 1000;
+
+export { DEFAULT_QUERY_LIMIT };

package/dist/esm/core/gemxql/builder/filters/build-extra-conditions.d.ts

@@ -0,0 +1,3 @@
+import type { IExtraCondition } from '../../types';
+export declare const buildExtraCondition: (condition: IExtraCondition) => string;
+export declare const buildExtraConditions: (conditions?: IExtraCondition[]) => string[];

package/dist/esm/core/gemxql/builder/filters/build-extra-conditions.js

@@ -0,0 +1,55 @@
+"use client"
+import '../../types/analytic-data.js';
+import '../../types/analytic-source.js';
+import { EGroupOperator, EComparisonOperator } from '../../types/extra-condition.js';
+import '../../types/field-filters.js';
+import '../../types/field-operators.js';
+import '../../types/group-with-clause.js';
+import '../../types/order-by.js';
+import '../../types/page-fields.js';
+import '../../types/row-reader-mode.js';
+import '../../types/time-dimension.js';
+
+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 '';
+    if (parts.length === 1)
+        return parts[0] ?? '';
+    return `(${parts.join(` ${groupOperator} `)})`;
+};
+const buildEq = ({ fields, value, groupOperator }) => {
+    if (!fields.length)
+        return '';
+    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.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.replace(/'/g, "''")}%'`), groupOperator);
+};
+const buildExtraCondition = (condition) => {
+    switch (condition.operator) {
+        case EComparisonOperator.EQ:
+            return buildEq(condition);
+        case EComparisonOperator.IN:
+            return buildIn(condition);
+        case EComparisonOperator.LIKE:
+            return buildLike(condition);
+    }
+};
+const buildExtraConditions = (conditions) => {
+    if (!conditions?.length)
+        return [];
+    return conditions.map(buildExtraCondition).filter(Boolean);
+};
+
+export { buildExtraCondition, buildExtraConditions };

package/dist/esm/core/gemxql/builder/filters/build-extra-conditions.mjs

@@ -0,0 +1,55 @@
+"use client"
+import '../../types/analytic-data.mjs';
+import '../../types/analytic-source.mjs';
+import { EGroupOperator, EComparisonOperator } from '../../types/extra-condition.mjs';
+import '../../types/field-filters.mjs';
+import '../../types/field-operators.mjs';
+import '../../types/group-with-clause.mjs';
+import '../../types/order-by.mjs';
+import '../../types/page-fields.mjs';
+import '../../types/row-reader-mode.mjs';
+import '../../types/time-dimension.mjs';
+
+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 '';
+    if (parts.length === 1)
+        return parts[0] ?? '';
+    return `(${parts.join(` ${groupOperator} `)})`;
+};
+const buildEq = ({ fields, value, groupOperator }) => {
+    if (!fields.length)
+        return '';
+    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.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.replace(/'/g, "''")}%'`), groupOperator);
+};
+const buildExtraCondition = (condition) => {
+    switch (condition.operator) {
+        case EComparisonOperator.EQ:
+            return buildEq(condition);
+        case EComparisonOperator.IN:
+            return buildIn(condition);
+        case EComparisonOperator.LIKE:
+            return buildLike(condition);
+    }
+};
+const buildExtraConditions = (conditions) => {
+    if (!conditions?.length)
+        return [];
+    return conditions.map(buildExtraCondition).filter(Boolean);
+};
+
+export { buildExtraCondition, buildExtraConditions };

package/dist/esm/core/gemxql/builder/filters/build-filter-conditions.d.ts

@@ -0,0 +1,22 @@
+import type { GemXQlFilters, GemXQlOverrideFilters, GemXQlVersionIds, OrderByFields } from '../../types';
+import { EFilterField, EOperatorField } from '../../types';
+export interface IBuildFilterConditionsParams {
+    filters: GemXQlFilters;
+    overrideFilters?: GemXQlOverrideFilters;
+}
+export interface IBuildVersionIdConditionParams {
+    versionIds?: GemXQlVersionIds;
+}
+interface FilterConfig {
+    operator?: EOperatorField;
+    operatorVal?: string;
+    singleField: EFilterField;
+    multiField: EFilterField;
+    condition?: EFilterField;
+    fieldName?: EFilterField;
+}
+export declare const filterConfigs: FilterConfig[];
+export declare const generateFilterConditions: (filters: GemXQlFilters, overrideFilters?: GemXQlOverrideFilters) => string[];
+export declare const buildVersionIdCondition: (versionIds?: GemXQlVersionIds) => string[];
+export declare const getFirstMetricInOrderBy: (orderBy: OrderByFields | undefined, metrics: string[]) => string[];
+export {};

package/dist/esm/core/gemxql/builder/filters/build-filter-conditions.js

@@ -0,0 +1,134 @@
+"use client"
+import { OPERATOR_IS, OPERATOR_IS_ONE_OF } from '../../constants/operators.js';
+import '../../constants/row-reader-mode.js';
+import '../../types/analytic-data.js';
+import '../../types/analytic-source.js';
+import '../../types/extra-condition.js';
+import { EFilterField } from '../../types/field-filters.js';
+import { EOperatorField } from '../../types/field-operators.js';
+import '../../types/group-with-clause.js';
+import '../../types/order-by.js';
+import '../../types/page-fields.js';
+import '../../types/row-reader-mode.js';
+import '../../types/time-dimension.js';
+
+const filterConfigs = [
+    {
+        operator: EOperatorField.DEVICE_OPERATOR,
+        singleField: EFilterField.DEVICE,
+        multiField: EFilterField.DEVICES,
+        fieldName: EFilterField.DEVICE,
+    },
+    {
+        operator: EOperatorField.VISITOR_OPERATOR,
+        singleField: EFilterField.VISITOR,
+        multiField: EFilterField.VISITORS,
+        fieldName: EFilterField.VISITOR,
+    },
+    {
+        operator: EOperatorField.TRAFFIC_SOURCE_OPERATOR,
+        singleField: EFilterField.TRAFFIC_SOURCE,
+        multiField: EFilterField.TRAFFIC_SOURCES,
+        fieldName: EFilterField.TRAFFIC_SOURCE,
+    },
+    {
+        operator: EOperatorField.VERSION_OPERATOR,
+        singleField: EFilterField.VERSION,
+        multiField: EFilterField.VERSIONS,
+        fieldName: EFilterField.VERSION,
+    },
+    {
+        operator: EOperatorField.PAGE_OPERATOR,
+        singleField: EFilterField.SINGLE_PAGE,
+        multiField: EFilterField.LIST_PAGE,
+        fieldName: EFilterField.SINGLE_PAGE,
+    },
+    {
+        operator: EOperatorField.CAMPAIGN_ITEM_OPERATOR,
+        singleField: EFilterField.GROUP_CAMPAIGN_ITEM,
+        multiField: EFilterField.GROUP_CAMPAIGN_ITEMS,
+        condition: EFilterField.GROUP_CAMPAIGN,
+        fieldName: EFilterField.SINGLE_CAMPAIGN,
+    },
+    {
+        operatorVal: OPERATOR_IS,
+        singleField: EFilterField.SINGLE_CAMPAIGN,
+        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} = ${quoteStr(singleValue)}`;
+    }
+    else if (operatorValue === OPERATOR_IS_ONE_OF && Array.isArray(multiValue) && multiValue.length > 0) {
+        return `${fieldName} IN (${multiValue.map(quoteStr).join(', ')})`;
+    }
+    return '';
+};
+const buildOverrideFilterConditions = (overrideFilters) => {
+    if (!overrideFilters)
+        return {};
+    return Object.fromEntries(Object.entries(overrideFilters)
+        .filter(([, value]) => value !== undefined)
+        .map(([key, value]) => {
+        const condition = Array.isArray(value)
+            ? `${key} IN (${value.map(quoteStr).join(', ')})`
+            : `${key} = ${quoteStr(String(value))}`;
+        return [key, condition];
+    }));
+};
+const generateFilterConditions = (filters, overrideFilters) => {
+    const conditions = [];
+    const hasFilters = Object.keys(filters).length > 0;
+    const hasOverride = !!overrideFilters && Object.keys(overrideFilters).length > 0;
+    if (!hasFilters && !hasOverride)
+        return conditions;
+    const overrideConditionsMap = buildOverrideFilterConditions(overrideFilters);
+    filterConfigs.forEach(({ operator, operatorVal, singleField, multiField, condition, fieldName }) => {
+        if (overrideConditionsMap[singleField]) {
+            conditions.push(overrideConditionsMap[singleField]);
+            return;
+        }
+        const operatorValue = operator ? filters[operator] : operatorVal;
+        let singleValue = filters[singleField];
+        const multiValue = filters[multiField];
+        const conditionValue = condition && filters[condition];
+        if (condition && !conditionValue) {
+            return;
+        }
+        const resolvedFieldName = fieldName ?? (singleValue ? singleField : multiField);
+        if (operatorVal && !singleValue) {
+            singleValue = filters[multiField];
+        }
+        const result = buildCondition({
+            operatorValue,
+            singleValue: Array.isArray(singleValue) ? undefined : singleValue,
+            multiValue: Array.isArray(multiValue) ? multiValue : undefined,
+            fieldName: resolvedFieldName,
+        });
+        if (result)
+            conditions.push(result);
+    });
+    return conditions;
+};
+const buildVersionIdCondition = (versionIds) => {
+    const conditions = [];
+    if (!versionIds)
+        return conditions;
+    Object.entries(versionIds).forEach(([key, value]) => {
+        if (!value)
+            return;
+        conditions.push(`${key} = ${quoteStr(value)}`);
+    });
+    return conditions;
+};
+const getFirstMetricInOrderBy = (orderBy, metrics) => {
+    if (!orderBy || metrics.length === 0)
+        return [];
+    const metric = metrics.find((metric) => orderBy[metric]);
+    return metric ? [metric] : [];
+};
+
+export { buildVersionIdCondition, filterConfigs, generateFilterConditions, getFirstMetricInOrderBy };

package/dist/esm/core/gemxql/builder/filters/build-filter-conditions.mjs

@@ -0,0 +1,134 @@
+"use client"
+import { OPERATOR_IS, OPERATOR_IS_ONE_OF } from '../../constants/operators.mjs';
+import '../../constants/row-reader-mode.mjs';
+import '../../types/analytic-data.mjs';
+import '../../types/analytic-source.mjs';
+import '../../types/extra-condition.mjs';
+import { EFilterField } from '../../types/field-filters.mjs';
+import { EOperatorField } from '../../types/field-operators.mjs';
+import '../../types/group-with-clause.mjs';
+import '../../types/order-by.mjs';
+import '../../types/page-fields.mjs';
+import '../../types/row-reader-mode.mjs';
+import '../../types/time-dimension.mjs';
+
+const filterConfigs = [
+    {
+        operator: EOperatorField.DEVICE_OPERATOR,
+        singleField: EFilterField.DEVICE,
+        multiField: EFilterField.DEVICES,
+        fieldName: EFilterField.DEVICE,
+    },
+    {
+        operator: EOperatorField.VISITOR_OPERATOR,
+        singleField: EFilterField.VISITOR,
+        multiField: EFilterField.VISITORS,
+        fieldName: EFilterField.VISITOR,
+    },
+    {
+        operator: EOperatorField.TRAFFIC_SOURCE_OPERATOR,
+        singleField: EFilterField.TRAFFIC_SOURCE,
+        multiField: EFilterField.TRAFFIC_SOURCES,
+        fieldName: EFilterField.TRAFFIC_SOURCE,
+    },
+    {
+        operator: EOperatorField.VERSION_OPERATOR,
+        singleField: EFilterField.VERSION,
+        multiField: EFilterField.VERSIONS,
+        fieldName: EFilterField.VERSION,
+    },
+    {
+        operator: EOperatorField.PAGE_OPERATOR,
+        singleField: EFilterField.SINGLE_PAGE,
+        multiField: EFilterField.LIST_PAGE,
+        fieldName: EFilterField.SINGLE_PAGE,
+    },
+    {
+        operator: EOperatorField.CAMPAIGN_ITEM_OPERATOR,
+        singleField: EFilterField.GROUP_CAMPAIGN_ITEM,
+        multiField: EFilterField.GROUP_CAMPAIGN_ITEMS,
+        condition: EFilterField.GROUP_CAMPAIGN,
+        fieldName: EFilterField.SINGLE_CAMPAIGN,
+    },
+    {
+        operatorVal: OPERATOR_IS,
+        singleField: EFilterField.SINGLE_CAMPAIGN,
+        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} = ${quoteStr(singleValue)}`;
+    }
+    else if (operatorValue === OPERATOR_IS_ONE_OF && Array.isArray(multiValue) && multiValue.length > 0) {
+        return `${fieldName} IN (${multiValue.map(quoteStr).join(', ')})`;
+    }
+    return '';
+};
+const buildOverrideFilterConditions = (overrideFilters) => {
+    if (!overrideFilters)
+        return {};
+    return Object.fromEntries(Object.entries(overrideFilters)
+        .filter(([, value]) => value !== undefined)
+        .map(([key, value]) => {
+        const condition = Array.isArray(value)
+            ? `${key} IN (${value.map(quoteStr).join(', ')})`
+            : `${key} = ${quoteStr(String(value))}`;
+        return [key, condition];
+    }));
+};
+const generateFilterConditions = (filters, overrideFilters) => {
+    const conditions = [];
+    const hasFilters = Object.keys(filters).length > 0;
+    const hasOverride = !!overrideFilters && Object.keys(overrideFilters).length > 0;
+    if (!hasFilters && !hasOverride)
+        return conditions;
+    const overrideConditionsMap = buildOverrideFilterConditions(overrideFilters);
+    filterConfigs.forEach(({ operator, operatorVal, singleField, multiField, condition, fieldName }) => {
+        if (overrideConditionsMap[singleField]) {
+            conditions.push(overrideConditionsMap[singleField]);
+            return;
+        }
+        const operatorValue = operator ? filters[operator] : operatorVal;
+        let singleValue = filters[singleField];
+        const multiValue = filters[multiField];
+        const conditionValue = condition && filters[condition];
+        if (condition && !conditionValue) {
+            return;
+        }
+        const resolvedFieldName = fieldName ?? (singleValue ? singleField : multiField);
+        if (operatorVal && !singleValue) {
+            singleValue = filters[multiField];
+        }
+        const result = buildCondition({
+            operatorValue,
+            singleValue: Array.isArray(singleValue) ? undefined : singleValue,
+            multiValue: Array.isArray(multiValue) ? multiValue : undefined,
+            fieldName: resolvedFieldName,
+        });
+        if (result)
+            conditions.push(result);
+    });
+    return conditions;
+};
+const buildVersionIdCondition = (versionIds) => {
+    const conditions = [];
+    if (!versionIds)
+        return conditions;
+    Object.entries(versionIds).forEach(([key, value]) => {
+        if (!value)
+            return;
+        conditions.push(`${key} = ${quoteStr(value)}`);
+    });
+    return conditions;
+};
+const getFirstMetricInOrderBy = (orderBy, metrics) => {
+    if (!orderBy || metrics.length === 0)
+        return [];
+    const metric = metrics.find((metric) => orderBy[metric]);
+    return metric ? [metric] : [];
+};
+
+export { buildVersionIdCondition, filterConfigs, generateFilterConditions, getFirstMetricInOrderBy };

package/dist/esm/core/gemxql/builder/filters/index.d.ts

@@ -0,0 +1,2 @@
+export * from './build-extra-conditions';
+export * from './build-filter-conditions';

package/dist/esm/core/gemxql/builder/helpers/date-query-helpers.d.ts

@@ -0,0 +1,5 @@
+import type { AnalyticDateFilter } from '../../../../components';
+export declare const getDateRangeForQuery: (dateRange: AnalyticDateFilter) => {
+    dateGTE: string;
+    dateLTE: string;
+};