perspectapi-ts-sdk 7.2.6 → 7.4.0

package/dist/index.js

@@ -182,6 +182,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);
@@ -191,6 +193,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;
         }
@@ -1347,6 +1352,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
@@ -1535,11 +1631,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(
@@ -1549,6 +1652,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;
@@ -1568,6 +1731,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`;
@@ -1590,6 +1754,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) {
@@ -4478,7 +4643,7 @@ function buildAbClient(apiKey, siteName, baseUrl, ctx, config, visitorId, isBot)
         return { variant: flag.defaultVariant, enrolled: false, config: null };
       }
       const variantCfg = flag.variants.find((v) => v.key === assigned)?.config ?? null;
-      emit(apiKey, baseUrl, ctx, {
+      await emit(apiKey, baseUrl, ctx, {
         site: siteName,
         kind: "exposure",
         flag: flagKey,
@@ -4499,7 +4664,7 @@ function buildAbClient(apiKey, siteName, baseUrl, ctx, config, visitorId, isBot)
         const bucket = bucketFor(visitorId, flagKey, flag.currentVersion);
         const assigned = variantForBucket(bucket, flag.variants, flag.trafficAllocationBp);
         if (assigned === null) continue;
-        emit(apiKey, baseUrl, ctx, {
+        await emit(apiKey, baseUrl, ctx, {
           site: siteName,
           kind: "conversion",
           flag: flagKey,
@@ -4543,7 +4708,11 @@ function emit(apiKey, baseUrl, ctx, body) {
     headers: { "content-type": "application/json", "x-api-key": apiKey },
     body: JSON.stringify(body)
   }).then(() => void 0).catch(() => void 0);
-  if (ctx) ctx.waitUntil(task);
+  if (ctx) {
+    ctx.waitUntil(task);
+    return Promise.resolve();
+  }
+  return task;
 }
 function classifyBotFromCfRequest(request) {
   const cf = request.cf;

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";
@@ -2889,7 +2889,7 @@ function buildAbClient(apiKey, siteName, baseUrl, ctx, config, visitorId, isBot)
         return { variant: flag.defaultVariant, enrolled: false, config: null };
       }
       const variantCfg = flag.variants.find((v) => v.key === assigned)?.config ?? null;
-      emit(apiKey, baseUrl, ctx, {
+      await emit(apiKey, baseUrl, ctx, {
         site: siteName,
         kind: "exposure",
         flag: flagKey,
@@ -2910,7 +2910,7 @@ function buildAbClient(apiKey, siteName, baseUrl, ctx, config, visitorId, isBot)
         const bucket = bucketFor(visitorId, flagKey, flag.currentVersion);
         const assigned = variantForBucket(bucket, flag.variants, flag.trafficAllocationBp);
         if (assigned === null) continue;
-        emit(apiKey, baseUrl, ctx, {
+        await emit(apiKey, baseUrl, ctx, {
           site: siteName,
           kind: "conversion",
           flag: flagKey,
@@ -2954,7 +2954,11 @@ function emit(apiKey, baseUrl, ctx, body) {
     headers: { "content-type": "application/json", "x-api-key": apiKey },
     body: JSON.stringify(body)
   }).then(() => void 0).catch(() => void 0);
-  if (ctx) ctx.waitUntil(task);
+  if (ctx) {
+    ctx.waitUntil(task);
+    return Promise.resolve();
+  }
+  return task;
 }
 function classifyBotFromCfRequest(request) {
   const cf = request.cf;

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.6",
+  "version": "7.4.0",
   "description": "TypeScript SDK for PerspectAPI - Cloudflare Workers compatible",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/ab/ab-client.ts

@@ -124,7 +124,7 @@ function buildAbClient(
         return { variant: flag.defaultVariant, enrolled: false, config: null };
       }
       const variantCfg = flag.variants.find((v) => v.key === assigned)?.config ?? null;
-      emit(apiKey, baseUrl, ctx, {
+      await emit(apiKey, baseUrl, ctx, {
         site: siteName,
         kind: 'exposure',
         flag: flagKey,
@@ -146,7 +146,7 @@ function buildAbClient(
         const bucket = bucketFor(visitorId, flagKey, flag.currentVersion);
         const assigned = variantForBucket(bucket, flag.variants, flag.trafficAllocationBp);
         if (assigned === null) continue;
-        emit(apiKey, baseUrl, ctx, {
+        await emit(apiKey, baseUrl, ctx, {
           site: siteName,
           kind: 'conversion',
           flag: flagKey,
@@ -225,7 +225,7 @@ function emit(
   baseUrl: string,
   ctx: { waitUntil(p: Promise<unknown>): void } | undefined,
   body: EventBody,
-): void {
+): Promise<void> {
   const task = fetch(`${baseUrl}/_ab/event`, {
     method: 'POST',
     headers: { 'content-type': 'application/json', 'x-api-key': apiKey },
@@ -233,7 +233,11 @@ function emit(
   })
     .then(() => undefined)
     .catch(() => undefined);
-  if (ctx) ctx.waitUntil(task);
+  if (ctx) {
+    ctx.waitUntil(task);
+    return Promise.resolve();
+  }
+  return task;
 }
 
 // ---------------------------------------------------------------------------

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);
       }