autopilot-core-sandbox 0.0.1

package/dist/dist/migrations/20260726000000_facebook_ads_integration.sql

@@ -0,0 +1,1538 @@
+-- Facebook Ads integration schema: connection, settings, cached spend,
+-- campaign filtering, and reporting functions. All access is server-only; the
+-- companion RLS migration locks every table and function to the service role.
+
+-- Campaign ids arrive from Meta as decimal strings. Normalized means a
+-- one-dimensional array of distinct, sorted, digit-only values, which lets the
+-- selection-change comparison in set_facebook_ads_campaign_selection detect
+-- no-op updates without invalidating the spend cache.
+create or replace function "public"."facebook_ads_campaign_ids_are_normalized"(
+    "p_campaign_ids" "text"[]
+)
+returns boolean
+language sql
+immutable
+parallel safe
+set search_path = ''
+as $$
+    select case
+        when cardinality("p_campaign_ids") = 0 then true
+        when coalesce(array_ndims("p_campaign_ids"), 0) <> 1 then false
+        when exists (
+            select 1
+            from unnest("p_campaign_ids") as "campaign_id"("value")
+            where "campaign_id"."value" is null
+               or "campaign_id"."value" !~ '^[0-9]+$'
+        ) then false
+        else "p_campaign_ids" = array(
+            select distinct "campaign_id"."value"
+            from unnest("p_campaign_ids") as "campaign_id"("value")
+            order by "campaign_id"."value"
+        )
+    end;
+$$;
+
+alter function "public"."facebook_ads_campaign_ids_are_normalized"("text"[])
+owner to "postgres";
+
+-- OAuth authorization is persisted before the customer selects an ad account,
+-- so the token and app-scoped Meta user id are required while token expiry and
+-- selected-account metadata remain nullable during that staged connection.
+-- Campaign filtering tracks either every campaign or an explicit normalized
+-- id selection; the spend configuration version increments whenever the
+-- account or campaign selection changes so in-flight syncs for a previous
+-- configuration become ineligible to write cached spend.
+create table if not exists "public"."facebook_ads_connection" (
+    "id" "uuid" default "gen_random_uuid"() not null,
+    "created_at" timestamp with time zone default "now"() not null,
+    "updated_at" timestamp with time zone default "now"() not null,
+    "company_id" "uuid" not null,
+    "meta_user_id" "text" not null,
+    "access_token" "text" not null,
+    "token_expires_at" timestamp with time zone,
+    "ad_account_id" "text",
+    "ad_account_name" "text",
+    "ad_account_status" integer,
+    "currency" "text",
+    "timezone_name" "text",
+    "timezone_offset_hours_utc" numeric(5, 2),
+    "campaign_selection_mode" "text" default 'all'::"text" not null,
+    "selected_campaign_ids" "text"[] default '{}'::"text"[] not null,
+    "spend_configuration_version" bigint default 0 not null,
+    "last_synced_at" timestamp with time zone,
+    "backfill_completed_at" timestamp with time zone,
+    "campaign_breakdown_backfill_completed_at" timestamp with time zone,
+    "last_sync_error" "text",
+    constraint "facebook_ads_connection_pkey" primary key ("id"),
+    constraint "facebook_ads_connection_company_id_key" unique ("company_id"),
+    constraint "facebook_ads_connection_company_id_id_key" unique ("company_id", "id"),
+    constraint "facebook_ads_connection_company_id_fkey"
+        foreign key ("company_id") references "public"."company"("id") on delete cascade,
+    constraint "facebook_ads_connection_timezone_offset_check"
+        check ("timezone_offset_hours_utc" between -24 and 24),
+    constraint "facebook_ads_connection_campaign_selection_mode_check"
+        check ("campaign_selection_mode" in ('all', 'selected')),
+    constraint "facebook_ads_connection_selected_campaign_ids_no_nulls_check"
+        check (array_position("selected_campaign_ids", null::"text") is null),
+    constraint "facebook_ads_connection_selected_campaign_ids_format_check"
+        check (
+            "public"."facebook_ads_campaign_ids_are_normalized"(
+                "selected_campaign_ids"
+            )
+        ),
+    constraint "facebook_ads_connection_campaign_selection_consistency_check"
+        check (
+            (
+                "campaign_selection_mode" = 'all'
+                and cardinality("selected_campaign_ids") = 0
+            )
+            or (
+                "campaign_selection_mode" = 'selected'
+                and cardinality("selected_campaign_ids") > 0
+            )
+        ),
+    constraint "facebook_ads_connection_spend_configuration_version_check"
+        check ("spend_configuration_version" >= 0)
+);
+
+alter table "public"."facebook_ads_connection" owner to "postgres";
+
+-- The selected Autopilot job source is configuration, not Meta-derived data,
+-- so it is kept separately from the connection and cached spend rows.
+create table if not exists "public"."settings_facebook_ads" (
+    "id" "uuid" default "gen_random_uuid"() not null,
+    "created_at" timestamp with time zone default "now"() not null,
+    "updated_at" timestamp with time zone default "now"() not null,
+    "company_id" "uuid" not null,
+    "source_id" "uuid",
+    "source_names" "text"[] default '{}'::"text"[] not null,
+    constraint "settings_facebook_ads_pkey" primary key ("id"),
+    constraint "settings_facebook_ads_company_id_key" unique ("company_id"),
+    constraint "settings_facebook_ads_company_id_fkey"
+        foreign key ("company_id") references "public"."company"("id") on delete cascade,
+    constraint "settings_facebook_ads_source_id_fkey"
+        foreign key ("source_id") references "public"."job_source"("id") on delete set null,
+    constraint "settings_facebook_ads_source_names_no_nulls_check"
+        check (array_position("source_names", null::"text") is null),
+    constraint "settings_facebook_ads_source_names_no_empty_check"
+        check (array_position("source_names", ''::"text") is null)
+);
+
+alter table "public"."settings_facebook_ads" owner to "postgres";
+
+-- Account-level daily spend powers the summary cards. The composite foreign
+-- key prevents a spend row from being assigned to a connection owned by a
+-- different company.
+create table if not exists "public"."facebook_ads_daily_spend" (
+    "id" "uuid" default "gen_random_uuid"() not null,
+    "created_at" timestamp with time zone default "now"() not null,
+    "updated_at" timestamp with time zone default "now"() not null,
+    "company_id" "uuid" not null,
+    "connection_id" "uuid" not null,
+    "date" date not null,
+    "spend" numeric(18, 6) not null,
+    "currency" "text" not null,
+    constraint "facebook_ads_daily_spend_pkey" primary key ("id"),
+    constraint "facebook_ads_daily_spend_connection_date_key"
+        unique ("connection_id", "date"),
+    constraint "facebook_ads_daily_spend_company_connection_fkey"
+        foreign key ("company_id", "connection_id")
+        references "public"."facebook_ads_connection"("company_id", "id")
+        on delete cascade,
+    constraint "facebook_ads_daily_spend_nonnegative_check" check ("spend" >= 0)
+);
+
+alter table "public"."facebook_ads_daily_spend" owner to "postgres";
+
+create index if not exists "facebook_ads_daily_spend_company_date_idx"
+    on "public"."facebook_ads_daily_spend" using "btree" ("company_id", "date");
+
+-- Campaign-level daily spend preserves the Meta campaign rows that the
+-- account-level cache collapses into daily totals, powering the report's
+-- campaign breakdown.
+create table if not exists "public"."facebook_ads_campaign_daily_spend" (
+    "id" "uuid" default "gen_random_uuid"() not null,
+    "created_at" timestamp with time zone default "now"() not null,
+    "updated_at" timestamp with time zone default "now"() not null,
+    "company_id" "uuid" not null,
+    "connection_id" "uuid" not null,
+    "campaign_id" "text" not null,
+    "campaign_name" "text" not null,
+    "date" date not null,
+    "spend" numeric(18, 6) not null,
+    "currency" "text" not null,
+    constraint "facebook_ads_campaign_daily_spend_pkey" primary key ("id"),
+    constraint "facebook_ads_campaign_daily_spend_connection_campaign_date_key"
+        unique ("connection_id", "campaign_id", "date"),
+    constraint "facebook_ads_campaign_daily_spend_company_connection_fkey"
+        foreign key ("company_id", "connection_id")
+        references "public"."facebook_ads_connection"("company_id", "id")
+        on delete cascade,
+    constraint "facebook_ads_campaign_daily_spend_campaign_id_check"
+        check ("campaign_id" ~ '^[0-9]+$'),
+    constraint "facebook_ads_campaign_daily_spend_campaign_name_check"
+        check (nullif(btrim("campaign_name"), '') is not null),
+    constraint "facebook_ads_campaign_daily_spend_currency_check"
+        check ("currency" ~ '^[A-Z]{3}$'),
+    constraint "facebook_ads_campaign_daily_spend_nonnegative_check"
+        check ("spend" >= 0)
+);
+
+alter table "public"."facebook_ads_campaign_daily_spend" owner to "postgres";
+
+create index if not exists "facebook_ads_campaign_daily_spend_company_date_idx"
+    on "public"."facebook_ads_campaign_daily_spend" (
+        "company_id",
+        "date"
+    );
+
+create index if not exists "facebook_ads_campaign_daily_spend_connection_campaign_idx"
+    on "public"."facebook_ads_campaign_daily_spend" (
+        "connection_id",
+        "campaign_id"
+    );
+
+-- Selecting an account and invalidating data from the previous account must
+-- be one transaction. This prevents a concurrent sync from repopulating stale
+-- rows after an account switch or clear operation. Selecting another ad
+-- account also resets campaign selection to its safe default; incrementing
+-- the version makes every sync started for the previous account or campaign
+-- selection ineligible to write cached spend.
+create or replace function "public"."set_facebook_ads_selected_account"(
+    "p_company_id" "uuid",
+    "p_ad_account_id" "text",
+    "p_ad_account_name" "text",
+    "p_ad_account_status" integer,
+    "p_currency" "text",
+    "p_timezone_name" "text",
+    "p_timezone_offset_hours_utc" numeric
+)
+returns boolean
+language plpgsql
+security definer
+set search_path = ''
+as $$
+declare
+    "v_connection_id" "uuid";
+    "v_previous_ad_account_id" "text";
+    "v_account_changed" boolean;
+begin
+    if "p_company_id" is null then
+        raise exception 'company_id is required' using errcode = '22023';
+    end if;
+
+    if "p_ad_account_id" is null then
+        if "p_ad_account_name" is not null
+            or "p_ad_account_status" is not null
+            or "p_currency" is not null
+            or "p_timezone_name" is not null
+            or "p_timezone_offset_hours_utc" is not null
+        then
+            raise exception 'account metadata must be null when clearing an account'
+                using errcode = '22023';
+        end if;
+    elsif nullif(btrim("p_ad_account_id"), '') is null
+        or nullif(btrim("p_ad_account_name"), '') is null
+        or "p_ad_account_status" is null
+        or coalesce("p_currency", '') !~ '^[A-Z]{3}$'
+        or nullif(btrim("p_timezone_name"), '') is null
+        or "p_timezone_offset_hours_utc" is null
+        or "p_timezone_offset_hours_utc" not between -24 and 24
+    then
+        raise exception 'complete account metadata is required when selecting an account'
+            using errcode = '22023';
+    end if;
+
+    select "id", "ad_account_id"
+    into "v_connection_id", "v_previous_ad_account_id"
+    from "public"."facebook_ads_connection"
+    where "company_id" = "p_company_id"
+    for update;
+
+    if not found then
+        raise exception 'Facebook Ads connection does not exist'
+            using errcode = '23503';
+    end if;
+
+    "v_account_changed" :=
+        "v_previous_ad_account_id" is distinct from "p_ad_account_id";
+
+    update "public"."facebook_ads_connection"
+    set
+        "ad_account_id" = "p_ad_account_id",
+        "ad_account_name" = "p_ad_account_name",
+        "ad_account_status" = "p_ad_account_status",
+        "currency" = "p_currency",
+        "timezone_name" = "p_timezone_name",
+        "timezone_offset_hours_utc" = "p_timezone_offset_hours_utc",
+        "campaign_selection_mode" = case
+            when "v_account_changed" or "p_ad_account_id" is null then 'all'
+            else "campaign_selection_mode"
+        end,
+        "selected_campaign_ids" = case
+            when "v_account_changed" or "p_ad_account_id" is null then
+                '{}'::"text"[]
+            else "selected_campaign_ids"
+        end,
+        "spend_configuration_version" = case
+            when "v_account_changed" then "spend_configuration_version" + 1
+            else "spend_configuration_version"
+        end,
+        "last_synced_at" = case
+            when "v_account_changed" then null
+            else "last_synced_at"
+        end,
+        "backfill_completed_at" = case
+            when "v_account_changed" or "p_ad_account_id" is null then null
+            else "backfill_completed_at"
+        end,
+        "last_sync_error" = null
+    where "id" = "v_connection_id";
+
+    if "v_account_changed" or "p_ad_account_id" is null then
+        delete from "public"."facebook_ads_daily_spend"
+        where "connection_id" = "v_connection_id";
+    end if;
+
+    return "v_account_changed";
+end;
+$$;
+
+alter function "public"."set_facebook_ads_selected_account"(
+    "uuid",
+    "text",
+    "text",
+    integer,
+    "text",
+    "text",
+    numeric
+) owner to "postgres";
+
+-- Normalize ids before comparing them so selecting the same campaigns in a
+-- different order does not invalidate and re-fetch the spend cache.
+create or replace function "public"."set_facebook_ads_campaign_selection"(
+    "p_company_id" "uuid",
+    "p_ad_account_id" "text",
+    "p_campaign_selection_mode" "text",
+    "p_selected_campaign_ids" "text"[]
+)
+returns boolean
+language plpgsql
+security invoker
+set search_path = ''
+as $$
+declare
+    "v_campaign_selection_mode" "text";
+    "v_connection_id" "uuid";
+    "v_current_campaign_selection_mode" "text";
+    "v_current_selected_campaign_ids" "text"[];
+    "v_normalized_campaign_ids" "text"[];
+    "v_selection_changed" boolean;
+begin
+    if "p_company_id" is null
+        or nullif(btrim("p_ad_account_id"), '') is null
+        or nullif(btrim("p_campaign_selection_mode"), '') is null
+    then
+        raise exception 'company_id, ad_account_id, and campaign selection mode are required'
+            using errcode = '22023';
+    end if;
+
+    "v_campaign_selection_mode" := lower(btrim("p_campaign_selection_mode"));
+    if "v_campaign_selection_mode" not in ('all', 'selected') then
+        raise exception 'campaign selection mode must be all or selected'
+            using errcode = '22023';
+    end if;
+
+    if "v_campaign_selection_mode" = 'all' then
+        "v_normalized_campaign_ids" := '{}'::"text"[];
+    else
+        if exists (
+            select 1
+            from unnest(
+                coalesce("p_selected_campaign_ids", '{}'::"text"[])
+            ) as "campaign_id"("value")
+            where "campaign_id"."value" is null
+               or btrim("campaign_id"."value") !~ '^[0-9]+$'
+        ) then
+            raise exception 'selected campaign ids must contain only Meta campaign ids'
+                using errcode = '22023';
+        end if;
+
+        select coalesce(
+            array_agg("normalized_campaign_id"."value"
+                order by "normalized_campaign_id"."value"),
+            '{}'::"text"[]
+        )
+        into "v_normalized_campaign_ids"
+        from (
+            select distinct btrim("campaign_id"."value") as "value"
+            from unnest(
+                coalesce("p_selected_campaign_ids", '{}'::"text"[])
+            ) as "campaign_id"("value")
+        ) as "normalized_campaign_id";
+
+        if cardinality("v_normalized_campaign_ids") = 0 then
+            raise exception 'select at least one Facebook Ads campaign'
+                using errcode = '22023';
+        end if;
+    end if;
+
+    select
+        "id",
+        "campaign_selection_mode",
+        "selected_campaign_ids"
+    into
+        "v_connection_id",
+        "v_current_campaign_selection_mode",
+        "v_current_selected_campaign_ids"
+    from "public"."facebook_ads_connection"
+    where "company_id" = "p_company_id"
+      and "ad_account_id" = btrim("p_ad_account_id")
+    for update;
+
+    if not found then
+        raise exception 'Facebook Ads account selection changed'
+            using errcode = '23503';
+    end if;
+
+    "v_selection_changed" :=
+        "v_current_campaign_selection_mode"
+            is distinct from "v_campaign_selection_mode"
+        or "v_current_selected_campaign_ids"
+            is distinct from "v_normalized_campaign_ids";
+
+    if not "v_selection_changed" then
+        return false;
+    end if;
+
+    update "public"."facebook_ads_connection"
+    set
+        "campaign_selection_mode" = "v_campaign_selection_mode",
+        "selected_campaign_ids" = "v_normalized_campaign_ids",
+        "spend_configuration_version" = "spend_configuration_version" + 1,
+        "last_synced_at" = null,
+        "backfill_completed_at" = null,
+        "last_sync_error" = null
+    where "id" = "v_connection_id";
+
+    delete from "public"."facebook_ads_daily_spend"
+    where "connection_id" = "v_connection_id";
+
+    return true;
+end;
+$$;
+
+alter function "public"."set_facebook_ads_campaign_selection"(
+    "uuid",
+    "text",
+    "text",
+    "text"[]
+) owner to "postgres";
+
+-- Meta returns spend as a decimal string. Keeping it as text through the API
+-- boundary avoids JavaScript floating-point conversion before PostgreSQL casts
+-- it to the exact numeric column type. A sync captures the spend configuration
+-- version before calling Meta; if the account or campaign selection changes
+-- while that request is running, the stale response returns zero and cannot
+-- repopulate rows deleted by the selection transaction.
+create or replace function "public"."upsert_facebook_ads_daily_spend"(
+    "p_company_id" "uuid",
+    "p_connection_id" "uuid",
+    "p_ad_account_id" "text",
+    "p_spend_configuration_version" bigint,
+    "p_currency" "text",
+    "p_rows" jsonb
+)
+returns integer
+language plpgsql
+set search_path = ''
+as $$
+declare
+    "v_row" jsonb;
+    "v_rows_upserted" integer;
+begin
+    if "p_company_id" is null
+        or "p_connection_id" is null
+        or nullif("p_ad_account_id", '') is null
+        or "p_spend_configuration_version" is null
+        or "p_spend_configuration_version" < 0
+    then
+        raise exception 'company_id, connection_id, ad_account_id, and spend configuration version are required'
+            using errcode = '22023';
+    end if;
+
+    if coalesce("p_currency", '') !~ '^[A-Z]{3}$' then
+        raise exception 'currency must be a three-letter uppercase code'
+            using errcode = '22023';
+    end if;
+
+    if "p_rows" is null or jsonb_typeof("p_rows") <> 'array' then
+        raise exception 'rows must be a JSON array'
+            using errcode = '22023';
+    end if;
+
+    perform 1
+    from "public"."facebook_ads_connection"
+    where "company_id" = "p_company_id"
+      and "id" = "p_connection_id"
+      and "ad_account_id" = "p_ad_account_id"
+      and "spend_configuration_version" = "p_spend_configuration_version"
+    for update;
+
+    if not found then
+        return 0;
+    end if;
+
+    for "v_row" in
+        select "row_value"
+        from jsonb_array_elements("p_rows") as "input"("row_value")
+    loop
+        if jsonb_typeof("v_row") <> 'object'
+            or coalesce(jsonb_typeof("v_row" -> 'date'), '') <> 'string'
+            or coalesce("v_row" ->> 'date', '') !~ '^[0-9]{4}-[0-9]{2}-[0-9]{2}$'
+            or coalesce(jsonb_typeof("v_row" -> 'spend'), '') <> 'string'
+            or coalesce("v_row" ->> 'spend', '') !~ '^[0-9]{1,12}([.][0-9]{1,6})?$'
+        then
+            raise exception 'each spend row must contain a valid date and decimal-string spend'
+                using errcode = '22023';
+        end if;
+
+        -- Force date validation before the insert so impossible calendar dates
+        -- fail the entire atomic batch.
+        perform ("v_row" ->> 'date')::date;
+    end loop;
+
+    insert into "public"."facebook_ads_daily_spend" (
+        "company_id",
+        "connection_id",
+        "date",
+        "spend",
+        "currency"
+    )
+    select
+        "p_company_id",
+        "p_connection_id",
+        ("row_value" ->> 'date')::date,
+        ("row_value" ->> 'spend')::numeric(18, 6),
+        "p_currency"
+    from jsonb_array_elements("p_rows") as "input"("row_value")
+    on conflict ("connection_id", "date") do update
+    set
+        "company_id" = excluded."company_id",
+        "spend" = excluded."spend",
+        "currency" = excluded."currency";
+
+    get diagnostics "v_rows_upserted" = row_count;
+    return "v_rows_upserted";
+end;
+$$;
+
+alter function "public"."upsert_facebook_ads_daily_spend"(
+    "uuid",
+    "uuid",
+    "text",
+    bigint,
+    "text",
+    jsonb
+) owner to "postgres";
+
+-- Replace one synchronized date window atomically. Campaign rows are retained
+-- for the breakdown while account-level zero-filled daily totals continue to
+-- power the existing summary report.
+create or replace function "public"."replace_facebook_ads_campaign_daily_spend"(
+    "p_company_id" "uuid",
+    "p_connection_id" "uuid",
+    "p_ad_account_id" "text",
+    "p_spend_configuration_version" bigint,
+    "p_currency" "text",
+    "p_date_from" date,
+    "p_date_to" date,
+    "p_rows" jsonb
+)
+returns boolean
+language plpgsql
+set search_path = ''
+as $$
+declare
+    "v_row" jsonb;
+begin
+    if "p_company_id" is null
+        or "p_connection_id" is null
+        or nullif(btrim("p_ad_account_id"), '') is null
+        or "p_spend_configuration_version" is null
+        or "p_spend_configuration_version" < 0
+        or "p_date_from" is null
+        or "p_date_to" is null
+        or "p_date_from" > "p_date_to"
+    then
+        raise exception 'valid connection and date range are required'
+            using errcode = '22023';
+    end if;
+
+    if "p_date_to" - "p_date_from" > 89 then
+        raise exception 'campaign spend windows cannot exceed 90 days'
+            using errcode = '22023';
+    end if;
+
+    if coalesce("p_currency", '') !~ '^[A-Z]{3}$' then
+        raise exception 'currency must be a three-letter uppercase code'
+            using errcode = '22023';
+    end if;
+
+    if "p_rows" is null or jsonb_typeof("p_rows") <> 'array' then
+        raise exception 'rows must be a JSON array' using errcode = '22023';
+    end if;
+
+    perform 1
+    from "public"."facebook_ads_connection"
+    where "company_id" = "p_company_id"
+      and "id" = "p_connection_id"
+      and "ad_account_id" = "p_ad_account_id"
+      and "spend_configuration_version" = "p_spend_configuration_version"
+    for update;
+
+    if not found then
+        return false;
+    end if;
+
+    for "v_row" in
+        select "row_value"
+        from jsonb_array_elements("p_rows") as "input"("row_value")
+    loop
+        if jsonb_typeof("v_row") <> 'object'
+            or coalesce(jsonb_typeof("v_row" -> 'campaign_id'), '') <> 'string'
+            or coalesce("v_row" ->> 'campaign_id', '') !~ '^[0-9]+$'
+            or coalesce(jsonb_typeof("v_row" -> 'campaign_name'), '') <> 'string'
+            or nullif(btrim("v_row" ->> 'campaign_name'), '') is null
+            or coalesce(jsonb_typeof("v_row" -> 'date'), '') <> 'string'
+            or coalesce("v_row" ->> 'date', '') !~ '^[0-9]{4}-[0-9]{2}-[0-9]{2}$'
+            or coalesce(jsonb_typeof("v_row" -> 'spend'), '') <> 'string'
+            or coalesce("v_row" ->> 'spend', '')
+                !~ '^[0-9]{1,12}([.][0-9]{1,6})?$'
+        then
+            raise exception 'each row must contain a valid campaign, date, and spend'
+                using errcode = '22023';
+        end if;
+
+        if ("v_row" ->> 'date')::date
+            not between "p_date_from" and "p_date_to"
+        then
+            raise exception 'campaign spend row is outside the requested range'
+                using errcode = '22023';
+        end if;
+    end loop;
+
+    if exists (
+        select 1
+        from jsonb_array_elements("p_rows") as "input"("row_value")
+        group by
+            "row_value" ->> 'campaign_id',
+            "row_value" ->> 'date'
+        having count(*) > 1
+    ) then
+        raise exception 'campaign spend rows must be unique by campaign and date'
+            using errcode = '22023';
+    end if;
+
+    delete from "public"."facebook_ads_campaign_daily_spend"
+    where "connection_id" = "p_connection_id"
+      and "date" between "p_date_from" and "p_date_to";
+
+    insert into "public"."facebook_ads_campaign_daily_spend" (
+        "company_id",
+        "connection_id",
+        "campaign_id",
+        "campaign_name",
+        "date",
+        "spend",
+        "currency"
+    )
+    select
+        "p_company_id",
+        "p_connection_id",
+        "row_value" ->> 'campaign_id',
+        btrim("row_value" ->> 'campaign_name'),
+        ("row_value" ->> 'date')::date,
+        ("row_value" ->> 'spend')::numeric(18, 6),
+        "p_currency"
+    from jsonb_array_elements("p_rows") as "input"("row_value");
+
+    insert into "public"."facebook_ads_daily_spend" (
+        "company_id",
+        "connection_id",
+        "date",
+        "spend",
+        "currency"
+    )
+    select
+        "p_company_id",
+        "p_connection_id",
+        "date_row"."value"::date,
+        coalesce(sum("campaign_spend"."spend"), 0::numeric),
+        "p_currency"
+    from generate_series(
+        "p_date_from"::timestamp without time zone,
+        "p_date_to"::timestamp without time zone,
+        interval '1 day'
+    ) as "date_row"("value")
+    left join "public"."facebook_ads_campaign_daily_spend" as "campaign_spend"
+      on "campaign_spend"."connection_id" = "p_connection_id"
+     and "campaign_spend"."date" = "date_row"."value"::date
+    group by "date_row"."value"
+    on conflict ("connection_id", "date") do update
+    set
+        "company_id" = excluded."company_id",
+        "spend" = excluded."spend",
+        "currency" = excluded."currency";
+
+    return true;
+end;
+$$;
+
+alter function "public"."replace_facebook_ads_campaign_daily_spend"(
+    "uuid",
+    "uuid",
+    "text",
+    bigint,
+    "text",
+    date,
+    date,
+    jsonb
+) owner to "postgres";
+
+-- Save the selected lead source and its initial attribution name together.
+-- Historical names are reset when the selected source changes so one source
+-- can never inherit aliases belonging to another source.
+create or replace function "public"."set_facebook_ads_source"(
+    "p_company_id" "uuid",
+    "p_source_id" "uuid"
+)
+returns void
+language plpgsql
+security definer
+set search_path = ''
+as $$
+declare
+    "v_source_name" "text";
+begin
+    if "p_company_id" is null then
+        raise exception 'company_id is required' using errcode = '22023';
+    end if;
+
+    perform pg_advisory_xact_lock(
+        hashtextextended("p_company_id"::text || ':facebook-source-name', 0)
+    );
+
+    if "p_source_id" is null then
+        insert into "public"."settings_facebook_ads" (
+            "company_id",
+            "source_id",
+            "source_names"
+        )
+        values ("p_company_id", null, '{}'::"text"[])
+        on conflict ("company_id") do update
+        set
+            "source_id" = null,
+            "source_names" = '{}'::"text"[];
+        return;
+    end if;
+
+    select "name"
+    into "v_source_name"
+    from "public"."job_source"
+    where "company_id" = "p_company_id"
+      and "id" = "p_source_id";
+
+    if not found then
+        raise exception 'Lead source does not belong to this company'
+            using errcode = '23503';
+    end if;
+
+    if nullif(btrim("v_source_name"), '') is null then
+        raise exception 'Lead source name cannot be blank'
+            using errcode = '22023';
+    end if;
+
+    if exists (
+        select 1
+        from "public"."job_source" as "other_source"
+        where "other_source"."company_id" = "p_company_id"
+          and "other_source"."id" <> "p_source_id"
+          and "other_source"."name" = "v_source_name"
+    ) then
+        raise exception 'Lead source name is not unique within this company'
+            using
+                errcode = '23505',
+                constraint = 'facebook_ads_source_name_unambiguous';
+    end if;
+
+    insert into "public"."settings_facebook_ads" (
+        "company_id",
+        "source_id",
+        "source_names"
+    )
+    values ("p_company_id", "p_source_id", array["v_source_name"])
+    on conflict ("company_id") do update
+    set
+        "source_id" = excluded."source_id",
+        "source_names" = case
+            when "settings_facebook_ads"."source_id" = excluded."source_id" then
+                array(
+                    select distinct "candidate"."value"
+                    from unnest(
+                        "settings_facebook_ads"."source_names"
+                        || excluded."source_names"
+                    ) as "candidate"("value")
+                    where nullif(btrim("candidate"."value"), '') is not null
+                    order by "candidate"."value"
+                )
+            else excluded."source_names"
+        end;
+end;
+$$;
+
+alter function "public"."set_facebook_ads_source"("uuid", "uuid")
+owner to "postgres";
+
+-- Supabase's generated TypeScript types cannot represent nullable RPC
+-- arguments. Expose explicit clear operations so callers remain fully typed
+-- while the existing transactional account and lead-source logic is reused.
+create or replace function "public"."clear_facebook_ads_selected_account"(
+    "p_company_id" "uuid"
+)
+returns boolean
+language plpgsql
+security definer
+set search_path = ''
+as $$
+begin
+    return "public"."set_facebook_ads_selected_account"(
+        "p_company_id",
+        null,
+        null,
+        null,
+        null,
+        null,
+        null
+    );
+end;
+$$;
+
+alter function "public"."clear_facebook_ads_selected_account"("uuid")
+owner to "postgres";
+
+create or replace function "public"."clear_facebook_ads_source"(
+    "p_company_id" "uuid"
+)
+returns void
+language plpgsql
+security definer
+set search_path = ''
+as $$
+begin
+    perform "public"."set_facebook_ads_source"(
+        "p_company_id",
+        null
+    );
+end;
+$$;
+
+alter function "public"."clear_facebook_ads_source"("uuid")
+owner to "postgres";
+
+-- Protect historical source-name attribution at mutation time. The advisory
+-- lock matches the selector RPC so source selection and source creation or
+-- renaming cannot race one another.
+create or replace function "public"."prevent_facebook_ads_source_name_collision"()
+returns trigger
+language plpgsql
+security definer
+set search_path = ''
+as $$
+declare
+    "v_selected_source_id" "uuid";
+    "v_selected_source_names" "text"[];
+    "v_selected_current_name" "text";
+begin
+    perform pg_advisory_xact_lock(
+        hashtextextended(new."company_id"::text || ':facebook-source-name', 0)
+    );
+
+    select
+        "settings"."source_id",
+        "settings"."source_names",
+        "selected_source"."name"
+    into
+        "v_selected_source_id",
+        "v_selected_source_names",
+        "v_selected_current_name"
+    from "public"."settings_facebook_ads" as "settings"
+    left join "public"."job_source" as "selected_source"
+      on "selected_source"."company_id" = "settings"."company_id"
+     and "selected_source"."id" = "settings"."source_id"
+    where "settings"."company_id" = new."company_id";
+
+    if "v_selected_source_id" is null then
+        return new;
+    end if;
+
+    "v_selected_source_names" :=
+        coalesce("v_selected_source_names", '{}'::"text"[])
+        || array["v_selected_current_name"];
+
+    if new."id" = "v_selected_source_id" then
+        if nullif(btrim(new."name"), '') is null then
+            raise exception 'Selected Facebook Ads lead source name cannot be blank'
+                using errcode = '22023';
+        end if;
+
+        if exists (
+            select 1
+            from "public"."job_source" as "other_source"
+            where "other_source"."company_id" = new."company_id"
+              and "other_source"."id" <> new."id"
+              and "other_source"."name" = new."name"
+        ) then
+            raise exception 'Lead source name conflicts with Facebook Ads attribution'
+                using
+                    errcode = '23505',
+                    constraint = 'facebook_ads_source_name_unambiguous';
+        end if;
+    elsif new."name" = any("v_selected_source_names") then
+        raise exception 'Lead source name conflicts with Facebook Ads attribution'
+            using
+                errcode = '23505',
+                constraint = 'facebook_ads_source_name_unambiguous';
+    end if;
+
+    return new;
+end;
+$$;
+
+alter function "public"."prevent_facebook_ads_source_name_collision"()
+owner to "postgres";
+
+create or replace trigger "prevent_facebook_ads_source_name_collision_trigger"
+before insert or update of "name" on "public"."job_source"
+for each row
+execute function "public"."prevent_facebook_ads_source_name_collision"();
+
+-- Preserve exact historical names for the currently selected source. Jobs
+-- store the source name rather than source id, so this keeps older jobs
+-- attributable after a source rename.
+create or replace function "public"."append_facebook_ads_source_name_on_rename"()
+returns trigger
+language plpgsql
+security definer
+set search_path = ''
+as $$
+begin
+    update "public"."settings_facebook_ads" as "settings"
+    set "source_names" = array(
+        select distinct "candidate"."value"
+        from unnest(
+            coalesce("settings"."source_names", '{}'::"text"[])
+            || array[old."name", new."name"]
+        ) as "candidate"("value")
+        where nullif(btrim("candidate"."value"), '') is not null
+        order by "candidate"."value"
+    )
+    where "settings"."company_id" = new."company_id"
+      and "settings"."source_id" = new."id";
+
+    return new;
+end;
+$$;
+
+alter function "public"."append_facebook_ads_source_name_on_rename"()
+owner to "postgres";
+
+create or replace trigger "append_facebook_ads_source_name_on_rename_trigger"
+after update of "name" on "public"."job_source"
+for each row
+when (old."name" is distinct from new."name")
+execute function "public"."append_facebook_ads_source_name_on_rename"();
+
+-- Build all dashboard aggregates in PostgreSQL. This avoids PostgREST row
+-- limits and guarantees each job is counted once by its earliest non-canceled
+-- schedule in the company's local calendar range.
+create or replace function "public"."get_facebook_ads_report"(
+    "p_company_id" "uuid",
+    "p_date_from" date,
+    "p_date_to" date
+)
+returns table(
+    "currency" "text",
+    "total_ad_spend" numeric,
+    "total_sales" numeric,
+    "client_count" bigint,
+    "source_attribution_ambiguous" boolean
+)
+language plpgsql
+stable
+security definer
+set search_path = ''
+as $$
+declare
+    "v_timezone_name" "text";
+    "v_date_from_utc" timestamp with time zone;
+    "v_date_to_utc" timestamp with time zone;
+    "v_source_id" "uuid";
+    "v_source_names" "text"[];
+    "v_current_source_name" "text";
+    "v_attribution_names" "text"[];
+begin
+    if "p_company_id" is null
+        or "p_date_from" is null
+        or "p_date_to" is null
+        or "p_date_from" > "p_date_to"
+    then
+        raise exception 'company_id and a valid date range are required'
+            using errcode = '22023';
+    end if;
+
+    select coalesce(nullif("company_row"."time_zone", ''), 'America/Chicago')
+    into "v_timezone_name"
+    from "public"."company" as "company_row"
+    where "company_row"."id" = "p_company_id";
+
+    if not found then
+        raise exception 'Company does not exist' using errcode = '23503';
+    end if;
+
+    "v_date_from_utc" := timezone(
+        "v_timezone_name",
+        "p_date_from"::timestamp without time zone
+    );
+    "v_date_to_utc" := timezone(
+        "v_timezone_name",
+        ("p_date_to" + 1)::timestamp without time zone
+    );
+
+    select "connection"."currency"
+    into "currency"
+    from "public"."facebook_ads_connection" as "connection"
+    where "connection"."company_id" = "p_company_id"
+      and "connection"."ad_account_id" is not null
+      and "connection"."backfill_completed_at" is not null
+      and upper("connection"."currency") = 'USD';
+
+    if not found then
+        raise exception 'Facebook Ads connection is not report-ready'
+            using errcode = '55000';
+    end if;
+
+    select coalesce(sum("daily_spend"."spend"), 0::numeric)
+    into "total_ad_spend"
+    from "public"."facebook_ads_daily_spend" as "daily_spend"
+    where "daily_spend"."company_id" = "p_company_id"
+      and "daily_spend"."date" between "p_date_from" and "p_date_to";
+
+    "total_sales" := 0::numeric;
+    "client_count" := 0::bigint;
+    "source_attribution_ambiguous" := false;
+
+    select
+        "settings"."source_id",
+        "settings"."source_names",
+        "source"."name"
+    into
+        "v_source_id",
+        "v_source_names",
+        "v_current_source_name"
+    from "public"."settings_facebook_ads" as "settings"
+    left join "public"."job_source" as "source"
+      on "source"."company_id" = "settings"."company_id"
+     and "source"."id" = "settings"."source_id"
+    where "settings"."company_id" = "p_company_id";
+
+    if "v_source_id" is null then
+        return next;
+        return;
+    end if;
+
+    select coalesce(array_agg("alias_row"."name" order by "alias_row"."name"), '{}'::"text"[])
+    into "v_attribution_names"
+    from (
+        select distinct "candidate"."value" as "name"
+        from unnest(
+            coalesce("v_source_names", '{}'::"text"[])
+            || array["v_current_source_name"]
+        ) as "candidate"("value")
+        where nullif(btrim("candidate"."value"), '') is not null
+    ) as "alias_row";
+
+    if cardinality("v_attribution_names") = 0 then
+        return next;
+        return;
+    end if;
+
+    select exists (
+        select 1
+        from "public"."job_source" as "other_source"
+        where "other_source"."company_id" = "p_company_id"
+          and "other_source"."id" <> "v_source_id"
+          and "other_source"."name" = any("v_attribution_names")
+    )
+    into "source_attribution_ambiguous";
+
+    if "source_attribution_ambiguous" then
+        return next;
+        return;
+    end if;
+
+    with "earliest_schedule" as (
+        select
+            "schedule"."job_id",
+            min("schedule"."start_time") as "start_time"
+        from "public"."job_schedule" as "schedule"
+        where "schedule"."company_id" = "p_company_id"
+          and "schedule"."status" <> 'Canceled'::"public"."job_status_enum"
+        group by "schedule"."job_id"
+    ),
+    "eligible_job" as (
+        select "job_row"."id"
+        from "public"."job" as "job_row"
+        inner join "earliest_schedule"
+          on "earliest_schedule"."job_id" = "job_row"."id"
+        where "job_row"."company_id" = "p_company_id"
+          and "earliest_schedule"."start_time" >= "v_date_from_utc"
+          and "earliest_schedule"."start_time" < "v_date_to_utc"
+          and "job_row"."job_source" = any("v_attribution_names")
+    )
+    select coalesce(sum("job_item"."item_price" * "job_item"."quantity"), 0::numeric)
+    into "total_sales"
+    from "eligible_job"
+    inner join "public"."job_item" as "job_item"
+      on "job_item"."company_id" = "p_company_id"
+     and "job_item"."job_id" = "eligible_job"."id";
+
+    select count(*)
+    into "client_count"
+    from "public"."client" as "client_row"
+    where "client_row"."company_id" = "p_company_id"
+      and "client_row"."source_id" = "v_source_id"
+      and "client_row"."client_or_lead" = 'client'::"public"."client_or_lead_enum"
+      and "client_row"."created_at" >= "v_date_from_utc"
+      and "client_row"."created_at" < "v_date_to_utc";
+
+    return next;
+end;
+$$;
+
+alter function "public"."get_facebook_ads_report"("uuid", date, date)
+owner to "postgres";
+
+-- These indexes support the report's company-scoped earliest-schedule, item,
+-- and client attribution scans. They are added once with the feature schema.
+create index if not exists "facebook_ads_job_schedule_report_idx"
+    on "public"."job_schedule" ("company_id", "job_id", "start_time")
+    where "status" <> 'Canceled'::"public"."job_status_enum";
+
+create index if not exists "facebook_ads_job_item_report_idx"
+    on "public"."job_item" ("company_id", "job_id");
+
+create index if not exists "facebook_ads_client_report_idx"
+    on "public"."client" (
+        "company_id",
+        "source_id",
+        "client_or_lead",
+        "created_at"
+    );
+
+create or replace function "public"."get_facebook_ads_campaign_spend_breakdown"(
+    "p_company_id" "uuid",
+    "p_date_from" date,
+    "p_date_to" date
+)
+returns table (
+    "campaign_id" "text",
+    "campaign_name" "text",
+    "total_spend" numeric
+)
+language sql
+stable
+security definer
+set search_path = ''
+as $$
+    select
+        "campaign_spend"."campaign_id",
+        (array_agg(
+            "campaign_spend"."campaign_name"
+            order by
+                "campaign_spend"."date" desc,
+                "campaign_spend"."updated_at" desc
+        ))[1] as "campaign_name",
+        coalesce(sum("campaign_spend"."spend"), 0::numeric) as "total_spend"
+    from "public"."facebook_ads_campaign_daily_spend" as "campaign_spend"
+    where "campaign_spend"."company_id" = "p_company_id"
+      and "campaign_spend"."date" between "p_date_from" and "p_date_to"
+    group by "campaign_spend"."campaign_id"
+    order by "total_spend" desc, "campaign_name", "campaign_id";
+$$;
+
+alter function "public"."get_facebook_ads_campaign_spend_breakdown"(
+    "uuid",
+    date,
+    date
+) owner to "postgres";
+
+create or replace function "public"."get_facebook_ads_job_sales_breakdown"(
+    "p_company_id" "uuid",
+    "p_date_from" date,
+    "p_date_to" date,
+    "p_limit" integer default 25,
+    "p_offset" integer default 0
+)
+returns table (
+    "job_id" "uuid",
+    "job_number" integer,
+    "scheduled_at" timestamp with time zone,
+    "client_id" "uuid",
+    "client_name" "text",
+    "lead_source" "text",
+    "sales" numeric,
+    "total_count" bigint
+)
+language plpgsql
+stable
+security definer
+set search_path = ''
+as $$
+declare
+    "v_timezone_name" "text";
+    "v_date_from_utc" timestamp with time zone;
+    "v_date_to_utc" timestamp with time zone;
+    "v_source_id" "uuid";
+    "v_source_names" "text"[];
+    "v_current_source_name" "text";
+    "v_attribution_names" "text"[];
+begin
+    if "p_company_id" is null
+        or "p_date_from" is null
+        or "p_date_to" is null
+        or "p_date_from" > "p_date_to"
+        or "p_limit" not between 1 and 100
+        or "p_offset" < 0
+    then
+        raise exception 'company, date range, and pagination are invalid'
+            using errcode = '22023';
+    end if;
+
+    select coalesce(nullif("company_row"."time_zone", ''), 'America/Chicago')
+    into "v_timezone_name"
+    from "public"."company" as "company_row"
+    where "company_row"."id" = "p_company_id";
+
+    if not found then
+        raise exception 'Company does not exist' using errcode = '23503';
+    end if;
+
+    "v_date_from_utc" := timezone(
+        "v_timezone_name",
+        "p_date_from"::timestamp without time zone
+    );
+    "v_date_to_utc" := timezone(
+        "v_timezone_name",
+        ("p_date_to" + 1)::timestamp without time zone
+    );
+
+    select
+        "settings"."source_id",
+        "settings"."source_names",
+        "source"."name"
+    into
+        "v_source_id",
+        "v_source_names",
+        "v_current_source_name"
+    from "public"."settings_facebook_ads" as "settings"
+    left join "public"."job_source" as "source"
+      on "source"."company_id" = "settings"."company_id"
+     and "source"."id" = "settings"."source_id"
+    where "settings"."company_id" = "p_company_id";
+
+    if "v_source_id" is null then
+        return;
+    end if;
+
+    select coalesce(array_agg("alias_row"."name" order by "alias_row"."name"), '{}'::"text"[])
+    into "v_attribution_names"
+    from (
+        select distinct "candidate"."value" as "name"
+        from unnest(
+            coalesce("v_source_names", '{}'::"text"[])
+            || array["v_current_source_name"]
+        ) as "candidate"("value")
+        where nullif(btrim("candidate"."value"), '') is not null
+    ) as "alias_row";
+
+    return query
+    with "earliest_schedule" as (
+        select
+            "schedule"."job_id",
+            min("schedule"."start_time") as "start_time"
+        from "public"."job_schedule" as "schedule"
+        where "schedule"."company_id" = "p_company_id"
+          and "schedule"."status" <> 'Canceled'::"public"."job_status_enum"
+        group by "schedule"."job_id"
+    ),
+    "job_sales" as (
+        select
+            "job_row"."id" as "job_id",
+            "job_row"."job_number",
+            "earliest_schedule"."start_time" as "scheduled_at",
+            "client_row"."id" as "client_id",
+            coalesce(
+                nullif(btrim("client_row"."client_company_name"), ''),
+                nullif(btrim(concat_ws(
+                    ' ',
+                    "client_row"."first_name",
+                    "client_row"."last_name"
+                )), ''),
+                'Unknown client'
+            ) as "client_name",
+            "job_row"."job_source" as "lead_source",
+            coalesce(sum(
+                "job_item"."item_price" * "job_item"."quantity"
+            ), 0::numeric) as "sales"
+        from "public"."job" as "job_row"
+        inner join "earliest_schedule"
+          on "earliest_schedule"."job_id" = "job_row"."id"
+        inner join "public"."client" as "client_row"
+          on "client_row"."company_id" = "p_company_id"
+         and "client_row"."id" = "job_row"."client_id"
+        left join "public"."job_item" as "job_item"
+          on "job_item"."company_id" = "p_company_id"
+         and "job_item"."job_id" = "job_row"."id"
+        where "job_row"."company_id" = "p_company_id"
+          and "earliest_schedule"."start_time" >= "v_date_from_utc"
+          and "earliest_schedule"."start_time" < "v_date_to_utc"
+          and "job_row"."job_source" = any("v_attribution_names")
+        group by
+            "job_row"."id",
+            "job_row"."job_number",
+            "earliest_schedule"."start_time",
+            "client_row"."id",
+            "client_row"."client_company_name",
+            "client_row"."first_name",
+            "client_row"."last_name",
+            "job_row"."job_source"
+    )
+    select
+        "job_sales"."job_id",
+        "job_sales"."job_number",
+        "job_sales"."scheduled_at",
+        "job_sales"."client_id",
+        "job_sales"."client_name",
+        "job_sales"."lead_source",
+        "job_sales"."sales",
+        count(*) over() as "total_count"
+    from "job_sales"
+    order by "job_sales"."scheduled_at" desc, "job_sales"."job_number" desc
+    limit "p_limit"
+    offset "p_offset";
+end;
+$$;
+
+alter function "public"."get_facebook_ads_job_sales_breakdown"(
+    "uuid",
+    date,
+    date,
+    integer,
+    integer
+) owner to "postgres";
+
+-- Issuing the report, campaign, and job queries as three separate RPC calls
+-- would let a sync commit between them and mix database snapshots. Because
+-- this function is STABLE, every query it runs — including the STABLE report
+-- functions it calls — uses the single snapshot of the calling statement, so
+-- the aggregate totals, campaign rows, and attributed jobs are always
+-- mutually consistent.
+create or replace function "public"."get_facebook_ads_breakdown"(
+    "p_company_id" "uuid",
+    "p_date_from" date,
+    "p_date_to" date,
+    "p_limit" integer default 25,
+    "p_offset" integer default 0
+)
+returns jsonb
+language plpgsql
+stable
+security definer
+set search_path = ''
+as $$
+declare
+    "v_report" jsonb;
+    "v_campaigns" jsonb;
+    "v_jobs" jsonb;
+begin
+    select to_jsonb("report_row")
+    into "v_report"
+    from "public"."get_facebook_ads_report"(
+        "p_company_id",
+        "p_date_from",
+        "p_date_to"
+    ) as "report_row";
+
+    select coalesce(jsonb_agg(to_jsonb("campaign_row")), '[]'::jsonb)
+    into "v_campaigns"
+    from "public"."get_facebook_ads_campaign_spend_breakdown"(
+        "p_company_id",
+        "p_date_from",
+        "p_date_to"
+    ) as "campaign_row";
+
+    select coalesce(jsonb_agg(to_jsonb("job_row")), '[]'::jsonb)
+    into "v_jobs"
+    from "public"."get_facebook_ads_job_sales_breakdown"(
+        "p_company_id",
+        "p_date_from",
+        "p_date_to",
+        "p_limit",
+        "p_offset"
+    ) as "job_row";
+
+    return jsonb_build_object(
+        'report', "v_report",
+        'campaigns', "v_campaigns",
+        'jobs', "v_jobs"
+    );
+end;
+$$;
+
+alter function "public"."get_facebook_ads_breakdown"(
+    "uuid",
+    date,
+    date,
+    integer,
+    integer
+) owner to "postgres";
+
+-- A lead source can represent one ad platform at a time. The advisory lock
+-- closes the cross-table race where Google and Facebook settings are updated
+-- concurrently for the same company and source.
+create or replace function "public"."prevent_duplicate_ads_source_assignment"()
+returns trigger
+language plpgsql
+security definer
+set search_path = ''
+as $$
+begin
+    if new."source_id" is null then
+        return new;
+    end if;
+
+    perform pg_advisory_xact_lock(
+        hashtextextended(
+            new."company_id"::text || ':' || new."source_id"::text,
+            0
+        )
+    );
+
+    if tg_table_name = 'settings_facebook_ads' then
+        if exists (
+            select 1
+            from "public"."settings_google_ads"
+            where "company_id" = new."company_id"
+              and "source_id" = new."source_id"
+        ) then
+            raise exception 'Lead source is already assigned to Google Ads'
+                using
+                    errcode = '23505',
+                    constraint = 'ads_source_platform_unique';
+        end if;
+    elsif tg_table_name = 'settings_google_ads' then
+        if exists (
+            select 1
+            from "public"."settings_facebook_ads"
+            where "company_id" = new."company_id"
+              and "source_id" = new."source_id"
+        ) then
+            raise exception 'Lead source is already assigned to Facebook Ads'
+                using
+                    errcode = '23505',
+                    constraint = 'ads_source_platform_unique';
+        end if;
+    else
+        raise exception 'Unsupported ads settings table'
+            using errcode = '55000';
+    end if;
+
+    return new;
+end;
+$$;
+
+alter function "public"."prevent_duplicate_ads_source_assignment"()
+owner to "postgres";
+
+create or replace trigger "prevent_duplicate_facebook_ads_source_trigger"
+before insert or update of "source_id" on "public"."settings_facebook_ads"
+for each row
+execute function "public"."prevent_duplicate_ads_source_assignment"();
+
+create or replace trigger "prevent_duplicate_google_ads_source_trigger"
+before insert or update of "source_id" on "public"."settings_google_ads"
+for each row
+execute function "public"."prevent_duplicate_ads_source_assignment"();
+
+-- Account changes and campaign-selection changes increment the spend
+-- configuration version. Clear the campaign cache in the same transaction and
+-- mark its historical import incomplete whenever that version changes.
+create or replace function "public"."reset_facebook_ads_campaign_breakdown"()
+returns trigger
+language plpgsql
+security definer
+set search_path = ''
+as $$
+begin
+    if "old"."ad_account_id" is distinct from "new"."ad_account_id"
+        or "old"."spend_configuration_version"
+            is distinct from "new"."spend_configuration_version"
+    then
+        delete from "public"."facebook_ads_campaign_daily_spend"
+        where "connection_id" = "old"."id";
+        "new"."campaign_breakdown_backfill_completed_at" := null;
+    end if;
+
+    return "new";
+end;
+$$;
+
+alter function "public"."reset_facebook_ads_campaign_breakdown"()
+owner to "postgres";
+
+create or replace trigger "reset_facebook_ads_campaign_breakdown_trigger"
+before update of "ad_account_id", "spend_configuration_version"
+on "public"."facebook_ads_connection"
+for each row execute function "public"."reset_facebook_ads_campaign_breakdown"();
+
+create or replace function "public"."set_facebook_ads_updated_at"()
+returns trigger
+language plpgsql
+as $$
+begin
+    new."updated_at" = "now"();
+    return new;
+end;
+$$;
+
+alter function "public"."set_facebook_ads_updated_at"() owner to "postgres";
+
+create or replace trigger "set_facebook_ads_connection_updated_at_trigger"
+before update on "public"."facebook_ads_connection"
+for each row
+execute function "public"."set_facebook_ads_updated_at"();
+
+create or replace trigger "set_settings_facebook_ads_updated_at_trigger"
+before update on "public"."settings_facebook_ads"
+for each row
+execute function "public"."set_facebook_ads_updated_at"();
+
+create or replace trigger "set_facebook_ads_daily_spend_updated_at_trigger"
+before update on "public"."facebook_ads_daily_spend"
+for each row
+execute function "public"."set_facebook_ads_updated_at"();
+
+create or replace trigger "set_facebook_ads_campaign_daily_spend_updated_at_trigger"
+before update on "public"."facebook_ads_campaign_daily_spend"
+for each row execute function "public"."set_facebook_ads_updated_at"();