perspectapi-ts-sdk 7.2.8 → 7.4.0

package/dist/index.mjs

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

package/dist/v2/index.d.mts

@@ -1 +1 @@
-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-BbTVcEl5.mjs';
+export { cI as ApiKeysV2Client, cx as BaseV2Client, cA as CategoriesV2Client, cB as CollectionsV2Client, cF as ContactsV2Client, cy as ContentV2Client, cL as CreditsV2Client, cN as EmailTemplatesV2Client, cM as EmailV2Client, cE as NewsletterV2Client, cC as OrdersV2Client, cG as OrganizationsV2Client, ay as PerspectApiV2Client, cw as PerspectApiV2Config, aA as PerspectV2Error, cz as ProductsV2Client, cD as SiteUsersV2Client, cH as SitesV2Client, cK as SubscriptionsV2Client, bS as V2ApiKey, c1 as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bP as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, c3 as V2CreditBalance, c2 as V2CreditTransaction, aT as V2Deleted, c8 as V2EmailSendParams, ce as V2EmailSendResult, c9 as V2EmailTemplate, cd as V2EmailTemplateCloneParams, cc as V2EmailTemplateCreateParams, cb as V2EmailTemplateListParams, c7 as V2EmailTemplateStatus, c6 as V2EmailTemplateType, ca as V2EmailTemplateType_Listing, aU as V2Error, aV as V2ErrorType, c4 as V2GrantCreditParams, c5 as V2GrantCreditResult, aS as V2List, aX as V2Media, bN as V2NewsletterBulkParams, bO as V2NewsletterBulkResult, bw as V2NewsletterCampaign, bH as V2NewsletterCampaignCreateParams, bv as V2NewsletterCampaignStatus, bI as V2NewsletterCampaignUpdateParams, bF as V2NewsletterImportRequest, bG as V2NewsletterImportResult, bu as V2NewsletterList, bA as V2NewsletterListCreateParams, bB as V2NewsletterListUpdateParams, bx as V2NewsletterSeries, bJ as V2NewsletterSeriesCreateParams, bK as V2NewsletterSeriesUpdateParams, by as V2NewsletterStatistics, bL as V2NewsletterStatisticsParams, bt as V2NewsletterSubscription, bE as V2NewsletterSubscriptionListMembershipUpdate, bM as V2NewsletterSubscriptionStatusUpdate, bC as V2NewsletterSyncInput, bD as V2NewsletterSyncResult, bz 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, bQ as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bR as V2Site, bn as V2SiteUser, bq as V2SiteUserListParams, bp as V2SiteUserMeUpdateParams, bs as V2SiteUserProfile, bX as V2SiteUserSubscription, bo as V2SiteUserUpdateParams, br as V2SiteUserWithProfile, bZ as V2SubscriptionCancelParams, b_ as V2SubscriptionChangePlanParams, b$ as V2SubscriptionChargeParams, c0 as V2SubscriptionChargeResult, bY as V2SubscriptionPauseParams, bU as V2Webhook, bV as V2WebhookCreateParams, bT as V2WebhookEventType, bW as V2WebhookUpdateParams, cJ as WebhooksV2Client, az as createPerspectApiV2Client } from '../index-CmcHYKO8.mjs';

package/dist/v2/index.d.ts

@@ -1 +1 @@
-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-BbTVcEl5.js';
+export { cI as ApiKeysV2Client, cx as BaseV2Client, cA as CategoriesV2Client, cB as CollectionsV2Client, cF as ContactsV2Client, cy as ContentV2Client, cL as CreditsV2Client, cN as EmailTemplatesV2Client, cM as EmailV2Client, cE as NewsletterV2Client, cC as OrdersV2Client, cG as OrganizationsV2Client, ay as PerspectApiV2Client, cw as PerspectApiV2Config, aA as PerspectV2Error, cz as ProductsV2Client, cD as SiteUsersV2Client, cH as SitesV2Client, cK as SubscriptionsV2Client, bS as V2ApiKey, c1 as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bP as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, c3 as V2CreditBalance, c2 as V2CreditTransaction, aT as V2Deleted, c8 as V2EmailSendParams, ce as V2EmailSendResult, c9 as V2EmailTemplate, cd as V2EmailTemplateCloneParams, cc as V2EmailTemplateCreateParams, cb as V2EmailTemplateListParams, c7 as V2EmailTemplateStatus, c6 as V2EmailTemplateType, ca as V2EmailTemplateType_Listing, aU as V2Error, aV as V2ErrorType, c4 as V2GrantCreditParams, c5 as V2GrantCreditResult, aS as V2List, aX as V2Media, bN as V2NewsletterBulkParams, bO as V2NewsletterBulkResult, bw as V2NewsletterCampaign, bH as V2NewsletterCampaignCreateParams, bv as V2NewsletterCampaignStatus, bI as V2NewsletterCampaignUpdateParams, bF as V2NewsletterImportRequest, bG as V2NewsletterImportResult, bu as V2NewsletterList, bA as V2NewsletterListCreateParams, bB as V2NewsletterListUpdateParams, bx as V2NewsletterSeries, bJ as V2NewsletterSeriesCreateParams, bK as V2NewsletterSeriesUpdateParams, by as V2NewsletterStatistics, bL as V2NewsletterStatisticsParams, bt as V2NewsletterSubscription, bE as V2NewsletterSubscriptionListMembershipUpdate, bM as V2NewsletterSubscriptionStatusUpdate, bC as V2NewsletterSyncInput, bD as V2NewsletterSyncResult, bz 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, bQ as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bR as V2Site, bn as V2SiteUser, bq as V2SiteUserListParams, bp as V2SiteUserMeUpdateParams, bs as V2SiteUserProfile, bX as V2SiteUserSubscription, bo as V2SiteUserUpdateParams, br as V2SiteUserWithProfile, bZ as V2SubscriptionCancelParams, b_ as V2SubscriptionChangePlanParams, b$ as V2SubscriptionChargeParams, c0 as V2SubscriptionChargeResult, bY as V2SubscriptionPauseParams, bU as V2Webhook, bV as V2WebhookCreateParams, bT as V2WebhookEventType, bW as V2WebhookUpdateParams, cJ as WebhooksV2Client, az as createPerspectApiV2Client } from '../index-CmcHYKO8.js';

package/dist/v2/index.js

@@ -27,6 +27,7 @@ __export(v2_exports, {
   ContactsV2Client: () => ContactsV2Client,
   ContentV2Client: () => ContentV2Client,
   CreditsV2Client: () => CreditsV2Client,
+  EmailTemplatesV2Client: () => EmailTemplatesV2Client,
   EmailV2Client: () => EmailV2Client,
   NewsletterV2Client: () => NewsletterV2Client,
   OrdersV2Client: () => OrdersV2Client,
@@ -140,6 +141,8 @@ var HttpClient = class {
     }
     this.dbg(`[HTTP Client] Headers:`, JSON.stringify(safeHeaders, null, 2));
     let lastError;
+    const method = (options.method || "GET").toUpperCase();
+    const isIdempotent = method === "GET" || method === "HEAD";
     for (let attempt = 0; attempt <= this.retries; attempt++) {
       try {
         const response = await this.fetchWithTimeout(url, requestOptions);
@@ -149,6 +152,9 @@ var HttpClient = class {
         if (error && typeof error === "object" && "status" in error && typeof error.status === "number" && error.status < 500) {
           throw error;
         }
+        if (!isIdempotent) {
+          throw error;
+        }
         if (attempt === this.retries) {
           break;
         }
@@ -1293,6 +1299,97 @@ var NewsletterV2Client = class extends BaseV2Client {
       data
     );
   }
+  // --- Lists (get by id) ---
+  async getListById(siteName, id, cachePolicy) {
+    return this.getOne(
+      this.sitePath(siteName, "newsletter", `lists/${encodeURIComponent(id)}`),
+      void 0,
+      cachePolicy
+    );
+  }
+  // --- Subscriptions (admin: lookup / status / delete / bulk) ---
+  async getSubscriptionByEmail(siteName, email, cachePolicy) {
+    return this.getOne(
+      this.sitePath(siteName, "newsletter", "subscriptions/by-email"),
+      { email },
+      cachePolicy
+    );
+  }
+  async updateSubscriptionStatus(siteName, id, data) {
+    return this.post(
+      this.sitePath(siteName, "newsletter", `subscriptions/${encodeURIComponent(id)}/status`),
+      data
+    );
+  }
+  async deleteSubscription(siteName, id) {
+    return this.deleteOne(
+      this.sitePath(siteName, "newsletter", `subscriptions/${encodeURIComponent(id)}`)
+    );
+  }
+  async bulkUpdateSubscriptions(siteName, data) {
+    return this.post(
+      this.sitePath(siteName, "newsletter", "subscriptions/bulk"),
+      data
+    );
+  }
+  // --- Statistics ---
+  async getStatistics(siteName, params, cachePolicy) {
+    return this.getOne(
+      this.sitePath(siteName, "newsletter", "statistics"),
+      params,
+      cachePolicy
+    );
+  }
+  // --- Campaigns (create / update / delete) ---
+  async createCampaign(siteName, data) {
+    return this.post(
+      this.sitePath(siteName, "newsletter", "campaigns"),
+      data
+    );
+  }
+  async updateCampaign(siteName, id, data) {
+    return this.patchOne(
+      this.sitePath(siteName, "newsletter", `campaigns/${encodeURIComponent(id)}`),
+      data
+    );
+  }
+  async deleteCampaign(siteName, id) {
+    return this.deleteOne(
+      this.sitePath(siteName, "newsletter", `campaigns/${encodeURIComponent(id)}`)
+    );
+  }
+  // --- Series ---
+  async listSeries(siteName, params, cachePolicy) {
+    return this.getList(
+      this.sitePath(siteName, "newsletter", "series"),
+      params,
+      cachePolicy
+    );
+  }
+  async getSeries(siteName, id, cachePolicy) {
+    return this.getOne(
+      this.sitePath(siteName, "newsletter", `series/${encodeURIComponent(id)}`),
+      void 0,
+      cachePolicy
+    );
+  }
+  async createSeries(siteName, data) {
+    return this.post(
+      this.sitePath(siteName, "newsletter", "series"),
+      data
+    );
+  }
+  async updateSeries(siteName, id, data) {
+    return this.patchOne(
+      this.sitePath(siteName, "newsletter", `series/${encodeURIComponent(id)}`),
+      data
+    );
+  }
+  async deleteSeries(siteName, id) {
+    return this.deleteOne(
+      this.sitePath(siteName, "newsletter", `series/${encodeURIComponent(id)}`)
+    );
+  }
 };
 
 // src/v2/client/contacts-client.ts
@@ -1481,11 +1578,18 @@ 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.
+   * Send a transactional email through the site's email provider.
+   *
+   * Requires a server-side API key — never call this from a browser. Sites
+   * without a configured provider fall back to the platform default with
+   * policy restrictions (owner-only recipients, daily quota).
    *
-   * 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.
+   * Provide content one of two ways (mutually exclusive):
+   *  - Raw: `subject` plus at least one of `html` / `text`.
+   *  - Template: `template_type` (published template for that type) or
+   *    `template_id` (published template by ID) plus optional `variables`; the
+   *    template is rendered server-side. `subject` is optional here and
+   *    overrides the rendered one.
    */
   async send(siteName, params) {
     return this.post(
@@ -1495,6 +1599,66 @@ var EmailV2Client = class extends BaseV2Client {
   }
 };
 
+// src/v2/client/email-templates-client.ts
+var EmailTemplatesV2Client = class extends BaseV2Client {
+  path(siteName, suffix = "") {
+    return this.sitePath(siteName, "email", suffix ? `templates/${suffix}` : "templates");
+  }
+  /** List every supported template type with its allowed variables. */
+  async listTypes(siteName, cachePolicy) {
+    return this.getList(
+      this.path(siteName, "types"),
+      void 0,
+      cachePolicy
+    );
+  }
+  /** Get the allowed variables for a single template type. */
+  async getTypeVariables(siteName, templateType, cachePolicy) {
+    return this.getOne(
+      this.path(siteName, `types/${templateType}`),
+      void 0,
+      cachePolicy
+    );
+  }
+  /** List template versions, optionally filtered by type and/or status. */
+  async list(siteName, params, cachePolicy) {
+    return this.getList(this.path(siteName), params, cachePolicy);
+  }
+  /** Get a specific template version by ID (`etpl_…`). */
+  async get(siteName, templateId, cachePolicy) {
+    return this.getOne(
+      this.path(siteName, encodeURIComponent(templateId)),
+      void 0,
+      cachePolicy
+    );
+  }
+  /** Get the currently published version for a template type. */
+  async getPublished(siteName, templateType, cachePolicy) {
+    return this.getOne(
+      this.path(siteName, `published/${templateType}`),
+      void 0,
+      cachePolicy
+    );
+  }
+  /** Create a new template version. */
+  async create(siteName, params) {
+    return this.post(this.path(siteName), params);
+  }
+  /** Clone a template version, optionally overriding fields. */
+  async clone(siteName, templateId, params) {
+    return this.post(
+      this.path(siteName, `${encodeURIComponent(templateId)}/clone`),
+      params ?? {}
+    );
+  }
+  /** Publish a template version (archives the previously published one). */
+  async publish(siteName, templateId) {
+    return this.post(
+      this.path(siteName, `${encodeURIComponent(templateId)}/publish`)
+    );
+  }
+};
+
 // src/v2/index.ts
 var PerspectApiV2Client = class {
   http;
@@ -1514,6 +1678,7 @@ var PerspectApiV2Client = class {
   subscriptions;
   credits;
   email;
+  emailTemplates;
   constructor(config) {
     const baseUrl = config.baseUrl.replace(/\/+$/, "");
     const v2BaseUrl = baseUrl.endsWith("/api/v2") ? baseUrl : `${baseUrl}/api/v2`;
@@ -1536,6 +1701,7 @@ var PerspectApiV2Client = class {
     this.subscriptions = new SubscriptionsV2Client(this.http, basePath, cache);
     this.credits = new CreditsV2Client(this.http, basePath, cache);
     this.email = new EmailV2Client(this.http, basePath, cache);
+    this.emailTemplates = new EmailTemplatesV2Client(this.http, basePath, cache);
   }
   /** Update the JWT token for authenticated requests. */
   setAuth(jwt) {
@@ -1562,6 +1728,7 @@ function createPerspectApiV2Client(config) {
   ContactsV2Client,
   ContentV2Client,
   CreditsV2Client,
+  EmailTemplatesV2Client,
   EmailV2Client,
   NewsletterV2Client,
   OrdersV2Client,

package/dist/v2/index.mjs

@@ -6,6 +6,7 @@ import {
   ContactsV2Client,
   ContentV2Client,
   CreditsV2Client,
+  EmailTemplatesV2Client,
   EmailV2Client,
   NewsletterV2Client,
   OrdersV2Client,
@@ -18,7 +19,7 @@ import {
   SubscriptionsV2Client,
   WebhooksV2Client,
   createPerspectApiV2Client
-} from "../chunk-WD62IBI5.mjs";
+} from "../chunk-PWZSSX4V.mjs";
 export {
   ApiKeysV2Client,
   BaseV2Client,
@@ -27,6 +28,7 @@ export {
   ContactsV2Client,
   ContentV2Client,
   CreditsV2Client,
+  EmailTemplatesV2Client,
   EmailV2Client,
   NewsletterV2Client,
   OrdersV2Client,

package/package.json

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

package/src/utils/http-client.ts

@@ -115,25 +115,37 @@ export class HttpClient {
     this.dbg(`[HTTP Client] Headers:`, JSON.stringify(safeHeaders, null, 2));
 
     let lastError: Error;
-    
+
+    // Only retry idempotent methods. Retrying POST/PATCH/PUT/DELETE on a
+    // timeout or 5xx can duplicate a side effect the server already applied
+    // (e.g. send the same transactional email twice, create two campaigns).
+    const method = (options.method || 'GET').toUpperCase();
+    const isIdempotent = method === 'GET' || method === 'HEAD';
+
     for (let attempt = 0; attempt <= this.retries; attempt++) {
       try {
         const response = await this.fetchWithTimeout(url, requestOptions);
         return await this.handleResponse<T>(response);
       } catch (error) {
         lastError = error as Error;
-        
+
         // Don't retry on client errors (4xx)
-        if (error && typeof error === 'object' && 'status' in error && 
+        if (error && typeof error === 'object' && 'status' in error &&
             typeof (error as any).status === 'number' && (error as any).status < 500) {
           throw error;
         }
-        
+
+        // Don't retry non-idempotent methods — the request may have been
+        // applied server-side even though we saw a timeout/5xx.
+        if (!isIdempotent) {
+          throw error;
+        }
+
         // Don't retry on last attempt
         if (attempt === this.retries) {
           break;
         }
-        
+
         // Exponential backoff
         await this.delay(Math.pow(2, attempt) * 1000);
       }

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

@@ -8,11 +8,18 @@ import type { V2EmailSendParams, V2EmailSendResult } from '../types';
 export class EmailV2Client extends BaseV2Client {
 
   /**
-   * Send a transactional email using the site's configured email provider.
+   * Send a transactional email through the site's 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.
+   * Requires a server-side API key — never call this from a browser. Sites
+   * without a configured provider fall back to the platform default with
+   * policy restrictions (owner-only recipients, daily quota).
+   *
+   * Provide content one of two ways (mutually exclusive):
+   *  - Raw: `subject` plus at least one of `html` / `text`.
+   *  - Template: `template_type` (published template for that type) or
+   *    `template_id` (published template by ID) plus optional `variables`; the
+   *    template is rendered server-side. `subject` is optional here and
+   *    overrides the rendered one.
    */
   async send(siteName: string, params: V2EmailSendParams): Promise<V2EmailSendResult> {
     return this.post<V2EmailSendResult>(

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

@@ -0,0 +1,113 @@
+/**
+ * v2 Email Templates Client — versioned CRUD for site email templates.
+ *
+ * Mirrors the email_template_* MCP tools. Templates live under
+ * /sites/:siteName/email/templates. Use `listTypes` / `getTypeVariables` to
+ * discover the allowed substitution variables for each template type before
+ * authoring, then create/clone/publish versions.
+ */
+
+import { BaseV2Client } from './base-v2-client';
+import type { CachePolicy } from '../../cache/types';
+import type {
+  V2EmailTemplate,
+  V2EmailTemplateType,
+  V2EmailTemplateType_Listing,
+  V2EmailTemplateListParams,
+  V2EmailTemplateCreateParams,
+  V2EmailTemplateCloneParams,
+  V2List,
+} from '../types';
+
+export class EmailTemplatesV2Client extends BaseV2Client {
+  private path(siteName: string, suffix = ''): string {
+    return this.sitePath(siteName, 'email', suffix ? `templates/${suffix}` : 'templates');
+  }
+
+  /** List every supported template type with its allowed variables. */
+  async listTypes(
+    siteName: string,
+    cachePolicy?: CachePolicy,
+  ): Promise<V2List<V2EmailTemplateType_Listing>> {
+    return this.getList<V2EmailTemplateType_Listing>(
+      this.path(siteName, 'types'),
+      undefined,
+      cachePolicy,
+    );
+  }
+
+  /** Get the allowed variables for a single template type. */
+  async getTypeVariables(
+    siteName: string,
+    templateType: V2EmailTemplateType,
+    cachePolicy?: CachePolicy,
+  ): Promise<V2EmailTemplateType_Listing> {
+    return this.getOne<V2EmailTemplateType_Listing>(
+      this.path(siteName, `types/${templateType}`),
+      undefined,
+      cachePolicy,
+    );
+  }
+
+  /** List template versions, optionally filtered by type and/or status. */
+  async list(
+    siteName: string,
+    params?: V2EmailTemplateListParams,
+    cachePolicy?: CachePolicy,
+  ): Promise<V2List<V2EmailTemplate>> {
+    return this.getList<V2EmailTemplate>(this.path(siteName), params, cachePolicy);
+  }
+
+  /** Get a specific template version by ID (`etpl_…`). */
+  async get(
+    siteName: string,
+    templateId: string,
+    cachePolicy?: CachePolicy,
+  ): Promise<V2EmailTemplate> {
+    return this.getOne<V2EmailTemplate>(
+      this.path(siteName, encodeURIComponent(templateId)),
+      undefined,
+      cachePolicy,
+    );
+  }
+
+  /** Get the currently published version for a template type. */
+  async getPublished(
+    siteName: string,
+    templateType: V2EmailTemplateType,
+    cachePolicy?: CachePolicy,
+  ): Promise<V2EmailTemplate> {
+    return this.getOne<V2EmailTemplate>(
+      this.path(siteName, `published/${templateType}`),
+      undefined,
+      cachePolicy,
+    );
+  }
+
+  /** Create a new template version. */
+  async create(
+    siteName: string,
+    params: V2EmailTemplateCreateParams,
+  ): Promise<V2EmailTemplate> {
+    return this.post<V2EmailTemplate>(this.path(siteName), params);
+  }
+
+  /** Clone a template version, optionally overriding fields. */
+  async clone(
+    siteName: string,
+    templateId: string,
+    params?: V2EmailTemplateCloneParams,
+  ): Promise<V2EmailTemplate> {
+    return this.post<V2EmailTemplate>(
+      this.path(siteName, `${encodeURIComponent(templateId)}/clone`),
+      params ?? {},
+    );
+  }
+
+  /** Publish a template version (archives the previously published one). */
+  async publish(siteName: string, templateId: string): Promise<V2EmailTemplate> {
+    return this.post<V2EmailTemplate>(
+      this.path(siteName, `${encodeURIComponent(templateId)}/publish`),
+    );
+  }
+}

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

@@ -6,11 +6,16 @@ import { BaseV2Client } from './base-v2-client';
 import type { CachePolicy } from '../../cache/types';
 import type {
   V2NewsletterSubscription, V2NewsletterList, V2NewsletterCampaign,
+  V2NewsletterSeries, V2NewsletterStatistics,
   V2PaginationParams, V2List, V2Deleted, V2NewsletterTrackingResponse,
   V2NewsletterListCreateParams, V2NewsletterListUpdateParams,
   V2NewsletterSyncInput, V2NewsletterSyncResult,
   V2NewsletterSubscriptionListMembershipUpdate,
   V2NewsletterImportRequest, V2NewsletterImportResult,
+  V2NewsletterCampaignCreateParams, V2NewsletterCampaignUpdateParams,
+  V2NewsletterSeriesCreateParams, V2NewsletterSeriesUpdateParams,
+  V2NewsletterStatisticsParams, V2NewsletterSubscriptionStatusUpdate,
+  V2NewsletterBulkParams, V2NewsletterBulkResult,
 } from '../types';
 
 export class NewsletterV2Client extends BaseV2Client {
@@ -206,4 +211,155 @@ export class NewsletterV2Client extends BaseV2Client {
       data,
     );
   }
+
+  // --- Lists (get by id) ---
+
+  async getListById(
+    siteName: string,
+    id: string,
+    cachePolicy?: CachePolicy,
+  ): Promise<V2NewsletterList> {
+    return this.getOne<V2NewsletterList>(
+      this.sitePath(siteName, 'newsletter', `lists/${encodeURIComponent(id)}`),
+      undefined,
+      cachePolicy,
+    );
+  }
+
+  // --- Subscriptions (admin: lookup / status / delete / bulk) ---
+
+  async getSubscriptionByEmail(
+    siteName: string,
+    email: string,
+    cachePolicy?: CachePolicy,
+  ): Promise<V2NewsletterSubscription> {
+    return this.getOne<V2NewsletterSubscription>(
+      this.sitePath(siteName, 'newsletter', 'subscriptions/by-email'),
+      { email },
+      cachePolicy,
+    );
+  }
+
+  async updateSubscriptionStatus(
+    siteName: string,
+    id: string,
+    data: V2NewsletterSubscriptionStatusUpdate,
+  ): Promise<V2NewsletterSubscription> {
+    return this.post<V2NewsletterSubscription>(
+      this.sitePath(siteName, 'newsletter', `subscriptions/${encodeURIComponent(id)}/status`),
+      data,
+    );
+  }
+
+  async deleteSubscription(siteName: string, id: string): Promise<V2Deleted> {
+    return this.deleteOne(
+      this.sitePath(siteName, 'newsletter', `subscriptions/${encodeURIComponent(id)}`),
+    );
+  }
+
+  async bulkUpdateSubscriptions(
+    siteName: string,
+    data: V2NewsletterBulkParams,
+  ): Promise<V2NewsletterBulkResult> {
+    return this.post<V2NewsletterBulkResult>(
+      this.sitePath(siteName, 'newsletter', 'subscriptions/bulk'),
+      data,
+    );
+  }
+
+  // --- Statistics ---
+
+  async getStatistics(
+    siteName: string,
+    params?: V2NewsletterStatisticsParams,
+    cachePolicy?: CachePolicy,
+  ): Promise<V2NewsletterStatistics> {
+    return this.getOne<V2NewsletterStatistics>(
+      this.sitePath(siteName, 'newsletter', 'statistics'),
+      params,
+      cachePolicy,
+    );
+  }
+
+  // --- Campaigns (create / update / delete) ---
+
+  async createCampaign(
+    siteName: string,
+    data: V2NewsletterCampaignCreateParams,
+  ): Promise<V2NewsletterCampaign> {
+    return this.post<V2NewsletterCampaign>(
+      this.sitePath(siteName, 'newsletter', 'campaigns'),
+      data,
+    );
+  }
+
+  async updateCampaign(
+    siteName: string,
+    id: string,
+    data: V2NewsletterCampaignUpdateParams,
+  ): Promise<V2NewsletterCampaign> {
+    return this.patchOne<V2NewsletterCampaign>(
+      this.sitePath(siteName, 'newsletter', `campaigns/${encodeURIComponent(id)}`),
+      data,
+    );
+  }
+
+  async deleteCampaign(siteName: string, id: string): Promise<V2Deleted> {
+    return this.deleteOne(
+      this.sitePath(siteName, 'newsletter', `campaigns/${encodeURIComponent(id)}`),
+    );
+  }
+
+  // --- Series ---
+
+  async listSeries(
+    siteName: string,
+    params?: { status?: 'active' | 'paused' | 'archived' },
+    cachePolicy?: CachePolicy,
+  ): Promise<V2List<V2NewsletterSeries>> {
+    return this.getList<V2NewsletterSeries>(
+      this.sitePath(siteName, 'newsletter', 'series'),
+      params,
+      cachePolicy,
+    );
+  }
+
+  async getSeries(
+    siteName: string,
+    id: string,
+    cachePolicy?: CachePolicy,
+  ): Promise<V2NewsletterSeries> {
+    return this.getOne<V2NewsletterSeries>(
+      this.sitePath(siteName, 'newsletter', `series/${encodeURIComponent(id)}`),
+      undefined,
+      cachePolicy,
+    );
+  }
+
+  async createSeries(
+    siteName: string,
+    data: V2NewsletterSeriesCreateParams,
+  ): Promise<V2NewsletterSeries> {
+    return this.post<V2NewsletterSeries>(
+      this.sitePath(siteName, 'newsletter', 'series'),
+      data,
+    );
+  }
+
+  async updateSeries(
+    siteName: string,
+    id: string,
+    data: V2NewsletterSeriesUpdateParams,
+  ): Promise<V2NewsletterSeries> {
+    return this.patchOne<V2NewsletterSeries>(
+      this.sitePath(siteName, 'newsletter', `series/${encodeURIComponent(id)}`),
+      data,
+    );
+  }
+
+  async deleteSeries(siteName: string, id: string): Promise<V2Deleted> {
+    return this.deleteOne(
+      this.sitePath(siteName, 'newsletter', `series/${encodeURIComponent(id)}`),
+    );
+  }
 }