@progus/connector 0.1.0

package/README.md

@@ -0,0 +1,102 @@
+# @progus/connector
+
+Headless connector for Progus partner/affiliate tracking, partner ID assignment,
+and cross-sell offers. No UI code, no embedded secrets.
+
+## Installation
+
+```bash
+npm install @progus/connector
+```
+
+## Usage (Shopify app, Node/TS)
+
+```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, // optional
+});
+
+await connector.trackInstall({
+  shopDomain: session.shop,
+  partnerId: partnerIdFromCookie,
+});
+
+await connector.trackSubscriptionUpdated({
+  shopDomain: session.shop,
+  data: {
+    subscriptionStatus: "ACTIVE",
+    subscriptionName: "pro",
+    subscriptionId: "gid://shopify/AppSubscription/123",
+  },
+});
+
+await connector.trackUninstall({ shopDomain: session.shop });
+```
+
+## Partner ID assignment
+
+```ts
+const result = await connector.assignPartnerId({
+  shopDomain: "my-shop.myshopify.com",
+  partnerId: "partner_123",
+});
+
+if (result.success) {
+  // persist partnerId in your app (db/cookie) as needed
+}
+```
+
+## Cross-sell offers
+
+```ts
+import { getCrossSellOffers } from "@progus/connector";
+
+const offers = getCrossSellOffers({
+  currentAppKey: "progus-store-locator",
+  installedAppKeys: ["progus_cod"],
+});
+```
+
+## Optional signing helper
+
+```ts
+import { signPayload } from "@progus/connector";
+
+const signature = signPayload(JSON.stringify({ test: true }), process.env.PARTNERS_SECRET_KEY!);
+```
+
+## Environment variables
+
+- `PARTNERS_API_URL` - base URL for partner API (e.g. `https://partners.example.com`)
+- `PARTNERS_SECRET_KEY` - signing secret for HMAC (required for tracking)
+- `PARTNERS_API_KEY` - optional API key header
+
+## Publishing
+
+```bash
+npm run build
+npm publish --access public
+```
+
+## Smoke script
+
+```bash
+npm run smoke
+```
+
+## Migration notes (Store Locator)
+
+Found integrations and call sites:
+- `web/controllers/partners.controller.js` (partner events + signing)
+- `web/controllers/auth/shopifyAuth.controller.js` (install event on OAuth)
+- `web/controllers/store.controller.js` (uninstall event)
+- `web/controllers/subscription.controller.js` (subscription event)
+- `web/routes/index.route.js` (save/check partner ID API)
+- `web/frontend/pages/plans.jsx` (partner ID UI)
+- `web/frontend/components/DashboardComponents/RecommendationsCard.jsx` (cross-sell)
+- `web/frontend/constants/recommendations.js` (apps catalog, moved to connector)

package/dist/index.cjs

@@ -0,0 +1,260 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  appsCatalog: () => appsCatalog,
+  createProgusConnector: () => createProgusConnector,
+  getCrossSellOffers: () => getCrossSellOffers,
+  normalizePartnerId: () => normalizePartnerId,
+  signPayload: () => signPayload
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/signing.ts
+var import_crypto = require("crypto");
+function signPayload(body, secret) {
+  return (0, import_crypto.createHmac)("sha256", secret).update(body).digest("hex");
+}
+
+// src/utils.ts
+function normalizePartnerId(value) {
+  if (!value) return null;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function buildEventId(shopDomain, eventName, externalId) {
+  if (!externalId) return void 0;
+  return `${shopDomain}:${eventName}:${externalId}`;
+}
+function stripTrailingSlash(value) {
+  return value.replace(/\/+$/, "");
+}
+function safeJsonParse(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+}
+
+// src/connector.ts
+function createProgusConnector(config) {
+  const apiBaseUrl = config.apiBaseUrl ? stripTrailingSlash(config.apiBaseUrl) : "";
+  const fetchImpl = config.fetch ?? globalThis.fetch;
+  const logger = config.logger ?? console;
+  const enableIdempotency = config.enableIdempotency !== false;
+  if (!fetchImpl) {
+    throw new Error("Fetch implementation is required");
+  }
+  async function postEvent(eventName, payload) {
+    const { shopDomain, partnerId, data, externalId } = payload;
+    if (!shopDomain) {
+      logger?.info?.("Partner event skipped: missing customerId");
+      return { success: false, message: "Missing customerId" };
+    }
+    if (!apiBaseUrl || !config.signingSecret) {
+      logger?.info?.("Partner event skipped: missing API configuration");
+      return { success: false, message: "Missing API configuration" };
+    }
+    const requestPayload = {
+      customerId: shopDomain,
+      appName: config.appKey,
+      data: data ?? {}
+    };
+    if (partnerId) {
+      requestPayload.partnerId = partnerId;
+    }
+    if (enableIdempotency) {
+      const eventId = buildEventId(shopDomain, String(eventName), externalId);
+      if (eventId) {
+        requestPayload.eventId = eventId;
+      }
+    }
+    const requestBody = JSON.stringify(requestPayload);
+    const headers = {
+      "Content-Type": "application/json",
+      "x-progus-hmac-sha256": signPayload(requestBody, config.signingSecret)
+    };
+    if (config.apiKey) {
+      headers["x-api-key"] = config.apiKey;
+    }
+    try {
+      const response = await fetchImpl(`${apiBaseUrl}/event/${eventName}`, {
+        method: "POST",
+        headers,
+        body: requestBody
+      });
+      const text = await response.text();
+      const parsed = safeJsonParse(text);
+      if (!response.ok) {
+        logger?.error?.(`Failed to send ${String(eventName)} event`, {
+          status: response.status
+        });
+        return {
+          success: false,
+          message: parsed?.message ?? `Failed to send ${String(eventName)} event`,
+          status: response.status,
+          data: parsed ?? void 0
+        };
+      }
+      return {
+        success: parsed?.success ?? true,
+        message: parsed?.message ?? `Successfully sent ${String(eventName)} event`,
+        status: response.status,
+        data: parsed ?? void 0
+      };
+    } catch (error) {
+      logger?.error?.(`Error sending ${String(eventName)} event`, {
+        error: error instanceof Error ? error.message : String(error)
+      });
+      return {
+        success: false,
+        message: error instanceof Error ? error.message : "Error sending event"
+      };
+    }
+  }
+  async function trackInstall(payload) {
+    const partnerId = normalizePartnerId(payload.partnerId);
+    if (!partnerId) {
+      logger?.info?.("Partner event skipped: missing partnerId required for installation event");
+      return { success: false, message: "Missing partnerId" };
+    }
+    return postEvent("installation", { shopDomain: payload.shopDomain, partnerId });
+  }
+  async function trackUninstall(payload) {
+    return postEvent("uninstallation", { shopDomain: payload.shopDomain });
+  }
+  async function trackSubscription(payload) {
+    return postEvent("subscription", {
+      shopDomain: payload.shopDomain,
+      data: payload.data,
+      externalId: payload.data.subscriptionId
+    });
+  }
+  async function assignPartnerId(payload) {
+    const normalized = normalizePartnerId(payload.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 checkPartnerId(payload) {
+    if (!payload.shopDomain) {
+      return { success: false, message: "Missing shop domain" };
+    }
+    if (!apiBaseUrl || !config.signingSecret) {
+      return { success: false, message: "Partners API configuration not set", status: 500 };
+    }
+    const requestBody = JSON.stringify({ shop: payload.shopDomain });
+    const headers = {
+      "Content-Type": "application/json",
+      "x-progus-hmac-sha256": signPayload(requestBody, config.signingSecret)
+    };
+    if (config.apiKey) {
+      headers["x-api-key"] = config.apiKey;
+    }
+    try {
+      const response = await fetchImpl(`${apiBaseUrl}/event/checkPartnerId`, {
+        method: "POST",
+        headers,
+        body: requestBody
+      });
+      const text = await response.text();
+      const parsed = safeJsonParse(text);
+      if (response.ok && parsed) {
+        return {
+          success: parsed.success ?? true,
+          partnerId: parsed.partnerId,
+          status: response.status,
+          message: parsed.message
+        };
+      }
+      logger?.error?.("checkPartnerId error", { status: response.status });
+      return { success: false, message: "Error checking partner ID", status: response.status };
+    } catch (error) {
+      logger?.error?.("Error checking partner ID", {
+        error: error instanceof Error ? error.message : String(error)
+      });
+      return { success: false, message: "Error checking partner ID", status: 500 };
+    }
+  }
+  return {
+    track: (eventName, payload) => postEvent(eventName, payload),
+    trackInstall,
+    trackUninstall,
+    trackSubscriptionPurchased: trackSubscription,
+    trackSubscriptionUpdated: trackSubscription,
+    trackSubscriptionCancelled: trackSubscription,
+    assignPartnerId,
+    checkPartnerId
+  };
+}
+
+// src/appsCatalog.json
+var appsCatalog_default = [
+  {
+    key: "progus_cod",
+    type: "app",
+    title: "Progus COD",
+    company: "Progus",
+    companyUrl: "https://progus.com",
+    desc: "Automate COD Fees & Hide/Show Cash on Delivery by Rules",
+    url: "https://apps.shopify.com/progus-cod",
+    icon: "https://cdn.shopify.com/app-store/listing_images/bc537219cc3ed2bd4e7e3e683fe6b74a/icon/CMi_6dTEkIoDEAE=.png",
+    priority: 100,
+    enabled: true
+  },
+  {
+    key: "progus_trust_badges",
+    type: "app",
+    title: "Progus Trust Badges",
+    company: "Progus",
+    companyUrl: "https://progus.com",
+    desc: "Add Trust Badges to your store to build trust and credibility.",
+    url: "https://apps.shopify.com/progus-trust-badges-1",
+    icon: "https://cdn.shopify.com/app-store/listing_images/f9d0009e237f27d2db35b41ef99be858/icon/CJ3y1qDn1JEDEAE=.png",
+    priority: 90,
+    enabled: true
+  }
+];
+
+// src/crossSell.ts
+var catalog = appsCatalog_default;
+function getCrossSellOffers(options = {}) {
+  const appsCatalog2 = options.appsCatalog ?? catalog;
+  const installedKeys = new Set(
+    [options.currentAppKey, ...options.installedAppKeys ?? []].filter(
+      (key) => Boolean(key)
+    )
+  );
+  const locale = options.locale;
+  return appsCatalog2.filter((app) => app.enabled !== false).filter((app) => locale ? !app.locales || app.locales.includes(locale) : true).filter((app) => !installedKeys.has(app.key)).sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+}
+var appsCatalog = catalog;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  appsCatalog,
+  createProgusConnector,
+  getCrossSellOffers,
+  normalizePartnerId,
+  signPayload
+});

package/dist/index.d.cts

@@ -0,0 +1,106 @@
+type FetchLike = typeof fetch;
+type Logger = {
+    info?: (message: string, meta?: Record<string, unknown>) => void;
+    warn?: (message: string, meta?: Record<string, unknown>) => void;
+    error?: (message: string, meta?: Record<string, unknown>) => void;
+};
+type AppsCatalogEntry = {
+    key: string;
+    type: string;
+    title: string;
+    company?: string;
+    companyUrl?: string;
+    desc?: string;
+    url: string;
+    icon?: string;
+    enabled?: boolean;
+    priority?: number;
+    locales?: string[];
+};
+type CrossSellOptions = {
+    currentAppKey?: string;
+    installedAppKeys?: string[];
+    locale?: string;
+    shopPlan?: string;
+    appsCatalog?: AppsCatalogEntry[];
+};
+type ConnectorConfig = {
+    appKey: string;
+    apiBaseUrl: string;
+    apiKey?: string;
+    signingSecret?: string;
+    appsCatalog?: AppsCatalogEntry[];
+    fetch?: FetchLike;
+    logger?: Logger;
+    enableIdempotency?: boolean;
+};
+type TrackEventName = "installation" | "uninstallation" | "subscription";
+type TrackEventParams<TData = Record<string, unknown>> = {
+    eventName: TrackEventName | (string & {});
+    shopDomain: string;
+    partnerId?: string | null;
+    data?: TData;
+    externalId?: string;
+};
+type TrackResult<TData = Record<string, unknown>> = {
+    success: boolean;
+    message?: string;
+    status?: number;
+    data?: TData;
+};
+type CheckPartnerIdResult = {
+    success: boolean;
+    partnerId?: string;
+    message?: string;
+    status?: number;
+};
+type AssignPartnerIdInput = {
+    shopDomain: string;
+    partnerId: string;
+};
+type SubscriptionEventData = {
+    subscriptionStatus?: string;
+    subscriptionName?: string;
+    subscriptionId?: string;
+    subscriptionPrice?: number;
+    subscriptionPeriod?: string;
+};
+
+type Connector = {
+    track: (eventName: TrackEventParams["eventName"], payload: Omit<TrackEventParams, "eventName">) => Promise<TrackResult>;
+    trackInstall: (payload: {
+        shopDomain: string;
+        partnerId?: string | null;
+    }) => Promise<TrackResult>;
+    trackUninstall: (payload: {
+        shopDomain: string;
+    }) => Promise<TrackResult>;
+    trackSubscriptionPurchased: (payload: {
+        shopDomain: string;
+        data: SubscriptionEventData;
+    }) => Promise<TrackResult>;
+    trackSubscriptionUpdated: (payload: {
+        shopDomain: string;
+        data: SubscriptionEventData;
+    }) => Promise<TrackResult>;
+    trackSubscriptionCancelled: (payload: {
+        shopDomain: string;
+        data: SubscriptionEventData;
+    }) => Promise<TrackResult>;
+    assignPartnerId: (payload: AssignPartnerIdInput) => Promise<TrackResult & {
+        partnerId?: string;
+    }>;
+    checkPartnerId: (payload: {
+        shopDomain: string;
+    }) => Promise<CheckPartnerIdResult>;
+};
+declare function createProgusConnector(config: ConnectorConfig): Connector;
+
+declare function getCrossSellOffers(options?: CrossSellOptions): AppsCatalogEntry[];
+declare const appsCatalog: AppsCatalogEntry[];
+
+declare function signPayload(body: string, secret: string): string;
+
+declare function normalizePartnerId(value?: string | null): string | null;
+
+export { type AppsCatalogEntry, type AssignPartnerIdInput, type CheckPartnerIdResult, type ConnectorConfig, type CrossSellOptions, type Logger, type SubscriptionEventData, type TrackEventName, type TrackEventParams, type TrackResult, appsCatalog, createProgusConnector, getCrossSellOffers, normalizePartnerId, signPayload };

package/dist/index.d.ts

@@ -0,0 +1,106 @@
+type FetchLike = typeof fetch;
+type Logger = {
+    info?: (message: string, meta?: Record<string, unknown>) => void;
+    warn?: (message: string, meta?: Record<string, unknown>) => void;
+    error?: (message: string, meta?: Record<string, unknown>) => void;
+};
+type AppsCatalogEntry = {
+    key: string;
+    type: string;
+    title: string;
+    company?: string;
+    companyUrl?: string;
+    desc?: string;
+    url: string;
+    icon?: string;
+    enabled?: boolean;
+    priority?: number;
+    locales?: string[];
+};
+type CrossSellOptions = {
+    currentAppKey?: string;
+    installedAppKeys?: string[];
+    locale?: string;
+    shopPlan?: string;
+    appsCatalog?: AppsCatalogEntry[];
+};
+type ConnectorConfig = {
+    appKey: string;
+    apiBaseUrl: string;
+    apiKey?: string;
+    signingSecret?: string;
+    appsCatalog?: AppsCatalogEntry[];
+    fetch?: FetchLike;
+    logger?: Logger;
+    enableIdempotency?: boolean;
+};
+type TrackEventName = "installation" | "uninstallation" | "subscription";
+type TrackEventParams<TData = Record<string, unknown>> = {
+    eventName: TrackEventName | (string & {});
+    shopDomain: string;
+    partnerId?: string | null;
+    data?: TData;
+    externalId?: string;
+};
+type TrackResult<TData = Record<string, unknown>> = {
+    success: boolean;
+    message?: string;
+    status?: number;
+    data?: TData;
+};
+type CheckPartnerIdResult = {
+    success: boolean;
+    partnerId?: string;
+    message?: string;
+    status?: number;
+};
+type AssignPartnerIdInput = {
+    shopDomain: string;
+    partnerId: string;
+};
+type SubscriptionEventData = {
+    subscriptionStatus?: string;
+    subscriptionName?: string;
+    subscriptionId?: string;
+    subscriptionPrice?: number;
+    subscriptionPeriod?: string;
+};
+
+type Connector = {
+    track: (eventName: TrackEventParams["eventName"], payload: Omit<TrackEventParams, "eventName">) => Promise<TrackResult>;
+    trackInstall: (payload: {
+        shopDomain: string;
+        partnerId?: string | null;
+    }) => Promise<TrackResult>;
+    trackUninstall: (payload: {
+        shopDomain: string;
+    }) => Promise<TrackResult>;
+    trackSubscriptionPurchased: (payload: {
+        shopDomain: string;
+        data: SubscriptionEventData;
+    }) => Promise<TrackResult>;
+    trackSubscriptionUpdated: (payload: {
+        shopDomain: string;
+        data: SubscriptionEventData;
+    }) => Promise<TrackResult>;
+    trackSubscriptionCancelled: (payload: {
+        shopDomain: string;
+        data: SubscriptionEventData;
+    }) => Promise<TrackResult>;
+    assignPartnerId: (payload: AssignPartnerIdInput) => Promise<TrackResult & {
+        partnerId?: string;
+    }>;
+    checkPartnerId: (payload: {
+        shopDomain: string;
+    }) => Promise<CheckPartnerIdResult>;
+};
+declare function createProgusConnector(config: ConnectorConfig): Connector;
+
+declare function getCrossSellOffers(options?: CrossSellOptions): AppsCatalogEntry[];
+declare const appsCatalog: AppsCatalogEntry[];
+
+declare function signPayload(body: string, secret: string): string;
+
+declare function normalizePartnerId(value?: string | null): string | null;
+
+export { type AppsCatalogEntry, type AssignPartnerIdInput, type CheckPartnerIdResult, type ConnectorConfig, type CrossSellOptions, type Logger, type SubscriptionEventData, type TrackEventName, type TrackEventParams, type TrackResult, appsCatalog, createProgusConnector, getCrossSellOffers, normalizePartnerId, signPayload };

package/dist/index.js

@@ -0,0 +1,229 @@
+// src/signing.ts
+import { createHmac } from "crypto";
+function signPayload(body, secret) {
+  return createHmac("sha256", secret).update(body).digest("hex");
+}
+
+// src/utils.ts
+function normalizePartnerId(value) {
+  if (!value) return null;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function buildEventId(shopDomain, eventName, externalId) {
+  if (!externalId) return void 0;
+  return `${shopDomain}:${eventName}:${externalId}`;
+}
+function stripTrailingSlash(value) {
+  return value.replace(/\/+$/, "");
+}
+function safeJsonParse(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+}
+
+// src/connector.ts
+function createProgusConnector(config) {
+  const apiBaseUrl = config.apiBaseUrl ? stripTrailingSlash(config.apiBaseUrl) : "";
+  const fetchImpl = config.fetch ?? globalThis.fetch;
+  const logger = config.logger ?? console;
+  const enableIdempotency = config.enableIdempotency !== false;
+  if (!fetchImpl) {
+    throw new Error("Fetch implementation is required");
+  }
+  async function postEvent(eventName, payload) {
+    const { shopDomain, partnerId, data, externalId } = payload;
+    if (!shopDomain) {
+      logger?.info?.("Partner event skipped: missing customerId");
+      return { success: false, message: "Missing customerId" };
+    }
+    if (!apiBaseUrl || !config.signingSecret) {
+      logger?.info?.("Partner event skipped: missing API configuration");
+      return { success: false, message: "Missing API configuration" };
+    }
+    const requestPayload = {
+      customerId: shopDomain,
+      appName: config.appKey,
+      data: data ?? {}
+    };
+    if (partnerId) {
+      requestPayload.partnerId = partnerId;
+    }
+    if (enableIdempotency) {
+      const eventId = buildEventId(shopDomain, String(eventName), externalId);
+      if (eventId) {
+        requestPayload.eventId = eventId;
+      }
+    }
+    const requestBody = JSON.stringify(requestPayload);
+    const headers = {
+      "Content-Type": "application/json",
+      "x-progus-hmac-sha256": signPayload(requestBody, config.signingSecret)
+    };
+    if (config.apiKey) {
+      headers["x-api-key"] = config.apiKey;
+    }
+    try {
+      const response = await fetchImpl(`${apiBaseUrl}/event/${eventName}`, {
+        method: "POST",
+        headers,
+        body: requestBody
+      });
+      const text = await response.text();
+      const parsed = safeJsonParse(text);
+      if (!response.ok) {
+        logger?.error?.(`Failed to send ${String(eventName)} event`, {
+          status: response.status
+        });
+        return {
+          success: false,
+          message: parsed?.message ?? `Failed to send ${String(eventName)} event`,
+          status: response.status,
+          data: parsed ?? void 0
+        };
+      }
+      return {
+        success: parsed?.success ?? true,
+        message: parsed?.message ?? `Successfully sent ${String(eventName)} event`,
+        status: response.status,
+        data: parsed ?? void 0
+      };
+    } catch (error) {
+      logger?.error?.(`Error sending ${String(eventName)} event`, {
+        error: error instanceof Error ? error.message : String(error)
+      });
+      return {
+        success: false,
+        message: error instanceof Error ? error.message : "Error sending event"
+      };
+    }
+  }
+  async function trackInstall(payload) {
+    const partnerId = normalizePartnerId(payload.partnerId);
+    if (!partnerId) {
+      logger?.info?.("Partner event skipped: missing partnerId required for installation event");
+      return { success: false, message: "Missing partnerId" };
+    }
+    return postEvent("installation", { shopDomain: payload.shopDomain, partnerId });
+  }
+  async function trackUninstall(payload) {
+    return postEvent("uninstallation", { shopDomain: payload.shopDomain });
+  }
+  async function trackSubscription(payload) {
+    return postEvent("subscription", {
+      shopDomain: payload.shopDomain,
+      data: payload.data,
+      externalId: payload.data.subscriptionId
+    });
+  }
+  async function assignPartnerId(payload) {
+    const normalized = normalizePartnerId(payload.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 checkPartnerId(payload) {
+    if (!payload.shopDomain) {
+      return { success: false, message: "Missing shop domain" };
+    }
+    if (!apiBaseUrl || !config.signingSecret) {
+      return { success: false, message: "Partners API configuration not set", status: 500 };
+    }
+    const requestBody = JSON.stringify({ shop: payload.shopDomain });
+    const headers = {
+      "Content-Type": "application/json",
+      "x-progus-hmac-sha256": signPayload(requestBody, config.signingSecret)
+    };
+    if (config.apiKey) {
+      headers["x-api-key"] = config.apiKey;
+    }
+    try {
+      const response = await fetchImpl(`${apiBaseUrl}/event/checkPartnerId`, {
+        method: "POST",
+        headers,
+        body: requestBody
+      });
+      const text = await response.text();
+      const parsed = safeJsonParse(text);
+      if (response.ok && parsed) {
+        return {
+          success: parsed.success ?? true,
+          partnerId: parsed.partnerId,
+          status: response.status,
+          message: parsed.message
+        };
+      }
+      logger?.error?.("checkPartnerId error", { status: response.status });
+      return { success: false, message: "Error checking partner ID", status: response.status };
+    } catch (error) {
+      logger?.error?.("Error checking partner ID", {
+        error: error instanceof Error ? error.message : String(error)
+      });
+      return { success: false, message: "Error checking partner ID", status: 500 };
+    }
+  }
+  return {
+    track: (eventName, payload) => postEvent(eventName, payload),
+    trackInstall,
+    trackUninstall,
+    trackSubscriptionPurchased: trackSubscription,
+    trackSubscriptionUpdated: trackSubscription,
+    trackSubscriptionCancelled: trackSubscription,
+    assignPartnerId,
+    checkPartnerId
+  };
+}
+
+// src/appsCatalog.json
+var appsCatalog_default = [
+  {
+    key: "progus_cod",
+    type: "app",
+    title: "Progus COD",
+    company: "Progus",
+    companyUrl: "https://progus.com",
+    desc: "Automate COD Fees & Hide/Show Cash on Delivery by Rules",
+    url: "https://apps.shopify.com/progus-cod",
+    icon: "https://cdn.shopify.com/app-store/listing_images/bc537219cc3ed2bd4e7e3e683fe6b74a/icon/CMi_6dTEkIoDEAE=.png",
+    priority: 100,
+    enabled: true
+  },
+  {
+    key: "progus_trust_badges",
+    type: "app",
+    title: "Progus Trust Badges",
+    company: "Progus",
+    companyUrl: "https://progus.com",
+    desc: "Add Trust Badges to your store to build trust and credibility.",
+    url: "https://apps.shopify.com/progus-trust-badges-1",
+    icon: "https://cdn.shopify.com/app-store/listing_images/f9d0009e237f27d2db35b41ef99be858/icon/CJ3y1qDn1JEDEAE=.png",
+    priority: 90,
+    enabled: true
+  }
+];
+
+// src/crossSell.ts
+var catalog = appsCatalog_default;
+function getCrossSellOffers(options = {}) {
+  const appsCatalog2 = options.appsCatalog ?? catalog;
+  const installedKeys = new Set(
+    [options.currentAppKey, ...options.installedAppKeys ?? []].filter(
+      (key) => Boolean(key)
+    )
+  );
+  const locale = options.locale;
+  return appsCatalog2.filter((app) => app.enabled !== false).filter((app) => locale ? !app.locales || app.locales.includes(locale) : true).filter((app) => !installedKeys.has(app.key)).sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+}
+var appsCatalog = catalog;
+export {
+  appsCatalog,
+  createProgusConnector,
+  getCrossSellOffers,
+  normalizePartnerId,
+  signPayload
+};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@progus/connector",
+  "version": "0.1.0",
+  "description": "Progus partner/affiliate connector helpers",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "src/appsCatalog.json"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean --target node18",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch --target node18",
+    "smoke": "tsx scripts/smoke.ts"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.30",
+    "tsup": "^8.0.1",
+    "tsx": "^4.7.1",
+    "typescript": "^5.4.5"
+  }
+}

package/src/appsCatalog.json

@@ -0,0 +1,26 @@
+[
+  {
+    "key": "progus_cod",
+    "type": "app",
+    "title": "Progus COD",
+    "company": "Progus",
+    "companyUrl": "https://progus.com",
+    "desc": "Automate COD Fees & Hide/Show Cash on Delivery by Rules",
+    "url": "https://apps.shopify.com/progus-cod",
+    "icon": "https://cdn.shopify.com/app-store/listing_images/bc537219cc3ed2bd4e7e3e683fe6b74a/icon/CMi_6dTEkIoDEAE=.png",
+    "priority": 100,
+    "enabled": true
+  },
+  {
+    "key": "progus_trust_badges",
+    "type": "app",
+    "title": "Progus Trust Badges",
+    "company": "Progus",
+    "companyUrl": "https://progus.com",
+    "desc": "Add Trust Badges to your store to build trust and credibility.",
+    "url": "https://apps.shopify.com/progus-trust-badges-1",
+    "icon": "https://cdn.shopify.com/app-store/listing_images/f9d0009e237f27d2db35b41ef99be858/icon/CJ3y1qDn1JEDEAE=.png",
+    "priority": 90,
+    "enabled": true
+  }
+]