perspectapi-ts-sdk 4.1.0 → 5.0.1

package/dist/index.js

@@ -37,6 +37,8 @@ __export(index_exports, {
   NoopCacheAdapter: () => NoopCacheAdapter,
   OrganizationsClient: () => OrganizationsClient,
   PerspectApiClient: () => PerspectApiClient,
+  PerspectApiV2Client: () => PerspectApiV2Client,
+  PerspectV2Error: () => PerspectV2Error,
   ProductsClient: () => ProductsClient,
   SiteUsersClient: () => SiteUsersClient,
   SitesClient: () => SitesClient,
@@ -45,6 +47,7 @@ __export(index_exports, {
   createApiError: () => createApiError,
   createCheckoutSession: () => createCheckoutSession,
   createPerspectApiClient: () => createPerspectApiClient,
+  createPerspectApiV2Client: () => createPerspectApiV2Client,
   default: () => perspect_api_client_default,
   generateResponsiveImageHtml: () => generateResponsiveImageHtml,
   generateResponsiveUrls: () => generateResponsiveUrls,
@@ -2784,15 +2787,16 @@ var SiteUsersClient = class extends BaseClient {
     );
   }
   /**
-   * Cancel a subscription (marks for cancellation at period end)
+   * Cancel a subscription.
    * @param siteName - The site name
    * @param id - Subscription ID
    * @param csrfToken - CSRF token (required)
+   * @param options - Cancellation mode/details
    */
-  async cancelSubscription(siteName, id, csrfToken) {
+  async cancelSubscription(siteName, id, csrfToken, options) {
     return this.create(
       this.siteUserEndpoint(siteName, `/users/me/subscriptions/${encodeURIComponent(id)}/cancel`),
-      {},
+      options ?? {},
       csrfToken
     );
   }
@@ -3022,11 +3026,12 @@ var SiteUsersClient = class extends BaseClient {
    * @param siteName - The site name
    * @param userId - User ID
    * @param subscriptionId - Subscription ID
+   * @param options - Cancellation mode/details
    */
-  async cancelUserSubscription(siteName, userId, subscriptionId) {
+  async cancelUserSubscription(siteName, userId, subscriptionId, options) {
     return this.create(
       this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/cancel`),
-      {}
+      options ?? {}
     );
   }
   /**
@@ -3319,6 +3324,446 @@ function createPerspectApiClient(config) {
 }
 var perspect_api_client_default = PerspectApiClient;
 
+// src/v2/client/base-v2-client.ts
+var PerspectV2Error = class extends Error {
+  type;
+  code;
+  param;
+  status;
+  constructor(error, status) {
+    super(error.message);
+    this.name = "PerspectV2Error";
+    this.type = error.type;
+    this.code = error.code;
+    this.param = error.param;
+    this.status = status;
+  }
+};
+var BaseV2Client = class {
+  http;
+  basePath;
+  constructor(http, basePath) {
+    this.http = http;
+    this.basePath = basePath;
+  }
+  buildPath(endpoint) {
+    const clean = endpoint.replace(/^\//, "");
+    return clean ? `${this.basePath}/${clean}` : this.basePath;
+  }
+  sitePath(siteName, resource, suffix = "") {
+    const encoded = encodeURIComponent(siteName.trim());
+    const cleanSuffix = suffix.replace(/^\//, "");
+    const end = cleanSuffix ? `/${cleanSuffix}` : "";
+    return `/sites/${encoded}/${resource}${end}`;
+  }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  toParams(params) {
+    if (!params) return void 0;
+    const out = {};
+    for (const [k, v] of Object.entries(params)) {
+      if (v !== void 0 && v !== null) out[k] = String(v);
+    }
+    return Object.keys(out).length > 0 ? out : void 0;
+  }
+  /**
+   * Extract v2 payload from HttpClient response.
+   *
+   * The shared HttpClient wraps responses in a v1-style { success, data } envelope.
+   * v2 API responses don't have a `success` field — the HttpClient already throws
+   * on HTTP errors, so if we reach this point the request succeeded.
+   *
+   * The HttpClient may return the v2 payload nested under `data` (when the response
+   * JSON contains a `data` key, which v2 list responses do) or as a direct wrap.
+   * We unwrap accordingly.
+   */
+  extractData(response) {
+    const payload = response.data;
+    if (payload && typeof payload === "object" && "error" in payload) {
+      const errObj = payload.error;
+      if (errObj && typeof errObj === "object" && "type" in errObj) {
+        throw this.toError(response);
+      }
+    }
+    return payload;
+  }
+  /** GET a single resource. */
+  async getOne(path, params) {
+    const response = await this.http.get(path, this.toParams(params));
+    return this.extractData(response);
+  }
+  /** GET a list of resources with cursor pagination. */
+  async getList(path, params) {
+    const response = await this.http.get(path, this.toParams(params));
+    return this.extractData(response);
+  }
+  /** POST to create a resource. */
+  async post(path, body) {
+    const response = await this.http.post(path, body);
+    return this.extractData(response);
+  }
+  /** PATCH to update a resource. */
+  async patchOne(path, body) {
+    const response = await this.http.patch(path, body);
+    return this.extractData(response);
+  }
+  /** DELETE a resource. */
+  async deleteOne(path) {
+    const response = await this.http.delete(path);
+    return this.extractData(response);
+  }
+  /**
+   * Auto-paginating async generator.
+   * Yields every item across all pages.
+   *
+   * Usage:
+   *   for await (const item of client.listAutoPaginate(path, params)) { ... }
+   */
+  async *listAutoPaginate(path, params) {
+    let startingAfter;
+    let hasMore = true;
+    while (hasMore) {
+      const queryParams = { ...params };
+      if (startingAfter) queryParams.starting_after = startingAfter;
+      const page = await this.getList(path, queryParams);
+      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;
+      }
+    }
+  }
+  toError(response) {
+    const data = response.data;
+    const errorObj = data?.error ?? response.error;
+    if (errorObj && typeof errorObj === "object" && "type" in errorObj) {
+      return new PerspectV2Error(errorObj, 400);
+    }
+    return new PerspectV2Error(
+      { type: "api_error", code: "unknown", message: response.message ?? "Unknown error" },
+      500
+    );
+  }
+};
+
+// src/v2/client/content-client.ts
+var ContentV2Client = class extends BaseV2Client {
+  async list(siteName, params) {
+    return this.getList(this.sitePath(siteName, "content"), params);
+  }
+  async *listAutoPaginated(siteName, params) {
+    yield* this.listAutoPaginate(this.sitePath(siteName, "content"), params);
+  }
+  async get(siteName, idOrSlug) {
+    return this.getOne(this.sitePath(siteName, "content", idOrSlug));
+  }
+  async create(siteName, data) {
+    return this.post(this.sitePath(siteName, "content"), data);
+  }
+  async update(siteName, id, data) {
+    return this.patchOne(this.sitePath(siteName, "content", id), data);
+  }
+  async del(siteName, id) {
+    return this.deleteOne(this.sitePath(siteName, "content", id));
+  }
+  async publish(siteName, id) {
+    return this.post(this.sitePath(siteName, "content", `${id}/publish`));
+  }
+  async unpublish(siteName, id) {
+    return this.post(this.sitePath(siteName, "content", `${id}/unpublish`));
+  }
+};
+
+// src/v2/client/products-client.ts
+var ProductsV2Client = class extends BaseV2Client {
+  async list(siteName, params) {
+    return this.getList(this.sitePath(siteName, "products"), params);
+  }
+  async *listAutoPaginated(siteName, params) {
+    yield* this.listAutoPaginate(this.sitePath(siteName, "products"), params);
+  }
+  async get(siteName, idOrSlug) {
+    return this.getOne(this.sitePath(siteName, "products", idOrSlug));
+  }
+  async create(siteName, data) {
+    return this.post(this.sitePath(siteName, "products"), data);
+  }
+  async update(siteName, id, data) {
+    return this.patchOne(this.sitePath(siteName, "products", id), data);
+  }
+  async del(siteName, id) {
+    return this.deleteOne(this.sitePath(siteName, "products", id));
+  }
+};
+
+// src/v2/client/categories-client.ts
+var CategoriesV2Client = class extends BaseV2Client {
+  async list(siteName, params) {
+    return this.getList(this.sitePath(siteName, "categories"), params);
+  }
+  async get(siteName, id) {
+    return this.getOne(this.sitePath(siteName, "categories", id));
+  }
+  async create(siteName, data) {
+    return this.post(this.sitePath(siteName, "categories"), data);
+  }
+  async update(siteName, id, data) {
+    return this.patchOne(this.sitePath(siteName, "categories", id), data);
+  }
+  async del(siteName, id) {
+    return this.deleteOne(this.sitePath(siteName, "categories", id));
+  }
+};
+
+// src/v2/client/collections-client.ts
+var CollectionsV2Client = class extends BaseV2Client {
+  async list(siteName, params) {
+    return this.getList(this.sitePath(siteName, "collections"), params);
+  }
+  async getCurrent(siteName) {
+    const result = await this.getOne(
+      this.sitePath(siteName, "collections", "current")
+    );
+    return result ?? null;
+  }
+  async get(siteName, id) {
+    return this.getOne(this.sitePath(siteName, "collections", id));
+  }
+  async create(siteName, data) {
+    return this.post(this.sitePath(siteName, "collections"), data);
+  }
+  async update(siteName, id, data) {
+    return this.patchOne(this.sitePath(siteName, "collections", id), data);
+  }
+  async del(siteName, id) {
+    return this.deleteOne(this.sitePath(siteName, "collections", id));
+  }
+  // --- Items ---
+  async listItems(siteName, collectionId) {
+    return this.getList(
+      this.sitePath(siteName, "collections", `${collectionId}/items`)
+    );
+  }
+  async addItem(siteName, collectionId, data) {
+    return this.post(
+      this.sitePath(siteName, "collections", `${collectionId}/items`),
+      data
+    );
+  }
+  async removeItem(siteName, collectionId, itemId) {
+    return this.deleteOne(
+      this.sitePath(siteName, "collections", `${collectionId}/items/${itemId}`)
+    );
+  }
+};
+
+// src/v2/client/orders-client.ts
+var OrdersV2Client = class extends BaseV2Client {
+  async list(siteName, params) {
+    return this.getList(this.sitePath(siteName, "orders"), params);
+  }
+  async *listAutoPaginated(siteName, params) {
+    yield* this.listAutoPaginate(this.sitePath(siteName, "orders"), params);
+  }
+  async get(siteName, id) {
+    return this.getOne(this.sitePath(siteName, "orders", id));
+  }
+};
+
+// src/v2/client/site-users-client.ts
+var SiteUsersV2Client = class extends BaseV2Client {
+  // --- OTP Auth ---
+  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 ---
+  async list(siteName, params) {
+    return this.getList(this.sitePath(siteName, "users"), params);
+  }
+  async *listAutoPaginated(siteName, params) {
+    yield* this.listAutoPaginate(this.sitePath(siteName, "users"), params);
+  }
+  async get(siteName, id) {
+    return this.getOne(this.sitePath(siteName, "users", id));
+  }
+  async update(siteName, id, data) {
+    return this.patchOne(this.sitePath(siteName, "users", id), data);
+  }
+};
+
+// src/v2/client/newsletter-client.ts
+var NewsletterV2Client = class extends BaseV2Client {
+  // --- Subscribe / Unsubscribe ---
+  async subscribe(siteName, data) {
+    return this.post(
+      this.sitePath(siteName, "newsletter", "subscribe"),
+      data
+    );
+  }
+  async confirm(siteName, token) {
+    return this.getOne(
+      this.sitePath(siteName, "newsletter", `confirm/${token}`)
+    );
+  }
+  async unsubscribe(siteName, data) {
+    return this.post(
+      this.sitePath(siteName, "newsletter", "unsubscribe"),
+      data
+    );
+  }
+  // --- Subscriptions (admin) ---
+  async listSubscriptions(siteName, params) {
+    return this.getList(
+      this.sitePath(siteName, "newsletter", "subscriptions"),
+      params
+    );
+  }
+  async getSubscription(siteName, id) {
+    return this.getOne(
+      this.sitePath(siteName, "newsletter", `subscriptions/${id}`)
+    );
+  }
+  // --- Lists ---
+  async listLists(siteName) {
+    return this.getList(
+      this.sitePath(siteName, "newsletter", "lists")
+    );
+  }
+  // --- Campaigns ---
+  async listCampaigns(siteName, params) {
+    return this.getList(
+      this.sitePath(siteName, "newsletter", "campaigns"),
+      params
+    );
+  }
+  async getCampaign(siteName, idOrSlug) {
+    return this.getOne(
+      this.sitePath(siteName, "newsletter", `campaigns/${idOrSlug}`)
+    );
+  }
+};
+
+// src/v2/client/contacts-client.ts
+var ContactsV2Client = class extends BaseV2Client {
+  async submit(siteName, data) {
+    return this.post(this.sitePath(siteName, "contacts"), data);
+  }
+  async list(siteName, params) {
+    return this.getList(this.sitePath(siteName, "contacts"), params);
+  }
+  async get(siteName, id) {
+    return this.getOne(this.sitePath(siteName, "contacts", id));
+  }
+};
+
+// src/v2/client/organizations-client.ts
+var OrganizationsV2Client = class extends BaseV2Client {
+  async list() {
+    return this.getList("/organizations");
+  }
+  async get(id) {
+    return this.getOne(`/organizations/${id}`);
+  }
+};
+
+// src/v2/client/sites-client.ts
+var SitesV2Client = class extends BaseV2Client {
+  async list(params) {
+    return this.getList("/sites", params);
+  }
+  async get(name) {
+    return this.getOne(`/sites/${encodeURIComponent(name)}`);
+  }
+};
+
+// src/v2/client/api-keys-client.ts
+var ApiKeysV2Client = class extends BaseV2Client {
+  async list(params) {
+    return this.getList("/api-keys", params);
+  }
+  async get(id) {
+    return this.getOne(`/api-keys/${id}`);
+  }
+  async del(id) {
+    return this.deleteOne(`/api-keys/${id}`);
+  }
+};
+
+// src/v2/client/webhooks-client.ts
+var WebhooksV2Client = class extends BaseV2Client {
+  async list(siteName, params) {
+    return this.getList(this.sitePath(siteName, "webhooks"), params);
+  }
+  async get(siteName, id) {
+    return this.getOne(this.sitePath(siteName, "webhooks", id));
+  }
+  async create(siteName, data) {
+    return this.post(this.sitePath(siteName, "webhooks"), data);
+  }
+  async update(siteName, id, data) {
+    return this.patchOne(this.sitePath(siteName, "webhooks", id), data);
+  }
+  async del(siteName, id) {
+    return this.deleteOne(this.sitePath(siteName, "webhooks", id));
+  }
+};
+
+// src/v2/index.ts
+var PerspectApiV2Client = class {
+  http;
+  content;
+  products;
+  categories;
+  collections;
+  orders;
+  siteUsers;
+  newsletter;
+  contacts;
+  organizations;
+  sites;
+  apiKeys;
+  webhooks;
+  constructor(config) {
+    const baseUrl = config.baseUrl.replace(/\/+$/, "");
+    const v2BaseUrl = baseUrl.endsWith("/api/v2") ? baseUrl : `${baseUrl}/api/v2`;
+    this.http = new HttpClient({ ...config, baseUrl: v2BaseUrl });
+    const basePath = "";
+    this.content = new ContentV2Client(this.http, basePath);
+    this.products = new ProductsV2Client(this.http, basePath);
+    this.categories = new CategoriesV2Client(this.http, basePath);
+    this.collections = new CollectionsV2Client(this.http, basePath);
+    this.orders = new OrdersV2Client(this.http, basePath);
+    this.siteUsers = new SiteUsersV2Client(this.http, basePath);
+    this.newsletter = new NewsletterV2Client(this.http, basePath);
+    this.contacts = new ContactsV2Client(this.http, basePath);
+    this.organizations = new OrganizationsV2Client(this.http, basePath);
+    this.sites = new SitesV2Client(this.http, basePath);
+    this.apiKeys = new ApiKeysV2Client(this.http, basePath);
+    this.webhooks = new WebhooksV2Client(this.http, basePath);
+  }
+  /** Update the JWT token for authenticated requests. */
+  setAuth(jwt) {
+    this.http.setAuth(jwt);
+  }
+  /** Update the API key. */
+  setApiKey(apiKey) {
+    this.http.setApiKey(apiKey);
+  }
+  /** Clear authentication. */
+  clearAuth() {
+    this.http.clearAuth();
+  }
+};
+function createPerspectApiV2Client(config) {
+  return new PerspectApiV2Client(config);
+}
+
 // src/utils/image-transform.ts
 var DEFAULT_IMAGE_SIZES = {
   thumbnail: {
@@ -3944,6 +4389,8 @@ async function createCheckoutSession(options) {
   NoopCacheAdapter,
   OrganizationsClient,
   PerspectApiClient,
+  PerspectApiV2Client,
+  PerspectV2Error,
   ProductsClient,
   SiteUsersClient,
   SitesClient,
@@ -3952,6 +4399,7 @@ async function createCheckoutSession(options) {
   createApiError,
   createCheckoutSession,
   createPerspectApiClient,
+  createPerspectApiV2Client,
   generateResponsiveImageHtml,
   generateResponsiveUrls,
   generateSizesAttribute,