@adcp/sdk 6.14.0 → 6.15.1

package/dist/lib/utils/activation-key-builders.d.ts

@@ -0,0 +1,21 @@
+import type { ActivationKey } from '../types/core.generated';
+type SegmentIdKey = Extract<ActivationKey, {
+    type: 'segment_id';
+}>;
+type KeyValueKey = Extract<ActivationKey, {
+    type: 'key_value';
+}>;
+type Tagged<T, Tag extends string> = Omit<T, 'type'> & {
+    type: Tag;
+};
+/** Build a `segment_id`-variant `ActivationKey`. */
+export declare function segmentIdActivationKey(fields: Omit<SegmentIdKey, 'type'>): Tagged<SegmentIdKey, 'segment_id'>;
+/** Build a `key_value`-variant `ActivationKey`. `key`/`value` flatten on the top level. SHAPE-GOTCHAS §1. */
+export declare function keyValueActivationKey(fields: Omit<KeyValueKey, 'type'>): Tagged<KeyValueKey, 'key_value'>;
+/** Grouped accessor for both `ActivationKey` variants. */
+export declare const activationKey: {
+    readonly segment: typeof segmentIdActivationKey;
+    readonly keyValue: typeof keyValueActivationKey;
+};
+export {};
+//# sourceMappingURL=activation-key-builders.d.ts.map

package/dist/lib/utils/activation-key-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation-key-builders.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/activation-key-builders.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,KAAK,YAAY,GAAG,OAAO,CAAC,aAAa,EAAE;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC;AACnE,KAAK,WAAW,GAAG,OAAO,CAAC,aAAa,EAAE;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,CAAC;AACjE,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,IAAI,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,EAAE,GAAG,CAAA;CAAE,CAAC;AAErE,oDAAoD;AACpD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC,CAE7G;AAED,6GAA6G;AAC7G,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,CAEzG;AAED,0DAA0D;AAC1D,eAAO,MAAM,aAAa;;;CAGhB,CAAC"}

package/dist/lib/utils/activation-key-builders.js

@@ -0,0 +1,28 @@
+"use strict";
+// Typed factory helpers for `ActivationKey` — schema oneOf on
+// `type: "segment_id" | "key_value"`. The `key_value` arm is consistently
+// mis-shaped: adopters intuit a nested `{ key_value: { key, value } }` and
+// write that, even though the schema flattens `key`/`value` onto the
+// `ActivationKey` itself. SHAPE-GOTCHAS §1.
+//
+// Same pattern as `asset-builders.ts` / `render-builders.ts`: spread order
+// writes the discriminator last, so a runtime cast that smuggles `type`
+// in via `fields` cannot clobber it.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.activationKey = void 0;
+exports.segmentIdActivationKey = segmentIdActivationKey;
+exports.keyValueActivationKey = keyValueActivationKey;
+/** Build a `segment_id`-variant `ActivationKey`. */
+function segmentIdActivationKey(fields) {
+    return { ...fields, type: 'segment_id' };
+}
+/** Build a `key_value`-variant `ActivationKey`. `key`/`value` flatten on the top level. SHAPE-GOTCHAS §1. */
+function keyValueActivationKey(fields) {
+    return { ...fields, type: 'key_value' };
+}
+/** Grouped accessor for both `ActivationKey` variants. */
+exports.activationKey = {
+    segment: segmentIdActivationKey,
+    keyValue: keyValueActivationKey,
+};
+//# sourceMappingURL=activation-key-builders.js.map

package/dist/lib/utils/activation-key-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation-key-builders.js","sourceRoot":"","sources":["../../../src/lib/utils/activation-key-builders.ts"],"names":[],"mappings":";AAAA,8DAA8D;AAC9D,0EAA0E;AAC1E,2EAA2E;AAC3E,qEAAqE;AACrE,4CAA4C;AAC5C,EAAE;AACF,2EAA2E;AAC3E,wEAAwE;AACxE,qCAAqC;;;AASrC,wDAEC;AAGD,sDAEC;AARD,oDAAoD;AACpD,SAAgB,sBAAsB,CAAC,MAAkC;IACvE,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AAC3C,CAAC;AAED,6GAA6G;AAC7G,SAAgB,qBAAqB,CAAC,MAAiC;IACrE,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAC1C,CAAC;AAED,0DAA0D;AAC7C,QAAA,aAAa,GAAG;IAC3B,OAAO,EAAE,sBAAsB;IAC/B,QAAQ,EAAE,qBAAqB;CACvB,CAAC"}

package/dist/lib/utils/build-creative-return-builders.d.ts

@@ -0,0 +1,24 @@
+import type { BuildCreativeSuccess, BuildCreativeMultiSuccess, CreativeManifest } from '../types/core.generated';
+type SingleEnvelopeFields = Omit<BuildCreativeSuccess, 'creative_manifest'> & {
+    manifest: CreativeManifest;
+};
+type MultiEnvelopeFields = Omit<BuildCreativeMultiSuccess, 'creative_manifests'> & {
+    manifests: CreativeManifest[];
+};
+/** Bare single-format manifest. Framework wraps as `{ creative_manifest }`. */
+export declare function singleBuildCreativeReturn(manifest: CreativeManifest): CreativeManifest;
+/** Bare multi-format manifest array. Framework wraps as `{ creative_manifests }`. */
+export declare function multiBuildCreativeReturn(manifests: CreativeManifest[]): CreativeManifest[];
+/** Shaped `BuildCreativeSuccess`. `manifest` field renamed to `creative_manifest` on wire. */
+export declare function singleEnvelopedBuildCreativeReturn(fields: SingleEnvelopeFields): BuildCreativeSuccess;
+/** Shaped `BuildCreativeMultiSuccess`. `manifests` renamed to `creative_manifests` on wire. */
+export declare function multiEnvelopedBuildCreativeReturn(fields: MultiEnvelopeFields): BuildCreativeMultiSuccess;
+/** Grouped accessor for the four `build_creative` return shapes. */
+export declare const buildCreativeReturn: {
+    readonly single: typeof singleBuildCreativeReturn;
+    readonly multi: typeof multiBuildCreativeReturn;
+    readonly singleEnveloped: typeof singleEnvelopedBuildCreativeReturn;
+    readonly multiEnveloped: typeof multiEnvelopedBuildCreativeReturn;
+};
+export {};
+//# sourceMappingURL=build-creative-return-builders.d.ts.map

package/dist/lib/utils/build-creative-return-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-creative-return-builders.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/build-creative-return-builders.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEjH,KAAK,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,GAAG;IAAE,QAAQ,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAC7G,KAAK,mBAAmB,GAAG,IAAI,CAAC,yBAAyB,EAAE,oBAAoB,CAAC,GAAG;IAAE,SAAS,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC;AAErH,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,gBAAgB,CAEtF;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAE1F;AAED,8FAA8F;AAC9F,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAGrG;AAED,+FAA+F;AAC/F,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,mBAAmB,GAAG,yBAAyB,CAGxG;AAED,oEAAoE;AACpE,eAAO,MAAM,mBAAmB;;;;;CAKtB,CAAC"}

package/dist/lib/utils/build-creative-return-builders.js

@@ -0,0 +1,42 @@
+"use strict";
+// Typed factory helpers for `build_creative` return values. Four shapes:
+//   1. bare `CreativeManifest`            — auto-wrapped as `{ creative_manifest }`
+//   2. bare `CreativeManifest[]`          — auto-wrapped as `{ creative_manifests }`
+//   3. shaped `BuildCreativeSuccess`      — passthrough
+//   4. shaped `BuildCreativeMultiSuccess` — passthrough multi-format
+//
+// Adopters writing the shaped envelope by hand consistently miss the
+// distinction between single (`creative_manifest`) and multi
+// (`creative_manifests`) field names. SHAPE-GOTCHAS §5.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCreativeReturn = void 0;
+exports.singleBuildCreativeReturn = singleBuildCreativeReturn;
+exports.multiBuildCreativeReturn = multiBuildCreativeReturn;
+exports.singleEnvelopedBuildCreativeReturn = singleEnvelopedBuildCreativeReturn;
+exports.multiEnvelopedBuildCreativeReturn = multiEnvelopedBuildCreativeReturn;
+/** Bare single-format manifest. Framework wraps as `{ creative_manifest }`. */
+function singleBuildCreativeReturn(manifest) {
+    return manifest;
+}
+/** Bare multi-format manifest array. Framework wraps as `{ creative_manifests }`. */
+function multiBuildCreativeReturn(manifests) {
+    return manifests;
+}
+/** Shaped `BuildCreativeSuccess`. `manifest` field renamed to `creative_manifest` on wire. */
+function singleEnvelopedBuildCreativeReturn(fields) {
+    const { manifest, ...rest } = fields;
+    return { ...rest, creative_manifest: manifest };
+}
+/** Shaped `BuildCreativeMultiSuccess`. `manifests` renamed to `creative_manifests` on wire. */
+function multiEnvelopedBuildCreativeReturn(fields) {
+    const { manifests, ...rest } = fields;
+    return { ...rest, creative_manifests: manifests };
+}
+/** Grouped accessor for the four `build_creative` return shapes. */
+exports.buildCreativeReturn = {
+    single: singleBuildCreativeReturn,
+    multi: multiBuildCreativeReturn,
+    singleEnveloped: singleEnvelopedBuildCreativeReturn,
+    multiEnveloped: multiEnvelopedBuildCreativeReturn,
+};
+//# sourceMappingURL=build-creative-return-builders.js.map

package/dist/lib/utils/build-creative-return-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-creative-return-builders.js","sourceRoot":"","sources":["../../../src/lib/utils/build-creative-return-builders.ts"],"names":[],"mappings":";AAAA,yEAAyE;AACzE,oFAAoF;AACpF,qFAAqF;AACrF,wDAAwD;AACxD,qEAAqE;AACrE,EAAE;AACF,qEAAqE;AACrE,6DAA6D;AAC7D,wDAAwD;;;AAQxD,8DAEC;AAGD,4DAEC;AAGD,gFAGC;AAGD,8EAGC;AApBD,+EAA+E;AAC/E,SAAgB,yBAAyB,CAAC,QAA0B;IAClE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,qFAAqF;AACrF,SAAgB,wBAAwB,CAAC,SAA6B;IACpE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,8FAA8F;AAC9F,SAAgB,kCAAkC,CAAC,MAA4B;IAC7E,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACrC,OAAO,EAAE,GAAG,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC;AAClD,CAAC;AAED,+FAA+F;AAC/F,SAAgB,iCAAiC,CAAC,MAA2B;IAC3E,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACtC,OAAO,EAAE,GAAG,IAAI,EAAE,kBAAkB,EAAE,SAAS,EAAE,CAAC;AACpD,CAAC;AAED,oEAAoE;AACvD,QAAA,mBAAmB,GAAG;IACjC,MAAM,EAAE,yBAAyB;IACjC,KAAK,EAAE,wBAAwB;IAC/B,eAAe,EAAE,kCAAkC;IACnD,cAAc,EAAE,iCAAiC;CACzC,CAAC"}

package/dist/lib/utils/media-buy-delivery-notification-builders.d.ts

@@ -0,0 +1,25 @@
+import type { GetMediaBuyDeliveryResponse } from '../types/core.generated';
+type NotificationFields = Omit<GetMediaBuyDeliveryResponse, 'notification_type'>;
+type Tagged<Tag extends string> = NotificationFields & {
+    notification_type: Tag;
+};
+/** Regular periodic delivery update. Set `sequence_number` and `next_expected_at`. */
+export declare function scheduledMediaBuyDeliveryNotification(fields: NotificationFields): Tagged<'scheduled'>;
+/** Campaign completed; no further notifications. Omit `next_expected_at`. */
+export declare function finalMediaBuyDeliveryNotification(fields: NotificationFields): Tagged<'final'>;
+/** Data not yet available. Set `partial_data: true` and `unavailable_count`. */
+export declare function delayedMediaBuyDeliveryNotification(fields: NotificationFields): Tagged<'delayed'>;
+/** Re-send with corrected data, SAME measurement window. Distinct from `window_update`. */
+export declare function adjustedMediaBuyDeliveryNotification(fields: NotificationFields): Tagged<'adjusted'>;
+/** Re-send with WIDER measurement window (e.g. C7 superseding C3). */
+export declare function windowUpdateMediaBuyDeliveryNotification(fields: NotificationFields): Tagged<'window_update'>;
+/** Grouped accessor for all five `MediaBuyDeliveryNotification` variants. */
+export declare const mediaBuyDeliveryNotification: {
+    readonly scheduled: typeof scheduledMediaBuyDeliveryNotification;
+    readonly final: typeof finalMediaBuyDeliveryNotification;
+    readonly delayed: typeof delayedMediaBuyDeliveryNotification;
+    readonly adjusted: typeof adjustedMediaBuyDeliveryNotification;
+    readonly windowUpdate: typeof windowUpdateMediaBuyDeliveryNotification;
+};
+export {};
+//# sourceMappingURL=media-buy-delivery-notification-builders.d.ts.map

package/dist/lib/utils/media-buy-delivery-notification-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-buy-delivery-notification-builders.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/media-buy-delivery-notification-builders.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAE3E,KAAK,kBAAkB,GAAG,IAAI,CAAC,2BAA2B,EAAE,mBAAmB,CAAC,CAAC;AACjF,KAAK,MAAM,CAAC,GAAG,SAAS,MAAM,IAAI,kBAAkB,GAAG;IAAE,iBAAiB,EAAE,GAAG,CAAA;CAAE,CAAC;AAElF,sFAAsF;AACtF,wBAAgB,qCAAqC,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAAC,WAAW,CAAC,CAErG;AAED,6EAA6E;AAC7E,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAAC,OAAO,CAAC,CAE7F;AAED,gFAAgF;AAChF,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAAC,SAAS,CAAC,CAEjG;AAED,2FAA2F;AAC3F,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAAC,UAAU,CAAC,CAEnG;AAED,sEAAsE;AACtE,wBAAgB,wCAAwC,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAAC,eAAe,CAAC,CAE5G;AAED,6EAA6E;AAC7E,eAAO,MAAM,4BAA4B;;;;;;CAM/B,CAAC"}

package/dist/lib/utils/media-buy-delivery-notification-builders.js

@@ -0,0 +1,41 @@
+"use strict";
+// Typed factory helpers for `get_media_buy_delivery` webhook notifications.
+// `notification_type` discriminator carries five values, each with distinct
+// re-send / supersession semantics:
+//   `scheduled` / `final` / `delayed` / `adjusted` / `window_update`.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mediaBuyDeliveryNotification = void 0;
+exports.scheduledMediaBuyDeliveryNotification = scheduledMediaBuyDeliveryNotification;
+exports.finalMediaBuyDeliveryNotification = finalMediaBuyDeliveryNotification;
+exports.delayedMediaBuyDeliveryNotification = delayedMediaBuyDeliveryNotification;
+exports.adjustedMediaBuyDeliveryNotification = adjustedMediaBuyDeliveryNotification;
+exports.windowUpdateMediaBuyDeliveryNotification = windowUpdateMediaBuyDeliveryNotification;
+/** Regular periodic delivery update. Set `sequence_number` and `next_expected_at`. */
+function scheduledMediaBuyDeliveryNotification(fields) {
+    return { ...fields, notification_type: 'scheduled' };
+}
+/** Campaign completed; no further notifications. Omit `next_expected_at`. */
+function finalMediaBuyDeliveryNotification(fields) {
+    return { ...fields, notification_type: 'final' };
+}
+/** Data not yet available. Set `partial_data: true` and `unavailable_count`. */
+function delayedMediaBuyDeliveryNotification(fields) {
+    return { ...fields, notification_type: 'delayed' };
+}
+/** Re-send with corrected data, SAME measurement window. Distinct from `window_update`. */
+function adjustedMediaBuyDeliveryNotification(fields) {
+    return { ...fields, notification_type: 'adjusted' };
+}
+/** Re-send with WIDER measurement window (e.g. C7 superseding C3). */
+function windowUpdateMediaBuyDeliveryNotification(fields) {
+    return { ...fields, notification_type: 'window_update' };
+}
+/** Grouped accessor for all five `MediaBuyDeliveryNotification` variants. */
+exports.mediaBuyDeliveryNotification = {
+    scheduled: scheduledMediaBuyDeliveryNotification,
+    final: finalMediaBuyDeliveryNotification,
+    delayed: delayedMediaBuyDeliveryNotification,
+    adjusted: adjustedMediaBuyDeliveryNotification,
+    windowUpdate: windowUpdateMediaBuyDeliveryNotification,
+};
+//# sourceMappingURL=media-buy-delivery-notification-builders.js.map

package/dist/lib/utils/media-buy-delivery-notification-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-buy-delivery-notification-builders.js","sourceRoot":"","sources":["../../../src/lib/utils/media-buy-delivery-notification-builders.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,4EAA4E;AAC5E,oCAAoC;AACpC,sEAAsE;;;AAQtE,sFAEC;AAGD,8EAEC;AAGD,kFAEC;AAGD,oFAEC;AAGD,4FAEC;AAvBD,sFAAsF;AACtF,SAAgB,qCAAqC,CAAC,MAA0B;IAC9E,OAAO,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC;AACvD,CAAC;AAED,6EAA6E;AAC7E,SAAgB,iCAAiC,CAAC,MAA0B;IAC1E,OAAO,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC;AACnD,CAAC;AAED,gFAAgF;AAChF,SAAgB,mCAAmC,CAAC,MAA0B;IAC5E,OAAO,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC;AACrD,CAAC;AAED,2FAA2F;AAC3F,SAAgB,oCAAoC,CAAC,MAA0B;IAC7E,OAAO,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC;AACtD,CAAC;AAED,sEAAsE;AACtE,SAAgB,wCAAwC,CAAC,MAA0B;IACjF,OAAO,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAC;AAC3D,CAAC;AAED,6EAA6E;AAChE,QAAA,4BAA4B,GAAG;IAC1C,SAAS,EAAE,qCAAqC;IAChD,KAAK,EAAE,iCAAiC;IACxC,OAAO,EAAE,mCAAmC;IAC5C,QAAQ,EAAE,oCAAoC;IAC9C,YAAY,EAAE,wCAAwC;CAC9C,CAAC"}

package/dist/lib/utils/preview-creative-builders.d.ts

@@ -0,0 +1,18 @@
+import type { PreviewCreativeSingleResponse, PreviewCreativeBatchResponse, PreviewCreativeVariantResponse } from '../types/core.generated';
+type Tagged<T, Tag extends string> = Omit<T, 'response_type'> & {
+    response_type: Tag;
+};
+/** Build a `single`-variant `PreviewCreativeResponse`. */
+export declare function singlePreviewCreativeResponse(fields: Omit<PreviewCreativeSingleResponse, 'response_type'>): Tagged<PreviewCreativeSingleResponse, 'single'>;
+/** Build a `batch`-variant `PreviewCreativeResponse`. */
+export declare function batchPreviewCreativeResponse(fields: Omit<PreviewCreativeBatchResponse, 'response_type'>): Tagged<PreviewCreativeBatchResponse, 'batch'>;
+/** Build a `variant`-variant `PreviewCreativeResponse`. */
+export declare function variantPreviewCreativeResponse(fields: Omit<PreviewCreativeVariantResponse, 'response_type'>): Tagged<PreviewCreativeVariantResponse, 'variant'>;
+/** Grouped accessor for the three `PreviewCreativeResponse` variants. */
+export declare const previewCreative: {
+    readonly single: typeof singlePreviewCreativeResponse;
+    readonly batch: typeof batchPreviewCreativeResponse;
+    readonly variant: typeof variantPreviewCreativeResponse;
+};
+export {};
+//# sourceMappingURL=preview-creative-builders.d.ts.map

package/dist/lib/utils/preview-creative-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-creative-builders.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/preview-creative-builders.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,6BAA6B,EAC7B,4BAA4B,EAC5B,8BAA8B,EAC/B,MAAM,yBAAyB,CAAC;AAEjC,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,IAAI,IAAI,CAAC,CAAC,EAAE,eAAe,CAAC,GAAG;IAAE,aAAa,EAAE,GAAG,CAAA;CAAE,CAAC;AAEvF,0DAA0D;AAC1D,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,IAAI,CAAC,6BAA6B,EAAE,eAAe,CAAC,GAC3D,MAAM,CAAC,6BAA6B,EAAE,QAAQ,CAAC,CAEjD;AAED,yDAAyD;AACzD,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE,eAAe,CAAC,GAC1D,MAAM,CAAC,4BAA4B,EAAE,OAAO,CAAC,CAE/C;AAED,2DAA2D;AAC3D,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,IAAI,CAAC,8BAA8B,EAAE,eAAe,CAAC,GAC5D,MAAM,CAAC,8BAA8B,EAAE,SAAS,CAAC,CAEnD;AAED,yEAAyE;AACzE,eAAO,MAAM,eAAe;;;;CAIlB,CAAC"}

package/dist/lib/utils/preview-creative-builders.js

@@ -0,0 +1,28 @@
+"use strict";
+// Typed factory helpers for `preview_creative` responses. Schema oneOf is a
+// three-way switch on `response_type: "single" | "batch" | "variant"`.
+// SHAPE-GOTCHAS §4.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.previewCreative = void 0;
+exports.singlePreviewCreativeResponse = singlePreviewCreativeResponse;
+exports.batchPreviewCreativeResponse = batchPreviewCreativeResponse;
+exports.variantPreviewCreativeResponse = variantPreviewCreativeResponse;
+/** Build a `single`-variant `PreviewCreativeResponse`. */
+function singlePreviewCreativeResponse(fields) {
+    return { ...fields, response_type: 'single' };
+}
+/** Build a `batch`-variant `PreviewCreativeResponse`. */
+function batchPreviewCreativeResponse(fields) {
+    return { ...fields, response_type: 'batch' };
+}
+/** Build a `variant`-variant `PreviewCreativeResponse`. */
+function variantPreviewCreativeResponse(fields) {
+    return { ...fields, response_type: 'variant' };
+}
+/** Grouped accessor for the three `PreviewCreativeResponse` variants. */
+exports.previewCreative = {
+    single: singlePreviewCreativeResponse,
+    batch: batchPreviewCreativeResponse,
+    variant: variantPreviewCreativeResponse,
+};
+//# sourceMappingURL=preview-creative-builders.js.map

package/dist/lib/utils/preview-creative-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-creative-builders.js","sourceRoot":"","sources":["../../../src/lib/utils/preview-creative-builders.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,uEAAuE;AACvE,oBAAoB;;;AAWpB,sEAIC;AAGD,oEAIC;AAGD,wEAIC;AAnBD,0DAA0D;AAC1D,SAAgB,6BAA6B,CAC3C,MAA4D;IAE5D,OAAO,EAAE,GAAG,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;AAChD,CAAC;AAED,yDAAyD;AACzD,SAAgB,4BAA4B,CAC1C,MAA2D;IAE3D,OAAO,EAAE,GAAG,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC;AAED,2DAA2D;AAC3D,SAAgB,8BAA8B,CAC5C,MAA6D;IAE7D,OAAO,EAAE,GAAG,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;AACjD,CAAC;AAED,yEAAyE;AAC5D,QAAA,eAAe,GAAG;IAC7B,MAAM,EAAE,6BAA6B;IACrC,KAAK,EAAE,4BAA4B;IACnC,OAAO,EAAE,8BAA8B;CAC/B,CAAC"}

package/dist/lib/utils/protocol-detection.js

@@ -36,6 +36,19 @@ async function detectA2AOrMcp(url, timeoutMs) {
     if (url.endsWith('/mcp/') || url.endsWith('/mcp')) {
         return 'mcp';
     }
+    // adcp-client#1612: classify each well-known card probe into one of three
+    // signals so we can distinguish "this is A2A but momentarily 503" from
+    // "this is not A2A":
+    //   - `confirm`  : 200/3xx — A2A confirmed
+    //   - `suspect`  : 5xx or transport error — host knows the path but can't
+    //                  serve it right now; still strong evidence of A2A. Falling
+    //                  back to MCP here is what produced the original #1612
+    //                  symptom (425s of MCP retries against an A2A root).
+    //   - `negative` : 4xx (other than 401/403/429) — host doesn't recognize
+    //                  the well-known path; MCP is the better default.
+    // 401/403/429 are auth/rate signals on the well-known path itself, which
+    // also indicate "host knows the path" → suspect.
+    let suspect = false;
     for (const path of a2a_discovery_1.A2A_CARD_PATHS) {
         try {
             const discoveryUrl = new URL(path, url);
@@ -52,11 +65,21 @@ async function detectA2AOrMcp(url, timeoutMs) {
             if (response.ok) {
                 return 'a2a';
             }
+            // 5xx or auth-on-the-path: treat as A2A suspicion (host has this route
+            // but couldn't return the card right now). Don't return immediately —
+            // a later path might confirm with a 200.
+            if (response.status >= 500 || response.status === 401 || response.status === 403 || response.status === 429) {
+                suspect = true;
+            }
+            // 4xx (other than the above): negative evidence, leave suspect alone.
         }
-        catch (error) {
-            // Fetch failed - try next path
+        catch {
+            // Network error or our 5s timeout fired. The host may still be A2A
+            // (just slow); upgrade suspicion so we don't fall back to MCP and
+            // burn the caller's discovery budget on a non-MCP root.
+            suspect = true;
         }
     }
-    return 'mcp';
+    return suspect ? 'a2a' : 'mcp';
 }
 //# sourceMappingURL=protocol-detection.js.map

package/dist/lib/utils/protocol-detection.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol-detection.js","sourceRoot":"","sources":["../../../src/lib/utils/protocol-detection.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAeH,wCAEC;AASD,8DAEC;AA1BD,mDAAiD;AAEjD;;;;;;;;;;GAUG;AACI,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,OAAO,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,yBAAyB,CAAC,GAAW,EAAE,YAAoB,IAAI;IACnF,OAAO,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,SAAiB;IAC1D,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,8BAAc,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACxC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;YAElE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE;gBACpD,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,OAAO,EAAE;oBACP,MAAM,EAAE,uBAAuB;iBAChC;aACF,CAAC,CAAC;YAEH,YAAY,CAAC,SAAS,CAAC,CAAC;YAExB,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,+BAA+B;QACjC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"protocol-detection.js","sourceRoot":"","sources":["../../../src/lib/utils/protocol-detection.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAeH,wCAEC;AASD,8DAEC;AA1BD,mDAAiD;AAEjD;;;;;;;;;;GAUG;AACI,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,OAAO,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,yBAAyB,CAAC,GAAW,EAAE,YAAoB,IAAI;IACnF,OAAO,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,SAAiB;IAC1D,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,0EAA0E;IAC1E,uEAAuE;IACvE,qBAAqB;IACrB,2CAA2C;IAC3C,0EAA0E;IAC1E,6EAA6E;IAC7E,wEAAwE;IACxE,sEAAsE;IACtE,yEAAyE;IACzE,mEAAmE;IACnE,yEAAyE;IACzE,iDAAiD;IACjD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,8BAAc,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACxC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;YAElE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE;gBACpD,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,OAAO,EAAE;oBACP,MAAM,EAAE,uBAAuB;iBAChC;aACF,CAAC,CAAC;YAEH,YAAY,CAAC,SAAS,CAAC,CAAC;YAExB,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,uEAAuE;YACvE,sEAAsE;YACtE,yCAAyC;YACzC,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5G,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YACD,sEAAsE;QACxE,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;YACnE,kEAAkE;YAClE,wDAAwD;YACxD,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AACjC,CAAC"}

package/dist/lib/utils/signal-id-builders.d.ts

@@ -0,0 +1,21 @@
+import type { SignalID } from '../types/core.generated';
+type CatalogSignal = Extract<SignalID, {
+    source: 'catalog';
+}>;
+type AgentSignal = Extract<SignalID, {
+    source: 'agent';
+}>;
+type Tagged<T, Tag extends string> = Omit<T, 'source'> & {
+    source: Tag;
+};
+/** Build a `catalog`-variant `SignalID`. Verifiable via the providers adagents.json. */
+export declare function catalogSignalId(fields: Omit<CatalogSignal, 'source'>): Tagged<CatalogSignal, 'catalog'>;
+/** Build an `agent`-variant `SignalID`. Agent-native segments not in a catalog. */
+export declare function agentSignalId(fields: Omit<AgentSignal, 'source'>): Tagged<AgentSignal, 'agent'>;
+/** Grouped accessor for both `SignalID` variants. */
+export declare const signalId: {
+    readonly catalog: typeof catalogSignalId;
+    readonly agent: typeof agentSignalId;
+};
+export {};
+//# sourceMappingURL=signal-id-builders.d.ts.map

package/dist/lib/utils/signal-id-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-id-builders.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/signal-id-builders.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,KAAK,aAAa,GAAG,OAAO,CAAC,QAAQ,EAAE;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAC9D,KAAK,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAC1D,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,IAAI,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG;IAAE,MAAM,EAAE,GAAG,CAAA;CAAE,CAAC;AAEzE,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,CAEvG;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAE/F;AAED,qDAAqD;AACrD,eAAO,MAAM,QAAQ;;;CAGX,CAAC"}

package/dist/lib/utils/signal-id-builders.js

@@ -0,0 +1,24 @@
+"use strict";
+// Typed factory helpers for `SignalID` — provenance tuple used in
+// `signal_ids` filters and as the `signal_id` field on `Signal` records.
+// Schema oneOf on `source: "catalog" | "agent"`. Adopters emit bare ID
+// strings for `signal_ids` filters even though the wire shape is an array
+// of provenance objects. SHAPE-GOTCHAS §2.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signalId = void 0;
+exports.catalogSignalId = catalogSignalId;
+exports.agentSignalId = agentSignalId;
+/** Build a `catalog`-variant `SignalID`. Verifiable via the providers adagents.json. */
+function catalogSignalId(fields) {
+    return { ...fields, source: 'catalog' };
+}
+/** Build an `agent`-variant `SignalID`. Agent-native segments not in a catalog. */
+function agentSignalId(fields) {
+    return { ...fields, source: 'agent' };
+}
+/** Grouped accessor for both `SignalID` variants. */
+exports.signalId = {
+    catalog: catalogSignalId,
+    agent: agentSignalId,
+};
+//# sourceMappingURL=signal-id-builders.js.map

package/dist/lib/utils/signal-id-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-id-builders.js","sourceRoot":"","sources":["../../../src/lib/utils/signal-id-builders.ts"],"names":[],"mappings":";AAAA,kEAAkE;AAClE,yEAAyE;AACzE,uEAAuE;AACvE,0EAA0E;AAC1E,2CAA2C;;;AAS3C,0CAEC;AAGD,sCAEC;AARD,wFAAwF;AACxF,SAAgB,eAAe,CAAC,MAAqC;IACnE,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC1C,CAAC;AAED,mFAAmF;AACnF,SAAgB,aAAa,CAAC,MAAmC;IAC/D,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACxC,CAAC;AAED,qDAAqD;AACxC,QAAA,QAAQ,GAAG;IACtB,OAAO,EAAE,eAAe;IACxB,KAAK,EAAE,aAAa;CACZ,CAAC"}

package/dist/lib/version.d.ts

@@ -1,11 +1,11 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "6.14.0";
+export declare const LIBRARY_VERSION = "6.15.1";
 /**
  * AdCP specification version this library is built for
  */
-export declare const ADCP_VERSION = "3.0.7";
+export declare const ADCP_VERSION = "3.0.8";
 /**
  * AdCP major version sent with every request (adcp_major_version field).
  * Sellers validate this against their supported versions and return
@@ -15,7 +15,7 @@ export declare const ADCP_MAJOR_VERSION = 3;
 /**
  * AdCP versions this library maintains backward compatibility with
  */
-export declare const COMPATIBLE_ADCP_VERSIONS: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0.0-beta.3", "3.0.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7"];
+export declare const COMPATIBLE_ADCP_VERSIONS: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0.0-beta.3", "3.0.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8"];
 /**
  * String literal union of every AdCP version the SDK formally supports.
  *
@@ -29,10 +29,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "6.14.0";
-    readonly adcp: "3.0.7";
-    readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0.0-beta.3", "3.0.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7"];
-    readonly generatedAt: "2026-05-08T13:17:43.198Z";
+    readonly library: "6.15.1";
+    readonly adcp: "3.0.8";
+    readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0.0-beta.3", "3.0.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8"];
+    readonly generatedAt: "2026-05-09T13:21:46.607Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,wBAAwB,yIAc3B,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,SAAS,MAAM,EAAE,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK7D"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,wBAAwB,kJAe3B,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,SAAS,MAAM,EAAE,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK7D"}

package/dist/lib/version.js

@@ -11,11 +11,11 @@ exports.parseAdcpMajorVersion = parseAdcpMajorVersion;
 /**
  * AdCP SDK library version
  */
-exports.LIBRARY_VERSION = '6.14.0';
+exports.LIBRARY_VERSION = '6.15.1';
 /**
  * AdCP specification version this library is built for
  */
-exports.ADCP_VERSION = '3.0.7';
+exports.ADCP_VERSION = '3.0.8';
 /**
  * AdCP major version sent with every request (adcp_major_version field).
  * Sellers validate this against their supported versions and return
@@ -39,15 +39,16 @@ exports.COMPATIBLE_ADCP_VERSIONS = [
     '3.0.5',
     '3.0.6',
     '3.0.7',
+    '3.0.8',
 ];
 /**
  * Full version information
  */
 exports.VERSION_INFO = {
-    library: '6.14.0',
-    adcp: '3.0.7',
+    library: '6.15.1',
+    adcp: '3.0.8',
     compatibleVersions: exports.COMPATIBLE_ADCP_VERSIONS,
-    generatedAt: '2026-05-08T13:17:43.198Z',
+    generatedAt: '2026-05-09T13:21:46.607Z',
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":";AAAA,gCAAgC;AAChC,iDAAiD;;;AA6DjD,wCAEC;AAKD,8CAEC;AAKD,4CAEC;AAKD,sDAEC;AAWD,sDAKC;AAlGD;;GAEG;AACU,QAAA,eAAe,GAAG,QAAQ,CAAC;AAExC;;GAEG;AACU,QAAA,YAAY,GAAG,OAAO,CAAC;AAEpC;;;;GAIG;AACU,QAAA,kBAAkB,GAAG,CAAC,CAAC;AAEpC;;GAEG;AACU,QAAA,wBAAwB,GAAG;IACtC,MAAM;IACN,MAAM;IACN,IAAI;IACJ,cAAc;IACd,cAAc;IACd,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;CACC,CAAC;AAYX;;GAEG;AACU,QAAA,YAAY,GAAG;IAC1B,OAAO,EAAE,QAAQ;IACjB,IAAI,EAAE,OAAO;IACb,kBAAkB,EAAE,gCAAwB;IAC5C,WAAW,EAAE,0BAA0B;CAC/B,CAAC;AAEX;;GAEG;AACH,SAAgB,cAAc;IAC5B,OAAO,oBAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,uBAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,WAAmB;IAClD,OAAQ,gCAA8C,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB;IACnC,OAAO,gCAAwB,CAAC;AAClC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CAAC,OAAe;IACnD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACxE,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":";AAAA,gCAAgC;AAChC,iDAAiD;;;AA8DjD,wCAEC;AAKD,8CAEC;AAKD,4CAEC;AAKD,sDAEC;AAWD,sDAKC;AAnGD;;GAEG;AACU,QAAA,eAAe,GAAG,QAAQ,CAAC;AAExC;;GAEG;AACU,QAAA,YAAY,GAAG,OAAO,CAAC;AAEpC;;;;GAIG;AACU,QAAA,kBAAkB,GAAG,CAAC,CAAC;AAEpC;;GAEG;AACU,QAAA,wBAAwB,GAAG;IACtC,MAAM;IACN,MAAM;IACN,IAAI;IACJ,cAAc;IACd,cAAc;IACd,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;CACC,CAAC;AAYX;;GAEG;AACU,QAAA,YAAY,GAAG;IAC1B,OAAO,EAAE,QAAQ;IACjB,IAAI,EAAE,OAAO;IACb,kBAAkB,EAAE,gCAAwB;IAC5C,WAAW,EAAE,0BAA0B;CAC/B,CAAC;AAEX;;GAEG;AACH,SAAgB,cAAc;IAC5B,OAAO,oBAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,uBAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,WAAmB;IAClD,OAAQ,gCAA8C,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB;IACnC,OAAO,gCAAwB,CAAC;AAClC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CAAC,OAAe;IACnD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACxE,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;AAC9C,CAAC"}

package/examples/hello_creative_adapter_ad_server.ts

@@ -66,7 +66,7 @@ import {
   type DecisioningPlatform,
   type SyncCreativesRow,
 } from '@adcp/sdk/server';
-import { FormatAsset } from '@adcp/sdk';
+import { FormatAsset, buildCreativeReturn, previewCreative, urlRender } from '@adcp/sdk';
 import type {
   BuildCreativeRequest,
   BuildCreativeSuccess,
@@ -511,16 +511,17 @@ class CreativeAdServerAdapter implements DecisioningPlatform<Record<string, neve
       // satisfying creative-manifest.json:14. Each `assets[key]` is a
       // discriminated AssetVariant — `asset_type` selects the matching
       // schema (html requires `content`, etc.).
-      return {
-        creative_manifest: {
+      // `buildCreativeReturn.singleEnveloped({...})` injects the wire-shape
+      // discriminator: takes a flat `manifest` field (renamed to
+      // `creative_manifest` on the wire). SHAPE-GOTCHAS §5.
+      return buildCreativeReturn.singleEnveloped({
+        manifest: {
           format_id: { agent_url: FORMAT_AGENT_URL, id: creative.format_id },
           assets: {
             serving_tag: { asset_type: 'html', content: rendered.tag_html },
           },
         },
-        // CAST: oneOf-emitter — picking variant 0 (single creative_manifest)
-        // of the BuildCreativeResponse oneOf. Adopters keep this cast.
-      } as unknown as BuildCreativeSuccess;
+      });
     },
 
     /**
@@ -553,26 +554,24 @@ class CreativeAdServerAdapter implements DecisioningPlatform<Record<string, neve
         });
       }
       const rendered = await upstream.renderCreative(networkCode, creativeId, {});
-      return {
-        response_type: 'single',
+      // `previewCreative.single({...})` injects
+      // `response_type: 'single'`. SHAPE-GOTCHAS §4.
+      return previewCreative.single({
         previews: [
           {
             preview_id: `prv_${creative.creative_id}`,
             renders: [
-              {
+              urlRender({
                 render_id: `rnd_${creative.creative_id}`,
                 preview_url: rendered.preview_url,
                 role: 'primary',
-              },
+              }),
             ],
             input: { name: 'default' },
           },
         ],
         expires_at: new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString(),
-        // CAST: oneOf-emitter — picking the `single` discriminator branch
-        // of the PreviewCreativeResponse 3-way union (single | batch | variant).
-        // See SHAPE-GOTCHAS §4. Adopters keep this cast.
-      } as unknown as PreviewCreativeResponse;
+      });
     },
 
     listCreativeFormats: async (_req, _ctx): Promise<ListCreativeFormatsResponse> => {

package/examples/hello_creative_adapter_template.ts

@@ -52,6 +52,8 @@ import {
   javascriptAsset,
   audioAsset,
   urlRender,
+  buildCreativeReturn,
+  previewCreative,
   type Format,
   type ListCreativeFormatsResponse,
   type BuildCreativeRequest,
@@ -446,12 +448,13 @@ class CreativeTemplateAdapter implements DecisioningPlatform<Record<string, neve
         return projectRenderToManifest(completed, { agent_url: PUBLIC_AGENT_URL, id: target.id });
       };
 
-      // Multi-format request — return `CreativeManifest[]`; framework wraps
-      // as `{ creative_manifests: [...] }`. See BuildCreativeReturn (4-arm
-      // discriminated union) — returning the wrong arm fails wire-schema
-      // validation. SHAPE-GOTCHAS.md §5.
+      // `buildCreativeReturn.multi(...)` / `.single(...)` pin which arm of
+      // the 4-shape `BuildCreativeReturn` union you're emitting. The framework
+      // wraps `multi` into `{ creative_manifests: [...] }` and `single` into
+      // `{ creative_manifest: <obj> }` on the wire. SHAPE-GOTCHAS §5.
       if (req.target_format_ids && req.target_format_ids.length > 0) {
-        return Promise.all(req.target_format_ids.map((t, i) => buildOne(t, i)));
+        const manifests = await Promise.all(req.target_format_ids.map((t, i) => buildOne(t, i)));
+        return buildCreativeReturn.multi(manifests);
       }
 
       // Single-format request.
@@ -461,7 +464,7 @@ class CreativeTemplateAdapter implements DecisioningPlatform<Record<string, neve
           field: 'target_format_id',
         });
       }
-      return buildOne(req.target_format_id, 0);
+      return buildCreativeReturn.single(await buildOne(req.target_format_id, 0));
     },
 
     previewCreative: async (req: PreviewCreativeRequest, ctx): Promise<PreviewCreativeResponse> => {
@@ -516,12 +519,11 @@ class CreativeTemplateAdapter implements DecisioningPlatform<Record<string, neve
         throw new AdcpError('INVALID_REQUEST', { message: 'upstream returned no preview_url' });
       }
 
-      // PreviewCreativeResponse is a 3-way discriminated union (single |
-      // batch | variant). Single mode requires `previews[].renders[]` even
-      // for one preview — and each render needs the `output_format`
-      // discriminator. urlRender({...}) injects it. SHAPE-GOTCHAS.md §4.
-      return {
-        response_type: 'single',
+      // `previewCreative.single({...})` injects
+      // `response_type: 'single'`. The render slot's `output_format`
+      // discriminator is in turn injected by `urlRender({...})`.
+      // SHAPE-GOTCHAS §4.
+      return previewCreative.single({
         previews: [
           {
             preview_id: `prv_${created.render_id}`,
@@ -539,7 +541,7 @@ class CreativeTemplateAdapter implements DecisioningPlatform<Record<string, neve
           },
         ],
         expires_at: new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString(),
-      };
+      });
     },
   });
 }