@progus/connector 0.7.1 → 0.7.3

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.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/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) {
@@ -369,8 +389,9 @@ function createProgusConnector(config) {
     }
   }
   function normalizeSubscriptionData(data) {
-    const subscriptionId = Number(data.subscriptionId);
-    if (!Number.isFinite(subscriptionId)) {
+    const rawId = data.subscriptionId;
+    const subscriptionId = rawId != null && rawId !== "" ? typeof rawId === "number" && Number.isFinite(rawId) ? rawId : String(rawId) : null;
+    if (subscriptionId === null) {
       return null;
     }
     const subscriptionPrice = Number(data.subscriptionPrice);
@@ -397,6 +418,7 @@ function createProgusConnector(config) {
     trackSubscriptionPurchased: trackSubscription,
     trackSubscriptionUpdated: trackSubscription,
     trackSubscriptionCancelled: trackSubscription,
+    trackTransaction,
     assignPartnerIdWithSubscription,
     checkPartnerId
   };

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

@@ -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) {
@@ -326,8 +346,9 @@ function createProgusConnector(config) {
     }
   }
   function normalizeSubscriptionData(data) {
-    const subscriptionId = Number(data.subscriptionId);
-    if (!Number.isFinite(subscriptionId)) {
+    const rawId = data.subscriptionId;
+    const subscriptionId = rawId != null && rawId !== "" ? typeof rawId === "number" && Number.isFinite(rawId) ? rawId : String(rawId) : null;
+    if (subscriptionId === null) {
       return null;
     }
     const subscriptionPrice = Number(data.subscriptionPrice);
@@ -354,6 +375,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.1",
+  "version": "0.7.3",
   "description": "Progus partner/affiliate connector helpers",
   "license": "MIT",
   "type": "module",