perspectapi-ts-sdk 5.4.5 → 6.0.1

package/dist/index.js

@@ -399,11 +399,7 @@ var CacheManager = class {
   async getOrSet(key, resolveValue, policy) {
     if (!this.enabled || policy?.skipCache) {
       console.log("[Cache] Cache disabled or skipped", { key, enabled: this.enabled, skipCache: policy?.skipCache });
-      const value2 = await resolveValue();
-      if (this.enabled && !policy?.skipCache && policy?.ttlSeconds !== 0) {
-        await this.set(key, value2, policy);
-      }
-      return value2;
+      return resolveValue();
     }
     const namespacedKey = this.namespacedKey(key);
     const cachedRaw = await this.adapter.get(namespacedKey);
@@ -426,7 +422,7 @@ var CacheManager = class {
     return value;
   }
   async set(key, value, options) {
-    if (!this.enabled || options?.ttlSeconds === 0) {
+    if (!this.enabled) {
       return;
     }
     const namespacedKey = this.namespacedKey(key);
@@ -3422,6 +3418,11 @@ var BaseV2Client = class {
     const response = await this.http.patch(path, body);
     return this.extractData(response);
   }
+  /** PUT to upsert a resource. */
+  async putOne(path, body) {
+    const response = await this.http.put(path, body);
+    return this.extractData(response);
+  }
   /** DELETE a resource. */
   async deleteOne(path) {
     const response = await this.http.delete(path);
@@ -3495,13 +3496,47 @@ var BaseV2Client = class {
 // src/v2/client/content-client.ts
 var ContentV2Client = class extends BaseV2Client {
   async list(siteName, params, cachePolicy) {
-    return this.getList(this.sitePath(siteName, "content"), params, cachePolicy);
+    return this.getList(
+      this.sitePath(siteName, "content"),
+      params,
+      this.withContentTags(siteName, cachePolicy, {
+        category: params?.category,
+        slugPrefix: params?.slug_prefix,
+        type: params?.type
+      })
+    );
   }
-  async *listAutoPaginated(siteName, params) {
-    yield* this.listAutoPaginate(this.sitePath(siteName, "content"), params);
+  async *listAutoPaginated(siteName, params, cachePolicy) {
+    let startingAfter;
+    let hasMore = true;
+    while (hasMore) {
+      const queryParams = { ...params ?? {} };
+      if (startingAfter) {
+        queryParams.starting_after = startingAfter;
+      }
+      const page = await this.list(siteName, queryParams, cachePolicy);
+      for (const item of page.data) {
+        yield item;
+      }
+      hasMore = page.has_more;
+      if (page.data.length > 0) {
+        startingAfter = page.data[page.data.length - 1].id;
+      } else {
+        hasMore = false;
+      }
+    }
   }
   async get(siteName, idOrSlug, cachePolicy) {
-    return this.getOne(this.sitePath(siteName, "content", idOrSlug), void 0, cachePolicy);
+    const isContentId = this.isContentId(idOrSlug);
+    return this.getOne(
+      this.sitePath(siteName, "content", idOrSlug),
+      void 0,
+      this.withContentTags(siteName, cachePolicy, {
+        id: isContentId ? idOrSlug : void 0,
+        slug: isContentId ? void 0 : idOrSlug,
+        slugPrefix: isContentId ? void 0 : this.extractSlugPrefix(idOrSlug)
+      })
+    );
   }
   async create(siteName, data) {
     return this.post(this.sitePath(siteName, "content"), data);
@@ -3518,6 +3553,56 @@ var ContentV2Client = class extends BaseV2Client {
   async unpublish(siteName, id) {
     return this.post(this.sitePath(siteName, "content", `${id}/unpublish`));
   }
+  withContentTags(siteName, cachePolicy, options) {
+    const tags = new Set(cachePolicy?.tags ?? []);
+    for (const tag of this.buildContentTags(siteName, options)) {
+      tags.add(tag);
+    }
+    return {
+      ...cachePolicy,
+      tags: Array.from(tags)
+    };
+  }
+  buildContentTags(siteName, options) {
+    const tags = /* @__PURE__ */ new Set(["content", `content:site:${siteName}`]);
+    const normalizedPrefix = this.normalizeTagPart(options.slugPrefix);
+    const normalizedCategory = this.normalizeTagPart(options.category);
+    const normalizedType = this.normalizeTagPart(options.type);
+    if (options.slug) {
+      tags.add(`content:slug:${siteName}:${options.slug}`);
+    }
+    if (options.id) {
+      tags.add(`content:id:${options.id}`);
+    }
+    if (normalizedPrefix) {
+      tags.add(`content:prefix:${normalizedPrefix}`);
+    }
+    if (normalizedType) {
+      tags.add(`content:${normalizedType}`);
+    }
+    if (normalizedCategory) {
+      tags.add("content:category");
+      tags.add(`content:category:${siteName}:${normalizedCategory}`);
+    }
+    return Array.from(tags);
+  }
+  normalizeTagPart(value) {
+    if (typeof value !== "string") {
+      return void 0;
+    }
+    const normalized = value.trim().toLowerCase();
+    return normalized === "" ? void 0 : normalized;
+  }
+  extractSlugPrefix(slug) {
+    const slashIndex = slug.indexOf("/");
+    if (slashIndex > 0) {
+      return slug.slice(0, slashIndex);
+    }
+    return void 0;
+  }
+  isContentId(idOrSlug) {
+    return /^cnt_/i.test(idOrSlug);
+  }
 };
 
 // src/v2/client/products-client.ts
@@ -3614,18 +3699,38 @@ var OrdersV2Client = class extends BaseV2Client {
   async get(siteName, id, cachePolicy) {
     return this.getOne(this.sitePath(siteName, "orders", id), void 0, cachePolicy);
   }
+  /**
+   * Create a checkout session via Stripe. Returns the session ID and a
+   * `checkout_url` that the client should redirect to (or open in a new tab).
+   *
+   * This replaces the v1 `checkout.createCheckoutSession()` + `getCsrfToken()`
+   * dance — v2 is API-key-only and requires no CSRF token.
+   */
+  async create(siteName, data) {
+    return this.post(
+      this.sitePath(siteName, "orders"),
+      data
+    );
+  }
+  /** Update fulfillment status, tracking number, and/or notes on an order. */
+  async updateFulfillment(siteName, id, data) {
+    return this.patchOne(
+      this.sitePath(siteName, "orders", `${id}/fulfillment`),
+      data
+    );
+  }
 };
 
 // src/v2/client/site-users-client.ts
 var SiteUsersV2Client = class extends BaseV2Client {
-  // --- OTP Auth ---
+  // --- OTP Auth (public, API-key-scoped) ---
   async requestOtp(siteName, data) {
     return this.post(this.sitePath(siteName, "users", "request-otp"), data);
   }
   async verifyOtp(siteName, data) {
     return this.post(this.sitePath(siteName, "users", "verify-otp"), data);
   }
-  // --- Admin ---
+  // --- Admin (API key) ---
   async list(siteName, params) {
     return this.getList(this.sitePath(siteName, "users"), params);
   }
@@ -3638,6 +3743,48 @@ var SiteUsersV2Client = class extends BaseV2Client {
   async update(siteName, id, data) {
     return this.patchOne(this.sitePath(siteName, "users", id), data);
   }
+  // --- Authenticated "me" endpoints (site-user JWT) ---
+  /**
+   * Load the currently-authenticated site user's canonical record plus their
+   * profile KV map. Requires `client.setAuth(jwt)` to have been called with
+   * the token returned from `verifyOtp`.
+   */
+  async getMe(siteName) {
+    return this.getOne(
+      this.sitePath(siteName, "users", "me")
+    );
+  }
+  /** Update the authenticated user's own fields. */
+  async updateMe(siteName, data) {
+    return this.patchOne(
+      this.sitePath(siteName, "users", "me"),
+      data
+    );
+  }
+  /** Fetch the profile KV map as a dedicated `site_user_profile` envelope. */
+  async getProfile(siteName) {
+    return this.getOne(
+      this.sitePath(siteName, "users", "me/profile")
+    );
+  }
+  /**
+   * Set a single profile key. The value is persisted verbatim — callers wanting
+   * structured data should JSON-stringify their value first.
+   */
+  async setProfileValue(siteName, key, value) {
+    const encoded = encodeURIComponent(key);
+    return this.putOne(
+      this.sitePath(siteName, "users", `me/profile/${encoded}`),
+      { value }
+    );
+  }
+  /** Delete a single profile key. */
+  async deleteProfileValue(siteName, key) {
+    const encoded = encodeURIComponent(key);
+    return this.deleteOne(
+      this.sitePath(siteName, "users", `me/profile/${encoded}`)
+    );
+  }
 };
 
 // src/v2/client/newsletter-client.ts
@@ -3709,6 +3856,61 @@ var NewsletterV2Client = class extends BaseV2Client {
       cachePolicy
     );
   }
+  // --- Admin writes: Lists CRUD ---
+  async createList(siteName, data) {
+    return this.post(
+      this.sitePath(siteName, "newsletter", "lists"),
+      data
+    );
+  }
+  async updateList(siteName, id, data) {
+    return this.patchOne(
+      this.sitePath(siteName, "newsletter", `lists/${id}`),
+      data
+    );
+  }
+  async deleteList(siteName, id) {
+    return this.deleteOne(
+      this.sitePath(siteName, "newsletter", `lists/${id}`)
+    );
+  }
+  // --- Admin writes: Subscription sync / membership / import ---
+  /**
+   * Upsert a subscription by email and (optionally) replace its list
+   * memberships. Returns a `newsletter_sync_result` envelope with the
+   * outcome (created / updated / resubscribed / already-unsubscribed).
+   */
+  async syncSubscription(siteName, data) {
+    return this.post(
+      this.sitePath(siteName, "newsletter", "subscriptions/sync"),
+      data
+    );
+  }
+  /**
+   * Add/remove/replace the list memberships for an existing subscription.
+   * Returns the refreshed subscription record.
+   */
+  async updateSubscriptionListMembership(siteName, subscriptionId, data) {
+    return this.post(
+      this.sitePath(
+        siteName,
+        "newsletter",
+        `subscriptions/${subscriptionId}/list-membership`
+      ),
+      data
+    );
+  }
+  /**
+   * Bulk import subscriptions. Each row is upserted via the same sync
+   * path; `refreshListCounts` is deferred until after all rows are
+   * processed on the server.
+   */
+  async importSubscriptions(siteName, data) {
+    return this.post(
+      this.sitePath(siteName, "newsletter", "subscriptions/import"),
+      data
+    );
+  }
 };
 
 // src/v2/client/contacts-client.ts
@@ -3776,6 +3978,102 @@ var WebhooksV2Client = class extends BaseV2Client {
   }
 };
 
+// src/v2/client/subscriptions-client.ts
+var SubscriptionsV2Client = class extends BaseV2Client {
+  // --- Authenticated "me" endpoints (site-user JWT) ---
+  /** List all subscriptions for the authenticated user. */
+  async listMySubscriptions(siteName) {
+    return this.getList(
+      this.sitePath(siteName, "users", "me/subscriptions")
+    );
+  }
+  /** Pause a subscription. */
+  async pauseSubscription(siteName, subId, params) {
+    return this.post(
+      this.sitePath(siteName, "users", `me/subscriptions/${subId}/pause`),
+      params ?? {}
+    );
+  }
+  /** Resume a paused subscription. */
+  async resumeSubscription(siteName, subId) {
+    return this.post(
+      this.sitePath(siteName, "users", `me/subscriptions/${subId}/resume`)
+    );
+  }
+  /** Cancel a subscription. */
+  async cancelSubscription(siteName, subId, params) {
+    return this.post(
+      this.sitePath(siteName, "users", `me/subscriptions/${subId}/cancel`),
+      params ?? {}
+    );
+  }
+  /** Change the plan (price) of a subscription. */
+  async changeSubscriptionPlan(siteName, subId, params) {
+    return this.post(
+      this.sitePath(siteName, "users", `me/subscriptions/${subId}/change-plan`),
+      params
+    );
+  }
+  // --- Admin endpoints (API key) ---
+  /** List subscriptions for a specific user (admin). */
+  async listUserSubscriptions(siteName, userId) {
+    return this.getList(
+      this.sitePath(siteName, "users", `${userId}/subscriptions`)
+    );
+  }
+  /** Pause a user's subscription (admin). */
+  async pauseUserSubscription(siteName, userId, subId, params) {
+    return this.post(
+      this.sitePath(siteName, "users", `${userId}/subscriptions/${subId}/pause`),
+      params ?? {}
+    );
+  }
+  /** Resume a user's paused subscription (admin). */
+  async resumeUserSubscription(siteName, userId, subId) {
+    return this.post(
+      this.sitePath(siteName, "users", `${userId}/subscriptions/${subId}/resume`)
+    );
+  }
+  /** Cancel a user's subscription (admin). */
+  async cancelUserSubscription(siteName, userId, subId, params) {
+    return this.post(
+      this.sitePath(siteName, "users", `${userId}/subscriptions/${subId}/cancel`),
+      params ?? {}
+    );
+  }
+};
+
+// src/v2/client/credits-client.ts
+var CreditsV2Client = class extends BaseV2Client {
+  // --- Authenticated "me" endpoints (site-user JWT) ---
+  /** Get the current credit balance for the authenticated user. */
+  async getMyBalance(siteName) {
+    return this.getOne(
+      this.sitePath(siteName, "users", "me/credits/balance")
+    );
+  }
+  /** Get credit balance and transaction history for the authenticated user. */
+  async getMyCredits(siteName) {
+    return this.getOne(
+      this.sitePath(siteName, "users", "me/credits")
+    );
+  }
+  // --- Admin endpoints (API key) ---
+  /** Get the credit balance for a specific user (admin). */
+  async getUserBalance(siteName, userId) {
+    return this.getOne(
+      this.sitePath(siteName, "users", `${userId}/credits/balance`)
+    );
+  }
+  /** Grant credit to a specific user (admin). */
+  async grantCredit(siteName, userId, data) {
+    return this.post(
+      this.sitePath(siteName, "users", `${userId}/credits/grant`),
+      data
+    );
+  }
+};
+
 // src/v2/index.ts
 var PerspectApiV2Client = class {
   http;
@@ -3792,6 +4090,8 @@ var PerspectApiV2Client = class {
   sites;
   apiKeys;
   webhooks;
+  subscriptions;
+  credits;
   constructor(config) {
     const baseUrl = config.baseUrl.replace(/\/+$/, "");
     const v2BaseUrl = baseUrl.endsWith("/api/v2") ? baseUrl : `${baseUrl}/api/v2`;
@@ -3811,6 +4111,8 @@ var PerspectApiV2Client = class {
     this.sites = new SitesV2Client(this.http, basePath, cache);
     this.apiKeys = new ApiKeysV2Client(this.http, basePath, cache);
     this.webhooks = new WebhooksV2Client(this.http, basePath, cache);
+    this.subscriptions = new SubscriptionsV2Client(this.http, basePath, cache);
+    this.credits = new CreditsV2Client(this.http, basePath, cache);
   }
   /** Update the JWT token for authenticated requests. */
   setAuth(jwt) {