|
|
export type AddressInput = {
|
|
|
street: string;
|
|
|
city: string;
|
|
|
state: string;
|
|
|
zip: string;
|
|
|
place_id: string;
|
|
|
formatted_address: string;
|
|
|
selected_from_suggestions: boolean;
|
|
|
/** MotherShip 联想候选项 ID（用户确认后必填） */
|
|
|
mothership_option_id?: string;
|
|
|
/** MotherShip 下拉展示文案，RPA 精确点选 */
|
|
|
mothership_display_label?: string;
|
|
|
/** 用户已从 MotherShip 多候选中确认 */
|
|
|
selected_from_mothership?: boolean;
|
|
|
};
|
|
|
|
|
|
export type WeightInput = {
|
|
|
value: number;
|
|
|
unit: "lb" | "kg";
|
|
|
};
|
|
|
|
|
|
export type DimensionsInput = {
|
|
|
length: number;
|
|
|
width: number;
|
|
|
height: number;
|
|
|
unit: "in" | "cm";
|
|
|
};
|
|
|
|
|
|
export type QuoteRequestBody = {
|
|
|
request_id: string;
|
|
|
customer_id: string;
|
|
|
pickup_address: AddressInput;
|
|
|
delivery_address: AddressInput;
|
|
|
weight: WeightInput;
|
|
|
dimensions: DimensionsInput;
|
|
|
pallet_count: number;
|
|
|
cargo_type: string;
|
|
|
service_level?: "standard" | "guaranteed";
|
|
|
rate_option?: "lowest" | "fastest";
|
|
|
display_unit?: "imperial" | "metric";
|
|
|
/** 候选 RPA 会话 ID（可选，10 分钟内有效） */
|
|
|
quote_session_id?: string;
|
|
|
};
|
|
|
|
|
|
export type NormalizedCargo = {
|
|
|
requestId: string;
|
|
|
customerId: string;
|
|
|
pickupAddress: AddressInput;
|
|
|
deliveryAddress: AddressInput;
|
|
|
weightLb: number;
|
|
|
dimLIn: number;
|
|
|
dimWIn: number;
|
|
|
dimHIn: number;
|
|
|
palletCount: number;
|
|
|
cargoType: string;
|
|
|
serviceLevel: "standard" | "guaranteed";
|
|
|
rateOption: "lowest" | "fastest";
|
|
|
cargoHash: string;
|
|
|
pickupSerialized: string;
|
|
|
deliverySerialized: string;
|
|
|
quoteSessionId?: string;
|
|
|
};
|
|
|
|
|
|
export type QuoteSubmitResult = {
|
|
|
quoteId: string;
|
|
|
status: "processing" | "done";
|
|
|
cached?: boolean;
|
|
|
};
|
|
|
|
|
|
export type L2CachePayload = {
|
|
|
quotes: Array<{
|
|
|
service_level: string;
|
|
|
rate_option: string;
|
|
|
carrier: string;
|
|
|
transit_days: string;
|
|
|
transit_description: string;
|
|
|
raw_freight: number;
|
|
|
surcharges: number;
|
|
|
raw_total: number;
|
|
|
}>;
|
|
|
};
|
|
|
|
|
|
export class ValidationError extends Error {
|
|
|
readonly code = "VALIDATION_FAILED";
|
|
|
|
|
|
constructor(message: string) {
|
|
|
super(message);
|
|
|
this.name = "ValidationError";
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/** SQL 注入等安全校验失败（task-105 / TC-504） */
|
|
|
export class SecurityValidationError extends ValidationError {
|
|
|
readonly isSecurity = true;
|
|
|
|
|
|
constructor(message: string) {
|
|
|
super(message);
|
|
|
this.name = "SecurityValidationError";
|
|
|
}
|
|
|
}
|
|
|
|
|
|
export class QuoteIdConflictError extends Error {
|
|
|
readonly code = "INTERNAL_ERROR";
|
|
|
|
|
|
constructor(message: string) {
|
|
|
super(message);
|
|
|
this.name = "QuoteIdConflictError";
|
|
|
}
|
|
|
}
|
|
|
|
|
|
export class RpaDataInvalidError extends Error {
|
|
|
readonly code = "RPA_DATA_INVALID";
|
|
|
|
|
|
constructor(message: string) {
|
|
|
super(message);
|
|
|
this.name = "RpaDataInvalidError";
|
|
|
}
|
|
|
}
|
