@rawdash/connector-meta-ads 0.16.0

package/README.md

@@ -0,0 +1,131 @@
+<!-- This file is generated from connector metadata by scripts/generate-connector-docs.ts. Do not edit by hand. -->
+
+# @rawdash/connector-meta-ads
+
+[![npm version](https://img.shields.io/npm/v/@rawdash/connector-meta-ads)](https://www.npmjs.com/package/@rawdash/connector-meta-ads)
+[![license](https://img.shields.io/npm/l/@rawdash/connector-meta-ads)](https://github.com/rawdash/rawdash/blob/main/LICENSE)
+
+Sync Meta (Facebook + Instagram) ad campaigns plus daily campaign, adset, and ad-level insights - spend, impressions, clicks, reach, conversions, and conversion value.
+
+## Install
+
+```sh
+npm install @rawdash/connector-meta-ads
+```
+
+## Authentication
+
+A long-lived System User access token from Meta Business Manager, scoped with `ads_read` (and `read_insights` on newer accounts) for the target ad account.
+
+1. In Meta Business Manager → Business Settings → Users → System Users, create a System User (or reuse an existing one) and assign it to the ad account with at least the Advertiser role.
+2. Generate a System User access token for the System User; pick `ads_read` and (where available) `read_insights` as the scopes. Choose the longest available expiry - System User tokens can be made effectively non-expiring.
+3. Find the ad account ID in Ads Manager → Settings → Account info; it always starts with `act_`.
+4. Store the token as a secret and reference it from the connector config as `accessToken: secret("META_ACCESS_TOKEN")` alongside `adAccountId: "act_<id>"`.
+
+## Configuration
+
+| Field          | Type   | Required | Description                                                                                                                                                |
+| -------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `adAccountId`  | string | Yes      | Meta Marketing API ad account ID. Find it in Ads Manager → Settings → Account info; it always starts with `act_`.                                          |
+| `accessToken`  | secret | Yes      | Long-lived System User access token from Meta Business Manager with `ads_read` (and, for newer accounts, `read_insights`) scopes on the chosen ad account. |
+| `apiVersion`   | string | No       | Pin a specific Meta Graph API version (e.g. `v21.0`). Defaults to `v21.0`.                                                                                 |
+| `lookbackDays` | number | No       | How many calendar days of insights to fetch on a full sync. Defaults to 90.                                                                                |
+| `resources`    | array  | No       | Which Meta resources to sync. Omit to sync all. Ad-level insights are the most expensive - leave them out if you only need campaign or adset rollups.      |
+
+## Resources
+
+- **`meta_campaign`** _(entity)_ - Meta ad campaigns with name, objective, status, and budget. Upserted by id; one row per campaign in the ad account.
+  - Endpoint: `GET /{ad_account_id}/campaigns`
+- **`meta_campaign_insights`** _(metric)_ - Daily campaign-level Meta Ads insights - spend (primary value), impressions, clicks, reach, conversions, and conversion value bucketed by campaign.
+  - Endpoint: `GET /{ad_account_id}/insights?level=campaign&time_increment=1`
+  - Unit: spend
+  - Granularity: day
+  - Dimensions: `date`, `campaignId`, `campaignName`, `impressions`, `clicks`, `spend`, `reach`, `conversions`, `conversion_value`
+  - Primary value is `spend`. `conversions` is the sum of every entry in the upstream `actions` array; `conversion_value` is the sum of every entry in `action_values`.
+- **`meta_adset_insights`** _(metric)_ - Daily adset-level Meta Ads insights - same fields as the campaign roll-up, bucketed by adset.
+  - Endpoint: `GET /{ad_account_id}/insights?level=adset&time_increment=1`
+  - Unit: spend
+  - Granularity: day
+  - Dimensions: `date`, `campaignId`, `campaignName`, `adsetId`, `adsetName`, `impressions`, `clicks`, `spend`, `reach`, `conversions`, `conversion_value`
+  - Primary value is `spend`. Includes campaign_id/campaign_name so adset rows are easy to roll up to their parent campaign.
+- **`meta_ad_insights`** _(metric)_ - Daily ad-level Meta Ads insights - same fields as the adset roll-up, bucketed by ad.
+  - Endpoint: `GET /{ad_account_id}/insights?level=ad&time_increment=1`
+  - Unit: spend
+  - Granularity: day
+  - Dimensions: `date`, `campaignId`, `campaignName`, `adsetId`, `adsetName`, `adId`, `adName`, `impressions`, `clicks`, `spend`, `reach`, `conversions`, `conversion_value`
+  - Primary value is `spend`. Cardinality is the highest of the three insights resources - opt in via `resources: [..., "ad_insights"]` only when you need per-ad breakdowns.
+
+## Example
+
+```ts
+import {
+  defineConfig,
+  defineDashboard,
+  defineMetric,
+  secret,
+} from '@rawdash/core';
+
+const metaAds = {
+  name: 'metaAds',
+  connectorId: 'meta-ads',
+  config: {
+    adAccountId: 'act_1234567890',
+    accessToken: secret('META_ACCESS_TOKEN'),
+    lookbackDays: 90,
+  },
+};
+
+export default defineConfig({
+  connectors: [metaAds],
+  dashboards: {
+    marketing: defineDashboard({
+      widgets: {
+        spend_30d: {
+          kind: 'stat',
+          title: 'Meta Ads spend (30d)',
+          window: '30d',
+          metric: defineMetric({
+            connector: metaAds,
+            shape: 'metric',
+            name: 'meta_campaign_insights',
+            field: 'spend',
+            fn: 'sum',
+          }),
+        },
+        daily_spend: {
+          kind: 'timeseries',
+          title: 'Daily Meta Ads spend',
+          window: '30d',
+          metric: defineMetric({
+            connector: metaAds,
+            shape: 'metric',
+            name: 'meta_campaign_insights',
+            field: 'spend',
+            fn: 'sum',
+          }),
+        },
+      },
+    }),
+  },
+});
+```
+
+## Rate limits
+
+Meta enforces per-app and per-ad-account budgets surfaced through the `X-Business-Use-Case-Usage` header. Sync at most every few hours per ad account; very large accounts may need a daily cadence.
+
+## Limitations
+
+- Insights are always fetched at daily granularity. Sub-daily breakdowns are not supported.
+- Insights for the most recent 30 days are re-fetched on every incremental sync because Meta keeps attributing conversions after the event date.
+- Creative-level breakdowns (publisher_platform, placement, demographics) are intentionally out of scope to keep the metric cardinality bounded.
+
+## Links
+
+- [Rawdash docs](https://rawdash.dev/docs/connectors/)
+- [Meta API docs](https://developers.facebook.com/docs/marketing-api/insights)
+- [GitHub](https://github.com/rawdash/rawdash)
+
+## License
+
+Apache-2.0

package/dist/index.d.ts

@@ -0,0 +1,393 @@
+import { BaseConnector, ConnectorContext, SyncOptions, StorageHandle, SyncResult, ConnectorDoc } from '@rawdash/core';
+import { z } from 'zod';
+
+declare const configFields: z.ZodObject<{
+    adAccountId: z.ZodString;
+    accessToken: z.ZodObject<{
+        $secret: z.ZodString;
+    }, z.core.$strip>;
+    apiVersion: z.ZodOptional<z.ZodString>;
+    lookbackDays: z.ZodOptional<z.ZodNumber>;
+    resources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        campaigns: "campaigns";
+        campaign_insights: "campaign_insights";
+        adset_insights: "adset_insights";
+        ad_insights: "ad_insights";
+    }>>>;
+}, z.core.$strip>;
+declare const doc: ConnectorDoc;
+interface MetaAdsSettings {
+    adAccountId: string;
+    apiVersion?: string;
+    lookbackDays?: number;
+    resources?: readonly MetaAdsResource[];
+}
+declare const metaAdsCredentials: {
+    accessToken: {
+        description: string;
+        auth: "required";
+    };
+};
+type MetaAdsCredentials = typeof metaAdsCredentials;
+declare const PHASE_ORDER: readonly ["campaigns", "campaign_insights", "adset_insights", "ad_insights"];
+type MetaAdsPhase = (typeof PHASE_ORDER)[number];
+type MetaAdsResource = MetaAdsPhase;
+interface MetaActionEntry {
+    action_type?: string;
+    value?: string | number;
+}
+interface MetaCampaign {
+    id: string;
+    name?: string | null;
+    objective?: string | null;
+    status?: string | null;
+    effective_status?: string | null;
+    daily_budget?: string | number | null;
+    lifetime_budget?: string | number | null;
+    created_time?: string | null;
+    updated_time?: string | null;
+}
+interface MetaInsightsBase {
+    date_start: string;
+    date_stop?: string;
+    impressions?: string | number;
+    clicks?: string | number;
+    spend?: string | number;
+    reach?: string | number;
+    actions?: MetaActionEntry[];
+    action_values?: MetaActionEntry[];
+}
+interface MetaCampaignInsight extends MetaInsightsBase {
+    campaign_id: string;
+    campaign_name?: string | null;
+}
+interface MetaAdsetInsight extends MetaCampaignInsight {
+    adset_id: string;
+    adset_name?: string | null;
+}
+interface MetaAdInsight extends MetaAdsetInsight {
+    ad_id: string;
+    ad_name?: string | null;
+}
+declare function campaignToEntity(row: MetaCampaign): {
+    type: string;
+    id: string;
+    attributes: Record<string, string | number | null>;
+    updated_at: number;
+};
+declare function insightRowToMetricSample(row: MetaCampaignInsight | MetaAdsetInsight | MetaAdInsight, phase: 'campaign_insights' | 'adset_insights' | 'ad_insights'): {
+    name: string;
+    ts: number;
+    value: number;
+    attributes: Record<string, string | number | null>;
+};
+declare class MetaAdsConnector extends BaseConnector<MetaAdsSettings, MetaAdsCredentials> {
+    static readonly id = "meta-ads";
+    static readonly resources: {
+        readonly meta_campaign: {
+            readonly shape: "entity";
+            readonly description: "Meta ad campaigns with name, objective, status, and budget. Upserted by id; one row per campaign in the ad account.";
+            readonly endpoint: "GET /{ad_account_id}/campaigns";
+            readonly responses: {
+                readonly campaigns: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    objective: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    effective_status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    daily_budget: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+                    lifetime_budget: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+                    created_time: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    updated_time: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>;
+            };
+        };
+        readonly meta_campaign_insights: {
+            readonly shape: "metric";
+            readonly description: "Daily campaign-level Meta Ads insights - spend (primary value), impressions, clicks, reach, conversions, and conversion value bucketed by campaign.";
+            readonly endpoint: "GET /{ad_account_id}/insights?level=campaign&time_increment=1";
+            readonly unit: "spend";
+            readonly granularity: "day";
+            readonly notes: "Primary value is `spend`. `conversions` is the sum of every entry in the upstream `actions` array; `conversion_value` is the sum of every entry in `action_values`.";
+            readonly dimensions: [{
+                readonly name: "date";
+                readonly description: "Calendar day of the metric sample (UTC).";
+            }, {
+                readonly name: "campaignId";
+                readonly description: "Meta campaign id.";
+            }, {
+                readonly name: "campaignName";
+                readonly description: "Meta campaign name.";
+            }, {
+                readonly name: "impressions";
+                readonly description: "Total impressions on the day.";
+            }, {
+                readonly name: "clicks";
+                readonly description: "Total clicks on the day.";
+            }, {
+                readonly name: "spend";
+                readonly description: "Total spend (account currency).";
+            }, {
+                readonly name: "reach";
+                readonly description: "Unique reach on the day.";
+            }, {
+                readonly name: "conversions";
+                readonly description: "Total attributed actions.";
+            }, {
+                readonly name: "conversion_value";
+                readonly description: "Total attributed action value (account currency).";
+            }];
+            readonly responses: {
+                readonly campaign_insights: z.ZodArray<z.ZodObject<{
+                    campaign_id: z.ZodString;
+                    campaign_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    date_start: z.ZodString;
+                    date_stop: z.ZodOptional<z.ZodString>;
+                    impressions: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    clicks: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    spend: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    reach: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        action_type: z.ZodOptional<z.ZodString>;
+                        value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    }, z.core.$strip>>>;
+                    action_values: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        action_type: z.ZodOptional<z.ZodString>;
+                        value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>>;
+            };
+        };
+        readonly meta_adset_insights: {
+            readonly shape: "metric";
+            readonly description: "Daily adset-level Meta Ads insights - same fields as the campaign roll-up, bucketed by adset.";
+            readonly endpoint: "GET /{ad_account_id}/insights?level=adset&time_increment=1";
+            readonly unit: "spend";
+            readonly granularity: "day";
+            readonly notes: "Primary value is `spend`. Includes campaign_id/campaign_name so adset rows are easy to roll up to their parent campaign.";
+            readonly dimensions: [{
+                readonly name: "date";
+                readonly description: "Calendar day of the metric sample (UTC).";
+            }, {
+                readonly name: "campaignId";
+                readonly description: "Parent campaign id.";
+            }, {
+                readonly name: "campaignName";
+                readonly description: "Parent campaign name.";
+            }, {
+                readonly name: "adsetId";
+                readonly description: "Meta adset id.";
+            }, {
+                readonly name: "adsetName";
+                readonly description: "Meta adset name.";
+            }, {
+                readonly name: "impressions";
+                readonly description: "Total impressions on the day.";
+            }, {
+                readonly name: "clicks";
+                readonly description: "Total clicks on the day.";
+            }, {
+                readonly name: "spend";
+                readonly description: "Total spend (account currency).";
+            }, {
+                readonly name: "reach";
+                readonly description: "Unique reach on the day.";
+            }, {
+                readonly name: "conversions";
+                readonly description: "Total attributed actions.";
+            }, {
+                readonly name: "conversion_value";
+                readonly description: "Total attributed action value (account currency).";
+            }];
+            readonly responses: {
+                readonly adset_insights: z.ZodArray<z.ZodObject<{
+                    campaign_id: z.ZodString;
+                    campaign_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    adset_id: z.ZodString;
+                    adset_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    date_start: z.ZodString;
+                    date_stop: z.ZodOptional<z.ZodString>;
+                    impressions: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    clicks: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    spend: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    reach: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        action_type: z.ZodOptional<z.ZodString>;
+                        value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    }, z.core.$strip>>>;
+                    action_values: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        action_type: z.ZodOptional<z.ZodString>;
+                        value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>>;
+            };
+        };
+        readonly meta_ad_insights: {
+            readonly shape: "metric";
+            readonly description: "Daily ad-level Meta Ads insights - same fields as the adset roll-up, bucketed by ad.";
+            readonly endpoint: "GET /{ad_account_id}/insights?level=ad&time_increment=1";
+            readonly unit: "spend";
+            readonly granularity: "day";
+            readonly notes: "Primary value is `spend`. Cardinality is the highest of the three insights resources - opt in via `resources: [..., \"ad_insights\"]` only when you need per-ad breakdowns.";
+            readonly dimensions: [{
+                readonly name: "date";
+                readonly description: "Calendar day of the metric sample (UTC).";
+            }, {
+                readonly name: "campaignId";
+                readonly description: "Parent campaign id.";
+            }, {
+                readonly name: "campaignName";
+                readonly description: "Parent campaign name.";
+            }, {
+                readonly name: "adsetId";
+                readonly description: "Parent adset id.";
+            }, {
+                readonly name: "adsetName";
+                readonly description: "Parent adset name.";
+            }, {
+                readonly name: "adId";
+                readonly description: "Meta ad id.";
+            }, {
+                readonly name: "adName";
+                readonly description: "Meta ad name.";
+            }, {
+                readonly name: "impressions";
+                readonly description: "Total impressions on the day.";
+            }, {
+                readonly name: "clicks";
+                readonly description: "Total clicks on the day.";
+            }, {
+                readonly name: "spend";
+                readonly description: "Total spend (account currency).";
+            }, {
+                readonly name: "reach";
+                readonly description: "Unique reach on the day.";
+            }, {
+                readonly name: "conversions";
+                readonly description: "Total attributed actions.";
+            }, {
+                readonly name: "conversion_value";
+                readonly description: "Total attributed action value (account currency).";
+            }];
+            readonly responses: {
+                readonly ad_insights: z.ZodArray<z.ZodObject<{
+                    campaign_id: z.ZodString;
+                    campaign_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    adset_id: z.ZodString;
+                    adset_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    ad_id: z.ZodString;
+                    ad_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    date_start: z.ZodString;
+                    date_stop: z.ZodOptional<z.ZodString>;
+                    impressions: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    clicks: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    spend: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    reach: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        action_type: z.ZodOptional<z.ZodString>;
+                        value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    }, z.core.$strip>>>;
+                    action_values: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        action_type: z.ZodOptional<z.ZodString>;
+                        value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>>;
+            };
+        };
+    };
+    static readonly schemas: {
+        readonly campaigns: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            objective: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            effective_status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            daily_budget: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            lifetime_budget: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            created_time: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            updated_time: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>;
+    } & {
+        readonly campaign_insights: z.ZodArray<z.ZodObject<{
+            campaign_id: z.ZodString;
+            campaign_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            date_start: z.ZodString;
+            date_stop: z.ZodOptional<z.ZodString>;
+            impressions: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            clicks: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            spend: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            reach: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                action_type: z.ZodOptional<z.ZodString>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            }, z.core.$strip>>>;
+            action_values: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                action_type: z.ZodOptional<z.ZodString>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+    } & {
+        readonly adset_insights: z.ZodArray<z.ZodObject<{
+            campaign_id: z.ZodString;
+            campaign_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            adset_id: z.ZodString;
+            adset_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            date_start: z.ZodString;
+            date_stop: z.ZodOptional<z.ZodString>;
+            impressions: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            clicks: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            spend: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            reach: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                action_type: z.ZodOptional<z.ZodString>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            }, z.core.$strip>>>;
+            action_values: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                action_type: z.ZodOptional<z.ZodString>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+    } & {
+        readonly ad_insights: z.ZodArray<z.ZodObject<{
+            campaign_id: z.ZodString;
+            campaign_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            adset_id: z.ZodString;
+            adset_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            ad_id: z.ZodString;
+            ad_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            date_start: z.ZodString;
+            date_stop: z.ZodOptional<z.ZodString>;
+            impressions: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            clicks: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            spend: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            reach: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                action_type: z.ZodOptional<z.ZodString>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            }, z.core.$strip>>>;
+            action_values: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                action_type: z.ZodOptional<z.ZodString>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+    } & Readonly<Record<string, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+    static create(input: unknown, ctx?: ConnectorContext): MetaAdsConnector;
+    readonly id = "meta-ads";
+    readonly credentials: {
+        accessToken: {
+            description: string;
+            auth: "required";
+        };
+    };
+    private buildHeaders;
+    private apiVersion;
+    private accountBase;
+    private fetchCampaignsPage;
+    private fetchInsightsPage;
+    private writeCampaigns;
+    private writeInsights;
+    private clearScopeOnFirstPage;
+    sync(options: SyncOptions, storage: StorageHandle, signal?: AbortSignal): Promise<SyncResult>;
+}
+
+export { type MetaActionEntry, type MetaAdInsight, MetaAdsConnector, type MetaAdsResource, type MetaAdsSettings, type MetaAdsetInsight, type MetaCampaign, type MetaCampaignInsight, campaignToEntity, configFields, MetaAdsConnector as default, doc, insightRowToMetricSample };

package/dist/index.js

@@ -0,0 +1,553 @@
+// ../../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)`;
+}
+
+// src/meta-ads.ts
+import {
+  BaseConnector,
+  defineConfigFields,
+  defineConnectorDoc,
+  defineResources,
+  makeChunkedCursorGuard,
+  paginateChunked,
+  schemasFromResources,
+  selectActivePhases
+} from "@rawdash/core";
+import { z } from "zod";
+var configFields = defineConfigFields(
+  z.object({
+    adAccountId: z.string().trim().regex(
+      /^act_\d+$/,
+      "Ad account ID must look like `act_<digits>` (e.g. `act_1234567890`)"
+    ).meta({
+      label: "Ad account ID",
+      description: "Meta Marketing API ad account ID. Find it in Ads Manager \u2192 Settings \u2192 Account info; it always starts with `act_`.",
+      placeholder: "act_1234567890"
+    }),
+    accessToken: z.object({ $secret: z.string() }).meta({
+      label: "System user access token",
+      description: "Long-lived System User access token from Meta Business Manager with `ads_read` (and, for newer accounts, `read_insights`) scopes on the chosen ad account.",
+      placeholder: "EAAB...",
+      secret: true
+    }),
+    apiVersion: z.string().regex(/^v\d+\.\d+$/, "API version must look like `v21.0`").optional().meta({
+      label: "Graph API version",
+      description: "Pin a specific Meta Graph API version (e.g. `v21.0`). Defaults to `v21.0`.",
+      placeholder: "v21.0"
+    }),
+    lookbackDays: z.number().int().positive().optional().meta({
+      label: "Lookback days (full sync)",
+      description: "How many calendar days of insights to fetch on a full sync. Defaults to 90.",
+      placeholder: "90"
+    }),
+    resources: z.array(
+      z.enum([
+        "campaigns",
+        "campaign_insights",
+        "adset_insights",
+        "ad_insights"
+      ])
+    ).nonempty().optional().meta({
+      label: "Resources",
+      description: "Which Meta resources to sync. Omit to sync all. Ad-level insights are the most expensive - leave them out if you only need campaign or adset rollups."
+    })
+  })
+);
+var doc = defineConnectorDoc({
+  displayName: "Meta Ads",
+  category: "marketing",
+  brandColor: "#0866FF",
+  tagline: "Sync Meta (Facebook + Instagram) ad campaigns plus daily campaign, adset, and ad-level insights - spend, impressions, clicks, reach, conversions, and conversion value.",
+  vendor: {
+    name: "Meta",
+    apiDocs: "https://developers.facebook.com/docs/marketing-api/insights",
+    website: "https://business.facebook.com"
+  },
+  auth: {
+    summary: "A long-lived System User access token from Meta Business Manager, scoped with `ads_read` (and `read_insights` on newer accounts) for the target ad account.",
+    setup: [
+      "In Meta Business Manager \u2192 Business Settings \u2192 Users \u2192 System Users, create a System User (or reuse an existing one) and assign it to the ad account with at least the Advertiser role.",
+      "Generate a System User access token for the System User; pick `ads_read` and (where available) `read_insights` as the scopes. Choose the longest available expiry - System User tokens can be made effectively non-expiring.",
+      "Find the ad account ID in Ads Manager \u2192 Settings \u2192 Account info; it always starts with `act_`.",
+      'Store the token as a secret and reference it from the connector config as `accessToken: secret("META_ACCESS_TOKEN")` alongside `adAccountId: "act_<id>"`.'
+    ]
+  },
+  rateLimit: "Meta enforces per-app and per-ad-account budgets surfaced through the `X-Business-Use-Case-Usage` header. Sync at most every few hours per ad account; very large accounts may need a daily cadence.",
+  limitations: [
+    "Insights are always fetched at daily granularity. Sub-daily breakdowns are not supported.",
+    "Insights for the most recent 30 days are re-fetched on every incremental sync because Meta keeps attributing conversions after the event date.",
+    "Creative-level breakdowns (publisher_platform, placement, demographics) are intentionally out of scope to keep the metric cardinality bounded."
+  ]
+});
+var metaAdsCredentials = {
+  accessToken: {
+    description: "Meta System User access token",
+    auth: "required"
+  }
+};
+var PHASE_ORDER = [
+  "campaigns",
+  "campaign_insights",
+  "adset_insights",
+  "ad_insights"
+];
+var isMetaAdsSyncCursor = makeChunkedCursorGuard(PHASE_ORDER);
+var DEFAULT_API_VERSION = "v21.0";
+var BASE_URL = "https://graph.facebook.com";
+var PAGE_LIMIT = 100;
+var MS_PER_DAY = 24 * 60 * 60 * 1e3;
+var DEFAULT_LOOKBACK_DAYS = 90;
+var INCREMENTAL_LOOKBACK_DAYS = 30;
+var INSIGHTS_PHASES = /* @__PURE__ */ new Set([
+  "campaign_insights",
+  "adset_insights",
+  "ad_insights"
+]);
+var PHASE_TO_LEVEL = {
+  campaign_insights: "campaign",
+  adset_insights: "adset",
+  ad_insights: "ad"
+};
+var METRIC_NAME = {
+  campaigns: "meta_campaign",
+  campaign_insights: "meta_campaign_insights",
+  adset_insights: "meta_adset_insights",
+  ad_insights: "meta_ad_insights"
+};
+var CAMPAIGN_ENTITY_TYPE = "meta_campaign";
+function toMetaDate(date) {
+  const y = date.getUTCFullYear();
+  const m = String(date.getUTCMonth() + 1).padStart(2, "0");
+  const d = String(date.getUTCDate()).padStart(2, "0");
+  return `${y}-${m}-${d}`;
+}
+function metaDateToMs(metaDate) {
+  const [y, m, d] = metaDate.split("-").map((part) => Number(part));
+  if (!Number.isFinite(y) || !Number.isFinite(m) || !Number.isFinite(d) || y === void 0 || m === void 0 || d === void 0) {
+    return 0;
+  }
+  return Date.UTC(y, m - 1, d);
+}
+function getDateRange(options, lookbackDays) {
+  const now = Date.now();
+  const until = toMetaDate(new Date(now));
+  if (options.mode === "latest" && options.since) {
+    const startMs2 = now - (INCREMENTAL_LOOKBACK_DAYS - 1) * MS_PER_DAY;
+    return { since: toMetaDate(new Date(startMs2)), until };
+  }
+  if (options.since) {
+    const sinceMs = new Date(options.since).getTime();
+    if (Number.isFinite(sinceMs)) {
+      const days = Math.max(1, Math.ceil((now - sinceMs) / MS_PER_DAY));
+      const cappedDays = Math.min(days, lookbackDays);
+      const startMs2 = now - (cappedDays - 1) * MS_PER_DAY;
+      return { since: toMetaDate(new Date(startMs2)), until };
+    }
+  }
+  const startMs = now - (lookbackDays - 1) * MS_PER_DAY;
+  return { since: toMetaDate(new Date(startMs)), until };
+}
+function parseNumber(value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return value;
+  }
+  if (typeof value === "string" && value.trim() !== "") {
+    const n = Number(value);
+    return Number.isFinite(n) ? n : 0;
+  }
+  return 0;
+}
+function parseOptionalNumber(value) {
+  if (value === null || value === void 0) {
+    return null;
+  }
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return value;
+  }
+  if (typeof value === "string" && value.trim() !== "") {
+    const n = Number(value);
+    return Number.isFinite(n) ? n : null;
+  }
+  return null;
+}
+function sumActionValues(entries) {
+  if (!entries) {
+    return 0;
+  }
+  let total = 0;
+  for (const entry of entries) {
+    total += parseNumber(entry.value);
+  }
+  return total;
+}
+var actionEntrySchema = z.object({
+  action_type: z.string().optional(),
+  value: z.union([z.string(), z.number()]).optional()
+});
+var campaignSchema = z.object({
+  id: z.string().min(1),
+  name: z.string().nullish(),
+  objective: z.string().nullish(),
+  status: z.string().nullish(),
+  effective_status: z.string().nullish(),
+  daily_budget: z.union([z.string(), z.number()]).nullish(),
+  lifetime_budget: z.union([z.string(), z.number()]).nullish(),
+  created_time: z.string().nullish(),
+  updated_time: z.string().nullish()
+});
+var insightsBaseShape = {
+  date_start: z.string(),
+  date_stop: z.string().optional(),
+  impressions: z.union([z.string(), z.number()]).optional(),
+  clicks: z.union([z.string(), z.number()]).optional(),
+  spend: z.union([z.string(), z.number()]).optional(),
+  reach: z.union([z.string(), z.number()]).optional(),
+  actions: z.array(actionEntrySchema).optional(),
+  action_values: z.array(actionEntrySchema).optional()
+};
+var campaignInsightSchema = z.object({
+  ...insightsBaseShape,
+  campaign_id: z.string().min(1),
+  campaign_name: z.string().nullish()
+});
+var adsetInsightSchema = z.object({
+  ...insightsBaseShape,
+  campaign_id: z.string().min(1),
+  campaign_name: z.string().nullish(),
+  adset_id: z.string().min(1),
+  adset_name: z.string().nullish()
+});
+var adInsightSchema = z.object({
+  ...insightsBaseShape,
+  campaign_id: z.string().min(1),
+  campaign_name: z.string().nullish(),
+  adset_id: z.string().min(1),
+  adset_name: z.string().nullish(),
+  ad_id: z.string().min(1),
+  ad_name: z.string().nullish()
+});
+var campaignsSchema = z.array(campaignSchema);
+var campaignInsightsSchema = z.array(campaignInsightSchema);
+var adsetInsightsSchema = z.array(adsetInsightSchema);
+var adInsightsSchema = z.array(adInsightSchema);
+var metaAdsResources = defineResources({
+  meta_campaign: {
+    shape: "entity",
+    description: "Meta ad campaigns with name, objective, status, and budget. Upserted by id; one row per campaign in the ad account.",
+    endpoint: "GET /{ad_account_id}/campaigns",
+    responses: { campaigns: campaignsSchema }
+  },
+  meta_campaign_insights: {
+    shape: "metric",
+    description: "Daily campaign-level Meta Ads insights - spend (primary value), impressions, clicks, reach, conversions, and conversion value bucketed by campaign.",
+    endpoint: "GET /{ad_account_id}/insights?level=campaign&time_increment=1",
+    unit: "spend",
+    granularity: "day",
+    notes: "Primary value is `spend`. `conversions` is the sum of every entry in the upstream `actions` array; `conversion_value` is the sum of every entry in `action_values`.",
+    dimensions: [
+      { name: "date", description: "Calendar day of the metric sample (UTC)." },
+      { name: "campaignId", description: "Meta campaign id." },
+      { name: "campaignName", description: "Meta campaign name." },
+      { name: "impressions", description: "Total impressions on the day." },
+      { name: "clicks", description: "Total clicks on the day." },
+      { name: "spend", description: "Total spend (account currency)." },
+      { name: "reach", description: "Unique reach on the day." },
+      { name: "conversions", description: "Total attributed actions." },
+      {
+        name: "conversion_value",
+        description: "Total attributed action value (account currency)."
+      }
+    ],
+    responses: { campaign_insights: campaignInsightsSchema }
+  },
+  meta_adset_insights: {
+    shape: "metric",
+    description: "Daily adset-level Meta Ads insights - same fields as the campaign roll-up, bucketed by adset.",
+    endpoint: "GET /{ad_account_id}/insights?level=adset&time_increment=1",
+    unit: "spend",
+    granularity: "day",
+    notes: "Primary value is `spend`. Includes campaign_id/campaign_name so adset rows are easy to roll up to their parent campaign.",
+    dimensions: [
+      { name: "date", description: "Calendar day of the metric sample (UTC)." },
+      { name: "campaignId", description: "Parent campaign id." },
+      { name: "campaignName", description: "Parent campaign name." },
+      { name: "adsetId", description: "Meta adset id." },
+      { name: "adsetName", description: "Meta adset name." },
+      { name: "impressions", description: "Total impressions on the day." },
+      { name: "clicks", description: "Total clicks on the day." },
+      { name: "spend", description: "Total spend (account currency)." },
+      { name: "reach", description: "Unique reach on the day." },
+      { name: "conversions", description: "Total attributed actions." },
+      {
+        name: "conversion_value",
+        description: "Total attributed action value (account currency)."
+      }
+    ],
+    responses: { adset_insights: adsetInsightsSchema }
+  },
+  meta_ad_insights: {
+    shape: "metric",
+    description: "Daily ad-level Meta Ads insights - same fields as the adset roll-up, bucketed by ad.",
+    endpoint: "GET /{ad_account_id}/insights?level=ad&time_increment=1",
+    unit: "spend",
+    granularity: "day",
+    notes: 'Primary value is `spend`. Cardinality is the highest of the three insights resources - opt in via `resources: [..., "ad_insights"]` only when you need per-ad breakdowns.',
+    dimensions: [
+      { name: "date", description: "Calendar day of the metric sample (UTC)." },
+      { name: "campaignId", description: "Parent campaign id." },
+      { name: "campaignName", description: "Parent campaign name." },
+      { name: "adsetId", description: "Parent adset id." },
+      { name: "adsetName", description: "Parent adset name." },
+      { name: "adId", description: "Meta ad id." },
+      { name: "adName", description: "Meta ad name." },
+      { name: "impressions", description: "Total impressions on the day." },
+      { name: "clicks", description: "Total clicks on the day." },
+      { name: "spend", description: "Total spend (account currency)." },
+      { name: "reach", description: "Unique reach on the day." },
+      { name: "conversions", description: "Total attributed actions." },
+      {
+        name: "conversion_value",
+        description: "Total attributed action value (account currency)."
+      }
+    ],
+    responses: { ad_insights: adInsightsSchema }
+  }
+});
+function campaignToEntity(row) {
+  const updatedAt = row.updated_time ? new Date(row.updated_time).getTime() : row.created_time ? new Date(row.created_time).getTime() : 0;
+  return {
+    type: CAMPAIGN_ENTITY_TYPE,
+    id: row.id,
+    attributes: {
+      name: row.name ?? null,
+      objective: row.objective ?? null,
+      status: row.status ?? null,
+      effectiveStatus: row.effective_status ?? null,
+      dailyBudget: parseOptionalNumber(row.daily_budget),
+      lifetimeBudget: parseOptionalNumber(row.lifetime_budget),
+      createdAt: row.created_time ? new Date(row.created_time).getTime() : null
+    },
+    updated_at: Number.isFinite(updatedAt) ? updatedAt : 0
+  };
+}
+function buildInsightAttributes(row) {
+  const impressions = parseNumber(row.impressions);
+  const clicks = parseNumber(row.clicks);
+  const spend = parseNumber(row.spend);
+  const reach = parseNumber(row.reach);
+  const conversions = (row.actions ?? []).length ? sumActionValues(row.actions) : 0;
+  const conversionValue = sumActionValues(row.action_values);
+  return {
+    date: row.date_start,
+    impressions,
+    clicks,
+    spend,
+    reach,
+    conversions,
+    conversion_value: conversionValue
+  };
+}
+function insightRowToMetricSample(row, phase) {
+  const attributes = buildInsightAttributes(row);
+  attributes["campaignId"] = row.campaign_id;
+  attributes["campaignName"] = row.campaign_name ?? null;
+  if (phase !== "campaign_insights") {
+    const ar = row;
+    attributes["adsetId"] = ar.adset_id;
+    attributes["adsetName"] = ar.adset_name ?? null;
+  }
+  if (phase === "ad_insights") {
+    const ar = row;
+    attributes["adId"] = ar.ad_id;
+    attributes["adName"] = ar.ad_name ?? null;
+  }
+  return {
+    name: METRIC_NAME[phase],
+    ts: metaDateToMs(row.date_start),
+    value: parseNumber(row.spend),
+    attributes
+  };
+}
+var CAMPAIGN_FIELDS = [
+  "id",
+  "name",
+  "objective",
+  "status",
+  "effective_status",
+  "daily_budget",
+  "lifetime_budget",
+  "created_time",
+  "updated_time"
+].join(",");
+var COMMON_INSIGHT_FIELDS = [
+  "date_start",
+  "date_stop",
+  "campaign_id",
+  "campaign_name",
+  "impressions",
+  "clicks",
+  "spend",
+  "reach",
+  "actions",
+  "action_values"
+];
+var INSIGHT_FIELDS = {
+  campaign_insights: COMMON_INSIGHT_FIELDS.join(","),
+  adset_insights: [...COMMON_INSIGHT_FIELDS, "adset_id", "adset_name"].join(
+    ","
+  ),
+  ad_insights: [
+    ...COMMON_INSIGHT_FIELDS,
+    "adset_id",
+    "adset_name",
+    "ad_id",
+    "ad_name"
+  ].join(",")
+};
+var MetaAdsConnector = class _MetaAdsConnector extends BaseConnector {
+  static id = "meta-ads";
+  static resources = metaAdsResources;
+  static schemas = schemasFromResources(metaAdsResources);
+  static create(input, ctx) {
+    const parsed = configFields.parse(input);
+    return new _MetaAdsConnector(
+      {
+        adAccountId: parsed.adAccountId,
+        apiVersion: parsed.apiVersion,
+        lookbackDays: parsed.lookbackDays,
+        resources: parsed.resources
+      },
+      { accessToken: parsed.accessToken },
+      ctx
+    );
+  }
+  id = "meta-ads";
+  credentials = metaAdsCredentials;
+  buildHeaders() {
+    return {
+      Authorization: `Bearer ${this.creds.accessToken}`,
+      "User-Agent": connectorUserAgent("meta-ads")
+    };
+  }
+  apiVersion() {
+    return this.settings.apiVersion ?? DEFAULT_API_VERSION;
+  }
+  accountBase() {
+    return `${BASE_URL}/${this.apiVersion()}/${this.settings.adAccountId}`;
+  }
+  async fetchCampaignsPage(after, signal) {
+    const url = new URL(`${this.accountBase()}/campaigns`);
+    url.searchParams.set("fields", CAMPAIGN_FIELDS);
+    url.searchParams.set("limit", String(PAGE_LIMIT));
+    if (after) {
+      url.searchParams.set("after", after);
+    }
+    const res = await this.get(
+      url.toString(),
+      {
+        resource: "campaigns",
+        headers: this.buildHeaders(),
+        signal
+      }
+    );
+    return {
+      items: res.body.data ?? [],
+      next: res.body.paging?.cursors?.after ?? null
+    };
+  }
+  async fetchInsightsPage(phase, dateRange, after, signal) {
+    const url = new URL(`${this.accountBase()}/insights`);
+    url.searchParams.set("level", PHASE_TO_LEVEL[phase]);
+    url.searchParams.set("time_increment", "1");
+    url.searchParams.set("fields", INSIGHT_FIELDS[phase]);
+    url.searchParams.set(
+      "time_range",
+      JSON.stringify({ since: dateRange.since, until: dateRange.until })
+    );
+    url.searchParams.set("limit", String(PAGE_LIMIT));
+    if (after) {
+      url.searchParams.set("after", after);
+    }
+    const res = await this.get(url.toString(), {
+      resource: phase,
+      headers: this.buildHeaders(),
+      signal
+    });
+    return {
+      items: res.body.data ?? [],
+      next: res.body.paging?.cursors?.after ?? null
+    };
+  }
+  async writeCampaigns(storage, items) {
+    for (const row of items) {
+      await storage.entity(campaignToEntity(row));
+    }
+  }
+  async writeInsights(storage, phase, items) {
+    for (const row of items) {
+      await storage.metric(insightRowToMetricSample(row, phase));
+    }
+  }
+  async clearScopeOnFirstPage(storage, phase, isFull) {
+    if (INSIGHTS_PHASES.has(phase)) {
+      await storage.metrics([], { names: [METRIC_NAME[phase]] });
+      return;
+    }
+    if (!isFull) {
+      return;
+    }
+    await storage.entities([], { types: [CAMPAIGN_ENTITY_TYPE] });
+  }
+  async sync(options, storage, signal) {
+    const cursor = isMetaAdsSyncCursor(options.cursor) ? options.cursor : void 0;
+    const isFull = options.mode === "full";
+    const lookbackDays = this.settings.lookbackDays ?? DEFAULT_LOOKBACK_DAYS;
+    const dateRange = getDateRange(options, lookbackDays);
+    const phases = selectActivePhases(
+      (r) => r,
+      PHASE_ORDER,
+      this.settings.resources
+    );
+    return paginateChunked({
+      phases,
+      cursor,
+      signal,
+      logger: this.logger,
+      fetchPage: async (phase, page, sig) => {
+        if (phase === "campaigns") {
+          return this.fetchCampaignsPage(page, sig);
+        }
+        return this.fetchInsightsPage(phase, dateRange, page, sig);
+      },
+      writeBatch: async (phase, items, page) => {
+        if (page === null) {
+          await this.clearScopeOnFirstPage(storage, phase, isFull);
+        }
+        if (phase === "campaigns") {
+          await this.writeCampaigns(storage, items);
+          return;
+        }
+        await this.writeInsights(
+          storage,
+          phase,
+          items
+        );
+      }
+    });
+  }
+};
+
+// src/index.ts
+var index_default = MetaAdsConnector;
+export {
+  MetaAdsConnector,
+  campaignToEntity,
+  configFields,
+  index_default as default,
+  doc,
+  insightRowToMetricSample
+};
+//# 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/meta-ads.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 { connectorUserAgent } from '@rawdash/connector-shared';\nimport {\n  BaseConnector,\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\nexport const configFields = defineConfigFields(\n  z.object({\n    adAccountId: z\n      .string()\n      .trim()\n      .regex(\n        /^act_\\d+$/,\n        'Ad account ID must look like `act_<digits>` (e.g. `act_1234567890`)',\n      )\n      .meta({\n        label: 'Ad account ID',\n        description:\n          'Meta Marketing API ad account ID. Find it in Ads Manager → Settings → Account info; it always starts with `act_`.',\n        placeholder: 'act_1234567890',\n      }),\n    accessToken: z.object({ $secret: z.string() }).meta({\n      label: 'System user access token',\n      description:\n        'Long-lived System User access token from Meta Business Manager with `ads_read` (and, for newer accounts, `read_insights`) scopes on the chosen ad account.',\n      placeholder: 'EAAB...',\n      secret: true,\n    }),\n    apiVersion: z\n      .string()\n      .regex(/^v\\d+\\.\\d+$/, 'API version must look like `v21.0`')\n      .optional()\n      .meta({\n        label: 'Graph API version',\n        description:\n          'Pin a specific Meta Graph API version (e.g. `v21.0`). Defaults to `v21.0`.',\n        placeholder: 'v21.0',\n      }),\n    lookbackDays: z.number().int().positive().optional().meta({\n      label: 'Lookback days (full sync)',\n      description:\n        'How many calendar days of insights to fetch on a full sync. Defaults to 90.',\n      placeholder: '90',\n    }),\n    resources: z\n      .array(\n        z.enum([\n          'campaigns',\n          'campaign_insights',\n          'adset_insights',\n          'ad_insights',\n        ]),\n      )\n      .nonempty()\n      .optional()\n      .meta({\n        label: 'Resources',\n        description:\n          'Which Meta resources to sync. Omit to sync all. Ad-level insights are the most expensive - leave them out if you only need campaign or adset rollups.',\n      }),\n  }),\n);\n\nexport const doc: ConnectorDoc = defineConnectorDoc({\n  displayName: 'Meta Ads',\n  category: 'marketing',\n  brandColor: '#0866FF',\n  tagline:\n    'Sync Meta (Facebook + Instagram) ad campaigns plus daily campaign, adset, and ad-level insights - spend, impressions, clicks, reach, conversions, and conversion value.',\n  vendor: {\n    name: 'Meta',\n    apiDocs: 'https://developers.facebook.com/docs/marketing-api/insights',\n    website: 'https://business.facebook.com',\n  },\n  auth: {\n    summary:\n      'A long-lived System User access token from Meta Business Manager, scoped with `ads_read` (and `read_insights` on newer accounts) for the target ad account.',\n    setup: [\n      'In Meta Business Manager → Business Settings → Users → System Users, create a System User (or reuse an existing one) and assign it to the ad account with at least the Advertiser role.',\n      'Generate a System User access token for the System User; pick `ads_read` and (where available) `read_insights` as the scopes. Choose the longest available expiry - System User tokens can be made effectively non-expiring.',\n      'Find the ad account ID in Ads Manager → Settings → Account info; it always starts with `act_`.',\n      'Store the token as a secret and reference it from the connector config as `accessToken: secret(\"META_ACCESS_TOKEN\")` alongside `adAccountId: \"act_<id>\"`.',\n    ],\n  },\n  rateLimit:\n    'Meta enforces per-app and per-ad-account budgets surfaced through the `X-Business-Use-Case-Usage` header. Sync at most every few hours per ad account; very large accounts may need a daily cadence.',\n  limitations: [\n    'Insights are always fetched at daily granularity. Sub-daily breakdowns are not supported.',\n    'Insights for the most recent 30 days are re-fetched on every incremental sync because Meta keeps attributing conversions after the event date.',\n    'Creative-level breakdowns (publisher_platform, placement, demographics) are intentionally out of scope to keep the metric cardinality bounded.',\n  ],\n});\n\n// ---------------------------------------------------------------------------\n// Settings / credentials\n// ---------------------------------------------------------------------------\n\nexport interface MetaAdsSettings {\n  adAccountId: string;\n  apiVersion?: string;\n  lookbackDays?: number;\n  resources?: readonly MetaAdsResource[];\n}\n\nconst metaAdsCredentials = {\n  accessToken: {\n    description: 'Meta System User access token',\n    auth: 'required' as const,\n  },\n} satisfies CredentialsSchema;\n\ntype MetaAdsCredentials = typeof metaAdsCredentials;\n\n// ---------------------------------------------------------------------------\n// Phases + cursor\n// ---------------------------------------------------------------------------\n\nconst PHASE_ORDER = [\n  'campaigns',\n  'campaign_insights',\n  'adset_insights',\n  'ad_insights',\n] as const;\n\ntype MetaAdsPhase = (typeof PHASE_ORDER)[number];\n\nexport type MetaAdsResource = MetaAdsPhase;\n\nconst isMetaAdsSyncCursor = makeChunkedCursorGuard(PHASE_ORDER);\n\nconst DEFAULT_API_VERSION = 'v21.0';\nconst BASE_URL = 'https://graph.facebook.com';\nconst PAGE_LIMIT = 100;\n\nconst MS_PER_DAY = 24 * 60 * 60 * 1000;\nconst DEFAULT_LOOKBACK_DAYS = 90;\n// Meta keeps attributing conversions for several days after the event; on\n// incremental syncs always re-pull the last 30 days so late attribution\n// rewrites stale rows.\nconst INCREMENTAL_LOOKBACK_DAYS = 30;\n\nconst INSIGHTS_PHASES: ReadonlySet<MetaAdsPhase> = new Set([\n  'campaign_insights',\n  'adset_insights',\n  'ad_insights',\n]);\n\nconst PHASE_TO_LEVEL: Record<\n  'campaign_insights' | 'adset_insights' | 'ad_insights',\n  'campaign' | 'adset' | 'ad'\n> = {\n  campaign_insights: 'campaign',\n  adset_insights: 'adset',\n  ad_insights: 'ad',\n};\n\nconst METRIC_NAME: Record<MetaAdsPhase, string> = {\n  campaigns: 'meta_campaign',\n  campaign_insights: 'meta_campaign_insights',\n  adset_insights: 'meta_adset_insights',\n  ad_insights: 'meta_ad_insights',\n};\n\nconst CAMPAIGN_ENTITY_TYPE = 'meta_campaign';\n\n// ---------------------------------------------------------------------------\n// Date helpers\n// ---------------------------------------------------------------------------\n\nfunction toMetaDate(date: Date): string {\n  const y = date.getUTCFullYear();\n  const m = String(date.getUTCMonth() + 1).padStart(2, '0');\n  const d = String(date.getUTCDate()).padStart(2, '0');\n  return `${y}-${m}-${d}`;\n}\n\nfunction metaDateToMs(metaDate: string): number {\n  // Meta insights dates arrive as 'YYYY-MM-DD'\n  const [y, m, d] = metaDate.split('-').map((part) => Number(part));\n  if (\n    !Number.isFinite(y) ||\n    !Number.isFinite(m) ||\n    !Number.isFinite(d) ||\n    y === undefined ||\n    m === undefined ||\n    d === undefined\n  ) {\n    return 0;\n  }\n  return Date.UTC(y, m - 1, d);\n}\n\ninterface MetaDateRange {\n  since: string;\n  until: string;\n}\n\nfunction getDateRange(\n  options: SyncOptions,\n  lookbackDays: number,\n): MetaDateRange {\n  const now = Date.now();\n  const until = toMetaDate(new Date(now));\n  if (options.mode === 'latest' && options.since) {\n    const startMs = now - (INCREMENTAL_LOOKBACK_DAYS - 1) * MS_PER_DAY;\n    return { since: toMetaDate(new Date(startMs)), until };\n  }\n  if (options.since) {\n    const sinceMs = new Date(options.since).getTime();\n    if (Number.isFinite(sinceMs)) {\n      const days = Math.max(1, Math.ceil((now - sinceMs) / MS_PER_DAY));\n      const cappedDays = Math.min(days, lookbackDays);\n      const startMs = now - (cappedDays - 1) * MS_PER_DAY;\n      return { since: toMetaDate(new Date(startMs)), until };\n    }\n  }\n  const startMs = now - (lookbackDays - 1) * MS_PER_DAY;\n  return { since: toMetaDate(new Date(startMs)), until };\n}\n\n// ---------------------------------------------------------------------------\n// Value helpers\n// ---------------------------------------------------------------------------\n\nfunction parseNumber(value: unknown): number {\n  if (typeof value === 'number' && Number.isFinite(value)) {\n    return value;\n  }\n  if (typeof value === 'string' && value.trim() !== '') {\n    const n = Number(value);\n    return Number.isFinite(n) ? n : 0;\n  }\n  return 0;\n}\n\nfunction parseOptionalNumber(value: unknown): number | null {\n  if (value === null || value === undefined) {\n    return null;\n  }\n  if (typeof value === 'number' && Number.isFinite(value)) {\n    return value;\n  }\n  if (typeof value === 'string' && value.trim() !== '') {\n    const n = Number(value);\n    return Number.isFinite(n) ? n : null;\n  }\n  return null;\n}\n\nfunction sumActionValues(\n  entries: ReadonlyArray<{ value?: unknown }> | undefined,\n): number {\n  if (!entries) {\n    return 0;\n  }\n  let total = 0;\n  for (const entry of entries) {\n    total += parseNumber(entry.value);\n  }\n  return total;\n}\n\n// ---------------------------------------------------------------------------\n// Schemas - describe the per-resource API response shape consumed by request()\n// ---------------------------------------------------------------------------\n\nconst actionEntrySchema = z.object({\n  action_type: z.string().optional(),\n  value: z.union([z.string(), z.number()]).optional(),\n});\n\nconst campaignSchema = z.object({\n  id: z.string().min(1),\n  name: z.string().nullish(),\n  objective: z.string().nullish(),\n  status: z.string().nullish(),\n  effective_status: z.string().nullish(),\n  daily_budget: z.union([z.string(), z.number()]).nullish(),\n  lifetime_budget: z.union([z.string(), z.number()]).nullish(),\n  created_time: z.string().nullish(),\n  updated_time: z.string().nullish(),\n});\n\nconst insightsBaseShape = {\n  date_start: z.string(),\n  date_stop: z.string().optional(),\n  impressions: z.union([z.string(), z.number()]).optional(),\n  clicks: z.union([z.string(), z.number()]).optional(),\n  spend: z.union([z.string(), z.number()]).optional(),\n  reach: z.union([z.string(), z.number()]).optional(),\n  actions: z.array(actionEntrySchema).optional(),\n  action_values: z.array(actionEntrySchema).optional(),\n};\n\nconst campaignInsightSchema = z.object({\n  ...insightsBaseShape,\n  campaign_id: z.string().min(1),\n  campaign_name: z.string().nullish(),\n});\n\nconst adsetInsightSchema = z.object({\n  ...insightsBaseShape,\n  campaign_id: z.string().min(1),\n  campaign_name: z.string().nullish(),\n  adset_id: z.string().min(1),\n  adset_name: z.string().nullish(),\n});\n\nconst adInsightSchema = z.object({\n  ...insightsBaseShape,\n  campaign_id: z.string().min(1),\n  campaign_name: z.string().nullish(),\n  adset_id: z.string().min(1),\n  adset_name: z.string().nullish(),\n  ad_id: z.string().min(1),\n  ad_name: z.string().nullish(),\n});\n\nconst campaignsSchema = z.array(campaignSchema);\nconst campaignInsightsSchema = z.array(campaignInsightSchema);\nconst adsetInsightsSchema = z.array(adsetInsightSchema);\nconst adInsightsSchema = z.array(adInsightSchema);\n\nconst metaAdsResources = defineResources({\n  meta_campaign: {\n    shape: 'entity',\n    description:\n      'Meta ad campaigns with name, objective, status, and budget. Upserted by id; one row per campaign in the ad account.',\n    endpoint: 'GET /{ad_account_id}/campaigns',\n    responses: { campaigns: campaignsSchema },\n  },\n  meta_campaign_insights: {\n    shape: 'metric',\n    description:\n      'Daily campaign-level Meta Ads insights - spend (primary value), impressions, clicks, reach, conversions, and conversion value bucketed by campaign.',\n    endpoint: 'GET /{ad_account_id}/insights?level=campaign&time_increment=1',\n    unit: 'spend',\n    granularity: 'day',\n    notes:\n      'Primary value is `spend`. `conversions` is the sum of every entry in the upstream `actions` array; `conversion_value` is the sum of every entry in `action_values`.',\n    dimensions: [\n      { name: 'date', description: 'Calendar day of the metric sample (UTC).' },\n      { name: 'campaignId', description: 'Meta campaign id.' },\n      { name: 'campaignName', description: 'Meta campaign name.' },\n      { name: 'impressions', description: 'Total impressions on the day.' },\n      { name: 'clicks', description: 'Total clicks on the day.' },\n      { name: 'spend', description: 'Total spend (account currency).' },\n      { name: 'reach', description: 'Unique reach on the day.' },\n      { name: 'conversions', description: 'Total attributed actions.' },\n      {\n        name: 'conversion_value',\n        description: 'Total attributed action value (account currency).',\n      },\n    ],\n    responses: { campaign_insights: campaignInsightsSchema },\n  },\n  meta_adset_insights: {\n    shape: 'metric',\n    description:\n      'Daily adset-level Meta Ads insights - same fields as the campaign roll-up, bucketed by adset.',\n    endpoint: 'GET /{ad_account_id}/insights?level=adset&time_increment=1',\n    unit: 'spend',\n    granularity: 'day',\n    notes:\n      'Primary value is `spend`. Includes campaign_id/campaign_name so adset rows are easy to roll up to their parent campaign.',\n    dimensions: [\n      { name: 'date', description: 'Calendar day of the metric sample (UTC).' },\n      { name: 'campaignId', description: 'Parent campaign id.' },\n      { name: 'campaignName', description: 'Parent campaign name.' },\n      { name: 'adsetId', description: 'Meta adset id.' },\n      { name: 'adsetName', description: 'Meta adset name.' },\n      { name: 'impressions', description: 'Total impressions on the day.' },\n      { name: 'clicks', description: 'Total clicks on the day.' },\n      { name: 'spend', description: 'Total spend (account currency).' },\n      { name: 'reach', description: 'Unique reach on the day.' },\n      { name: 'conversions', description: 'Total attributed actions.' },\n      {\n        name: 'conversion_value',\n        description: 'Total attributed action value (account currency).',\n      },\n    ],\n    responses: { adset_insights: adsetInsightsSchema },\n  },\n  meta_ad_insights: {\n    shape: 'metric',\n    description:\n      'Daily ad-level Meta Ads insights - same fields as the adset roll-up, bucketed by ad.',\n    endpoint: 'GET /{ad_account_id}/insights?level=ad&time_increment=1',\n    unit: 'spend',\n    granularity: 'day',\n    notes:\n      'Primary value is `spend`. Cardinality is the highest of the three insights resources - opt in via `resources: [..., \"ad_insights\"]` only when you need per-ad breakdowns.',\n    dimensions: [\n      { name: 'date', description: 'Calendar day of the metric sample (UTC).' },\n      { name: 'campaignId', description: 'Parent campaign id.' },\n      { name: 'campaignName', description: 'Parent campaign name.' },\n      { name: 'adsetId', description: 'Parent adset id.' },\n      { name: 'adsetName', description: 'Parent adset name.' },\n      { name: 'adId', description: 'Meta ad id.' },\n      { name: 'adName', description: 'Meta ad name.' },\n      { name: 'impressions', description: 'Total impressions on the day.' },\n      { name: 'clicks', description: 'Total clicks on the day.' },\n      { name: 'spend', description: 'Total spend (account currency).' },\n      { name: 'reach', description: 'Unique reach on the day.' },\n      { name: 'conversions', description: 'Total attributed actions.' },\n      {\n        name: 'conversion_value',\n        description: 'Total attributed action value (account currency).',\n      },\n    ],\n    responses: { ad_insights: adInsightsSchema },\n  },\n});\n\n// ---------------------------------------------------------------------------\n// API response types\n// ---------------------------------------------------------------------------\n\nexport interface MetaActionEntry {\n  action_type?: string;\n  value?: string | number;\n}\n\nexport interface MetaCampaign {\n  id: string;\n  name?: string | null;\n  objective?: string | null;\n  status?: string | null;\n  effective_status?: string | null;\n  daily_budget?: string | number | null;\n  lifetime_budget?: string | number | null;\n  created_time?: string | null;\n  updated_time?: string | null;\n}\n\ninterface MetaInsightsBase {\n  date_start: string;\n  date_stop?: string;\n  impressions?: string | number;\n  clicks?: string | number;\n  spend?: string | number;\n  reach?: string | number;\n  actions?: MetaActionEntry[];\n  action_values?: MetaActionEntry[];\n}\n\nexport interface MetaCampaignInsight extends MetaInsightsBase {\n  campaign_id: string;\n  campaign_name?: string | null;\n}\n\nexport interface MetaAdsetInsight extends MetaCampaignInsight {\n  adset_id: string;\n  adset_name?: string | null;\n}\n\nexport interface MetaAdInsight extends MetaAdsetInsight {\n  ad_id: string;\n  ad_name?: string | null;\n}\n\ninterface MetaPagedResponse<T> {\n  data?: T[];\n  paging?: {\n    cursors?: { after?: string; before?: string };\n    next?: string;\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Row conversion helpers\n// ---------------------------------------------------------------------------\n\nexport function campaignToEntity(row: MetaCampaign): {\n  type: string;\n  id: string;\n  attributes: Record<string, string | number | null>;\n  updated_at: number;\n} {\n  const updatedAt = row.updated_time\n    ? new Date(row.updated_time).getTime()\n    : row.created_time\n      ? new Date(row.created_time).getTime()\n      : 0;\n  return {\n    type: CAMPAIGN_ENTITY_TYPE,\n    id: row.id,\n    attributes: {\n      name: row.name ?? null,\n      objective: row.objective ?? null,\n      status: row.status ?? null,\n      effectiveStatus: row.effective_status ?? null,\n      dailyBudget: parseOptionalNumber(row.daily_budget),\n      lifetimeBudget: parseOptionalNumber(row.lifetime_budget),\n      createdAt: row.created_time ? new Date(row.created_time).getTime() : null,\n    },\n    updated_at: Number.isFinite(updatedAt) ? updatedAt : 0,\n  };\n}\n\nfunction buildInsightAttributes(\n  row: MetaInsightsBase,\n): Record<string, string | number | null> {\n  const impressions = parseNumber(row.impressions);\n  const clicks = parseNumber(row.clicks);\n  const spend = parseNumber(row.spend);\n  const reach = parseNumber(row.reach);\n  const conversions = (row.actions ?? []).length\n    ? sumActionValues(row.actions)\n    : 0;\n  const conversionValue = sumActionValues(row.action_values);\n  return {\n    date: row.date_start,\n    impressions,\n    clicks,\n    spend,\n    reach,\n    conversions,\n    conversion_value: conversionValue,\n  };\n}\n\nexport function insightRowToMetricSample(\n  row: MetaCampaignInsight | MetaAdsetInsight | MetaAdInsight,\n  phase: 'campaign_insights' | 'adset_insights' | 'ad_insights',\n): {\n  name: string;\n  ts: number;\n  value: number;\n  attributes: Record<string, string | number | null>;\n} {\n  const attributes = buildInsightAttributes(row);\n  attributes['campaignId'] = row.campaign_id;\n  attributes['campaignName'] = row.campaign_name ?? null;\n  if (phase !== 'campaign_insights') {\n    const ar = row as MetaAdsetInsight;\n    attributes['adsetId'] = ar.adset_id;\n    attributes['adsetName'] = ar.adset_name ?? null;\n  }\n  if (phase === 'ad_insights') {\n    const ar = row as MetaAdInsight;\n    attributes['adId'] = ar.ad_id;\n    attributes['adName'] = ar.ad_name ?? null;\n  }\n  return {\n    name: METRIC_NAME[phase],\n    ts: metaDateToMs(row.date_start),\n    value: parseNumber(row.spend),\n    attributes,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// MetaAdsConnector\n// ---------------------------------------------------------------------------\n\nconst CAMPAIGN_FIELDS = [\n  'id',\n  'name',\n  'objective',\n  'status',\n  'effective_status',\n  'daily_budget',\n  'lifetime_budget',\n  'created_time',\n  'updated_time',\n].join(',');\n\nconst COMMON_INSIGHT_FIELDS = [\n  'date_start',\n  'date_stop',\n  'campaign_id',\n  'campaign_name',\n  'impressions',\n  'clicks',\n  'spend',\n  'reach',\n  'actions',\n  'action_values',\n];\n\nconst INSIGHT_FIELDS: Record<\n  'campaign_insights' | 'adset_insights' | 'ad_insights',\n  string\n> = {\n  campaign_insights: COMMON_INSIGHT_FIELDS.join(','),\n  adset_insights: [...COMMON_INSIGHT_FIELDS, 'adset_id', 'adset_name'].join(\n    ',',\n  ),\n  ad_insights: [\n    ...COMMON_INSIGHT_FIELDS,\n    'adset_id',\n    'adset_name',\n    'ad_id',\n    'ad_name',\n  ].join(','),\n};\n\nexport class MetaAdsConnector extends BaseConnector<\n  MetaAdsSettings,\n  MetaAdsCredentials\n> {\n  static readonly id = 'meta-ads';\n\n  static readonly resources = metaAdsResources;\n\n  static readonly schemas = schemasFromResources(metaAdsResources);\n\n  static create(input: unknown, ctx?: ConnectorContext): MetaAdsConnector {\n    const parsed = configFields.parse(input);\n    return new MetaAdsConnector(\n      {\n        adAccountId: parsed.adAccountId,\n        apiVersion: parsed.apiVersion,\n        lookbackDays: parsed.lookbackDays,\n        resources: parsed.resources,\n      },\n      { accessToken: parsed.accessToken },\n      ctx,\n    );\n  }\n\n  readonly id = 'meta-ads';\n  override readonly credentials = metaAdsCredentials;\n\n  private buildHeaders(): Record<string, string> {\n    return {\n      Authorization: `Bearer ${this.creds.accessToken}`,\n      'User-Agent': connectorUserAgent('meta-ads'),\n    };\n  }\n\n  private apiVersion(): string {\n    return this.settings.apiVersion ?? DEFAULT_API_VERSION;\n  }\n\n  private accountBase(): string {\n    return `${BASE_URL}/${this.apiVersion()}/${this.settings.adAccountId}`;\n  }\n\n  private async fetchCampaignsPage(\n    after: string | null,\n    signal: AbortSignal | undefined,\n  ): Promise<{ items: unknown[]; next: string | null }> {\n    const url = new URL(`${this.accountBase()}/campaigns`);\n    url.searchParams.set('fields', CAMPAIGN_FIELDS);\n    url.searchParams.set('limit', String(PAGE_LIMIT));\n    if (after) {\n      url.searchParams.set('after', after);\n    }\n    const res = await this.get<MetaPagedResponse<MetaCampaign>>(\n      url.toString(),\n      {\n        resource: 'campaigns',\n        headers: this.buildHeaders(),\n        signal,\n      },\n    );\n    return {\n      items: res.body.data ?? [],\n      next: res.body.paging?.cursors?.after ?? null,\n    };\n  }\n\n  private async fetchInsightsPage(\n    phase: 'campaign_insights' | 'adset_insights' | 'ad_insights',\n    dateRange: MetaDateRange,\n    after: string | null,\n    signal: AbortSignal | undefined,\n  ): Promise<{ items: unknown[]; next: string | null }> {\n    const url = new URL(`${this.accountBase()}/insights`);\n    url.searchParams.set('level', PHASE_TO_LEVEL[phase]);\n    url.searchParams.set('time_increment', '1');\n    url.searchParams.set('fields', INSIGHT_FIELDS[phase]);\n    url.searchParams.set(\n      'time_range',\n      JSON.stringify({ since: dateRange.since, until: dateRange.until }),\n    );\n    url.searchParams.set('limit', String(PAGE_LIMIT));\n    if (after) {\n      url.searchParams.set('after', after);\n    }\n    const res = await this.get<MetaPagedResponse<unknown>>(url.toString(), {\n      resource: phase,\n      headers: this.buildHeaders(),\n      signal,\n    });\n    return {\n      items: res.body.data ?? [],\n      next: res.body.paging?.cursors?.after ?? null,\n    };\n  }\n\n  private async writeCampaigns(\n    storage: StorageHandle,\n    items: MetaCampaign[],\n  ): Promise<void> {\n    for (const row of items) {\n      await storage.entity(campaignToEntity(row));\n    }\n  }\n\n  private async writeInsights(\n    storage: StorageHandle,\n    phase: 'campaign_insights' | 'adset_insights' | 'ad_insights',\n    items: Array<MetaCampaignInsight | MetaAdsetInsight | MetaAdInsight>,\n  ): Promise<void> {\n    for (const row of items) {\n      await storage.metric(insightRowToMetricSample(row, phase));\n    }\n  }\n\n  private async clearScopeOnFirstPage(\n    storage: StorageHandle,\n    phase: MetaAdsPhase,\n    isFull: boolean,\n  ): Promise<void> {\n    if (INSIGHTS_PHASES.has(phase)) {\n      // Insights are append-only with no upsert key, so every sync (full or\n      // incremental) rewrites the whole metric scope for the configured window.\n      await storage.metrics([], { names: [METRIC_NAME[phase]] });\n      return;\n    }\n    if (!isFull) {\n      return;\n    }\n    await storage.entities([], { types: [CAMPAIGN_ENTITY_TYPE] });\n  }\n\n  async sync(\n    options: SyncOptions,\n    storage: StorageHandle,\n    signal?: AbortSignal,\n  ): Promise<SyncResult> {\n    const cursor = isMetaAdsSyncCursor(options.cursor)\n      ? options.cursor\n      : undefined;\n    const isFull = options.mode === 'full';\n    const lookbackDays = this.settings.lookbackDays ?? DEFAULT_LOOKBACK_DAYS;\n    // Recompute on every tick. A resume across midnight will shift `until` by\n    // a day, which is fine: the metric scope is fully replaced each phase.\n    const dateRange = getDateRange(options, lookbackDays);\n\n    const phases = selectActivePhases<MetaAdsResource, MetaAdsPhase>(\n      (r) => r,\n      PHASE_ORDER,\n      this.settings.resources,\n    );\n\n    return paginateChunked<MetaAdsPhase, string>({\n      phases,\n      cursor,\n      signal,\n      logger: this.logger,\n      fetchPage: async (phase, page, sig) => {\n        if (phase === 'campaigns') {\n          return this.fetchCampaignsPage(page, sig);\n        }\n        return this.fetchInsightsPage(phase, dateRange, page, sig);\n      },\n      writeBatch: async (phase, items, page) => {\n        if (page === null) {\n          await this.clearScopeOnFirstPage(storage, phase, isFull);\n        }\n        if (phase === 'campaigns') {\n          await this.writeCampaigns(storage, items as MetaCampaign[]);\n          return;\n        }\n        await this.writeInsights(\n          storage,\n          phase,\n          items as Array<\n            MetaCampaignInsight | MetaAdsetInsight | MetaAdInsight\n          >,\n        );\n      },\n    });\n  }\n}\n","import { MetaAdsConnector } from './meta-ads';\n\nexport {\n  campaignToEntity,\n  configFields,\n  doc,\n  insightRowToMetricSample,\n  MetaAdsConnector,\n} from './meta-ads';\nexport type {\n  MetaAdsResource,\n  MetaAdsSettings,\n  MetaActionEntry,\n  MetaAdInsight,\n  MetaAdsetInsight,\n  MetaCampaign,\n  MetaCampaignInsight,\n} from './meta-ads';\nexport default MetaAdsConnector;\n"],"mappings":"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","names":["startMs"]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@rawdash/connector-meta-ads",
+  "version": "0.16.0",
+  "description": "Rawdash connector for Meta (Facebook + Instagram) Ads — campaigns and daily campaign/adset/ad insights",
+  "license": "Apache-2.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rawdash/rawdash.git",
+    "directory": "packages/connectors/meta-ads"
+  },
+  "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"
+  }
+}