@thorprovider/blocks 4.1.0 → 4.3.0

package/dist/ports/order-detail.d.ts

@@ -0,0 +1,301 @@
+export type SectionId = 'logistics' | 'items' | 'pricing' | 'payments' | 'afterSales' | 'documents' | 'b2b' | 'revisions';
+export type SectionIssue = 'unavailable' | 'error' | 'forbidden';
+/** Integer minor units. Formatting belongs to the view or the host. */
+export type Money = {
+    amount: number;
+    currency: string;
+};
+export type ProductKind = 'physical' | 'digital' | 'bundle' | 'service' | 'configured' | 'custom' | 'serialized' | 'warranty' | 'measured';
+export type AttributeKind = 'variant' | 'commercial' | 'custom';
+export type OrderLineAttribute = {
+    id: string;
+    label: string;
+    value: string;
+    kind: AttributeKind;
+};
+export type TaxLine = {
+    id: string;
+    label: string;
+    /** Display-only rate label, e.g. "16%". Never used to recalculate. */
+    rate?: string;
+    amount: Money;
+    included?: boolean;
+    exemption?: boolean;
+};
+export type Adjustment = {
+    id: string;
+    label: string;
+    scope: 'product' | 'order' | 'shipping' | 'payment';
+    direction: 'discount' | 'surcharge';
+    amount: Money;
+    source: 'promotion' | 'manual' | 'contract' | 'tax';
+    promotionId?: string;
+};
+export type PriceKind = 'list' | 'volume' | 'contract' | 'customer' | 'promotion';
+export type OrderLine = {
+    id: string;
+    /** Catalog identity, kept only for adapters; never rendered. */
+    productId?: string;
+    name: string;
+    sku: string;
+    image?: string;
+    variant?: string;
+    quantity: number;
+    /** Quantity cancelled after creation; never inferred from totals. */
+    cancelledQuantity: number;
+    unitPrice: {
+        original: Money;
+        applied: Money;
+        kind: PriceKind;
+    };
+    /** Gross historical subtotal for the chargeable quantity. */
+    subtotal: Money;
+    /** Explanatory product-scope discounts; already inside the applied price. */
+    discounts: Adjustment[];
+    taxes: TaxLine[];
+    /** Authoritative charged amount for this line, taxes included. */
+    total: Money;
+    attributes: OrderLineAttribute[];
+    kind: ProductKind;
+    serialNumber?: string;
+    warranty?: string;
+    measure?: {
+        quantity: number;
+        unit: string;
+    };
+    bundle?: {
+        name: string;
+        sku: string;
+        quantity: number;
+    }[];
+    note?: string;
+};
+export type FulfillmentStatus = 'pending' | 'preparing' | 'shipped' | 'delivered' | 'partially_delivered' | 'ready_for_pickup' | 'picked_up' | 'cancelled';
+export type FulfillmentAllocation = {
+    lineId: string;
+    quantity: number;
+};
+export type TrackingEvent = {
+    id: string;
+    at: string;
+    label: string;
+    place?: string;
+};
+export type PackageRef = {
+    id: string;
+    label: string;
+};
+export type PickupDetails = {
+    locationName: string;
+    address: string;
+    schedule: string;
+    instructions?: string;
+    status: 'scheduled' | 'ready' | 'picked_up' | 'expired';
+    availableFrom?: string;
+    expiresAt?: string;
+    code?: string;
+    evidence?: string;
+};
+export type Fulfillment = {
+    id: string;
+    groupId: string;
+    status: FulfillmentStatus;
+    carrier?: string;
+    provider?: string;
+    trackingNumber?: string;
+    trackingUrl?: string;
+    shippedAt?: string;
+    deliveredAt?: string;
+    packages: PackageRef[];
+    events: TrackingEvent[];
+    allocations: FulfillmentAllocation[];
+    pickup?: PickupDetails;
+    evidence?: string;
+};
+export type ShippingMethod = {
+    id: string;
+    name: string;
+    description?: string;
+    /** Internal warehouse/profile ids are never rendered. */
+    profileId?: string;
+};
+export type LogisticsGroup = {
+    id: string;
+    mode: 'shipping' | 'pickup';
+    method: ShippingMethod;
+    shippingSubtotal: Money;
+    discounts: Adjustment[];
+    taxes: TaxLine[];
+    /** Authoritative group total, shipping taxes included. */
+    total: Money;
+    etaLabel?: string;
+    pickup?: PickupDetails;
+};
+export type PromotionType = 'fixed-product' | 'percent-product' | 'fixed-order' | 'percent-order' | 'buy-x-get-y' | 'free-shipping' | 'shipping-discount' | 'payment-method-discount' | 'financing-benefit' | 'provider-incentive';
+export type PromotionScope = 'product' | 'order' | 'shipping' | 'payment';
+export type PromotionNominal = {
+    kind: 'percent';
+    percent: number;
+} | {
+    kind: 'fixed';
+    money: Money;
+};
+export type BuyXGetY = {
+    conditionLineIds: string[];
+    rewardLineIds: string[];
+    rewardQuantity: number;
+    freeQuantity: number;
+    partial: boolean;
+};
+export type Promotion = {
+    id: string;
+    code?: string;
+    name: string;
+    type: PromotionType;
+    scope: PromotionScope;
+    application: 'automatic' | 'code';
+    nominal: PromotionNominal;
+    /** Effective historical amount. Must equal its linked adjustments. */
+    discounted: Money;
+    lineIds: string[];
+    groupIds?: string[];
+    adjustmentIds: string[];
+    buyXGetY?: BuyXGetY;
+};
+export type TransactionKind = 'payment' | 'authorization' | 'refund' | 'credit';
+export type TransactionStatus = 'pending' | 'authorized' | 'captured' | 'refunded' | 'failed';
+export type PaymentMethodKind = 'card' | 'wallet' | 'transfer' | 'credit' | 'cash';
+export type Transaction = {
+    id: string;
+    kind: TransactionKind;
+    status: TransactionStatus;
+    amount: Money;
+    at: string;
+    method: PaymentMethodKind;
+    reference?: string;
+    note?: string;
+};
+export type AfterSalesType = 'return' | 'exchange' | 'claim';
+export type AfterSalesStatus = 'requested' | 'approved' | 'in_transit' | 'received' | 'completed' | 'rejected';
+export type AfterSalesLine = {
+    lineId: string;
+    quantity: number;
+};
+export type OrderActionId = 'reorder' | 'invoice' | 'track' | 'return' | 'exchange' | 'problem' | 'cancel' | 'pay-balance' | 'support';
+export type AfterSalesCase = {
+    id: string;
+    type: AfterSalesType;
+    status: AfterSalesStatus;
+    createdAt: string;
+    reason: string;
+    lines: AfterSalesLine[];
+    refund?: Money;
+    replacement?: {
+        name: string;
+        sku: string;
+        quantity: number;
+    }[];
+    shipment?: {
+        carrier?: string;
+        trackingNumber?: string;
+        trackingUrl?: string;
+        status?: string;
+    };
+    availableActions: OrderActionId[];
+};
+export type DocumentKind = 'invoice' | 'receipt' | 'payment-proof' | 'credit-note' | 'shipping' | 'business';
+export type OrderDocument = {
+    id: string;
+    kind: DocumentKind;
+    label: string;
+    issuedAt?: string;
+    /** Only available documents are rendered with an action. */
+    available: boolean;
+};
+export type InvoiceStatus = 'not_issued' | 'pending' | 'issued' | 'overdue';
+export type ApprovalStatus = 'pending' | 'approved' | 'rejected';
+export type OrderBusiness = {
+    company: string;
+    buyer: string;
+    branch?: string;
+    purchaseOrder?: string;
+    internalReference?: string;
+    costCenter?: string;
+    paymentTerms?: string;
+    creditLimit?: Money;
+    creditUsed?: Money;
+    dueAt?: string;
+    invoiceStatus?: InvoiceStatus;
+    approval?: {
+        status: ApprovalStatus;
+        by?: string;
+        at?: string;
+    };
+};
+export type RevisionKind = 'item-added' | 'item-removed' | 'quantity' | 'price' | 'shipping' | 'tax' | 'cancel';
+export type OrderRevision = {
+    id: string;
+    at: string;
+    kind: RevisionKind;
+    summary: string;
+    delta?: Money;
+};
+export type Address = {
+    name: string;
+    line1: string;
+    line2?: string;
+    city: string;
+    region?: string;
+    postalCode: string;
+    country: string;
+    phone?: string;
+};
+export type MoneySummary = {
+    itemsSubtotal: Money;
+    itemDiscounts: Money;
+    orderDiscounts: Money;
+    shippingSubtotal: Money;
+    shippingDiscounts: Money;
+    tax: Money;
+    adjustments: Money;
+    total: Money;
+};
+export type CommercialStatus = 'pending' | 'processing' | 'completed' | 'cancelled';
+export type OrderDetailOrder = {
+    id: string;
+    number: string;
+    createdAt: string;
+    updatedAt: string;
+    currency: string;
+    commercial: CommercialStatus;
+    logistics: {
+        status: FulfillmentStatus;
+        delayed?: boolean;
+    };
+    shippingAddress?: Address;
+    billingAddress?: Address;
+    lines: OrderLine[];
+    groups: LogisticsGroup[];
+    fulfillments: Fulfillment[];
+    promotions: Promotion[];
+    adjustments: Adjustment[];
+    transactions: Transaction[];
+    cases: AfterSalesCase[];
+    documents: OrderDocument[];
+    business?: OrderBusiness;
+    revisions: OrderRevision[];
+    totals: MoneySummary;
+    availableActions: OrderActionId[];
+};
+export type OrderDetailSnapshot = {
+    order: OrderDetailOrder;
+    /** Per-section issues from a partial load. Absent means the section is valid. */
+    issues?: Partial<Record<SectionId, SectionIssue>>;
+    warning?: boolean;
+};
+export interface OrderDetailPort {
+    get(orderId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<OrderDetailSnapshot>;
+}
+//# sourceMappingURL=order-detail.d.ts.map

package/dist/ports/order-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-detail.d.ts","sourceRoot":"","sources":["../../src/ports/order-detail.ts"],"names":[],"mappings":"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"}

package/dist/ports/order-detail.js

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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);
+var order_detail_exports = {};
+module.exports = __toCommonJS(order_detail_exports);
+//# sourceMappingURL=order-detail.js.map

package/dist/ports/order-detail.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ports/order-detail.ts"],"sourcesContent":["export type SectionId =\n  | 'logistics'\n  | 'items'\n  | 'pricing'\n  | 'payments'\n  | 'afterSales'\n  | 'documents'\n  | 'b2b'\n  | 'revisions'\n\nexport type SectionIssue = 'unavailable' | 'error' | 'forbidden'\n\n/** Integer minor units. Formatting belongs to the view or the host. */\nexport type Money = { amount: number; currency: string }\n\nexport type ProductKind =\n  | 'physical'\n  | 'digital'\n  | 'bundle'\n  | 'service'\n  | 'configured'\n  | 'custom'\n  | 'serialized'\n  | 'warranty'\n  | 'measured'\n\nexport type AttributeKind = 'variant' | 'commercial' | 'custom'\n\nexport type OrderLineAttribute = {\n  id: string\n  label: string\n  value: string\n  kind: AttributeKind\n}\n\nexport type TaxLine = {\n  id: string\n  label: string\n  /** Display-only rate label, e.g. \"16%\". Never used to recalculate. */\n  rate?: string\n  amount: Money\n  included?: boolean\n  exemption?: boolean\n}\n\nexport type Adjustment = {\n  id: string\n  label: string\n  scope: 'product' | 'order' | 'shipping' | 'payment'\n  direction: 'discount' | 'surcharge'\n  amount: Money\n  source: 'promotion' | 'manual' | 'contract' | 'tax'\n  promotionId?: string\n}\n\nexport type PriceKind = 'list' | 'volume' | 'contract' | 'customer' | 'promotion'\n\nexport type OrderLine = {\n  id: string\n  /** Catalog identity, kept only for adapters; never rendered. */\n  productId?: string\n  name: string\n  sku: string\n  image?: string\n  variant?: string\n  quantity: number\n  /** Quantity cancelled after creation; never inferred from totals. */\n  cancelledQuantity: number\n  unitPrice: { original: Money; applied: Money; kind: PriceKind }\n  /** Gross historical subtotal for the chargeable quantity. */\n  subtotal: Money\n  /** Explanatory product-scope discounts; already inside the applied price. */\n  discounts: Adjustment[]\n  taxes: TaxLine[]\n  /** Authoritative charged amount for this line, taxes included. */\n  total: Money\n  attributes: OrderLineAttribute[]\n  kind: ProductKind\n  serialNumber?: string\n  warranty?: string\n  measure?: { quantity: number; unit: string }\n  bundle?: { name: string; sku: string; quantity: number }[]\n  note?: string\n}\n\nexport type FulfillmentStatus =\n  | 'pending'\n  | 'preparing'\n  | 'shipped'\n  | 'delivered'\n  | 'partially_delivered'\n  | 'ready_for_pickup'\n  | 'picked_up'\n  | 'cancelled'\n\nexport type FulfillmentAllocation = { lineId: string; quantity: number }\n\nexport type TrackingEvent = {\n  id: string\n  at: string\n  label: string\n  place?: string\n}\n\nexport type PackageRef = { id: string; label: string }\n\nexport type PickupDetails = {\n  locationName: string\n  address: string\n  schedule: string\n  instructions?: string\n  status: 'scheduled' | 'ready' | 'picked_up' | 'expired'\n  availableFrom?: string\n  expiresAt?: string\n  code?: string\n  evidence?: string\n}\n\nexport type Fulfillment = {\n  id: string\n  groupId: string\n  status: FulfillmentStatus\n  carrier?: string\n  provider?: string\n  trackingNumber?: string\n  trackingUrl?: string\n  shippedAt?: string\n  deliveredAt?: string\n  packages: PackageRef[]\n  events: TrackingEvent[]\n  allocations: FulfillmentAllocation[]\n  pickup?: PickupDetails\n  evidence?: string\n}\n\nexport type ShippingMethod = {\n  id: string\n  name: string\n  description?: string\n  /** Internal warehouse/profile ids are never rendered. */\n  profileId?: string\n}\n\nexport type LogisticsGroup = {\n  id: string\n  mode: 'shipping' | 'pickup'\n  method: ShippingMethod\n  shippingSubtotal: Money\n  discounts: Adjustment[]\n  taxes: TaxLine[]\n  /** Authoritative group total, shipping taxes included. */\n  total: Money\n  etaLabel?: string\n  pickup?: PickupDetails\n}\n\nexport type PromotionType =\n  | 'fixed-product'\n  | 'percent-product'\n  | 'fixed-order'\n  | 'percent-order'\n  | 'buy-x-get-y'\n  | 'free-shipping'\n  | 'shipping-discount'\n  | 'payment-method-discount'\n  | 'financing-benefit'\n  | 'provider-incentive'\n\nexport type PromotionScope = 'product' | 'order' | 'shipping' | 'payment'\n\nexport type PromotionNominal =\n  | { kind: 'percent'; percent: number }\n  | { kind: 'fixed'; money: Money }\n\nexport type BuyXGetY = {\n  conditionLineIds: string[]\n  rewardLineIds: string[]\n  rewardQuantity: number\n  freeQuantity: number\n  partial: boolean\n}\n\nexport type Promotion = {\n  id: string\n  code?: string\n  name: string\n  type: PromotionType\n  scope: PromotionScope\n  application: 'automatic' | 'code'\n  nominal: PromotionNominal\n  /** Effective historical amount. Must equal its linked adjustments. */\n  discounted: Money\n  lineIds: string[]\n  groupIds?: string[]\n  adjustmentIds: string[]\n  buyXGetY?: BuyXGetY\n}\n\nexport type TransactionKind = 'payment' | 'authorization' | 'refund' | 'credit'\nexport type TransactionStatus = 'pending' | 'authorized' | 'captured' | 'refunded' | 'failed'\nexport type PaymentMethodKind = 'card' | 'wallet' | 'transfer' | 'credit' | 'cash'\n\nexport type Transaction = {\n  id: string\n  kind: TransactionKind\n  status: TransactionStatus\n  amount: Money\n  at: string\n  method: PaymentMethodKind\n  reference?: string\n  note?: string\n}\n\nexport type AfterSalesType = 'return' | 'exchange' | 'claim'\nexport type AfterSalesStatus =\n  | 'requested'\n  | 'approved'\n  | 'in_transit'\n  | 'received'\n  | 'completed'\n  | 'rejected'\n\nexport type AfterSalesLine = { lineId: string; quantity: number }\n\nexport type OrderActionId =\n  | 'reorder'\n  | 'invoice'\n  | 'track'\n  | 'return'\n  | 'exchange'\n  | 'problem'\n  | 'cancel'\n  | 'pay-balance'\n  | 'support'\n\nexport type AfterSalesCase = {\n  id: string\n  type: AfterSalesType\n  status: AfterSalesStatus\n  createdAt: string\n  reason: string\n  lines: AfterSalesLine[]\n  refund?: Money\n  replacement?: { name: string; sku: string; quantity: number }[]\n  shipment?: { carrier?: string; trackingNumber?: string; trackingUrl?: string; status?: string }\n  availableActions: OrderActionId[]\n}\n\nexport type DocumentKind =\n  | 'invoice'\n  | 'receipt'\n  | 'payment-proof'\n  | 'credit-note'\n  | 'shipping'\n  | 'business'\n\nexport type OrderDocument = {\n  id: string\n  kind: DocumentKind\n  label: string\n  issuedAt?: string\n  /** Only available documents are rendered with an action. */\n  available: boolean\n}\n\nexport type InvoiceStatus = 'not_issued' | 'pending' | 'issued' | 'overdue'\nexport type ApprovalStatus = 'pending' | 'approved' | 'rejected'\n\nexport type OrderBusiness = {\n  company: string\n  buyer: string\n  branch?: string\n  purchaseOrder?: string\n  internalReference?: string\n  costCenter?: string\n  paymentTerms?: string\n  creditLimit?: Money\n  creditUsed?: Money\n  dueAt?: string\n  invoiceStatus?: InvoiceStatus\n  approval?: { status: ApprovalStatus; by?: string; at?: string }\n}\n\nexport type RevisionKind =\n  | 'item-added'\n  | 'item-removed'\n  | 'quantity'\n  | 'price'\n  | 'shipping'\n  | 'tax'\n  | 'cancel'\n\nexport type OrderRevision = {\n  id: string\n  at: string\n  kind: RevisionKind\n  summary: string\n  delta?: Money\n}\n\nexport type Address = {\n  name: string\n  line1: string\n  line2?: string\n  city: string\n  region?: string\n  postalCode: string\n  country: string\n  phone?: string\n}\n\nexport type MoneySummary = {\n  itemsSubtotal: Money\n  itemDiscounts: Money\n  orderDiscounts: Money\n  shippingSubtotal: Money\n  shippingDiscounts: Money\n  tax: Money\n  adjustments: Money\n  total: Money\n}\n\nexport type CommercialStatus = 'pending' | 'processing' | 'completed' | 'cancelled'\n\nexport type OrderDetailOrder = {\n  id: string\n  number: string\n  createdAt: string\n  updatedAt: string\n  currency: string\n  commercial: CommercialStatus\n  logistics: { status: FulfillmentStatus; delayed?: boolean }\n  shippingAddress?: Address\n  billingAddress?: Address\n  lines: OrderLine[]\n  groups: LogisticsGroup[]\n  fulfillments: Fulfillment[]\n  promotions: Promotion[]\n  adjustments: Adjustment[]\n  transactions: Transaction[]\n  cases: AfterSalesCase[]\n  documents: OrderDocument[]\n  business?: OrderBusiness\n  revisions: OrderRevision[]\n  totals: MoneySummary\n  availableActions: OrderActionId[]\n}\n\nexport type OrderDetailSnapshot = {\n  order: OrderDetailOrder\n  /** Per-section issues from a partial load. Absent means the section is valid. */\n  issues?: Partial<Record<SectionId, SectionIssue>>\n  warning?: boolean\n}\n\nexport interface OrderDetailPort {\n  get(orderId: string, options?: { signal?: AbortSignal }): Promise<OrderDetailSnapshot>\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/ports/order-detail.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=order-detail.mjs.map

package/dist/ports/order-detail.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/ports/order-history.d.ts

@@ -0,0 +1,128 @@
+/** Integer minor units. Formatting belongs to the view or the host. */
+export type Money = {
+    amount: number;
+    currency: string;
+};
+export type QuickFilterId = 'all' | 'in-progress' | 'completed' | 'cancelled' | 'attention';
+export type SortId = 'newest' | 'oldest' | 'total-desc' | 'total-asc' | 'updated';
+export type DatePreset = 'today' | '7d' | '30d' | '90d' | 'year' | 'custom';
+export type CommercialStatus = 'pending' | 'processing' | 'completed' | 'cancelled';
+/** `requires-action` is a filter-only pseudo-value derived from attention. */
+export type CommercialFilter = CommercialStatus | 'requires-action';
+export type PaymentStatus = 'unpaid' | 'authorized' | 'partially_paid' | 'paid';
+export type RefundStatus = 'none' | 'partial' | 'full';
+export type FulfilmentStatus = 'unfulfilled' | 'preparing' | 'shipped' | 'partially_delivered' | 'delivered' | 'delayed' | 'ready_for_pickup';
+export type DeliveryMode = 'shipping' | 'pickup' | 'mixed';
+export type ShipmentMode = 'shipping' | 'pickup';
+export type ReturnStatus = 'none' | 'requested' | 'in_progress' | 'completed';
+export type InvoiceStatus = 'not_issued' | 'pending' | 'issued' | 'overdue';
+export type OrderActionId = 'view' | 'track' | 'reorder' | 'invoice' | 'return' | 'exchange' | 'problem' | 'cancel' | 'pay-balance' | 'support';
+export type OrderItem = {
+    id: string;
+    name: string;
+    sku: string;
+    variant?: string;
+    quantity: number;
+    /** Optional product image. Without it the view renders a labelled monogram. */
+    image?: string;
+};
+export type ShipmentSummary = {
+    id: string;
+    mode: ShipmentMode;
+    status: FulfilmentStatus;
+    itemCount: number;
+    etaLabel?: string;
+};
+export type OrderBusiness = {
+    company: string;
+    buyer: string;
+    branch?: string;
+    purchaseOrder?: string;
+    costCenter?: string;
+    invoiceStatus?: InvoiceStatus;
+    paymentTerms?: string;
+    approvalPending?: boolean;
+};
+/**
+ * Normalised presentation model. `id` is the backend identity and is never
+ * rendered; `number` is the buyer-facing reference.
+ */
+export type OrderRecord = {
+    id: string;
+    number: string;
+    placedAt: string;
+    updatedAt: string;
+    total: Money;
+    items: OrderItem[];
+    itemCount: number;
+    commercial: CommercialStatus;
+    payment: {
+        status: PaymentStatus;
+        due?: Money;
+        creditTerms: boolean;
+    };
+    refund: RefundStatus;
+    fulfilment: {
+        status: FulfilmentStatus;
+        shipments: ShipmentSummary[];
+    };
+    deliveryMode: DeliveryMode;
+    returns: ReturnStatus;
+    /** A partial cancellation keeps its commercial status and is shown as a note. */
+    partiallyCancelled?: boolean;
+    externalReference?: string;
+    b2b?: OrderBusiness;
+    /** Backend-authorised actions for this order. The view intersects with capabilities. */
+    availableActions: OrderActionId[];
+};
+export type FilterSelection = {
+    commercial?: CommercialFilter[];
+    payment?: PaymentStatus[];
+    refund?: RefundStatus[];
+    fulfilment?: FulfilmentStatus[];
+    mode?: DeliveryMode[];
+    returns?: ReturnStatus[];
+    invoiceStatus?: InvoiceStatus[];
+    paymentTerms?: string[];
+    company?: string[];
+    buyer?: string[];
+    branch?: string[];
+    products?: string;
+    purchaseOrder?: string;
+    costCenter?: string;
+};
+export type OrdersQuery = {
+    search: string;
+    quick: QuickFilterId;
+    filters: FilterSelection;
+    date?: {
+        preset: DatePreset;
+        from?: string;
+        to?: string;
+    };
+    amount?: {
+        min?: number;
+        max?: number;
+        currency: string;
+    };
+    sort: SortId;
+    page: number;
+    pageSize: number;
+};
+export type OrdersPage = {
+    items: OrderRecord[];
+    /** Matching the full query, quick filter included. */
+    total: number;
+    /** Authorised orders with search and filters cleared. */
+    totalAll: number;
+    pageCount: number;
+    counts?: Record<QuickFilterId, number>;
+    /** Partial failure: the results are still valid. */
+    warning?: boolean;
+};
+export interface OrdersPort {
+    list(query: OrdersQuery, options?: {
+        signal?: AbortSignal;
+    }): Promise<OrdersPage>;
+}
+//# sourceMappingURL=order-history.d.ts.map

package/dist/ports/order-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-history.d.ts","sourceRoot":"","sources":["../../src/ports/order-history.ts"],"names":[],"mappings":"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"}

package/dist/ports/order-history.js

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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);
+var order_history_exports = {};
+module.exports = __toCommonJS(order_history_exports);
+//# sourceMappingURL=order-history.js.map

package/dist/ports/order-history.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ports/order-history.ts"],"sourcesContent":["/** Integer minor units. Formatting belongs to the view or the host. */\nexport type Money = { amount: number; currency: string }\n\nexport type QuickFilterId = 'all' | 'in-progress' | 'completed' | 'cancelled' | 'attention'\n\nexport type SortId = 'newest' | 'oldest' | 'total-desc' | 'total-asc' | 'updated'\n\nexport type DatePreset = 'today' | '7d' | '30d' | '90d' | 'year' | 'custom'\n\nexport type CommercialStatus = 'pending' | 'processing' | 'completed' | 'cancelled'\n/** `requires-action` is a filter-only pseudo-value derived from attention. */\nexport type CommercialFilter = CommercialStatus | 'requires-action'\nexport type PaymentStatus = 'unpaid' | 'authorized' | 'partially_paid' | 'paid'\nexport type RefundStatus = 'none' | 'partial' | 'full'\nexport type FulfilmentStatus =\n  | 'unfulfilled'\n  | 'preparing'\n  | 'shipped'\n  | 'partially_delivered'\n  | 'delivered'\n  | 'delayed'\n  | 'ready_for_pickup'\nexport type DeliveryMode = 'shipping' | 'pickup' | 'mixed'\nexport type ShipmentMode = 'shipping' | 'pickup'\nexport type ReturnStatus = 'none' | 'requested' | 'in_progress' | 'completed'\nexport type InvoiceStatus = 'not_issued' | 'pending' | 'issued' | 'overdue'\n\nexport type OrderActionId =\n  | 'view'\n  | 'track'\n  | 'reorder'\n  | 'invoice'\n  | 'return'\n  | 'exchange'\n  | 'problem'\n  | 'cancel'\n  | 'pay-balance'\n  | 'support'\n\nexport type OrderItem = {\n  id: string\n  name: string\n  sku: string\n  variant?: string\n  quantity: number\n  /** Optional product image. Without it the view renders a labelled monogram. */\n  image?: string\n}\n\nexport type ShipmentSummary = {\n  id: string\n  mode: ShipmentMode\n  status: FulfilmentStatus\n  itemCount: number\n  etaLabel?: string\n}\n\nexport type OrderBusiness = {\n  company: string\n  buyer: string\n  branch?: string\n  purchaseOrder?: string\n  costCenter?: string\n  invoiceStatus?: InvoiceStatus\n  paymentTerms?: string\n  approvalPending?: boolean\n}\n\n/**\n * Normalised presentation model. `id` is the backend identity and is never\n * rendered; `number` is the buyer-facing reference.\n */\nexport type OrderRecord = {\n  id: string\n  number: string\n  placedAt: string\n  updatedAt: string\n  total: Money\n  items: OrderItem[]\n  itemCount: number\n  commercial: CommercialStatus\n  payment: { status: PaymentStatus; due?: Money; creditTerms: boolean }\n  refund: RefundStatus\n  fulfilment: { status: FulfilmentStatus; shipments: ShipmentSummary[] }\n  deliveryMode: DeliveryMode\n  returns: ReturnStatus\n  /** A partial cancellation keeps its commercial status and is shown as a note. */\n  partiallyCancelled?: boolean\n  externalReference?: string\n  b2b?: OrderBusiness\n  /** Backend-authorised actions for this order. The view intersects with capabilities. */\n  availableActions: OrderActionId[]\n}\n\nexport type FilterSelection = {\n  commercial?: CommercialFilter[]\n  payment?: PaymentStatus[]\n  refund?: RefundStatus[]\n  fulfilment?: FulfilmentStatus[]\n  mode?: DeliveryMode[]\n  returns?: ReturnStatus[]\n  invoiceStatus?: InvoiceStatus[]\n  paymentTerms?: string[]\n  company?: string[]\n  buyer?: string[]\n  branch?: string[]\n  products?: string\n  purchaseOrder?: string\n  costCenter?: string\n}\n\nexport type OrdersQuery = {\n  search: string\n  quick: QuickFilterId\n  filters: FilterSelection\n  date?: { preset: DatePreset; from?: string; to?: string }\n  amount?: { min?: number; max?: number; currency: string }\n  sort: SortId\n  page: number\n  pageSize: number\n}\n\nexport type OrdersPage = {\n  items: OrderRecord[]\n  /** Matching the full query, quick filter included. */\n  total: number\n  /** Authorised orders with search and filters cleared. */\n  totalAll: number\n  pageCount: number\n  counts?: Record<QuickFilterId, number>\n  /** Partial failure: the results are still valid. */\n  warning?: boolean\n}\n\nexport interface OrdersPort {\n  list(query: OrdersQuery, options?: { signal?: AbortSignal }): Promise<OrdersPage>\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/ports/order-history.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=order-history.mjs.map

package/dist/ports/order-history.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thorprovider/blocks",
-  "version": "4.1.0",
+  "version": "4.3.0",
   "description": "Reusable, framework-agnostic React component blocks for Thor Commerce storefronts.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -28,6 +28,13 @@
       "require": "./dist/lib/contracts.js",
       "default": "./dist/lib/contracts.mjs"
     },
+    "./ports": {
+      "types": "./dist/ports/index.d.ts",
+      "development": "./dist/ports/index.mjs",
+      "import": "./dist/ports/index.mjs",
+      "require": "./dist/ports/index.js",
+      "default": "./dist/ports/index.mjs"
+    },
     "./styles.css": "./styles.css",
     "./*": {
       "types": "./dist/*.d.ts",
@@ -48,7 +55,7 @@
     "preaudit": "yarn build",
     "workflow": "node audit/workflow.mjs",
     "subagent": "node audit/subagent.mjs",
-    "audit:test": "node --test audit/resolve-block.test.mjs audit/workflow.test.mjs",
+    "audit:test": "node --test audit/resolve-block.test.mjs audit/block-catalog.test.mjs audit/workflow.test.mjs",
     "audit:type-check": "yarn build && tsc -p audit/tsconfig.json --noEmit",
     "generate:agent-index": "node ../../scripts/generate-package-agents-index.cjs packages/blocks @thorprovider/blocks"
   },
@@ -64,7 +71,7 @@
   "license": "MIT",
   "dependencies": {
     "@base-ui/react": "^1.8.0",
-    "@thorprovider/types": "^7.3.0",
+    "@thorprovider/types": "^7.5.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cn": "^0.4.0",