@mohasinac/appkit 2.6.3 → 2.6.5

package/dist/_internal/shared/checkout/rules/prize-draw.rule.js

@@ -0,0 +1,65 @@
+import { ValidationError } from "../../../../errors";
+import { DEFAULT_LISTING_RULE } from "./_defaults";
+import { PRIZE_DRAW_MAX_REVEALS_PER_ORDER } from "./_limits";
+export const prizeDrawRule = {
+    ...DEFAULT_LISTING_RULE,
+    orderType: "prize-draw",
+    nonRefundable: true,
+    maxQuantityPerLine: 1,
+    canMergeWithSameProduct: false,
+    maxLinesPerOrder: PRIZE_DRAW_MAX_REVEALS_PER_ORDER,
+    refundPolicy: { full: false, partial: false, partialGranularity: "none" },
+    splitKey: (item) => `prize-draw:${item.itemId}`,
+    /**
+     * Slice a high-quantity prize-draw entry into chunks of
+     * PRIZE_DRAW_MAX_REVEALS_PER_ORDER so each resulting order has at most
+     * that many reveal slots.  Buying 7 entries → [3, 3, 1].
+     */
+    splitMultipleOrders: (item) => {
+        if (item.quantity <= PRIZE_DRAW_MAX_REVEALS_PER_ORDER)
+            return [item];
+        const chunks = [];
+        let remaining = item.quantity;
+        let batchIndex = 0;
+        while (remaining > 0) {
+            const batchQty = Math.min(remaining, PRIZE_DRAW_MAX_REVEALS_PER_ORDER);
+            chunks.push({
+                ...item,
+                quantity: batchQty,
+                itemId: `${item.itemId}-batch-${batchIndex}`,
+            });
+            remaining -= batchQty;
+            batchIndex++;
+        }
+        return chunks;
+    },
+    preflightChecks: (pairs) => {
+        for (const { item, product } of pairs) {
+            if (product.listingType !== "prize-draw")
+                continue;
+            const max = product.prizeMaxEntries ?? 0;
+            if (max <= 0)
+                continue;
+            const current = product.prizeCurrentEntries ?? 0;
+            if (current + item.quantity > max) {
+                throw Object.assign(new ValidationError(`Draw is full for "${product.title}". ${current}/${max} entries already in.`), { code: "PRIZE_POOL_FULL", productId: product.id });
+            }
+        }
+    },
+    stockDecrementExtras: (product, quantity) => {
+        if (product.listingType !== "prize-draw")
+            return {};
+        return {
+            prizeCurrentEntries: (product.prizeCurrentEntries ?? 0) + quantity,
+        };
+    },
+    decorateOrderItem: (line, product) => ({
+        ...line,
+        listingType: "prize-draw",
+        prizeRevealStatus: product.prizeRevealStatus === "open" ? "open" : "pending",
+    }),
+    decorateOrderDoc: (_groupFirstItem, groupFirstProduct) => ({
+        prizeDrawProductId: groupFirstProduct.id,
+        isNonRefundable: true,
+    }),
+};

package/dist/_internal/shared/checkout/rules/standard.rule.d.ts

@@ -0,0 +1,2 @@
+import type { ListingCheckoutRule } from "./types";
+export declare const standardRule: ListingCheckoutRule;

package/dist/_internal/shared/checkout/rules/standard.rule.js

@@ -0,0 +1,5 @@
+import { DEFAULT_LISTING_RULE } from "./_defaults";
+export const standardRule = {
+    ...DEFAULT_LISTING_RULE,
+    orderType: "standard",
+};

package/dist/_internal/shared/checkout/rules/types.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Checkout rule interfaces — S-SBUNI-RULES 2026-05-13.
+ *
+ * Two registries:
+ *   - CHECKOUT_RULES  keyed by ListingType  (for cart-based products)
+ *   - CATEGORY_CHECKOUT_RULES  keyed by CategoryType  (for direct-checkout
+ *     categories like bundles)
+ *
+ * Every hook has a default in _defaults.ts so rule files only override what
+ * differs from the baseline. This is the seam that makes Phase 2+ listing
+ * types zero-consumer-edit additions.
+ */
+import type { CartItemDocument } from "../../../../features/cart/schemas/firestore";
+import type { ProductDocument } from "../../../../features/products/schemas/firestore";
+import type { OrderDocumentItem } from "../../../../features/orders/schemas/firestore";
+import type { OrderType } from "../../../../features/orders/utils/order-splitter";
+export interface CartItemProductPair {
+    item: CartItemDocument;
+    product: ProductDocument;
+}
+/** Minimal shape for an order-line created by the checkout action pipeline. */
+export interface OrderItemInput extends Omit<OrderDocumentItem, "bundleCategorySlug" | "bundleProductIds"> {
+    bundleCategorySlug?: string;
+    bundleProductIds?: string[];
+}
+export interface RefundPolicy {
+    full: boolean;
+    partial: boolean;
+    /** Granularity of partial refunds when `partial: true`. */
+    partialGranularity: "item" | "amount" | "none";
+}
+/**
+ * Checkout rule for a ListingType.  Every field has a default; rule files only
+ * override what differs from the baseline.
+ */
+export interface ListingCheckoutRule {
+    /** Can this listing type be purchased at all? */
+    purchaseable: boolean;
+    /**
+     * Can this item sit in the shopping cart?  False for auctions (bid-only),
+     * classified (chat-only), live (pending jurisdiction gate), bundles
+     * (direct-checkout-only via CategoryCheckoutRule).
+     */
+    cartEligible: boolean;
+    /** OrderType assigned to orders created from this listing type. */
+    orderType: OrderType;
+    /**
+     * Does checkout require a shipping address? False for digital-code (electronic
+     * delivery) and classified (meetup-arranged locally).
+     */
+    requiresShippingAddress: boolean;
+    /** Does checkout require the consent-OTP gate? */
+    requiresConsentOtp: boolean;
+    /**
+     * Is this order non-refundable? Blocks the refund API for orders of this type.
+     * Set true for prize-draw entries.
+     */
+    nonRefundable: boolean;
+    /** Hard qty cap per single cart line. Auction/offer/prize-draw-per-line = 1. */
+    maxQuantityPerLine: number;
+    /**
+     * When false the checkout pipeline issues one order per cart line (even when
+     * multiple lines share the same product).  Auctions and offers set this to
+     * false so each lock is its own order.
+     */
+    canMergeWithSameProduct: boolean;
+    /**
+     * Maximum reveal-entries per order. Prize-draw sets this to
+     * PRIZE_DRAW_MAX_REVEALS_PER_ORDER (3) — an entry qty of 7 becomes [3,3,1].
+     * Infinity for all other types.
+     */
+    maxLinesPerOrder: number;
+    /** Full/partial refund capabilities per type. */
+    refundPolicy: RefundPolicy;
+    /**
+     * Return the grouping key used by the order splitter. Items with the same
+     * key land in the same OrderGroup and produce one order document.
+     */
+    splitKey(item: CartItemDocument): string;
+    /**
+     * Slice a single cart item into N virtual items when qty > maxLinesPerOrder.
+     * Returns [item] for most types.  Prize-draw overrides to chunk the quantity
+     * into batches of PRIZE_DRAW_MAX_REVEALS_PER_ORDER.
+     */
+    splitMultipleOrders(item: CartItemDocument): CartItemDocument[];
+    /**
+     * Synchronous preflight guard — runs before any state is mutated.
+     * Throws ValidationError on violation; returns void on pass.
+     * Receives only data already in memory (no IO needed).
+     *
+     * Pre-order checks reservationCap. Prize-draw checks prizeMaxEntries.
+     * Future `live` checks jurisdiction from product + buyer state.
+     */
+    preflightChecks(pairs: CartItemProductPair[]): void;
+    /**
+     * Return extra Firestore field updates to merge alongside the standard
+     * `availableQuantity` decrement. Pure — works from product data already
+     * fetched by the calling action.
+     *
+     * Prize-draw bumps `prizeCurrentEntries`. Pre-order bumps `preOrderCurrentCount`.
+     */
+    stockDecrementExtras(product: ProductDocument, quantity: number): Record<string, unknown>;
+    /**
+     * Transform a raw order-line input (built from cart item data) before it
+     * is written to the OrderDocument.  Adds type-specific fields such as
+     * prize-draw reveal status and deadline.
+     */
+    decorateOrderItem(line: OrderItemInput, product: ProductDocument): OrderItemInput;
+    /**
+     * Return extra fields to spread onto the created OrderDocument.
+     * Used for prize-draw-specific fields (prizeDrawProductId, isNonRefundable,
+     * prizeRevealDeadline).
+     */
+    decorateOrderDoc(groupFirstItem: CartItemDocument, groupFirstProduct: ProductDocument): Record<string, unknown>;
+}
+/**
+ * Checkout rule for a purchaseable CategoryType (currently only "bundle").
+ * Bundles are always direct-checkout — they never enter the cart.
+ */
+export interface CategoryCheckoutRule {
+    purchaseable: boolean;
+    cartEligible: boolean;
+    orderType: OrderType;
+    requiresShippingAddress: boolean;
+}

package/dist/_internal/shared/checkout/rules/types.js

@@ -0,0 +1,13 @@
+/**
+ * Checkout rule interfaces — S-SBUNI-RULES 2026-05-13.
+ *
+ * Two registries:
+ *   - CHECKOUT_RULES  keyed by ListingType  (for cart-based products)
+ *   - CATEGORY_CHECKOUT_RULES  keyed by CategoryType  (for direct-checkout
+ *     categories like bundles)
+ *
+ * Every hook has a default in _defaults.ts so rule files only override what
+ * differs from the baseline. This is the seam that makes Phase 2+ listing
+ * types zero-consumer-edit additions.
+ */
+export {};

package/dist/_internal/shared/features/cart/schema.d.ts

@@ -20,8 +20,8 @@ export declare const addToCartSchema: z.ZodObject<{
     productTitle: string;
     productImage: string;
     price: number;
-    listingType: "auction" | "standard" | "prize-draw" | "pre-order";
     storeName: string;
+    listingType: "auction" | "standard" | "pre-order" | "prize-draw";
     offerId?: string | undefined;
     lockedPrice?: number | undefined;
     isOffer?: boolean | undefined;
@@ -30,7 +30,7 @@ export declare const addToCartSchema: z.ZodObject<{
     productId: string;
     productTitle: string;
     price: number;
-    listingType: "auction" | "standard" | "prize-draw" | "pre-order";
+    listingType: "auction" | "standard" | "pre-order" | "prize-draw";
     currency?: string | undefined;
     quantity?: number | undefined;
     productImage?: string | undefined;
@@ -78,8 +78,8 @@ export declare const mergeGuestCartSchema: z.ZodObject<{
         productTitle: string;
         productImage: string;
         price: number;
-        listingType: "auction" | "standard" | "prize-draw" | "pre-order";
         storeName: string;
+        listingType: "auction" | "standard" | "pre-order" | "prize-draw";
         offerId?: string | undefined;
         lockedPrice?: number | undefined;
         isOffer?: boolean | undefined;
@@ -88,7 +88,7 @@ export declare const mergeGuestCartSchema: z.ZodObject<{
         productId: string;
         productTitle: string;
         price: number;
-        listingType: "auction" | "standard" | "prize-draw" | "pre-order";
+        listingType: "auction" | "standard" | "pre-order" | "prize-draw";
         currency?: string | undefined;
         quantity?: number | undefined;
         productImage?: string | undefined;
@@ -106,8 +106,8 @@ export declare const mergeGuestCartSchema: z.ZodObject<{
         productTitle: string;
         productImage: string;
         price: number;
-        listingType: "auction" | "standard" | "prize-draw" | "pre-order";
         storeName: string;
+        listingType: "auction" | "standard" | "pre-order" | "prize-draw";
         offerId?: string | undefined;
         lockedPrice?: number | undefined;
         isOffer?: boolean | undefined;
@@ -118,7 +118,7 @@ export declare const mergeGuestCartSchema: z.ZodObject<{
         productId: string;
         productTitle: string;
         price: number;
-        listingType: "auction" | "standard" | "prize-draw" | "pre-order";
+        listingType: "auction" | "standard" | "pre-order" | "prize-draw";
         currency?: string | undefined;
         quantity?: number | undefined;
         productImage?: string | undefined;

package/dist/_internal/shared/features/categories/bundle-copy.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Bundle UI copy — single source of truth for user-facing strings rendered by
+ * the bundle views (S-SBUNI-3 + S-SBUNI-4). Keeping these in one shared module
+ * means a copy change touches one file, not five components.
+ *
+ * Pure string constants — no React, no styling. Safe to import from anywhere
+ * in the appkit tree.
+ */
+export declare const BUNDLE_COPY: {
+    readonly detailItemsHeading: "What's included";
+    readonly detailDescriptionHeading: "About this bundle";
+    readonly featuredDefaultTitle: "Curated Bundles";
+    readonly adminListTitle: "Bundles";
+    readonly adminEditorTitleNew: "New bundle";
+    readonly adminEditorTitleEdit: "Edit bundle";
+    readonly picker: {
+        readonly title: "Bundle members";
+        readonly selectedCount: (selected: number, min: number, max: number) => string;
+        readonly searchPlaceholder: "Search products to add (type at least 2 characters)";
+        readonly searchAriaLabel: "Search bundle member products";
+        readonly searchingHint: "Searching…";
+        readonly searchErrorPrefix: "Search error";
+        readonly noMatches: (query: string) => string;
+        readonly removeAria: (title: string) => string;
+        readonly toggleAria: (title: string) => string;
+    };
+    readonly detail: {
+        readonly priceFallback: "—";
+        readonly itemCount: (n: number) => string;
+        readonly emptyMembers: "Bundle contents are being updated. Check back shortly.";
+        readonly ctaDisabled: "Add to cart coming soon";
+        readonly ctaHint: "Bundle checkout is being wired up — buyers can browse contents now and the buy flow ships in the next release.";
+        readonly ctaAddToCart: "Add bundle to cart";
+        readonly ctaAdding: "Adding…";
+        readonly ctaOutOfStock: "Currently out of stock";
+        readonly ctaSuccess: "Bundle added to cart";
+        readonly ctaSignInRequired: "Sign in to add to cart";
+        readonly ctaErrorFallback: "Couldn't add bundle to cart";
+        readonly ctaBuyNow: "Buy now";
+        readonly qtyLabel: "Qty";
+        readonly qtyAriaLabel: "Bundle quantity";
+    };
+    readonly orderDetail: {
+        readonly bundleHeader: (name: string) => string;
+        readonly bundleItemCount: (n: number) => string;
+        readonly expandLabel: "Show items";
+        readonly collapseLabel: "Hide items";
+    };
+    readonly featured: {
+        readonly viewAll: "View all bundles →";
+        readonly empty: "Bundles coming soon — curated multi-item drops launching shortly.";
+        readonly priceFallback: "—";
+        readonly itemCount: (n: number) => string;
+    };
+    readonly adminList: {
+        readonly newButton: "+ New bundle";
+        readonly loading: "Loading bundles…";
+        readonly empty: "No bundles yet. Create one to get started.";
+        readonly columns: {
+            readonly name: "Name";
+            readonly price: "Price";
+            readonly members: "Members";
+            readonly stock: "Stock";
+            readonly status: "Status";
+        };
+        readonly editLabel: "Edit";
+        readonly activeBadge: "Active";
+        readonly inactiveBadge: "Inactive";
+    };
+    readonly adminEditor: {
+        readonly loading: "Loading bundle…";
+        readonly saveButton: (saving: boolean, isEdit: boolean) => "Saving…" | "Save changes" | "Create bundle";
+        readonly deleteButton: (deleting: boolean) => "Deleting…" | "Delete bundle";
+        readonly deleteConfirm: "Delete this bundle? This action cannot be undone.";
+        readonly fields: {
+            readonly nameLabel: "Name *";
+            readonly namePlaceholder: "Pokémon TCG Starter Pack 2026";
+            readonly descriptionLabel: "Description";
+            readonly descriptionPlaceholder: "One paragraph describing what's in the bundle and who it's for.";
+            readonly priceLabel: "Bundle price (₹) *";
+            readonly pricePlaceholder: "6499";
+            readonly pricePaiseHint: (paise: number | null) => string;
+            readonly coverImageLabel: "Cover image URL";
+            readonly activeLabel: "Bundle is active (visible to buyers)";
+        };
+        readonly ruleTypeLabel: "Bundle members source";
+        readonly ruleTypeStatic: "Hand-picked products";
+        readonly ruleTypeDynamic: "Dynamic query (auto-resolves)";
+        readonly dynamic: {
+            readonly title: "Dynamic query rule";
+            readonly hint: "onProductStockChange resolves bundleProductIds; bundleQueryResolvedAt tracks the last refresh.";
+            readonly fields: {
+                readonly categorySlug: "Category slug filter";
+                readonly brandSlug: "Brand slug filter";
+                readonly tags: "Tags (comma-separated)";
+                readonly listingType: "Listing type";
+                readonly orderBy: "Order by";
+                readonly limit: "Limit";
+            };
+        };
+        readonly errors: {
+            readonly nameRequired: "Bundle name is required";
+            readonly priceInvalid: "Bundle price must be a positive number (rupees)";
+            readonly loadFailed: "Failed to load bundle";
+            readonly saveFailed: "Save failed";
+            readonly deleteFailed: "Delete failed";
+        };
+    };
+    readonly stockBadge: {
+        readonly in_stock: "In stock";
+        readonly partial: "Some items unavailable";
+        readonly out_of_stock: "Currently out of stock";
+        readonly listVariantInStock: "In stock";
+        readonly listVariantPartial: "Partial";
+        readonly listVariantOutOfStock: "Out of stock";
+    };
+};
+/** Stock-status variant mapping (kept here so consumers can drive Badge variant prop). */
+export declare const BUNDLE_STOCK_VARIANT: {
+    readonly in_stock: "success";
+    readonly partial: "warning";
+    readonly out_of_stock: "danger";
+};

package/dist/_internal/shared/features/categories/bundle-copy.js

@@ -0,0 +1,134 @@
+/**
+ * Bundle UI copy — single source of truth for user-facing strings rendered by
+ * the bundle views (S-SBUNI-3 + S-SBUNI-4). Keeping these in one shared module
+ * means a copy change touches one file, not five components.
+ *
+ * Pure string constants — no React, no styling. Safe to import from anywhere
+ * in the appkit tree.
+ */
+export const BUNDLE_COPY = {
+    // Headings + section titles
+    detailItemsHeading: "What's included",
+    detailDescriptionHeading: "About this bundle",
+    featuredDefaultTitle: "Curated Bundles",
+    adminListTitle: "Bundles",
+    adminEditorTitleNew: "New bundle",
+    adminEditorTitleEdit: "Edit bundle",
+    picker: {
+        title: "Bundle members",
+        selectedCount: (selected, min, max) => `${selected} selected · min ${min}, max ${max}`,
+        searchPlaceholder: "Search products to add (type at least 2 characters)",
+        searchAriaLabel: "Search bundle member products",
+        searchingHint: "Searching…",
+        searchErrorPrefix: "Search error",
+        noMatches: (query) => `No matches for "${query}".`,
+        removeAria: (title) => `Remove ${title}`,
+        toggleAria: (title) => `Toggle ${title}`,
+    },
+    // Detail page
+    detail: {
+        priceFallback: "—",
+        itemCount: (n) => `${n} item${n !== 1 ? "s" : ""}`,
+        emptyMembers: "Bundle contents are being updated. Check back shortly.",
+        // SB-UNI-5 2026-05-13 — CTA functional. Disabled-CTA copy retained for
+        // consumers that opt out of the wired CTA (the new client island reads
+        // the active strings below).
+        ctaDisabled: "Add to cart coming soon",
+        ctaHint: "Bundle checkout is being wired up — buyers can browse contents now and the buy flow ships in the next release.",
+        ctaAddToCart: "Add bundle to cart",
+        ctaAdding: "Adding…",
+        ctaOutOfStock: "Currently out of stock",
+        ctaSuccess: "Bundle added to cart",
+        ctaSignInRequired: "Sign in to add to cart",
+        ctaErrorFallback: "Couldn't add bundle to cart",
+        ctaBuyNow: "Buy now",
+        qtyLabel: "Qty",
+        qtyAriaLabel: "Bundle quantity",
+    },
+    // Order detail bundle grouping (SB-UNI-5)
+    orderDetail: {
+        bundleHeader: (name) => `Bundle: ${name}`,
+        bundleItemCount: (n) => `Includes ${n} item${n !== 1 ? "s" : ""}`,
+        expandLabel: "Show items",
+        collapseLabel: "Hide items",
+    },
+    // Featured strip
+    featured: {
+        viewAll: "View all bundles →",
+        empty: "Bundles coming soon — curated multi-item drops launching shortly.",
+        priceFallback: "—",
+        itemCount: (n) => `${n} item${n !== 1 ? "s" : ""}`,
+    },
+    // Admin list
+    adminList: {
+        newButton: "+ New bundle",
+        loading: "Loading bundles…",
+        empty: "No bundles yet. Create one to get started.",
+        columns: {
+            name: "Name",
+            price: "Price",
+            members: "Members",
+            stock: "Stock",
+            status: "Status",
+        },
+        editLabel: "Edit",
+        activeBadge: "Active",
+        inactiveBadge: "Inactive",
+    },
+    // Admin editor
+    adminEditor: {
+        loading: "Loading bundle…",
+        saveButton: (saving, isEdit) => saving ? "Saving…" : isEdit ? "Save changes" : "Create bundle",
+        deleteButton: (deleting) => deleting ? "Deleting…" : "Delete bundle",
+        deleteConfirm: "Delete this bundle? This action cannot be undone.",
+        fields: {
+            nameLabel: "Name *",
+            namePlaceholder: "Pokémon TCG Starter Pack 2026",
+            descriptionLabel: "Description",
+            descriptionPlaceholder: "One paragraph describing what's in the bundle and who it's for.",
+            priceLabel: "Bundle price (₹) *",
+            pricePlaceholder: "6499",
+            pricePaiseHint: (paise) => `Stored as paise: ${paise ?? "—"}`,
+            coverImageLabel: "Cover image URL",
+            activeLabel: "Bundle is active (visible to buyers)",
+        },
+        // SB-UNI-5 2026-05-13 — static/dynamic rule-type toggle.
+        ruleTypeLabel: "Bundle members source",
+        ruleTypeStatic: "Hand-picked products",
+        ruleTypeDynamic: "Dynamic query (auto-resolves)",
+        dynamic: {
+            title: "Dynamic query rule",
+            hint: "onProductStockChange resolves bundleProductIds; bundleQueryResolvedAt tracks the last refresh.",
+            fields: {
+                categorySlug: "Category slug filter",
+                brandSlug: "Brand slug filter",
+                tags: "Tags (comma-separated)",
+                listingType: "Listing type",
+                orderBy: "Order by",
+                limit: "Limit",
+            },
+        },
+        errors: {
+            nameRequired: "Bundle name is required",
+            priceInvalid: "Bundle price must be a positive number (rupees)",
+            loadFailed: "Failed to load bundle",
+            saveFailed: "Save failed",
+            deleteFailed: "Delete failed",
+        },
+    },
+    // Stock badges (shared between list + featured + detail)
+    stockBadge: {
+        in_stock: "In stock",
+        partial: "Some items unavailable",
+        out_of_stock: "Currently out of stock",
+        listVariantInStock: "In stock",
+        listVariantPartial: "Partial",
+        listVariantOutOfStock: "Out of stock",
+    },
+};
+/** Stock-status variant mapping (kept here so consumers can drive Badge variant prop). */
+export const BUNDLE_STOCK_VARIANT = {
+    in_stock: "success",
+    partial: "warning",
+    out_of_stock: "danger",
+};