@progus/connector 0.6.8 → 0.7.1

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/{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-BZZ9FX7S.d.cts → crossSell-BdqPj2g7.d.cts}

@@ -40,11 +40,9 @@ type CheckPartnerIdResult = {
     message?: string;
     status?: number;
 };
-type AssignPartnerIdInput = {
+type AssignPartnerIdWithSubscriptionInput = {
     shopDomain: string;
     partnerId: string;
-};
-type AssignPartnerIdWithSubscriptionInput = AssignPartnerIdInput & {
     admin: ShopifyAdminGraphQLClient;
 };
 type SubscriptionEventData = {
@@ -85,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 AssignPartnerIdWithSubscriptionInput 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 };
+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-BZZ9FX7S.d.ts → crossSell-BdqPj2g7.d.ts}

@@ -40,11 +40,9 @@ type CheckPartnerIdResult = {
     message?: string;
     status?: number;
 };
-type AssignPartnerIdInput = {
+type AssignPartnerIdWithSubscriptionInput = {
     shopDomain: string;
     partnerId: string;
-};
-type AssignPartnerIdWithSubscriptionInput = AssignPartnerIdInput & {
     admin: ShopifyAdminGraphQLClient;
 };
 type SubscriptionEventData = {
@@ -85,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 AssignPartnerIdWithSubscriptionInput 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 };
+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.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 { h as AppsCatalogEntry, i as CrossSellFetchOptions, j as CrossSellOptions, f as fetchAppsCatalog, g as getCrossSellOffers, e as getCrossSellOffersFromApi } from './crossSell-BZZ9FX7S.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 { h as AppsCatalogEntry, i as CrossSellFetchOptions, j as CrossSellOptions, f as fetchAppsCatalog, g as getCrossSellOffers, e as getCrossSellOffersFromApi } from './crossSell-BZZ9FX7S.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/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,7 +211,6 @@ function createProgusConnector(config) {
       trackSubscriptionPurchased: fail,
       trackSubscriptionUpdated: fail,
       trackSubscriptionCancelled: fail,
-      assignPartnerId: fail,
       assignPartnerIdWithSubscription: fail,
       checkPartnerId: async () => ({ success: false, message, status: 500 })
     };
@@ -306,23 +305,19 @@ 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 });
-    return { ...result, partnerId: normalized };
-  }
-  async function assignPartnerIdWithSubscription(payload) {
-    const { admin, ...rest } = payload;
-    const result = await assignPartnerId(rest);
-    if (!result.success) return result;
+    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: rest.shopDomain,
+          shopDomain,
           data: subscriptionPayload
         });
       }
@@ -331,7 +326,7 @@ function createProgusConnector(config) {
         error: error instanceof Error ? error.message : String(error)
       });
     }
-    return result;
+    return { ...result, partnerId: normalized };
   }
   async function checkPartnerId(payload) {
     if (!payload.shopDomain) {
@@ -402,13 +397,31 @@ function createProgusConnector(config) {
     trackSubscriptionPurchased: trackSubscription,
     trackSubscriptionUpdated: trackSubscription,
     trackSubscriptionCancelled: trackSubscription,
-    assignPartnerId,
     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(
@@ -468,7 +481,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;
@@ -494,7 +507,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,5 +1,5 @@
-import { C as ConnectorConfig, T as TrackEventParams, a as TrackResult, S as SubscriptionEventData, A as AssignPartnerIdInput, b as AssignPartnerIdWithSubscriptionInput, c as CheckPartnerIdResult, d as ShopifyAdminGraphQLClient } from './crossSell-BZZ9FX7S.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-BZZ9FX7S.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,9 +22,6 @@ type Connector = {
         shopDomain: string;
         data: SubscriptionEventData;
     }) => Promise<TrackResult>;
-    assignPartnerId: (payload: AssignPartnerIdInput) => Promise<TrackResult & {
-        partnerId?: string;
-    }>;
     assignPartnerIdWithSubscription: (payload: AssignPartnerIdWithSubscriptionInput) => Promise<TrackResult & {
         partnerId?: string;
     }>;
@@ -42,4 +39,4 @@ declare function signPayload(body: string, secret: string): string;
 
 declare function normalizePartnerId(value?: string | null): string | null;
 
-export { AssignPartnerIdInput, AssignPartnerIdWithSubscriptionInput, 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 AssignPartnerIdWithSubscriptionInput, c as CheckPartnerIdResult, d as ShopifyAdminGraphQLClient } from './crossSell-BZZ9FX7S.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-BZZ9FX7S.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,9 +22,6 @@ type Connector = {
         shopDomain: string;
         data: SubscriptionEventData;
     }) => Promise<TrackResult>;
-    assignPartnerId: (payload: AssignPartnerIdInput) => Promise<TrackResult & {
-        partnerId?: string;
-    }>;
     assignPartnerIdWithSubscription: (payload: AssignPartnerIdWithSubscriptionInput) => Promise<TrackResult & {
         partnerId?: string;
     }>;
@@ -42,4 +39,4 @@ declare function signPayload(body: string, secret: string): string;
 
 declare function normalizePartnerId(value?: string | null): string | null;
 
-export { AssignPartnerIdInput, AssignPartnerIdWithSubscriptionInput, 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

@@ -6,7 +6,7 @@ import {
   normalizePartnerId,
   safeJsonParse,
   stripTrailingSlash
-} from "./chunk-WZ5FAA44.js";
+} from "./chunk-77N7IXZB.js";
 
 // src/subscription.ts
 var ACTIVE_SUBSCRIPTIONS_QUERY = `
@@ -168,7 +168,6 @@ function createProgusConnector(config) {
       trackSubscriptionPurchased: fail,
       trackSubscriptionUpdated: fail,
       trackSubscriptionCancelled: fail,
-      assignPartnerId: fail,
       assignPartnerIdWithSubscription: fail,
       checkPartnerId: async () => ({ success: false, message, status: 500 })
     };
@@ -263,23 +262,19 @@ 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 });
-    return { ...result, partnerId: normalized };
-  }
-  async function assignPartnerIdWithSubscription(payload) {
-    const { admin, ...rest } = payload;
-    const result = await assignPartnerId(rest);
-    if (!result.success) return result;
+    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: rest.shopDomain,
+          shopDomain,
           data: subscriptionPayload
         });
       }
@@ -288,7 +283,7 @@ function createProgusConnector(config) {
         error: error instanceof Error ? error.message : String(error)
       });
     }
-    return result;
+    return { ...result, partnerId: normalized };
   }
   async function checkPartnerId(payload) {
     if (!payload.shopDomain) {
@@ -359,7 +354,6 @@ function createProgusConnector(config) {
     trackSubscriptionPurchased: trackSubscription,
     trackSubscriptionUpdated: trackSubscription,
     trackSubscriptionCancelled: trackSubscription,
-    assignPartnerId,
     assignPartnerIdWithSubscription,
     checkPartnerId
   };

package/package.json

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