@adcp/sdk 13.1.3 → 13.1.4

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

@@ -1453,10 +1453,7 @@ export type DAASTAsset = {
      * Discriminator indicating DAAST is delivered via URL endpoint
      */
     delivery_type: 'url';
-    /**
-     * URL endpoint that returns DAAST XML. May carry unsubstituted ad-server macros — DAAST/VAST-style `[MACRO]` and `${MACRO}` placeholders are accepted as-is (RFC 6570 syntax); buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
-     */
-    url: string;
+    url: MacroBearingURL;
 } | {
     /**
      * Discriminator indicating DAAST is delivered as inline XML content
@@ -1480,10 +1477,7 @@ export interface DAASTTrackerAsset {
      * The DAAST tracking event this URL fires on. MUST NOT be `impression` (model as `url` asset with `url_type: "tracker_pixel"`), `clickTracking` / `customClick` (click-tracking trackers go on their own URL asset), `error`, or any of the `ViewableImpression`-element children (`viewable`, `notViewable`, `viewUndetermined`, `measurableImpression`, `viewableImpression`).
      */
     daast_event: DAASTTrackingEvent;
-    /**
-     * Tracker URL that fires when `daast_event` occurs. May carry AdCP universal macros; the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * DAAST `offset` attribute. Required when `daast_event` is `progress` (DAAST 1.1 §3.2.4.3); ignored otherwise. Same format as VAST 4.2 `Tracking@offset`: `HH:MM:SS` or `HH:MM:SS.mmm` for absolute time (two-digit hours, minutes 00–59, seconds 00–59), or an integer percentage 0–100 suffixed with `%`. Negative offsets are NOT permitted.
      * @pattern ^(\d{2}:[0-5]\d:[0-5]\d(\.\d{3})?|(100|\d{1,2})%)$
@@ -1898,6 +1892,11 @@ export type LegacyPostalCodeSystem = 'us_zip' | 'us_zip_plus_four' | 'gb_outward
  */
 export type LiftDimension = 'awareness' | 'consideration' | 'favorability' | 'purchase_intent' | 'ad_recall';
 
+/**
+ * URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]`, `${MACRO}`, and `%%MACRO%%` placeholders are accepted as-is; buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
+ */
+export type MacroBearingURL = string;
+
 /**
  * Remedy types available when a performance standard or billing measurement threshold is breached.
  */
@@ -2599,10 +2598,7 @@ export interface PixelTrackerAsset {
      * Matches IAB OpenRTB Native 1.2 method enum (1=img, 2=js). `js` MUST only be used by sellers whose renderer supports JavaScript trackers; sellers without JS-tracker support MUST reject `method: js` declarations at sync_creatives time with `CREATIVE_REJECTED` carrying the reason.
      */
     method?: 'img' | 'js';
-    /**
-     * Tracker URL fired when `event` occurs. May carry AdCP universal macros (e.g., `{MEDIA_BUY_ID}`, `{CREATIVE_ID}`, `{CACHEBUSTER}`); the seller's renderer URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * REQUIRED when `event` is `custom`; otherwise MUST be absent. Adopter-defined event name. Sellers without registered handling for a given custom_event_name MUST silently no-op (do not fire) rather than reject — custom events are forward-compatible probes.
      */
@@ -3622,10 +3618,7 @@ export interface URLAsset {
      * Discriminator identifying this as a URL asset. See /schemas/creative/asset-types for the registry.
      */
     asset_type: 'url';
-    /**
-     * URL reference. May be a plain URI or an RFC 6570 URI template carrying AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`). Buyers MUST NOT pre-encode macro braces at sync time; the ad server URL-encodes substituted values at impression time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     url_type?: URLAssetType;
     /**
      * Description of what this URL points to
@@ -3685,10 +3678,7 @@ export type VASTAsset = {
      * Discriminator indicating VAST is delivered via URL endpoint
      */
     delivery_type: 'url';
-    /**
-     * URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]` and `${MACRO}` placeholders are accepted as-is (RFC 6570 syntax); buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
-     */
-    url: string;
+    url: MacroBearingURL;
 } | {
     /**
      * Discriminator indicating VAST is delivered as inline XML content
@@ -3712,10 +3702,7 @@ export interface VASTTrackerAsset {
      * The VAST tracking event this URL fires on. Maps 1:1 to the VAST `Tracking event="..."` attribute inside `TrackingEvents`. MUST NOT be `impression` (belongs in the VAST `Impression` element — model as a `url` asset with `url_type: "tracker_pixel"`), `clickTracking` / `customClick` (belong in `VideoClicks`), `error` (VAST `Error` element), or any of `viewable` / `notViewable` / `viewUndetermined` / `measurableImpression` / `viewableImpression` (children of the VAST `ViewableImpression` element, not `TrackingEvents`).
      */
     vast_event: VASTTrackingEvent;
-    /**
-     * Tracker URL that fires when `vast_event` occurs. May carry AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`); the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * VAST `offset` attribute. Required when `vast_event` is `progress`; ignored otherwise. Format matches the VAST 4.2 XSD `Tracking@offset` pattern: `HH:MM:SS` or `HH:MM:SS.mmm` for absolute time (two-digit hours, minutes 00–59, seconds 00–59), or an integer percentage 0–100 suffixed with `%`. Negative offsets are NOT permitted — the VAST 4.2 XSD pattern does not allow a leading minus.
      * @pattern ^(\d{2}:[0-5]\d:[0-5]\d(\.\d{3})?|(100|\d{1,2})%)$

package/dist/lib/types/get-creative-delivery.d.ts

@@ -735,10 +735,7 @@ export type DAASTAsset = {
      * Discriminator indicating DAAST is delivered via URL endpoint
      */
     delivery_type: 'url';
-    /**
-     * URL endpoint that returns DAAST XML. May carry unsubstituted ad-server macros — DAAST/VAST-style `[MACRO]` and `${MACRO}` placeholders are accepted as-is (RFC 6570 syntax); buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
-     */
-    url: string;
+    url: MacroBearingURL;
 } | {
     /**
      * Discriminator indicating DAAST is delivered as inline XML content
@@ -762,10 +759,7 @@ export interface DAASTTrackerAsset {
      * The DAAST tracking event this URL fires on. MUST NOT be `impression` (model as `url` asset with `url_type: "tracker_pixel"`), `clickTracking` / `customClick` (click-tracking trackers go on their own URL asset), `error`, or any of the `ViewableImpression`-element children (`viewable`, `notViewable`, `viewUndetermined`, `measurableImpression`, `viewableImpression`).
      */
     daast_event: DAASTTrackingEvent;
-    /**
-     * Tracker URL that fires when `daast_event` occurs. May carry AdCP universal macros; the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * DAAST `offset` attribute. Required when `daast_event` is `progress` (DAAST 1.1 §3.2.4.3); ignored otherwise. Same format as VAST 4.2 `Tracking@offset`: `HH:MM:SS` or `HH:MM:SS.mmm` for absolute time (two-digit hours, minutes 00–59, seconds 00–59), or an integer percentage 0–100 suffixed with `%`. Negative offsets are NOT permitted.
      * @pattern ^(\d{2}:[0-5]\d:[0-5]\d(\.\d{3})?|(100|\d{1,2})%)$
@@ -1409,6 +1403,11 @@ export interface LegacyManifestNamedFormatReference {
     ext?: ExtensionObject;
 }
 
+/**
+ * URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]`, `${MACRO}`, and `%%MACRO%%` placeholders are accepted as-is; buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
+ */
+export type MacroBearingURL = string;
+
 /**
  * Manifest declares which canonical format it targets via `format_kind` (e.g., `image`). This 3.1+ canonical-format path was introduced by RFC #3305.
  */
@@ -1557,10 +1556,7 @@ export interface PixelTrackerAsset {
      * Matches IAB OpenRTB Native 1.2 method enum (1=img, 2=js). `js` MUST only be used by sellers whose renderer supports JavaScript trackers; sellers without JS-tracker support MUST reject `method: js` declarations at sync_creatives time with `CREATIVE_REJECTED` carrying the reason.
      */
     method?: 'img' | 'js';
-    /**
-     * Tracker URL fired when `event` occurs. May carry AdCP universal macros (e.g., `{MEDIA_BUY_ID}`, `{CREATIVE_ID}`, `{CACHEBUSTER}`); the seller's renderer URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * REQUIRED when `event` is `custom`; otherwise MUST be absent. Adopter-defined event name. Sellers without registered handling for a given custom_event_name MUST silently no-op (do not fire) rather than reject — custom events are forward-compatible probes.
      */
@@ -2074,10 +2070,7 @@ export interface URLAsset {
      * Discriminator identifying this as a URL asset. See /schemas/creative/asset-types for the registry.
      */
     asset_type: 'url';
-    /**
-     * URL reference. May be a plain URI or an RFC 6570 URI template carrying AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`). Buyers MUST NOT pre-encode macro braces at sync time; the ad server URL-encodes substituted values at impression time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     url_type?: URLAssetType;
     /**
      * Description of what this URL points to
@@ -2137,10 +2130,7 @@ export type VASTAsset = {
      * Discriminator indicating VAST is delivered via URL endpoint
      */
     delivery_type: 'url';
-    /**
-     * URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]` and `${MACRO}` placeholders are accepted as-is (RFC 6570 syntax); buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
-     */
-    url: string;
+    url: MacroBearingURL;
 } | {
     /**
      * Discriminator indicating VAST is delivered as inline XML content
@@ -2164,10 +2154,7 @@ export interface VASTTrackerAsset {
      * The VAST tracking event this URL fires on. Maps 1:1 to the VAST `Tracking event="..."` attribute inside `TrackingEvents`. MUST NOT be `impression` (belongs in the VAST `Impression` element — model as a `url` asset with `url_type: "tracker_pixel"`), `clickTracking` / `customClick` (belong in `VideoClicks`), `error` (VAST `Error` element), or any of `viewable` / `notViewable` / `viewUndetermined` / `measurableImpression` / `viewableImpression` (children of the VAST `ViewableImpression` element, not `TrackingEvents`).
      */
     vast_event: VASTTrackingEvent;
-    /**
-     * Tracker URL that fires when `vast_event` occurs. May carry AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`); the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * VAST `offset` attribute. Required when `vast_event` is `progress`; ignored otherwise. Format matches the VAST 4.2 XSD `Tracking@offset` pattern: `HH:MM:SS` or `HH:MM:SS.mmm` for absolute time (two-digit hours, minutes 00–59, seconds 00–59), or an integer percentage 0–100 suffixed with `%`. Negative offsets are NOT permitted — the VAST 4.2 XSD pattern does not allow a leading minus.
      * @pattern ^(\d{2}:[0-5]\d:[0-5]\d(\.\d{3})?|(100|\d{1,2})%)$

package/dist/lib/types/get-creative-features.d.ts

@@ -763,10 +763,7 @@ export type DAASTAsset = {
      * Discriminator indicating DAAST is delivered via URL endpoint
      */
     delivery_type: 'url';
-    /**
-     * URL endpoint that returns DAAST XML. May carry unsubstituted ad-server macros — DAAST/VAST-style `[MACRO]` and `${MACRO}` placeholders are accepted as-is (RFC 6570 syntax); buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
-     */
-    url: string;
+    url: MacroBearingURL;
 } | {
     /**
      * Discriminator indicating DAAST is delivered as inline XML content
@@ -790,10 +787,7 @@ export interface DAASTTrackerAsset {
      * The DAAST tracking event this URL fires on. MUST NOT be `impression` (model as `url` asset with `url_type: "tracker_pixel"`), `clickTracking` / `customClick` (click-tracking trackers go on their own URL asset), `error`, or any of the `ViewableImpression`-element children (`viewable`, `notViewable`, `viewUndetermined`, `measurableImpression`, `viewableImpression`).
      */
     daast_event: DAASTTrackingEvent;
-    /**
-     * Tracker URL that fires when `daast_event` occurs. May carry AdCP universal macros; the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * DAAST `offset` attribute. Required when `daast_event` is `progress` (DAAST 1.1 §3.2.4.3); ignored otherwise. Same format as VAST 4.2 `Tracking@offset`: `HH:MM:SS` or `HH:MM:SS.mmm` for absolute time (two-digit hours, minutes 00–59, seconds 00–59), or an integer percentage 0–100 suffixed with `%`. Negative offsets are NOT permitted.
      * @pattern ^(\d{2}:[0-5]\d:[0-5]\d(\.\d{3})?|(100|\d{1,2})%)$
@@ -1060,6 +1054,11 @@ export interface LegacyManifestNamedFormatReference {
     ext?: ExtensionObject;
 }
 
+/**
+ * URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]`, `${MACRO}`, and `%%MACRO%%` placeholders are accepted as-is; buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
+ */
+export type MacroBearingURL = string;
+
 /**
  * Manifest declares which canonical format it targets via `format_kind` (e.g., `image`). This 3.1+ canonical-format path was introduced by RFC #3305.
  */
@@ -1192,10 +1191,7 @@ export interface PixelTrackerAsset {
      * Matches IAB OpenRTB Native 1.2 method enum (1=img, 2=js). `js` MUST only be used by sellers whose renderer supports JavaScript trackers; sellers without JS-tracker support MUST reject `method: js` declarations at sync_creatives time with `CREATIVE_REJECTED` carrying the reason.
      */
     method?: 'img' | 'js';
-    /**
-     * Tracker URL fired when `event` occurs. May carry AdCP universal macros (e.g., `{MEDIA_BUY_ID}`, `{CREATIVE_ID}`, `{CACHEBUSTER}`); the seller's renderer URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * REQUIRED when `event` is `custom`; otherwise MUST be absent. Adopter-defined event name. Sellers without registered handling for a given custom_event_name MUST silently no-op (do not fire) rather than reject — custom events are forward-compatible probes.
      */
@@ -1699,10 +1695,7 @@ export interface URLAsset {
      * Discriminator identifying this as a URL asset. See /schemas/creative/asset-types for the registry.
      */
     asset_type: 'url';
-    /**
-     * URL reference. May be a plain URI or an RFC 6570 URI template carrying AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`). Buyers MUST NOT pre-encode macro braces at sync time; the ad server URL-encodes substituted values at impression time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     url_type?: URLAssetType;
     /**
      * Description of what this URL points to
@@ -1762,10 +1755,7 @@ export type VASTAsset = {
      * Discriminator indicating VAST is delivered via URL endpoint
      */
     delivery_type: 'url';
-    /**
-     * URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]` and `${MACRO}` placeholders are accepted as-is (RFC 6570 syntax); buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
-     */
-    url: string;
+    url: MacroBearingURL;
 } | {
     /**
      * Discriminator indicating VAST is delivered as inline XML content
@@ -1789,10 +1779,7 @@ export interface VASTTrackerAsset {
      * The VAST tracking event this URL fires on. Maps 1:1 to the VAST `Tracking event="..."` attribute inside `TrackingEvents`. MUST NOT be `impression` (belongs in the VAST `Impression` element — model as a `url` asset with `url_type: "tracker_pixel"`), `clickTracking` / `customClick` (belong in `VideoClicks`), `error` (VAST `Error` element), or any of `viewable` / `notViewable` / `viewUndetermined` / `measurableImpression` / `viewableImpression` (children of the VAST `ViewableImpression` element, not `TrackingEvents`).
      */
     vast_event: VASTTrackingEvent;
-    /**
-     * Tracker URL that fires when `vast_event` occurs. May carry AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`); the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * VAST `offset` attribute. Required when `vast_event` is `progress`; ignored otherwise. Format matches the VAST 4.2 XSD `Tracking@offset` pattern: `HH:MM:SS` or `HH:MM:SS.mmm` for absolute time (two-digit hours, minutes 00–59, seconds 00–59), or an integer percentage 0–100 suffixed with `%`. Negative offsets are NOT permitted — the VAST 4.2 XSD pattern does not allow a leading minus.
      * @pattern ^(\d{2}:[0-5]\d:[0-5]\d(\.\d{3})?|(100|\d{1,2})%)$

package/dist/lib/types/get-task-status.d.ts

@@ -4277,10 +4277,7 @@ export type DAASTAsset = {
      * Discriminator indicating DAAST is delivered via URL endpoint
      */
     delivery_type: 'url';
-    /**
-     * URL endpoint that returns DAAST XML. May carry unsubstituted ad-server macros — DAAST/VAST-style `[MACRO]` and `${MACRO}` placeholders are accepted as-is (RFC 6570 syntax); buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
-     */
-    url: string;
+    url: MacroBearingURL;
 } | {
     /**
      * Discriminator indicating DAAST is delivered as inline XML content
@@ -4309,10 +4306,7 @@ export interface DAASTTrackerAsset {
      * The DAAST tracking event this URL fires on. MUST NOT be `impression` (model as `url` asset with `url_type: "tracker_pixel"`), `clickTracking` / `customClick` (click-tracking trackers go on their own URL asset), `error`, or any of the `ViewableImpression`-element children (`viewable`, `notViewable`, `viewUndetermined`, `measurableImpression`, `viewableImpression`).
      */
     daast_event: DAASTTrackingEvent;
-    /**
-     * Tracker URL that fires when `daast_event` occurs. May carry AdCP universal macros; the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * DAAST `offset` attribute. Required when `daast_event` is `progress` (DAAST 1.1 §3.2.4.3); ignored otherwise. Same format as VAST 4.2 `Tracking@offset`: `HH:MM:SS` or `HH:MM:SS.mmm` for absolute time (two-digit hours, minutes 00–59, seconds 00–59), or an integer percentage 0–100 suffixed with `%`. Negative offsets are NOT permitted.
      * @pattern ^(\d{2}:[0-5]\d:[0-5]\d(\.\d{3})?|(100|\d{1,2})%)$
@@ -6415,6 +6409,11 @@ export interface LegacyProductNamedFormatReference {
  */
 export type LiftDimension = 'awareness' | 'consideration' | 'favorability' | 'purchase_intent' | 'ad_recall';
 
+/**
+ * URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]`, `${MACRO}`, and `%%MACRO%%` placeholders are accepted as-is; buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
+ */
+export type MacroBearingURL = string;
+
 /**
  * Remedy types available when a performance standard or billing measurement threshold is breached.
  */
@@ -7305,10 +7304,7 @@ export interface PixelTrackerAsset {
      * Matches IAB OpenRTB Native 1.2 method enum (1=img, 2=js). `js` MUST only be used by sellers whose renderer supports JavaScript trackers; sellers without JS-tracker support MUST reject `method: js` declarations at sync_creatives time with `CREATIVE_REJECTED` carrying the reason.
      */
     method?: 'img' | 'js';
-    /**
-     * Tracker URL fired when `event` occurs. May carry AdCP universal macros (e.g., `{MEDIA_BUY_ID}`, `{CREATIVE_ID}`, `{CACHEBUSTER}`); the seller's renderer URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * REQUIRED when `event` is `custom`; otherwise MUST be absent. Adopter-defined event name. Sellers without registered handling for a given custom_event_name MUST silently no-op (do not fire) rather than reject — custom events are forward-compatible probes.
      */
@@ -10392,10 +10388,7 @@ export interface URLAsset {
      * Discriminator identifying this as a URL asset. See /schemas/creative/asset-types for the registry.
      */
     asset_type: 'url';
-    /**
-     * URL reference. May be a plain URI or an RFC 6570 URI template carrying AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`). Buyers MUST NOT pre-encode macro braces at sync time; the ad server URL-encodes substituted values at impression time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     url_type?: URLAssetType;
     /**
      * Description of what this URL points to
@@ -10658,10 +10651,7 @@ export type VASTAsset = {
      * Discriminator indicating VAST is delivered via URL endpoint
      */
     delivery_type: 'url';
-    /**
-     * URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]` and `${MACRO}` placeholders are accepted as-is (RFC 6570 syntax); buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
-     */
-    url: string;
+    url: MacroBearingURL;
 } | {
     /**
      * Discriminator indicating VAST is delivered as inline XML content
@@ -10685,10 +10675,7 @@ export interface VASTTrackerAsset {
      * The VAST tracking event this URL fires on. Maps 1:1 to the VAST `Tracking event="..."` attribute inside `TrackingEvents`. MUST NOT be `impression` (belongs in the VAST `Impression` element — model as a `url` asset with `url_type: "tracker_pixel"`), `clickTracking` / `customClick` (belong in `VideoClicks`), `error` (VAST `Error` element), or any of `viewable` / `notViewable` / `viewUndetermined` / `measurableImpression` / `viewableImpression` (children of the VAST `ViewableImpression` element, not `TrackingEvents`).
      */
     vast_event: VASTTrackingEvent;
-    /**
-     * Tracker URL that fires when `vast_event` occurs. May carry AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`); the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * VAST `offset` attribute. Required when `vast_event` is `progress`; ignored otherwise. Format matches the VAST 4.2 XSD `Tracking@offset` pattern: `HH:MM:SS` or `HH:MM:SS.mmm` for absolute time (two-digit hours, minutes 00–59, seconds 00–59), or an integer percentage 0–100 suffixed with `%`. Negative offsets are NOT permitted — the VAST 4.2 XSD pattern does not allow a leading minus.
      * @pattern ^(\d{2}:[0-5]\d:[0-5]\d(\.\d{3})?|(100|\d{1,2})%)$

package/dist/lib/types/list-creatives.d.ts

@@ -1140,10 +1140,7 @@ export type DAASTAsset = {
      * Discriminator indicating DAAST is delivered via URL endpoint
      */
     delivery_type: 'url';
-    /**
-     * URL endpoint that returns DAAST XML. May carry unsubstituted ad-server macros — DAAST/VAST-style `[MACRO]` and `${MACRO}` placeholders are accepted as-is (RFC 6570 syntax); buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
-     */
-    url: string;
+    url: MacroBearingURL;
 } | {
     /**
      * Discriminator indicating DAAST is delivered as inline XML content
@@ -1167,10 +1164,7 @@ export interface DAASTTrackerAsset {
      * The DAAST tracking event this URL fires on. MUST NOT be `impression` (model as `url` asset with `url_type: "tracker_pixel"`), `clickTracking` / `customClick` (click-tracking trackers go on their own URL asset), `error`, or any of the `ViewableImpression`-element children (`viewable`, `notViewable`, `viewUndetermined`, `measurableImpression`, `viewableImpression`).
      */
     daast_event: DAASTTrackingEvent;
-    /**
-     * Tracker URL that fires when `daast_event` occurs. May carry AdCP universal macros; the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * DAAST `offset` attribute. Required when `daast_event` is `progress` (DAAST 1.1 §3.2.4.3); ignored otherwise. Same format as VAST 4.2 `Tracking@offset`: `HH:MM:SS` or `HH:MM:SS.mmm` for absolute time (two-digit hours, minutes 00–59, seconds 00–59), or an integer percentage 0–100 suffixed with `%`. Negative offsets are NOT permitted.
      * @pattern ^(\d{2}:[0-5]\d:[0-5]\d(\.\d{3})?|(100|\d{1,2})%)$
@@ -1672,6 +1666,11 @@ export interface ListedCreativeCanonicalFormatKind {
     webhook_activity?: WebhookActivityRecord[];
 }
 
+/**
+ * URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]`, `${MACRO}`, and `%%MACRO%%` placeholders are accepted as-is; buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
+ */
+export type MacroBearingURL = string;
+
 /**
  * Markdown-formatted text content following CommonMark specification
  */
@@ -1901,10 +1900,7 @@ export interface PixelTrackerAsset {
      * Matches IAB OpenRTB Native 1.2 method enum (1=img, 2=js). `js` MUST only be used by sellers whose renderer supports JavaScript trackers; sellers without JS-tracker support MUST reject `method: js` declarations at sync_creatives time with `CREATIVE_REJECTED` carrying the reason.
      */
     method?: 'img' | 'js';
-    /**
-     * Tracker URL fired when `event` occurs. May carry AdCP universal macros (e.g., `{MEDIA_BUY_ID}`, `{CREATIVE_ID}`, `{CACHEBUSTER}`); the seller's renderer URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * REQUIRED when `event` is `custom`; otherwise MUST be absent. Adopter-defined event name. Sellers without registered handling for a given custom_event_name MUST silently no-op (do not fire) rather than reject — custom events are forward-compatible probes.
      */
@@ -2348,10 +2344,7 @@ export interface URLAsset {
      * Discriminator identifying this as a URL asset. See /schemas/creative/asset-types for the registry.
      */
     asset_type: 'url';
-    /**
-     * URL reference. May be a plain URI or an RFC 6570 URI template carrying AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`). Buyers MUST NOT pre-encode macro braces at sync time; the ad server URL-encodes substituted values at impression time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     url_type?: URLAssetType;
     /**
      * Description of what this URL points to
@@ -2411,10 +2404,7 @@ export type VASTAsset = {
      * Discriminator indicating VAST is delivered via URL endpoint
      */
     delivery_type: 'url';
-    /**
-     * URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]` and `${MACRO}` placeholders are accepted as-is (RFC 6570 syntax); buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
-     */
-    url: string;
+    url: MacroBearingURL;
 } | {
     /**
      * Discriminator indicating VAST is delivered as inline XML content
@@ -2438,10 +2428,7 @@ export interface VASTTrackerAsset {
      * The VAST tracking event this URL fires on. Maps 1:1 to the VAST `Tracking event="..."` attribute inside `TrackingEvents`. MUST NOT be `impression` (belongs in the VAST `Impression` element — model as a `url` asset with `url_type: "tracker_pixel"`), `clickTracking` / `customClick` (belong in `VideoClicks`), `error` (VAST `Error` element), or any of `viewable` / `notViewable` / `viewUndetermined` / `measurableImpression` / `viewableImpression` (children of the VAST `ViewableImpression` element, not `TrackingEvents`).
      */
     vast_event: VASTTrackingEvent;
-    /**
-     * Tracker URL that fires when `vast_event` occurs. May carry AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`); the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * VAST `offset` attribute. Required when `vast_event` is `progress`; ignored otherwise. Format matches the VAST 4.2 XSD `Tracking@offset` pattern: `HH:MM:SS` or `HH:MM:SS.mmm` for absolute time (two-digit hours, minutes 00–59, seconds 00–59), or an integer percentage 0–100 suffixed with `%`. Negative offsets are NOT permitted — the VAST 4.2 XSD pattern does not allow a leading minus.
      * @pattern ^(\d{2}:[0-5]\d:[0-5]\d(\.\d{3})?|(100|\d{1,2})%)$

package/dist/lib/types/manifest.generated.d.mts

@@ -1,5 +1,5 @@
 /**
- * Manifest-derived constants for AdCP 3.1.24.
+ * Manifest-derived constants for AdCP 3.1.30.
  *
  * Single source of truth for tool↔protocol grouping, error-code metadata
  * (description + recovery + suggestion), and specialism→required-tools
@@ -9,8 +9,8 @@
  * previously lived in `src/lib/utils/capabilities.ts` and
  * `src/lib/types/error-codes.ts`.
  *
- * Source: `schemas/cache/3.1.24/manifest.json` (adcp_version: 3.1.24, generated_at:
- * 2026-09-23T15:25:22.838Z). Re-run `npm run sync-schemas` then
+ * Source: `schemas/cache/3.1.30/manifest.json` (adcp_version: 3.1.30, generated_at:
+ * 2026-10-28T15:35:14.201Z). Re-run `npm run sync-schemas` then
  * `npm run generate-manifest-derived` to refresh after a spec bump.
  */
 export type ErrorRecovery = 'transient' | 'correctable' | 'terminal';

package/dist/lib/types/manifest.generated.d.ts

@@ -1,5 +1,5 @@
 /**
- * Manifest-derived constants for AdCP 3.1.24.
+ * Manifest-derived constants for AdCP 3.1.30.
  *
  * Single source of truth for tool↔protocol grouping, error-code metadata
  * (description + recovery + suggestion), and specialism→required-tools
@@ -9,8 +9,8 @@
  * previously lived in `src/lib/utils/capabilities.ts` and
  * `src/lib/types/error-codes.ts`.
  *
- * Source: `schemas/cache/3.1.24/manifest.json` (adcp_version: 3.1.24, generated_at:
- * 2026-09-23T15:25:22.838Z). Re-run `npm run sync-schemas` then
+ * Source: `schemas/cache/3.1.30/manifest.json` (adcp_version: 3.1.30, generated_at:
+ * 2026-10-28T15:35:14.201Z). Re-run `npm run sync-schemas` then
  * `npm run generate-manifest-derived` to refresh after a spec bump.
  */
 export type ErrorRecovery = 'transient' | 'correctable' | 'terminal';