dtc-mcp 0.1.0

package/dist/platforms/shopify/client.js

@@ -0,0 +1,366 @@
+import { config, log } from "../../config.js";
+import { ShopifyApiError } from "../../shared/errors.js";
+import { TTLCache } from "../../shared/cache.js";
+const cache = new TTLCache(5 * 60 * 1000); // 5-minute TTL
+// ---- Token Manager (Client Credentials Grant) ----
+class ShopifyTokenManager {
+    accessToken = null;
+    expiresAt = 0;
+    async getAccessToken() {
+        // Legacy mode: return static token directly
+        if (config.shopifyAuthMode === "legacy") {
+            return config.shopifyAccessToken;
+        }
+        // Client credentials mode: use cached token if still valid
+        if (this.accessToken && Date.now() < this.expiresAt - 60_000) {
+            return this.accessToken;
+        }
+        return this.refreshToken();
+    }
+    async refreshToken() {
+        log("info", "Acquiring Shopify access token via Client Credentials Grant");
+        const url = `https://${config.shopifyStore}/admin/oauth/access_token`;
+        const body = new URLSearchParams({
+            grant_type: "client_credentials",
+            client_id: config.shopifyClientId,
+            client_secret: config.shopifyClientSecret,
+        });
+        const response = await fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/x-www-form-urlencoded" },
+            body: body.toString(),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new ShopifyApiError(`Token request failed (${response.status}): ${text}`);
+        }
+        const data = (await response.json());
+        this.accessToken = data.access_token;
+        this.expiresAt = Date.now() + data.expires_in * 1000;
+        log("info", "Shopify access token acquired", {
+            expiresIn: `${Math.round(data.expires_in / 3600)}h`,
+        });
+        return this.accessToken;
+    }
+}
+const tokenManager = new ShopifyTokenManager();
+// ---- Cost-based Rate Limiting ----
+class CostTracker {
+    availablePoints = 1000;
+    lastUpdated = Date.now();
+    restoreRate = 50; // points per second
+    async waitForCapacity(estimatedCost) {
+        this.restorePoints();
+        if (this.availablePoints >= estimatedCost)
+            return;
+        const deficit = estimatedCost - this.availablePoints;
+        const waitMs = (deficit / this.restoreRate) * 1000 + 100;
+        log("debug", `Shopify rate limit: waiting ${Math.round(waitMs)}ms for ${deficit} points`);
+        await new Promise((resolve) => setTimeout(resolve, waitMs));
+        this.restorePoints();
+    }
+    updateFromResponse(extensions) {
+        if (extensions?.cost?.throttleStatus?.currentlyAvailable !== undefined) {
+            this.availablePoints = extensions.cost.throttleStatus.currentlyAvailable;
+            this.lastUpdated = Date.now();
+        }
+    }
+    restorePoints() {
+        const elapsed = (Date.now() - this.lastUpdated) / 1000;
+        this.availablePoints = Math.min(1000, this.availablePoints + elapsed * this.restoreRate);
+        this.lastUpdated = Date.now();
+    }
+}
+const costTracker = new CostTracker();
+// ---- GraphQL Client ----
+function getEndpoint() {
+    return `https://${config.shopifyStore}/admin/api/${config.shopifyApiVersion}/graphql.json`;
+}
+async function buildHeaders() {
+    return {
+        "Content-Type": "application/json",
+        "X-Shopify-Access-Token": await tokenManager.getAccessToken(),
+    };
+}
+/**
+ * Execute a GraphQL query against Shopify Admin API.
+ */
+export async function shopifyQuery(query, variables, estimatedCost = 10) {
+    await costTracker.waitForCapacity(estimatedCost);
+    const response = await fetchWithRetry(query, variables);
+    const json = (await response.json());
+    costTracker.updateFromResponse(json.extensions);
+    if (json.errors?.length) {
+        const throttled = json.errors.find((e) => e.extensions?.code === "THROTTLED");
+        if (throttled) {
+            // Wait and retry once
+            log("debug", "Shopify THROTTLED, retrying...");
+            await new Promise((resolve) => setTimeout(resolve, 2000));
+            return shopifyQuery(query, variables, estimatedCost);
+        }
+        throw new ShopifyApiError(json.errors.map((e) => e.message).join("; "));
+    }
+    if (!json.data) {
+        throw new ShopifyApiError("No data in GraphQL response");
+    }
+    return json.data;
+}
+async function fetchWithRetry(query, variables, maxRetries = 3) {
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            const response = await fetch(getEndpoint(), {
+                method: "POST",
+                headers: await buildHeaders(),
+                body: JSON.stringify({ query, variables }),
+            });
+            if (response.status === 429) {
+                const retryAfter = response.headers.get("Retry-After");
+                const waitMs = retryAfter ? parseInt(retryAfter) * 1000 : 2000;
+                log("debug", `Shopify 429, waiting ${waitMs}ms`);
+                await new Promise((resolve) => setTimeout(resolve, waitMs));
+                continue;
+            }
+            if (!response.ok) {
+                throw new ShopifyApiError(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            return response;
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt < maxRetries) {
+                const backoff = Math.pow(2, attempt) * 1000;
+                await new Promise((resolve) => setTimeout(resolve, backoff));
+            }
+        }
+    }
+    throw lastError;
+}
+/**
+ * Execute a ShopifyQL query for pre-aggregated analytics data.
+ */
+export async function shopifyqlQuery(ql) {
+    const cacheKey = `shopifyql:${ql}`;
+    const cached = cache.get(cacheKey);
+    if (cached)
+        return cached;
+    const query = `
+    query ShopifyQL($query: String!) {
+      shopifyqlQuery(query: $query) {
+        tableData {
+          columns {
+            name
+            dataType
+            displayName
+          }
+          rows
+        }
+        parseErrors
+      }
+    }
+  `;
+    const data = await shopifyQuery(query, { query: ql }, 5);
+    if (data.shopifyqlQuery.parseErrors?.length) {
+        throw new ShopifyApiError(`ShopifyQL parse error: ${data.shopifyqlQuery.parseErrors.join(", ")}`);
+    }
+    if (!data.shopifyqlQuery.tableData) {
+        throw new ShopifyApiError("No table data in ShopifyQL response");
+    }
+    const result = {
+        columns: data.shopifyqlQuery.tableData.columns,
+        rows: data.shopifyqlQuery.tableData.rows,
+    };
+    cache.set(cacheKey, result);
+    return result;
+}
+// ---- Store Timezone ----
+let storeTimezoneCache = null;
+export async function getStoreTimezone() {
+    if (storeTimezoneCache)
+        return storeTimezoneCache;
+    const data = await shopifyQuery(`{ shop { ianaTimezone } }`, undefined, 1);
+    storeTimezoneCache = data.shop.ianaTimezone;
+    log("debug", "Store timezone", { tz: storeTimezoneCache });
+    return storeTimezoneCache;
+}
+/**
+ * Get a YYYY-MM-DD date string in the store's timezone, offset by N days from today.
+ */
+function dateInTimezone(tz, offsetDays) {
+    const date = new Date();
+    date.setDate(date.getDate() - offsetDays);
+    // en-CA locale gives YYYY-MM-DD format
+    return date.toLocaleDateString("en-CA", { timeZone: tz });
+}
+export async function getAggregatedSales(days) {
+    const tz = await getStoreTimezone();
+    // Try ShopifyQL first (fast, single API call, server-side aggregation)
+    try {
+        const ql = `FROM orders SHOW sum(gross_sales) AS gross_revenue, sum(net_sales) AS net_revenue, count() AS order_count SINCE -${days}d UNTIL today WITH TIMEZONE ${tz}`;
+        const result = await shopifyqlQuery(ql);
+        if (result.rows?.length) {
+            let grossRevenue = 0;
+            let netRevenue = 0;
+            let orderCount = 0;
+            for (let i = 0; i < result.columns.length; i++) {
+                const col = result.columns[i].name.toLowerCase();
+                if (col.includes("gross_revenue") || col.includes("gross_sales")) {
+                    grossRevenue = parseFloat(result.rows[0][i]) || 0;
+                }
+                if (col.includes("net_revenue") || col.includes("net_sales")) {
+                    netRevenue = parseFloat(result.rows[0][i]) || 0;
+                }
+                if (col.includes("order_count") || col.includes("count")) {
+                    orderCount = parseInt(result.rows[0][i]) || 0;
+                }
+            }
+            return { grossRevenue, netRevenue, orderCount, source: "shopifyql" };
+        }
+    }
+    catch (error) {
+        log("debug", "ShopifyQL unavailable, falling back to GraphQL orders", {
+            error: String(error),
+        });
+    }
+    // Fallback: paginate orders via GraphQL and sum client-side
+    const sinceDate = dateInTimezone(tz, days);
+    const query = `
+    query($first: Int!, $after: String, $queryStr: String!) {
+      orders(first: $first, after: $after, query: $queryStr, sortKey: CREATED_AT) {
+        nodes {
+          subtotalPriceSet { shopMoney { amount } }
+          currentSubtotalPriceSet { shopMoney { amount } }
+        }
+        pageInfo { hasNextPage endCursor }
+      }
+    }
+  `;
+    const orders = await paginateGraphQL(query, {
+        first: 250,
+        queryStr: `created_at:>=${sinceDate} -status:cancelled`,
+    }, (data) => {
+        const o = data.orders;
+        return { nodes: o.nodes, pageInfo: o.pageInfo };
+    }, 10);
+    let grossRevenue = 0;
+    let netRevenue = 0;
+    for (const order of orders) {
+        grossRevenue += parseFloat(order.subtotalPriceSet.shopMoney.amount) || 0;
+        netRevenue += parseFloat(order.currentSubtotalPriceSet.shopMoney.amount) || 0;
+    }
+    return {
+        grossRevenue: Math.round(grossRevenue * 100) / 100,
+        netRevenue: Math.round(netRevenue * 100) / 100,
+        orderCount: orders.length,
+        source: "graphql_orders",
+    };
+}
+const SHOPIFYQL_GROUP = {
+    daily: "day",
+    weekly: "week",
+    monthly: "month",
+};
+/**
+ * Get sales data broken down by day, week, or month.
+ */
+export async function getTimeSeriesSales(days, granularity) {
+    const tz = await getStoreTimezone();
+    // Try ShopifyQL first (server-side aggregation)
+    try {
+        const groupBy = SHOPIFYQL_GROUP[granularity];
+        const ql = `FROM orders SHOW sum(gross_sales) AS gross_revenue, sum(net_sales) AS net_revenue, count() AS order_count GROUP BY ${groupBy} SINCE -${days}d UNTIL today WITH TIMEZONE ${tz}`;
+        const result = await shopifyqlQuery(ql);
+        if (result.rows?.length) {
+            const dateIdx = result.columns.findIndex((c) => ["day", "week", "month"].includes(c.name.toLowerCase()));
+            const grossIdx = result.columns.findIndex((c) => c.name.toLowerCase().includes("gross_revenue") || c.name.toLowerCase().includes("gross_sales"));
+            const netIdx = result.columns.findIndex((c) => c.name.toLowerCase().includes("net_revenue") || c.name.toLowerCase().includes("net_sales"));
+            const countIdx = result.columns.findIndex((c) => c.name.toLowerCase().includes("order_count") || c.name.toLowerCase().includes("count"));
+            const buckets = result.rows.map((row) => ({
+                date: row[dateIdx] ?? "",
+                grossRevenue: parseFloat(row[grossIdx]) || 0,
+                netRevenue: parseFloat(row[netIdx]) || 0,
+                orderCount: parseInt(row[countIdx]) || 0,
+            }));
+            buckets.sort((a, b) => a.date.localeCompare(b.date));
+            return { buckets, source: "shopifyql" };
+        }
+    }
+    catch (error) {
+        log("debug", "ShopifyQL unavailable for time-series, falling back to GraphQL", {
+            error: String(error),
+        });
+    }
+    // Fallback: paginate orders and bucket client-side
+    const sinceDate = dateInTimezone(tz, days);
+    const query = `
+    query($first: Int!, $after: String, $queryStr: String!) {
+      orders(first: $first, after: $after, query: $queryStr, sortKey: CREATED_AT) {
+        nodes {
+          createdAt
+          subtotalPriceSet { shopMoney { amount } }
+          currentSubtotalPriceSet { shopMoney { amount } }
+        }
+        pageInfo { hasNextPage endCursor }
+      }
+    }
+  `;
+    const orders = await paginateGraphQL(query, {
+        first: 250,
+        queryStr: `created_at:>=${sinceDate} -status:cancelled`,
+    }, (data) => {
+        const o = data.orders;
+        return { nodes: o.nodes, pageInfo: o.pageInfo };
+    }, 10);
+    // Group into buckets
+    const bucketMap = new Map();
+    for (const order of orders) {
+        const key = bucketKey(order.createdAt, granularity, tz);
+        const existing = bucketMap.get(key) ?? { grossRevenue: 0, netRevenue: 0, orderCount: 0 };
+        existing.grossRevenue += parseFloat(order.subtotalPriceSet.shopMoney.amount) || 0;
+        existing.netRevenue += parseFloat(order.currentSubtotalPriceSet.shopMoney.amount) || 0;
+        existing.orderCount += 1;
+        bucketMap.set(key, existing);
+    }
+    const buckets = Array.from(bucketMap.entries())
+        .map(([date, data]) => ({
+        date,
+        grossRevenue: data.grossRevenue,
+        netRevenue: data.netRevenue,
+        orderCount: data.orderCount,
+    }))
+        .sort((a, b) => a.date.localeCompare(b.date));
+    return { buckets, source: "graphql_orders" };
+}
+function bucketKey(createdAt, granularity, tz) {
+    const dateStr = new Date(createdAt).toLocaleDateString("en-CA", { timeZone: tz });
+    if (granularity === "daily")
+        return dateStr;
+    if (granularity === "monthly")
+        return dateStr.substring(0, 7);
+    // weekly: find Monday of that week
+    const d = new Date(dateStr + "T12:00:00Z");
+    const day = d.getUTCDay();
+    const diff = day === 0 ? -6 : 1 - day;
+    d.setUTCDate(d.getUTCDate() + diff);
+    return d.toISOString().substring(0, 10);
+}
+/**
+ * Auto-paginate a Shopify GraphQL query.
+ */
+export async function paginateGraphQL(query, variables, extractPage, maxPages = 5, estimatedCostPerPage = 10) {
+    const allItems = [];
+    let cursor = null;
+    let pages = 0;
+    while (pages < maxPages) {
+        const vars = { ...variables, after: cursor };
+        const data = await shopifyQuery(query, vars, estimatedCostPerPage);
+        const page = extractPage(data);
+        allItems.push(...page.nodes);
+        pages++;
+        if (!page.pageInfo.hasNextPage || !page.pageInfo.endCursor)
+            break;
+        cursor = page.pageInfo.endCursor;
+    }
+    return allItems;
+}
+//# sourceMappingURL=client.js.map

package/dist/platforms/shopify/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/platforms/shopify/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAU,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe;AAEnE,qDAAqD;AAErD,MAAM,mBAAmB;IACf,WAAW,GAAkB,IAAI,CAAC;IAClC,SAAS,GAAG,CAAC,CAAC;IAEtB,KAAK,CAAC,cAAc;QAClB,4CAA4C;QAC5C,IAAI,MAAM,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;YACxC,OAAO,MAAM,CAAC,kBAAmB,CAAC;QACpC,CAAC;QAED,2DAA2D;QAC3D,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,GAAG,MAAM,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC,WAAW,CAAC;QAC1B,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;IAC7B,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,GAAG,CAAC,MAAM,EAAE,6DAA6D,CAAC,CAAC;QAE3E,MAAM,GAAG,GAAG,WAAW,MAAM,CAAC,YAAY,2BAA2B,CAAC;QACtE,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC;YAC/B,UAAU,EAAE,oBAAoB;YAChC,SAAS,EAAE,MAAM,CAAC,eAAgB;YAClC,aAAa,EAAE,MAAM,CAAC,mBAAoB;SAC3C,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE;YAChE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;SACtB,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,eAAe,CACvB,yBAAyB,QAAQ,CAAC,MAAM,MAAM,IAAI,EAAE,CACrD,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAGlC,CAAC;QAEF,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACrD,GAAG,CAAC,MAAM,EAAE,+BAA+B,EAAE;YAC3C,SAAS,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG;SACpD,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,YAAY,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAE/C,qCAAqC;AAErC,MAAM,WAAW;IACP,eAAe,GAAG,IAAI,CAAC;IACvB,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAChB,WAAW,GAAG,EAAE,CAAC,CAAC,oBAAoB;IAEvD,KAAK,CAAC,eAAe,CAAC,aAAqB;QACzC,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,IAAI,IAAI,CAAC,eAAe,IAAI,aAAa;YAAE,OAAO;QAElD,MAAM,OAAO,GAAG,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC;QACrD,MAAM,MAAM,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC;QACzD,GAAG,CAAC,OAAO,EAAE,+BAA+B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,OAAO,SAAS,CAAC,CAAC;QAC1F,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED,kBAAkB,CAAC,UAMlB;QACC,IAAI,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,kBAAkB,KAAK,SAAS,EAAE,CAAC;YACvE,IAAI,CAAC,eAAe,GAAG,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC;YACzE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;QACvD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,CAC7B,IAAI,EACJ,IAAI,CAAC,eAAe,GAAG,OAAO,GAAG,IAAI,CAAC,WAAW,CAClD,CAAC;QACF,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAChC,CAAC;CACF;AAED,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;AAEtC,2BAA2B;AAE3B,SAAS,WAAW;IAClB,OAAO,WAAW,MAAM,CAAC,YAAY,cAAc,MAAM,CAAC,iBAAiB,eAAe,CAAC;AAC7F,CAAC;AAED,KAAK,UAAU,YAAY;IACzB,OAAO;QACL,cAAc,EAAE,kBAAkB;QAClC,wBAAwB,EAAE,MAAM,YAAY,CAAC,cAAc,EAAE;KAC9D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAa,EACb,SAAmC,EACnC,aAAa,GAAG,EAAE;IAElB,MAAM,WAAW,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;IAEjD,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAUlC,CAAC;IAEF,WAAW,CAAC,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEhD,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,IAAI,KAAK,WAAW,CAC1C,CAAC;QACF,IAAI,SAAS,EAAE,CAAC;YACd,sBAAsB;YACtB,GAAG,CAAC,OAAO,EAAE,gCAAgC,CAAC,CAAC;YAC/C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;YAC1D,OAAO,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,IAAI,eAAe,CACvB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC7C,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,eAAe,CAAC,6BAA6B,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,KAAa,EACb,SAAmC,EACnC,UAAU,GAAG,CAAC;IAEd,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,WAAW,EAAE,EAAE;gBAC1C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,MAAM,YAAY,EAAE;gBAC7B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;aAC3C,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;gBACvD,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;gBAC/D,GAAG,CAAC,OAAO,EAAE,wBAAwB,MAAM,IAAI,CAAC,CAAC;gBACjD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;gBAC5D,SAAS;YACX,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,eAAe,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAC/E,CAAC;YAED,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAClB,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;gBACzB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;gBAC5C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC;AAeD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EAAU;IAC7C,MAAM,QAAQ,GAAG,aAAa,EAAE,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAgC,CAAC;IAClE,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,KAAK,GAAG;;;;;;;;;;;;;;GAcb,CAAC;IAEF,MAAM,IAAI,GAAG,MAAM,YAAY,CAK5B,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAE5B,IAAI,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;QAC5C,MAAM,IAAI,eAAe,CACvB,0BAA0B,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;QACnC,MAAM,IAAI,eAAe,CAAC,qCAAqC,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,MAAM,GAAoB;QAC9B,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,OAAO;QAC9C,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI;KACzC,CAAC;IAEF,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2BAA2B;AAE3B,IAAI,kBAAkB,GAAkB,IAAI,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,kBAAkB;QAAE,OAAO,kBAAkB,CAAC;IAElD,MAAM,IAAI,GAAG,MAAM,YAAY,CAC7B,2BAA2B,EAC3B,SAAS,EACT,CAAC,CACF,CAAC;IAEF,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;IAC5C,GAAG,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC3D,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,EAAU,EAAE,UAAkB;IACpD,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,CAAC;IAC1C,uCAAuC;IACvC,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;AAC5D,CAAC;AAMD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY;IAEZ,MAAM,EAAE,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAEpC,uEAAuE;IACvE,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,oHAAoH,IAAI,+BAA+B,EAAE,EAAE,CAAC;QACvK,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YACxB,IAAI,YAAY,GAAG,CAAC,CAAC;YACrB,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/C,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjD,IAAI,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;oBACjE,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACpD,CAAC;gBACD,IAAI,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC7D,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAClD,CAAC;gBACD,IAAI,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBACzD,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAChD,CAAC;YACH,CAAC;YACD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QACvE,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,OAAO,EAAE,uDAAuD,EAAE;YACpE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;SACrB,CAAC,CAAC;IACL,CAAC;IAED,4DAA4D;IAC5D,MAAM,SAAS,GAAG,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAG;;;;;;;;;;GAUb,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,eAAe,CAClC,KAAK,EACL;QACE,KAAK,EAAE,GAAG;QACV,QAAQ,EAAE,gBAAgB,SAAS,oBAAoB;KACxD,EACD,CAAC,IAAI,EAAE,EAAE;QACP,MAAM,CAAC,GAAG,IAAI,CAAC,MAGd,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAClD,CAAC,EACD,EAAE,CACH,CAAC;IAEF,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,MAAM,KAAK,IAAI,MAGlB,EAAE,CAAC;QACH,YAAY,IAAI,UAAU,CAAC,KAAK,CAAC,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzE,UAAU,IAAI,UAAU,CAAC,KAAK,CAAC,uBAAuB,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChF,CAAC;IAED,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,GAAG,CAAC,GAAG,GAAG;QAClD,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,GAAG;QAC9C,UAAU,EAAE,MAAM,CAAC,MAAM;QACzB,MAAM,EAAE,gBAAgB;KACzB,CAAC;AACJ,CAAC;AAaD,MAAM,eAAe,GAAgC;IACnD,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,OAAO;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,WAAwB;IAExB,MAAM,EAAE,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAEpC,gDAAgD;IAChD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QAC7C,MAAM,EAAE,GAAG,sHAAsH,OAAO,WAAW,IAAI,+BAA+B,EAAE,EAAE,CAAC;QAC3L,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,EAAE,CAAC,CAAC;QAExC,IAAI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAC7C,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CACxD,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9C,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAC/F,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5C,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAC3F,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9C,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CACvF,CAAC;YAEF,MAAM,OAAO,GAAqB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC1D,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE;gBACxB,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;gBAC5C,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;gBACxC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;aACzC,CAAC,CAAC,CAAC;YAEJ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACrD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAC1C,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,OAAO,EAAE,gEAAgE,EAAE;YAC7E,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;SACrB,CAAC,CAAC;IACL,CAAC;IAED,mDAAmD;IACnD,MAAM,SAAS,GAAG,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAG;;;;;;;;;;;GAWb,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,eAAe,CAClC,KAAK,EACL;QACE,KAAK,EAAE,GAAG;QACV,QAAQ,EAAE,gBAAgB,SAAS,oBAAoB;KACxD,EACD,CAAC,IAAI,EAAE,EAAE;QACP,MAAM,CAAC,GAAG,IAAI,CAAC,MAGd,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAClD,CAAC,EACD,EAAE,CACH,CAAC;IAEF,qBAAqB;IACrB,MAAM,SAAS,GAAG,IAAI,GAAG,EAA4E,CAAC;IAEtG,KAAK,MAAM,KAAK,IAAI,MAIlB,EAAE,CAAC;QACH,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QACzF,QAAQ,CAAC,YAAY,IAAI,UAAU,CAAC,KAAK,CAAC,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClF,QAAQ,CAAC,UAAU,IAAI,UAAU,CAAC,KAAK,CAAC,uBAAuB,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvF,QAAQ,CAAC,UAAU,IAAI,CAAC,CAAC;QACzB,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,OAAO,GAAqB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;SAC9D,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACtB,IAAI;QACJ,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;AAC/C,CAAC;AAED,SAAS,SAAS,CAAC,SAAiB,EAAE,WAAwB,EAAE,EAAU;IACxE,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IAClF,IAAI,WAAW,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5C,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9D,mCAAmC;IACnC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IACtC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IACpC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC;AASD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAa,EACb,SAAkC,EAClC,WAGC,EACD,QAAQ,GAAG,CAAC,EACZ,oBAAoB,GAAG,EAAE;IAEzB,MAAM,QAAQ,GAAQ,EAAE,CAAC;IACzB,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,OAAO,KAAK,GAAG,QAAQ,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,YAAY,CAC7B,KAAK,EACL,IAAI,EACJ,oBAAoB,CACrB,CAAC;QAEF,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS;YAAE,MAAM;QAClE,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;IACnC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/platforms/shopify/tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerShopifyTools(server: McpServer): void;

package/dist/platforms/shopify/tools.js

@@ -0,0 +1,253 @@
+import { z } from "zod";
+import { isShopifyConfigured } from "../../config.js";
+import { shopifyQuery, getAggregatedSales, getTimeSeriesSales, getStoreTimezone, paginateGraphQL, } from "./client.js";
+import { transformSalesSummary, transformSalesTimeSeries, transformProductPerformance, transformOrders, transformInventoryAlerts, transformCustomerCohort, transformRecentOrders, } from "./transforms.js";
+import { formatError, shopifyNotConfigured, toolResult, } from "../../shared/errors.js";
+export function registerShopifyTools(server) {
+    // ---- Tool 9: Sales Summary ----
+    server.tool("shopify_sales_summary", "Revenue, orders, AOV for a period with comparison.", {
+        days: z.number().min(1).max(90).default(30),
+        compare_previous: z
+            .boolean()
+            .default(true)
+            .describe("Include previous period comparison"),
+    }, async ({ days, compare_previous }) => {
+        if (!isShopifyConfigured())
+            return shopifyNotConfigured();
+        try {
+            const current = await getAggregatedSales(days);
+            let previous;
+            if (compare_previous) {
+                // Fetch double the range and subtract current to get previous period
+                const doublePeriod = await getAggregatedSales(days * 2);
+                previous = {
+                    grossRevenue: Math.max(0, doublePeriod.grossRevenue - current.grossRevenue),
+                    netRevenue: Math.max(0, doublePeriod.netRevenue - current.netRevenue),
+                    orderCount: Math.max(0, doublePeriod.orderCount - current.orderCount),
+                };
+            }
+            const result = transformSalesSummary(current, days, previous);
+            return toolResult({ ...result, data_source: current.source });
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // ---- Tool 10: Product Performance ----
+    server.tool("shopify_product_performance", "Top products by revenue or units. Default 7d — longer periods may be slow.", {
+        days: z.number().min(1).max(90).default(7),
+        metric: z.enum(["revenue", "units"]).default("revenue"),
+        limit: z.number().min(1).max(25).default(10),
+    }, async ({ days, metric, limit }) => {
+        if (!isShopifyConfigured())
+            return shopifyNotConfigured();
+        try {
+            const tz = await getStoreTimezone();
+            const sinceDate = new Date();
+            sinceDate.setDate(sinceDate.getDate() - days);
+            const sinceDateStr = sinceDate.toLocaleDateString("en-CA", { timeZone: tz });
+            const query = `
+          query($first: Int!, $after: String, $queryStr: String!) {
+            orders(first: $first, after: $after, query: $queryStr) {
+              nodes {
+                lineItems(first: 50) {
+                  nodes {
+                    name
+                    product { id title }
+                    quantity
+                    originalTotalSet { shopMoney { amount } }
+                  }
+                }
+              }
+              pageInfo { hasNextPage endCursor }
+            }
+          }
+        `;
+            const orders = await paginateGraphQL(query, {
+                first: 50,
+                queryStr: `created_at:>=${sinceDateStr}`,
+            }, (data) => {
+                const orders = data.orders;
+                return { nodes: orders.nodes, pageInfo: orders.pageInfo };
+            }, days <= 7 ? 10 : 5);
+            const result = transformProductPerformance(orders, limit, metric);
+            return toolResult({
+                products: result,
+                period_days: days,
+                ranked_by: metric,
+            });
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // ---- Tool 11: Order Search ----
+    server.tool("shopify_order_search", "Find orders by number, email, or status. Key fields only.", {
+        query: z
+            .string()
+            .describe("Search query: order number (#1001), email, or financial_status:paid"),
+        limit: z.number().min(1).max(25).default(10),
+    }, async ({ query: searchQuery, limit }) => {
+        if (!isShopifyConfigured())
+            return shopifyNotConfigured();
+        try {
+            const gqlQuery = `
+          query($first: Int!, $queryStr: String!) {
+            orders(first: $first, query: $queryStr) {
+              nodes {
+                name
+                email
+                createdAt
+                totalPriceSet { shopMoney { amount currencyCode } }
+                displayFinancialStatus
+                displayFulfillmentStatus
+                lineItems(first: 10) {
+                  nodes {
+                    name
+                    quantity
+                    originalUnitPriceSet { shopMoney { amount } }
+                  }
+                }
+              }
+            }
+          }
+        `;
+            const data = await shopifyQuery(gqlQuery, { first: limit, queryStr: searchQuery });
+            const result = transformOrders(data.orders.nodes);
+            return toolResult({ orders: result });
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // ---- Tool 12: Inventory Alerts ----
+    server.tool("shopify_inventory_alerts", "Products with low or zero stock. Sorted by most urgent first.", {
+        threshold: z
+            .number()
+            .default(10)
+            .describe("Alert when inventory at or below this number"),
+        limit: z.number().min(1).max(50).default(20),
+    }, async ({ threshold, limit }) => {
+        if (!isShopifyConfigured())
+            return shopifyNotConfigured();
+        try {
+            const query = `
+          query($first: Int!, $after: String) {
+            productVariants(first: $first, after: $after) {
+              nodes {
+                displayName
+                sku
+                inventoryQuantity
+                product { title }
+              }
+              pageInfo { hasNextPage endCursor }
+            }
+          }
+        `;
+            const variants = await paginateGraphQL(query, { first: 250 }, (data) => {
+                const pv = data.productVariants;
+                return { nodes: pv.nodes, pageInfo: pv.pageInfo };
+            }, 3);
+            const alerts = transformInventoryAlerts(variants, threshold);
+            return toolResult({ alerts: alerts.slice(0, limit) });
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // ---- Tool 13: Customer Cohort ----
+    server.tool("shopify_customer_cohort", "New vs returning buyers in the period. Shows first-time vs repeat split.", {
+        days: z.number().min(1).max(365).default(90),
+        limit: z
+            .number()
+            .min(1)
+            .max(500)
+            .default(250)
+            .describe("Max customers to analyze"),
+    }, async ({ days, limit }) => {
+        if (!isShopifyConfigured())
+            return shopifyNotConfigured();
+        try {
+            const tz = await getStoreTimezone();
+            const sinceDate = new Date();
+            sinceDate.setDate(sinceDate.getDate() - days);
+            const sinceDateStr = sinceDate.toLocaleDateString("en-CA", { timeZone: tz });
+            const query = `
+          query($first: Int!, $after: String, $queryStr: String!) {
+            customers(first: $first, after: $after, query: $queryStr) {
+              nodes {
+                id
+                email
+                numberOfOrders
+                amountSpent { amount currencyCode }
+                createdAt
+              }
+              pageInfo { hasNextPage endCursor }
+            }
+          }
+        `;
+            const customers = await paginateGraphQL(query, {
+                first: Math.min(limit, 250),
+                queryStr: `last_order_date:>=${sinceDateStr}`,
+            }, (data) => {
+                const c = data.customers;
+                return { nodes: c.nodes, pageInfo: c.pageInfo };
+            }, Math.ceil(limit / 250));
+            const result = transformCustomerCohort(customers, days);
+            return toolResult(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // ---- Tool 14: Recent Orders ----
+    server.tool("shopify_recent_orders", "Most recent orders. Quick snapshot of store activity.", {
+        limit: z.number().min(1).max(25).default(10),
+    }, async ({ limit }) => {
+        if (!isShopifyConfigured())
+            return shopifyNotConfigured();
+        try {
+            const query = `
+          query($first: Int!) {
+            orders(first: $first, sortKey: CREATED_AT, reverse: true) {
+              nodes {
+                name
+                email
+                createdAt
+                totalPriceSet { shopMoney { amount currencyCode } }
+                displayFinancialStatus
+                displayFulfillmentStatus
+              }
+            }
+          }
+        `;
+            const data = await shopifyQuery(query, { first: limit });
+            const result = transformRecentOrders(data.orders.nodes);
+            return toolResult({ orders: result });
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // ---- Tool 15: Sales Time Series ----
+    server.tool("shopify_sales_timeseries", "Revenue and orders broken down by day, week, or month.", {
+        days: z.number().min(1).max(365).default(30),
+        granularity: z
+            .enum(["daily", "weekly", "monthly"])
+            .default("daily")
+            .describe("Time bucket size"),
+    }, async ({ days, granularity }) => {
+        if (!isShopifyConfigured())
+            return shopifyNotConfigured();
+        try {
+            const tz = await getStoreTimezone();
+            const { buckets, source } = await getTimeSeriesSales(days, granularity);
+            const result = transformSalesTimeSeries(buckets, days, granularity, tz);
+            return toolResult({ ...result, data_source: source });
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/platforms/shopify/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/platforms/shopify/tools.ts"],"names":[],"mappings":"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"}