dtc-mcp 0.1.0

package/dist/platforms/klaviyo/transforms.js

@@ -0,0 +1,326 @@
+// ---- Campaign Transforms ----
+export function transformCampaignSummary(campaigns, reportRows, metric, limit, channel = "email") {
+    const metricsById = new Map();
+    for (const row of reportRows) {
+        const id = row.groupings.campaign_id;
+        if (!id)
+            continue;
+        // Merge stats if grouped by message — sum them up for the campaign
+        const existing = metricsById.get(id) ?? {};
+        for (const [key, val] of Object.entries(row.statistics)) {
+            existing[key] = (existing[key] ?? 0) + val;
+        }
+        metricsById.set(id, existing);
+    }
+    const results = campaigns.map((c) => {
+        const attrs = c.attributes;
+        const stats = metricsById.get(c.id) ?? {};
+        const recipients = stats.recipients ?? 0;
+        return {
+            id: c.id,
+            name: String(attrs.name ?? ""),
+            channel,
+            status: String(attrs.status ?? "unknown"),
+            send_date: extractSendDate(attrs),
+            recipients,
+            open_rate: safeRate(stats.opens_unique ?? stats.opens, recipients),
+            click_rate: safeRate(stats.clicks_unique ?? stats.clicks, recipients),
+            revenue: stats.conversion_value ?? 0,
+            unsubscribe_rate: safeRate(stats.unsubscribes, recipients),
+        };
+    });
+    // Sort by requested metric descending
+    results.sort((a, b) => {
+        const valA = a[metric];
+        const valB = b[metric];
+        return (valB ?? 0) - (valA ?? 0);
+    });
+    return results.slice(0, limit);
+}
+export function transformCampaignDetail(campaign, messages, reportRows, audienceNames) {
+    const attrs = campaign.attributes;
+    // Sum all report rows for this campaign
+    const stats = {};
+    for (const row of reportRows) {
+        for (const [key, val] of Object.entries(row.statistics)) {
+            stats[key] = (stats[key] ?? 0) + val;
+        }
+    }
+    const recipients = stats.recipients ?? 0;
+    const opens = stats.opens_unique ?? stats.opens ?? 0;
+    return {
+        id: campaign.id,
+        name: String(attrs.name ?? ""),
+        channel: extractChannelFromMessages(messages),
+        status: String(attrs.status ?? "unknown"),
+        subject_line: extractSubjectLine(messages),
+        send_date: extractSendDate(attrs),
+        audiences: audienceNames,
+        recipients,
+        open_rate: safeRate(opens, recipients),
+        click_rate: safeRate(stats.clicks_unique ?? stats.clicks, recipients),
+        click_through_rate: safeRate(stats.clicks_unique ?? stats.clicks, opens),
+        revenue: stats.conversion_value ?? 0,
+        unsubscribe_rate: safeRate(stats.unsubscribes, recipients),
+        bounce_rate: safeRate(stats.bounced, recipients),
+        spam_rate: safeRate(stats.spam_complaints, recipients),
+    };
+}
+// ---- Flow Transforms ----
+export function transformFlowSummary(flows, reportRows, metric, limit) {
+    // Group report rows by flow_id and sum stats
+    const metricsById = new Map();
+    for (const row of reportRows) {
+        const id = row.groupings.flow_id;
+        if (!id)
+            continue;
+        const existing = metricsById.get(id) ?? {};
+        for (const [key, val] of Object.entries(row.statistics)) {
+            existing[key] = (existing[key] ?? 0) + val;
+        }
+        metricsById.set(id, existing);
+    }
+    const results = flows.map((f) => {
+        const attrs = f.attributes;
+        const stats = metricsById.get(f.id) ?? {};
+        const recipients = stats.recipients ?? 0;
+        return {
+            id: f.id,
+            name: String(attrs.name ?? ""),
+            status: String(attrs.status ?? "unknown"),
+            trigger_type: String(attrs.trigger_type ?? "unknown"),
+            message_count: f.messageCount,
+            recipients,
+            click_rate: safeRate(stats.clicks_unique ?? stats.clicks, recipients),
+            revenue: stats.conversion_value ?? 0,
+            conversion_rate: safeRate(stats.conversions, recipients),
+        };
+    });
+    results.sort((a, b) => {
+        const valA = a[metric];
+        const valB = b[metric];
+        return (valB ?? 0) - (valA ?? 0);
+    });
+    return results.slice(0, limit);
+}
+export function transformFlowDetail(flow, messages, reportRows) {
+    const attrs = flow.attributes;
+    // Group report rows by flow_message_id
+    const metricsByMessageId = new Map();
+    const totalStats = {};
+    for (const row of reportRows) {
+        const msgId = row.groupings.flow_message_id;
+        for (const [key, val] of Object.entries(row.statistics)) {
+            totalStats[key] = (totalStats[key] ?? 0) + val;
+        }
+        if (msgId) {
+            const existing = metricsByMessageId.get(msgId) ?? {};
+            for (const [key, val] of Object.entries(row.statistics)) {
+                existing[key] = (existing[key] ?? 0) + val;
+            }
+            metricsByMessageId.set(msgId, existing);
+        }
+    }
+    const messageDetails = messages.map((m) => {
+        const mAttrs = m.attributes;
+        const stats = metricsByMessageId.get(m.id) ?? {};
+        const recipients = stats.recipients ?? 0;
+        return {
+            message_id: m.id,
+            message_name: String(mAttrs.name ?? ""),
+            subject_line: mAttrs.subject
+                ? String(mAttrs.subject)
+                : mAttrs.label
+                    ? String(mAttrs.label)
+                    : null,
+            status: String(mAttrs.status ?? "unknown"),
+            recipients,
+            open_rate: safeRate(stats.opens_unique ?? stats.opens, recipients),
+            click_rate: safeRate(stats.clicks_unique ?? stats.clicks, recipients),
+            revenue: stats.conversion_value ?? 0,
+        };
+    });
+    return {
+        id: flow.id,
+        name: String(attrs.name ?? ""),
+        status: String(attrs.status ?? "unknown"),
+        trigger_type: String(attrs.trigger_type ?? "unknown"),
+        total_revenue: totalStats.conversion_value ?? 0,
+        total_recipients: totalStats.recipients ?? 0,
+        messages: messageDetails,
+    };
+}
+// ---- Subscriber / List / Segment Transforms ----
+export function transformSubscriberHealth(lists, segments) {
+    const transformedLists = lists.map((l) => ({
+        id: l.id,
+        name: String(l.attributes.name ?? ""),
+        size: Number(l.attributes.profile_count ?? 0),
+    }));
+    const transformedSegments = segments.map((s) => ({
+        id: s.id,
+        name: String(s.attributes.name ?? ""),
+        estimated_size: Number(s.attributes.profile_count ?? 0),
+    }));
+    const total = transformedLists.reduce((sum, l) => sum + l.size, 0);
+    return {
+        total_subscribers: total,
+        lists: transformedLists
+            .sort((a, b) => b.size - a.size)
+            .slice(0, 10),
+        segments: transformedSegments
+            .sort((a, b) => b.estimated_size - a.estimated_size)
+            .slice(0, 10),
+    };
+}
+export function transformListSegments(lists, segments) {
+    const items = [];
+    for (const l of lists) {
+        items.push({
+            id: l.id,
+            name: String(l.attributes.name ?? ""),
+            type: "list",
+            size: Number(l.attributes.profile_count ?? 0),
+            created_at: String(l.attributes.created ?? ""),
+            updated_at: String(l.attributes.updated ?? ""),
+        });
+    }
+    for (const s of segments) {
+        items.push({
+            id: s.id,
+            name: String(s.attributes.name ?? ""),
+            type: "segment",
+            size: Number(s.attributes.profile_count ?? 0),
+            created_at: String(s.attributes.created ?? ""),
+            updated_at: String(s.attributes.updated ?? ""),
+        });
+    }
+    return items;
+}
+// ---- Profile Transforms ----
+export function transformProfiles(profiles) {
+    return profiles.map((p) => {
+        const attrs = p.attributes;
+        const location = attrs.location;
+        return {
+            email: attrs.email ? String(attrs.email) : null,
+            first_name: attrs.first_name ? String(attrs.first_name) : null,
+            last_name: attrs.last_name ? String(attrs.last_name) : null,
+            phone_number: attrs.phone_number ? String(attrs.phone_number) : null,
+            city: location?.city ? String(location.city) : null,
+            country: location?.country ? String(location.country) : null,
+            created_at: String(attrs.created ?? ""),
+        };
+    });
+}
+// ---- Event Transforms ----
+export function transformEvents(events, includedProfiles, metricName) {
+    return events.map((e) => {
+        const attrs = e.attributes;
+        const profileId = extractRelationshipId(e.relationships, "profile");
+        const profile = profileId ? includedProfiles.get(profileId) : undefined;
+        // Strip event properties to high-signal fields based on metric type
+        const rawProps = attrs.event_properties ?? {};
+        const props = stripEventProperties(rawProps, metricName);
+        return {
+            timestamp: String(attrs.datetime ?? ""),
+            profile_email: profile?.email ?? null,
+            profile_name: profile
+                ? [profile.first_name, profile.last_name].filter(Boolean).join(" ") ||
+                    null
+                : null,
+            event_properties: props,
+        };
+    });
+}
+// ---- Helpers ----
+function safeRate(numerator, denominator) {
+    if (!denominator || !numerator)
+        return 0;
+    return Math.round((numerator / denominator) * 10000) / 10000; // 4 decimal places
+}
+function extractChannelFromMessages(messages) {
+    if (!messages.length)
+        return "email";
+    const first = messages[0].attributes;
+    const def = first.definition;
+    if (def?.channel)
+        return String(def.channel);
+    // Fallback for flow messages
+    if (first.channel)
+        return String(first.channel);
+    return "email";
+}
+function extractSendDate(attrs) {
+    return (attrs.send_time ??
+        attrs.scheduled_at ??
+        null);
+}
+function extractSubjectLine(messages) {
+    if (!messages.length)
+        return null;
+    const first = messages[0].attributes;
+    // Campaign messages nest fields under definition
+    const def = first.definition;
+    if (def) {
+        const content = def.content;
+        if (content?.subject)
+            return String(content.subject);
+        if (def.label)
+            return String(def.label);
+    }
+    // Fallback for flow messages (top-level fields)
+    return first.subject ? String(first.subject) : first.label ? String(first.label) : null;
+}
+function extractRelationshipId(relationships, name) {
+    if (!relationships)
+        return null;
+    const rel = relationships[name];
+    return rel?.data?.id ?? null;
+}
+function stripEventProperties(props, metricName) {
+    const normalized = metricName.toLowerCase();
+    // For "Placed Order" — keep order value, items, and currency
+    if (normalized.includes("placed order") || normalized.includes("order")) {
+        return pick(props, [
+            "$value",
+            "value",
+            "Items",
+            "ItemNames",
+            "ItemCount",
+            "Currency",
+            "OrderId",
+        ]);
+    }
+    // For email events — keep campaign/flow context
+    if (normalized.includes("opened") ||
+        normalized.includes("clicked") ||
+        normalized.includes("received")) {
+        return pick(props, [
+            "Subject",
+            "CampaignName",
+            "FlowName",
+            "$flow",
+            "$message",
+            "URL",
+        ]);
+    }
+    // Default: return top-level keys only, no nested objects
+    const result = {};
+    for (const [key, val] of Object.entries(props)) {
+        if (typeof val !== "object" || val === null) {
+            result[key] = val;
+        }
+    }
+    return result;
+}
+function pick(obj, keys) {
+    const result = {};
+    for (const key of keys) {
+        if (key in obj) {
+            result[key] = obj[key];
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=transforms.js.map

package/dist/platforms/klaviyo/transforms.js.map

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

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

@@ -0,0 +1,51 @@
+/**
+ * Execute a GraphQL query against Shopify Admin API.
+ */
+export declare function shopifyQuery<T = Record<string, unknown>>(query: string, variables?: Record<string, unknown>, estimatedCost?: number): Promise<T>;
+export interface ShopifyQLColumn {
+    name: string;
+    dataType: string;
+    displayName: string;
+}
+export interface ShopifyQLResult {
+    columns: ShopifyQLColumn[];
+    rows: string[][];
+}
+/**
+ * Execute a ShopifyQL query for pre-aggregated analytics data.
+ */
+export declare function shopifyqlQuery(ql: string): Promise<ShopifyQLResult>;
+export declare function getStoreTimezone(): Promise<string>;
+export type SalesSource = "shopifyql" | "graphql_orders";
+export declare function getAggregatedSales(days: number): Promise<{
+    grossRevenue: number;
+    netRevenue: number;
+    orderCount: number;
+    source: SalesSource;
+}>;
+export interface RawSalesBucket {
+    date: string;
+    grossRevenue: number;
+    netRevenue: number;
+    orderCount: number;
+}
+type Granularity = "daily" | "weekly" | "monthly";
+/**
+ * Get sales data broken down by day, week, or month.
+ */
+export declare function getTimeSeriesSales(days: number, granularity: Granularity): Promise<{
+    buckets: RawSalesBucket[];
+    source: SalesSource;
+}>;
+interface PageInfo {
+    hasNextPage: boolean;
+    endCursor?: string | null;
+}
+/**
+ * Auto-paginate a Shopify GraphQL query.
+ */
+export declare function paginateGraphQL<T>(query: string, variables: Record<string, unknown>, extractPage: (data: Record<string, unknown>) => {
+    nodes: T[];
+    pageInfo: PageInfo;
+}, maxPages?: number, estimatedCostPerPage?: number): Promise<T[]>;
+export {};