@mohasinac/appkit 4.71.0 → 4.71.2

package/dist/features/orders/schemas/firestore.d.ts

@@ -9,23 +9,25 @@ import type { StatusChangeEntry } from "../../../_internal/shared/history/index"
 import type { ReturnReason } from "../../../_internal/shared/features/orders/return-reasons";
 import type { DisputeKind } from "../../../_internal/shared/features/orders/dispute-reasons";
 import type { ReturnCustodyState } from "../../../_internal/shared/features/returns/custody";
+import type { OrderPolicyConsent } from "../../../_internal/shared/checkout/policy-consent";
 import type { ActualShipmentCost, SelectedShippingQuote, ShippingReconciliation } from "../../../_internal/shared/shipping/quote";
+import type { ShippingObligation } from "../../../_internal/shared/features/shipping/offer";
 import type { Encrypted, Plaintext } from "../../../security/encrypted";
 export interface OrderSourceStandard {
     path: "standard";
     listPrice: number;
 }
-export interface OrderSourceAuctionWon {
-    path: "auction-won";
-    auctionId: string;
+export interface OrderSourceCollectorDropWon {
+    path: "collector-drop-won";
+    collectorDropId: string;
     bidId: string;
     winningBidAmount: number;
-    /** Bids placed across the whole auction — the "against N bidders" figure. */
+    /** Bids placed across the whole collector drop — the "against N bidders" figure. */
     bidCount: number;
     startingBid: number;
     reservePrice?: number;
     reserveMet: boolean;
-    auctionEndedAt: Date;
+    collectorDropEndedAt: Date;
     /** Second-highest bid, when there was one. */
     runnerUpAmount?: number;
 }
@@ -34,8 +36,8 @@ export interface OrderSourceAuctionWon {
  *
  * An earlier draft of this type asserted "zero bids BY DEFINITION, because
  * buy-now is only valid while `!bidsHaveStarted`". That gate no longer
- * exists: `buyNowAuction` places an actual `BidDocument` (`isBuyout: true`)
- * plus a 1h locked cart line and leaves the auction **live**, and Buy Now is
+ * exists: `buyNowCollectorDrop` places an actual `BidDocument` (`isBuyout: true`)
+ * plus a 1h locked cart line and leaves the collector drop **live**, and Buy Now is
  * offered whenever `buyNowPrice` still beats the standing bid. Recording
  * `bidCount: 0` would bake a falsehood into an immutable audit record.
  *
@@ -45,11 +47,11 @@ export interface OrderSourceAuctionWon {
  *
  * An unpaid buyout lapses to **`cancelled`**, not `forfeited`, and the seller
  * is deliberately not notified: nothing was ever sold. That makes its
- * timeline materially different from a lapsed auction win.
+ * timeline materially different from a lapsed collector drop win.
  */
-export interface OrderSourceAuctionBuyNow {
-    path: "auction-buy-now";
-    auctionId: string;
+export interface OrderSourceCollectorDropBuyNow {
+    path: "collector-drop-buy-now";
+    collectorDropId: string;
     /** The buyout bid itself — a buyout IS a bid. */
     bidId: string;
     buyNowPrice: number;
@@ -59,9 +61,9 @@ export interface OrderSourceAuctionBuyNow {
     /** Active non-buyout bids at buyout time. NOT always zero. */
     bidCount: number;
     boughtAt: Date;
-    /** `min(now + AUCTION_BUYOUT_WINDOW_MS, auctionEndDate)`. */
+    /** `min(now + COLLECTOR_DROP_BUYOUT_WINDOW_MS, collectorDropEndDate)`. */
     checkoutDeadline: Date;
-    auctionEndDate?: Date;
+    collectorDropEndDate?: Date;
 }
 export interface OrderSourceOfferAccepted {
     path: "offer-accepted";
@@ -90,14 +92,14 @@ export interface OrderSourcePreOrder {
     balanceDue: number;
     expectedDeliveryDate?: Date;
 }
-export interface OrderSourcePrizeDraw {
-    path: "prize-draw";
+export interface OrderSourceClearance {
+    path: "clearance";
     prizeDrawProductId: string;
     pricePerEntry: number;
     entryCount: number;
     revealMode: "instant" | "scheduled";
 }
-export type OrderSourceContext = OrderSourceStandard | OrderSourceAuctionWon | OrderSourceAuctionBuyNow | OrderSourceOfferAccepted | OrderSourcePreOrder | OrderSourcePrizeDraw;
+export type OrderSourceContext = OrderSourceStandard | OrderSourceCollectorDropWon | OrderSourceCollectorDropBuyNow | OrderSourceOfferAccepted | OrderSourcePreOrder | OrderSourceClearance;
 /** Manual shipping is the only supported method — sellers enter carrier + tracking directly, no carrier API integration. */
 export type ShippingMethod = "custom";
 export type RefundType = "full" | "partial";
@@ -302,8 +304,79 @@ export interface OrderDocumentItem {
      * with the same stats, and one is rare and costly.
      */
     colourway?: string;
-    /** SB8-F â€" per-item reveal status; flips through pending â†' open â†' revealed/closed. */
+    /**
+     * SB8-F — per-item reveal status; flips through pending → open →
+     * revealed/closed.
+     *
+     * 🛑 THIS IS THE REVEAL STATE. There is deliberately no second
+     * `revealState` field beside it: the workflow registry's `RevealState`
+     * ("unrevealed" | "revealed") is a NORMALISED VIEW of this one, derived in
+     * `assertCancellable`, and a stored duplicate would be two fields that can
+     * disagree about whether a buyer has seen their item — on the field the
+     * cancel/refund gate reads. One fact, one home.
+     *
+     * ⚠ NAMING, flagged not fixed: `prize*` names a mechanism (a draw) on what
+     * is now a generic capability — `supportsSurpriseReveal` is a flag any
+     * listing type may carry. The honest name is `revealState`, but renaming it
+     * collides with the PRODUCT-level `prizeRevealStatus` (a different,
+     * three-state draw status) and is the size of the `collector-drop`/`bids`
+     * rename, so it belongs with that lane, not half-done here.
+     */
     prizeRevealStatus?: "pending" | "open" | "closed" | "revealed";
+    /**
+     * When the concealed contents of THIS line became visible to the buyer.
+     *
+     * 🛑 On the order ITEM, never the product: two buyers of the same concealed
+     * product are in different states, and this is the timestamp a dispute is
+     * adjudicated against ("the reveal happened before the cancellation
+     * request", "the reveal happened at shipment, not at the seller's
+     * convenience"). `prizeWon.wonAt` on the ORDER records when the platform
+     * ALLOCATED; this records when the BUYER SAW. They are the same instant for
+     * immediate-reveal clearance and days apart for a delayed reveal, so one
+     * field cannot answer both.
+     */
+    revealedAt?: Date;
+    /**
+     * The id of the immutable `adminAuditLog` row that records how this line's
+     * concealed item was chosen.
+     *
+     * 🛑 THE ANTI-FRAUD HANDLE, and it is a pointer rather than a copy on
+     * purpose. The allocation facts live in a collection no seller can write to
+     * or update; duplicating them here would put an editable copy beside the
+     * immutable one, and a dispute would then have two answers. This field is
+     * what lets a buyer, an admin or a support agent go from "my order" to "the
+     * record of why I got this one" in a single lookup.
+     *
+     * Written inside the allocation transaction (`clearanceAssignWinner`) and
+     * never set or changed by any seller-reachable path. Absent on every line
+     * allocated before this field existed, which is why no reader may treat its
+     * absence as tampering.
+     */
+    allocationId?: string;
+    /**
+     * Where a NON-SHIPPED line is in its fulfilment, when fulfilment is not
+     * automatic.
+     *
+     * 🛑 Only ever set on a line whose resolved `fulfilmentModeFor()` is
+     * `"manual-digital"`. A shipped line's fulfilment state is the order's own
+     * `shipped`/`delivered` status plus its shipment record, and an
+     * instant-digital line is fulfilled before any UI could show a state — so
+     * writing this on either would be a second, weaker copy of a fact the
+     * lifecycle already holds.
+     *
+     *   `"pending_release"` — paid, nothing delivered, waiting on a human
+     *   `"released"`        — the seller released it; content is claimable
+     *
+     * The state exists because the alternative is invisible failure: before it,
+     * a `codeDeliveryMethod: "manual-email"` listing auto-claimed anyway, and a
+     * genuinely manual flow would have left a paid order looking identical to a
+     * fulfilled one.
+     */
+    fulfilmentState?: "pending_release" | "released";
+    /** When the seller/staff released a `pending_release` line. */
+    releasedAt?: Date;
+    /** Uid of whoever released it — a human act, so it is attributed. */
+    releasedBy?: string;
     /** Set when the buyer cancels this specific line item post-order (partial cancellation). */
     cancelledQuantity?: number;
     cancelledAt?: Date;
@@ -498,13 +571,13 @@ export interface OrderDocument extends BaseDocument {
     items?: OrderDocumentItem[];
     orderType?: OrderType;
     /**
-     * True when this `orderType: "auction"` order came from Buy Now rather than
+     * True when this `orderType: "collector-drop"` order came from Buy Now rather than
      * from winning the bidding.
      *
      * Not a new `orderType` value on purpose — the /user/orders tabs key on
-     * `orderType`, and a buyout IS an auction order from the buyer's point of
+     * `orderType`, and a buyout IS a collector drop order from the buyer's point of
      * view. What it changes is the ADMIN review window: a buyout is settled in a
-     * one-hour scramble against a still-live auction, so `paymentReviewAutoApprove`
+     * one-hour scramble against a still-live collector drop, so `paymentReviewAutoApprove`
      * gives an admin a full day to verify its proof instead of the usual couple of
      * hours before auto-approving.
      */
@@ -1032,6 +1105,34 @@ export interface OrderDocument extends BaseDocument {
      * was taken", never as zero.
      */
     selectedShippingQuote?: SelectedShippingQuote;
+    /**
+     * WHICH SHIPPING METHOD THE BUYER BOUGHT, and therefore what the seller owes.
+     *
+     * Owner, 2026-11-08: *"if they have selected that, then it is up to the
+     * seller to fulfil as is, they cannot use the platform to ship for the other,
+     * as we have already taken money from the customer. If however they need to
+     * override it, they can refund the excess if any, and in case if they needed
+     * to pay more for their custom shipping than what the buyer paid they have to
+     * swallow that money as a loss."*
+     *
+     * 🛑 Distinct from `selectedShippingQuote` above, which exists only when a
+     * CARRIER quoted the parcel. This exists whenever shipping was charged at
+     * all, including when the buyer bought the seller's own ₹200 rate — and that
+     * case is precisely the one with a fulfilment obligation attached, so it
+     * cannot be recorded in a field whose shape presumes a courier.
+     *
+     * 🛑 Written at checkout, never recomputed, because the decision is made at
+     * checkout and the rule is broken at pack time — days later, by a different
+     * person, on a different screen. `mayBookPlatformLabel(order)` is the gate
+     * that reads it. Absence means the order predates this field and fails open;
+     * see that function's note for why, and for the identical hazard
+     * `isReimbursableShipment` carries.
+     *
+     * 🛑 Absent on a group that was charged ₹0 shipping (a later group in a
+     * multi-seller cart, or a cart with no shippable line) — an obligation
+     * without a payment behind it would bind a seller to a price nobody paid.
+     */
+    shippingObligation?: ShippingObligation;
     /**
      * What the seller actually spent on postage, recorded at dispatch.
      *
@@ -1158,7 +1259,62 @@ export interface OrderDocument extends BaseDocument {
     shippingLabelUrl?: string;
     payoutStatus?: OrderPayoutStatus;
     payoutId?: string;
+    /**
+     * ── This order's seller share was settled BY THE GATEWAY at capture ───────
+     *
+     * Present only on an order collected through split settlement: the buyer's
+     * money went buyer → aggregator escrow → seller, and the platform never held
+     * this seller's share. Absent means the ordinary path — we owe them a payout.
+     *
+     * 🛑 **IT IS THE DOUBLE-PAYMENT GUARD.** `orderNeedsManualPayout`
+     * (`_internal/shared/checkout/settlement-split.ts`) is the one predicate that
+     * reads it, and both mark-shipped writers consult it before setting
+     * `payoutStatus: "eligible"`. Without that gate the weekly and automatic
+     * sweeps would create a `payouts` row for the FULL share of an order the
+     * aggregator has already paid — the seller paid twice, once from escrow and
+     * once from the platform's own balance.
+     *
+     * 🛑 A SNAPSHOT, never recomputed. It records how THIS order was collected.
+     * Re-deriving it from the store's current vendor registration would mean a
+     * store whose registration is later revoked retroactively re-acquires a
+     * payout for money it has already received (Root Cause #42).
+     *
+     * 🛑 `vendorAmount` is the share INSTRUCTED at capture, and it is deliberately
+     * NOT the whole of what the seller is owed. `computePayoutDeduction` takes a
+     * postage reimbursement and a points-earn figure that do not exist until the
+     * parcel ships, so a residue is decided later. That residue has no settlement
+     * path today — see `settlement-split.ts`' header; it is a stated gap, not an
+     * oversight to be fixed by inflating this number.
+     */
+    splitSettlement?: {
+        /** The adapter that collected and split, e.g. `"cashfree"`. */
+        gateway: string;
+        /** The gateway's vendor id for this seller — i.e. the store slug. */
+        vendorId: string;
+        /** Decimal rupees instructed to that vendor for THIS order. */
+        vendorAmount: number;
+        /** When the instruction was sent with the capture. */
+        instructedAt: Date | string;
+        /** Our own merchant order id for the capture, so the two can be joined. */
+        merchantOrderId?: string;
+    };
     offerId?: string;
+    /**
+     * THE CONSENT RECORD for this order (item 1.39).
+     *
+     * 🛑 Not a boolean. It carries the policy `version`, the `hash`, the
+     * `acceptedAt` timestamp, the buyer id and the VERBATIM clause text the
+     * buyer was shown — because the question a dispute actually asks is "what
+     * did they agree to", and `termsAccepted: true` cannot answer it. An admin
+     * rewording a clause next month must not change what this order says was
+     * accepted, which is why the text is copied here rather than pointed at.
+     *
+     * Optional on the TYPE only, for orders placed before the gate existed.
+     * Every path that creates an order now populates it — `assertBuyerPolicyConsent`
+     * throws rather than returning undefined, so a new order cannot be written
+     * without one.
+     */
+    policyConsent?: OrderPolicyConsent;
     /**
      * Populated when the linked product is a prize-draw and the reveal has
      * assigned a prize to this order. `wonAt` is the moment of assignment, not
@@ -1169,6 +1325,20 @@ export interface OrderDocument extends BaseDocument {
         title: string;
         images: string[];
         wonAt: Date;
+        /**
+         * The `adminAuditLog` row that records how this item was chosen.
+         *
+         * 🛑 Mirrored from the order LINE's `allocationId` (the canonical home —
+         * two buyers of the same concealed product are in different states, so the
+         * line is where the fact belongs). It is here as well because `prizeWon`
+         * is the object every reveal surface already reads, and an anti-fraud
+         * trace a page cannot reach without an extra derivation is a trace nobody
+         * will show. Written only by `clearanceAssignWinner`, inside the same
+         * transaction as the allocation.
+         *
+         * Absent on every order allocated before the record existed.
+         */
+        allocationId?: string;
     };
     /** Source product id when the order came from a prize-draw entry. */
     prizeDrawProductId?: string;
@@ -1207,12 +1377,12 @@ export interface OrderDocument extends BaseDocument {
      * How the buyer acquired the right to buy, written ONCE at creation.
      *
      * A discriminated union rather than optional fields, because `orderType`
-     * cannot distinguish an auction that was WON from one that was BOUGHT OUT
-     * — both are `"auction"` — and `winningBidAmount`/`bidCount` are
+     * cannot distinguish a collector drop that was WON from one that was BOUGHT OUT
+     * — both are `"collector-drop"` — and `winningBidAmount`/`bidCount` are
      * meaningless on a buy-now, where there are zero bids by definition.
      *
-     * Never recomputed: a settled auction's numbers must not move when the
-     * auction document is later archived or the product is re-priced.
+     * Never recomputed: a settled collector drop's numbers must not move when the
+     * collector drop document is later archived or the product is re-priced.
      */
     sourceContext?: OrderSourceContext;
     /**
@@ -1426,7 +1596,7 @@ export interface OrderDocument extends BaseDocument {
      */
     isTestData?: boolean;
 }
-export type OrderPaymentRecordMethod = "manual" | "phonepe" | "razorpay" | "cod";
+export type OrderPaymentRecordMethod = "manual" | "phonepe" | "razorpay" | "cashfree" | "cod";
 export type OrderPaymentVerificationMethod = "manual_review" | "webhook" | "cod_collection" | "order_status";
 export interface OrderPaymentRecord {
     method: OrderPaymentRecordMethod;
@@ -1453,6 +1623,7 @@ export interface OrderPaymentRecord {
         razorpayOrderId?: string;
         /** Razorpay's payment id (`pay_…`) — the key its refund API needs. */
         razorpayPaymentId?: string;
+        cashfreeOrderId?: string;
         transactionId?: string;
     };
 }
@@ -1517,7 +1688,7 @@ export declare const ORDER_UPDATABLE_FIELDS: readonly ["notes", "shippingAddress
  * was dropped before the order existed is not part of the order's history.
  *
  * **Acquisition is NOT tracked here either** — how the buyer got the right to
- * buy (auction won, offer accepted, bought out) is written once to
+ * buy (collector drop won, offer accepted, bought out) is written once to
  * `sourceContext` at creation. It never changes, so it is not a timeline
  * event.
  *

package/dist/features/orders/schemas/firestore.js

@@ -187,7 +187,7 @@ export const ORDER_UPDATABLE_FIELDS = ["notes", "shippingAddress"];
  * was dropped before the order existed is not part of the order's history.
  *
  * **Acquisition is NOT tracked here either** — how the buyer got the right to
- * buy (auction won, offer accepted, bought out) is written once to
+ * buy (collector drop won, offer accepted, bought out) is written once to
  * `sourceContext` at creation. It never changes, so it is not a timeline
  * event.
  *

package/dist/features/orders/schemas/index.d.ts

@@ -1,6 +1,6 @@
 export * from "./firestore";
 import { z } from "zod";
-export declare const orderListingTypeSchema: z.ZodEnum<["standard", "auction", "pre-order", "prize-draw", "classified", "digital-code", "live"]>;
+export declare const orderListingTypeSchema: z.ZodEnum<["standard", "collector-drop", "auction", "pre-order", "clearance", "classified", "digital-code", "live"]>;
 export declare const orderPaymentStatusSchema: z.ZodEnum<["pending", "processing", "paid", "failed", "refunded", "partial_refund"]>;
 export declare const orderShippingMethodSchema: z.ZodEnum<["custom"]>;
 export declare const orderRefundStatusSchema: z.ZodEnum<["pending", "processing", "completed", "rejected"]>;
@@ -88,24 +88,39 @@ export declare const orderDocumentItemSchema: z.ZodObject<{
     quantity: z.ZodNumber;
     unitPrice: z.ZodEffects<z.ZodNumber, number, number>;
     totalPrice: z.ZodEffects<z.ZodNumber, number, number>;
-    listingType: z.ZodOptional<z.ZodEnum<["standard", "auction", "pre-order", "prize-draw", "classified", "digital-code", "live"]>>;
+    listingType: z.ZodOptional<z.ZodEnum<["standard", "collector-drop", "auction", "pre-order", "clearance", "classified", "digital-code", "live"]>>;
     prizeRevealStatus: z.ZodOptional<z.ZodEnum<["pending", "open", "closed", "revealed"]>>;
+    revealedAt: z.ZodOptional<z.ZodDate>;
+    allocationId: z.ZodOptional<z.ZodString>;
+    fulfilmentState: z.ZodOptional<z.ZodEnum<["pending_release", "released"]>>;
+    releasedAt: z.ZodOptional<z.ZodDate>;
+    releasedBy: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     productId: string;
     productTitle: string;
     quantity: number;
     unitPrice: number;
     totalPrice: number;
-    listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live" | undefined;
-    prizeRevealStatus?: "pending" | "open" | "closed" | "revealed" | undefined;
+    listingType?: "standard" | "collector-drop" | "pre-order" | "clearance" | "classified" | "digital-code" | "live" | "auction" | undefined;
+    prizeRevealStatus?: "open" | "pending" | "closed" | "revealed" | undefined;
+    revealedAt?: Date | undefined;
+    allocationId?: string | undefined;
+    fulfilmentState?: "pending_release" | "released" | undefined;
+    releasedAt?: Date | undefined;
+    releasedBy?: string | undefined;
 }, {
     productId: string;
     productTitle: string;
     quantity: number;
     unitPrice: number;
     totalPrice: number;
-    listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live" | undefined;
-    prizeRevealStatus?: "pending" | "open" | "closed" | "revealed" | undefined;
+    listingType?: "standard" | "collector-drop" | "pre-order" | "clearance" | "classified" | "digital-code" | "live" | "auction" | undefined;
+    prizeRevealStatus?: "open" | "pending" | "closed" | "revealed" | undefined;
+    revealedAt?: Date | undefined;
+    allocationId?: string | undefined;
+    fulfilmentState?: "pending_release" | "released" | undefined;
+    releasedAt?: Date | undefined;
+    releasedBy?: string | undefined;
 }>;
 /**
  * Mirror of `OrderRefundEvent`.
@@ -164,8 +179,8 @@ export declare const orderRefundEventSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">;
     refundedBy: string;
     status?: "failed" | "processed" | "reserved" | undefined;
-    failureReason?: string | undefined;
     gateway?: string | undefined;
+    failureReason?: string | undefined;
     itemIds?: string[] | undefined;
     reasonCode?: string | undefined;
     gatewayRefundId?: string | undefined;
@@ -190,8 +205,8 @@ export declare const orderRefundEventSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">;
     refundedBy: string;
     status?: "failed" | "processed" | "reserved" | undefined;
-    failureReason?: string | undefined;
     gateway?: string | undefined;
+    failureReason?: string | undefined;
     itemIds?: string[] | undefined;
     reasonCode?: string | undefined;
     gatewayRefundId?: string | undefined;
@@ -297,24 +312,39 @@ export declare const orderFirestoreSchema: z.ZodObject<{
         quantity: z.ZodNumber;
         unitPrice: z.ZodEffects<z.ZodNumber, number, number>;
         totalPrice: z.ZodEffects<z.ZodNumber, number, number>;
-        listingType: z.ZodOptional<z.ZodEnum<["standard", "auction", "pre-order", "prize-draw", "classified", "digital-code", "live"]>>;
+        listingType: z.ZodOptional<z.ZodEnum<["standard", "collector-drop", "auction", "pre-order", "clearance", "classified", "digital-code", "live"]>>;
         prizeRevealStatus: z.ZodOptional<z.ZodEnum<["pending", "open", "closed", "revealed"]>>;
+        revealedAt: z.ZodOptional<z.ZodDate>;
+        allocationId: z.ZodOptional<z.ZodString>;
+        fulfilmentState: z.ZodOptional<z.ZodEnum<["pending_release", "released"]>>;
+        releasedAt: z.ZodOptional<z.ZodDate>;
+        releasedBy: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         productId: string;
         productTitle: string;
         quantity: number;
         unitPrice: number;
         totalPrice: number;
-        listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live" | undefined;
-        prizeRevealStatus?: "pending" | "open" | "closed" | "revealed" | undefined;
+        listingType?: "standard" | "collector-drop" | "pre-order" | "clearance" | "classified" | "digital-code" | "live" | "auction" | undefined;
+        prizeRevealStatus?: "open" | "pending" | "closed" | "revealed" | undefined;
+        revealedAt?: Date | undefined;
+        allocationId?: string | undefined;
+        fulfilmentState?: "pending_release" | "released" | undefined;
+        releasedAt?: Date | undefined;
+        releasedBy?: string | undefined;
     }, {
         productId: string;
         productTitle: string;
         quantity: number;
         unitPrice: number;
         totalPrice: number;
-        listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live" | undefined;
-        prizeRevealStatus?: "pending" | "open" | "closed" | "revealed" | undefined;
+        listingType?: "standard" | "collector-drop" | "pre-order" | "clearance" | "classified" | "digital-code" | "live" | "auction" | undefined;
+        prizeRevealStatus?: "open" | "pending" | "closed" | "revealed" | undefined;
+        revealedAt?: Date | undefined;
+        allocationId?: string | undefined;
+        fulfilmentState?: "pending_release" | "released" | undefined;
+        releasedAt?: Date | undefined;
+        releasedBy?: string | undefined;
     }>, "many">>;
     orderType: z.ZodOptional<z.ZodString>;
     imageUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -537,8 +567,8 @@ export declare const orderFirestoreSchema: z.ZodObject<{
         }, z.ZodTypeAny, "passthrough">;
         refundedBy: string;
         status?: "failed" | "processed" | "reserved" | undefined;
-        failureReason?: string | undefined;
         gateway?: string | undefined;
+        failureReason?: string | undefined;
         itemIds?: string[] | undefined;
         reasonCode?: string | undefined;
         gatewayRefundId?: string | undefined;
@@ -563,8 +593,8 @@ export declare const orderFirestoreSchema: z.ZodObject<{
         }, z.ZodTypeAny, "passthrough">;
         refundedBy: string;
         status?: "failed" | "processed" | "reserved" | undefined;
-        failureReason?: string | undefined;
         gateway?: string | undefined;
+        failureReason?: string | undefined;
         itemIds?: string[] | undefined;
         reasonCode?: string | undefined;
         gatewayRefundId?: string | undefined;
@@ -625,8 +655,8 @@ export declare const orderFirestoreSchema: z.ZodObject<{
     refundPending: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     currency: string;
-    status: "cancelled" | "pending" | "confirmed" | "processing" | "shipped" | "delivered" | "returned" | "return_requested" | "refunded";
     id: string;
+    status: "cancelled" | "pending" | "confirmed" | "processing" | "shipped" | "delivered" | "returned" | "return_requested" | "refunded";
     createdAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
@@ -679,8 +709,13 @@ export declare const orderFirestoreSchema: z.ZodObject<{
         quantity: number;
         unitPrice: number;
         totalPrice: number;
-        listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live" | undefined;
-        prizeRevealStatus?: "pending" | "open" | "closed" | "revealed" | undefined;
+        listingType?: "standard" | "collector-drop" | "pre-order" | "clearance" | "classified" | "digital-code" | "live" | "auction" | undefined;
+        prizeRevealStatus?: "open" | "pending" | "closed" | "revealed" | undefined;
+        revealedAt?: Date | undefined;
+        allocationId?: string | undefined;
+        fulfilmentState?: "pending_release" | "released" | undefined;
+        releasedAt?: Date | undefined;
+        releasedBy?: string | undefined;
     }[] | undefined;
     bundleId?: string | undefined;
     orderType?: string | undefined;
@@ -749,8 +784,8 @@ export declare const orderFirestoreSchema: z.ZodObject<{
         }, z.ZodTypeAny, "passthrough">;
         refundedBy: string;
         status?: "failed" | "processed" | "reserved" | undefined;
-        failureReason?: string | undefined;
         gateway?: string | undefined;
+        failureReason?: string | undefined;
         itemIds?: string[] | undefined;
         reasonCode?: string | undefined;
         gatewayRefundId?: string | undefined;
@@ -784,8 +819,8 @@ export declare const orderFirestoreSchema: z.ZodObject<{
     refundPending?: boolean | undefined;
 }, {
     currency: string;
-    status: "cancelled" | "pending" | "confirmed" | "processing" | "shipped" | "delivered" | "returned" | "return_requested" | "refunded";
     id: string;
+    status: "cancelled" | "pending" | "confirmed" | "processing" | "shipped" | "delivered" | "returned" | "return_requested" | "refunded";
     createdAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
@@ -838,8 +873,13 @@ export declare const orderFirestoreSchema: z.ZodObject<{
         quantity: number;
         unitPrice: number;
         totalPrice: number;
-        listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live" | undefined;
-        prizeRevealStatus?: "pending" | "open" | "closed" | "revealed" | undefined;
+        listingType?: "standard" | "collector-drop" | "pre-order" | "clearance" | "classified" | "digital-code" | "live" | "auction" | undefined;
+        prizeRevealStatus?: "open" | "pending" | "closed" | "revealed" | undefined;
+        revealedAt?: Date | undefined;
+        allocationId?: string | undefined;
+        fulfilmentState?: "pending_release" | "released" | undefined;
+        releasedAt?: Date | undefined;
+        releasedBy?: string | undefined;
     }[] | undefined;
     bundleId?: string | undefined;
     orderType?: string | undefined;
@@ -908,8 +948,8 @@ export declare const orderFirestoreSchema: z.ZodObject<{
         }, z.ZodTypeAny, "passthrough">;
         refundedBy: string;
         status?: "failed" | "processed" | "reserved" | undefined;
-        failureReason?: string | undefined;
         gateway?: string | undefined;
+        failureReason?: string | undefined;
         itemIds?: string[] | undefined;
         reasonCode?: string | undefined;
         gatewayRefundId?: string | undefined;
@@ -1066,6 +1106,9 @@ export declare const orderSchema: z.ZodObject<{
     updatedAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     currency: string;
+    address: {} & {
+        [k: string]: unknown;
+    };
     id: string;
     userId: string;
     paymentStatus: string;
@@ -1079,9 +1122,6 @@ export declare const orderSchema: z.ZodObject<{
         storeId?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }[];
-    address: {} & {
-        [k: string]: unknown;
-    };
     total: number;
     subtotal: number;
     orderStatus: "cancelled" | "pending" | "confirmed" | "processing" | "shipped" | "delivered" | "returned" | "return_requested" | "refunded";
@@ -1103,6 +1143,9 @@ export declare const orderSchema: z.ZodObject<{
     }[] | undefined;
 }, {
     currency: string;
+    address: {} & {
+        [k: string]: unknown;
+    };
     id: string;
     userId: string;
     paymentStatus: string;
@@ -1116,9 +1159,6 @@ export declare const orderSchema: z.ZodObject<{
         storeId?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }[];
-    address: {} & {
-        [k: string]: unknown;
-    };
     total: number;
     subtotal: number;
     orderStatus: "cancelled" | "pending" | "confirmed" | "processing" | "shipped" | "delivered" | "returned" | "return_requested" | "refunded";

package/dist/features/orders/schemas/index.js

@@ -6,9 +6,12 @@ import { auditTimestampsShape, firestoreDateSchema, rupeesSchema } from "../../.
 // AppliedOrderDiscount in ./firestore.ts. Registered into SCHEMAS.firestore.orders.
 export const orderListingTypeSchema = z.enum([
     "standard",
+    "collector-drop",
+    // Pre-rename spelling, accepted so an order written before the
+    // collector-drop rename still validates on update.
     "auction",
     "pre-order",
-    "prize-draw",
+    "clearance",
     "classified",
     "digital-code",
     "live",
@@ -51,6 +54,21 @@ export const orderDocumentItemSchema = z.object({
     totalPrice: rupeesSchema,
     listingType: orderListingTypeSchema.optional(),
     prizeRevealStatus: z.enum(["pending", "open", "closed", "revealed"]).optional(),
+    /*
+     * 🛑 Both MUST be here even though nothing validates an order item on the
+     * way out: `z.object()` STRIPS unknown keys, so a field on the interface
+     * and absent from this mirror is REMOVED on parse rather than erroring —
+     * the exact silent drift the `OrderRefundEvent` note below documents. For
+     * `allocationId` that would mean the pointer to the immutable allocation
+     * record quietly disappearing from a line whose contents are in dispute.
+     */
+    revealedAt: z.date().optional(),
+    allocationId: z.string().optional(),
+    /* Manual-release fulfilment — see the document interface. Same strip-on-parse
+     * hazard as the two above. */
+    fulfilmentState: z.enum(["pending_release", "released"]).optional(),
+    releasedAt: z.date().optional(),
+    releasedBy: z.string().optional(),
 });
 /**
  * Mirror of `OrderRefundEvent`.