@adcp/sdk 16.5.0 → 16.6.0

package/dist/lib/server/decisioning/runtime/from-platform.mjs

@@ -3299,7 +3299,7 @@ async function autoStoreResources(store, accountId, kind, resources, idField, lo
     );
   }
 }
-async function persistTargetingOverlayFromCreate(store, accountId, request, result, logger) {
+async function persistMediaBuyFromCreate(store, accountId, request, result, logger) {
   if (!store || !accountId) return;
   if (result == null || typeof result !== "object") return;
   try {
@@ -3322,7 +3322,7 @@ async function persistTargetingOverlayFromUpdate(store, accountId, mediaBuyId, p
     logger.warn(`[adcp/decisioning] mediaBuyStore.mergeFromUpdate failed: ${msg}`);
   }
 }
-async function backfillTargetingOverlay(store, accountId, result, logger) {
+async function backfillMediaBuyState(store, accountId, result, logger) {
   if (!store || !accountId) return;
   if (result == null || typeof result !== "object") return;
   try {
@@ -4096,7 +4096,7 @@ function buildMediaBuyHandlers(platform, taskRegistry, taskWebhookEmit, observab
               },
               result,
               async (r) => {
-                await persistTargetingOverlayFromCreate(mediaBuyStore, reqCtx.account?.id, params, r, logger);
+                await persistMediaBuyFromCreate(mediaBuyStore, reqCtx.account?.id, params, r, logger);
                 return asSemanticServerResponseForWire(
                   r,
                   "create_media_buy",
@@ -4384,7 +4384,7 @@ function buildMediaBuyHandlers(platform, taskRegistry, taskWebhookEmit, observab
               canonicalFormatLegacyResolver,
               responseWireMode
             );
-            await backfillTargetingOverlay(mediaBuyStore, reqCtx.account?.id, wireResult, logger);
+            await backfillMediaBuyState(mediaBuyStore, reqCtx.account?.id, wireResult, logger);
             return wireResult;
           },
           (r) => r
@@ -5526,7 +5526,7 @@ function buildAccountHandlers(platform, ctxFor, logger = DEFAULT_FRAMEWORK_LOGGE
           if (policy.failedRows.size === 0) {
             return {
               ...dryRun && { dry_run: true },
-              accounts: rows.map(toWireSyncAccountRow)
+              accounts: rows.map((row) => toWireSyncAccountRow(row, resolveCtx.servedAdcpVersion))
             };
           }
           const combined = [];
@@ -5542,7 +5542,7 @@ function buildAccountHandlers(platform, ctxFor, logger = DEFAULT_FRAMEWORK_LOGGE
           }
           return {
             ...dryRun && { dry_run: true },
-            accounts: combined.map(toWireSyncAccountRow)
+            accounts: combined.map((row) => toWireSyncAccountRow(row, resolveCtx.servedAdcpVersion))
           };
         }
       );

package/dist/lib/server/index.d.mts

@@ -32,7 +32,7 @@ export { applyTargetingInput, hasTargetingClears, resolveTargetingInput } from '
 export type { ResolvedTargetingInput, TargetingInputFor } from '../media-buy/targeting-input.mjs';
 export type { CreateTargetingInput, UpdateTargetingInput } from '../types/index.mjs';
 export type { MediaBuyStore, CreateMediaBuyStoreOptions, CreateMediaBuyInputForStore, CreateMediaBuyResultForStore, UpdateMediaBuyInputForStore, GetMediaBuysResultForStore, } from './media-buy-store.mjs';
-export { MEDIA_BUY_TRANSITIONS, CREATIVE_ASSET_TRANSITIONS, isLegalMediaBuyTransition, isLegalCreativeTransition, assertMediaBuyTransition, assertCreativeTransition, } from './state-machine.mjs';
+export { MEDIA_BUY_TRANSITIONS, getMediaBuyTransitions, CREATIVE_ASSET_TRANSITIONS, isLegalMediaBuyTransition, isLegalCreativeTransition, assertMediaBuyTransition, assertCreativeTransition, } from './state-machine.mjs';
 export { getAccountMode, isSandboxOrMockAccount, assertSandboxAccount } from './account-mode.mjs';
 export type { AccountMode } from './account-mode.mjs';
 export { taskToolResponse, registerAdcpTaskTool, createTaskCapableServer, InMemoryTaskStore, isTerminal, } from './tasks.mjs';

package/dist/lib/server/index.d.ts

@@ -32,7 +32,7 @@ export { applyTargetingInput, hasTargetingClears, resolveTargetingInput } from '
 export type { ResolvedTargetingInput, TargetingInputFor } from '../media-buy/targeting-input';
 export type { CreateTargetingInput, UpdateTargetingInput } from '../types';
 export type { MediaBuyStore, CreateMediaBuyStoreOptions, CreateMediaBuyInputForStore, CreateMediaBuyResultForStore, UpdateMediaBuyInputForStore, GetMediaBuysResultForStore, } from './media-buy-store';
-export { MEDIA_BUY_TRANSITIONS, CREATIVE_ASSET_TRANSITIONS, isLegalMediaBuyTransition, isLegalCreativeTransition, assertMediaBuyTransition, assertCreativeTransition, } from './state-machine';
+export { MEDIA_BUY_TRANSITIONS, getMediaBuyTransitions, CREATIVE_ASSET_TRANSITIONS, isLegalMediaBuyTransition, isLegalCreativeTransition, assertMediaBuyTransition, assertCreativeTransition, } from './state-machine';
 export { getAccountMode, isSandboxOrMockAccount, assertSandboxAccount } from './account-mode';
 export type { AccountMode } from './account-mode';
 export { taskToolResponse, registerAdcpTaskTool, createTaskCapableServer, InMemoryTaskStore, isTerminal, } from './tasks';

package/dist/lib/server/index.js

@@ -157,6 +157,7 @@ __export(server_exports, {
   getIdempotencyMigration: () => import_idempotency.getIdempotencyMigration,
   getKeyedAccountMigration: () => import_keyed_account_backend.getKeyedAccountMigration,
   getMcpTasksMigration: () => import_postgres_task_store.getMcpTasksMigration,
+  getMediaBuyTransitions: () => import_state_machine.getMediaBuyTransitions,
   getNotificationSubscriptionMigration: () => import_notification_subscriptions.getNotificationSubscriptionMigration,
   getServeRequestContext: () => import_auth.getServeRequestContext,
   getWebhookDeliveryMigration: () => import_webhook_delivery.getWebhookDeliveryMigration,
@@ -498,6 +499,7 @@ var import_property_lists = require('./property-lists.js');
   getIdempotencyMigration,
   getKeyedAccountMigration,
   getMcpTasksMigration,
+  getMediaBuyTransitions,
   getNotificationSubscriptionMigration,
   getServeRequestContext,
   getWebhookDeliveryMigration,

package/dist/lib/server/index.mjs

@@ -59,6 +59,7 @@ import { createMediaBuyStore, DEFAULT_MEDIA_BUY_STORE_COLLECTION } from "./media
 import { applyTargetingInput, hasTargetingClears, resolveTargetingInput } from "../media-buy/targeting-input.mjs";
 import {
   MEDIA_BUY_TRANSITIONS,
+  getMediaBuyTransitions,
   CREATIVE_ASSET_TRANSITIONS,
   isLegalMediaBuyTransition,
   isLegalCreativeTransition,
@@ -444,6 +445,7 @@ export {
   getIdempotencyMigration,
   getKeyedAccountMigration,
   getMcpTasksMigration,
+  getMediaBuyTransitions,
   getNotificationSubscriptionMigration,
   getServeRequestContext,
   getWebhookDeliveryMigration,

package/dist/lib/server/media-buy-action-resolver.d.mts

@@ -32,6 +32,9 @@ export interface SellerActionResolutionOptions {
     /** Noncommercial metadata authority is explicit, never fabricated as a proposal term. */
     metadata?: {
         update_name?: SellerActionDecision;
+        /** Seller-owned scope identifies packages which have never been enabled
+         * for serving. Aggregate buy status cannot establish that fact. */
+        update_creative_start_policy?: SellerActionDecision;
     };
     now?: number;
 }

package/dist/lib/server/media-buy-action-resolver.d.ts

@@ -32,6 +32,9 @@ export interface SellerActionResolutionOptions {
     /** Noncommercial metadata authority is explicit, never fabricated as a proposal term. */
     metadata?: {
         update_name?: SellerActionDecision;
+        /** Seller-owned scope identifies packages which have never been enabled
+         * for serving. Aggregate buy status cannot establish that fact. */
+        update_creative_start_policy?: SellerActionDecision;
     };
     now?: number;
 }

package/dist/lib/server/media-buy-action-resolver.js

@@ -246,6 +246,38 @@ const mediaBuyActionResolver = {
           }
         );
     }
+    const startup = input.metadata?.update_creative_start_policy;
+    if (startup) {
+      const scope = Array.isArray(startup.applicable_package_ids) ? startup.applicable_package_ids : void 0;
+      const entry = {
+        action: "update_creative_start_policy",
+        mode: "self_serve",
+        task: startup.task ?? "control_media_buy",
+        ...scope && { applicable_package_ids: [...scope] },
+        ...startup.sla && { sla: structuredClone(startup.sla) }
+      };
+      const request = scope ? { packages: scope.map((package_id) => ({ package_id, start_requires_all_creatives_approved: false })) } : void 0;
+      const result = (0, import_action_assessment.assessActionAvailability)(
+        { ...input.buy, available_actions: [entry] },
+        entry.action,
+        {
+          adcpVersion: input.adcpVersion ?? import_version.ADCP_VERSION,
+          request
+        }
+      );
+      if (input.wireVersion !== "3.1" && startup.authorization === true && startup.governance === true && startup.policy === true && result.status === "available_now")
+        available_actions.push(entry);
+      else
+        unavailable.push(
+          result.status === "currently_unavailable" ? result : {
+            status: "currently_unavailable",
+            action: "update_creative_start_policy",
+            reason: "condition_unresolved",
+            certainty: "unknown",
+            message: "Explicit seller startup gates and a supported wire projection must admit this action."
+          }
+        );
+    }
     return {
       available_actions,
       unavailable,

package/dist/lib/server/media-buy-action-resolver.mjs

@@ -235,6 +235,38 @@ const mediaBuyActionResolver = {
           }
         );
     }
+    const startup = input.metadata?.update_creative_start_policy;
+    if (startup) {
+      const scope = Array.isArray(startup.applicable_package_ids) ? startup.applicable_package_ids : void 0;
+      const entry = {
+        action: "update_creative_start_policy",
+        mode: "self_serve",
+        task: startup.task ?? "control_media_buy",
+        ...scope && { applicable_package_ids: [...scope] },
+        ...startup.sla && { sla: structuredClone(startup.sla) }
+      };
+      const request = scope ? { packages: scope.map((package_id) => ({ package_id, start_requires_all_creatives_approved: false })) } : void 0;
+      const result = assessActionAvailability(
+        { ...input.buy, available_actions: [entry] },
+        entry.action,
+        {
+          adcpVersion: input.adcpVersion ?? ADCP_VERSION,
+          request
+        }
+      );
+      if (input.wireVersion !== "3.1" && startup.authorization === true && startup.governance === true && startup.policy === true && result.status === "available_now")
+        available_actions.push(entry);
+      else
+        unavailable.push(
+          result.status === "currently_unavailable" ? result : {
+            status: "currently_unavailable",
+            action: "update_creative_start_policy",
+            reason: "condition_unresolved",
+            certainty: "unknown",
+            message: "Explicit seller startup gates and a supported wire projection must admit this action."
+          }
+        );
+    }
     return {
       available_actions,
       unavailable,

package/dist/lib/server/media-buy-store.d.mts

@@ -1,7 +1,8 @@
 /**
  * Opinionated media-buy store that satisfies the seller's spec contract:
- * persist `packages[].targeting_overlay` from `create_media_buy`, echo it on
- * `get_media_buys`, and deep-merge updates without dropping prior
+ * persist creation context and `packages[].targeting_overlay` from
+ * `create_media_buy`, echo them on `get_media_buys`, and merge targeting
+ * updates without dropping creation context or prior
  * `property_list` / `collection_list` references.
  *
  * Per `schemas/cache/<v>/media-buy/get-media-buys-response.json` the seller
@@ -12,7 +13,7 @@
  * by hand.
  *
  * Adopters opt in by passing `mediaBuyStore` to
- * `createAdcpServerFromPlatform`. Backed by any `AdcpStateStore` —
+ * `createAdcpServerFromPlatform`. Backed by any `AdcpStateStore`:
  * `InMemoryStateStore` for development, `PostgresStateStore` for
  * production.
  *
@@ -41,9 +42,13 @@ export declare const DEFAULT_MEDIA_BUY_STORE_COLLECTION = "media_buys_targeting"
  * request to the full generated type just to thread it through.
  */
 export interface CreateMediaBuyInputForStore {
+    /** Opaque creation context, persisted verbatim for resource readback. */
+    context?: Record<string, unknown>;
     packages?: Array<{
         package_id?: string;
         buyer_ref?: string;
+        product_id?: string;
+        context?: Record<string, unknown>;
         /**
          * Request-shaped Targeting Input: individual dimensions may be `null` to
          * suppress a configured-product or product default (AdCP 3.2, DR-0020).
@@ -58,9 +63,12 @@ export interface CreateMediaBuyInputForStore {
  */
 export interface CreateMediaBuyResultForStore {
     media_buy_id: string;
+    context?: Record<string, unknown>;
     packages?: Array<{
         package_id?: string;
         buyer_ref?: string;
+        product_id?: string;
+        context?: Record<string, unknown>;
         targeting_overlay?: TargetingOverlay;
     }>;
 }
@@ -89,18 +97,23 @@ export interface UpdateMediaBuyInputForStore {
 export interface GetMediaBuysResultForStore {
     media_buys?: Array<{
         media_buy_id?: string;
+        context?: Record<string, unknown>;
         packages?: Array<{
             package_id?: string;
+            context?: Record<string, unknown>;
             targeting_overlay?: TargetingOverlay;
         }>;
     }>;
 }
 export interface MediaBuyStore {
     /**
-     * Persist `packages[].targeting_overlay` from a successful
-     * `create_media_buy`. Joins the request's per-package targeting
+     * Persist buy/package creation context and `packages[].targeting_overlay`
+     * from a successful `create_media_buy`. Joins the request's per-package targeting
      * overlay with the response's seller-assigned `package_id` (or
-     * `buyer_ref` when the request used buyer-supplied refs).
+     * `buyer_ref` when the request used buyer-supplied refs). Context uses
+     * unambiguous package identities, then positional alignment only when
+     * package counts agree and echoed identities do not contradict it.
+     * Existing creation context is retained on repeated persistence calls.
      */
     persistFromCreate(accountId: string, request: CreateMediaBuyInputForStore, result: CreateMediaBuyResultForStore): Promise<void>;
     /**
@@ -112,21 +125,22 @@ export interface MediaBuyStore {
      * - field present and `null` → clear (drop the field)
      *
      * A patch that clears the last surviving dimension drops the package's
-     * tracked overlay entirely, so `backfill` stops echoing one — a cleared
+     * tracked overlay entirely, so `backfill` stops echoing one. A cleared
      * dimension is absent from effective readback rather than present as `null`.
      *
      * `new_packages` from the patch are persisted as fresh entries when
      * they declare `targeting_overlay`. Entries that omit it are
-     * intentionally NOT tracked — this store is overlay-only, and a
-     * later patch can still seed an overlay onto the package_id when
-     * one becomes relevant.
+     * not tracked. Updates preserve creation context and do not capture
+     * context for packages added after creation.
      */
     mergeFromUpdate(accountId: string, mediaBuyId: string, patch: UpdateMediaBuyInputForStore): Promise<void>;
     /**
-     * Fill in missing `packages[].targeting_overlay` on the seller's
+     * Fill in missing buy/package creation context and
+     * `packages[].targeting_overlay` on the seller's
      * `get_media_buys` response from the persisted store. **Mutates the
      * response in place** (and returns it for fluent chaining). Packages
-     * the seller already echoed are left untouched.
+     * the seller already echoed are left untouched. The top-level response
+     * context belongs to the read request and is never changed.
      */
     backfill<T extends GetMediaBuysResultForStore>(accountId: string, result: T): Promise<T>;
 }

package/dist/lib/server/media-buy-store.d.ts

@@ -1,7 +1,8 @@
 /**
  * Opinionated media-buy store that satisfies the seller's spec contract:
- * persist `packages[].targeting_overlay` from `create_media_buy`, echo it on
- * `get_media_buys`, and deep-merge updates without dropping prior
+ * persist creation context and `packages[].targeting_overlay` from
+ * `create_media_buy`, echo them on `get_media_buys`, and merge targeting
+ * updates without dropping creation context or prior
  * `property_list` / `collection_list` references.
  *
  * Per `schemas/cache/<v>/media-buy/get-media-buys-response.json` the seller
@@ -12,7 +13,7 @@
  * by hand.
  *
  * Adopters opt in by passing `mediaBuyStore` to
- * `createAdcpServerFromPlatform`. Backed by any `AdcpStateStore` —
+ * `createAdcpServerFromPlatform`. Backed by any `AdcpStateStore`:
  * `InMemoryStateStore` for development, `PostgresStateStore` for
  * production.
  *
@@ -41,9 +42,13 @@ export declare const DEFAULT_MEDIA_BUY_STORE_COLLECTION = "media_buys_targeting"
  * request to the full generated type just to thread it through.
  */
 export interface CreateMediaBuyInputForStore {
+    /** Opaque creation context, persisted verbatim for resource readback. */
+    context?: Record<string, unknown>;
     packages?: Array<{
         package_id?: string;
         buyer_ref?: string;
+        product_id?: string;
+        context?: Record<string, unknown>;
         /**
          * Request-shaped Targeting Input: individual dimensions may be `null` to
          * suppress a configured-product or product default (AdCP 3.2, DR-0020).
@@ -58,9 +63,12 @@ export interface CreateMediaBuyInputForStore {
  */
 export interface CreateMediaBuyResultForStore {
     media_buy_id: string;
+    context?: Record<string, unknown>;
     packages?: Array<{
         package_id?: string;
         buyer_ref?: string;
+        product_id?: string;
+        context?: Record<string, unknown>;
         targeting_overlay?: TargetingOverlay;
     }>;
 }
@@ -89,18 +97,23 @@ export interface UpdateMediaBuyInputForStore {
 export interface GetMediaBuysResultForStore {
     media_buys?: Array<{
         media_buy_id?: string;
+        context?: Record<string, unknown>;
         packages?: Array<{
             package_id?: string;
+            context?: Record<string, unknown>;
             targeting_overlay?: TargetingOverlay;
         }>;
     }>;
 }
 export interface MediaBuyStore {
     /**
-     * Persist `packages[].targeting_overlay` from a successful
-     * `create_media_buy`. Joins the request's per-package targeting
+     * Persist buy/package creation context and `packages[].targeting_overlay`
+     * from a successful `create_media_buy`. Joins the request's per-package targeting
      * overlay with the response's seller-assigned `package_id` (or
-     * `buyer_ref` when the request used buyer-supplied refs).
+     * `buyer_ref` when the request used buyer-supplied refs). Context uses
+     * unambiguous package identities, then positional alignment only when
+     * package counts agree and echoed identities do not contradict it.
+     * Existing creation context is retained on repeated persistence calls.
      */
     persistFromCreate(accountId: string, request: CreateMediaBuyInputForStore, result: CreateMediaBuyResultForStore): Promise<void>;
     /**
@@ -112,21 +125,22 @@ export interface MediaBuyStore {
      * - field present and `null` → clear (drop the field)
      *
      * A patch that clears the last surviving dimension drops the package's
-     * tracked overlay entirely, so `backfill` stops echoing one — a cleared
+     * tracked overlay entirely, so `backfill` stops echoing one. A cleared
      * dimension is absent from effective readback rather than present as `null`.
      *
      * `new_packages` from the patch are persisted as fresh entries when
      * they declare `targeting_overlay`. Entries that omit it are
-     * intentionally NOT tracked — this store is overlay-only, and a
-     * later patch can still seed an overlay onto the package_id when
-     * one becomes relevant.
+     * not tracked. Updates preserve creation context and do not capture
+     * context for packages added after creation.
      */
     mergeFromUpdate(accountId: string, mediaBuyId: string, patch: UpdateMediaBuyInputForStore): Promise<void>;
     /**
-     * Fill in missing `packages[].targeting_overlay` on the seller's
+     * Fill in missing buy/package creation context and
+     * `packages[].targeting_overlay` on the seller's
      * `get_media_buys` response from the persisted store. **Mutates the
      * response in place** (and returns it for fluent chaining). Packages
-     * the seller already echoed are left untouched.
+     * the seller already echoed are left untouched. The top-level response
+     * context belongs to the read request and is never changed.
      */
     backfill<T extends GetMediaBuysResultForStore>(accountId: string, result: T): Promise<T>;
 }

package/dist/lib/server/media-buy-store.js

@@ -25,6 +25,25 @@ module.exports = __toCommonJS(media_buy_store_exports);
 var import_targeting_input = require('../media-buy/targeting-input.js');
 var import_state_store = require('./state-store.js');
 const DEFAULT_MEDIA_BUY_STORE_COLLECTION = "media_buys_targeting";
+const PACKAGE_IDENTITY_FIELDS = ["package_id", "product_id", "buyer_ref"];
+function compatibleIdentity(left, right) {
+  if (!left || !right) return false;
+  return PACKAGE_IDENTITY_FIELDS.every((key) => !left[key] || !right[key] || left[key] === right[key]);
+}
+function sharesIdentity(left, right) {
+  if (!left || !right) return false;
+  return compatibleIdentity(left, right) && PACKAGE_IDENTITY_FIELDS.some((key) => left[key] && left[key] === right[key]);
+}
+function matchContextPackage(requests, responses, index) {
+  const matches = requests.filter((request) => sharesIdentity(request, responses[index]));
+  if (matches.length === 1 && responses.filter((response) => sharesIdentity(matches[0], response)).length === 1) {
+    return matches[0];
+  }
+  if (requests.length === responses.length && requests.every((request, i) => compatibleIdentity(request, responses[i]))) {
+    return requests[index];
+  }
+  return void 0;
+}
 function createMediaBuyStore(options) {
   const collection = options.collection ?? DEFAULT_MEDIA_BUY_STORE_COLLECTION;
   function viewFor(accountId) {
@@ -42,8 +61,9 @@ function createMediaBuyStore(options) {
     async persistFromCreate(accountId, request, result) {
       const requestPackages = request.packages ?? [];
       const responsePackages = result.packages ?? [];
-      if (requestPackages.length === 0 || !result.media_buy_id) return;
-      const persistedPackages = [];
+      if (!result.media_buy_id) return;
+      const prior = await loadRecord(accountId, result.media_buy_id);
+      const byId = new Map((prior?.packages ?? []).map((pkg) => [pkg.package_id, { ...pkg }]));
       for (let i = 0; i < requestPackages.length; i++) {
         const reqPkg = requestPackages[i];
         if (!reqPkg?.targeting_overlay) continue;
@@ -54,12 +74,26 @@ function createMediaBuyStore(options) {
         if (!packageId) continue;
         const persistedOverlay = respPkg?.targeting_overlay ?? (0, import_targeting_input.resolveTargetingInput)(reqPkg.targeting_overlay);
         if (!persistedOverlay) continue;
-        persistedPackages.push({ package_id: packageId, targeting_overlay: persistedOverlay });
+        byId.set(packageId, { ...byId.get(packageId), package_id: packageId, targeting_overlay: persistedOverlay });
       }
-      if (persistedPackages.length === 0) return;
+      for (const [index, response] of responsePackages.entries()) {
+        if (!response.package_id) continue;
+        const context2 = matchContextPackage(requestPackages, responsePackages, index)?.context ?? response.context;
+        const stored = byId.get(response.package_id);
+        if (context2 !== void 0 && stored?.context === void 0) {
+          byId.set(response.package_id, {
+            ...stored,
+            package_id: response.package_id,
+            context: structuredClone(context2)
+          });
+        }
+      }
+      const context = prior?.context ?? request.context ?? result.context;
+      if (byId.size === 0 && context === void 0) return;
       await writeRecord(accountId, {
         media_buy_id: result.media_buy_id,
-        packages: persistedPackages
+        ...context !== void 0 ? { context: structuredClone(context) } : {},
+        packages: Array.from(byId.values())
       });
     },
     async mergeFromUpdate(accountId, mediaBuyId, patch) {
@@ -67,42 +101,56 @@ function createMediaBuyStore(options) {
         media_buy_id: mediaBuyId,
         packages: []
       };
-      const byId = new Map(prior.packages.map((p) => [p.package_id, p.targeting_overlay]));
+      const byId = new Map(prior.packages.map((p) => [p.package_id, { ...p }]));
       for (const pkg of patch.packages ?? []) {
         const packageId = pkg?.package_id;
         if (!packageId) continue;
         if (!("targeting_overlay" in pkg)) continue;
         const incoming = pkg.targeting_overlay;
         if (incoming === void 0) continue;
-        const merged = (0, import_targeting_input.applyTargetingInput)(byId.get(packageId), incoming);
-        if (merged) byId.set(packageId, merged);
-        else byId.delete(packageId);
+        const stored = byId.get(packageId);
+        const merged = (0, import_targeting_input.applyTargetingInput)(stored?.targeting_overlay, incoming);
+        if (merged) byId.set(packageId, { ...stored, package_id: packageId, targeting_overlay: merged });
+        else if (stored?.context !== void 0) {
+          byId.set(packageId, { package_id: packageId, context: stored.context });
+        } else byId.delete(packageId);
       }
       for (const pkg of patch.new_packages ?? []) {
         if (!pkg?.targeting_overlay || !pkg.package_id) continue;
         const resolved = (0, import_targeting_input.resolveTargetingInput)(pkg.targeting_overlay);
-        if (resolved) byId.set(pkg.package_id, resolved);
+        if (resolved)
+          byId.set(pkg.package_id, {
+            ...byId.get(pkg.package_id),
+            package_id: pkg.package_id,
+            targeting_overlay: resolved
+          });
       }
       await writeRecord(accountId, {
-        media_buy_id: mediaBuyId,
-        packages: Array.from(byId.entries()).map(([package_id, targeting_overlay]) => ({
-          package_id,
-          targeting_overlay
-        }))
+        ...prior,
+        packages: Array.from(byId.values())
       });
     },
     async backfill(accountId, result) {
       const buys = result.media_buys;
       if (!buys || buys.length === 0) return result;
       for (const buy of buys) {
-        if (!buy?.media_buy_id || !buy.packages) continue;
+        if (!buy?.media_buy_id) continue;
         const record = await loadRecord(accountId, buy.media_buy_id);
         if (!record) continue;
-        const overlayById = new Map(record.packages.map((p) => [p.package_id, p.targeting_overlay]));
-        for (const pkg of buy.packages) {
-          if (!pkg?.package_id || pkg.targeting_overlay !== void 0) continue;
-          const persisted = overlayById.get(pkg.package_id);
-          if (persisted) pkg.targeting_overlay = persisted;
+        if (buy.context === void 0 && record.context !== void 0) {
+          buy.context = structuredClone(record.context);
+        }
+        const byId = new Map(record.packages.map((p) => [p.package_id, p]));
+        for (const pkg of buy.packages ?? []) {
+          if (!pkg?.package_id) continue;
+          const persisted = byId.get(pkg.package_id);
+          if (!persisted) continue;
+          if (pkg.targeting_overlay === void 0 && persisted.targeting_overlay !== void 0) {
+            pkg.targeting_overlay = persisted.targeting_overlay;
+          }
+          if (pkg.context === void 0 && persisted.context !== void 0) {
+            pkg.context = structuredClone(persisted.context);
+          }
         }
       }
       return result;