@fire-spark/core 0.3.1 → 0.3.3

package/dist/index.d.ts

@@ -264,6 +264,13 @@ declare const updateOrder: (id: string, body: OrderUpdateInput, options?: Servic
 declare const cancelOrder: (id: string, options?: ServiceHttpOptions) => Promise<Order$1>;
 declare const refundOrder: (id: string, options?: ServiceHttpOptions) => Promise<Order$1>;
 declare const reorderOrder: (id: string, body?: OrderReorderInput, options?: ServiceHttpOptions) => Promise<Order$1>;
+/**
+ * `POST /storefront/v1/orders/:id/reopen`: voids every payment of a placed,
+ * unpaid order, cancels it (`VOIDED`) and returns the new `OPEN` order with
+ * the same content. Rejects with `StorefrontHttpError` 400
+ * (`details.code: "ORDER_PAYMENT_CAPTURED"`) when a payment was captured.
+ */
+declare const reopenOrder: (id: string, options?: ServiceHttpOptions) => Promise<Order$1>;
 declare const validateOrder: (body: OrderValidateInput, options?: ServiceHttpOptions) => Promise<OrderValidateOutput>;
 //#endregion
 //#region src/order/payments/orchestrator.d.ts
@@ -451,11 +458,18 @@ declare class Order {
   private readonly listeners;
   private readonly externalNotify?;
   private readonly http;
+  private readonly debounceMs;
   private readonly flush;
   private readonly payments;
   /** Real tenders chosen with `setTenders`; REDEMPTION ones come from redeem. */
   private realTenders;
   private readonly redemptionProviders;
+  /**
+   * Redeems as applied, before the D18 cap trims payment amounts. The cap
+   * is re-derived from these on every edit, so a redeem trimmed while the
+   * total was low recovers its amount once the total grows back.
+   */
+  private requestedRedeem;
   private constructor();
   /**
    * Opens a cart session: reuses an existing OPEN order for the scope, or a
@@ -528,9 +542,23 @@ declare class Order {
     billing_info?: Order$1["customer"]["billing_info"];
   }): void;
   cancelOrder(): Promise<void>;
+  /**
+   * Reopens this placed, unpaid order: the server voids every payment
+   * (REDEMPTION points released), cancels it as `VOIDED` and opens a new
+   * `OPEN` order with the same content. This instance is closed afterwards;
+   * replace it with the returned `Order` (same HTTP options and listener).
+   *
+   * Rejects with `StorefrontHttpError` 400 and
+   * `details.code: "ORDER_PAYMENT_CAPTURED"` when a payment was already
+   * captured; nothing changes then and this instance stays usable.
+   */
+  reopen(): Promise<Order>;
   refundOrder(): Promise<void>;
   validateOrder(): Promise<void>;
-  /** Tenders of the next intent: real ones plus one per payment redeem. */
+  /**
+   * Tenders of the next intent: real ones plus one per payment redeem.
+   * When the payment redeems cover the total, only REDEMPTION tenders.
+   */
   getTenders(payment?: PlaceOrderInput["payment"]): PaymentTenderInput[];
   /**
    * Chooses the real tenders (with allocation for mixed payments) and saves
@@ -542,6 +570,9 @@ declare class Order {
   clearTenders(): Promise<Order$1>;
   private syncPaymentIntent;
   private applyServerOrder;
+  /** Keeps the applied redeems while the server holds the same capped ones. */
+  private replaceDraft;
+  private appliedRedeem;
   /**
    * Places the order with a DRAFT intent: `intent_id` as is, else the
    * tenders of `getTenders(input.payment)` saved first (simple flow: one
@@ -959,6 +990,7 @@ declare const services: {
     cancel: typeof cancelOrder;
     refund: typeof refundOrder;
     reorder: typeof reorderOrder;
+    reopen: typeof reopenOrder;
     validate: typeof validateOrder;
     place: typeof placeOrder;
     recordPayment: typeof recordOrderPayment;