@mohasinac/appkit 4.62.0 → 4.63.0

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

@@ -107,6 +107,27 @@ export interface StoreDocument extends BaseDocument {
     adminNotes?: string;
     /** Admin "verified store" badge — distinct from `status`/`isPublic`. */
     isVerified?: boolean;
+    /**
+     * Paid at SHIPPING rather than at delivery.
+     *
+     * 🛑 **A risk transfer, not a courtesy or a badge.** Paying before delivery
+     * means the platform carries a lost parcel and a non-delivery dispute with
+     * the money already gone. Admin-granted only, `recordAdminAction`-logged,
+     * revocable — and **PRIVATE in the public projection**, because it describes
+     * our risk posture rather than anything a buyer should weigh. A store does
+     * not get to display that we trust it.
+     *
+     * 🛑 A faster path through the SAME machinery, never a second one. The
+     * eligibility sweep moves the delivered-status test, not the payout, the
+     * hold, the deductions or the dispatch.
+     *
+     * 🛑 **A refund after a trusted payout has no money left to net against.**
+     * The ordinary path deducts from a still-`pending` payout; once paid there
+     * is nothing to deduct from, so it becomes a `manual_refund_due` case —
+     * which already exists and already means exactly this. Never a negative
+     * payout.
+     */
+    trustedSeller?: boolean;
     /** Reason recorded when `status` is set to "suspended". */
     suspensionReason?: string;
     stats?: {
@@ -233,6 +254,77 @@ export interface StoreDocument extends BaseDocument {
      */
     supportsShippingProtection?: boolean;
     supportsSaleProtection?: boolean;
+    /**
+     * This store accepts buyer points as part-payment.
+     *
+     * ## 🛑 OPT-IN, because the accepting store ABSORBS the redemption
+     *
+     * Decision 3: a redeemed point reduces THAT store's payout for THAT order.
+     * Earning is mandatory (it costs the seller nothing at issue time); accepting
+     * is optional, because accepting is where the money actually moves. So this
+     * follows `supportsSaleProtection` above exactly — **absent means NOT
+     * accepted, never "unknown"** — and for the identical reason: defaulting it
+     * `true` would enrol every existing seller in funding discounts they never
+     * agreed to, and retrofitting consent later means switching a working feature
+     * off for them.
+     *
+     * 🛑 Live currently has ONE store, so this flag is inert today. It is still
+     * built now rather than later: the day a second seller exists, enabling
+     * redemption for them without asking is taking their money, and the cost of
+     * the field today is one boolean and one check.
+     *
+     * `store-letitrip-official` is always treated as accepting — the platform's
+     * own storefront cannot decline to fund its own programme. That is resolved
+     * in code rather than seeded, so it cannot be switched off by an edit.
+     */
+    acceptsPoints?: boolean;
+    /**
+     * ── S5a: this store allows a SHARED PURCHASE (one payer, N destinations) ──
+     *
+     * The coordinator buys everything and assigns a destination per item, so the
+     * seller packs one order into several parcels. That is real extra work —
+     * picking, packing and labelling N shipments instead of one — which is why
+     * it is an opt-in with its own fees rather than a free platform behaviour.
+     *
+     * 🛑 **Absent means NOT allowed**, matching `supportsSaleProtection` and
+     * `acceptsPoints` above, and for the same reason: the cost falls on the
+     * seller, so enrolling them without asking is taking their labour. Every
+     * existing store therefore starts with it off, which is the correct state
+     * rather than a migration problem.
+     *
+     * 🛑 This is S5a ONLY — one payer. It is NOT the N-party flow (S5b), which
+     * needs multi-party payment, a coordinator deposit, an approval cascade, a
+     * stock-reservation primitive that does not exist, and per-buyer invoicing
+     * and GST. A seller enabling this is agreeing to split one paid order across
+     * destinations, not to be paid by several people.
+     */
+    allowSharedPurchase?: boolean;
+    /**
+     * Flat fee per shared-purchase arrangement, in decimal rupees.
+     *
+     * Covers picking, packing and labelling one order into N parcels. Borne by
+     * the COORDINATOR — they chose the arrangement — which keeps each
+     * destination's own cost to goods plus that destination's shipping.
+     *
+     * 🛑 SNAPSHOTTED onto the order at checkout, never re-read later. The
+     * precedent is exact: the refund path reads `finalSale` from the ORDER
+     * snapshot rather than the live product, because "re-reading the live
+     * product would let a seller flip the switch afterwards" (D61). A fee read
+     * late is the same hole.
+     */
+    sharedPurchaseHandlingFee?: number;
+    /**
+     * Extra shipping per destination BEYOND THE FIRST, in decimal rupees.
+     *
+     * The first destination is the shipping the order would have paid anyway;
+     * this is the marginal cost of each additional parcel. Borne by the buyer at
+     * that destination in the full N-party flow — in S5a there is one payer, so
+     * the coordinator pays all of it, which is correct because they are the
+     * person who asked for the extra legs.
+     *
+     * Snapshotted with the handling fee, for the same reason.
+     */
+    sharedPurchaseExtraShippingPerDestination?: number;
     /**
      * ── C5g: ADMIN-GRANTED trust. Routes even a protected claim to the seller ──
      *
@@ -315,6 +407,7 @@ export declare const STORE_FIELDS: {
     readonly ADMIN_NOTES: "adminNotes";
     readonly IS_FEATURED: "isFeatured";
     readonly IS_VERIFIED: "isVerified";
+    readonly TRUSTED_SELLER: "trustedSeller";
     readonly SUSPENSION_REASON: "suspensionReason";
     readonly CAPABILITIES: "capabilities";
     readonly STATUS_VALUES: {
@@ -333,3 +426,22 @@ export type StoreAddressUpdateInput = _AddrUpdate;
 export { ADDRESS_FIELDS as STORE_ADDRESS_FIELDS, ADDRESS_INDEXED_FIELDS as STORE_ADDRESS_INDEXED_FIELDS, ADDRESS_PUBLIC_FIELDS as STORE_ADDRESS_PUBLIC_FIELDS, ADDRESS_UPDATABLE_FIELDS as STORE_ADDRESS_UPDATABLE_FIELDS, DEFAULT_ADDRESS_DATA as DEFAULT_STORE_ADDRESS_DATA, } from "../../addresses/schemas";
 /** @deprecated SB-UNI-A — literal alias only. Use ADDRESSES_COLLECTION. */
 export declare const STORE_ADDRESS_SUBCOLLECTION: "addresses";
+/**
+ * The platform's own storefront.
+ *
+ * An IDENTITY, not a setting — it is the same id the seed's `REAL_STORE_IDS`
+ * and `realListingsOnly` already treat as the platform's own, and resolving it
+ * in code is what stops it being switched off by an edit, a reseed, or a
+ * mis-clicked admin toggle. `storeAcceptsPoints` is the motivating reader: the
+ * one store the points programme is advertised on cannot be allowed to decline
+ * to fund it.
+ *
+ * 🛑 It lives HERE, in `features/`, and not beside its reader in
+ * `_internal/shared/features/points/` — `audit-ssr-in-appkit` Rule 3 forbids a
+ * brand-bearing literal inside `_internal/`, because a consumer of appkit would
+ * inherit OUR store id with no way to override it. `features/` is where the
+ * same literal already lives legitimately (`CONSIGNMENT_STORE_ID` in
+ * `features/catalogue/utils/product-from-item.ts`), and this file is the one
+ * that already documents the rule on `acceptsPoints` above.
+ */
+export declare const PLATFORM_STORE_ID = "store-letitrip-official";

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

@@ -74,6 +74,7 @@ export const STORE_FIELDS = {
     ADMIN_NOTES: "adminNotes",
     IS_FEATURED: "isFeatured",
     IS_VERIFIED: "isVerified",
+    TRUSTED_SELLER: "trustedSeller",
     SUSPENSION_REASON: "suspensionReason",
     CAPABILITIES: "capabilities",
     STATUS_VALUES: {
@@ -101,3 +102,22 @@ export function generateStoreSlug(storeName, ownerDisplayName) {
 export { ADDRESS_FIELDS as STORE_ADDRESS_FIELDS, ADDRESS_INDEXED_FIELDS as STORE_ADDRESS_INDEXED_FIELDS, ADDRESS_PUBLIC_FIELDS as STORE_ADDRESS_PUBLIC_FIELDS, ADDRESS_UPDATABLE_FIELDS as STORE_ADDRESS_UPDATABLE_FIELDS, DEFAULT_ADDRESS_DATA as DEFAULT_STORE_ADDRESS_DATA, } from "../../addresses/schemas/index.js";
 /** @deprecated SB-UNI-A — literal alias only. Use ADDRESSES_COLLECTION. */
 export const STORE_ADDRESS_SUBCOLLECTION = "addresses";
+/**
+ * The platform's own storefront.
+ *
+ * An IDENTITY, not a setting — it is the same id the seed's `REAL_STORE_IDS`
+ * and `realListingsOnly` already treat as the platform's own, and resolving it
+ * in code is what stops it being switched off by an edit, a reseed, or a
+ * mis-clicked admin toggle. `storeAcceptsPoints` is the motivating reader: the
+ * one store the points programme is advertised on cannot be allowed to decline
+ * to fund it.
+ *
+ * 🛑 It lives HERE, in `features/`, and not beside its reader in
+ * `_internal/shared/features/points/` — `audit-ssr-in-appkit` Rule 3 forbids a
+ * brand-bearing literal inside `_internal/`, because a consumer of appkit would
+ * inherit OUR store id with no way to override it. `features/` is where the
+ * same literal already lives legitimately (`CONSIGNMENT_STORE_ID` in
+ * `features/catalogue/utils/product-from-item.ts`), and this file is the one
+ * that already documents the rule on `acceptsPoints` above.
+ */
+export const PLATFORM_STORE_ID = "store-letitrip-official";

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

@@ -218,13 +218,13 @@ export declare const storeFirestoreSchema: z.ZodObject<{
         totalReviews: z.ZodNumber;
         averageRating: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        itemsSold: number;
         totalProducts: number;
+        itemsSold: number;
         totalReviews: number;
         averageRating?: number | undefined;
     }, {
-        itemsSold: number;
         totalProducts: number;
+        itemsSold: number;
         totalReviews: number;
         averageRating?: number | undefined;
     }>>;
@@ -363,8 +363,8 @@ export declare const storeFirestoreSchema: z.ZodObject<{
     location?: string | undefined;
     returnPolicy?: string | undefined;
     stats?: {
-        itemsSold: number;
         totalProducts: number;
+        itemsSold: number;
         totalReviews: number;
         averageRating?: number | undefined;
     } | undefined;
@@ -432,8 +432,8 @@ export declare const storeFirestoreSchema: z.ZodObject<{
     location?: string | undefined;
     returnPolicy?: string | undefined;
     stats?: {
-        itemsSold: number;
         totalProducts: number;
+        itemsSold: number;
         totalReviews: number;
         averageRating?: number | undefined;
     } | undefined;
@@ -530,8 +530,8 @@ export declare const storeListItemSchema: z.ZodObject<{
     storeDescription?: string | undefined;
     storeLogoURL?: string | undefined;
     storeBannerURL?: string | undefined;
-    itemsSold?: number | undefined;
     totalProducts?: number | undefined;
+    itemsSold?: number | undefined;
     totalReviews?: number | undefined;
     averageRating?: number | undefined;
 }, {
@@ -546,8 +546,8 @@ export declare const storeListItemSchema: z.ZodObject<{
     storeDescription?: string | undefined;
     storeLogoURL?: string | undefined;
     storeBannerURL?: string | undefined;
-    itemsSold?: number | undefined;
     totalProducts?: number | undefined;
+    itemsSold?: number | undefined;
     totalReviews?: number | undefined;
     averageRating?: number | undefined;
 }>;

package/dist/features/stores/types/index.d.ts

@@ -24,6 +24,25 @@ export interface StoreListItem {
      */
     supportsShippingProtection: boolean;
     supportsSaleProtection: boolean;
+    /**
+     * S5a — this seller will split one paid order across several destinations.
+     *
+     * Not optional, for the same reason as the two above: the projection
+     * resolves absence to `false`, so the client never decides what `undefined`
+     * means.
+     */
+    allowSharedPurchase: boolean;
+    /**
+     * The two shared-purchase fees, in decimal rupees.
+     *
+     * 🛑 OPTIONAL here where `allowSharedPurchase` is not, and the asymmetry is
+     * the point: a flag's absence means "no", but a fee's absence means "not
+     * configured" — which is not ₹0. A client that defaulted these to zero would
+     * quote a free arrangement from a store that has simply not priced one, and
+     * the coordinator commits against that quote.
+     */
+    sharedPurchaseHandlingFee?: number;
+    sharedPurchaseExtraShippingPerDestination?: number;
     createdAt?: string;
 }
 export interface StoreDetail extends StoreListItem {

package/dist/features/support/repository/support.repository.js

@@ -9,6 +9,41 @@ import { sieveAnd, sieveFilter, SIEVE_OP } from "../../../utils/sieve-builder.js
 import { maskPii, revealPii } from "../../../security/pii-accessors.js";
 import { SUPPORT_TICKET_COLLECTION, SUPPORT_TICKET_PII_FIELDS, SUPPORT_TICKET_TRACKED_FIELDS, TicketStatusValues, ACTIVE_TICKET_STATUSES, } from "../schemas/firestore.js";
 import { withHistory } from "../../../_internal/shared/history/index.js";
+/**
+ * Who, if anyone, gets credited with resolving this ticket.
+ *
+ * 🛑 **A BUYER is never the resolver**, even though a buyer can drive the
+ * transition — replying "that's sorted, thanks" is a legitimate way for a
+ * ticket to reach `resolved`, and crediting it would put a customer's uid in
+ * a field a payslip is computed from. `system` has no uid at all, which is
+ * the other case that must not be paid.
+ *
+ * Returning `undefined` is correct and expected: the ticket is still resolved,
+ * it simply earns nobody wages. A fabricated fallback — the assignee, the
+ * ticket owner — would be a wage attributed to someone who did not do the
+ * work, and it would look exactly like a real one.
+ */
+const WAGE_EARNING_ACTOR_ROLES = new Set(["seller", "admin"]);
+function resolverUid(ctx) {
+    const actor = ctx?.actor;
+    if (!actor?.uid)
+        return undefined;
+    /*
+     * An ALLOW-LIST, not `role !== "buyer"`. A tenth actor role added later
+     * would silently start earning wages under a deny-list, which is the
+     * `Record<Union, T>`-over-`Set<string>` argument this codebase makes
+     * everywhere else — and the roles that can be credited is the shorter,
+     * more stable list.
+     *
+     * 🛑 `HistoryActorRole` has no `employee` member, and that is FINE: this
+     * field records WHO resolved it, and the payroll decides whether that
+     * person is on it. A seller resolving their own store's ticket is recorded
+     * here and appears on no payslip, because they are not an employee.
+     */
+    if (!WAGE_EARNING_ACTOR_ROLES.has(actor.role))
+        return undefined;
+    return actor.uid;
+}
 export class SupportRepository extends BaseRepository {
     constructor() {
         super(SUPPORT_TICKET_COLLECTION);
@@ -210,7 +245,7 @@ export class SupportRepository extends BaseRepository {
         // `piiFields`, which is what encrypts `assignedToName` on the way down.
         const patch = {
             ...update,
-            ...this.resolutionStamps(current, update.status),
+            ...this.resolutionStamps(current, update.status, resolverUid(ctx)),
             updatedAt: new Date(),
         };
         return this.update(ticketId, this.withTicketHistory(current, patch, ctx, "updateTicketStatus"));
@@ -233,14 +268,45 @@ export class SupportRepository extends BaseRepository {
      * against the document would poison that patch's inferred type with
      * `Encrypted<string>` members it never actually sets.
      */
-    resolutionStamps(current, next) {
+    resolutionStamps(current, next, actorUid) {
         if (!next || next === current?.status)
             return {};
         const now = new Date();
-        if (next === TicketStatusValues.RESOLVED && !current?.resolvedAt)
-            return { resolvedAt: now };
+        if (next === TicketStatusValues.RESOLVED && !current?.resolvedAt) {
+            /*
+             * 🛑 `resolvedBy` is stamped HERE and is not the same thing as
+             * `assignedTo`.
+             *
+             * `assignedTo` is the CURRENT assignee: reassign a resolved ticket for
+             * follow-up and it moves, so paying from it credits whoever happens to
+             * hold the ticket at month end rather than whoever did the work. That is
+             * the whole reason this field exists.
+             *
+             * Absent when the caller supplied no actor — a system transition has no
+             * person to pay, and a fabricated uid would be a wage attributed to
+             * somebody who did nothing.
+             */
+            return actorUid ? { resolvedAt: now, resolvedBy: actorUid } : { resolvedAt: now };
+        }
         if (next === TicketStatusValues.CLOSED && !current?.closedAt)
             return { closedAt: now };
+        /*
+         * 🛑 A REOPEN clears both, and clearing `resolvedBy` is load-bearing.
+         *
+         * Pay is computed from tickets STILL RESOLVED at period end, so a ticket
+         * that goes back to open must stop counting — otherwise close-it,
+         * let-it-reopen, close-it-again pays twice for one problem.
+         *
+         * Cleared rather than left in place with the status as the only signal,
+         * because `resolvedTicketsForPeriod` filters on all three and a stale
+         * `resolvedAt` surviving a reopen is a row that looks payable to anything
+         * that checks fewer of them.
+         */
+        const reopened = current?.resolvedAt != null &&
+            next !== TicketStatusValues.RESOLVED &&
+            next !== TicketStatusValues.CLOSED;
+        if (reopened)
+            return { resolvedAt: undefined, resolvedBy: undefined };
         return {};
     }
     /** Append a timeline entry when the patch touches a tracked field. */
@@ -259,7 +325,7 @@ export class SupportRepository extends BaseRepository {
             trigger: ctx?.trigger ?? defaultTrigger,
             reason: ctx?.reason,
             note: ctx?.note,
-            // `encryptPiiFields` never descends into arrays, so a PII-named value
+            // `encryptPiiFields` covers only NAMED paths, so an undeclared PII-named value
             // reaching `changes` would persist in PLAINTEXT inside statusHistory.
             piiFields: SUPPORT_TICKET_PII_FIELDS,
         });
@@ -288,7 +354,7 @@ export class SupportRepository extends BaseRepository {
             };
             if (newStatus) {
                 const current = prior !== undefined ? prior : await this.getTicketById(ticketId);
-                Object.assign(updateData, this.withTicketHistory(current, { status: newStatus, ...this.resolutionStamps(current, newStatus) }, ctx, "addMessage"));
+                Object.assign(updateData, this.withTicketHistory(current, { status: newStatus, ...this.resolutionStamps(current, newStatus, resolverUid(ctx)) }, ctx, "addMessage"));
             }
             await ref.update(updateData);
         }

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

@@ -196,6 +196,23 @@ export interface SupportTicketDocument extends BaseDocument {
      * `Date` field and split the collection into two shapes.
      */
     resolvedAt?: Date;
+    /**
+     * The uid of whoever moved the ticket to `resolved`.
+     *
+     * 🛑 **Not `assignedTo`.** That is the CURRENT assignee and moves on
+     * reassignment, so paying from it credits whoever holds the ticket at period
+     * end rather than whoever did the work. Employee pay is computed from this
+     * field; see `resolvedTicketsForPeriod`.
+     *
+     * Server-stamped, never client-sent, and **cleared on reopen** — pay counts
+     * tickets still resolved at period end, so a reopened ticket must stop
+     * counting or closing it twice pays twice.
+     *
+     * Absent on a system transition and on a buyer-driven one: both are real
+     * resolutions that earn nobody wages, and a fallback to the assignee would
+     * be a wage attributed to someone who did nothing.
+     */
+    resolvedBy?: string;
     closedAt?: Date;
     /** When we acknowledged receipt. Server-stamped at intake. */
     acknowledgedAt?: Date;

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

@@ -157,7 +157,7 @@ export declare const supportTicketFirestoreSchema: z.ZodObject<{
     updatedAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    category: "general" | "order_issue" | "billing_payment" | "account" | "listing_dispute" | "scam_report" | "refund_request" | "auction_dispute" | "store_change_request" | "order_modification_request" | "unban_request";
+    category: "general" | "account" | "order_issue" | "billing_payment" | "listing_dispute" | "scam_report" | "refund_request" | "auction_dispute" | "store_change_request" | "order_modification_request" | "unban_request";
     priority: "normal" | "high" | "low" | "urgent";
     description: string;
     userId: string;
@@ -175,11 +175,11 @@ export declare const supportTicketFirestoreSchema: z.ZodObject<{
         attachments?: string[] | undefined;
     }[];
     orderId?: string | undefined;
-    assignedTo?: string | undefined;
-    resolvedAt?: string | Date | z.objectOutputType<{
+    closedAt?: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
-    closedAt?: string | Date | z.objectOutputType<{
+    assignedTo?: string | undefined;
+    resolvedAt?: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
     assignedToName?: string | undefined;
@@ -200,7 +200,7 @@ export declare const supportTicketFirestoreSchema: z.ZodObject<{
     updatedAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    category: "general" | "order_issue" | "billing_payment" | "account" | "listing_dispute" | "scam_report" | "refund_request" | "auction_dispute" | "store_change_request" | "order_modification_request" | "unban_request";
+    category: "general" | "account" | "order_issue" | "billing_payment" | "listing_dispute" | "scam_report" | "refund_request" | "auction_dispute" | "store_change_request" | "order_modification_request" | "unban_request";
     priority: "normal" | "high" | "low" | "urgent";
     description: string;
     userId: string;
@@ -218,11 +218,11 @@ export declare const supportTicketFirestoreSchema: z.ZodObject<{
         attachments?: string[] | undefined;
     }[];
     orderId?: string | undefined;
-    assignedTo?: string | undefined;
-    resolvedAt?: string | Date | z.objectInputType<{
+    closedAt?: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
-    closedAt?: string | Date | z.objectInputType<{
+    assignedTo?: string | undefined;
+    resolvedAt?: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
     assignedToName?: string | undefined;

package/dist/features/wishlist/hooks/useWishlistWithGuest.d.ts

@@ -29,7 +29,7 @@ export declare function useWishlistWithGuest(userId: string | null | undefined,
         productPrice: number;
         productSlug: string;
         addedAt: string | undefined;
-        type: "category" | "store" | "classified" | "auction" | "digital-code" | "live" | "product" | "preorder";
+        type: "category" | "store" | "classified" | "auction" | "digital-code" | "live" | "preorder" | "product";
     }[];
     total: number;
     wishlistedIds: Set<string>;

package/dist/index.d.ts

@@ -550,6 +550,8 @@ export { scammerRepository } from "./repositories/index";
 export { supportRepository, SupportRepository } from "./repositories/index";
 export type { SupportTicketDocument, SupportTicketCreateInput, SupportTicketUpdateInput, TicketMessage, TicketCategory, TicketStatus, TicketPriority, } from "./repositories/index";
 export { ELIGIBLE_ORDER_STATUSES_FOR_TICKET, SUPPORT_TICKET_COLLECTION, ACTIVE_TICKET_STATUSES, SUPPORT_TICKET_FIELDS, TicketCategoryValues, TicketStatusValues, TicketPriorityValues, } from "./features/support/schemas/firestore";
+export { AdminIntegrationsView } from "./features/admin/components/AdminIntegrationsView";
+export type { AdminIntegrationsViewProps } from "./features/admin/components/AdminIntegrationsView";
 export { AdminTaxCodesView } from "./features/admin/components/AdminTaxCodesView";
 export type { AdminTaxCodesViewProps } from "./features/admin/components/AdminTaxCodesView";
 export { AdminTaxCodeEditorView } from "./features/admin/components/AdminTaxCodeEditorView";
@@ -1962,6 +1964,8 @@ export type { OrderSiblingPaymentsProps } from "./features/orders/index";
 export { OrderPaymentSummary } from "./features/orders/index";
 export type { OrderPaymentSummaryProps } from "./features/orders/index";
 export { OrderStatusTimeline } from "./features/orders/index";
+export { OrderProvenanceCard } from "./features/orders/index";
+export type { OrderProvenanceCardProps } from "./features/orders/index";
 export { OrderCompletionPanel } from "./features/orders/index";
 export { StatusTimeline, stepsFromEntries } from "./features/status-history/index";
 export type { StatusTimelineProps, TimelineEntry, TimelineStep } from "./features/status-history/index";
@@ -2000,6 +2004,7 @@ export type { OrderAdminUpdateInput } from "./features/orders/index";
 export type { AppliedOrderDiscount } from "./features/orders/index";
 export type { OrderCreateInput } from "./features/orders/index";
 export type { OrderDocument } from "./features/orders/index";
+export type { OrderSourceContext } from "./features/orders/index";
 export type { OrderRefundEvent, RefundType } from "./features/orders/schemas/firestore";
 export { MANUAL_PAYMENT_METHODS, isManualPaymentMethod, PAYMENT_REVIEW_QUEUE_MODES, isPaymentReviewQueueMode, PAYMENT_REVIEW_QUEUE_SCAN_LIMIT, } from "./features/orders/constants/payment-window";
 export type { PaymentReviewQueueMode } from "./features/orders/constants/payment-window";
@@ -2190,7 +2195,7 @@ export { actionTracker, setActionTrackerSink, resetActionTrackerSink, type Actio
 export { cartRequiresShipping, cartIsDigitalOnly, cartIsChatOnly, } from "./_internal/shared/listing-types/cart-shipping";
 export { ACTIONS, action, act, canPerformAction, actionsForListingType, actionLabel, type ActionDef, type ActionKind, type ActionResource, type ActionTree, type ActionConfirmation, } from "./_internal/shared/actions/action-registry";
 export { buildBulkAction } from "./_internal/shared/actions/bulk-helpers";
-export { computeCheckoutFees, computePayoutDeduction, computeCodHandlingFee, computeGiftWrapFee, computeShipmentProtectionFee, computeSaleProtectionFee, calculateGst, } from "./_internal/shared/fees/calculator";
+export { computeCheckoutFees, allocateCheckoutFees, computePayoutDeduction, computeCodHandlingFee, computeGiftWrapFee, computeShipmentProtectionFee, computeSaleProtectionFee, calculateGst, } from "./_internal/shared/fees/calculator";
 export { searchPriceIndex, PRICE_INDEX_SEARCH_LIMIT, PRICE_INDEX_MIN_QUERY_LENGTH } from "./_internal/server/features/price-index/search";
 export type { PriceIndexSearchResponse, PriceIndexSearchResult, PriceIndexSearchResultBand, } from "./_internal/server/features/price-index/search";
 export { protectionAvailability, computeProtectionFees, adjudicateClaim, badgesFor, showsRiskNotice, showsSafetyBadge, returnDestination, rtoDestination, PROTECTION_KINDS, } from "./_internal/shared/features/shipping/protections";
@@ -2198,6 +2203,9 @@ export type { ProtectionKind, ProtectionAvailability, ProtectionTierInput, Prote
 export type { FeeCommissionRates, CheckoutFees, PayoutDeduction, CodHandlingFeeRates, GiftWrapFeeRates, ShipmentProtectionFeeRates, SaleProtectionFeeRates, GstBreakdown, } from "./_internal/shared/fees/calculator";
 export { checkEmiEligibility, computeEmiSchedule, computeBuyerEmiQuote } from "./_internal/shared/features/emi/schedule";
 export type { BuyerEmiQuote } from "./_internal/shared/features/emi/schedule";
+export { amountDueNow, groupEmiGate, groupEmiQuote, groupEmiSchedule, emiOrderFields } from "./_internal/shared/features/emi/group";
+export { emiTenderFor, resolveEmiChoice, emiTenderBlockReason, isTenderCompatibleWithEmi } from "./_internal/shared/features/emi/choice";
+export type { EmiChoice, EmiTender } from "./_internal/shared/features/emi/choice";
 export { toBuyerFacingFees, toBuyerEmiSettings, } from "./_internal/shared/features/site-settings/fees";
 export type { BuyerFacingFees, BuyerEmiSettings, } from "./_internal/shared/features/site-settings/fees";
 export { GSTIN_PATTERN, gstinCheckCharacter, isValidGstin, validateGstEnablement, canEnableGst, } from "./_internal/shared/features/site-settings/gst-registration";
@@ -2852,6 +2860,8 @@ export { BUNDLE_COPY, BUNDLE_STOCK_VARIANT, } from "./_internal/shared/features/
 export { REFUND_COPY } from "./_internal/shared/features/orders/refund-copy";
 export { RETURN_REASON, FINAL_SALE_EXEMPT_REASONS, RETURN_REASON_LABEL, RETURN_REASON_GROUP_LABEL, isFinalSaleExempt, isReturnReason, selectableReturnReasons, } from "./_internal/shared/features/orders/return-reasons";
 export type { ReturnReason } from "./_internal/shared/features/orders/return-reasons";
+export { DISPUTE_KIND, DISPUTE_KIND_LABEL, DISPUTE_GATE, DISPUTE_TRANSIT_WINDOW_DAYS, DISPUTE_NOT_REACHED_GRACE_DAYS, isDisputeKind, checkDisputeGate, resolveDisputeEtd, disputeNotReachedFilableFrom, } from "./_internal/shared/features/orders/dispute-reasons";
+export type { DisputeKind, DisputeGateOrder, DisputeGateResult, } from "./_internal/shared/features/orders/dispute-reasons";
 export { bundleCreateSchema, bundleUpdateSchema, bundleQueryRuleSchema, bundleDisplaySchema, type BundleCreateBody, type BundleUpdateBody, } from "./_internal/shared/features/categories/bundle-schemas";
 export type { GroupedListingDocument, GroupTheme, GroupVisibility } from "./features/grouped/schemas/firestore";
 export { navItemFormSchema, navItemCreateSchema, navItemUpdateSchema, type NavItemFormValues, } from "./features/admin/schemas/nav-item-form";

package/dist/index.js

@@ -1090,6 +1090,15 @@ export { ELIGIBLE_ORDER_STATUSES_FOR_TICKET, SUPPORT_TICKET_COLLECTION, ACTIVE_T
 // SB-UNI-B â€" sublistingCategoriesRepository + SublistingCategoryDocument deleted.
 // Use categoriesRepository.findBySlugAndType(slug, "sublisting") and CategoryDocument with categoryType:"sublisting".
 // [DB]-Database layer â€" uses firebase-admin; server-only.
+/*
+ * AdminIntegrationsView (12b) — /admin/integrations.
+ *
+ * The caller `INTEGRATIONS` / `integrationPatch` / `allIntegrationsPatch` were
+ * missing: the model landed with every route guard resolving through it and
+ * nothing in the UI reading it, which made those three exports speculative
+ * infra. This is what reads them.
+ */
+export { AdminIntegrationsView } from "./features/admin/components/AdminIntegrationsView.js";
 // AdminTaxCodesView / AdminTaxCodeEditorView (B3) — /admin/tax-codes.
 export { AdminTaxCodesView } from "./features/admin/components/AdminTaxCodesView.js";
 export { AdminTaxCodeEditorView } from "./features/admin/components/AdminTaxCodeEditorView.js";
@@ -3691,6 +3700,9 @@ export { OrdersList } from "./features/orders/index.js";
 export { OrderSiblingPayments } from "./features/orders/index.js";
 export { OrderPaymentSummary } from "./features/orders/index.js";
 export { OrderStatusTimeline } from "./features/orders/index.js";
+// OrderProvenanceCard — renders sourceContext, the record of HOW the buyer
+// earned this price. Mounted on the buyer, seller AND admin order detail.
+export { OrderProvenanceCard } from "./features/orders/index.js";
 // OrderCompletionPanel - Per-line ratings + Mark complete, the buyer's fast path.
 export { OrderCompletionPanel } from "./features/orders/index.js";
 // [CLIENT] StatusTimeline — the ONE rail both orders and offers render.
@@ -4075,7 +4087,14 @@ export { cartRequiresShipping, cartIsDigitalOnly, cartIsChatOnly, } from "./_int
 export { ACTIONS, action, act, canPerformAction, actionsForListingType, actionLabel, } from "./_internal/shared/actions/action-registry.js";
 export { buildBulkAction } from "./_internal/shared/actions/bulk-helpers.js";
 // Shared fee calculator — platform/gateway/GST/COD handling/addon fee math (pure, client-safe).
-export { computeCheckoutFees, computePayoutDeduction, computeCodHandlingFee, computeGiftWrapFee, computeShipmentProtectionFee, computeSaleProtectionFee, calculateGst, } from "./_internal/shared/fees/calculator.js";
+export { computeCheckoutFees, 
+// The per-group split of the ONE capped commission. Exported for the capture
+// route's points tender: the tender is applied per order group against the
+// same base the order path uses, and that base includes this share. Without
+// it the route would have to re-derive the apportionment — and the allocator
+// also carries the `minimumTransactionFee` floor (D41), which already spent
+// a release being re-implemented by hand in that very file.
+allocateCheckoutFees, computePayoutDeduction, computeCodHandlingFee, computeGiftWrapFee, computeShipmentProtectionFee, computeSaleProtectionFee, calculateGst, } from "./_internal/shared/fees/calculator.js";
 // C5e buyer protections — the pure three-tier gate plus the one fee pair
 // every money path must agree on. Public API because the capture route
 // (/api/payment/create-order) is one of the three sites that must agree.
@@ -4087,6 +4106,16 @@ export { searchPriceIndex, PRICE_INDEX_SEARCH_LIMIT, PRICE_INDEX_MIN_QUERY_LENGT
 export { protectionAvailability, computeProtectionFees, adjudicateClaim, badgesFor, showsRiskNotice, showsSafetyBadge, returnDestination, rtoDestination, PROTECTION_KINDS, } from "./_internal/shared/features/shipping/protections.js";
 // EMI eligibility + schedule computation (pure, client-safe — used for checkout quotes).
 export { checkEmiEligibility, computeEmiSchedule, computeBuyerEmiQuote } from "./_internal/shared/features/emi/schedule.js";
+/*
+ * 0f — the per-group instalment helpers. Exported because the CAPTURE amount
+ * is computed in a consumer route (`/api/payment/create-order`), and that
+ * route is one of the four money paths that must agree about an EMI order.
+ * There is no `./_internal/*` subpath, deliberately, so the barrel is how a
+ * consumer reaches shared checkout maths — exactly as `lineTotalFor` and
+ * `resolveShippingCost` already are.
+ */
+export { amountDueNow, groupEmiGate, groupEmiQuote, groupEmiSchedule, emiOrderFields } from "./_internal/shared/features/emi/group.js";
+export { emiTenderFor, resolveEmiChoice, emiTenderBlockReason, isTenderCompatibleWithEmi } from "./_internal/shared/features/emi/choice.js";
 // Buyer-facing projections of siteSettings.commissions / .emi — the single
 // definition of "safe to send to a browser" for fee data. See fees.ts header.
 export { toBuyerFacingFees, toBuyerEmiSettings, } from "./_internal/shared/features/site-settings/fees.js";
@@ -5121,6 +5150,9 @@ export { REFUND_COPY } from "./_internal/shared/features/orders/refund-copy.js";
 // See the module docstring for why the exempt set is "seller or carrier fault"
 // rather than "serious reasons".
 export { RETURN_REASON, FINAL_SALE_EXEMPT_REASONS, RETURN_REASON_LABEL, RETURN_REASON_GROUP_LABEL, isFinalSaleExempt, isReturnReason, selectableReturnReasons, } from "./_internal/shared/features/orders/return-reasons.js";
+// Dispute KINDS and their gates. `_internal/*` is not a subpath export, so a
+// consumer route reaches these only through a barrel.
+export { DISPUTE_KIND, DISPUTE_KIND_LABEL, DISPUTE_GATE, DISPUTE_TRANSIT_WINDOW_DAYS, DISPUTE_NOT_REACHED_GRACE_DAYS, isDisputeKind, checkDisputeGate, resolveDisputeEtd, disputeNotReachedFilableFrom, } from "./_internal/shared/features/orders/dispute-reasons.js";
 // S-SBUNI-4 follow-up â€" shared admin bundle zod schemas.
 export { bundleCreateSchema, bundleUpdateSchema, bundleQueryRuleSchema, bundleDisplaySchema, } from "./_internal/shared/features/categories/bundle-schemas.js";
 export { navItemFormSchema, navItemCreateSchema, navItemUpdateSchema, } from "./features/admin/schemas/nav-item-form.js";