IABTechLab · prk-Jr · Jun 9, 2026 · May 29, 2026 · May 29, 2026 · May 29, 2026
diff --git a/crates/js/lib/src/core/types.ts b/crates/js/lib/src/core/types.ts
@@ -20,6 +20,49 @@ export interface AdUnit {
   bids?: Bid[];
 }
 
+/** Minimal shape of a server-side auction slot injected into `window.tsjs.adSlots`. */
+export interface AuctionSlot {
+  id: string;
+  gam_unit_path: string;
+  div_id: string;
+  formats: Array<[number, number]>;
+  targeting?: Record<string, string>;
+}
+
+/** Debug-only copy of server-side bid fields exposed for pipeline inspection. */
+export interface AuctionDebugBidData {
+  slot_id?: string;
+  price?: number | null;
+  currency?: string;
+  creative?: string | null;
+  adomain?: string[] | null;
+  bidder?: string;
+  width?: number;
+  height?: number;
+  nurl?: string | null;
+  burl?: string | null;
+  ad_id?: string | null;
+  cache_id?: string | null;
+  cache_host?: string | null;
+  cache_path?: string | null;
+  metadata?: Record<string, unknown>;
+}
+
+/** Bid targeting data from the server-side auction, injected into `window.tsjs.bids`. */
+export interface AuctionBidData {
+  hb_pb?: string;
+  hb_bidder?: string;
+  hb_adid?: string;
+  hb_cache_host?: string;
+  hb_cache_path?: string;
+  nurl?: string;
+  burl?: string;
+  /** Raw creative markup. Only present when `[debug] inject_adm_for_testing = true`. */
+  adm?: string;
+  /** Debug-only bid field mirror. Only present when `[debug] inject_adm_for_testing = true`. */
+  debug_bid?: AuctionDebugBidData;
+}
+
 export interface TsjsApi {
   version: string;
   que: Array<() => void>;
@@ -41,4 +84,20 @@ export interface TsjsApi {
     error(...args: unknown[]): void;
     debug(...args: unknown[]): void;
   };
+
+  // ── Server-side auction runtime (populated by TS edge injection) ──────────
+  /** Ad slot definitions injected at <head> open. */
+  adSlots?: AuctionSlot[];
+  /** Winning bid targeting data injected before </body>. */
+  bids?: Record<string, AuctionBidData>;
+  /** Initialises GPT slots with server-side bid targeting and calls refresh(). */
+  adInit?: () => void;
+  /** GPT slot objects TS defined — used to destroy stale slots on SPA navigation. */
+  prevGptSlots?: unknown[];
+  /** Guards one-time-per-page enableSingleRequest/enableServices calls. */
+  servicesEnabled?: boolean;
+  /** Maps actualDivId → slotId for slotRenderEnded billing lookup. */
+  divToSlotId?: Record<string, string>;
+  /** Guards SPA pushState hook installation. */
+  spaHookInstalled?: boolean;
 }