@rawdash/connector-klaviyo 0.0.1

package/README.md

@@ -0,0 +1,125 @@
+<!-- This file is generated from connector metadata by scripts/generate-connector-docs.ts. Do not edit by hand. -->
+
+# @rawdash/connector-klaviyo
+
+[![npm version](https://img.shields.io/npm/v/@rawdash/connector-klaviyo)](https://www.npmjs.com/package/@rawdash/connector-klaviyo)
+[![license](https://img.shields.io/npm/l/@rawdash/connector-klaviyo)](https://github.com/rawdash/rawdash/blob/main/LICENSE)
+
+Sync campaigns, flows, lists, and segments from Klaviyo for ecommerce email and SMS marketing analytics.
+
+## Install
+
+```sh
+npm install @rawdash/connector-klaviyo
+```
+
+## Authentication
+
+A Klaviyo Private API Key with read access to campaigns, flows, lists, and segments.
+
+1. Open Klaviyo -> Settings -> API Keys and create a new Private API Key.
+2. Grant read access to Campaigns, Flows, Lists, and Segments (or only the scopes you intend to sync).
+3. Copy the generated key and store it as a secret, referencing it from the connector config as `apiKey: secret("KLAVIYO_API_KEY")`.
+
+## Configuration
+
+| Field         | Type                              | Required | Description                                                                                                                                          |
+| ------------- | --------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `apiKey`      | secret                            | Yes      | Klaviyo Private API Key with read scopes for campaigns, flows, lists, and segments. Create one at Klaviyo -> Settings -> API Keys.                   |
+| `apiRevision` | string                            | No       | Value sent in the revision header. Defaults to 2024-10-15; pin a specific date here when upgrading deliberately.                                     |
+| `channel`     | `email` \| `sms` \| `mobile_push` | No       | Which campaign channel to sync. The Klaviyo campaigns endpoint requires a channel filter and only returns one channel per call; defaults to 'email'. |
+| `resources`   | array                             | No       | Which Klaviyo resources to sync. Omit to sync all of them. The key only needs read scopes for the resources listed here.                             |
+
+## Resources
+
+- **`klaviyo_list`** _(entity)_ - Klaviyo lists (manually managed subscriber collections) with opt-in process and created/updated timestamps.
+  - Endpoint: `GET /api/lists`
+  - `name`: List display name.
+  - `optInProcess`: Opt-in process (e.g. single_opt_in, double_opt_in).
+  - `createdAt`: When the list was created (Unix ms).
+- **`klaviyo_segment`** _(entity)_ - Klaviyo segments (rule-based dynamic groups) with active, starred, and processing flags.
+  - Endpoint: `GET /api/segments`
+  - `name`: Segment display name.
+  - `isActive`: Whether the segment is active.
+  - `isStarred`: Whether the segment is starred.
+  - `isProcessing`: Whether the segment is currently recomputing.
+  - `createdAt`: When the segment was created (Unix ms).
+- **`klaviyo_campaign`** _(entity)_ - Klaviyo campaigns for the configured channel, with status, archived flag, send strategy, and send time.
+  - Endpoint: `GET /api/campaigns`
+  - Klaviyo requires a channel filter on /campaigns; this connector syncs one channel per instance (the configured `channel` setting).
+  - `name`: Campaign name.
+  - `status`: Campaign status (Draft, Sent, etc.).
+  - `archived`: Whether the campaign is archived.
+  - `channel`: Campaign channel (email, sms, mobile_push).
+  - `sendStrategy`: Send strategy method (static, smart_send_time, etc.).
+  - `sendTime`: Scheduled or actual send time (Unix ms).
+  - `createdAt`: When the campaign was created (Unix ms).
+- **`klaviyo_flow`** _(entity)_ - Klaviyo flows (automation series) with status, trigger type, and archived flag.
+  - Endpoint: `GET /api/flows`
+  - `name`: Flow name.
+  - `status`: Flow status (live, draft, manual).
+  - `archived`: Whether the flow is archived.
+  - `triggerType`: Flow trigger type (e.g. list, segment, metric).
+  - `createdAt`: When the flow was created (Unix ms).
+
+## Example
+
+```ts
+import {
+  defineConfig,
+  defineDashboard,
+  defineMetric,
+  secret,
+} from '@rawdash/core';
+
+const klaviyo = {
+  name: 'klaviyo',
+  connectorId: 'klaviyo',
+  config: {
+    apiKey: secret('KLAVIYO_API_KEY'),
+    apiRevision: '2024-10-15',
+    channel: 'email',
+  },
+};
+
+export default defineConfig({
+  connectors: [klaviyo],
+  dashboards: {
+    marketing: defineDashboard({
+      widgets: {
+        active_segments: {
+          kind: 'stat',
+          title: 'Active segments',
+          metric: defineMetric({
+            connector: klaviyo,
+            shape: 'entity',
+            entityType: 'klaviyo_segment',
+            fn: 'count',
+            filter: [{ field: 'isActive', op: 'eq', value: true }],
+          }),
+        },
+      },
+    }),
+  },
+});
+```
+
+## Rate limits
+
+Klaviyo enforces per-endpoint burst and steady rate limits and signals them via the RateLimit-Remaining and RateLimit-Reset response headers. The shared HTTP client backs off on 429 and honors Retry-After.
+
+## Limitations
+
+- Campaign and flow statistics (campaign-values-reports / flow-values-reports) are not synced; the reports endpoints require a per-account conversion metric id and are deferred to a follow-up.
+- Profile, event, catalog, and coupon objects are out of scope (niche for dashboard use).
+- Only one campaign channel per sync (email, sms, or mobile_push) - the Klaviyo campaigns endpoint requires the filter and does not allow OR across channels.
+
+## Links
+
+- [Rawdash docs](https://rawdash.dev/docs/connectors/)
+- [Klaviyo API docs](https://developers.klaviyo.com/en/reference/api_overview)
+- [GitHub](https://github.com/rawdash/rawdash)
+
+## License
+
+Apache-2.0

package/dist/index.d.ts

@@ -0,0 +1,472 @@
+import { BaseConnector, ConnectorContext, SyncOptions, StorageHandle, SyncResult, ConnectorDoc } from '@rawdash/core';
+import { z } from 'zod';
+
+declare const configFields: z.ZodObject<{
+    apiKey: z.ZodObject<{
+        $secret: z.ZodString;
+    }, z.core.$strip>;
+    apiRevision: z.ZodDefault<z.ZodString>;
+    channel: z.ZodDefault<z.ZodEnum<{
+        email: "email";
+        sms: "sms";
+        mobile_push: "mobile_push";
+    }>>;
+    resources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        lists: "lists";
+        segments: "segments";
+        campaigns: "campaigns";
+        flows: "flows";
+    }>>>;
+}, z.core.$strip>;
+declare const doc: ConnectorDoc;
+type KlaviyoChannel = 'email' | 'sms' | 'mobile_push';
+interface KlaviyoSettings {
+    apiRevision: string;
+    channel: KlaviyoChannel;
+    resources?: readonly KlaviyoResource[];
+}
+declare const klaviyoCredentials: {
+    apiKey: {
+        description: string;
+        auth: "required";
+    };
+};
+type KlaviyoCredentials = typeof klaviyoCredentials;
+declare const PHASE_ORDER: readonly ["lists", "segments", "campaigns", "flows"];
+type KlaviyoPhase = (typeof PHASE_ORDER)[number];
+type KlaviyoResource = KlaviyoPhase;
+declare const klaviyoResources: {
+    readonly klaviyo_list: {
+        readonly shape: "entity";
+        readonly description: "Klaviyo lists (manually managed subscriber collections) with opt-in process and created/updated timestamps.";
+        readonly endpoint: "GET /api/lists";
+        readonly fields: [{
+            readonly name: "name";
+            readonly description: "List display name.";
+        }, {
+            readonly name: "optInProcess";
+            readonly description: "Opt-in process (e.g. single_opt_in, double_opt_in).";
+        }, {
+            readonly name: "createdAt";
+            readonly description: "When the list was created (Unix ms).";
+        }];
+        readonly responses: {
+            readonly lists: z.ZodObject<{
+                data: z.ZodArray<z.ZodObject<{
+                    type: z.ZodString;
+                    id: z.ZodString;
+                    attributes: z.ZodObject<{
+                        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        updated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        opt_in_process: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$strip>;
+                }, z.core.$strip>>;
+                links: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>;
+        };
+    };
+    readonly klaviyo_segment: {
+        readonly shape: "entity";
+        readonly description: "Klaviyo segments (rule-based dynamic groups) with active, starred, and processing flags.";
+        readonly endpoint: "GET /api/segments";
+        readonly fields: [{
+            readonly name: "name";
+            readonly description: "Segment display name.";
+        }, {
+            readonly name: "isActive";
+            readonly description: "Whether the segment is active.";
+        }, {
+            readonly name: "isStarred";
+            readonly description: "Whether the segment is starred.";
+        }, {
+            readonly name: "isProcessing";
+            readonly description: "Whether the segment is currently recomputing.";
+        }, {
+            readonly name: "createdAt";
+            readonly description: "When the segment was created (Unix ms).";
+        }];
+        readonly responses: {
+            readonly segments: z.ZodObject<{
+                data: z.ZodArray<z.ZodObject<{
+                    type: z.ZodString;
+                    id: z.ZodString;
+                    attributes: z.ZodObject<{
+                        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        updated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        is_active: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                        is_starred: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                        is_processing: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                    }, z.core.$strip>;
+                }, z.core.$strip>>;
+                links: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>;
+        };
+    };
+    readonly klaviyo_campaign: {
+        readonly shape: "entity";
+        readonly description: "Klaviyo campaigns for the configured channel, with status, archived flag, send strategy, and send time.";
+        readonly endpoint: "GET /api/campaigns";
+        readonly notes: "Klaviyo requires a channel filter on /campaigns; this connector syncs one channel per instance (the configured `channel` setting).";
+        readonly fields: [{
+            readonly name: "name";
+            readonly description: "Campaign name.";
+        }, {
+            readonly name: "status";
+            readonly description: "Campaign status (Draft, Sent, etc.).";
+        }, {
+            readonly name: "archived";
+            readonly description: "Whether the campaign is archived.";
+        }, {
+            readonly name: "channel";
+            readonly description: "Campaign channel (email, sms, mobile_push).";
+        }, {
+            readonly name: "sendStrategy";
+            readonly description: "Send strategy method (static, smart_send_time, etc.).";
+        }, {
+            readonly name: "sendTime";
+            readonly description: "Scheduled or actual send time (Unix ms).";
+        }, {
+            readonly name: "createdAt";
+            readonly description: "When the campaign was created (Unix ms).";
+        }];
+        readonly responses: {
+            readonly campaigns: z.ZodObject<{
+                data: z.ZodArray<z.ZodObject<{
+                    type: z.ZodString;
+                    id: z.ZodString;
+                    attributes: z.ZodObject<{
+                        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        archived: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                        channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        send_time: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        scheduled_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        send_strategy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                            method: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        }, z.core.$strip>>>;
+                        created_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        updated_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$strip>;
+                }, z.core.$strip>>;
+                links: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>;
+        };
+    };
+    readonly klaviyo_flow: {
+        readonly shape: "entity";
+        readonly description: "Klaviyo flows (automation series) with status, trigger type, and archived flag.";
+        readonly endpoint: "GET /api/flows";
+        readonly fields: [{
+            readonly name: "name";
+            readonly description: "Flow name.";
+        }, {
+            readonly name: "status";
+            readonly description: "Flow status (live, draft, manual).";
+        }, {
+            readonly name: "archived";
+            readonly description: "Whether the flow is archived.";
+        }, {
+            readonly name: "triggerType";
+            readonly description: "Flow trigger type (e.g. list, segment, metric).";
+        }, {
+            readonly name: "createdAt";
+            readonly description: "When the flow was created (Unix ms).";
+        }];
+        readonly responses: {
+            readonly flows: z.ZodObject<{
+                data: z.ZodArray<z.ZodObject<{
+                    type: z.ZodString;
+                    id: z.ZodString;
+                    attributes: z.ZodObject<{
+                        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        archived: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                        trigger_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        updated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$strip>;
+                }, z.core.$strip>>;
+                links: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>;
+        };
+    };
+};
+declare const id = "klaviyo";
+declare class KlaviyoConnector extends BaseConnector<KlaviyoSettings, KlaviyoCredentials> {
+    static readonly id = "klaviyo";
+    static readonly resources: {
+        readonly klaviyo_list: {
+            readonly shape: "entity";
+            readonly description: "Klaviyo lists (manually managed subscriber collections) with opt-in process and created/updated timestamps.";
+            readonly endpoint: "GET /api/lists";
+            readonly fields: [{
+                readonly name: "name";
+                readonly description: "List display name.";
+            }, {
+                readonly name: "optInProcess";
+                readonly description: "Opt-in process (e.g. single_opt_in, double_opt_in).";
+            }, {
+                readonly name: "createdAt";
+                readonly description: "When the list was created (Unix ms).";
+            }];
+            readonly responses: {
+                readonly lists: z.ZodObject<{
+                    data: z.ZodArray<z.ZodObject<{
+                        type: z.ZodString;
+                        id: z.ZodString;
+                        attributes: z.ZodObject<{
+                            name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            updated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            opt_in_process: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>>;
+                    links: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                        next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            };
+        };
+        readonly klaviyo_segment: {
+            readonly shape: "entity";
+            readonly description: "Klaviyo segments (rule-based dynamic groups) with active, starred, and processing flags.";
+            readonly endpoint: "GET /api/segments";
+            readonly fields: [{
+                readonly name: "name";
+                readonly description: "Segment display name.";
+            }, {
+                readonly name: "isActive";
+                readonly description: "Whether the segment is active.";
+            }, {
+                readonly name: "isStarred";
+                readonly description: "Whether the segment is starred.";
+            }, {
+                readonly name: "isProcessing";
+                readonly description: "Whether the segment is currently recomputing.";
+            }, {
+                readonly name: "createdAt";
+                readonly description: "When the segment was created (Unix ms).";
+            }];
+            readonly responses: {
+                readonly segments: z.ZodObject<{
+                    data: z.ZodArray<z.ZodObject<{
+                        type: z.ZodString;
+                        id: z.ZodString;
+                        attributes: z.ZodObject<{
+                            name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            updated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            is_active: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                            is_starred: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                            is_processing: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>>;
+                    links: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                        next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            };
+        };
+        readonly klaviyo_campaign: {
+            readonly shape: "entity";
+            readonly description: "Klaviyo campaigns for the configured channel, with status, archived flag, send strategy, and send time.";
+            readonly endpoint: "GET /api/campaigns";
+            readonly notes: "Klaviyo requires a channel filter on /campaigns; this connector syncs one channel per instance (the configured `channel` setting).";
+            readonly fields: [{
+                readonly name: "name";
+                readonly description: "Campaign name.";
+            }, {
+                readonly name: "status";
+                readonly description: "Campaign status (Draft, Sent, etc.).";
+            }, {
+                readonly name: "archived";
+                readonly description: "Whether the campaign is archived.";
+            }, {
+                readonly name: "channel";
+                readonly description: "Campaign channel (email, sms, mobile_push).";
+            }, {
+                readonly name: "sendStrategy";
+                readonly description: "Send strategy method (static, smart_send_time, etc.).";
+            }, {
+                readonly name: "sendTime";
+                readonly description: "Scheduled or actual send time (Unix ms).";
+            }, {
+                readonly name: "createdAt";
+                readonly description: "When the campaign was created (Unix ms).";
+            }];
+            readonly responses: {
+                readonly campaigns: z.ZodObject<{
+                    data: z.ZodArray<z.ZodObject<{
+                        type: z.ZodString;
+                        id: z.ZodString;
+                        attributes: z.ZodObject<{
+                            name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            archived: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                            channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            send_time: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            scheduled_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            send_strategy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                                method: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            }, z.core.$strip>>>;
+                            created_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            updated_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>>;
+                    links: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                        next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            };
+        };
+        readonly klaviyo_flow: {
+            readonly shape: "entity";
+            readonly description: "Klaviyo flows (automation series) with status, trigger type, and archived flag.";
+            readonly endpoint: "GET /api/flows";
+            readonly fields: [{
+                readonly name: "name";
+                readonly description: "Flow name.";
+            }, {
+                readonly name: "status";
+                readonly description: "Flow status (live, draft, manual).";
+            }, {
+                readonly name: "archived";
+                readonly description: "Whether the flow is archived.";
+            }, {
+                readonly name: "triggerType";
+                readonly description: "Flow trigger type (e.g. list, segment, metric).";
+            }, {
+                readonly name: "createdAt";
+                readonly description: "When the flow was created (Unix ms).";
+            }];
+            readonly responses: {
+                readonly flows: z.ZodObject<{
+                    data: z.ZodArray<z.ZodObject<{
+                        type: z.ZodString;
+                        id: z.ZodString;
+                        attributes: z.ZodObject<{
+                            name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            archived: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                            trigger_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            updated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>>;
+                    links: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                        next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            };
+        };
+    };
+    static readonly schemas: {
+        readonly lists: z.ZodObject<{
+            data: z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                id: z.ZodString;
+                attributes: z.ZodObject<{
+                    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    updated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    opt_in_process: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            links: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+    } & {
+        readonly segments: z.ZodObject<{
+            data: z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                id: z.ZodString;
+                attributes: z.ZodObject<{
+                    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    updated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    is_active: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                    is_starred: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                    is_processing: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            links: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+    } & {
+        readonly campaigns: z.ZodObject<{
+            data: z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                id: z.ZodString;
+                attributes: z.ZodObject<{
+                    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    archived: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                    channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    send_time: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    scheduled_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    send_strategy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                        method: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$strip>>>;
+                    created_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    updated_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            links: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+    } & {
+        readonly flows: z.ZodObject<{
+            data: z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                id: z.ZodString;
+                attributes: z.ZodObject<{
+                    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    archived: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                    trigger_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    updated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            links: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+    } & Readonly<Record<string, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+    static create(input: unknown, ctx?: ConnectorContext): KlaviyoConnector;
+    readonly id = "klaviyo";
+    readonly credentials: {
+        apiKey: {
+            description: string;
+            auth: "required";
+        };
+    };
+    private buildHeaders;
+    private apiGet;
+    private allowedPagePath;
+    private sanitizePageUrl;
+    private resolveCursor;
+    private buildInitialUrl;
+    private fetchPhasePage;
+    private writeLists;
+    private writeSegments;
+    private writeCampaigns;
+    private writeFlows;
+    private writePhase;
+    sync(options: SyncOptions, storage: StorageHandle, signal?: AbortSignal): Promise<SyncResult>;
+}
+
+export { type KlaviyoChannel, KlaviyoConnector, type KlaviyoResource, type KlaviyoSettings, configFields, KlaviyoConnector as default, doc, id, klaviyoResources as resources };

package/dist/index.js

@@ -0,0 +1,511 @@
+// ../../connector-shared/dist/index.js
+var HTTP_CLIENT_VERSION = "0.0.0";
+var DEFAULT_USER_AGENT = `rawdash-connector/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;
+function connectorUserAgent(connectorId) {
+  return `rawdash-connector-${connectorId}/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;
+}
+function sanitizeAllowedUrl(options) {
+  const { url, host, pathname, protocol = "https:" } = options;
+  if (url === null) {
+    return null;
+  }
+  try {
+    const u = new URL(url);
+    if (u.protocol !== protocol || u.host !== host || u.pathname !== pathname) {
+      return null;
+    }
+    return u.toString();
+  } catch {
+    return null;
+  }
+}
+function parseEpoch(value, unit) {
+  if (value === null || value === void 0) {
+    return null;
+  }
+  if (unit === "iso") {
+    if (typeof value !== "string") {
+      return null;
+    }
+    const ms = new Date(value).getTime();
+    return Number.isFinite(ms) ? ms : null;
+  }
+  if (typeof value === "string" && value.trim() === "") {
+    return null;
+  }
+  const n = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(n)) {
+    return null;
+  }
+  const result = unit === "s" ? n * 1e3 : n;
+  return Number.isFinite(result) ? result : null;
+}
+
+// src/klaviyo.ts
+import {
+  BaseConnector,
+  defineConfigFields,
+  defineConnectorDoc,
+  defineResources,
+  makeChunkedCursorGuard,
+  paginateChunked,
+  schemasFromResources,
+  selectActivePhases
+} from "@rawdash/core";
+import { z } from "zod";
+var configFields = defineConfigFields(
+  z.object({
+    apiKey: z.object({ $secret: z.string() }).meta({
+      label: "Private API Key",
+      description: "Klaviyo Private API Key with read scopes for campaigns, flows, lists, and segments. Create one at Klaviyo -> Settings -> API Keys.",
+      placeholder: "pk_...",
+      secret: true
+    }),
+    apiRevision: z.string().trim().regex(
+      /^\d{4}-\d{2}-\d{2}(\.pre)?$/,
+      'Use a Klaviyo API revision date like "2024-10-15".'
+    ).default("2024-10-15").meta({
+      label: "API revision",
+      description: "Value sent in the revision header. Defaults to 2024-10-15; pin a specific date here when upgrading deliberately.",
+      placeholder: "2024-10-15"
+    }),
+    channel: z.enum(["email", "sms", "mobile_push"]).default("email").meta({
+      label: "Campaign channel",
+      description: "Which campaign channel to sync. The Klaviyo campaigns endpoint requires a channel filter and only returns one channel per call; defaults to 'email'.",
+      placeholder: "email"
+    }),
+    resources: z.array(z.enum(["lists", "segments", "campaigns", "flows"])).nonempty().optional().meta({
+      label: "Resources",
+      description: "Which Klaviyo resources to sync. Omit to sync all of them. The key only needs read scopes for the resources listed here."
+    })
+  })
+);
+var doc = defineConnectorDoc({
+  displayName: "Klaviyo",
+  category: "marketing",
+  brandColor: "#000000",
+  tagline: "Sync campaigns, flows, lists, and segments from Klaviyo for ecommerce email and SMS marketing analytics.",
+  vendor: {
+    name: "Klaviyo",
+    apiDocs: "https://developers.klaviyo.com/en/reference/api_overview",
+    website: "https://www.klaviyo.com"
+  },
+  auth: {
+    summary: "A Klaviyo Private API Key with read access to campaigns, flows, lists, and segments.",
+    setup: [
+      "Open Klaviyo -> Settings -> API Keys and create a new Private API Key.",
+      "Grant read access to Campaigns, Flows, Lists, and Segments (or only the scopes you intend to sync).",
+      'Copy the generated key and store it as a secret, referencing it from the connector config as `apiKey: secret("KLAVIYO_API_KEY")`.'
+    ]
+  },
+  rateLimit: "Klaviyo enforces per-endpoint burst and steady rate limits and signals them via the RateLimit-Remaining and RateLimit-Reset response headers. The shared HTTP client backs off on 429 and honors Retry-After.",
+  limitations: [
+    "Campaign and flow statistics (campaign-values-reports / flow-values-reports) are not synced; the reports endpoints require a per-account conversion metric id and are deferred to a follow-up.",
+    "Profile, event, catalog, and coupon objects are out of scope (niche for dashboard use).",
+    "Only one campaign channel per sync (email, sms, or mobile_push) - the Klaviyo campaigns endpoint requires the filter and does not allow OR across channels."
+  ]
+});
+var klaviyoCredentials = {
+  apiKey: {
+    description: "Klaviyo Private API Key",
+    auth: "required"
+  }
+};
+var PHASE_ORDER = ["lists", "segments", "campaigns", "flows"];
+var isKlaviyoSyncCursor = makeChunkedCursorGuard(PHASE_ORDER);
+var KLAVIYO_API_HOST = "a.klaviyo.com";
+var KLAVIYO_API_BASE = `https://${KLAVIYO_API_HOST}/api`;
+var PAGE_SIZE = 100;
+var LIST_ENTITY = "klaviyo_list";
+var SEGMENT_ENTITY = "klaviyo_segment";
+var CAMPAIGN_ENTITY = "klaviyo_campaign";
+var FLOW_ENTITY = "klaviyo_flow";
+var ENTITY_TYPE_BY_PHASE = {
+  lists: LIST_ENTITY,
+  segments: SEGMENT_ENTITY,
+  campaigns: CAMPAIGN_ENTITY,
+  flows: FLOW_ENTITY
+};
+var UPDATED_FIELD_BY_PHASE = {
+  lists: "updated",
+  segments: "updated",
+  campaigns: "updated_at",
+  flows: "updated"
+};
+var idString = z.string().min(1);
+function jsonApiList(attributes) {
+  return z.object({
+    data: z.array(
+      z.object({
+        type: z.string(),
+        id: idString,
+        attributes
+      })
+    ),
+    links: z.object({ next: z.string().nullish() }).nullish()
+  });
+}
+var listsResponseSchema = jsonApiList(
+  z.object({
+    name: z.string().nullish(),
+    created: z.string().nullish(),
+    updated: z.string().nullish(),
+    opt_in_process: z.string().nullish()
+  })
+);
+var segmentsResponseSchema = jsonApiList(
+  z.object({
+    name: z.string().nullish(),
+    created: z.string().nullish(),
+    updated: z.string().nullish(),
+    is_active: z.boolean().nullish(),
+    is_starred: z.boolean().nullish(),
+    is_processing: z.boolean().nullish()
+  })
+);
+var campaignsResponseSchema = jsonApiList(
+  z.object({
+    name: z.string().nullish(),
+    status: z.string().nullish(),
+    archived: z.boolean().nullish(),
+    channel: z.string().nullish(),
+    send_time: z.string().nullish(),
+    scheduled_at: z.string().nullish(),
+    send_strategy: z.object({ method: z.string().nullish() }).nullish(),
+    created_at: z.string().nullish(),
+    updated_at: z.string().nullish()
+  })
+);
+var flowsResponseSchema = jsonApiList(
+  z.object({
+    name: z.string().nullish(),
+    status: z.string().nullish(),
+    archived: z.boolean().nullish(),
+    trigger_type: z.string().nullish(),
+    created: z.string().nullish(),
+    updated: z.string().nullish()
+  })
+);
+var klaviyoResources = defineResources({
+  [LIST_ENTITY]: {
+    shape: "entity",
+    description: "Klaviyo lists (manually managed subscriber collections) with opt-in process and created/updated timestamps.",
+    endpoint: "GET /api/lists",
+    fields: [
+      { name: "name", description: "List display name." },
+      {
+        name: "optInProcess",
+        description: "Opt-in process (e.g. single_opt_in, double_opt_in)."
+      },
+      {
+        name: "createdAt",
+        description: "When the list was created (Unix ms)."
+      }
+    ],
+    responses: { lists: listsResponseSchema }
+  },
+  [SEGMENT_ENTITY]: {
+    shape: "entity",
+    description: "Klaviyo segments (rule-based dynamic groups) with active, starred, and processing flags.",
+    endpoint: "GET /api/segments",
+    fields: [
+      { name: "name", description: "Segment display name." },
+      { name: "isActive", description: "Whether the segment is active." },
+      { name: "isStarred", description: "Whether the segment is starred." },
+      {
+        name: "isProcessing",
+        description: "Whether the segment is currently recomputing."
+      },
+      {
+        name: "createdAt",
+        description: "When the segment was created (Unix ms)."
+      }
+    ],
+    responses: { segments: segmentsResponseSchema }
+  },
+  [CAMPAIGN_ENTITY]: {
+    shape: "entity",
+    description: "Klaviyo campaigns for the configured channel, with status, archived flag, send strategy, and send time.",
+    endpoint: "GET /api/campaigns",
+    notes: "Klaviyo requires a channel filter on /campaigns; this connector syncs one channel per instance (the configured `channel` setting).",
+    fields: [
+      { name: "name", description: "Campaign name." },
+      { name: "status", description: "Campaign status (Draft, Sent, etc.)." },
+      { name: "archived", description: "Whether the campaign is archived." },
+      {
+        name: "channel",
+        description: "Campaign channel (email, sms, mobile_push)."
+      },
+      {
+        name: "sendStrategy",
+        description: "Send strategy method (static, smart_send_time, etc.)."
+      },
+      {
+        name: "sendTime",
+        description: "Scheduled or actual send time (Unix ms)."
+      },
+      {
+        name: "createdAt",
+        description: "When the campaign was created (Unix ms)."
+      }
+    ],
+    responses: { campaigns: campaignsResponseSchema }
+  },
+  [FLOW_ENTITY]: {
+    shape: "entity",
+    description: "Klaviyo flows (automation series) with status, trigger type, and archived flag.",
+    endpoint: "GET /api/flows",
+    fields: [
+      { name: "name", description: "Flow name." },
+      { name: "status", description: "Flow status (live, draft, manual)." },
+      { name: "archived", description: "Whether the flow is archived." },
+      {
+        name: "triggerType",
+        description: "Flow trigger type (e.g. list, segment, metric)."
+      },
+      {
+        name: "createdAt",
+        description: "When the flow was created (Unix ms)."
+      }
+    ],
+    responses: { flows: flowsResponseSchema }
+  }
+});
+var id = "klaviyo";
+var KlaviyoConnector = class _KlaviyoConnector extends BaseConnector {
+  static id = id;
+  static resources = klaviyoResources;
+  static schemas = schemasFromResources(klaviyoResources);
+  static create(input, ctx) {
+    const parsed = configFields.parse(input);
+    return new _KlaviyoConnector(
+      {
+        apiRevision: parsed.apiRevision,
+        channel: parsed.channel,
+        resources: parsed.resources
+      },
+      { apiKey: parsed.apiKey },
+      ctx
+    );
+  }
+  id = id;
+  credentials = klaviyoCredentials;
+  buildHeaders() {
+    return {
+      Authorization: `Klaviyo-API-Key ${this.creds.apiKey}`,
+      revision: this.settings.apiRevision,
+      Accept: "application/vnd.api+json",
+      "User-Agent": connectorUserAgent("klaviyo")
+    };
+  }
+  apiGet(url, resource, signal) {
+    return this.get(url, {
+      resource,
+      headers: this.buildHeaders(),
+      signal
+    });
+  }
+  // -------------------------------------------------------------------------
+  // URL building + sanitization
+  // -------------------------------------------------------------------------
+  allowedPagePath(phase) {
+    switch (phase) {
+      case "lists":
+        return "/api/lists";
+      case "segments":
+        return "/api/segments";
+      case "campaigns":
+        return "/api/campaigns";
+      case "flows":
+        return "/api/flows";
+    }
+  }
+  sanitizePageUrl(phase, pageUrl) {
+    return sanitizeAllowedUrl({
+      url: pageUrl,
+      host: KLAVIYO_API_HOST,
+      pathname: this.allowedPagePath(phase)
+    });
+  }
+  resolveCursor(cursor) {
+    if (!isKlaviyoSyncCursor(cursor)) {
+      return void 0;
+    }
+    return {
+      phase: cursor.phase,
+      page: this.sanitizePageUrl(cursor.phase, cursor.page)
+    };
+  }
+  buildInitialUrl(phase, options) {
+    const u = new URL(`${KLAVIYO_API_BASE}${this.allowedPagePath(phase)}`);
+    u.searchParams.set("page[size]", String(PAGE_SIZE));
+    u.searchParams.set("sort", UPDATED_FIELD_BY_PHASE[phase]);
+    const filters = [];
+    if (phase === "campaigns") {
+      filters.push(`equals(messages.channel,'${this.settings.channel}')`);
+    }
+    if (options.since) {
+      const date = new Date(options.since);
+      if (Number.isFinite(date.getTime())) {
+        filters.push(
+          `greater-than(${UPDATED_FIELD_BY_PHASE[phase]},${date.toISOString()})`
+        );
+      }
+    }
+    if (filters.length > 0) {
+      u.searchParams.set("filter", filters.join(","));
+    }
+    return u.toString();
+  }
+  // -------------------------------------------------------------------------
+  // Fetchers
+  // -------------------------------------------------------------------------
+  async fetchPhasePage(phase, page, options, signal) {
+    const url = page ?? this.buildInitialUrl(phase, options);
+    const res = await this.apiGet(url, phase, signal);
+    const nextRaw = res.body.links?.next ?? null;
+    const next = nextRaw ? this.sanitizePageUrl(phase, nextRaw) : null;
+    return { items: res.body.data ?? [], next };
+  }
+  // -------------------------------------------------------------------------
+  // Writers
+  // -------------------------------------------------------------------------
+  async writeLists(storage, items) {
+    for (const item of items) {
+      const attrs = item.attributes ?? {};
+      const createdMs = parseEpoch(attrs.created ?? null, "iso");
+      const updatedMs = parseEpoch(attrs.updated ?? null, "iso");
+      await storage.entity({
+        type: LIST_ENTITY,
+        id: item.id,
+        attributes: {
+          name: attrs.name ?? null,
+          optInProcess: attrs.opt_in_process ?? null,
+          createdAt: createdMs
+        },
+        updated_at: updatedMs ?? createdMs ?? 0
+      });
+    }
+  }
+  async writeSegments(storage, items) {
+    for (const item of items) {
+      const attrs = item.attributes ?? {};
+      const createdMs = parseEpoch(attrs.created ?? null, "iso");
+      const updatedMs = parseEpoch(attrs.updated ?? null, "iso");
+      await storage.entity({
+        type: SEGMENT_ENTITY,
+        id: item.id,
+        attributes: {
+          name: attrs.name ?? null,
+          isActive: attrs.is_active ?? null,
+          isStarred: attrs.is_starred ?? null,
+          isProcessing: attrs.is_processing ?? null,
+          createdAt: createdMs
+        },
+        updated_at: updatedMs ?? createdMs ?? 0
+      });
+    }
+  }
+  async writeCampaigns(storage, items) {
+    for (const item of items) {
+      const attrs = item.attributes ?? {};
+      const createdMs = parseEpoch(attrs.created_at ?? null, "iso");
+      const updatedMs = parseEpoch(attrs.updated_at ?? null, "iso");
+      const sendTimeMs = parseEpoch(
+        attrs.send_time ?? attrs.scheduled_at ?? null,
+        "iso"
+      );
+      await storage.entity({
+        type: CAMPAIGN_ENTITY,
+        id: item.id,
+        attributes: {
+          name: attrs.name ?? null,
+          status: attrs.status ?? null,
+          archived: attrs.archived ?? null,
+          channel: attrs.channel ?? this.settings.channel,
+          sendStrategy: attrs.send_strategy?.method ?? null,
+          sendTime: sendTimeMs,
+          createdAt: createdMs
+        },
+        updated_at: updatedMs ?? createdMs ?? 0
+      });
+    }
+  }
+  async writeFlows(storage, items) {
+    for (const item of items) {
+      const attrs = item.attributes ?? {};
+      const createdMs = parseEpoch(attrs.created ?? null, "iso");
+      const updatedMs = parseEpoch(attrs.updated ?? null, "iso");
+      await storage.entity({
+        type: FLOW_ENTITY,
+        id: item.id,
+        attributes: {
+          name: attrs.name ?? null,
+          status: attrs.status ?? null,
+          archived: attrs.archived ?? null,
+          triggerType: attrs.trigger_type ?? null,
+          createdAt: createdMs
+        },
+        updated_at: updatedMs ?? createdMs ?? 0
+      });
+    }
+  }
+  async writePhase(storage, phase, items) {
+    switch (phase) {
+      case "lists":
+        return this.writeLists(
+          storage,
+          items
+        );
+      case "segments":
+        return this.writeSegments(
+          storage,
+          items
+        );
+      case "campaigns":
+        return this.writeCampaigns(
+          storage,
+          items
+        );
+      case "flows":
+        return this.writeFlows(
+          storage,
+          items
+        );
+    }
+  }
+  async sync(options, storage, signal) {
+    const cursor = this.resolveCursor(options.cursor);
+    const isFull = options.mode === "full";
+    const phases = selectActivePhases(
+      (r) => r,
+      PHASE_ORDER,
+      this.settings.resources
+    );
+    return paginateChunked({
+      phases,
+      cursor,
+      signal,
+      logger: this.logger,
+      fetchPage: async (phase, page, sig) => this.fetchPhasePage(phase, page, options, sig),
+      writeBatch: async (phase, items, page) => {
+        if (isFull && page === null) {
+          await storage.entities([], { types: [ENTITY_TYPE_BY_PHASE[phase]] });
+        }
+        await this.writePhase(storage, phase, items);
+      }
+    });
+  }
+};
+
+// src/index.ts
+var index_default = KlaviyoConnector;
+export {
+  KlaviyoConnector,
+  configFields,
+  index_default as default,
+  doc,
+  id,
+  klaviyoResources as resources
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../connector-shared/src/errors.ts","../../../connector-shared/src/retry.ts","../../../connector-shared/src/version.ts","../../../connector-shared/src/request.ts","../../../connector-shared/src/rate-limit.ts","../../../connector-shared/src/sanitize.ts","../../../connector-shared/src/epoch.ts","../../../connector-shared/src/pagination.ts","../../../connector-shared/src/logger.ts","../src/klaviyo.ts","../src/index.ts"],"sourcesContent":["import type { HttpResponse } from './types';\n\nexport type HttpErrorKind =\n  | 'transient'\n  | 'rate_limit'\n  | 'auth'\n  | 'upstream_bug'\n  | 'client_bug';\n\nexport abstract class HttpClientError extends Error {\n  abstract readonly kind: HttpErrorKind;\n  readonly response?: HttpResponse;\n\n  constructor(message: string, response?: HttpResponse) {\n    super(message);\n    this.name = new.target.name;\n    this.response = response;\n  }\n}\n\nexport class TransientError extends HttpClientError {\n  readonly kind = 'transient' as const;\n}\n\nexport class RateLimitError extends HttpClientError {\n  readonly kind = 'rate_limit' as const;\n  readonly retryAfter?: Date;\n\n  constructor(message: string, response?: HttpResponse, retryAfter?: Date) {\n    super(message, response);\n    this.retryAfter = retryAfter;\n  }\n}\n\nexport class AuthError extends HttpClientError {\n  readonly kind = 'auth' as const;\n}\n\nexport class UpstreamBugError extends HttpClientError {\n  readonly kind = 'upstream_bug' as const;\n}\n\nexport class ClientBugError extends HttpClientError {\n  readonly kind = 'client_bug' as const;\n}\n\nexport function classifyStatus(status: number): HttpErrorKind {\n  if (status === 429) {\n    return 'rate_limit';\n  }\n  if (status === 401 || status === 403) {\n    return 'auth';\n  }\n  if (status === 408) {\n    return 'transient';\n  }\n  if (status >= 500) {\n    return 'upstream_bug';\n  }\n  if (status >= 400) {\n    return 'client_bug';\n  }\n  return 'client_bug';\n}\n\nexport function errorForStatus(\n  message: string,\n  response: HttpResponse,\n  retryAfter?: Date,\n): HttpClientError {\n  const kind = classifyStatus(response.status);\n  switch (kind) {\n    case 'rate_limit':\n      return new RateLimitError(message, response, retryAfter);\n    case 'auth':\n      return new AuthError(message, response);\n    case 'transient':\n      return new TransientError(message, response);\n    case 'upstream_bug':\n      return new UpstreamBugError(message, response);\n    case 'client_bug':\n      return new ClientBugError(message, response);\n  }\n}\n","import { HttpClientError, RateLimitError, TransientError } from './errors';\n\nexport interface RetryPolicy {\n  maxAttempts?: number;\n  initialDelayMs?: number;\n  maxDelayMs?: number;\n  retryOn?: (status: number | null, err?: Error) => boolean;\n}\n\nexport const defaultRetryOn = (status: number | null, err?: Error): boolean => {\n  if (err instanceof RateLimitError) {\n    return true;\n  }\n  if (err instanceof TransientError) {\n    return true;\n  }\n  if (status === null) {\n    return err instanceof Error && !(err instanceof HttpClientError);\n  }\n  if (status === 408 || status === 429) {\n    return true;\n  }\n  if (status >= 500) {\n    return true;\n  }\n  return false;\n};\n\nexport function backoffDelayMs(\n  attempt: number,\n  policy: Required<Pick<RetryPolicy, 'initialDelayMs' | 'maxDelayMs'>>,\n): number {\n  const base = policy.initialDelayMs * 2 ** attempt;\n  const jitter = base * 0.25 * Math.random();\n  return Math.min(base + jitter, policy.maxDelayMs);\n}\n\nexport function parseRetryAfter(\n  headerValue: string | null,\n  now: Date = new Date(),\n): Date | undefined {\n  if (!headerValue) {\n    return undefined;\n  }\n  const trimmed = headerValue.trim();\n  if (/^\\d+$/.test(trimmed)) {\n    return new Date(now.getTime() + Number(trimmed) * 1000);\n  }\n  const parsed = Date.parse(trimmed);\n  if (Number.isNaN(parsed)) {\n    return undefined;\n  }\n  return new Date(parsed);\n}\n\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  if (signal?.aborted) {\n    return Promise.reject(signal.reason ?? new Error('Aborted'));\n  }\n  return new Promise<void>((resolve, reject) => {\n    const onAbort = () => {\n      clearTimeout(timer);\n      reject(signal!.reason ?? new Error('Aborted'));\n    };\n    const timer = setTimeout(() => {\n      signal?.removeEventListener('abort', onAbort);\n      resolve();\n    }, ms);\n    signal?.addEventListener('abort', onAbort, { once: true });\n  });\n}\n","export const HTTP_CLIENT_VERSION = '0.0.0';\n\nexport const DEFAULT_USER_AGENT = `rawdash-connector/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;\n\nexport function connectorUserAgent(connectorId: string): string {\n  return `rawdash-connector-${connectorId}/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;\n}\n","import {\n  AuthError,\n  ClientBugError,\n  HttpClientError,\n  RateLimitError,\n  TransientError,\n  UpstreamBugError,\n  errorForStatus,\n} from './errors';\nimport { defaultRetryOn, parseRetryAfter, sleep } from './retry';\nimport type { FetchLike, HttpMethod, HttpRequest, HttpResponse } from './types';\nimport { DEFAULT_USER_AGENT } from './version';\n\nconst DEFAULT_TIMEOUT_MS = 10_000;\nconst DEFAULT_MAX_ATTEMPTS = 3;\nconst DEFAULT_INITIAL_DELAY_MS = 1000;\nconst DEFAULT_MAX_DELAY_MS = 60_000;\nconst OBSERVER_TIMEOUT_MS = 250;\n\nexport interface RequestObservation {\n  url: string;\n  method: HttpMethod;\n  status: number;\n  resource: string;\n  requestId: string;\n  body: unknown;\n}\n\nexport type RequestObserver = (\n  event: RequestObservation,\n) => void | Promise<void>;\n\nexport interface RequestOptions {\n  fetch?: FetchLike;\n  observer?: RequestObserver;\n  resource: string;\n  requestId?: string;\n}\n\nasync function notifyObserver(\n  observer: RequestObserver,\n  event: RequestObservation,\n): Promise<void> {\n  let result: void | Promise<void>;\n  try {\n    result = observer(event);\n  } catch (err) {\n    console.warn('[connector-shared] request observer threw:', err);\n    return;\n  }\n  if (!(result instanceof Promise)) {\n    return;\n  }\n  const guarded = result.catch((err) => {\n    console.warn('[connector-shared] request observer rejected:', err);\n  });\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const timeout = new Promise<void>((resolve) => {\n    timer = setTimeout(resolve, OBSERVER_TIMEOUT_MS);\n  });\n  try {\n    await Promise.race([guarded, timeout]);\n  } finally {\n    if (timer) {\n      clearTimeout(timer);\n    }\n  }\n}\n\nfunction newRequestId(): string {\n  const c = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (c?.randomUUID) {\n    return c.randomUUID();\n  }\n  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nfunction mergeHeaders(\n  defaults: Record<string, string>,\n  overrides: Record<string, string> | undefined,\n): Record<string, string> {\n  const merged: Record<string, string> = {};\n  for (const [k, v] of Object.entries(defaults)) {\n    merged[k.toLowerCase()] = v;\n  }\n  if (overrides) {\n    for (const [k, v] of Object.entries(overrides)) {\n      merged[k.toLowerCase()] = v;\n    }\n  }\n  return merged;\n}\n\nfunction linkTimeoutSignal(\n  parent: AbortSignal | undefined,\n  timeoutMs: number,\n): { signal: AbortSignal; cancel: () => void } {\n  const controller = new AbortController();\n  const onParentAbort = () => {\n    controller.abort(parent?.reason);\n  };\n  if (parent) {\n    if (parent.aborted) {\n      controller.abort(parent.reason);\n    } else {\n      parent.addEventListener('abort', onParentAbort, { once: true });\n    }\n  }\n  const timer = setTimeout(() => {\n    controller.abort(new Error(`Request timed out after ${timeoutMs}ms`));\n  }, timeoutMs);\n  return {\n    signal: controller.signal,\n    cancel: () => {\n      clearTimeout(timer);\n      if (parent) {\n        parent.removeEventListener('abort', onParentAbort);\n      }\n    },\n  };\n}\n\nasync function readBody(res: Response, parseJson: boolean): Promise<unknown> {\n  if (res.status === 204 || res.status === 205) {\n    return null;\n  }\n  const contentType = res.headers.get('content-type') ?? '';\n  if (parseJson && contentType.includes('application/json')) {\n    const text = await res.text();\n    if (text.length === 0) {\n      return null;\n    }\n    return JSON.parse(text);\n  }\n  return res.text();\n}\n\nexport async function request<T = unknown>(\n  req: HttpRequest,\n  options: RequestOptions,\n): Promise<HttpResponse<T>> {\n  const fetchImpl: FetchLike = options.fetch ?? (globalThis.fetch as FetchLike);\n  const retry = req.retry ?? {};\n  const maxAttempts = retry.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;\n  const initialDelayMs = retry.initialDelayMs ?? DEFAULT_INITIAL_DELAY_MS;\n  const maxDelayMs = retry.maxDelayMs ?? DEFAULT_MAX_DELAY_MS;\n  const retryOn = retry.retryOn ?? defaultRetryOn;\n  const timeoutMs = req.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const parseJson = req.parseJson ?? true;\n\n  const headers = mergeHeaders(\n    {\n      'User-Agent': DEFAULT_USER_AGENT,\n      Accept: 'application/json',\n    },\n    req.headers,\n  );\n\n  let lastErr: Error | undefined;\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    req.signal?.throwIfAborted();\n\n    const { signal, cancel } = linkTimeoutSignal(req.signal, timeoutMs);\n    let res: Response;\n    try {\n      res = await fetchImpl(req.url, {\n        method: req.method ?? 'GET',\n        headers,\n        body: req.body as RequestInit['body'],\n        signal,\n      });\n    } catch (err) {\n      cancel();\n      if (req.signal?.aborted) {\n        throw req.signal.reason ?? err;\n      }\n      const error = err instanceof Error ? err : new Error(String(err));\n      lastErr = error;\n      if (attempt < maxAttempts - 1 && retryOn(null, error)) {\n        const delay = computeDelay(attempt, initialDelayMs, maxDelayMs);\n        await sleep(delay, req.signal);\n        continue;\n      }\n      throw new TransientError(error.message);\n    }\n    cancel();\n\n    const body = await readBody(res, parseJson);\n    const httpResponse: HttpResponse<T> = {\n      status: res.status,\n      headers: res.headers,\n      body: body as T,\n    };\n    if (req.rateLimit) {\n      const state = req.rateLimit.parse(res.headers);\n      if (state) {\n        httpResponse.rateLimitState = state;\n      }\n    }\n\n    if (options.observer) {\n      await notifyObserver(options.observer, {\n        url: req.url,\n        method: req.method ?? 'GET',\n        status: res.status,\n        resource: options.resource,\n        requestId: options.requestId ?? newRequestId(),\n        body,\n      });\n    }\n\n    if (res.ok) {\n      return httpResponse;\n    }\n\n    const retryAfter = parseRetryAfter(res.headers.get('retry-after'));\n    const message = `HTTP ${res.status} ${res.statusText} for ${req.method ?? 'GET'} ${req.url}`;\n    const err = errorForStatus(message, httpResponse, retryAfter);\n\n    if (\n      attempt < maxAttempts - 1 &&\n      retryOn(res.status, err) &&\n      !(err instanceof AuthError) &&\n      !(err instanceof ClientBugError)\n    ) {\n      lastErr = err;\n      let delay = computeDelay(attempt, initialDelayMs, maxDelayMs);\n      if (err instanceof RateLimitError && retryAfter) {\n        const wait = retryAfter.getTime() - Date.now();\n        if (wait > 0) {\n          delay = Math.min(wait, maxDelayMs);\n        }\n      }\n      await sleep(delay, req.signal);\n      continue;\n    }\n\n    throw err;\n  }\n\n  throw lastErr ?? new UpstreamBugError('Exhausted retry attempts');\n}\n\nfunction computeDelay(\n  attempt: number,\n  initialDelayMs: number,\n  maxDelayMs: number,\n): number {\n  const base = initialDelayMs * 2 ** attempt;\n  const jitter = base * 0.25 * Math.random();\n  return Math.min(base + jitter, maxDelayMs);\n}\n\nexport { HttpClientError };\n","export interface RateLimitState {\n  remaining: number;\n  resetAt: Date;\n}\n\nexport interface RateLimitPolicy {\n  parse(headers: Headers): RateLimitState | null;\n}\n\nexport interface StandardRateLimitPolicyConfig {\n  remainingHeader: string;\n  resetHeader: string;\n  resetUnit: 's' | 'ms';\n  resetFallbackMs?: number;\n}\n\nexport function standardRateLimitPolicy(\n  config: StandardRateLimitPolicyConfig,\n): RateLimitPolicy {\n  const { remainingHeader, resetHeader, resetUnit, resetFallbackMs } = config;\n  const multiplier = resetUnit === 's' ? 1000 : 1;\n  return {\n    parse(h) {\n      const remainingRaw = h.get(remainingHeader);\n      if (remainingRaw === null || remainingRaw.trim() === '') {\n        return null;\n      }\n      const remaining = Number(remainingRaw);\n      if (!Number.isFinite(remaining)) {\n        return null;\n      }\n      const resetRaw = h.get(resetHeader);\n      if (resetRaw === null) {\n        if (resetFallbackMs === undefined) {\n          return null;\n        }\n        return {\n          remaining,\n          resetAt: new Date(Date.now() + resetFallbackMs),\n        };\n      }\n      if (resetRaw.trim() === '') {\n        return null;\n      }\n      const reset = Number(resetRaw);\n      if (!Number.isFinite(reset) || reset < 0) {\n        return null;\n      }\n      const resetMs = reset * multiplier;\n      if (!Number.isFinite(resetMs)) {\n        return null;\n      }\n      return { remaining, resetAt: new Date(resetMs) };\n    },\n  };\n}\n","export interface SanitizeAllowedUrlOptions {\n  url: string | null;\n  host: string;\n  pathname: string;\n  protocol?: 'https:' | 'http:';\n}\n\nexport function sanitizeAllowedUrl(\n  options: SanitizeAllowedUrlOptions,\n): string | null {\n  const { url, host, pathname, protocol = 'https:' } = options;\n  if (url === null) {\n    return null;\n  }\n  try {\n    const u = new URL(url);\n    if (u.protocol !== protocol || u.host !== host || u.pathname !== pathname) {\n      return null;\n    }\n    return u.toString();\n  } catch {\n    return null;\n  }\n}\n","export type EpochUnit = 'ms' | 's' | 'iso';\n\nexport function parseEpoch(\n  value: number | string | null | undefined,\n  unit: EpochUnit,\n): number | null {\n  if (value === null || value === undefined) {\n    return null;\n  }\n  if (unit === 'iso') {\n    if (typeof value !== 'string') {\n      return null;\n    }\n    const ms = new Date(value).getTime();\n    return Number.isFinite(ms) ? ms : null;\n  }\n  if (typeof value === 'string' && value.trim() === '') {\n    return null;\n  }\n  const n = typeof value === 'number' ? value : Number(value);\n  if (!Number.isFinite(n)) {\n    return null;\n  }\n  const result = unit === 's' ? n * 1000 : n;\n  return Number.isFinite(result) ? result : null;\n}\n","import { request } from './request';\nimport type { HttpRequest } from './types';\n\nexport function parseLinkHeader(header: string | null): Record<string, string> {\n  if (!header) {\n    return {};\n  }\n  const result: Record<string, string> = {};\n  for (const part of header.split(',')) {\n    const match = part.match(/<([^>]+)>\\s*;\\s*rel=\"([^\"]+)\"/);\n    if (match) {\n      result[match[2]!] = match[1]!;\n    }\n  }\n  return result;\n}\n\nexport async function* paginateLink<T>(\n  initial: HttpRequest,\n  parse: (body: unknown) => T[],\n  options: { resource: string },\n): AsyncIterable<T> {\n  let next: string | null = initial.url;\n  while (next) {\n    const res: Awaited<ReturnType<typeof request>> = await request(\n      {\n        ...initial,\n        url: next,\n      },\n      { resource: options.resource },\n    );\n    for (const item of parse(res.body)) {\n      yield item;\n    }\n    const links = parseLinkHeader(res.headers.get('link'));\n    next = links['next'] ?? null;\n  }\n}\n\nexport async function* paginateCursor<T>(\n  initial: HttpRequest,\n  parse: (body: unknown) => { items: T[]; nextCursor: string | null },\n  buildNext: (req: HttpRequest, cursor: string) => HttpRequest,\n  options: { resource: string },\n): AsyncIterable<T> {\n  let req: HttpRequest = initial;\n  while (true) {\n    const res = await request(req, { resource: options.resource });\n    const { items, nextCursor } = parse(res.body);\n    for (const item of items) {\n      yield item;\n    }\n    if (!nextCursor) {\n      return;\n    }\n    req = buildNext(req, nextCursor);\n  }\n}\n\nexport async function* paginatePage<T>(\n  initial: HttpRequest,\n  parse: (body: unknown) => { items: T[]; hasMore: boolean },\n  buildPage: (req: HttpRequest, page: number) => HttpRequest,\n  options: { resource: string },\n): AsyncIterable<T> {\n  let page = 1;\n  while (true) {\n    const req = page === 1 ? initial : buildPage(initial, page);\n    const res = await request(req, { resource: options.resource });\n    const { items, hasMore } = parse(res.body);\n    for (const item of items) {\n      yield item;\n    }\n    if (!hasMore || items.length === 0) {\n      return;\n    }\n    page++;\n  }\n}\n","export type LogFields = Record<string, unknown>;\n\nexport interface ConnectorLogger {\n  info(event: string, fields?: LogFields): void;\n  warn(event: string, fields?: LogFields): void;\n}\n\nexport interface ConnectorLoggerOptions {\n  scope: string;\n}\n\nconst MAX_VALUE_LEN = 120;\n\nfunction truncate(s: string, max = MAX_VALUE_LEN): string {\n  if (s.length <= max) {\n    return s;\n  }\n  return `${s.slice(0, max - 1)}…`;\n}\n\nfunction formatValue(value: unknown): string {\n  if (value === null) {\n    return 'null';\n  }\n  if (value === undefined) {\n    return '';\n  }\n  if (typeof value === 'number' || typeof value === 'boolean') {\n    return String(value);\n  }\n  if (typeof value === 'string') {\n    const t = truncate(value);\n    if (/[\\s\"=]/.test(t)) {\n      return JSON.stringify(t);\n    }\n    return t;\n  }\n  if (typeof value === 'bigint') {\n    return value.toString();\n  }\n  let json: string | undefined;\n  try {\n    json = JSON.stringify(value);\n  } catch {\n    json = undefined;\n  }\n  return truncate(json ?? String(value));\n}\n\nexport function formatLogFields(fields?: LogFields): string {\n  if (!fields) {\n    return '';\n  }\n  const parts: string[] = [];\n  for (const [k, v] of Object.entries(fields)) {\n    if (v === undefined) {\n      continue;\n    }\n    parts.push(`${k}=${formatValue(v)}`);\n  }\n  return parts.length > 0 ? ` ${parts.join(' ')}` : '';\n}\n\nexport function formatLogLine(\n  scope: string,\n  event: string,\n  fields?: LogFields,\n): string {\n  return `[${scope}] ${event}${formatLogFields(fields)}`;\n}\n\nexport function createDefaultConnectorLogger(\n  opts: ConnectorLoggerOptions,\n): ConnectorLogger {\n  return {\n    info(event, fields) {\n      console.info(formatLogLine(opts.scope, event, fields));\n    },\n    warn(event, fields) {\n      console.warn(formatLogLine(opts.scope, event, fields));\n    },\n  };\n}\n\nconst NOOP_LOGGER: ConnectorLogger = {\n  info() {},\n  warn() {},\n};\n\nexport function noopConnectorLogger(): ConnectorLogger {\n  return NOOP_LOGGER;\n}\n","import {\n  type HttpResponse,\n  connectorUserAgent,\n  parseEpoch,\n  sanitizeAllowedUrl,\n} from '@rawdash/connector-shared';\nimport {\n  BaseConnector,\n  type ChunkedSyncCursor,\n  type ConnectorContext,\n  type ConnectorDoc,\n  type CredentialsSchema,\n  type StorageHandle,\n  type SyncOptions,\n  type SyncResult,\n  defineConfigFields,\n  defineConnectorDoc,\n  defineResources,\n  makeChunkedCursorGuard,\n  paginateChunked,\n  schemasFromResources,\n  selectActivePhases,\n} from '@rawdash/core';\nimport { z } from 'zod';\n\n// ---------------------------------------------------------------------------\n// configFields\n// ---------------------------------------------------------------------------\n\nexport const configFields = defineConfigFields(\n  z.object({\n    apiKey: z.object({ $secret: z.string() }).meta({\n      label: 'Private API Key',\n      description:\n        'Klaviyo Private API Key with read scopes for campaigns, flows, lists, and segments. Create one at Klaviyo -> Settings -> API Keys.',\n      placeholder: 'pk_...',\n      secret: true,\n    }),\n    apiRevision: z\n      .string()\n      .trim()\n      .regex(\n        /^\\d{4}-\\d{2}-\\d{2}(\\.pre)?$/,\n        'Use a Klaviyo API revision date like \"2024-10-15\".',\n      )\n      .default('2024-10-15')\n      .meta({\n        label: 'API revision',\n        description:\n          'Value sent in the revision header. Defaults to 2024-10-15; pin a specific date here when upgrading deliberately.',\n        placeholder: '2024-10-15',\n      }),\n    channel: z.enum(['email', 'sms', 'mobile_push']).default('email').meta({\n      label: 'Campaign channel',\n      description:\n        \"Which campaign channel to sync. The Klaviyo campaigns endpoint requires a channel filter and only returns one channel per call; defaults to 'email'.\",\n      placeholder: 'email',\n    }),\n    resources: z\n      .array(z.enum(['lists', 'segments', 'campaigns', 'flows']))\n      .nonempty()\n      .optional()\n      .meta({\n        label: 'Resources',\n        description:\n          'Which Klaviyo resources to sync. Omit to sync all of them. The key only needs read scopes for the resources listed here.',\n      }),\n  }),\n);\n\n// ---------------------------------------------------------------------------\n// Connector doc (catalog metadata)\n// ---------------------------------------------------------------------------\n\nexport const doc: ConnectorDoc = defineConnectorDoc({\n  displayName: 'Klaviyo',\n  category: 'marketing',\n  brandColor: '#000000',\n  tagline:\n    'Sync campaigns, flows, lists, and segments from Klaviyo for ecommerce email and SMS marketing analytics.',\n  vendor: {\n    name: 'Klaviyo',\n    apiDocs: 'https://developers.klaviyo.com/en/reference/api_overview',\n    website: 'https://www.klaviyo.com',\n  },\n  auth: {\n    summary:\n      'A Klaviyo Private API Key with read access to campaigns, flows, lists, and segments.',\n    setup: [\n      'Open Klaviyo -> Settings -> API Keys and create a new Private API Key.',\n      'Grant read access to Campaigns, Flows, Lists, and Segments (or only the scopes you intend to sync).',\n      'Copy the generated key and store it as a secret, referencing it from the connector config as `apiKey: secret(\"KLAVIYO_API_KEY\")`.',\n    ],\n  },\n  rateLimit:\n    'Klaviyo enforces per-endpoint burst and steady rate limits and signals them via the RateLimit-Remaining and RateLimit-Reset response headers. The shared HTTP client backs off on 429 and honors Retry-After.',\n  limitations: [\n    'Campaign and flow statistics (campaign-values-reports / flow-values-reports) are not synced; the reports endpoints require a per-account conversion metric id and are deferred to a follow-up.',\n    'Profile, event, catalog, and coupon objects are out of scope (niche for dashboard use).',\n    'Only one campaign channel per sync (email, sms, or mobile_push) - the Klaviyo campaigns endpoint requires the filter and does not allow OR across channels.',\n  ],\n});\n\n// ---------------------------------------------------------------------------\n// Settings / credentials\n// ---------------------------------------------------------------------------\n\nexport type KlaviyoChannel = 'email' | 'sms' | 'mobile_push';\n\nexport interface KlaviyoSettings {\n  apiRevision: string;\n  channel: KlaviyoChannel;\n  resources?: readonly KlaviyoResource[];\n}\n\nconst klaviyoCredentials = {\n  apiKey: {\n    description: 'Klaviyo Private API Key',\n    auth: 'required' as const,\n  },\n} satisfies CredentialsSchema;\n\ntype KlaviyoCredentials = typeof klaviyoCredentials;\n\n// ---------------------------------------------------------------------------\n// Sync phases + cursor\n// ---------------------------------------------------------------------------\n\nconst PHASE_ORDER = ['lists', 'segments', 'campaigns', 'flows'] as const;\n\ntype KlaviyoPhase = (typeof PHASE_ORDER)[number];\n\nexport type KlaviyoResource = KlaviyoPhase;\n\ntype KlaviyoSyncCursor = ChunkedSyncCursor<KlaviyoPhase, string>;\n\nconst isKlaviyoSyncCursor = makeChunkedCursorGuard(PHASE_ORDER);\n\nconst KLAVIYO_API_HOST = 'a.klaviyo.com';\nconst KLAVIYO_API_BASE = `https://${KLAVIYO_API_HOST}/api`;\nconst PAGE_SIZE = 100;\n\nconst LIST_ENTITY = 'klaviyo_list';\nconst SEGMENT_ENTITY = 'klaviyo_segment';\nconst CAMPAIGN_ENTITY = 'klaviyo_campaign';\nconst FLOW_ENTITY = 'klaviyo_flow';\n\nconst ENTITY_TYPE_BY_PHASE: Record<KlaviyoPhase, string> = {\n  lists: LIST_ENTITY,\n  segments: SEGMENT_ENTITY,\n  campaigns: CAMPAIGN_ENTITY,\n  flows: FLOW_ENTITY,\n};\n\n// Klaviyo's `updated` (lists/segments/flows) and `updated_at` (campaigns)\n// filter fields differ per endpoint.\nconst UPDATED_FIELD_BY_PHASE: Record<KlaviyoPhase, string> = {\n  lists: 'updated',\n  segments: 'updated',\n  campaigns: 'updated_at',\n  flows: 'updated',\n};\n\n// ---------------------------------------------------------------------------\n// API response types (JSON:API)\n// ---------------------------------------------------------------------------\n\ninterface JsonApiResource<TAttrs> {\n  type: string;\n  id: string;\n  attributes: TAttrs;\n}\n\ninterface JsonApiList<TAttrs> {\n  data: Array<JsonApiResource<TAttrs>>;\n  links?: { next?: string | null } | null;\n}\n\ninterface ListAttributes {\n  name?: string | null;\n  created?: string | null;\n  updated?: string | null;\n  opt_in_process?: string | null;\n}\n\ninterface SegmentAttributes {\n  name?: string | null;\n  created?: string | null;\n  updated?: string | null;\n  is_active?: boolean | null;\n  is_starred?: boolean | null;\n  is_processing?: boolean | null;\n}\n\ninterface CampaignAttributes {\n  name?: string | null;\n  status?: string | null;\n  archived?: boolean | null;\n  channel?: string | null;\n  send_time?: string | null;\n  scheduled_at?: string | null;\n  send_strategy?: { method?: string | null } | null;\n  created_at?: string | null;\n  updated_at?: string | null;\n}\n\ninterface FlowAttributes {\n  name?: string | null;\n  status?: string | null;\n  archived?: boolean | null;\n  trigger_type?: string | null;\n  created?: string | null;\n  updated?: string | null;\n}\n\n// ---------------------------------------------------------------------------\n// Schemas\n// ---------------------------------------------------------------------------\n\nconst idString = z.string().min(1);\n\nfunction jsonApiList<T extends z.ZodTypeAny>(attributes: T) {\n  return z.object({\n    data: z.array(\n      z.object({\n        type: z.string(),\n        id: idString,\n        attributes,\n      }),\n    ),\n    links: z.object({ next: z.string().nullish() }).nullish(),\n  });\n}\n\nconst listsResponseSchema = jsonApiList(\n  z.object({\n    name: z.string().nullish(),\n    created: z.string().nullish(),\n    updated: z.string().nullish(),\n    opt_in_process: z.string().nullish(),\n  }),\n);\n\nconst segmentsResponseSchema = jsonApiList(\n  z.object({\n    name: z.string().nullish(),\n    created: z.string().nullish(),\n    updated: z.string().nullish(),\n    is_active: z.boolean().nullish(),\n    is_starred: z.boolean().nullish(),\n    is_processing: z.boolean().nullish(),\n  }),\n);\n\nconst campaignsResponseSchema = jsonApiList(\n  z.object({\n    name: z.string().nullish(),\n    status: z.string().nullish(),\n    archived: z.boolean().nullish(),\n    channel: z.string().nullish(),\n    send_time: z.string().nullish(),\n    scheduled_at: z.string().nullish(),\n    send_strategy: z.object({ method: z.string().nullish() }).nullish(),\n    created_at: z.string().nullish(),\n    updated_at: z.string().nullish(),\n  }),\n);\n\nconst flowsResponseSchema = jsonApiList(\n  z.object({\n    name: z.string().nullish(),\n    status: z.string().nullish(),\n    archived: z.boolean().nullish(),\n    trigger_type: z.string().nullish(),\n    created: z.string().nullish(),\n    updated: z.string().nullish(),\n  }),\n);\n\n// ---------------------------------------------------------------------------\n// Resources\n// ---------------------------------------------------------------------------\n\nexport const klaviyoResources = defineResources({\n  [LIST_ENTITY]: {\n    shape: 'entity',\n    description:\n      'Klaviyo lists (manually managed subscriber collections) with opt-in process and created/updated timestamps.',\n    endpoint: 'GET /api/lists',\n    fields: [\n      { name: 'name', description: 'List display name.' },\n      {\n        name: 'optInProcess',\n        description: 'Opt-in process (e.g. single_opt_in, double_opt_in).',\n      },\n      {\n        name: 'createdAt',\n        description: 'When the list was created (Unix ms).',\n      },\n    ],\n    responses: { lists: listsResponseSchema },\n  },\n  [SEGMENT_ENTITY]: {\n    shape: 'entity',\n    description:\n      'Klaviyo segments (rule-based dynamic groups) with active, starred, and processing flags.',\n    endpoint: 'GET /api/segments',\n    fields: [\n      { name: 'name', description: 'Segment display name.' },\n      { name: 'isActive', description: 'Whether the segment is active.' },\n      { name: 'isStarred', description: 'Whether the segment is starred.' },\n      {\n        name: 'isProcessing',\n        description: 'Whether the segment is currently recomputing.',\n      },\n      {\n        name: 'createdAt',\n        description: 'When the segment was created (Unix ms).',\n      },\n    ],\n    responses: { segments: segmentsResponseSchema },\n  },\n  [CAMPAIGN_ENTITY]: {\n    shape: 'entity',\n    description:\n      'Klaviyo campaigns for the configured channel, with status, archived flag, send strategy, and send time.',\n    endpoint: 'GET /api/campaigns',\n    notes:\n      'Klaviyo requires a channel filter on /campaigns; this connector syncs one channel per instance (the configured `channel` setting).',\n    fields: [\n      { name: 'name', description: 'Campaign name.' },\n      { name: 'status', description: 'Campaign status (Draft, Sent, etc.).' },\n      { name: 'archived', description: 'Whether the campaign is archived.' },\n      {\n        name: 'channel',\n        description: 'Campaign channel (email, sms, mobile_push).',\n      },\n      {\n        name: 'sendStrategy',\n        description: 'Send strategy method (static, smart_send_time, etc.).',\n      },\n      {\n        name: 'sendTime',\n        description: 'Scheduled or actual send time (Unix ms).',\n      },\n      {\n        name: 'createdAt',\n        description: 'When the campaign was created (Unix ms).',\n      },\n    ],\n    responses: { campaigns: campaignsResponseSchema },\n  },\n  [FLOW_ENTITY]: {\n    shape: 'entity',\n    description:\n      'Klaviyo flows (automation series) with status, trigger type, and archived flag.',\n    endpoint: 'GET /api/flows',\n    fields: [\n      { name: 'name', description: 'Flow name.' },\n      { name: 'status', description: 'Flow status (live, draft, manual).' },\n      { name: 'archived', description: 'Whether the flow is archived.' },\n      {\n        name: 'triggerType',\n        description: 'Flow trigger type (e.g. list, segment, metric).',\n      },\n      {\n        name: 'createdAt',\n        description: 'When the flow was created (Unix ms).',\n      },\n    ],\n    responses: { flows: flowsResponseSchema },\n  },\n});\n\n// ---------------------------------------------------------------------------\n// KlaviyoConnector\n// ---------------------------------------------------------------------------\n\nexport const id = 'klaviyo';\n\nexport class KlaviyoConnector extends BaseConnector<\n  KlaviyoSettings,\n  KlaviyoCredentials\n> {\n  static readonly id = id;\n\n  static readonly resources = klaviyoResources;\n\n  static readonly schemas = schemasFromResources(klaviyoResources);\n\n  static create(input: unknown, ctx?: ConnectorContext): KlaviyoConnector {\n    const parsed = configFields.parse(input);\n    return new KlaviyoConnector(\n      {\n        apiRevision: parsed.apiRevision,\n        channel: parsed.channel,\n        resources: parsed.resources,\n      },\n      { apiKey: parsed.apiKey },\n      ctx,\n    );\n  }\n\n  readonly id = id;\n  override readonly credentials = klaviyoCredentials;\n\n  private buildHeaders(): Record<string, string> {\n    return {\n      Authorization: `Klaviyo-API-Key ${this.creds.apiKey}`,\n      revision: this.settings.apiRevision,\n      Accept: 'application/vnd.api+json',\n      'User-Agent': connectorUserAgent('klaviyo'),\n    };\n  }\n\n  private apiGet<T>(\n    url: string,\n    resource: string,\n    signal?: AbortSignal,\n  ): Promise<HttpResponse<T>> {\n    return this.get<T>(url, {\n      resource,\n      headers: this.buildHeaders(),\n      signal,\n    });\n  }\n\n  // -------------------------------------------------------------------------\n  // URL building + sanitization\n  // -------------------------------------------------------------------------\n\n  private allowedPagePath(phase: KlaviyoPhase): string {\n    switch (phase) {\n      case 'lists':\n        return '/api/lists';\n      case 'segments':\n        return '/api/segments';\n      case 'campaigns':\n        return '/api/campaigns';\n      case 'flows':\n        return '/api/flows';\n    }\n  }\n\n  private sanitizePageUrl(\n    phase: KlaviyoPhase,\n    pageUrl: string | null,\n  ): string | null {\n    return sanitizeAllowedUrl({\n      url: pageUrl,\n      host: KLAVIYO_API_HOST,\n      pathname: this.allowedPagePath(phase),\n    });\n  }\n\n  private resolveCursor(cursor: unknown): KlaviyoSyncCursor | undefined {\n    if (!isKlaviyoSyncCursor(cursor)) {\n      return undefined;\n    }\n    return {\n      phase: cursor.phase,\n      page: this.sanitizePageUrl(cursor.phase, cursor.page),\n    };\n  }\n\n  private buildInitialUrl(phase: KlaviyoPhase, options: SyncOptions): string {\n    const u = new URL(`${KLAVIYO_API_BASE}${this.allowedPagePath(phase)}`);\n    u.searchParams.set('page[size]', String(PAGE_SIZE));\n    u.searchParams.set('sort', UPDATED_FIELD_BY_PHASE[phase]);\n    const filters: string[] = [];\n    if (phase === 'campaigns') {\n      filters.push(`equals(messages.channel,'${this.settings.channel}')`);\n    }\n    if (options.since) {\n      const date = new Date(options.since);\n      if (Number.isFinite(date.getTime())) {\n        filters.push(\n          `greater-than(${UPDATED_FIELD_BY_PHASE[phase]},${date.toISOString()})`,\n        );\n      }\n    }\n    if (filters.length > 0) {\n      u.searchParams.set('filter', filters.join(','));\n    }\n    return u.toString();\n  }\n\n  // -------------------------------------------------------------------------\n  // Fetchers\n  // -------------------------------------------------------------------------\n\n  private async fetchPhasePage<TAttrs>(\n    phase: KlaviyoPhase,\n    page: string | null,\n    options: SyncOptions,\n    signal?: AbortSignal,\n  ): Promise<{\n    items: Array<JsonApiResource<TAttrs>>;\n    next: string | null;\n  }> {\n    const url = page ?? this.buildInitialUrl(phase, options);\n    const res = await this.apiGet<JsonApiList<TAttrs>>(url, phase, signal);\n    const nextRaw = res.body.links?.next ?? null;\n    const next = nextRaw ? this.sanitizePageUrl(phase, nextRaw) : null;\n    return { items: res.body.data ?? [], next };\n  }\n\n  // -------------------------------------------------------------------------\n  // Writers\n  // -------------------------------------------------------------------------\n\n  private async writeLists(\n    storage: StorageHandle,\n    items: Array<JsonApiResource<ListAttributes>>,\n  ): Promise<void> {\n    for (const item of items) {\n      const attrs = item.attributes ?? ({} as ListAttributes);\n      const createdMs = parseEpoch(attrs.created ?? null, 'iso');\n      const updatedMs = parseEpoch(attrs.updated ?? null, 'iso');\n      await storage.entity({\n        type: LIST_ENTITY,\n        id: item.id,\n        attributes: {\n          name: attrs.name ?? null,\n          optInProcess: attrs.opt_in_process ?? null,\n          createdAt: createdMs,\n        },\n        updated_at: updatedMs ?? createdMs ?? 0,\n      });\n    }\n  }\n\n  private async writeSegments(\n    storage: StorageHandle,\n    items: Array<JsonApiResource<SegmentAttributes>>,\n  ): Promise<void> {\n    for (const item of items) {\n      const attrs = item.attributes ?? ({} as SegmentAttributes);\n      const createdMs = parseEpoch(attrs.created ?? null, 'iso');\n      const updatedMs = parseEpoch(attrs.updated ?? null, 'iso');\n      await storage.entity({\n        type: SEGMENT_ENTITY,\n        id: item.id,\n        attributes: {\n          name: attrs.name ?? null,\n          isActive: attrs.is_active ?? null,\n          isStarred: attrs.is_starred ?? null,\n          isProcessing: attrs.is_processing ?? null,\n          createdAt: createdMs,\n        },\n        updated_at: updatedMs ?? createdMs ?? 0,\n      });\n    }\n  }\n\n  private async writeCampaigns(\n    storage: StorageHandle,\n    items: Array<JsonApiResource<CampaignAttributes>>,\n  ): Promise<void> {\n    for (const item of items) {\n      const attrs = item.attributes ?? ({} as CampaignAttributes);\n      const createdMs = parseEpoch(attrs.created_at ?? null, 'iso');\n      const updatedMs = parseEpoch(attrs.updated_at ?? null, 'iso');\n      const sendTimeMs = parseEpoch(\n        attrs.send_time ?? attrs.scheduled_at ?? null,\n        'iso',\n      );\n      await storage.entity({\n        type: CAMPAIGN_ENTITY,\n        id: item.id,\n        attributes: {\n          name: attrs.name ?? null,\n          status: attrs.status ?? null,\n          archived: attrs.archived ?? null,\n          channel: attrs.channel ?? this.settings.channel,\n          sendStrategy: attrs.send_strategy?.method ?? null,\n          sendTime: sendTimeMs,\n          createdAt: createdMs,\n        },\n        updated_at: updatedMs ?? createdMs ?? 0,\n      });\n    }\n  }\n\n  private async writeFlows(\n    storage: StorageHandle,\n    items: Array<JsonApiResource<FlowAttributes>>,\n  ): Promise<void> {\n    for (const item of items) {\n      const attrs = item.attributes ?? ({} as FlowAttributes);\n      const createdMs = parseEpoch(attrs.created ?? null, 'iso');\n      const updatedMs = parseEpoch(attrs.updated ?? null, 'iso');\n      await storage.entity({\n        type: FLOW_ENTITY,\n        id: item.id,\n        attributes: {\n          name: attrs.name ?? null,\n          status: attrs.status ?? null,\n          archived: attrs.archived ?? null,\n          triggerType: attrs.trigger_type ?? null,\n          createdAt: createdMs,\n        },\n        updated_at: updatedMs ?? createdMs ?? 0,\n      });\n    }\n  }\n\n  private async writePhase(\n    storage: StorageHandle,\n    phase: KlaviyoPhase,\n    items: unknown[],\n  ): Promise<void> {\n    switch (phase) {\n      case 'lists':\n        return this.writeLists(\n          storage,\n          items as Array<JsonApiResource<ListAttributes>>,\n        );\n      case 'segments':\n        return this.writeSegments(\n          storage,\n          items as Array<JsonApiResource<SegmentAttributes>>,\n        );\n      case 'campaigns':\n        return this.writeCampaigns(\n          storage,\n          items as Array<JsonApiResource<CampaignAttributes>>,\n        );\n      case 'flows':\n        return this.writeFlows(\n          storage,\n          items as Array<JsonApiResource<FlowAttributes>>,\n        );\n    }\n  }\n\n  async sync(\n    options: SyncOptions,\n    storage: StorageHandle,\n    signal?: AbortSignal,\n  ): Promise<SyncResult> {\n    const cursor = this.resolveCursor(options.cursor);\n    const isFull = options.mode === 'full';\n\n    const phases = selectActivePhases<KlaviyoResource, KlaviyoPhase>(\n      (r) => r,\n      PHASE_ORDER,\n      this.settings.resources,\n    );\n\n    return paginateChunked<KlaviyoPhase, string>({\n      phases,\n      cursor,\n      signal,\n      logger: this.logger,\n      fetchPage: async (phase, page, sig) =>\n        this.fetchPhasePage(phase, page, options, sig),\n      writeBatch: async (phase, items, page) => {\n        if (isFull && page === null) {\n          await storage.entities([], { types: [ENTITY_TYPE_BY_PHASE[phase]] });\n        }\n        await this.writePhase(storage, phase, items);\n      },\n    });\n  }\n}\n","import { KlaviyoConnector } from './klaviyo';\n\nexport {\n  configFields,\n  doc,\n  KlaviyoConnector,\n  klaviyoResources as resources,\n  id,\n} from './klaviyo';\nexport type {\n  KlaviyoSettings,\n  KlaviyoResource,\n  KlaviyoChannel,\n} from './klaviyo';\nexport default KlaviyoConnector;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@rawdash/connector-klaviyo",
+  "version": "0.0.1",
+  "description": "Rawdash connector for Klaviyo — syncs campaigns, flows, lists, and segments from the Klaviyo REST API into the six-shape storage model",
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rawdash/rawdash.git",
+    "directory": "packages/connectors/klaviyo"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "@rawdash/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@rawdash/core": "workspace:*",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@rawdash/connector-shared": "workspace:*",
+    "@rawdash/connector-test-utils": "workspace:*",
+    "fast-check": "^4.8.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.4"
+  }
+}