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

package/dist/lib/media-buy/action-contracts.js

@@ -0,0 +1,304 @@
+"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 action_contracts_exports = {};
+__export(action_contracts_exports, {
+  NON_TERMINAL_ACTION_STATUSES: () => NON_TERMINAL_ACTION_STATUSES,
+  actionAllowedStatuses: () => actionAllowedStatuses,
+  actionFitsErrorDetails: () => actionFitsErrorDetails,
+  changeConstraintIssues: () => changeConstraintIssues,
+  changeTermIssues: () => changeTermIssues,
+  defaultMediaBuyActionTask: () => defaultMediaBuyActionTask,
+  elapsedDuration: () => elapsedDuration,
+  findProductAction: () => findProductAction,
+  legacyActionSupported: () => legacyActionSupported,
+  liveActionFitsVersion: () => liveActionFitsVersion,
+  liveActionIssues: () => liveActionIssues,
+  mediaBuyActionTasks: () => mediaBuyActionTasks,
+  packageActionStatus: () => packageActionStatus,
+  productTemplateIssues: () => productTemplateIssues,
+  slaValid: () => slaValid,
+  slaWithin: () => slaWithin,
+  supportsChangeTermIdentity: () => supportsChangeTermIdentity,
+  supportsRc3Actions: () => supportsRc3Actions,
+  withActionProposal: () => withActionProposal
+});
+module.exports = __toCommonJS(action_contracts_exports);
+var import_action_metadata = require('./action-metadata.generated.js');
+var import_legacy_action_ids = require('./legacy-action-ids.js');
+var import_media_buy_helpers = require('../server/media-buy-helpers.js');
+var import_available_actions = require('./available-actions.js');
+const NON_TERMINAL_ACTION_STATUSES = ["pending_creatives", "pending_start", "active", "paused"];
+const MODES = ["self_serve", "conditional_self_serve", "seller_managed", "requires_approval"];
+const record = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const finite = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0;
+function mediaBuyActionTasks(action) {
+  return Object.hasOwn(import_action_metadata.CANONICAL_ACTION_TASKS, action) ? import_action_metadata.CANONICAL_ACTION_TASKS[action] ?? [] : [];
+}
+function defaultMediaBuyActionTask(action) {
+  return ["control_media_buy", "refine_proposals", "sync_creatives"].find(
+    (task) => mediaBuyActionTasks(action).includes(task)
+  );
+}
+function actionAllowedStatuses(term) {
+  return NON_TERMINAL_ACTION_STATUSES.filter((status) => {
+    if (term.allowed_statuses && !term.allowed_statuses.includes(status)) return false;
+    if (term.allowed_statuses) return true;
+    if (["pause", "resume", "cancel"].includes(term.action)) {
+      return (0, import_media_buy_helpers.validActionsForStatus)(status).includes(term.action);
+    }
+    const parent = (0, import_available_actions.getRollupParent)(term.action) ?? (["update_budget_allocation", "update_spend_target"].includes(term.action) ? "update_budget" : "update_packages");
+    const defaults = (0, import_media_buy_helpers.validActionsForStatus)(status);
+    return defaults.includes(term.action === "add_packages" ? term.action : parent);
+  });
+}
+function elapsedDuration(value) {
+  if (!record(value) || !Number.isSafeInteger(value.interval) || value.interval < 1) return void 0;
+  const factor = { seconds: 1e3, minutes: 6e4, hours: 36e5, days: 864e5 }[String(value.unit)];
+  if (factor === void 0) return void 0;
+  const result = value.interval * factor;
+  return Number.isFinite(result) ? result : void 0;
+}
+function isoElapsed(value) {
+  const match = /^P(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?)?$/.exec(value);
+  if (!match || !match.slice(1).some((x) => x !== void 0)) return void 0;
+  const result = Number(match[1] ?? 0) * 86400 + Number(match[2] ?? 0) * 3600 + Number(match[3] ?? 0) * 60 + Number(match[4] ?? 0);
+  return Number.isFinite(result) ? result : void 0;
+}
+function slaWithin(ceiling, candidate) {
+  for (const key of ["response_max", "completion_max"]) {
+    const promised = ceiling?.[key];
+    if (promised === void 0) continue;
+    const actual = candidate?.[key];
+    if (actual === promised) continue;
+    if (actual === void 0) return false;
+    const a = isoElapsed(actual), b = isoElapsed(promised);
+    if (a === void 0 || b === void 0 || a > b) return false;
+  }
+  return true;
+}
+const CONSTRAINT_FIELDS = {
+  budget: ["max_delta_amount", "max_delta_percent", "min_result_amount", "max_result_amount"],
+  flight: ["max_change", "earliest_result", "latest_result", "minimum_notice"],
+  package_count: ["max_additions", "max_removals", "max_result_count"],
+  effective_timing: ["minimum_notice", "earliest_effective_at", "latest_effective_at"]
+};
+function changeConstraintIssues(action, constraints, currency) {
+  if (constraints === void 0) return [];
+  if (!record(constraints)) return ["constraints must be an object"];
+  const kind = String(constraints.kind);
+  const fields = Object.hasOwn(CONSTRAINT_FIELDS, kind) ? CONSTRAINT_FIELDS[kind] : void 0;
+  const actions = Object.hasOwn(import_action_metadata.CHANGE_CONSTRAINT_ACTIONS, kind) ? import_action_metadata.CHANGE_CONSTRAINT_ACTIONS[kind] : void 0;
+  if (!fields || !actions?.includes(action)) return ["constraint/action incompatibility"];
+  if (Object.keys(constraints).some((key) => key !== "kind" && !fields.includes(key)))
+    return ["unknown constraint field"];
+  if (!fields.some((key) => constraints[key] !== void 0)) return ["empty constraints"];
+  const issues = [];
+  for (const key of fields) {
+    const value = constraints[key];
+    if (value === void 0) continue;
+    if (key.endsWith("_amount")) {
+      if (!record(value) || !finite(value.amount) || typeof value.currency !== "string" || !/^[A-Z]{3}$/.test(value.currency) || Object.keys(value).some((k) => !["amount", "currency"].includes(k)) || currency !== void 0 && value.currency !== currency)
+        issues.push(`invalid ${key}`);
+    } else if (key === "max_change" || key === "minimum_notice") {
+      if (!record(value) || !Number.isSafeInteger(value.interval) || value.interval < 1 || !["seconds", "minutes", "hours", "days", "campaign"].includes(String(value.unit)) || value.unit === "campaign" && value.interval !== 1 || Object.keys(value).some((k) => !["interval", "unit"].includes(k)))
+        issues.push(`invalid ${key}`);
+    } else if (key.startsWith("earliest_") || key.startsWith("latest_")) {
+      if (typeof value !== "string" || !Number.isFinite(Date.parse(value))) issues.push(`invalid ${key}`);
+    } else if (!finite(value) || constraints.kind === "package_count" && !Number.isSafeInteger(value))
+      issues.push(`invalid ${key}`);
+  }
+  const min = constraints.min_result_amount, max = constraints.max_result_amount;
+  if (record(min) && record(max) && (min.currency !== max.currency || Number(min.amount) > Number(max.amount)))
+    issues.push("inconsistent money bounds");
+  for (const [a, b] of [
+    ["earliest_result", "latest_result"],
+    ["earliest_effective_at", "latest_effective_at"]
+  ]) {
+    if (typeof constraints[a] === "string" && typeof constraints[b] === "string" && Date.parse(constraints[a]) > Date.parse(constraints[b]))
+      issues.push("inconsistent time bounds");
+  }
+  return issues;
+}
+function slaValid(sla) {
+  return sla === void 0 || record(sla) && Object.entries(sla).every(
+    ([k, v]) => ["response_max", "completion_max"].includes(k) && typeof v === "string" && /^P(?!$)(\d+Y)?(\d+M)?(\d+D)?(T(\d+H)?(\d+M)?(\d+S)?)?$/.test(v)
+  );
+}
+function changeTermIssues(terms, currency) {
+  if (!Array.isArray(terms) || terms.length > 256) return ["invalid change_terms array"];
+  const ids = /* @__PURE__ */ new Set(), actions = /* @__PURE__ */ new Set(), issues = [];
+  for (const term of terms) {
+    if (!record(term)) {
+      issues.push("invalid change term");
+      continue;
+    }
+    if (typeof term.term_id !== "string" || !/^[A-Za-z0-9_.:-]+$/.test(term.term_id) || ids.has(term.term_id))
+      issues.push("invalid or duplicate term identity");
+    if (actions.has(term.action) || !import_action_metadata.CHANGE_TERM_ACTIONS.includes(term.action))
+      issues.push("invalid or duplicate action identity");
+    if (!MODES.includes(term.service_mode)) issues.push("invalid service mode");
+    if (term.allowed_statuses !== void 0 && (!Array.isArray(term.allowed_statuses) || !term.allowed_statuses.length || new Set(term.allowed_statuses).size !== term.allowed_statuses.length || term.allowed_statuses.some((s) => !NON_TERMINAL_ACTION_STATUSES.includes(s))))
+      issues.push("invalid status scope");
+    if (term.conditions !== void 0 && (!Array.isArray(term.conditions) || !term.conditions.length || new Set(term.conditions).size !== term.conditions.length || term.conditions.some((c) => typeof c !== "string" || !/^[A-Za-z0-9][A-Za-z0-9_.:-]{0,199}$/.test(c))))
+      issues.push("invalid conditions");
+    if (!slaValid(term.processing_sla)) issues.push("invalid SLA");
+    for (const key of ["terms_ref", "description"])
+      if (term[key] !== void 0 && (typeof term[key] !== "string" || !term[key].length || term[key].length > 1e3))
+        issues.push(`invalid ${key}`);
+    if (Object.keys(term).some(
+      (k) => ![
+        "term_id",
+        "action",
+        "service_mode",
+        "allowed_statuses",
+        "processing_sla",
+        "constraints",
+        "conditions",
+        "terms_ref",
+        "description",
+        "ext"
+      ].includes(k)
+    ))
+      issues.push("unknown change term field");
+    issues.push(...changeConstraintIssues(term.action, term.constraints, currency));
+    ids.add(term.term_id);
+    actions.add(term.action);
+  }
+  return issues;
+}
+function productTemplateIssues(templates, currency) {
+  if (!Array.isArray(templates) || templates.length > 256) return ["invalid allowed_actions array"];
+  const seen = /* @__PURE__ */ new Set(), issues = [];
+  for (const template of templates) {
+    if (!record(template) || seen.has(template.action)) {
+      issues.push("duplicate or invalid product action");
+      continue;
+    }
+    seen.add(template.action);
+    if (!Array.isArray(template.modes) || !template.modes.length || new Set(template.modes).size !== template.modes.length || template.modes.some((m) => !MODES.includes(m)))
+      issues.push("invalid product modes");
+    issues.push(
+      ...changeTermIssues(
+        [
+          {
+            term_id: "template",
+            action: import_action_metadata.CHANGE_TERM_ACTIONS.find(
+              (action) => (0, import_available_actions.getRollupParent)(action) === template.action && changeConstraintIssues(action, template.constraints, currency).length === 0
+            ) ?? template.action,
+            service_mode: template.modes?.[0],
+            allowed_statuses: void 0,
+            processing_sla: template.sla,
+            constraints: template.constraints,
+            terms_ref: template.terms_ref
+          }
+        ],
+        currency
+      ).filter((issue) => issue !== "invalid or duplicate action identity")
+    );
+    if (![...import_action_metadata.CHANGE_TERM_ACTIONS, ...import_action_metadata.LEGACY_AVAILABLE_ACTIONS].includes(template.action))
+      issues.push("invalid product action");
+    if (template.allowed_statuses !== void 0 && (!Array.isArray(template.allowed_statuses) || !template.allowed_statuses.length || new Set(template.allowed_statuses).size !== template.allowed_statuses.length || template.allowed_statuses.some(
+      (status) => ![...NON_TERMINAL_ACTION_STATUSES, "completed", "rejected", "canceled"].includes(status)
+    )))
+      issues.push("invalid product status scope");
+  }
+  return issues;
+}
+function findProductAction(templates, action) {
+  return templates?.find((t) => t.action === action) ?? templates?.find((t) => t.action === (0, import_available_actions.getRollupParent)(action));
+}
+function legacyActionSupported(action) {
+  return import_legacy_action_ids.V3_1_ACTION_IDS.includes(action);
+}
+function liveActionIssues(entries) {
+  if (!Array.isArray(entries)) return ["invalid live action array"];
+  const seen = /* @__PURE__ */ new Set();
+  for (const entry of entries) {
+    if (!record(entry) || typeof entry.action !== "string" || !entry.action || typeof entry.mode !== "string" || !entry.mode || seen.has(entry.action))
+      return ["invalid or duplicate live action"];
+    seen.add(entry.action);
+    if (entry.task !== void 0 && !["control_media_buy", "refine_proposals", "sync_creatives"].includes(String(entry.task)))
+      return ["invalid live task"];
+    if (!slaValid(entry.sla)) return ["invalid live SLA"];
+    if (entry.change_term_id !== void 0 && (typeof entry.change_term_id !== "string" || !/^[A-Za-z0-9_.:-]+$/.test(entry.change_term_id)))
+      return ["invalid live term identity"];
+    if (entry.terms_ref !== void 0 && typeof entry.terms_ref !== "string") return ["invalid opaque reference"];
+    if (entry.applicable_package_ids !== void 0 && (!Array.isArray(entry.applicable_package_ids) || !entry.applicable_package_ids.length || entry.applicable_package_ids.some((id) => typeof id !== "string" || !id) || new Set(entry.applicable_package_ids).size !== entry.applicable_package_ids.length))
+      return ["invalid package scope"];
+  }
+  return [];
+}
+function supportsChangeTermIdentity(version) {
+  const match = /^(\d+)\.(\d+)(?:\.(\d+))?(?:-(.*))?$/.exec(version);
+  if (!match) return false;
+  if (Number(match[1]) > 3 || Number(match[1]) === 3 && Number(match[2]) > 2) return true;
+  if (Number(match[1]) !== 3 || Number(match[2]) !== 2) return false;
+  return !match[4] || /^rc\.\d+$/.test(match[4]) || /^beta\.(\d+)$/.test(match[4]) && Number(match[4].slice(5)) >= 9;
+}
+function supportsRc3Actions(version) {
+  const match = /^(\d+)\.(\d+)(?:\.(\d+))?(?:-(.*))?$/.exec(version);
+  if (!match) return false;
+  if (Number(match[1]) > 3 || Number(match[1]) === 3 && Number(match[2]) > 2) return true;
+  if (Number(match[1]) !== 3 || Number(match[2]) !== 2) return false;
+  return !match[4] || /^rc\.(\d+)$/.test(match[4]) && Number(match[4].slice(3)) >= 3;
+}
+function liveActionFitsVersion(entry, version) {
+  if (/^3\.[01](?:\.|-|$)/.test(version) && (!legacyActionSupported(entry.action) || entry.task !== void 0))
+    return false;
+  if (!supportsChangeTermIdentity(version) && (entry.change_term_id !== void 0 || entry.mode === "seller_managed"))
+    return false;
+  return supportsRc3Actions(version) || entry.action !== "update_media_buy_frequency_cap" && entry.applicable_package_ids === void 0;
+}
+function actionFitsErrorDetails(action, version) {
+  if (/^3\.[01](?:\.|-|$)/.test(version)) return legacyActionSupported(action);
+  return import_action_metadata.LEGACY_AVAILABLE_ACTIONS.includes(action) || action === "update_media_buy_frequency_cap" && supportsRc3Actions(version);
+}
+function withActionProposal(buy, options) {
+  return buy.accepted_proposal === void 0 && options.proposal !== void 0 ? { ...buy, accepted_proposal: options.proposal } : buy;
+}
+function packageActionStatus(pkg) {
+  if (pkg?.canceled === true) return "canceled";
+  if (pkg?.status && ["completed", "canceled", "failed", "rejected"].includes(pkg.status)) return pkg.status;
+  if (pkg?.status !== void 0 && !NON_TERMINAL_ACTION_STATUSES.includes(pkg.status))
+    return void 0;
+  if (pkg?.status === "pending_start" || pkg?.status === "pending_creatives") return pkg.status;
+  return pkg?.paused === true ? "paused" : pkg?.status ?? (pkg ? "active" : void 0);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  NON_TERMINAL_ACTION_STATUSES,
+  actionAllowedStatuses,
+  actionFitsErrorDetails,
+  changeConstraintIssues,
+  changeTermIssues,
+  defaultMediaBuyActionTask,
+  elapsedDuration,
+  findProductAction,
+  legacyActionSupported,
+  liveActionFitsVersion,
+  liveActionIssues,
+  mediaBuyActionTasks,
+  packageActionStatus,
+  productTemplateIssues,
+  slaValid,
+  slaWithin,
+  supportsChangeTermIdentity,
+  supportsRc3Actions,
+  withActionProposal
+});

package/dist/lib/media-buy/action-contracts.mjs

@@ -0,0 +1,267 @@
+import {
+  CANONICAL_ACTION_TASKS,
+  CHANGE_CONSTRAINT_ACTIONS,
+  CHANGE_TERM_ACTIONS,
+  LEGACY_AVAILABLE_ACTIONS
+} from "./action-metadata.generated.mjs";
+import { V3_1_ACTION_IDS } from "./legacy-action-ids.mjs";
+import { validActionsForStatus } from "../server/media-buy-helpers.mjs";
+import { getRollupParent } from "./available-actions.mjs";
+const NON_TERMINAL_ACTION_STATUSES = ["pending_creatives", "pending_start", "active", "paused"];
+const MODES = ["self_serve", "conditional_self_serve", "seller_managed", "requires_approval"];
+const record = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const finite = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0;
+function mediaBuyActionTasks(action) {
+  return Object.hasOwn(CANONICAL_ACTION_TASKS, action) ? CANONICAL_ACTION_TASKS[action] ?? [] : [];
+}
+function defaultMediaBuyActionTask(action) {
+  return ["control_media_buy", "refine_proposals", "sync_creatives"].find(
+    (task) => mediaBuyActionTasks(action).includes(task)
+  );
+}
+function actionAllowedStatuses(term) {
+  return NON_TERMINAL_ACTION_STATUSES.filter((status) => {
+    if (term.allowed_statuses && !term.allowed_statuses.includes(status)) return false;
+    if (term.allowed_statuses) return true;
+    if (["pause", "resume", "cancel"].includes(term.action)) {
+      return validActionsForStatus(status).includes(term.action);
+    }
+    const parent = getRollupParent(term.action) ?? (["update_budget_allocation", "update_spend_target"].includes(term.action) ? "update_budget" : "update_packages");
+    const defaults = validActionsForStatus(status);
+    return defaults.includes(term.action === "add_packages" ? term.action : parent);
+  });
+}
+function elapsedDuration(value) {
+  if (!record(value) || !Number.isSafeInteger(value.interval) || value.interval < 1) return void 0;
+  const factor = { seconds: 1e3, minutes: 6e4, hours: 36e5, days: 864e5 }[String(value.unit)];
+  if (factor === void 0) return void 0;
+  const result = value.interval * factor;
+  return Number.isFinite(result) ? result : void 0;
+}
+function isoElapsed(value) {
+  const match = /^P(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?)?$/.exec(value);
+  if (!match || !match.slice(1).some((x) => x !== void 0)) return void 0;
+  const result = Number(match[1] ?? 0) * 86400 + Number(match[2] ?? 0) * 3600 + Number(match[3] ?? 0) * 60 + Number(match[4] ?? 0);
+  return Number.isFinite(result) ? result : void 0;
+}
+function slaWithin(ceiling, candidate) {
+  for (const key of ["response_max", "completion_max"]) {
+    const promised = ceiling?.[key];
+    if (promised === void 0) continue;
+    const actual = candidate?.[key];
+    if (actual === promised) continue;
+    if (actual === void 0) return false;
+    const a = isoElapsed(actual), b = isoElapsed(promised);
+    if (a === void 0 || b === void 0 || a > b) return false;
+  }
+  return true;
+}
+const CONSTRAINT_FIELDS = {
+  budget: ["max_delta_amount", "max_delta_percent", "min_result_amount", "max_result_amount"],
+  flight: ["max_change", "earliest_result", "latest_result", "minimum_notice"],
+  package_count: ["max_additions", "max_removals", "max_result_count"],
+  effective_timing: ["minimum_notice", "earliest_effective_at", "latest_effective_at"]
+};
+function changeConstraintIssues(action, constraints, currency) {
+  if (constraints === void 0) return [];
+  if (!record(constraints)) return ["constraints must be an object"];
+  const kind = String(constraints.kind);
+  const fields = Object.hasOwn(CONSTRAINT_FIELDS, kind) ? CONSTRAINT_FIELDS[kind] : void 0;
+  const actions = Object.hasOwn(CHANGE_CONSTRAINT_ACTIONS, kind) ? CHANGE_CONSTRAINT_ACTIONS[kind] : void 0;
+  if (!fields || !actions?.includes(action)) return ["constraint/action incompatibility"];
+  if (Object.keys(constraints).some((key) => key !== "kind" && !fields.includes(key)))
+    return ["unknown constraint field"];
+  if (!fields.some((key) => constraints[key] !== void 0)) return ["empty constraints"];
+  const issues = [];
+  for (const key of fields) {
+    const value = constraints[key];
+    if (value === void 0) continue;
+    if (key.endsWith("_amount")) {
+      if (!record(value) || !finite(value.amount) || typeof value.currency !== "string" || !/^[A-Z]{3}$/.test(value.currency) || Object.keys(value).some((k) => !["amount", "currency"].includes(k)) || currency !== void 0 && value.currency !== currency)
+        issues.push(`invalid ${key}`);
+    } else if (key === "max_change" || key === "minimum_notice") {
+      if (!record(value) || !Number.isSafeInteger(value.interval) || value.interval < 1 || !["seconds", "minutes", "hours", "days", "campaign"].includes(String(value.unit)) || value.unit === "campaign" && value.interval !== 1 || Object.keys(value).some((k) => !["interval", "unit"].includes(k)))
+        issues.push(`invalid ${key}`);
+    } else if (key.startsWith("earliest_") || key.startsWith("latest_")) {
+      if (typeof value !== "string" || !Number.isFinite(Date.parse(value))) issues.push(`invalid ${key}`);
+    } else if (!finite(value) || constraints.kind === "package_count" && !Number.isSafeInteger(value))
+      issues.push(`invalid ${key}`);
+  }
+  const min = constraints.min_result_amount, max = constraints.max_result_amount;
+  if (record(min) && record(max) && (min.currency !== max.currency || Number(min.amount) > Number(max.amount)))
+    issues.push("inconsistent money bounds");
+  for (const [a, b] of [
+    ["earliest_result", "latest_result"],
+    ["earliest_effective_at", "latest_effective_at"]
+  ]) {
+    if (typeof constraints[a] === "string" && typeof constraints[b] === "string" && Date.parse(constraints[a]) > Date.parse(constraints[b]))
+      issues.push("inconsistent time bounds");
+  }
+  return issues;
+}
+function slaValid(sla) {
+  return sla === void 0 || record(sla) && Object.entries(sla).every(
+    ([k, v]) => ["response_max", "completion_max"].includes(k) && typeof v === "string" && /^P(?!$)(\d+Y)?(\d+M)?(\d+D)?(T(\d+H)?(\d+M)?(\d+S)?)?$/.test(v)
+  );
+}
+function changeTermIssues(terms, currency) {
+  if (!Array.isArray(terms) || terms.length > 256) return ["invalid change_terms array"];
+  const ids = /* @__PURE__ */ new Set(), actions = /* @__PURE__ */ new Set(), issues = [];
+  for (const term of terms) {
+    if (!record(term)) {
+      issues.push("invalid change term");
+      continue;
+    }
+    if (typeof term.term_id !== "string" || !/^[A-Za-z0-9_.:-]+$/.test(term.term_id) || ids.has(term.term_id))
+      issues.push("invalid or duplicate term identity");
+    if (actions.has(term.action) || !CHANGE_TERM_ACTIONS.includes(term.action))
+      issues.push("invalid or duplicate action identity");
+    if (!MODES.includes(term.service_mode)) issues.push("invalid service mode");
+    if (term.allowed_statuses !== void 0 && (!Array.isArray(term.allowed_statuses) || !term.allowed_statuses.length || new Set(term.allowed_statuses).size !== term.allowed_statuses.length || term.allowed_statuses.some((s) => !NON_TERMINAL_ACTION_STATUSES.includes(s))))
+      issues.push("invalid status scope");
+    if (term.conditions !== void 0 && (!Array.isArray(term.conditions) || !term.conditions.length || new Set(term.conditions).size !== term.conditions.length || term.conditions.some((c) => typeof c !== "string" || !/^[A-Za-z0-9][A-Za-z0-9_.:-]{0,199}$/.test(c))))
+      issues.push("invalid conditions");
+    if (!slaValid(term.processing_sla)) issues.push("invalid SLA");
+    for (const key of ["terms_ref", "description"])
+      if (term[key] !== void 0 && (typeof term[key] !== "string" || !term[key].length || term[key].length > 1e3))
+        issues.push(`invalid ${key}`);
+    if (Object.keys(term).some(
+      (k) => ![
+        "term_id",
+        "action",
+        "service_mode",
+        "allowed_statuses",
+        "processing_sla",
+        "constraints",
+        "conditions",
+        "terms_ref",
+        "description",
+        "ext"
+      ].includes(k)
+    ))
+      issues.push("unknown change term field");
+    issues.push(...changeConstraintIssues(term.action, term.constraints, currency));
+    ids.add(term.term_id);
+    actions.add(term.action);
+  }
+  return issues;
+}
+function productTemplateIssues(templates, currency) {
+  if (!Array.isArray(templates) || templates.length > 256) return ["invalid allowed_actions array"];
+  const seen = /* @__PURE__ */ new Set(), issues = [];
+  for (const template of templates) {
+    if (!record(template) || seen.has(template.action)) {
+      issues.push("duplicate or invalid product action");
+      continue;
+    }
+    seen.add(template.action);
+    if (!Array.isArray(template.modes) || !template.modes.length || new Set(template.modes).size !== template.modes.length || template.modes.some((m) => !MODES.includes(m)))
+      issues.push("invalid product modes");
+    issues.push(
+      ...changeTermIssues(
+        [
+          {
+            term_id: "template",
+            action: CHANGE_TERM_ACTIONS.find(
+              (action) => getRollupParent(action) === template.action && changeConstraintIssues(action, template.constraints, currency).length === 0
+            ) ?? template.action,
+            service_mode: template.modes?.[0],
+            allowed_statuses: void 0,
+            processing_sla: template.sla,
+            constraints: template.constraints,
+            terms_ref: template.terms_ref
+          }
+        ],
+        currency
+      ).filter((issue) => issue !== "invalid or duplicate action identity")
+    );
+    if (![...CHANGE_TERM_ACTIONS, ...LEGACY_AVAILABLE_ACTIONS].includes(template.action))
+      issues.push("invalid product action");
+    if (template.allowed_statuses !== void 0 && (!Array.isArray(template.allowed_statuses) || !template.allowed_statuses.length || new Set(template.allowed_statuses).size !== template.allowed_statuses.length || template.allowed_statuses.some(
+      (status) => ![...NON_TERMINAL_ACTION_STATUSES, "completed", "rejected", "canceled"].includes(status)
+    )))
+      issues.push("invalid product status scope");
+  }
+  return issues;
+}
+function findProductAction(templates, action) {
+  return templates?.find((t) => t.action === action) ?? templates?.find((t) => t.action === getRollupParent(action));
+}
+function legacyActionSupported(action) {
+  return V3_1_ACTION_IDS.includes(action);
+}
+function liveActionIssues(entries) {
+  if (!Array.isArray(entries)) return ["invalid live action array"];
+  const seen = /* @__PURE__ */ new Set();
+  for (const entry of entries) {
+    if (!record(entry) || typeof entry.action !== "string" || !entry.action || typeof entry.mode !== "string" || !entry.mode || seen.has(entry.action))
+      return ["invalid or duplicate live action"];
+    seen.add(entry.action);
+    if (entry.task !== void 0 && !["control_media_buy", "refine_proposals", "sync_creatives"].includes(String(entry.task)))
+      return ["invalid live task"];
+    if (!slaValid(entry.sla)) return ["invalid live SLA"];
+    if (entry.change_term_id !== void 0 && (typeof entry.change_term_id !== "string" || !/^[A-Za-z0-9_.:-]+$/.test(entry.change_term_id)))
+      return ["invalid live term identity"];
+    if (entry.terms_ref !== void 0 && typeof entry.terms_ref !== "string") return ["invalid opaque reference"];
+    if (entry.applicable_package_ids !== void 0 && (!Array.isArray(entry.applicable_package_ids) || !entry.applicable_package_ids.length || entry.applicable_package_ids.some((id) => typeof id !== "string" || !id) || new Set(entry.applicable_package_ids).size !== entry.applicable_package_ids.length))
+      return ["invalid package scope"];
+  }
+  return [];
+}
+function supportsChangeTermIdentity(version) {
+  const match = /^(\d+)\.(\d+)(?:\.(\d+))?(?:-(.*))?$/.exec(version);
+  if (!match) return false;
+  if (Number(match[1]) > 3 || Number(match[1]) === 3 && Number(match[2]) > 2) return true;
+  if (Number(match[1]) !== 3 || Number(match[2]) !== 2) return false;
+  return !match[4] || /^rc\.\d+$/.test(match[4]) || /^beta\.(\d+)$/.test(match[4]) && Number(match[4].slice(5)) >= 9;
+}
+function supportsRc3Actions(version) {
+  const match = /^(\d+)\.(\d+)(?:\.(\d+))?(?:-(.*))?$/.exec(version);
+  if (!match) return false;
+  if (Number(match[1]) > 3 || Number(match[1]) === 3 && Number(match[2]) > 2) return true;
+  if (Number(match[1]) !== 3 || Number(match[2]) !== 2) return false;
+  return !match[4] || /^rc\.(\d+)$/.test(match[4]) && Number(match[4].slice(3)) >= 3;
+}
+function liveActionFitsVersion(entry, version) {
+  if (/^3\.[01](?:\.|-|$)/.test(version) && (!legacyActionSupported(entry.action) || entry.task !== void 0))
+    return false;
+  if (!supportsChangeTermIdentity(version) && (entry.change_term_id !== void 0 || entry.mode === "seller_managed"))
+    return false;
+  return supportsRc3Actions(version) || entry.action !== "update_media_buy_frequency_cap" && entry.applicable_package_ids === void 0;
+}
+function actionFitsErrorDetails(action, version) {
+  if (/^3\.[01](?:\.|-|$)/.test(version)) return legacyActionSupported(action);
+  return LEGACY_AVAILABLE_ACTIONS.includes(action) || action === "update_media_buy_frequency_cap" && supportsRc3Actions(version);
+}
+function withActionProposal(buy, options) {
+  return buy.accepted_proposal === void 0 && options.proposal !== void 0 ? { ...buy, accepted_proposal: options.proposal } : buy;
+}
+function packageActionStatus(pkg) {
+  if (pkg?.canceled === true) return "canceled";
+  if (pkg?.status && ["completed", "canceled", "failed", "rejected"].includes(pkg.status)) return pkg.status;
+  if (pkg?.status !== void 0 && !NON_TERMINAL_ACTION_STATUSES.includes(pkg.status))
+    return void 0;
+  if (pkg?.status === "pending_start" || pkg?.status === "pending_creatives") return pkg.status;
+  return pkg?.paused === true ? "paused" : pkg?.status ?? (pkg ? "active" : void 0);
+}
+export {
+  NON_TERMINAL_ACTION_STATUSES,
+  actionAllowedStatuses,
+  actionFitsErrorDetails,
+  changeConstraintIssues,
+  changeTermIssues,
+  defaultMediaBuyActionTask,
+  elapsedDuration,
+  findProductAction,
+  legacyActionSupported,
+  liveActionFitsVersion,
+  liveActionIssues,
+  mediaBuyActionTasks,
+  packageActionStatus,
+  productTemplateIssues,
+  slaValid,
+  slaWithin,
+  supportsChangeTermIdentity,
+  supportsRc3Actions,
+  withActionProposal
+};

package/dist/lib/media-buy/action-metadata.generated.d.mts

@@ -0,0 +1,37 @@
+export declare const CANONICAL_ACTION_TASKS: {
+    readonly pause: readonly ["control_media_buy"];
+    readonly resume: readonly ["control_media_buy"];
+    readonly cancel: readonly ["control_media_buy", "refine_proposals"];
+    readonly update_name: readonly ["control_media_buy"];
+    readonly increase_budget: readonly ["control_media_buy", "refine_proposals"];
+    readonly decrease_budget: readonly ["control_media_buy", "refine_proposals"];
+    readonly reallocate_budget: readonly ["control_media_buy", "refine_proposals"];
+    readonly update_budget_allocation: readonly ["control_media_buy", "refine_proposals"];
+    readonly update_targeting: readonly ["control_media_buy", "refine_proposals"];
+    readonly update_pacing: readonly ["control_media_buy", "refine_proposals"];
+    readonly update_bidding: readonly ["control_media_buy", "refine_proposals"];
+    readonly update_frequency_caps: readonly ["control_media_buy", "refine_proposals"];
+    readonly update_media_buy_frequency_cap: readonly ["control_media_buy", "refine_proposals"];
+    readonly update_catalog_assignments: readonly ["control_media_buy"];
+    readonly update_keywords: readonly ["control_media_buy"];
+    readonly update_optimization_goals: readonly ["control_media_buy"];
+    readonly update_impression_goal: readonly ["control_media_buy"];
+    readonly update_spend_target: readonly ["control_media_buy"];
+    readonly update_reporting_webhook: readonly ["control_media_buy"];
+    readonly remove_packages: readonly ["control_media_buy", "refine_proposals"];
+    readonly extend_flight: readonly ["refine_proposals"];
+    readonly shorten_flight: readonly ["refine_proposals"];
+    readonly update_flight_dates: readonly ["refine_proposals"];
+    readonly add_packages: readonly ["refine_proposals"];
+    readonly replace_creative: readonly ["sync_creatives"];
+    readonly update_creative_assignments: readonly ["sync_creatives"];
+    readonly remove_creative: readonly ["sync_creatives"];
+};
+export declare const CHANGE_CONSTRAINT_ACTIONS: {
+    readonly budget: readonly ["increase_budget", "decrease_budget", "reallocate_budget", "update_budget_allocation", "update_spend_target"];
+    readonly flight: readonly ["extend_flight", "shorten_flight", "update_flight_dates"];
+    readonly package_count: readonly ["add_packages", "remove_packages"];
+    readonly effective_timing: readonly ["pause", "resume", "cancel"];
+};
+export declare const LEGACY_AVAILABLE_ACTIONS: readonly ["pause", "resume", "cancel", "update_name", "extend_flight", "shorten_flight", "update_flight_dates", "increase_budget", "decrease_budget", "reallocate_budget", "update_budget_allocation", "update_targeting", "update_pacing", "update_bidding", "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 CHANGE_TERM_ACTIONS: readonly ["pause", "resume", "cancel", "extend_flight", "shorten_flight", "update_flight_dates", "increase_budget", "decrease_budget", "reallocate_budget", "update_budget_allocation", "update_targeting", "update_pacing", "update_bidding", "update_frequency_caps", "update_media_buy_frequency_cap", "update_catalog_assignments", "update_keywords", "update_optimization_goals", "update_impression_goal", "update_spend_target", "update_reporting_webhook", "replace_creative", "update_creative_assignments", "remove_creative", "add_packages", "remove_packages"];

package/dist/lib/media-buy/action-metadata.generated.d.ts

@@ -0,0 +1,37 @@
+export declare const CANONICAL_ACTION_TASKS: {
+    readonly pause: readonly ["control_media_buy"];
+    readonly resume: readonly ["control_media_buy"];
+    readonly cancel: readonly ["control_media_buy", "refine_proposals"];
+    readonly update_name: readonly ["control_media_buy"];
+    readonly increase_budget: readonly ["control_media_buy", "refine_proposals"];
+    readonly decrease_budget: readonly ["control_media_buy", "refine_proposals"];
+    readonly reallocate_budget: readonly ["control_media_buy", "refine_proposals"];
+    readonly update_budget_allocation: readonly ["control_media_buy", "refine_proposals"];
+    readonly update_targeting: readonly ["control_media_buy", "refine_proposals"];
+    readonly update_pacing: readonly ["control_media_buy", "refine_proposals"];
+    readonly update_bidding: readonly ["control_media_buy", "refine_proposals"];
+    readonly update_frequency_caps: readonly ["control_media_buy", "refine_proposals"];
+    readonly update_media_buy_frequency_cap: readonly ["control_media_buy", "refine_proposals"];
+    readonly update_catalog_assignments: readonly ["control_media_buy"];
+    readonly update_keywords: readonly ["control_media_buy"];
+    readonly update_optimization_goals: readonly ["control_media_buy"];
+    readonly update_impression_goal: readonly ["control_media_buy"];
+    readonly update_spend_target: readonly ["control_media_buy"];
+    readonly update_reporting_webhook: readonly ["control_media_buy"];
+    readonly remove_packages: readonly ["control_media_buy", "refine_proposals"];
+    readonly extend_flight: readonly ["refine_proposals"];
+    readonly shorten_flight: readonly ["refine_proposals"];
+    readonly update_flight_dates: readonly ["refine_proposals"];
+    readonly add_packages: readonly ["refine_proposals"];
+    readonly replace_creative: readonly ["sync_creatives"];
+    readonly update_creative_assignments: readonly ["sync_creatives"];
+    readonly remove_creative: readonly ["sync_creatives"];
+};
+export declare const CHANGE_CONSTRAINT_ACTIONS: {
+    readonly budget: readonly ["increase_budget", "decrease_budget", "reallocate_budget", "update_budget_allocation", "update_spend_target"];
+    readonly flight: readonly ["extend_flight", "shorten_flight", "update_flight_dates"];
+    readonly package_count: readonly ["add_packages", "remove_packages"];
+    readonly effective_timing: readonly ["pause", "resume", "cancel"];
+};
+export declare const LEGACY_AVAILABLE_ACTIONS: readonly ["pause", "resume", "cancel", "update_name", "extend_flight", "shorten_flight", "update_flight_dates", "increase_budget", "decrease_budget", "reallocate_budget", "update_budget_allocation", "update_targeting", "update_pacing", "update_bidding", "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 CHANGE_TERM_ACTIONS: readonly ["pause", "resume", "cancel", "extend_flight", "shorten_flight", "update_flight_dates", "increase_budget", "decrease_budget", "reallocate_budget", "update_budget_allocation", "update_targeting", "update_pacing", "update_bidding", "update_frequency_caps", "update_media_buy_frequency_cap", "update_catalog_assignments", "update_keywords", "update_optimization_goals", "update_impression_goal", "update_spend_target", "update_reporting_webhook", "replace_creative", "update_creative_assignments", "remove_creative", "add_packages", "remove_packages"];