@thorprovider/types 5.7.0 → 5.7.1

package/dist/index.d.mts

@@ -1992,6 +1992,7 @@ interface SubmitApplicationBody {
     selfie_url: string;
     additional_comments?: string | null;
     consent: boolean;
+    turnstile_token: string;
 }
 /**
  * Aplicación creada, devuelta en la respuesta 201 de
@@ -2043,6 +2044,10 @@ type SubmitApplicationResult = {
     ok: false;
     reason: 'rate_limited';
     retryAfterSeconds: number;
+} | {
+    ok: false;
+    reason: 'challenge_failed';
+    message?: string;
 } | {
     ok: false;
     reason: 'invalid_data';
@@ -4397,7 +4402,16 @@ interface DropshipperOrderItem {
     profit: DropshipperItemProfit;
     metadata: null;
 }
-/** Order totals with profit breakdown */
+/**
+ * Order totals with profit breakdown.
+ *
+ * All monetary fields (`subtotal`, `tax_total`, `shipping_total`,
+ * `discount_total`, `total`, `net_revenue`, `cost_total`, `profit`) are
+ * expressed in MINOR units of the order's `currency_code` (e.g. cents for
+ * two-decimal currencies; the raw integer for zero-decimal currencies such as
+ * JPY). `margin_percent` is unitless. Consumers must NOT apply a fixed `/100`;
+ * divide by `10^minorDigits(currencyCode)` only at the presentation boundary.
+ */
 interface DropshipperOrderTotals {
     subtotal: number;
     tax_total: number;
@@ -4409,7 +4423,14 @@ interface DropshipperOrderTotals {
     profit: number;
     margin_percent: number;
 }
-/** Timeline event on an order */
+/**
+ * Timeline event on an order.
+ *
+ * `amount` (when present) is expressed in MINOR units of `currency_code`
+ * (e.g. cents for two-decimal currencies). Historical events may not carry
+ * `amount`/`currency_code`; when absent, consumers must fall back to the raw
+ * `description` text and MUST NOT apply any unit conversion.
+ */
 interface DropshipperOrderTimelineEvent {
     id: string;
     code: string;
@@ -4417,6 +4438,10 @@ interface DropshipperOrderTimelineEvent {
     description: string;
     type: "info" | "success" | "warning" | "error";
     timestamp: string;
+    /** Amount in minor units of `currency_code` (payment/refund events). */
+    amount?: number;
+    /** Currency the `amount` is expressed in (payment/refund events). */
+    currency_code?: string;
 }
 /** Payment collection on an order */
 interface DropshipperPaymentSession {
@@ -4628,7 +4653,17 @@ interface DropshipperOrderFulfillment {
     items: DropshipperFulfillmentItem[];
     labels: DropshipperFulfillmentLabel[];
 }
-/** Full order detail as returned by GET /admin/thor/dropshipper/orders/:id */
+/**
+ * Full order detail as returned by GET /admin/thor/dropshipper/orders/:id.
+ *
+ * All monetary fields across the payload (order totals, items, shipping
+ * methods, payment collections, returns, exchanges/claims, transactions,
+ * financial summary, timeline `amount`) are expressed in MINOR units of the
+ * order's `currency_code` (e.g. cents for two-decimal currencies; the raw
+ * integer for zero-decimal currencies such as JPY). Consumers must NOT apply
+ * a fixed `/100`; divide by `10^minorDigits(currencyCode)` only at the
+ * presentation boundary.
+ */
 interface DropshipperOrderDetail {
     id: string;
     display_id: number;

package/dist/index.d.ts

@@ -1992,6 +1992,7 @@ interface SubmitApplicationBody {
     selfie_url: string;
     additional_comments?: string | null;
     consent: boolean;
+    turnstile_token: string;
 }
 /**
  * Aplicación creada, devuelta en la respuesta 201 de
@@ -2043,6 +2044,10 @@ type SubmitApplicationResult = {
     ok: false;
     reason: 'rate_limited';
     retryAfterSeconds: number;
+} | {
+    ok: false;
+    reason: 'challenge_failed';
+    message?: string;
 } | {
     ok: false;
     reason: 'invalid_data';
@@ -4397,7 +4402,16 @@ interface DropshipperOrderItem {
     profit: DropshipperItemProfit;
     metadata: null;
 }
-/** Order totals with profit breakdown */
+/**
+ * Order totals with profit breakdown.
+ *
+ * All monetary fields (`subtotal`, `tax_total`, `shipping_total`,
+ * `discount_total`, `total`, `net_revenue`, `cost_total`, `profit`) are
+ * expressed in MINOR units of the order's `currency_code` (e.g. cents for
+ * two-decimal currencies; the raw integer for zero-decimal currencies such as
+ * JPY). `margin_percent` is unitless. Consumers must NOT apply a fixed `/100`;
+ * divide by `10^minorDigits(currencyCode)` only at the presentation boundary.
+ */
 interface DropshipperOrderTotals {
     subtotal: number;
     tax_total: number;
@@ -4409,7 +4423,14 @@ interface DropshipperOrderTotals {
     profit: number;
     margin_percent: number;
 }
-/** Timeline event on an order */
+/**
+ * Timeline event on an order.
+ *
+ * `amount` (when present) is expressed in MINOR units of `currency_code`
+ * (e.g. cents for two-decimal currencies). Historical events may not carry
+ * `amount`/`currency_code`; when absent, consumers must fall back to the raw
+ * `description` text and MUST NOT apply any unit conversion.
+ */
 interface DropshipperOrderTimelineEvent {
     id: string;
     code: string;
@@ -4417,6 +4438,10 @@ interface DropshipperOrderTimelineEvent {
     description: string;
     type: "info" | "success" | "warning" | "error";
     timestamp: string;
+    /** Amount in minor units of `currency_code` (payment/refund events). */
+    amount?: number;
+    /** Currency the `amount` is expressed in (payment/refund events). */
+    currency_code?: string;
 }
 /** Payment collection on an order */
 interface DropshipperPaymentSession {
@@ -4628,7 +4653,17 @@ interface DropshipperOrderFulfillment {
     items: DropshipperFulfillmentItem[];
     labels: DropshipperFulfillmentLabel[];
 }
-/** Full order detail as returned by GET /admin/thor/dropshipper/orders/:id */
+/**
+ * Full order detail as returned by GET /admin/thor/dropshipper/orders/:id.
+ *
+ * All monetary fields across the payload (order totals, items, shipping
+ * methods, payment collections, returns, exchanges/claims, transactions,
+ * financial summary, timeline `amount`) are expressed in MINOR units of the
+ * order's `currency_code` (e.g. cents for two-decimal currencies; the raw
+ * integer for zero-decimal currencies such as JPY). Consumers must NOT apply
+ * a fixed `/100`; divide by `10^minorDigits(currencyCode)` only at the
+ * presentation boundary.
+ */
 interface DropshipperOrderDetail {
     id: string;
     display_id: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thorprovider/types",
-  "version": "5.7.0",
+  "version": "5.7.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

@@ -617,7 +617,16 @@ export interface DropshipperOrderItem {
   metadata: null;
 }
 
-/** Order totals with profit breakdown */
+/**
+ * Order totals with profit breakdown.
+ *
+ * All monetary fields (`subtotal`, `tax_total`, `shipping_total`,
+ * `discount_total`, `total`, `net_revenue`, `cost_total`, `profit`) are
+ * expressed in MINOR units of the order's `currency_code` (e.g. cents for
+ * two-decimal currencies; the raw integer for zero-decimal currencies such as
+ * JPY). `margin_percent` is unitless. Consumers must NOT apply a fixed `/100`;
+ * divide by `10^minorDigits(currencyCode)` only at the presentation boundary.
+ */
 export interface DropshipperOrderTotals {
   subtotal: number;
   tax_total: number;
@@ -630,7 +639,14 @@ export interface DropshipperOrderTotals {
   margin_percent: number;
 }
 
-/** Timeline event on an order */
+/**
+ * Timeline event on an order.
+ *
+ * `amount` (when present) is expressed in MINOR units of `currency_code`
+ * (e.g. cents for two-decimal currencies). Historical events may not carry
+ * `amount`/`currency_code`; when absent, consumers must fall back to the raw
+ * `description` text and MUST NOT apply any unit conversion.
+ */
 export interface DropshipperOrderTimelineEvent {
   id: string;
   code: string;
@@ -638,6 +654,10 @@ export interface DropshipperOrderTimelineEvent {
   description: string;
   type: "info" | "success" | "warning" | "error";
   timestamp: string;
+  /** Amount in minor units of `currency_code` (payment/refund events). */
+  amount?: number;
+  /** Currency the `amount` is expressed in (payment/refund events). */
+  currency_code?: string;
 }
 
 /** Payment collection on an order */
@@ -869,7 +889,17 @@ export interface DropshipperOrderFulfillment {
   labels: DropshipperFulfillmentLabel[];
 }
 
-/** Full order detail as returned by GET /admin/thor/dropshipper/orders/:id */
+/**
+ * Full order detail as returned by GET /admin/thor/dropshipper/orders/:id.
+ *
+ * All monetary fields across the payload (order totals, items, shipping
+ * methods, payment collections, returns, exchanges/claims, transactions,
+ * financial summary, timeline `amount`) are expressed in MINOR units of the
+ * order's `currency_code` (e.g. cents for two-decimal currencies; the raw
+ * integer for zero-decimal currencies such as JPY). Consumers must NOT apply
+ * a fixed `/100`; divide by `10^minorDigits(currencyCode)` only at the
+ * presentation boundary.
+ */
 export interface DropshipperOrderDetail {
   id: string;
   display_id: number;

package/src/auth.ts

@@ -245,6 +245,7 @@ export interface SubmitApplicationBody {
   selfie_url: string;
   additional_comments?: string | null;
   consent: boolean;
+  turnstile_token: string;
 }
 
 /**
@@ -293,6 +294,7 @@ export type SubmitApplicationResult =
   | { ok: true; application: SubmitApplicationCreated }
   | { ok: false; reason: 'conflict'; application: SubmitApplicationConflictApplication }
   | { ok: false; reason: 'rate_limited'; retryAfterSeconds: number }
+  | { ok: false; reason: 'challenge_failed'; message?: string }
   | { ok: false; reason: 'invalid_data'; fields?: Record<string, string[]> };
 
 /**