@adtrackify/at-service-common 5.0.0 → 5.0.2

package/dist/cjs/clients/third-party/shopify/shopify-graphql-client.js

@@ -1,353 +1,353 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ShopifyGraphQLClient = void 0;
-const admin_api_client_1 = require("@shopify/admin-api-client");
-const helpers_1 = require("../../../helpers");
-const graphql_product_queries_1 = require("./graphql-product-queries");
-const graphql_order_queries_1 = require("./graphql-order-queries");
-const graphql_analytics_queries_1 = require("./graphql-analytics-queries");
-var SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS;
-(function (SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS) {
-    SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS["SUCCESS"] = "success";
-    SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS["PARTIAL"] = "partial";
-    SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS["FAILED"] = "failed";
-})(SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS || (SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS = {}));
-class ShopifyGraphQLClient {
-    static _shopify_api_version = process.env.SHOPIFY_API_VERSION;
-    static getClient = (shop, accessToken) => {
-        const client = (0, admin_api_client_1.createAdminApiClient)({
-            storeDomain: shop,
-            accessToken: accessToken,
-            apiVersion: this._shopify_api_version,
-            retries: 1,
-        });
-        return client;
-    };
-    static getProductWithVariantsGraphQL = async (shop, accessToken, productId, pageSize = 100) => {
-        try {
-            const client = this.getClient(shop, accessToken);
-            const result = await this.executePagedProductQuery(client, productId, pageSize, null);
-            return result;
-        }
-        catch (error) {
-            helpers_1.Logger.error('Failed getProductWithVariantsGraphQL', {
-                error,
-                shop,
-                accessToken,
-                productId,
-            });
-            throw error;
-        }
-    };
-    static executePagedProductQuery = async (client, productId, pageSize, cursor) => {
-        try {
-            let result = {};
-            let product = null;
-            const allVariants = [];
-            let hasNextPage = false;
-            do {
-                helpers_1.Logger.debug('executePagedProductQuery', { productId, pageSize, cursor });
-                result = await this.executeProductQuery(client, productId, pageSize, cursor ?? null);
-                if (result?.errors) {
-                    helpers_1.Logger.error('executePagedProductQuery: Failed to execute product query', {
-                        result,
-                        shop: client.config.storeDomain,
-                        productId,
-                        accessToken: client.config.accessToken,
-                    });
-                    break;
-                }
-                else if (result?.data?.product) {
-                    product = result.data.product;
-                    allVariants.push(...(product?.variants?.nodes ?? []));
-                    hasNextPage = product?.variants?.pageInfo?.hasNextPage;
-                    cursor = product?.variants?.pageInfo?.endCursor;
-                }
-                if (hasNextPage) {
-                    helpers_1.Logger.info('executePagedProductQuery: hasNextPage product variants', {
-                        hasNextPage,
-                        shop: client.config.storeDomain,
-                        productId,
-                        accessToken: client.config.accessToken,
-                    });
-                }
-            } while (hasNextPage);
-            if (product) {
-                product.variants.nodes = allVariants;
-                result.data = result?.data ?? {};
-                result.data.product = product;
-            }
-            return result;
-        }
-        catch (error) {
-            helpers_1.Logger.error('executePagedProductQuery:Failed to execute paged product query', {
-                error,
-                shop: client.config.storeDomain,
-                productId,
-                accessToken: client.config.accessToken,
-            });
-            throw error;
-        }
-    };
-    static executeProductQuery = async (client, productId, pageSize, cursor) => {
-        try {
-            const result = await client.request(graphql_product_queries_1.graphqlProductQueryByProductId, {
-                variables: {
-                    id: `gid://shopify/Product/${productId}`,
-                    first: pageSize,
-                    after: cursor,
-                },
-            });
-            if (result?.errors) {
-                helpers_1.Logger.error('Failed to executeProductQuery -- response errors', {
-                    result,
-                    responseErrors: result.errors,
-                    shop: client.config.storeDomain,
-                    productId,
-                    cursor,
-                });
-            }
-            return result;
-        }
-        catch (error) {
-            helpers_1.Logger.error('Failed to executeProductQuery -- exception', {
-                error,
-                shop: client.config.storeDomain,
-                productId,
-                accessToken: client.config.accessToken,
-            });
-            return {};
-        }
-    };
-    static getOrderLineItemsSellingPlan = async (shop, accessToken, orderId) => {
-        try {
-            const client = this.getClient(shop, accessToken);
-            const result = await client.request(graphql_order_queries_1.graphqlOrderLineItemsSellingPlanQuery, {
-                variables: {
-                    id: `gid://shopify/Order/${orderId}`,
-                },
-            });
-            if (result?.errors) {
-                helpers_1.Logger.error('getOrderLineItemsSellingPlan: GraphQL errors', {
-                    errors: result.errors,
-                    shop,
-                    orderId,
-                });
-                return null;
-            }
-            const lineItems = result?.data?.order?.lineItems?.nodes;
-            if (!lineItems || lineItems.length === 0) {
-                helpers_1.Logger.debug('getOrderLineItemsSellingPlan: no line items found', { shop, orderId });
-                return new Map();
-            }
-            const sellingPlanMap = new Map();
-            for (const lineItem of lineItems) {
-                const variantLegacyId = lineItem.variant?.legacyResourceId;
-                const sellingPlanId = lineItem.sellingPlan?.sellingPlanId;
-                if (variantLegacyId && sellingPlanId) {
-                    sellingPlanMap.set(variantLegacyId, sellingPlanId);
-                }
-            }
-            helpers_1.Logger.debug('getOrderLineItemsSellingPlan: success', {
-                shop,
-                orderId,
-                sellingPlanCount: sellingPlanMap.size,
-            });
-            return sellingPlanMap;
-        }
-        catch (error) {
-            helpers_1.Logger.error('getOrderLineItemsSellingPlan: failed', {
-                error,
-                shop,
-                orderId,
-            });
-            return null;
-        }
-    };
-    static safeGetHistoricalMetrics = async (shop, accessToken, monthsBack = 12) => {
-        const logMeta = { shop, monthsBack };
-        try {
-            if (!shop || !accessToken) {
-                helpers_1.Logger.warn('safeGetHistoricalMetrics: missing shop or accessToken', logMeta);
-                return this.buildEmptyMetrics();
-            }
-            const client = this.getClient(shop, accessToken);
-            const [salesResult, sessionsResult] = await Promise.all([
-                this.executeSafeShopifyQLQuery(client, graphql_analytics_queries_1.SHOPIFYQL_QUERIES.SALES_MONTHLY(monthsBack), shop, 'sales'),
-                this.executeSafeShopifyQLQuery(client, graphql_analytics_queries_1.SHOPIFYQL_QUERIES.SESSIONS_MONTHLY(monthsBack), shop, 'sessions'),
-            ]);
-            const salesByMonth = this.parseSalesMetrics(salesResult);
-            const sessionsByMonth = this.parseSessionsMetrics(sessionsResult);
-            const months = this.mergeMonthlyMetrics(salesByMonth, sessionsByMonth);
-            const fetchStatus = this.determineFetchStatus(salesResult, sessionsResult);
-            const currency = this.extractCurrency();
-            const metrics = {
-                fetchedAt: new Date().toISOString(),
-                currency,
-                months,
-                fetchStatus,
-            };
-            helpers_1.Logger.info('safeGetHistoricalMetrics: completed', {
-                ...logMeta,
-                fetchStatus,
-                monthsCount: months.length,
-                hasSalesData: salesByMonth.size > 0,
-                hasSessionsData: sessionsByMonth.size > 0,
-            });
-            return metrics;
-        }
-        catch (error) {
-            helpers_1.Logger.warn('safeGetHistoricalMetrics: failed, returning empty metrics', {
-                error,
-                errorMessage: error instanceof Error ? error.message : String(error),
-                ...logMeta,
-            });
-            return this.buildEmptyMetrics();
-        }
-    };
-    static executeSafeShopifyQLQuery = async (client, query, shop, queryType) => {
-        try {
-            const result = await client.request(graphql_analytics_queries_1.graphqlShopifyQLQuery, {
-                variables: { query },
-            });
-            if (result?.errors) {
-                helpers_1.Logger.warn('executeSafeShopifyQLQuery: GraphQL errors', {
-                    errors: result.errors,
-                    shop,
-                    queryType,
-                });
-                return null;
-            }
-            const parseErrors = result?.data?.shopifyqlQuery?.parseErrors;
-            if (parseErrors && parseErrors.length > 0) {
-                helpers_1.Logger.warn('executeSafeShopifyQLQuery: ShopifyQL parse errors', {
-                    parseErrors,
-                    shop,
-                    queryType,
-                });
-                return null;
-            }
-            return result?.data ?? null;
-        }
-        catch (error) {
-            helpers_1.Logger.warn('executeSafeShopifyQLQuery: failed', {
-                error,
-                errorMessage: error instanceof Error ? error.message : String(error),
-                shop,
-                queryType,
-            });
-            return null;
-        }
-    };
-    static parseSalesMetrics = (result) => {
-        const metricsMap = new Map();
-        const tableData = result?.shopifyqlQuery?.tableData;
-        if (!tableData)
-            return metricsMap;
-        const columns = tableData.columns ?? [];
-        const rows = tableData.rowData ?? tableData.rows ?? [];
-        const monthIdx = columns.findIndex((c) => c.name === 'month');
-        const totalSalesIdx = columns.findIndex((c) => c.name === 'total_sales');
-        const ordersIdx = columns.findIndex((c) => c.name === 'orders');
-        const aovIdx = columns.findIndex((c) => c.name === 'average_order_value');
-        for (const row of rows) {
-            const rowData = this.extractRowData(row, columns);
-            const month = this.formatMonthKey(rowData[monthIdx]);
-            if (!month)
-                continue;
-            metricsMap.set(month, {
-                month,
-                totalSales: this.safeParseFloat(rowData[totalSalesIdx]),
-                orderCount: this.safeParseInt(rowData[ordersIdx]),
-                averageOrderValue: this.safeParseFloat(rowData[aovIdx]),
-            });
-        }
-        return metricsMap;
-    };
-    static parseSessionsMetrics = (result) => {
-        const metricsMap = new Map();
-        const tableData = result?.shopifyqlQuery?.tableData;
-        if (!tableData)
-            return metricsMap;
-        const columns = tableData.columns ?? [];
-        const rows = tableData.rowData ?? tableData.rows ?? [];
-        const monthIdx = columns.findIndex((c) => c.name === 'month');
-        const sessionsIdx = columns.findIndex((c) => c.name === 'sessions');
-        const visitorsIdx = columns.findIndex((c) => c.name === 'online_store_visitors');
-        for (const row of rows) {
-            const rowData = this.extractRowData(row, columns);
-            const month = this.formatMonthKey(rowData[monthIdx]);
-            if (!month)
-                continue;
-            metricsMap.set(month, {
-                month,
-                sessionCount: this.safeParseInt(rowData[sessionsIdx]),
-                visitorCount: this.safeParseInt(rowData[visitorsIdx]),
-            });
-        }
-        return metricsMap;
-    };
-    static extractRowData = (row, columns) => {
-        if (Array.isArray(row)) {
-            return row;
-        }
-        return columns.map((col) => row[col.name] ?? '');
-    };
-    static mergeMonthlyMetrics = (salesByMonth, sessionsByMonth) => {
-        const allMonths = new Set([...salesByMonth.keys(), ...sessionsByMonth.keys()]);
-        return Array.from(allMonths)
-            .sort()
-            .map((month) => {
-            const sales = salesByMonth.get(month) ?? {};
-            const sessions = sessionsByMonth.get(month) ?? {};
-            return {
-                month,
-                totalSales: sales.totalSales,
-                orderCount: sales.orderCount,
-                averageOrderValue: sales.averageOrderValue,
-                sessionCount: sessions.sessionCount,
-                visitorCount: sessions.visitorCount,
-            };
-        });
-    };
-    static determineFetchStatus = (salesResult, sessionsResult) => {
-        const hasSales = !!salesResult?.shopifyqlQuery?.tableData;
-        const hasSessions = !!sessionsResult?.shopifyqlQuery?.tableData;
-        if (hasSales && hasSessions) {
-            return SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS.SUCCESS;
-        }
-        if (hasSales || hasSessions) {
-            return SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS.PARTIAL;
-        }
-        return SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS.FAILED;
-    };
-    static extractCurrency = () => {
-        return undefined;
-    };
-    static formatMonthKey = (value) => {
-        if (!value)
-            return undefined;
-        const match = value.match(/^(\d{4}-\d{2})/);
-        return match?.[1];
-    };
-    static safeParseFloat = (value) => {
-        if (!value)
-            return undefined;
-        const parsed = parseFloat(value);
-        return Number.isNaN(parsed) ? undefined : parsed;
-    };
-    static safeParseInt = (value) => {
-        if (!value)
-            return undefined;
-        const parsed = parseInt(value, 10);
-        return Number.isNaN(parsed) ? undefined : parsed;
-    };
-    static buildEmptyMetrics = () => ({
-        fetchedAt: new Date().toISOString(),
-        currency: undefined,
-        months: [],
-        fetchStatus: SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS.FAILED,
-    });
-}
-exports.ShopifyGraphQLClient = ShopifyGraphQLClient;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShopifyGraphQLClient = void 0;
+const admin_api_client_1 = require("@shopify/admin-api-client");
+const helpers_1 = require("../../../helpers");
+const graphql_product_queries_1 = require("./graphql-product-queries");
+const graphql_order_queries_1 = require("./graphql-order-queries");
+const graphql_analytics_queries_1 = require("./graphql-analytics-queries");
+var SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS;
+(function (SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS) {
+    SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS["SUCCESS"] = "success";
+    SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS["PARTIAL"] = "partial";
+    SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS["FAILED"] = "failed";
+})(SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS || (SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS = {}));
+class ShopifyGraphQLClient {
+    static _shopify_api_version = process.env.SHOPIFY_API_VERSION;
+    static getClient = (shop, accessToken) => {
+        const client = (0, admin_api_client_1.createAdminApiClient)({
+            storeDomain: shop,
+            accessToken: accessToken,
+            apiVersion: this._shopify_api_version,
+            retries: 1,
+        });
+        return client;
+    };
+    static getProductWithVariantsGraphQL = async (shop, accessToken, productId, pageSize = 100) => {
+        try {
+            const client = this.getClient(shop, accessToken);
+            const result = await this.executePagedProductQuery(client, productId, pageSize, null);
+            return result;
+        }
+        catch (error) {
+            helpers_1.Logger.error('Failed getProductWithVariantsGraphQL', {
+                error,
+                shop,
+                accessToken,
+                productId,
+            });
+            throw error;
+        }
+    };
+    static executePagedProductQuery = async (client, productId, pageSize, cursor) => {
+        try {
+            let result = {};
+            let product = null;
+            const allVariants = [];
+            let hasNextPage = false;
+            do {
+                helpers_1.Logger.debug('executePagedProductQuery', { productId, pageSize, cursor });
+                result = await this.executeProductQuery(client, productId, pageSize, cursor ?? null);
+                if (result?.errors) {
+                    helpers_1.Logger.error('executePagedProductQuery: Failed to execute product query', {
+                        result,
+                        shop: client.config.storeDomain,
+                        productId,
+                        accessToken: client.config.accessToken,
+                    });
+                    break;
+                }
+                else if (result?.data?.product) {
+                    product = result.data.product;
+                    allVariants.push(...(product?.variants?.nodes ?? []));
+                    hasNextPage = product?.variants?.pageInfo?.hasNextPage;
+                    cursor = product?.variants?.pageInfo?.endCursor;
+                }
+                if (hasNextPage) {
+                    helpers_1.Logger.info('executePagedProductQuery: hasNextPage product variants', {
+                        hasNextPage,
+                        shop: client.config.storeDomain,
+                        productId,
+                        accessToken: client.config.accessToken,
+                    });
+                }
+            } while (hasNextPage);
+            if (product) {
+                product.variants.nodes = allVariants;
+                result.data = result?.data ?? {};
+                result.data.product = product;
+            }
+            return result;
+        }
+        catch (error) {
+            helpers_1.Logger.error('executePagedProductQuery:Failed to execute paged product query', {
+                error,
+                shop: client.config.storeDomain,
+                productId,
+                accessToken: client.config.accessToken,
+            });
+            throw error;
+        }
+    };
+    static executeProductQuery = async (client, productId, pageSize, cursor) => {
+        try {
+            const result = await client.request(graphql_product_queries_1.graphqlProductQueryByProductId, {
+                variables: {
+                    id: `gid://shopify/Product/${productId}`,
+                    first: pageSize,
+                    after: cursor,
+                },
+            });
+            if (result?.errors) {
+                helpers_1.Logger.error('Failed to executeProductQuery -- response errors', {
+                    result,
+                    responseErrors: result.errors,
+                    shop: client.config.storeDomain,
+                    productId,
+                    cursor,
+                });
+            }
+            return result;
+        }
+        catch (error) {
+            helpers_1.Logger.error('Failed to executeProductQuery -- exception', {
+                error,
+                shop: client.config.storeDomain,
+                productId,
+                accessToken: client.config.accessToken,
+            });
+            return {};
+        }
+    };
+    static getOrderLineItemsSellingPlan = async (shop, accessToken, orderId) => {
+        try {
+            const client = this.getClient(shop, accessToken);
+            const result = await client.request(graphql_order_queries_1.graphqlOrderLineItemsSellingPlanQuery, {
+                variables: {
+                    id: `gid://shopify/Order/${orderId}`,
+                },
+            });
+            if (result?.errors) {
+                helpers_1.Logger.error('getOrderLineItemsSellingPlan: GraphQL errors', {
+                    errors: result.errors,
+                    shop,
+                    orderId,
+                });
+                return null;
+            }
+            const lineItems = result?.data?.order?.lineItems?.nodes;
+            if (!lineItems || lineItems.length === 0) {
+                helpers_1.Logger.debug('getOrderLineItemsSellingPlan: no line items found', { shop, orderId });
+                return new Map();
+            }
+            const sellingPlanMap = new Map();
+            for (const lineItem of lineItems) {
+                const variantLegacyId = lineItem.variant?.legacyResourceId;
+                const sellingPlanId = lineItem.sellingPlan?.sellingPlanId;
+                if (variantLegacyId && sellingPlanId) {
+                    sellingPlanMap.set(variantLegacyId, sellingPlanId);
+                }
+            }
+            helpers_1.Logger.debug('getOrderLineItemsSellingPlan: success', {
+                shop,
+                orderId,
+                sellingPlanCount: sellingPlanMap.size,
+            });
+            return sellingPlanMap;
+        }
+        catch (error) {
+            helpers_1.Logger.error('getOrderLineItemsSellingPlan: failed', {
+                error,
+                shop,
+                orderId,
+            });
+            return null;
+        }
+    };
+    static safeGetHistoricalMetrics = async (shop, accessToken, monthsBack = 12) => {
+        const logMeta = { shop, monthsBack };
+        try {
+            if (!shop || !accessToken) {
+                helpers_1.Logger.warn('safeGetHistoricalMetrics: missing shop or accessToken', logMeta);
+                return this.buildEmptyMetrics();
+            }
+            const client = this.getClient(shop, accessToken);
+            const [salesResult, sessionsResult] = await Promise.all([
+                this.executeSafeShopifyQLQuery(client, graphql_analytics_queries_1.SHOPIFYQL_QUERIES.SALES_MONTHLY(monthsBack), shop, 'sales'),
+                this.executeSafeShopifyQLQuery(client, graphql_analytics_queries_1.SHOPIFYQL_QUERIES.SESSIONS_MONTHLY(monthsBack), shop, 'sessions'),
+            ]);
+            const salesByMonth = this.parseSalesMetrics(salesResult);
+            const sessionsByMonth = this.parseSessionsMetrics(sessionsResult);
+            const months = this.mergeMonthlyMetrics(salesByMonth, sessionsByMonth);
+            const fetchStatus = this.determineFetchStatus(salesResult, sessionsResult);
+            const currency = this.extractCurrency();
+            const metrics = {
+                fetchedAt: new Date().toISOString(),
+                currency,
+                months,
+                fetchStatus,
+            };
+            helpers_1.Logger.info('safeGetHistoricalMetrics: completed', {
+                ...logMeta,
+                fetchStatus,
+                monthsCount: months.length,
+                hasSalesData: salesByMonth.size > 0,
+                hasSessionsData: sessionsByMonth.size > 0,
+            });
+            return metrics;
+        }
+        catch (error) {
+            helpers_1.Logger.warn('safeGetHistoricalMetrics: failed, returning empty metrics', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                ...logMeta,
+            });
+            return this.buildEmptyMetrics();
+        }
+    };
+    static executeSafeShopifyQLQuery = async (client, query, shop, queryType) => {
+        try {
+            const result = await client.request(graphql_analytics_queries_1.graphqlShopifyQLQuery, {
+                variables: { query },
+            });
+            if (result?.errors) {
+                helpers_1.Logger.warn('executeSafeShopifyQLQuery: GraphQL errors', {
+                    errors: result.errors,
+                    shop,
+                    queryType,
+                });
+                return null;
+            }
+            const parseErrors = result?.data?.shopifyqlQuery?.parseErrors;
+            if (parseErrors && parseErrors.length > 0) {
+                helpers_1.Logger.warn('executeSafeShopifyQLQuery: ShopifyQL parse errors', {
+                    parseErrors,
+                    shop,
+                    queryType,
+                });
+                return null;
+            }
+            return result?.data ?? null;
+        }
+        catch (error) {
+            helpers_1.Logger.warn('executeSafeShopifyQLQuery: failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                shop,
+                queryType,
+            });
+            return null;
+        }
+    };
+    static parseSalesMetrics = (result) => {
+        const metricsMap = new Map();
+        const tableData = result?.shopifyqlQuery?.tableData;
+        if (!tableData)
+            return metricsMap;
+        const columns = tableData.columns ?? [];
+        const rows = tableData.rowData ?? tableData.rows ?? [];
+        const monthIdx = columns.findIndex((c) => c.name === 'month');
+        const totalSalesIdx = columns.findIndex((c) => c.name === 'total_sales');
+        const ordersIdx = columns.findIndex((c) => c.name === 'orders');
+        const aovIdx = columns.findIndex((c) => c.name === 'average_order_value');
+        for (const row of rows) {
+            const rowData = this.extractRowData(row, columns);
+            const month = this.formatMonthKey(rowData[monthIdx]);
+            if (!month)
+                continue;
+            metricsMap.set(month, {
+                month,
+                totalSales: this.safeParseFloat(rowData[totalSalesIdx]),
+                orderCount: this.safeParseInt(rowData[ordersIdx]),
+                averageOrderValue: this.safeParseFloat(rowData[aovIdx]),
+            });
+        }
+        return metricsMap;
+    };
+    static parseSessionsMetrics = (result) => {
+        const metricsMap = new Map();
+        const tableData = result?.shopifyqlQuery?.tableData;
+        if (!tableData)
+            return metricsMap;
+        const columns = tableData.columns ?? [];
+        const rows = tableData.rowData ?? tableData.rows ?? [];
+        const monthIdx = columns.findIndex((c) => c.name === 'month');
+        const sessionsIdx = columns.findIndex((c) => c.name === 'sessions');
+        const visitorsIdx = columns.findIndex((c) => c.name === 'online_store_visitors');
+        for (const row of rows) {
+            const rowData = this.extractRowData(row, columns);
+            const month = this.formatMonthKey(rowData[monthIdx]);
+            if (!month)
+                continue;
+            metricsMap.set(month, {
+                month,
+                sessionCount: this.safeParseInt(rowData[sessionsIdx]),
+                visitorCount: this.safeParseInt(rowData[visitorsIdx]),
+            });
+        }
+        return metricsMap;
+    };
+    static extractRowData = (row, columns) => {
+        if (Array.isArray(row)) {
+            return row;
+        }
+        return columns.map((col) => row[col.name] ?? '');
+    };
+    static mergeMonthlyMetrics = (salesByMonth, sessionsByMonth) => {
+        const allMonths = new Set([...salesByMonth.keys(), ...sessionsByMonth.keys()]);
+        return Array.from(allMonths)
+            .sort()
+            .map((month) => {
+            const sales = salesByMonth.get(month) ?? {};
+            const sessions = sessionsByMonth.get(month) ?? {};
+            return {
+                month,
+                totalSales: sales.totalSales,
+                orderCount: sales.orderCount,
+                averageOrderValue: sales.averageOrderValue,
+                sessionCount: sessions.sessionCount,
+                visitorCount: sessions.visitorCount,
+            };
+        });
+    };
+    static determineFetchStatus = (salesResult, sessionsResult) => {
+        const hasSales = !!salesResult?.shopifyqlQuery?.tableData;
+        const hasSessions = !!sessionsResult?.shopifyqlQuery?.tableData;
+        if (hasSales && hasSessions) {
+            return SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS.SUCCESS;
+        }
+        if (hasSales || hasSessions) {
+            return SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS.PARTIAL;
+        }
+        return SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS.FAILED;
+    };
+    static extractCurrency = () => {
+        return undefined;
+    };
+    static formatMonthKey = (value) => {
+        if (!value)
+            return undefined;
+        const match = value.match(/^(\d{4}-\d{2})/);
+        return match?.[1];
+    };
+    static safeParseFloat = (value) => {
+        if (!value)
+            return undefined;
+        const parsed = parseFloat(value);
+        return Number.isNaN(parsed) ? undefined : parsed;
+    };
+    static safeParseInt = (value) => {
+        if (!value)
+            return undefined;
+        const parsed = parseInt(value, 10);
+        return Number.isNaN(parsed) ? undefined : parsed;
+    };
+    static buildEmptyMetrics = () => ({
+        fetchedAt: new Date().toISOString(),
+        currency: undefined,
+        months: [],
+        fetchStatus: SHOPIFY_HISTORICAL_METRICS_FETCH_STATUS.FAILED,
+    });
+}
+exports.ShopifyGraphQLClient = ShopifyGraphQLClient;
 //# sourceMappingURL=shopify-graphql-client.js.map