@the_ro_show/agent-ads-sdk 0.1.0

package/dist/index.js

@@ -0,0 +1,351 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  APIRequestError: () => APIRequestError,
+  AttentionMarketClient: () => AttentionMarketClient,
+  AttentionMarketError: () => AttentionMarketError,
+  NetworkError: () => NetworkError,
+  TimeoutError: () => TimeoutError,
+  createClickEvent: () => createClickEvent,
+  createImpressionEvent: () => createImpressionEvent,
+  createOpportunity: () => createOpportunity,
+  generateTimestamp: () => generateTimestamp,
+  generateUUID: () => generateUUID
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var AttentionMarketError = class _AttentionMarketError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "AttentionMarketError";
+    Object.setPrototypeOf(this, _AttentionMarketError.prototype);
+  }
+};
+var APIRequestError = class _APIRequestError extends AttentionMarketError {
+  statusCode;
+  errorCode;
+  requestId;
+  details;
+  constructor(statusCode, apiError) {
+    super(apiError.message);
+    this.name = "APIRequestError";
+    this.statusCode = statusCode;
+    this.errorCode = apiError.error;
+    if (apiError.request_id !== void 0) {
+      this.requestId = apiError.request_id;
+    }
+    if (apiError.details !== void 0) {
+      this.details = apiError.details;
+    }
+    Object.setPrototypeOf(this, _APIRequestError.prototype);
+  }
+};
+var NetworkError = class _NetworkError extends AttentionMarketError {
+  cause;
+  constructor(message, cause) {
+    super(message);
+    this.name = "NetworkError";
+    if (cause !== void 0) {
+      this.cause = cause;
+    }
+    Object.setPrototypeOf(this, _NetworkError.prototype);
+  }
+};
+var TimeoutError = class _TimeoutError extends AttentionMarketError {
+  constructor(message = "Request timed out") {
+    super(message);
+    this.name = "TimeoutError";
+    Object.setPrototypeOf(this, _TimeoutError.prototype);
+  }
+};
+
+// src/http.ts
+var RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([408, 429, 500, 502, 503, 504]);
+var HTTPClient = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async request(method, path, options = {}) {
+    const url = `${this.config.baseUrl}${path}`;
+    let lastError;
+    for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
+      try {
+        const response = await this.makeRequest(url, method, options);
+        return response;
+      } catch (error) {
+        lastError = error;
+        if (!this.shouldRetry(error, attempt)) {
+          throw error;
+        }
+        if (attempt < this.config.maxRetries) {
+          await this.backoff(attempt);
+        }
+      }
+    }
+    throw lastError;
+  }
+  async makeRequest(url, method, options) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.config.timeoutMs);
+    try {
+      const headers = {
+        "Content-Type": "application/json",
+        ...options.headers
+      };
+      if (this.config.apiKey) {
+        headers["Authorization"] = `Bearer ${this.config.apiKey}`;
+      }
+      if (options.idempotencyKey) {
+        headers["Idempotency-Key"] = options.idempotencyKey;
+      }
+      const response = await fetch(url, {
+        method,
+        headers,
+        body: options.body ? JSON.stringify(options.body) : void 0,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        const errorBody = await response.json().catch(() => ({
+          error: "unknown_error",
+          message: "Failed to parse error response",
+          request_id: "unknown"
+        }));
+        throw new APIRequestError(response.status, errorBody);
+      }
+      return await response.json();
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new TimeoutError();
+      }
+      if (error instanceof APIRequestError) {
+        throw error;
+      }
+      throw new NetworkError("Network request failed", error);
+    }
+  }
+  shouldRetry(error, attempt) {
+    if (attempt >= this.config.maxRetries) {
+      return false;
+    }
+    if (error instanceof TimeoutError) {
+      return true;
+    }
+    if (error instanceof NetworkError) {
+      return true;
+    }
+    if (error instanceof APIRequestError) {
+      return RETRYABLE_STATUS_CODES.has(error.statusCode);
+    }
+    return false;
+  }
+  async backoff(attempt) {
+    const baseDelay = 100 * Math.pow(2, attempt);
+    const jitter = Math.random() * 100;
+    const delay = baseDelay + jitter;
+    await new Promise((resolve) => setTimeout(resolve, delay));
+  }
+};
+
+// src/utils.ts
+var import_node_crypto = require("crypto");
+function generateUUID() {
+  return (0, import_node_crypto.randomUUID)();
+}
+function generateTimestamp() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function createOpportunity(params) {
+  const opportunity = {
+    intent: {
+      taxonomy: params.taxonomy
+    },
+    context: {
+      country: params.country,
+      language: params.language,
+      platform: params.platform
+    },
+    constraints: {
+      max_units: params.constraints?.max_units ?? 1,
+      allowed_unit_types: params.constraints?.allowed_unit_types ?? ["sponsored_suggestion"]
+    },
+    privacy: {
+      data_policy: params.privacy?.data_policy ?? "coarse_only"
+    }
+  };
+  if (params.query !== void 0) {
+    opportunity.intent.query = params.query;
+  }
+  if (params.region !== void 0) {
+    opportunity.context.region = params.region;
+  }
+  if (params.city !== void 0) {
+    opportunity.context.city = params.city;
+  }
+  if (params.constraints?.blocked_categories !== void 0) {
+    opportunity.constraints.blocked_categories = params.constraints.blocked_categories;
+  }
+  if (params.constraints?.max_title_chars !== void 0) {
+    opportunity.constraints.max_title_chars = params.constraints.max_title_chars;
+  }
+  if (params.constraints?.max_body_chars !== void 0) {
+    opportunity.constraints.max_body_chars = params.constraints.max_body_chars;
+  }
+  return opportunity;
+}
+function createImpressionEvent(params) {
+  const event = {
+    event_id: generateUUID(),
+    occurred_at: params.occurred_at ?? generateTimestamp(),
+    agent_id: params.agent_id,
+    request_id: params.request_id,
+    decision_id: params.decision_id,
+    unit_id: params.unit_id,
+    event_type: "impression",
+    tracking_token: params.tracking_token
+  };
+  if (params.metadata !== void 0) {
+    event.metadata = params.metadata;
+  }
+  return event;
+}
+function createClickEvent(params) {
+  const event = {
+    event_id: generateUUID(),
+    occurred_at: params.occurred_at ?? generateTimestamp(),
+    agent_id: params.agent_id,
+    request_id: params.request_id,
+    decision_id: params.decision_id,
+    unit_id: params.unit_id,
+    event_type: "click",
+    tracking_token: params.tracking_token
+  };
+  if (params.metadata !== void 0) {
+    event.metadata = {
+      ...params.metadata,
+      href: params.href
+    };
+  } else {
+    event.metadata = {
+      href: params.href
+    };
+  }
+  return event;
+}
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.attentionmarket.ai";
+var DEFAULT_TIMEOUT_MS = 4e3;
+var DEFAULT_MAX_RETRIES = 2;
+var AttentionMarketClient = class {
+  http;
+  constructor(config) {
+    this.http = new HTTPClient({
+      apiKey: config.apiKey,
+      baseUrl: config.baseUrl ?? DEFAULT_BASE_URL,
+      timeoutMs: config.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+      maxRetries: config.maxRetries ?? DEFAULT_MAX_RETRIES
+    });
+  }
+  /**
+   * Request a sponsored unit decision for an agent opportunity.
+   * Returns the full DecideResponse including status, ttl_ms, and all units.
+   */
+  async decideRaw(request, options) {
+    const requestOptions = { body: request };
+    if (options?.idempotencyKey !== void 0) {
+      requestOptions.idempotencyKey = options.idempotencyKey;
+    }
+    return await this.http.request("POST", "/v1/decide", requestOptions);
+  }
+  /**
+   * Convenience wrapper around decideRaw().
+   * Returns null if status is no_fill, otherwise returns the first ad unit.
+   */
+  async decide(request, options) {
+    const response = await this.decideRaw(request, options);
+    if (response.status === "no_fill") {
+      return null;
+    }
+    return response.units[0] ?? null;
+  }
+  /**
+   * Report an event (impression, click, action, conversion, feedback).
+   */
+  async track(event) {
+    return await this.http.request("POST", "/v1/event", {
+      body: event
+    });
+  }
+  /**
+   * Convenience method to track an impression event.
+   * Creates an impression event using createImpressionEvent() and calls track().
+   */
+  async trackImpression(params) {
+    const event = createImpressionEvent(params);
+    return await this.track(event);
+  }
+  /**
+   * Convenience method to track a click event.
+   * Creates a click event using createClickEvent() and calls track().
+   */
+  async trackClick(params) {
+    const event = createClickEvent(params);
+    return await this.track(event);
+  }
+  /**
+   * Fetch default policy constraints and formatting requirements.
+   */
+  async getPolicy() {
+    return await this.http.request("GET", "/v1/policy");
+  }
+  /**
+   * Create or register an agent (optional helper).
+   * Note: This endpoint is unauthenticated in v1.
+   */
+  static async signupAgent(request, options) {
+    const http = new HTTPClient({
+      baseUrl: options?.baseUrl ?? DEFAULT_BASE_URL,
+      timeoutMs: DEFAULT_TIMEOUT_MS,
+      maxRetries: DEFAULT_MAX_RETRIES
+    });
+    return await http.request("POST", "/v1/agent/signup", {
+      body: request
+    });
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  APIRequestError,
+  AttentionMarketClient,
+  AttentionMarketError,
+  NetworkError,
+  TimeoutError,
+  createClickEvent,
+  createImpressionEvent,
+  createOpportunity,
+  generateTimestamp,
+  generateUUID
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/http.ts","../src/utils.ts","../src/client.ts"],"sourcesContent":["/**\n * AttentionMarket Agent Ads SDK\n * TypeScript SDK for integrating agent-native sponsored units\n */\n\n// Main client\nexport { AttentionMarketClient } from './client.js';\n\n// Types\nexport type {\n  // Configuration\n  SDKConfig,\n  // Agent Signup\n  AgentSignupRequest,\n  AgentSignupResponse,\n  // Decide\n  DecideRequest,\n  DecideResponse,\n  // Placement\n  PlacementType,\n  Placement,\n  // Opportunity\n  Opportunity,\n  Intent,\n  Context,\n  Constraints,\n  Privacy,\n  // Ad Units\n  AdUnit,\n  Disclosure,\n  Tracking,\n  SponsoredSuggestion,\n  SponsoredTool,\n  ToolCall,\n  // Events\n  EventType,\n  EventIngestRequest,\n  EventIngestResponse,\n  // Policy\n  PolicyResponse,\n  // Errors\n  APIError,\n} from './types.js';\n\n// Errors\nexport {\n  AttentionMarketError,\n  APIRequestError,\n  NetworkError,\n  TimeoutError,\n} from './errors.js';\n\n// Utilities\nexport {\n  generateUUID,\n  generateTimestamp,\n  createOpportunity,\n  createImpressionEvent,\n  createClickEvent,\n} from './utils.js';\n\nexport type {\n  CreateOpportunityParams,\n  CreateImpressionEventParams,\n  CreateClickEventParams,\n} from './utils.js';\n","/**\n * Error classes for AttentionMarket SDK.\n * Surfaces HTTP status, API error codes, messages, and request_id.\n */\n\nimport type { APIError } from './types.js';\n\nexport class AttentionMarketError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'AttentionMarketError';\n    Object.setPrototypeOf(this, AttentionMarketError.prototype);\n  }\n}\n\nexport class APIRequestError extends AttentionMarketError {\n  public readonly statusCode: number;\n  public readonly errorCode: string;\n  public readonly requestId?: string;\n  public readonly details?: Record<string, unknown>;\n\n  constructor(\n    statusCode: number,\n    apiError: APIError,\n  ) {\n    super(apiError.message);\n    this.name = 'APIRequestError';\n    this.statusCode = statusCode;\n    this.errorCode = apiError.error;\n    if (apiError.request_id !== undefined) {\n      this.requestId = apiError.request_id;\n    }\n    if (apiError.details !== undefined) {\n      this.details = apiError.details;\n    }\n    Object.setPrototypeOf(this, APIRequestError.prototype);\n  }\n}\n\nexport class NetworkError extends AttentionMarketError {\n  public readonly cause?: Error;\n\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = 'NetworkError';\n    if (cause !== undefined) {\n      this.cause = cause;\n    }\n    Object.setPrototypeOf(this, NetworkError.prototype);\n  }\n}\n\nexport class TimeoutError extends AttentionMarketError {\n  constructor(message: string = 'Request timed out') {\n    super(message);\n    this.name = 'TimeoutError';\n    Object.setPrototypeOf(this, TimeoutError.prototype);\n  }\n}\n","/**\n * HTTP client with retry logic, timeout handling, and authentication.\n * Retry policy: only on 408, 429, 500, 502, 503, 504\n * Max retries: 2 (configurable)\n * Backoff: exponential with jitter\n */\n\nimport { APIRequestError, NetworkError, TimeoutError } from './errors.js';\nimport type { APIError } from './types.js';\n\nexport interface HTTPClientConfig {\n  apiKey?: string;\n  baseUrl: string;\n  timeoutMs: number;\n  maxRetries: number;\n}\n\nconst RETRYABLE_STATUS_CODES = new Set([408, 429, 500, 502, 503, 504]);\n\nexport class HTTPClient {\n  constructor(private config: HTTPClientConfig) {}\n\n  async request<T>(\n    method: 'GET' | 'POST',\n    path: string,\n    options: {\n      body?: unknown;\n      headers?: Record<string, string>;\n      idempotencyKey?: string;\n    } = {},\n  ): Promise<T> {\n    const url = `${this.config.baseUrl}${path}`;\n    let lastError: Error | undefined;\n\n    for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {\n      try {\n        const response = await this.makeRequest(url, method, options);\n        return response as T;\n      } catch (error) {\n        lastError = error as Error;\n\n        // Don't retry if it's not a retryable error\n        if (!this.shouldRetry(error, attempt)) {\n          throw error;\n        }\n\n        // Wait before retrying\n        if (attempt < this.config.maxRetries) {\n          await this.backoff(attempt);\n        }\n      }\n    }\n\n    // All retries exhausted\n    throw lastError;\n  }\n\n  private async makeRequest(\n    url: string,\n    method: 'GET' | 'POST',\n    options: {\n      body?: unknown;\n      headers?: Record<string, string>;\n      idempotencyKey?: string;\n    },\n  ): Promise<unknown> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.config.timeoutMs);\n\n    try {\n      const headers: Record<string, string> = {\n        'Content-Type': 'application/json',\n        ...options.headers,\n      };\n\n      if (this.config.apiKey) {\n        headers['Authorization'] = `Bearer ${this.config.apiKey}`;\n      }\n\n      if (options.idempotencyKey) {\n        headers['Idempotency-Key'] = options.idempotencyKey;\n      }\n\n      const response = await fetch(url, {\n        method,\n        headers,\n        body: options.body ? JSON.stringify(options.body) : undefined,\n        signal: controller.signal,\n      });\n\n      clearTimeout(timeoutId);\n\n      // Handle non-OK responses\n      if (!response.ok) {\n        const errorBody = await response.json().catch(() => ({\n          error: 'unknown_error',\n          message: 'Failed to parse error response',\n          request_id: 'unknown',\n        }));\n\n        throw new APIRequestError(response.status, errorBody as APIError);\n      }\n\n      // Parse successful response\n      return await response.json();\n    } catch (error) {\n      clearTimeout(timeoutId);\n\n      // Handle abort (timeout)\n      if (error instanceof Error && error.name === 'AbortError') {\n        throw new TimeoutError();\n      }\n\n      // Re-throw API errors\n      if (error instanceof APIRequestError) {\n        throw error;\n      }\n\n      // Network errors\n      throw new NetworkError('Network request failed', error as Error);\n    }\n  }\n\n  private shouldRetry(error: unknown, attempt: number): boolean {\n    // Don't retry if we've exhausted attempts\n    if (attempt >= this.config.maxRetries) {\n      return false;\n    }\n\n    // Retry on timeout\n    if (error instanceof TimeoutError) {\n      return true;\n    }\n\n    // Retry on network errors\n    if (error instanceof NetworkError) {\n      return true;\n    }\n\n    // Retry on specific HTTP status codes\n    if (error instanceof APIRequestError) {\n      return RETRYABLE_STATUS_CODES.has(error.statusCode);\n    }\n\n    return false;\n  }\n\n  private async backoff(attempt: number): Promise<void> {\n    // Exponential backoff: 100ms * 2^attempt + jitter\n    const baseDelay = 100 * Math.pow(2, attempt);\n    const jitter = Math.random() * 100;\n    const delay = baseDelay + jitter;\n\n    await new Promise((resolve) => setTimeout(resolve, delay));\n  }\n}\n","/**\n * Utility functions for the AttentionMarket SDK.\n * Includes UUID generation, opportunity helpers, and event builders.\n */\n\nimport { randomUUID } from 'node:crypto';\nimport type { EventIngestRequest, Opportunity } from './types.js';\n\n/**\n * Generate a UUID v4 for use as event_id, request_id, etc.\n */\nexport function generateUUID(): string {\n  return randomUUID();\n}\n\n/**\n * Generate an ISO 8601 timestamp for the current moment.\n */\nexport function generateTimestamp(): string {\n  return new Date().toISOString();\n}\n\n// ============================================================================\n// Opportunity Helper\n// ============================================================================\n\nexport interface CreateOpportunityParams {\n  // Required\n  taxonomy: string;\n  country: string;\n  language: string;\n  platform: 'web' | 'ios' | 'android' | 'desktop' | 'voice' | 'other';\n\n  // Optional\n  query?: string;\n  region?: string;\n  city?: string;\n\n  // Optional overrides (with defaults)\n  constraints?: {\n    max_units?: number;\n    allowed_unit_types?: ('sponsored_suggestion' | 'sponsored_block' | 'sponsored_tool')[];\n    blocked_categories?: string[];\n    max_title_chars?: number;\n    max_body_chars?: number;\n  };\n  privacy?: {\n    data_policy?: 'coarse_only' | 'none' | 'extended';\n  };\n}\n\n/**\n * Create a valid Opportunity object with safe defaults.\n *\n * Defaults:\n * - constraints.max_units = 1\n * - constraints.allowed_unit_types = ['sponsored_suggestion']\n * - privacy.data_policy = 'coarse_only'\n */\nexport function createOpportunity(params: CreateOpportunityParams): Opportunity {\n  const opportunity: Opportunity = {\n    intent: {\n      taxonomy: params.taxonomy,\n    },\n    context: {\n      country: params.country,\n      language: params.language,\n      platform: params.platform,\n    },\n    constraints: {\n      max_units: params.constraints?.max_units ?? 1,\n      allowed_unit_types: params.constraints?.allowed_unit_types ?? ['sponsored_suggestion'],\n    },\n    privacy: {\n      data_policy: params.privacy?.data_policy ?? 'coarse_only',\n    },\n  };\n\n  // Add optional intent fields\n  if (params.query !== undefined) {\n    opportunity.intent.query = params.query;\n  }\n\n  // Add optional context fields\n  if (params.region !== undefined) {\n    opportunity.context.region = params.region;\n  }\n  if (params.city !== undefined) {\n    opportunity.context.city = params.city;\n  }\n\n  // Add optional constraint fields\n  if (params.constraints?.blocked_categories !== undefined) {\n    opportunity.constraints.blocked_categories = params.constraints.blocked_categories;\n  }\n  if (params.constraints?.max_title_chars !== undefined) {\n    opportunity.constraints.max_title_chars = params.constraints.max_title_chars;\n  }\n  if (params.constraints?.max_body_chars !== undefined) {\n    opportunity.constraints.max_body_chars = params.constraints.max_body_chars;\n  }\n\n  return opportunity;\n}\n\n// ============================================================================\n// Event Helpers\n// ============================================================================\n\nexport interface CreateImpressionEventParams {\n  agent_id: string;\n  request_id: string;\n  decision_id: string;\n  unit_id: string;\n  tracking_token: string;\n  occurred_at?: string;\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Helper to create an impression event payload.\n *\n * @param params - Event parameters (snake_case to match API)\n * @returns EventIngestRequest ready to pass to client.track()\n */\nexport function createImpressionEvent(params: CreateImpressionEventParams): EventIngestRequest {\n  const event: EventIngestRequest = {\n    event_id: generateUUID(),\n    occurred_at: params.occurred_at ?? generateTimestamp(),\n    agent_id: params.agent_id,\n    request_id: params.request_id,\n    decision_id: params.decision_id,\n    unit_id: params.unit_id,\n    event_type: 'impression',\n    tracking_token: params.tracking_token,\n  };\n\n  if (params.metadata !== undefined) {\n    event.metadata = params.metadata;\n  }\n\n  return event;\n}\n\nexport interface CreateClickEventParams {\n  agent_id: string;\n  request_id: string;\n  decision_id: string;\n  unit_id: string;\n  tracking_token: string;\n  href: string;\n  occurred_at?: string;\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Helper to create a click event payload.\n *\n * @param params - Event parameters (snake_case to match API)\n * @returns EventIngestRequest ready to pass to client.track()\n */\nexport function createClickEvent(params: CreateClickEventParams): EventIngestRequest {\n  const event: EventIngestRequest = {\n    event_id: generateUUID(),\n    occurred_at: params.occurred_at ?? generateTimestamp(),\n    agent_id: params.agent_id,\n    request_id: params.request_id,\n    decision_id: params.decision_id,\n    unit_id: params.unit_id,\n    event_type: 'click',\n    tracking_token: params.tracking_token,\n  };\n\n  // Include href in metadata\n  if (params.metadata !== undefined) {\n    event.metadata = {\n      ...params.metadata,\n      href: params.href,\n    };\n  } else {\n    event.metadata = {\n      href: params.href,\n    };\n  }\n\n  return event;\n}\n","/**\n * Main SDK client for AttentionMarket Agent Ads API.\n * Provides public methods: decide(), decideRaw(), track(), getPolicy(), signupAgent()\n */\n\nimport { HTTPClient } from './http.js';\nimport { createImpressionEvent, createClickEvent } from './utils.js';\nimport type {\n  SDKConfig,\n  DecideRequest,\n  DecideResponse,\n  EventIngestRequest,\n  EventIngestResponse,\n  PolicyResponse,\n  AgentSignupRequest,\n  AgentSignupResponse,\n  AdUnit,\n} from './types.js';\nimport type { CreateImpressionEventParams, CreateClickEventParams } from './utils.js';\n\nconst DEFAULT_BASE_URL = 'https://api.attentionmarket.ai';\nconst DEFAULT_TIMEOUT_MS = 4000;\nconst DEFAULT_MAX_RETRIES = 2;\n\nexport class AttentionMarketClient {\n  private http: HTTPClient;\n\n  constructor(config: SDKConfig) {\n    this.http = new HTTPClient({\n      apiKey: config.apiKey,\n      baseUrl: config.baseUrl ?? DEFAULT_BASE_URL,\n      timeoutMs: config.timeoutMs ?? DEFAULT_TIMEOUT_MS,\n      maxRetries: config.maxRetries ?? DEFAULT_MAX_RETRIES,\n    });\n  }\n\n  /**\n   * Request a sponsored unit decision for an agent opportunity.\n   * Returns the full DecideResponse including status, ttl_ms, and all units.\n   */\n  async decideRaw(\n    request: DecideRequest,\n    options?: { idempotencyKey?: string },\n  ): Promise<DecideResponse> {\n    const requestOptions: {\n      body: DecideRequest;\n      idempotencyKey?: string;\n    } = { body: request };\n\n    if (options?.idempotencyKey !== undefined) {\n      requestOptions.idempotencyKey = options.idempotencyKey;\n    }\n\n    return await this.http.request<DecideResponse>('POST', '/v1/decide', requestOptions);\n  }\n\n  /**\n   * Convenience wrapper around decideRaw().\n   * Returns null if status is no_fill, otherwise returns the first ad unit.\n   */\n  async decide(\n    request: DecideRequest,\n    options?: { idempotencyKey?: string },\n  ): Promise<AdUnit | null> {\n    const response = await this.decideRaw(request, options);\n\n    if (response.status === 'no_fill') {\n      return null;\n    }\n\n    // Return first unit if available\n    return response.units[0] ?? null;\n  }\n\n  /**\n   * Report an event (impression, click, action, conversion, feedback).\n   */\n  async track(event: EventIngestRequest): Promise<EventIngestResponse> {\n    return await this.http.request<EventIngestResponse>('POST', '/v1/event', {\n      body: event,\n    });\n  }\n\n  /**\n   * Convenience method to track an impression event.\n   * Creates an impression event using createImpressionEvent() and calls track().\n   */\n  async trackImpression(\n    params: Omit<CreateImpressionEventParams, 'occurred_at'> & { occurred_at?: string },\n  ): Promise<EventIngestResponse> {\n    const event = createImpressionEvent(params);\n    return await this.track(event);\n  }\n\n  /**\n   * Convenience method to track a click event.\n   * Creates a click event using createClickEvent() and calls track().\n   */\n  async trackClick(\n    params: Omit<CreateClickEventParams, 'occurred_at'> & { occurred_at?: string },\n  ): Promise<EventIngestResponse> {\n    const event = createClickEvent(params);\n    return await this.track(event);\n  }\n\n  /**\n   * Fetch default policy constraints and formatting requirements.\n   */\n  async getPolicy(): Promise<PolicyResponse> {\n    return await this.http.request<PolicyResponse>('GET', '/v1/policy');\n  }\n\n  /**\n   * Create or register an agent (optional helper).\n   * Note: This endpoint is unauthenticated in v1.\n   */\n  static async signupAgent(\n    request: AgentSignupRequest,\n    options?: { baseUrl?: string },\n  ): Promise<AgentSignupResponse> {\n    // Create temporary HTTP client without authentication\n    const http = new HTTPClient({\n      baseUrl: options?.baseUrl ?? DEFAULT_BASE_URL,\n      timeoutMs: DEFAULT_TIMEOUT_MS,\n      maxRetries: DEFAULT_MAX_RETRIES,\n    });\n\n    return await http.request<AgentSignupResponse>('POST', '/v1/agent/signup', {\n      body: request,\n    });\n  }\n}\n"],"mappings":"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","names":[]}