@mohasinac/appkit 4.9.1 → 4.9.3

package/dist/features/admin/repository/notification.repository.js

@@ -1,5 +1,5 @@
 import { normalizeError } from "../../../errors/normalize";
-import { BaseRepository, getFirestoreCount, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, getFirestoreCount, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { NOTIFICATIONS_COLLECTION, NOTIFICATION_FIELDS, } from "../schemas";
 import { serverLogger } from "../../../monitoring";
 import { serverTimestamp } from "../../../contracts/field-ops";
@@ -218,6 +218,6 @@ NotificationRepository.SIEVE_FIELDS = {
     priority: { canFilter: true, canSort: true },
     isRead: { canFilter: true, canSort: false },
     relatedType: { canFilter: true, canSort: false },
-    createdAt: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 export const notificationRepository = new NotificationRepository();

package/dist/features/auctions/repository/bid.repository.d.ts

@@ -3,7 +3,7 @@
  *
  * Data access layer for bid documents in Firestore
  */
-import { BaseRepository } from "../../../providers/db-firebase";
+import { BaseRepository, parseSieveDateValue } from "../../../providers/db-firebase";
 import type { DocumentReference, WriteBatch } from "firebase-admin/firestore";
 import type { SieveModel, FirebaseSieveResult } from "../../../providers/db-firebase";
 import type { BidDocument, BidCreateInput, BidUpdateInput, BidAdminUpdateInput, BidStatus } from "../schemas";
@@ -138,10 +138,12 @@ export declare class BidRepository extends BaseRepository<BidDocument> {
         bidDate: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         createdAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
     };
     /**

package/dist/features/auctions/repository/bid.repository.js

@@ -4,7 +4,7 @@ import { normalizeError } from "../../../errors/normalize";
  *
  * Data access layer for bid documents in Firestore
  */
-import { BaseRepository, getFirestoreCount, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, getFirestoreCount, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { DatabaseError } from "../../../errors";
 import { BID_COLLECTION, createBidId } from "../schemas";
 import { encryptPiiFields, decryptPiiFields, BID_PII_FIELDS, } from "../../../security";
@@ -375,7 +375,7 @@ BidRepository.SIEVE_FIELDS = {
     bidAmount: { canFilter: true, canSort: true },
     status: { canFilter: true, canSort: true },
     isWinning: { canFilter: true, canSort: false },
-    bidDate: { canFilter: true, canSort: true },
-    createdAt: { canFilter: true, canSort: true },
+    bidDate: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 export const bidRepository = new BidRepository();

package/dist/features/auth/repository/session.repository.js

@@ -1,7 +1,7 @@
 import { normalizeError } from "../../../errors/normalize";
 import { DatabaseError } from "../../../errors";
 import { serverLogger } from "../../../monitoring";
-import { BaseRepository, } from "../../../providers/db-firebase";
+import { BaseRepository, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { generateSessionId } from "../token-helpers";
 import { SESSION_COLLECTION, SESSION_EXPIRATION_MS, SESSION_FIELDS, } from "../schemas";
 export class SessionRepository extends BaseRepository {
@@ -273,8 +273,8 @@ SessionRepository.SIEVE_FIELDS = {
         canFilter: true,
         canSort: false,
     },
-    lastActivity: { canFilter: true, canSort: true },
-    expiresAt: { canFilter: true, canSort: true },
-    createdAt: { canFilter: true, canSort: true },
+    lastActivity: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    expiresAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 export const sessionRepository = new SessionRepository();

package/dist/features/auth/repository/user.repository.js

@@ -1,6 +1,6 @@
 import { normalizeError } from "../../../errors/normalize";
 import { DatabaseError } from "../../../errors";
-import { BaseRepository, getFirestoreCount, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, getFirestoreCount, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { USER_PII_FIELDS, decryptPayoutDetails, decryptPiiFields, decryptShippingConfig, encryptPayoutDetails, encryptPiiFields, encryptShippingConfig, piiBlindIndex, } from "../../../security";
 import { USER_COLLECTION, USER_FIELDS, createUserId, } from "../schemas";
 export class UserRepository extends BaseRepository {
@@ -257,7 +257,7 @@ UserRepository.SIEVE_FIELDS = {
     emailVerified: { canFilter: true, canSort: false },
     disabled: { canFilter: true, canSort: true },
     storeStatus: { canFilter: true, canSort: false },
-    createdAt: { canFilter: true, canSort: true },
-    updatedAt: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    updatedAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 export const userRepository = new UserRepository();

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

@@ -1,5 +1,5 @@
 import type { FirebaseSieveResult, SieveModel } from "../../../providers/db-firebase";
-import { BaseRepository } from "../../../providers/db-firebase";
+import { BaseRepository, parseSieveDateValue } from "../../../providers/db-firebase";
 import { type BlogPostCreateInput, type BlogPostDocument, type BlogPostUpdateInput } from "../schemas";
 import type { BlogPostCategory } from "../types";
 declare class BlogRepository extends BaseRepository<BlogPostDocument> {
@@ -61,10 +61,12 @@ declare class BlogRepository extends BaseRepository<BlogPostDocument> {
         publishedAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         updatedAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         tags: {
             canFilter: boolean;
@@ -73,6 +75,7 @@ declare class BlogRepository extends BaseRepository<BlogPostDocument> {
         createdAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
     };
     listPublished(opts: {

package/dist/features/blog/repository/blog.repository.js

@@ -1,6 +1,6 @@
 import { DatabaseError } from "../../../errors";
 import { normalizeError } from "../../../errors/normalize";
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { BLOG_POST_FIELDS, BLOG_POSTS_COLLECTION, } from "../schemas";
 import { createBlogPostId } from "../schemas";
 import { increment } from "../../../contracts/field-ops";
@@ -171,10 +171,10 @@ BlogRepository.SIEVE_FIELDS = {
     isFeatured: { canFilter: true, canSort: false },
     readTimeMinutes: { canFilter: true, canSort: true },
     views: { canFilter: true, canSort: true },
-    publishedAt: { canFilter: true, canSort: true },
-    updatedAt: { canFilter: true, canSort: true },
+    publishedAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    updatedAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
     tags: { canFilter: true, canSort: false },
-    createdAt: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 const blogRepository = new BlogRepository();
 export { BlogRepository, blogRepository };

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

@@ -4,7 +4,7 @@ import { CART_FIELDS } from "../../../constants/field-names";
 import { normalizeError } from "../../../errors/normalize";
 const ERR_CART_ITEM_NOT_FOUND = "Cart item not found";
 const ERR_CART_ITEM_LOCKED = "This item requires payment and cannot be removed or modified.";
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { decryptPii } from "../../../security";
 import { CART_COLLECTION, } from "../schemas";
 export class CartRepository extends BaseRepository {
@@ -291,7 +291,7 @@ export class CartRepository extends BaseRepository {
 CartRepository.SIEVE_FIELDS = {
     userId: { canFilter: true, canSort: false },
     sessionId: { canFilter: true, canSort: false },
-    updatedAt: { canFilter: true, canSort: true },
-    createdAt: { canFilter: true, canSort: true },
+    updatedAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 export const cartRepository = new CartRepository();

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

@@ -1,7 +1,7 @@
 /**
  * Personal Catalogue Repository (Feature B).
  */
-import { BaseRepository, type SieveModel, type FirebaseSieveResult } from "../../../providers/db-firebase";
+import { BaseRepository, parseSieveDateValue, type SieveModel, type FirebaseSieveResult } from "../../../providers/db-firebase";
 import { type CatalogueItemDocument, type CatalogueItemCreateInput, type CatalogueItemUpdateInput } from "../schemas/firestore";
 export declare class CatalogueRepository extends BaseRepository<CatalogueItemDocument> {
     constructor();
@@ -31,6 +31,7 @@ export declare class CatalogueRepository extends BaseRepository<CatalogueItemDoc
         createdAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
     };
     /** Bounded scan for the staleness-reminder Function — images older than N days, not yet reminded for this update. */

package/dist/features/catalogue/repository/catalogue.repository.js

@@ -1,7 +1,7 @@
 /**
  * Personal Catalogue Repository (Feature B).
  */
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { CATALOGUE_COLLECTION, CATALOGUE_FIELDS, createCatalogueItemId, } from "../schemas/firestore";
 export class CatalogueRepository extends BaseRepository {
     constructor() {
@@ -63,6 +63,6 @@ CatalogueRepository.SIEVE_FIELDS = {
     ownerId: { canFilter: true, canSort: false },
     visibility: { canFilter: true, canSort: false },
     listingStatus: { canFilter: true, canSort: false },
-    createdAt: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 export const catalogueRepository = new CatalogueRepository();

package/dist/features/categories/repository/categories.repository.js

@@ -1,7 +1,7 @@
 import { normalizeError } from "../../../errors/normalize";
 import { increment, arrayUnion, arrayRemove, } from "../../../contracts/field-ops";
 import { DatabaseError } from "../../../errors";
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { PRODUCT_FIELDS } from "../../../constants/field-names";
 import { CATEGORY_FIELDS, CATEGORIES_COLLECTION, MIN_ITEMS_FOR_FEATURED, buildCategoryTree, calculateCategoryFields, canBeFeatured, createCategoryId, isValidCategoryMove, } from "../schemas";
 export class CategoriesRepository extends BaseRepository {
@@ -523,6 +523,6 @@ CategoriesRepository.SIEVE_FIELDS = {
     },
     id: { canFilter: true, canSort: false },
     isLeaf: { canFilter: true, canSort: false },
-    createdAt: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 export const categoriesRepository = new CategoriesRepository();

package/dist/features/events/repository/event-entry.repository.js

@@ -1,7 +1,7 @@
 import { normalizeError } from "../../../errors/normalize";
 import { DatabaseError } from "../../../errors";
 import { serverLogger } from "../../../monitoring";
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { decryptPiiFields, encryptPiiFields, EVENT_ENTRY_PII_FIELDS, } from "../../../security";
 import { EVENT_ENTRIES_COLLECTION, EVENT_ENTRY_FIELDS, } from "../schemas";
 /** Extracted from getExportReport's poll branch to stay under the max nesting depth. */
@@ -304,7 +304,7 @@ EventEntryRepository.SIEVE_FIELDS = {
     userDisplayName: { canFilter: false, canSort: false },
     reviewStatus: { canFilter: true, canSort: false },
     status: { canFilter: true, canSort: false },
-    submittedAt: { canFilter: true, canSort: true },
+    submittedAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
     points: { canFilter: true, canSort: true },
 };
 const eventEntryRepository = new EventEntryRepository();

package/dist/features/events/repository/events.repository.js

@@ -2,7 +2,7 @@ import { DatabaseError } from "../../../errors";
 import { serverLogger } from "../../../monitoring";
 import { slugify } from "../../../utils";
 import { normalizeError } from "../../../errors/normalize";
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { EVENT_FIELDS, EVENTS_COLLECTION, } from "../schemas";
 import { increment } from "../../../contracts/field-ops";
 class EventRepository extends BaseRepository {
@@ -143,8 +143,8 @@ EventRepository.SIEVE_FIELDS = {
     status: { canFilter: true, canSort: true },
     title: { canFilter: true, canSort: true },
     createdBy: { canFilter: true, canSort: false },
-    startsAt: { canFilter: true, canSort: true },
-    endsAt: { canFilter: true, canSort: true },
+    startsAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    endsAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
     "stats.totalEntries": {
         path: "stats.totalEntries",
         canFilter: true,
@@ -161,7 +161,7 @@ EventRepository.SIEVE_FIELDS = {
         canSort: true,
     },
     id: { canFilter: true, canSort: false },
-    createdAt: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 const eventRepository = new EventRepository();
 export { EventRepository, eventRepository };

package/dist/features/faq/repository/faqs.repository.js

@@ -1,4 +1,4 @@
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { DatabaseError } from "../../../errors";
 import { increment } from "../../../contracts/field-ops";
 import { FAQ_FIELDS } from "../../../constants/field-names";
@@ -295,6 +295,6 @@ FirebaseFAQsRepository.SIEVE_FIELDS = {
     tags: { canFilter: true, canSort: false },
     searchTokens: { canFilter: true, canSort: false },
     "stats.helpful": { canFilter: false, canSort: true },
-    createdAt: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 export const faqsRepository = new FirebaseFAQsRepository();

package/dist/features/homepage/repository/carousel.repository.js

@@ -4,7 +4,7 @@ import { normalizeError } from "../../../errors/normalize";
  *
  * Manages homepage carousel slides with grid card system
  */
-import { BaseRepository, getFirestoreCount, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, getFirestoreCount, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { increment } from "../../../contracts/field-ops";
 import { CAROUSEL_SLIDES_COLLECTION, MAX_ACTIVE_SLIDES, DEFAULT_CAROUSEL_SLIDE_DATA, canActivateSlide, createCarouselId, } from "../schemas";
 import { DatabaseError } from "../../../errors";
@@ -250,8 +250,8 @@ CarouselRepository.SIEVE_FIELDS = {
     active: { canFilter: true, canSort: false },
     order: { canFilter: true, canSort: true },
     createdBy: { canFilter: true, canSort: false },
-    createdAt: { canFilter: true, canSort: true },
-    updatedAt: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    updatedAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 // Export singleton instance
 export const carouselRepository = new CarouselRepository();

package/dist/features/homepage/repository/homepage-sections.repository.js

@@ -5,7 +5,7 @@
  */
 import { DatabaseError } from "../../../errors";
 import { HOMEPAGE_SECTION_FIELDS } from "../../../constants/field-names";
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { normalizeError } from "../../../errors/normalize";
 import { HOMEPAGE_SECTIONS_COLLECTION, createHomepageSectionId, } from "../schemas";
 export class HomepageSectionsRepository extends BaseRepository {
@@ -180,7 +180,7 @@ HomepageSectionsRepository.SIEVE_FIELDS = {
     type: { canFilter: true, canSort: false },
     enabled: { canFilter: true, canSort: false },
     order: { canFilter: true, canSort: true },
-    createdAt: { canFilter: true, canSort: true },
-    updatedAt: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    updatedAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 export const homepageSectionsRepository = new HomepageSectionsRepository();

package/dist/features/lottery/repository/lottery-entry.repository.js

@@ -1,7 +1,7 @@
 import { normalizeError } from "../../../errors/normalize";
 import { DatabaseError } from "../../../errors";
 import { serverLogger } from "../../../monitoring";
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { decryptPiiFields, encryptPiiFields, LOTTERY_ENTRY_PII_FIELDS, } from "../../../security";
 import { LOTTERY_ENTRIES_COLLECTION, LOTTERY_ENTRY_FIELDS, } from "../schemas/firestore";
 class LotteryEntryRepository extends BaseRepository {
@@ -123,7 +123,7 @@ LotteryEntryRepository.SIEVE_FIELDS = {
     productId: { canFilter: true, canSort: false },
     userId: { canFilter: true, canSort: false },
     status: { canFilter: true, canSort: false },
-    submittedAt: { canFilter: true, canSort: true },
+    submittedAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
     userLotteryNumber: { canFilter: false, canSort: true },
 };
 export { LotteryEntryRepository };

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

@@ -1,6 +1,6 @@
 import type { DocumentReference, WriteBatch } from "firebase-admin/firestore";
 import type { FirebaseSieveResult, SieveModel } from "../../../providers/db-firebase";
-import { BaseRepository } from "../../../providers/db-firebase";
+import { BaseRepository, parseSieveDateValue } from "../../../providers/db-firebase";
 import { type OrderCreateInput, type OrderDocument, type OrderRefundEvent } from "../schemas";
 import type { OrderStatus, PaymentStatus } from "../types";
 declare class OrderRepository extends BaseRepository<OrderDocument> {
@@ -89,10 +89,12 @@ declare class OrderRepository extends BaseRepository<OrderDocument> {
         orderDate: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         createdAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         contestable: {
             canFilter: boolean;
@@ -157,10 +159,12 @@ declare class OrderRepository extends BaseRepository<OrderDocument> {
         orderDate: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         createdAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         paymentBatchId: {
             canFilter: boolean;

package/dist/features/orders/repository/orders.repository.js

@@ -1,6 +1,6 @@
 import { normalizeError } from "../../../errors/normalize";
 import { DatabaseError, NotFoundError } from "../../../errors";
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { decryptPiiFields, encryptPiiFields, ORDER_PII_FIELDS, } from "../../../security";
 import { serverTimestamp } from "../../../contracts/field-ops";
 import { createOrderId, ORDER_COLLECTION, OrderStatusValues, } from "../schemas";
@@ -464,8 +464,8 @@ OrderRepository.SELLER_SIEVE_FIELDS = {
     paymentStatus: { canFilter: true, canSort: true },
     paymentMethod: { canFilter: true, canSort: true },
     totalPrice: { canFilter: true, canSort: true },
-    orderDate: { canFilter: true, canSort: true },
-    createdAt: { canFilter: true, canSort: true },
+    orderDate: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
     contestable: { canFilter: true, canSort: false },
 };
 OrderRepository.ADMIN_SIEVE_FIELDS = {
@@ -482,8 +482,8 @@ OrderRepository.ADMIN_SIEVE_FIELDS = {
     shippingMethod: { canFilter: true, canSort: true },
     payoutStatus: { canFilter: true, canSort: false },
     totalPrice: { canFilter: true, canSort: true },
-    orderDate: { canFilter: true, canSort: true },
-    createdAt: { canFilter: true, canSort: true },
+    orderDate: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
     // S-SBUNI-RULES 2026-05-13 — refund + batch fields
     paymentBatchId: { canFilter: true, canSort: false },
     contestable: { canFilter: true, canSort: false },

package/dist/features/payments/repository/payout.repository.d.ts

@@ -4,7 +4,7 @@
  * Data access layer for payout documents in Firestore.
  * Handles seller payout requests and admin payout processing.
  */
-import { BaseRepository, type SieveModel, type FirebaseSieveResult } from "../../../providers/db-firebase";
+import { BaseRepository, parseSieveDateValue, type SieveModel, type FirebaseSieveResult } from "../../../providers/db-firebase";
 import type { DocumentReference, WriteResult } from "firebase-admin/firestore";
 import type { PayoutDocument, PayoutCreateInput, PayoutRefundDeduction, PayoutStatus, PayoutUpdateInput } from "../schemas";
 export declare class PayoutRepository extends BaseRepository<PayoutDocument> {
@@ -109,14 +109,17 @@ export declare class PayoutRepository extends BaseRepository<PayoutDocument> {
         requestedAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         createdAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         processedAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
     };
     /**

package/dist/features/payments/repository/payout.repository.js

@@ -4,7 +4,7 @@
  * Data access layer for payout documents in Firestore.
  * Handles seller payout requests and admin payout processing.
  */
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { PAYOUT_COLLECTION, PAYOUT_FIELDS, createPayoutId } from "../schemas";
 import { encryptPiiFields, decryptPiiFields, addPiiIndices, PAYOUT_PII_FIELDS, PAYOUT_PII_INDEX_MAP, encryptPayoutBankAccount, decryptPayoutBankAccount, } from "../../../security";
 export class PayoutRepository extends BaseRepository {
@@ -241,9 +241,9 @@ PayoutRepository.SIEVE_FIELDS = {
     paymentMethod: { canFilter: true, canSort: false },
     amount: { canFilter: true, canSort: true },
     netAmount: { canFilter: true, canSort: true },
-    requestedAt: { canFilter: true, canSort: true },
-    createdAt: { canFilter: true, canSort: true },
-    processedAt: { canFilter: true, canSort: true },
+    requestedAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    processedAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 // Export singleton instance
 export const payoutRepository = new PayoutRepository();

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

@@ -1,6 +1,6 @@
 import type { DocumentReference, WriteBatch } from "firebase-admin/firestore";
 import type { DocumentSnapshot } from "../../../providers/db-firebase";
-import { BaseRepository, type FirebaseSieveResult, type SieveFilterAliases, type SieveModel } from "../../../providers/db-firebase";
+import { BaseRepository, parseSieveDateValue, type FirebaseSieveResult, type SieveFilterAliases, type SieveModel } from "../../../providers/db-firebase";
 import { type ProductCreateInput, type ProductDocument, type ProductUpdateInput } from "../schemas";
 import type { ProductStatus } from "../types";
 export declare class ProductRepository extends BaseRepository<ProductDocument> {
@@ -140,22 +140,27 @@ export declare class ProductRepository extends BaseRepository<ProductDocument> {
         createdAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         updatedAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         auctionEndDate: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         prizeRevealWindowStart: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         prizeRevealWindowEnd: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         prizeRevealStatus: {
             canFilter: boolean;
@@ -184,6 +189,7 @@ export declare class ProductRepository extends BaseRepository<ProductDocument> {
         preOrderDeliveryDate: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         preOrderDepositPercent: {
             canFilter: boolean;

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

@@ -1,7 +1,7 @@
 import { normalizeError } from "../../../errors/normalize";
 import { increment, serverTimestamp } from "../../../contracts/field-ops";
 import { DatabaseError } from "../../../errors";
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { cacheManager } from "../../../core";
 import { generateUniqueId, slugify, buildSearchTokens, tokenizeQuery, generateBarcodeId } from "../../../utils";
 import { PRODUCT_COLLECTION, ProductStatusValues } from "../schemas";
@@ -500,18 +500,18 @@ ProductRepository.SIEVE_FIELDS = {
     bidCount: { canFilter: true, canSort: true },
     isSold: { canFilter: true, canSort: true },
     isPartOfBundle: { canFilter: true, canSort: false },
-    createdAt: { canFilter: true, canSort: true },
-    updatedAt: { canFilter: true, canSort: true },
-    auctionEndDate: { canFilter: true, canSort: true },
-    prizeRevealWindowStart: { canFilter: true, canSort: true },
-    prizeRevealWindowEnd: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    updatedAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    auctionEndDate: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    prizeRevealWindowStart: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    prizeRevealWindowEnd: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
     prizeRevealStatus: { canFilter: true, canSort: false },
     startingBid: { canFilter: true, canSort: true },
     buyNowPrice: { canFilter: true, canSort: true },
     minBidIncrement: { canFilter: true, canSort: false },
     autoExtendable: { canFilter: true, canSort: false },
     reservePrice: { canFilter: true, canSort: true },
-    preOrderDeliveryDate: { canFilter: true, canSort: true },
+    preOrderDeliveryDate: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
     preOrderDepositPercent: { canFilter: true, canSort: false },
     preOrderDepositAmount: { canFilter: true, canSort: true },
     preOrderMaxQuantity: { canFilter: true, canSort: true },

package/dist/features/promotions/repository/coupons.repository.d.ts

@@ -4,7 +4,7 @@ import type { ListingType } from "../../products/types";
  *
  * Manages coupon creation, validation, and usage tracking
  */
-import { BaseRepository } from "../../../providers/db-firebase";
+import { BaseRepository, parseSieveDateValue } from "../../../providers/db-firebase";
 import type { SieveModel, FirebaseSieveResult } from "../../../providers/db-firebase";
 import { CouponDocument, CouponUsageDocument, CouponCreateInput } from "../schemas";
 import type { CouponType } from "../types";
@@ -179,11 +179,13 @@ export declare class CouponsRepository extends BaseRepository<CouponDocument> {
             path: string;
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         "validity.startDate": {
             path: string;
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         "discount.value": {
             path: string;
@@ -203,6 +205,7 @@ export declare class CouponsRepository extends BaseRepository<CouponDocument> {
         createdAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         storeId: {
             canFilter: boolean;

package/dist/features/promotions/repository/coupons.repository.js

@@ -5,7 +5,7 @@ import { serverLogger } from "../../../monitoring/server-logger";
  *
  * Manages coupon creation, validation, and usage tracking
  */
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { COUPONS_COLLECTION, COUPON_FIELDS, isValidCouponCode, isCouponValid, canUserUseCoupon, calculateDiscount, createCouponId, } from "../schemas";
 import { USER_COLLECTION } from "../../auth/schemas";
 import { DatabaseError } from "../../../errors";
@@ -500,11 +500,13 @@ CouponsRepository.SIEVE_FIELDS = {
         path: "validity.endDate",
         canFilter: true,
         canSort: true,
+        parseValue: parseSieveDateValue,
     },
     "validity.startDate": {
         path: "validity.startDate",
         canFilter: true,
         canSort: true,
+        parseValue: parseSieveDateValue,
     },
     "discount.value": {
         path: "discount.value",
@@ -521,7 +523,7 @@ CouponsRepository.SIEVE_FIELDS = {
         canFilter: true,
         canSort: true,
     },
-    createdAt: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
     storeId: { canFilter: true, canSort: false },
     scope: { canFilter: true, canSort: false },
 };

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

@@ -1,5 +1,5 @@
 import type { FirebaseSieveResult, SieveModel } from "../../../providers/db-firebase";
-import { BaseRepository } from "../../../providers/db-firebase";
+import { BaseRepository, parseSieveDateValue } from "../../../providers/db-firebase";
 import { type ReviewCreateInput, type ReviewDocument } from "../schemas";
 import type { ReviewStatus } from "../types";
 export interface ReviewRatingAggregate {
@@ -107,10 +107,12 @@ declare class ReviewRepository extends BaseRepository<ReviewDocument> {
         updatedAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         createdAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
     };
     listForProduct(productId: string, model: SieveModel): Promise<FirebaseSieveResult<ReviewDocument>>;

package/dist/features/reviews/repository/reviews.repository.js

@@ -1,4 +1,4 @@
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { addPiiIndices, decryptPiiFields, encryptPiiFields, REVIEW_PII_FIELDS, REVIEW_PII_INDEX_MAP, } from "../../../security";
 import { createReviewId, REVIEW_COLLECTION, } from "../schemas";
 const REVIEW_FIELDS = {
@@ -262,8 +262,8 @@ ReviewRepository.SIEVE_FIELDS = {
     helpfulCount: { canFilter: true, canSort: true },
     featured: { canFilter: true, canSort: false },
     reportCount: { canFilter: true, canSort: true },
-    updatedAt: { canFilter: true, canSort: true },
-    createdAt: { canFilter: true, canSort: true },
+    updatedAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 const reviewRepository = new ReviewRepository();
 export { ReviewRepository, reviewRepository };

package/dist/features/scams/repository/scammer.repository.d.ts

@@ -1,4 +1,4 @@
-import { BaseRepository, type FirebaseSieveResult, type SieveModel } from "../../../providers/db-firebase";
+import { BaseRepository, parseSieveDateValue, type FirebaseSieveResult, type SieveModel } from "../../../providers/db-firebase";
 import { type ScammerDocument, type ScammerIncidentDocument, type ScammerCommentDocument, type ScammerCreateInput, type ScammerAdminUpdateInput } from "../schemas/firestore";
 declare class ScammerRepository extends BaseRepository<ScammerDocument> {
     constructor();
@@ -42,6 +42,7 @@ declare class ScammerRepository extends BaseRepository<ScammerDocument> {
         createdAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         updatedAt: {
             canFilter: boolean;

package/dist/features/scams/repository/scammer.repository.js

@@ -1,5 +1,5 @@
 import { DatabaseError } from "../../../errors";
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { normalizeError } from "../../../errors/normalize";
 import { serverLogger } from "../../../monitoring/server-logger";
 import { increment } from "../../../contracts/field-ops";
@@ -190,7 +190,7 @@ ScammerRepository.SIEVE_FIELDS = {
     isContested: { canFilter: true, canSort: false },
     views: { canFilter: false, canSort: true },
     incidentCount: { canFilter: false, canSort: true },
-    createdAt: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
     updatedAt: { canFilter: false, canSort: true },
 };
 const scammerRepository = new ScammerRepository();

package/dist/features/server-errors/repository/server-errors.repository.js

@@ -1,5 +1,5 @@
 import { BaseRepository } from "../../../providers/db-firebase";
-import { applySieveToFirestore } from "../../../providers/db-firebase";
+import { applySieveToFirestore, parseSieveDateValue } from "../../../providers/db-firebase";
 import { SERVER_ERRORS_COLLECTION, SERVER_ERROR_STACK_MAX_BYTES, } from "../schemas/firestore";
 import { normalizeError } from "../../../errors/normalize";
 /** Truncate a stack to the documented byte budget — never persist > 4 KB. */
@@ -63,7 +63,7 @@ export class ServerErrorsRepository extends BaseRepository {
     }
 }
 ServerErrorsRepository.SIEVE_FIELDS = {
-    occurredAt: { canFilter: true, canSort: true },
+    occurredAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
     source: { canFilter: true, canSort: false },
     route: { canFilter: true, canSort: false },
     method: { canFilter: true, canSort: false },

package/dist/features/shipments/repository/shipment-items.repository.d.ts

@@ -4,7 +4,7 @@
  * exactly Firestore's native batched-write limit, so bulkCreate() writes an
  * entire import in a single WriteBatch with no chunking logic.
  */
-import { BaseRepository, type SieveModel, type FirebaseSieveResult } from "../../../providers/db-firebase";
+import { BaseRepository, parseSieveDateValue, type SieveModel, type FirebaseSieveResult } from "../../../providers/db-firebase";
 import { type ShipmentItem, type ShipmentItemCreateInput, type ShipmentItemUpdateInput } from "../schemas/firestore";
 export declare class ShipmentItemsRepository extends BaseRepository<ShipmentItem> {
     constructor();
@@ -50,6 +50,7 @@ export declare class ShipmentItemsRepository extends BaseRepository<ShipmentItem
         createdAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
     };
 }

package/dist/features/shipments/repository/shipment-items.repository.js

@@ -4,7 +4,7 @@
  * exactly Firestore's native batched-write limit, so bulkCreate() writes an
  * entire import in a single WriteBatch with no chunking logic.
  */
-import { BaseRepository, } from "../../../providers/db-firebase";
+import { BaseRepository, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { SHIPMENT_ITEM_COLLECTION, SHIPMENT_ITEM_FIELDS, MAX_ITEMS_PER_LOT, } from "../schemas/firestore";
 import { ValidationError } from "../../../errors";
 import { sieveAnd, sieveFilter, SIEVE_OP } from "../../../utils/sieve-builder";
@@ -73,6 +73,6 @@ ShipmentItemsRepository.SIEVE_FIELDS = {
     title: { canFilter: true, canSort: true },
     price: { canFilter: true, canSort: true },
     linkedProductId: { canFilter: true, canSort: false },
-    createdAt: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 export const shipmentItemsRepository = new ShipmentItemsRepository();

package/dist/features/shipments/repository/shipment-lots.repository.d.ts

@@ -1,7 +1,7 @@
 /**
  * Shipment Lots Repository — one doc per lot, FK'd to a shipment.
  */
-import { BaseRepository, type SieveModel, type FirebaseSieveResult } from "../../../providers/db-firebase";
+import { BaseRepository, parseSieveDateValue, type SieveModel, type FirebaseSieveResult } from "../../../providers/db-firebase";
 import { type ShipmentLot, type ShipmentLotCreateInput, type ShipmentLotUpdateInput } from "../schemas/firestore";
 export declare class ShipmentLotsRepository extends BaseRepository<ShipmentLot> {
     constructor();
@@ -42,6 +42,7 @@ export declare class ShipmentLotsRepository extends BaseRepository<ShipmentLot>
         createdAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
     };
 }

package/dist/features/shipments/repository/shipment-lots.repository.js

@@ -1,7 +1,7 @@
 /**
  * Shipment Lots Repository — one doc per lot, FK'd to a shipment.
  */
-import { BaseRepository, } from "../../../providers/db-firebase";
+import { BaseRepository, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { SHIPMENT_LOT_COLLECTION, SHIPMENT_LOT_FIELDS, } from "../schemas/firestore";
 export class ShipmentLotsRepository extends BaseRepository {
     constructor() {
@@ -50,6 +50,6 @@ ShipmentLotsRepository.SIEVE_FIELDS = {
     lotName: { canFilter: true, canSort: true },
     projectedProfit: { canFilter: true, canSort: true },
     projectedRevenue: { canFilter: true, canSort: true },
-    createdAt: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 export const shipmentLotsRepository = new ShipmentLotsRepository();

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

@@ -2,7 +2,7 @@
  * Procurement Shipments Repository — header document only.
  * Lots/items live in ShipmentLotsRepository / ShipmentItemsRepository.
  */
-import { BaseRepository, type SieveModel, type FirebaseSieveResult } from "../../../providers/db-firebase";
+import { BaseRepository, parseSieveDateValue, type SieveModel, type FirebaseSieveResult } from "../../../providers/db-firebase";
 import { type ShipmentDocument, type ShipmentCreateInput, type ShipmentUpdateInput } from "../schemas/firestore";
 export declare class ShipmentsRepository extends BaseRepository<ShipmentDocument> {
     constructor();
@@ -39,10 +39,12 @@ export declare class ShipmentsRepository extends BaseRepository<ShipmentDocument
         etaDate: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
         createdAt: {
             canFilter: boolean;
             canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
         };
     };
     list(model: SieveModel): Promise<FirebaseSieveResult<ShipmentDocument>>;

package/dist/features/shipments/repository/shipments.repository.js

@@ -2,7 +2,7 @@
  * Procurement Shipments Repository — header document only.
  * Lots/items live in ShipmentLotsRepository / ShipmentItemsRepository.
  */
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { ConflictError } from "../../../errors";
 import { SHIPMENT_COLLECTION, SHIPMENT_FIELDS, SHIPMENT_ITEM_COLLECTION, DEFAULT_SHIPMENT_TOTALS, createShipmentId, } from "../schemas/firestore";
 export class ShipmentsRepository extends BaseRepository {
@@ -71,7 +71,7 @@ ShipmentsRepository.SIEVE_FIELDS = {
     shipmentNumber: { canFilter: true, canSort: true },
     supplierName: { canFilter: true, canSort: true },
     status: { canFilter: true, canSort: true },
-    etaDate: { canFilter: true, canSort: true },
-    createdAt: { canFilter: true, canSort: true },
+    etaDate: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 export const shipmentsRepository = new ShipmentsRepository();

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

@@ -1,5 +1,5 @@
 import { firebaseFieldOps } from "../../../providers/db-firebase";
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
 import { normalizeError } from "../../../errors/normalize";
 import { DatabaseError } from "../../../errors";
 import { SUPPORT_TICKET_FIELDS } from "../../../constants/field-names";
@@ -115,7 +115,7 @@ SupportRepository.SIEVE_FIELDS = {
     priority: { canFilter: true, canSort: false },
     assignedTo: { canFilter: true, canSort: false },
     orderId: { canFilter: true, canSort: false },
-    createdAt: { canFilter: true, canSort: true },
-    updatedAt: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+    updatedAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 export const supportRepository = new SupportRepository();

package/dist/features/tester/repository/tester-checklist-item.repository.js

@@ -1,4 +1,4 @@
-import { BaseRepository } from "../../../providers/db-firebase";
+import { BaseRepository, parseSieveDateValue } from "../../../providers/db-firebase";
 import { DatabaseError } from "../../../errors";
 import { TESTER_CHECKLIST_ITEM_COLLECTION, TESTER_CHECKLIST_ITEM_FIELDS, createChecklistItemId, } from "../schemas/firestore";
 export class TesterChecklistItemRepository extends BaseRepository {
@@ -130,7 +130,7 @@ TesterChecklistItemRepository.SIEVE_FIELDS = {
     phase: { canFilter: true, canSort: true },
     isActive: { canFilter: true, canSort: false },
     searchTokens: { canFilter: true, canSort: false },
-    createdAt: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
     bugConfirmed: { canFilter: true, canSort: false },
 };
 export const testerChecklistItemRepository = new TesterChecklistItemRepository();

package/dist/features/tester/repository/tester-checklist-response.repository.js

@@ -1,4 +1,4 @@
-import { BaseRepository } from "../../../providers/db-firebase";
+import { BaseRepository, parseSieveDateValue } from "../../../providers/db-firebase";
 import { TESTER_CHECKLIST_RESPONSE_COLLECTION, TESTER_CHECKLIST_RESPONSE_FIELDS, createChecklistResponseId, } from "../schemas/firestore";
 import { testerChecklistItemRepository } from "./tester-checklist-item.repository";
 function escapeMd(text) {
@@ -230,6 +230,6 @@ TesterChecklistResponseRepository.SIEVE_FIELDS = {
     phase: { canFilter: true, canSort: true },
     answer: { canFilter: true, canSort: false },
     status: { canFilter: true, canSort: false },
-    createdAt: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };
 export const testerChecklistResponseRepository = new TesterChecklistResponseRepository();

package/dist/features/tester/seed-data/tester-checklist-seed-data.js

@@ -207,6 +207,12 @@ const rawTesterChecklistItems = [
                 { key: "classified-contact-flow", label: "A classified listing shows a contact-seller flow with deliberately no checkout/buy button" },
                 { key: "digitalcode-delivery", label: "Purchasing a digital-code listing delivers the code to the buyer post-purchase" },
                 { key: "live-item-detail", label: "A live-item listing's detail page shows the livestream link correctly" },
+                {
+                    key: "live-item-video-mandatory",
+                    label: "Creating a live-item listing (species: animals/plants) without a video is rejected with a clear error; a live listing WITH a video plays correctly in the gallery's video slide and its poster thumbnail is watermarked",
+                    description: "Verify the block on both the admin product editor and the seller \"List a live item\" form. Then verify playback against the tester-sandbox fixture \"Test Live Item — Golden Retriever Puppy\" (live-tester-sandbox-1) — its video is a real dog clip (previously a broken YouTube link that never played); confirm it actually plays in theater mode and the thumbnail carries the site watermark.",
+                    href: "/store/live/new",
+                },
             ],
         },
         {
@@ -224,7 +230,11 @@ const rawTesterChecklistItems = [
                 { key: "shipping-address-edit", label: "Editing an existing shipping address from checkout works" },
                 { key: "shipping-method-selection", label: "Selecting a shipping method/provider at checkout recalculates the shipping fee correctly" },
                 { key: "gst-breakdown-display", label: "When GST is enabled in Site Settings, checkout shows the correct CGST/SGST or IGST breakdown based on buyer vs seller state" },
-                { key: "checkout-otp-highvalue", label: "Carts ≥ the admin-configured high-value OTP threshold (Site Settings → Shipping → \"High-value checkout OTP threshold\") prompt a \"Verify this order\" email OTP right before payment (except COD)" },
+                {
+                    key: "checkout-otp-highvalue",
+                    label: "Carts ≥ the admin-configured high-value OTP threshold (Site Settings → Shipping → \"High-value checkout OTP threshold\", default ₹5,000) prompt a \"Verify this order\" email OTP right before payment (except COD); carts below the threshold check out directly with no OTP step at all",
+                    description: "Root-caused 2026-08-20 — the OTP email send used to be fire-and-forget, so a Resend/API failure silently left the buyer stuck with no code and no error. Sending now surfaces a real error if the email genuinely fails to send, and the \"already sent, retry in N minutes\" rate-limit message is a clear sentence instead of a raw error code. Place a real order ≥ the threshold and confirm the code actually arrives by email (check spam too) — report the exact error text if it still doesn't.",
+                },
                 { key: "payment-method-selection", label: "Choosing between COD, UPI/manual, and Razorpay (when enabled) at checkout works" },
                 { key: "payment-window-countdown", label: "Manual-payment orders show a 15-minute countdown timer on the payment page" },
                 { key: "payment-proof-upload", label: "Uploading manual payment proof (screenshot, UTR, mark-as-paid + agreement checkboxes) works" },
@@ -334,6 +344,17 @@ const rawTesterChecklistItems = [
                     label: "The mobile bottom navigation bar shows a Cart tab with a live item-count badge; Wishlist is no longer a bottom-tab slot but is still reachable from the header",
                     description: "Wishlist was intentionally removed only from the bottom tab bar, not from the header/app-bar or main navigation — confirm the header wishlist icon is unaffected.",
                 },
+                {
+                    key: "cart-badge-matches-cart-page",
+                    label: "After adding an item to the cart, the item actually appears when you open the cart page — not just an updated badge count with an empty cart",
+                    description: "Root-caused 2026-08-20 — a background sync manager that replays queued cart/wishlist writes to the server was built but never mounted anywhere in the app, so the cart badge (read from a local queue) updated instantly while the server-backed cart page (read from Firestore) never received the write and showed empty. Add an item, then navigate to /cart (not just glance at the badge) and confirm it's really there — check on both a fresh session and after a page reload.",
+                    href: "/cart",
+                },
+                {
+                    key: "cart-mobile-no-overflow",
+                    label: "On mobile, cart item cards stay fully within the screen width per seller group — no horizontal overflow/clipping — and a floating checkout bar (styled like the bulk-action bar, sitting above the bottom nav) shows the total and a Checkout button, with enough bottom margin that the last cart item is never hidden behind it",
+                    href: "/cart",
+                },
             ],
         },
         {
@@ -398,6 +419,12 @@ const rawTesterChecklistItems = [
                 { key: "browser-back-forward", label: "Browser back/forward buttons move correctly between dashboard sub-pages without breaking the layout" },
                 { key: "logged-out-redirect", label: "Opening a user dashboard URL while logged out redirects to login, then returns to the originally requested page after signing in" },
                 { key: "breadcrumbs-accurate", label: "Breadcrumbs (where present) on nested user dashboard pages accurately reflect the current location" },
+                {
+                    key: "sidebar-logout-button",
+                    label: "The user dashboard sidebar itself (not just the header profile dropdown) has a visible \"Log out\" action at the bottom, and clicking it signs out and redirects to login",
+                    description: "Previously the only logout affordance while on a dashboard page was the header profile dropdown — the sidebar had none. Check on both mobile (drawer) and desktop (persistent rail).",
+                    href: "/user",
+                },
             ],
         },
     ]),
@@ -536,6 +563,11 @@ const rawTesterChecklistItems = [
                 { key: "store-browser-back-forward", label: "Browser back/forward buttons move correctly between store dashboard sub-pages without breaking the layout" },
                 { key: "store-logged-out-redirect", label: "Opening a store dashboard URL while logged out (or as a non-seller) redirects appropriately instead of erroring" },
                 { key: "store-nav-listing-type-groups", label: "The seller nav correctly groups/labels each listing-type management area (standard, auctions, pre-orders, prize draws, bundles, classifieds, digital codes, live, art, stickers)" },
+                {
+                    key: "store-sidebar-logout-button",
+                    label: "The store dashboard sidebar has a visible \"Log out\" action at the bottom (not just the header profile dropdown), and clicking it signs out and redirects to login",
+                    href: "/store",
+                },
             ],
         },
     ]),
@@ -669,6 +701,11 @@ const rawTesterChecklistItems = [
                 { key: "card-row-heights-aligned", label: "Product/auction/pre-order/event cards in the same row are the same height, with their action button (Reserve now, Place bid, View details, etc.) aligned along a common bottom edge even when one card's description is longer than another's" },
                 { key: "image-watermark-subtle", label: "Product and listing images show a small, subtle watermark (not oversized or fully opaque, doesn't obscure the image)" },
                 { key: "section-cta-buttons-visible", label: "Homepage section \"View all →\" / \"Go to…\" buttons use a solid primary-colored fill so they're clearly identifiable as clickable CTAs, not a plain white/outline box that blends into the page" },
+                {
+                    key: "mobile-search-bar-proportions",
+                    label: "On mobile, the global header search bar's resource-type dropdown (Products/Auctions/etc.) is a compact, capped width and the text input takes up most of the remaining space — not an oversized dropdown squeezing the input down to a sliver",
+                    href: "/",
+                },
             ],
         },
         {
@@ -752,6 +789,12 @@ const rawTesterChecklistItems = [
                     description: "Verify \"Beyblade Burst\" shows 2 items (matching the 2 real products inside it when browsed), not \"0 items\". If any category shows 0 despite having published products, run `npm run categories:backfill-metrics` to recompute the counters.",
                     href: "/categories",
                 },
+                {
+                    key: "parent-category-includes-children",
+                    label: "Visiting a PARENT category's page shows products filed under its child categories too (not just products tagged with the parent's own id), and its \"N products\" count is the sum of its own products plus every child category's",
+                    description: "Verify against \"Spinning Tops\" (category-spinning-tops, the root over Original/Metal Fight/Burst/X) — its product listing and count should include every Beyblade product across all 4 generations, not show empty or only the root's own (normally zero) direct products. Note: this rollup applies to page 1 / default sort only — changing sort or paging within the tab may still narrow back to the parent's own products (a known follow-up, not yet fixed).",
+                    href: "/categories",
+                },
                 {
                     key: "category-brand-related-sections",
                     label: "A category detail page shows a \"Related Categories\" section (other categories sharing the same root) and a brand detail page shows a \"Related Brands\" section, each with real items",
@@ -937,6 +980,12 @@ const rawTesterChecklistItems = [
             pageLabel: "Users & Trust",
             cases: [
                 { key: "users-role-change", label: "Admin can change a user's role and toggle isTester/canTestAdmin", href: "/admin/users" },
+                {
+                    key: "admin-delete-user-complete",
+                    label: "Deleting a user from the admin Users editor removes their Firestore profile, their active sessions, AND their Firebase Auth record — not just the Firestore doc",
+                    description: "Verify the deleted account can no longer log in at all (Auth record gone), not just that it's missing from the admin list.",
+                    href: "/admin/users",
+                },
                 { key: "roles-crud", label: "Admin can create and edit custom roles", href: "/admin/roles" },
                 { key: "sessions-revoke", label: "Admin can revoke a user's active sessions", href: "/admin/sessions" },
                 { key: "scammers-registry-admin", label: "Admin can manage the scammer registry", href: "/admin/scammers" },
@@ -976,6 +1025,17 @@ const rawTesterChecklistItems = [
                 { key: "guide-pages-admin", label: "The 8 admin guide pages all load correctly", href: "/admin/guide" },
                 { key: "tester-checklist-crud-admin", label: "Admin can create, edit, and toggle adminOnly on tester checklist items", href: "/admin/tester-checklist" },
                 { key: "tester-feedback-report-export", label: "Admin tester-feedback report shows Yes/No analytics grouped correctly and the Download Report export works", href: "/admin/tester-feedback" },
+                {
+                    key: "admin-sidebar-logout-button",
+                    label: "The admin dashboard sidebar has a visible \"Log out\" action at the bottom (not just the header profile dropdown), and clicking it signs out and redirects to login",
+                    href: "/admin/dashboard",
+                },
+                {
+                    key: "dashboard-tables-colors-avatars-icons",
+                    label: "Admin/store/user dashboard tables and list/grid cards show color-coded status badges (green/amber/red/blue by meaning, not one flat color for every status) and a circular avatar/icon per row (a real photo when the item has one — user avatar, store logo, product image — otherwise a resource-type icon), instead of plain black-on-white text rows",
+                    description: "Spot-check a few different dashboards — Users (avatar photos), Stores (logos), Products (thumbnails), and a resource with no natural photo like Orders/Payouts/Coupons (should still show a resource icon, not a blank row).",
+                    href: "/admin/users",
+                },
             ],
         },
         {

package/dist/index.d.ts

@@ -1838,6 +1838,7 @@ export type { FeedbackConfig } from "./features/events/index";
 export type { FormFieldType } from "./features/events/index";
 export type { LeaderboardEntry } from "./features/events/index";
 export type { PollResultEntry } from "./features/events/index";
+export type { SpinResultEntry } from "./features/events/index";
 export type { OfferConfig } from "./features/events/index";
 export type { PollConfig } from "./features/events/index";
 export type { PollResultsVisibility } from "./features/events/index";

package/dist/providers/db-firebase/index.d.ts

@@ -27,4 +27,4 @@ export declare const firebaseDbProvider: IDbProvider;
 export { buildFirebaseClientConfig, normalizeFirebaseConfigValue, } from "./client-config";
 export type { FirebaseClientConfig } from "./client-config";
 export type { SieveModel, SieveFields, SieveFieldConfig, SieveOptions, SieveResult, SieveFilterAlias, SieveFilterAliases, FirebaseSieveFieldConfig, FirebaseSieveFields, FirebaseSieveOptions, FirebaseSieveResult, } from "./sieve";
-export { applySieveToFirestore, expandFilterAliases } from "./sieve";
+export { applySieveToFirestore, expandFilterAliases, parseSieveDateValue } from "./sieve";

package/dist/providers/db-firebase/index.js

@@ -38,4 +38,4 @@ export const firebaseDbProvider = {
 };
 // Firebase client config builder (for consumer app bundles)
 export { buildFirebaseClientConfig, normalizeFirebaseConfigValue, } from "./client-config";
-export { applySieveToFirestore, expandFilterAliases } from "./sieve";
+export { applySieveToFirestore, expandFilterAliases, parseSieveDateValue } from "./sieve";

package/dist/providers/db-firebase/sieve.d.ts

@@ -75,8 +75,27 @@ export type SieveFieldConfig = {
     path?: string;
     canFilter?: boolean;
     canSort?: boolean;
+    /**
+     * Convert the raw string filter value before it reaches the Firestore
+     * adapter. Required for any field stored as a Firestore Timestamp — without
+     * it, sievejs's default `convertValue` (`processor.js`) leaves date-like
+     * filter values as plain strings, and a Firestore inequality (`>`, `<`,
+     * `>=`, `<=`) comparing a Timestamp field against a string value matches
+     * ZERO documents (Firestore requires the query value's type to match the
+     * field's stored type for range comparisons) — silently, with no error.
+     * Use `parseSieveDateValue` below for Timestamp fields.
+     */
+    parseValue?: (raw: string) => unknown;
 };
 export type SieveFields = Record<string, SieveFieldConfig>;
+/**
+ * `SieveFieldConfig.parseValue` for any field stored as a Firestore
+ * Timestamp. Converts an ISO date string (or any `Date`-parseable value) into
+ * a real `Date`, which the Admin SDK compares correctly against a Timestamp
+ * field. Falls back to the raw string on an unparseable value rather than
+ * throwing, so a malformed filter degrades to "no match" instead of a 500.
+ */
+export declare function parseSieveDateValue(raw: string): Date | string;
 export interface SieveModel {
     /** Comma-delimited filter expressions, e.g. `status==published,price>=100` */
     filters?: string;

package/dist/providers/db-firebase/sieve.js

@@ -101,6 +101,17 @@ import { expandFilterAliases as _expandFilterAliases, } from "./filter-aliases";
 // should prefer importing from `./filter-aliases` directly — that path has
 // zero runtime deps and is client-safe.
 export { _expandFilterAliases as expandFilterAliases, };
+/**
+ * `SieveFieldConfig.parseValue` for any field stored as a Firestore
+ * Timestamp. Converts an ISO date string (or any `Date`-parseable value) into
+ * a real `Date`, which the Admin SDK compares correctly against a Timestamp
+ * field. Falls back to the raw string on an unparseable value rather than
+ * throwing, so a malformed filter degrades to "no match" instead of a 500.
+ */
+export function parseSieveDateValue(raw) {
+    const parsed = new Date(raw);
+    return Number.isNaN(parsed.getTime()) ? raw : parsed;
+}
 const SIEVE_DEFAULTS = {
     caseSensitive: false,
     defaultPageSize: 20,

package/dist/server.d.ts

@@ -272,6 +272,8 @@ export { eventIdGET } from "./features/events/server";
 export { eventsGET } from "./features/events/server";
 export { getEventLeaderboard } from "./features/events/server";
 export { getEventPollResults } from "./features/events/server";
+export type { PollResultEntry, SpinResultEntry } from "./features/events/index";
+export { getEventSpinResults } from "./features/events/server";
 export { getBugHunterLeaderboard } from "./features/tester/server";
 export { getPublicEventById } from "./features/events/server";
 export { listPublicEvents } from "./features/events/server";

package/dist/server.js

@@ -779,6 +779,9 @@ export { getEventLeaderboard } from "./features/events/server";
 // getEventPollResults - Helper for get event poll results (per-option vote tally).
 export { getEventPollResults } from "./features/events/server";
 // [SERVER-ONLY]-Server-only — uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
+// getEventSpinResults - Last N winning spins for a spin_wheel event, most recent first.
+export { getEventSpinResults } from "./features/events/server";
+// [SERVER-ONLY]-Server-only — uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // getBugHunterLeaderboard - Ranks testers by confirmed-bug count.
 export { getBugHunterLeaderboard } from "./features/tester/server";
 // [SERVER-ONLY]-Server-only — uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mohasinac/appkit",
-  "version": "4.9.1",
+  "version": "4.9.3",
   "license": "MIT",
   "publishConfig": {
     "access": "public"