@mohasinac/appkit 4.9.2 → 4.9.4

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/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/base.js

@@ -191,7 +191,18 @@ const TOKEN_TO_OP = {
     ">=": ">=",
     "@=": "array-contains",
 };
-/** Best-effort scalar coercion for sieve filter values. */
+/** Matches a bare `YYYY-MM-DD` date or a full ISO-8601 timestamp. */
+const ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:?\d{2})?)?$/;
+/**
+ * Best-effort scalar coercion for sieve filter values, used by the legacy
+ * `findAll()` query path (no `SieveFieldConfig`/`parseValue` mechanism
+ * exists here — see `./sieve.ts`'s `sieveQuery`/`applySieveToFirestore` for
+ * that). An ISO-date-shaped string is converted to a real `Date` so a range
+ * filter (`>`/`<`/`>=`/`<=`) on a Firestore Timestamp field compares
+ * correctly — without this, the string reaches `.where(field, op, value)`
+ * unchanged and Firestore's type-ordering silently matches ZERO documents
+ * (CLAUDE.md Recurrent Root Cause Pattern #47).
+ */
 function coerceValue(raw) {
     if (raw === "true")
         return true;
@@ -199,6 +210,11 @@ function coerceValue(raw) {
         return false;
     if (raw === "null")
         return null;
+    if (ISO_DATE_RE.test(raw)) {
+        const d = new Date(raw);
+        if (!Number.isNaN(d.getTime()))
+            return d;
+    }
     const n = Number(raw);
     if (!Number.isNaN(n) && raw !== "")
         return n;

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.2",
+  "version": "4.9.4",
   "license": "MIT",
   "publishConfig": {
     "access": "public"