DTO Reference

let skuIdMap = {};

async function initBridge() {
  // Load all products and index by SKU (uppercased for case-insensitive lookup)
  const productResult = await window.pipeline.products.list({ page: 1, pageSize: 500 });
  const products = (productResult && productResult.items) ? productResult.items : [];
  products.forEach(function(p) {
    if (p.sku && p.id) {
      skuIdMap[p.sku.toUpperCase()] = p.id;
    }
  });
}

// Later, when building a line:
function resolveProduct(skuCode) {
  return {
    productCode: skuCode,
    productId: skuIdMap[skuCode.toUpperCase()] || null  // null = no task injection (still sends)
  };
}

// BridgeContextDto
interface BridgeContextDto {
  userName: string;
  userEmail: string;
  userRole: string;       // e.g. "H_Admin", "H_Field"
  tenantName: string;
  tenantId: string;
  cultureCode: string;   // e.g. "en-NZ"
}

// BridgeCustomerDto
interface BridgeCustomerDto {
  id: string;            // GUID
  name: string;
  email: string;
  phone: string;
}

// BridgeProductDto
interface BridgeProductDto {
  id: string;            // GUID
  sku: string;           // Human-readable product code (Stock_SKU.SKU)
  name: string;
  price: number;         // Retail sell price (Stock_SKU.Sell)
  unit: string;          // UOM token
}

// BridgeTaskTemplateDto (from taskTemplates.list)
interface BridgeTaskTemplateDto {
  id: string;            // GUID - pass as LinkedItemId on a "task" line
  code: string;          // Stable code (e.g. "T_DEFAULT_INSTALLATION_TASK")
  name: string;
}

// BridgeCostItemDto (from costItems.list) - DEPRECATED, prefer BridgeJobCostTemplateDto
interface BridgeCostItemDto {
  id: string;            // GUID - pass as LinkedItemId on a "cost" line (deprecated)
  code: string;          // Stable code (e.g. "COS-TRAVEL-TIME")
  name: string;
  type: string;          // T_Type token (e.g. "T_FINANCIAL", "T_TRAVEL")
}

// BridgeJobCostTemplateDto (from jobCostTemplates.list)
interface BridgeJobCostTemplateDto {
  id: string;            // GUID - pass as LinkedItemId on a "jobcost" line
  code: string;          // JobCostTemplate.CostCode (e.g. "SHIPPING", "DISPOSAL", "TRAVEL")
  name: string;          // JobCostTemplate.CostName
  type: string;          // T_CostType token: "T_ADHOC" | "T_PURCHASED_ITEM" | "T_THIRD_PARTY_COST" | "T_EXPENSE"
}

// BridgeQuoteDto
interface BridgeQuoteDto {
  id: string;            // GUID
  ref: string;
  customerName: string;
  total: number;
  status: string;
  date: string;          // ISO 8601 datetime
}

// BridgeJobDto
interface BridgeJobDto {
  id: string;            // GUID
  ref: string;           // Human-readable job reference (e.g. "JOB-0042")
  customerName: string;
  customerIdGuid: string; // GUID
  status: string;
}

// BridgePagedResult<T>
interface BridgePagedResult<T> {
  items: T[];
  totalCount: number;
  page: number;
  pageSize: number;
}

// BridgeCreateQuoteRequest
interface BridgeCreateQuoteRequest {
  jobId?: string;
  customerName?: string;
  customerEmail?: string;
  customerPhone?: string;
  upsertByEmail: boolean;
  title?: string;
  quoteRef?: string;
  lines: BridgeQuoteLineRequest[];
}

// BridgeQuoteLineRequest (for quotes.create)
interface BridgeQuoteLineRequest {
  description?: string;
  productCode?: string;
  qty: number;
  unitPrice: number;
  taxRate: number;
  supplierRef?: string;     // Resolved against G_Suppliers.SupplierRef then Name (active only).
                            // Null/unresolved falls back to the Self supplier (T_SELF).
}

// BridgeCreateQuoteResult
interface BridgeCreateQuoteResult {
  id: string;
  ref: string;
  total: number;
  url?: string;          // Relative deep-link to the created quote, if available
}

// BridgeAddLineDto (for quotes.addLines - quoting_extension only)
interface BridgeAddLineDto {
  description?: string;
  productCode?: string;
  qty: number;
  unitPrice: number;
  costPrice?: number;       // When set: BUY=costPrice, SELL=unitPrice. When omitted: BUY=SELL=unitPrice
  taxRate: number;
  location?: string;        // Maps to FreeTextField2
  specification?: string;   // Maps to FreeTextField
  unit?: string;            // "T_ITEM" | "T_SQUARE_METRE" | "T_LINEAR_METRE"
  groupKey?: string;        // Lines sharing the same groupKey get the same QuoteLine.GroupId

  // -- Line linking (preferred over productId) --
  lineType?: string;        // "product" | "task" | "cost" | "jobcost"  (defaults to "product")
  linkedItemId?: string;    // GUID into Stock_SKU / G_Task_Templates / COB_Items / JobCostTemplate
                            // based on lineType. Replaces productId for new tools. Validation:
                            // rejects the whole batch if a non-null GUID does not resolve to an
                            // active row. For "jobcost", null is valid (ad-hoc job cost).

  // -- Categorical grouping --
  section?: string;         // Free-text section label (e.g. "Blinds", "Installation", "Extras").
                            // Host UI groups lines by section.
                            // Max 100 chars; trimmed; null/empty renders under "Ungrouped".
  summaryOnly?: boolean;    // Default false. When true, the section this line belongs to prints
                            // on the customer's quote as a single name + total row, with its
                            // individual lines suppressed. Section identity is
                            // (section, summaryOnly) - see "Summary-only sections" below.

  // -- Pricing / supplier / free-text --
  discountPercent?: number; // 0-100. Stored on QuoteLine.DiscountPercent; LineNett =
                            // sell × qty × (1 − discountPercent/100). Null = 0.
  supplierRef?: string;     // Resolved against G_Suppliers.SupplierRef then Name (active only).
                            // Null/unresolved falls back to the Self supplier (T_SELF). A resolved
                            // supplier drives PO + supplier-invoice creation on quote-to-job.
  freeTextField3?: string;  // Persisted on QuoteLine.FreeTextField3 (1+2 come from
  freeTextField4?: string;  // specification/location). Map 1:1 to JobCost.FreeTextLine1-4 on convert.

  // -- Deprecated (still supported) --
  /** @deprecated Use linkedItemId with lineType="product" instead. Retained for back-compat
   *  with Ziptrak v2.1.2 and earlier. New tools should not set this field. */
  productId?: string;
}

// All three lines carry the same section AND the same summaryOnly value,
// so they land in one collapsed section totalling $1,250.
await pipeline.quotes.addLines([
  { description: "Travel to site",      qty: 1, unitPrice: 400, taxRate: 15,
    lineType: "jobcost", section: "Installation, Travel & Shipping", summaryOnly: true },
  { description: "Freight",             qty: 1, unitPrice: 350, taxRate: 15,
    lineType: "jobcost", section: "Installation, Travel & Shipping", summaryOnly: true },
  { description: "Installation labour", qty: 1, unitPrice: 500, taxRate: 15,
    lineType: "task",    section: "Installation, Travel & Shipping", summaryOnly: true },
]);