@adcp/sdk 14.0.0-rc.38 → 14.0.0-rc.39

package/dist/lib/media-buy/index.mjs

@@ -42,6 +42,7 @@ import { applyTargetingInput, hasTargetingClears, resolveTargetingInput } from "
 export * from "./compatibility.mjs";
 export * from "./established-proposal-store.mjs";
 export * from "./legacy-purchase-continuation.mjs";
+export * from "./actions.mjs";
 export {
   ACTIONS_BY_FIELD,
   LEGACY_COARSE_ACTIONS,

package/dist/lib/media-buy/legacy-action-ids.d.mts

@@ -0,0 +1 @@
+export declare const V3_1_ACTION_IDS: readonly ["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"];

package/dist/lib/media-buy/legacy-action-ids.d.ts

@@ -0,0 +1 @@
+export declare const V3_1_ACTION_IDS: readonly ["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"];

package/dist/lib/media-buy/legacy-action-ids.js

@@ -0,0 +1,50 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var legacy_action_ids_exports = {};
+__export(legacy_action_ids_exports, {
+  V3_1_ACTION_IDS: () => V3_1_ACTION_IDS
+});
+module.exports = __toCommonJS(legacy_action_ids_exports);
+const V3_1_ACTION_IDS = [
+  "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"
+];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  V3_1_ACTION_IDS
+});

package/dist/lib/media-buy/legacy-action-ids.mjs

@@ -0,0 +1,26 @@
+const V3_1_ACTION_IDS = [
+  "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 {
+  V3_1_ACTION_IDS
+};

package/dist/lib/media-buy/mutations.d.mts

@@ -0,0 +1,70 @@
+import type { MediaBuyActionContext, MediaBuyActionId, UpdateMediaBuyRequestLike } from './types.mjs';
+export type MediaBuyMutationDirection = 'increase' | 'decrease' | 'reallocate' | 'extend' | 'shorten' | 'shift';
+/**
+ * One action a request body covers, plus the direction inference where the
+ * fine-grained vocabulary distinguishes increase/decrease or
+ * extend/shorten. `touched_fields` lists the normalized dotted paths that
+ * triggered this entry (useful for debugging).
+ */
+export interface ResolvedAction {
+    action: MediaBuyActionId;
+    /**
+     * Direction tag. Present when the resolver picked between fine-grained
+     * siblings (e.g. `increase_budget` vs `decrease_budget`).
+     */
+    direction?: MediaBuyMutationDirection;
+    touched_fields: string[];
+}
+export type MediaBuyMutationScope = 'buy' | 'package' | 'packages';
+/**
+ * One concrete requested mutation inside an `update_media_buy` patch.
+ *
+ * `field` is the normalized schema path used for action mapping
+ * (`packages[].budget`), while `path` is the concrete request path
+ * (`packages[0].budget`) that adopter code can use for diagnostics or
+ * dispatch. `from` is best-effort and only populated for fields the helper can
+ * read from the supplied current buy snapshot.
+ */
+export interface DecomposedUpdateMediaBuyMutation {
+    action: MediaBuyActionId;
+    direction?: MediaBuyMutationDirection;
+    field: string;
+    path: string;
+    scope: MediaBuyMutationScope;
+    package_id?: string;
+    package_index?: number;
+    from?: unknown;
+    to?: unknown;
+}
+export interface DecomposedUpdateMediaBuy {
+    /** Concrete mutations requested by the patch. Empty when no known fields were touched. */
+    mutations: DecomposedUpdateMediaBuyMutation[];
+    /** Aggregated action view, preserving the legacy `getActionForMutation()` shape. */
+    actions: ResolvedAction[];
+    /** Unique normalized fields touched by this patch, in request traversal order. */
+    touched_fields: string[];
+}
+/**
+ * Walk the request body and return the set of fine-grained actions it
+ * covers. Compatibility wrapper over `decomposeUpdateMediaBuy()` for callers
+ * that only need the action-level view. Hydrated change_terms select canonical
+ * field bindings; without them, this wrapper retains legacy action mappings.
+ *
+ * Returns an empty array when the request touches no recognized field
+ * (e.g. only `idempotency_key` / `revision` / `account` were set).
+ */
+export declare function getActionForMutation(currentBuy: MediaBuyActionContext, request: UpdateMediaBuyRequestLike): ResolvedAction[];
+/**
+ * Decompose an `update_media_buy` patch into the concrete mutations it
+ * requests plus the fine-grained actions those mutations require.
+ *
+ * This is intentionally read-only: it does not validate availability or
+ * mutate the request. Buyer code can use it for previews and preflight;
+ * seller/adopter code can use it to dispatch individual patch operations
+ * without re-walking the raw request.
+ */
+export declare function decomposeUpdateMediaBuy(currentBuy: MediaBuyActionContext, request: UpdateMediaBuyRequestLike): DecomposedUpdateMediaBuy;
+/** Fail closed on unmodeled mutation fields; envelope data does not create an action. */
+export declare function hasUnmappedMutation(request: UpdateMediaBuyRequestLike, decomposition: DecomposedUpdateMediaBuy): boolean;
+/** Minimal structural guard for JSON callers; full wire validation remains at dispatch. */
+export declare function mutationShapeIssue(request: unknown): string | undefined;

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

@@ -0,0 +1,70 @@
+import type { MediaBuyActionContext, MediaBuyActionId, UpdateMediaBuyRequestLike } from './types';
+export type MediaBuyMutationDirection = 'increase' | 'decrease' | 'reallocate' | 'extend' | 'shorten' | 'shift';
+/**
+ * One action a request body covers, plus the direction inference where the
+ * fine-grained vocabulary distinguishes increase/decrease or
+ * extend/shorten. `touched_fields` lists the normalized dotted paths that
+ * triggered this entry (useful for debugging).
+ */
+export interface ResolvedAction {
+    action: MediaBuyActionId;
+    /**
+     * Direction tag. Present when the resolver picked between fine-grained
+     * siblings (e.g. `increase_budget` vs `decrease_budget`).
+     */
+    direction?: MediaBuyMutationDirection;
+    touched_fields: string[];
+}
+export type MediaBuyMutationScope = 'buy' | 'package' | 'packages';
+/**
+ * One concrete requested mutation inside an `update_media_buy` patch.
+ *
+ * `field` is the normalized schema path used for action mapping
+ * (`packages[].budget`), while `path` is the concrete request path
+ * (`packages[0].budget`) that adopter code can use for diagnostics or
+ * dispatch. `from` is best-effort and only populated for fields the helper can
+ * read from the supplied current buy snapshot.
+ */
+export interface DecomposedUpdateMediaBuyMutation {
+    action: MediaBuyActionId;
+    direction?: MediaBuyMutationDirection;
+    field: string;
+    path: string;
+    scope: MediaBuyMutationScope;
+    package_id?: string;
+    package_index?: number;
+    from?: unknown;
+    to?: unknown;
+}
+export interface DecomposedUpdateMediaBuy {
+    /** Concrete mutations requested by the patch. Empty when no known fields were touched. */
+    mutations: DecomposedUpdateMediaBuyMutation[];
+    /** Aggregated action view, preserving the legacy `getActionForMutation()` shape. */
+    actions: ResolvedAction[];
+    /** Unique normalized fields touched by this patch, in request traversal order. */
+    touched_fields: string[];
+}
+/**
+ * Walk the request body and return the set of fine-grained actions it
+ * covers. Compatibility wrapper over `decomposeUpdateMediaBuy()` for callers
+ * that only need the action-level view. Hydrated change_terms select canonical
+ * field bindings; without them, this wrapper retains legacy action mappings.
+ *
+ * Returns an empty array when the request touches no recognized field
+ * (e.g. only `idempotency_key` / `revision` / `account` were set).
+ */
+export declare function getActionForMutation(currentBuy: MediaBuyActionContext, request: UpdateMediaBuyRequestLike): ResolvedAction[];
+/**
+ * Decompose an `update_media_buy` patch into the concrete mutations it
+ * requests plus the fine-grained actions those mutations require.
+ *
+ * This is intentionally read-only: it does not validate availability or
+ * mutate the request. Buyer code can use it for previews and preflight;
+ * seller/adopter code can use it to dispatch individual patch operations
+ * without re-walking the raw request.
+ */
+export declare function decomposeUpdateMediaBuy(currentBuy: MediaBuyActionContext, request: UpdateMediaBuyRequestLike): DecomposedUpdateMediaBuy;
+/** Fail closed on unmodeled mutation fields; envelope data does not create an action. */
+export declare function hasUnmappedMutation(request: UpdateMediaBuyRequestLike, decomposition: DecomposedUpdateMediaBuy): boolean;
+/** Minimal structural guard for JSON callers; full wire validation remains at dispatch. */
+export declare function mutationShapeIssue(request: unknown): string | undefined;