@mohasinac/appkit 3.0.4 → 3.0.6

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

@@ -4,9 +4,9 @@
  */
 export declare const ADMIN_CHECKOUT_BYPASS_FLAG_KEY: "adminCheckoutBypass";
 export type NotificationType = "order_placed" | "order_confirmed" | "order_shipped" | "order_delivered" | "order_cancelled" | "bid_placed" | "bid_outbid" | "bid_won" | "bid_lost" | "review_approved" | "review_replied" | "product_available" | "promotion" | "system" | "welcome" | "account_action" | "offer_received" | "offer_responded" | "offer_expired" | "offer_counter_accepted" | "refund_initiated" | "prize_reveal_ready" | "prize_reveal_expired" | "prize_reveal_reminder";
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 export type NotificationPriority = "low" | "normal" | "high";
-export interface NotificationDocument {
-    id: string;
+export interface NotificationDocument extends BaseDocument {
     userId: string;
     type: NotificationType;
     priority: NotificationPriority;
@@ -19,8 +19,6 @@ export interface NotificationDocument {
     readAt?: Date;
     relatedId?: string;
     relatedType?: "order" | "product" | "bid" | "review" | "blog" | "user" | "offer" | "support_ticket" | "scammer";
-    createdAt: Date;
-    updatedAt: Date;
 }
 export declare const NOTIFICATIONS_COLLECTION: "notifications";
 export declare const NOTIFICATIONS_INDEXED_FIELDS: readonly ["userId", "isRead", "createdAt", "type"];
@@ -81,8 +79,7 @@ export declare const notificationQueryHelpers: {
     readonly unread: (userId: string) => readonly [readonly ["userId", "==", string], readonly ["isRead", "==", false]];
     readonly byType: (type: NotificationType) => readonly ["type", "==", NotificationType];
 };
-export interface ChatRoomDocument {
-    id: string;
+export interface ChatRoomDocument extends BaseDocument {
     buyerId: string;
     ownerId: string;
     orderId: string;
@@ -92,8 +89,6 @@ export interface ChatRoomDocument {
     ownerName: string;
     lastMessage?: string;
     lastMessageAt?: Date;
-    createdAt: Date;
-    updatedAt: Date;
     /** UIDs of participants who soft-deleted this room on their side. */
     deletedBy: string[];
     /** True for admin-created group chats (> 2 participants). */

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

@@ -2,6 +2,7 @@
  * Bids/Auctions Firestore Document Types & Constants
  */
 import { type GenerateBidIdInput } from "../../../utils/id-generators";
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 export type BidStatus = "active" | "outbid" | "won" | "lost" | "cancelled";
 /** Runtime-accessible bid status values — use instead of bare string literals. */
 export declare const BidStatusValues: {
@@ -11,8 +12,7 @@ export declare const BidStatusValues: {
     readonly LOST: "lost";
     readonly CANCELLED: "cancelled";
 };
-export interface BidDocument {
-    id: string;
+export interface BidDocument extends BaseDocument {
     productId: string;
     productTitle: string;
     userId: string;
@@ -25,8 +25,6 @@ export interface BidDocument {
     previousBidAmount?: number;
     bidDate: Date;
     autoMaxBid?: number;
-    createdAt: Date;
-    updatedAt: Date;
 }
 export declare const BID_COLLECTION: "bids";
 export declare const BID_INDEXED_FIELDS: readonly ["productId", "userId", "status", "isWinning", "bidDate", "createdAt"];

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

@@ -63,13 +63,13 @@ export declare const auctionItemSchema: z.ZodObject<{
     featured: boolean;
     listingType: "auction";
     createdAt: string;
-    id: string;
     title: string;
     slug: string;
     price: number;
     auctionEndDate: string;
     startingBid: number;
     bidCount: number;
+    id: string;
     updatedAt: string;
     sellerId: string;
     storeId?: string | undefined;
@@ -92,13 +92,13 @@ export declare const auctionItemSchema: z.ZodObject<{
     featured: boolean;
     listingType: "auction";
     createdAt: string;
-    id: string;
     title: string;
     slug: string;
     price: number;
     auctionEndDate: string;
     startingBid: number;
     bidCount: number;
+    id: string;
     updatedAt: string;
     sellerId: string;
     storeId?: string | undefined;

package/dist/features/before-after/schemas/index.d.ts

@@ -22,8 +22,8 @@ export declare const beforeAfterItemSchema: z.ZodObject<{
     sortOrder: z.ZodDefault<z.ZodNumber>;
     createdAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    id: string;
     title: string;
+    id: string;
     sortOrder: number;
     isActive: boolean;
     createdAt?: string | undefined;
@@ -34,8 +34,8 @@ export declare const beforeAfterItemSchema: z.ZodObject<{
     afterImageUrl?: string | undefined;
     durationWeeks?: number | undefined;
 }, {
-    id: string;
     title: string;
+    id: string;
     createdAt?: string | undefined;
     description?: string | undefined;
     sortOrder?: number | undefined;

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

@@ -3,14 +3,14 @@
  */
 import type { MediaFieldInput, MediaField } from "../../media/types";
 import type { BlogPostStatus, BlogPostCategory } from "../types";
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 /** Runtime-accessible blog post status values — use instead of bare string literals. */
 export declare const BlogPostStatusValues: {
     readonly DRAFT: BlogPostStatus;
     readonly PUBLISHED: BlogPostStatus;
     readonly ARCHIVED: BlogPostStatus;
 };
-export interface BlogPostDocument {
-    id: string;
+export interface BlogPostDocument extends BaseDocument {
     title: string;
     slug: string;
     excerpt: string;
@@ -30,8 +30,6 @@ export interface BlogPostDocument {
     views: number;
     metaTitle?: string;
     metaDescription?: string;
-    createdAt: Date;
-    updatedAt: Date;
 }
 export declare const BLOG_POSTS_COLLECTION: "blogPosts";
 export declare const BLOG_POSTS_INDEXED_FIELDS: readonly ["status", "publishedAt", "isFeatured", "category", "slug"];

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

@@ -111,10 +111,10 @@ export declare const blogPostFirestoreSchema: z.ZodObject<{
     createdAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    id: string;
     title: string;
     slug: string;
     tags: string[];
+    id: string;
     updatedAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
@@ -161,10 +161,10 @@ export declare const blogPostFirestoreSchema: z.ZodObject<{
     createdAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    id: string;
     title: string;
     slug: string;
     tags: string[];
+    id: string;
     updatedAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
@@ -331,9 +331,9 @@ export declare const blogPostSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     status: "draft" | "published" | "archived";
     category: "news" | "tips" | "guides" | "updates" | "community";
-    id: string;
     title: string;
     slug: string;
+    id: string;
     coverImage: {
         url: string;
         type: "image" | "video" | "file";
@@ -378,9 +378,9 @@ export declare const blogPostSchema: z.ZodObject<{
 }, {
     status: "draft" | "published" | "archived";
     category: "news" | "tips" | "guides" | "updates" | "community";
-    id: string;
     title: string;
     slug: string;
+    id: string;
     createdAt?: string | undefined;
     tags?: string[] | undefined;
     updatedAt?: string | undefined;

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

@@ -4,6 +4,7 @@
  * Canonical Firestore document interfaces, collection names, field constants
  * for the cart feature.
  */
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 export interface CartItemDocument {
     itemId: string;
     productId: string;
@@ -66,16 +67,13 @@ export interface CartAppliedCoupon {
     /** Mirrors CouponDocument.restrictions.combineWithSellerCoupons — used for conflict detection when adding future coupons */
     combineWithSellerCoupons?: boolean;
 }
-export interface CartDocument {
-    id: string;
+export interface CartDocument extends BaseDocument {
     userId: string;
     items: CartItemDocument[];
     /** Multiple coupons/deals applied at cart level */
     appliedCoupons?: CartAppliedCoupon[];
     /** Item IDs the user has selected for the next checkout (undefined = all items) */
     selectedItemIds?: string[];
-    createdAt: Date;
-    updatedAt: Date;
 }
 export declare const CART_COLLECTION: "carts";
 export declare const CART_INDEXED_FIELDS: string[];

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

@@ -5,6 +5,7 @@
  * and hierarchy helpers for the categories feature.
  */
 import type { CategoryAncestor, CategoryMetrics, CategoryDisplay } from "../types";
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 export type { CategoryAncestor, CategoryMetrics };
 /**
  * How a bundle resolves its member products.
@@ -77,8 +78,7 @@ export interface CategoryDocumentMetrics {
     totalItemCount: number;
     lastUpdated: Date;
 }
-export interface CategoryDocument {
-    id: string;
+export interface CategoryDocument extends BaseDocument {
     name: string;
     slug: string;
     description?: string;
@@ -159,8 +159,6 @@ export interface CategoryDocument {
     createdByStoreId?: string;
     /** Display name of the store that requested this category. */
     createdByStoreName?: string;
-    createdAt: Date;
-    updatedAt: Date;
     ancestors: CategoryAncestor[];
 }
 export declare const CATEGORIES_COLLECTION: "categories";

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

@@ -370,8 +370,8 @@ export declare const categoryFirestoreSchema: z.ZodObject<{
     createdAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    id: string;
     slug: string;
+    id: string;
     updatedAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
@@ -464,8 +464,8 @@ export declare const categoryFirestoreSchema: z.ZodObject<{
     createdAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    id: string;
     slug: string;
+    id: string;
     updatedAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
@@ -669,8 +669,8 @@ export declare const categoryItemSchema: z.ZodObject<{
     createdAt: z.ZodOptional<z.ZodString>;
     updatedAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    id: string;
     slug: string;
+    id: string;
     name: string;
     tier: number;
     type?: "category" | "brand" | "collection" | "concern" | undefined;
@@ -702,8 +702,8 @@ export declare const categoryItemSchema: z.ZodObject<{
         lastUpdated?: string | undefined;
     } | undefined;
 }, {
-    id: string;
     slug: string;
+    id: string;
     name: string;
     tier: number;
     type?: "category" | "brand" | "collection" | "concern" | undefined;

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

@@ -3,11 +3,11 @@
  */
 import type { MediaField } from "../../media/types";
 import type { JsonValue } from "@mohasinac/appkit";
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 import type { EventType, EventStatus, EntryReviewStatus, SaleConfig, OfferConfig, PollConfig, SurveyConfig, FeedbackConfig, RaffleType, SpinPrize } from "../types";
 export declare const EVENTS_COLLECTION: "events";
 export declare const EVENT_ENTRIES_COLLECTION: "eventEntries";
-export interface EventDocument {
-    id: string;
+export interface EventDocument extends BaseDocument {
     slug?: string;
     type: EventType;
     title: string;
@@ -48,8 +48,6 @@ export interface EventDocument {
         flaggedEntries: number;
     };
     createdBy: string;
-    createdAt: Date;
-    updatedAt: Date;
 }
 export interface EventEntryDocument {
     id: string;

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

@@ -266,9 +266,9 @@ export declare const eventItemSchema: z.ZodObject<{
     status: "draft" | "ended" | "active" | "paused";
     type: "offer" | "feedback" | "sale" | "poll" | "survey";
     createdAt: string;
-    id: string;
     title: string;
     description: string;
+    id: string;
     updatedAt: string;
     stats: {
         totalEntries: number;
@@ -337,9 +337,9 @@ export declare const eventItemSchema: z.ZodObject<{
     status: "draft" | "ended" | "active" | "paused";
     type: "offer" | "feedback" | "sale" | "poll" | "survey";
     createdAt: string;
-    id: string;
     title: string;
     description: string;
+    id: string;
     updatedAt: string;
     stats: {
         totalEntries: number;

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

@@ -3,13 +3,13 @@
  */
 import type { FAQCategory, FAQAnswer, FAQStats } from "../types";
 export type { FAQCategory, FAQAnswer, FAQStats } from "../types";
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 export interface FAQSEO {
     slug: string;
     metaTitle?: string;
     metaDescription?: string;
 }
-export interface FAQDocument {
-    id: string;
+export interface FAQDocument extends BaseDocument {
     question: string;
     answer: FAQAnswer;
     category: FAQCategory;
@@ -29,8 +29,6 @@ export interface FAQDocument {
     seo: FAQSEO;
     isActive: boolean;
     createdBy: string;
-    createdAt: Date;
-    updatedAt: Date;
 }
 export declare const FAQS_COLLECTION: "faqs";
 export declare const FAQS_INDEXED_FIELDS: readonly ["slug", "seo.slug", "category", "order", "showOnHomepage", "showInFooter", "isPinned", "priority", "tags", "searchTokens", "isActive", "stats.helpful", "createdBy", "createdAt"];

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

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

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

@@ -37,9 +37,9 @@ export declare const groupedListingFirestoreSchema: z.ZodObject<{
     createdAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    id: string;
     title: string;
     slug: string;
+    id: string;
     updatedAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
@@ -60,9 +60,9 @@ export declare const groupedListingFirestoreSchema: z.ZodObject<{
     createdAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    id: string;
     title: string;
     slug: string;
+    id: string;
     updatedAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;

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

@@ -2,6 +2,7 @@
  * Homepage Feature Firestore Document Types & Constants
  * Covers: carousel slides, homepage sections
  */
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 /** Unified background for a slide or card — supports image, video, solid color, or gradient. */
 export interface CarouselBackground {
     type: "image" | "video" | "color" | "gradient";
@@ -63,14 +64,11 @@ export interface CarouselCard {
 }
 export type GridCardCreateInput = Omit<CarouselCard, "id">;
 /** A named carousel that holds up to MAX_SLIDES_PER_CAROUSEL slide references. */
-export interface CarouselDocument {
-    id: string;
+export interface CarouselDocument extends BaseDocument {
     name: string;
     status: "active" | "draft";
     /** Ordered slide IDs (max MAX_SLIDES_PER_CAROUSEL). */
     slideIds: string[];
-    createdAt: Date;
-    updatedAt: Date;
     createdBy: string;
 }
 export type CarouselCreateInput = Omit<CarouselDocument, "id" | "createdAt" | "updatedAt">;
@@ -78,8 +76,7 @@ export type CarouselUpdateInput = Partial<Pick<CarouselDocument, "name" | "statu
 export declare class TooManySlidesError extends Error {
     constructor();
 }
-export interface CarouselSlideDocument {
-    id: string;
+export interface CarouselSlideDocument extends BaseDocument {
     /**
      * Reference to a named CarouselDocument (EX2).
      * null = default hero carousel (backward-compat with pre-EX2 slides).
@@ -131,8 +128,6 @@ export interface CarouselSlideDocument {
         views: number;
         lastViewed?: Date;
     };
-    createdAt: Date;
-    updatedAt: Date;
     createdBy: string;
 }
 export declare const CAROUSEL_SLIDES_COLLECTION: "carouselSlides";
@@ -552,14 +547,11 @@ export interface GoogleReviewsSectionConfig {
 }
 export type SectionType = "welcome" | "carousel" | "stats" | "trust-indicators" | "categories" | "brands" | "products" | "pre-orders" | "auctions" | "banner" | "features" | "reviews" | "whatsapp-community" | "faq" | "blog-articles" | "newsletter" | "stores" | "events" | "social-feed" | "custom-cards" | "google-reviews" | "featured-bundles" | "prize-draws" | "event-raffles" | "collection-cards";
 export type SectionConfig = CarouselSectionConfig | WelcomeSectionConfig | StatsSectionConfig | TrustIndicatorsSectionConfig | CategoriesSectionConfig | BrandsSectionConfig | ProductsSectionConfig | PreOrdersSectionConfig | AuctionsSectionConfig | BannerSectionConfig | FeaturesSectionConfig | ReviewsSectionConfig | WhatsAppCommunitySectionConfig | FAQSectionConfig | BlogArticlesSectionConfig | NewsletterSectionConfig | StoresSectionConfig | EventsSectionConfig | SocialFeedSectionConfig | CustomCardsSectionConfig | GoogleReviewsSectionConfig | FeaturedBundlesSectionConfig | PrizeDrawsSectionConfig | EventRafflesSectionConfig | CollectionCardsSectionConfig;
-export interface HomepageSectionDocument {
-    id: string;
+export interface HomepageSectionDocument extends BaseDocument {
     type: SectionType;
     order: number;
     enabled: boolean;
     config: SectionConfig;
-    createdAt: Date;
-    updatedAt: Date;
 }
 export declare const HOMEPAGE_SECTIONS_COLLECTION: "homepageSections";
 export declare const HOMEPAGE_SECTIONS_INDEXED_FIELDS: readonly ["enabled", "order", "type"];

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

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

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

@@ -5,6 +5,7 @@
  * Messages are embedded as an array for seed purposes; production can migrate to
  * a subcollection when the thread exceeds ~200 messages.
  */
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 export interface ConversationMessage {
     id: string;
     senderId: string;
@@ -14,8 +15,7 @@ export interface ConversationMessage {
     sentAt: Date;
     attachments?: string[];
 }
-export interface ConversationDocument {
-    id: string;
+export interface ConversationDocument extends BaseDocument {
     buyerId: string;
     buyerDisplayName: string;
     storeId: string;
@@ -29,8 +29,6 @@ export interface ConversationDocument {
     unreadBuyer: number;
     unreadSeller: number;
     status: "active" | "archived" | "blocked";
-    createdAt: Date;
-    updatedAt: Date;
 }
 export declare const CONVERSATIONS_COLLECTION: "conversations";
 export declare const CONVERSATIONS_INDEXED_FIELDS: readonly ["buyerId", "storeId", "productId", "status", "lastMessageAt", "createdAt"];

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

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

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

@@ -15,6 +15,11 @@ declare class OrderRepository extends BaseRepository<OrderDocument> {
     findConfirmed(): Promise<OrderDocument[]>;
     findPending(): Promise<OrderDocument[]>;
     updateStatus(orderId: string, status: OrderStatus, additionalData?: Partial<OrderDocument>): Promise<OrderDocument>;
+    assignWorker(orderId: string, workerId: string): Promise<OrderDocument>;
+    unassignWorker(orderId: string): Promise<OrderDocument>;
+    markPicked(orderId: string): Promise<OrderDocument>;
+    markPacked(orderId: string): Promise<OrderDocument>;
+    findFulfillmentQueue(storeId: string): Promise<OrderDocument[]>;
     updatePaymentStatus(orderId: string, paymentStatus: PaymentStatus, paymentId?: string): Promise<OrderDocument>;
     cancelOrder(orderId: string, reason: string, refundAmount?: number): Promise<OrderDocument>;
     findRecentByUser(userId: string): Promise<OrderDocument[]>;

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

@@ -71,6 +71,32 @@ class OrderRepository extends BaseRepository {
             updatedAt: new Date(),
         });
     }
+    async assignWorker(orderId, workerId) {
+        return this.update(orderId, { assignedWorkerId: workerId, updatedAt: new Date() });
+    }
+    async unassignWorker(orderId) {
+        return this.update(orderId, { assignedWorkerId: undefined, updatedAt: new Date() });
+    }
+    async markPicked(orderId) {
+        const order = await this.findById(orderId);
+        if (!order)
+            throw new NotFoundError(`Order ${orderId} not found`);
+        const nextStatus = order.status === "confirmed" ? "processing" : order.status;
+        return this.update(orderId, { pickedAt: new Date(), status: nextStatus, updatedAt: new Date() });
+    }
+    async markPacked(orderId) {
+        return this.update(orderId, { packedAt: new Date(), updatedAt: new Date() });
+    }
+    async findFulfillmentQueue(storeId) {
+        const snap = await this.db
+            .collection(this.collection)
+            .where(ORDER_FIELDS.STORE_ID, "==", storeId)
+            .where(ORDER_FIELDS.STATUS, "in", ["confirmed", "processing"])
+            .orderBy(ORDER_FIELDS.CREATED_AT, "asc")
+            .limit(200)
+            .get();
+        return snap.docs.map((doc) => this.decryptOrder({ id: doc.id, ...doc.data() }));
+    }
     async updatePaymentStatus(orderId, paymentStatus, paymentId) {
         return this.update(orderId, {
             paymentStatus,

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

@@ -3,6 +3,7 @@
  */
 import type { OrderStatus, PaymentStatus } from "../types";
 import type { OrderType } from "../utils/order-splitter";
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 export type ShippingMethod = "custom" | "shiprocket";
 export type RefundType = "full" | "partial";
 export type OrderPayoutStatus = "eligible" | "requested" | "paid";
@@ -99,8 +100,7 @@ export interface AppliedOrderDiscount {
     scope?: "admin" | "seller";
     storeId?: string;
 }
-export interface OrderDocument {
-    id: string;
+export interface OrderDocument extends BaseDocument {
     productId: string;
     productTitle: string;
     userId: string;
@@ -203,11 +203,15 @@ export interface OrderDocument {
         shelf: string;
         bin: string;
     };
-    createdAt: Date;
-    updatedAt: Date;
+    /** UID of the employee or seller assigned to fulfil this order. */
+    assignedWorkerId?: string;
+    /** Timestamp when all items in this order were physically confirmed picked. */
+    pickedAt?: Date;
+    /** Timestamp when the order was packed and ready for courier handoff. */
+    packedAt?: Date;
 }
 export declare const ORDER_COLLECTION: "orders";
-export declare const ORDER_INDEXED_FIELDS: readonly ["userId", "productId", "storeId", "status", "paymentStatus", "payoutStatus", "shippingMethod", "orderDate", "createdAt"];
+export declare const ORDER_INDEXED_FIELDS: readonly ["userId", "productId", "storeId", "status", "paymentStatus", "payoutStatus", "shippingMethod", "orderDate", "createdAt", "assignedWorkerId", "pickedAt", "packedAt"];
 export declare const DEFAULT_ORDER_DATA: Partial<OrderDocument>;
 export declare const ORDER_PUBLIC_FIELDS: readonly ["id", "productId", "productTitle", "quantity", "unitPrice", "totalPrice", "currency", "status", "paymentStatus", "shippingAddress", "trackingNumber", "notes", "orderDate", "shippingDate", "deliveryDate", "createdAt"];
 export declare const ORDER_UPDATABLE_FIELDS: readonly ["notes", "shippingAddress"];

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

@@ -54,6 +54,9 @@ export const ORDER_INDEXED_FIELDS = [
     "shippingMethod",
     "orderDate",
     "createdAt",
+    "assignedWorkerId",
+    "pickedAt",
+    "packedAt",
 ];
 export const DEFAULT_ORDER_DATA = {
     status: "pending",

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

@@ -2,6 +2,7 @@
  * Payouts Firestore Document Types & Constants
  */
 import { type GeneratePayoutIdInput } from "../../../utils/id-generators";
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 export interface PayoutBankAccount {
     accountHolderName: string;
     accountNumberMasked: string;
@@ -32,8 +33,7 @@ export declare const PayoutStatusValues: {
     readonly FAILED: "failed";
 };
 export type PayoutPaymentMethod = "bank_transfer" | "upi";
-export interface PayoutDocument {
-    id: string;
+export interface PayoutDocument extends BaseDocument {
     storeId: string;
     sellerName: string;
     sellerEmail: string;
@@ -66,8 +66,6 @@ export interface PayoutDocument {
     netAmount?: number;
     requestedAt: Date;
     processedAt?: Date;
-    createdAt: Date;
-    updatedAt: Date;
 }
 export declare const PAYOUT_COLLECTION: "payouts";
 export declare const PAYOUT_INDEXED_FIELDS: readonly ["storeId", "status", "requestedAt", "createdAt"];