🤖 Merge PR DefinitelyTyped#73615 upgrade: facebook-nodejs-business-sdk to v23 types by @rodinhatokay

Author: rodinhatokay

types/facebook-nodejs-business-sdk/facebook-nodejs-business-sdk-tests.ts

@@ -15,7 +15,8 @@ import {
     Campaign,
     AdsPixel,
     AdCreative,
-    Ad
+    Ad,
+    AdCampaignStats,
 } from 'facebook-nodejs-business-sdk';
 import { FacebookRequestError } from 'facebook-nodejs-business-sdk/src/exceptions';
 import TEventRequest from "facebook-nodejs-business-sdk/src/objects/serverside/event-request";
@@ -162,3 +163,14 @@ export function testBusinessDataApiUserDataConstructor() {
 export function testAttributionDataConstructor() {
     const attributionData = new AttributionData();
 }
+
+export function testAdCampaignStatsFields() {
+    AdCampaignStats.Fields.account_id;
+    AdCampaignStats.Fields.actions;
+    AdCampaignStats.Fields.adgroup_id;
+    AdCampaignStats.Fields.campaign_id;
+    AdCampaignStats.Fields.campaign_ids;
+    AdCampaignStats.Fields.clicks;
+    AdCampaignStats.Fields.end_time;
+    AdCampaignStats.Fields.id;
+}

types/facebook-nodejs-business-sdk/index.d.ts

@@ -1,7 +1,7 @@
 {
     "private": true,
     "name": "@types/facebook-nodejs-business-sdk",
-    "version": "22.0.9999",
+    "version": "23.0.9999",
     "projects": [
         "https://github.com/facebook/facebook-nodejs-business-sdk"
     ],

types/facebook-nodejs-business-sdk/package.json

@@ -5,7 +5,7 @@
     },
     "devDependencies": {
         "@khanacademy/flow-to-ts": "^0.5.2",
-        "facebook-nodejs-business-sdk": "^22.0.1",
+        "facebook-nodejs-business-sdk": "^23.0.1",
         "typescript": "^5.8.3"
     }
 }

types/facebook-nodejs-business-sdk/scripts/package.json

@@ -1,12 +1,10 @@
 import { AbstractCrudObject } from "./../abstract-crud-object";
 /**
- * AdAccountSuggestedTag
+ * ABTestPostTestActions
  * @see {@link https://developers.facebook.com/docs/marketing-api/}
  */
-export default class AdAccountSuggestedTag extends AbstractCrudObject {
+export default class ABTestPostTestActions extends AbstractCrudObject {
     static get Fields(): Readonly<{
-        product_id: "product_id";
-        x: "x";
-        y: "y";
+        auto_change_budget_to_winner: "auto_change_budget_to_winner";
     }>;
 }

types/facebook-nodejs-business-sdk/src/objects/ad-account-suggested-tag.d.ts renamed to types/facebook-nodejs-business-sdk/src/objects/ab-test-post-test-actions.d.ts

@@ -24,6 +24,7 @@ export default class AdAccountAdRulesHistory extends AbstractCrudObject {
         convert_asc_cp_single_instance: "CONVERT_ASC_CP_SINGLE_INSTANCE";
         email: "EMAIL";
         enable_advantage_campaign_budget: "ENABLE_ADVANTAGE_CAMPAIGN_BUDGET";
+        enable_advantage_plus_audience: "ENABLE_ADVANTAGE_PLUS_AUDIENCE";
         enable_advantage_plus_creative: "ENABLE_ADVANTAGE_PLUS_CREATIVE";
         enable_advantage_plus_placements: "ENABLE_ADVANTAGE_PLUS_PLACEMENTS";
         enable_autoflow: "ENABLE_AUTOFLOW";

types/facebook-nodejs-business-sdk/src/objects/ad-account-ad-rules-history.d.ts

@@ -26,7 +26,7 @@ export default class AdAccountAdVolume extends AbstractCrudObject {
         account_spend_limit: "ACCOUNT_SPEND_LIMIT";
         account_spend_limit_duplication: "ACCOUNT_SPEND_LIMIT_DUPLICATION";
         aco_toggle: "ACO_TOGGLE";
-        adopt_capi_gateway_from_test_drive: "ADOPT_CAPI_GATEWAY_FROM_TEST_DRIVE";
+        adset_budget_sharing: "ADSET_BUDGET_SHARING";
         ads_reporting: "ADS_REPORTING";
         ads_status: "ADS_STATUS";
         advanced_campaign_budget: "ADVANCED_CAMPAIGN_BUDGET";
@@ -60,12 +60,19 @@ export default class AdAccountAdVolume extends AbstractCrudObject {
         ad_lift_recall_goal_precreate: "AD_LIFT_RECALL_GOAL_PRECREATE";
         ad_lift_recall_optimization_goal: "AD_LIFT_RECALL_OPTIMIZATION_GOAL";
         ad_objective: "AD_OBJECTIVE";
+        ad_set_budget_sharing_guidance: "AD_SET_BUDGET_SHARING_GUIDANCE";
         aem_v2_ineligible: "AEM_V2_INELIGIBLE";
         aggregated_bid_limited: "AGGREGATED_BID_LIMITED";
         aggregated_budget_limited: "AGGREGATED_BUDGET_LIMITED";
         aggregated_cost_limited: "AGGREGATED_COST_LIMITED";
+        aplusc_add_overlays: "APLUSC_ADD_OVERLAYS";
+        aplusc_dynamic_description: "APLUSC_DYNAMIC_DESCRIPTION";
+        aplusc_image_background_generation: "APLUSC_IMAGE_BACKGROUND_GENERATION";
         aplusc_music: "APLUSC_MUSIC";
+        aplusc_relevant_comments: "APLUSC_RELEVANT_COMMENTS";
+        aplusc_standard_enhancements_bundle: "APLUSC_STANDARD_ENHANCEMENTS_BUNDLE";
         aplusc_text_improvements: "APLUSC_TEXT_IMPROVEMENTS";
+        aplusc_visual_touchups: "APLUSC_VISUAL_TOUCHUPS";
         aplus_c_catalog_duplication: "APLUS_C_CATALOG_DUPLICATION";
         app_aem_v2_installation_promotion: "APP_AEM_V2_INSTALLATION_PROMOTION";
         app_engaged_view_conversions_duplication: "APP_ENGAGED_VIEW_CONVERSIONS_DUPLICATION";
@@ -83,6 +90,7 @@ export default class AdAccountAdVolume extends AbstractCrudObject {
         audience_expansion_lookalike: "AUDIENCE_EXPANSION_LOOKALIKE";
         audience_expansion_retargeting: "AUDIENCE_EXPANSION_RETARGETING";
         audience_learning_limited: "AUDIENCE_LEARNING_LIMITED";
+        autobid_to_manual_bid: "AUTOBID_TO_MANUAL_BID";
         autoflow_opt_in: "AUTOFLOW_OPT_IN";
         autoflow_opt_in_fallback_duplication_flow: "AUTOFLOW_OPT_IN_FALLBACK_DUPLICATION_FLOW";
         autoflow_opt_in_v2: "AUTOFLOW_OPT_IN_V2";
@@ -91,14 +99,19 @@ export default class AdAccountAdVolume extends AbstractCrudObject {
         auto_bid: "AUTO_BID";
         auto_cat_selection_enhancement: "AUTO_CAT_SELECTION_ENHANCEMENT";
         background_generation: "BACKGROUND_GENERATION";
+        bid_limited_sensitive: "BID_LIMITED_SENSITIVE";
+        bid_limited_starving: "BID_LIMITED_STARVING";
         blended_ads: "BLENDED_ADS";
         blended_ads_duplication: "BLENDED_ADS_DUPLICATION";
         blended_ads_for_shops_ads_duplication: "BLENDED_ADS_FOR_SHOPS_ADS_DUPLICATION";
         bpbaa_with_capi_upsell: "BPBAA_WITH_CAPI_UPSELL";
         broadgeo_am_upsell_guidance: "BROADGEO_AM_UPSELL_GUIDANCE";
         broad_targeting: "BROAD_TARGETING";
+        budget_amortization: "BUDGET_AMORTIZATION";
         budget_limited: "BUDGET_LIMITED";
         budget_reallocation: "BUDGET_REALLOCATION";
+        call_ads_dayparting_l3_recommendation: "CALL_ADS_DAYPARTING_L3_RECOMMENDATION";
+        campaign_guidance_navigator_reels_tips: "CAMPAIGN_GUIDANCE_NAVIGATOR_REELS_TIPS";
         capi: "CAPI";
         capi_crm_funnel: "CAPI_CRM_FUNNEL";
         capi_crm_guidance: "CAPI_CRM_GUIDANCE";
@@ -108,6 +121,7 @@ export default class AdAccountAdVolume extends AbstractCrudObject {
         capi_performance_match_key: "CAPI_PERFORMANCE_MATCH_KEY";
         capi_performance_match_key_v2: "CAPI_PERFORMANCE_MATCH_KEY_V2";
         cash_rewards_opt_in: "CASH_REWARDS_OPT_IN";
+        catalog_dynamic_media: "CATALOG_DYNAMIC_MEDIA";
         catalog_match_rate: "CATALOG_MATCH_RATE";
         commerce_shops_ads_duplication: "COMMERCE_SHOPS_ADS_DUPLICATION";
         connected_sources: "CONNECTED_SOURCES";
@@ -135,16 +149,21 @@ export default class AdAccountAdVolume extends AbstractCrudObject {
         creative_limited_hourly: "CREATIVE_LIMITED_HOURLY";
         creator_ads_pa_conversion: "CREATOR_ADS_PA_CONVERSION";
         cta: "CTA";
+        ctm_ad_objective_growth: "CTM_AD_OBJECTIVE_GROWTH";
+        ctm_leads_optimization_upsell: "CTM_LEADS_OPTIMIZATION_UPSELL";
         ctx_budget_optimization: "CTX_BUDGET_OPTIMIZATION";
         ctx_creation_package: "CTX_CREATION_PACKAGE";
         ctx_cta_upgrade_in_duplication: "CTX_CTA_UPGRADE_IN_DUPLICATION";
         ctx_ctmpo_upgrade: "CTX_CTMPO_UPGRADE";
+        ctx_ctwapo_upgrade: "CTX_CTWAPO_UPGRADE";
         ctx_guidance: "CTX_GUIDANCE";
         ctx_hvs: "CTX_HVS";
         ctx_multi_message_destination: "CTX_MULTI_MESSAGE_DESTINATION";
         ctx_precreate: "CTX_PRECREATE";
+        ctx_product_extension_duplication: "CTX_PRODUCT_EXTENSION_DUPLICATION";
         ctx_sabr_cbo: "CTX_SABR_CBO";
         ctx_sabr_non_cbo: "CTX_SABR_NON_CBO";
+        ctx_smart_defaulting: "CTX_SMART_DEFAULTING";
         ctx_zo_cbo: "CTX_ZO_CBO";
         ctx_zo_non_cbo: "CTX_ZO_NON_CBO";
         custom_audience_relaxation: "CUSTOM_AUDIENCE_RELAXATION";
@@ -158,6 +177,7 @@ export default class AdAccountAdVolume extends AbstractCrudObject {
         delivery_warning: "DELIVERY_WARNING";
         dynamic_advantage_campaign_budget: "DYNAMIC_ADVANTAGE_CAMPAIGN_BUDGET";
         ecosystem_bid_reduce_l1_cardinality: "ECOSYSTEM_BID_REDUCE_L1_CARDINALITY";
+        enable_whats_app_ads_data_sharing: "ENABLE_WHATS_APP_ADS_DATA_SHARING";
         engaged_view_conversions_creation: "ENGAGED_VIEW_CONVERSIONS_CREATION";
         evc_app_duplication_upgrade: "EVC_APP_DUPLICATION_UPGRADE";
         evc_web_duplication_upgrade: "EVC_WEB_DUPLICATION_UPGRADE";
@@ -171,8 +191,11 @@ export default class AdAccountAdVolume extends AbstractCrudObject {
         heuristic_default_duration: "HEURISTIC_DEFAULT_DURATION";
         high_cost: "HIGH_COST";
         historical_benchmark: "HISTORICAL_BENCHMARK";
+        iaa_roas_optimization: "IAA_ROAS_OPTIMIZATION";
         ig_multi_ads: "IG_MULTI_ADS";
         ig_surfaces_manual_placements: "IG_SURFACES_MANUAL_PLACEMENTS";
+        incremental_attribution: "INCREMENTAL_ATTRIBUTION";
+        instant_forms_leads: "INSTANT_FORMS_LEADS";
         landing_page_view: "LANDING_PAGE_VIEW";
         landing_page_view_optimization_goal: "LANDING_PAGE_VIEW_OPTIMIZATION_GOAL";
         landing_page_view_precreate: "LANDING_PAGE_VIEW_PRECREATE";
@@ -205,9 +228,11 @@ export default class AdAccountAdVolume extends AbstractCrudObject {
         optimal_bau: "OPTIMAL_BAU";
         outcome_forecaster_budget_recommendation: "OUTCOME_FORECASTER_BUDGET_RECOMMENDATION";
         outcome_forecaster_shadow_logging: "OUTCOME_FORECASTER_SHADOW_LOGGING";
+        partnership_ads: "PARTNERSHIP_ADS";
         payment_method: "PAYMENT_METHOD";
         performant_creative_reels_opt_in: "PERFORMANT_CREATIVE_REELS_OPT_IN";
         pfr_l1_inline_mmt: "PFR_L1_INLINE_MMT";
+        pixelless_lpv_optimization_goal: "PIXELLESS_LPV_OPTIMIZATION_GOAL";
         pixel_optimization_aam: "PIXEL_OPTIMIZATION_AAM";
         pixel_optimization_aam_precreate: "PIXEL_OPTIMIZATION_AAM_PRECREATE";
         pixel_optimization_hie: "PIXEL_OPTIMIZATION_HIE";
@@ -220,6 +245,7 @@ export default class AdAccountAdVolume extends AbstractCrudObject {
         predictive_creative_limited_hourly: "PREDICTIVE_CREATIVE_LIMITED_HOURLY";
         preparing_status: "PREPARING_STATUS";
         product_set_boosting: "PRODUCT_SET_BOOSTING";
+        promo_ads_upsell_guidance: "PROMO_ADS_UPSELL_GUIDANCE";
         purchase_optimization: "PURCHASE_OPTIMIZATION";
         rapid_learning_limited: "RAPID_LEARNING_LIMITED";
         rapid_learning_phase: "RAPID_LEARNING_PHASE";
@@ -232,18 +258,22 @@ export default class AdAccountAdVolume extends AbstractCrudObject {
         reels_performant_creative: "REELS_PERFORMANT_CREATIVE";
         reels_placement: "REELS_PLACEMENT";
         revert: "REVERT";
+        review_creative_duplicated_rejected_ads: "REVIEW_CREATIVE_DUPLICATED_REJECTED_ADS";
         sabr_default_duration: "SABR_DEFAULT_DURATION";
         sales_conversion: "SALES_CONVERSION";
         saved_audience: "SAVED_AUDIENCE";
         scale_good_campaign: "SCALE_GOOD_CAMPAIGN";
         scale_good_campaign_duplication: "SCALE_GOOD_CAMPAIGN_DUPLICATION";
         scale_good_campaign_smb: "SCALE_GOOD_CAMPAIGN_SMB";
+        scale_good_campaign_v2_duplication: "SCALE_GOOD_CAMPAIGN_V2_DUPLICATION";
         scale_good_ctx_campaign: "SCALE_GOOD_CTX_CAMPAIGN";
+        seasonal_campaigns: "SEASONAL_CAMPAIGNS";
         semantic_based_audience_duplication: "SEMANTIC_BASED_AUDIENCE_DUPLICATION";
         semantic_based_audience_expansion: "SEMANTIC_BASED_AUDIENCE_EXPANSION";
         setup_pixel: "SETUP_PIXEL";
         shops_ads: "SHOPS_ADS";
         shops_ads_duplication: "SHOPS_ADS_DUPLICATION";
+        shops_ads_saoff: "SHOPS_ADS_SAOFF";
         shops_ads_traffic_cap_settings: "SHOPS_ADS_TRAFFIC_CAP_SETTINGS";
         shop_ads_v2: "SHOP_ADS_V2";
         signals_down_funnel_event_optimization: "SIGNALS_DOWN_FUNNEL_EVENT_OPTIMIZATION";
@@ -260,6 +290,7 @@ export default class AdAccountAdVolume extends AbstractCrudObject {
         tailored_lead_ad_campaign: "TAILORED_LEAD_AD_CAMPAIGN";
         tailored_messages_campaign: "TAILORED_MESSAGES_CAMPAIGN";
         targeting_creative_fragmentation: "TARGETING_CREATIVE_FRAGMENTATION";
+        threeco_web_plus_app_upsell: "THREECO_WEB_PLUS_APP_UPSELL";
         tla_creation_package: "TLA_CREATION_PACKAGE";
         top_adsets_with_ads_under_cap: "TOP_ADSETS_WITH_ADS_UNDER_CAP";
         top_campaigns_with_ads_under_cap: "TOP_CAMPAIGNS_WITH_ADS_UNDER_CAP";
@@ -273,13 +304,16 @@ export default class AdAccountAdVolume extends AbstractCrudObject {
         unused_budget: "UNUSED_BUDGET";
         value_diagnostics_guidance: "VALUE_DIAGNOSTICS_GUIDANCE";
         value_optimization_goal: "VALUE_OPTIMIZATION_GOAL";
+        value_rules_guidance: "VALUE_RULES_GUIDANCE";
         video_length: "VIDEO_LENGTH";
         video_views_upsell: "VIDEO_VIEWS_UPSELL";
         video_views_upsell_precreate: "VIDEO_VIEWS_UPSELL_PRECREATE";
         vo_vt_1d_defaulting: "VO_VT_1D_DEFAULTING";
         wa_messaging_partners: "WA_MESSAGING_PARTNERS";
         wa_messaging_partners_precreate: "WA_MESSAGING_PARTNERS_PRECREATE";
         web_engaged_view_conversions: "WEB_ENGAGED_VIEW_CONVERSIONS";
+        wtwa_upsell_in_duplication: "WTWA_UPSELL_IN_DUPLICATION";
+        wtwa_upsell_in_syd_and_am_table: "WTWA_UPSELL_IN_SYD_AND_AM_TABLE";
         zero_conversion: "ZERO_CONVERSION";
         zero_impression: "ZERO_IMPRESSION";
         zero_outcome_budget: "ZERO_OUTCOME_BUDGET";

types/facebook-nodejs-business-sdk/src/objects/ad-account-ad-volume.d.ts

@@ -0,0 +1,21 @@
+import { AbstractCrudObject } from "./../abstract-crud-object";
+/**
+ * AdAccountAgencyFeeConfig
+ * @see {@link https://developers.facebook.com/docs/marketing-api/}
+ */
+export default class AdAccountAgencyFeeConfig extends AbstractCrudObject {
+    static get Fields(): Readonly<{
+        can_add_agency_fee_to_invoice: "can_add_agency_fee_to_invoice";
+        default_agency_fee_pct: "default_agency_fee_pct";
+        id: "id";
+        is_agency_fee_disabled: "is_agency_fee_disabled";
+        status: "status";
+    }>;
+    static get Status(): Readonly<{
+        active: "ACTIVE";
+        archived: "ARCHIVED";
+        draft: "DRAFT";
+        unknown: "UNKNOWN";
+    }>;
+    get(fields: string[], params?: Record<string, any>): Promise<AdAccountAgencyFeeConfig>;
+}

types/facebook-nodejs-business-sdk/src/objects/ad-account-agency-fee-config.d.ts

@@ -17,6 +17,7 @@ export default class AdAccountDeliveryEstimate extends AbstractCrudObject {
         ad_recall_lift: "AD_RECALL_LIFT";
         app_installs: "APP_INSTALLS";
         app_installs_and_offsite_conversions: "APP_INSTALLS_AND_OFFSITE_CONVERSIONS";
+        automatic_objective: "AUTOMATIC_OBJECTIVE";
         conversations: "CONVERSATIONS";
         derived_events: "DERIVED_EVENTS";
         engaged_users: "ENGAGED_USERS";

types/facebook-nodejs-business-sdk/src/objects/ad-account-delivery-estimate.d.ts

@@ -13,6 +13,7 @@ export default class AdAccountOptimizationGoalsAEMv2Eligibility extends Abstract
         ad_recall_lift: "AD_RECALL_LIFT";
         app_installs: "APP_INSTALLS";
         app_installs_and_offsite_conversions: "APP_INSTALLS_AND_OFFSITE_CONVERSIONS";
+        automatic_objective: "AUTOMATIC_OBJECTIVE";
         conversations: "CONVERSATIONS";
         derived_events: "DERIVED_EVENTS";
         engaged_users: "ENGAGED_USERS";