@progus/connector 0.5.5 → 0.6.1

package/README.md

@@ -91,9 +91,25 @@ import { signPayload } from "@progus/connector";
 const signature = signPayload(JSON.stringify({ test: true }), process.env.PARTNERS_SECRET_KEY!);
 ```
 
-## UI components and cross-sell
+## Cross-sell recommendations (server-side)
 
-Use `@progus/connector-ui` for browser-safe helpers and UI components.
+Use the connector to fetch and filter the Progus apps catalog on the backend,
+then pass the list to your frontend UI.
+
+```ts
+import { getCrossSellOffersFromApi } from "@progus/connector";
+
+const recommendations = await getCrossSellOffersFromApi({
+  appName: "progus-store-locator",
+  limit: 3,
+  fetch, // pass your server-side fetch
+});
+```
+
+## UI components
+
+Use `@progus/connector-ui` for UI components. It re-exports cross-sell helpers
+from `@progus/connector`.
 
 ## Environment variables
 

package/dist/chunk-WZ5FAA44.js

@@ -0,0 +1,129 @@
+// 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/crossSell.ts
+function getCrossSellOffers(options = {}) {
+  const appsCatalog = options.appsCatalog ?? [];
+  const installedKeys = new Set(
+    [options.appName, ...options.installedAppKeys ?? []].filter(
+      (key) => Boolean(key)
+    )
+  );
+  const locale = options.locale;
+  return appsCatalog.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 DEFAULT_APPS_CATALOG_URL = "https://appsdata.progus.com/recommendations";
+var FALLBACK_APPS_CATALOG = [
+  {
+    key: "progus_ai_studio",
+    type: "app",
+    title: "Progus AI Studio",
+    company: "Progus",
+    companyUrl: "https://progus.com",
+    desc: "Generate on-brand AI product & variant images in bulk.",
+    url: "https://apps.shopify.com/progus-ai-studio",
+    icon: "https://cdn.shopify.com/app-store/listing_images/9428a41ed53c66cd7329a2583cd2f3d9/icon/COje1rnS4pEDEAE=.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: 80,
+    enabled: true
+  },
+  {
+    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: 90,
+    enabled: true
+  }
+];
+function buildFallbackCatalog(options) {
+  const appName = options.appName;
+  const limit = typeof options.limit === "number" ? options.limit : 3;
+  let items = FALLBACK_APPS_CATALOG.filter((app) => app.enabled !== false);
+  if (appName) {
+    items = items.filter((app) => app.key !== appName);
+  }
+  if (limit > 0) {
+    items = items.slice(0, limit);
+  }
+  return items;
+}
+async function fetchAppsCatalog(options = {}) {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const logger = options.logger ?? console;
+  const appName = options.appName;
+  const baseUrl = stripTrailingSlash(options.appsCatalogUrl ?? DEFAULT_APPS_CATALOG_URL);
+  const limit = typeof options.limit === "number" ? options.limit : 3;
+  const params = new URLSearchParams();
+  if (appName) params.set("appName", appName);
+  if (limit > 0) params.set("limit", String(limit));
+  const url = params.toString() ? `${baseUrl}?${params.toString()}` : baseUrl;
+  if (!fetchImpl) {
+    logger?.error?.("Failed to fetch apps catalog", {
+      error: "Fetch implementation is required"
+    });
+    return buildFallbackCatalog(options);
+  }
+  try {
+    const response = await fetchImpl(url);
+    const text = await response.text();
+    const parsed = safeJsonParse(text);
+    if (!response.ok || !parsed) {
+      logger?.error?.("Failed to fetch apps catalog", { status: response.status });
+      return buildFallbackCatalog(options);
+    }
+    return parsed;
+  } catch (error) {
+    logger?.error?.("Failed to fetch apps catalog", {
+      error: error instanceof Error ? error.message : String(error)
+    });
+    return buildFallbackCatalog(options);
+  }
+}
+async function getCrossSellOffersFromApi(options = {}) {
+  const appsCatalog = options.appsCatalog ?? await fetchAppsCatalog(options);
+  return getCrossSellOffers({ ...options, appsCatalog });
+}
+
+export {
+  normalizePartnerId,
+  buildEventId,
+  stripTrailingSlash,
+  safeJsonParse,
+  getCrossSellOffers,
+  fetchAppsCatalog,
+  getCrossSellOffersFromApi
+};

package/dist/crossSell-BFz9e72n.d.cts

@@ -0,0 +1,78 @@
+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 FetchLike = typeof fetch;
+type ConnectorConfig = {
+    appKey: string;
+    apiBaseUrl: string;
+    apiKey?: string;
+    signingSecret?: string;
+    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?: number | string;
+    subscriptionPrice?: number | string;
+    subscriptionPeriod?: string;
+};
+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 = {
+    appName?: string;
+    installedAppKeys?: string[];
+    locale?: string;
+    shopPlan?: string;
+    appsCatalog?: AppsCatalogEntry[];
+};
+type CrossSellFetchOptions = CrossSellOptions & {
+    appsCatalogUrl?: string;
+    limit?: number;
+    fetch?: FetchLike;
+    logger?: Logger;
+};
+
+declare function getCrossSellOffers(options?: CrossSellOptions): AppsCatalogEntry[];
+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, getCrossSellOffersFromApi as c, type AppsCatalogEntry as d, type CrossSellFetchOptions as e, fetchAppsCatalog as f, getCrossSellOffers as g, type CrossSellOptions as h, type TrackEventName as i };

package/dist/crossSell-BFz9e72n.d.ts

@@ -0,0 +1,78 @@
+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 FetchLike = typeof fetch;
+type ConnectorConfig = {
+    appKey: string;
+    apiBaseUrl: string;
+    apiKey?: string;
+    signingSecret?: string;
+    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?: number | string;
+    subscriptionPrice?: number | string;
+    subscriptionPeriod?: string;
+};
+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 = {
+    appName?: string;
+    installedAppKeys?: string[];
+    locale?: string;
+    shopPlan?: string;
+    appsCatalog?: AppsCatalogEntry[];
+};
+type CrossSellFetchOptions = CrossSellOptions & {
+    appsCatalogUrl?: string;
+    limit?: number;
+    fetch?: FetchLike;
+    logger?: Logger;
+};
+
+declare function getCrossSellOffers(options?: CrossSellOptions): AppsCatalogEntry[];
+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, getCrossSellOffersFromApi as c, type AppsCatalogEntry as d, type CrossSellFetchOptions as e, fetchAppsCatalog as f, getCrossSellOffers as g, type CrossSellOptions as h, type TrackEventName as i };

package/dist/crossSell.cjs

@@ -0,0 +1,144 @@
+"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/crossSell.ts
+var crossSell_exports = {};
+__export(crossSell_exports, {
+  fetchAppsCatalog: () => fetchAppsCatalog,
+  getCrossSellOffers: () => getCrossSellOffers,
+  getCrossSellOffersFromApi: () => getCrossSellOffersFromApi
+});
+module.exports = __toCommonJS(crossSell_exports);
+
+// src/utils.ts
+function stripTrailingSlash(value) {
+  return value.replace(/\/+$/, "");
+}
+function safeJsonParse(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+}
+
+// src/crossSell.ts
+function getCrossSellOffers(options = {}) {
+  const appsCatalog = options.appsCatalog ?? [];
+  const installedKeys = new Set(
+    [options.appName, ...options.installedAppKeys ?? []].filter(
+      (key) => Boolean(key)
+    )
+  );
+  const locale = options.locale;
+  return appsCatalog.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 DEFAULT_APPS_CATALOG_URL = "https://appsdata.progus.com/recommendations";
+var FALLBACK_APPS_CATALOG = [
+  {
+    key: "progus_ai_studio",
+    type: "app",
+    title: "Progus AI Studio",
+    company: "Progus",
+    companyUrl: "https://progus.com",
+    desc: "Generate on-brand AI product & variant images in bulk.",
+    url: "https://apps.shopify.com/progus-ai-studio",
+    icon: "https://cdn.shopify.com/app-store/listing_images/9428a41ed53c66cd7329a2583cd2f3d9/icon/COje1rnS4pEDEAE=.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: 80,
+    enabled: true
+  },
+  {
+    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: 90,
+    enabled: true
+  }
+];
+function buildFallbackCatalog(options) {
+  const appName = options.appName;
+  const limit = typeof options.limit === "number" ? options.limit : 3;
+  let items = FALLBACK_APPS_CATALOG.filter((app) => app.enabled !== false);
+  if (appName) {
+    items = items.filter((app) => app.key !== appName);
+  }
+  if (limit > 0) {
+    items = items.slice(0, limit);
+  }
+  return items;
+}
+async function fetchAppsCatalog(options = {}) {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const logger = options.logger ?? console;
+  const appName = options.appName;
+  const baseUrl = stripTrailingSlash(options.appsCatalogUrl ?? DEFAULT_APPS_CATALOG_URL);
+  const limit = typeof options.limit === "number" ? options.limit : 3;
+  const params = new URLSearchParams();
+  if (appName) params.set("appName", appName);
+  if (limit > 0) params.set("limit", String(limit));
+  const url = params.toString() ? `${baseUrl}?${params.toString()}` : baseUrl;
+  if (!fetchImpl) {
+    logger?.error?.("Failed to fetch apps catalog", {
+      error: "Fetch implementation is required"
+    });
+    return buildFallbackCatalog(options);
+  }
+  try {
+    const response = await fetchImpl(url);
+    const text = await response.text();
+    const parsed = safeJsonParse(text);
+    if (!response.ok || !parsed) {
+      logger?.error?.("Failed to fetch apps catalog", { status: response.status });
+      return buildFallbackCatalog(options);
+    }
+    return parsed;
+  } catch (error) {
+    logger?.error?.("Failed to fetch apps catalog", {
+      error: error instanceof Error ? error.message : String(error)
+    });
+    return buildFallbackCatalog(options);
+  }
+}
+async function getCrossSellOffersFromApi(options = {}) {
+  const appsCatalog = options.appsCatalog ?? await fetchAppsCatalog(options);
+  return getCrossSellOffers({ ...options, appsCatalog });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  fetchAppsCatalog,
+  getCrossSellOffers,
+  getCrossSellOffersFromApi
+});

package/dist/crossSell.d.cts

@@ -0,0 +1 @@
+export { f as fetchAppsCatalog, g as getCrossSellOffers, c as getCrossSellOffersFromApi } from './crossSell-BFz9e72n.cjs';

package/dist/crossSell.d.ts

@@ -0,0 +1 @@
+export { f as fetchAppsCatalog, g as getCrossSellOffers, c as getCrossSellOffersFromApi } from './crossSell-BFz9e72n.js';

package/dist/crossSell.js

@@ -0,0 +1,10 @@
+import {
+  fetchAppsCatalog,
+  getCrossSellOffers,
+  getCrossSellOffersFromApi
+} from "./chunk-WZ5FAA44.js";
+export {
+  fetchAppsCatalog,
+  getCrossSellOffers,
+  getCrossSellOffersFromApi
+};

package/dist/index.cjs

@@ -21,6 +21,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   createProgusConnector: () => createProgusConnector,
+  fetchAppsCatalog: () => fetchAppsCatalog,
+  getCrossSellOffers: () => getCrossSellOffers,
+  getCrossSellOffersFromApi: () => getCrossSellOffersFromApi,
   normalizePartnerId: () => normalizePartnerId,
   signPayload: () => signPayload
 });
@@ -61,7 +64,19 @@ function createProgusConnector(config) {
   const enableIdempotency = config.enableIdempotency !== false;
   const validSubscriptionPeriods = /* @__PURE__ */ new Set(["ANNUAL", "EVERY_30_DAYS"]);
   if (!fetchImpl) {
-    throw new Error("Fetch implementation is required");
+    const message = "Fetch implementation is required";
+    logger?.error?.(message);
+    const fail = async () => ({ success: false, message });
+    return {
+      track: async () => ({ success: false, message }),
+      trackInstall: fail,
+      trackUninstall: fail,
+      trackSubscriptionPurchased: fail,
+      trackSubscriptionUpdated: fail,
+      trackSubscriptionCancelled: fail,
+      assignPartnerId: fail,
+      checkPartnerId: async () => ({ success: false, message, status: 500 })
+    };
   }
   async function postEvent(eventName, payload) {
     const { shopDomain, partnerId, data, externalId } = payload;
@@ -234,9 +249,111 @@ function createProgusConnector(config) {
     checkPartnerId
   };
 }
+
+// src/crossSell.ts
+function getCrossSellOffers(options = {}) {
+  const appsCatalog = options.appsCatalog ?? [];
+  const installedKeys = new Set(
+    [options.appName, ...options.installedAppKeys ?? []].filter(
+      (key) => Boolean(key)
+    )
+  );
+  const locale = options.locale;
+  return appsCatalog.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 DEFAULT_APPS_CATALOG_URL = "https://appsdata.progus.com/recommendations";
+var FALLBACK_APPS_CATALOG = [
+  {
+    key: "progus_ai_studio",
+    type: "app",
+    title: "Progus AI Studio",
+    company: "Progus",
+    companyUrl: "https://progus.com",
+    desc: "Generate on-brand AI product & variant images in bulk.",
+    url: "https://apps.shopify.com/progus-ai-studio",
+    icon: "https://cdn.shopify.com/app-store/listing_images/9428a41ed53c66cd7329a2583cd2f3d9/icon/COje1rnS4pEDEAE=.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: 80,
+    enabled: true
+  },
+  {
+    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: 90,
+    enabled: true
+  }
+];
+function buildFallbackCatalog(options) {
+  const appName = options.appName;
+  const limit = typeof options.limit === "number" ? options.limit : 3;
+  let items = FALLBACK_APPS_CATALOG.filter((app) => app.enabled !== false);
+  if (appName) {
+    items = items.filter((app) => app.key !== appName);
+  }
+  if (limit > 0) {
+    items = items.slice(0, limit);
+  }
+  return items;
+}
+async function fetchAppsCatalog(options = {}) {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const logger = options.logger ?? console;
+  const appName = options.appName;
+  const baseUrl = stripTrailingSlash(options.appsCatalogUrl ?? DEFAULT_APPS_CATALOG_URL);
+  const limit = typeof options.limit === "number" ? options.limit : 3;
+  const params = new URLSearchParams();
+  if (appName) params.set("appName", appName);
+  if (limit > 0) params.set("limit", String(limit));
+  const url = params.toString() ? `${baseUrl}?${params.toString()}` : baseUrl;
+  if (!fetchImpl) {
+    logger?.error?.("Failed to fetch apps catalog", {
+      error: "Fetch implementation is required"
+    });
+    return buildFallbackCatalog(options);
+  }
+  try {
+    const response = await fetchImpl(url);
+    const text = await response.text();
+    const parsed = safeJsonParse(text);
+    if (!response.ok || !parsed) {
+      logger?.error?.("Failed to fetch apps catalog", { status: response.status });
+      return buildFallbackCatalog(options);
+    }
+    return parsed;
+  } catch (error) {
+    logger?.error?.("Failed to fetch apps catalog", {
+      error: error instanceof Error ? error.message : String(error)
+    });
+    return buildFallbackCatalog(options);
+  }
+}
+async function getCrossSellOffersFromApi(options = {}) {
+  const appsCatalog = options.appsCatalog ?? await fetchAppsCatalog(options);
+  return getCrossSellOffers({ ...options, appsCatalog });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createProgusConnector,
+  fetchAppsCatalog,
+  getCrossSellOffers,
+  getCrossSellOffersFromApi,
   normalizePartnerId,
   signPayload
 });

package/dist/index.d.cts

@@ -1,49 +1,5 @@
-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 FetchLike = typeof fetch;
-type ConnectorConfig = {
-    appKey: string;
-    apiBaseUrl: string;
-    apiKey?: string;
-    signingSecret?: string;
-    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?: number | string;
-    subscriptionPrice?: number | string;
-    subscriptionPeriod?: string;
-};
+import { C as ConnectorConfig, T as TrackEventParams, a as TrackResult, S as SubscriptionEventData, A as AssignPartnerIdInput, b as CheckPartnerIdResult } from './crossSell-BFz9e72n.cjs';
+export { d as AppsCatalogEntry, e as CrossSellFetchOptions, h as CrossSellOptions, L as Logger, i as TrackEventName, f as fetchAppsCatalog, g as getCrossSellOffers, c as getCrossSellOffersFromApi } from './crossSell-BFz9e72n.cjs';
 
 type Connector = {
     track: (eventName: TrackEventParams["eventName"], payload: Omit<TrackEventParams, "eventName">) => Promise<TrackResult>;
@@ -79,4 +35,4 @@ declare function signPayload(body: string, secret: string): string;
 
 declare function normalizePartnerId(value?: string | null): string | null;
 
-export { type AssignPartnerIdInput, type CheckPartnerIdResult, type ConnectorConfig, type Logger, type SubscriptionEventData, type TrackEventName, type TrackEventParams, type TrackResult, createProgusConnector, normalizePartnerId, signPayload };
+export { AssignPartnerIdInput, CheckPartnerIdResult, ConnectorConfig, SubscriptionEventData, TrackEventParams, TrackResult, createProgusConnector, normalizePartnerId, signPayload };

package/dist/index.d.ts

@@ -1,49 +1,5 @@
-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 FetchLike = typeof fetch;
-type ConnectorConfig = {
-    appKey: string;
-    apiBaseUrl: string;
-    apiKey?: string;
-    signingSecret?: string;
-    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?: number | string;
-    subscriptionPrice?: number | string;
-    subscriptionPeriod?: string;
-};
+import { C as ConnectorConfig, T as TrackEventParams, a as TrackResult, S as SubscriptionEventData, A as AssignPartnerIdInput, b as CheckPartnerIdResult } from './crossSell-BFz9e72n.js';
+export { d as AppsCatalogEntry, e as CrossSellFetchOptions, h as CrossSellOptions, L as Logger, i as TrackEventName, f as fetchAppsCatalog, g as getCrossSellOffers, c as getCrossSellOffersFromApi } from './crossSell-BFz9e72n.js';
 
 type Connector = {
     track: (eventName: TrackEventParams["eventName"], payload: Omit<TrackEventParams, "eventName">) => Promise<TrackResult>;
@@ -79,4 +35,4 @@ declare function signPayload(body: string, secret: string): string;
 
 declare function normalizePartnerId(value?: string | null): string | null;
 
-export { type AssignPartnerIdInput, type CheckPartnerIdResult, type ConnectorConfig, type Logger, type SubscriptionEventData, type TrackEventName, type TrackEventParams, type TrackResult, createProgusConnector, normalizePartnerId, signPayload };
+export { AssignPartnerIdInput, CheckPartnerIdResult, ConnectorConfig, SubscriptionEventData, TrackEventParams, TrackResult, createProgusConnector, normalizePartnerId, signPayload };

package/dist/index.js

@@ -1,30 +1,19 @@
+import {
+  buildEventId,
+  fetchAppsCatalog,
+  getCrossSellOffers,
+  getCrossSellOffersFromApi,
+  normalizePartnerId,
+  safeJsonParse,
+  stripTrailingSlash
+} from "./chunk-WZ5FAA44.js";
+
 // 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) : "";
@@ -33,7 +22,19 @@ function createProgusConnector(config) {
   const enableIdempotency = config.enableIdempotency !== false;
   const validSubscriptionPeriods = /* @__PURE__ */ new Set(["ANNUAL", "EVERY_30_DAYS"]);
   if (!fetchImpl) {
-    throw new Error("Fetch implementation is required");
+    const message = "Fetch implementation is required";
+    logger?.error?.(message);
+    const fail = async () => ({ success: false, message });
+    return {
+      track: async () => ({ success: false, message }),
+      trackInstall: fail,
+      trackUninstall: fail,
+      trackSubscriptionPurchased: fail,
+      trackSubscriptionUpdated: fail,
+      trackSubscriptionCancelled: fail,
+      assignPartnerId: fail,
+      checkPartnerId: async () => ({ success: false, message, status: 500 })
+    };
   }
   async function postEvent(eventName, payload) {
     const { shopDomain, partnerId, data, externalId } = payload;
@@ -208,6 +209,9 @@ function createProgusConnector(config) {
 }
 export {
   createProgusConnector,
+  fetchAppsCatalog,
+  getCrossSellOffers,
+  getCrossSellOffersFromApi,
   normalizePartnerId,
   signPayload
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progus/connector",
-  "version": "0.5.5",
+  "version": "0.6.1",
   "description": "Progus partner/affiliate connector helpers",
   "license": "MIT",
   "type": "module",
@@ -12,6 +12,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./crossSell": {
+      "types": "./dist/crossSell.d.ts",
+      "import": "./dist/crossSell.js",
+      "require": "./dist/crossSell.cjs"
     }
   },
   "files": [
@@ -26,8 +31,8 @@
     "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",
+    "build": "tsup src/index.ts src/crossSell.ts --format esm,cjs --dts --clean --target node18",
+    "dev": "tsup src/index.ts src/crossSell.ts --format esm,cjs --dts --watch --target node18",
     "smoke": "tsx scripts/smoke.ts"
   },
   "devDependencies": {