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

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

@@ -1,20 +1,23 @@
 export type { ActionNotAllowedDetails, ActionNotAllowedReason, MediaBuyActionMode, MediaBuyAvailableAction, MediaBuyValidAction, SLAWindow, } from '../types/core.generated';
 import type { MediaBuyAvailableAction, MediaBuyValidAction } from '../types/core.generated';
 import type { SLAWindow } from '../types/core.generated';
+import type { ControlMediaBuyRequest } from '../types/tools.generated';
 import type { MediaBuyUpdateFieldAction } from './update-fields.generated';
+import type { CANONICAL_ACTION_TASKS } from './action-metadata.generated';
 /**
  * Every action id the structured `available_actions[].action` surface can
  * carry. Derived from the generated wire type plus the generated
- * `update_media_buy` dispatch table, so it is exactly the legacy
- * `MediaBuyValidAction` enum on schema pins that predate
+ * `update_media_buy` dispatch table, preserving the legacy vocabulary on schema pins that predate
  * `core/media-buy-available-action-id.json` (AdCP <= 3.2.0-rc.2) and widens
  * to include structured-only ids such as `update_media_buy_frequency_cap`
- * once the pin picks that schema up. Use this — not `MediaBuyValidAction` —
+ * once the pin picks that schema up. Canonical task metadata keeps the union
+ * narrow even when a generated oneOf wire type flattens action to string.
+ * Use this — not `MediaBuyValidAction` —
  * wherever code reads `available_actions[].action`, `allowed_actions[].action`,
  * or `ACTION_NOT_ALLOWED.attempted_action`. `MediaBuyValidAction` remains the
  * correct type for the deprecated flat `valid_actions[]` list only.
  */
-export type MediaBuyActionId = MediaBuyAvailableAction['action'] | MediaBuyUpdateFieldAction;
+export type MediaBuyActionId = MediaBuyAvailableAction['action'] | MediaBuyUpdateFieldAction | keyof typeof CANONICAL_ACTION_TASKS;
 /**
  * @deprecated Use `SLAWindow`. Kept as an import-compatibility alias for the
  * pre-codegen draft export name; the shape is the generated wire contract.
@@ -36,17 +39,31 @@ export type LegacyCoarseAction = (typeof LEGACY_COARSE_ACTIONS)[number];
  * fields are required by the helpers themselves.
  */
 export interface MediaBuyActionContext {
+    accepted_proposal?: import('./action-types').ActionProposal;
+    accepted_proposal_id?: string;
     media_buy_id?: string;
     status?: string;
     start_time?: string;
     end_time?: string;
+    revision?: number;
+    currency?: string;
+    total_budget?: number | {
+        amount: number;
+        currency: string;
+    };
+    daily_budget_cap?: number | null;
     packages?: ReadonlyArray<{
         package_id?: string;
         budget?: number;
         start_time?: string;
         end_time?: string;
+        canceled?: boolean;
+        paused?: boolean;
+        status?: string;
+        daily_budget_cap?: number | null;
+        min_spend_target?: number | null;
     }>;
-    available_actions?: MediaBuyAvailableAction[];
+    available_actions?: readonly import('./action-types').LiveMediaBuyAction[];
     valid_actions?: MediaBuyValidAction[];
 }
 /**
@@ -56,6 +73,26 @@ export interface MediaBuyActionContext {
  * resolver signature.
  */
 export interface UpdateMediaBuyRequestLike {
+    media_buy_id?: string;
+    account?: unknown;
+    context?: unknown;
+    governance_context?: unknown;
+    push_notification_config?: unknown;
+    ext?: unknown;
+    budget_cap_timezone?: string | null;
+    invoice_recipient?: unknown;
+    revision?: number;
+    idempotency_key?: string;
+    name?: string;
+    total_budget?: {
+        amount: number;
+        currency: string;
+    };
+    daily_budget_cap?: number | null;
+    budget_allocation?: unknown;
+    pacing?: unknown;
+    bidding?: unknown;
+    reporting_webhook?: unknown;
     paused?: boolean;
     canceled?: true;
     cancellation_reason?: string;
@@ -68,13 +105,24 @@ export interface UpdateMediaBuyRequestLike {
     new_packages?: ReadonlyArray<unknown>;
     packages?: ReadonlyArray<{
         package_id: string;
-        budget?: number;
+        context?: unknown;
+        ext?: unknown;
+        cancellation_reason?: string;
+        catalogs?: unknown;
+        catalog_ids?: readonly string[];
+        bid_price?: number;
+        optimization_goals?: unknown;
+        impressions?: number;
+        budget?: number | null;
+        daily_budget_cap?: number | null;
+        min_spend_target?: number | null;
+        bidding?: unknown;
         pacing?: unknown;
         start_time?: string;
         end_time?: string;
         paused?: boolean;
         canceled?: true;
-        targeting_overlay?: {
+        targeting_overlay?: NonNullable<ControlMediaBuyRequest['packages']>[number]['targeting_overlay'] | {
             frequency_cap?: unknown;
             [k: string]: unknown;
         };

package/dist/lib/protocols/rawResponseCapture.d.mts

@@ -16,6 +16,13 @@ export interface RawHttpCapture {
 interface CaptureSlot {
     captures: RawHttpCapture[];
     maxBodyBytes: number;
+    /** Optional ceiling on recorded exchanges; overflow is marked, not silent. */
+    maxCaptures?: number;
+    /** Optional ceiling on total recorded body bytes across all exchanges. */
+    maxTotalBodyBytes?: number;
+    totalBodyBytes: number;
+    /** Set when a ceiling was hit, so callers can fail closed. */
+    overflowed?: 'captures' | 'bytes';
 }
 export declare const rawResponseCaptureStorage: import("async_hooks").AsyncLocalStorage<CaptureSlot>;
 /**
@@ -31,10 +38,15 @@ export declare const rawResponseCaptureStorage: import("async_hooks").AsyncLocal
  */
 export declare function withRawResponseCapture<T>(fn: () => Promise<T>, options?: {
     maxBodyBytes?: number;
+    maxCaptures?: number;
+    maxTotalBodyBytes?: number;
 }): Promise<{
     result: T;
     captures: RawHttpCapture[];
+    overflowed?: 'captures' | 'bytes';
 }>;
+/** Read the capture-overflow marker attached to a thrown error, if any. */
+export declare function getCaptureOverflowFromError(err: unknown): 'captures' | 'bytes' | undefined;
 /** Type guard for errors carrying partial captures from `withRawResponseCapture`. */
 export declare function getCapturesFromError(err: unknown): RawHttpCapture[] | undefined;
 /**

package/dist/lib/protocols/rawResponseCapture.d.ts

@@ -16,6 +16,13 @@ export interface RawHttpCapture {
 interface CaptureSlot {
     captures: RawHttpCapture[];
     maxBodyBytes: number;
+    /** Optional ceiling on recorded exchanges; overflow is marked, not silent. */
+    maxCaptures?: number;
+    /** Optional ceiling on total recorded body bytes across all exchanges. */
+    maxTotalBodyBytes?: number;
+    totalBodyBytes: number;
+    /** Set when a ceiling was hit, so callers can fail closed. */
+    overflowed?: 'captures' | 'bytes';
 }
 export declare const rawResponseCaptureStorage: import("async_hooks").AsyncLocalStorage<CaptureSlot>;
 /**
@@ -31,10 +38,15 @@ export declare const rawResponseCaptureStorage: import("async_hooks").AsyncLocal
  */
 export declare function withRawResponseCapture<T>(fn: () => Promise<T>, options?: {
     maxBodyBytes?: number;
+    maxCaptures?: number;
+    maxTotalBodyBytes?: number;
 }): Promise<{
     result: T;
     captures: RawHttpCapture[];
+    overflowed?: 'captures' | 'bytes';
 }>;
+/** Read the capture-overflow marker attached to a thrown error, if any. */
+export declare function getCaptureOverflowFromError(err: unknown): 'captures' | 'bytes' | undefined;
 /** Type guard for errors carrying partial captures from `withRawResponseCapture`. */
 export declare function getCapturesFromError(err: unknown): RawHttpCapture[] | undefined;
 /**

package/dist/lib/protocols/rawResponseCapture.js

@@ -18,6 +18,7 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var rawResponseCapture_exports = {};
 __export(rawResponseCapture_exports, {
+  getCaptureOverflowFromError: () => getCaptureOverflowFromError,
   getCapturesFromError: () => getCapturesFromError,
   rawResponseCaptureStorage: () => rawResponseCaptureStorage,
   withRawResponseCapture: () => withRawResponseCapture,
@@ -30,11 +31,14 @@ const rawResponseCaptureStorage = (0, import_global_async_local_storage.globalAs
 async function withRawResponseCapture(fn, options = {}) {
   const slot = {
     captures: [],
-    maxBodyBytes: options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES
+    maxBodyBytes: options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES,
+    ...options.maxCaptures !== void 0 ? { maxCaptures: options.maxCaptures } : {},
+    ...options.maxTotalBodyBytes !== void 0 ? { maxTotalBodyBytes: options.maxTotalBodyBytes } : {},
+    totalBodyBytes: 0
   };
   try {
     const result = await rawResponseCaptureStorage.run(slot, fn);
-    return { result, captures: slot.captures };
+    return { result, captures: slot.captures, ...slot.overflowed ? { overflowed: slot.overflowed } : {} };
   } catch (err) {
     if (err && typeof err === "object") {
       try {
@@ -44,12 +48,27 @@ async function withRawResponseCapture(fn, options = {}) {
           configurable: true,
           writable: true
         });
+        if (slot.overflowed) {
+          Object.defineProperty(err, "capturesOverflowed", {
+            value: slot.overflowed,
+            enumerable: false,
+            configurable: true,
+            writable: true
+          });
+        }
       } catch {
       }
     }
     throw err;
   }
 }
+function getCaptureOverflowFromError(err) {
+  if (err && typeof err === "object") {
+    const marker = err.capturesOverflowed;
+    if (marker === "captures" || marker === "bytes") return marker;
+  }
+  return void 0;
+}
 function getCapturesFromError(err) {
   if (err && typeof err === "object" && Array.isArray(err.captures)) {
     return err.captures;
@@ -82,13 +101,23 @@ function wrapFetchWithCapture(upstream) {
       const lower = key.toLowerCase();
       headers[key] = REDACTED_HEADER_NAMES.has(lower) ? REDACTED_PLACEHOLDER : value;
     });
+    if (slot.maxCaptures !== void 0 && slot.captures.length >= slot.maxCaptures) {
+      slot.overflowed ??= "captures";
+      return response;
+    }
+    const redactedBody = redactBearerInBody(body);
+    if (slot.maxTotalBodyBytes !== void 0 && slot.totalBodyBytes + redactedBody.length > slot.maxTotalBodyBytes) {
+      slot.overflowed ??= "bytes";
+      return response;
+    }
+    slot.totalBodyBytes += redactedBody.length;
     slot.captures.push({
       url,
       method,
       ...requestMetadata,
       status: response.status,
       headers,
-      body: redactBearerInBody(body),
+      body: redactedBody,
       latencyMs,
       timestamp: new Date(startedAt).toISOString(),
       bodyTruncated
@@ -143,6 +172,7 @@ async function readBodyBounded(response, maxBodyBytes) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  getCaptureOverflowFromError,
   getCapturesFromError,
   rawResponseCaptureStorage,
   withRawResponseCapture,

package/dist/lib/protocols/rawResponseCapture.mjs

@@ -9,11 +9,14 @@ const rawResponseCaptureStorage = globalAsyncLocalStorage("rawResponseCapture");
 async function withRawResponseCapture(fn, options = {}) {
   const slot = {
     captures: [],
-    maxBodyBytes: options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES
+    maxBodyBytes: options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES,
+    ...options.maxCaptures !== void 0 ? { maxCaptures: options.maxCaptures } : {},
+    ...options.maxTotalBodyBytes !== void 0 ? { maxTotalBodyBytes: options.maxTotalBodyBytes } : {},
+    totalBodyBytes: 0
   };
   try {
     const result = await rawResponseCaptureStorage.run(slot, fn);
-    return { result, captures: slot.captures };
+    return { result, captures: slot.captures, ...slot.overflowed ? { overflowed: slot.overflowed } : {} };
   } catch (err) {
     if (err && typeof err === "object") {
       try {
@@ -23,12 +26,27 @@ async function withRawResponseCapture(fn, options = {}) {
           configurable: true,
           writable: true
         });
+        if (slot.overflowed) {
+          Object.defineProperty(err, "capturesOverflowed", {
+            value: slot.overflowed,
+            enumerable: false,
+            configurable: true,
+            writable: true
+          });
+        }
       } catch {
       }
     }
     throw err;
   }
 }
+function getCaptureOverflowFromError(err) {
+  if (err && typeof err === "object") {
+    const marker = err.capturesOverflowed;
+    if (marker === "captures" || marker === "bytes") return marker;
+  }
+  return void 0;
+}
 function getCapturesFromError(err) {
   if (err && typeof err === "object" && Array.isArray(err.captures)) {
     return err.captures;
@@ -61,13 +79,23 @@ function wrapFetchWithCapture(upstream) {
       const lower = key.toLowerCase();
       headers[key] = REDACTED_HEADER_NAMES.has(lower) ? REDACTED_PLACEHOLDER : value;
     });
+    if (slot.maxCaptures !== void 0 && slot.captures.length >= slot.maxCaptures) {
+      slot.overflowed ??= "captures";
+      return response;
+    }
+    const redactedBody = redactBearerInBody(body);
+    if (slot.maxTotalBodyBytes !== void 0 && slot.totalBodyBytes + redactedBody.length > slot.maxTotalBodyBytes) {
+      slot.overflowed ??= "bytes";
+      return response;
+    }
+    slot.totalBodyBytes += redactedBody.length;
     slot.captures.push({
       url,
       method,
       ...requestMetadata,
       status: response.status,
       headers,
-      body: redactBearerInBody(body),
+      body: redactedBody,
       latencyMs,
       timestamp: new Date(startedAt).toISOString(),
       bodyTruncated
@@ -121,6 +149,7 @@ async function readBodyBounded(response, maxBodyBytes) {
   return { body: text.slice(0, maxBodyBytes), bodyTruncated: true };
 }
 export {
+  getCaptureOverflowFromError,
   getCapturesFromError,
   rawResponseCaptureStorage,
   withRawResponseCapture,