@adcp/sdk 17.0.0-beta.1 → 17.0.0-beta.2

package/dist/lib/server/decisioning/account.mjs

@@ -1,4 +1,5 @@
 import { projectReportingDeliveryConfigStates } from "../reporting-delivery-config.mjs";
+import { projectAccountResponseIdentityFields } from "../account-response-identity.mjs";
 const ACCOUNT_AUTHORIZATION_WIRE_KEYS = [
   "allowed_tasks",
   "field_scopes",
@@ -19,6 +20,30 @@ class AccountNotFoundError extends Error {
     super(message);
   }
 }
+const SYNC_ACCOUNT_PASSTHROUGH_KEYS = [
+  "account_id",
+  "brand",
+  "operator",
+  "revision",
+  "currency",
+  "timezone",
+  "name",
+  "action",
+  "status",
+  "billing",
+  "account_scope",
+  "setup",
+  "rate_card",
+  "payment_terms",
+  "credit_limit",
+  "errors",
+  "warnings",
+  "sandbox"
+];
+const SYNC_ACCOUNTS_RESULT_KEY_COVERAGE = {};
+void SYNC_ACCOUNTS_RESULT_KEY_COVERAGE;
+const SYNC_ACCOUNTS_PROJECTION_KEY_COVERAGE = {};
+void SYNC_ACCOUNTS_PROJECTION_KEY_COVERAGE;
 function toWireAccount(account) {
   const wire = {
     account_id: account.id,
@@ -76,22 +101,19 @@ function projectAccountAuthorization(authorization) {
   return projected;
 }
 function toWireSyncAccountRow(row) {
+  const identity = projectAccountResponseIdentityFields(row);
   const wire = {
-    brand: row.brand,
-    operator: row.operator,
     action: row.action,
-    status: row.status
+    ...identity
   };
-  if (row.account_id !== void 0) wire.account_id = row.account_id;
-  if (row.name !== void 0) wire.name = row.name;
-  if (row.billing !== void 0) wire.billing = row.billing;
+  const source = row;
+  function copyField(key) {
+    const value = source[key];
+    if (value !== void 0) wire[key] = value;
+  }
+  for (const key of SYNC_ACCOUNT_PASSTHROUGH_KEYS) copyField(key);
   const projectedEntity = projectBillingEntity(row.billing_entity);
   if (projectedEntity !== void 0) wire.billing_entity = projectedEntity;
-  if (row.account_scope !== void 0) wire.account_scope = row.account_scope;
-  if (row.setup !== void 0) wire.setup = row.setup;
-  if (row.rate_card !== void 0) wire.rate_card = row.rate_card;
-  if (row.payment_terms !== void 0) wire.payment_terms = row.payment_terms;
-  if (row.credit_limit !== void 0) wire.credit_limit = row.credit_limit;
   if (row.notification_configs !== void 0) {
     wire.notification_configs = row.notification_configs.map(projectNotificationConfig);
   }
@@ -103,9 +125,6 @@ function toWireSyncAccountRow(row) {
       row.authorization
     );
   }
-  if (row.errors !== void 0) wire.errors = row.errors;
-  if (row.warnings !== void 0) wire.warnings = row.warnings;
-  if (row.sandbox !== void 0) wire.sandbox = row.sandbox;
   return wire;
 }
 function projectNotificationConfig(config) {

package/dist/lib/server/decisioning/runtime/from-platform.d.mts

@@ -362,10 +362,10 @@ export interface CreateAdcpServerFromPlatformOptions<TAccount = unknown> extends
     ctxMetadata?: CtxMetadataStore;
     /**
      * Opinionated media-buy store that satisfies the seller spec contract for
-     * `targeting_overlay` echo: persist `packages[].targeting_overlay` from
-     * `create_media_buy`, echo it on `get_media_buys`, deep-merge across
-     * `update_media_buy` without dropping prior `property_list` /
-     * `collection_list` references.
+     * creation context and targeting echo: persist buy/package `context` and
+     * `packages[].targeting_overlay` from `create_media_buy`, then fill missing
+     * fields on `get_media_buys`. Targeting updates preserve creation context
+     * and prior `property_list` / `collection_list` references.
      *
      * Wire to honor the
      * `schemas/cache/<v>/media-buy/get-media-buys-response.json` contract
@@ -373,7 +373,7 @@ export interface CreateAdcpServerFromPlatformOptions<TAccount = unknown> extends
      * `property-lists` / `collection-lists` MUST echo the persisted refs;
      * `mediaBuyStore` is the framework-side way to do it.
      *
-     * Backed by any `AdcpStateStore` — `InMemoryStateStore` for dev,
+     * Backed by any `AdcpStateStore`: `InMemoryStateStore` for dev,
      * `PostgresStateStore` for production. Failures are logged and swallowed
      * (auto-echo MUST NOT break a successful seller response).
      *

package/dist/lib/server/decisioning/runtime/from-platform.d.ts

@@ -362,10 +362,10 @@ export interface CreateAdcpServerFromPlatformOptions<TAccount = unknown> extends
     ctxMetadata?: CtxMetadataStore;
     /**
      * Opinionated media-buy store that satisfies the seller spec contract for
-     * `targeting_overlay` echo: persist `packages[].targeting_overlay` from
-     * `create_media_buy`, echo it on `get_media_buys`, deep-merge across
-     * `update_media_buy` without dropping prior `property_list` /
-     * `collection_list` references.
+     * creation context and targeting echo: persist buy/package `context` and
+     * `packages[].targeting_overlay` from `create_media_buy`, then fill missing
+     * fields on `get_media_buys`. Targeting updates preserve creation context
+     * and prior `property_list` / `collection_list` references.
      *
      * Wire to honor the
      * `schemas/cache/<v>/media-buy/get-media-buys-response.json` contract
@@ -373,7 +373,7 @@ export interface CreateAdcpServerFromPlatformOptions<TAccount = unknown> extends
      * `property-lists` / `collection-lists` MUST echo the persisted refs;
      * `mediaBuyStore` is the framework-side way to do it.
      *
-     * Backed by any `AdcpStateStore` — `InMemoryStateStore` for dev,
+     * Backed by any `AdcpStateStore`: `InMemoryStateStore` for dev,
      * `PostgresStateStore` for production. Failures are logged and swallowed
      * (auto-echo MUST NOT break a successful seller response).
      *

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

@@ -3270,7 +3270,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 {
@@ -3293,7 +3293,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 {
@@ -4081,7 +4081,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",
@@ -4369,7 +4369,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

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

@@ -3302,7 +3302,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 {
@@ -3325,7 +3325,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 {
@@ -4113,7 +4113,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",
@@ -4401,7 +4401,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

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;