@thorprovider/types 5.5.1 → 5.6.1

package/dist/index.d.mts

@@ -4107,7 +4107,24 @@ interface ValidateCheckoutItemsRequest {
 /** Per-variant result in the validate checkout response */
 interface ValidatedCheckoutItem {
     variant_id: string;
+    /**
+     * Disponibilidad agregada del canal (suma de locations). Se conserva para
+     * compatibilidad; el límite Modelo A real es `maxSingleLocationAvailability`.
+     */
     availableQuantity: number;
+    /**
+     * Mayor capacidad de un solo almacén del canal para servir el ítem completo.
+     * `null` cuando `manageInventory=false` o `allowBackorder=true` (el backend no
+     * computa el gate single-location en esos casos).
+     */
+    maxSingleLocationAvailability: number | null;
+    /** Almacenes del canal que pueden servir la cantidad pedida completa. */
+    eligibleLocations: string[];
+    /**
+     * `true` cuando la cantidad pedida excede la capacidad de todo almacén del
+     * canal (`maxSingleLocationAvailability < quantity`). Es el veredicto Modelo A.
+     */
+    exceeds_max_stock: boolean;
     sale_price: number;
     cost_price: number;
     manageInventory: boolean;
@@ -4541,6 +4558,45 @@ interface DropshipperShippingMethod {
     shipping_profile_id?: string;
     stock_location_id?: string;
 }
+/** An outbound item added to the order by an exchange or a claim */
+interface DropshipperOrderChangeItem {
+    /** Id of the added order line item (order_item.id) */
+    item_id: string;
+    quantity: number;
+    note?: string | null;
+}
+/** An inbound claim item (what is being returned under the claim) */
+interface DropshipperClaimItem extends DropshipperOrderChangeItem {
+    reason?: string | null;
+}
+/** An exchange on an order (read-only; created and managed by the provider) */
+interface DropshipperOrderExchange {
+    id: string;
+    display_id: number;
+    /** Live state of the linked order change (pending, confirmed, canceled, ...) */
+    status: string;
+    difference_due: number;
+    created_at: string;
+    canceled_at: string | null;
+    /** Return associated with the exchange inbound items, when present */
+    return_id?: string | null;
+    additional_items: DropshipperOrderChangeItem[];
+}
+/** A claim on an order (read-only; created and managed by the provider) */
+interface DropshipperOrderClaim {
+    id: string;
+    display_id: number;
+    type: 'refund' | 'replace';
+    /** Live state of the linked order change (pending, confirmed, canceled, ...) */
+    status: string;
+    refund_amount: number;
+    created_at: string;
+    canceled_at: string | null;
+    /** Outbound items added by the claim (replacement items) */
+    additional_items: DropshipperOrderChangeItem[];
+    /** Inbound items being claimed */
+    items: DropshipperClaimItem[];
+}
 /** Full order detail as returned by GET /admin/thor/dropshipper/orders/:id */
 interface DropshipperOrderDetail {
     id: string;
@@ -4562,6 +4618,10 @@ interface DropshipperOrderDetail {
     shipping_methods: DropshipperShippingMethod[];
     payment_collections: DropshipperPaymentCollection[];
     returns: DropshipperReturn[];
+    /** Exchanges on the order, read-only (contract v3, optional) */
+    exchanges?: DropshipperOrderExchange[];
+    /** Claims on the order, read-only (contract v3, optional) */
+    claims?: DropshipperOrderClaim[];
     transactions: DropshipperTransaction[];
     financial_summary: DropshipperFinancialSummary;
     timeline: DropshipperOrderTimelineEvent[];

package/dist/index.d.ts

@@ -4107,7 +4107,24 @@ interface ValidateCheckoutItemsRequest {
 /** Per-variant result in the validate checkout response */
 interface ValidatedCheckoutItem {
     variant_id: string;
+    /**
+     * Disponibilidad agregada del canal (suma de locations). Se conserva para
+     * compatibilidad; el límite Modelo A real es `maxSingleLocationAvailability`.
+     */
     availableQuantity: number;
+    /**
+     * Mayor capacidad de un solo almacén del canal para servir el ítem completo.
+     * `null` cuando `manageInventory=false` o `allowBackorder=true` (el backend no
+     * computa el gate single-location en esos casos).
+     */
+    maxSingleLocationAvailability: number | null;
+    /** Almacenes del canal que pueden servir la cantidad pedida completa. */
+    eligibleLocations: string[];
+    /**
+     * `true` cuando la cantidad pedida excede la capacidad de todo almacén del
+     * canal (`maxSingleLocationAvailability < quantity`). Es el veredicto Modelo A.
+     */
+    exceeds_max_stock: boolean;
     sale_price: number;
     cost_price: number;
     manageInventory: boolean;
@@ -4541,6 +4558,45 @@ interface DropshipperShippingMethod {
     shipping_profile_id?: string;
     stock_location_id?: string;
 }
+/** An outbound item added to the order by an exchange or a claim */
+interface DropshipperOrderChangeItem {
+    /** Id of the added order line item (order_item.id) */
+    item_id: string;
+    quantity: number;
+    note?: string | null;
+}
+/** An inbound claim item (what is being returned under the claim) */
+interface DropshipperClaimItem extends DropshipperOrderChangeItem {
+    reason?: string | null;
+}
+/** An exchange on an order (read-only; created and managed by the provider) */
+interface DropshipperOrderExchange {
+    id: string;
+    display_id: number;
+    /** Live state of the linked order change (pending, confirmed, canceled, ...) */
+    status: string;
+    difference_due: number;
+    created_at: string;
+    canceled_at: string | null;
+    /** Return associated with the exchange inbound items, when present */
+    return_id?: string | null;
+    additional_items: DropshipperOrderChangeItem[];
+}
+/** A claim on an order (read-only; created and managed by the provider) */
+interface DropshipperOrderClaim {
+    id: string;
+    display_id: number;
+    type: 'refund' | 'replace';
+    /** Live state of the linked order change (pending, confirmed, canceled, ...) */
+    status: string;
+    refund_amount: number;
+    created_at: string;
+    canceled_at: string | null;
+    /** Outbound items added by the claim (replacement items) */
+    additional_items: DropshipperOrderChangeItem[];
+    /** Inbound items being claimed */
+    items: DropshipperClaimItem[];
+}
 /** Full order detail as returned by GET /admin/thor/dropshipper/orders/:id */
 interface DropshipperOrderDetail {
     id: string;
@@ -4562,6 +4618,10 @@ interface DropshipperOrderDetail {
     shipping_methods: DropshipperShippingMethod[];
     payment_collections: DropshipperPaymentCollection[];
     returns: DropshipperReturn[];
+    /** Exchanges on the order, read-only (contract v3, optional) */
+    exchanges?: DropshipperOrderExchange[];
+    /** Claims on the order, read-only (contract v3, optional) */
+    claims?: DropshipperOrderClaim[];
     transactions: DropshipperTransaction[];
     financial_summary: DropshipperFinancialSummary;
     timeline: DropshipperOrderTimelineEvent[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thorprovider/types",
-  "version": "5.5.1",
+  "version": "5.6.1",
   "description": "Shared TypeScript types for Thor Commerce ecosystem - Framework-agnostic type definitions",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/admin/DropshippingAdmin.ts

@@ -302,7 +302,24 @@ export interface ValidateCheckoutItemsRequest {
 /** Per-variant result in the validate checkout response */
 export interface ValidatedCheckoutItem {
   variant_id: string
+  /**
+   * Disponibilidad agregada del canal (suma de locations). Se conserva para
+   * compatibilidad; el límite Modelo A real es `maxSingleLocationAvailability`.
+   */
   availableQuantity: number
+  /**
+   * Mayor capacidad de un solo almacén del canal para servir el ítem completo.
+   * `null` cuando `manageInventory=false` o `allowBackorder=true` (el backend no
+   * computa el gate single-location en esos casos).
+   */
+  maxSingleLocationAvailability: number | null
+  /** Almacenes del canal que pueden servir la cantidad pedida completa. */
+  eligibleLocations: string[]
+  /**
+   * `true` cuando la cantidad pedida excede la capacidad de todo almacén del
+   * canal (`maxSingleLocationAvailability < quantity`). Es el veredicto Modelo A.
+   */
+  exceeds_max_stock: boolean
   sale_price: number
   cost_price: number
   manageInventory: boolean
@@ -775,6 +792,49 @@ export interface DropshipperShippingMethod {
   stock_location_id?: string;
 }
 
+/** An outbound item added to the order by an exchange or a claim */
+export interface DropshipperOrderChangeItem {
+  /** Id of the added order line item (order_item.id) */
+  item_id: string;
+  quantity: number;
+  note?: string | null;
+}
+
+/** An inbound claim item (what is being returned under the claim) */
+export interface DropshipperClaimItem extends DropshipperOrderChangeItem {
+  reason?: string | null;
+}
+
+/** An exchange on an order (read-only; created and managed by the provider) */
+export interface DropshipperOrderExchange {
+  id: string;
+  display_id: number;
+  /** Live state of the linked order change (pending, confirmed, canceled, ...) */
+  status: string;
+  difference_due: number;
+  created_at: string;
+  canceled_at: string | null;
+  /** Return associated with the exchange inbound items, when present */
+  return_id?: string | null;
+  additional_items: DropshipperOrderChangeItem[];
+}
+
+/** A claim on an order (read-only; created and managed by the provider) */
+export interface DropshipperOrderClaim {
+  id: string;
+  display_id: number;
+  type: 'refund' | 'replace';
+  /** Live state of the linked order change (pending, confirmed, canceled, ...) */
+  status: string;
+  refund_amount: number;
+  created_at: string;
+  canceled_at: string | null;
+  /** Outbound items added by the claim (replacement items) */
+  additional_items: DropshipperOrderChangeItem[];
+  /** Inbound items being claimed */
+  items: DropshipperClaimItem[];
+}
+
 /** Full order detail as returned by GET /admin/thor/dropshipper/orders/:id */
 export interface DropshipperOrderDetail {
   id: string;
@@ -794,6 +854,10 @@ export interface DropshipperOrderDetail {
   shipping_methods: DropshipperShippingMethod[];
   payment_collections: DropshipperPaymentCollection[];
   returns: DropshipperReturn[];
+  /** Exchanges on the order, read-only (contract v3, optional) */
+  exchanges?: DropshipperOrderExchange[];
+  /** Claims on the order, read-only (contract v3, optional) */
+  claims?: DropshipperOrderClaim[];
   transactions: DropshipperTransaction[];
   financial_summary: DropshipperFinancialSummary;
   timeline: DropshipperOrderTimelineEvent[];