@trillboards/ads-sdk 2.0.0

package/dist/server.d.ts

@@ -0,0 +1,238 @@
+interface VastTagBuilderConfig {
+    apiKey: string;
+    apiBase?: string;
+}
+interface BuildTagOptions {
+    deviceId: string;
+    width?: number;
+    height?: number;
+    orientation?: 'portrait' | 'landscape';
+    muted?: boolean;
+    autoplay?: boolean;
+    userAgent?: string;
+}
+interface VastTagResult {
+    url: string;
+    sources: Array<{
+        name: string;
+        vast_url: string;
+        priority: number;
+        timeout_ms: number;
+    }>;
+    auctionWinner?: {
+        source: string;
+        bid_price_cpm: number;
+        vast_url: string;
+    } | null;
+}
+declare class VastTagBuilder {
+    private authFetch;
+    constructor(config: VastTagBuilderConfig);
+    buildTag(options: BuildTagOptions): Promise<VastTagResult>;
+}
+
+interface TrackingBatchConfig {
+    apiKey: string;
+    apiBase?: string;
+}
+interface ImpressionReport {
+    adId: string;
+    impressionId: string;
+    deviceId: string;
+    screenId?: string;
+    duration: number;
+    completed: boolean;
+    timestamp: string;
+}
+interface TrackingResult {
+    success: boolean;
+    tracked: number;
+    proofs: Array<{
+        impressionId: string;
+        proof: string;
+        publicKeyUrl: string;
+    }>;
+}
+declare class TrackingBatch {
+    private apiBase;
+    private authFetch;
+    constructor(config: TrackingBatchConfig);
+    report(impressions: ImpressionReport[]): Promise<TrackingResult>;
+}
+
+interface LiveAudience {
+    face_count: number;
+    attention_score: number;
+    mood: string | null;
+    income_level: string | null;
+    purchase_intent: number | null;
+    dwell_time_ms: number | null;
+    timestamp: string;
+}
+interface AudiencePrediction {
+    predicted_face_count: number;
+    predicted_attention_score: number;
+    predicted_mood: string | null;
+    confidence: number;
+    hour: number;
+    dayOfWeek: number;
+}
+interface LookalikeScreen {
+    screenId: string;
+    similarity: number;
+    audience_profile: Record<string, unknown>;
+}
+declare class AudienceClient {
+    private authFetch;
+    constructor(apiKey: string, apiBase: string);
+    getLive(screenId: string): Promise<LiveAudience>;
+    predict(screenId: string, options: {
+        hour: number;
+        dayOfWeek: number;
+    }): Promise<AudiencePrediction>;
+    findLookalikes(screenId: string, options?: {
+        limit?: number;
+        minSimilarity?: number;
+    }): Promise<LookalikeScreen[]>;
+}
+
+interface ScreenDailyAnalytics {
+    date: string;
+    ads: {
+        plays_started: number;
+        plays_completed: number;
+        completion_rate: number;
+        programmatic_plays: number;
+        direct_plays: number;
+    };
+    audience: {
+        avg_face_count: number;
+        avg_attention_score: number;
+        peak_viewers: number;
+    };
+    earnings: {
+        programmatic_cents: number;
+        direct_cents: number;
+        total_cents: number;
+    };
+    streaming: {
+        seconds: number;
+        uptime_percentage: number;
+    };
+}
+interface EarningsData {
+    screenId: string;
+    period: string;
+    impressions_count: number;
+    cpm_rate: number;
+    gross_revenue: number;
+    earner_revenue: number;
+    earner_share_rate: number;
+}
+declare class AnalyticsClient {
+    private authFetch;
+    constructor(apiKey: string, apiBase: string);
+    getScreenDaily(screenId: string, options: {
+        startDate: string;
+        endDate: string;
+    }): Promise<ScreenDailyAnalytics[]>;
+    getEarnings(options?: {
+        screenId?: string;
+        startDate?: string;
+        endDate?: string;
+    }): Promise<EarningsData[]>;
+}
+
+interface AuctionResult {
+    auction_id: string;
+    screen_id: string;
+    timestamp: string;
+    winning_bid: {
+        bid_price_cpm: number;
+        dsp_name: string;
+        creative_id: string;
+        vast_url: string;
+    } | null;
+    all_bids: Array<{
+        dsp_name: string;
+        bid_price_cpm: number;
+        latency_ms: number;
+    }>;
+    latency_ms: number;
+    floor_price_cpm: number;
+}
+declare class AuctionClient {
+    private authFetch;
+    constructor(apiKey: string, apiBase: string);
+    list(options?: {
+        screenId?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<AuctionResult[]>;
+    get(auctionId: string): Promise<AuctionResult>;
+}
+
+interface CreativeReview {
+    creative_id: string;
+    advertiser_name: string;
+    creative_url: string;
+    status: 'pending' | 'approved' | 'flagged' | 'blocked';
+    iab_categories: string[];
+    age_rating: string | null;
+    brand_detected: string | null;
+    content_flags: string[];
+    reviewed_at: string | null;
+    created_at: string;
+}
+interface CreativeStats {
+    total: number;
+    pending: number;
+    approved: number;
+    flagged: number;
+    blocked: number;
+}
+declare class CreativeClient {
+    private authFetch;
+    constructor(apiKey: string, apiBase: string);
+    list(options?: {
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<CreativeReview[]>;
+    getStats(): Promise<CreativeStats>;
+    block(creativeId: string, reason?: string): Promise<void>;
+    unblock(creativeId: string): Promise<void>;
+}
+
+interface PartnerClientConfig {
+    apiKey: string;
+    apiBase?: string;
+}
+declare class PartnerClient {
+    private apiKey;
+    private apiBase;
+    private authFetch;
+    readonly audience: AudienceClient;
+    readonly analytics: AnalyticsClient;
+    readonly auctions: AuctionClient;
+    readonly creatives: CreativeClient;
+    constructor(config: PartnerClientConfig);
+    createVastTagBuilder(): VastTagBuilder;
+    createTrackingBatch(): TrackingBatch;
+    protected fetch(path: string, options?: RequestInit): Promise<any>;
+}
+
+/**
+ * Create a reusable authenticated fetch function bound to a
+ * specific API key and base URL.
+ *
+ * - Strips trailing slashes from `apiBase` to avoid double-slash paths.
+ * - Applies a 10-second timeout via `AbortSignal.timeout` unless
+ *   the caller provides their own `signal`.
+ * - Always sends `Authorization: Bearer <key>` and
+ *   `Content-Type: application/json`.
+ * - Throws on non-2xx responses.
+ */
+declare function createAuthenticatedFetch(apiKey: string, apiBase: string): (path: string, options?: RequestInit) => Promise<any>;
+
+export { AnalyticsClient, AuctionClient, type AuctionResult, AudienceClient, type AudiencePrediction, type BuildTagOptions, CreativeClient, type CreativeReview, type CreativeStats, type EarningsData, type ImpressionReport, type LiveAudience, type LookalikeScreen, PartnerClient, type PartnerClientConfig, type ScreenDailyAnalytics, TrackingBatch, type TrackingBatchConfig, type TrackingResult, VastTagBuilder, type VastTagBuilderConfig, type VastTagResult, createAuthenticatedFetch };

package/dist/server.js

@@ -0,0 +1,209 @@
+'use strict';
+
+// src/server/fetchWithAuth.ts
+function createAuthenticatedFetch(apiKey, apiBase) {
+  const base = apiBase.replace(/\/+$/, "");
+  return async (path, options) => {
+    const response = await globalThis.fetch(`${base}${path}`, {
+      ...options,
+      signal: options?.signal ?? AbortSignal.timeout(1e4),
+      headers: {
+        "Authorization": `Bearer ${apiKey}`,
+        "Content-Type": "application/json",
+        ...options?.headers ?? {}
+      }
+    });
+    if (!response.ok) {
+      throw new Error(`API error: HTTP ${response.status}`);
+    }
+    return response.json();
+  };
+}
+
+// src/server/VastTagBuilder.ts
+var VastTagBuilder = class {
+  constructor(config) {
+    this.authFetch = createAuthenticatedFetch(config.apiKey, config.apiBase ?? "https://api.trillboards.com/v1");
+  }
+  async buildTag(options) {
+    const params = new URLSearchParams();
+    if (options.width) params.set("slot_w", String(options.width));
+    if (options.height) params.set("slot_h", String(options.height));
+    if (options.orientation) params.set("orientation", options.orientation);
+    if (options.muted !== void 0) params.set("muted", options.muted ? "1" : "0");
+    if (options.autoplay !== void 0) params.set("autoplay", options.autoplay ? "1" : "0");
+    if (options.userAgent) params.set("ua", options.userAgent);
+    const query = params.toString();
+    const path = `/partner/device/${options.deviceId}/ads${query ? `?${query}` : ""}`;
+    const data = await this.authFetch(path);
+    const hbs = data.data?.header_bidding_settings;
+    return {
+      url: hbs?.vast_tag_url ?? "",
+      sources: (hbs?.vast_waterfall?.sources ?? []).map((s) => ({
+        name: s.name,
+        vast_url: s.vast_url,
+        priority: s.priority,
+        timeout_ms: s.timeout_ms
+      })),
+      auctionWinner: hbs?.auction_winner ?? null
+    };
+  }
+};
+
+// src/server/TrackingBatch.ts
+var TrackingBatch = class {
+  constructor(config) {
+    this.apiBase = (config.apiBase ?? "https://api.trillboards.com/v1").replace(/\/+$/, "");
+    this.authFetch = createAuthenticatedFetch(config.apiKey, config.apiBase ?? "https://api.trillboards.com/v1");
+  }
+  async report(impressions) {
+    const data = await this.authFetch("/partner/tracking/batch", {
+      method: "POST",
+      body: JSON.stringify({ impressions })
+    });
+    return {
+      success: data.success ?? true,
+      tracked: data.data?.tracked ?? impressions.length,
+      proofs: (data.data?.proofs ?? []).map((p) => ({
+        impressionId: p.impression_id,
+        proof: p.proof,
+        publicKeyUrl: p.public_key_url ?? `${this.apiBase}/.well-known/public-key`
+      }))
+    };
+  }
+};
+
+// src/server/AudienceClient.ts
+var AudienceClient = class {
+  constructor(apiKey, apiBase) {
+    this.authFetch = createAuthenticatedFetch(apiKey, apiBase);
+  }
+  async getLive(screenId) {
+    const data = await this.authFetch(`/partner/audience/live/${screenId}`);
+    return data.data ?? data;
+  }
+  async predict(screenId, options) {
+    const params = new URLSearchParams({
+      hour: String(options.hour),
+      day_of_week: String(options.dayOfWeek)
+    });
+    const data = await this.authFetch(`/partner/audience/predict/${screenId}?${params}`);
+    return data.data ?? data;
+  }
+  async findLookalikes(screenId, options) {
+    const params = new URLSearchParams();
+    if (options?.limit) params.set("limit", String(options.limit));
+    if (options?.minSimilarity) params.set("min_similarity", String(options.minSimilarity));
+    const query = params.toString();
+    const data = await this.authFetch(`/partner/audience/lookalikes/${screenId}${query ? `?${query}` : ""}`);
+    return data.data ?? [];
+  }
+};
+
+// src/server/AnalyticsClient.ts
+var AnalyticsClient = class {
+  constructor(apiKey, apiBase) {
+    this.authFetch = createAuthenticatedFetch(apiKey, apiBase);
+  }
+  async getScreenDaily(screenId, options) {
+    const params = new URLSearchParams({
+      start_date: options.startDate,
+      end_date: options.endDate
+    });
+    const data = await this.authFetch(`/partner/screens/${screenId}/analytics?${params}`);
+    return data.data ?? [];
+  }
+  async getEarnings(options) {
+    const params = new URLSearchParams();
+    if (options?.screenId) params.set("screen_id", options.screenId);
+    if (options?.startDate) params.set("start_date", options.startDate);
+    if (options?.endDate) params.set("end_date", options.endDate);
+    const query = params.toString();
+    const data = await this.authFetch(`/partner/earnings${query ? `?${query}` : ""}`);
+    return data.data ?? [];
+  }
+};
+
+// src/server/AuctionClient.ts
+var AuctionClient = class {
+  constructor(apiKey, apiBase) {
+    this.authFetch = createAuthenticatedFetch(apiKey, apiBase);
+  }
+  async list(options) {
+    const params = new URLSearchParams();
+    if (options?.screenId) params.set("screen_id", options.screenId);
+    if (options?.limit) params.set("limit", String(options.limit));
+    if (options?.offset) params.set("offset", String(options.offset));
+    const query = params.toString();
+    const data = await this.authFetch(`/partner/auctions${query ? `?${query}` : ""}`);
+    return data.data ?? [];
+  }
+  async get(auctionId) {
+    const data = await this.authFetch(`/partner/auctions/${auctionId}`);
+    return data.data ?? data;
+  }
+};
+
+// src/server/CreativeClient.ts
+var CreativeClient = class {
+  constructor(apiKey, apiBase) {
+    this.authFetch = createAuthenticatedFetch(apiKey, apiBase);
+  }
+  async list(options) {
+    const params = new URLSearchParams();
+    if (options?.status) params.set("status", options.status);
+    if (options?.limit) params.set("limit", String(options.limit));
+    if (options?.offset) params.set("offset", String(options.offset));
+    const query = params.toString();
+    const data = await this.authFetch(`/openrtb/v1/creative-review${query ? `?${query}` : ""}`);
+    return data.data ?? [];
+  }
+  async getStats() {
+    const data = await this.authFetch("/openrtb/v1/creative-review/stats");
+    return data.data ?? data;
+  }
+  async block(creativeId, reason) {
+    await this.authFetch(`/openrtb/v1/creative-review/${creativeId}/block`, {
+      method: "POST",
+      body: JSON.stringify({ reason })
+    });
+  }
+  async unblock(creativeId) {
+    await this.authFetch(`/openrtb/v1/creative-review/${creativeId}/unblock`, {
+      method: "POST"
+    });
+  }
+};
+
+// src/server/PartnerClient.ts
+var PartnerClient = class {
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.apiBase = config.apiBase ?? "https://api.trillboards.com/v1";
+    this.authFetch = createAuthenticatedFetch(this.apiKey, this.apiBase);
+    this.audience = new AudienceClient(this.apiKey, this.apiBase);
+    this.analytics = new AnalyticsClient(this.apiKey, this.apiBase);
+    this.auctions = new AuctionClient(this.apiKey, this.apiBase);
+    this.creatives = new CreativeClient(this.apiKey, this.apiBase);
+  }
+  createVastTagBuilder() {
+    return new VastTagBuilder({ apiKey: this.apiKey, apiBase: this.apiBase });
+  }
+  createTrackingBatch() {
+    return new TrackingBatch({ apiKey: this.apiKey, apiBase: this.apiBase });
+  }
+  async fetch(path, options = {}) {
+    return this.authFetch(path, options);
+  }
+};
+
+exports.AnalyticsClient = AnalyticsClient;
+exports.AuctionClient = AuctionClient;
+exports.AudienceClient = AudienceClient;
+exports.CreativeClient = CreativeClient;
+exports.PartnerClient = PartnerClient;
+exports.TrackingBatch = TrackingBatch;
+exports.VastTagBuilder = VastTagBuilder;
+exports.createAuthenticatedFetch = createAuthenticatedFetch;
+//# sourceMappingURL=server.js.map
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/fetchWithAuth.ts","../src/server/VastTagBuilder.ts","../src/server/TrackingBatch.ts","../src/server/AudienceClient.ts","../src/server/AnalyticsClient.ts","../src/server/AuctionClient.ts","../src/server/CreativeClient.ts","../src/server/PartnerClient.ts"],"names":[],"mappings":"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","file":"server.js","sourcesContent":["// ─────────────────────────────────────────────────────────────\n// @trillboards/ads-sdk  —  Shared authenticated fetch utility\n// ─────────────────────────────────────────────────────────────\n\n/**\n * Create a reusable authenticated fetch function bound to a\n * specific API key and base URL.\n *\n * - Strips trailing slashes from `apiBase` to avoid double-slash paths.\n * - Applies a 10-second timeout via `AbortSignal.timeout` unless\n *   the caller provides their own `signal`.\n * - Always sends `Authorization: Bearer <key>` and\n *   `Content-Type: application/json`.\n * - Throws on non-2xx responses.\n */\nexport function createAuthenticatedFetch(apiKey: string, apiBase: string) {\n  const base = apiBase.replace(/\\/+$/, '');\n\n  return async (path: string, options?: RequestInit): Promise<any> => {\n    const response = await globalThis.fetch(`${base}${path}`, {\n      ...options,\n      signal: options?.signal ?? AbortSignal.timeout(10000),\n      headers: {\n        'Authorization': `Bearer ${apiKey}`,\n        'Content-Type': 'application/json',\n        ...((options?.headers as Record<string, string>) ?? {}),\n      },\n    });\n\n    if (!response.ok) {\n      throw new Error(`API error: HTTP ${response.status}`);\n    }\n\n    return response.json();\n  };\n}\n","import { createAuthenticatedFetch } from './fetchWithAuth';\n\nexport interface VastTagBuilderConfig {\n  apiKey: string;\n  apiBase?: string;\n}\n\nexport interface BuildTagOptions {\n  deviceId: string;\n  width?: number;\n  height?: number;\n  orientation?: 'portrait' | 'landscape';\n  muted?: boolean;\n  autoplay?: boolean;\n  userAgent?: string;\n}\n\nexport interface VastTagResult {\n  url: string;\n  sources: Array<{\n    name: string;\n    vast_url: string;\n    priority: number;\n    timeout_ms: number;\n  }>;\n  auctionWinner?: {\n    source: string;\n    bid_price_cpm: number;\n    vast_url: string;\n  } | null;\n}\n\nexport class VastTagBuilder {\n  private authFetch: ReturnType<typeof createAuthenticatedFetch>;\n\n  constructor(config: VastTagBuilderConfig) {\n    this.authFetch = createAuthenticatedFetch(config.apiKey, config.apiBase ?? 'https://api.trillboards.com/v1');\n  }\n\n  async buildTag(options: BuildTagOptions): Promise<VastTagResult> {\n    const params = new URLSearchParams();\n    if (options.width) params.set('slot_w', String(options.width));\n    if (options.height) params.set('slot_h', String(options.height));\n    if (options.orientation) params.set('orientation', options.orientation);\n    if (options.muted !== undefined) params.set('muted', options.muted ? '1' : '0');\n    if (options.autoplay !== undefined) params.set('autoplay', options.autoplay ? '1' : '0');\n    if (options.userAgent) params.set('ua', options.userAgent);\n\n    const query = params.toString();\n    const path = `/partner/device/${options.deviceId}/ads${query ? `?${query}` : ''}`;\n\n    const data = await this.authFetch(path);\n    const hbs = data.data?.header_bidding_settings;\n\n    return {\n      url: hbs?.vast_tag_url ?? '',\n      sources: (hbs?.vast_waterfall?.sources ?? []).map((s: any) => ({\n        name: s.name,\n        vast_url: s.vast_url,\n        priority: s.priority,\n        timeout_ms: s.timeout_ms,\n      })),\n      auctionWinner: hbs?.auction_winner ?? null,\n    };\n  }\n}\n","import { createAuthenticatedFetch } from './fetchWithAuth';\n\nexport interface TrackingBatchConfig {\n  apiKey: string;\n  apiBase?: string;\n}\n\nexport interface ImpressionReport {\n  adId: string;\n  impressionId: string;\n  deviceId: string;\n  screenId?: string;\n  duration: number;\n  completed: boolean;\n  timestamp: string;\n}\n\nexport interface TrackingResult {\n  success: boolean;\n  tracked: number;\n  proofs: Array<{\n    impressionId: string;\n    proof: string;\n    publicKeyUrl: string;\n  }>;\n}\n\nexport class TrackingBatch {\n  private apiBase: string;\n  private authFetch: ReturnType<typeof createAuthenticatedFetch>;\n\n  constructor(config: TrackingBatchConfig) {\n    this.apiBase = (config.apiBase ?? 'https://api.trillboards.com/v1').replace(/\\/+$/, '');\n    this.authFetch = createAuthenticatedFetch(config.apiKey, config.apiBase ?? 'https://api.trillboards.com/v1');\n  }\n\n  async report(impressions: ImpressionReport[]): Promise<TrackingResult> {\n    const data = await this.authFetch('/partner/tracking/batch', {\n      method: 'POST',\n      body: JSON.stringify({ impressions }),\n    });\n\n    return {\n      success: data.success ?? true,\n      tracked: data.data?.tracked ?? impressions.length,\n      proofs: (data.data?.proofs ?? []).map((p: any) => ({\n        impressionId: p.impression_id,\n        proof: p.proof,\n        publicKeyUrl: p.public_key_url ?? `${this.apiBase}/.well-known/public-key`,\n      })),\n    };\n  }\n}\n","import { createAuthenticatedFetch } from './fetchWithAuth';\n\nexport interface LiveAudience {\n  face_count: number;\n  attention_score: number;\n  mood: string | null;\n  income_level: string | null;\n  purchase_intent: number | null;\n  dwell_time_ms: number | null;\n  timestamp: string;\n}\n\nexport interface AudiencePrediction {\n  predicted_face_count: number;\n  predicted_attention_score: number;\n  predicted_mood: string | null;\n  confidence: number;\n  hour: number;\n  dayOfWeek: number;\n}\n\nexport interface LookalikeScreen {\n  screenId: string;\n  similarity: number;\n  audience_profile: Record<string, unknown>;\n}\n\nexport class AudienceClient {\n  private authFetch: ReturnType<typeof createAuthenticatedFetch>;\n\n  constructor(apiKey: string, apiBase: string) {\n    this.authFetch = createAuthenticatedFetch(apiKey, apiBase);\n  }\n\n  async getLive(screenId: string): Promise<LiveAudience> {\n    const data = await this.authFetch(`/partner/audience/live/${screenId}`);\n    return data.data ?? data;\n  }\n\n  async predict(screenId: string, options: { hour: number; dayOfWeek: number }): Promise<AudiencePrediction> {\n    const params = new URLSearchParams({\n      hour: String(options.hour),\n      day_of_week: String(options.dayOfWeek),\n    });\n    const data = await this.authFetch(`/partner/audience/predict/${screenId}?${params}`);\n    return data.data ?? data;\n  }\n\n  async findLookalikes(screenId: string, options?: { limit?: number; minSimilarity?: number }): Promise<LookalikeScreen[]> {\n    const params = new URLSearchParams();\n    if (options?.limit) params.set('limit', String(options.limit));\n    if (options?.minSimilarity) params.set('min_similarity', String(options.minSimilarity));\n    const query = params.toString();\n    const data = await this.authFetch(`/partner/audience/lookalikes/${screenId}${query ? `?${query}` : ''}`);\n    return data.data ?? [];\n  }\n}\n","import { createAuthenticatedFetch } from './fetchWithAuth';\n\nexport interface ScreenDailyAnalytics {\n  date: string;\n  ads: {\n    plays_started: number;\n    plays_completed: number;\n    completion_rate: number;\n    programmatic_plays: number;\n    direct_plays: number;\n  };\n  audience: {\n    avg_face_count: number;\n    avg_attention_score: number;\n    peak_viewers: number;\n  };\n  earnings: {\n    programmatic_cents: number;\n    direct_cents: number;\n    total_cents: number;\n  };\n  streaming: {\n    seconds: number;\n    uptime_percentage: number;\n  };\n}\n\nexport interface EarningsData {\n  screenId: string;\n  period: string;\n  impressions_count: number;\n  cpm_rate: number;\n  gross_revenue: number;\n  earner_revenue: number;\n  earner_share_rate: number;\n}\n\nexport class AnalyticsClient {\n  private authFetch: ReturnType<typeof createAuthenticatedFetch>;\n\n  constructor(apiKey: string, apiBase: string) {\n    this.authFetch = createAuthenticatedFetch(apiKey, apiBase);\n  }\n\n  async getScreenDaily(screenId: string, options: { startDate: string; endDate: string }): Promise<ScreenDailyAnalytics[]> {\n    const params = new URLSearchParams({\n      start_date: options.startDate,\n      end_date: options.endDate,\n    });\n    const data = await this.authFetch(`/partner/screens/${screenId}/analytics?${params}`);\n    return data.data ?? [];\n  }\n\n  async getEarnings(options?: { screenId?: string; startDate?: string; endDate?: string }): Promise<EarningsData[]> {\n    const params = new URLSearchParams();\n    if (options?.screenId) params.set('screen_id', options.screenId);\n    if (options?.startDate) params.set('start_date', options.startDate);\n    if (options?.endDate) params.set('end_date', options.endDate);\n    const query = params.toString();\n    const data = await this.authFetch(`/partner/earnings${query ? `?${query}` : ''}`);\n    return data.data ?? [];\n  }\n}\n","import { createAuthenticatedFetch } from './fetchWithAuth';\n\nexport interface AuctionResult {\n  auction_id: string;\n  screen_id: string;\n  timestamp: string;\n  winning_bid: {\n    bid_price_cpm: number;\n    dsp_name: string;\n    creative_id: string;\n    vast_url: string;\n  } | null;\n  all_bids: Array<{\n    dsp_name: string;\n    bid_price_cpm: number;\n    latency_ms: number;\n  }>;\n  latency_ms: number;\n  floor_price_cpm: number;\n}\n\nexport class AuctionClient {\n  private authFetch: ReturnType<typeof createAuthenticatedFetch>;\n\n  constructor(apiKey: string, apiBase: string) {\n    this.authFetch = createAuthenticatedFetch(apiKey, apiBase);\n  }\n\n  async list(options?: { screenId?: string; limit?: number; offset?: number }): Promise<AuctionResult[]> {\n    const params = new URLSearchParams();\n    if (options?.screenId) params.set('screen_id', options.screenId);\n    if (options?.limit) params.set('limit', String(options.limit));\n    if (options?.offset) params.set('offset', String(options.offset));\n    const query = params.toString();\n    const data = await this.authFetch(`/partner/auctions${query ? `?${query}` : ''}`);\n    return data.data ?? [];\n  }\n\n  async get(auctionId: string): Promise<AuctionResult> {\n    const data = await this.authFetch(`/partner/auctions/${auctionId}`);\n    return data.data ?? data;\n  }\n}\n","import { createAuthenticatedFetch } from './fetchWithAuth';\n\nexport interface CreativeReview {\n  creative_id: string;\n  advertiser_name: string;\n  creative_url: string;\n  status: 'pending' | 'approved' | 'flagged' | 'blocked';\n  iab_categories: string[];\n  age_rating: string | null;\n  brand_detected: string | null;\n  content_flags: string[];\n  reviewed_at: string | null;\n  created_at: string;\n}\n\nexport interface CreativeStats {\n  total: number;\n  pending: number;\n  approved: number;\n  flagged: number;\n  blocked: number;\n}\n\nexport class CreativeClient {\n  private authFetch: ReturnType<typeof createAuthenticatedFetch>;\n\n  constructor(apiKey: string, apiBase: string) {\n    this.authFetch = createAuthenticatedFetch(apiKey, apiBase);\n  }\n\n  async list(options?: { status?: string; limit?: number; offset?: number }): Promise<CreativeReview[]> {\n    const params = new URLSearchParams();\n    if (options?.status) params.set('status', options.status);\n    if (options?.limit) params.set('limit', String(options.limit));\n    if (options?.offset) params.set('offset', String(options.offset));\n    const query = params.toString();\n    const data = await this.authFetch(`/openrtb/v1/creative-review${query ? `?${query}` : ''}`);\n    return data.data ?? [];\n  }\n\n  async getStats(): Promise<CreativeStats> {\n    const data = await this.authFetch('/openrtb/v1/creative-review/stats');\n    return data.data ?? data;\n  }\n\n  async block(creativeId: string, reason?: string): Promise<void> {\n    await this.authFetch(`/openrtb/v1/creative-review/${creativeId}/block`, {\n      method: 'POST',\n      body: JSON.stringify({ reason }),\n    });\n  }\n\n  async unblock(creativeId: string): Promise<void> {\n    await this.authFetch(`/openrtb/v1/creative-review/${creativeId}/unblock`, {\n      method: 'POST',\n    });\n  }\n}\n","import { VastTagBuilder } from './VastTagBuilder';\nimport { TrackingBatch } from './TrackingBatch';\nimport { AudienceClient } from './AudienceClient';\nimport { AnalyticsClient } from './AnalyticsClient';\nimport { AuctionClient } from './AuctionClient';\nimport { CreativeClient } from './CreativeClient';\nimport { createAuthenticatedFetch } from './fetchWithAuth';\n\nexport interface PartnerClientConfig {\n  apiKey: string;\n  apiBase?: string;\n}\n\nexport class PartnerClient {\n  private apiKey: string;\n  private apiBase: string;\n  private authFetch: ReturnType<typeof createAuthenticatedFetch>;\n\n  readonly audience: AudienceClient;\n  readonly analytics: AnalyticsClient;\n  readonly auctions: AuctionClient;\n  readonly creatives: CreativeClient;\n\n  constructor(config: PartnerClientConfig) {\n    this.apiKey = config.apiKey;\n    this.apiBase = config.apiBase ?? 'https://api.trillboards.com/v1';\n    this.authFetch = createAuthenticatedFetch(this.apiKey, this.apiBase);\n    this.audience = new AudienceClient(this.apiKey, this.apiBase);\n    this.analytics = new AnalyticsClient(this.apiKey, this.apiBase);\n    this.auctions = new AuctionClient(this.apiKey, this.apiBase);\n    this.creatives = new CreativeClient(this.apiKey, this.apiBase);\n  }\n\n  createVastTagBuilder(): VastTagBuilder {\n    return new VastTagBuilder({ apiKey: this.apiKey, apiBase: this.apiBase });\n  }\n\n  createTrackingBatch(): TrackingBatch {\n    return new TrackingBatch({ apiKey: this.apiKey, apiBase: this.apiBase });\n  }\n\n  protected async fetch(path: string, options: RequestInit = {}): Promise<any> {\n    return this.authFetch(path, options);\n  }\n}\n"]}