@adcp/sdk 7.6.0 → 7.8.0

package/dist/lib/media-buy/preflight.js

@@ -0,0 +1,376 @@
+"use strict";
+// Buyer-side preflight helpers for `update_media_buy`. See RFC #4480.
+//
+// Three layers, each usable on its own:
+//   1. Boolean gates: `canPause(buy)`, `canExtendFlight(buy)`, ... - single
+//      question, single answer. Drives UI affordances.
+//   2. Resolver: `getActionForMutation(buy, request)` - turns a request diff
+//      into the set of fine-grained actions it covers. Drives dispatch.
+//   3. Preflight: `preflightUpdateMediaBuy(buy, request)` - composes
+//      resolver + gate checks into a single ok/not-ok decision.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canRemoveCreative = exports.canRemovePackages = exports.canAddPackages = exports.canUpdateCreativeAssignments = exports.canReplaceCreative = exports.canUpdateFrequencyCaps = exports.canUpdatePacing = exports.canUpdateTargeting = exports.canReallocateBudget = exports.canDecreaseBudget = exports.canIncreaseBudget = exports.canUpdateFlightDates = exports.canShortenFlight = exports.canExtendFlight = exports.canCancel = exports.canResume = exports.canPause = void 0;
+exports.getActionForMutation = getActionForMutation;
+exports.preflightUpdateMediaBuy = preflightUpdateMediaBuy;
+exports.recoveryForModeMismatch = recoveryForModeMismatch;
+const errors_1 = require("../errors");
+const available_actions_1 = require("./available-actions");
+const update_fields_generated_1 = require("./update-fields.generated");
+// ---------------------------------------------------------------------------
+// Boolean gates
+// ---------------------------------------------------------------------------
+function isAvailable(buy, action) {
+    return (0, available_actions_1.findAvailableAction)(buy, action, { silent: true }) !== undefined;
+}
+const canPause = (buy) => isAvailable(buy, 'pause');
+exports.canPause = canPause;
+const canResume = (buy) => isAvailable(buy, 'resume');
+exports.canResume = canResume;
+const canCancel = (buy) => isAvailable(buy, 'cancel');
+exports.canCancel = canCancel;
+const canExtendFlight = (buy) => isAvailable(buy, 'extend_flight');
+exports.canExtendFlight = canExtendFlight;
+const canShortenFlight = (buy) => isAvailable(buy, 'shorten_flight');
+exports.canShortenFlight = canShortenFlight;
+const canUpdateFlightDates = (buy) => isAvailable(buy, 'update_flight_dates');
+exports.canUpdateFlightDates = canUpdateFlightDates;
+const canIncreaseBudget = (buy) => isAvailable(buy, 'increase_budget');
+exports.canIncreaseBudget = canIncreaseBudget;
+const canDecreaseBudget = (buy) => isAvailable(buy, 'decrease_budget');
+exports.canDecreaseBudget = canDecreaseBudget;
+const canReallocateBudget = (buy) => isAvailable(buy, 'reallocate_budget');
+exports.canReallocateBudget = canReallocateBudget;
+const canUpdateTargeting = (buy) => isAvailable(buy, 'update_targeting');
+exports.canUpdateTargeting = canUpdateTargeting;
+const canUpdatePacing = (buy) => isAvailable(buy, 'update_pacing');
+exports.canUpdatePacing = canUpdatePacing;
+const canUpdateFrequencyCaps = (buy) => isAvailable(buy, 'update_frequency_caps');
+exports.canUpdateFrequencyCaps = canUpdateFrequencyCaps;
+const canReplaceCreative = (buy) => isAvailable(buy, 'replace_creative');
+exports.canReplaceCreative = canReplaceCreative;
+const canUpdateCreativeAssignments = (buy) => isAvailable(buy, 'update_creative_assignments');
+exports.canUpdateCreativeAssignments = canUpdateCreativeAssignments;
+const canAddPackages = (buy) => isAvailable(buy, 'add_packages');
+exports.canAddPackages = canAddPackages;
+const canRemovePackages = (buy) => isAvailable(buy, 'remove_packages');
+exports.canRemovePackages = canRemovePackages;
+const canRemoveCreative = (buy) => isAvailable(buy, 'remove_creative');
+exports.canRemoveCreative = canRemoveCreative;
+// Float tolerance for comparing summed budgets across packages. Below this
+// difference, two totals are treated as equal (absorbs cent-rounding from
+// per-package decimal math). Half a cent is the smallest representable
+// difference any current AdCP currency cares about. If a future spec
+// extension allows sub-cent / micro-amount pricing (e.g. programmatic
+// auction-side bidding) this tolerance would mask real reallocations and
+// should be tightened or made currency-aware.
+const BUDGET_EQUAL_TOLERANCE = 0.005;
+/**
+ * Walk the request body and return the set of fine-grained actions it
+ * covers. Uses `ACTIONS_BY_FIELD` from the generated table to map dotted
+ * paths back to actions, then compares against `currentBuy` to pick
+ * direction-specific siblings.
+ *
+ * Returns an empty array when the request touches no recognized field
+ * (e.g. only `idempotency_key` / `revision` / `account` were set).
+ */
+function getActionForMutation(currentBuy, request) {
+    const touched = collectTouchedFields(request);
+    if (touched.size === 0)
+        return [];
+    // Map each touched path to candidate actions, then resolve direction
+    // for budget/flight clusters.
+    const resolved = new Map();
+    for (const field of touched) {
+        const candidates = update_fields_generated_1.ACTIONS_BY_FIELD[field];
+        if (!candidates)
+            continue;
+        let pick;
+        if (field === 'paused') {
+            pick = { action: request.paused === false ? 'resume' : 'pause' };
+        }
+        else if (field === 'packages[].budget') {
+            pick = resolveBudgetDirection(currentBuy, request);
+        }
+        else if (field === 'end_time' || field === 'packages[].end_time') {
+            pick = resolveFlightEndDirection(currentBuy, request, field);
+        }
+        else if (field === 'start_time' || field === 'packages[].start_time') {
+            pick = { action: 'update_flight_dates', direction: 'shift' };
+        }
+        else {
+            // Unambiguous: every other field has exactly one fine-grained
+            // action in ACTIONS_BY_FIELD.
+            pick = { action: candidates[0] };
+        }
+        const existing = resolved.get(pick.action);
+        if (existing) {
+            existing.touched_fields.push(field);
+        }
+        else {
+            resolved.set(pick.action, {
+                action: pick.action,
+                direction: pick.direction,
+                touched_fields: [field],
+            });
+        }
+    }
+    return [...resolved.values()];
+}
+function collectTouchedFields(request) {
+    const touched = new Set();
+    if (request.paused !== undefined)
+        touched.add('paused');
+    if (request.canceled !== undefined)
+        touched.add('canceled');
+    if (request.cancellation_reason !== undefined)
+        touched.add('cancellation_reason');
+    if (request.start_time !== undefined)
+        touched.add('start_time');
+    if (request.end_time !== undefined)
+        touched.add('end_time');
+    if (request.new_packages !== undefined && request.new_packages.length > 0) {
+        touched.add('new_packages');
+    }
+    if (request.packages) {
+        for (const pkg of request.packages) {
+            if (pkg.canceled !== undefined)
+                touched.add('packages[].canceled');
+            // `pkg.paused` has no entry in the generated action mapping - the
+            // spec keys pause/resume at the buy level only. Drop silently so the
+            // resolver doesn't conflate it with the top-level `paused` action.
+            if (pkg.budget !== undefined)
+                touched.add('packages[].budget');
+            if (pkg.pacing !== undefined)
+                touched.add('packages[].pacing');
+            if (pkg.start_time !== undefined)
+                touched.add('packages[].start_time');
+            if (pkg.end_time !== undefined)
+                touched.add('packages[].end_time');
+            if (pkg.creative_assignments !== undefined) {
+                touched.add('packages[].creative_assignments');
+            }
+            if (pkg.creatives !== undefined)
+                touched.add('packages[].creatives');
+            if (pkg.keyword_targets_add !== undefined)
+                touched.add('packages[].keyword_targets_add');
+            if (pkg.keyword_targets_remove !== undefined) {
+                touched.add('packages[].keyword_targets_remove');
+            }
+            if (pkg.negative_keywords_add !== undefined)
+                touched.add('packages[].negative_keywords_add');
+            if (pkg.negative_keywords_remove !== undefined) {
+                touched.add('packages[].negative_keywords_remove');
+            }
+            if (pkg.targeting_overlay !== undefined) {
+                // `frequency_cap` is the only nested field with its own action.
+                // Touching the whole overlay falls through to update_targeting.
+                const overlayKeys = Object.keys(pkg.targeting_overlay);
+                if (overlayKeys.length === 1 && overlayKeys[0] === 'frequency_cap') {
+                    touched.add('packages[].targeting_overlay.frequency_cap');
+                }
+                else {
+                    touched.add('packages[].targeting_overlay');
+                }
+            }
+        }
+    }
+    return touched;
+}
+function resolveBudgetDirection(currentBuy, request) {
+    const currentByPkg = new Map();
+    for (const pkg of currentBuy.packages ?? []) {
+        if (pkg.package_id && typeof pkg.budget === 'number') {
+            currentByPkg.set(pkg.package_id, pkg.budget);
+        }
+    }
+    let currentTotal = 0;
+    let proposedTotal = 0;
+    let sawIncrease = false;
+    let sawDecrease = false;
+    for (const pkg of request.packages ?? []) {
+        if (typeof pkg.budget !== 'number')
+            continue;
+        const prev = currentByPkg.get(pkg.package_id);
+        if (prev === undefined) {
+            // No baseline - treat as increase (mirrors how sellers see a new
+            // budget on a previously-zero line).
+            sawIncrease = true;
+            proposedTotal += pkg.budget;
+            continue;
+        }
+        currentTotal += prev;
+        proposedTotal += pkg.budget;
+        if (pkg.budget > prev)
+            sawIncrease = true;
+        if (pkg.budget < prev)
+            sawDecrease = true;
+    }
+    // Reallocate: per-package movement in both directions but total
+    // unchanged (within float tolerance to absorb cent rounding).
+    if (sawIncrease && sawDecrease && Math.abs(proposedTotal - currentTotal) < BUDGET_EQUAL_TOLERANCE) {
+        return { action: 'reallocate_budget', direction: 'reallocate' };
+    }
+    if (proposedTotal > currentTotal)
+        return { action: 'increase_budget', direction: 'increase' };
+    if (proposedTotal < currentTotal)
+        return { action: 'decrease_budget', direction: 'decrease' };
+    // Equal totals with no per-package movement (e.g. budget set to same
+    // value) - defaults to reallocate so the request still has *some*
+    // action attached for the preflight to check against.
+    return { action: 'reallocate_budget', direction: 'reallocate' };
+}
+function resolveFlightEndDirection(currentBuy, request, field) {
+    // If start_time is being touched at the same time, the action is
+    // update_flight_dates regardless of end direction (shift semantics).
+    if (request.start_time !== undefined) {
+        return { action: 'update_flight_dates', direction: 'shift' };
+    }
+    const packageStartTouched = (request.packages ?? []).some(pkg => pkg.start_time !== undefined);
+    if (packageStartTouched) {
+        return { action: 'update_flight_dates', direction: 'shift' };
+    }
+    if (field === 'end_time') {
+        const currentEnd = currentBuy.end_time;
+        const proposedEnd = request.end_time;
+        if (currentEnd && proposedEnd) {
+            const cur = Date.parse(currentEnd);
+            const next = Date.parse(proposedEnd);
+            if (!Number.isNaN(cur) && !Number.isNaN(next)) {
+                if (next > cur)
+                    return { action: 'extend_flight', direction: 'extend' };
+                if (next < cur)
+                    return { action: 'shorten_flight', direction: 'shorten' };
+            }
+        }
+        // Indeterminate (missing baseline or unparseable dates). Fall through
+        // to the generic vocabulary; sellers that advertise either of the
+        // direction-specific actions usually also advertise update_flight_dates.
+        return { action: 'update_flight_dates', direction: 'shift' };
+    }
+    // packages[].end_time
+    let extending = false;
+    let shortening = false;
+    const currentByPkg = new Map();
+    for (const pkg of currentBuy.packages ?? []) {
+        if (pkg.package_id)
+            currentByPkg.set(pkg.package_id, pkg.end_time);
+    }
+    for (const pkg of request.packages ?? []) {
+        if (!pkg.end_time)
+            continue;
+        const prev = currentByPkg.get(pkg.package_id);
+        if (!prev) {
+            extending = true;
+            continue;
+        }
+        const cur = Date.parse(prev);
+        const next = Date.parse(pkg.end_time);
+        if (Number.isNaN(cur) || Number.isNaN(next))
+            continue;
+        if (next > cur)
+            extending = true;
+        if (next < cur)
+            shortening = true;
+    }
+    if (extending && !shortening)
+        return { action: 'extend_flight', direction: 'extend' };
+    if (shortening && !extending)
+        return { action: 'shorten_flight', direction: 'shorten' };
+    // Mixed or indeterminate - fall through to update_flight_dates.
+    return { action: 'update_flight_dates', direction: 'shift' };
+}
+/**
+ * Decide whether an `update_media_buy` request is reachable against the
+ * current buy state. When the buy carries only legacy `valid_actions[]`,
+ * the preflight passes (with `compat.source: 'valid_actions'`) for any
+ * matching action - mode is not knowable, so it's reported as `self_serve`
+ * but flagged as a compat fallback.
+ *
+ * Multi-action requests: every resolved action must be present in
+ * `available_actions[]`. All missing actions are reported in `denials[]`
+ * so callers can render every blocker in a single pass.
+ *
+ * Throws `ValidationError` when the request touches no recognized
+ * `update_media_buy` field. This is a buyer-side bug (the SDK was asked to
+ * dispatch a no-op), not a seller-side denial.
+ */
+function preflightUpdateMediaBuy(currentBuy, request) {
+    const resolved = getActionForMutation(currentBuy, request);
+    if (resolved.length === 0) {
+        throw new errors_1.ValidationError('request', request, 'update_media_buy request must touch at least one mutating field (paused, canceled, start_time, end_time, packages[*], or new_packages)');
+    }
+    const result = (0, available_actions_1.getAvailableActions)(currentBuy, { silent: true });
+    const compat = result.source === 'valid_actions' ? { source: result.source, message: result.deprecationHint ?? '' } : undefined;
+    const matched = [];
+    const modes = [];
+    const denials = [];
+    for (const resolvedAction of resolved) {
+        const lookup = (0, available_actions_1.findAvailableAction)(currentBuy, resolvedAction.action, { silent: true });
+        if (!lookup) {
+            // Without product allowed_actions on the buy we can't distinguish
+            // not_supported_on_product vs not_supported_on_buy. wrong_status
+            // is server-side. Default to not_supported_on_buy: the most common
+            // preflight failure when a seller doesn't advertise the action on
+            // this specific buy.
+            denials.push({ action: resolvedAction.action, reason: 'not_supported_on_buy' });
+            continue;
+        }
+        matched.push(lookup.entry);
+        modes.push(lookup.entry.mode);
+    }
+    if (denials.length > 0) {
+        return {
+            ok: false,
+            denials,
+            currently_available_actions: result.actions,
+            compat,
+        };
+    }
+    return {
+        ok: true,
+        actions: resolved,
+        modes,
+        matched,
+        requiresAsyncFlow: modes.some(m => m !== 'self_serve'),
+        compat,
+    };
+}
+/**
+ * Build a typed recovery hint from a `mode_mismatch` rejection. Exported
+ * so callers handling `ActionNotAllowedError` outside of the preflight
+ * surface (e.g. when an in-flight mutation races a buy state change) get
+ * the same structured recovery path.
+ */
+function recoveryForModeMismatch(attemptedAction, currentlyAvailable) {
+    const entry = currentlyAvailable.find(a => a.action === attemptedAction);
+    if (!entry)
+        return undefined;
+    switch (entry.mode) {
+        case 'requires_proposal':
+            return {
+                kind: 'createProposal',
+                message: `seller now resolves \`${attemptedAction}\` as requires_proposal. ` +
+                    'reissue via the proposal lifecycle (`create_proposal` / `finalize_proposal`).',
+            };
+        case 'requires_approval':
+            return {
+                kind: 'waitForApproval',
+                message: `seller now resolves \`${attemptedAction}\` as requires_approval. ` +
+                    'expect an async approval callback rather than a direct response.',
+            };
+        case 'conditional_self_serve':
+            return {
+                kind: 'reissueAsDirect',
+                message: `seller resolves \`${attemptedAction}\` as conditional_self_serve: ` +
+                    'small mutations clear automatically, larger ones queue. retry; expect a possible async escalation.',
+            };
+        case 'self_serve':
+            return {
+                kind: 'reissueAsDirect',
+                message: `seller resolves \`${attemptedAction}\` as self_serve. retry the same request.`,
+            };
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=preflight.js.map

package/dist/lib/media-buy/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../../src/lib/media-buy/preflight.ts"],"names":[],"mappings":"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"}

package/dist/lib/media-buy/types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Fine-grained action identifier introduced in AdCP 3.1. Includes the legacy
+ * coarse values (`update_budget`, `update_dates`, `update_packages`,
+ * `sync_creatives`) so sellers staying on 3.x continue to round-trip.
+ */
+export type MediaBuyValidAction = 'pause' | 'resume' | 'cancel' | 'extend_flight' | 'shorten_flight' | 'update_flight_dates' | 'increase_budget' | 'decrease_budget' | 'reallocate_budget' | 'update_targeting' | 'update_pacing' | 'update_frequency_caps' | 'replace_creative' | 'update_creative_assignments' | 'remove_creative' | 'add_packages' | 'remove_packages' | 'update_budget' | 'update_dates' | 'update_packages' | 'sync_creatives';
+export declare const LEGACY_COARSE_ACTIONS: readonly ["update_budget", "update_dates", "update_packages", "sync_creatives"];
+export type LegacyCoarseAction = (typeof LEGACY_COARSE_ACTIONS)[number];
+/**
+ * How a seller honors a given action on a media buy. Buyers branch on this to
+ * pick a synchronous, conditional, proposal, or async-approval flow.
+ */
+export type MediaBuyActionMode = 'self_serve' | 'conditional_self_serve' | 'requires_proposal' | 'requires_approval';
+/**
+ * SLA window expressed as a structured duration. Mirrors `sla-window.json`
+ * as a `{ unit, value }` pair (e.g. `{ unit: 'hours', value: 24 }`). The schema
+ * landed alongside #4514 but is intentionally minimal; the spec calls out
+ * that absence means "no commitment", not "zero commitment".
+ */
+export interface SlaWindow {
+    unit: 'minutes' | 'hours' | 'days' | 'business_days';
+    value: number;
+    response_max?: number;
+}
+/**
+ * One entry of the per-buy `available_actions[]` array. Authoritative for
+ * the buy at the moment of emission - sellers MAY resolve to a different
+ * mode by the time the mutation arrives, in which case the call is rejected
+ * with `ACTION_NOT_ALLOWED` (`reason: mode_mismatch`).
+ *
+ * The containing array is uniquely keyed by `action` (contract invariant,
+ * not enforced by JSON Schema `uniqueItems`).
+ */
+export interface MediaBuyAvailableAction {
+    action: MediaBuyValidAction;
+    mode: MediaBuyActionMode;
+    sla?: SlaWindow;
+    /**
+     * Opaque pointer into a buy-terms negotiation. The buy-terms RFC is
+     * separate; until it lands the field is any string.
+     */
+    terms_ref?: string;
+}
+/**
+ * Reason an `update_media_buy` request was rejected with
+ * `ACTION_NOT_ALLOWED`. Buyer SDKs branch on this to choose a recovery path.
+ */
+export type ActionNotAllowedReason = 'wrong_status' | 'not_supported_on_product' | 'not_supported_on_buy' | 'mode_mismatch';
+/**
+ * Structured details payload for `ACTION_NOT_ALLOWED` errors.
+ */
+export interface ActionNotAllowedDetails {
+    attempted_action: MediaBuyValidAction;
+    reason: ActionNotAllowedReason;
+    currently_available_actions?: MediaBuyAvailableAction[];
+}
+/**
+ * Minimum surface a media buy needs to expose for the preflight helpers to
+ * operate. Picks the fields the helpers actually read so callers can pass
+ * either a `MediaBuy`, a `CreateMediaBuySuccess`, an `UpdateMediaBuySuccess`,
+ * or a `get_media_buys` entry. Optional fields match the schema; required
+ * fields are required by the helpers themselves.
+ */
+export interface MediaBuyActionContext {
+    media_buy_id?: string;
+    status?: string;
+    start_time?: string;
+    end_time?: string;
+    packages?: ReadonlyArray<{
+        package_id?: string;
+        budget?: number;
+        start_time?: string;
+        end_time?: string;
+    }>;
+    available_actions?: MediaBuyAvailableAction[];
+    valid_actions?: MediaBuyValidAction[];
+}
+/**
+ * Subset of `UpdateMediaBuyRequest` the resolver introspects. Reusing a
+ * minimal interface keeps the preflight independent of the generated
+ * request type so a schema bump that adds optional fields doesn't churn the
+ * resolver signature.
+ */
+export interface UpdateMediaBuyRequestLike {
+    paused?: boolean;
+    canceled?: true;
+    cancellation_reason?: string;
+    start_time?: {
+        datetime?: string;
+    } | string;
+    end_time?: string;
+    new_packages?: ReadonlyArray<unknown>;
+    packages?: ReadonlyArray<{
+        package_id: string;
+        budget?: number;
+        pacing?: unknown;
+        start_time?: string;
+        end_time?: string;
+        paused?: boolean;
+        canceled?: true;
+        targeting_overlay?: {
+            frequency_cap?: unknown;
+            [k: string]: unknown;
+        };
+        keyword_targets_add?: unknown;
+        keyword_targets_remove?: unknown;
+        negative_keywords_add?: unknown;
+        negative_keywords_remove?: unknown;
+        creative_assignments?: unknown;
+        creatives?: unknown;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/media-buy/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/media-buy/types.ts"],"names":[],"mappings":"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"}

package/dist/lib/media-buy/types.js

@@ -0,0 +1,25 @@
+"use strict";
+// Buyer-side types for the available_actions surface (AdCP 3.1, RFC #4480).
+//
+// Hand-written until schemas/cache/ catches up to the 3.1 release and the
+// codegen regenerates `*.generated.ts`. Mirrors:
+//   - schemas/source/core/media-buy-available-action.json
+//   - schemas/source/core/sla-window.json
+//   - schemas/source/enums/media-buy-action-mode.json
+//   - schemas/source/enums/media-buy-valid-action.json
+//   - schemas/source/enums/action-not-allowed-reason.json
+//   - schemas/source/error-details/action-not-allowed.json
+//
+// When `sync-schemas` next runs and produces the equivalent types under
+// `src/lib/types/*.generated.ts`, this file should be deleted and the public
+// re-exports in `src/lib/media-buy/index.ts` should point at the generated
+// names.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LEGACY_COARSE_ACTIONS = void 0;
+exports.LEGACY_COARSE_ACTIONS = [
+    'update_budget',
+    'update_dates',
+    'update_packages',
+    'sync_creatives',
+];
+//# sourceMappingURL=types.js.map

package/dist/lib/media-buy/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/media-buy/types.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,EAAE;AACF,0EAA0E;AAC1E,iDAAiD;AACjD,0DAA0D;AAC1D,0CAA0C;AAC1C,sDAAsD;AACtD,uDAAuD;AACvD,0DAA0D;AAC1D,2DAA2D;AAC3D,EAAE;AACF,wEAAwE;AACxE,6EAA6E;AAC7E,2EAA2E;AAC3E,SAAS;;;AA8BI,QAAA,qBAAqB,GAAG;IACnC,eAAe;IACf,cAAc;IACd,iBAAiB;IACjB,gBAAgB;CACiC,CAAC"}

package/dist/lib/media-buy/update-fields.generated.d.ts

@@ -0,0 +1,14 @@
+import type { MediaBuyValidAction } from './types';
+export interface UpdateFieldEntry {
+    /** Dotted paths into the update_media_buy request body this action covers. */
+    readonly update_fields: readonly string[];
+    /** Fine-grained values this action rolls up to (legacy coarse actions only). */
+    readonly rollup: readonly MediaBuyValidAction[] | null;
+    /** True for `x-deprecated-enum-values` (legacy coarse vocabulary). */
+    readonly deprecated: boolean;
+}
+export declare const UPDATE_FIELDS_BY_ACTION: Readonly<Record<MediaBuyValidAction, UpdateFieldEntry>>;
+export declare const ACTIONS_BY_FIELD: Readonly<Record<string, readonly MediaBuyValidAction[]>>;
+export { LEGACY_COARSE_ACTIONS } from './types';
+export type { LegacyCoarseAction } from './types';
+//# sourceMappingURL=update-fields.generated.d.ts.map

package/dist/lib/media-buy/update-fields.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-fields.generated.d.ts","sourceRoot":"","sources":["../../../src/lib/media-buy/update-fields.generated.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,GAAG,IAAI,CAAC;IACvD,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAC5C,MAAM,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CA2GrC,CAAC;AAEX,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CACrC,MAAM,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC,CAqBtC,CAAC;AAEX,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC"}