@subscribeflow/sdk 1.0.5

package/dist/index.js

@@ -0,0 +1,1029 @@
+/**
+ * SubscribeFlow TypeScript SDK
+ *
+ * A type-safe client for the SubscribeFlow API.
+ *
+ * @example
+ * ```typescript
+ * import { SubscribeFlowClient } from '@subscribeflow/sdk';
+ *
+ * const client = new SubscribeFlowClient({
+ *   apiKey: 'sf_live_your_api_key',
+ *   baseUrl: 'https://api.subscribeflow.net', // optional
+ * });
+ *
+ * // Create a subscriber
+ * const subscriber = await client.subscribers.create({
+ *   email: 'user@example.com',
+ *   tags: ['newsletter', 'product-updates'],
+ * });
+ *
+ * // List all tags
+ * const tags = await client.tags.list();
+ * ```
+ *
+ * @packageDocumentation
+ */
+import createClient from "openapi-fetch";
+/**
+ * Error thrown by the SubscribeFlow client.
+ */
+export class SubscribeFlowError extends Error {
+    status;
+    type;
+    detail;
+    instance;
+    constructor(message, status, type, detail, instance) {
+        super(message);
+        this.status = status;
+        this.type = type;
+        this.detail = detail;
+        this.instance = instance;
+        this.name = "SubscribeFlowError";
+    }
+}
+/**
+ * SubscribeFlow API client.
+ *
+ * Provides type-safe access to all SubscribeFlow API endpoints.
+ */
+export class SubscribeFlowClient {
+    client;
+    config;
+    /**
+     * Create a new SubscribeFlow client.
+     *
+     * @param config - Client configuration
+     *
+     * @example
+     * ```typescript
+     * const client = new SubscribeFlowClient({
+     *   apiKey: process.env.SUBSCRIBEFLOW_API_KEY!,
+     * });
+     * ```
+     */
+    constructor(config) {
+        this.config = {
+            baseUrl: "https://api.subscribeflow.net",
+            ...config,
+        };
+        this.client = createClient({
+            baseUrl: this.config.baseUrl,
+            headers: {
+                Authorization: `Bearer ${this.config.apiKey}`,
+                "Content-Type": "application/json",
+            },
+        });
+    }
+    /**
+     * Subscriber management operations.
+     */
+    subscribers = {
+        /**
+         * Create a new subscriber.
+         *
+         * @param data - Subscriber data
+         * @returns The created subscriber
+         *
+         * @example
+         * ```typescript
+         * const subscriber = await client.subscribers.create({
+         *   email: 'user@example.com',
+         *   tags: ['newsletter'],
+         *   metadata: { source: 'website' },
+         * });
+         * ```
+         */
+        create: async (data) => {
+            const { data: result, error } = await this.client.POST("/api/v1/subscribers", {
+                body: data,
+            });
+            if (error) {
+                throw this.handleError(error);
+            }
+            return result;
+        },
+        /**
+         * List all subscribers with optional filtering.
+         *
+         * @param options - Query options
+         * @returns Paginated list of subscribers
+         *
+         * @example
+         * ```typescript
+         * const { items, total, next_cursor } = await client.subscribers.list({
+         *   limit: 50,
+         *   status: 'active',
+         * });
+         * ```
+         */
+        list: async (options) => {
+            const { data: result, error } = await this.client.GET("/api/v1/subscribers", {
+                params: { query: options },
+            });
+            if (error) {
+                throw this.handleError(error);
+            }
+            return result;
+        },
+        /**
+         * Get a subscriber by ID.
+         *
+         * @param id - Subscriber ID (UUID)
+         * @returns The subscriber
+         *
+         * @example
+         * ```typescript
+         * const subscriber = await client.subscribers.get('123e4567-e89b-...');
+         * ```
+         */
+        get: async (id) => {
+            const { data: result, error } = await this.client.GET("/api/v1/subscribers/{subscriber_id}", {
+                params: { path: { subscriber_id: id } },
+            });
+            if (error) {
+                throw this.handleError(error);
+            }
+            return result;
+        },
+        /**
+         * Update a subscriber.
+         *
+         * @param id - Subscriber ID (UUID)
+         * @param data - Fields to update
+         * @returns The updated subscriber
+         */
+        update: async (id, data) => {
+            const { data: result, error } = await this.client.PUT("/api/v1/subscribers/{subscriber_id}", {
+                params: { path: { subscriber_id: id } },
+                body: data,
+            });
+            if (error) {
+                throw this.handleError(error);
+            }
+            return result;
+        },
+        /**
+         * Delete a subscriber.
+         *
+         * @param id - Subscriber ID (UUID)
+         */
+        delete: async (id) => {
+            const { error } = await this.client.DELETE("/api/v1/subscribers/{subscriber_id}", {
+                params: { path: { subscriber_id: id } },
+            });
+            if (error) {
+                throw this.handleError(error);
+            }
+        },
+        /**
+         * Add tags to a subscriber.
+         *
+         * @param id - Subscriber UUID
+         * @param tagIds - Tag UUIDs to add
+         * @returns Updated tag list
+         */
+        addTags: async (id, tagIds) => {
+            const { data: result, error } = await this.client.POST("/api/v1/subscribers/{subscriber_id}/tags", {
+                params: { path: { subscriber_id: id } },
+                body: { tag_ids: tagIds },
+            });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Remove a tag from a subscriber.
+         *
+         * @param id - Subscriber UUID
+         * @param tagId - Tag UUID to remove
+         */
+        removeTag: async (id, tagId) => {
+            const { error } = await this.client.DELETE("/api/v1/subscribers/{subscriber_id}/tags/{tag_id}", {
+                params: {
+                    path: { subscriber_id: id, tag_id: tagId },
+                },
+            });
+            if (error)
+                throw this.handleError(error);
+        },
+        /**
+         * List tags for a subscriber.
+         *
+         * @param id - Subscriber UUID
+         * @returns List of subscriber's tags
+         */
+        listTags: async (id) => {
+            const { data: result, error } = await this.client.GET("/api/v1/subscribers/{subscriber_id}/tags", {
+                params: { path: { subscriber_id: id } },
+            });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+    };
+    /**
+     * Tag management operations.
+     */
+    tags = {
+        /**
+         * Create a new tag.
+         *
+         * @param data - Tag data
+         * @returns The created tag
+         *
+         * @example
+         * ```typescript
+         * const tag = await client.tags.create({
+         *   name: 'Product Updates',
+         *   slug: 'product-updates',
+         *   description: 'Get notified about new features',
+         * });
+         * ```
+         */
+        create: async (data) => {
+            const { data: result, error } = await this.client.POST("/api/v1/tags", {
+                body: data,
+            });
+            if (error) {
+                throw this.handleError(error);
+            }
+            return result;
+        },
+        /**
+         * List all tags.
+         *
+         * @param options - Query options
+         * @returns Paginated list of tags
+         */
+        list: async (options) => {
+            const { data: result, error } = await this.client.GET("/api/v1/tags", {
+                params: { query: options },
+            });
+            if (error) {
+                throw this.handleError(error);
+            }
+            return result;
+        },
+        /**
+         * Get a tag by ID.
+         *
+         * @param id - Tag ID (UUID)
+         * @returns The tag
+         */
+        get: async (id) => {
+            const { data: result, error } = await this.client.GET("/api/v1/tags/{tag_id}", {
+                params: { path: { tag_id: id } },
+            });
+            if (error) {
+                throw this.handleError(error);
+            }
+            return result;
+        },
+        /**
+         * Update a tag.
+         *
+         * @param id - Tag ID (UUID)
+         * @param data - Fields to update
+         * @returns The updated tag
+         */
+        update: async (id, data) => {
+            const { data: result, error } = await this.client.PUT("/api/v1/tags/{tag_id}", {
+                params: { path: { tag_id: id } },
+                body: data,
+            });
+            if (error) {
+                throw this.handleError(error);
+            }
+            return result;
+        },
+        /**
+         * Delete a tag.
+         *
+         * @param id - Tag ID (UUID)
+         */
+        delete: async (id) => {
+            const { error } = await this.client.DELETE("/api/v1/tags/{tag_id}", {
+                params: { path: { tag_id: id } },
+            });
+            if (error) {
+                throw this.handleError(error);
+            }
+        },
+    };
+    /**
+     * Webhook management operations.
+     */
+    webhooks = {
+        /**
+         * Create a new webhook endpoint.
+         *
+         * @param data - Webhook endpoint data
+         * @returns The created webhook endpoint with signing secret
+         */
+        create: async (data) => {
+            const { data: result, error } = await this.client.POST("/api/v1/webhooks", {
+                body: data,
+            });
+            if (error) {
+                throw this.handleError(error);
+            }
+            return result;
+        },
+        /**
+         * List all webhook endpoints.
+         *
+         * @param options - Query options
+         * @returns Paginated list of webhook endpoints
+         */
+        list: async (options) => {
+            const { data: result, error } = await this.client.GET("/api/v1/webhooks", {
+                params: { query: options },
+            });
+            if (error) {
+                throw this.handleError(error);
+            }
+            return result;
+        },
+        /**
+         * Get a webhook endpoint by ID.
+         *
+         * @param id - Webhook endpoint ID (UUID)
+         * @returns The webhook endpoint
+         */
+        get: async (id) => {
+            const { data: result, error } = await this.client.GET("/api/v1/webhooks/{endpoint_id}", {
+                params: { path: { endpoint_id: id } },
+            });
+            if (error) {
+                throw this.handleError(error);
+            }
+            return result;
+        },
+        /**
+         * Delete a webhook endpoint.
+         *
+         * @param id - Webhook endpoint ID (UUID)
+         */
+        delete: async (id) => {
+            const { error } = await this.client.DELETE("/api/v1/webhooks/{endpoint_id}", {
+                params: { path: { endpoint_id: id } },
+            });
+            if (error) {
+                throw this.handleError(error);
+            }
+        },
+        /**
+         * Test a webhook endpoint by sending a test event.
+         *
+         * @param id - Webhook endpoint ID (UUID)
+         * @param eventType - Event type to test (defaults to subscriber.created)
+         * @returns Test delivery result
+         */
+        test: async (id, eventType = "subscriber.created") => {
+            const { data: result, error } = await this.client.POST("/api/v1/webhooks/{endpoint_id}/test", {
+                params: { path: { endpoint_id: id } },
+                body: { event_type: eventType },
+            });
+            if (error) {
+                throw this.handleError(error);
+            }
+            return result;
+        },
+        /**
+         * Update a webhook endpoint.
+         *
+         * @param id - Webhook endpoint ID
+         * @param data - Fields to update
+         * @returns The updated endpoint
+         */
+        update: async (id, data) => {
+            const { data: result, error } = await this.client.PUT(
+            // @ts-expect-error - path not yet in OpenAPI spec for PUT method
+            "/api/v1/webhooks/{endpoint_id}", {
+                params: { path: { endpoint_id: id } },
+                body: data,
+            });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Regenerate the signing secret for a webhook endpoint.
+         *
+         * @param id - Webhook endpoint ID
+         * @returns The endpoint with new secret
+         */
+        regenerateSecret: async (id) => {
+            const { data: result, error } = await this.client.POST("/api/v1/webhooks/{endpoint_id}/regenerate-secret", { params: { path: { endpoint_id: id } } });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * List deliveries for a webhook endpoint.
+         *
+         * @param id - Webhook endpoint ID
+         * @param options - Filter options
+         * @returns Paginated list of deliveries
+         */
+        listDeliveries: async (id, options) => {
+            const { data: result, error } = await this.client.GET("/api/v1/webhooks/{endpoint_id}/deliveries", {
+                params: { path: { endpoint_id: id }, query: options },
+            });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Get a specific delivery with payload details.
+         *
+         * @param endpointId - Webhook endpoint ID
+         * @param deliveryId - Delivery ID
+         * @returns Detailed delivery record
+         */
+        getDelivery: async (endpointId, deliveryId) => {
+            const { data: result, error } = await this.client.GET("/api/v1/webhooks/{endpoint_id}/deliveries/{delivery_id}", {
+                params: {
+                    path: { endpoint_id: endpointId, delivery_id: deliveryId },
+                },
+            });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Retry a failed delivery.
+         *
+         * @param endpointId - Webhook endpoint ID
+         * @param deliveryId - Delivery ID
+         * @returns Retry result
+         */
+        retryDelivery: async (endpointId, deliveryId) => {
+            const { data: result, error } = await this.client.POST("/api/v1/webhooks/{endpoint_id}/deliveries/{delivery_id}/retry", {
+                params: {
+                    path: { endpoint_id: endpointId, delivery_id: deliveryId },
+                },
+            });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Get delivery statistics for a webhook endpoint.
+         *
+         * @param id - Webhook endpoint ID
+         * @param days - Number of days (default: 30)
+         * @returns Delivery statistics
+         */
+        getStats: async (id, days) => {
+            const { data: result, error } = await this.client.GET("/api/v1/webhooks/{endpoint_id}/stats", {
+                params: { path: { endpoint_id: id }, query: { days: days ?? 30 } },
+            });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * List deliveries across all webhook endpoints.
+         *
+         * @param options - Filter options
+         * @returns Paginated list of deliveries
+         */
+        listAllDeliveries: async (options) => {
+            const { data: result, error } = await this.client.GET("/api/v1/webhooks/deliveries/all", { params: { query: options } });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Get delivery statistics across all endpoints.
+         *
+         * @param days - Number of days (default: 30)
+         * @returns Global delivery statistics
+         */
+        getGlobalStats: async (days) => {
+            const { data: result, error } = await this.client.GET("/api/v1/webhooks/stats/all", { params: { query: { days: days ?? 30 } } });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * List all available webhook event types.
+         *
+         * @returns Event types with descriptions
+         */
+        listEventTypes: async () => {
+            const { data: result, error } = await this.client.GET("/api/v1/webhooks/event-types", {});
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+    };
+    /**
+     * Template management operations.
+     */
+    templates = {
+        /**
+         * Create a new email template.
+         *
+         * @param data - Template data
+         * @returns The created template
+         *
+         * @example
+         * ```typescript
+         * const template = await client.templates.create({
+         *   name: 'Welcome Email',
+         *   subject: 'Welcome to {{company}}!',
+         *   mjml_content: '<mjml>...</mjml>',
+         *   category: 'onboarding',
+         * });
+         * ```
+         */
+        create: async (data) => {
+            const { data: result, error } = await this.client.POST(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/templates", { body: data });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * List all templates with optional filtering.
+         *
+         * @param options - Query options
+         * @returns Paginated list of templates
+         *
+         * @example
+         * ```typescript
+         * const templates = await client.templates.list({ category: 'onboarding' });
+         * ```
+         */
+        list: async (options) => {
+            const { data: result, error } = await this.client.GET(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/templates", { params: { query: options } });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Get a template by slug.
+         *
+         * @param slug - Template slug
+         * @returns The template
+         *
+         * @example
+         * ```typescript
+         * const template = await client.templates.get('welcome-email');
+         * ```
+         */
+        get: async (slug) => {
+            const { data: result, error } = await this.client.GET(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/templates/{slug}", { params: { path: { slug } } });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Update a template.
+         *
+         * @param slug - Template slug
+         * @param data - Fields to update
+         * @returns The updated template
+         */
+        update: async (slug, data) => {
+            const { data: result, error } = await this.client.PUT(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/templates/{slug}", {
+                params: { path: { slug } },
+                body: data,
+            });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Delete a template.
+         *
+         * @param slug - Template slug
+         */
+        delete: async (slug) => {
+            const { error } = await this.client.DELETE(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/templates/{slug}", { params: { path: { slug } } });
+            if (error)
+                throw this.handleError(error);
+        },
+        /**
+         * Preview a rendered template with variables.
+         *
+         * @param slug - Template slug
+         * @param variables - Template variables to render
+         * @returns The rendered HTML preview
+         *
+         * @example
+         * ```typescript
+         * const preview = await client.templates.preview('welcome-email', {
+         *   company: 'Acme Inc',
+         *   name: 'John',
+         * });
+         * ```
+         */
+        preview: async (slug, variables) => {
+            const { data: result, error } = await this.client.POST(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/templates/{slug}/preview", {
+                params: { path: { slug } },
+                body: { variables: variables ?? {} },
+            });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+    };
+    /**
+     * Email sending operations.
+     */
+    emails = {
+        /**
+         * Send an email using a template.
+         *
+         * @param data - Email send data
+         * @returns The send result with message ID
+         *
+         * @example
+         * ```typescript
+         * const result = await client.emails.send({
+         *   template_slug: 'welcome-email',
+         *   to: 'user@example.com',
+         *   variables: { name: 'John', company: 'Acme Inc' },
+         *   idempotency_key: 'welcome-user-123',
+         * });
+         * ```
+         */
+        send: async (data) => {
+            const { data: result, error } = await this.client.POST(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/emails/send", { body: data });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+    };
+    /**
+     * Campaign management operations.
+     */
+    campaigns = {
+        /**
+         * Create a new campaign (draft status).
+         *
+         * @param data - Campaign data
+         * @returns The created campaign
+         */
+        create: async (data) => {
+            const { data: result, error } = await this.client.POST(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/campaigns", { body: data });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * List campaigns with optional filtering.
+         *
+         * @param options - Query options
+         * @returns Paginated list of campaigns
+         */
+        list: async (options) => {
+            const { data: result, error } = await this.client.GET(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/campaigns", { params: { query: options } });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Get a campaign by ID.
+         *
+         * @param id - Campaign UUID
+         * @returns The campaign with statistics
+         */
+        get: async (id) => {
+            const { data: result, error } = await this.client.GET(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/campaigns/{campaign_id}", { params: { path: { campaign_id: id } } });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Update a campaign (draft status only).
+         *
+         * @param id - Campaign UUID
+         * @param data - Fields to update
+         * @returns The updated campaign
+         */
+        update: async (id, data) => {
+            const { data: result, error } = await this.client.PUT(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/campaigns/{campaign_id}", {
+                params: { path: { campaign_id: id } },
+                body: data,
+            });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Trigger campaign sending.
+         *
+         * @param id - Campaign UUID
+         * @param batchSize - Emails per batch (1-500, default: 50)
+         * @returns Send response with recipient count
+         */
+        send: async (id, batchSize) => {
+            const { data: result, error } = await this.client.POST(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/campaigns/{campaign_id}/send", {
+                params: { path: { campaign_id: id } },
+                body: { batch_size: batchSize ?? 50 },
+            });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Cancel a sending campaign.
+         *
+         * @param id - Campaign UUID
+         * @returns The cancelled campaign
+         */
+        cancel: async (id) => {
+            const { data: result, error } = await this.client.POST(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/campaigns/{campaign_id}/cancel", { params: { path: { campaign_id: id } } });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Count recipients matching a tag filter.
+         *
+         * @param tagFilter - Tag filter criteria
+         * @returns Number of matching recipients
+         */
+        countRecipients: async (tagFilter) => {
+            const { data: result, error } = await this.client.POST(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/campaigns/count-recipients", { body: tagFilter });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+    };
+    /**
+     * Email trigger management operations.
+     */
+    triggers = {
+        /**
+         * Create a new email trigger.
+         *
+         * @param data - Trigger data
+         * @returns The created trigger
+         */
+        create: async (data) => {
+            const { data: result, error } = await this.client.POST(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/email-triggers", { body: data });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * List all email triggers.
+         *
+         * @returns List of triggers
+         */
+        list: async () => {
+            const { data: result, error } = await this.client.GET(
+            // @ts-expect-error - path not yet in OpenAPI spec
+            "/api/v1/email-triggers", {});
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Get a trigger by ID.
+         *
+         * @param id - Trigger UUID
+         * @returns The trigger
+         */
+        get: async (id) => {
+            const { data: result, error } = await this.client.GET(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/email-triggers/{trigger_id}", { params: { path: { trigger_id: id } } });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Update a trigger.
+         *
+         * @param id - Trigger UUID
+         * @param data - Fields to update
+         * @returns The updated trigger
+         */
+        update: async (id, data) => {
+            const { data: result, error } = await this.client.PUT(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/email-triggers/{trigger_id}", {
+                params: { path: { trigger_id: id } },
+                body: data,
+            });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Delete a trigger.
+         *
+         * @param id - Trigger UUID
+         */
+        delete: async (id) => {
+            const { error } = await this.client.DELETE(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/email-triggers/{trigger_id}", { params: { path: { trigger_id: id } } });
+            if (error)
+                throw this.handleError(error);
+        },
+    };
+    /**
+     * Subscriber note management operations.
+     */
+    notes = {
+        /**
+         * Create a note for a subscriber.
+         *
+         * @param subscriberId - Subscriber UUID
+         * @param data - Note data
+         * @returns The created note
+         *
+         * @example
+         * ```typescript
+         * const note = await client.notes.create('subscriber-uuid', {
+         *   content: 'Customer inquiry about pricing.',
+         *   source: 'contact_form',
+         *   subject: 'SubscribeFlow',
+         * });
+         * ```
+         */
+        create: async (subscriberId, data) => {
+            const { data: result, error } = await this.client.POST(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/subscribers/{subscriber_id}/notes", {
+                params: { path: { subscriber_id: subscriberId } },
+                body: data,
+            });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * List notes for a subscriber.
+         *
+         * @param subscriberId - Subscriber UUID
+         * @param options - Filter and pagination options
+         * @returns Paginated list of notes
+         */
+        list: async (subscriberId, options) => {
+            const { data: result, error } = await this.client.GET(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/subscribers/{subscriber_id}/notes", {
+                params: { path: { subscriber_id: subscriberId }, query: options },
+            });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Get a note by ID.
+         *
+         * @param subscriberId - Subscriber UUID
+         * @param noteId - Note UUID
+         * @returns The note
+         */
+        get: async (subscriberId, noteId) => {
+            const { data: result, error } = await this.client.GET(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/subscribers/{subscriber_id}/notes/{note_id}", {
+                params: {
+                    path: { subscriber_id: subscriberId, note_id: noteId },
+                },
+            });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Update a note.
+         *
+         * @param subscriberId - Subscriber UUID
+         * @param noteId - Note UUID
+         * @param data - Fields to update
+         * @returns The updated note
+         */
+        update: async (subscriberId, noteId, data) => {
+            const { data: result, error } = await this.client.PUT(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/subscribers/{subscriber_id}/notes/{note_id}", {
+                params: {
+                    path: { subscriber_id: subscriberId, note_id: noteId },
+                },
+                body: data,
+            });
+            if (error)
+                throw this.handleError(error);
+            return result;
+        },
+        /**
+         * Delete a note.
+         *
+         * @param subscriberId - Subscriber UUID
+         * @param noteId - Note UUID
+         */
+        delete: async (subscriberId, noteId) => {
+            const { error } = await this.client.DELETE(
+            // @ts-expect-error - path will be available after OpenAPI spec regeneration
+            "/api/v1/subscribers/{subscriber_id}/notes/{note_id}", {
+                params: {
+                    path: { subscriber_id: subscriberId, note_id: noteId },
+                },
+            });
+            if (error)
+                throw this.handleError(error);
+        },
+    };
+    /**
+     * Create a Preference Center client with JWT token auth.
+     *
+     * @param token - JWT token from subscribers.generateToken()
+     * @returns Object with preference center methods
+     */
+    preferenceCenter(token) {
+        const baseUrl = this.config.baseUrl;
+        const pcClient = createClient({
+            baseUrl,
+            headers: { "Content-Type": "application/json" },
+        });
+        const handleErr = this.handleError.bind(this);
+        return {
+            getPreferences: async () => {
+                const { data: result, error } = await pcClient.GET("/preference-center", { params: { query: { token } } });
+                if (error)
+                    throw handleErr(error);
+                return result;
+            },
+            subscribeTag: async (tagId) => {
+                const { data: result, error } = await pcClient.PUT("/preference-center/tags/{tag_id}", {
+                    params: { path: { tag_id: tagId }, query: { token } },
+                });
+                if (error)
+                    throw handleErr(error);
+                return result;
+            },
+            unsubscribeTag: async (tagId) => {
+                const { data: result, error } = await pcClient.DELETE("/preference-center/tags/{tag_id}", {
+                    params: { path: { tag_id: tagId }, query: { token } },
+                });
+                if (error)
+                    throw handleErr(error);
+                return result;
+            },
+            exportData: async () => {
+                const { data: result, error } = await pcClient.GET("/preference-center/data-export", { params: { query: { token } } });
+                if (error)
+                    throw handleErr(error);
+                return result;
+            },
+            deleteAccount: async () => {
+                const { data: result, error } = await pcClient.DELETE("/preference-center/account", { params: { query: { token } } });
+                if (error)
+                    throw handleErr(error);
+                return result;
+            },
+        };
+    }
+    /**
+     * Handle API errors and convert to SubscribeFlowError.
+     */
+    handleError(error) {
+        if (typeof error === "object" && error !== null) {
+            const err = error;
+            return new SubscribeFlowError(String(err.title || err.detail || "Unknown error"), Number(err.status || 500), String(err.type || "unknown"), String(err.detail || "An error occurred"), err.instance);
+        }
+        return new SubscribeFlowError("Unknown error", 500, "unknown", String(error));
+    }
+}
+//# sourceMappingURL=index.js.map