adserver-dashboard 1.0.0

package/client/src/lib/influence-deals-api.ts

@@ -0,0 +1,896 @@
+// Influence Deals API Client
+// Manages deals, line items, creatives, and inventories
+
+import { directCampaignAuth } from "./auth-service";
+
+// ============================================================================
+// CUSTOM API ERROR CLASS
+// ============================================================================
+
+export interface APIValidationError {
+  field: string;
+  message: string;
+}
+
+export interface APIErrorResponse {
+  code?: string;
+  message?: string;
+  errors?: APIValidationError[];
+}
+
+export class APIError extends Error {
+  public readonly code: string;
+  public readonly errors: APIValidationError[];
+  public readonly statusCode: number;
+
+  constructor(
+    message: string,
+    code: string = "UNKNOWN_ERROR",
+    errors: APIValidationError[] = [],
+    statusCode: number = 500,
+  ) {
+    super(message);
+    this.name = "APIError";
+    this.code = code;
+    this.errors = errors;
+    this.statusCode = statusCode;
+  }
+
+  isValidationError(): boolean {
+    return this.code === "VALIDATION_ERROR" && this.errors.length > 0;
+  }
+}
+
+/**
+ * Format API error for display in toast messages
+ * Shows validation errors if available, otherwise shows generic message
+ */
+export function formatAPIErrorForToast(error: unknown): string {
+  if (error instanceof APIError) {
+    if (error.isValidationError() && error.errors.length > 0) {
+      return error.errors.map((e) => `${e.field}: ${e.message}`).join("\n");
+    }
+    return error.message;
+  }
+
+  if (error && typeof error === "object") {
+    const err = error as any;
+    if (err.errors && Array.isArray(err.errors) && err.errors.length > 0) {
+      return err.errors
+        .map((e: APIValidationError) => `${e.field}: ${e.message}`)
+        .join("\n");
+    }
+    if (err.message) {
+      return err.message;
+    }
+  }
+
+  if (error instanceof Error) {
+    return error.message;
+  }
+
+  return "An unexpected error occurred. Please try again.";
+}
+
+// API endpoint from environment variable
+const INFLUENCE_DEALS_BASE_URL = import.meta.env.VITE_INFLUENCE_DEALS_API_URL;
+
+// Public Approval API base URL (no auth required)
+// Uses the same external API server as authenticated endpoints
+const PUBLIC_APPROVAL_BASE_URL = (() => {
+  if (INFLUENCE_DEALS_BASE_URL) {
+    try {
+      const url = new URL(INFLUENCE_DEALS_BASE_URL);
+      return `${url.origin}/api/v1/public/approval`;
+    } catch {
+      const baseUrl = INFLUENCE_DEALS_BASE_URL.replace(/\/api\/v1\/rest$/, '');
+      return `${baseUrl}/api/v1/public/approval`;
+    }
+  }
+  console.warn('[Public Approval API] VITE_INFLUENCE_DEALS_API_URL is not set. Public approval endpoints may not work.');
+  return '/api/v1/public/approval';
+})();
+
+// Helper function to construct public approval URLs
+function buildPublicApprovalUrl(path: string, params?: Record<string, any>): string {
+  const url = `${PUBLIC_APPROVAL_BASE_URL}${path}`;
+  if (!params) return url;
+
+  const searchParams = new URLSearchParams();
+  Object.entries(params).forEach(([key, value]) => {
+    if (value !== undefined && value !== null) {
+      searchParams.set(key, String(value));
+    }
+  });
+
+  const query = searchParams.toString();
+  return query ? `${url}?${query}` : url;
+}
+
+// Helper function to construct URLs
+function buildUrl(path: string, params?: Record<string, any>): string {
+  const url = `${INFLUENCE_DEALS_BASE_URL}${path}`;
+  if (!params) return url;
+
+  const searchParams = new URLSearchParams();
+  Object.entries(params).forEach(([key, value]) => {
+    if (value !== undefined && value !== null) {
+      searchParams.set(key, String(value));
+    }
+  });
+
+  const query = searchParams.toString();
+  return query ? `${url}?${query}` : url;
+}
+
+// Generate a unique external ID for deals and line items
+export function generateExternalId(): string {
+  return `ext-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+}
+
+// Editable deal statuses - only these statuses allow editing deals and line items
+const EDITABLE_DEAL_STATUSES = ['DRAFT', 'GENERATED', 'REOPENED'];
+
+/**
+ * Check if a deal status allows editing operations (edit deal, edit/clone/delete line items)
+ * Only DRAFT, GENERATED, and REOPENED statuses are editable
+ */
+export function isDealEditable(status: string | undefined | null): boolean {
+  if (!status) return false;
+  return EDITABLE_DEAL_STATUSES.includes(status.toUpperCase());
+}
+
+// ============================================================================
+// TYPE DEFINITIONS
+// ============================================================================
+
+export interface DealSeller {
+  publisher_id: string;
+  publisher_name: string;
+}
+
+export interface DealAccount {
+  account_id: string;
+  account_name: string;
+}
+
+export interface DealBuyer {
+  dsp: string;
+  seatId: string;
+  buyerName: string;
+}
+
+export interface DealProgrammatic {
+  buyers: DealBuyer[];
+  auctionType: number;
+  transactionType: string;
+  costType: string;
+  published: boolean;
+  reopened: boolean;
+  nonBillable: boolean;
+  stopBidRequests: boolean;
+}
+
+export interface DealBudgetSetup {
+  budgetAmount?: number;
+  budgetType?: string;
+}
+
+export interface DealDirect {
+  budgetSetup?: DealBudgetSetup;
+  approvalEmails?: string[];
+}
+
+export interface Deal {
+  id: string;
+  source: string;
+  externalId: string;
+  dealId: string;
+  name: string;
+  dealType:
+    | "GUARANTEED"
+    | "PREFERRED_DEAL"
+    | "PRIVATE_AUCTION"
+    | "EVERGREEN_PMP";
+  advertiser: string | null;
+  seller: DealSeller;
+  currency: string;
+  timezoneId: string | null;
+  startDate: string | null;
+  endDate: string | null;
+  account: DealAccount;
+  country: string;
+  status: "DRAFT" | "LIVE" | "PAUSED" | "COMPLETED" | "ARCHIVED" | "APPROVED" | "REJECTED" | "PENDING" | "REVIEWING" | "REOPENED" | "EXPIRED" | "REQUESTED" | "GENERATED" | "ACTIVE";
+  active: boolean;
+  isPlaying: boolean;
+  publishers: { id: string; name: string }[];
+  metadata: any;
+  version: number;
+  mode: string | null;
+  createdAt: string;
+  updatedAt: string;
+  programmatic: DealProgrammatic;
+  direct?: DealDirect;
+  // Additional fields for campaign wizard
+  brand?: string;
+  clientType?: string;
+  approvalEmails?: string[];
+  targetCountry?: string;
+  totalBudget?: number;
+  dailyBudgetCap?: number;
+}
+
+export interface LineItemBudgetSetup {
+  currency?: string;
+  budgetType?: string;
+  budgetAmount?: number;
+}
+
+export interface LineItemCampaignGoal {
+  type?: string;
+  targetValue?: number;
+}
+
+export interface LineItemDirect {
+  budgetSetup?: LineItemBudgetSetup;
+  campaignGoal?: LineItemCampaignGoal;
+  pricing?: {
+    cpmBase?: number;
+    estimatedCostBase?: number;
+  };
+}
+
+export interface LineItemProgrammatic {
+  bidFloor?: number;
+  bidFloorBase?: number;
+  netCost?: number;
+  impressions?: number;
+  impMultiplier?: number;
+}
+
+export interface ProgrammaticLineItem {
+  name: string;
+  startDate: string;
+  endDate: string;
+  status: string;
+  inventories: LineItemInventory[];
+  programmatic: LineItemProgrammatic;
+  targeting?: any;
+}
+
+export interface DirectLineItem {
+  name: string;
+  startDate: string;
+  endDate: string;
+  status: string;
+  inventories: LineItemInventory[];
+  targetQuantity?: number;
+  budget?: number;
+  pacing?: any;
+  direct?: LineItemDirect;
+  deliveryTargeting?: any;
+  planning?: any;
+  pricing?: {
+    cpmBase?: number;
+    estimatedCostBase?: number;
+  };
+}
+
+export interface LineItem {
+  id: string;
+  name: string;
+  goalType: "IMPRESSIONS" | "BUDGET" | "UNLIMITED";
+  targetQuantity: number;
+  budget: number;
+  pacing: "EVEN" | "ASAP" | "CUSTOM";
+  startDate: string;
+  totalInventories: number;
+  endDate: string;
+  status: "DRAFT" | "ACTIVE" | "PAUSED" | "COMPLETED";
+  inventories: LineItemInventory[];
+  scheduleGrids?: ScheduleGrid[];
+  direct?: LineItemDirect;
+  programmatic?: LineItemProgrammatic;
+  createdAt?: string;
+  updatedAt?: string;
+  dealId?: string;
+  pricing?: {
+    cpmBase?: number;
+    estimatedCostBase?: number;
+  };
+}
+
+export interface LineItemInventory {
+  id: string;
+  inventoryId: string;
+  name: string;
+  type: "SCREEN" | "NETWORK" | "PACKAGE";
+  address?: string;
+  tags?: string[];
+  screenCount?: number;
+  pricePerDay?: number;
+}
+
+export interface ScheduleGrid {
+  date: string;
+  hours: number[]; // 0-23 representing active hours
+}
+
+export interface Creative {
+  id: string;
+  name: string;
+  type: "IMAGE" | "VIDEO";
+  mimeType: string;
+  size: number;
+  resolution: string;
+  duration?: number;
+  url: string;
+  thumbnailUrl?: string;
+  status: "PROCESSING" | "ACCEPTED" | "REJECTED" | "INADEQUATE";
+  tags?: string[];
+  uploadedBy?: string;
+  lineItemIds?: string[]; // Creatives can be assigned to multiple line items
+  createdAt?: string;
+  updatedAt?: string;
+}
+
+export interface DealListResponse {
+  requestId: string;
+  status: number;
+  result: {
+    data: Deal[];
+    pagination: {
+      page: number;
+      limit: number;
+      total: number;
+      totalPages: number;
+    };
+  };
+}
+
+export interface DealResponse {
+  requestId: string;
+  status: number;
+  result: Deal;
+}
+
+// ============================================================================
+// API ENDPOINTS
+// ============================================================================
+
+export const InfluenceDealsAPI = {
+  // ============================================================================
+  // DEALS (Campaigns)
+  // ============================================================================
+  deals: {
+    // List deals with pagination and filters
+    list: (params?: {
+      page?: number;
+      limit?: number;
+      search?: string;
+      source?: string;
+      currency?: string;
+      brand?: string;
+      advertiser?: string;
+      publisher?: string;
+      publisherId?: string;
+      startDate?: string;
+      endDate?: string;
+      status?: string;
+    }) => buildUrl("/deals", params),
+
+    // Get single deal by ID
+    get: (dealId: string) => buildUrl(`/deals/${dealId}`),
+
+    // Create deal
+    create: () => `${INFLUENCE_DEALS_BASE_URL}/deals`,
+
+    // Update deal
+    update: (dealId: string) => `${INFLUENCE_DEALS_BASE_URL}/deals/${dealId}`,
+
+    // Archive deal
+    archive: (dealId: string) => `${INFLUENCE_DEALS_BASE_URL}/deals/${dealId}`,
+
+    // Bulk sync deals with line items, inventories, and creatives
+    sync: () => `${INFLUENCE_DEALS_BASE_URL}/deals/sync`,
+
+    // Get deal history/activity log
+    history: (
+      dealId: string,
+      params?: { page?: number; limit?: number; action?: string },
+    ) => buildUrl(`/deals/${dealId}/history`, params),
+
+    // Get deal-level inventories (minified format)
+    inventoriesMinified: (dealId: string) =>
+      buildUrl(`/deals/${dealId}/inventories/minified`),
+  },
+
+  // ============================================================================
+  // LINE ITEMS
+  // ============================================================================
+  lineItems: {
+    // List line items by deal
+    list: (dealId: string, params?: { page?: number; limit?: number }) =>
+      buildUrl(`/deals/${dealId}/line-items`, params),
+
+    // Get single line item
+    get: (dealId: string, lineItemId: string) =>
+      buildUrl(`/deals/${dealId}/line-items/${lineItemId}`),
+
+    // Create line item
+    create: (dealId: string) =>
+      `${INFLUENCE_DEALS_BASE_URL}/deals/${dealId}/line-items`,
+
+    // Update line item
+    update: (dealId: string, lineItemId: string) =>
+      `${INFLUENCE_DEALS_BASE_URL}/deals/${dealId}/line-items/${lineItemId}`,
+
+    // Delete line item
+    delete: (dealId: string, lineItemId: string) =>
+      `${INFLUENCE_DEALS_BASE_URL}/deals/${dealId}/line-items/${lineItemId}`,
+
+    // Get line item inventories with pagination
+    inventories: (
+      dealId: string,
+      lineItemId: string,
+      params?: { page?: number; limit?: number },
+    ) =>
+      buildUrl(`/deals/${dealId}/line-items/${lineItemId}/inventories`, params),
+
+    // Update line item inventories (separate endpoint from line item update)
+    updateInventories: (dealId: string, lineItemId: string) =>
+      `${INFLUENCE_DEALS_BASE_URL}/deals/${dealId}/line-items/${lineItemId}/inventories`,
+  },
+
+  // ============================================================================
+  // CREATIVES
+  // ============================================================================
+  creatives: {
+    // List creatives by deal
+    listByDeal: (dealId: string, params?: { page?: number; limit?: number }) =>
+      buildUrl(`/deals/${dealId}/creatives`, params),
+
+    // List creatives by line item
+    listByLineItem: (
+      dealId: string,
+      lineItemId: string,
+      params?: { page?: number; limit?: number },
+    ) =>
+      buildUrl(`/deals/${dealId}/line-items/${lineItemId}/creatives`, params),
+
+    // Create creative for line item
+    create: (dealId: string, lineItemId: string) =>
+      `${INFLUENCE_DEALS_BASE_URL}/deals/${dealId}/line-items/${lineItemId}/creatives`,
+
+    // Delete creative
+    delete: (dealId: string, lineItemId: string, creativeId: string) =>
+      `${INFLUENCE_DEALS_BASE_URL}/deals/${dealId}/line-items/${lineItemId}/creatives/${creativeId}`,
+  },
+
+  // ============================================================================
+  // SYSTEM
+  // ============================================================================
+  system: {
+    // Health check
+    health: () => `${INFLUENCE_DEALS_BASE_URL}/health`,
+  },
+
+  // ============================================================================
+  // CAMPAIGN APPROVAL (Internal - Authenticated)
+  // ============================================================================
+  approval: {
+    // Request campaign approval - sends emails to approvers
+    request: (dealId: string) =>
+      `${INFLUENCE_DEALS_BASE_URL}/deals/${dealId}/approval/request`,
+
+    // Get approval history for a deal
+    history: (dealId: string) =>
+      `${INFLUENCE_DEALS_BASE_URL}/deals/${dealId}/approval/history`,
+
+    // Resend approval email to selected approvers
+    resend: (dealId: string) =>
+      `${INFLUENCE_DEALS_BASE_URL}/deals/${dealId}/approval/resend`,
+  },
+
+  // ============================================================================
+  // DEAL REOPEN (DIRECT mode only)
+  // ============================================================================
+  reopen: {
+    // Reopen a DIRECT deal - allows further edits
+    // Allowed from: APPROVED, LIVE, COMPLETED, EXPIRED, REJECTED, ARCHIVED
+    reopen: (dealId: string) =>
+      `${INFLUENCE_DEALS_BASE_URL}/deals/${dealId}/reopen`,
+  },
+
+  // ============================================================================
+  // DEAL STATUS TRANSITIONS
+  // ============================================================================
+  status: {
+    // Transition a campaign to a new status with workflow-aware validation
+    // Guardrails: LIVE requires delivery confirmation, COMPLETED/EXPIRED by SCHEDULER only
+    transition: (dealId: string) =>
+      `${INFLUENCE_DEALS_BASE_URL}/deals/${dealId}/status`,
+    
+    // Get all campaign status definitions
+    definitions: (workflow?: 'DIRECT' | 'PROGRAMMATIC') =>
+      `${INFLUENCE_DEALS_BASE_URL}/deals/status/definitions${workflow ? `?workflow=${workflow}` : ''}`,
+  },
+
+  // ============================================================================
+  // PUBLIC APPROVAL (External - Token-based, no auth)
+  // ============================================================================
+  publicApproval: {
+    // Get campaign details for approval
+    campaign: (token: string) =>
+      buildPublicApprovalUrl('/campaign', { token }),
+
+    // Get line items for approval
+    lineItems: (token: string) =>
+      buildPublicApprovalUrl('/line-items', { token }),
+
+    // Get inventories for approval
+    inventories: (token: string, lineItemId?: string) =>
+      buildPublicApprovalUrl('/inventories', { token, ...(lineItemId && { lineItemId }) }),
+
+    // Request OTP verification
+    requestOtp: () => `${PUBLIC_APPROVAL_BASE_URL}/otp/request`,
+
+    // Verify OTP
+    verifyOtp: () => `${PUBLIC_APPROVAL_BASE_URL}/otp/verify`,
+
+    // Submit approval decision
+    decision: () => `${PUBLIC_APPROVAL_BASE_URL}/decision`,
+  },
+};
+
+// ============================================================================
+// RESPONSE HANDLERS
+// ============================================================================
+
+/**
+ * Helper function to handle API responses
+ * Throws APIError with validation errors preserved for toast display
+ */
+export async function handleInfluenceDealsResponse<T>(
+  response: Response,
+): Promise<T> {
+  const data = await response.json();
+
+  if (!response.ok) {
+    const errorMessage = data.message || data.error || "API request failed";
+    const errorCode = data.code || "UNKNOWN_ERROR";
+    const validationErrors: APIValidationError[] = data.errors || [];
+
+    throw new APIError(
+      errorMessage,
+      errorCode,
+      validationErrors,
+      response.status,
+    );
+  }
+
+  // Return the result from the wrapped response
+  return data.result || data;
+}
+
+/**
+ * Make an authenticated request to the Influence Deals API
+ */
+export async function influenceDealsRequest<T>(
+  url: string,
+  method: string = "GET",
+  body?: any,
+): Promise<T> {
+  const options: RequestInit = {
+    method,
+    headers: {
+      "Content-Type": "application/json",
+      Accept: "application/json",
+    },
+  };
+
+  if (body) {
+    options.body = JSON.stringify(body);
+  }
+
+  const response = await directCampaignAuth.fetch(url, options);
+  return handleInfluenceDealsResponse<T>(response);
+}
+
+// ============================================================================
+// DATA MAPPERS - Convert between old and new formats
+// ============================================================================
+
+/**
+ * Map old campaign format to new deal format
+ */
+export function mapCampaignToDeal(
+  campaign: any,
+  existingExternalId?: string,
+): Partial<Deal> & { externalId: string } {
+  return {
+    externalId:
+      existingExternalId || campaign.externalId || generateExternalId(),
+    name: campaign.name,
+    dealType: campaign.dealType || "GUARANTEED",
+    advertiser: campaign.brand,
+    currency: campaign.currency || "MYR",
+    startDate: campaign.startDate,
+    endDate: campaign.endDate,
+    country: campaign.targetCountry || campaign.country,
+    status: campaign.status || "DRAFT",
+    // Extended fields for wizard
+    brand: campaign.brand,
+    clientType: campaign.clientType,
+    approvalEmails: campaign.approvalEmails,
+    targetCountry: campaign.targetCountry,
+    totalBudget: campaign.totalBudget,
+    dailyBudgetCap: campaign.dailyBudgetCap,
+  };
+}
+
+/**
+ * Map deal format back to campaign format for compatibility
+ */
+export function mapDealToCampaign(deal: Deal): any {
+  return {
+    id: deal.id,
+    name: deal.name,
+    dealType: deal.dealType,
+    brand: deal.advertiser || deal.brand,
+    clientType: deal.clientType,
+    currency: deal.currency,
+    startDate: deal.startDate,
+    endDate: deal.endDate,
+    country: deal.country,
+    targetCountry: deal.targetCountry || deal.country,
+    status: deal.status,
+    approvalEmails: deal.approvalEmails,
+    totalBudget: deal.totalBudget,
+    dailyBudgetCap: deal.dailyBudgetCap,
+    createdAt: deal.createdAt,
+    updatedAt: deal.updatedAt,
+  };
+}
+
+/**
+ * Build PROGRAMMATIC line item payload
+ * Programmatic deals only support basic targeting, bidFloor, netCost, impressions, and impMultiplier
+ * No deliveryTargeting or planning data for programmatic
+ */
+export function buildProgrammaticLineItemPayload(
+  lineItem: any,
+  dealType: string,
+): ProgrammaticLineItem {
+  const payload: any = {
+    name: lineItem.name,
+    startDate: lineItem.startDate,
+    endDate: lineItem.endDate,
+    status: lineItem.status || "DRAFT",
+    inventories: lineItem.inventories || [],
+    programmatic: lineItem.programmatic || {
+      bidFloor: 0,
+      netCost: 0,
+      impressions: 0,
+      impMultiplier: { type: "ALL_TIME" },
+    },
+    targeting: lineItem.targeting,
+  };
+
+  if (lineItem.priority !== undefined) payload.priority = lineItem.priority;
+  if (lineItem.creativeType) payload.creativeType = lineItem.creativeType;
+  if (lineItem.duration !== undefined) payload.duration = lineItem.duration;
+  if (lineItem.creativeSource) payload.creativeSource = lineItem.creativeSource;
+  if (lineItem.timezoneId) payload.timezoneId = lineItem.timezoneId;
+  if (lineItem.publisherId) payload.publisherId = lineItem.publisherId;
+  if (lineItem.currency) payload.currency = lineItem.currency;
+  if (lineItem.resolutions?.length) payload.resolutions = lineItem.resolutions;
+  if (lineItem.schedule?.length) payload.schedule = lineItem.schedule;
+  if (lineItem.pacing) payload.pacing = lineItem.pacing;
+  if (lineItem.bidFloor !== undefined) payload.bidFloor = lineItem.bidFloor;
+  if (lineItem.bidFloorBase !== undefined) payload.bidFloorBase = lineItem.bidFloorBase;
+  if (lineItem.netCost !== undefined) payload.netCost = lineItem.netCost;
+  if (lineItem.impressions !== undefined) payload.impressions = lineItem.impressions;
+
+  if (lineItem.customFees?.length) payload.customFees = lineItem.customFees;
+  if (lineItem.frequencyCap) payload.frequencyCap = lineItem.frequencyCap;
+  if (lineItem.trafficAllocation !== undefined) payload.trafficAllocation = lineItem.trafficAllocation;
+  if (lineItem.inventorySource) payload.inventorySource = lineItem.inventorySource;
+
+  if (dealType === "GUARANTEED" && lineItem.thresholdCountPerDay) {
+    payload.thresholdCountPerDay = lineItem.thresholdCountPerDay;
+  }
+  
+  return payload;
+}
+
+/**
+ * Build DIRECT line item payload
+ * Direct deals support full targeting, deliveryTargeting, planning, budgetSetup, campaignGoal, and pacing
+ */
+export function buildDirectLineItemPayload(
+  lineItem: any,
+): DirectLineItem {
+  const payload: any = {
+    name: lineItem.name,
+    startDate: lineItem.startDate,
+    endDate: lineItem.endDate,
+    status: lineItem.status || "DRAFT",
+    inventories: lineItem.inventories || [],
+    targetQuantity: lineItem.targetQuantity || lineItem.impressionsGoal,
+    budget: lineItem.budget,
+    pacing: lineItem.pacing,
+    direct: lineItem.direct,
+    deliveryTargeting: lineItem.deliveryTargeting,
+    planning: lineItem.planning,
+  };
+
+  if (lineItem.priority !== undefined) payload.priority = lineItem.priority;
+  if (lineItem.creativeType) payload.creativeType = lineItem.creativeType;
+  if (lineItem.duration !== undefined) payload.duration = lineItem.duration;
+  if (lineItem.creativeSource) payload.creativeSource = lineItem.creativeSource;
+  if (lineItem.timezoneId) payload.timezoneId = lineItem.timezoneId;
+  if (lineItem.publisherId) payload.publisherId = lineItem.publisherId;
+  if (lineItem.currency) payload.currency = lineItem.currency;
+  if (lineItem.resolutions?.length) payload.resolutions = lineItem.resolutions;
+  if (lineItem.schedule?.length) payload.schedule = lineItem.schedule;
+  if (lineItem.customFees?.length) payload.customFees = lineItem.customFees;
+  if (lineItem.frequencyCap) payload.frequencyCap = lineItem.frequencyCap;
+  if (lineItem.trafficAllocation !== undefined) payload.trafficAllocation = lineItem.trafficAllocation;
+  if (lineItem.inventorySource) payload.inventorySource = lineItem.inventorySource;
+
+  return payload;
+}
+
+/**
+ * Map line item with embedded inventories and schedule
+ * Supports both DIRECT and PROGRAMMATIC deal modes
+ * @param lineItem The line item data
+ * @param mode The deal mode (DIRECT or PROGRAMMATIC)
+ * @param dealType The deal type (for PROGRAMMATIC: GUARANTEED, PRIVATE_AUCTION, EVERGREEN_PMP, PREFERRED_DEAL)
+ */
+export function mapLineItemForAPI(
+  lineItem: any,
+  mode?: string,
+  dealType?: string,
+): ProgrammaticLineItem | DirectLineItem | Partial<LineItem> {
+  // If mode is provided, use the appropriate builder
+  if (mode) {
+    const upperMode = mode.toUpperCase();
+    if (upperMode === "PROGRAMMATIC") {
+      return buildProgrammaticLineItemPayload(lineItem, dealType || "GUARANTEED");
+    } else if (upperMode === "DIRECT") {
+      return buildDirectLineItemPayload(lineItem);
+    }
+  }
+
+  // Fallback to original behavior for backward compatibility
+  return {
+    name: lineItem.name,
+    targetQuantity: lineItem.targetQuantity || lineItem.impressionsGoal,
+    budget: lineItem.budget,
+    pacing: lineItem.pacing,
+    startDate: lineItem.startDate,
+    endDate: lineItem.endDate,
+    status: lineItem.status || "DRAFT",
+    inventories: lineItem.inventories || [],
+  };
+}
+
+/**
+ * Parse latitude and longitude from POINT geometry string
+ * Format: "POINT(longitude latitude)"
+ */
+function parsePointGeometry(geom: string): { latitude: number; longitude: number } | null {
+  if (!geom || typeof geom !== 'string') return null;
+  const match = geom.match(/POINT\(([-\d.]+)\s+([-\d.]+)\)/i);
+  if (match) {
+    return {
+      longitude: parseFloat(match[1]),
+      latitude: parseFloat(match[2]),
+    };
+  }
+  return null;
+}
+
+/**
+ * Map inventory data from JAD API format to Influence Deals API format
+ * Includes all relevant fields for the inventory update payload
+ */
+export function mapInventoryForAPI(inv: any): Record<string, any> {
+  const inventory: Record<string, any> = {
+    id: inv.id || inv.inventoryId,
+  };
+
+  if (inv.name) {
+    inventory.name = inv.name;
+  }
+
+  if (inv.timeZone) {
+    inventory.timezone = inv.timeZone;
+  }
+
+  if (inv.thumbnailUrl) {
+    inventory.thumbnail = inv.thumbnailUrl;
+  }
+
+  if (inv.typeName) {
+    inventory.venueType = inv.typeName;
+  } else if (inv.environment) {
+    inventory.venueType = inv.environment.toUpperCase();
+  }
+
+  if (inv.mediaOwnerId || inv.mediaOwnerName) {
+    inventory.publisher = {
+      id: inv.mediaOwnerId,
+      name: inv.mediaOwnerName,
+    };
+  }
+
+  if (inv.geoms && Array.isArray(inv.geoms) && inv.geoms.length > 0) {
+    const coords = parsePointGeometry(inv.geoms[0]);
+    if (coords) {
+      inventory.latitude = coords.latitude;
+      inventory.longitude = coords.longitude;
+    }
+  }
+
+  if (inv.panels && Array.isArray(inv.panels) && inv.panels.length > 0) {
+    const panel = inv.panels[0];
+    if (panel.pixelWidth && panel.pixelHeight) {
+      inventory.size = `${panel.pixelWidth}x${panel.pixelHeight}`;
+    }
+  }
+
+  if (inv.digitalFields) {
+    if (inv.digitalFields.spotDuration) {
+      inventory.spotDuration = inv.digitalFields.spotDuration;
+    }
+    if (inv.digitalFields.loopsPerHour && inv.digitalFields.spotsPerLoop) {
+      inventory.spotsPerHour = inv.digitalFields.loopsPerHour * inv.digitalFields.spotsPerLoop;
+    } else if (inv.digitalFields.loopsPerHour) {
+      inventory.spotsPerHour = inv.digitalFields.loopsPerHour;
+    }
+  }
+
+  if (inv.typePath) {
+    inventory.venueTypeIds = [inv.typePath];
+  }
+
+  if (inv.externalIds && Array.isArray(inv.externalIds)) {
+    const lmxEntry = inv.externalIds.find((ext: any) => ext.platform === 'LMX');
+    if (lmxEntry && lmxEntry.externalId) {
+      inventory.referenceId = lmxEntry.externalId;
+    }
+  }
+
+  if (inv.planning) {
+    inventory.planning = {
+      capacity: inv.planning.capacity ? {
+        campaignDays: inv.planning.capacity.campaignDays,
+        available: inv.planning.capacity.available ? {
+          slots: inv.planning.capacity.available.slots || 0,
+          playTimeSec: inv.planning.capacity.available.playTimeSec || 0,
+          maxImpressions: inv.planning.capacity.available.maxImpressions || 0,
+        } : undefined,
+      } : undefined,
+      allocation: inv.planning.allocation ? {
+        slots: inv.planning.allocation.slots || 0,
+        playTimeSec: inv.planning.allocation.playTimeSec || 0,
+        sov: inv.planning.allocation.sov || 0,
+        sot: inv.planning.allocation.sot || 0,
+      } : undefined,
+      estimates: inv.planning.estimates ? {
+        impressions: inv.planning.estimates.impressions || 0,
+        reach: inv.planning.estimates.reach || 0,
+        frequency: inv.planning.estimates.frequency || 0,
+      } : undefined,
+      pricing: inv.planning.pricing ? {
+        cpm: inv.planning.pricing.cpm || 0,
+        estimatedCost: inv.planning.pricing.estimatedCost || 0,
+      } : undefined,
+    };
+  }
+
+  return inventory;
+}