chajia/lib/embed/host-bridge.ts

/**
 * 宿主 iframe ↔ 查价页 postMessage 协议（v1）
 * 文档：api调用文档/嵌入-postMessage对接文档.md
 */

export const CHAJIA_PM_SOURCE = "chajia" as const;
export const CHAJIA_PM_VERSION = 1 as const;

/** 四条互斥查价模块（与 OpenAPI 路线 ID 一致） */
export type ChajiaModuleId =
  | "MS_GUEST"
  | "MS_LOGGED_IN"
  | "FLOCK_GUEST"
  | "FLOCK_LOGGED_IN";

export type ChajiaHostToIframeType =
  | "chajia:select-module"
  | "chajia:fill"
  | "chajia:ping"
  /** 宿主请求 iframe 内滚到「选择承运商」报价区 */
  | "chajia:scroll-quotes";

export type ChajiaIframeToHostType =
  | "chajia:ready"
  | "chajia:pong"
  | "chajia:module-changed"
  | "chajia:fill-ack"
  | "chajia:quote-result"
  | "chajia:quote-save"
  /** 进入二级详情等场景：请求宿主把查价区滚到视口顶部 */
  | "chajia:scroll-top"
  | "chajia:error";

export type ChajiaPmType = ChajiaHostToIframeType | ChajiaIframeToHostType;

export interface ChajiaPmEnvelope<T extends ChajiaPmType = ChajiaPmType> {
  source: typeof CHAJIA_PM_SOURCE;
  version: typeof CHAJIA_PM_VERSION;
  type: T;
  /** 宿主生成，用于配对 fill / 结果 */
  request_id?: string;
  module?: ChajiaModuleId;
  payload?: unknown;
}

/** MotherShip 免账号：表单草稿（与嵌入 QuoteForm 一致） */
export interface MsGuestFillPayload {
  business_customer_id?: string;
  /** ccnew LR_Base_User.F_Account */
  business_user_account?: string;
  pickup?: { street?: string; city?: string; state?: string; zip?: string };
  delivery?: { street?: string; city?: string; state?: string; zip?: string };
  weight?: { value: number; unit?: "lb" | "kg" | "t" };
  dimensions?: {
    length: number;
    width: number;
    height: number;
    unit?: "in" | "cm" | "m";
  };
  pallet_count?: number;
  cargo_type?: string;
  service_level?: "standard" | "guaranteed";
  display_unit?: "imperial" | "metric";
}

/**
 * MotherShip 登录后地址预填。
 * 宿主可只传整段文本（street / formatted_address），写入搜索框；
 * place_id / mothership_option_id 可选——无则用户须点选联想确认。
 */
export interface MsLoggedInAddressFill {
  street?: string;
  city?: string;
  state?: string;
  zip?: string;
  place_id?: string;
  formatted_address?: string;
  mothership_option_id?: string;
  mothership_display_label?: string;
}

/** MotherShip 登录后：地址文本 + 附加服务 + 货物行 */
export interface MsLoggedInFillPayload {
  business_customer_id?: string;
  /** ccnew LR_Base_User.F_Account；无 BC 时反查加价客户 */
  business_user_account?: string;
  pickup_address?: MsLoggedInAddressFill;
  delivery_address?: MsLoggedInAddressFill;
  ready_date?: string;
  ready_time?: string;
  pickup_accessorials?: string[];
  delivery_accessorials?: string[];
  cargo_lines?: Array<{
    cargo_type?: string;
    quantity?: number;
    weight_lb?: number;
    length_in?: number;
    width_in?: number;
    height_in?: number;
  }>;
}

/** 从地址 fill 抽出搜索框文案（整段文本优先） */
export function msLoggedInAddressQueryText(
  addr: MsLoggedInAddressFill | null | undefined,
): string {
  if (!addr) return "";
  const formatted = addr.formatted_address?.trim() ?? "";
  if (formatted) return formatted;
  const street = addr.street?.trim() ?? "";
  if (street) return street;
  const parts = [addr.city, addr.state, addr.zip]
    .map((x) => (x ?? "").trim())
    .filter(Boolean);
  return parts.join(", ");
}

/** Flock 免账号 */
export interface FlockGuestFillPayload {
  pickup_date: string;
  pickup_zip: string;
  delivery_zip: string;
  pallet_count: number;
  total_weight: { value: number; unit?: "lb" | "kg" | "t" };
  dimensions: {
    length: number;
    width: number;
    height: number;
    unit?: "in" | "cm" | "m";
  };
}

/** Flock 登录后 Quick（核心字段） */
export interface FlockLoggedInFillPayload {
  pickup_date: string;
  pickup_zip: string;
  delivery_zip: string;
  pickup_type?: string;
  delivery_type?: string;
  items: Array<{
    quantity: number;
    packaging_type?: string;
    length_in: number;
    width_in: number;
    height_in: number;
    total_weight_lb: number;
    freight_class?: string;
    description?: string;
  }>;
  pickup_liftgate?: boolean;
  delivery_liftgate?: boolean;
  additional_services?: string[];
  vehicle_types?: string[];
}

export type ChajiaFillPayloadByModule = {
  MS_GUEST: MsGuestFillPayload;
  MS_LOGGED_IN: MsLoggedInFillPayload;
  FLOCK_GUEST: FlockGuestFillPayload;
  FLOCK_LOGGED_IN: FlockLoggedInFillPayload;
};

export interface ChajiaFillMessagePayload<
  M extends ChajiaModuleId = ChajiaModuleId,
> {
  /** 是否切到对应模块（默认 true） */
  select_module?: boolean;
  /** 模块表单数据 */
  form: ChajiaFillPayloadByModule[M];
}

/** 查价成功后回传（与程序 QuoteItem / QuoteDetail 对齐） */
export interface ChajiaQuoteResultPayload {
  quote_id: string;
  request_id: string;
  status: "done" | "failed" | "expired";
  module: ChajiaModuleId;
  currency: string;
  source_type?: string | null;
  is_realtime?: boolean;
  quotes: Array<{
    carrier: string;
    service_level: string;
    rate_option: string;
    transit_days: string;
    transit_description: string;
    raw_freight: number;
    surcharges: number;
    raw_total: number;
    markup_percent: number;
    markup_amount: number;
    final_total: number;
    /** 给宿主的显式别名：原价（未加价） */
    base_total_before_markup?: number;
    /** 给宿主的显式别名：本客户加价金额 */
    customer_markup_amount?: number;
    /** 给宿主的显式别名：本客户最终展示价 */
    customer_final_total?: number;
    /** 宿主无需再猜：true 表示 final_total 已是客户价 */
    is_customer_markup_applied?: boolean;
    /** 宿主可直接据此取展示价 */
    pricing_mode?: "customer_final";
    breakdown: Array<{ item: string; amount: number }>;
    /** 宿主保存快照时标记选中行 */
    selected?: boolean;
    guaranteed?: boolean;
    guarantee_amount?: number | null;
    estimated_pickup?: string | null;
    estimated_delivery?: string | null;
  }>;
  error_code?: string | null;
  error_message?: string | null;
}

/** 用户点击「保存本次询价记录」回传宿主（含选中报价） */
export interface ChajiaQuoteSavePayload extends ChajiaQuoteResultPayload {
  action: "save";
  selected_carrier?: string | null;
  coverage?: "basic" | "freight_protect" | null;
  cargo_value_usd?: number | null;
  ready_date?: string | null;
  estimated_pickup?: string | null;
  pickup_address?: MsLoggedInAddressFill;
  delivery_address?: MsLoggedInAddressFill;
  cargo_lines?: Array<{
    cargo_type?: string;
    quantity?: number;
    weight_lb?: number;
    length_in?: number;
    width_in?: number;
    height_in?: number;
  }>;
}

export interface ChajiaErrorPayload {
  code: string;
  message: string;
  module?: ChajiaModuleId;
}

export interface ChajiaFillAckPayload {
  ok: boolean;
  module: ChajiaModuleId;
  applied_keys: string[];
  message?: string;
}

const MODULE_SET = new Set<string>([
  "MS_GUEST",
  "MS_LOGGED_IN",
  "FLOCK_GUEST",
  "FLOCK_LOGGED_IN",
]);

export function isChajiaModuleId(v: unknown): v is ChajiaModuleId {
  return typeof v === "string" && MODULE_SET.has(v);
}

export function moduleToHubRoute(
  module: ChajiaModuleId,
): { provider: "mothership" | "flock"; mode: "anon" | "login" } {
  switch (module) {
    case "MS_GUEST":
      return { provider: "mothership", mode: "anon" };
    case "MS_LOGGED_IN":
      return { provider: "mothership", mode: "login" };
    case "FLOCK_GUEST":
      return { provider: "flock", mode: "anon" };
    case "FLOCK_LOGGED_IN":
      return { provider: "flock", mode: "login" };
  }
}

export function parseChajiaPostMessage(
  data: unknown,
): ChajiaPmEnvelope | null {
  if (!data || typeof data !== "object") return null;
  const o = data as Record<string, unknown>;
  if (o.source !== CHAJIA_PM_SOURCE) return null;
  if (o.version !== CHAJIA_PM_VERSION) return null;
  if (typeof o.type !== "string" || !o.type.startsWith("chajia:")) return null;
  return {
    source: CHAJIA_PM_SOURCE,
    version: CHAJIA_PM_VERSION,
    type: o.type as ChajiaPmType,
    request_id: typeof o.request_id === "string" ? o.request_id : undefined,
    module: isChajiaModuleId(o.module) ? o.module : undefined,
    payload: o.payload,
  };
}

/** iframe → 宿主（仅当嵌入在 iframe 中时发送） */
export function postToHost(
  type: ChajiaIframeToHostType,
  opts?: {
    request_id?: string;
    module?: ChajiaModuleId;
    payload?: unknown;
    targetOrigin?: string;
  },
): void {
  if (typeof window === "undefined") return;
  if (window.parent === window) return;
  const msg: ChajiaPmEnvelope = {
    source: CHAJIA_PM_SOURCE,
    version: CHAJIA_PM_VERSION,
    type,
    request_id: opts?.request_id,
    module: opts?.module,
    payload: opts?.payload,
  };
  window.parent.postMessage(msg, opts?.targetOrigin ?? "*");
}

export function listTopLevelKeys(obj: unknown): string[] {
  if (!obj || typeof obj !== "object" || Array.isArray(obj)) return [];
  return Object.keys(obj as Record<string, unknown>);
}