perspectapi-ts-sdk 6.5.9 → 7.0.1

package/dist/index.js

@@ -76,7 +76,7 @@ module.exports = __toCommonJS(index_exports);
 
 // src/deprecation.ts
 var V1_SUNSET_DATE = "2026-06-01";
-var V1_DEPRECATION_NOTICE = "perspectapi-ts-sdk v1 client is deprecated; sunsets 2026-06-01. New integrations must use createPerspectApiV2Client.";
+var V1_DEPRECATION_NOTICE = "perspectapi-ts-sdk v1 client is deprecated; sunsets 2026-06-01. Do not use it for new code. Use createPerspectApiV2Client from perspectapi-ts-sdk/v2.";
 var warned = false;
 function warnV1Deprecated() {
   if (warned) return;
@@ -978,13 +978,40 @@ var CollectionsV2Client = class extends BaseV2Client {
 // src/v2/client/orders-client.ts
 var OrdersV2Client = class extends BaseV2Client {
   async list(siteName, params, cachePolicy) {
-    return this.getList(this.sitePath(siteName, "orders"), params, cachePolicy);
+    return this.getList(
+      this.sitePath(siteName, "orders"),
+      params,
+      this.withOrderTags(siteName, cachePolicy, {
+        fulfillmentStatus: params?.fulfillment_status
+      })
+    );
   }
-  async *listAutoPaginated(siteName, params) {
-    yield* this.listAutoPaginate(this.sitePath(siteName, "orders"), 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, id, cachePolicy) {
-    return this.getOne(this.sitePath(siteName, "orders", id), void 0, cachePolicy);
+    return this.getOne(
+      this.sitePath(siteName, "orders", id),
+      void 0,
+      this.withOrderTags(siteName, cachePolicy, { id })
+    );
   }
   /**
    * Create a checkout session via Stripe. Returns the session ID and a
@@ -999,12 +1026,48 @@ var OrdersV2Client = class extends BaseV2Client {
       data
     );
   }
-  /** Update fulfillment status, tracking number, and/or notes on an order. */
+  /**
+   * Update fulfillment status, tracking number, and/or notes on an order.
+   *
+   * Set `notify_customer: true` when moving the order into a terminal
+   * fulfillment state to send the customer fulfillment email.
+   */
   async updateFulfillment(siteName, id, data) {
-    return this.patchOne(
+    const result = await this.patchOne(
       this.sitePath(siteName, "orders", `${id}/fulfillment`),
       data
     );
+    await this.invalidateCache({
+      tags: this.buildOrderTags(siteName, { id }),
+      keys: [this.sitePath(siteName, "orders", id)]
+    });
+    return result;
+  }
+  withOrderTags(siteName, cachePolicy, options = {}) {
+    const tags = new Set(cachePolicy?.tags ?? []);
+    for (const tag of this.buildOrderTags(siteName, options)) {
+      tags.add(tag);
+    }
+    return {
+      ...cachePolicy,
+      tags: Array.from(tags)
+    };
+  }
+  buildOrderTags(siteName, options = {}) {
+    const tags = /* @__PURE__ */ new Set(["orders", `orders:site:${siteName}`]);
+    if (options.id) {
+      tags.add(`orders:id:${options.id}`);
+    }
+    const fulfillmentStatus = this.normalizeTagPart(options.fulfillmentStatus);
+    if (fulfillmentStatus) {
+      tags.add(`orders:fulfillment:${siteName}:${fulfillmentStatus}`);
+    }
+    return Array.from(tags);
+  }
+  normalizeTagPart(value) {
+    if (!value) return null;
+    const normalized = value.trim().toLowerCase().replace(/[^a-z0-9_-]+/g, "-");
+    return normalized || null;
   }
 };
 
@@ -1453,6 +1516,7 @@ var BaseClient = class {
   basePath;
   cache;
   constructor(http, basePath, cache) {
+    warnV1Deprecated();
     this.http = http;
     this.basePath = basePath;
     this.cache = cache && cache.isEnabled() ? cache : void 0;