perspectapi-ts-sdk 7.0.0 → 7.1.0

package/dist/{chunk-K3T2AFYA.mjs → chunk-MMKJ2WBF.mjs}

@@ -892,13 +892,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
@@ -920,10 +947,51 @@ var OrdersV2Client = class extends BaseV2Client {
    * 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;
+  }
+  /**
+   * Send the customer fulfillment template for an external delivery/packing
+   * record without mutating a checkout session.
+   */
+  async sendFulfillmentNotification(siteName, data) {
+    return this.post(
+      this.sitePath(siteName, "orders", "fulfillment-notifications"),
+      data
+    );
+  }
+  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;
   }
 };
 
@@ -1309,6 +1377,23 @@ var CreditsV2Client = class extends BaseV2Client {
   }
 };
 
+// src/v2/client/email-client.ts
+var EmailV2Client = class extends BaseV2Client {
+  /**
+   * Send a transactional email using the site's configured email provider.
+   *
+   * Requires a server-side API key — never call this from a browser.
+   * The site must have an email provider configured in its settings.
+   * At least one of `html` or `text` must be provided.
+   */
+  async send(siteName, params) {
+    return this.post(
+      this.sitePath(siteName, "email", "send"),
+      params
+    );
+  }
+};
+
 // src/v2/index.ts
 var PerspectApiV2Client = class {
   http;
@@ -1327,6 +1412,7 @@ var PerspectApiV2Client = class {
   webhooks;
   subscriptions;
   credits;
+  email;
   constructor(config) {
     const baseUrl = config.baseUrl.replace(/\/+$/, "");
     const v2BaseUrl = baseUrl.endsWith("/api/v2") ? baseUrl : `${baseUrl}/api/v2`;
@@ -1348,6 +1434,7 @@ var PerspectApiV2Client = class {
     this.webhooks = new WebhooksV2Client(this.http, basePath, cache);
     this.subscriptions = new SubscriptionsV2Client(this.http, basePath, cache);
     this.credits = new CreditsV2Client(this.http, basePath, cache);
+    this.email = new EmailV2Client(this.http, basePath, cache);
   }
   /** Update the JWT token for authenticated requests. */
   setAuth(jwt) {
@@ -1388,6 +1475,7 @@ export {
   WebhooksV2Client,
   SubscriptionsV2Client,
   CreditsV2Client,
+  EmailV2Client,
   PerspectApiV2Client,
   createPerspectApiV2Client
 };

package/dist/{index-CWvUyMt3.d.mts → index-DuNDHod-.d.mts}

@@ -1462,9 +1462,40 @@ interface V2OrderFulfillmentUpdate {
     fulfillment_status: string;
     tracking_number?: string;
     notes?: string;
+    fulfillment_details_text?: string;
+    fulfillment_details_html?: string;
     /** When true, a terminal fulfillment status triggers a customer email. */
     notify_customer?: boolean;
 }
+interface V2OrderFulfillmentNotificationLineItem {
+    quantity: number;
+    description: string;
+    amount_total?: number;
+    currency?: string;
+}
+interface V2OrderFulfillmentNotificationParams {
+    session_id?: string;
+    order_id?: string;
+    customer_email: string;
+    customer_name?: string;
+    fulfillment_status?: string;
+    fulfillment_details_text?: string;
+    fulfillment_details_html?: string;
+    line_items?: V2OrderFulfillmentNotificationLineItem[];
+    amount_total?: number;
+    currency?: string;
+    shipping_details?: Record<string, unknown>;
+    customer_details?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    created_at?: string;
+}
+interface V2OrderFulfillmentNotificationResult extends V2Object {
+    object: "fulfillment_notification";
+    order_id: string;
+    notified: boolean;
+    queued: boolean;
+    reason?: string;
+}
 interface V2OrderCreateResult extends V2Object {
     object: "checkout_session";
     checkout_url: string | null;
@@ -1802,6 +1833,22 @@ interface V2GrantCreditResult {
     object: "grant_credit_result";
     new_balance_cents: number;
 }
+interface V2EmailSendParams {
+    to: string | string[];
+    subject: string;
+    html?: string;
+    text?: string;
+    from?: string;
+    reply_to?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+}
+interface V2EmailSendResult {
+    object: "email";
+    id: string | null;
+    status: "sent";
+    to: string | string[];
+}
 
 /**
  * v2 Base Client — cursor pagination, expand support, caching, typed errors.
@@ -1941,7 +1988,7 @@ declare class CollectionsV2Client extends BaseV2Client {
 
 declare class OrdersV2Client extends BaseV2Client {
     list(siteName: string, params?: V2OrderListParams, cachePolicy?: CachePolicy): Promise<V2List<V2Order>>;
-    listAutoPaginated(siteName: string, params?: Omit<V2OrderListParams, 'starting_after' | 'ending_before'>): AsyncGenerator<V2Order, void, unknown>;
+    listAutoPaginated(siteName: string, params?: Omit<V2OrderListParams, 'starting_after' | 'ending_before'>, cachePolicy?: CachePolicy): AsyncGenerator<V2Order, void, unknown>;
     get(siteName: string, id: string, cachePolicy?: CachePolicy): Promise<V2Order>;
     /**
      * Create a checkout session via Stripe. Returns the session ID and a
@@ -1958,6 +2005,14 @@ declare class OrdersV2Client extends BaseV2Client {
      * fulfillment state to send the customer fulfillment email.
      */
     updateFulfillment(siteName: string, id: string, data: V2OrderFulfillmentUpdate): Promise<V2Order>;
+    /**
+     * Send the customer fulfillment template for an external delivery/packing
+     * record without mutating a checkout session.
+     */
+    sendFulfillmentNotification(siteName: string, data: V2OrderFulfillmentNotificationParams): Promise<V2OrderFulfillmentNotificationResult>;
+    private withOrderTags;
+    private buildOrderTags;
+    private normalizeTagPart;
 }
 
 /**
@@ -2179,6 +2234,21 @@ declare class CreditsV2Client extends BaseV2Client {
     grantCredit(siteName: string, userId: string, data: V2GrantCreditParams): Promise<V2GrantCreditResult>;
 }
 
+/**
+ * v2 Email Client — send transactional email through a site's configured provider.
+ */
+
+declare class EmailV2Client extends BaseV2Client {
+    /**
+     * Send a transactional email using the site's configured email provider.
+     *
+     * Requires a server-side API key — never call this from a browser.
+     * The site must have an email provider configured in its settings.
+     * At least one of `html` or `text` must be provided.
+     */
+    send(siteName: string, params: V2EmailSendParams): Promise<V2EmailSendResult>;
+}
+
 /**
  * PerspectAPI v2 SDK Client
  *
@@ -2211,6 +2281,7 @@ declare class PerspectApiV2Client {
     readonly webhooks: WebhooksV2Client;
     readonly subscriptions: SubscriptionsV2Client;
     readonly credits: CreditsV2Client;
+    readonly email: EmailV2Client;
     constructor(config: PerspectApiV2Config);
     /** Update the JWT token for authenticated requests. */
     setAuth(jwt: string): void;
@@ -2221,4 +2292,4 @@ declare class PerspectApiV2Client {
 }
 declare function createPerspectApiV2Client(config: PerspectApiConfig): PerspectApiV2Client;
 
-export { type NewsletterManagementList as $, type ApiResponse as A, type CreateNewsletterSubscriptionRequest as B, CacheManager as C, type NewsletterConfirmResponse as D, type NewsletterUnsubscribeRequest as E, type NewsletterUnsubscribeResponse as F, type NewsletterPreferences as G, HttpClient as H, type NewsletterList as I, type NewsletterCampaignListResponse as J, type NewsletterCampaignDetail as K, type NewsletterStatusResponse as L, type NewsletterManagementSubscriptionsListResponse as M, type NewsletterSubscribeResponse as N, type Organization as O, type PaginatedResponse as P, type NewsletterManagementSubscription as Q, type NewsletterSubscriptionSyncRequest as R, type Site as S, type NewsletterSubscriptionSyncResponse as T, type User as U, type NewsletterSubscriptionsBulkUpdateRequest as V, type Webhook as W, type NewsletterSubscriptionsBulkUpdateResponse as X, type NewsletterSubscriptionMembershipUpdateRequest as Y, type NewsletterSubscriptionsImportRequest as Z, type NewsletterSubscriptionsImportResponse as _, type CachePolicy as a, type V2ContentListParams as a$, type NewsletterManagementSeries as a0, type NewsletterManagementCampaignListResponse as a1, type NewsletterManagementCampaign as a2, type NewsletterCampaignTestSendRequest as a3, type NewsletterCampaignTestSendResponse as a4, type NewsletterManagementStatsResponse as a5, type NewsletterExportCreateRequest as a6, type NewsletterExportCreateResponse as a7, type RequestOtpRequest as a8, type VerifyOtpRequest as a9, PerspectV2Error as aA, createApiError as aB, PerspectApiError as aC, type CacheConfig as aD, type ApiError as aE, type MediaItem as aF, type CategorySummary as aG, type PaymentGateway as aH, type NewsletterSubscription as aI, type NewsletterCampaignSummary as aJ, type NewsletterManagementListMembership as aK, type NewsletterSubscriptionsBulkAction as aL, type NewsletterSubscriptionsBulkOutcome as aM, type NewsletterSubscriptionImportRowRequest as aN, type NewsletterSubscriptionsImportRowResult as aO, type NewsletterManagementPagination as aP, type SetProfileValueRequest as aQ, type V2Object as aR, type V2List as aS, type V2Deleted as aT, type V2Error as aU, type V2ErrorType as aV, type V2PaginationParams as aW, type V2Media as aX, type V2Content as aY, type V2ContentCreateParams as aZ, type V2ContentUpdateParams as a_, type VerifyOtpResponse as aa, type SiteUser as ab, type SiteUserProfile as ac, type UpdateSiteUserRequest as ad, type SiteUserOrder as ae, type SiteUserSubscription as af, type CancelSubscriptionRequest as ag, type CancelSubscriptionResponse as ah, type CreditBalance as ai, type CreditBalanceWithTransactions as aj, type GrantCreditRequest as ak, type ProductBundleGroup as al, type CreateBundleGroupRequest as am, type BundleCollection as an, type BundleCollectionItemWithProduct as ao, type CreateBundleCollectionRequest as ap, type AddCollectionItemRequest as aq, type BundleCollectionItem as ar, type PerspectApiConfig as as, type CacheAdapter as at, type BlogPost as au, type CheckoutMetadata as av, type CheckoutAddress as aw, type CheckoutTaxRequest as ax, PerspectApiV2Client as ay, createPerspectApiV2Client as az, type CacheInvalidateOptions as b, type CheckoutMetadataValue as b$, type V2Product as b0, type V2ProductCreateParams as b1, type V2ProductUpdateParams as b2, type V2ProductListParams as b3, type V2Category as b4, type V2CategoryCreateParams as b5, type V2CategoryUpdateParams as b6, type V2Collection as b7, type V2CollectionItem as b8, type V2CollectionCreateParams as b9, type V2NewsletterImportResult as bA, type V2ContactSubmission as bB, type V2Organization as bC, type V2Site as bD, type V2ApiKey as bE, type V2WebhookEventType as bF, type V2Webhook as bG, type V2WebhookCreateParams as bH, type V2WebhookUpdateParams as bI, type V2SiteUserSubscription as bJ, type V2SubscriptionPauseParams as bK, type V2SubscriptionCancelParams as bL, type V2SubscriptionChangePlanParams as bM, type V2SubscriptionChargeParams as bN, type V2SubscriptionChargeResult as bO, type V2CancelSubscriptionResult as bP, type V2CreditTransaction as bQ, type V2CreditBalance as bR, type V2GrantCreditParams as bS, type V2GrantCreditResult as bT, type PaginationParams as bU, type ContentStatus as bV, type ContentType as bW, type ProductSkuMediaItem as bX, type ProductSkuOption as bY, type CreatePaymentGatewayRequest as bZ, type WebhookEventType as b_, type V2CollectionUpdateParams as ba, type V2Order as bb, type V2OrderListParams as bc, type V2OrderLineItemPriceData as bd, type V2OrderLineItem as be, type V2OrderAddress as bf, type V2OrderTaxRequest as bg, type V2OrderCreateParams as bh, type V2OrderFulfillmentUpdate as bi, type V2OrderCreateResult as bj, type V2SiteUser as bk, type V2SiteUserUpdateParams as bl, type V2SiteUserMeUpdateParams as bm, type V2SiteUserListParams as bn, type V2SiteUserWithProfile as bo, type V2SiteUserProfile as bp, type V2NewsletterSubscription as bq, type V2NewsletterList as br, type V2NewsletterCampaign as bs, type V2NewsletterTrackingResponse as bt, type V2NewsletterListCreateParams as bu, type V2NewsletterListUpdateParams as bv, type V2NewsletterSyncInput as bw, type V2NewsletterSyncResult as bx, type V2NewsletterSubscriptionListMembershipUpdate as by, type V2NewsletterImportRequest as bz, type ContentQueryParams as c, type CheckoutTaxStrategy as c0, type CheckoutTaxExemptionStatus as c1, type CheckoutTaxCustomerExemptionRequest as c2, type CheckoutTaxBreakdownItem as c3, type CheckoutSessionTax as c4, type SubscriptionCancellationMode as c5, type CreditTransaction as c6, type HttpMethod as c7, type RequestOptions as c8, type PerspectApiV2Config as c9, BaseV2Client as ca, ContentV2Client as cb, ProductsV2Client as cc, CategoriesV2Client as cd, CollectionsV2Client as ce, OrdersV2Client as cf, SiteUsersV2Client as cg, NewsletterV2Client as ch, ContactsV2Client as ci, OrganizationsV2Client as cj, SitesV2Client as ck, ApiKeysV2Client as cl, WebhooksV2Client as cm, SubscriptionsV2Client as cn, CreditsV2Client as co, type Content as d, type ContentCategoryResponse as e, type CreateContentRequest as f, type UpdateContentRequest as g, type ApiKey as h, type CreateApiKeyRequest as i, type UpdateApiKeyRequest as j, type CreateOrganizationRequest as k, type CreateSiteRequest as l, type ProductQueryParams as m, type Product as n, type CreateProductRequest as o, type ProductSku as p, type CreateProductSkuRequest as q, type Category as r, type CreateCategoryRequest as s, type CreateWebhookRequest as t, type CreateCheckoutSessionRequest as u, type CheckoutSession as v, type CreateContactRequest as w, type ContactSubmitResponse as x, type ContactStatusResponse as y, type ContactSubmission as z };
+export { type NewsletterManagementList as $, type ApiResponse as A, type CreateNewsletterSubscriptionRequest as B, CacheManager as C, type NewsletterConfirmResponse as D, type NewsletterUnsubscribeRequest as E, type NewsletterUnsubscribeResponse as F, type NewsletterPreferences as G, HttpClient as H, type NewsletterList as I, type NewsletterCampaignListResponse as J, type NewsletterCampaignDetail as K, type NewsletterStatusResponse as L, type NewsletterManagementSubscriptionsListResponse as M, type NewsletterSubscribeResponse as N, type Organization as O, type PaginatedResponse as P, type NewsletterManagementSubscription as Q, type NewsletterSubscriptionSyncRequest as R, type Site as S, type NewsletterSubscriptionSyncResponse as T, type User as U, type NewsletterSubscriptionsBulkUpdateRequest as V, type Webhook as W, type NewsletterSubscriptionsBulkUpdateResponse as X, type NewsletterSubscriptionMembershipUpdateRequest as Y, type NewsletterSubscriptionsImportRequest as Z, type NewsletterSubscriptionsImportResponse as _, type CachePolicy as a, type V2ContentListParams as a$, type NewsletterManagementSeries as a0, type NewsletterManagementCampaignListResponse as a1, type NewsletterManagementCampaign as a2, type NewsletterCampaignTestSendRequest as a3, type NewsletterCampaignTestSendResponse as a4, type NewsletterManagementStatsResponse as a5, type NewsletterExportCreateRequest as a6, type NewsletterExportCreateResponse as a7, type RequestOtpRequest as a8, type VerifyOtpRequest as a9, PerspectV2Error as aA, createApiError as aB, PerspectApiError as aC, type CacheConfig as aD, type ApiError as aE, type MediaItem as aF, type CategorySummary as aG, type PaymentGateway as aH, type NewsletterSubscription as aI, type NewsletterCampaignSummary as aJ, type NewsletterManagementListMembership as aK, type NewsletterSubscriptionsBulkAction as aL, type NewsletterSubscriptionsBulkOutcome as aM, type NewsletterSubscriptionImportRowRequest as aN, type NewsletterSubscriptionsImportRowResult as aO, type NewsletterManagementPagination as aP, type SetProfileValueRequest as aQ, type V2Object as aR, type V2List as aS, type V2Deleted as aT, type V2Error as aU, type V2ErrorType as aV, type V2PaginationParams as aW, type V2Media as aX, type V2Content as aY, type V2ContentCreateParams as aZ, type V2ContentUpdateParams as a_, type VerifyOtpResponse as aa, type SiteUser as ab, type SiteUserProfile as ac, type UpdateSiteUserRequest as ad, type SiteUserOrder as ae, type SiteUserSubscription as af, type CancelSubscriptionRequest as ag, type CancelSubscriptionResponse as ah, type CreditBalance as ai, type CreditBalanceWithTransactions as aj, type GrantCreditRequest as ak, type ProductBundleGroup as al, type CreateBundleGroupRequest as am, type BundleCollection as an, type BundleCollectionItemWithProduct as ao, type CreateBundleCollectionRequest as ap, type AddCollectionItemRequest as aq, type BundleCollectionItem as ar, type PerspectApiConfig as as, type CacheAdapter as at, type BlogPost as au, type CheckoutMetadata as av, type CheckoutAddress as aw, type CheckoutTaxRequest as ax, PerspectApiV2Client as ay, createPerspectApiV2Client as az, type CacheInvalidateOptions as b, type ContentType as b$, type V2Product as b0, type V2ProductCreateParams as b1, type V2ProductUpdateParams as b2, type V2ProductListParams as b3, type V2Category as b4, type V2CategoryCreateParams as b5, type V2CategoryUpdateParams as b6, type V2Collection as b7, type V2CollectionItem as b8, type V2CollectionCreateParams as b9, type V2NewsletterSyncResult as bA, type V2NewsletterSubscriptionListMembershipUpdate as bB, type V2NewsletterImportRequest as bC, type V2NewsletterImportResult as bD, type V2ContactSubmission as bE, type V2Organization as bF, type V2Site as bG, type V2ApiKey as bH, type V2WebhookEventType as bI, type V2Webhook as bJ, type V2WebhookCreateParams as bK, type V2WebhookUpdateParams as bL, type V2SiteUserSubscription as bM, type V2SubscriptionPauseParams as bN, type V2SubscriptionCancelParams as bO, type V2SubscriptionChangePlanParams as bP, type V2SubscriptionChargeParams as bQ, type V2SubscriptionChargeResult as bR, type V2CancelSubscriptionResult as bS, type V2CreditTransaction as bT, type V2CreditBalance as bU, type V2GrantCreditParams as bV, type V2GrantCreditResult as bW, type V2EmailSendParams as bX, type V2EmailSendResult as bY, type PaginationParams as bZ, type ContentStatus as b_, type V2CollectionUpdateParams as ba, type V2Order as bb, type V2OrderListParams as bc, type V2OrderLineItemPriceData as bd, type V2OrderLineItem as be, type V2OrderAddress as bf, type V2OrderTaxRequest as bg, type V2OrderCreateParams as bh, type V2OrderFulfillmentUpdate as bi, type V2OrderFulfillmentNotificationLineItem as bj, type V2OrderFulfillmentNotificationParams as bk, type V2OrderFulfillmentNotificationResult as bl, type V2OrderCreateResult as bm, type V2SiteUser as bn, type V2SiteUserUpdateParams as bo, type V2SiteUserMeUpdateParams as bp, type V2SiteUserListParams as bq, type V2SiteUserWithProfile as br, type V2SiteUserProfile as bs, type V2NewsletterSubscription as bt, type V2NewsletterList as bu, type V2NewsletterCampaign as bv, type V2NewsletterTrackingResponse as bw, type V2NewsletterListCreateParams as bx, type V2NewsletterListUpdateParams as by, type V2NewsletterSyncInput as bz, type ContentQueryParams as c, type ProductSkuMediaItem as c0, type ProductSkuOption as c1, type CreatePaymentGatewayRequest as c2, type WebhookEventType as c3, type CheckoutMetadataValue as c4, type CheckoutTaxStrategy as c5, type CheckoutTaxExemptionStatus as c6, type CheckoutTaxCustomerExemptionRequest as c7, type CheckoutTaxBreakdownItem as c8, type CheckoutSessionTax as c9, type SubscriptionCancellationMode as ca, type CreditTransaction as cb, type HttpMethod as cc, type RequestOptions as cd, type PerspectApiV2Config as ce, BaseV2Client as cf, ContentV2Client as cg, ProductsV2Client as ch, CategoriesV2Client as ci, CollectionsV2Client as cj, OrdersV2Client as ck, SiteUsersV2Client as cl, NewsletterV2Client as cm, ContactsV2Client as cn, OrganizationsV2Client as co, SitesV2Client as cp, ApiKeysV2Client as cq, WebhooksV2Client as cr, SubscriptionsV2Client as cs, CreditsV2Client as ct, EmailV2Client as cu, type Content as d, type ContentCategoryResponse as e, type CreateContentRequest as f, type UpdateContentRequest as g, type ApiKey as h, type CreateApiKeyRequest as i, type UpdateApiKeyRequest as j, type CreateOrganizationRequest as k, type CreateSiteRequest as l, type ProductQueryParams as m, type Product as n, type CreateProductRequest as o, type ProductSku as p, type CreateProductSkuRequest as q, type Category as r, type CreateCategoryRequest as s, type CreateWebhookRequest as t, type CreateCheckoutSessionRequest as u, type CheckoutSession as v, type CreateContactRequest as w, type ContactSubmitResponse as x, type ContactStatusResponse as y, type ContactSubmission as z };

package/dist/{index-CWvUyMt3.d.ts → index-DuNDHod-.d.ts}

@@ -1462,9 +1462,40 @@ interface V2OrderFulfillmentUpdate {
     fulfillment_status: string;
     tracking_number?: string;
     notes?: string;
+    fulfillment_details_text?: string;
+    fulfillment_details_html?: string;
     /** When true, a terminal fulfillment status triggers a customer email. */
     notify_customer?: boolean;
 }
+interface V2OrderFulfillmentNotificationLineItem {
+    quantity: number;
+    description: string;
+    amount_total?: number;
+    currency?: string;
+}
+interface V2OrderFulfillmentNotificationParams {
+    session_id?: string;
+    order_id?: string;
+    customer_email: string;
+    customer_name?: string;
+    fulfillment_status?: string;
+    fulfillment_details_text?: string;
+    fulfillment_details_html?: string;
+    line_items?: V2OrderFulfillmentNotificationLineItem[];
+    amount_total?: number;
+    currency?: string;
+    shipping_details?: Record<string, unknown>;
+    customer_details?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    created_at?: string;
+}
+interface V2OrderFulfillmentNotificationResult extends V2Object {
+    object: "fulfillment_notification";
+    order_id: string;
+    notified: boolean;
+    queued: boolean;
+    reason?: string;
+}
 interface V2OrderCreateResult extends V2Object {
     object: "checkout_session";
     checkout_url: string | null;
@@ -1802,6 +1833,22 @@ interface V2GrantCreditResult {
     object: "grant_credit_result";
     new_balance_cents: number;
 }
+interface V2EmailSendParams {
+    to: string | string[];
+    subject: string;
+    html?: string;
+    text?: string;
+    from?: string;
+    reply_to?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+}
+interface V2EmailSendResult {
+    object: "email";
+    id: string | null;
+    status: "sent";
+    to: string | string[];
+}
 
 /**
  * v2 Base Client — cursor pagination, expand support, caching, typed errors.
@@ -1941,7 +1988,7 @@ declare class CollectionsV2Client extends BaseV2Client {
 
 declare class OrdersV2Client extends BaseV2Client {
     list(siteName: string, params?: V2OrderListParams, cachePolicy?: CachePolicy): Promise<V2List<V2Order>>;
-    listAutoPaginated(siteName: string, params?: Omit<V2OrderListParams, 'starting_after' | 'ending_before'>): AsyncGenerator<V2Order, void, unknown>;
+    listAutoPaginated(siteName: string, params?: Omit<V2OrderListParams, 'starting_after' | 'ending_before'>, cachePolicy?: CachePolicy): AsyncGenerator<V2Order, void, unknown>;
     get(siteName: string, id: string, cachePolicy?: CachePolicy): Promise<V2Order>;
     /**
      * Create a checkout session via Stripe. Returns the session ID and a
@@ -1958,6 +2005,14 @@ declare class OrdersV2Client extends BaseV2Client {
      * fulfillment state to send the customer fulfillment email.
      */
     updateFulfillment(siteName: string, id: string, data: V2OrderFulfillmentUpdate): Promise<V2Order>;
+    /**
+     * Send the customer fulfillment template for an external delivery/packing
+     * record without mutating a checkout session.
+     */
+    sendFulfillmentNotification(siteName: string, data: V2OrderFulfillmentNotificationParams): Promise<V2OrderFulfillmentNotificationResult>;
+    private withOrderTags;
+    private buildOrderTags;
+    private normalizeTagPart;
 }
 
 /**
@@ -2179,6 +2234,21 @@ declare class CreditsV2Client extends BaseV2Client {
     grantCredit(siteName: string, userId: string, data: V2GrantCreditParams): Promise<V2GrantCreditResult>;
 }
 
+/**
+ * v2 Email Client — send transactional email through a site's configured provider.
+ */
+
+declare class EmailV2Client extends BaseV2Client {
+    /**
+     * Send a transactional email using the site's configured email provider.
+     *
+     * Requires a server-side API key — never call this from a browser.
+     * The site must have an email provider configured in its settings.
+     * At least one of `html` or `text` must be provided.
+     */
+    send(siteName: string, params: V2EmailSendParams): Promise<V2EmailSendResult>;
+}
+
 /**
  * PerspectAPI v2 SDK Client
  *
@@ -2211,6 +2281,7 @@ declare class PerspectApiV2Client {
     readonly webhooks: WebhooksV2Client;
     readonly subscriptions: SubscriptionsV2Client;
     readonly credits: CreditsV2Client;
+    readonly email: EmailV2Client;
     constructor(config: PerspectApiV2Config);
     /** Update the JWT token for authenticated requests. */
     setAuth(jwt: string): void;
@@ -2221,4 +2292,4 @@ declare class PerspectApiV2Client {
 }
 declare function createPerspectApiV2Client(config: PerspectApiConfig): PerspectApiV2Client;
 
-export { type NewsletterManagementList as $, type ApiResponse as A, type CreateNewsletterSubscriptionRequest as B, CacheManager as C, type NewsletterConfirmResponse as D, type NewsletterUnsubscribeRequest as E, type NewsletterUnsubscribeResponse as F, type NewsletterPreferences as G, HttpClient as H, type NewsletterList as I, type NewsletterCampaignListResponse as J, type NewsletterCampaignDetail as K, type NewsletterStatusResponse as L, type NewsletterManagementSubscriptionsListResponse as M, type NewsletterSubscribeResponse as N, type Organization as O, type PaginatedResponse as P, type NewsletterManagementSubscription as Q, type NewsletterSubscriptionSyncRequest as R, type Site as S, type NewsletterSubscriptionSyncResponse as T, type User as U, type NewsletterSubscriptionsBulkUpdateRequest as V, type Webhook as W, type NewsletterSubscriptionsBulkUpdateResponse as X, type NewsletterSubscriptionMembershipUpdateRequest as Y, type NewsletterSubscriptionsImportRequest as Z, type NewsletterSubscriptionsImportResponse as _, type CachePolicy as a, type V2ContentListParams as a$, type NewsletterManagementSeries as a0, type NewsletterManagementCampaignListResponse as a1, type NewsletterManagementCampaign as a2, type NewsletterCampaignTestSendRequest as a3, type NewsletterCampaignTestSendResponse as a4, type NewsletterManagementStatsResponse as a5, type NewsletterExportCreateRequest as a6, type NewsletterExportCreateResponse as a7, type RequestOtpRequest as a8, type VerifyOtpRequest as a9, PerspectV2Error as aA, createApiError as aB, PerspectApiError as aC, type CacheConfig as aD, type ApiError as aE, type MediaItem as aF, type CategorySummary as aG, type PaymentGateway as aH, type NewsletterSubscription as aI, type NewsletterCampaignSummary as aJ, type NewsletterManagementListMembership as aK, type NewsletterSubscriptionsBulkAction as aL, type NewsletterSubscriptionsBulkOutcome as aM, type NewsletterSubscriptionImportRowRequest as aN, type NewsletterSubscriptionsImportRowResult as aO, type NewsletterManagementPagination as aP, type SetProfileValueRequest as aQ, type V2Object as aR, type V2List as aS, type V2Deleted as aT, type V2Error as aU, type V2ErrorType as aV, type V2PaginationParams as aW, type V2Media as aX, type V2Content as aY, type V2ContentCreateParams as aZ, type V2ContentUpdateParams as a_, type VerifyOtpResponse as aa, type SiteUser as ab, type SiteUserProfile as ac, type UpdateSiteUserRequest as ad, type SiteUserOrder as ae, type SiteUserSubscription as af, type CancelSubscriptionRequest as ag, type CancelSubscriptionResponse as ah, type CreditBalance as ai, type CreditBalanceWithTransactions as aj, type GrantCreditRequest as ak, type ProductBundleGroup as al, type CreateBundleGroupRequest as am, type BundleCollection as an, type BundleCollectionItemWithProduct as ao, type CreateBundleCollectionRequest as ap, type AddCollectionItemRequest as aq, type BundleCollectionItem as ar, type PerspectApiConfig as as, type CacheAdapter as at, type BlogPost as au, type CheckoutMetadata as av, type CheckoutAddress as aw, type CheckoutTaxRequest as ax, PerspectApiV2Client as ay, createPerspectApiV2Client as az, type CacheInvalidateOptions as b, type CheckoutMetadataValue as b$, type V2Product as b0, type V2ProductCreateParams as b1, type V2ProductUpdateParams as b2, type V2ProductListParams as b3, type V2Category as b4, type V2CategoryCreateParams as b5, type V2CategoryUpdateParams as b6, type V2Collection as b7, type V2CollectionItem as b8, type V2CollectionCreateParams as b9, type V2NewsletterImportResult as bA, type V2ContactSubmission as bB, type V2Organization as bC, type V2Site as bD, type V2ApiKey as bE, type V2WebhookEventType as bF, type V2Webhook as bG, type V2WebhookCreateParams as bH, type V2WebhookUpdateParams as bI, type V2SiteUserSubscription as bJ, type V2SubscriptionPauseParams as bK, type V2SubscriptionCancelParams as bL, type V2SubscriptionChangePlanParams as bM, type V2SubscriptionChargeParams as bN, type V2SubscriptionChargeResult as bO, type V2CancelSubscriptionResult as bP, type V2CreditTransaction as bQ, type V2CreditBalance as bR, type V2GrantCreditParams as bS, type V2GrantCreditResult as bT, type PaginationParams as bU, type ContentStatus as bV, type ContentType as bW, type ProductSkuMediaItem as bX, type ProductSkuOption as bY, type CreatePaymentGatewayRequest as bZ, type WebhookEventType as b_, type V2CollectionUpdateParams as ba, type V2Order as bb, type V2OrderListParams as bc, type V2OrderLineItemPriceData as bd, type V2OrderLineItem as be, type V2OrderAddress as bf, type V2OrderTaxRequest as bg, type V2OrderCreateParams as bh, type V2OrderFulfillmentUpdate as bi, type V2OrderCreateResult as bj, type V2SiteUser as bk, type V2SiteUserUpdateParams as bl, type V2SiteUserMeUpdateParams as bm, type V2SiteUserListParams as bn, type V2SiteUserWithProfile as bo, type V2SiteUserProfile as bp, type V2NewsletterSubscription as bq, type V2NewsletterList as br, type V2NewsletterCampaign as bs, type V2NewsletterTrackingResponse as bt, type V2NewsletterListCreateParams as bu, type V2NewsletterListUpdateParams as bv, type V2NewsletterSyncInput as bw, type V2NewsletterSyncResult as bx, type V2NewsletterSubscriptionListMembershipUpdate as by, type V2NewsletterImportRequest as bz, type ContentQueryParams as c, type CheckoutTaxStrategy as c0, type CheckoutTaxExemptionStatus as c1, type CheckoutTaxCustomerExemptionRequest as c2, type CheckoutTaxBreakdownItem as c3, type CheckoutSessionTax as c4, type SubscriptionCancellationMode as c5, type CreditTransaction as c6, type HttpMethod as c7, type RequestOptions as c8, type PerspectApiV2Config as c9, BaseV2Client as ca, ContentV2Client as cb, ProductsV2Client as cc, CategoriesV2Client as cd, CollectionsV2Client as ce, OrdersV2Client as cf, SiteUsersV2Client as cg, NewsletterV2Client as ch, ContactsV2Client as ci, OrganizationsV2Client as cj, SitesV2Client as ck, ApiKeysV2Client as cl, WebhooksV2Client as cm, SubscriptionsV2Client as cn, CreditsV2Client as co, type Content as d, type ContentCategoryResponse as e, type CreateContentRequest as f, type UpdateContentRequest as g, type ApiKey as h, type CreateApiKeyRequest as i, type UpdateApiKeyRequest as j, type CreateOrganizationRequest as k, type CreateSiteRequest as l, type ProductQueryParams as m, type Product as n, type CreateProductRequest as o, type ProductSku as p, type CreateProductSkuRequest as q, type Category as r, type CreateCategoryRequest as s, type CreateWebhookRequest as t, type CreateCheckoutSessionRequest as u, type CheckoutSession as v, type CreateContactRequest as w, type ContactSubmitResponse as x, type ContactStatusResponse as y, type ContactSubmission as z };
+export { type NewsletterManagementList as $, type ApiResponse as A, type CreateNewsletterSubscriptionRequest as B, CacheManager as C, type NewsletterConfirmResponse as D, type NewsletterUnsubscribeRequest as E, type NewsletterUnsubscribeResponse as F, type NewsletterPreferences as G, HttpClient as H, type NewsletterList as I, type NewsletterCampaignListResponse as J, type NewsletterCampaignDetail as K, type NewsletterStatusResponse as L, type NewsletterManagementSubscriptionsListResponse as M, type NewsletterSubscribeResponse as N, type Organization as O, type PaginatedResponse as P, type NewsletterManagementSubscription as Q, type NewsletterSubscriptionSyncRequest as R, type Site as S, type NewsletterSubscriptionSyncResponse as T, type User as U, type NewsletterSubscriptionsBulkUpdateRequest as V, type Webhook as W, type NewsletterSubscriptionsBulkUpdateResponse as X, type NewsletterSubscriptionMembershipUpdateRequest as Y, type NewsletterSubscriptionsImportRequest as Z, type NewsletterSubscriptionsImportResponse as _, type CachePolicy as a, type V2ContentListParams as a$, type NewsletterManagementSeries as a0, type NewsletterManagementCampaignListResponse as a1, type NewsletterManagementCampaign as a2, type NewsletterCampaignTestSendRequest as a3, type NewsletterCampaignTestSendResponse as a4, type NewsletterManagementStatsResponse as a5, type NewsletterExportCreateRequest as a6, type NewsletterExportCreateResponse as a7, type RequestOtpRequest as a8, type VerifyOtpRequest as a9, PerspectV2Error as aA, createApiError as aB, PerspectApiError as aC, type CacheConfig as aD, type ApiError as aE, type MediaItem as aF, type CategorySummary as aG, type PaymentGateway as aH, type NewsletterSubscription as aI, type NewsletterCampaignSummary as aJ, type NewsletterManagementListMembership as aK, type NewsletterSubscriptionsBulkAction as aL, type NewsletterSubscriptionsBulkOutcome as aM, type NewsletterSubscriptionImportRowRequest as aN, type NewsletterSubscriptionsImportRowResult as aO, type NewsletterManagementPagination as aP, type SetProfileValueRequest as aQ, type V2Object as aR, type V2List as aS, type V2Deleted as aT, type V2Error as aU, type V2ErrorType as aV, type V2PaginationParams as aW, type V2Media as aX, type V2Content as aY, type V2ContentCreateParams as aZ, type V2ContentUpdateParams as a_, type VerifyOtpResponse as aa, type SiteUser as ab, type SiteUserProfile as ac, type UpdateSiteUserRequest as ad, type SiteUserOrder as ae, type SiteUserSubscription as af, type CancelSubscriptionRequest as ag, type CancelSubscriptionResponse as ah, type CreditBalance as ai, type CreditBalanceWithTransactions as aj, type GrantCreditRequest as ak, type ProductBundleGroup as al, type CreateBundleGroupRequest as am, type BundleCollection as an, type BundleCollectionItemWithProduct as ao, type CreateBundleCollectionRequest as ap, type AddCollectionItemRequest as aq, type BundleCollectionItem as ar, type PerspectApiConfig as as, type CacheAdapter as at, type BlogPost as au, type CheckoutMetadata as av, type CheckoutAddress as aw, type CheckoutTaxRequest as ax, PerspectApiV2Client as ay, createPerspectApiV2Client as az, type CacheInvalidateOptions as b, type ContentType as b$, type V2Product as b0, type V2ProductCreateParams as b1, type V2ProductUpdateParams as b2, type V2ProductListParams as b3, type V2Category as b4, type V2CategoryCreateParams as b5, type V2CategoryUpdateParams as b6, type V2Collection as b7, type V2CollectionItem as b8, type V2CollectionCreateParams as b9, type V2NewsletterSyncResult as bA, type V2NewsletterSubscriptionListMembershipUpdate as bB, type V2NewsletterImportRequest as bC, type V2NewsletterImportResult as bD, type V2ContactSubmission as bE, type V2Organization as bF, type V2Site as bG, type V2ApiKey as bH, type V2WebhookEventType as bI, type V2Webhook as bJ, type V2WebhookCreateParams as bK, type V2WebhookUpdateParams as bL, type V2SiteUserSubscription as bM, type V2SubscriptionPauseParams as bN, type V2SubscriptionCancelParams as bO, type V2SubscriptionChangePlanParams as bP, type V2SubscriptionChargeParams as bQ, type V2SubscriptionChargeResult as bR, type V2CancelSubscriptionResult as bS, type V2CreditTransaction as bT, type V2CreditBalance as bU, type V2GrantCreditParams as bV, type V2GrantCreditResult as bW, type V2EmailSendParams as bX, type V2EmailSendResult as bY, type PaginationParams as bZ, type ContentStatus as b_, type V2CollectionUpdateParams as ba, type V2Order as bb, type V2OrderListParams as bc, type V2OrderLineItemPriceData as bd, type V2OrderLineItem as be, type V2OrderAddress as bf, type V2OrderTaxRequest as bg, type V2OrderCreateParams as bh, type V2OrderFulfillmentUpdate as bi, type V2OrderFulfillmentNotificationLineItem as bj, type V2OrderFulfillmentNotificationParams as bk, type V2OrderFulfillmentNotificationResult as bl, type V2OrderCreateResult as bm, type V2SiteUser as bn, type V2SiteUserUpdateParams as bo, type V2SiteUserMeUpdateParams as bp, type V2SiteUserListParams as bq, type V2SiteUserWithProfile as br, type V2SiteUserProfile as bs, type V2NewsletterSubscription as bt, type V2NewsletterList as bu, type V2NewsletterCampaign as bv, type V2NewsletterTrackingResponse as bw, type V2NewsletterListCreateParams as bx, type V2NewsletterListUpdateParams as by, type V2NewsletterSyncInput as bz, type ContentQueryParams as c, type ProductSkuMediaItem as c0, type ProductSkuOption as c1, type CreatePaymentGatewayRequest as c2, type WebhookEventType as c3, type CheckoutMetadataValue as c4, type CheckoutTaxStrategy as c5, type CheckoutTaxExemptionStatus as c6, type CheckoutTaxCustomerExemptionRequest as c7, type CheckoutTaxBreakdownItem as c8, type CheckoutSessionTax as c9, type SubscriptionCancellationMode as ca, type CreditTransaction as cb, type HttpMethod as cc, type RequestOptions as cd, type PerspectApiV2Config as ce, BaseV2Client as cf, ContentV2Client as cg, ProductsV2Client as ch, CategoriesV2Client as ci, CollectionsV2Client as cj, OrdersV2Client as ck, SiteUsersV2Client as cl, NewsletterV2Client as cm, ContactsV2Client as cn, OrganizationsV2Client as co, SitesV2Client as cp, ApiKeysV2Client as cq, WebhooksV2Client as cr, SubscriptionsV2Client as cs, CreditsV2Client as ct, EmailV2Client as cu, type Content as d, type ContentCategoryResponse as e, type CreateContentRequest as f, type UpdateContentRequest as g, type ApiKey as h, type CreateApiKeyRequest as i, type UpdateApiKeyRequest as j, type CreateOrganizationRequest as k, type CreateSiteRequest as l, type ProductQueryParams as m, type Product as n, type CreateProductRequest as o, type ProductSku as p, type CreateProductSkuRequest as q, type Category as r, type CreateCategoryRequest as s, type CreateWebhookRequest as t, type CreateCheckoutSessionRequest as u, type CheckoutSession as v, type CreateContactRequest as w, type ContactSubmitResponse as x, type ContactStatusResponse as y, type ContactSubmission as z };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { H as HttpClient, C as CacheManager, A as ApiResponse, a as CachePolicy, b as CacheInvalidateOptions, U as User, c as ContentQueryParams, P as PaginatedResponse, d as Content, e as ContentCategoryResponse, f as CreateContentRequest, g as UpdateContentRequest, h as ApiKey, i as CreateApiKeyRequest, j as UpdateApiKeyRequest, O as Organization, k as CreateOrganizationRequest, S as Site, l as CreateSiteRequest, m as ProductQueryParams, n as Product, o as CreateProductRequest, p as ProductSku, q as CreateProductSkuRequest, r as Category, s as CreateCategoryRequest, W as Webhook, t as CreateWebhookRequest, u as CreateCheckoutSessionRequest, v as CheckoutSession, w as CreateContactRequest, x as ContactSubmitResponse, y as ContactStatusResponse, z as ContactSubmission, B as CreateNewsletterSubscriptionRequest, N as NewsletterSubscribeResponse, D as NewsletterConfirmResponse, E as NewsletterUnsubscribeRequest, F as NewsletterUnsubscribeResponse, G as NewsletterPreferences, I as NewsletterList, J as NewsletterCampaignListResponse, K as NewsletterCampaignDetail, L as NewsletterStatusResponse, M as NewsletterManagementSubscriptionsListResponse, Q as NewsletterManagementSubscription, R as NewsletterSubscriptionSyncRequest, T as NewsletterSubscriptionSyncResponse, V as NewsletterSubscriptionsBulkUpdateRequest, X as NewsletterSubscriptionsBulkUpdateResponse, Y as NewsletterSubscriptionMembershipUpdateRequest, Z as NewsletterSubscriptionsImportRequest, _ as NewsletterSubscriptionsImportResponse, $ as NewsletterManagementList, a0 as NewsletterManagementSeries, a1 as NewsletterManagementCampaignListResponse, a2 as NewsletterManagementCampaign, a3 as NewsletterCampaignTestSendRequest, a4 as NewsletterCampaignTestSendResponse, a5 as NewsletterManagementStatsResponse, a6 as NewsletterExportCreateRequest, a7 as NewsletterExportCreateResponse, a8 as RequestOtpRequest, a9 as VerifyOtpRequest, aa as VerifyOtpResponse, ab as SiteUser, ac as SiteUserProfile, ad as UpdateSiteUserRequest, ae as SiteUserOrder, af as SiteUserSubscription, ag as CancelSubscriptionRequest, ah as CancelSubscriptionResponse, ai as CreditBalance, aj as CreditBalanceWithTransactions, ak as GrantCreditRequest, al as ProductBundleGroup, am as CreateBundleGroupRequest, an as BundleCollection, ao as BundleCollectionItemWithProduct, ap as CreateBundleCollectionRequest, aq as AddCollectionItemRequest, ar as BundleCollectionItem, as as PerspectApiConfig, at as CacheAdapter, au as BlogPost, av as CheckoutMetadata, aw as CheckoutAddress, ax as CheckoutTaxRequest } from './index-CWvUyMt3.mjs';
-export { aE as ApiError, aD as CacheConfig, aG as CategorySummary, b$ as CheckoutMetadataValue, c4 as CheckoutSessionTax, c3 as CheckoutTaxBreakdownItem, c2 as CheckoutTaxCustomerExemptionRequest, c1 as CheckoutTaxExemptionStatus, c0 as CheckoutTaxStrategy, bV as ContentStatus, bW as ContentType, bZ as CreatePaymentGatewayRequest, c6 as CreditTransaction, c7 as HttpMethod, aF as MediaItem, aJ as NewsletterCampaignSummary, aK as NewsletterManagementListMembership, aP as NewsletterManagementPagination, aI as NewsletterSubscription, aN as NewsletterSubscriptionImportRowRequest, aL as NewsletterSubscriptionsBulkAction, aM as NewsletterSubscriptionsBulkOutcome, aO as NewsletterSubscriptionsImportRowResult, bU as PaginationParams, aH as PaymentGateway, aC as PerspectApiError, ay as PerspectApiV2Client, aA as PerspectV2Error, bX as ProductSkuMediaItem, bY as ProductSkuOption, c8 as RequestOptions, aQ as SetProfileValueRequest, c5 as SubscriptionCancellationMode, bE as V2ApiKey, bP as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bB as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, bR as V2CreditBalance, bQ as V2CreditTransaction, aT as V2Deleted, aU as V2Error, aV as V2ErrorType, bS as V2GrantCreditParams, bT as V2GrantCreditResult, aS as V2List, aX as V2Media, bs as V2NewsletterCampaign, bz as V2NewsletterImportRequest, bA as V2NewsletterImportResult, br as V2NewsletterList, bu as V2NewsletterListCreateParams, bv as V2NewsletterListUpdateParams, bq as V2NewsletterSubscription, by as V2NewsletterSubscriptionListMembershipUpdate, bw as V2NewsletterSyncInput, bx as V2NewsletterSyncResult, bt as V2NewsletterTrackingResponse, aR as V2Object, bb as V2Order, bf as V2OrderAddress, bh as V2OrderCreateParams, bj as V2OrderCreateResult, bi as V2OrderFulfillmentUpdate, be as V2OrderLineItem, bd as V2OrderLineItemPriceData, bc as V2OrderListParams, bg as V2OrderTaxRequest, bC as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bD as V2Site, bk as V2SiteUser, bn as V2SiteUserListParams, bm as V2SiteUserMeUpdateParams, bp as V2SiteUserProfile, bJ as V2SiteUserSubscription, bl as V2SiteUserUpdateParams, bo as V2SiteUserWithProfile, bL as V2SubscriptionCancelParams, bM as V2SubscriptionChangePlanParams, bN as V2SubscriptionChargeParams, bO as V2SubscriptionChargeResult, bK as V2SubscriptionPauseParams, bG as V2Webhook, bH as V2WebhookCreateParams, bF as V2WebhookEventType, bI as V2WebhookUpdateParams, b_ as WebhookEventType, aB as createApiError, az as createPerspectApiV2Client } from './index-CWvUyMt3.mjs';
+import { H as HttpClient, C as CacheManager, A as ApiResponse, a as CachePolicy, b as CacheInvalidateOptions, U as User, c as ContentQueryParams, P as PaginatedResponse, d as Content, e as ContentCategoryResponse, f as CreateContentRequest, g as UpdateContentRequest, h as ApiKey, i as CreateApiKeyRequest, j as UpdateApiKeyRequest, O as Organization, k as CreateOrganizationRequest, S as Site, l as CreateSiteRequest, m as ProductQueryParams, n as Product, o as CreateProductRequest, p as ProductSku, q as CreateProductSkuRequest, r as Category, s as CreateCategoryRequest, W as Webhook, t as CreateWebhookRequest, u as CreateCheckoutSessionRequest, v as CheckoutSession, w as CreateContactRequest, x as ContactSubmitResponse, y as ContactStatusResponse, z as ContactSubmission, B as CreateNewsletterSubscriptionRequest, N as NewsletterSubscribeResponse, D as NewsletterConfirmResponse, E as NewsletterUnsubscribeRequest, F as NewsletterUnsubscribeResponse, G as NewsletterPreferences, I as NewsletterList, J as NewsletterCampaignListResponse, K as NewsletterCampaignDetail, L as NewsletterStatusResponse, M as NewsletterManagementSubscriptionsListResponse, Q as NewsletterManagementSubscription, R as NewsletterSubscriptionSyncRequest, T as NewsletterSubscriptionSyncResponse, V as NewsletterSubscriptionsBulkUpdateRequest, X as NewsletterSubscriptionsBulkUpdateResponse, Y as NewsletterSubscriptionMembershipUpdateRequest, Z as NewsletterSubscriptionsImportRequest, _ as NewsletterSubscriptionsImportResponse, $ as NewsletterManagementList, a0 as NewsletterManagementSeries, a1 as NewsletterManagementCampaignListResponse, a2 as NewsletterManagementCampaign, a3 as NewsletterCampaignTestSendRequest, a4 as NewsletterCampaignTestSendResponse, a5 as NewsletterManagementStatsResponse, a6 as NewsletterExportCreateRequest, a7 as NewsletterExportCreateResponse, a8 as RequestOtpRequest, a9 as VerifyOtpRequest, aa as VerifyOtpResponse, ab as SiteUser, ac as SiteUserProfile, ad as UpdateSiteUserRequest, ae as SiteUserOrder, af as SiteUserSubscription, ag as CancelSubscriptionRequest, ah as CancelSubscriptionResponse, ai as CreditBalance, aj as CreditBalanceWithTransactions, ak as GrantCreditRequest, al as ProductBundleGroup, am as CreateBundleGroupRequest, an as BundleCollection, ao as BundleCollectionItemWithProduct, ap as CreateBundleCollectionRequest, aq as AddCollectionItemRequest, ar as BundleCollectionItem, as as PerspectApiConfig, at as CacheAdapter, au as BlogPost, av as CheckoutMetadata, aw as CheckoutAddress, ax as CheckoutTaxRequest } from './index-DuNDHod-.mjs';
+export { aE as ApiError, aD as CacheConfig, aG as CategorySummary, c4 as CheckoutMetadataValue, c9 as CheckoutSessionTax, c8 as CheckoutTaxBreakdownItem, c7 as CheckoutTaxCustomerExemptionRequest, c6 as CheckoutTaxExemptionStatus, c5 as CheckoutTaxStrategy, b_ as ContentStatus, b$ as ContentType, c2 as CreatePaymentGatewayRequest, cb as CreditTransaction, cc as HttpMethod, aF as MediaItem, aJ as NewsletterCampaignSummary, aK as NewsletterManagementListMembership, aP as NewsletterManagementPagination, aI as NewsletterSubscription, aN as NewsletterSubscriptionImportRowRequest, aL as NewsletterSubscriptionsBulkAction, aM as NewsletterSubscriptionsBulkOutcome, aO as NewsletterSubscriptionsImportRowResult, bZ as PaginationParams, aH as PaymentGateway, aC as PerspectApiError, ay as PerspectApiV2Client, aA as PerspectV2Error, c0 as ProductSkuMediaItem, c1 as ProductSkuOption, cd as RequestOptions, aQ as SetProfileValueRequest, ca as SubscriptionCancellationMode, bH as V2ApiKey, bS as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bE as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, bU as V2CreditBalance, bT as V2CreditTransaction, aT as V2Deleted, bX as V2EmailSendParams, bY as V2EmailSendResult, aU as V2Error, aV as V2ErrorType, bV as V2GrantCreditParams, bW as V2GrantCreditResult, aS as V2List, aX as V2Media, bv as V2NewsletterCampaign, bC as V2NewsletterImportRequest, bD as V2NewsletterImportResult, bu as V2NewsletterList, bx as V2NewsletterListCreateParams, by as V2NewsletterListUpdateParams, bt as V2NewsletterSubscription, bB as V2NewsletterSubscriptionListMembershipUpdate, bz as V2NewsletterSyncInput, bA as V2NewsletterSyncResult, bw as V2NewsletterTrackingResponse, aR as V2Object, bb as V2Order, bf as V2OrderAddress, bh as V2OrderCreateParams, bm as V2OrderCreateResult, bj as V2OrderFulfillmentNotificationLineItem, bk as V2OrderFulfillmentNotificationParams, bl as V2OrderFulfillmentNotificationResult, bi as V2OrderFulfillmentUpdate, be as V2OrderLineItem, bd as V2OrderLineItemPriceData, bc as V2OrderListParams, bg as V2OrderTaxRequest, bF as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bG as V2Site, bn as V2SiteUser, bq as V2SiteUserListParams, bp as V2SiteUserMeUpdateParams, bs as V2SiteUserProfile, bM as V2SiteUserSubscription, bo as V2SiteUserUpdateParams, br as V2SiteUserWithProfile, bO as V2SubscriptionCancelParams, bP as V2SubscriptionChangePlanParams, bQ as V2SubscriptionChargeParams, bR as V2SubscriptionChargeResult, bN as V2SubscriptionPauseParams, bJ as V2Webhook, bK as V2WebhookCreateParams, bI as V2WebhookEventType, bL as V2WebhookUpdateParams, c3 as WebhookEventType, aB as createApiError, az as createPerspectApiV2Client } from './index-DuNDHod-.mjs';
 
 /**
  * v1 deprecation constants — kept in sync with the backend's
@@ -1775,6 +1775,8 @@ declare class SiteUsersClient extends BaseClient {
         fulfillment_status: string;
         tracking_number?: string;
         notes?: string;
+        fulfillment_details_text?: string;
+        fulfillment_details_html?: string;
         notify_customer?: boolean;
     }): Promise<ApiResponse<{
         success: boolean;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { H as HttpClient, C as CacheManager, A as ApiResponse, a as CachePolicy, b as CacheInvalidateOptions, U as User, c as ContentQueryParams, P as PaginatedResponse, d as Content, e as ContentCategoryResponse, f as CreateContentRequest, g as UpdateContentRequest, h as ApiKey, i as CreateApiKeyRequest, j as UpdateApiKeyRequest, O as Organization, k as CreateOrganizationRequest, S as Site, l as CreateSiteRequest, m as ProductQueryParams, n as Product, o as CreateProductRequest, p as ProductSku, q as CreateProductSkuRequest, r as Category, s as CreateCategoryRequest, W as Webhook, t as CreateWebhookRequest, u as CreateCheckoutSessionRequest, v as CheckoutSession, w as CreateContactRequest, x as ContactSubmitResponse, y as ContactStatusResponse, z as ContactSubmission, B as CreateNewsletterSubscriptionRequest, N as NewsletterSubscribeResponse, D as NewsletterConfirmResponse, E as NewsletterUnsubscribeRequest, F as NewsletterUnsubscribeResponse, G as NewsletterPreferences, I as NewsletterList, J as NewsletterCampaignListResponse, K as NewsletterCampaignDetail, L as NewsletterStatusResponse, M as NewsletterManagementSubscriptionsListResponse, Q as NewsletterManagementSubscription, R as NewsletterSubscriptionSyncRequest, T as NewsletterSubscriptionSyncResponse, V as NewsletterSubscriptionsBulkUpdateRequest, X as NewsletterSubscriptionsBulkUpdateResponse, Y as NewsletterSubscriptionMembershipUpdateRequest, Z as NewsletterSubscriptionsImportRequest, _ as NewsletterSubscriptionsImportResponse, $ as NewsletterManagementList, a0 as NewsletterManagementSeries, a1 as NewsletterManagementCampaignListResponse, a2 as NewsletterManagementCampaign, a3 as NewsletterCampaignTestSendRequest, a4 as NewsletterCampaignTestSendResponse, a5 as NewsletterManagementStatsResponse, a6 as NewsletterExportCreateRequest, a7 as NewsletterExportCreateResponse, a8 as RequestOtpRequest, a9 as VerifyOtpRequest, aa as VerifyOtpResponse, ab as SiteUser, ac as SiteUserProfile, ad as UpdateSiteUserRequest, ae as SiteUserOrder, af as SiteUserSubscription, ag as CancelSubscriptionRequest, ah as CancelSubscriptionResponse, ai as CreditBalance, aj as CreditBalanceWithTransactions, ak as GrantCreditRequest, al as ProductBundleGroup, am as CreateBundleGroupRequest, an as BundleCollection, ao as BundleCollectionItemWithProduct, ap as CreateBundleCollectionRequest, aq as AddCollectionItemRequest, ar as BundleCollectionItem, as as PerspectApiConfig, at as CacheAdapter, au as BlogPost, av as CheckoutMetadata, aw as CheckoutAddress, ax as CheckoutTaxRequest } from './index-CWvUyMt3.js';
-export { aE as ApiError, aD as CacheConfig, aG as CategorySummary, b$ as CheckoutMetadataValue, c4 as CheckoutSessionTax, c3 as CheckoutTaxBreakdownItem, c2 as CheckoutTaxCustomerExemptionRequest, c1 as CheckoutTaxExemptionStatus, c0 as CheckoutTaxStrategy, bV as ContentStatus, bW as ContentType, bZ as CreatePaymentGatewayRequest, c6 as CreditTransaction, c7 as HttpMethod, aF as MediaItem, aJ as NewsletterCampaignSummary, aK as NewsletterManagementListMembership, aP as NewsletterManagementPagination, aI as NewsletterSubscription, aN as NewsletterSubscriptionImportRowRequest, aL as NewsletterSubscriptionsBulkAction, aM as NewsletterSubscriptionsBulkOutcome, aO as NewsletterSubscriptionsImportRowResult, bU as PaginationParams, aH as PaymentGateway, aC as PerspectApiError, ay as PerspectApiV2Client, aA as PerspectV2Error, bX as ProductSkuMediaItem, bY as ProductSkuOption, c8 as RequestOptions, aQ as SetProfileValueRequest, c5 as SubscriptionCancellationMode, bE as V2ApiKey, bP as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bB as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, bR as V2CreditBalance, bQ as V2CreditTransaction, aT as V2Deleted, aU as V2Error, aV as V2ErrorType, bS as V2GrantCreditParams, bT as V2GrantCreditResult, aS as V2List, aX as V2Media, bs as V2NewsletterCampaign, bz as V2NewsletterImportRequest, bA as V2NewsletterImportResult, br as V2NewsletterList, bu as V2NewsletterListCreateParams, bv as V2NewsletterListUpdateParams, bq as V2NewsletterSubscription, by as V2NewsletterSubscriptionListMembershipUpdate, bw as V2NewsletterSyncInput, bx as V2NewsletterSyncResult, bt as V2NewsletterTrackingResponse, aR as V2Object, bb as V2Order, bf as V2OrderAddress, bh as V2OrderCreateParams, bj as V2OrderCreateResult, bi as V2OrderFulfillmentUpdate, be as V2OrderLineItem, bd as V2OrderLineItemPriceData, bc as V2OrderListParams, bg as V2OrderTaxRequest, bC as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bD as V2Site, bk as V2SiteUser, bn as V2SiteUserListParams, bm as V2SiteUserMeUpdateParams, bp as V2SiteUserProfile, bJ as V2SiteUserSubscription, bl as V2SiteUserUpdateParams, bo as V2SiteUserWithProfile, bL as V2SubscriptionCancelParams, bM as V2SubscriptionChangePlanParams, bN as V2SubscriptionChargeParams, bO as V2SubscriptionChargeResult, bK as V2SubscriptionPauseParams, bG as V2Webhook, bH as V2WebhookCreateParams, bF as V2WebhookEventType, bI as V2WebhookUpdateParams, b_ as WebhookEventType, aB as createApiError, az as createPerspectApiV2Client } from './index-CWvUyMt3.js';
+import { H as HttpClient, C as CacheManager, A as ApiResponse, a as CachePolicy, b as CacheInvalidateOptions, U as User, c as ContentQueryParams, P as PaginatedResponse, d as Content, e as ContentCategoryResponse, f as CreateContentRequest, g as UpdateContentRequest, h as ApiKey, i as CreateApiKeyRequest, j as UpdateApiKeyRequest, O as Organization, k as CreateOrganizationRequest, S as Site, l as CreateSiteRequest, m as ProductQueryParams, n as Product, o as CreateProductRequest, p as ProductSku, q as CreateProductSkuRequest, r as Category, s as CreateCategoryRequest, W as Webhook, t as CreateWebhookRequest, u as CreateCheckoutSessionRequest, v as CheckoutSession, w as CreateContactRequest, x as ContactSubmitResponse, y as ContactStatusResponse, z as ContactSubmission, B as CreateNewsletterSubscriptionRequest, N as NewsletterSubscribeResponse, D as NewsletterConfirmResponse, E as NewsletterUnsubscribeRequest, F as NewsletterUnsubscribeResponse, G as NewsletterPreferences, I as NewsletterList, J as NewsletterCampaignListResponse, K as NewsletterCampaignDetail, L as NewsletterStatusResponse, M as NewsletterManagementSubscriptionsListResponse, Q as NewsletterManagementSubscription, R as NewsletterSubscriptionSyncRequest, T as NewsletterSubscriptionSyncResponse, V as NewsletterSubscriptionsBulkUpdateRequest, X as NewsletterSubscriptionsBulkUpdateResponse, Y as NewsletterSubscriptionMembershipUpdateRequest, Z as NewsletterSubscriptionsImportRequest, _ as NewsletterSubscriptionsImportResponse, $ as NewsletterManagementList, a0 as NewsletterManagementSeries, a1 as NewsletterManagementCampaignListResponse, a2 as NewsletterManagementCampaign, a3 as NewsletterCampaignTestSendRequest, a4 as NewsletterCampaignTestSendResponse, a5 as NewsletterManagementStatsResponse, a6 as NewsletterExportCreateRequest, a7 as NewsletterExportCreateResponse, a8 as RequestOtpRequest, a9 as VerifyOtpRequest, aa as VerifyOtpResponse, ab as SiteUser, ac as SiteUserProfile, ad as UpdateSiteUserRequest, ae as SiteUserOrder, af as SiteUserSubscription, ag as CancelSubscriptionRequest, ah as CancelSubscriptionResponse, ai as CreditBalance, aj as CreditBalanceWithTransactions, ak as GrantCreditRequest, al as ProductBundleGroup, am as CreateBundleGroupRequest, an as BundleCollection, ao as BundleCollectionItemWithProduct, ap as CreateBundleCollectionRequest, aq as AddCollectionItemRequest, ar as BundleCollectionItem, as as PerspectApiConfig, at as CacheAdapter, au as BlogPost, av as CheckoutMetadata, aw as CheckoutAddress, ax as CheckoutTaxRequest } from './index-DuNDHod-.js';
+export { aE as ApiError, aD as CacheConfig, aG as CategorySummary, c4 as CheckoutMetadataValue, c9 as CheckoutSessionTax, c8 as CheckoutTaxBreakdownItem, c7 as CheckoutTaxCustomerExemptionRequest, c6 as CheckoutTaxExemptionStatus, c5 as CheckoutTaxStrategy, b_ as ContentStatus, b$ as ContentType, c2 as CreatePaymentGatewayRequest, cb as CreditTransaction, cc as HttpMethod, aF as MediaItem, aJ as NewsletterCampaignSummary, aK as NewsletterManagementListMembership, aP as NewsletterManagementPagination, aI as NewsletterSubscription, aN as NewsletterSubscriptionImportRowRequest, aL as NewsletterSubscriptionsBulkAction, aM as NewsletterSubscriptionsBulkOutcome, aO as NewsletterSubscriptionsImportRowResult, bZ as PaginationParams, aH as PaymentGateway, aC as PerspectApiError, ay as PerspectApiV2Client, aA as PerspectV2Error, c0 as ProductSkuMediaItem, c1 as ProductSkuOption, cd as RequestOptions, aQ as SetProfileValueRequest, ca as SubscriptionCancellationMode, bH as V2ApiKey, bS as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bE as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, bU as V2CreditBalance, bT as V2CreditTransaction, aT as V2Deleted, bX as V2EmailSendParams, bY as V2EmailSendResult, aU as V2Error, aV as V2ErrorType, bV as V2GrantCreditParams, bW as V2GrantCreditResult, aS as V2List, aX as V2Media, bv as V2NewsletterCampaign, bC as V2NewsletterImportRequest, bD as V2NewsletterImportResult, bu as V2NewsletterList, bx as V2NewsletterListCreateParams, by as V2NewsletterListUpdateParams, bt as V2NewsletterSubscription, bB as V2NewsletterSubscriptionListMembershipUpdate, bz as V2NewsletterSyncInput, bA as V2NewsletterSyncResult, bw as V2NewsletterTrackingResponse, aR as V2Object, bb as V2Order, bf as V2OrderAddress, bh as V2OrderCreateParams, bm as V2OrderCreateResult, bj as V2OrderFulfillmentNotificationLineItem, bk as V2OrderFulfillmentNotificationParams, bl as V2OrderFulfillmentNotificationResult, bi as V2OrderFulfillmentUpdate, be as V2OrderLineItem, bd as V2OrderLineItemPriceData, bc as V2OrderListParams, bg as V2OrderTaxRequest, bF as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bG as V2Site, bn as V2SiteUser, bq as V2SiteUserListParams, bp as V2SiteUserMeUpdateParams, bs as V2SiteUserProfile, bM as V2SiteUserSubscription, bo as V2SiteUserUpdateParams, br as V2SiteUserWithProfile, bO as V2SubscriptionCancelParams, bP as V2SubscriptionChangePlanParams, bQ as V2SubscriptionChargeParams, bR as V2SubscriptionChargeResult, bN as V2SubscriptionPauseParams, bJ as V2Webhook, bK as V2WebhookCreateParams, bI as V2WebhookEventType, bL as V2WebhookUpdateParams, c3 as WebhookEventType, aB as createApiError, az as createPerspectApiV2Client } from './index-DuNDHod-.js';
 
 /**
  * v1 deprecation constants — kept in sync with the backend's
@@ -1775,6 +1775,8 @@ declare class SiteUsersClient extends BaseClient {
         fulfillment_status: string;
         tracking_number?: string;
         notes?: string;
+        fulfillment_details_text?: string;
+        fulfillment_details_html?: string;
         notify_customer?: boolean;
     }): Promise<ApiResponse<{
         success: boolean;

package/dist/index.js

@@ -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
@@ -1006,10 +1033,51 @@ var OrdersV2Client = class extends BaseV2Client {
    * 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;
+  }
+  /**
+   * Send the customer fulfillment template for an external delivery/packing
+   * record without mutating a checkout session.
+   */
+  async sendFulfillmentNotification(siteName, data) {
+    return this.post(
+      this.sitePath(siteName, "orders", "fulfillment-notifications"),
+      data
+    );
+  }
+  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;
   }
 };
 
@@ -1395,6 +1463,23 @@ var CreditsV2Client = class extends BaseV2Client {
   }
 };
 
+// src/v2/client/email-client.ts
+var EmailV2Client = class extends BaseV2Client {
+  /**
+   * Send a transactional email using the site's configured email provider.
+   *
+   * Requires a server-side API key — never call this from a browser.
+   * The site must have an email provider configured in its settings.
+   * At least one of `html` or `text` must be provided.
+   */
+  async send(siteName, params) {
+    return this.post(
+      this.sitePath(siteName, "email", "send"),
+      params
+    );
+  }
+};
+
 // src/v2/index.ts
 var PerspectApiV2Client = class {
   http;
@@ -1413,6 +1498,7 @@ var PerspectApiV2Client = class {
   webhooks;
   subscriptions;
   credits;
+  email;
   constructor(config) {
     const baseUrl = config.baseUrl.replace(/\/+$/, "");
     const v2BaseUrl = baseUrl.endsWith("/api/v2") ? baseUrl : `${baseUrl}/api/v2`;
@@ -1434,6 +1520,7 @@ var PerspectApiV2Client = class {
     this.webhooks = new WebhooksV2Client(this.http, basePath, cache);
     this.subscriptions = new SubscriptionsV2Client(this.http, basePath, cache);
     this.credits = new CreditsV2Client(this.http, basePath, cache);
+    this.email = new EmailV2Client(this.http, basePath, cache);
   }
   /** Update the JWT token for authenticated requests. */
   setAuth(jwt) {

package/dist/index.mjs

@@ -7,7 +7,7 @@ import {
   PerspectV2Error,
   createApiError,
   createPerspectApiV2Client
-} from "./chunk-K3T2AFYA.mjs";
+} from "./chunk-MMKJ2WBF.mjs";
 
 // src/deprecation.ts
 var V1_SUNSET_DATE = "2026-06-01";

package/dist/v2/index.d.mts

@@ -1 +1 @@
-export { cl as ApiKeysV2Client, ca as BaseV2Client, cd as CategoriesV2Client, ce as CollectionsV2Client, ci as ContactsV2Client, cb as ContentV2Client, co as CreditsV2Client, ch as NewsletterV2Client, cf as OrdersV2Client, cj as OrganizationsV2Client, ay as PerspectApiV2Client, c9 as PerspectApiV2Config, aA as PerspectV2Error, cc as ProductsV2Client, cg as SiteUsersV2Client, ck as SitesV2Client, cn as SubscriptionsV2Client, bE as V2ApiKey, bP as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bB as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, bR as V2CreditBalance, bQ as V2CreditTransaction, aT as V2Deleted, aU as V2Error, aV as V2ErrorType, bS as V2GrantCreditParams, bT as V2GrantCreditResult, aS as V2List, aX as V2Media, bs as V2NewsletterCampaign, bz as V2NewsletterImportRequest, bA as V2NewsletterImportResult, br as V2NewsletterList, bu as V2NewsletterListCreateParams, bv as V2NewsletterListUpdateParams, bq as V2NewsletterSubscription, by as V2NewsletterSubscriptionListMembershipUpdate, bw as V2NewsletterSyncInput, bx as V2NewsletterSyncResult, bt as V2NewsletterTrackingResponse, aR as V2Object, bb as V2Order, bf as V2OrderAddress, bh as V2OrderCreateParams, bj as V2OrderCreateResult, bi as V2OrderFulfillmentUpdate, be as V2OrderLineItem, bd as V2OrderLineItemPriceData, bc as V2OrderListParams, bg as V2OrderTaxRequest, bC as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bD as V2Site, bk as V2SiteUser, bn as V2SiteUserListParams, bm as V2SiteUserMeUpdateParams, bp as V2SiteUserProfile, bJ as V2SiteUserSubscription, bl as V2SiteUserUpdateParams, bo as V2SiteUserWithProfile, bL as V2SubscriptionCancelParams, bM as V2SubscriptionChangePlanParams, bN as V2SubscriptionChargeParams, bO as V2SubscriptionChargeResult, bK as V2SubscriptionPauseParams, bG as V2Webhook, bH as V2WebhookCreateParams, bF as V2WebhookEventType, bI as V2WebhookUpdateParams, cm as WebhooksV2Client, az as createPerspectApiV2Client } from '../index-CWvUyMt3.mjs';
+export { cq as ApiKeysV2Client, cf as BaseV2Client, ci as CategoriesV2Client, cj as CollectionsV2Client, cn as ContactsV2Client, cg as ContentV2Client, ct as CreditsV2Client, cu as EmailV2Client, cm as NewsletterV2Client, ck as OrdersV2Client, co as OrganizationsV2Client, ay as PerspectApiV2Client, ce as PerspectApiV2Config, aA as PerspectV2Error, ch as ProductsV2Client, cl as SiteUsersV2Client, cp as SitesV2Client, cs as SubscriptionsV2Client, bH as V2ApiKey, bS as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bE as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, bU as V2CreditBalance, bT as V2CreditTransaction, aT as V2Deleted, bX as V2EmailSendParams, bY as V2EmailSendResult, aU as V2Error, aV as V2ErrorType, bV as V2GrantCreditParams, bW as V2GrantCreditResult, aS as V2List, aX as V2Media, bv as V2NewsletterCampaign, bC as V2NewsletterImportRequest, bD as V2NewsletterImportResult, bu as V2NewsletterList, bx as V2NewsletterListCreateParams, by as V2NewsletterListUpdateParams, bt as V2NewsletterSubscription, bB as V2NewsletterSubscriptionListMembershipUpdate, bz as V2NewsletterSyncInput, bA as V2NewsletterSyncResult, bw as V2NewsletterTrackingResponse, aR as V2Object, bb as V2Order, bf as V2OrderAddress, bh as V2OrderCreateParams, bm as V2OrderCreateResult, bj as V2OrderFulfillmentNotificationLineItem, bk as V2OrderFulfillmentNotificationParams, bl as V2OrderFulfillmentNotificationResult, bi as V2OrderFulfillmentUpdate, be as V2OrderLineItem, bd as V2OrderLineItemPriceData, bc as V2OrderListParams, bg as V2OrderTaxRequest, bF as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bG as V2Site, bn as V2SiteUser, bq as V2SiteUserListParams, bp as V2SiteUserMeUpdateParams, bs as V2SiteUserProfile, bM as V2SiteUserSubscription, bo as V2SiteUserUpdateParams, br as V2SiteUserWithProfile, bO as V2SubscriptionCancelParams, bP as V2SubscriptionChangePlanParams, bQ as V2SubscriptionChargeParams, bR as V2SubscriptionChargeResult, bN as V2SubscriptionPauseParams, bJ as V2Webhook, bK as V2WebhookCreateParams, bI as V2WebhookEventType, bL as V2WebhookUpdateParams, cr as WebhooksV2Client, az as createPerspectApiV2Client } from '../index-DuNDHod-.mjs';

package/dist/v2/index.d.ts

@@ -1 +1 @@
-export { cl as ApiKeysV2Client, ca as BaseV2Client, cd as CategoriesV2Client, ce as CollectionsV2Client, ci as ContactsV2Client, cb as ContentV2Client, co as CreditsV2Client, ch as NewsletterV2Client, cf as OrdersV2Client, cj as OrganizationsV2Client, ay as PerspectApiV2Client, c9 as PerspectApiV2Config, aA as PerspectV2Error, cc as ProductsV2Client, cg as SiteUsersV2Client, ck as SitesV2Client, cn as SubscriptionsV2Client, bE as V2ApiKey, bP as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bB as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, bR as V2CreditBalance, bQ as V2CreditTransaction, aT as V2Deleted, aU as V2Error, aV as V2ErrorType, bS as V2GrantCreditParams, bT as V2GrantCreditResult, aS as V2List, aX as V2Media, bs as V2NewsletterCampaign, bz as V2NewsletterImportRequest, bA as V2NewsletterImportResult, br as V2NewsletterList, bu as V2NewsletterListCreateParams, bv as V2NewsletterListUpdateParams, bq as V2NewsletterSubscription, by as V2NewsletterSubscriptionListMembershipUpdate, bw as V2NewsletterSyncInput, bx as V2NewsletterSyncResult, bt as V2NewsletterTrackingResponse, aR as V2Object, bb as V2Order, bf as V2OrderAddress, bh as V2OrderCreateParams, bj as V2OrderCreateResult, bi as V2OrderFulfillmentUpdate, be as V2OrderLineItem, bd as V2OrderLineItemPriceData, bc as V2OrderListParams, bg as V2OrderTaxRequest, bC as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bD as V2Site, bk as V2SiteUser, bn as V2SiteUserListParams, bm as V2SiteUserMeUpdateParams, bp as V2SiteUserProfile, bJ as V2SiteUserSubscription, bl as V2SiteUserUpdateParams, bo as V2SiteUserWithProfile, bL as V2SubscriptionCancelParams, bM as V2SubscriptionChangePlanParams, bN as V2SubscriptionChargeParams, bO as V2SubscriptionChargeResult, bK as V2SubscriptionPauseParams, bG as V2Webhook, bH as V2WebhookCreateParams, bF as V2WebhookEventType, bI as V2WebhookUpdateParams, cm as WebhooksV2Client, az as createPerspectApiV2Client } from '../index-CWvUyMt3.js';
+export { cq as ApiKeysV2Client, cf as BaseV2Client, ci as CategoriesV2Client, cj as CollectionsV2Client, cn as ContactsV2Client, cg as ContentV2Client, ct as CreditsV2Client, cu as EmailV2Client, cm as NewsletterV2Client, ck as OrdersV2Client, co as OrganizationsV2Client, ay as PerspectApiV2Client, ce as PerspectApiV2Config, aA as PerspectV2Error, ch as ProductsV2Client, cl as SiteUsersV2Client, cp as SitesV2Client, cs as SubscriptionsV2Client, bH as V2ApiKey, bS as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bE as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, bU as V2CreditBalance, bT as V2CreditTransaction, aT as V2Deleted, bX as V2EmailSendParams, bY as V2EmailSendResult, aU as V2Error, aV as V2ErrorType, bV as V2GrantCreditParams, bW as V2GrantCreditResult, aS as V2List, aX as V2Media, bv as V2NewsletterCampaign, bC as V2NewsletterImportRequest, bD as V2NewsletterImportResult, bu as V2NewsletterList, bx as V2NewsletterListCreateParams, by as V2NewsletterListUpdateParams, bt as V2NewsletterSubscription, bB as V2NewsletterSubscriptionListMembershipUpdate, bz as V2NewsletterSyncInput, bA as V2NewsletterSyncResult, bw as V2NewsletterTrackingResponse, aR as V2Object, bb as V2Order, bf as V2OrderAddress, bh as V2OrderCreateParams, bm as V2OrderCreateResult, bj as V2OrderFulfillmentNotificationLineItem, bk as V2OrderFulfillmentNotificationParams, bl as V2OrderFulfillmentNotificationResult, bi as V2OrderFulfillmentUpdate, be as V2OrderLineItem, bd as V2OrderLineItemPriceData, bc as V2OrderListParams, bg as V2OrderTaxRequest, bF as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bG as V2Site, bn as V2SiteUser, bq as V2SiteUserListParams, bp as V2SiteUserMeUpdateParams, bs as V2SiteUserProfile, bM as V2SiteUserSubscription, bo as V2SiteUserUpdateParams, br as V2SiteUserWithProfile, bO as V2SubscriptionCancelParams, bP as V2SubscriptionChangePlanParams, bQ as V2SubscriptionChargeParams, bR as V2SubscriptionChargeResult, bN as V2SubscriptionPauseParams, bJ as V2Webhook, bK as V2WebhookCreateParams, bI as V2WebhookEventType, bL as V2WebhookUpdateParams, cr as WebhooksV2Client, az as createPerspectApiV2Client } from '../index-DuNDHod-.js';

package/dist/v2/index.js

@@ -27,6 +27,7 @@ __export(v2_exports, {
   ContactsV2Client: () => ContactsV2Client,
   ContentV2Client: () => ContentV2Client,
   CreditsV2Client: () => CreditsV2Client,
+  EmailV2Client: () => EmailV2Client,
   NewsletterV2Client: () => NewsletterV2Client,
   OrdersV2Client: () => OrdersV2Client,
   OrganizationsV2Client: () => OrganizationsV2Client,
@@ -923,13 +924,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
@@ -951,10 +979,51 @@ var OrdersV2Client = class extends BaseV2Client {
    * 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;
+  }
+  /**
+   * Send the customer fulfillment template for an external delivery/packing
+   * record without mutating a checkout session.
+   */
+  async sendFulfillmentNotification(siteName, data) {
+    return this.post(
+      this.sitePath(siteName, "orders", "fulfillment-notifications"),
+      data
+    );
+  }
+  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;
   }
 };
 
@@ -1340,6 +1409,23 @@ var CreditsV2Client = class extends BaseV2Client {
   }
 };
 
+// src/v2/client/email-client.ts
+var EmailV2Client = class extends BaseV2Client {
+  /**
+   * Send a transactional email using the site's configured email provider.
+   *
+   * Requires a server-side API key — never call this from a browser.
+   * The site must have an email provider configured in its settings.
+   * At least one of `html` or `text` must be provided.
+   */
+  async send(siteName, params) {
+    return this.post(
+      this.sitePath(siteName, "email", "send"),
+      params
+    );
+  }
+};
+
 // src/v2/index.ts
 var PerspectApiV2Client = class {
   http;
@@ -1358,6 +1444,7 @@ var PerspectApiV2Client = class {
   webhooks;
   subscriptions;
   credits;
+  email;
   constructor(config) {
     const baseUrl = config.baseUrl.replace(/\/+$/, "");
     const v2BaseUrl = baseUrl.endsWith("/api/v2") ? baseUrl : `${baseUrl}/api/v2`;
@@ -1379,6 +1466,7 @@ var PerspectApiV2Client = class {
     this.webhooks = new WebhooksV2Client(this.http, basePath, cache);
     this.subscriptions = new SubscriptionsV2Client(this.http, basePath, cache);
     this.credits = new CreditsV2Client(this.http, basePath, cache);
+    this.email = new EmailV2Client(this.http, basePath, cache);
   }
   /** Update the JWT token for authenticated requests. */
   setAuth(jwt) {
@@ -1405,6 +1493,7 @@ function createPerspectApiV2Client(config) {
   ContactsV2Client,
   ContentV2Client,
   CreditsV2Client,
+  EmailV2Client,
   NewsletterV2Client,
   OrdersV2Client,
   OrganizationsV2Client,

package/dist/v2/index.mjs

@@ -6,6 +6,7 @@ import {
   ContactsV2Client,
   ContentV2Client,
   CreditsV2Client,
+  EmailV2Client,
   NewsletterV2Client,
   OrdersV2Client,
   OrganizationsV2Client,
@@ -17,7 +18,7 @@ import {
   SubscriptionsV2Client,
   WebhooksV2Client,
   createPerspectApiV2Client
-} from "../chunk-K3T2AFYA.mjs";
+} from "../chunk-MMKJ2WBF.mjs";
 export {
   ApiKeysV2Client,
   BaseV2Client,
@@ -26,6 +27,7 @@ export {
   ContactsV2Client,
   ContentV2Client,
   CreditsV2Client,
+  EmailV2Client,
   NewsletterV2Client,
   OrdersV2Client,
   OrganizationsV2Client,

package/package.json

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

package/src/client/site-users-client.ts

@@ -519,6 +519,8 @@ export class SiteUsersClient extends BaseClient {
       fulfillment_status: string;
       tracking_number?: string;
       notes?: string;
+      fulfillment_details_text?: string;
+      fulfillment_details_html?: string;
       notify_customer?: boolean;
     }
   ): Promise<ApiResponse<{ success: boolean }>> {

package/src/v2/client/email-client.ts

@@ -0,0 +1,23 @@
+/**
+ * v2 Email Client — send transactional email through a site's configured provider.
+ */
+
+import { BaseV2Client } from './base-v2-client';
+import type { V2EmailSendParams, V2EmailSendResult } from '../types';
+
+export class EmailV2Client extends BaseV2Client {
+
+  /**
+   * Send a transactional email using the site's configured email provider.
+   *
+   * Requires a server-side API key — never call this from a browser.
+   * The site must have an email provider configured in its settings.
+   * At least one of `html` or `text` must be provided.
+   */
+  async send(siteName: string, params: V2EmailSendParams): Promise<V2EmailSendResult> {
+    return this.post<V2EmailSendResult>(
+      this.sitePath(siteName, 'email', 'send'),
+      params,
+    );
+  }
+}

package/src/v2/client/orders-client.ts

@@ -13,21 +13,57 @@ import type {
   V2OrderCreateParams,
   V2OrderCreateResult,
   V2OrderFulfillmentUpdate,
+  V2OrderFulfillmentNotificationParams,
+  V2OrderFulfillmentNotificationResult,
   V2List,
 } from '../types';
 
 export class OrdersV2Client extends BaseV2Client {
 
   async list(siteName: string, params?: V2OrderListParams, cachePolicy?: CachePolicy): Promise<V2List<V2Order>> {
-    return this.getList<V2Order>(this.sitePath(siteName, 'orders'), params, cachePolicy);
+    return this.getList<V2Order>(
+      this.sitePath(siteName, 'orders'),
+      params,
+      this.withOrderTags(siteName, cachePolicy, {
+        fulfillmentStatus: params?.fulfillment_status,
+      }),
+    );
   }
 
-  async *listAutoPaginated(siteName: string, params?: Omit<V2OrderListParams, 'starting_after' | 'ending_before'>) {
-    yield* this.listAutoPaginate<V2Order>(this.sitePath(siteName, 'orders'), params);
+  async *listAutoPaginated(
+    siteName: string,
+    params?: Omit<V2OrderListParams, 'starting_after' | 'ending_before'>,
+    cachePolicy?: CachePolicy,
+  ) {
+    let startingAfter: string | undefined;
+    let hasMore = true;
+
+    while (hasMore) {
+      const queryParams: V2OrderListParams = { ...(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: string, id: string, cachePolicy?: CachePolicy): Promise<V2Order> {
-    return this.getOne<V2Order>(this.sitePath(siteName, 'orders', id), undefined, cachePolicy);
+    return this.getOne<V2Order>(
+      this.sitePath(siteName, 'orders', id),
+      undefined,
+      this.withOrderTags(siteName, cachePolicy, { id }),
+    );
   }
 
   /**
@@ -58,9 +94,67 @@ export class OrdersV2Client extends BaseV2Client {
     id: string,
     data: V2OrderFulfillmentUpdate,
   ): Promise<V2Order> {
-    return this.patchOne<V2Order>(
+    const result = await this.patchOne<V2Order>(
       this.sitePath(siteName, 'orders', `${id}/fulfillment`),
       data,
     );
+    await this.invalidateCache({
+      tags: this.buildOrderTags(siteName, { id }),
+      keys: [this.sitePath(siteName, 'orders', id)],
+    });
+    return result;
+  }
+
+  /**
+   * Send the customer fulfillment template for an external delivery/packing
+   * record without mutating a checkout session.
+   */
+  async sendFulfillmentNotification(
+    siteName: string,
+    data: V2OrderFulfillmentNotificationParams,
+  ): Promise<V2OrderFulfillmentNotificationResult> {
+    return this.post<V2OrderFulfillmentNotificationResult>(
+      this.sitePath(siteName, 'orders', 'fulfillment-notifications'),
+      data,
+    );
+  }
+
+  private withOrderTags(
+    siteName: string,
+    cachePolicy: CachePolicy | undefined,
+    options: { id?: string; fulfillmentStatus?: string | null } = {},
+  ): CachePolicy {
+    const tags = new Set<string>(cachePolicy?.tags ?? []);
+    for (const tag of this.buildOrderTags(siteName, options)) {
+      tags.add(tag);
+    }
+
+    return {
+      ...cachePolicy,
+      tags: Array.from(tags),
+    };
+  }
+
+  private buildOrderTags(
+    siteName: string,
+    options: { id?: string; fulfillmentStatus?: string | null } = {},
+  ): string[] {
+    const tags = new Set<string>(['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);
+  }
+
+  private normalizeTagPart(value?: string | null): string | null {
+    if (!value) return null;
+    const normalized = value.trim().toLowerCase().replace(/[^a-z0-9_-]+/g, '-');
+    return normalized || null;
   }
 }

package/src/v2/index.ts

@@ -29,6 +29,7 @@ import { ApiKeysV2Client } from './client/api-keys-client';
 import { WebhooksV2Client } from './client/webhooks-client';
 import { SubscriptionsV2Client } from './client/subscriptions-client';
 import { CreditsV2Client } from './client/credits-client';
+import { EmailV2Client } from './client/email-client';
 
 export interface PerspectApiV2Config extends PerspectApiConfig {
   cache?: CacheConfig;
@@ -52,6 +53,7 @@ export class PerspectApiV2Client {
   readonly webhooks: WebhooksV2Client;
   readonly subscriptions: SubscriptionsV2Client;
   readonly credits: CreditsV2Client;
+  readonly email: EmailV2Client;
 
   constructor(config: PerspectApiV2Config) {
     // Ensure base URL points to /api/v2
@@ -79,6 +81,7 @@ export class PerspectApiV2Client {
     this.webhooks = new WebhooksV2Client(this.http, basePath, cache);
     this.subscriptions = new SubscriptionsV2Client(this.http, basePath, cache);
     this.credits = new CreditsV2Client(this.http, basePath, cache);
+    this.email = new EmailV2Client(this.http, basePath, cache);
   }
 
   /** Update the JWT token for authenticated requests. */
@@ -120,3 +123,4 @@ export { ApiKeysV2Client } from './client/api-keys-client';
 export { WebhooksV2Client } from './client/webhooks-client';
 export { SubscriptionsV2Client } from './client/subscriptions-client';
 export { CreditsV2Client } from './client/credits-client';
+export { EmailV2Client } from './client/email-client';

package/src/v2/types.ts

@@ -328,10 +328,44 @@ export interface V2OrderFulfillmentUpdate {
   fulfillment_status: string;
   tracking_number?: string;
   notes?: string;
+  fulfillment_details_text?: string;
+  fulfillment_details_html?: string;
   /** When true, a terminal fulfillment status triggers a customer email. */
   notify_customer?: boolean;
 }
 
+export interface V2OrderFulfillmentNotificationLineItem {
+  quantity: number;
+  description: string;
+  amount_total?: number;
+  currency?: string;
+}
+
+export interface V2OrderFulfillmentNotificationParams {
+  session_id?: string;
+  order_id?: string;
+  customer_email: string;
+  customer_name?: string;
+  fulfillment_status?: string;
+  fulfillment_details_text?: string;
+  fulfillment_details_html?: string;
+  line_items?: V2OrderFulfillmentNotificationLineItem[];
+  amount_total?: number;
+  currency?: string;
+  shipping_details?: Record<string, unknown>;
+  customer_details?: Record<string, unknown>;
+  metadata?: Record<string, unknown>;
+  created_at?: string;
+}
+
+export interface V2OrderFulfillmentNotificationResult extends V2Object {
+  object: "fulfillment_notification";
+  order_id: string;
+  notified: boolean;
+  queued: boolean;
+  reason?: string;
+}
+
 export interface V2OrderCreateResult extends V2Object {
   object: "checkout_session";
   checkout_url: string | null;
@@ -751,3 +785,23 @@ export interface V2GrantCreditResult {
   object: "grant_credit_result";
   new_balance_cents: number;
 }
+
+// --- Email ---
+
+export interface V2EmailSendParams {
+  to: string | string[];
+  subject: string;
+  html?: string;
+  text?: string;
+  from?: string;
+  reply_to?: string;
+  cc?: string | string[];
+  bcc?: string | string[];
+}
+
+export interface V2EmailSendResult {
+  object: "email";
+  id: string | null;
+  status: "sent";
+  to: string | string[];
+}