@mohasinac/appkit 4.22.0 → 4.23.0

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

@@ -15,6 +15,7 @@
  *  - No new ticket in the same category while existing one is waiting_on_user
  */
 import type { BaseDocument } from "../../../_internal/shared/types/base-document";
+import type { StatusChangeEntry } from "../../../_internal/shared/history/types";
 export declare const TicketCategoryValues: {
     readonly ORDER_ISSUE: "order_issue";
     readonly BILLING_PAYMENT: "billing_payment";
@@ -101,11 +102,47 @@ export interface SupportTicketDocument extends BaseDocument {
     internalNotes?: string;
     /** Threaded conversation. Ordered by createdAt asc. */
     messages: TicketMessage[];
+    /**
+     * Stamped by the repository the first time `status` becomes `resolved` /
+     * `closed`. Both were declared, given `SUPPORT_TICKET_FIELDS` constants and
+     * listed in `SupportTicketUpdateInput` — and **nothing ever wrote either**
+     * (verified 2026-08-26), so no resolved ticket in the collection carries a
+     * resolution time and "how long do tickets take" has never been answerable.
+     *
+     * Server-stamped, never client-sent: the same discipline the reports route
+     * adopted after a client-sent `resolvedAt` arrived as a JSON string into a
+     * `Date` field and split the collection into two shapes.
+     */
     resolvedAt?: Date;
     closedAt?: Date;
+    /**
+     * Who changed what, when, and why. See § "Status History" in CLAUDE.md.
+     * Append-only, capped at STATUS_HISTORY_MAX, oldest evicted first.
+     */
+    statusHistory?: StatusChangeEntry[];
+    /** How many entries fell off the front. Never imply "this is all of it". */
+    statusHistoryTruncated?: number;
 }
+/**
+ * The fields whose changes earn a timeline entry.
+ *
+ * Explicit, not a whole-document diff: a diff would record the `updatedAt`
+ * bump on every write and exhaust the 50-entry cap within days. `messages` is
+ * excluded on purpose — the thread is already the conversation, and mirroring
+ * every reply into history would bury the handful of transitions anyone reads.
+ */
+export declare const SUPPORT_TICKET_TRACKED_FIELDS: readonly ["status", "priority", "assignedTo", "resolvedAt", "closedAt"];
+/**
+ * PII on this document, for `withHistory`'s scrub.
+ *
+ * `assignedToName` is a staff display name denormalised for the admin table —
+ * not the ticket author's identity — but it is still a person's name reaching
+ * an array `encryptPiiFields` cannot descend into, so history carries the UID
+ * (`assignedTo`) and never the name.
+ */
+export declare const SUPPORT_TICKET_PII_FIELDS: readonly ["userEmail", "userDisplayName", "assignedToName"];
 export type SupportTicketCreateInput = Pick<SupportTicketDocument, "userId" | "userEmail" | "userDisplayName" | "category" | "subject" | "description" | "orderId">;
-export type SupportTicketUpdateInput = Partial<Pick<SupportTicketDocument, "status" | "priority" | "assignedTo" | "assignedToName" | "internalNotes" | "resolvedAt" | "closedAt" | "relatedParties">>;
+export type SupportTicketUpdateInput = Partial<Pick<SupportTicketDocument, "status" | "priority" | "assignedTo" | "assignedToName" | "internalNotes" | "relatedParties">>;
 export declare const SUPPORT_TICKET_COLLECTION: "supportTickets";
 export declare const SUPPORT_TICKET_ID_PREFIX: "ticket-";
 export declare const SUPPORT_TICKET_INDEXED_FIELDS: readonly ["userId", "status", "category", "priority", "assignedTo", "orderId", "createdAt", "updatedAt"];

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

@@ -63,6 +63,40 @@ export const ELIGIBLE_ORDER_STATUSES_FOR_TICKET = [
     "SHIPPED",
     "RETURN_REQUESTED",
 ];
+/**
+ * The fields whose changes earn a timeline entry.
+ *
+ * Explicit, not a whole-document diff: a diff would record the `updatedAt`
+ * bump on every write and exhaust the 50-entry cap within days. `messages` is
+ * excluded on purpose — the thread is already the conversation, and mirroring
+ * every reply into history would bury the handful of transitions anyone reads.
+ */
+export const SUPPORT_TICKET_TRACKED_FIELDS = [
+    "status",
+    "priority",
+    "assignedTo",
+    "resolvedAt",
+    "closedAt",
+];
+/**
+ * PII on this document, for `withHistory`'s scrub.
+ *
+ * `assignedToName` is a staff display name denormalised for the admin table —
+ * not the ticket author's identity — but it is still a person's name reaching
+ * an array `encryptPiiFields` cannot descend into, so history carries the UID
+ * (`assignedTo`) and never the name.
+ */
+export const SUPPORT_TICKET_PII_FIELDS = [
+    "userEmail",
+    "userDisplayName",
+    "assignedToName",
+];
+/*
+ * `resolvedAt` / `closedAt` are deliberately NOT in the update input. They are
+ * events, and the server is the only thing that knows when one happened —
+ * letting a client send them is how the reports collection ended up holding
+ * both Timestamps and ISO strings in one field.
+ */
 // ============================================================================
 // COLLECTION CONSTANTS
 // ============================================================================

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

@@ -182,6 +182,7 @@ export declare const supportTicketFirestoreSchema: z.ZodObject<{
     closedAt?: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
+    assignedToName?: string | undefined;
     relatedParties?: {
         storeId?: string | undefined;
         userId?: string | undefined;
@@ -189,7 +190,6 @@ export declare const supportTicketFirestoreSchema: z.ZodObject<{
         productId?: string | undefined;
         bidId?: string | undefined;
     } | undefined;
-    assignedToName?: string | undefined;
     internalNotes?: string | undefined;
 }, {
     status: "closed" | "open" | "resolved" | "in_progress" | "waiting_on_user";
@@ -225,6 +225,7 @@ export declare const supportTicketFirestoreSchema: z.ZodObject<{
     closedAt?: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
+    assignedToName?: string | undefined;
     relatedParties?: {
         storeId?: string | undefined;
         userId?: string | undefined;
@@ -232,7 +233,6 @@ export declare const supportTicketFirestoreSchema: z.ZodObject<{
         productId?: string | undefined;
         bidId?: string | undefined;
     } | undefined;
-    assignedToName?: string | undefined;
     internalNotes?: string | undefined;
 }>;
 export type SupportTicketFromSchema = z.infer<typeof supportTicketFirestoreSchema>;

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

@@ -1156,6 +1156,60 @@ const rawTesterChecklistItems = [
                     description: "The fix had to cover the update path as well as create — a create-only fix would mean the listing saved correctly and then lost its per-type block the first time anyone edited anything else (Root Cause #39).",
                     href: "/store/classified",
                 },
+                {
+                    key: "ticket-resolution-timestamp-stamped",
+                    label: "Resolving a support ticket records WHEN it was resolved",
+                    description: "`resolvedAt` and `closedAt` were declared on the document, had field-name constants, were listed in the update input — and nothing had ever written either (verified 2026-08-26), so no resolved ticket carried a resolution time. Move a ticket to Resolved, reopen it, and confirm the timeline shows a real date on that step. Re-save an unrelated field afterwards: the resolution time must NOT move forward.",
+                    href: "/admin/support-tickets",
+                },
+                {
+                    key: "payout-utr-actually-saves",
+                    label: "The UTR entered when marking a payout paid is still there on reload",
+                    description: "The mark-paid modal REQUIRES a transaction reference, the route declared it, its own test asserted it reached the action — and the action picked only status/adminNote/processedAt, so the UTR was dropped while the 200 echoed it back as if stored. Mark a payout paid with a reference, reload the payout, and confirm 'Transaction ref' shows it.",
+                    href: "/admin/payouts",
+                },
+                {
+                    key: "store-approval-makes-it-public",
+                    label: "Approving a pending store actually makes it visible on /stores",
+                    description: "`status` and `isPublic` are two distinct fields and public visibility gates on `isPublic`. The admin PATCH wrote `status` directly and never touched `isPublic`, so an approved store was active AND invisible with no error anywhere. Approve `store-blader-bazaar`, then open /stores and confirm it appears.",
+                    href: "/admin/stores",
+                },
+                {
+                    key: "store-timeline-shows-who-suspended",
+                    label: "A suspended store's page shows who suspended it, when, and why",
+                    description: "Previously recoverable only from /admin/audit-log, which a store owner can never see. Suspend a store with a reason, open its admin detail page, and confirm the History block names the admin, the time, and the reason.",
+                    href: "/admin/stores",
+                },
+                {
+                    key: "payout-failure-reasons-survive-retries",
+                    label: "A payout that failed twice shows BOTH reasons, not just the last",
+                    description: "`lastFailureReason` is overwritten by every retry, so the timeline is the only place earlier attempts survive. Also confirm the four dispatch fields (razorpayPayoutId, razorpayStatus, failureCount, lastFailureReason) render — they were written by the batch and UNDECLARED on the document until 2026-08-26, so nothing could safely surface them.",
+                    href: "/admin/payouts",
+                },
+                {
+                    key: "bid-timeline-explains-forfeited",
+                    label: "A forfeited bid says why it was forfeited",
+                    description: "Open a forfeited bid from /admin/bids. The History block must read 'Forfeited' with the system actor and the reason 'The 48-hour checkout window closed without payment.' A bid moves through more states than any record a buyer owns and every one of them happened inside a settlement batch with nothing recording it.",
+                    href: "/admin/bids",
+                },
+                {
+                    key: "catalogue-rejection-reason-survives",
+                    label: "A catalogue item rejected twice keeps both reasons",
+                    description: "`rejectionReason` holds only the last decision. Reject a submission, have the owner resubmit, reject again with a different reason — the approval modal's History block must show both, each with its own date.",
+                    href: "/admin/catalogue-approvals",
+                },
+                {
+                    key: "history-absent-renders-empty-not-invented",
+                    label: "A record created BEFORE history existed shows 'no recorded history', not a made-up date",
+                    description: "Never fabricate a timestamp. Open any store, payout or ticket that predates this feature: the History block must say there is none, NOT derive a step from `updatedAt` — 'last write of any kind' is not an event, and a made-up date makes the record lie.",
+                    href: "/admin/stores",
+                },
+                {
+                    key: "history-carries-no-pii",
+                    label: "No name or email appears anywhere in a record's History block",
+                    description: "`encryptPiiFields` is a flat top-level loop that never descends into arrays, so a PII value inside statusHistory would be stored in PLAINTEXT. Every entry shows a ROLE (Admin/System/Buyer/Store) and never a name. Check a payout (sellerEmail/upiId), a bid (userName/userEmail) and a scammer profile (built entirely of identifying details).",
+                    href: "/admin/payouts",
+                },
                 {
                     key: "form-errors-wait-for-first-submit",
                     label: "Opening the address form shows NO errors until you press Save",

package/dist/index.d.ts

@@ -2120,6 +2120,7 @@ export { SidebarLayout } from "./features/layout/index";
 export { TitleBar } from "./features/layout/index";
 export { TitleBarLayout } from "./features/layout/index";
 export { useBottomActions } from "./features/layout/index";
+export { RecordStatusTimeline } from "./features/status-history/index";
 export { useFormBottomActions } from "./features/layout/index";
 export { FormErrorList } from "./ui/forms";
 export { OverlayContext, useIsInsideOverlay } from "./ui/components/overlay-context";
@@ -3236,7 +3237,7 @@ export { getListingRule, getCategoryRule, pickOrderType, getSplitKey, runSyncPre
 export type { ListingCheckoutRule, CategoryCheckoutRule, CartItemProductPair, OrderItemInput, RefundPolicy, } from "./_internal/shared/checkout/rules";
 export { MEGABYTE, MAX_IMAGE_BYTES, MAX_PDF_BYTES, MAX_VIDEO_BYTES, MAX_LABEL, MAX_BYTES, ALLOWED_IMAGE_MIMES, ALLOWED_VIDEO_MIMES, ALLOWED_DOC_MIMES, ALLOWED_MIMES, ALLOWED_TYPES_LABEL, MIME_TO_EXT, PDF_MAGIC, VIDEO_CONVERSION_HINTS, classifyMime, isAllowedMime, maxBytesFor, getConversionHint, } from "./_internal/shared/media/limits";
 export type { MediaKind, AllowedImageMime, AllowedVideoMime, AllowedDocMime, AllowedMime, } from "./_internal/shared/media/limits";
-export { PRODUCT_FIELDS, PRODUCT_STATUS_TRANSITIONS, ORDER_FIELDS, REVIEW_FIELDS, BID_FIELDS, AD_FIELDS, BLOG_FIELDS, BRAND_FIELDS, WISHLIST_FIELDS, HISTORY_FIELDS, COUPON_USAGE_FIELDS, CONVERSATION_FIELDS, CAROUSEL_FIELDS, FAQ_FIELDS, HOMEPAGE_SECTION_FIELDS, SITE_SETTINGS_FIELDS, COMMON_FIELDS, OAUTH_STATE_VALUES, SCHEMA_DEFAULTS, } from "./constants/field-names";
+export { PRODUCT_FIELDS, PRODUCT_STATUS_TRANSITIONS, ORDER_FIELDS, REVIEW_FIELDS, BID_FIELDS, AD_FIELDS, AD_TRACKED_FIELDS, BLOG_FIELDS, BRAND_FIELDS, WISHLIST_FIELDS, HISTORY_FIELDS, COUPON_USAGE_FIELDS, CONVERSATION_FIELDS, CAROUSEL_FIELDS, FAQ_FIELDS, HOMEPAGE_SECTION_FIELDS, SITE_SETTINGS_FIELDS, COMMON_FIELDS, OAUTH_STATE_VALUES, SCHEMA_DEFAULTS, } from "./constants/field-names";
 export { SORT_DIR, sortBy } from "./constants/sort";
 export type { SortDirection } from "./constants/sort";
 export { TABLE_KEYS, VIEW_MODE } from "./constants/table-keys";
@@ -3297,3 +3298,5 @@ export { adminUserUpdateSchema, whatsappSettingsSchema, lotteryPullSchema, } fro
 export { siteSettingsFormSchema } from "./features/admin/schemas/site-settings-form";
 export { createReviewSchema as reviewSubmitSchema } from "./_internal/shared/features/reviews/schema";
 export { wishlistAddSchema } from "./schemas/api-routes";
+export { withHistory, buildHistoryEntry, appendHistoryEntry, diffTrackedFields, STATUS_HISTORY_MAX, } from "./_internal/shared/history/index";
+export type { StatusChangeEntry, SerialisedStatusChangeEntry, HistoryActor, HistoryActorRole, FieldChange, } from "./_internal/shared/history/index";

package/dist/index.js

@@ -3934,6 +3934,7 @@ export { TitleBarLayout } from "./features/layout/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // useBottomActions - React hook for use bottom actions.
 export { useBottomActions } from "./features/layout/index";
+export { RecordStatusTimeline } from "./features/status-history/index";
 // useFormBottomActions - pins a form's Save/Cancel row + error sheet to the mobile bottom-chrome tier.
 export { useFormBottomActions } from "./features/layout/index";
 export { FormErrorList } from "./ui/forms";
@@ -5641,7 +5642,7 @@ export { MEGABYTE, MAX_IMAGE_BYTES, MAX_PDF_BYTES, MAX_VIDEO_BYTES, MAX_LABEL, M
 // NOTE: STORE_FIELDS, CATEGORY_FIELDS, EVENT_FIELDS, EVENT_ENTRY_FIELDS, PAYOUT_FIELDS,
 // COUPON_FIELDS, CART_FIELDS, USER_FIELDS, ADDRESS_FIELDS, NOTIFICATION_FIELDS,
 // SESSION_FIELDS, SCAMMER_FIELDS are already exported from feature barrels above.
-export { PRODUCT_FIELDS, PRODUCT_STATUS_TRANSITIONS, ORDER_FIELDS, REVIEW_FIELDS, BID_FIELDS, AD_FIELDS, BLOG_FIELDS, BRAND_FIELDS, WISHLIST_FIELDS, HISTORY_FIELDS, COUPON_USAGE_FIELDS, CONVERSATION_FIELDS, CAROUSEL_FIELDS, FAQ_FIELDS, HOMEPAGE_SECTION_FIELDS, SITE_SETTINGS_FIELDS, COMMON_FIELDS, OAUTH_STATE_VALUES, SCHEMA_DEFAULTS, } from "./constants/field-names";
+export { PRODUCT_FIELDS, PRODUCT_STATUS_TRANSITIONS, ORDER_FIELDS, REVIEW_FIELDS, BID_FIELDS, AD_FIELDS, AD_TRACKED_FIELDS, BLOG_FIELDS, BRAND_FIELDS, WISHLIST_FIELDS, HISTORY_FIELDS, COUPON_USAGE_FIELDS, CONVERSATION_FIELDS, CAROUSEL_FIELDS, FAQ_FIELDS, HOMEPAGE_SECTION_FIELDS, SITE_SETTINGS_FIELDS, COMMON_FIELDS, OAUTH_STATE_VALUES, SCHEMA_DEFAULTS, } from "./constants/field-names";
 // ── Sort helpers ──────────────────────────────────────────────────────────────
 export { SORT_DIR, sortBy } from "./constants/sort";
 // ── URL table keys + view mode ────────────────────────────────────────────────
@@ -5715,3 +5716,13 @@ export { siteSettingsFormSchema } from "./features/admin/schemas/site-settings-f
  */
 export { createReviewSchema as reviewSubmitSchema } from "./_internal/shared/features/reviews/schema";
 export { wishlistAddSchema } from "./schemas/api-routes";
+/*
+ * Status history — the generic primitive behind every entity timeline.
+ *
+ * `withHistory` is exported because ads have no repository of their own: they
+ * live inside the `siteSettings` singleton, so their route calls it directly.
+ * Every other adopter funnels through its repository's write primitives and
+ * should keep doing so — a call site reaching for this outside a repository
+ * is usually a missing funnel, not a reason to export more of it.
+ */
+export { withHistory, buildHistoryEntry, appendHistoryEntry, diffTrackedFields, STATUS_HISTORY_MAX, } from "./_internal/shared/history/index";

package/dist/schemas/registry.d.ts

@@ -1234,7 +1234,7 @@ export declare const SCHEMAS: {
             }, import("zod").ZodTypeAny, "passthrough"> | undefined;
             featuredPriority?: number | undefined;
             isBrand?: boolean | undefined;
-            createdByType?: "store" | "admin" | undefined;
+            createdByType?: "admin" | "store" | undefined;
             createdByStoreId?: string | undefined;
             itemCode?: string | undefined;
             brandWebsite?: string | undefined;
@@ -1333,7 +1333,7 @@ export declare const SCHEMAS: {
             }, import("zod").ZodTypeAny, "passthrough"> | undefined;
             featuredPriority?: number | undefined;
             isBrand?: boolean | undefined;
-            createdByType?: "store" | "admin" | undefined;
+            createdByType?: "admin" | "store" | undefined;
             createdByStoreId?: string | undefined;
             itemCode?: string | undefined;
             brandWebsite?: string | undefined;
@@ -1406,7 +1406,7 @@ export declare const SCHEMAS: {
                 }>;
             }, "strip", import("zod").ZodTypeAny, {
                 type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
-                scope: "admin" | "seller";
+                scope: "seller" | "admin";
                 name: string;
                 discount: {
                     value: number;
@@ -1425,7 +1425,7 @@ export declare const SCHEMAS: {
                 description?: string | undefined;
             }, {
                 type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
-                scope: "admin" | "seller";
+                scope: "seller" | "admin";
                 name: string;
                 discount: {
                     value: number;
@@ -1485,7 +1485,7 @@ export declare const SCHEMAS: {
             couponId: string;
             couponSnapshot: {
                 type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
-                scope: "admin" | "seller";
+                scope: "seller" | "admin";
                 name: string;
                 discount: {
                     value: number;
@@ -1525,7 +1525,7 @@ export declare const SCHEMAS: {
             couponId: string;
             couponSnapshot: {
                 type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
-                scope: "admin" | "seller";
+                scope: "seller" | "admin";
                 name: string;
                 discount: {
                     value: number;
@@ -1596,7 +1596,7 @@ export declare const SCHEMAS: {
                 body: string;
                 isRead: boolean;
                 senderId: string;
-                senderRole: "seller" | "buyer";
+                senderRole: "buyer" | "seller";
                 sentAt: string | Date | import("zod").objectOutputType<{
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough">;
@@ -1606,7 +1606,7 @@ export declare const SCHEMAS: {
                 body: string;
                 isRead: boolean;
                 senderId: string;
-                senderRole: "seller" | "buyer";
+                senderRole: "buyer" | "seller";
                 sentAt: string | Date | import("zod").objectInputType<{
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough">;
@@ -1644,7 +1644,7 @@ export declare const SCHEMAS: {
                 body: string;
                 isRead: boolean;
                 senderId: string;
-                senderRole: "seller" | "buyer";
+                senderRole: "buyer" | "seller";
                 sentAt: string | Date | import("zod").objectOutputType<{
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough">;
@@ -1677,7 +1677,7 @@ export declare const SCHEMAS: {
                 body: string;
                 isRead: boolean;
                 senderId: string;
-                senderRole: "seller" | "buyer";
+                senderRole: "buyer" | "seller";
                 sentAt: string | Date | import("zod").objectInputType<{
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough">;
@@ -1838,7 +1838,7 @@ export declare const SCHEMAS: {
             code: string;
             type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
             id: string;
-            scope: "admin" | "seller";
+            scope: "seller" | "admin";
             name: string;
             createdAt: string | Date | import("zod").objectOutputType<{
                 toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
@@ -1896,7 +1896,7 @@ export declare const SCHEMAS: {
             code: string;
             type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
             id: string;
-            scope: "admin" | "seller";
+            scope: "seller" | "admin";
             name: string;
             createdAt: string | Date | import("zod").objectInputType<{
                 toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
@@ -2372,14 +2372,14 @@ export declare const SCHEMAS: {
                 code: string;
                 type: "auto" | "coupon" | "deal";
                 discountAmount: number;
-                scope?: "admin" | "seller" | undefined;
+                scope?: "seller" | "admin" | undefined;
                 storeId?: string | undefined;
                 couponId?: string | undefined;
             }, {
                 code: string;
                 type: "auto" | "coupon" | "deal";
                 discountAmount: number;
-                scope?: "admin" | "seller" | undefined;
+                scope?: "seller" | "admin" | undefined;
                 storeId?: string | undefined;
                 couponId?: string | undefined;
             }>, "many">>;
@@ -2510,9 +2510,9 @@ export declare const SCHEMAS: {
                 overrideReason: import("zod").ZodOptional<import("zod").ZodString>;
             }, "strip", import("zod").ZodTypeAny, {
                 type: "full" | "partial";
+                reason: string;
                 amount: number;
                 refundId: string;
-                reason: string;
                 refundedAt: string | Date | import("zod").objectOutputType<{
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough">;
@@ -2525,9 +2525,9 @@ export declare const SCHEMAS: {
                 overrideReason?: string | undefined;
             }, {
                 type: "full" | "partial";
+                reason: string;
                 amount: number;
                 refundId: string;
-                reason: string;
                 refundedAt: string | Date | import("zod").objectInputType<{
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough">;
@@ -2668,7 +2668,7 @@ export declare const SCHEMAS: {
                 code: string;
                 type: "auto" | "coupon" | "deal";
                 discountAmount: number;
-                scope?: "admin" | "seller" | undefined;
+                scope?: "seller" | "admin" | undefined;
                 storeId?: string | undefined;
                 couponId?: string | undefined;
             }[] | undefined;
@@ -2700,9 +2700,9 @@ export declare const SCHEMAS: {
             paymentBatchId?: string | undefined;
             refunds?: {
                 type: "full" | "partial";
+                reason: string;
                 amount: number;
                 refundId: string;
-                reason: string;
                 refundedAt: string | Date | import("zod").objectOutputType<{
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough">;
@@ -2816,7 +2816,7 @@ export declare const SCHEMAS: {
                 code: string;
                 type: "auto" | "coupon" | "deal";
                 discountAmount: number;
-                scope?: "admin" | "seller" | undefined;
+                scope?: "seller" | "admin" | undefined;
                 storeId?: string | undefined;
                 couponId?: string | undefined;
             }[] | undefined;
@@ -2848,9 +2848,9 @@ export declare const SCHEMAS: {
             paymentBatchId?: string | undefined;
             refunds?: {
                 type: "full" | "partial";
+                reason: string;
                 amount: number;
                 refundId: string;
-                reason: string;
                 refundedAt: string | Date | import("zod").objectInputType<{
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough">;
@@ -2944,20 +2944,20 @@ export declare const SCHEMAS: {
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough">>]>;
             }, "strip", import("zod").ZodTypeAny, {
+                reason: string;
                 orderId: string;
                 refundId: string;
                 refundedAmount: number;
                 deductedAmount: number;
-                reason: string;
                 appliedAt: string | Date | import("zod").objectOutputType<{
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough">;
             }, {
+                reason: string;
                 orderId: string;
                 refundId: string;
                 refundedAmount: number;
                 deductedAmount: number;
-                reason: string;
                 appliedAt: string | Date | import("zod").objectInputType<{
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough">;
@@ -2999,6 +2999,9 @@ export declare const SCHEMAS: {
             platformFeeRate: number;
             paymentMethod: "bank_transfer" | "upi";
             orderIds: string[];
+            processedAt?: string | Date | import("zod").objectOutputType<{
+                toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
+            }, import("zod").ZodTypeAny, "passthrough"> | undefined;
             bankAccount?: {
                 accountHolderName: string;
                 accountNumberMasked: string;
@@ -3014,19 +3017,16 @@ export declare const SCHEMAS: {
             gstRate?: number | undefined;
             isAutomatic?: boolean | undefined;
             refundDeductions?: {
+                reason: string;
                 orderId: string;
                 refundId: string;
                 refundedAmount: number;
                 deductedAmount: number;
-                reason: string;
                 appliedAt: string | Date | import("zod").objectOutputType<{
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough">;
             }[] | undefined;
             netAmount?: number | undefined;
-            processedAt?: string | Date | import("zod").objectOutputType<{
-                toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
-            }, import("zod").ZodTypeAny, "passthrough"> | undefined;
         }, {
             currency: string;
             status: "paid" | "failed" | "pending" | "processing";
@@ -3049,6 +3049,9 @@ export declare const SCHEMAS: {
             platformFeeRate: number;
             paymentMethod: "bank_transfer" | "upi";
             orderIds: string[];
+            processedAt?: string | Date | import("zod").objectInputType<{
+                toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
+            }, import("zod").ZodTypeAny, "passthrough"> | undefined;
             bankAccount?: {
                 accountHolderName: string;
                 accountNumberMasked: string;
@@ -3064,19 +3067,16 @@ export declare const SCHEMAS: {
             gstRate?: number | undefined;
             isAutomatic?: boolean | undefined;
             refundDeductions?: {
+                reason: string;
                 orderId: string;
                 refundId: string;
                 refundedAmount: number;
                 deductedAmount: number;
-                reason: string;
                 appliedAt: string | Date | import("zod").objectInputType<{
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough">;
             }[] | undefined;
             netAmount?: number | undefined;
-            processedAt?: string | Date | import("zod").objectInputType<{
-                toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
-            }, import("zod").ZodTypeAny, "passthrough"> | undefined;
         }>;
         readonly reviews: import("zod").ZodObject<{
             createdAt: import("zod").ZodUnion<[import("zod").ZodDate, import("zod").ZodString, import("zod").ZodObject<{
@@ -4192,6 +4192,7 @@ export declare const SCHEMAS: {
             closedAt?: string | Date | import("zod").objectOutputType<{
                 toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
             }, import("zod").ZodTypeAny, "passthrough"> | undefined;
+            assignedToName?: string | undefined;
             relatedParties?: {
                 storeId?: string | undefined;
                 userId?: string | undefined;
@@ -4199,7 +4200,6 @@ export declare const SCHEMAS: {
                 productId?: string | undefined;
                 bidId?: string | undefined;
             } | undefined;
-            assignedToName?: string | undefined;
             internalNotes?: string | undefined;
         }, {
             status: "closed" | "open" | "resolved" | "in_progress" | "waiting_on_user";
@@ -4235,6 +4235,7 @@ export declare const SCHEMAS: {
             closedAt?: string | Date | import("zod").objectInputType<{
                 toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
             }, import("zod").ZodTypeAny, "passthrough"> | undefined;
+            assignedToName?: string | undefined;
             relatedParties?: {
                 storeId?: string | undefined;
                 userId?: string | undefined;
@@ -4242,7 +4243,6 @@ export declare const SCHEMAS: {
                 productId?: string | undefined;
                 bidId?: string | undefined;
             } | undefined;
-            assignedToName?: string | undefined;
             internalNotes?: string | undefined;
         }>;
     };

package/dist/seed/bids-seed-data.js

@@ -35,6 +35,14 @@ const BIDDER_NAMES = {
     "user-rohit-collector": "Mock User 14",
     "user-ananya-collector": "Mock User 9",
 };
+/*
+ * Typed on the document, not `FirestoreDocument`. Once `BidDocument` gained
+ * `statusHistory?: StatusChangeEntry[]`, `Partial<BidDocument>` stopped being
+ * assignable to `FirestoreDocument` — an array of objects does not satisfy
+ * that index signature. The right fix is to narrow the parameter to what the
+ * caller actually passes rather than widen the document to keep a helper
+ * happy.
+ */
 function withBidDefaults(b) {
     return {
         ...b,

package/package.json

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