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

package/dist/lib/testing/storyboard/compliance.d.ts

@@ -181,12 +181,9 @@ export declare function getExternalSchemaRootForCompliance(options: ResolveOptio
 export declare function loadBundleStoryboards(ref: BundleRef): Storyboard[];
 /** Enumerate every bundle present in the cache (universal + protocols + specialisms). */
 export declare function listBundles(options?: ResolveOptions): BundleRef[];
-/** List every storyboard the cache can produce, across all bundles. */
+/** List every storyboard the selected immutable bundle can produce, as detached records. */
 export declare function listAllComplianceStoryboards(options?: ResolveOptions): Storyboard[];
-/**
- * Find a storyboard by its internal `id` (the YAML's `id:` field).
- * Scans every bundle in the cache. Returns undefined if no match.
- */
+/** Find a storyboard by its internal YAML id without reparsing a warm bundle. */
 export declare function getComplianceStoryboardById(id: string, options?: ResolveOptions): Storyboard | undefined;
 /** Find a bundle by its directory/file id (`media-buy`, `sales-guaranteed`, `capability-discovery`). */
 export declare function findBundleById(id: string, options?: ResolveOptions): BundleRef | undefined;

package/dist/lib/testing/storyboard/compliance.js

@@ -47,6 +47,7 @@ var import_errors = require('../../errors/index.js');
 var import_adcp_version_config = require('../../utils/adcp-version-config.js');
 var import_schema_loader = require('../../validation/schema-loader.js');
 var import_synthesize = require('./request-signing/synthesize.js');
+var import_vector_loader = require('./request-signing/vector-loader.js');
 var import_provenance = require('./provenance.js');
 class CapabilityResolutionError extends import_errors.ADCPError {
   code;
@@ -434,23 +435,71 @@ function listBundles(options = {}) {
   }
   return bundles;
 }
-function listAllComplianceStoryboards(options = {}) {
-  const seen = /* @__PURE__ */ new Set();
-  const storyboards = [];
-  for (const ref of listBundles(options)) {
-    for (const sb of loadBundleStoryboards(ref)) {
-      if (seen.has(sb.id)) continue;
-      seen.add(sb.id);
-      storyboards.push(sb);
+const STORYBOARD_INDEX_CACHE_LIMIT = 8;
+const storyboardIndexes = /* @__PURE__ */ new Map();
+function customComplianceInventory(dir) {
+  if (!(0, import_fs.existsSync)(dir)) return "missing";
+  const entries = [];
+  const visitedDirectories = /* @__PURE__ */ new Set();
+  const visit = (file, relative) => {
+    const stat = (0, import_fs.statSync)(file, { bigint: true });
+    entries.push([relative, String(stat.mtimeNs), String(stat.ctimeNs), String(stat.size), String(stat.ino)]);
+    if (!stat.isDirectory()) return;
+    const identity = `${stat.dev}:${stat.ino}`;
+    if (visitedDirectories.has(identity)) return;
+    visitedDirectories.add(identity);
+    for (const child of (0, import_fs.readdirSync)(file).sort()) visit((0, import_path.join)(file, child), `${relative}/${child}`);
+  };
+  visit(dir, "");
+  return JSON.stringify(entries);
+}
+function complianceStoryboardIndex(options) {
+  const dir = (0, import_path.resolve)(getComplianceCacheDir(options));
+  const indexPath = (0, import_path.join)(dir, "index.json");
+  const stamp = (0, import_fs.existsSync)(indexPath) ? (0, import_fs.statSync)(indexPath) : void 0;
+  const schemaRoot = getConfiguredSchemaRoot(options);
+  const customRoot = Boolean(getConfiguredComplianceDir(options));
+  const inventory = customRoot ? customComplianceInventory(dir) : null;
+  const key = JSON.stringify([
+    dir,
+    options.version ?? import_version.ADCP_VERSION,
+    schemaRoot ? (0, import_path.resolve)(schemaRoot) : null,
+    options.hostedStableLineAlias ?? null,
+    stamp?.mtimeMs ?? null,
+    stamp?.size ?? null,
+    inventory
+  ]);
+  const cached = storyboardIndexes.get(key);
+  if (cached) {
+    storyboardIndexes.delete(key);
+    storyboardIndexes.set(key, cached);
+    return cached;
+  }
+  if (customRoot) (0, import_vector_loader.invalidateRequestSigningVectorCache)(dir);
+  const indexed = /* @__PURE__ */ new Map();
+  for (const ref of listBundles({ ...options, complianceDir: dir })) {
+    for (const storyboard of loadBundleStoryboards(ref)) {
+      if (!indexed.has(storyboard.id)) indexed.set(storyboard.id, storyboard);
     }
   }
-  return storyboards;
+  storyboardIndexes.set(key, indexed);
+  while (storyboardIndexes.size > STORYBOARD_INDEX_CACHE_LIMIT) {
+    const oldest = storyboardIndexes.keys().next().value;
+    if (oldest !== void 0) storyboardIndexes.delete(oldest);
+  }
+  return indexed;
+}
+function cloneComplianceStoryboard(storyboard) {
+  const copy = structuredClone(storyboard);
+  const trustedRoot = (0, import_provenance.trustedStoryboardComplianceRoot)(storyboard);
+  return trustedRoot ? (0, import_provenance.markStoryboardComplianceRoot)(copy, trustedRoot) : copy;
+}
+function listAllComplianceStoryboards(options = {}) {
+  return [...complianceStoryboardIndex(options).values()].map(cloneComplianceStoryboard);
 }
 function getComplianceStoryboardById(id, options = {}) {
-  for (const sb of listAllComplianceStoryboards(options)) {
-    if (sb.id === id) return sb;
-  }
-  return void 0;
+  const storyboard = complianceStoryboardIndex(options).get(id);
+  return storyboard ? cloneComplianceStoryboard(storyboard) : void 0;
 }
 function findBundleById(id, options = {}) {
   return listBundles(options).find((b) => b.id === id);

package/dist/lib/testing/storyboard/compliance.mjs

@@ -12,7 +12,8 @@ import { ADCPError } from "../../errors/index.mjs";
 import { isAdcpVersionSupported } from "../../utils/adcp-version-config.mjs";
 import { hasSchemaBundle, resolveBundleKey } from "../../validation/schema-loader.mjs";
 import { synthesizeRequestSigningSteps } from "./request-signing/synthesize.mjs";
-import { markStoryboardComplianceRoot } from "./provenance.mjs";
+import { invalidateRequestSigningVectorCache } from "./request-signing/vector-loader.mjs";
+import { markStoryboardComplianceRoot, trustedStoryboardComplianceRoot } from "./provenance.mjs";
 class CapabilityResolutionError extends ADCPError {
   code;
   specialism;
@@ -399,23 +400,71 @@ function listBundles(options = {}) {
   }
   return bundles;
 }
-function listAllComplianceStoryboards(options = {}) {
-  const seen = /* @__PURE__ */ new Set();
-  const storyboards = [];
-  for (const ref of listBundles(options)) {
-    for (const sb of loadBundleStoryboards(ref)) {
-      if (seen.has(sb.id)) continue;
-      seen.add(sb.id);
-      storyboards.push(sb);
+const STORYBOARD_INDEX_CACHE_LIMIT = 8;
+const storyboardIndexes = /* @__PURE__ */ new Map();
+function customComplianceInventory(dir) {
+  if (!existsSync(dir)) return "missing";
+  const entries = [];
+  const visitedDirectories = /* @__PURE__ */ new Set();
+  const visit = (file, relative) => {
+    const stat = statSync(file, { bigint: true });
+    entries.push([relative, String(stat.mtimeNs), String(stat.ctimeNs), String(stat.size), String(stat.ino)]);
+    if (!stat.isDirectory()) return;
+    const identity = `${stat.dev}:${stat.ino}`;
+    if (visitedDirectories.has(identity)) return;
+    visitedDirectories.add(identity);
+    for (const child of readdirSync(file).sort()) visit(join(file, child), `${relative}/${child}`);
+  };
+  visit(dir, "");
+  return JSON.stringify(entries);
+}
+function complianceStoryboardIndex(options) {
+  const dir = resolve(getComplianceCacheDir(options));
+  const indexPath = join(dir, "index.json");
+  const stamp = existsSync(indexPath) ? statSync(indexPath) : void 0;
+  const schemaRoot = getConfiguredSchemaRoot(options);
+  const customRoot = Boolean(getConfiguredComplianceDir(options));
+  const inventory = customRoot ? customComplianceInventory(dir) : null;
+  const key = JSON.stringify([
+    dir,
+    options.version ?? ADCP_VERSION,
+    schemaRoot ? resolve(schemaRoot) : null,
+    options.hostedStableLineAlias ?? null,
+    stamp?.mtimeMs ?? null,
+    stamp?.size ?? null,
+    inventory
+  ]);
+  const cached = storyboardIndexes.get(key);
+  if (cached) {
+    storyboardIndexes.delete(key);
+    storyboardIndexes.set(key, cached);
+    return cached;
+  }
+  if (customRoot) invalidateRequestSigningVectorCache(dir);
+  const indexed = /* @__PURE__ */ new Map();
+  for (const ref of listBundles({ ...options, complianceDir: dir })) {
+    for (const storyboard of loadBundleStoryboards(ref)) {
+      if (!indexed.has(storyboard.id)) indexed.set(storyboard.id, storyboard);
     }
   }
-  return storyboards;
+  storyboardIndexes.set(key, indexed);
+  while (storyboardIndexes.size > STORYBOARD_INDEX_CACHE_LIMIT) {
+    const oldest = storyboardIndexes.keys().next().value;
+    if (oldest !== void 0) storyboardIndexes.delete(oldest);
+  }
+  return indexed;
+}
+function cloneComplianceStoryboard(storyboard) {
+  const copy = structuredClone(storyboard);
+  const trustedRoot = trustedStoryboardComplianceRoot(storyboard);
+  return trustedRoot ? markStoryboardComplianceRoot(copy, trustedRoot) : copy;
+}
+function listAllComplianceStoryboards(options = {}) {
+  return [...complianceStoryboardIndex(options).values()].map(cloneComplianceStoryboard);
 }
 function getComplianceStoryboardById(id, options = {}) {
-  for (const sb of listAllComplianceStoryboards(options)) {
-    if (sb.id === id) return sb;
-  }
-  return void 0;
+  const storyboard = complianceStoryboardIndex(options).get(id);
+  return storyboard ? cloneComplianceStoryboard(storyboard) : void 0;
 }
 function findBundleById(id, options = {}) {
   return listBundles(options).find((b) => b.id === id);

package/dist/lib/testing/storyboard/request-signing/vector-loader.d.mts

@@ -34,6 +34,8 @@ export declare function signingProfileForAdcpVersion(version?: string): '3.2' |
 export declare function loadRequestSigningVectors(options?: LoadVectorsOptions): LoadedVectors;
 /** Load only the shared signing keyset, without requiring the grader vectors. */
 export declare function loadRequestSigningKeys(options?: LoadVectorsOptions): TestKeyset;
+/** Refresh only the signing fixtures belonging to a changed custom compliance root. */
+export declare function invalidateRequestSigningVectorCache(complianceDir: string): void;
 /** Test-only: clear the memoization cache so a fresh cache path is reread. */
 export declare function __resetVectorCache(): void;
 /** Where the A2A operation-resolution vectors came from. */

package/dist/lib/testing/storyboard/request-signing/vector-loader.d.ts

@@ -34,6 +34,8 @@ export declare function signingProfileForAdcpVersion(version?: string): '3.2' |
 export declare function loadRequestSigningVectors(options?: LoadVectorsOptions): LoadedVectors;
 /** Load only the shared signing keyset, without requiring the grader vectors. */
 export declare function loadRequestSigningKeys(options?: LoadVectorsOptions): TestKeyset;
+/** Refresh only the signing fixtures belonging to a changed custom compliance root. */
+export declare function invalidateRequestSigningVectorCache(complianceDir: string): void;
 /** Test-only: clear the memoization cache so a fresh cache path is reread. */
 export declare function __resetVectorCache(): void;
 /** Where the A2A operation-resolution vectors came from. */

package/dist/lib/testing/storyboard/request-signing/vector-loader.js

@@ -22,6 +22,7 @@ __export(vector_loader_exports, {
   A2A_VECTORS_UNAVAILABLE_MESSAGE: () => A2A_VECTORS_UNAVAILABLE_MESSAGE,
   __resetVectorCache: () => __resetVectorCache,
   findKey: () => findKey,
+  invalidateRequestSigningVectorCache: () => invalidateRequestSigningVectorCache,
   loadA2aOperationResolutionVectors: () => loadA2aOperationResolutionVectors,
   loadRequestSigningKeys: () => loadRequestSigningKeys,
   loadRequestSigningVectors: () => loadRequestSigningVectors,
@@ -95,6 +96,15 @@ function loadRequestSigningKeys(options = {}) {
   const cacheDir = (0, import_compliance.getComplianceCacheDir)(options);
   return loadKeys((0, import_path.join)(cacheDir, "test-vectors", "request-signing", "keys.json"));
 }
+function invalidateRequestSigningVectorCache(complianceDir) {
+  const sourceDir = (0, import_path.resolve)(complianceDir, "test-vectors", "request-signing");
+  for (const key of VECTOR_CACHE.keys()) {
+    if ((0, import_path.resolve)(key) === sourceDir) VECTOR_CACHE.delete(key);
+  }
+  for (const key of A2A_VECTOR_CACHE.keys()) {
+    if ((0, import_path.resolve)(key) === (0, import_path.join)(sourceDir, "a2a")) A2A_VECTOR_CACHE.delete(key);
+  }
+}
 function __resetVectorCache() {
   VECTOR_CACHE.clear();
   A2A_VECTOR_CACHE.clear();
@@ -384,6 +394,7 @@ function strArray(v, where) {
   A2A_VECTORS_UNAVAILABLE_MESSAGE,
   __resetVectorCache,
   findKey,
+  invalidateRequestSigningVectorCache,
   loadA2aOperationResolutionVectors,
   loadRequestSigningKeys,
   loadRequestSigningVectors,

package/dist/lib/testing/storyboard/request-signing/vector-loader.mjs

@@ -69,6 +69,15 @@ function loadRequestSigningKeys(options = {}) {
   const cacheDir = getComplianceCacheDir(options);
   return loadKeys(join(cacheDir, "test-vectors", "request-signing", "keys.json"));
 }
+function invalidateRequestSigningVectorCache(complianceDir) {
+  const sourceDir = resolve(complianceDir, "test-vectors", "request-signing");
+  for (const key of VECTOR_CACHE.keys()) {
+    if (resolve(key) === sourceDir) VECTOR_CACHE.delete(key);
+  }
+  for (const key of A2A_VECTOR_CACHE.keys()) {
+    if (resolve(key) === join(sourceDir, "a2a")) A2A_VECTOR_CACHE.delete(key);
+  }
+}
 function __resetVectorCache() {
   VECTOR_CACHE.clear();
   A2A_VECTOR_CACHE.clear();
@@ -357,6 +366,7 @@ export {
   A2A_VECTORS_UNAVAILABLE_MESSAGE,
   __resetVectorCache,
   findKey,
+  invalidateRequestSigningVectorCache,
   loadA2aOperationResolutionVectors,
   loadRequestSigningKeys,
   loadRequestSigningVectors,

package/dist/lib/testing/storyboard/validations.d.mts

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.1";
+export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.2";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/testing/storyboard/validations.d.ts

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.1";
+export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.2";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/types/accept-proposal.d.ts

@@ -1101,26 +1101,22 @@ export type DayOfWeek = 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'frida
 export type DaypartTarget = {
     /**
      * Days of week this window applies to. Use multiple days for compact targeting (e.g., monday-friday in one object). For an overnight start_time/end_time window, each day names the day the window starts on.
-     *
-     * @minItems 1
      */
-    days: [DayOfWeek, ...DayOfWeek[]];
+    days: DayOfWeek[];
     /**
      * Start hour (inclusive), 0-23 in 24-hour format. 0 = midnight, 6 = 6:00am, 18 = 6:00pm. Whole-hour form: pair with end_hour; mutually exclusive with start_time and end_time.
+     * @minimum 0
+     * @maximum 23
+     * @format int
      */
-    start_hour?: number;
+    start_hour: number;
     /**
      * End hour (exclusive), 1-24 in 24-hour format. 10 = 10:00am, 24 = midnight. Must be greater than start_hour; whole-hour windows never cross midnight. Whole-hour form: pair with start_hour; mutually exclusive with start_time and end_time.
+     * @minimum 1
+     * @maximum 24
+     * @format int
      */
-    end_hour?: number;
-    /**
-     * Experimental in AdCP 3.3. Start of the window (inclusive) as a 24-hour HH:MM civil clock time on the entry's timezone clock, such as '19:30'. Use for windows that do not fall on whole hours (linear TV programme junctions, quarter-hour schedules). Pair with end_time; mutually exclusive with start_hour and end_hour. A window whose end_time is earlier than its start_time crosses midnight and belongs to the day it starts on. A product accepts only the finest time granularity it declares in overlay_support.daypart_targets.time_granularity; sellers MUST reject, never round, a clock time the product does not honor.
-     */
-    start_time?: string;
-    /**
-     * Experimental in AdCP 3.3. End of the window (exclusive) as a 24-hour HH:MM civil clock time, such as '23:00'. Pair with start_time; mutually exclusive with start_hour and end_hour. end_time earlier than start_time means the window crosses midnight and ends at end_time on the following civil day (for example, 22:00 to 02:00 runs from 22:00 on a listed day until 02:00 the next morning); '00:00' therefore ends the window at the midnight closing the start day. end_time MUST NOT equal start_time: a zero-length or full-day window is invalid, and a full day uses start_hour 0 with end_hour 24. Sellers MUST reject an equal pair with INVALID_REQUEST.
-     */
-    end_time?: string;
+    end_hour: number;
     /**
      * Civil-time clock used to evaluate this window. 'inventory_local' evaluates the hours in the seller-assigned local timezone of each inventory unit that can deliver the impression, such as a screen, venue, station, or publisher property; it never means the buyer, account, or server timezone. A concrete IANA timezone identifier (for example, 'America/New_York', 'CET', or 'UTC') evaluates one shared civil-time clock across the targeted inventory. Omission defaults to 'inventory_local'. Buyers that begin with a user or account preference MUST resolve it to a concrete IANA identifier before sending the daypart; 'user_timezone' and 'account_timezone' are not wire values. For each candidate delivery instant, convert the instant into this clock and compare its resulting local day and time of day with the half-open window: a skipped DST hour or interval has no matching instants, while both occurrences of a repeated hour or interval match. For an overnight start_time/end_time window, an instant matches when its local day is a listed day and its local time is at or after start_time, or when the local day before it is a listed day and its local time is before end_time. This delivery clock is independent of reporting_capabilities.timezone.
      */
@@ -1129,29 +1125,23 @@ export type DaypartTarget = {
      * Optional human-readable name for this time window (e.g., 'Morning Drive', 'Prime Time')
      */
     label?: string;
-} & ({} | {}) & {
+    start_time?: never;
+    end_time?: never;
+} | {
     /**
      * Days of week this window applies to. Use multiple days for compact targeting (e.g., monday-friday in one object). For an overnight start_time/end_time window, each day names the day the window starts on.
-     *
-     * @minItems 1
-     */
-    days: [DayOfWeek, ...DayOfWeek[]];
-    /**
-     * Start hour (inclusive), 0-23 in 24-hour format. 0 = midnight, 6 = 6:00am, 18 = 6:00pm. Whole-hour form: pair with end_hour; mutually exclusive with start_time and end_time.
-     */
-    start_hour?: number;
-    /**
-     * End hour (exclusive), 1-24 in 24-hour format. 10 = 10:00am, 24 = midnight. Must be greater than start_hour; whole-hour windows never cross midnight. Whole-hour form: pair with start_hour; mutually exclusive with start_time and end_time.
      */
-    end_hour?: number;
+    days: DayOfWeek[];
     /**
      * Experimental in AdCP 3.3. Start of the window (inclusive) as a 24-hour HH:MM civil clock time on the entry's timezone clock, such as '19:30'. Use for windows that do not fall on whole hours (linear TV programme junctions, quarter-hour schedules). Pair with end_time; mutually exclusive with start_hour and end_hour. A window whose end_time is earlier than its start_time crosses midnight and belongs to the day it starts on. A product accepts only the finest time granularity it declares in overlay_support.daypart_targets.time_granularity; sellers MUST reject, never round, a clock time the product does not honor.
+     * @pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$
      */
-    start_time?: string;
+    start_time: string;
     /**
      * Experimental in AdCP 3.3. End of the window (exclusive) as a 24-hour HH:MM civil clock time, such as '23:00'. Pair with start_time; mutually exclusive with start_hour and end_hour. end_time earlier than start_time means the window crosses midnight and ends at end_time on the following civil day (for example, 22:00 to 02:00 runs from 22:00 on a listed day until 02:00 the next morning); '00:00' therefore ends the window at the midnight closing the start day. end_time MUST NOT equal start_time: a zero-length or full-day window is invalid, and a full day uses start_hour 0 with end_hour 24. Sellers MUST reject an equal pair with INVALID_REQUEST.
+     * @pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$
      */
-    end_time?: string;
+    end_time: string;
     /**
      * Civil-time clock used to evaluate this window. 'inventory_local' evaluates the hours in the seller-assigned local timezone of each inventory unit that can deliver the impression, such as a screen, venue, station, or publisher property; it never means the buyer, account, or server timezone. A concrete IANA timezone identifier (for example, 'America/New_York', 'CET', or 'UTC') evaluates one shared civil-time clock across the targeted inventory. Omission defaults to 'inventory_local'. Buyers that begin with a user or account preference MUST resolve it to a concrete IANA identifier before sending the daypart; 'user_timezone' and 'account_timezone' are not wire values. For each candidate delivery instant, convert the instant into this clock and compare its resulting local day and time of day with the half-open window: a skipped DST hour or interval has no matching instants, while both occurrences of a repeated hour or interval match. For an overnight start_time/end_time window, an instant matches when its local day is a listed day and its local time is at or after start_time, or when the local day before it is a listed day and its local time is before end_time. This delivery clock is independent of reporting_capabilities.timezone.
      */
@@ -1160,7 +1150,9 @@ export type DaypartTarget = {
      * Optional human-readable name for this time window (e.g., 'Morning Drive', 'Prime Time')
      */
     label?: string;
-} & ({} | {});
+    start_hour?: never;
+    end_hour?: never;
+};
 
 /**
  * Seller-authored integrity pin over one third-party-published definition that a proposal's commercial_terms reference: a publisher-catalog format option, publisher-catalog placement, adagents.json collection, or data-provider signal. content_digest is the lowercase-hex SHA-256 of the RFC 8785 (JCS) serialization of the kind's closed projection of the published entry, defined normatively in docs/media-buy/specification.mdx#definition-pins. Pins live inside commercial_terms, so terms_digest covers the pin but not the definition it names: a published definition can change while terms_digest still verifies, and re-verifying the pin is what detects it. Request inputs never carry pins.

package/dist/lib/types/asset-instances.d.mts

@@ -31,4 +31,4 @@ export type AssetInstance = AssetVariant;
  * switch-case helpers.
  */
 export type AssetInstanceType = AssetInstance['asset_type'];
-export type { ImageAsset, VideoAsset, AudioAsset, TextAsset, HTMLAsset, URLAsset, CSSAsset, JavaScriptAsset, MarkdownAsset, VASTAsset, DAASTAsset, BriefAsset, VideoBriefAsset, CatalogAsset, WebhookAsset, ZipAsset, PublishedPostAsset, CardAsset, PixelTrackerAsset, VASTTrackerAsset, DAASTTrackerAsset, DisplayTagAsset, };
+export type { AssetVariant, ImageAsset, VideoAsset, AudioAsset, TextAsset, HTMLAsset, URLAsset, CSSAsset, JavaScriptAsset, MarkdownAsset, VASTAsset, DAASTAsset, BriefAsset, VideoBriefAsset, CatalogAsset, WebhookAsset, ZipAsset, PublishedPostAsset, CardAsset, PixelTrackerAsset, VASTTrackerAsset, DAASTTrackerAsset, DisplayTagAsset, };

package/dist/lib/types/asset-instances.d.ts

@@ -31,4 +31,4 @@ export type AssetInstance = AssetVariant;
  * switch-case helpers.
  */
 export type AssetInstanceType = AssetInstance['asset_type'];
-export type { ImageAsset, VideoAsset, AudioAsset, TextAsset, HTMLAsset, URLAsset, CSSAsset, JavaScriptAsset, MarkdownAsset, VASTAsset, DAASTAsset, BriefAsset, VideoBriefAsset, CatalogAsset, WebhookAsset, ZipAsset, PublishedPostAsset, CardAsset, PixelTrackerAsset, VASTTrackerAsset, DAASTTrackerAsset, DisplayTagAsset, };
+export type { AssetVariant, ImageAsset, VideoAsset, AudioAsset, TextAsset, HTMLAsset, URLAsset, CSSAsset, JavaScriptAsset, MarkdownAsset, VASTAsset, DAASTAsset, BriefAsset, VideoBriefAsset, CatalogAsset, WebhookAsset, ZipAsset, PublishedPostAsset, CardAsset, PixelTrackerAsset, VASTTrackerAsset, DAASTTrackerAsset, DisplayTagAsset, };

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

@@ -1177,26 +1177,22 @@ export type DayOfWeek = 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'frida
 export type DaypartTarget = {
     /**
      * Days of week this window applies to. Use multiple days for compact targeting (e.g., monday-friday in one object). For an overnight start_time/end_time window, each day names the day the window starts on.
-     *
-     * @minItems 1
      */
-    days: [DayOfWeek, ...DayOfWeek[]];
+    days: DayOfWeek[];
     /**
      * Start hour (inclusive), 0-23 in 24-hour format. 0 = midnight, 6 = 6:00am, 18 = 6:00pm. Whole-hour form: pair with end_hour; mutually exclusive with start_time and end_time.
+     * @minimum 0
+     * @maximum 23
+     * @format int
      */
-    start_hour?: number;
+    start_hour: number;
     /**
      * End hour (exclusive), 1-24 in 24-hour format. 10 = 10:00am, 24 = midnight. Must be greater than start_hour; whole-hour windows never cross midnight. Whole-hour form: pair with start_hour; mutually exclusive with start_time and end_time.
+     * @minimum 1
+     * @maximum 24
+     * @format int
      */
-    end_hour?: number;
-    /**
-     * Experimental in AdCP 3.3. Start of the window (inclusive) as a 24-hour HH:MM civil clock time on the entry's timezone clock, such as '19:30'. Use for windows that do not fall on whole hours (linear TV programme junctions, quarter-hour schedules). Pair with end_time; mutually exclusive with start_hour and end_hour. A window whose end_time is earlier than its start_time crosses midnight and belongs to the day it starts on. A product accepts only the finest time granularity it declares in overlay_support.daypart_targets.time_granularity; sellers MUST reject, never round, a clock time the product does not honor.
-     */
-    start_time?: string;
-    /**
-     * Experimental in AdCP 3.3. End of the window (exclusive) as a 24-hour HH:MM civil clock time, such as '23:00'. Pair with start_time; mutually exclusive with start_hour and end_hour. end_time earlier than start_time means the window crosses midnight and ends at end_time on the following civil day (for example, 22:00 to 02:00 runs from 22:00 on a listed day until 02:00 the next morning); '00:00' therefore ends the window at the midnight closing the start day. end_time MUST NOT equal start_time: a zero-length or full-day window is invalid, and a full day uses start_hour 0 with end_hour 24. Sellers MUST reject an equal pair with INVALID_REQUEST.
-     */
-    end_time?: string;
+    end_hour: number;
     /**
      * Civil-time clock used to evaluate this window. 'inventory_local' evaluates the hours in the seller-assigned local timezone of each inventory unit that can deliver the impression, such as a screen, venue, station, or publisher property; it never means the buyer, account, or server timezone. A concrete IANA timezone identifier (for example, 'America/New_York', 'CET', or 'UTC') evaluates one shared civil-time clock across the targeted inventory. Omission defaults to 'inventory_local'. Buyers that begin with a user or account preference MUST resolve it to a concrete IANA identifier before sending the daypart; 'user_timezone' and 'account_timezone' are not wire values. For each candidate delivery instant, convert the instant into this clock and compare its resulting local day and time of day with the half-open window: a skipped DST hour or interval has no matching instants, while both occurrences of a repeated hour or interval match. For an overnight start_time/end_time window, an instant matches when its local day is a listed day and its local time is at or after start_time, or when the local day before it is a listed day and its local time is before end_time. This delivery clock is independent of reporting_capabilities.timezone.
      */
@@ -1205,29 +1201,23 @@ export type DaypartTarget = {
      * Optional human-readable name for this time window (e.g., 'Morning Drive', 'Prime Time')
      */
     label?: string;
-} & ({} | {}) & {
+    start_time?: never;
+    end_time?: never;
+} | {
     /**
      * Days of week this window applies to. Use multiple days for compact targeting (e.g., monday-friday in one object). For an overnight start_time/end_time window, each day names the day the window starts on.
-     *
-     * @minItems 1
-     */
-    days: [DayOfWeek, ...DayOfWeek[]];
-    /**
-     * Start hour (inclusive), 0-23 in 24-hour format. 0 = midnight, 6 = 6:00am, 18 = 6:00pm. Whole-hour form: pair with end_hour; mutually exclusive with start_time and end_time.
-     */
-    start_hour?: number;
-    /**
-     * End hour (exclusive), 1-24 in 24-hour format. 10 = 10:00am, 24 = midnight. Must be greater than start_hour; whole-hour windows never cross midnight. Whole-hour form: pair with start_hour; mutually exclusive with start_time and end_time.
      */
-    end_hour?: number;
+    days: DayOfWeek[];
     /**
      * Experimental in AdCP 3.3. Start of the window (inclusive) as a 24-hour HH:MM civil clock time on the entry's timezone clock, such as '19:30'. Use for windows that do not fall on whole hours (linear TV programme junctions, quarter-hour schedules). Pair with end_time; mutually exclusive with start_hour and end_hour. A window whose end_time is earlier than its start_time crosses midnight and belongs to the day it starts on. A product accepts only the finest time granularity it declares in overlay_support.daypart_targets.time_granularity; sellers MUST reject, never round, a clock time the product does not honor.
+     * @pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$
      */
-    start_time?: string;
+    start_time: string;
     /**
      * Experimental in AdCP 3.3. End of the window (exclusive) as a 24-hour HH:MM civil clock time, such as '23:00'. Pair with start_time; mutually exclusive with start_hour and end_hour. end_time earlier than start_time means the window crosses midnight and ends at end_time on the following civil day (for example, 22:00 to 02:00 runs from 22:00 on a listed day until 02:00 the next morning); '00:00' therefore ends the window at the midnight closing the start day. end_time MUST NOT equal start_time: a zero-length or full-day window is invalid, and a full day uses start_hour 0 with end_hour 24. Sellers MUST reject an equal pair with INVALID_REQUEST.
+     * @pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$
      */
-    end_time?: string;
+    end_time: string;
     /**
      * Civil-time clock used to evaluate this window. 'inventory_local' evaluates the hours in the seller-assigned local timezone of each inventory unit that can deliver the impression, such as a screen, venue, station, or publisher property; it never means the buyer, account, or server timezone. A concrete IANA timezone identifier (for example, 'America/New_York', 'CET', or 'UTC') evaluates one shared civil-time clock across the targeted inventory. Omission defaults to 'inventory_local'. Buyers that begin with a user or account preference MUST resolve it to a concrete IANA identifier before sending the daypart; 'user_timezone' and 'account_timezone' are not wire values. For each candidate delivery instant, convert the instant into this clock and compare its resulting local day and time of day with the half-open window: a skipped DST hour or interval has no matching instants, while both occurrences of a repeated hour or interval match. For an overnight start_time/end_time window, an instant matches when its local day is a listed day and its local time is at or after start_time, or when the local day before it is a listed day and its local time is before end_time. This delivery clock is independent of reporting_capabilities.timezone.
      */
@@ -1236,7 +1226,9 @@ export type DaypartTarget = {
      * Optional human-readable name for this time window (e.g., 'Morning Drive', 'Prime Time')
      */
     label?: string;
-} & ({} | {});
+    start_hour?: never;
+    end_hour?: never;
+};
 
 /**
  * Restrict delivery to specific time windows. Each entry specifies days of week, an hour range, and an optional timezone that defaults to inventory_local. A concrete IANA zone uses one shared civil-time clock, while inventory_local evaluates each inventory unit in its seller-assigned local timezone. Entries are independent and MAY use different clocks.

package/dist/lib/types/check-governance.d.ts

@@ -1608,26 +1608,22 @@ export type DayOfWeek = 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'frida
 export type DaypartTarget = {
     /**
      * Days of week this window applies to. Use multiple days for compact targeting (e.g., monday-friday in one object). For an overnight start_time/end_time window, each day names the day the window starts on.
-     *
-     * @minItems 1
      */
-    days: [DayOfWeek, ...DayOfWeek[]];
+    days: DayOfWeek[];
     /**
      * Start hour (inclusive), 0-23 in 24-hour format. 0 = midnight, 6 = 6:00am, 18 = 6:00pm. Whole-hour form: pair with end_hour; mutually exclusive with start_time and end_time.
+     * @minimum 0
+     * @maximum 23
+     * @format int
      */
-    start_hour?: number;
+    start_hour: number;
     /**
      * End hour (exclusive), 1-24 in 24-hour format. 10 = 10:00am, 24 = midnight. Must be greater than start_hour; whole-hour windows never cross midnight. Whole-hour form: pair with start_hour; mutually exclusive with start_time and end_time.
+     * @minimum 1
+     * @maximum 24
+     * @format int
      */
-    end_hour?: number;
-    /**
-     * Experimental in AdCP 3.3. Start of the window (inclusive) as a 24-hour HH:MM civil clock time on the entry's timezone clock, such as '19:30'. Use for windows that do not fall on whole hours (linear TV programme junctions, quarter-hour schedules). Pair with end_time; mutually exclusive with start_hour and end_hour. A window whose end_time is earlier than its start_time crosses midnight and belongs to the day it starts on. A product accepts only the finest time granularity it declares in overlay_support.daypart_targets.time_granularity; sellers MUST reject, never round, a clock time the product does not honor.
-     */
-    start_time?: string;
-    /**
-     * Experimental in AdCP 3.3. End of the window (exclusive) as a 24-hour HH:MM civil clock time, such as '23:00'. Pair with start_time; mutually exclusive with start_hour and end_hour. end_time earlier than start_time means the window crosses midnight and ends at end_time on the following civil day (for example, 22:00 to 02:00 runs from 22:00 on a listed day until 02:00 the next morning); '00:00' therefore ends the window at the midnight closing the start day. end_time MUST NOT equal start_time: a zero-length or full-day window is invalid, and a full day uses start_hour 0 with end_hour 24. Sellers MUST reject an equal pair with INVALID_REQUEST.
-     */
-    end_time?: string;
+    end_hour: number;
     /**
      * Civil-time clock used to evaluate this window. 'inventory_local' evaluates the hours in the seller-assigned local timezone of each inventory unit that can deliver the impression, such as a screen, venue, station, or publisher property; it never means the buyer, account, or server timezone. A concrete IANA timezone identifier (for example, 'America/New_York', 'CET', or 'UTC') evaluates one shared civil-time clock across the targeted inventory. Omission defaults to 'inventory_local'. Buyers that begin with a user or account preference MUST resolve it to a concrete IANA identifier before sending the daypart; 'user_timezone' and 'account_timezone' are not wire values. For each candidate delivery instant, convert the instant into this clock and compare its resulting local day and time of day with the half-open window: a skipped DST hour or interval has no matching instants, while both occurrences of a repeated hour or interval match. For an overnight start_time/end_time window, an instant matches when its local day is a listed day and its local time is at or after start_time, or when the local day before it is a listed day and its local time is before end_time. This delivery clock is independent of reporting_capabilities.timezone.
      */
@@ -1636,29 +1632,23 @@ export type DaypartTarget = {
      * Optional human-readable name for this time window (e.g., 'Morning Drive', 'Prime Time')
      */
     label?: string;
-} & ({} | {}) & {
+    start_time?: never;
+    end_time?: never;
+} | {
     /**
      * Days of week this window applies to. Use multiple days for compact targeting (e.g., monday-friday in one object). For an overnight start_time/end_time window, each day names the day the window starts on.
-     *
-     * @minItems 1
-     */
-    days: [DayOfWeek, ...DayOfWeek[]];
-    /**
-     * Start hour (inclusive), 0-23 in 24-hour format. 0 = midnight, 6 = 6:00am, 18 = 6:00pm. Whole-hour form: pair with end_hour; mutually exclusive with start_time and end_time.
-     */
-    start_hour?: number;
-    /**
-     * End hour (exclusive), 1-24 in 24-hour format. 10 = 10:00am, 24 = midnight. Must be greater than start_hour; whole-hour windows never cross midnight. Whole-hour form: pair with start_hour; mutually exclusive with start_time and end_time.
      */
-    end_hour?: number;
+    days: DayOfWeek[];
     /**
      * Experimental in AdCP 3.3. Start of the window (inclusive) as a 24-hour HH:MM civil clock time on the entry's timezone clock, such as '19:30'. Use for windows that do not fall on whole hours (linear TV programme junctions, quarter-hour schedules). Pair with end_time; mutually exclusive with start_hour and end_hour. A window whose end_time is earlier than its start_time crosses midnight and belongs to the day it starts on. A product accepts only the finest time granularity it declares in overlay_support.daypart_targets.time_granularity; sellers MUST reject, never round, a clock time the product does not honor.
+     * @pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$
      */
-    start_time?: string;
+    start_time: string;
     /**
      * Experimental in AdCP 3.3. End of the window (exclusive) as a 24-hour HH:MM civil clock time, such as '23:00'. Pair with start_time; mutually exclusive with start_hour and end_hour. end_time earlier than start_time means the window crosses midnight and ends at end_time on the following civil day (for example, 22:00 to 02:00 runs from 22:00 on a listed day until 02:00 the next morning); '00:00' therefore ends the window at the midnight closing the start day. end_time MUST NOT equal start_time: a zero-length or full-day window is invalid, and a full day uses start_hour 0 with end_hour 24. Sellers MUST reject an equal pair with INVALID_REQUEST.
+     * @pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$
      */
-    end_time?: string;
+    end_time: string;
     /**
      * Civil-time clock used to evaluate this window. 'inventory_local' evaluates the hours in the seller-assigned local timezone of each inventory unit that can deliver the impression, such as a screen, venue, station, or publisher property; it never means the buyer, account, or server timezone. A concrete IANA timezone identifier (for example, 'America/New_York', 'CET', or 'UTC') evaluates one shared civil-time clock across the targeted inventory. Omission defaults to 'inventory_local'. Buyers that begin with a user or account preference MUST resolve it to a concrete IANA identifier before sending the daypart; 'user_timezone' and 'account_timezone' are not wire values. For each candidate delivery instant, convert the instant into this clock and compare its resulting local day and time of day with the half-open window: a skipped DST hour or interval has no matching instants, while both occurrences of a repeated hour or interval match. For an overnight start_time/end_time window, an instant matches when its local day is a listed day and its local time is at or after start_time, or when the local day before it is a listed day and its local time is before end_time. This delivery clock is independent of reporting_capabilities.timezone.
      */
@@ -1667,7 +1657,9 @@ export type DaypartTarget = {
      * Optional human-readable name for this time window (e.g., 'Morning Drive', 'Prime Time')
      */
     label?: string;
-} & ({} | {});
+    start_hour?: never;
+    end_hour?: never;
+};
 
 /**
  * Seller-authored integrity pin over one third-party-published definition that a proposal's commercial_terms reference: a publisher-catalog format option, publisher-catalog placement, adagents.json collection, or data-provider signal. content_digest is the lowercase-hex SHA-256 of the RFC 8785 (JCS) serialization of the kind's closed projection of the published entry, defined normatively in docs/media-buy/specification.mdx#definition-pins. Pins live inside commercial_terms, so terms_digest covers the pin but not the definition it names: a published definition can change while terms_digest still verifies, and re-verifying the pin is what detects it. Request inputs never carry pins.