@mohasinac/appkit 4.44.0 → 4.45.0

package/dist/features/cart/components/StoreAddonsPicker.d.ts

@@ -13,6 +13,7 @@ export interface StoreAddonsValue {
     giftWrapAddon?: boolean;
     giftWrapMessage?: string;
     shipmentProtectionAddon?: boolean;
+    saleProtectionAddon?: boolean;
 }
 /** The subset of `siteSettings.commissions` that gates and prices the add-ons. */
 export interface StoreAddonsRates {
@@ -23,6 +24,31 @@ export interface StoreAddonsRates {
     shipmentProtectionFeeEnabled?: boolean;
     shipmentProtectionFeePercent?: number;
     shipmentProtectionFeeMin?: number;
+    saleProtectionFeeEnabled?: boolean;
+    saleProtectionFeePercent?: number;
+    saleProtectionFeeMin?: number;
+}
+/**
+ * Tiers 2 and 3 of the protection gate — C5e. Tier 1 is `rates.*FeeEnabled`.
+ *
+ * Supplied per store by the caller, which is the only place that knows both
+ * the seller's opt-in and what is in this store's basket.
+ */
+export interface StoreProtectionContext {
+    /** `StoreDocument.supportsShippingProtection` — absent reads as NOT supported. */
+    supportsShippingProtection?: boolean;
+    supportsSaleProtection?: boolean;
+    /**
+     * True when ANY of this store's selected items is `finalSale`.
+     *
+     * 🛑 Any, not all, and that is the conservative reading: sale protection is
+     * priced on the whole store subtotal and claimed per item, so offering it
+     * over a basket containing one non-returnable item would sell cover that
+     * cannot be honoured on part of what it was charged for. Shipment protection
+     * is deliberately unaffected — a parcel lost in transit was never delivered,
+     * so there is nothing for "final" to be final about.
+     */
+    hasFinalSaleItem?: boolean;
 }
 /**
  * True when the site offers at least one paid add-on.
@@ -31,6 +57,12 @@ export interface StoreAddonsRates {
  * parent that doesn't know that ends up drawing a bare "Add-ons" heading over
  * empty space. Callers use this to decide between mounting the picker and
  * showing an explanatory line instead.
+ *
+ * 🛑 Deliberately asks only about TIER 1. A seller who supports neither
+ * protection still has WhatsApp updates and gift wrap, and a store whose only
+ * enabled add-ons are protections it declined must still render the picker —
+ * because that is where the risk notice lives, and a hidden notice is the
+ * tri-state failure in § `StoreProtectionContext`.
  */
 export declare function hasAnyStoreAddon(rates: StoreAddonsRates | null | undefined): boolean;
 export interface StoreAddonsPickerProps {
@@ -40,6 +72,8 @@ export interface StoreAddonsPickerProps {
     value: StoreAddonsValue;
     onChange: (storeId: string, next: StoreAddonsValue) => void;
     rates: StoreAddonsRates | null;
+    /** Tiers 2 and 3. Absent means the seller supports neither protection. */
+    protection?: StoreProtectionContext;
     /**
      * When true the controls render disabled with `disabledReason`. Used in the
      * cart when none of this store's items are selected — the fees genuinely
@@ -53,4 +87,4 @@ export interface StoreAddonsPickerProps {
     currency?: string;
     className?: string;
 }
-export declare function StoreAddonsPicker({ storeId, storeSubtotal, value, onChange, rates, disabled, disabledReason, showGiftMessage, currency, className, }: StoreAddonsPickerProps): React.JSX.Element | null;
+export declare function StoreAddonsPicker({ storeId, storeSubtotal, value, onChange, rates, protection, disabled, disabledReason, showGiftMessage, currency, className, }: StoreAddonsPickerProps): React.JSX.Element | null;

package/dist/features/cart/components/StoreAddonsPicker.js

@@ -1,11 +1,11 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Gift, MessageCircle, ShieldCheck } from "lucide-react";
-import { Div, Row, Stack, Text } from "../../../ui";
-import { IconBox } from "../../../ui/components/IconBox";
-import { FieldCheckbox } from "../../../ui/forms/FieldCheckbox";
-import { FieldTextarea } from "../../../ui/forms/FieldTextarea";
-import { formatCurrency } from "../../../utils/number.formatter";
+import { Gift, MessageCircle, ShieldAlert, ShieldCheck, ShieldOff } from "lucide-react";
+import { Div, Row, Stack, Text } from "../../../ui/index.js";
+import { IconBox } from "../../../ui/components/IconBox.js";
+import { FieldCheckbox } from "../../../ui/forms/FieldCheckbox.js";
+import { FieldTextarea } from "../../../ui/forms/FieldTextarea.js";
+import { formatCurrency } from "../../../utils/number.formatter.js";
 /**
  * True when the site offers at least one paid add-on.
  *
@@ -13,19 +13,47 @@ import { formatCurrency } from "../../../utils/number.formatter";
  * parent that doesn't know that ends up drawing a bare "Add-ons" heading over
  * empty space. Callers use this to decide between mounting the picker and
  * showing an explanatory line instead.
+ *
+ * 🛑 Deliberately asks only about TIER 1. A seller who supports neither
+ * protection still has WhatsApp updates and gift wrap, and a store whose only
+ * enabled add-ons are protections it declined must still render the picker —
+ * because that is where the risk notice lives, and a hidden notice is the
+ * tri-state failure in § `StoreProtectionContext`.
  */
 export function hasAnyStoreAddon(rates) {
     return (!!rates &&
         !!(rates.whatsappNotifyFeeEnabled ||
             rates.giftWrapFeeEnabled ||
-            rates.shipmentProtectionFeeEnabled));
+            rates.shipmentProtectionFeeEnabled ||
+            rates.saleProtectionFeeEnabled));
 }
-export function StoreAddonsPicker({ storeId, storeSubtotal, value, onChange, rates, disabled = false, disabledReason, showGiftMessage = false, currency = "INR", className = "", }) {
+export function StoreAddonsPicker({ storeId, storeSubtotal, value, onChange, rates, protection, disabled = false, disabledReason, showGiftMessage = false, currency = "INR", className = "", }) {
     if (!hasAnyStoreAddon(rates) || !rates)
         return null;
     const money = (value) => formatCurrency(value, currency);
     const set = (patch) => onChange(storeId, { ...value, ...patch });
-    // Mirrors computeShipmentProtectionFee so the label states the real charge.
-    const protectionFee = Math.max(rates.shipmentProtectionFeeMin ?? 30, Math.round(storeSubtotal * ((rates.shipmentProtectionFeePercent ?? 2) / 100) * 100) / 100);
-    return (_jsxs(Stack, { gap: "xs", className: `min-w-0 ${className}`, children: [disabled && disabledReason && (_jsx(Text, { size: "xs", color: "muted", children: disabledReason })), rates.whatsappNotifyFeeEnabled && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "brand", children: _jsx(MessageCircle, { size: 14 }) }), _jsx(Div, { className: "flex-1 min-w-0", children: _jsx(FieldCheckbox, { name: `whatsappNotifyAddon-${storeId}`, label: `WhatsApp order updates (+${money(rates.whatsappNotifyFee ?? 10)})`, checked: !!value.whatsappNotifyAddon, onChange: (checked) => set({ whatsappNotifyAddon: checked }), disabled: disabled }) })] })), rates.giftWrapFeeEnabled && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "brand", children: _jsx(Gift, { size: 14 }) }), _jsxs(Stack, { gap: "xs", className: "flex-1 min-w-0", children: [_jsx(FieldCheckbox, { name: `giftWrapAddon-${storeId}`, label: `Gift wrap (+${money(rates.giftWrapFee ?? 49)})`, checked: !!value.giftWrapAddon, onChange: (checked) => set({ giftWrapAddon: checked }), disabled: disabled }), showGiftMessage && value.giftWrapAddon && (_jsx(FieldTextarea, { name: `giftWrapMessage-${storeId}`, label: "Gift message (optional)", value: value.giftWrapMessage ?? "", onChange: (next) => set({ giftWrapMessage: next.slice(0, 500) }), rows: 2, maxLength: 500, showCharCount: true, placeholder: "Add a note for the recipient\u2026", disabled: disabled }))] })] })), rates.shipmentProtectionFeeEnabled && storeSubtotal > 0 && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "brand", children: _jsx(ShieldCheck, { size: 14 }) }), _jsx(Div, { className: "flex-1 min-w-0", children: _jsx(FieldCheckbox, { name: `shipmentProtectionAddon-${storeId}`, label: `Shipment protection (+${money(protectionFee)})`, checked: !!value.shipmentProtectionAddon, onChange: (checked) => set({ shipmentProtectionAddon: checked }), disabled: disabled }) })] }))] }));
+    // Mirrors computeShipmentProtectionFee / computeSaleProtectionFee so each
+    // label states the real charge.
+    const feeFor = (minFallback, min, percent, pctFallback = 2) => Math.max(min ?? minFallback, Math.round(storeSubtotal * ((percent ?? pctFallback) / 100) * 100) / 100);
+    const protectionFee = feeFor(30, rates.shipmentProtectionFeeMin, rates.shipmentProtectionFeePercent, 2);
+    const saleFee = feeFor(49, rates.saleProtectionFeeMin, rates.saleProtectionFeePercent, 3);
+    /*
+     * All three tiers, evaluated platform → seller → item, exactly as
+     * `protectionAvailability` does server-side. The buyer-facing message differs
+     * per tier and that is the point: platform-off shows NOTHING (there is
+     * nothing to disclose about this seller), seller-off shows the risk notice,
+     * item-ineligible says why.
+     */
+    const shippingOffered = !!rates.shipmentProtectionFeeEnabled && !!protection?.supportsShippingProtection;
+    const saleOffered = !!rates.saleProtectionFeeEnabled &&
+        !!protection?.supportsSaleProtection &&
+        !protection?.hasFinalSaleItem;
+    const shippingDeclined = !!rates.shipmentProtectionFeeEnabled && !protection?.supportsShippingProtection;
+    const saleDeclined = !!rates.saleProtectionFeeEnabled && !protection?.supportsSaleProtection;
+    const saleBlockedByFinalSale = !!rates.saleProtectionFeeEnabled && !!protection?.supportsSaleProtection && !!protection?.hasFinalSaleItem;
+    return (_jsxs(Stack, { gap: "xs", className: `min-w-0 ${className}`, children: [disabled && disabledReason && (_jsx(Text, { size: "xs", color: "muted", children: disabledReason })), rates.whatsappNotifyFeeEnabled && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "brand", children: _jsx(MessageCircle, { size: 14 }) }), _jsx(Div, { className: "flex-1 min-w-0", children: _jsx(FieldCheckbox, { name: `whatsappNotifyAddon-${storeId}`, label: `WhatsApp order updates (+${money(rates.whatsappNotifyFee ?? 10)})`, checked: !!value.whatsappNotifyAddon, onChange: (checked) => set({ whatsappNotifyAddon: checked }), disabled: disabled }) })] })), rates.giftWrapFeeEnabled && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "brand", children: _jsx(Gift, { size: 14 }) }), _jsxs(Stack, { gap: "xs", className: "flex-1 min-w-0", children: [_jsx(FieldCheckbox, { name: `giftWrapAddon-${storeId}`, label: `Gift wrap (+${money(rates.giftWrapFee ?? 49)})`, checked: !!value.giftWrapAddon, onChange: (checked) => set({ giftWrapAddon: checked }), disabled: disabled }), showGiftMessage && value.giftWrapAddon && (_jsx(FieldTextarea, { name: `giftWrapMessage-${storeId}`, label: "Gift message (optional)", value: value.giftWrapMessage ?? "", onChange: (next) => set({ giftWrapMessage: next.slice(0, 500) }), rows: 2, maxLength: 500, showCharCount: true, placeholder: "Add a note for the recipient\u2026", disabled: disabled }))] })] })), shippingOffered && storeSubtotal > 0 && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "brand", children: _jsx(ShieldCheck, { size: 14 }) }), _jsx(Div, { className: "flex-1 min-w-0", children: _jsx(FieldCheckbox, { name: `shipmentProtectionAddon-${storeId}`, label: `Shipment protection — loss or damage in transit (+${money(protectionFee)})`, checked: !!value.shipmentProtectionAddon, onChange: (checked) => set({ shipmentProtectionAddon: checked }), disabled: disabled }) })] })), saleOffered && storeSubtotal > 0 && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "brand", children: _jsx(ShieldAlert, { size: 14 }) }), _jsx(Div, { className: "flex-1 min-w-0", children: _jsx(FieldCheckbox, { name: `saleProtectionAddon-${storeId}`, label: `Sale protection — item not as described (+${money(saleFee)})`, checked: !!value.saleProtectionAddon, onChange: (checked) => set({ saleProtectionAddon: checked }), disabled: disabled }) })] })), (shippingDeclined || saleDeclined) && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "muted", children: _jsx(ShieldOff, { size: 14 }) }), _jsx(Text, { size: "xs", color: "muted", className: "flex-1 min-w-0", children: shippingDeclined && saleDeclined
+                            ? "This seller does not offer shipment or sale protection."
+                            : shippingDeclined
+                                ? "This seller does not offer shipment protection."
+                                : "This seller does not offer sale protection." })] })), saleBlockedByFinalSale && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "muted", children: _jsx(ShieldOff, { size: 14 }) }), _jsx(Text, { size: "xs", color: "muted", className: "flex-1 min-w-0", children: "Sale protection is not available \u2014 this basket contains a final-sale item. Shipment protection is unaffected." })] }))] }));
 }

package/dist/features/cart/components/index.js

@@ -1,10 +1,10 @@
-export { CartItemRow, CartDrawer } from "./CartDrawer";
-export { CartGroupLineRow } from "./CartGroupLineRow";
-export { CartView } from "./CartView";
-export { CartSummary } from "./CartSummary";
-export { StoreAddonsPicker, hasAnyStoreAddon } from "./StoreAddonsPicker";
-export { CartPriceBreakdown } from "./CartPriceBreakdown";
-export { CheckoutView } from "./CheckoutView";
-export { CheckoutAddressStep } from "./CheckoutAddressStep";
-export { CheckoutSuccessView } from "./CheckoutSuccessView";
-export { ShippingPicker } from "./ShippingPicker";
+export { CartItemRow, CartDrawer } from "./CartDrawer.js";
+export { CartGroupLineRow } from "./CartGroupLineRow.js";
+export { CartView } from "./CartView.js";
+export { CartSummary } from "./CartSummary.js";
+export { StoreAddonsPicker, hasAnyStoreAddon } from "./StoreAddonsPicker.js";
+export { CartPriceBreakdown } from "./CartPriceBreakdown.js";
+export { CheckoutView } from "./CheckoutView.js";
+export { CheckoutAddressStep } from "./CheckoutAddressStep.js";
+export { CheckoutSuccessView } from "./CheckoutSuccessView.js";
+export { ShippingPicker } from "./ShippingPicker.js";

package/dist/features/cart/hooks/useAddToCart.js

@@ -1,14 +1,14 @@
 "use client";
-import { normalizeError } from "../../../errors/normalize";
+import { normalizeError } from "../../../errors/normalize.js";
 import { useCallback, useEffect, useRef } from "react";
 import { useMutation, useQueryClient } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import { addToGuestCart, getGuestCartItems } from "../utils/guest-cart";
-import { CART_ENDPOINTS } from "../../../constants/api-endpoints";
-import { dispatchCartUpdated, formatCartAddedMessage } from "../utils/pending-ops";
-import { useToast } from "../../../ui/components/Toast";
-import { formatCurrency } from "../../../utils/number.formatter";
-import { getDefaultCurrency } from "../../../core/baseline-resolver";
+import { apiClient } from "../../../http/index.js";
+import { addToGuestCart, getGuestCartItems } from "../utils/guest-cart.js";
+import { CART_ENDPOINTS } from "../../../constants/api-endpoints.js";
+import { dispatchCartUpdated, formatCartAddedMessage } from "../utils/pending-ops.js";
+import { useToast } from "../../../ui/components/Toast.js";
+import { formatCurrency } from "../../../utils/number.formatter.js";
+import { getDefaultCurrency } from "../../../core/baseline-resolver.js";
 function showAddedToast(showToast, detail) {
     showToast(formatCartAddedMessage(detail, (amount) => formatCurrency(amount, getDefaultCurrency())), "success");
 }

package/dist/features/cart/hooks/useCart.js

@@ -1,7 +1,7 @@
 import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import { getDefaultCurrency } from "../../../core/baseline-resolver";
-import { CART_ENDPOINTS } from "../../../constants/api-endpoints";
+import { apiClient } from "../../../http/index.js";
+import { getDefaultCurrency } from "../../../core/baseline-resolver.js";
+import { CART_ENDPOINTS } from "../../../constants/api-endpoints.js";
 export function useCart(userIdOrSession, opts) {
     const endpoint = opts?.endpoint ?? CART_ENDPOINTS.BY_USER(userIdOrSession);
     const query = useQuery({

package/dist/features/cart/hooks/useCartCount.js

@@ -1,10 +1,10 @@
 "use client";
 import { useEffect, useState } from "react";
 import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import { useGuestCart } from "./useGuestCart";
-import { CART_ENDPOINTS } from "../../../constants/api-endpoints";
-import { CART_OPS_CHANGE_EVENT, getCartOpsDelta } from "../utils/pending-ops";
+import { apiClient } from "../../../http/index.js";
+import { useGuestCart } from "./useGuestCart.js";
+import { CART_ENDPOINTS } from "../../../constants/api-endpoints.js";
+import { CART_OPS_CHANGE_EVENT, getCartOpsDelta } from "../utils/pending-ops.js";
 /**
  * useCartCount
  *

package/dist/features/cart/hooks/useCartQuery.js

@@ -1,5 +1,5 @@
 import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
+import { apiClient } from "../../../http/index.js";
 export function useCartQuery(options) {
     return useQuery({
         queryKey: options.queryKey ?? ["cart"],

package/dist/features/cart/hooks/useCheckoutReadQueries.js

@@ -1,5 +1,5 @@
 import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
+import { apiClient } from "../../../http/index.js";
 export function useCheckoutReadQueries(options) {
     const addressQuery = useQuery({
         queryKey: options.addressesQueryKey ?? ["addresses"],

package/dist/features/cart/hooks/useGuestCart.js

@@ -1,6 +1,6 @@
 "use client";
 import { useState, useEffect, useCallback } from "react";
-import { getGuestCartItems, addToGuestCart, clearGuestCart, removeFromGuestCart, updateGuestCartQuantity, GUEST_CART_CHANGE_EVENT, } from "../utils/guest-cart";
+import { getGuestCartItems, addToGuestCart, clearGuestCart, removeFromGuestCart, updateGuestCartQuantity, GUEST_CART_CHANGE_EVENT, } from "../utils/guest-cart.js";
 /**
  * useGuestCart
  *

package/dist/features/cart/hooks/useGuestCartMerge.js

@@ -1,9 +1,9 @@
 "use client";
 import { useEffect, useRef } from "react";
-import { apiClient } from "../../../http";
-import { clearGuestCart, clearGuestReturnTo, getGuestCartItems, getGuestReturnTo, } from "../utils/guest-cart";
-import { CART_ENDPOINTS } from "../../../constants/api-endpoints";
-import { normalizeError } from "../../../errors/normalize";
+import { apiClient } from "../../../http/index.js";
+import { clearGuestCart, clearGuestReturnTo, getGuestCartItems, getGuestReturnTo, } from "../utils/guest-cart.js";
+import { CART_ENDPOINTS } from "../../../constants/api-endpoints.js";
+import { normalizeError } from "../../../errors/normalize.js";
 /**
  * useGuestCartMerge
  *

package/dist/features/cart/hooks/useOrder.js

@@ -1,6 +1,6 @@
 import { useQuery } from "@tanstack/react-query";
-import { apiClient, ApiClientError } from "../../../http";
-import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints";
+import { apiClient, ApiClientError } from "../../../http/index.js";
+import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints.js";
 export function useOrder(orderId, options) {
     const endpoint = options?.endpoint ?? ACCOUNT_ENDPOINTS.ORDER_BY_ID(orderId);
     const queryKeyPrefix = options?.queryKeyPrefix ?? "order";

package/dist/features/cart/index.js

@@ -1,15 +1,15 @@
-export * from "./types";
-export * from "./schemas";
-export * from "./columns";
-export * from "./hooks/useCart";
-export * from "./hooks/useCartQuery";
-export * from "./hooks/useCheckoutReadQueries";
-export * from "./hooks/useOrder";
-export * from "./hooks/useGuestCart";
-export * from "./hooks/useCartCount";
-export * from "./hooks/useAddToCart";
-export * from "./hooks/useGuestCartMerge";
-export * from "./components";
-export * from "./utils/guest-cart";
-export * from "./utils/pending-ops";
-export { manifest } from "./manifest";
+export * from "./types/index.js";
+export * from "./schemas/index.js";
+export * from "./columns/index.js";
+export * from "./hooks/useCart.js";
+export * from "./hooks/useCartQuery.js";
+export * from "./hooks/useCheckoutReadQueries.js";
+export * from "./hooks/useOrder.js";
+export * from "./hooks/useGuestCart.js";
+export * from "./hooks/useCartCount.js";
+export * from "./hooks/useAddToCart.js";
+export * from "./hooks/useGuestCartMerge.js";
+export * from "./components/index.js";
+export * from "./utils/guest-cart.js";
+export * from "./utils/pending-ops.js";
+export { manifest } from "./manifest.js";

package/dist/features/cart/repository/cart.repository.js

@@ -1,12 +1,12 @@
 import { randomUUID } from "crypto";
 import { FieldValue } from "firebase-admin/firestore";
-import { DatabaseError, NotFoundError, ValidationError } from "../../../errors";
-import { CART_FIELDS } from "../../../constants/field-names";
-import { normalizeError } from "../../../errors/normalize";
+import { DatabaseError, NotFoundError, ValidationError } from "../../../errors/index.js";
+import { CART_FIELDS } from "../../../constants/field-names.js";
+import { normalizeError } from "../../../errors/normalize.js";
 const ERR_CART_ITEM_NOT_FOUND = "Cart item not found";
 const ERR_CART_ITEM_LOCKED = "This item requires payment and cannot be removed or modified.";
-import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
-import { CART_COLLECTION, } from "../schemas";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase/index.js";
+import { CART_COLLECTION, } from "../schemas/index.js";
 export class CartRepository extends BaseRepository {
     constructor() {
         super(CART_COLLECTION);
@@ -551,7 +551,8 @@ export class CartRepository extends BaseRepository {
         const isEmpty = !addons ||
             (!addons.whatsappNotifyAddon &&
                 !addons.giftWrapAddon &&
-                !addons.shipmentProtectionAddon);
+                !addons.shipmentProtectionAddon &&
+                !addons.saleProtectionAddon);
         await this.db
             .collection(this.collection)
             .doc(userId)

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

@@ -192,7 +192,17 @@ export interface CartStoreAddons {
     whatsappNotifyAddon?: boolean;
     giftWrapAddon?: boolean;
     giftWrapMessage?: string;
+    /** Loss or damage IN TRANSIT. */
     shipmentProtectionAddon?: boolean;
+    /**
+     * The ITEM itself — not as described, wrong item, item issues (C5e).
+     *
+     * 🛑 A separate selection from `shipmentProtectionAddon`, not a rename of it,
+     * because the two failures are independent and a `finalSale` item is eligible
+     * for one and not the other. See
+     * `_internal/shared/features/shipping/protections.ts`.
+     */
+    saleProtectionAddon?: boolean;
 }
 export interface CartDocument extends BaseDocument {
     userId: string;

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

@@ -174,8 +174,8 @@ export declare const cartSummarySchema: z.ZodObject<{
         sessionId?: string | undefined;
         addedAt?: string | undefined;
     }[];
-    subtotal: number;
     itemCount: number;
+    subtotal: number;
 }, {
     items: {
         id: string;
@@ -193,7 +193,7 @@ export declare const cartSummarySchema: z.ZodObject<{
         sessionId?: string | undefined;
         addedAt?: string | undefined;
     }[];
-    subtotal: number;
     itemCount: number;
+    subtotal: number;
     currency?: string | undefined;
 }>;

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

@@ -1,6 +1,6 @@
-export * from "./firestore";
+export * from "./firestore.js";
 import { z } from "zod";
-import { getDefaultCurrency } from "../../../core/baseline-resolver";
+import { getDefaultCurrency } from "../../../core/baseline-resolver.js";
 export const cartItemMetaSchema = z.object({
     title: z.string(),
     price: z.number(),

package/dist/features/cart/server.js

@@ -3,5 +3,5 @@
  *
  * Server-only entry point for cart repositories.
  */
-export * from "./actions";
-export { CartRepository, cartRepository } from "./repository/cart.repository";
+export * from "./actions/index.js";
+export { CartRepository, cartRepository } from "./repository/cart.repository.js";

package/dist/features/cart/utils/guest-cart.js

@@ -1,5 +1,5 @@
-import { normalizeError } from "../../../errors/normalize";
-import { CART_MAX_ITEMS } from "../../../constants/limits";
+import { normalizeError } from "../../../errors/normalize.js";
+import { CART_MAX_ITEMS } from "../../../constants/limits.js";
 const DEFAULT_GUEST_CART_KEY = process.env.NEXT_PUBLIC_APP_ID
     ? `${process.env.NEXT_PUBLIC_APP_ID}_guest_cart`
     : "guest_cart";

package/dist/features/cart/utils/line-total.js

@@ -1,4 +1,4 @@
-import { lineTotalFor } from "../../../_internal/shared/checkout/order-math";
+import { lineTotalFor } from "../../../_internal/shared/checkout/order-math.js";
 /**
  * What one cart line contributes to a subtotal, computed on the CLIENT — where
  * no `ProductDocument` is available.

package/dist/features/cart/utils/pending-ops.js

@@ -5,7 +5,7 @@
  * Written to localStorage so they survive page refreshes.
  * The sync manager replays these and clears them after a successful push.
  */
-import { normalizeError } from "../../../errors/normalize";
+import { normalizeError } from "../../../errors/normalize.js";
 const APP_ID = () => typeof process !== "undefined" && process.env.NEXT_PUBLIC_APP_ID
     ? process.env.NEXT_PUBLIC_APP_ID
     : "letitrip";

package/dist/features/catalogue/actions/approve-catalogue-listing.js

@@ -1,10 +1,10 @@
 "use server";
 import { wrapAction } from "@mohasinac/appkit/server";
-import { catalogueRepository } from "../../../repositories";
-import { requireRoleUser } from "../../../providers/auth-firebase/helpers";
-import { isAdminUser } from "../../../features/auth/role-predicates";
-import { ValidationError, AuthorizationError } from "../../../errors";
-import { createProductFromCatalogueItem, CONSIGNMENT_STORE_ID } from "../utils/product-from-item";
+import { catalogueRepository } from "../../../repositories/index.js";
+import { requireRoleUser } from "../../../providers/auth-firebase/helpers.js";
+import { isAdminUser } from "../../../features/auth/role-predicates.js";
+import { ValidationError, AuthorizationError } from "../../../errors/index.js";
+import { createProductFromCatalogueItem, CONSIGNMENT_STORE_ID } from "../utils/product-from-item.js";
 /**
  * Admin path — approves a buyer's "Request to sell", creating the product
  * under the platform's own consignment store (not the buyer's, since a

package/dist/features/catalogue/actions/list-from-catalogue.js

@@ -1,11 +1,11 @@
 "use server";
 import { wrapAction } from "@mohasinac/appkit/server";
-import { catalogueRepository, storeRepository } from "../../../repositories";
-import { requireRoleUser } from "../../../providers/auth-firebase/helpers";
-import { isAdminUser } from "../../../features/auth/role-predicates";
-import { ValidationError, AuthorizationError } from "../../../errors";
-import { assertCatalogueImagesFresh } from "../utils/freshness";
-import { createProductFromCatalogueItem, CONSIGNMENT_STORE_ID } from "../utils/product-from-item";
+import { catalogueRepository, storeRepository } from "../../../repositories/index.js";
+import { requireRoleUser } from "../../../providers/auth-firebase/helpers.js";
+import { isAdminUser } from "../../../features/auth/role-predicates.js";
+import { ValidationError, AuthorizationError } from "../../../errors/index.js";
+import { assertCatalogueImagesFresh } from "../utils/freshness.js";
+import { createProductFromCatalogueItem, CONSIGNMENT_STORE_ID } from "../utils/product-from-item.js";
 /**
  * Direct-listing path — turns a catalogue item straight into a real listing,
  * no approval queue. Two callers:

package/dist/features/catalogue/actions/submit-for-approval.js

@@ -1,9 +1,9 @@
 "use server";
 import { wrapAction } from "@mohasinac/appkit/server";
-import { catalogueRepository } from "../../../repositories";
-import { requireRoleUser } from "../../../providers/auth-firebase/helpers";
-import { ValidationError, AuthorizationError } from "../../../errors";
-import { assertCatalogueImagesFresh } from "../utils/freshness";
+import { catalogueRepository } from "../../../repositories/index.js";
+import { requireRoleUser } from "../../../providers/auth-firebase/helpers.js";
+import { ValidationError, AuthorizationError } from "../../../errors/index.js";
+import { assertCatalogueImagesFresh } from "../utils/freshness.js";
 /**
  * Buyer path — requests admin list the item on their behalf. Flips
  * listingStatus to "pending_admin_approval"; the admin-notification fan-out

package/dist/features/catalogue/components/AdminCatalogueApprovalsView.js

@@ -4,13 +4,13 @@ import React from "react";
 import { sortBy } from "@mohasinac/appkit/client";
 import { useQueryClient } from "@tanstack/react-query";
 import { useApiMutation } from "@mohasinac/appkit/client";
-import { Button, Modal, RecordDetailModal, Row, Stack, Text, Textarea } from "../../../ui";
-import { formatCurrency } from "../../../utils/number.formatter";
-import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
-import { apiClient } from "../../../http";
-import { toRecordArray, toRelativeDate, toStringValue, } from "../../admin/hooks/useAdminListingData";
-import { DataListingView } from "../../admin/components/DataListingView";
-import { RecordStatusTimeline } from "../../status-history/components/RecordStatusTimeline";
+import { Button, Modal, RecordDetailModal, Row, Stack, Text, Textarea } from "../../../ui/index.js";
+import { formatCurrency } from "../../../utils/number.formatter.js";
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints.js";
+import { apiClient } from "../../../http/index.js";
+import { toRecordArray, toRelativeDate, toStringValue, } from "../../admin/hooks/useAdminListingData.js";
+import { DataListingView } from "../../admin/components/DataListingView.js";
+import { RecordStatusTimeline } from "../../status-history/components/RecordStatusTimeline.js";
 /** The submitted item's photos — the whole point of a visual approval. */
 function toPhotoEntries(raw) {
     const images = Array.isArray(raw.images) ? raw.images : [];

package/dist/features/catalogue/components/CatalogueItemEditorView.js

@@ -1,6 +1,6 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { IMAGE_ACCEPT_ATTR } from "../../../_internal/shared/media/limits";
+import { IMAGE_ACCEPT_ATTR } from "../../../_internal/shared/media/limits.js";
 /**
  * Add or edit an item in a user's personal catalogue.
  *
@@ -26,17 +26,17 @@ import { IMAGE_ACCEPT_ATTR } from "../../../_internal/shared/media/limits";
 import React from "react";
 import { useQueryClient } from "@tanstack/react-query";
 import { useApiMutation } from "@mohasinac/appkit/client";
-import { ACCOUNT_ENDPOINTS, BRAND_ENDPOINTS, CATEGORY_ENDPOINTS } from "../../../constants/api-endpoints";
-import { apiClient } from "../../../http";
-import { Alert, PaginatedSelect, Stack } from "../../../ui";
-import { applyZodIssues } from "../../../ui/forms/apply-zod-issues";
-import { FormErrorSummary } from "../../../ui/forms/FormErrorSummary";
-import { FormShellContext, useFormShellState } from "../../../ui/forms/FormShell";
-import { buildSectionsFromSchema } from "../../shell/build-sections";
-import { SectionForm, useSectionFormNav } from "../../shell/SectionForm";
-import { useMediaUpload } from "../../media";
-import { MediaUploadList } from "../../media/upload/MediaUploadList";
-import { createCatalogueItemSchema } from "../schemas/validation";
+import { ACCOUNT_ENDPOINTS, BRAND_ENDPOINTS, CATEGORY_ENDPOINTS } from "../../../constants/api-endpoints.js";
+import { apiClient } from "../../../http/index.js";
+import { Alert, PaginatedSelect, Stack } from "../../../ui/index.js";
+import { applyZodIssues } from "../../../ui/forms/apply-zod-issues.js";
+import { FormErrorSummary } from "../../../ui/forms/FormErrorSummary.js";
+import { FormShellContext, useFormShellState } from "../../../ui/forms/FormShell.js";
+import { buildSectionsFromSchema } from "../../shell/build-sections.js";
+import { SectionForm, useSectionFormNav } from "../../shell/SectionForm.js";
+import { useMediaUpload } from "../../media/index.js";
+import { MediaUploadList } from "../../media/upload/MediaUploadList.js";
+import { createCatalogueItemSchema } from "../schemas/validation.js";
 /** PUBLIC endpoints — this is a buyer surface; the admin ones would 403. */
 async function loadOptionsFrom(endpoint, query, page, 
 /** Extra query params. Passed as an object rather than baked into

package/dist/features/catalogue/components/PublicCatalogueItemDetailView.js

@@ -1,13 +1,13 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import Link from "next/link";
+import Link from "next/link.js";
 import { useQuery } from "@tanstack/react-query";
-import { Container, Div, GatedPrice, Grid, Heading, Main, Row, Section, Skeleton, Span, Stack, Text } from "../../../ui";
-import { MediaImage } from "../../media/MediaImage";
-import { apiClient } from "../../../http";
-import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints";
-import { formatCurrency } from "../../../utils/number.formatter";
-import { ROUTES } from "../../../next/routing/route-map";
+import { Container, Div, GatedPrice, Grid, Heading, Main, Row, Section, Skeleton, Span, Stack, Text } from "../../../ui/index.js";
+import { MediaImage } from "../../media/MediaImage.js";
+import { apiClient } from "../../../http/index.js";
+import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints.js";
+import { formatCurrency } from "../../../utils/number.formatter.js";
+import { ROUTES } from "../../../next/routing/route-map.js";
 const __O = {
     hidden: "overflow-hidden",
 };

package/dist/features/catalogue/components/PublicCatalogueView.js

@@ -1,12 +1,12 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import Link from "next/link";
+import Link from "next/link.js";
 import { useQuery } from "@tanstack/react-query";
-import { Div, GatedPrice, Grid, Heading, Skeleton, Text } from "../../../ui";
-import { MediaImage } from "../../media/MediaImage";
-import { apiClient } from "../../../http";
-import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints";
-import { formatCurrency } from "../../../utils/number.formatter";
+import { Div, GatedPrice, Grid, Heading, Skeleton, Text } from "../../../ui/index.js";
+import { MediaImage } from "../../media/MediaImage.js";
+import { apiClient } from "../../../http/index.js";
+import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints.js";
+import { formatCurrency } from "../../../utils/number.formatter.js";
 export function PublicCatalogueView({ ownerSlug }) {
     const { data, isLoading } = useQuery({
         queryKey: ["catalogue", "public", ownerSlug],

package/dist/features/catalogue/components/UserCatalogueView.js

@@ -3,11 +3,11 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React from "react";
 import { useQuery, useQueryClient } from "@tanstack/react-query";
 import { useApiMutation } from "@mohasinac/appkit/client";
-import { Badge, Button, Div, Grid, Heading, Row, SideDrawer, Skeleton, Stack, Text } from "../../../ui";
-import { MediaImage } from "../../media/MediaImage";
-import { apiClient } from "../../../http";
-import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints";
-import { CatalogueItemEditorView } from "./CatalogueItemEditorView";
+import { Badge, Button, Div, Grid, Heading, Row, SideDrawer, Skeleton, Stack, Text } from "../../../ui/index.js";
+import { MediaImage } from "../../media/MediaImage.js";
+import { apiClient } from "../../../http/index.js";
+import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints.js";
+import { CatalogueItemEditorView } from "./CatalogueItemEditorView.js";
 const STATUS_VARIANT = {
     not_listed: "secondary",
     pending_admin_approval: "warning",