@mohasinac/appkit 3.0.4 → 3.0.6

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

@@ -45,8 +45,8 @@ export declare const preorderItemSchema: z.ZodObject<{
     active: z.ZodDefault<z.ZodBoolean>;
     createdAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    id: string;
     slug: string;
+    id: string;
     name: string;
     active: boolean;
     isFeatured: boolean;
@@ -66,8 +66,8 @@ export declare const preorderItemSchema: z.ZodObject<{
     franchise?: string | undefined;
     preorderShipDate?: string | undefined;
 }, {
-    id: string;
     slug: string;
+    id: string;
     name: string;
     salePrice: number;
     regularPrice: number;

package/dist/features/products/constants/action-defs.d.ts

@@ -96,16 +96,32 @@ export declare const DETAIL_ACTIONS: {
     readonly auction: readonly ["place-bid", "buy-now-auction", "watch-auction", "share"];
     /** Pre-order: reserve, wishlist, share */
     readonly preorder: readonly ["reserve-now", "add-to-wishlist", "share"];
+    /** Prize draw: enter, wishlist, share */
+    readonly "prize-draw": readonly ["enter-prize-draw", "add-to-wishlist", "share"];
+    /** Classified: offer, share */
+    readonly classified: readonly ["make-offer", "share"];
+    /** Digital code: buy now, share */
+    readonly "digital-code": readonly ["buy-now", "share"];
+    /** Live item: buy now, wishlist, share */
+    readonly live: readonly ["buy-now", "add-to-wishlist", "share"];
 };
 export declare const MOBILE_PRIMARY_ACTIONS: {
     readonly product: readonly ["buy-now", "add-to-cart"];
     readonly auction: readonly ["place-bid", "buy-now-auction"];
     readonly preorder: readonly ["reserve-now"];
+    readonly "prize-draw": readonly ["enter-prize-draw"];
+    readonly classified: readonly ["make-offer"];
+    readonly "digital-code": readonly ["buy-now"];
+    readonly live: readonly ["buy-now"];
 };
 export declare const LISTING_BULK_ACTIONS: {
     readonly products: readonly ["add-to-cart", "add-to-wishlist", "compare"];
     readonly auctions: readonly ["watch-auction", "unwatch-auction", "compare"];
     readonly preorders: readonly ["add-to-cart", "add-to-wishlist", "compare"];
+    readonly prizeDraws: readonly ActionId[];
+    readonly classifieds: readonly ActionId[];
+    readonly digitalCodes: readonly ActionId[];
+    readonly live: readonly ActionId[];
     readonly stores: ActionId[];
 };
 /** Maximum number of items the Compare overlay (BK3) supports at once. */

package/dist/features/products/constants/action-defs.js

@@ -137,18 +137,34 @@ export const DETAIL_ACTIONS = {
     auction: [ACTION_ID.PLACE_BID, ACTION_ID.BUY_NOW_AUCTION, ACTION_ID.WATCH_AUCTION, ACTION_ID.SHARE],
     /** Pre-order: reserve, wishlist, share */
     preorder: [ACTION_ID.RESERVE_NOW, ACTION_ID.ADD_TO_WISHLIST, ACTION_ID.SHARE],
+    /** Prize draw: enter, wishlist, share */
+    "prize-draw": [ACTION_ID.ENTER_PRIZE_DRAW, ACTION_ID.ADD_TO_WISHLIST, ACTION_ID.SHARE],
+    /** Classified: offer, share */
+    classified: [ACTION_ID.MAKE_OFFER, ACTION_ID.SHARE],
+    /** Digital code: buy now, share */
+    "digital-code": [ACTION_ID.BUY_NOW, ACTION_ID.SHARE],
+    /** Live item: buy now, wishlist, share */
+    live: [ACTION_ID.BUY_NOW, ACTION_ID.ADD_TO_WISHLIST, ACTION_ID.SHARE],
 };
 // Mobile bottom bar — 1–2 primary CTAs only (limited horizontal space)
 export const MOBILE_PRIMARY_ACTIONS = {
     product: [ACTION_ID.BUY_NOW, ACTION_ID.ADD_TO_CART],
     auction: [ACTION_ID.PLACE_BID, ACTION_ID.BUY_NOW_AUCTION],
     preorder: [ACTION_ID.RESERVE_NOW],
+    "prize-draw": [ACTION_ID.ENTER_PRIZE_DRAW],
+    classified: [ACTION_ID.MAKE_OFFER],
+    "digital-code": [ACTION_ID.BUY_NOW],
+    live: [ACTION_ID.BUY_NOW],
 };
 // Listing page bulk actions — shown in the bottom action bar when items are selected
 export const LISTING_BULK_ACTIONS = {
     products: [ACTION_ID.ADD_TO_CART, ACTION_ID.ADD_TO_WISHLIST, ACTION_ID.COMPARE],
     auctions: [ACTION_ID.WATCH_AUCTION, ACTION_ID.UNWATCH_AUCTION, ACTION_ID.COMPARE],
     preorders: [ACTION_ID.ADD_TO_CART, ACTION_ID.ADD_TO_WISHLIST, ACTION_ID.COMPARE],
+    prizeDraws: [ACTION_ID.ADD_TO_WISHLIST, ACTION_ID.COMPARE],
+    classifieds: [ACTION_ID.ADD_TO_WISHLIST, ACTION_ID.COMPARE],
+    digitalCodes: [ACTION_ID.ADD_TO_WISHLIST, ACTION_ID.COMPARE],
+    live: [ACTION_ID.ADD_TO_WISHLIST, ACTION_ID.COMPARE],
     stores: [ACTION_ID.COMPARE],
 };
 /** Maximum number of items the Compare overlay (BK3) supports at once. */

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

@@ -40,6 +40,18 @@ export declare const CATEGORY_PAGE_TABS: readonly [{
     readonly id: "bundles";
     readonly label: "Bundles";
     readonly collection: "bundles";
+}, {
+    readonly id: "classifieds";
+    readonly label: "Classifieds";
+    readonly listingType: "classified";
+}, {
+    readonly id: "digital-codes";
+    readonly label: "Digital Codes";
+    readonly listingType: "digital-code";
+}, {
+    readonly id: "live";
+    readonly label: "Live Items";
+    readonly listingType: "live";
 }, {
     readonly id: "stores";
     readonly label: "Stores";
@@ -67,6 +79,18 @@ export declare const STORE_PAGE_TABS: readonly [{
     readonly id: "bundles";
     readonly label: "Bundles";
     readonly collection: "bundles";
+}, {
+    readonly id: "classifieds";
+    readonly label: "Classifieds";
+    readonly listingType: "classified";
+}, {
+    readonly id: "digital-codes";
+    readonly label: "Digital Codes";
+    readonly listingType: "digital-code";
+}, {
+    readonly id: "live";
+    readonly label: "Live Items";
+    readonly listingType: "live";
 }];
 export type StoreTabId = (typeof STORE_PAGE_TABS)[number]["id"];
 /** Tabs shown on the seller-dashboard listings view + admin products list. */
@@ -89,6 +113,18 @@ export declare const SELLER_LISTING_TABS: readonly [{
     readonly id: "prize-draws";
     readonly label: "Prize Draws";
     readonly listingType: "prize-draw";
+}, {
+    readonly id: "classifieds";
+    readonly label: "Classifieds";
+    readonly listingType: "classified";
+}, {
+    readonly id: "digital-codes";
+    readonly label: "Digital Codes";
+    readonly listingType: "digital-code";
+}, {
+    readonly id: "live";
+    readonly label: "Live Items";
+    readonly listingType: "live";
 }];
 export type SellerListingTabId = (typeof SELLER_LISTING_TABS)[number]["id"];
 /** Tabs shown on `/search` results. */
@@ -115,5 +151,17 @@ export declare const SEARCH_RESULT_TABS: readonly [{
     readonly id: "bundles";
     readonly label: "Bundles";
     readonly collection: "bundles";
+}, {
+    readonly id: "classifieds";
+    readonly label: "Classifieds";
+    readonly listingType: "classified";
+}, {
+    readonly id: "digital-codes";
+    readonly label: "Digital Codes";
+    readonly listingType: "digital-code";
+}, {
+    readonly id: "live";
+    readonly label: "Live Items";
+    readonly listingType: "live";
 }];
 export type SearchTabId = (typeof SEARCH_RESULT_TABS)[number]["id"];

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

@@ -15,6 +15,9 @@ export const CATEGORY_PAGE_TABS = [
     { id: "pre-orders", label: "Pre-Orders", listingType: "pre-order" },
     { id: "prize-draws", label: "Prize Draws", listingType: "prize-draw" },
     { id: "bundles", label: "Bundles", collection: "bundles" },
+    { id: "classifieds", label: "Classifieds", listingType: "classified" },
+    { id: "digital-codes", label: "Digital Codes", listingType: "digital-code" },
+    { id: "live", label: "Live Items", listingType: "live" },
     { id: "stores", label: "Stores", entity: "stores" },
 ];
 /** Tabs shown on the public `/stores/[slug]` nav bar. */
@@ -24,6 +27,9 @@ export const STORE_PAGE_TABS = [
     { id: "pre-orders", label: "Pre-Orders", listingType: "pre-order" },
     { id: "prize-draws", label: "Prize Draws", listingType: "prize-draw" },
     { id: "bundles", label: "Bundles", collection: "bundles" },
+    { id: "classifieds", label: "Classifieds", listingType: "classified" },
+    { id: "digital-codes", label: "Digital Codes", listingType: "digital-code" },
+    { id: "live", label: "Live Items", listingType: "live" },
 ];
 /** Tabs shown on the seller-dashboard listings view + admin products list. */
 export const SELLER_LISTING_TABS = [
@@ -32,6 +38,9 @@ export const SELLER_LISTING_TABS = [
     { id: "auctions", label: "Auctions", listingType: "auction" },
     { id: "pre-orders", label: "Pre-Orders", listingType: "pre-order" },
     { id: "prize-draws", label: "Prize Draws", listingType: "prize-draw" },
+    { id: "classifieds", label: "Classifieds", listingType: "classified" },
+    { id: "digital-codes", label: "Digital Codes", listingType: "digital-code" },
+    { id: "live", label: "Live Items", listingType: "live" },
 ];
 /** Tabs shown on `/search` results. */
 export const SEARCH_RESULT_TABS = [
@@ -41,4 +50,7 @@ export const SEARCH_RESULT_TABS = [
     { id: "pre-orders", label: "Pre-Orders", listingType: "pre-order" },
     { id: "prize-draws", label: "Prize Draws", listingType: "prize-draw" },
     { id: "bundles", label: "Bundles", collection: "bundles" },
+    { id: "classifieds", label: "Classifieds", listingType: "classified" },
+    { id: "digital-codes", label: "Digital Codes", listingType: "digital-code" },
+    { id: "live", label: "Live Items", listingType: "live" },
 ];

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

@@ -18,6 +18,7 @@ export declare class ProductRepository extends BaseRepository<ProductDocument> {
     findByStatus(status: ProductStatus): Promise<ProductDocument[]>;
     findFeatured(): Promise<ProductDocument[]>;
     findByCategory(category: string): Promise<ProductDocument[]>;
+    findByBarcodeId(barcodeId: string): Promise<ProductDocument | null>;
     findBySlug(slug: string): Promise<ProductDocument | undefined>;
     findByIdOrSlug(idOrSlug: string): Promise<ProductDocument | undefined>;
     /**
@@ -206,6 +207,42 @@ export declare class ProductRepository extends BaseRepository<ProductDocument> {
             canFilter: boolean;
             canSort: boolean;
         };
+        "classified.meetupArea": {
+            canFilter: boolean;
+            canSort: boolean;
+        };
+        "classified.acceptsShipping": {
+            canFilter: boolean;
+            canSort: boolean;
+        };
+        "classified.negotiable": {
+            canFilter: boolean;
+            canSort: boolean;
+        };
+        "digitalCode.codeDeliveryMethod": {
+            canFilter: boolean;
+            canSort: boolean;
+        };
+        "digitalCode.codesAvailable": {
+            canFilter: boolean;
+            canSort: boolean;
+        };
+        "liveItem.species": {
+            canFilter: boolean;
+            canSort: boolean;
+        };
+        "liveItem.sex": {
+            canFilter: boolean;
+            canSort: boolean;
+        };
+        "liveItem.jurisdictionAllowed": {
+            canFilter: boolean;
+            canSort: boolean;
+        };
+        "liveItem.cites": {
+            canFilter: boolean;
+            canSort: boolean;
+        };
     };
     /**
      * Virtual filter aliases — callers can pass `f=listingType==auction` for

package/dist/features/products/repository/products.repository.js

@@ -3,7 +3,7 @@ import { increment, serverTimestamp } from "../../../contracts/field-ops";
 import { DatabaseError } from "../../../errors";
 import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
 import { cacheManager } from "../../../core";
-import { generateUniqueId, slugify, buildSearchTokens, tokenizeQuery } from "../../../utils";
+import { generateUniqueId, slugify, buildSearchTokens, tokenizeQuery, generateBarcodeId } from "../../../utils";
 import { PRODUCT_COLLECTION, ProductStatusValues, } from "../schemas";
 import { PRODUCT_FIELDS } from "../../../constants/field-names";
 /**
@@ -20,11 +20,17 @@ const SIEVE_CLAUSE_LT_AUCTION = `${PRODUCT_FIELDS.LISTING_TYPE}==${LISTING_TYPE_
 const SIEVE_CLAUSE_LT_PREORDER = `${PRODUCT_FIELDS.LISTING_TYPE}==${LISTING_TYPE_VALUES.PRE_ORDER}`;
 const SIEVE_CLAUSE_LT_STANDARD = `${PRODUCT_FIELDS.LISTING_TYPE}==${LISTING_TYPE_VALUES.STANDARD}`;
 const SIEVE_CLAUSE_LT_PRIZE_DRAW = `${PRODUCT_FIELDS.LISTING_TYPE}==${LISTING_TYPE_VALUES.PRIZE_DRAW}`;
+const SIEVE_CLAUSE_LT_CLASSIFIED = `${PRODUCT_FIELDS.LISTING_TYPE}==${LISTING_TYPE_VALUES.CLASSIFIED}`;
+const SIEVE_CLAUSE_LT_DIGITAL_CODE = `${PRODUCT_FIELDS.LISTING_TYPE}==${LISTING_TYPE_VALUES.DIGITAL_CODE}`;
+const SIEVE_CLAUSE_LT_LIVE = `${PRODUCT_FIELDS.LISTING_TYPE}==${LISTING_TYPE_VALUES.LIVE}`;
 const LISTING_KIND_ALIAS_MAP = {
     standard: LISTING_TYPE_VALUES.STANDARD,
     auction: LISTING_TYPE_VALUES.AUCTION,
     "pre-order": LISTING_TYPE_VALUES.PRE_ORDER,
     "prize-draw": LISTING_TYPE_VALUES.PRIZE_DRAW,
+    classified: LISTING_TYPE_VALUES.CLASSIFIED,
+    "digital-code": LISTING_TYPE_VALUES.DIGITAL_CODE,
+    live: LISTING_TYPE_VALUES.LIVE,
     // Legacy → canonical.
     product: LISTING_TYPE_VALUES.STANDARD,
     preorder: LISTING_TYPE_VALUES.PRE_ORDER,
@@ -105,8 +111,10 @@ export class ProductRepository extends BaseRepository {
                 return false;
             }
         });
+        const barcodeId = input.barcodeId ?? await generateBarcodeId(id);
         const productData = {
             ...input,
+            barcodeId,
             slug: id,
             availableQuantity: input.stockQuantity,
             searchTokens: buildProductSearchTokens(input),
@@ -136,6 +144,10 @@ export class ProductRepository extends BaseRepository {
             .get();
         return snap.docs.map((d) => this.mapDoc(d));
     }
+    async findByBarcodeId(barcodeId) {
+        const docs = await this.findBy("barcodeId", barcodeId);
+        return docs[0] ?? null;
+    }
     async findBySlug(slug) {
         const key = this.cacheKeyBySlug(slug);
         const cached = cacheManager.get(key);
@@ -486,6 +498,15 @@ ProductRepository.SIEVE_FIELDS = {
     currency: { canFilter: true, canSort: false },
     freeShipping: { canFilter: true, canSort: false },
     searchTokens: { canFilter: true, canSort: false },
+    "classified.meetupArea": { canFilter: true, canSort: false },
+    "classified.acceptsShipping": { canFilter: true, canSort: false },
+    "classified.negotiable": { canFilter: true, canSort: false },
+    "digitalCode.codeDeliveryMethod": { canFilter: true, canSort: false },
+    "digitalCode.codesAvailable": { canFilter: true, canSort: true },
+    "liveItem.species": { canFilter: true, canSort: false },
+    "liveItem.sex": { canFilter: true, canSort: false },
+    "liveItem.jurisdictionAllowed": { canFilter: true, canSort: false },
+    "liveItem.cites": { canFilter: true, canSort: false },
 };
 /**
  * Virtual filter aliases — callers can pass `f=listingType==auction` for
@@ -540,6 +561,12 @@ ProductRepository.FILTER_ALIASES = {
                 return [SIEVE_CLAUSE_PUBLISHED, SIEVE_CLAUSE_LT_PREORDER].join(",");
             case "publicPrizeDraws":
                 return [SIEVE_CLAUSE_PUBLISHED, SIEVE_CLAUSE_LT_PRIZE_DRAW].join(",");
+            case "publicClassifieds":
+                return [SIEVE_CLAUSE_PUBLISHED, SIEVE_CLAUSE_LT_CLASSIFIED].join(",");
+            case "publicDigitalCodes":
+                return [SIEVE_CLAUSE_PUBLISHED, SIEVE_CLAUSE_LT_DIGITAL_CODE].join(",");
+            case "publicLive":
+                return [SIEVE_CLAUSE_PUBLISHED, SIEVE_CLAUSE_LT_LIVE].join(",");
             case "published":
                 return SIEVE_CLAUSE_PUBLISHED;
             default:

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

@@ -3,6 +3,7 @@
  */
 import { type GenerateProductIdInput, type GenerateAuctionIdInput, type GeneratePreOrderIdInput } from "../../../utils/id-generators";
 import type { ProductStatus, ListingType } from "../types";
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 export interface ProductVideoField {
     url: string;
     thumbnailUrl: string;
@@ -103,8 +104,7 @@ export interface ProductLiveItemMeta {
     /** CITES permit number (Appendix I/II species). */
     cites?: string;
 }
-export interface ProductDocument {
-    id: string;
+export interface ProductDocument extends BaseDocument {
     title: string;
     description: string;
     slug?: string;
@@ -264,9 +264,11 @@ export interface ProductDocument {
         shelf: string;
         bin: string;
     };
+    /** Scannable barcode identifier linking this listing to a physical stickered item.
+     *  Auto-generated as `LIR-{8-char-hex}` on product creation when not supplied.
+     *  Override by scanning a pre-printed sticker during the create/edit flow. */
+    barcodeId?: string;
     searchTokens?: string[];
-    createdAt: Date;
-    updatedAt: Date;
 }
 /**
  * Single prize within a prize-draw listing. A draw can have between 3 and 16
@@ -294,10 +296,10 @@ export declare const ProductStatusValues: {
     readonly ARCHIVED: "archived";
 };
 export declare const PRODUCT_COLLECTION: "products";
-export declare const PRODUCT_INDEXED_FIELDS: readonly ["storeId", "status", "category", "featured", "listingType", "isPromoted", "isOnSale", "isSold", "searchTokens", "createdAt"];
+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"];
+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 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

@@ -23,6 +23,7 @@ export const PRODUCT_INDEXED_FIELDS = [
     "isSold",
     "searchTokens",
     "createdAt",
+    "barcodeId",
 ];
 export const DEFAULT_PRODUCT_DATA = {
     status: "draft",
@@ -173,6 +174,7 @@ export const PRODUCT_UPDATABLE_FIELDS = [
     "groupParentSlug",
     "groupChildSlugs",
     "groupTitle",
+    "barcodeId",
 ];
 // ── SB-UNI-N 2026-05-15 — Digital-code pool subcollection ───────────────────
 // Codes live at `products/{productId}/codes/{codeId}` — seller-only write,

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

@@ -263,8 +263,8 @@ export declare const productItemSchema: z.ZodObject<{
             unit?: string | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
-        id: string;
         title: string;
+        id: string;
         text?: string | undefined;
         fields?: {
             value: string;
@@ -273,8 +273,8 @@ export declare const productItemSchema: z.ZodObject<{
             unit?: string | undefined;
         }[] | undefined;
     }, {
-        id: string;
         title: string;
+        id: string;
         text?: string | undefined;
         fields?: {
             value: string;
@@ -285,9 +285,9 @@ export declare const productItemSchema: z.ZodObject<{
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     status: "draft" | "published" | "archived" | "in_review";
-    id: string;
     title: string;
     price: number;
+    id: string;
     currency?: string | undefined;
     video?: {
         url: string;
@@ -356,8 +356,8 @@ export declare const productItemSchema: z.ZodObject<{
         unit?: string | undefined;
     }[] | undefined;
     customSections?: {
-        id: string;
         title: string;
+        id: string;
         text?: string | undefined;
         fields?: {
             value: string;
@@ -414,9 +414,9 @@ export declare const productItemSchema: z.ZodObject<{
     publishedAt?: string | undefined;
 }, {
     status: "draft" | "published" | "archived" | "in_review";
-    id: string;
     title: string;
     price: number;
+    id: string;
     currency?: string | undefined;
     video?: {
         url: string;
@@ -485,8 +485,8 @@ export declare const productItemSchema: z.ZodObject<{
         unit?: string | undefined;
     }[] | undefined;
     customSections?: {
-        id: string;
         title: string;
+        id: string;
         text?: string | undefined;
         fields?: {
             value: string;

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

@@ -149,6 +149,8 @@ export interface ProductItem {
         shelf: string;
         bin: string;
     };
+    /** Scannable barcode ID linking this listing to a physical stickered item. */
+    barcodeId?: string;
 }
 export interface ProductListResponse {
     items: ProductItem[];

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

@@ -2,6 +2,7 @@
  * Coupons/Promotions Firestore Document Types & Constants
  */
 import type { CouponType } from "../types";
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 export interface DiscountConfig {
     value: number;
     maxDiscount?: number;
@@ -41,8 +42,7 @@ export interface CouponStats {
     totalRevenue: number;
     totalDiscount: number;
 }
-export interface CouponDocument {
-    id: string;
+export interface CouponDocument extends BaseDocument {
     code: string;
     name: string;
     description: string;
@@ -58,8 +58,6 @@ export interface CouponDocument {
     validity: ValidityConfig;
     restrictions: RestrictionsConfig;
     createdBy: string;
-    createdAt: Date;
-    updatedAt: Date;
     stats: CouponStats;
 }
 export interface CouponUsageDocument {

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

@@ -277,8 +277,8 @@ export declare const couponFirestoreSchema: z.ZodObject<{
     createdAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    id: string;
     description: string;
+    id: string;
     updatedAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
@@ -336,8 +336,8 @@ export declare const couponFirestoreSchema: z.ZodObject<{
     createdAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    id: string;
     description: string;
+    id: string;
     updatedAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
@@ -758,8 +758,8 @@ export declare const couponItemSchema: z.ZodObject<{
     code: string;
     type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
     createdAt: string;
-    id: string;
     description: string;
+    id: string;
     updatedAt: string;
     name: string;
     scope: "seller" | "admin";
@@ -782,8 +782,8 @@ export declare const couponItemSchema: z.ZodObject<{
     code: string;
     type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
     createdAt: string;
-    id: string;
     description: string;
+    id: string;
     updatedAt: string;
     name: string;
     scope: "seller" | "admin";

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

@@ -2,6 +2,7 @@
  * Reviews Firestore Document Types & Constants
  */
 import type { ReviewStatus } from "../types";
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 /** Runtime-accessible review status values — use instead of bare string literals. */
 export declare const ReviewStatusValues: {
     readonly PENDING: "pending";
@@ -15,8 +16,7 @@ export interface ReviewVideoField {
     trimStart?: number;
     trimEnd?: number;
 }
-export interface ReviewDocument {
-    id: string;
+export interface ReviewDocument extends BaseDocument {
     productId: string;
     productTitle: string;
     storeId?: string;
@@ -44,8 +44,6 @@ export interface ReviewDocument {
     isAnonymous?: boolean;
     sellerReply?: string;
     sellerRepliedAt?: Date;
-    createdAt: Date;
-    updatedAt: Date;
     approvedAt?: Date;
     rejectedAt?: Date;
 }

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

@@ -103,8 +103,8 @@ export declare const reviewFirestoreSchema: z.ZodObject<{
     createdAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    id: string;
     title: string;
+    id: string;
     updatedAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
@@ -150,8 +150,8 @@ export declare const reviewFirestoreSchema: z.ZodObject<{
     createdAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    id: string;
     title: string;
+    id: string;
     updatedAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;

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

@@ -25,6 +25,7 @@
  *  - SCAMMER_MATCH_FIELDS lists the Firestore array-contains fields used for this query
  */
 import type { ScamType } from "../constants/scam-types";
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 export declare const ScammerStatusValues: {
     readonly PENDING_REVIEW: "pending_review";
     readonly VERIFIED: "verified";
@@ -83,8 +84,7 @@ export interface ScammerSocialMedia {
     handle: string;
     url?: string;
 }
-export interface ScammerDocument {
-    id: string;
+export interface ScammerDocument extends BaseDocument {
     /** URL-safe slug — used in /scams/[slug]. Same as id. */
     seoSlug: string;
     /**
@@ -159,8 +159,6 @@ export interface ScammerDocument {
      * Reset to false when all contests are reviewed.
      */
     isContested?: boolean;
-    createdAt: Date;
-    updatedAt: Date;
 }
 /**
  * One victim's report linked to an existing scammer profile.

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

@@ -83,9 +83,9 @@ export declare const scammerFirestoreSchema: z.ZodObject<{
     createdAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    id: string;
     description: string;
     tags: string[];
+    id: string;
     updatedAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
@@ -123,9 +123,9 @@ export declare const scammerFirestoreSchema: z.ZodObject<{
     createdAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    id: string;
     description: string;
     tags: string[];
+    id: string;
     updatedAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
@@ -195,8 +195,8 @@ export declare const scammerIncidentFirestoreSchema: z.ZodObject<{
     createdAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    id: string;
     description: string;
+    id: string;
     scamType: string;
     reportedBy: string;
     scammerId: string;
@@ -218,8 +218,8 @@ export declare const scammerIncidentFirestoreSchema: z.ZodObject<{
     createdAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    id: string;
     description: string;
+    id: string;
     scamType: string;
     reportedBy: string;
     scammerId: string;