perspectapi-ts-sdk 1.1.1 → 1.3.0

package/dist/index.d.ts

@@ -98,6 +98,74 @@ interface CreateSiteRequest {
     description?: string;
     organizationId: number;
 }
+interface NewsletterSubscription {
+    id: string;
+    email: string;
+    name?: string;
+    status: 'pending' | 'confirmed' | 'unsubscribed' | 'bounced' | 'complained';
+    frequency: 'instant' | 'daily' | 'weekly' | 'monthly';
+    topics?: string[];
+    language: string;
+    confirmedAt?: string;
+    unsubscribedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateNewsletterSubscriptionRequest {
+    email: string;
+    name?: string;
+    list_ids?: string[];
+    frequency?: 'instant' | 'daily' | 'weekly' | 'monthly';
+    topics?: string[];
+    language?: string;
+    source?: string;
+    source_url?: string;
+    double_opt_in?: boolean;
+    turnstile_token?: string;
+    metadata?: Record<string, any>;
+}
+interface NewsletterList {
+    id: string;
+    list_name: string;
+    slug: string;
+    description?: string;
+    is_default: boolean;
+    subscriber_count?: number;
+}
+interface NewsletterPreferences {
+    frequency?: 'instant' | 'daily' | 'weekly' | 'monthly';
+    topics?: string[];
+    language?: string;
+    email_format?: 'html' | 'text' | 'both';
+    timezone?: string;
+    track_opens?: boolean;
+    track_clicks?: boolean;
+}
+interface NewsletterStatusResponse {
+    subscribed: boolean;
+    status: string;
+    frequency?: string;
+    created_at?: string;
+    confirmed_at?: string;
+}
+interface NewsletterSubscribeResponse {
+    message: string;
+    status: string;
+    subscription_id?: string;
+}
+interface NewsletterConfirmResponse {
+    message: string;
+    subscription?: {
+        email: string;
+        name?: string;
+        frequency: string;
+    };
+}
+interface NewsletterUnsubscribeRequest {
+    token?: string;
+    email?: string;
+    reason?: string;
+}
 type ContentStatus = 'draft' | 'publish' | 'private' | 'trash';
 type ContentType = 'post' | 'page';
 interface Content {
@@ -329,6 +397,7 @@ interface RequestOptions {
     body?: any;
     params?: Record<string, string | number | boolean>;
     timeout?: number;
+    csrfToken?: string;
 }
 
 /**
@@ -365,19 +434,19 @@ declare class HttpClient {
     /**
      * POST request
      */
-    post<T = any>(endpoint: string, body?: any): Promise<ApiResponse<T>>;
+    post<T = any>(endpoint: string, body?: any, options?: Partial<RequestOptions>): Promise<ApiResponse<T>>;
     /**
      * PUT request
      */
-    put<T = any>(endpoint: string, body?: any): Promise<ApiResponse<T>>;
+    put<T = any>(endpoint: string, body?: any, options?: Partial<RequestOptions>): Promise<ApiResponse<T>>;
     /**
      * DELETE request
      */
-    delete<T = any>(endpoint: string): Promise<ApiResponse<T>>;
+    delete<T = any>(endpoint: string, options?: Partial<RequestOptions>): Promise<ApiResponse<T>>;
     /**
      * PATCH request
      */
-    patch<T = any>(endpoint: string, body?: any): Promise<ApiResponse<T>>;
+    patch<T = any>(endpoint: string, body?: any, options?: Partial<RequestOptions>): Promise<ApiResponse<T>>;
     /**
      * Build full URL with query parameters
      */
@@ -433,19 +502,19 @@ declare abstract class BaseClient {
     /**
      * Handle create operations
      */
-    protected create<T, R = T>(endpoint: string, data: T): Promise<ApiResponse<R>>;
+    protected create<T, R = T>(endpoint: string, data: T, csrfToken?: string): Promise<ApiResponse<R>>;
     /**
      * Handle update operations
      */
-    protected update<T, R = T>(endpoint: string, data: T): Promise<ApiResponse<R>>;
+    protected update<T, R = T>(endpoint: string, data: T, csrfToken?: string): Promise<ApiResponse<R>>;
     /**
      * Handle partial update operations
      */
-    protected patch<T, R = T>(endpoint: string, data: T): Promise<ApiResponse<R>>;
+    protected patch<T, R = T>(endpoint: string, data: T, csrfToken?: string): Promise<ApiResponse<R>>;
     /**
      * Handle delete operations
      */
-    protected delete<T = any>(endpoint: string): Promise<ApiResponse<T>>;
+    protected delete<T = any>(endpoint: string, csrfToken?: string): Promise<ApiResponse<T>>;
 }
 
 /**
@@ -1389,8 +1458,11 @@ declare class ContactClient extends BaseClient {
     private contactEndpoint;
     /**
      * Submit contact form
+     * @param siteName - The site to submit contact form to
+     * @param data - Contact form data
+     * @param csrfToken - CSRF token (required for browser-based submissions)
      */
-    submitContact(siteName: string, data: CreateContactRequest): Promise<ApiResponse<{
+    submitContact(siteName: string, data: CreateContactRequest, csrfToken?: string): Promise<ApiResponse<{
         id: string;
         message: string;
         status: string;
@@ -1532,6 +1604,208 @@ declare class ContactClient extends BaseClient {
     }>>;
 }
 
+/**
+ * Newsletter subscription client for PerspectAPI SDK
+ */
+
+declare class NewsletterClient extends BaseClient {
+    constructor(http: any);
+    /**
+     * Build a newsletter endpoint scoped to a site (without /sites prefix)
+     */
+    private newsletterEndpoint;
+    /**
+     * Subscribe to newsletter
+     * @param siteName - The site to subscribe to
+     * @param data - Subscription data
+     * @param csrfToken - CSRF token (required for browser-based submissions)
+     */
+    subscribe(siteName: string, data: CreateNewsletterSubscriptionRequest, csrfToken?: string): Promise<ApiResponse<NewsletterSubscribeResponse>>;
+    /**
+     * Confirm newsletter subscription via token
+     */
+    confirmSubscription(siteName: string, token: string): Promise<ApiResponse<NewsletterConfirmResponse>>;
+    /**
+     * Unsubscribe from newsletter
+     * @param siteName - The site to unsubscribe from
+     * @param data - Unsubscribe data
+     * @param csrfToken - CSRF token (required for browser-based submissions)
+     */
+    unsubscribe(siteName: string, data: NewsletterUnsubscribeRequest, csrfToken?: string): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * One-click unsubscribe via token (GET request)
+     */
+    unsubscribeByToken(siteName: string, token: string): Promise<ApiResponse<string>>;
+    /**
+     * Update subscription preferences
+     * @param siteName - The site name
+     * @param email - Subscriber email
+     * @param preferences - New preferences
+     * @param csrfToken - CSRF token (required for browser-based submissions)
+     */
+    updatePreferences(siteName: string, email: string, preferences: NewsletterPreferences, csrfToken?: string): Promise<ApiResponse<{
+        message: string;
+        preferences: NewsletterPreferences;
+    }>>;
+    /**
+     * Get available newsletter lists
+     */
+    getLists(siteName: string): Promise<ApiResponse<{
+        lists: NewsletterList[];
+        total: number;
+    }>>;
+    /**
+     * Check subscription status by email
+     */
+    getStatus(siteName: string, email: string): Promise<ApiResponse<NewsletterStatusResponse>>;
+    /**
+     * Get all newsletter subscriptions (admin only)
+     */
+    getSubscriptions(siteName: string, params?: {
+        page?: number;
+        limit?: number;
+        status?: string;
+        list_id?: string;
+        search?: string;
+        startDate?: string;
+        endDate?: string;
+    }): Promise<PaginatedResponse<NewsletterSubscription>>;
+    /**
+     * Get subscription by ID (admin only)
+     */
+    getSubscriptionById(siteName: string, id: string): Promise<ApiResponse<NewsletterSubscription>>;
+    /**
+     * Update subscription status (admin only)
+     */
+    updateSubscriptionStatus(siteName: string, id: string, status: 'confirmed' | 'unsubscribed' | 'bounced' | 'complained', notes?: string): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Delete subscription (admin only)
+     */
+    deleteSubscription(siteName: string, id: string): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Bulk update subscriptions (admin only)
+     */
+    bulkUpdateSubscriptions(siteName: string, data: {
+        ids: string[];
+        action: 'confirm' | 'unsubscribe' | 'delete' | 'add_to_list' | 'remove_from_list';
+        list_id?: string;
+    }): Promise<ApiResponse<{
+        success: boolean;
+        updatedCount: number;
+        failedCount: number;
+    }>>;
+    /**
+     * Create newsletter list (admin only)
+     */
+    createList(siteName: string, data: {
+        list_name: string;
+        slug: string;
+        description?: string;
+        is_public?: boolean;
+        is_default?: boolean;
+        double_opt_in?: boolean;
+        welcome_email_enabled?: boolean;
+    }): Promise<ApiResponse<NewsletterList>>;
+    /**
+     * Update newsletter list (admin only)
+     */
+    updateList(siteName: string, listId: string, data: Partial<{
+        list_name: string;
+        description: string;
+        is_public: boolean;
+        is_default: boolean;
+        double_opt_in: boolean;
+        welcome_email_enabled: boolean;
+    }>): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Delete newsletter list (admin only)
+     */
+    deleteList(siteName: string, listId: string): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Get newsletter statistics (admin only)
+     */
+    getStatistics(siteName: string, params?: {
+        startDate?: string;
+        endDate?: string;
+        list_id?: string;
+    }): Promise<ApiResponse<{
+        totalSubscribers: number;
+        confirmedSubscribers: number;
+        pendingSubscribers: number;
+        unsubscribedCount: number;
+        bouncedCount: number;
+        subscribersByDay: Array<{
+            date: string;
+            count: number;
+        }>;
+        subscribersByList: Array<{
+            list_id: string;
+            list_name: string;
+            count: number;
+        }>;
+        engagementMetrics: {
+            averageOpenRate: number;
+            averageClickRate: number;
+        };
+    }>>;
+    /**
+     * Export newsletter subscriptions (admin only)
+     */
+    exportSubscriptions(siteName: string, params?: {
+        format?: 'csv' | 'json' | 'xlsx';
+        status?: string;
+        list_id?: string;
+        startDate?: string;
+        endDate?: string;
+    }): Promise<ApiResponse<{
+        downloadUrl: string;
+        expiresAt: string;
+    }>>;
+    /**
+     * Import newsletter subscriptions (admin only)
+     */
+    importSubscriptions(siteName: string, data: {
+        subscriptions: Array<{
+            email: string;
+            name?: string;
+            status?: string;
+            lists?: string[];
+        }>;
+        skip_confirmation?: boolean;
+        update_existing?: boolean;
+    }): Promise<ApiResponse<{
+        imported: number;
+        updated: number;
+        failed: number;
+        errors?: Array<{
+            email: string;
+            error: string;
+        }>;
+    }>>;
+    /**
+     * Send test newsletter (admin only)
+     */
+    sendTestNewsletter(siteName: string, data: {
+        to: string;
+        subject: string;
+        html_content: string;
+        text_content?: string;
+    }): Promise<ApiResponse<{
+        message: string;
+        sent: boolean;
+    }>>;
+}
+
 /**
  * Main PerspectAPI SDK Client
  * Cloudflare Workers compatible TypeScript SDK
@@ -1549,6 +1823,7 @@ declare class PerspectApiClient {
     readonly webhooks: WebhooksClient;
     readonly checkout: CheckoutClient;
     readonly contact: ContactClient;
+    readonly newsletter: NewsletterClient;
     constructor(config: PerspectApiConfig);
     /**
      * Update authentication token
@@ -1767,4 +2042,4 @@ declare function createCheckoutSession(options: CheckoutSessionOptions): Promise
     error: string;
 }>;
 
-export { type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, type AuthResponse, BaseClient, type BlogPost, CategoriesClient, type Category, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, ContactClient, type ContactSubmission, type Content, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreateProductRequest, type CreateSiteRequest, type CreateWebhookRequest, HttpClient, type HttpMethod, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, PerspectApiClient, type PerspectApiConfig, type Product, type ProductQueryParams, ProductsClient, type RequestOptions, type SignInRequest, type SignUpRequest, type Site, SitesClient, type UpdateApiKeyRequest, type UpdateContentRequest, type User, type Webhook, WebhooksClient, createApiError, createCheckoutSession, createPerspectApiClient, PerspectApiClient as default, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformProduct };
+export { type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, type AuthResponse, BaseClient, type BlogPost, CategoriesClient, type Category, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, ContactClient, type ContactSubmission, type Content, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateNewsletterSubscriptionRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreateProductRequest, type CreateSiteRequest, type CreateWebhookRequest, HttpClient, type HttpMethod, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, NewsletterClient, type NewsletterConfirmResponse, type NewsletterList, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterUnsubscribeRequest, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, PerspectApiClient, type PerspectApiConfig, type Product, type ProductQueryParams, ProductsClient, type RequestOptions, type SignInRequest, type SignUpRequest, type Site, SitesClient, type UpdateApiKeyRequest, type UpdateContentRequest, type User, type Webhook, WebhooksClient, createApiError, createCheckoutSession, createPerspectApiClient, PerspectApiClient as default, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformProduct };

package/dist/index.js

@@ -28,6 +28,7 @@ __export(index_exports, {
   ContactClient: () => ContactClient,
   ContentClient: () => ContentClient,
   HttpClient: () => HttpClient,
+  NewsletterClient: () => NewsletterClient,
   OrganizationsClient: () => OrganizationsClient,
   PerspectApiClient: () => PerspectApiClient,
   ProductsClient: () => ProductsClient,
@@ -129,26 +130,26 @@ var HttpClient = class {
   /**
    * POST request
    */
-  async post(endpoint, body) {
-    return this.request(endpoint, { method: "POST", body });
+  async post(endpoint, body, options) {
+    return this.request(endpoint, { method: "POST", body, ...options });
   }
   /**
    * PUT request
    */
-  async put(endpoint, body) {
-    return this.request(endpoint, { method: "PUT", body });
+  async put(endpoint, body, options) {
+    return this.request(endpoint, { method: "PUT", body, ...options });
   }
   /**
    * DELETE request
    */
-  async delete(endpoint) {
-    return this.request(endpoint, { method: "DELETE" });
+  async delete(endpoint, options) {
+    return this.request(endpoint, { method: "DELETE", ...options });
   }
   /**
    * PATCH request
    */
-  async patch(endpoint, body) {
-    return this.request(endpoint, { method: "PATCH", body });
+  async patch(endpoint, body, options) {
+    return this.request(endpoint, { method: "PATCH", body, ...options });
   }
   /**
    * Build full URL with query parameters
@@ -174,6 +175,9 @@ var HttpClient = class {
       ...this.defaultHeaders,
       ...options.headers
     };
+    if (options.csrfToken) {
+      headers["X-CSRF-Token"] = options.csrfToken;
+    }
     const requestOptions = {
       method: options.method || "GET",
       headers
@@ -297,26 +301,26 @@ var BaseClient = class {
   /**
    * Handle create operations
    */
-  async create(endpoint, data) {
-    return this.http.post(this.buildPath(endpoint), data);
+  async create(endpoint, data, csrfToken) {
+    return this.http.post(this.buildPath(endpoint), data, { csrfToken });
   }
   /**
    * Handle update operations
    */
-  async update(endpoint, data) {
-    return this.http.put(this.buildPath(endpoint), data);
+  async update(endpoint, data, csrfToken) {
+    return this.http.put(this.buildPath(endpoint), data, { csrfToken });
   }
   /**
    * Handle partial update operations
    */
-  async patch(endpoint, data) {
-    return this.http.patch(this.buildPath(endpoint), data);
+  async patch(endpoint, data, csrfToken) {
+    return this.http.patch(this.buildPath(endpoint), data, { csrfToken });
   }
   /**
    * Handle delete operations
    */
-  async delete(endpoint) {
-    return this.http.delete(this.buildPath(endpoint));
+  async delete(endpoint, csrfToken) {
+    return this.http.delete(this.buildPath(endpoint), { csrfToken });
   }
 };
 
@@ -1183,9 +1187,15 @@ var ContactClient = class extends BaseClient {
   }
   /**
    * Submit contact form
+   * @param siteName - The site to submit contact form to
+   * @param data - Contact form data
+   * @param csrfToken - CSRF token (required for browser-based submissions)
    */
-  async submitContact(siteName, data) {
-    return this.create(this.contactEndpoint(siteName, "/contact/submit"), data);
+  async submitContact(siteName, data, csrfToken) {
+    if (typeof window !== "undefined" && !csrfToken && !data.turnstileToken) {
+      console.warn("CSRF token recommended for browser-based contact form submissions");
+    }
+    return this.create(this.contactEndpoint(siteName, "/contact/submit"), data, csrfToken);
   }
   /**
    * Get contact submission status
@@ -1267,6 +1277,201 @@ var ContactClient = class extends BaseClient {
   }
 };
 
+// src/client/newsletter-client.ts
+var NewsletterClient = class extends BaseClient {
+  constructor(http) {
+    super(http, "/api/v1");
+  }
+  /**
+   * Build a newsletter endpoint scoped to a site (without /sites prefix)
+   */
+  newsletterEndpoint(siteName, endpoint) {
+    return this.siteScopedEndpoint(siteName, endpoint, { includeSitesSegment: false });
+  }
+  /**
+   * Subscribe to newsletter
+   * @param siteName - The site to subscribe to
+   * @param data - Subscription data
+   * @param csrfToken - CSRF token (required for browser-based submissions)
+   */
+  async subscribe(siteName, data, csrfToken) {
+    if (typeof window !== "undefined" && !csrfToken && !data.turnstile_token) {
+      console.warn("CSRF token recommended for browser-based newsletter subscriptions");
+    }
+    return this.create(
+      this.newsletterEndpoint(siteName, "/newsletter/subscribe"),
+      data,
+      csrfToken
+    );
+  }
+  /**
+   * Confirm newsletter subscription via token
+   */
+  async confirmSubscription(siteName, token) {
+    return this.getSingle(
+      this.newsletterEndpoint(siteName, `/newsletter/confirm/${encodeURIComponent(token)}`)
+    );
+  }
+  /**
+   * Unsubscribe from newsletter
+   * @param siteName - The site to unsubscribe from
+   * @param data - Unsubscribe data
+   * @param csrfToken - CSRF token (required for browser-based submissions)
+   */
+  async unsubscribe(siteName, data, csrfToken) {
+    return this.create(
+      this.newsletterEndpoint(siteName, "/newsletter/unsubscribe"),
+      data,
+      csrfToken
+    );
+  }
+  /**
+   * One-click unsubscribe via token (GET request)
+   */
+  async unsubscribeByToken(siteName, token) {
+    return this.http.get(
+      this.buildPath(this.newsletterEndpoint(siteName, `/newsletter/unsubscribe/${encodeURIComponent(token)}`))
+    );
+  }
+  /**
+   * Update subscription preferences
+   * @param siteName - The site name
+   * @param email - Subscriber email
+   * @param preferences - New preferences
+   * @param csrfToken - CSRF token (required for browser-based submissions)
+   */
+  async updatePreferences(siteName, email, preferences, csrfToken) {
+    return this.patch(
+      this.newsletterEndpoint(siteName, "/newsletter/preferences"),
+      { email, ...preferences },
+      csrfToken
+    );
+  }
+  /**
+   * Get available newsletter lists
+   */
+  async getLists(siteName) {
+    return this.getSingle(
+      this.newsletterEndpoint(siteName, "/newsletter/lists")
+    );
+  }
+  /**
+   * Check subscription status by email
+   */
+  async getStatus(siteName, email) {
+    return this.http.get(
+      this.buildPath(this.newsletterEndpoint(siteName, "/newsletter/status")),
+      { email }
+    );
+  }
+  // Admin methods (require authentication)
+  /**
+   * Get all newsletter subscriptions (admin only)
+   */
+  async getSubscriptions(siteName, params) {
+    return this.getPaginated(
+      this.newsletterEndpoint(siteName, "/newsletter/subscriptions"),
+      params
+    );
+  }
+  /**
+   * Get subscription by ID (admin only)
+   */
+  async getSubscriptionById(siteName, id) {
+    return this.getSingle(
+      this.newsletterEndpoint(siteName, `/newsletter/subscriptions/${encodeURIComponent(id)}`)
+    );
+  }
+  /**
+   * Update subscription status (admin only)
+   */
+  async updateSubscriptionStatus(siteName, id, status, notes) {
+    return this.patch(
+      this.newsletterEndpoint(siteName, `/newsletter/subscriptions/${encodeURIComponent(id)}`),
+      { status, notes }
+    );
+  }
+  /**
+   * Delete subscription (admin only)
+   */
+  async deleteSubscription(siteName, id) {
+    return this.delete(
+      this.newsletterEndpoint(siteName, `/newsletter/subscriptions/${encodeURIComponent(id)}`)
+    );
+  }
+  /**
+   * Bulk update subscriptions (admin only)
+   */
+  async bulkUpdateSubscriptions(siteName, data) {
+    return this.create(
+      this.newsletterEndpoint(siteName, "/newsletter/subscriptions/bulk-update"),
+      data
+    );
+  }
+  /**
+   * Create newsletter list (admin only)
+   */
+  async createList(siteName, data) {
+    return this.create(
+      this.newsletterEndpoint(siteName, "/newsletter/lists"),
+      data
+    );
+  }
+  /**
+   * Update newsletter list (admin only)
+   */
+  async updateList(siteName, listId, data) {
+    return this.update(
+      this.newsletterEndpoint(siteName, `/newsletter/lists/${encodeURIComponent(listId)}`),
+      data
+    );
+  }
+  /**
+   * Delete newsletter list (admin only)
+   */
+  async deleteList(siteName, listId) {
+    return this.delete(
+      this.newsletterEndpoint(siteName, `/newsletter/lists/${encodeURIComponent(listId)}`)
+    );
+  }
+  /**
+   * Get newsletter statistics (admin only)
+   */
+  async getStatistics(siteName, params) {
+    return this.http.get(
+      this.buildPath(this.newsletterEndpoint(siteName, "/newsletter/statistics")),
+      params
+    );
+  }
+  /**
+   * Export newsletter subscriptions (admin only)
+   */
+  async exportSubscriptions(siteName, params) {
+    return this.create(
+      this.newsletterEndpoint(siteName, "/newsletter/export"),
+      params || {}
+    );
+  }
+  /**
+   * Import newsletter subscriptions (admin only)
+   */
+  async importSubscriptions(siteName, data) {
+    return this.create(
+      this.newsletterEndpoint(siteName, "/newsletter/import"),
+      data
+    );
+  }
+  /**
+   * Send test newsletter (admin only)
+   */
+  async sendTestNewsletter(siteName, data) {
+    return this.create(
+      this.newsletterEndpoint(siteName, "/newsletter/test"),
+      data
+    );
+  }
+};
+
 // src/perspect-api-client.ts
 var PerspectApiClient = class {
   http;
@@ -1281,6 +1486,7 @@ var PerspectApiClient = class {
   webhooks;
   checkout;
   contact;
+  newsletter;
   constructor(config) {
     if (!config.baseUrl) {
       throw new Error("baseUrl is required in PerspectApiConfig");
@@ -1296,6 +1502,7 @@ var PerspectApiClient = class {
     this.webhooks = new WebhooksClient(this.http);
     this.checkout = new CheckoutClient(this.http);
     this.contact = new ContactClient(this.http);
+    this.newsletter = new NewsletterClient(this.http);
   }
   /**
    * Update authentication token
@@ -1758,6 +1965,7 @@ async function createCheckoutSession(options) {
   ContactClient,
   ContentClient,
   HttpClient,
+  NewsletterClient,
   OrganizationsClient,
   PerspectApiClient,
   ProductsClient,