@progus/connector 0.7.0 → 0.7.2

package/dist/{chunk-WZ5FAA44.js → chunk-77N7IXZB.js}

@@ -20,6 +20,25 @@ function safeJsonParse(text) {
 }
 
 // src/crossSell.ts
+function appendUtmSource(url, utmSource) {
+  const source = utmSource?.trim();
+  if (!source) return url;
+  try {
+    const parsed = new URL(url);
+    if (!parsed.searchParams.has("utm_source")) {
+      parsed.searchParams.set("utm_source", source);
+    }
+    return parsed.toString();
+  } catch {
+    return url;
+  }
+}
+function withSourceTracking(apps, utmSource) {
+  return apps.map((app) => ({
+    ...app,
+    url: appendUtmSource(app.url, utmSource)
+  }));
+}
 function getCrossSellOffers(options = {}) {
   const appsCatalog = options.appsCatalog ?? [];
   const installedKeys = new Set(
@@ -79,7 +98,7 @@ function buildFallbackCatalog(options) {
   if (limit > 0) {
     items = items.slice(0, limit);
   }
-  return items;
+  return withSourceTracking(items, appName);
 }
 async function fetchAppsCatalog(options = {}) {
   const fetchImpl = options.fetch ?? globalThis.fetch;
@@ -105,7 +124,7 @@ async function fetchAppsCatalog(options = {}) {
       logger?.error?.("Failed to fetch apps catalog", { status: response.status });
       return buildFallbackCatalog(options);
     }
-    return parsed;
+    return withSourceTracking(parsed, appName);
   } catch (error) {
     logger?.error?.("Failed to fetch apps catalog", {
       error: error instanceof Error ? error.message : String(error)

package/dist/{crossSell-BdqPj2g7.d.cts → crossSell-DGRqzhbh.d.cts}

@@ -20,13 +20,20 @@ type ConnectorConfig = {
     logger?: Logger;
     enableIdempotency?: boolean;
 };
-type TrackEventName = "installation" | "uninstallation" | "subscription";
+type TrackEventName = "installation" | "uninstallation" | "subscription" | "transaction";
+type TransactionEventData = {
+    transactionId: string;
+    value: number;
+    currency?: string;
+    platform?: string;
+};
 type TrackEventParams<TData = Record<string, unknown>> = {
     eventName: TrackEventName | (string & {});
     shopDomain: string;
     partnerId?: string | null;
     data?: TData;
     externalId?: string;
+    platform?: string;
 };
 type TrackResult<TData = Record<string, unknown>> = {
     success: boolean;
@@ -51,6 +58,7 @@ type SubscriptionEventData = {
     subscriptionId?: number | string;
     subscriptionPrice?: number | string;
     subscriptionPeriod?: string;
+    platform?: string;
 };
 type AppsCatalogEntry = {
     key: string;
@@ -83,4 +91,4 @@ declare function getCrossSellOffers(options?: CrossSellOptions): AppsCatalogEntr
 declare function fetchAppsCatalog(options?: CrossSellFetchOptions): Promise<AppsCatalogEntry[]>;
 declare function getCrossSellOffersFromApi(options?: CrossSellFetchOptions): Promise<AppsCatalogEntry[]>;
 
-export { type AssignPartnerIdWithSubscriptionInput as A, type ConnectorConfig as C, type Logger as L, type SubscriptionEventData as S, type TrackEventParams as T, type TrackResult as a, type CheckPartnerIdResult as b, type ShopifyAdminGraphQLClient as c, getCrossSellOffersFromApi as d, type AppsCatalogEntry as e, fetchAppsCatalog as f, getCrossSellOffers as g, type CrossSellFetchOptions as h, type CrossSellOptions as i, type TrackEventName as j };
+export { type AssignPartnerIdWithSubscriptionInput as A, type ConnectorConfig as C, type Logger as L, type SubscriptionEventData as S, type TrackEventParams as T, type TrackResult as a, type TransactionEventData as b, type CheckPartnerIdResult as c, type ShopifyAdminGraphQLClient as d, getCrossSellOffersFromApi as e, fetchAppsCatalog as f, getCrossSellOffers as g, type AppsCatalogEntry as h, type CrossSellFetchOptions as i, type CrossSellOptions as j, type TrackEventName as k };

package/dist/{crossSell-BdqPj2g7.d.ts → crossSell-DGRqzhbh.d.ts}

@@ -20,13 +20,20 @@ type ConnectorConfig = {
     logger?: Logger;
     enableIdempotency?: boolean;
 };
-type TrackEventName = "installation" | "uninstallation" | "subscription";
+type TrackEventName = "installation" | "uninstallation" | "subscription" | "transaction";
+type TransactionEventData = {
+    transactionId: string;
+    value: number;
+    currency?: string;
+    platform?: string;
+};
 type TrackEventParams<TData = Record<string, unknown>> = {
     eventName: TrackEventName | (string & {});
     shopDomain: string;
     partnerId?: string | null;
     data?: TData;
     externalId?: string;
+    platform?: string;
 };
 type TrackResult<TData = Record<string, unknown>> = {
     success: boolean;
@@ -51,6 +58,7 @@ type SubscriptionEventData = {
     subscriptionId?: number | string;
     subscriptionPrice?: number | string;
     subscriptionPeriod?: string;
+    platform?: string;
 };
 type AppsCatalogEntry = {
     key: string;
@@ -83,4 +91,4 @@ declare function getCrossSellOffers(options?: CrossSellOptions): AppsCatalogEntr
 declare function fetchAppsCatalog(options?: CrossSellFetchOptions): Promise<AppsCatalogEntry[]>;
 declare function getCrossSellOffersFromApi(options?: CrossSellFetchOptions): Promise<AppsCatalogEntry[]>;
 
-export { type AssignPartnerIdWithSubscriptionInput as A, type ConnectorConfig as C, type Logger as L, type SubscriptionEventData as S, type TrackEventParams as T, type TrackResult as a, type CheckPartnerIdResult as b, type ShopifyAdminGraphQLClient as c, getCrossSellOffersFromApi as d, type AppsCatalogEntry as e, fetchAppsCatalog as f, getCrossSellOffers as g, type CrossSellFetchOptions as h, type CrossSellOptions as i, type TrackEventName as j };
+export { type AssignPartnerIdWithSubscriptionInput as A, type ConnectorConfig as C, type Logger as L, type SubscriptionEventData as S, type TrackEventParams as T, type TrackResult as a, type TransactionEventData as b, type CheckPartnerIdResult as c, type ShopifyAdminGraphQLClient as d, getCrossSellOffersFromApi as e, fetchAppsCatalog as f, getCrossSellOffers as g, type AppsCatalogEntry as h, type CrossSellFetchOptions as i, type CrossSellOptions as j, type TrackEventName as k };

package/dist/crossSell.cjs

@@ -39,6 +39,25 @@ function safeJsonParse(text) {
 }
 
 // src/crossSell.ts
+function appendUtmSource(url, utmSource) {
+  const source = utmSource?.trim();
+  if (!source) return url;
+  try {
+    const parsed = new URL(url);
+    if (!parsed.searchParams.has("utm_source")) {
+      parsed.searchParams.set("utm_source", source);
+    }
+    return parsed.toString();
+  } catch {
+    return url;
+  }
+}
+function withSourceTracking(apps, utmSource) {
+  return apps.map((app) => ({
+    ...app,
+    url: appendUtmSource(app.url, utmSource)
+  }));
+}
 function getCrossSellOffers(options = {}) {
   const appsCatalog = options.appsCatalog ?? [];
   const installedKeys = new Set(
@@ -98,7 +117,7 @@ function buildFallbackCatalog(options) {
   if (limit > 0) {
     items = items.slice(0, limit);
   }
-  return items;
+  return withSourceTracking(items, appName);
 }
 async function fetchAppsCatalog(options = {}) {
   const fetchImpl = options.fetch ?? globalThis.fetch;
@@ -124,7 +143,7 @@ async function fetchAppsCatalog(options = {}) {
       logger?.error?.("Failed to fetch apps catalog", { status: response.status });
       return buildFallbackCatalog(options);
     }
-    return parsed;
+    return withSourceTracking(parsed, appName);
   } catch (error) {
     logger?.error?.("Failed to fetch apps catalog", {
       error: error instanceof Error ? error.message : String(error)

package/dist/crossSell.d.cts

@@ -1 +1 @@
-export { e as AppsCatalogEntry, h as CrossSellFetchOptions, i as CrossSellOptions, f as fetchAppsCatalog, g as getCrossSellOffers, d as getCrossSellOffersFromApi } from './crossSell-BdqPj2g7.cjs';
+export { h as AppsCatalogEntry, i as CrossSellFetchOptions, j as CrossSellOptions, f as fetchAppsCatalog, g as getCrossSellOffers, e as getCrossSellOffersFromApi } from './crossSell-DGRqzhbh.cjs';

package/dist/crossSell.d.ts

@@ -1 +1 @@
-export { e as AppsCatalogEntry, h as CrossSellFetchOptions, i as CrossSellOptions, f as fetchAppsCatalog, g as getCrossSellOffers, d as getCrossSellOffersFromApi } from './crossSell-BdqPj2g7.js';
+export { h as AppsCatalogEntry, i as CrossSellFetchOptions, j as CrossSellOptions, f as fetchAppsCatalog, g as getCrossSellOffers, e as getCrossSellOffersFromApi } from './crossSell-DGRqzhbh.js';

package/dist/crossSell.js

@@ -2,7 +2,7 @@ import {
   fetchAppsCatalog,
   getCrossSellOffers,
   getCrossSellOffersFromApi
-} from "./chunk-WZ5FAA44.js";
+} from "./chunk-77N7IXZB.js";
 export {
   fetchAppsCatalog,
   getCrossSellOffers,

package/dist/index.cjs

@@ -211,6 +211,7 @@ function createProgusConnector(config) {
       trackSubscriptionPurchased: fail,
       trackSubscriptionUpdated: fail,
       trackSubscriptionCancelled: fail,
+      trackTransaction: fail,
       assignPartnerIdWithSubscription: fail,
       checkPartnerId: async () => ({ success: false, message, status: 500 })
     };
@@ -233,6 +234,9 @@ function createProgusConnector(config) {
     if (partnerId) {
       requestPayload.partnerId = partnerId;
     }
+    if (payload.platform !== void 0) {
+      requestPayload.platform = payload.platform;
+    }
     if (enableIdempotency) {
       const eventId = buildEventId(shopDomain, String(eventName), externalId);
       if (eventId) {
@@ -288,11 +292,27 @@ function createProgusConnector(config) {
       logger?.info?.("Partner event skipped: missing partnerId required for installation event");
       return { success: false, message: "Missing partnerId" };
     }
-    return postEvent("installation", { shopDomain: payload.shopDomain, partnerId });
+    return postEvent("installation", {
+      shopDomain: payload.shopDomain,
+      partnerId,
+      platform: payload.platform
+    });
   }
   async function trackUninstall(payload) {
     return postEvent("uninstallation", { shopDomain: payload.shopDomain });
   }
+  async function trackTransaction(payload) {
+    const { transactionId, value } = payload.data;
+    if (!transactionId || typeof value !== "number" || !Number.isFinite(value)) {
+      logger?.info?.("Partner event skipped: transaction requires transactionId and numeric value");
+      return { success: false, message: "Invalid transaction data: transactionId and value required" };
+    }
+    return postEvent("transaction", {
+      shopDomain: payload.shopDomain,
+      data: payload.data,
+      externalId: transactionId
+    });
+  }
   async function trackSubscription(payload) {
     const normalized = normalizeSubscriptionData(payload.data);
     if (!normalized) {
@@ -397,12 +417,32 @@ function createProgusConnector(config) {
     trackSubscriptionPurchased: trackSubscription,
     trackSubscriptionUpdated: trackSubscription,
     trackSubscriptionCancelled: trackSubscription,
+    trackTransaction,
     assignPartnerIdWithSubscription,
     checkPartnerId
   };
 }
 
 // src/crossSell.ts
+function appendUtmSource(url, utmSource) {
+  const source = utmSource?.trim();
+  if (!source) return url;
+  try {
+    const parsed = new URL(url);
+    if (!parsed.searchParams.has("utm_source")) {
+      parsed.searchParams.set("utm_source", source);
+    }
+    return parsed.toString();
+  } catch {
+    return url;
+  }
+}
+function withSourceTracking(apps, utmSource) {
+  return apps.map((app) => ({
+    ...app,
+    url: appendUtmSource(app.url, utmSource)
+  }));
+}
 function getCrossSellOffers(options = {}) {
   const appsCatalog = options.appsCatalog ?? [];
   const installedKeys = new Set(
@@ -462,7 +502,7 @@ function buildFallbackCatalog(options) {
   if (limit > 0) {
     items = items.slice(0, limit);
   }
-  return items;
+  return withSourceTracking(items, appName);
 }
 async function fetchAppsCatalog(options = {}) {
   const fetchImpl = options.fetch ?? globalThis.fetch;
@@ -488,7 +528,7 @@ async function fetchAppsCatalog(options = {}) {
       logger?.error?.("Failed to fetch apps catalog", { status: response.status });
       return buildFallbackCatalog(options);
     }
-    return parsed;
+    return withSourceTracking(parsed, appName);
   } catch (error) {
     logger?.error?.("Failed to fetch apps catalog", {
       error: error instanceof Error ? error.message : String(error)

package/dist/index.d.cts

@@ -1,11 +1,12 @@
-import { C as ConnectorConfig, T as TrackEventParams, a as TrackResult, S as SubscriptionEventData, A as AssignPartnerIdWithSubscriptionInput, b as CheckPartnerIdResult, c as ShopifyAdminGraphQLClient } from './crossSell-BdqPj2g7.cjs';
-export { e as AppsCatalogEntry, h as CrossSellFetchOptions, i as CrossSellOptions, L as Logger, j as TrackEventName, f as fetchAppsCatalog, g as getCrossSellOffers, d as getCrossSellOffersFromApi } from './crossSell-BdqPj2g7.cjs';
+import { C as ConnectorConfig, T as TrackEventParams, a as TrackResult, S as SubscriptionEventData, b as TransactionEventData, A as AssignPartnerIdWithSubscriptionInput, c as CheckPartnerIdResult, d as ShopifyAdminGraphQLClient } from './crossSell-DGRqzhbh.cjs';
+export { h as AppsCatalogEntry, i as CrossSellFetchOptions, j as CrossSellOptions, L as Logger, k as TrackEventName, f as fetchAppsCatalog, g as getCrossSellOffers, e as getCrossSellOffersFromApi } from './crossSell-DGRqzhbh.cjs';
 
 type Connector = {
     track: (eventName: TrackEventParams["eventName"], payload: Omit<TrackEventParams, "eventName">) => Promise<TrackResult>;
     trackInstall: (payload: {
         shopDomain: string;
         partnerId?: string | null;
+        platform?: string;
     }) => Promise<TrackResult>;
     trackUninstall: (payload: {
         shopDomain: string;
@@ -22,6 +23,10 @@ type Connector = {
         shopDomain: string;
         data: SubscriptionEventData;
     }) => Promise<TrackResult>;
+    trackTransaction: (payload: {
+        shopDomain: string;
+        data: TransactionEventData;
+    }) => Promise<TrackResult>;
     assignPartnerIdWithSubscription: (payload: AssignPartnerIdWithSubscriptionInput) => Promise<TrackResult & {
         partnerId?: string;
     }>;
@@ -39,4 +44,4 @@ declare function signPayload(body: string, secret: string): string;
 
 declare function normalizePartnerId(value?: string | null): string | null;
 
-export { AssignPartnerIdWithSubscriptionInput, CheckPartnerIdResult, ConnectorConfig, ShopifyAdminGraphQLClient, SubscriptionEventData, TrackEventParams, TrackResult, createProgusConnector, fetchActiveSubscriptionEventData, normalizePartnerId, signPayload };
+export { AssignPartnerIdWithSubscriptionInput, CheckPartnerIdResult, ConnectorConfig, ShopifyAdminGraphQLClient, SubscriptionEventData, TrackEventParams, TrackResult, TransactionEventData, createProgusConnector, fetchActiveSubscriptionEventData, normalizePartnerId, signPayload };

package/dist/index.d.ts

@@ -1,11 +1,12 @@
-import { C as ConnectorConfig, T as TrackEventParams, a as TrackResult, S as SubscriptionEventData, A as AssignPartnerIdWithSubscriptionInput, b as CheckPartnerIdResult, c as ShopifyAdminGraphQLClient } from './crossSell-BdqPj2g7.js';
-export { e as AppsCatalogEntry, h as CrossSellFetchOptions, i as CrossSellOptions, L as Logger, j as TrackEventName, f as fetchAppsCatalog, g as getCrossSellOffers, d as getCrossSellOffersFromApi } from './crossSell-BdqPj2g7.js';
+import { C as ConnectorConfig, T as TrackEventParams, a as TrackResult, S as SubscriptionEventData, b as TransactionEventData, A as AssignPartnerIdWithSubscriptionInput, c as CheckPartnerIdResult, d as ShopifyAdminGraphQLClient } from './crossSell-DGRqzhbh.js';
+export { h as AppsCatalogEntry, i as CrossSellFetchOptions, j as CrossSellOptions, L as Logger, k as TrackEventName, f as fetchAppsCatalog, g as getCrossSellOffers, e as getCrossSellOffersFromApi } from './crossSell-DGRqzhbh.js';
 
 type Connector = {
     track: (eventName: TrackEventParams["eventName"], payload: Omit<TrackEventParams, "eventName">) => Promise<TrackResult>;
     trackInstall: (payload: {
         shopDomain: string;
         partnerId?: string | null;
+        platform?: string;
     }) => Promise<TrackResult>;
     trackUninstall: (payload: {
         shopDomain: string;
@@ -22,6 +23,10 @@ type Connector = {
         shopDomain: string;
         data: SubscriptionEventData;
     }) => Promise<TrackResult>;
+    trackTransaction: (payload: {
+        shopDomain: string;
+        data: TransactionEventData;
+    }) => Promise<TrackResult>;
     assignPartnerIdWithSubscription: (payload: AssignPartnerIdWithSubscriptionInput) => Promise<TrackResult & {
         partnerId?: string;
     }>;
@@ -39,4 +44,4 @@ declare function signPayload(body: string, secret: string): string;
 
 declare function normalizePartnerId(value?: string | null): string | null;
 
-export { AssignPartnerIdWithSubscriptionInput, CheckPartnerIdResult, ConnectorConfig, ShopifyAdminGraphQLClient, SubscriptionEventData, TrackEventParams, TrackResult, createProgusConnector, fetchActiveSubscriptionEventData, normalizePartnerId, signPayload };
+export { AssignPartnerIdWithSubscriptionInput, CheckPartnerIdResult, ConnectorConfig, ShopifyAdminGraphQLClient, SubscriptionEventData, TrackEventParams, TrackResult, TransactionEventData, createProgusConnector, fetchActiveSubscriptionEventData, normalizePartnerId, signPayload };

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   normalizePartnerId,
   safeJsonParse,
   stripTrailingSlash
-} from "./chunk-WZ5FAA44.js";
+} from "./chunk-77N7IXZB.js";
 
 // src/subscription.ts
 var ACTIVE_SUBSCRIPTIONS_QUERY = `
@@ -168,6 +168,7 @@ function createProgusConnector(config) {
       trackSubscriptionPurchased: fail,
       trackSubscriptionUpdated: fail,
       trackSubscriptionCancelled: fail,
+      trackTransaction: fail,
       assignPartnerIdWithSubscription: fail,
       checkPartnerId: async () => ({ success: false, message, status: 500 })
     };
@@ -190,6 +191,9 @@ function createProgusConnector(config) {
     if (partnerId) {
       requestPayload.partnerId = partnerId;
     }
+    if (payload.platform !== void 0) {
+      requestPayload.platform = payload.platform;
+    }
     if (enableIdempotency) {
       const eventId = buildEventId(shopDomain, String(eventName), externalId);
       if (eventId) {
@@ -245,11 +249,27 @@ function createProgusConnector(config) {
       logger?.info?.("Partner event skipped: missing partnerId required for installation event");
       return { success: false, message: "Missing partnerId" };
     }
-    return postEvent("installation", { shopDomain: payload.shopDomain, partnerId });
+    return postEvent("installation", {
+      shopDomain: payload.shopDomain,
+      partnerId,
+      platform: payload.platform
+    });
   }
   async function trackUninstall(payload) {
     return postEvent("uninstallation", { shopDomain: payload.shopDomain });
   }
+  async function trackTransaction(payload) {
+    const { transactionId, value } = payload.data;
+    if (!transactionId || typeof value !== "number" || !Number.isFinite(value)) {
+      logger?.info?.("Partner event skipped: transaction requires transactionId and numeric value");
+      return { success: false, message: "Invalid transaction data: transactionId and value required" };
+    }
+    return postEvent("transaction", {
+      shopDomain: payload.shopDomain,
+      data: payload.data,
+      externalId: transactionId
+    });
+  }
   async function trackSubscription(payload) {
     const normalized = normalizeSubscriptionData(payload.data);
     if (!normalized) {
@@ -354,6 +374,7 @@ function createProgusConnector(config) {
     trackSubscriptionPurchased: trackSubscription,
     trackSubscriptionUpdated: trackSubscription,
     trackSubscriptionCancelled: trackSubscription,
+    trackTransaction,
     assignPartnerIdWithSubscription,
     checkPartnerId
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progus/connector",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Progus partner/affiliate connector helpers",
   "license": "MIT",
   "type": "module",