perspectapi-ts-sdk 3.0.2 → 3.2.0

package/dist/index.js

@@ -23,6 +23,7 @@ __export(index_exports, {
   ApiKeysClient: () => ApiKeysClient,
   AuthClient: () => AuthClient,
   BaseClient: () => BaseClient,
+  BundlesClient: () => BundlesClient,
   CacheManager: () => CacheManager,
   CategoriesClient: () => CategoriesClient,
   CheckoutClient: () => CheckoutClient,
@@ -2473,6 +2474,51 @@ var SiteUsersClient = class extends BaseClient {
       csrfToken
     );
   }
+  /**
+   * Pause a subscription via Stripe pause_collection
+   * @param siteName - The site name
+   * @param subscriptionId - Subscription ID
+   * @param csrfToken - CSRF token (required)
+   * @param resumesAt - Optional ISO date string when subscription should auto-resume
+   */
+  async pauseSubscription(siteName, subscriptionId, csrfToken, resumesAt) {
+    const body = {};
+    if (resumesAt) {
+      body.resumes_at = resumesAt;
+    }
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/me/subscriptions/${encodeURIComponent(subscriptionId)}/pause`),
+      body,
+      csrfToken
+    );
+  }
+  /**
+   * Resume a paused subscription
+   * @param siteName - The site name
+   * @param subscriptionId - Subscription ID
+   * @param csrfToken - CSRF token (required)
+   */
+  async resumeSubscription(siteName, subscriptionId, csrfToken) {
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/me/subscriptions/${encodeURIComponent(subscriptionId)}/resume`),
+      {},
+      csrfToken
+    );
+  }
+  /**
+   * Change subscription plan tier
+   * @param siteName - The site name
+   * @param subscriptionId - Subscription ID
+   * @param productId - New product ID to switch to
+   * @param csrfToken - CSRF token (required)
+   */
+  async changeSubscriptionPlan(siteName, subscriptionId, productId, csrfToken) {
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/me/subscriptions/${encodeURIComponent(subscriptionId)}/change-plan`),
+      { product_id: productId },
+      csrfToken
+    );
+  }
   /**
    * Get linked newsletter subscriptions
    * @param siteName - The site name
@@ -2483,6 +2529,29 @@ var SiteUsersClient = class extends BaseClient {
     );
   }
   // ============================================================================
+  // CREDIT ENDPOINTS (site user JWT required)
+  // ============================================================================
+  /**
+   * Get current credit balance
+   * @param siteName - The site name
+   */
+  async getCreditBalance(siteName) {
+    return this.getSingle(
+      this.siteUserEndpoint(siteName, "/users/me/credits/balance")
+    );
+  }
+  /**
+   * Get credit balance and paginated transactions
+   * @param siteName - The site name
+   * @param params - Pagination params
+   */
+  async getCreditTransactions(siteName, params) {
+    return this.http.get(
+      this.buildPath(this.siteUserEndpoint(siteName, "/users/me/credits")),
+      params
+    );
+  }
+  // ============================================================================
   // ADMIN ENDPOINTS (API key auth required)
   // ============================================================================
   /**
@@ -2520,6 +2589,195 @@ var SiteUsersClient = class extends BaseClient {
       csrfToken
     );
   }
+  /**
+   * Grant credit to a user (admin only)
+   * Adds credit to the user's ledger and Stripe Customer Balance.
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param data - Amount in cents and description
+   * @param csrfToken - CSRF token (required)
+   */
+  async grantCredit(siteName, userId, data, csrfToken) {
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/credits/grant`),
+      data,
+      csrfToken
+    );
+  }
+};
+
+// src/client/bundles-client.ts
+var BundlesClient = class extends BaseClient {
+  constructor(http, cache) {
+    super(http, "/api/v1", cache);
+  }
+  // ============================================================================
+  // BUNDLE GROUPS (structural "pick N items" on a product)
+  // ============================================================================
+  async getBundleGroups(siteName, productId, cachePolicy) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/products/${productId}/bundle-groups`,
+      { includeSitesSegment: false }
+    );
+    const path = this.buildPath(endpoint);
+    return this.fetchWithCache(
+      endpoint,
+      void 0,
+      this.buildBundleTags(siteName, [`bundles:product:${productId}`]),
+      cachePolicy,
+      () => this.http.get(path)
+    );
+  }
+  async createBundleGroup(siteName, productId, data) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/products/${productId}/bundle-groups`,
+      { includeSitesSegment: false }
+    );
+    return this.create(endpoint, data);
+  }
+  async updateBundleGroup(siteName, productId, bundleGroupId, data) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/products/${productId}/bundle-groups/${bundleGroupId}`,
+      { includeSitesSegment: false }
+    );
+    return this.patch(endpoint, data);
+  }
+  async deleteBundleGroup(siteName, productId, bundleGroupId) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/products/${productId}/bundle-groups/${bundleGroupId}`,
+      { includeSitesSegment: false }
+    );
+    return this.delete(endpoint);
+  }
+  // ============================================================================
+  // BUNDLE COLLECTIONS (time-bounded, site-scoped sets of products)
+  // ============================================================================
+  async getCollections(siteName, cachePolicy) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      "/collections",
+      { includeSitesSegment: false }
+    );
+    const path = this.buildPath(endpoint);
+    return this.fetchWithCache(
+      endpoint,
+      void 0,
+      this.buildCollectionTags(siteName, ["collections:list"]),
+      cachePolicy,
+      () => this.http.get(path)
+    );
+  }
+  async getCurrentCollection(siteName, cachePolicy) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      "/collections/current",
+      { includeSitesSegment: false }
+    );
+    const path = this.buildPath(endpoint);
+    return this.fetchWithCache(
+      endpoint,
+      void 0,
+      this.buildCollectionTags(siteName, ["collections:current"]),
+      cachePolicy,
+      () => this.http.get(path)
+    );
+  }
+  async getCollection(siteName, collectionId, cachePolicy) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/collections/${collectionId}`,
+      { includeSitesSegment: false }
+    );
+    const path = this.buildPath(endpoint);
+    return this.fetchWithCache(
+      endpoint,
+      void 0,
+      this.buildCollectionTags(siteName, [`collections:id:${collectionId}`]),
+      cachePolicy,
+      () => this.http.get(path)
+    );
+  }
+  async createCollection(siteName, data) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      "/collections",
+      { includeSitesSegment: false }
+    );
+    return this.create(endpoint, data);
+  }
+  async updateCollection(siteName, collectionId, data) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/collections/${collectionId}`,
+      { includeSitesSegment: false }
+    );
+    return this.patch(endpoint, data);
+  }
+  async deleteCollection(siteName, collectionId) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/collections/${collectionId}`,
+      { includeSitesSegment: false }
+    );
+    return this.delete(endpoint);
+  }
+  // ============================================================================
+  // COLLECTION ITEMS
+  // ============================================================================
+  async getCollectionItems(siteName, collectionId, cachePolicy) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/collections/${collectionId}/items`,
+      { includeSitesSegment: false }
+    );
+    const path = this.buildPath(endpoint);
+    return this.fetchWithCache(
+      endpoint,
+      void 0,
+      this.buildCollectionTags(siteName, [`collections:items:${collectionId}`]),
+      cachePolicy,
+      () => this.http.get(path)
+    );
+  }
+  async addCollectionItem(siteName, collectionId, data) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/collections/${collectionId}/items`,
+      { includeSitesSegment: false }
+    );
+    return this.create(endpoint, data);
+  }
+  async removeCollectionItem(siteName, collectionId, itemId) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/collections/${collectionId}/items/${itemId}`,
+      { includeSitesSegment: false }
+    );
+    return this.delete(endpoint);
+  }
+  // ============================================================================
+  // CACHE TAGS
+  // ============================================================================
+  buildBundleTags(siteName, extraTags = []) {
+    const tags = /* @__PURE__ */ new Set(["bundles"]);
+    if (siteName) {
+      tags.add(`bundles:site:${siteName}`);
+    }
+    extraTags.filter(Boolean).forEach((tag) => tags.add(tag));
+    return Array.from(tags.values());
+  }
+  buildCollectionTags(siteName, extraTags = []) {
+    const tags = /* @__PURE__ */ new Set(["collections"]);
+    if (siteName) {
+      tags.add(`collections:site:${siteName}`);
+    }
+    extraTags.filter(Boolean).forEach((tag) => tags.add(tag));
+    return Array.from(tags.values());
+  }
 };
 
 // src/perspect-api-client.ts
@@ -2539,6 +2797,7 @@ var PerspectApiClient = class {
   contact;
   newsletter;
   siteUsers;
+  bundles;
   constructor(config) {
     if (!config.baseUrl) {
       throw new Error("baseUrl is required in PerspectApiConfig");
@@ -2557,6 +2816,7 @@ var PerspectApiClient = class {
     this.contact = new ContactClient(this.http, this.cache);
     this.newsletter = new NewsletterClient(this.http, this.cache);
     this.siteUsers = new SiteUsersClient(this.http, this.cache);
+    this.bundles = new BundlesClient(this.http, this.cache);
   }
   /**
    * Update authentication token
@@ -3233,6 +3493,7 @@ async function createCheckoutSession(options) {
   ApiKeysClient,
   AuthClient,
   BaseClient,
+  BundlesClient,
   CacheManager,
   CategoriesClient,
   CheckoutClient,

package/dist/index.mjs

@@ -2411,6 +2411,51 @@ var SiteUsersClient = class extends BaseClient {
       csrfToken
     );
   }
+  /**
+   * Pause a subscription via Stripe pause_collection
+   * @param siteName - The site name
+   * @param subscriptionId - Subscription ID
+   * @param csrfToken - CSRF token (required)
+   * @param resumesAt - Optional ISO date string when subscription should auto-resume
+   */
+  async pauseSubscription(siteName, subscriptionId, csrfToken, resumesAt) {
+    const body = {};
+    if (resumesAt) {
+      body.resumes_at = resumesAt;
+    }
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/me/subscriptions/${encodeURIComponent(subscriptionId)}/pause`),
+      body,
+      csrfToken
+    );
+  }
+  /**
+   * Resume a paused subscription
+   * @param siteName - The site name
+   * @param subscriptionId - Subscription ID
+   * @param csrfToken - CSRF token (required)
+   */
+  async resumeSubscription(siteName, subscriptionId, csrfToken) {
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/me/subscriptions/${encodeURIComponent(subscriptionId)}/resume`),
+      {},
+      csrfToken
+    );
+  }
+  /**
+   * Change subscription plan tier
+   * @param siteName - The site name
+   * @param subscriptionId - Subscription ID
+   * @param productId - New product ID to switch to
+   * @param csrfToken - CSRF token (required)
+   */
+  async changeSubscriptionPlan(siteName, subscriptionId, productId, csrfToken) {
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/me/subscriptions/${encodeURIComponent(subscriptionId)}/change-plan`),
+      { product_id: productId },
+      csrfToken
+    );
+  }
   /**
    * Get linked newsletter subscriptions
    * @param siteName - The site name
@@ -2421,6 +2466,29 @@ var SiteUsersClient = class extends BaseClient {
     );
   }
   // ============================================================================
+  // CREDIT ENDPOINTS (site user JWT required)
+  // ============================================================================
+  /**
+   * Get current credit balance
+   * @param siteName - The site name
+   */
+  async getCreditBalance(siteName) {
+    return this.getSingle(
+      this.siteUserEndpoint(siteName, "/users/me/credits/balance")
+    );
+  }
+  /**
+   * Get credit balance and paginated transactions
+   * @param siteName - The site name
+   * @param params - Pagination params
+   */
+  async getCreditTransactions(siteName, params) {
+    return this.http.get(
+      this.buildPath(this.siteUserEndpoint(siteName, "/users/me/credits")),
+      params
+    );
+  }
+  // ============================================================================
   // ADMIN ENDPOINTS (API key auth required)
   // ============================================================================
   /**
@@ -2458,6 +2526,195 @@ var SiteUsersClient = class extends BaseClient {
       csrfToken
     );
   }
+  /**
+   * Grant credit to a user (admin only)
+   * Adds credit to the user's ledger and Stripe Customer Balance.
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param data - Amount in cents and description
+   * @param csrfToken - CSRF token (required)
+   */
+  async grantCredit(siteName, userId, data, csrfToken) {
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/credits/grant`),
+      data,
+      csrfToken
+    );
+  }
+};
+
+// src/client/bundles-client.ts
+var BundlesClient = class extends BaseClient {
+  constructor(http, cache) {
+    super(http, "/api/v1", cache);
+  }
+  // ============================================================================
+  // BUNDLE GROUPS (structural "pick N items" on a product)
+  // ============================================================================
+  async getBundleGroups(siteName, productId, cachePolicy) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/products/${productId}/bundle-groups`,
+      { includeSitesSegment: false }
+    );
+    const path = this.buildPath(endpoint);
+    return this.fetchWithCache(
+      endpoint,
+      void 0,
+      this.buildBundleTags(siteName, [`bundles:product:${productId}`]),
+      cachePolicy,
+      () => this.http.get(path)
+    );
+  }
+  async createBundleGroup(siteName, productId, data) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/products/${productId}/bundle-groups`,
+      { includeSitesSegment: false }
+    );
+    return this.create(endpoint, data);
+  }
+  async updateBundleGroup(siteName, productId, bundleGroupId, data) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/products/${productId}/bundle-groups/${bundleGroupId}`,
+      { includeSitesSegment: false }
+    );
+    return this.patch(endpoint, data);
+  }
+  async deleteBundleGroup(siteName, productId, bundleGroupId) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/products/${productId}/bundle-groups/${bundleGroupId}`,
+      { includeSitesSegment: false }
+    );
+    return this.delete(endpoint);
+  }
+  // ============================================================================
+  // BUNDLE COLLECTIONS (time-bounded, site-scoped sets of products)
+  // ============================================================================
+  async getCollections(siteName, cachePolicy) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      "/collections",
+      { includeSitesSegment: false }
+    );
+    const path = this.buildPath(endpoint);
+    return this.fetchWithCache(
+      endpoint,
+      void 0,
+      this.buildCollectionTags(siteName, ["collections:list"]),
+      cachePolicy,
+      () => this.http.get(path)
+    );
+  }
+  async getCurrentCollection(siteName, cachePolicy) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      "/collections/current",
+      { includeSitesSegment: false }
+    );
+    const path = this.buildPath(endpoint);
+    return this.fetchWithCache(
+      endpoint,
+      void 0,
+      this.buildCollectionTags(siteName, ["collections:current"]),
+      cachePolicy,
+      () => this.http.get(path)
+    );
+  }
+  async getCollection(siteName, collectionId, cachePolicy) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/collections/${collectionId}`,
+      { includeSitesSegment: false }
+    );
+    const path = this.buildPath(endpoint);
+    return this.fetchWithCache(
+      endpoint,
+      void 0,
+      this.buildCollectionTags(siteName, [`collections:id:${collectionId}`]),
+      cachePolicy,
+      () => this.http.get(path)
+    );
+  }
+  async createCollection(siteName, data) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      "/collections",
+      { includeSitesSegment: false }
+    );
+    return this.create(endpoint, data);
+  }
+  async updateCollection(siteName, collectionId, data) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/collections/${collectionId}`,
+      { includeSitesSegment: false }
+    );
+    return this.patch(endpoint, data);
+  }
+  async deleteCollection(siteName, collectionId) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/collections/${collectionId}`,
+      { includeSitesSegment: false }
+    );
+    return this.delete(endpoint);
+  }
+  // ============================================================================
+  // COLLECTION ITEMS
+  // ============================================================================
+  async getCollectionItems(siteName, collectionId, cachePolicy) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/collections/${collectionId}/items`,
+      { includeSitesSegment: false }
+    );
+    const path = this.buildPath(endpoint);
+    return this.fetchWithCache(
+      endpoint,
+      void 0,
+      this.buildCollectionTags(siteName, [`collections:items:${collectionId}`]),
+      cachePolicy,
+      () => this.http.get(path)
+    );
+  }
+  async addCollectionItem(siteName, collectionId, data) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/collections/${collectionId}/items`,
+      { includeSitesSegment: false }
+    );
+    return this.create(endpoint, data);
+  }
+  async removeCollectionItem(siteName, collectionId, itemId) {
+    const endpoint = this.siteScopedEndpoint(
+      siteName,
+      `/collections/${collectionId}/items/${itemId}`,
+      { includeSitesSegment: false }
+    );
+    return this.delete(endpoint);
+  }
+  // ============================================================================
+  // CACHE TAGS
+  // ============================================================================
+  buildBundleTags(siteName, extraTags = []) {
+    const tags = /* @__PURE__ */ new Set(["bundles"]);
+    if (siteName) {
+      tags.add(`bundles:site:${siteName}`);
+    }
+    extraTags.filter(Boolean).forEach((tag) => tags.add(tag));
+    return Array.from(tags.values());
+  }
+  buildCollectionTags(siteName, extraTags = []) {
+    const tags = /* @__PURE__ */ new Set(["collections"]);
+    if (siteName) {
+      tags.add(`collections:site:${siteName}`);
+    }
+    extraTags.filter(Boolean).forEach((tag) => tags.add(tag));
+    return Array.from(tags.values());
+  }
 };
 
 // src/perspect-api-client.ts
@@ -2477,6 +2734,7 @@ var PerspectApiClient = class {
   contact;
   newsletter;
   siteUsers;
+  bundles;
   constructor(config) {
     if (!config.baseUrl) {
       throw new Error("baseUrl is required in PerspectApiConfig");
@@ -2495,6 +2753,7 @@ var PerspectApiClient = class {
     this.contact = new ContactClient(this.http, this.cache);
     this.newsletter = new NewsletterClient(this.http, this.cache);
     this.siteUsers = new SiteUsersClient(this.http, this.cache);
+    this.bundles = new BundlesClient(this.http, this.cache);
   }
   /**
    * Update authentication token
@@ -3170,6 +3429,7 @@ export {
   ApiKeysClient,
   AuthClient,
   BaseClient,
+  BundlesClient,
   CacheManager,
   CategoriesClient,
   CheckoutClient,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perspectapi-ts-sdk",
-  "version": "3.0.2",
+  "version": "3.2.0",
   "description": "TypeScript SDK for PerspectAPI - Cloudflare Workers compatible",
   "main": "dist/index.js",
   "module": "dist/index.mjs",