@mohasinac/appkit 4.71.0 → 4.72.0

package/dist/_internal/server/features/stores/tabs.js

@@ -26,7 +26,6 @@ import { couponsRepository, reviewRepository } from "../../../../repositories/in
 import { ROUTES } from "../../../../next/routing/route-map.js";
 import { STORE_PAGE_TABS } from "../../../../features/products/constants/listing-tabs.js";
 import { isListingTypeEnabled, isCategoryTypeEnabled } from "../../../shared/listing-types/feature-flags.js";
-import { pluginFor } from "../../../shared/listing-types/_registry.js";
 import { listingTabCounts } from "../products/listing-tab-counts.js";
 function tabLabel(base, count) {
     if (!count)
@@ -45,16 +44,17 @@ function tabLabel(base, count) {
  */
 const STORE_LISTING_HREF = {
     products: (slug) => String(ROUTES.PUBLIC.STORE_PRODUCTS(slug)),
-    auctions: (slug) => String(ROUTES.PUBLIC.STORE_AUCTIONS(slug)),
+    "collector-drops": (slug) => String(ROUTES.PUBLIC.STORE_COLLECTOR_DROPS(slug)),
     "pre-orders": (slug) => String(ROUTES.PUBLIC.STORE_PRE_ORDERS(slug)),
-    "prize-draws": (slug) => String(ROUTES.PUBLIC.STORE_PRIZE_DRAWS(slug)),
+    "clearance": (slug) => String(ROUTES.PUBLIC.STORE_CLEARANCE(slug)),
     bundles: (slug) => String(ROUTES.PUBLIC.STORE_BUNDLES(slug)),
     classifieds: (slug) => String(ROUTES.PUBLIC.STORE_CLASSIFIEDS(slug)),
     "digital-codes": (slug) => String(ROUTES.PUBLIC.STORE_DIGITAL_CODES(slug)),
     live: (slug) => String(ROUTES.PUBLIC.STORE_LIVE(slug)),
-    // Combined art + stickers, mirroring the public /art page. This used to
-    // point at STORE_PRODUCTS, which filters to `standard` — so the tab showed
-    // a real non-zero count and landed on a page with none of those items.
+    // Art & Stickers, mirroring the public /art page. This used to point at
+    // STORE_PRODUCTS, which filters to `standard` — so the tab showed a real
+    // non-zero count and landed on a page with none of those items.
+    // Keyed on the `art` tabSlug, which 1.34 deliberately left unchanged.
     art: (slug) => String(ROUTES.PUBLIC.STORE_ART(slug)),
     spares: (slug) => String(ROUTES.PUBLIC.STORE_SPARES(slug)),
 };
@@ -79,11 +79,6 @@ export async function resolveStoreTabs(storeSlug, storeId, settings) {
             if (!isCategoryTypeEnabled("bundle", settings))
                 return false;
         }
-        else if (tab.id === pluginFor("art").tabSlug) {
-            // Combined tab — visible if either underlying listing type is enabled.
-            if (!(isListingTypeEnabled("art", settings) || isListingTypeEnabled("stickers", settings)))
-                return false;
-        }
         else if (tab.listingType) {
             if (!isListingTypeEnabled(tab.listingType, settings))
                 return false;

package/dist/_internal/server/features/widgets/widget-instances.d.ts

@@ -0,0 +1,34 @@
+import type { WidgetInstance } from "../../../../ui/widgets/types";
+/**
+ * Every stored instance for one region, ordered.
+ *
+ * `React.cache`-wrapped and keyed on `regionId` alone — the narrowest shared
+ * argument, same rule `getPageRegion`/`getFieldVisibility` follow. That is
+ * what makes it safe for a shared presentational component to call this per
+ * mount: seven listing-type detail views rendering the same region cost ONE
+ * read per request, not seven.
+ *
+ * Degrades to `[]` on a missing collection or any read failure, so a
+ * widget-config outage can never block a page from rendering — it falls back
+ * to the registry defaults, which is the pre-widget-system behaviour.
+ */
+export declare const getWidgetInstances: (regionId: string) => Promise<readonly WidgetInstance[]>;
+/**
+ * Replace the stored rows for one region.
+ *
+ * 🛑 A BATCHED delete-then-write of only this region's documents, never a
+ * collection-wide operation: the collection holds every region's rows, so an
+ * unscoped write would take out other regions. Scoped by the same
+ * `regionId ==` query the read uses, so the two cannot disagree about what
+ * "this region's rows" means.
+ *
+ * Whole-region replace rather than a per-row patch because the editor always
+ * holds the full current list client-side (the same shape `setPageRegion`
+ * uses), so there is no partial-update case and no merge for two editors to
+ * race. `order` is persisted explicitly rather than inferred from array
+ * position — array position is not a fact Firestore preserves across a
+ * per-document write.
+ */
+export declare function setWidgetInstances(regionId: string, instances: readonly WidgetInstance[]): Promise<void>;
+/** Remove one instance. Its children are NOT cascaded — the resolver reports them as `orphan-parent`, which is recoverable; a silent cascade is not. */
+export declare function deleteWidgetInstance(instanceId: string): Promise<void>;

package/dist/_internal/server/features/widgets/widget-instances.js

@@ -0,0 +1,169 @@
+/*
+ * WHY: Persistence for the widget system's instance table (lane W-WIDGET;
+ *      schema approved by the hub 2026-11-08). Mirrors
+ *      `_internal/server/features/dashboard/page-regions.ts` — same
+ *      `React.cache`-wrapped, `safeRead`-degrading read, same plain async
+ *      write, same "the id is a hand-chosen/minted stable string the caller
+ *      passes" identity rule. This is the THIRD occurrence of that pattern
+ *      (page regions, field visibility, widget instances), so under the Rule
+ *      of Three there is now a case for extracting a shared helper — flagged
+ *      rather than done, because the three differ in a way that matters: the
+ *      other two are DOCUMENT-per-id reads and this one is a COLLECTION QUERY
+ *      on `regionId`.
+ *
+ * WHY A COLLECTION AND NOT A `siteSettings` FIELD: `siteSettings` is a single
+ *      document that two lanes already write (`navConfig`,
+ *      `listings.requiredFields`), and a Firestore map write REPLACES rather
+ *      than merges — the exact failure `HomepageSectionsRepository` needed an
+ *      explicit `update` override to survive, where every omitted config key
+ *      was "silently deleted" behind an HTTP 200. The measured ceiling here is
+ *      ~5,210 keys (docs/overhaul/widget-architecture.md §12.2); at that size
+ *      a whole-map replace is a certainty, not a hazard. A collection also
+ *      makes orphan/cycle detection a query instead of a full-document scan.
+ *
+ * WHAT: `getWidgetInstances(regionId)` / `setWidgetInstances(regionId, rows)`
+ *       over the `widgetInstances` collection. One row per PLACED widget, doc
+ *       id = the minted `WidgetInstance.id`.
+ *
+ * 🛑 ABSENT MEANS TEMPLATE DEFAULT, NOT EMPTY. A region with no stored rows
+ *    renders its registry default (`RELATED_DEFAULT_INSTANCES` and friends),
+ *    which is what makes the whole cost model work: a default widget costs
+ *    ZERO config rows until somebody changes it, and a page with nothing
+ *    configured renders byte-identically to before the widget system existed.
+ *    `mergeStoredWithDefaults` in `ui/widgets/merge.ts` is where that is
+ *    applied — this module only answers "what is stored".
+ *
+ * EXPORTS: getWidgetInstances, setWidgetInstances, deleteWidgetInstance
+ *
+ * @tag domain:widgets
+ * @tag layer:server
+ * @tag pattern:none
+ * @tag access:server-only
+ * @tag consumers:RelatedItemsSection,widget-instances-route
+ * @tag sideEffects:firestore-read,firestore-write
+ */
+import { cache } from "react";
+import { getAdminDb } from "../../../../providers/db-firebase/index.js";
+import { safeRead } from "../../../../errors/safe-read.js";
+const WIDGET_INSTANCES_COLLECTION = "widgetInstances";
+const EMPTY = [];
+/**
+ * Normalise one stored row.
+ *
+ * 🛑 Defensive per FIELD rather than trusting the document, because a widget
+ * instance is admin/vendor-authored data and a single malformed row must not
+ * take a page region down. A row that cannot produce an `id` + `type` +
+ * `regionId` is DROPPED here rather than handed to the resolver, which would
+ * otherwise report it as `unknown-type` and make a storage problem look like
+ * a registry problem.
+ */
+function normalise(raw, fallbackRegionId) {
+    if (raw == null || typeof raw !== "object")
+        return null;
+    const d = raw;
+    const id = typeof d.id === "string" && d.id ? d.id : null;
+    const type = typeof d.type === "string" && d.type ? d.type : null;
+    if (!id || !type)
+        return null;
+    const regionId = typeof d.regionId === "string" && d.regionId ? d.regionId : fallbackRegionId;
+    const parentId = typeof d.parentId === "string" && d.parentId ? d.parentId : null;
+    const order = typeof d.order === "number" && Number.isFinite(d.order) ? d.order : 0;
+    const out = { id, type, regionId, parentId, order };
+    if (d.span === "full" || d.span === "pair" || d.span === "third" || d.span === "quarter") {
+        out.span = d.span;
+    }
+    // Absent `state` is the common case and MUST stay absent — it means
+    // "inherit the definition's default", which is a different fact from "off".
+    if (d.state === "on" || d.state === "off")
+        out.state = d.state;
+    if (d.config != null && typeof d.config === "object") {
+        out.config = d.config;
+    }
+    if (Array.isArray(d.contentTags)) {
+        out.contentTags = d.contentTags.filter((t) => t != null &&
+            typeof t === "object" &&
+            typeof t.value === "string" &&
+            ["listingType", "categoryType", "browsePage"].includes(String(t.governs)));
+    }
+    if (typeof d.templateId === "string")
+        out.templateId = d.templateId;
+    if (typeof d.templateVersion === "number")
+        out.templateVersion = d.templateVersion;
+    if (typeof d.templateSlot === "string")
+        out.templateSlot = d.templateSlot;
+    if (Array.isArray(d.aliases)) {
+        out.aliases = d.aliases.filter((a) => typeof a === "string");
+    }
+    return out;
+}
+/**
+ * Every stored instance for one region, ordered.
+ *
+ * `React.cache`-wrapped and keyed on `regionId` alone — the narrowest shared
+ * argument, same rule `getPageRegion`/`getFieldVisibility` follow. That is
+ * what makes it safe for a shared presentational component to call this per
+ * mount: seven listing-type detail views rendering the same region cost ONE
+ * read per request, not seven.
+ *
+ * Degrades to `[]` on a missing collection or any read failure, so a
+ * widget-config outage can never block a page from rendering — it falls back
+ * to the registry defaults, which is the pre-widget-system behaviour.
+ */
+export const getWidgetInstances = cache(async (regionId) => {
+    return safeRead(async () => {
+        const snap = await getAdminDb()
+            .collection(WIDGET_INSTANCES_COLLECTION)
+            .where("regionId", "==", regionId)
+            .get();
+        if (snap.empty)
+            return EMPTY;
+        const rows = [];
+        for (const doc of snap.docs) {
+            const row = normalise({ id: doc.id, ...doc.data() }, regionId);
+            if (row)
+                rows.push(row);
+        }
+        rows.sort((a, b) => a.order - b.order);
+        return rows;
+    }, {
+        route: "widget-instances",
+        key: `widget-instances:${regionId}`,
+        fallback: EMPTY,
+    });
+});
+/**
+ * Replace the stored rows for one region.
+ *
+ * 🛑 A BATCHED delete-then-write of only this region's documents, never a
+ * collection-wide operation: the collection holds every region's rows, so an
+ * unscoped write would take out other regions. Scoped by the same
+ * `regionId ==` query the read uses, so the two cannot disagree about what
+ * "this region's rows" means.
+ *
+ * Whole-region replace rather than a per-row patch because the editor always
+ * holds the full current list client-side (the same shape `setPageRegion`
+ * uses), so there is no partial-update case and no merge for two editors to
+ * race. `order` is persisted explicitly rather than inferred from array
+ * position — array position is not a fact Firestore preserves across a
+ * per-document write.
+ */
+export async function setWidgetInstances(regionId, instances) {
+    const db = getAdminDb();
+    const col = db.collection(WIDGET_INSTANCES_COLLECTION);
+    const existing = await col.where("regionId", "==", regionId).get();
+    const keep = new Set(instances.map((i) => i.id));
+    const batch = db.batch();
+    for (const doc of existing.docs) {
+        if (!keep.has(doc.id))
+            batch.delete(doc.ref);
+    }
+    for (const [index, inst] of instances.entries()) {
+        const { id, ...rest } = inst;
+        batch.set(col.doc(id), { ...rest, regionId, order: typeof inst.order === "number" ? inst.order : index, updatedAt: new Date() }, { merge: true });
+    }
+    await batch.commit();
+}
+/** Remove one instance. Its children are NOT cascaded — the resolver reports them as `orphan-parent`, which is recoverable; a silent cascade is not. */
+export async function deleteWidgetInstance(instanceId) {
+    await getAdminDb().collection(WIDGET_INSTANCES_COLLECTION).doc(instanceId).delete();
+}

package/dist/_internal/server/functions/define.d.ts

@@ -5,11 +5,11 @@
  * `trigger.kind` and the matching handler shape).
  *
  * Usage:
- *   export const auctionSettlement = defineFunction({
- *     name: "auctionSettlement",
- *     description: "Settle expired auctions and notify winners.",
+ *   export const collectorDropSettlement = defineFunction({
+ *     name: "collectorDropSettlement",
+ *     description: "Settle expired collector drops and notify winners.",
  *     trigger: { kind: "schedule", cron: "every 15 minutes" },
- *     handler: auctionSettlementHandler,
+ *     handler: collectorDropSettlementHandler,
  *     options: { timeoutSeconds: 300, memory: "256MiB" },
  *   });
  */

package/dist/_internal/server/functions/define.js

@@ -5,11 +5,11 @@
  * `trigger.kind` and the matching handler shape).
  *
  * Usage:
- *   export const auctionSettlement = defineFunction({
- *     name: "auctionSettlement",
- *     description: "Settle expired auctions and notify winners.",
+ *   export const collectorDropSettlement = defineFunction({
+ *     name: "collectorDropSettlement",
+ *     description: "Settle expired collector drops and notify winners.",
  *     trigger: { kind: "schedule", cron: "every 15 minutes" },
- *     handler: auctionSettlementHandler,
+ *     handler: collectorDropSettlementHandler,
  *     options: { timeoutSeconds: 300, memory: "256MiB" },
  *   });
  */

package/dist/_internal/server/functions/firestore.d.ts

@@ -14,8 +14,8 @@ export declare const onProductStockChange: import("./types").DocumentTriggerFunc
 }, {
     [x: string]: import("../../..").JsonValue;
 }>;
-export declare const onPrizeDrawPaymentConfirmed: import("./types").DocumentTriggerFunctionDefinition<import("../jobs/core/onPrizeDrawPaymentConfirmed").PrizeDrawOrderSnapshot, import("../jobs/core/onPrizeDrawPaymentConfirmed").PrizeDrawOrderSnapshot>;
-export declare const prizeDrawSoldOutReveal: import("./types").DocumentTriggerFunctionDefinition<import("../jobs/core/prizeDrawSoldOutReveal").PrizeDrawStockSnapshot, import("../jobs/core/prizeDrawSoldOutReveal").PrizeDrawStockSnapshot>;
+export declare const onClearancePaymentConfirmed: import("./types").DocumentTriggerFunctionDefinition<import("../jobs/core/onClearancePaymentConfirmed").ClearanceOrderSnapshot, import("../jobs/core/onClearancePaymentConfirmed").ClearanceOrderSnapshot>;
+export declare const clearanceSoldOutReveal: import("./types").DocumentTriggerFunctionDefinition<import("../jobs/core/clearanceSoldOutReveal").ClearanceStockSnapshot, import("../jobs/core/clearanceSoldOutReveal").ClearanceStockSnapshot>;
 export declare const onReviewWrite: import("./types").DocumentTriggerFunctionDefinition<Record<string, import("../../..").JsonValue>, Record<string, import("../../..").JsonValue>>;
 export declare const onCategoryWrite: import("./types").DocumentTriggerFunctionDefinition<import("../jobs").CategoryDoc, import("../jobs").CategoryDoc>;
 /**
@@ -71,7 +71,7 @@ export declare const FIRESTORE_TRIGGER_FUNCTIONS: readonly [import("./types").Do
     [x: string]: import("../../..").JsonValue;
 }, {
     [x: string]: import("../../..").JsonValue;
-}>, import("./types").DocumentTriggerFunctionDefinition<import("../jobs/core/onPrizeDrawPaymentConfirmed").PrizeDrawOrderSnapshot, import("../jobs/core/onPrizeDrawPaymentConfirmed").PrizeDrawOrderSnapshot>, import("./types").DocumentTriggerFunctionDefinition<import("../jobs/core/prizeDrawSoldOutReveal").PrizeDrawStockSnapshot, import("../jobs/core/prizeDrawSoldOutReveal").PrizeDrawStockSnapshot>, import("./types").DocumentTriggerFunctionDefinition<Record<string, import("../../..").JsonValue>, Record<string, import("../../..").JsonValue>>, import("./types").DocumentTriggerFunctionDefinition<import("../jobs").CategoryDoc, import("../jobs").CategoryDoc>, import("./types").DocumentTriggerFunctionDefinition<Record<string, import("../../..").JsonValue>, Record<string, import("../../..").JsonValue>>, import("./types").DocumentTriggerFunctionDefinition<import("../jobs").StoreDoc, import("../jobs").StoreDoc>, import("./types").DocumentTriggerFunctionDefinition<null, Record<string, import("../../..").JsonValue>>, import("./types").DocumentTriggerFunctionDefinition<Record<string, import("../../..").JsonValue>, Record<string, import("../../..").JsonValue>>, import("./types").DocumentTriggerFunctionDefinition<Record<string, import("../../..").JsonValue>, Record<string, import("../../..").JsonValue>>, import("./types").DocumentTriggerFunctionDefinition<null, Record<string, import("../../..").JsonValue>>, import("./types").DocumentTriggerFunctionDefinition<Record<string, import("../../..").JsonValue>, Record<string, import("../../..").JsonValue>>, import("./types").DocumentTriggerFunctionDefinition<{
+}>, import("./types").DocumentTriggerFunctionDefinition<import("../jobs/core/onClearancePaymentConfirmed").ClearanceOrderSnapshot, import("../jobs/core/onClearancePaymentConfirmed").ClearanceOrderSnapshot>, import("./types").DocumentTriggerFunctionDefinition<import("../jobs/core/clearanceSoldOutReveal").ClearanceStockSnapshot, import("../jobs/core/clearanceSoldOutReveal").ClearanceStockSnapshot>, import("./types").DocumentTriggerFunctionDefinition<Record<string, import("../../..").JsonValue>, Record<string, import("../../..").JsonValue>>, import("./types").DocumentTriggerFunctionDefinition<import("../jobs").CategoryDoc, import("../jobs").CategoryDoc>, import("./types").DocumentTriggerFunctionDefinition<Record<string, import("../../..").JsonValue>, Record<string, import("../../..").JsonValue>>, import("./types").DocumentTriggerFunctionDefinition<import("../jobs").StoreDoc, import("../jobs").StoreDoc>, import("./types").DocumentTriggerFunctionDefinition<null, Record<string, import("../../..").JsonValue>>, import("./types").DocumentTriggerFunctionDefinition<Record<string, import("../../..").JsonValue>, Record<string, import("../../..").JsonValue>>, import("./types").DocumentTriggerFunctionDefinition<Record<string, import("../../..").JsonValue>, Record<string, import("../../..").JsonValue>>, import("./types").DocumentTriggerFunctionDefinition<null, Record<string, import("../../..").JsonValue>>, import("./types").DocumentTriggerFunctionDefinition<Record<string, import("../../..").JsonValue>, Record<string, import("../../..").JsonValue>>, import("./types").DocumentTriggerFunctionDefinition<{
     [x: string]: import("../../..").JsonValue;
 }, {
     [x: string]: import("../../..").JsonValue;

package/dist/_internal/server/functions/firestore.js

@@ -6,7 +6,7 @@
  * The path patterns mirror the original `functions/src/index.ts` declarations
  * to preserve identical deploy behavior.
  */
-import { onCategoryWriteHandler, onOrderCreateHandler, onOrderStatusChangeHandler, onProductStockChangeHandler, onProductWriteHandler, onReviewWriteHandler, onScamReportCreateHandler, onScamReportUpdateHandler, onSiteSettingsWriteHandler, onStoreWriteHandler, onSupportTicketCreateHandler, onSupportTicketUpdateHandler, onUserBanChangeHandler, onShipmentItemWriteHandler, onShipmentLotWriteHandler, onShipmentHeaderWriteHandler, onShipmentDeletedHandler, onCatalogueSubmittedForApprovalHandler, onJobCreatedHandler, onPrizeDrawPaymentConfirmedHandler, prizeDrawSoldOutRevealHandler, } from "../jobs/handlers/index.js";
+import { onCategoryWriteHandler, onOrderCreateHandler, onOrderStatusChangeHandler, onProductStockChangeHandler, onProductWriteHandler, onReviewWriteHandler, onScamReportCreateHandler, onScamReportUpdateHandler, onSiteSettingsWriteHandler, onStoreWriteHandler, onSupportTicketCreateHandler, onSupportTicketUpdateHandler, onUserBanChangeHandler, onShipmentItemWriteHandler, onShipmentLotWriteHandler, onShipmentHeaderWriteHandler, onShipmentDeletedHandler, onCatalogueSubmittedForApprovalHandler, onJobCreatedHandler, onClearancePaymentConfirmedHandler, clearanceSoldOutRevealHandler, } from "../jobs/handlers/index.js";
 import { defineFunction } from "./define.js";
 const REGION = "asia-south1";
 export const onOrderCreate = defineFunction({
@@ -37,18 +37,27 @@ export const onProductStockChange = defineFunction({
     handler: onProductStockChangeHandler,
     options: { region: REGION },
 });
-export const onPrizeDrawPaymentConfirmed = defineFunction({
+export const onClearancePaymentConfirmed = defineFunction({
+    /*
+     * 🛑 `name` intentionally retains the old "PrizeDraw" spelling. `bindAllFromRegistry`
+     * keys `module.exports` off `def.name`, so this string IS the deployed Cloud Function
+     * name — renaming it would orphan the live function and create a second one beside it.
+     * The exported const, the handler symbol and the module path were renamed to
+     * clearance; only this identifier is frozen.
+     */
     name: "onPrizeDrawPaymentConfirmed",
-    description: "Instant-mode prize-draw winner assignment the moment an order's payment is confirmed.",
+    description: "Instant-mode clearance winner assignment the moment an order's payment is confirmed.",
     trigger: { kind: "documentUpdated", pathPattern: "orders/{orderId}" },
-    handler: onPrizeDrawPaymentConfirmedHandler,
+    handler: onClearancePaymentConfirmedHandler,
     options: { region: REGION },
 });
-export const prizeDrawSoldOutReveal = defineFunction({
+export const clearanceSoldOutReveal = defineFunction({
+    // 🛑 `name` intentionally retains the old "prizeDraw" spelling — it is the DEPLOYED
+    // Cloud Function name (see `onClearancePaymentConfirmed` above for the full reason).
     name: "prizeDrawSoldOutReveal",
-    description: "Assign winners for all outstanding prize-draw orders the moment a scheduled-mode draw sells out.",
+    description: "Assign winners for all outstanding clearance orders the moment a scheduled-mode draw sells out.",
     trigger: { kind: "documentWritten", pathPattern: "products/{productId}" },
-    handler: prizeDrawSoldOutRevealHandler,
+    handler: clearanceSoldOutRevealHandler,
     options: { region: REGION },
 });
 export const onReviewWrite = defineFunction({
@@ -184,8 +193,8 @@ export const FIRESTORE_TRIGGER_FUNCTIONS = [
     onOrderStatusChange,
     onProductWrite,
     onProductStockChange,
-    onPrizeDrawPaymentConfirmed,
-    prizeDrawSoldOutReveal,
+    onClearancePaymentConfirmed,
+    clearanceSoldOutReveal,
     onReviewWrite,
     onCategoryWrite,
     onSiteSettingsWrite,

package/dist/_internal/server/functions/https.js

@@ -89,7 +89,7 @@ export const listingProcessor = defineFunction({
 });
 export const triggerEventRaffle = defineFunction({
     name: "triggerEventRaffle",
-    description: "Admin-triggered raffle winner draw with crypto.randomInt.",
+    description: "Admin-triggered giveaway winner draw with crypto.randomInt.",
     trigger: { kind: "https" },
     handler: triggerEventRaffleHandler,
     options: {

package/dist/_internal/server/functions/scheduled.d.ts

@@ -1,4 +1,16 @@
-export declare const auctionSettlement: import("./types").ScheduledFunctionDefinition;
+/**
+ * 🛑 RENAMED from `auctionSettlement` in the collector-drop rename.
+ *
+ * `bindAllFromRegistry` does `out[def.name] = bindOne(def)`, so `name` IS the
+ * deployed Lambda key — renaming it DEPLOYS A NEW FUNCTION rather than moving
+ * the old one. **After the next `firebase deploy --only functions`, the old
+ * `auctionSettlement` function must be DELETED from the Firebase project by
+ * hand** (`firebase functions:delete auctionSettlement --region asia-south1`).
+ * Until it is, it keeps running on its own Cloud Scheduler job every 15
+ * minutes, settling the same collector drops a second time — two settlers for
+ * one collection, plus a second Scheduler job's standing cost.
+ */
+export declare const collectorDropSettlement: import("./types").ScheduledFunctionDefinition;
 export declare const pendingOrderTimeout: import("./types").ScheduledFunctionDefinition;
 export declare const paymentWindowTimeout: import("./types").ScheduledFunctionDefinition;
 export declare const hardBanReinstatement: import("./types").ScheduledFunctionDefinition;
@@ -6,6 +18,17 @@ export declare const paymentReviewAutoApprove: import("./types").ScheduledFuncti
 export declare const couponExpiry: import("./types").ScheduledFunctionDefinition;
 export declare const offerExpiry: import("./types").ScheduledFunctionDefinition;
 export declare const reservationExpiry: import("./types").ScheduledFunctionDefinition;
+/**
+ * 🛑 THE ONLY MECHANISM THAT NOTICES A CRASHED CLOUD FUNCTION.
+ *
+ * `stickerTraceCoordinator`/`stickerTraceTask` hard-kill at their
+ * `timeoutSeconds` ceiling without running `catch`/`finally` — so a run can
+ * leave `queued`/`running` with no terminal write and sit there forever, a
+ * gap `shard.ts` and `progress.ts` both document from the inside ("nothing
+ * sweeps it"). 20 minutes is generous above the coordinator's 540s and a
+ * shard's 300s ceilings combined with fan-out — not a tight SLA.
+ */
+export declare const stickerTraceSweep: import("./types").ScheduledFunctionDefinition;
 export declare const productStatsSync: import("./types").ScheduledFunctionDefinition;
 /**
  * Seller standing — MONTHLY, on the last day of the month.
@@ -111,8 +134,8 @@ export declare const cleanupRtdbEvents: import("./types").ScheduledFunctionDefin
 export declare const mediaTmpCleanup: import("./types").ScheduledFunctionDefinition;
 export declare const draftPrune: import("./types").ScheduledFunctionDefinition;
 export declare const testDataCleanup: import("./types").ScheduledFunctionDefinition;
-export declare const prizeDrawExpiryReveal: import("./types").ScheduledFunctionDefinition;
+export declare const clearanceExpiryReveal: import("./types").ScheduledFunctionDefinition;
 export declare const bundleStockSync: import("./types").ScheduledFunctionDefinition;
 export declare const emiInstallmentReminder: import("./types").ScheduledFunctionDefinition;
 export declare const catalogueImageStalenessReminder: import("./types").ScheduledFunctionDefinition;
-export declare const SCHEDULED_FUNCTIONS: readonly [import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition];
+export declare const SCHEDULED_FUNCTIONS: readonly [import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition];

package/dist/_internal/server/functions/scheduled.js

@@ -1,14 +1,26 @@
 // Scheduled function definitions (Cloud Scheduler triggers).
 // Cron syntax accepts both Firebase shorthand and standard cron expressions.
-import { auctionSettlementHandler, autoPayoutEligibilityHandler, bundleStockSyncHandler, cartPruneHandler, cleanupRtdbEventsHandler, countersReconcileHandler, boxRollupReconcileHandler, couponExpiryHandler, dailyDataCleanupHandler, draftPruneHandler, emiInstallmentReminderHandler, catalogueImageStalenessReminderHandler, mediaTmpCleanupHandler, notificationPruneHandler, offerExpiryHandler, reservationExpiryHandler, obligationSweepHandler, paymentReconcileHandler, paymentWindowTimeoutHandler, hardBanReinstatementHandler, paymentReviewAutoApproveHandler, pendingOrderTimeoutHandler, positionsReconcileHandler, prizeDrawExpiryRevealHandler, productStatsSyncHandler, revenueRollupHandler, sellerStandingRollupHandler, priceIndexRollupHandler, marketPriceRollupHandler, searchIndexBuildHandler, analyticsAlertEvaluateHandler, pageViewRollupHandler, pageViewPruneHandler, dailyStatusDigestHandler, weeklyPayoutEligibilityHandler, testDataCleanupHandler, } from "../jobs/handlers/index.js";
+import { collectorDropSettlementHandler, autoPayoutEligibilityHandler, bundleStockSyncHandler, cartPruneHandler, cleanupRtdbEventsHandler, countersReconcileHandler, boxRollupReconcileHandler, couponExpiryHandler, dailyDataCleanupHandler, draftPruneHandler, emiInstallmentReminderHandler, catalogueImageStalenessReminderHandler, mediaTmpCleanupHandler, notificationPruneHandler, stickerTraceSweepHandler, offerExpiryHandler, reservationExpiryHandler, obligationSweepHandler, paymentReconcileHandler, paymentWindowTimeoutHandler, hardBanReinstatementHandler, paymentReviewAutoApproveHandler, pendingOrderTimeoutHandler, positionsReconcileHandler, clearanceExpiryRevealHandler, productStatsSyncHandler, revenueRollupHandler, sellerStandingRollupHandler, priceIndexRollupHandler, marketPriceRollupHandler, searchIndexBuildHandler, analyticsAlertEvaluateHandler, pageViewRollupHandler, pageViewPruneHandler, dailyStatusDigestHandler, weeklyPayoutEligibilityHandler, testDataCleanupHandler, } from "../jobs/handlers/index.js";
 import { defineFunction } from "./define.js";
 const REGION = "asia-south1";
 const EVERY_5_MIN = "every 5 minutes";
-export const auctionSettlement = defineFunction({
-    name: "auctionSettlement",
-    description: "Settle expired auctions every 15 minutes and notify winners.",
+/**
+ * 🛑 RENAMED from `auctionSettlement` in the collector-drop rename.
+ *
+ * `bindAllFromRegistry` does `out[def.name] = bindOne(def)`, so `name` IS the
+ * deployed Lambda key — renaming it DEPLOYS A NEW FUNCTION rather than moving
+ * the old one. **After the next `firebase deploy --only functions`, the old
+ * `auctionSettlement` function must be DELETED from the Firebase project by
+ * hand** (`firebase functions:delete auctionSettlement --region asia-south1`).
+ * Until it is, it keeps running on its own Cloud Scheduler job every 15
+ * minutes, settling the same collector drops a second time — two settlers for
+ * one collection, plus a second Scheduler job's standing cost.
+ */
+export const collectorDropSettlement = defineFunction({
+    name: "collectorDropSettlement",
+    description: "Settle expired collector drops every 15 minutes and notify winners.",
     trigger: { kind: "schedule", cron: "every 15 minutes", timeZone: "UTC" },
-    handler: auctionSettlementHandler,
+    handler: collectorDropSettlementHandler,
     options: { region: REGION, timeoutSeconds: 300, memory: "256MiB", maxInstances: 1 },
 });
 export const pendingOrderTimeout = defineFunction({
@@ -145,6 +157,23 @@ export const reservationExpiry = defineFunction({
     handler: reservationExpiryHandler,
     options: { region: REGION, timeoutSeconds: 300, memory: "256MiB", maxInstances: 1 },
 });
+/**
+ * 🛑 THE ONLY MECHANISM THAT NOTICES A CRASHED CLOUD FUNCTION.
+ *
+ * `stickerTraceCoordinator`/`stickerTraceTask` hard-kill at their
+ * `timeoutSeconds` ceiling without running `catch`/`finally` — so a run can
+ * leave `queued`/`running` with no terminal write and sit there forever, a
+ * gap `shard.ts` and `progress.ts` both document from the inside ("nothing
+ * sweeps it"). 20 minutes is generous above the coordinator's 540s and a
+ * shard's 300s ceilings combined with fan-out — not a tight SLA.
+ */
+export const stickerTraceSweep = defineFunction({
+    name: "stickerTraceSweep",
+    description: "Fail sticker-trace runs stuck queued/running past 20 minutes with no terminal write.",
+    trigger: { kind: "schedule", cron: "every 15 minutes" },
+    handler: stickerTraceSweepHandler,
+    options: { region: REGION, timeoutSeconds: 120, memory: "256MiB", maxInstances: 1 },
+});
 export const productStatsSync = defineFunction({
     name: "productStatsSync",
     description: "Recompute aggregated product statistics (daily 01:00 UTC).",
@@ -403,7 +432,7 @@ export const boxRollupReconcile = defineFunction({
 });
 export const positionsReconcile = defineFunction({
     name: "positionsReconcile",
-    description: "Reconcile bid/auction positions (daily 03:30 UTC).",
+    description: "Reconcile bid/collector drop positions (daily 03:30 UTC).",
     trigger: { kind: "schedule", cron: "30 3 * * *", timeZone: "UTC" },
     handler: positionsReconcileHandler,
     options: { region: REGION, timeoutSeconds: 120, memory: "256MiB", maxInstances: 1 },
@@ -481,14 +510,21 @@ export const testDataCleanup = defineFunction({
 // REMOVED. The tester runner now owns fixture state — it seeds a known catalog at the
 // start of a run and wipes at the end — so a background job independently rewriting
 // those same documents was redundant and, worse, raced a run in progress: it reset
-// currentBid and recomputed auctionEndDate underneath a test that was mid-assertion.
+// currentBid and recomputed collectorDropEndDate underneath a test that was mid-assertion.
 // Do not reinstate it without also deciding who owns fixture state; two owners is the
 // bug it caused. See tester/scripts/lifecycle.mjs.
-export const prizeDrawExpiryReveal = defineFunction({
+export const clearanceExpiryReveal = defineFunction({
+    /*
+     * 🛑 `name` intentionally retains the old "prizeDraw" spelling. `bindAllFromRegistry`
+     * keys `module.exports` off `def.name`, so this string IS the deployed Cloud Function
+     * name and the Cloud Scheduler job behind it — renaming it would orphan both and
+     * create duplicates. Only the exported const, handler symbol and module path moved
+     * to the clearance spelling.
+     */
     name: "prizeDrawExpiryReveal",
-    description: "Assign winners for outstanding paid orders on scheduled-mode prize draws past their expiry, then close them (every 5 minutes).",
+    description: "Assign winners for outstanding paid orders on scheduled-mode clearance past their expiry, then close them (every 5 minutes).",
     trigger: { kind: "schedule", cron: EVERY_5_MIN },
-    handler: prizeDrawExpiryRevealHandler,
+    handler: clearanceExpiryRevealHandler,
     options: { region: REGION, timeoutSeconds: 300, memory: "256MiB", maxInstances: 1 },
 });
 export const bundleStockSync = defineFunction({
@@ -513,7 +549,7 @@ export const catalogueImageStalenessReminder = defineFunction({
     options: { region: REGION, timeoutSeconds: 300, memory: "256MiB", maxInstances: 1 },
 });
 export const SCHEDULED_FUNCTIONS = [
-    auctionSettlement,
+    collectorDropSettlement,
     pendingOrderTimeout,
     paymentWindowTimeout,
     hardBanReinstatement,
@@ -521,6 +557,7 @@ export const SCHEDULED_FUNCTIONS = [
     couponExpiry,
     offerExpiry,
     reservationExpiry,
+    stickerTraceSweep,
     productStatsSync,
     revenueRollup,
     sellerStandingRollup,
@@ -554,7 +591,7 @@ export const SCHEDULED_FUNCTIONS = [
     mediaTmpCleanup,
     draftPrune,
     testDataCleanup,
-    prizeDrawExpiryReveal,
+    clearanceExpiryReveal,
     bundleStockSync,
     emiInstallmentReminder,
     catalogueImageStalenessReminder,

package/dist/_internal/server/jobs/core/assignSpinPrize.js

@@ -30,6 +30,7 @@
 import crypto from "node:crypto";
 import { EVENT_ENTRY_FIELDS, EVENT_FIELDS, COMMON_FIELDS, } from "../../../../constants/field-names.js";
 import { resolveDate } from "../../../../utils/index.js";
+import { normalizeEventType } from "../../../../features/events/types/index.js";
 import { resolveEventRef } from "./_event-ref.js";
 import { EVENT_DRAW_REASON } from "./event-draw-reasons.js";
 const EVENT_ENTRIES_COLLECTION = "eventEntries";
@@ -69,7 +70,10 @@ export async function runAssignSpinPrize(input, ctx) {
      * answered 200 and awarded a prize. A redirect is navigation, not a
      * precondition.
      */
-    if (event.type && event.type !== EVENT_FIELDS.TYPE_VALUES.SPIN_WHEEL) {
+    // 🛑 `normalizeEventType`, not a bare `!==`: pre-2026-10-31 documents still
+    // hold `spin_wheel`, and refusing them would break every seeded spin event.
+    if (event.type &&
+        normalizeEventType(event.type) !== EVENT_FIELDS.TYPE_VALUES.BONUS_SPIN) {
         return { eventId, userId, reason: EVENT_DRAW_REASON.NOT_A_SPIN_WHEEL };
     }
     const endsAt = resolveDate(event.endsAt);

package/dist/_internal/server/jobs/core/autoPayoutEligibility.js

@@ -1,4 +1,4 @@
-import { orderRepository, payoutRepository, storeRepository, userRepository, siteSettingsRepository, } from "../../../../repositories/index.js";
+import { orderRepository, payoutRepository, storeRepository, userRepository, sellerProfileRepository, siteSettingsRepository, } from "../../../../repositories/index.js";
 import { getDefaultCurrency } from "../../../../core/baseline-resolver.js";
 import { computePayoutDeduction } from "../../../shared/fees/calculator.js";
 import { payoutCutoff } from "../../../shared/fees/payout-hold.js";
@@ -26,7 +26,7 @@ import { BATCH_LIMIT } from "../handlers/messages.js";
  * they did, and one of them had no cutoff at all.
  */
 export async function runAutoPayoutEligibility(ctx) {
-    // `FEATURE_PAYOUTS` gate deleted 2026-10-19 — see `auctionSettlement.ts`.
+    // `FEATURE_PAYOUTS` gate deleted 2026-10-19 — see `collectorDropSettlement.ts`.
     // This was the one flag actually set (`functions/.env.letitrip-in-app`), so
     // unlike its four siblings this job was running; removing the gate is a
     // no-op in behaviour and removes the lever that could silently stop payouts.
@@ -98,6 +98,8 @@ export async function runAutoPayoutEligibility(ctx) {
          * `revealUser` handles it explicitly.
          */
         const sellerPlain = userRepository.revealUser(seller);
+        const sellerProfile = await sellerProfileRepository.findById(store.ownerId);
+        const sellerProfilePlain = sellerProfile ? sellerProfileRepository.revealProfile(sellerProfile) : null;
         const sellerId = store.ownerId;
         /*
          * The TAXABLE VALUE — see `orderTaxableValue`. Two narrowings, both
@@ -147,11 +149,11 @@ export async function runAutoPayoutEligibility(ctx) {
             isAutomatic: true,
             currency: getDefaultCurrency(),
             status: "pending",
-            paymentMethod: sellerPlain.payoutDetails?.method === "upi"
+            paymentMethod: sellerProfilePlain?.payoutDetails?.method === "upi"
                 ? "upi"
                 : "bank_transfer",
-            upiId: sellerPlain.payoutDetails?.method === "upi"
-                ? sellerPlain.payoutDetails.upiId
+            upiId: sellerProfilePlain?.payoutDetails?.method === "upi"
+                ? sellerProfilePlain.payoutDetails.upiId
                 : undefined,
             /*
              * Only the MASKED account fields are copied, which is why this block
@@ -159,13 +161,13 @@ export async function runAutoPayoutEligibility(ctx) {
              * `ifscCode` and `bankName` are in no PII list. The real
              * `accountNumber` is deliberately not carried onto the payout.
              */
-            bankAccount: sellerPlain.payoutDetails?.method === "bank_transfer" &&
-                sellerPlain.payoutDetails.bankAccount
+            bankAccount: sellerProfilePlain?.payoutDetails?.method === "bank_transfer" &&
+                sellerProfilePlain.payoutDetails.bankAccount
                 ? {
-                    accountHolderName: sellerPlain.payoutDetails.bankAccount.accountHolderName,
-                    accountNumberMasked: sellerPlain.payoutDetails.bankAccount.accountNumberMasked,
-                    ifscCode: sellerPlain.payoutDetails.bankAccount.ifscCode,
-                    bankName: sellerPlain.payoutDetails.bankAccount.bankName,
+                    accountHolderName: sellerProfilePlain.payoutDetails.bankAccount.accountHolderName,
+                    accountNumberMasked: sellerProfilePlain.payoutDetails.bankAccount.accountNumberMasked,
+                    ifscCode: sellerProfilePlain.payoutDetails.bankAccount.ifscCode,
+                    bankName: sellerProfilePlain.payoutDetails.bankAccount.bankName,
                 }
                 : undefined,
             /*