@progus/connector 0.6.7 → 0.7.0

package/README.md

@@ -8,80 +8,124 @@ Headless connector for Progus partner/affiliate tracking and partner ID assignme
 npm install @progus/connector
 ```
 
-## Usage (Shopify app, Node/TS)
+## Minimal Integration
+
+Integrate the partner program in 4 steps:
+
+### 1. Server connector setup
 
 ```ts
+// utils/progus-connector.server.ts
 import { createProgusConnector } from "@progus/connector";
 
-const connector = createProgusConnector({
-  appKey: "progus-store-locator",
-  apiBaseUrl: process.env.PARTNERS_API_URL!,
-  signingSecret: process.env.PARTNERS_SECRET_KEY!,
-  apiKey: process.env.PARTNERS_API_KEY,
-});
+export function isPartnersConnectorConfigured(): boolean {
+  return Boolean(process.env.PARTNERS_API_URL && process.env.PARTNERS_SECRET_KEY);
+}
+
+export function getPartnersConnector() {
+  return createProgusConnector({
+    appKey: "your-app-name",
+    apiBaseUrl: process.env.PARTNERS_API_URL || "",
+    signingSecret: process.env.PARTNERS_SECRET_KEY || "",
+    apiKey: process.env.PARTNERS_API_KEY,
+  });
+}
+```
+
+### 2. Cookie-based install tracking (client-side)
 
-await connector.trackInstall({
+```ts
+// On app load (e.g. in root route useEffect)
+const cookieMatch = document.cookie.match(/(?:^|; )progus_partner_id=([^;]*)/);
+const partnerId = cookieMatch ? decodeURIComponent(cookieMatch[1]) : null;
+
+if (partnerId) {
+  await connector.trackInstall({ shopDomain: session.shop, partnerId });
+  document.cookie = "progus_partner_id=; Path=/; Max-Age=0"; // clear after tracking
+}
+```
+
+### 3. Partner ID assignment (Save Partner ID button)
+
+```ts
+// On "Save Partner ID" action
+const result = await connector.assignPartnerIdWithSubscription({
   shopDomain: session.shop,
-  partnerId: partnerIdFromCookie,
+  partnerId: inputValue,
+  admin, // Shopify Admin GraphQL client
 });
 
+if (result.success) {
+  // Lock the input field, show success
+}
+```
+
+### 4. Required webhooks
+
+**APP_SUBSCRIPTIONS_UPDATE** - track subscription changes:
+```ts
 await connector.trackSubscriptionUpdated({
-  shopDomain: session.shop,
+  shopDomain: shop,
   data: {
-    subscriptionStatus: "ACTIVE",
-    subscriptionName: "pro",
-    subscriptionId: "gid://shopify/AppSubscription/123",
+    subscriptionId,        // numeric ID (required)
+    subscriptionPrice,     // number (required)
+    subscriptionPeriod,    // "EVERY_30_DAYS" or "ANNUAL" (required)
+    subscriptionStatus,    // e.g. "ACTIVE", "CANCELLED"
+    subscriptionName,      // plan name
   },
 });
+```
 
-await connector.trackUninstall({ shopDomain: session.shop });
+**APP_UNINSTALLED** - track uninstalls:
+```ts
+await connector.trackUninstall({ shopDomain: shop });
 ```
 
-## Prompt: Partner program implementation (copy/paste)
+## AI Prompt: Partner program implementation
+
+Copy/paste for AI assistants:
 
 ```
 You are integrating Progus Partner Program using @progus/connector in a Shopify app.
 
-Implement these pieces:
-1) Server connector:
-   - createProgusConnector({ appKey, PARTNERS_API_URL, PARTNERS_SECRET_KEY, PARTNERS_API_KEY })
-   - expose getPartnersConnector() + isPartnersConnectorConfigured()
+Required files to create/modify:
 
-2) Install tracking:
-   - after app install, call trackInstall({ shopDomain, partnerId })
-   - partnerId source: read cookie "progus_partner_id" on progus.com
-   - cookie must be JS-readable (HttpOnly=false) and cross-site (SameSite=None; Secure)
-   - if partnerId is missing, skip tracking
+1) Server connector (utils/progus-connector.server.ts):
+   - createProgusConnector({ appKey, apiBaseUrl, signingSecret, apiKey })
+   - export getPartnersConnector() and isPartnersConnectorConfigured()
 
-3) Partner ID assignment UI:
-   - save partnerId from merchant input (Partner ID field)
-   - call assignPartnerId({ shopDomain, partnerId }) on save
-   - lock the field after successful save
-   - optionally check partnerId on load with checkPartnerId({ shopDomain })
+2) Cookie-based install tracking (client-side, on app load):
+   - read cookie "progus_partner_id" (HttpOnly=false, SameSite=None, Secure)
+   - if exists: call connector.trackInstall({ shopDomain, partnerId })
+   - clear cookie after successful tracking
+   - if no cookie, skip tracking
 
-4) Subscription tracking:
-   - on app_subscriptions/update webhook, send trackSubscriptionUpdated
-   - payload must include: subscriptionId (digits), subscriptionPrice (number), subscriptionPeriod ("EVERY_30_DAYS" or "ANNUAL"), subscriptionStatus, subscriptionName
-   - if webhook payload is missing price/interval, fetch details via Admin GraphQL node(id) -> AppSubscription -> lineItems.plan.pricingDetails
+3) Partner ID assignment UI (on "Save Partner ID" button):
+   - call connector.assignPartnerIdWithSubscription({ shopDomain, partnerId, admin })
+   - admin = Shopify Admin GraphQL client
+   - connector normalizes partnerId and fetches active subscription automatically
+   - subscription event sent ONLY if price + period are available
+   - lock the Partner ID field after success
+   - optionally: check existing partnerId on load with connector.checkPartnerId({ shopDomain })
 
-5) Uninstall tracking:
-   - on app/uninstalled webhook, call trackUninstall({ shopDomain })
+4) APP_SUBSCRIPTIONS_UPDATE webhook (required):
+   - call connector.trackSubscriptionUpdated({ shopDomain, data })
+   - data must include: subscriptionId (number), subscriptionPrice (number), subscriptionPeriod ("EVERY_30_DAYS" | "ANNUAL")
+   - if webhook payload missing price/interval, query: node(id) -> AppSubscription -> lineItems.plan.pricingDetails
+   - connector validates; event skipped if price/period missing
 
-Return errors gracefully; do not break webhooks if partner tracking fails.
-```
+5) APP_UNINSTALLED webhook (required):
+   - call connector.trackUninstall({ shopDomain })
 
-## Partner ID assignment
+Error handling: catch and log errors; never break webhooks on partner tracking failure.
+```
 
-```ts
-const result = await connector.assignPartnerId({
-  shopDomain: "my-shop.myshopify.com",
-  partnerId: "partner_123",
-});
+## Validation
 
-if (result.success) {
-  // persist partnerId in your app (db/cookie) as needed
-}
-```
+The connector handles all validation internally:
+- `trackInstall` normalizes partnerId (trims, checks format)
+- `trackSubscriptionUpdated` validates price/period; skips if missing
+- Apps do not need to validate before calling connector methods
 
 ## Optional signing helper
 

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

@@ -40,9 +40,10 @@ type CheckPartnerIdResult = {
     message?: string;
     status?: number;
 };
-type AssignPartnerIdInput = {
+type AssignPartnerIdWithSubscriptionInput = {
     shopDomain: string;
     partnerId: string;
+    admin: ShopifyAdminGraphQLClient;
 };
 type SubscriptionEventData = {
     subscriptionStatus?: string;
@@ -82,4 +83,4 @@ declare function getCrossSellOffers(options?: CrossSellOptions): AppsCatalogEntr
 declare function fetchAppsCatalog(options?: CrossSellFetchOptions): Promise<AppsCatalogEntry[]>;
 declare function getCrossSellOffersFromApi(options?: CrossSellFetchOptions): Promise<AppsCatalogEntry[]>;
 
-export { type AssignPartnerIdInput 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 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 };

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

@@ -40,9 +40,10 @@ type CheckPartnerIdResult = {
     message?: string;
     status?: number;
 };
-type AssignPartnerIdInput = {
+type AssignPartnerIdWithSubscriptionInput = {
     shopDomain: string;
     partnerId: string;
+    admin: ShopifyAdminGraphQLClient;
 };
 type SubscriptionEventData = {
     subscriptionStatus?: string;
@@ -82,4 +83,4 @@ declare function getCrossSellOffers(options?: CrossSellOptions): AppsCatalogEntr
 declare function fetchAppsCatalog(options?: CrossSellFetchOptions): Promise<AppsCatalogEntry[]>;
 declare function getCrossSellOffersFromApi(options?: CrossSellFetchOptions): Promise<AppsCatalogEntry[]>;
 
-export { type AssignPartnerIdInput 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 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 };

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-Bs_6xA6f.cjs';
+export { e as AppsCatalogEntry, h as CrossSellFetchOptions, i as CrossSellOptions, f as fetchAppsCatalog, g as getCrossSellOffers, d as getCrossSellOffersFromApi } from './crossSell-BdqPj2g7.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-Bs_6xA6f.js';
+export { e as AppsCatalogEntry, h as CrossSellFetchOptions, i as CrossSellOptions, f as fetchAppsCatalog, g as getCrossSellOffers, d as getCrossSellOffersFromApi } from './crossSell-BdqPj2g7.js';

package/dist/index.cjs

@@ -30,6 +30,142 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/subscription.ts
+var ACTIVE_SUBSCRIPTIONS_QUERY = `
+  query {
+    currentAppInstallation {
+      activeSubscriptions {
+        id
+        name
+        status
+        lineItems {
+          plan {
+            pricingDetails {
+              __typename
+              ... on AppRecurringPricing {
+                interval
+                price {
+                  amount
+                }
+              }
+              ... on AppUsagePricing {
+                cappedAmount {
+                  amount
+                }
+                terms
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+`;
+var SUBSCRIPTION_DETAILS_QUERY = `
+  query AppSubscriptionDetails($id: ID!) {
+    node(id: $id) {
+      ... on AppSubscription {
+        id
+        name
+        status
+        lineItems {
+          plan {
+            pricingDetails {
+              __typename
+              ... on AppRecurringPricing {
+                interval
+                price {
+                  amount
+                }
+              }
+              ... on AppUsagePricing {
+                cappedAmount {
+                  amount
+                }
+                terms
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+`;
+function normalizeInterval(intervalRaw, nameHint) {
+  const interval = intervalRaw ? String(intervalRaw).toUpperCase() : "";
+  if (interval === "ANNUAL" || interval === "EVERY_30_DAYS") return interval;
+  if (interval === "MONTHLY" || interval === "EVERY_30DAYS") return "EVERY_30_DAYS";
+  const name = (nameHint ?? "").toLowerCase();
+  if (name.includes("annual") || name.includes("year")) return "ANNUAL";
+  if (name) return "EVERY_30_DAYS";
+  return "";
+}
+function parseSubscriptionId(rawId) {
+  if (!rawId) return null;
+  return rawId.match(/\d+$/)?.[0] ?? rawId.split("/").pop() ?? rawId;
+}
+function parsePrice(rawPrice) {
+  if (typeof rawPrice === "number") return rawPrice;
+  if (typeof rawPrice === "string") {
+    const parsed = Number(rawPrice);
+    return Number.isFinite(parsed) ? parsed : null;
+  }
+  return null;
+}
+function extractPricing(subscription) {
+  const pricingDetails = subscription?.lineItems?.[0]?.plan?.pricingDetails;
+  const rawPrice = pricingDetails?.price?.amount ?? pricingDetails?.cappedAmount?.amount;
+  const subscriptionPrice = parsePrice(rawPrice);
+  const subscriptionPeriod = normalizeInterval(pricingDetails?.interval, subscription?.name);
+  return { subscriptionPrice, subscriptionPeriod };
+}
+async function fetchActiveSubscriptionEventData(admin, logger = console) {
+  const response = await admin.graphql(ACTIVE_SUBSCRIPTIONS_QUERY);
+  const result = await response.json();
+  if (result.errors?.length) {
+    logger.error?.("Partner subscription query errors", { errors: result.errors });
+  }
+  const subscriptions = result.data?.currentAppInstallation?.activeSubscriptions ?? [];
+  const active = subscriptions.find((sub) => String(sub.status ?? "").toUpperCase() === "ACTIVE") ?? subscriptions[0];
+  const subscriptionId = parseSubscriptionId(active?.id);
+  if (!subscriptionId) return null;
+  let { subscriptionPrice, subscriptionPeriod } = extractPricing(active);
+  if (!subscriptionPeriod || subscriptionPrice === null) {
+    try {
+      const detailsResponse = await admin.graphql(SUBSCRIPTION_DETAILS_QUERY, {
+        variables: { id: active?.id }
+      });
+      const detailsJson = await detailsResponse.json();
+      if (detailsJson.errors?.length) {
+        logger.error?.("Partner subscription details query errors", { errors: detailsJson.errors });
+      }
+      const details = detailsJson.data?.node;
+      ({ subscriptionPrice, subscriptionPeriod } = extractPricing(details));
+      if (!subscriptionPeriod || subscriptionPrice === null) return null;
+      return {
+        subscriptionStatus: details?.status ?? active?.status ?? "ACTIVE",
+        subscriptionName: details?.name ?? active?.name,
+        subscriptionId,
+        subscriptionPrice,
+        subscriptionPeriod
+      };
+    } catch (error) {
+      logger.error?.("Partner subscription details query failed", {
+        error: error instanceof Error ? error.message : String(error)
+      });
+      return null;
+    }
+  }
+  if (!subscriptionPeriod || subscriptionPrice === null) return null;
+  return {
+    subscriptionStatus: active?.status ?? "ACTIVE",
+    subscriptionName: active?.name,
+    subscriptionId,
+    subscriptionPrice,
+    subscriptionPeriod
+  };
+}
+
 // src/signing.ts
 var import_crypto = require("crypto");
 function signPayload(body, secret) {
@@ -75,7 +211,7 @@ function createProgusConnector(config) {
       trackSubscriptionPurchased: fail,
       trackSubscriptionUpdated: fail,
       trackSubscriptionCancelled: fail,
-      assignPartnerId: fail,
+      assignPartnerIdWithSubscription: fail,
       checkPartnerId: async () => ({ success: false, message, status: 500 })
     };
   }
@@ -169,12 +305,27 @@ function createProgusConnector(config) {
       externalId: String(normalized.subscriptionId)
     });
   }
-  async function assignPartnerId(payload) {
-    const normalized = normalizePartnerId(payload.partnerId);
+  async function assignPartnerIdWithSubscription(payload) {
+    const { admin, shopDomain, partnerId } = payload;
+    const normalized = normalizePartnerId(partnerId);
     if (!normalized) {
       return { success: false, message: "Partner ID is required" };
     }
-    const result = await trackInstall({ shopDomain: payload.shopDomain, partnerId: normalized });
+    const result = await trackInstall({ shopDomain, partnerId: normalized });
+    if (!result.success) return { ...result, partnerId: normalized };
+    try {
+      const subscriptionPayload = await fetchActiveSubscriptionEventData(admin, logger);
+      if (subscriptionPayload) {
+        await trackSubscription({
+          shopDomain,
+          data: subscriptionPayload
+        });
+      }
+    } catch (error) {
+      logger?.error?.("Partner subscription sync failed", {
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
     return { ...result, partnerId: normalized };
   }
   async function checkPartnerId(payload) {
@@ -246,7 +397,7 @@ function createProgusConnector(config) {
     trackSubscriptionPurchased: trackSubscription,
     trackSubscriptionUpdated: trackSubscription,
     trackSubscriptionCancelled: trackSubscription,
-    assignPartnerId,
+    assignPartnerIdWithSubscription,
     checkPartnerId
   };
 }
@@ -349,142 +500,6 @@ async function getCrossSellOffersFromApi(options = {}) {
   const appsCatalog = options.appsCatalog ?? await fetchAppsCatalog(options);
   return getCrossSellOffers({ ...options, appsCatalog });
 }
-
-// src/subscription.ts
-var ACTIVE_SUBSCRIPTIONS_QUERY = `
-  query {
-    currentAppInstallation {
-      activeSubscriptions {
-        id
-        name
-        status
-        lineItems {
-          plan {
-            pricingDetails {
-              __typename
-              ... on AppRecurringPricing {
-                interval
-                price {
-                  amount
-                }
-              }
-              ... on AppUsagePricing {
-                cappedAmount {
-                  amount
-                }
-                terms
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-`;
-var SUBSCRIPTION_DETAILS_QUERY = `
-  query AppSubscriptionDetails($id: ID!) {
-    node(id: $id) {
-      ... on AppSubscription {
-        id
-        name
-        status
-        lineItems {
-          plan {
-            pricingDetails {
-              __typename
-              ... on AppRecurringPricing {
-                interval
-                price {
-                  amount
-                }
-              }
-              ... on AppUsagePricing {
-                cappedAmount {
-                  amount
-                }
-                terms
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-`;
-function normalizeInterval(intervalRaw, nameHint) {
-  const interval = intervalRaw ? String(intervalRaw).toUpperCase() : "";
-  if (interval === "ANNUAL" || interval === "EVERY_30_DAYS") return interval;
-  if (interval === "MONTHLY" || interval === "EVERY_30DAYS") return "EVERY_30_DAYS";
-  const name = (nameHint ?? "").toLowerCase();
-  if (name.includes("annual") || name.includes("year")) return "ANNUAL";
-  if (name) return "EVERY_30_DAYS";
-  return "";
-}
-function parseSubscriptionId(rawId) {
-  if (!rawId) return null;
-  return rawId.match(/\d+$/)?.[0] ?? rawId.split("/").pop() ?? rawId;
-}
-function parsePrice(rawPrice) {
-  if (typeof rawPrice === "number") return rawPrice;
-  if (typeof rawPrice === "string") {
-    const parsed = Number(rawPrice);
-    return Number.isFinite(parsed) ? parsed : null;
-  }
-  return null;
-}
-function extractPricing(subscription) {
-  const pricingDetails = subscription?.lineItems?.[0]?.plan?.pricingDetails;
-  const rawPrice = pricingDetails?.price?.amount ?? pricingDetails?.cappedAmount?.amount;
-  const subscriptionPrice = parsePrice(rawPrice);
-  const subscriptionPeriod = normalizeInterval(pricingDetails?.interval, subscription?.name);
-  return { subscriptionPrice, subscriptionPeriod };
-}
-async function fetchActiveSubscriptionEventData(admin, logger = console) {
-  const response = await admin.graphql(ACTIVE_SUBSCRIPTIONS_QUERY);
-  const result = await response.json();
-  if (result.errors?.length) {
-    logger.error?.("Partner subscription query errors", { errors: result.errors });
-  }
-  const subscriptions = result.data?.currentAppInstallation?.activeSubscriptions ?? [];
-  const active = subscriptions.find((sub) => String(sub.status ?? "").toUpperCase() === "ACTIVE") ?? subscriptions[0];
-  const subscriptionId = parseSubscriptionId(active?.id);
-  if (!subscriptionId) return null;
-  let { subscriptionPrice, subscriptionPeriod } = extractPricing(active);
-  if (!subscriptionPeriod || subscriptionPrice === null) {
-    try {
-      const detailsResponse = await admin.graphql(SUBSCRIPTION_DETAILS_QUERY, {
-        variables: { id: active?.id }
-      });
-      const detailsJson = await detailsResponse.json();
-      if (detailsJson.errors?.length) {
-        logger.error?.("Partner subscription details query errors", { errors: detailsJson.errors });
-      }
-      const details = detailsJson.data?.node;
-      ({ subscriptionPrice, subscriptionPeriod } = extractPricing(details));
-      if (!subscriptionPeriod || subscriptionPrice === null) return null;
-      return {
-        subscriptionStatus: details?.status ?? active?.status ?? "ACTIVE",
-        subscriptionName: details?.name ?? active?.name,
-        subscriptionId,
-        subscriptionPrice,
-        subscriptionPeriod
-      };
-    } catch (error) {
-      logger.error?.("Partner subscription details query failed", {
-        error: error instanceof Error ? error.message : String(error)
-      });
-      return null;
-    }
-  }
-  if (!subscriptionPeriod || subscriptionPrice === null) return null;
-  return {
-    subscriptionStatus: active?.status ?? "ACTIVE",
-    subscriptionName: active?.name,
-    subscriptionId,
-    subscriptionPrice,
-    subscriptionPeriod
-  };
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createProgusConnector,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { C as ConnectorConfig, T as TrackEventParams, a as TrackResult, S as SubscriptionEventData, A as AssignPartnerIdInput, b as CheckPartnerIdResult, c as ShopifyAdminGraphQLClient } from './crossSell-Bs_6xA6f.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-Bs_6xA6f.cjs';
+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';
 
 type Connector = {
     track: (eventName: TrackEventParams["eventName"], payload: Omit<TrackEventParams, "eventName">) => Promise<TrackResult>;
@@ -22,7 +22,7 @@ type Connector = {
         shopDomain: string;
         data: SubscriptionEventData;
     }) => Promise<TrackResult>;
-    assignPartnerId: (payload: AssignPartnerIdInput) => Promise<TrackResult & {
+    assignPartnerIdWithSubscription: (payload: AssignPartnerIdWithSubscriptionInput) => Promise<TrackResult & {
         partnerId?: string;
     }>;
     checkPartnerId: (payload: {
@@ -39,4 +39,4 @@ declare function signPayload(body: string, secret: string): string;
 
 declare function normalizePartnerId(value?: string | null): string | null;
 
-export { AssignPartnerIdInput, CheckPartnerIdResult, ConnectorConfig, ShopifyAdminGraphQLClient, SubscriptionEventData, TrackEventParams, TrackResult, createProgusConnector, fetchActiveSubscriptionEventData, normalizePartnerId, signPayload };
+export { AssignPartnerIdWithSubscriptionInput, CheckPartnerIdResult, ConnectorConfig, ShopifyAdminGraphQLClient, SubscriptionEventData, TrackEventParams, TrackResult, createProgusConnector, fetchActiveSubscriptionEventData, normalizePartnerId, signPayload };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as ConnectorConfig, T as TrackEventParams, a as TrackResult, S as SubscriptionEventData, A as AssignPartnerIdInput, b as CheckPartnerIdResult, c as ShopifyAdminGraphQLClient } from './crossSell-Bs_6xA6f.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-Bs_6xA6f.js';
+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';
 
 type Connector = {
     track: (eventName: TrackEventParams["eventName"], payload: Omit<TrackEventParams, "eventName">) => Promise<TrackResult>;
@@ -22,7 +22,7 @@ type Connector = {
         shopDomain: string;
         data: SubscriptionEventData;
     }) => Promise<TrackResult>;
-    assignPartnerId: (payload: AssignPartnerIdInput) => Promise<TrackResult & {
+    assignPartnerIdWithSubscription: (payload: AssignPartnerIdWithSubscriptionInput) => Promise<TrackResult & {
         partnerId?: string;
     }>;
     checkPartnerId: (payload: {
@@ -39,4 +39,4 @@ declare function signPayload(body: string, secret: string): string;
 
 declare function normalizePartnerId(value?: string | null): string | null;
 
-export { AssignPartnerIdInput, CheckPartnerIdResult, ConnectorConfig, ShopifyAdminGraphQLClient, SubscriptionEventData, TrackEventParams, TrackResult, createProgusConnector, fetchActiveSubscriptionEventData, normalizePartnerId, signPayload };
+export { AssignPartnerIdWithSubscriptionInput, CheckPartnerIdResult, ConnectorConfig, ShopifyAdminGraphQLClient, SubscriptionEventData, TrackEventParams, TrackResult, createProgusConnector, fetchActiveSubscriptionEventData, normalizePartnerId, signPayload };

package/dist/index.js

@@ -8,6 +8,142 @@ import {
   stripTrailingSlash
 } from "./chunk-WZ5FAA44.js";
 
+// src/subscription.ts
+var ACTIVE_SUBSCRIPTIONS_QUERY = `
+  query {
+    currentAppInstallation {
+      activeSubscriptions {
+        id
+        name
+        status
+        lineItems {
+          plan {
+            pricingDetails {
+              __typename
+              ... on AppRecurringPricing {
+                interval
+                price {
+                  amount
+                }
+              }
+              ... on AppUsagePricing {
+                cappedAmount {
+                  amount
+                }
+                terms
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+`;
+var SUBSCRIPTION_DETAILS_QUERY = `
+  query AppSubscriptionDetails($id: ID!) {
+    node(id: $id) {
+      ... on AppSubscription {
+        id
+        name
+        status
+        lineItems {
+          plan {
+            pricingDetails {
+              __typename
+              ... on AppRecurringPricing {
+                interval
+                price {
+                  amount
+                }
+              }
+              ... on AppUsagePricing {
+                cappedAmount {
+                  amount
+                }
+                terms
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+`;
+function normalizeInterval(intervalRaw, nameHint) {
+  const interval = intervalRaw ? String(intervalRaw).toUpperCase() : "";
+  if (interval === "ANNUAL" || interval === "EVERY_30_DAYS") return interval;
+  if (interval === "MONTHLY" || interval === "EVERY_30DAYS") return "EVERY_30_DAYS";
+  const name = (nameHint ?? "").toLowerCase();
+  if (name.includes("annual") || name.includes("year")) return "ANNUAL";
+  if (name) return "EVERY_30_DAYS";
+  return "";
+}
+function parseSubscriptionId(rawId) {
+  if (!rawId) return null;
+  return rawId.match(/\d+$/)?.[0] ?? rawId.split("/").pop() ?? rawId;
+}
+function parsePrice(rawPrice) {
+  if (typeof rawPrice === "number") return rawPrice;
+  if (typeof rawPrice === "string") {
+    const parsed = Number(rawPrice);
+    return Number.isFinite(parsed) ? parsed : null;
+  }
+  return null;
+}
+function extractPricing(subscription) {
+  const pricingDetails = subscription?.lineItems?.[0]?.plan?.pricingDetails;
+  const rawPrice = pricingDetails?.price?.amount ?? pricingDetails?.cappedAmount?.amount;
+  const subscriptionPrice = parsePrice(rawPrice);
+  const subscriptionPeriod = normalizeInterval(pricingDetails?.interval, subscription?.name);
+  return { subscriptionPrice, subscriptionPeriod };
+}
+async function fetchActiveSubscriptionEventData(admin, logger = console) {
+  const response = await admin.graphql(ACTIVE_SUBSCRIPTIONS_QUERY);
+  const result = await response.json();
+  if (result.errors?.length) {
+    logger.error?.("Partner subscription query errors", { errors: result.errors });
+  }
+  const subscriptions = result.data?.currentAppInstallation?.activeSubscriptions ?? [];
+  const active = subscriptions.find((sub) => String(sub.status ?? "").toUpperCase() === "ACTIVE") ?? subscriptions[0];
+  const subscriptionId = parseSubscriptionId(active?.id);
+  if (!subscriptionId) return null;
+  let { subscriptionPrice, subscriptionPeriod } = extractPricing(active);
+  if (!subscriptionPeriod || subscriptionPrice === null) {
+    try {
+      const detailsResponse = await admin.graphql(SUBSCRIPTION_DETAILS_QUERY, {
+        variables: { id: active?.id }
+      });
+      const detailsJson = await detailsResponse.json();
+      if (detailsJson.errors?.length) {
+        logger.error?.("Partner subscription details query errors", { errors: detailsJson.errors });
+      }
+      const details = detailsJson.data?.node;
+      ({ subscriptionPrice, subscriptionPeriod } = extractPricing(details));
+      if (!subscriptionPeriod || subscriptionPrice === null) return null;
+      return {
+        subscriptionStatus: details?.status ?? active?.status ?? "ACTIVE",
+        subscriptionName: details?.name ?? active?.name,
+        subscriptionId,
+        subscriptionPrice,
+        subscriptionPeriod
+      };
+    } catch (error) {
+      logger.error?.("Partner subscription details query failed", {
+        error: error instanceof Error ? error.message : String(error)
+      });
+      return null;
+    }
+  }
+  if (!subscriptionPeriod || subscriptionPrice === null) return null;
+  return {
+    subscriptionStatus: active?.status ?? "ACTIVE",
+    subscriptionName: active?.name,
+    subscriptionId,
+    subscriptionPrice,
+    subscriptionPeriod
+  };
+}
+
 // src/signing.ts
 import { createHmac } from "crypto";
 function signPayload(body, secret) {
@@ -32,7 +168,7 @@ function createProgusConnector(config) {
       trackSubscriptionPurchased: fail,
       trackSubscriptionUpdated: fail,
       trackSubscriptionCancelled: fail,
-      assignPartnerId: fail,
+      assignPartnerIdWithSubscription: fail,
       checkPartnerId: async () => ({ success: false, message, status: 500 })
     };
   }
@@ -126,12 +262,27 @@ function createProgusConnector(config) {
       externalId: String(normalized.subscriptionId)
     });
   }
-  async function assignPartnerId(payload) {
-    const normalized = normalizePartnerId(payload.partnerId);
+  async function assignPartnerIdWithSubscription(payload) {
+    const { admin, shopDomain, partnerId } = payload;
+    const normalized = normalizePartnerId(partnerId);
     if (!normalized) {
       return { success: false, message: "Partner ID is required" };
     }
-    const result = await trackInstall({ shopDomain: payload.shopDomain, partnerId: normalized });
+    const result = await trackInstall({ shopDomain, partnerId: normalized });
+    if (!result.success) return { ...result, partnerId: normalized };
+    try {
+      const subscriptionPayload = await fetchActiveSubscriptionEventData(admin, logger);
+      if (subscriptionPayload) {
+        await trackSubscription({
+          shopDomain,
+          data: subscriptionPayload
+        });
+      }
+    } catch (error) {
+      logger?.error?.("Partner subscription sync failed", {
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
     return { ...result, partnerId: normalized };
   }
   async function checkPartnerId(payload) {
@@ -203,146 +354,10 @@ function createProgusConnector(config) {
     trackSubscriptionPurchased: trackSubscription,
     trackSubscriptionUpdated: trackSubscription,
     trackSubscriptionCancelled: trackSubscription,
-    assignPartnerId,
+    assignPartnerIdWithSubscription,
     checkPartnerId
   };
 }
-
-// src/subscription.ts
-var ACTIVE_SUBSCRIPTIONS_QUERY = `
-  query {
-    currentAppInstallation {
-      activeSubscriptions {
-        id
-        name
-        status
-        lineItems {
-          plan {
-            pricingDetails {
-              __typename
-              ... on AppRecurringPricing {
-                interval
-                price {
-                  amount
-                }
-              }
-              ... on AppUsagePricing {
-                cappedAmount {
-                  amount
-                }
-                terms
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-`;
-var SUBSCRIPTION_DETAILS_QUERY = `
-  query AppSubscriptionDetails($id: ID!) {
-    node(id: $id) {
-      ... on AppSubscription {
-        id
-        name
-        status
-        lineItems {
-          plan {
-            pricingDetails {
-              __typename
-              ... on AppRecurringPricing {
-                interval
-                price {
-                  amount
-                }
-              }
-              ... on AppUsagePricing {
-                cappedAmount {
-                  amount
-                }
-                terms
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-`;
-function normalizeInterval(intervalRaw, nameHint) {
-  const interval = intervalRaw ? String(intervalRaw).toUpperCase() : "";
-  if (interval === "ANNUAL" || interval === "EVERY_30_DAYS") return interval;
-  if (interval === "MONTHLY" || interval === "EVERY_30DAYS") return "EVERY_30_DAYS";
-  const name = (nameHint ?? "").toLowerCase();
-  if (name.includes("annual") || name.includes("year")) return "ANNUAL";
-  if (name) return "EVERY_30_DAYS";
-  return "";
-}
-function parseSubscriptionId(rawId) {
-  if (!rawId) return null;
-  return rawId.match(/\d+$/)?.[0] ?? rawId.split("/").pop() ?? rawId;
-}
-function parsePrice(rawPrice) {
-  if (typeof rawPrice === "number") return rawPrice;
-  if (typeof rawPrice === "string") {
-    const parsed = Number(rawPrice);
-    return Number.isFinite(parsed) ? parsed : null;
-  }
-  return null;
-}
-function extractPricing(subscription) {
-  const pricingDetails = subscription?.lineItems?.[0]?.plan?.pricingDetails;
-  const rawPrice = pricingDetails?.price?.amount ?? pricingDetails?.cappedAmount?.amount;
-  const subscriptionPrice = parsePrice(rawPrice);
-  const subscriptionPeriod = normalizeInterval(pricingDetails?.interval, subscription?.name);
-  return { subscriptionPrice, subscriptionPeriod };
-}
-async function fetchActiveSubscriptionEventData(admin, logger = console) {
-  const response = await admin.graphql(ACTIVE_SUBSCRIPTIONS_QUERY);
-  const result = await response.json();
-  if (result.errors?.length) {
-    logger.error?.("Partner subscription query errors", { errors: result.errors });
-  }
-  const subscriptions = result.data?.currentAppInstallation?.activeSubscriptions ?? [];
-  const active = subscriptions.find((sub) => String(sub.status ?? "").toUpperCase() === "ACTIVE") ?? subscriptions[0];
-  const subscriptionId = parseSubscriptionId(active?.id);
-  if (!subscriptionId) return null;
-  let { subscriptionPrice, subscriptionPeriod } = extractPricing(active);
-  if (!subscriptionPeriod || subscriptionPrice === null) {
-    try {
-      const detailsResponse = await admin.graphql(SUBSCRIPTION_DETAILS_QUERY, {
-        variables: { id: active?.id }
-      });
-      const detailsJson = await detailsResponse.json();
-      if (detailsJson.errors?.length) {
-        logger.error?.("Partner subscription details query errors", { errors: detailsJson.errors });
-      }
-      const details = detailsJson.data?.node;
-      ({ subscriptionPrice, subscriptionPeriod } = extractPricing(details));
-      if (!subscriptionPeriod || subscriptionPrice === null) return null;
-      return {
-        subscriptionStatus: details?.status ?? active?.status ?? "ACTIVE",
-        subscriptionName: details?.name ?? active?.name,
-        subscriptionId,
-        subscriptionPrice,
-        subscriptionPeriod
-      };
-    } catch (error) {
-      logger.error?.("Partner subscription details query failed", {
-        error: error instanceof Error ? error.message : String(error)
-      });
-      return null;
-    }
-  }
-  if (!subscriptionPeriod || subscriptionPrice === null) return null;
-  return {
-    subscriptionStatus: active?.status ?? "ACTIVE",
-    subscriptionName: active?.name,
-    subscriptionId,
-    subscriptionPrice,
-    subscriptionPeriod
-  };
-}
 export {
   createProgusConnector,
   fetchActiveSubscriptionEventData,

package/package.json

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