@mohasinac/appkit 3.2.20 → 3.3.0

package/dist/features/products/components/ProductForm.js

@@ -12,8 +12,23 @@ import { useMediaUpload } from "../../media";
 import { resolveDate } from "../../../utils/date.formatter";
 import { normalizeRichTextHtml } from "../../../utils/string.formatter";
 import { useListingTypeFlags } from "../../../react/hooks/useListingTypeFlags";
-import { isAuctionListing, isPreOrderListing, isPrizeDrawListing, } from "../utils/listing-type";
+import { isAuctionListing, isPreOrderListing, isPrizeDrawListing, normalizeListingType, } from "../utils/listing-type";
 import { PrizeDrawItemsEditor } from "./PrizeDrawItemsEditor";
+// ListingType uses the canonical SB1-G spellings ("standard", "pre-order");
+// ProductFeatureProductType predates it with legacy spellings for 2 values.
+// Replaces the old 2-case ternary that silently mapped every other type
+// (classified/digital-code/live/prize-draw/art/stickers) to "product".
+const LISTING_TYPE_TO_FEATURE_PRODUCT_TYPE = {
+    standard: "product",
+    auction: "auction",
+    "pre-order": "preorder",
+    "prize-draw": "prize-draw",
+    classified: "classified",
+    "digital-code": "digital-code",
+    live: "live",
+    art: "art",
+    stickers: "stickers",
+};
 export const PRODUCT_STATUS_OPTIONS = [
     { value: "draft", label: "Draft" },
     { value: "published", label: "Published" },
@@ -122,7 +137,7 @@ export function ProductForm({ product, onChange, isReadonly = false, renderDescr
                         .split(",")
                         .map((tag) => tag.trim())
                         .filter(Boolean),
-                }), disabled: isReadonly, placeholder: t("formTagsPlaceholder") }), _jsxs(FormGroup, { columns: 2, children: [_jsx(Checkbox, { label: t("formFeatured"), checked: !!product.featured, onChange: (e) => update({ featured: e.target.checked }), disabled: isReadonly }), _jsx(Checkbox, { label: t("formIsPromoted"), checked: !!product.isPromoted, onChange: (e) => update({ isPromoted: e.target.checked }), disabled: isReadonly })] }), _jsx(Heading, { level: 4, className: "mt-4", children: t("sectionConditionShipping") }), _jsxs(FormGroup, { columns: 2, children: [_jsx(FormField, { name: "condition", label: t("formCondition"), type: "select", value: product.condition || "new", onChange: (value) => update({
+                }), disabled: isReadonly, placeholder: t("formTagsPlaceholder") }), _jsxs(FormGroup, { columns: 2, children: [_jsx(Checkbox, { label: t("formFeatured"), checked: !!product.featured, onChange: (e) => update({ featured: e.target.checked }), disabled: isReadonly }), _jsx(Checkbox, { label: t("formIsPromoted"), checked: !!product.isPromoted, onChange: (e) => update({ isPromoted: e.target.checked }), disabled: isReadonly }), _jsx(Checkbox, { label: t("formAllowShipBeforeEmiComplete"), checked: !!product.allowShipBeforeEmiComplete, onChange: (e) => update({ allowShipBeforeEmiComplete: e.target.checked }), disabled: isReadonly })] }), _jsx(Heading, { level: 4, className: "mt-4", children: t("sectionConditionShipping") }), _jsxs(FormGroup, { columns: 2, children: [_jsx(FormField, { name: "condition", label: t("formCondition"), type: "select", value: product.condition || "new", onChange: (value) => update({
                             condition: value,
                         }), disabled: isReadonly, options: [
                             { value: "new", label: t("formConditionNew") },
@@ -199,11 +214,7 @@ export function ProductForm({ product, onChange, isReadonly = false, renderDescr
                 value: product.groupId,
                 onChange: (id) => update({ groupId: id || undefined }),
                 disabled: isReadonly,
-            }), !isAuctionListing(product) && renderGroupSettings?.(product), _jsx(ProductFeaturesSelector, { value: product.features ?? [], onChange: (features) => update({ features }), productType: (isAuctionListing(product)
-                    ? "auction"
-                    : isPreOrderListing(product)
-                        ? "preorder"
-                        : "product"), storeId: product.storeId, disabled: isReadonly }), _jsxs(Div, { children: [_jsx(Heading, { level: 3, className: "mb-1", color: "muted", size: "sm", weight: "semibold", children: "Custom Sections" }), _jsx(Text, { className: "mb-3", color: "muted", size: "xs", children: "Add up to 3 custom tabs to your product page \u2014 e.g. \"Box Contents\", \"Compatibility\", \"Grading Details\"." }), _jsx(CustomSectionsEditor, { sections: product.customSections ?? [], onChange: (sections) => update({ customSections: sections }) })] }), _jsx(FormField, { name: "shippingInfo", label: t("formShipping"), type: "textarea", value: product.shippingInfo || "", onChange: (value) => update({ shippingInfo: value }), disabled: isReadonly, placeholder: "Shipping information..." }), _jsx(FormField, { name: "returnPolicy", label: t("formReturnPolicy"), type: "textarea", value: product.returnPolicy || "", onChange: (value) => update({ returnPolicy: value }), disabled: isReadonly, placeholder: "Return policy details..." }), _jsxs(Div, { children: [_jsx(Heading, { level: 3, className: "mb-1", color: "muted", size: "sm", weight: "semibold", children: "Physical Inventory" }), _jsx(Text, { className: "mb-3", color: "muted", size: "xs", children: "Assign a storage location for warehouse or shelf organisation. Used by the Print & Label Center." }), _jsxs(FormGroup, { columns: 3, children: [_jsx(FormField, { name: "physicalLocation.zone", label: "Zone", type: "text", placeholder: "e.g. A", value: product.physicalLocation?.zone ?? "", onChange: (v) => update({
+            }), !isAuctionListing(product) && renderGroupSettings?.(product), _jsx(ProductFeaturesSelector, { value: product.features ?? [], onChange: (features) => update({ features }), productType: LISTING_TYPE_TO_FEATURE_PRODUCT_TYPE[normalizeListingType(product)], storeId: product.storeId, disabled: isReadonly }), _jsxs(Div, { children: [_jsx(Heading, { level: 3, className: "mb-1", color: "muted", size: "sm", weight: "semibold", children: "Custom Sections" }), _jsx(Text, { className: "mb-3", color: "muted", size: "xs", children: "Add up to 3 custom tabs to your product page \u2014 e.g. \"Box Contents\", \"Compatibility\", \"Grading Details\"." }), _jsx(CustomSectionsEditor, { sections: product.customSections ?? [], onChange: (sections) => update({ customSections: sections }) })] }), _jsx(FormField, { name: "shippingInfo", label: t("formShipping"), type: "textarea", value: product.shippingInfo || "", onChange: (value) => update({ shippingInfo: value }), disabled: isReadonly, placeholder: "Shipping information..." }), _jsx(FormField, { name: "returnPolicy", label: t("formReturnPolicy"), type: "textarea", value: product.returnPolicy || "", onChange: (value) => update({ returnPolicy: value }), disabled: isReadonly, placeholder: "Return policy details..." }), _jsxs(Div, { children: [_jsx(Heading, { level: 3, className: "mb-1", color: "muted", size: "sm", weight: "semibold", children: "Physical Inventory" }), _jsx(Text, { className: "mb-3", color: "muted", size: "xs", children: "Assign a storage location for warehouse or shelf organisation. Used by the Print & Label Center." }), _jsxs(FormGroup, { columns: 3, children: [_jsx(FormField, { name: "physicalLocation.zone", label: "Zone", type: "text", placeholder: "e.g. A", value: product.physicalLocation?.zone ?? "", onChange: (v) => update({
                                     physicalLocation: {
                                         zone: v,
                                         shelf: product.physicalLocation?.shelf ?? "",

package/dist/features/products/components/ProductGrid.js

@@ -11,15 +11,14 @@ import { useLongPress } from "../../../react/hooks/useLongPress";
 import { FeatureBadgeList } from "./FeatureBadge";
 import { useProductFeatures } from "./ProductFeaturesContext";
 import { PRODUCT_FEATURE_CARD_MAX_VISIBLE } from "../constants/product-features.constants";
-import { isAuctionListing, isPreOrderListing } from "../utils/listing-type";
+import { normalizeListingType } from "../utils/listing-type";
+import { pluginFor } from "../../../_internal/shared/listing-types/_registry";
 const __P = {
     p3: "p-3",
 };
 const __O = {
     hidden: "overflow-hidden",
 };
-const CLS_BADGE_AUCTION = "bg-warning-surface text-white";
-const CLS_BADGE_PREORDER = "bg-violet-600 text-white";
 const CLS_BADGE_NEW = "rounded-full bg-error-surface px-2 py-0.5 text-[10px] text-white shadow-sm";
 const CLS_BADGE_SALE = "rounded-full bg-success-surface px-2 py-0.5 text-[10px] font-bold text-white shadow-sm";
 const CLS_BADGE_TRENDING = "rounded-full bg-indigo-600 px-2 py-0.5 text-[10px] font-bold text-white shadow-sm";
@@ -38,14 +37,10 @@ export function ProductCard({ product, href, onClick, onAddToWishlist, isWishlis
         ? Math.round(((product.originalPrice - product.price) / product.originalPrice) *
             100)
         : null;
-    // SB1-G — canonical accessors that handle the legacy boolean fallback.
-    const isAuction = isAuctionListing(product);
-    const isPreOrder = isPreOrderListing(product);
-    const typeBadge = isAuction
-        ? { label: "Auction", cls: CLS_BADGE_AUCTION }
-        : isPreOrder
-            ? { label: "Pre-Order", cls: CLS_BADGE_PREORDER }
-            : null;
+    const listingPlugin = pluginFor(normalizeListingType(product));
+    const typeBadge = listingPlugin.badge
+        ? { label: listingPlugin.badge.label, cls: listingPlugin.badge.className }
+        : null;
     const longPress = useLongPress(() => onSelect?.(product.id));
     const featuresList = useProductFeatures();
     const handleCardClick = selectionMode
@@ -97,7 +92,7 @@ export function ProductCard({ product, href, onClick, onAddToWishlist, isWishlis
                         return seller ? (_jsxs(Text, { className: "mt-0.5 text-[11px]", color: "faint", children: ["by ", seller] })) : null;
                     })(), product.rating !== undefined && (_jsxs(Row, { className: "mt-1", gap: "xs", children: [_jsx(Span, { className: CLS_STAR, children: "\u2605" }), _jsxs(Span, { className: "text-[11px]", color: "muted", children: [product.rating.toFixed(1), product.reviewCount ? ` (${product.reviewCount})` : ""] })] })), _jsxs(Div, { className: "mt-auto", padding: "t-xs", children: [_jsxs(Row, { align: "baseline", gap: "sm", children: [_jsx(Span, { size: "base", weight: "bold", className: "text-primary dark:text-primary-400", children: formatCurrency(product.price, getDefaultCurrency()) }), product.originalPrice && product.originalPrice > product.price && (_jsx(Span, { size: "xs", className: "line-through", color: "faint", children: formatCurrency(product.originalPrice, getDefaultCurrency()) }))] }), (() => {
                                 const stock = product.stockCount ?? product.stockQuantity ?? product.availableQuantity;
-                                if (stock === undefined || isAuction)
+                                if (stock === undefined || !listingPlugin.showsStockQuantity)
                                     return null;
                                 if (stock <= 0) {
                                     return (_jsx(Text, { className: CLS_DISCOUNT_TEXT, children: "Out of stock" }));

package/dist/features/products/components/ShowGroupSection.js

@@ -2,20 +2,18 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useEffect, useState } from "react";
 import Link from "next/link";
-import { ROUTES } from "../../../next";
 import { Div, Row, Span, Table, Thead, Tbody, Tr, Th, Td, Text, Modal, SideDrawer, Button } from "../../../ui";
 import { MediaImage } from "../../media/MediaImage";
 import { formatCurrency } from "../../../utils/number.formatter";
-import { isPreOrderListing } from "../utils/listing-type";
+import { normalizeListingType } from "../utils/listing-type";
+import { pluginFor } from "../../../_internal/shared/listing-types/_registry";
 const __O = {
     hidden: "overflow-hidden",
     xAuto: "overflow-x-auto",
 };
 function memberHref(m) {
     const slug = m.slug ?? m.id;
-    if (isPreOrderListing(m))
-        return String(ROUTES.PUBLIC.PRE_ORDER_DETAIL(slug));
-    return String(ROUTES.PUBLIC.PRODUCT_DETAIL(slug));
+    return pluginFor(normalizeListingType(m)).detailRoute(slug);
 }
 function MemberThumb({ member, isCurrent }) {
     const image = member.images?.[0] ?? "";

package/dist/features/products/components/SublistingCarouselSection.js

@@ -5,18 +5,15 @@ import Link from "next/link";
 import { ROUTES } from "../../../next";
 import { Div, Row, Span, Text } from "../../../ui";
 import { formatCurrency } from "../../../utils/number.formatter";
-import { isAuctionListing, isPreOrderListing } from "../utils/listing-type";
+import { normalizeListingType } from "../utils/listing-type";
+import { pluginFor } from "../../../_internal/shared/listing-types/_registry";
 const __O = {
     hidden: "overflow-hidden",
     xAuto: "overflow-x-auto",
 };
 function getHref(listing) {
     const slug = listing.slug ?? listing.id;
-    if (isAuctionListing(listing))
-        return String(ROUTES.PUBLIC.AUCTION_DETAIL(slug));
-    if (isPreOrderListing(listing))
-        return String(ROUTES.PUBLIC.PRE_ORDER_DETAIL(slug));
-    return String(ROUTES.PUBLIC.PRODUCT_DETAIL(slug));
+    return pluginFor(normalizeListingType(listing)).detailRoute(slug);
 }
 function ListingThumb({ listing, isCurrent, }) {
     const image = listing.images?.[0] ?? listing.mainImage ?? "";

package/dist/features/products/constants/listing-tabs.d.ts

@@ -52,6 +52,14 @@ export declare const CATEGORY_PAGE_TABS: readonly [{
     readonly id: "live";
     readonly label: "Live Items";
     readonly listingType: "live";
+}, {
+    readonly id: "art";
+    readonly label: "Art";
+    readonly listingType: "art";
+}, {
+    readonly id: "stickers";
+    readonly label: "Stickers";
+    readonly listingType: "stickers";
 }, {
     readonly id: "stores";
     readonly label: "Stores";
@@ -91,6 +99,14 @@ export declare const STORE_PAGE_TABS: readonly [{
     readonly id: "live";
     readonly label: "Live Items";
     readonly listingType: "live";
+}, {
+    readonly id: "art";
+    readonly label: "Art";
+    readonly listingType: "art";
+}, {
+    readonly id: "stickers";
+    readonly label: "Stickers";
+    readonly listingType: "stickers";
 }];
 export type StoreTabId = (typeof STORE_PAGE_TABS)[number]["id"];
 /** Tabs shown on the seller-dashboard listings view + admin products list. */
@@ -125,6 +141,14 @@ export declare const SELLER_LISTING_TABS: readonly [{
     readonly id: "live";
     readonly label: "Live Items";
     readonly listingType: "live";
+}, {
+    readonly id: "art";
+    readonly label: "Art";
+    readonly listingType: "art";
+}, {
+    readonly id: "stickers";
+    readonly label: "Stickers";
+    readonly listingType: "stickers";
 }];
 export type SellerListingTabId = (typeof SELLER_LISTING_TABS)[number]["id"];
 /** Tabs shown on `/search` results. */
@@ -163,5 +187,13 @@ export declare const SEARCH_RESULT_TABS: readonly [{
     readonly id: "live";
     readonly label: "Live Items";
     readonly listingType: "live";
+}, {
+    readonly id: "art";
+    readonly label: "Art";
+    readonly listingType: "art";
+}, {
+    readonly id: "stickers";
+    readonly label: "Stickers";
+    readonly listingType: "stickers";
 }];
 export type SearchTabId = (typeof SEARCH_RESULT_TABS)[number]["id"];

package/dist/features/products/constants/listing-tabs.js

@@ -18,6 +18,8 @@ export const CATEGORY_PAGE_TABS = [
     { id: "classifieds", label: "Classifieds", listingType: "classified" },
     { id: "digital-codes", label: "Digital Codes", listingType: "digital-code" },
     { id: "live", label: "Live Items", listingType: "live" },
+    { id: "art", label: "Art", listingType: "art" },
+    { id: "stickers", label: "Stickers", listingType: "stickers" },
     { id: "stores", label: "Stores", entity: "stores" },
 ];
 /** Tabs shown on the public `/stores/[slug]` nav bar. */
@@ -30,6 +32,8 @@ export const STORE_PAGE_TABS = [
     { id: "classifieds", label: "Classifieds", listingType: "classified" },
     { id: "digital-codes", label: "Digital Codes", listingType: "digital-code" },
     { id: "live", label: "Live Items", listingType: "live" },
+    { id: "art", label: "Art", listingType: "art" },
+    { id: "stickers", label: "Stickers", listingType: "stickers" },
 ];
 /** Tabs shown on the seller-dashboard listings view + admin products list. */
 export const SELLER_LISTING_TABS = [
@@ -41,6 +45,8 @@ export const SELLER_LISTING_TABS = [
     { id: "classifieds", label: "Classifieds", listingType: "classified" },
     { id: "digital-codes", label: "Digital Codes", listingType: "digital-code" },
     { id: "live", label: "Live Items", listingType: "live" },
+    { id: "art", label: "Art", listingType: "art" },
+    { id: "stickers", label: "Stickers", listingType: "stickers" },
 ];
 /** Tabs shown on `/search` results. */
 export const SEARCH_RESULT_TABS = [
@@ -53,4 +59,6 @@ export const SEARCH_RESULT_TABS = [
     { id: "classifieds", label: "Classifieds", listingType: "classified" },
     { id: "digital-codes", label: "Digital Codes", listingType: "digital-code" },
     { id: "live", label: "Live Items", listingType: "live" },
+    { id: "art", label: "Art", listingType: "art" },
+    { id: "stickers", label: "Stickers", listingType: "stickers" },
 ];

package/dist/features/products/index.d.ts

@@ -9,5 +9,5 @@ export * from "./components";
 export * from "./schemas";
 export * from "./columns";
 export { manifest } from "./manifest";
-export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, isPrizeDrawListing, isClassifiedListing, isDigitalCodeListing, isLiveListing, } from "./utils/listing-type";
+export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, isPrizeDrawListing, isClassifiedListing, isDigitalCodeListing, isLiveListing, isArtListing, isStickersListing, } from "./utils/listing-type";
 export { sanitizeProductForPublic, sanitizeProductsForPublic, } from "./utils/sanitize";

package/dist/features/products/index.js

@@ -11,5 +11,7 @@ export * from "./columns";
 export { manifest } from "./manifest";
 export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, isPrizeDrawListing, 
 // SB-UNI-F 2026-05-13 — Phase 2 predicates.
-isClassifiedListing, isDigitalCodeListing, isLiveListing, } from "./utils/listing-type";
+isClassifiedListing, isDigitalCodeListing, isLiveListing, 
+// Art/stickers session.
+isArtListing, isStickersListing, } from "./utils/listing-type";
 export { sanitizeProductForPublic, sanitizeProductsForPublic, } from "./utils/sanitize";

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

@@ -105,6 +105,21 @@ export interface ProductLiveItemMeta {
     /** CITES permit number (Appendix I/II species). */
     cites?: string;
 }
+/**
+ * Print-specific metadata shared by the "art" and "stickers" listing types
+ * (both are printed-only physical goods). Every field optional so partial
+ * seller input still saves.
+ */
+export interface ProductPrintMeta {
+    /** e.g. "A4", "12x18 in", "5x5 cm sheet". */
+    size?: string;
+    /** e.g. "Matte photo paper", "Vinyl", "Canvas". */
+    material?: string;
+    /** e.g. "Glossy", "Matte", "Holographic". */
+    finish?: string;
+    /** Limited-edition print run size; omitted for open editions. */
+    editionSize?: number;
+}
 export interface ProductDocument extends BaseDocument {
     title: string;
     description: string;
@@ -178,6 +193,10 @@ export interface ProductDocument extends BaseDocument {
     isPromoted?: boolean;
     isOnSale?: boolean;
     isSold?: boolean;
+    /** When true, an EMI order for this product ships as soon as it's confirmed instead of waiting for every installment to be paid. Default false. */
+    allowShipBeforeEmiComplete?: boolean;
+    /** Print-specific metadata for "art" / "stickers" listings — printed-only physical goods. Optional on every listing type; only populated for art/stickers. */
+    printMeta?: ProductPrintMeta;
     promotionEndDate?: Date;
     pickupAddressId?: string;
     viewCount?: number;
@@ -313,7 +332,7 @@ export declare const PRODUCT_COLLECTION: "products";
 export declare const PRODUCT_INDEXED_FIELDS: readonly ["storeId", "status", "category", "featured", "listingType", "isPromoted", "isOnSale", "isSold", "searchTokens", "createdAt", "barcodeId"];
 export declare const DEFAULT_PRODUCT_DATA: Partial<ProductDocument>;
 export declare const PRODUCT_PUBLIC_FIELDS: readonly ["id", "title", "description", "category", "subcategory", "brand", "price", "currency", "stockQuantity", "availableQuantity", "images", "status", "storeName", "featured", "tags", "specifications", "features", "shippingInfo", "returnPolicy", "listingType", "auctionEndDate", "startingBid", "currentBid", "bidCount", "reservePrice", "buyNowPrice", "minBidIncrement", "autoExtendable", "auctionExtensionMinutes", "auctionShippingPaidBy", "buyItNowPriceInPaise", "bidsHaveStarted", "grading", "card", "classified", "digitalCode", "liveItem", "catalogProductId", "preOrderDeliveryDate", "preOrderDepositPercent", "preOrderDepositAmount", "preOrderMaxQuantity", "preOrderCurrentCount", "preOrderProductionStatus", "preOrderCancellable", "condition", "insurance", "insuranceCost", "shippingPaidBy", "isPromoted", "isOnSale", "isSold", "slug", "seoTitle", "seoDescription", "seoKeywords", "viewCount", "customFields", "customSections", "sublistingCategoryId", "groupId", "isGroupParent", "groupParentSlug", "groupChildSlugs", "groupTitle", "createdAt"];
-export declare const PRODUCT_UPDATABLE_FIELDS: readonly ["title", "description", "category", "subcategory", "brand", "price", "stockQuantity", "images", "status", "tags", "specifications", "features", "shippingInfo", "returnPolicy", "pickupAddressId", "condition", "insurance", "shippingPaidBy", "autoExtendable", "auctionExtensionMinutes", "auctionShippingPaidBy", "reservePrice", "buyNowPrice", "minBidIncrement", "buyItNowPriceInPaise", "bidsHaveStarted", "grading", "card", "classified", "digitalCode", "liveItem", "catalogProductId", "listingType", "preOrderDeliveryDate", "preOrderDepositPercent", "preOrderDepositAmount", "preOrderMaxQuantity", "preOrderProductionStatus", "preOrderCancellable", "isOnSale", "isSold", "seoTitle", "seoDescription", "seoKeywords", "customFields", "customSections", "sublistingCategoryId", "groupId", "isGroupParent", "groupParentSlug", "groupChildSlugs", "groupTitle", "barcodeId"];
+export declare const PRODUCT_UPDATABLE_FIELDS: readonly ["title", "description", "category", "subcategory", "brand", "price", "stockQuantity", "images", "status", "tags", "specifications", "features", "shippingInfo", "returnPolicy", "pickupAddressId", "condition", "insurance", "shippingPaidBy", "autoExtendable", "auctionExtensionMinutes", "auctionShippingPaidBy", "reservePrice", "buyNowPrice", "minBidIncrement", "buyItNowPriceInPaise", "bidsHaveStarted", "grading", "card", "classified", "digitalCode", "liveItem", "catalogProductId", "listingType", "preOrderDeliveryDate", "preOrderDepositPercent", "preOrderDepositAmount", "preOrderMaxQuantity", "preOrderProductionStatus", "preOrderCancellable", "isOnSale", "isSold", "allowShipBeforeEmiComplete", "printMeta", "seoTitle", "seoDescription", "seoKeywords", "customFields", "customSections", "sublistingCategoryId", "groupId", "isGroupParent", "groupParentSlug", "groupChildSlugs", "groupTitle", "barcodeId"];
 export type ProductCreateInput = Omit<ProductDocument, "id" | "createdAt" | "updatedAt" | "availableQuantity" | "bidCount" | "currentBid" | "auctionOriginalEndDate">;
 export type ProductUpdateInput = Partial<Pick<ProductDocument, (typeof PRODUCT_UPDATABLE_FIELDS)[number]>>;
 export type ProductAdminUpdateInput = Partial<Omit<ProductDocument, "id" | "createdAt">>;

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

@@ -163,6 +163,8 @@ export const PRODUCT_UPDATABLE_FIELDS = [
     "preOrderCancellable",
     "isOnSale",
     "isSold",
+    "allowShipBeforeEmiComplete",
+    "printMeta",
     "seoTitle",
     "seoDescription",
     "seoKeywords",

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

@@ -29,6 +29,23 @@ export declare const productSeoSchema: z.ZodObject<{
     description?: string | undefined;
     keywords?: string[] | undefined;
 }>;
+/** Print-specific metadata for "art" / "stickers" listings. */
+export declare const printMetaSchema: z.ZodObject<{
+    size: z.ZodOptional<z.ZodString>;
+    material: z.ZodOptional<z.ZodString>;
+    finish: z.ZodOptional<z.ZodString>;
+    editionSize: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    size?: string | undefined;
+    material?: string | undefined;
+    finish?: string | undefined;
+    editionSize?: number | undefined;
+}, {
+    size?: string | undefined;
+    material?: string | undefined;
+    finish?: string | undefined;
+    editionSize?: number | undefined;
+}>;
 /**
  * Base Zod schema for a product item.
  * Apps can extend this to add their own fields:
@@ -86,6 +103,23 @@ export declare const productItemSchema: z.ZodObject<{
     }>>;
     featured: z.ZodOptional<z.ZodBoolean>;
     isPromoted: z.ZodOptional<z.ZodBoolean>;
+    allowShipBeforeEmiComplete: z.ZodOptional<z.ZodBoolean>;
+    printMeta: z.ZodOptional<z.ZodObject<{
+        size: z.ZodOptional<z.ZodString>;
+        material: z.ZodOptional<z.ZodString>;
+        finish: z.ZodOptional<z.ZodString>;
+        editionSize: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        size?: string | undefined;
+        material?: string | undefined;
+        finish?: string | undefined;
+        editionSize?: number | undefined;
+    }, {
+        size?: string | undefined;
+        material?: string | undefined;
+        finish?: string | undefined;
+        editionSize?: number | undefined;
+    }>>;
     currentBid: z.ZodOptional<z.ZodNumber>;
     availableQuantity: z.ZodOptional<z.ZodNumber>;
     category: z.ZodOptional<z.ZodString>;
@@ -337,6 +371,13 @@ export declare const productItemSchema: z.ZodObject<{
     preOrderCurrentCount?: number | undefined;
     preOrderProductionStatus?: "upcoming" | "in_production" | "ready_to_ship" | undefined;
     preOrderCancellable?: boolean | undefined;
+    allowShipBeforeEmiComplete?: boolean | undefined;
+    printMeta?: {
+        size?: string | undefined;
+        material?: string | undefined;
+        finish?: string | undefined;
+        editionSize?: number | undefined;
+    } | undefined;
     pickupAddressId?: string | undefined;
     viewCount?: number | undefined;
     avgRating?: number | undefined;
@@ -466,6 +507,13 @@ export declare const productItemSchema: z.ZodObject<{
     preOrderCurrentCount?: number | undefined;
     preOrderProductionStatus?: "upcoming" | "in_production" | "ready_to_ship" | undefined;
     preOrderCancellable?: boolean | undefined;
+    allowShipBeforeEmiComplete?: boolean | undefined;
+    printMeta?: {
+        size?: string | undefined;
+        material?: string | undefined;
+        finish?: string | undefined;
+        editionSize?: number | undefined;
+    } | undefined;
     pickupAddressId?: string | undefined;
     viewCount?: number | undefined;
     avgRating?: number | undefined;

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

@@ -13,6 +13,13 @@ export const productSeoSchema = z.object({
     description: z.string().optional(),
     keywords: z.array(z.string()).optional(),
 });
+/** Print-specific metadata for "art" / "stickers" listings. */
+export const printMetaSchema = z.object({
+    size: z.string().max(80).optional(),
+    material: z.string().max(80).optional(),
+    finish: z.string().max(80).optional(),
+    editionSize: z.number().int().positive().optional(),
+});
 // --- Base item schema ---------------------------------------------------------
 /**
  * Base Zod schema for a product item.
@@ -43,6 +50,8 @@ export const productItemSchema = z.object({
         .optional(),
     featured: z.boolean().optional(),
     isPromoted: z.boolean().optional(),
+    allowShipBeforeEmiComplete: z.boolean().optional(),
+    printMeta: printMetaSchema.optional(),
     currentBid: z.number().optional(),
     availableQuantity: z.number().optional(),
     category: z.string().optional(),

package/dist/features/products/schemas/product-features.d.ts

@@ -20,7 +20,7 @@ export declare const MAX_STORE_CUSTOM_FEATURES = 20;
 export declare const MAX_FEATURES_PER_PRODUCT = 10;
 export type ProductFeatureScope = "platform" | "store";
 export type ProductFeatureCategory = "shipping" | "seller" | "condition" | "platform" | "auction" | "preorder" | "custom";
-export type ProductFeatureProductType = "product" | "auction" | "preorder" | "prize-draw" | "classified" | "digital-code" | "live" | "all";
+export type ProductFeatureProductType = "product" | "auction" | "preorder" | "prize-draw" | "classified" | "digital-code" | "live" | "art" | "stickers" | "all";
 /**
  * Either an appkit icon-set name key (e.g. "truck") or a raw SVG path-d string.
  * Path strings must start with "M " — see isFeatureIconPath().

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

@@ -1,6 +1,6 @@
 import type { MediaField } from "../../media/types/index";
-import type { CustomField, CustomSection } from "../schemas/firestore";
-export type { CustomField, CustomSection } from "../schemas/firestore";
+import type { CustomField, CustomSection, ProductPrintMeta } from "../schemas/firestore";
+export type { CustomField, CustomSection, ProductPrintMeta } from "../schemas/firestore";
 export type ProductStatus = "draft" | "published" | "in_review" | "archived";
 export type ProductCondition = "new" | "like_new" | "good" | "fair" | "poor" | "used" | "refurbished" | "broken" | "graded";
 /**
@@ -10,7 +10,7 @@ export type ProductCondition = "new" | "like_new" | "good" | "fair" | "poor" | "
  * accepts legacy alias tokens (`preorder` → `pre-order`, `product` → `standard`)
  * but stored values are always one of these five.
  */
-export type ListingType = "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
+export type ListingType = "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live" | "art" | "stickers";
 export interface ProductImage {
     url: string;
     thumbnailUrl?: string;
@@ -39,6 +39,8 @@ export interface ProductItem {
     };
     featured?: boolean;
     isPromoted?: boolean;
+    allowShipBeforeEmiComplete?: boolean;
+    printMeta?: ProductPrintMeta;
     currentBid?: number;
     availableQuantity?: number;
     /** @deprecated Use categorySlugs[0] */

package/dist/features/products/utils/listing-type.d.ts

@@ -33,3 +33,9 @@ export declare const isDigitalCodeListing: (input?: {
 export declare const isLiveListing: (input?: {
     listingType?: ListingType;
 }) => boolean;
+export declare const isArtListing: (input?: {
+    listingType?: ListingType;
+}) => boolean;
+export declare const isStickersListing: (input?: {
+    listingType?: ListingType;
+}) => boolean;

package/dist/features/products/utils/listing-type.js

@@ -19,6 +19,9 @@ export const isPrizeDrawListing = (input) => normalizeListingType(input) === "pr
 export const isClassifiedListing = (input) => normalizeListingType(input) === "classified";
 export const isDigitalCodeListing = (input) => normalizeListingType(input) === "digital-code";
 export const isLiveListing = (input) => normalizeListingType(input) === "live";
+// Art/stickers session — printed-only physical-goods listing types.
+export const isArtListing = (input) => normalizeListingType(input) === "art";
+export const isStickersListing = (input) => normalizeListingType(input) === "stickers";
 // SB-UNI-D — isBundleListing removed. Bundles are now a categoryType
 // discriminator on CategoryDocument; consumers should query
 // `categoriesRepository.findBySlugAndType(slug, "bundle")` instead.

package/dist/features/reviews/api/[id]/route.js

@@ -13,6 +13,7 @@ import { z } from "zod";
 import { getProviders } from "../../../../contracts";
 import { createRouteHandler } from "../../../../next";
 import { normalizeError } from "../../../../errors/normalize";
+import { isAdminUser, isModeratorUser } from "../../../auth/role-predicates";
 const ERR_REVIEW_NOT_FOUND = "Review not found";
 // ---- GET /api/reviews/[id] ---------------------------------------------------
 export async function GET(_request, context) {
@@ -70,8 +71,8 @@ export const reviewItemPATCH = createRouteHandler({
         if (!review)
             return NextResponse.json({ success: false, error: ERR_REVIEW_NOT_FOUND }, { status: 404 });
         const isOwner = review.userId === user.uid;
-        const isModerator = user.role === "moderator";
-        const isAdmin = user.role === "admin";
+        const isModerator = isModeratorUser(user);
+        const isAdmin = isAdminUser(user);
         if (!isOwner && !isModerator && !isAdmin) {
             return NextResponse.json({ success: false, error: "Forbidden" }, { status: 403 });
         }
@@ -101,8 +102,8 @@ export const reviewItemDELETE = createRouteHandler({
         if (!review)
             return NextResponse.json({ success: false, error: ERR_REVIEW_NOT_FOUND }, { status: 404 });
         const isOwner = review.userId === user.uid;
-        const isModerator = user.role === "moderator";
-        const isAdmin = user.role === "admin";
+        const isModerator = isModeratorUser(user);
+        const isAdmin = isAdminUser(user);
         if (!isOwner && !isModerator && !isAdmin) {
             return NextResponse.json({ success: false, error: "Forbidden" }, { status: 403 });
         }

package/dist/features/seller/actions/seller-actions.d.ts

@@ -5,13 +5,11 @@
  * explicit params. Called by letitrip thin wrappers that handle auth,
  * rate-limiting, and user-facing validation.
  *
- * Note: Shiprocket-specific actions (updateSellerShipping,
- * verifyShiprocketPickupOtp, shiprocketShipOrder) remain in the letitrip
- * thin wrapper because they use the @/lib/shiprocket/client SDK which is
- * a permanent letitrip-only dependency.
+ * Note: updateSellerShipping remains in the letitrip thin wrapper
+ * (src/actions/seller.actions.ts) alongside the other seller server actions.
  */
 import type { JsonValue } from "../../../schemas/types";
-import type { SellerPayoutDetails } from "../../auth/schemas/firestore";
+import type { SellerPayoutDetails, SellerShippingConfig } from "../../auth/schemas/firestore";
 import type { StoreDocument } from "../../stores/schemas/firestore";
 import type { ProductDocument } from "../../products/schemas/firestore";
 import type { OrderDocument } from "../../orders/schemas/firestore";
@@ -86,6 +84,14 @@ export interface CustomShipOrderInput {
     trackingNumber: string;
     trackingUrl: string;
 }
+export interface MarkEmiInstallmentPaidInput {
+    /** 1-based installment number, matches EmiInstallment.index. */
+    installmentIndex: number;
+    /** Buyer-supplied UTR/reference number for this installment's manual payment. */
+    transactionId?: string;
+    /** Signed-URL media slug for the buyer's payment proof for this installment. */
+    proofUrl?: string;
+}
 export interface SellerListParams {
     filters?: string;
     sorts?: string;
@@ -109,15 +115,7 @@ export declare function requestPayout(userId: string, userName: string, userEmai
 export declare function bulkSellerOrder(userId: string, userRole: string, userDisplayName: string, userEmail: string, orderIds: string[]): Promise<BulkSellerOrderResult>;
 export declare function createSellerProduct(userId: string, userName: string, userEmail: string, input: Record<string, JsonValue>): Promise<void>;
 export declare function getSellerStore(userId: string): Promise<StoreDocument | null>;
-export declare function getSellerShipping(userId: string): Promise<{
-    method: import("../../auth").SellerShippingMethod;
-    customShippingPrice?: number;
-    customCarrierName?: string;
-    shiprocketEmail?: string;
-    shiprocketTokenExpiry?: Date;
-    pickupAddress?: import("../../auth").SellerPickupAddress;
-    isConfigured: boolean;
-} | null>;
+export declare function getSellerShipping(userId: string): Promise<SellerShippingConfig | null>;
 export declare function getSellerPayoutSettings(userId: string): Promise<SellerPayoutDetails | {
     method: string;
     isConfigured: boolean;
@@ -166,8 +164,25 @@ export declare function listSellerMyProducts(userId: string, params?: SellerList
 }>;
 export declare function sellerUpdateProduct(userId: string, userRole: string, productId: string, input: Record<string, JsonValue>): Promise<ProductDocument>;
 export declare function sellerDeleteProduct(userId: string, userRole: string, productId: string): Promise<void>;
+/**
+ * EMI orders stay unshipped until every installment is paid, UNLESS every
+ * product in the order has its `allowShipBeforeEmiComplete` flag set. This
+ * is the single choke point for the "ship" transition, so it can't be
+ * bypassed by a different route/action reaching `orderRepository.update`
+ * directly with `status: "shipped"`.
+ */
+export declare function assertEmiShippable(order: OrderDocument): Promise<void>;
 export declare function customShipOrder(userId: string, userRole: string, orderId: string, input: CustomShipOrderInput): Promise<{
     orderId: string;
     method: string;
 }>;
+/**
+ * Records collection of one EMI installment. Seller/admin marks the
+ * installment paid after verifying the buyer's manual transfer (UTR +
+ * proof). Recomputes `emiRemainingBalance` from the still-pending
+ * installments and flips `emiComplete` once none remain — that flag is the
+ * single gate `assertEmiShippable` reads, so this is the only place an
+ * EMI order can become shippable.
+ */
+export declare function markEmiInstallmentPaid(userId: string, userRole: string, orderId: string, input: MarkEmiInstallmentPaidInput): Promise<OrderDocument>;
 export {};