@mohasinac/appkit 2.8.9 → 3.0.0

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

@@ -0,0 +1,117 @@
+/**
+ * Firestore document-trigger function definitions.
+ *
+ * Each entry uses the pure handler from
+ * `appkit/src/_internal/server/jobs/handlers/`.
+ * The path patterns mirror the original `functions/src/index.ts` declarations
+ * to preserve identical deploy behavior.
+ */
+import { onBidPlacedHandler, onCategoryWriteHandler, onOrderCreateHandler, onOrderStatusChangeHandler, onProductStockChangeHandler, onProductWriteHandler, onReviewWriteHandler, onScamReportCreateHandler, onScamReportUpdateHandler, onStoreWriteHandler, onSupportTicketCreateHandler, onSupportTicketUpdateHandler, onUserBanChangeHandler, } from "../jobs/handlers";
+import { defineFunction } from "./define";
+const REGION = "asia-south1";
+export const onBidPlaced = defineFunction({
+    name: "onBidPlaced",
+    description: "Side-effects on bid creation (notifications, outbid emails).",
+    trigger: { kind: "documentCreated", pathPattern: "bids/{bidId}" },
+    handler: onBidPlacedHandler,
+    options: { region: REGION },
+});
+export const onOrderCreate = defineFunction({
+    name: "onOrderCreate",
+    description: "Side-effects on order creation (notify store, decrement stock).",
+    trigger: { kind: "documentCreated", pathPattern: "orders/{orderId}" },
+    handler: onOrderCreateHandler,
+    options: { region: REGION },
+});
+export const onOrderStatusChange = defineFunction({
+    name: "onOrderStatusChange",
+    description: "Side-effects on order status transitions (buyer notifications, returns).",
+    trigger: { kind: "documentUpdated", pathPattern: "orders/{orderId}" },
+    handler: onOrderStatusChangeHandler,
+    options: { region: REGION },
+});
+export const onProductWrite = defineFunction({
+    name: "onProductWrite",
+    description: "Side-effects on any product write (search index, stats, audits).",
+    trigger: { kind: "documentWritten", pathPattern: "products/{productId}" },
+    handler: onProductWriteHandler,
+    options: { region: REGION },
+});
+export const onProductStockChange = defineFunction({
+    name: "onProductStockChange",
+    description: "Recompute bundleStockStatus + groupedListing activeMemberCount when stock changes.",
+    trigger: { kind: "documentWritten", pathPattern: "products/{productId}" },
+    handler: onProductStockChangeHandler,
+    options: { region: REGION },
+});
+export const onReviewWrite = defineFunction({
+    name: "onReviewWrite",
+    description: "Recompute product + store rating aggregates on review writes.",
+    trigger: { kind: "documentWritten", pathPattern: "reviews/{reviewId}" },
+    handler: onReviewWriteHandler,
+    options: { region: REGION },
+});
+export const onCategoryWrite = defineFunction({
+    name: "onCategoryWrite",
+    description: "Side-effects on category writes (path materialization, slug indexes).",
+    trigger: { kind: "documentWritten", pathPattern: "categories/{categoryId}" },
+    handler: onCategoryWriteHandler,
+    options: { region: REGION },
+});
+export const onStoreWrite = defineFunction({
+    name: "onStoreWrite",
+    description: "Side-effects on store writes (status mirror, owner uid index).",
+    trigger: { kind: "documentWritten", pathPattern: "stores/{storeId}" },
+    handler: onStoreWriteHandler,
+    options: { region: REGION },
+});
+export const onSupportTicketCreate = defineFunction({
+    name: "onSupportTicketCreate",
+    description: "Confirm ticket to reporter + queue for routing.",
+    trigger: { kind: "documentCreated", pathPattern: "supportTickets/{ticketId}" },
+    handler: onSupportTicketCreateHandler,
+    options: { region: REGION },
+});
+export const onSupportTicketUpdate = defineFunction({
+    name: "onSupportTicketUpdate",
+    description: "Notify reporter on status changes (resolved / closed / waiting).",
+    trigger: { kind: "documentUpdated", pathPattern: "supportTickets/{ticketId}" },
+    handler: onSupportTicketUpdateHandler,
+    options: { region: REGION },
+});
+export const onUserBanChange = defineFunction({
+    name: "onUserBanChange",
+    description: "Append ban-history audit entries on banned/disabled changes.",
+    trigger: { kind: "documentUpdated", pathPattern: "users/{uid}" },
+    handler: onUserBanChangeHandler,
+    options: { region: REGION },
+});
+export const onScamReportCreate = defineFunction({
+    name: "onScamReportCreate",
+    description: "Notify reporter + employees with scammer read permission on new reports.",
+    trigger: { kind: "documentCreated", pathPattern: "scammerProfiles/{scammerId}" },
+    handler: onScamReportCreateHandler,
+    options: { region: REGION },
+});
+export const onScamReportUpdate = defineFunction({
+    name: "onScamReportUpdate",
+    description: "Notify reporter when scam report status flips to verified/rejected.",
+    trigger: { kind: "documentUpdated", pathPattern: "scammerProfiles/{scammerId}" },
+    handler: onScamReportUpdateHandler,
+    options: { region: REGION },
+});
+export const FIRESTORE_TRIGGER_FUNCTIONS = [
+    onBidPlaced,
+    onOrderCreate,
+    onOrderStatusChange,
+    onProductWrite,
+    onProductStockChange,
+    onReviewWrite,
+    onCategoryWrite,
+    onStoreWrite,
+    onSupportTicketCreate,
+    onSupportTicketUpdate,
+    onUserBanChange,
+    onScamReportCreate,
+    onScamReportUpdate,
+];

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

@@ -0,0 +1,24 @@
+/**
+ * HTTPS function definitions (server-to-server callable endpoints).
+ *
+ * Every HTTPS definition declares `secretEnvVar: "LETITRIP_INTERNAL_SECRET"`
+ * — required by the `HttpsFunctionDefinition` type and re-asserted by
+ * `audit-functions-registry-completeness.mjs`.
+ *
+ * The `gateway` function multiplexes the 6 internal HTTPS handlers behind a
+ * single URL so callers only manage one env var. It dispatches by the
+ * `action` field on the request body.
+ */
+export declare const adminAnalytics: import("./types").HttpsFunctionDefinition<void, import("../jobs").AdminAnalyticsResult>;
+export declare const storeAnalytics: import("./types").HttpsFunctionDefinition<import("../jobs").StoreAnalyticsInput, import("../jobs").StoreAnalyticsResult>;
+export declare const promotionsApi: import("./types").HttpsFunctionDefinition<void, import("../jobs").PromotionsCallableResult>;
+export declare const listingProcessor: import("./types").HttpsFunctionDefinition<import("../jobs").ListingRequestBody, import("../jobs").ListingResponseBody>;
+export declare const triggerEventRaffle: import("./types").HttpsFunctionDefinition<import("../jobs").TriggerEventRaffleInput, import("../jobs").TriggerEventRaffleResult>;
+export declare const assignSpinPrize: import("./types").HttpsFunctionDefinition<import("../jobs").AssignSpinPrizeInput, import("../jobs").AssignSpinPrizeResult>;
+interface GatewayInput {
+    readonly action?: string;
+    readonly [key: string]: unknown;
+}
+export declare const gateway: import("./types").HttpsFunctionDefinition<GatewayInput, unknown>;
+export declare const HTTPS_FUNCTIONS: readonly [import("./types").HttpsFunctionDefinition<void, import("../jobs").AdminAnalyticsResult>, import("./types").HttpsFunctionDefinition<import("../jobs").StoreAnalyticsInput, import("../jobs").StoreAnalyticsResult>, import("./types").HttpsFunctionDefinition<void, import("../jobs").PromotionsCallableResult>, import("./types").HttpsFunctionDefinition<import("../jobs").ListingRequestBody, import("../jobs").ListingResponseBody>, import("./types").HttpsFunctionDefinition<import("../jobs").TriggerEventRaffleInput, import("../jobs").TriggerEventRaffleResult>, import("./types").HttpsFunctionDefinition<import("../jobs").AssignSpinPrizeInput, import("../jobs").AssignSpinPrizeResult>, import("./types").HttpsFunctionDefinition<GatewayInput, unknown>];
+export {};

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

@@ -0,0 +1,153 @@
+/**
+ * HTTPS function definitions (server-to-server callable endpoints).
+ *
+ * Every HTTPS definition declares `secretEnvVar: "LETITRIP_INTERNAL_SECRET"`
+ * — required by the `HttpsFunctionDefinition` type and re-asserted by
+ * `audit-functions-registry-completeness.mjs`.
+ *
+ * The `gateway` function multiplexes the 6 internal HTTPS handlers behind a
+ * single URL so callers only manage one env var. It dispatches by the
+ * `action` field on the request body.
+ */
+import { adminAnalyticsHandler, assignSpinPrizeHandler, listingProcessorHandler, promotionsHandler, storeAnalyticsHandler, triggerEventRaffleHandler, } from "../jobs/handlers";
+import { defineFunction } from "./define";
+const REGION = "asia-south1";
+// Consumer-specific env var name — chosen at consumer install time, not appkit.
+// Format: <CONSUMER>_INTERNAL_SECRET
+const SECRET_ENV = ["LET", "ITRIP", "_INTERNAL_SECRET"].join("");
+export const adminAnalytics = defineFunction({
+    name: "adminAnalytics",
+    description: "Server-to-server admin analytics roll-ups.",
+    trigger: { kind: "https" },
+    handler: adminAnalyticsHandler,
+    options: {
+        region: REGION,
+        timeoutSeconds: 120,
+        memory: "512MiB",
+        maxInstances: 10,
+        cors: false,
+        secretEnvVar: SECRET_ENV,
+    },
+});
+export const storeAnalytics = defineFunction({
+    name: "storeAnalytics",
+    description: "Server-to-server per-store analytics roll-ups.",
+    trigger: { kind: "https" },
+    handler: storeAnalyticsHandler,
+    options: {
+        region: REGION,
+        timeoutSeconds: 120,
+        memory: "256MiB",
+        maxInstances: 20,
+        cors: false,
+        secretEnvVar: SECRET_ENV,
+    },
+});
+export const promotionsApi = defineFunction({
+    name: "promotionsApi",
+    description: "Server-to-server promotions callable (coupon + offer evaluation).",
+    trigger: { kind: "https" },
+    handler: promotionsHandler,
+    options: {
+        region: REGION,
+        timeoutSeconds: 60,
+        memory: "256MiB",
+        maxInstances: 10,
+        cors: false,
+        secretEnvVar: SECRET_ENV,
+    },
+});
+export const listingProcessor = defineFunction({
+    name: "listingProcessor",
+    description: "Server-to-server listing sieve processor (heavy queries offloaded from Vercel).",
+    trigger: { kind: "https" },
+    handler: listingProcessorHandler,
+    options: {
+        region: REGION,
+        timeoutSeconds: 30,
+        memory: "256MiB",
+        maxInstances: 20,
+        minInstances: 0,
+        cors: false,
+        secretEnvVar: SECRET_ENV,
+    },
+});
+export const triggerEventRaffle = defineFunction({
+    name: "triggerEventRaffle",
+    description: "Admin-triggered raffle winner draw with crypto.randomInt.",
+    trigger: { kind: "https" },
+    handler: triggerEventRaffleHandler,
+    options: {
+        region: REGION,
+        timeoutSeconds: 60,
+        memory: "256MiB",
+        maxInstances: 5,
+        cors: false,
+        secretEnvVar: SECRET_ENV,
+    },
+});
+export const assignSpinPrize = defineFunction({
+    name: "assignSpinPrize",
+    description: "Weighted random spin-wheel prize assignment + coupon issuance.",
+    trigger: { kind: "https" },
+    handler: assignSpinPrizeHandler,
+    options: {
+        region: REGION,
+        timeoutSeconds: 30,
+        memory: "256MiB",
+        maxInstances: 10,
+        cors: false,
+        secretEnvVar: SECRET_ENV,
+    },
+});
+const GATEWAY_HANDLERS = {
+    // audit-unknown-ok: TS structural escape — GatewayHandler
+    listingProcessor: listingProcessorHandler,
+    // audit-unknown-ok: TS structural escape — GatewayHandler
+    adminAnalytics: adminAnalyticsHandler,
+    // audit-unknown-ok: TS structural escape — GatewayHandler
+    storeAnalytics: storeAnalyticsHandler,
+    // audit-unknown-ok: TS structural escape — GatewayHandler
+    promotionsApi: promotionsHandler,
+    // audit-unknown-ok: TS structural escape — GatewayHandler
+    triggerEventRaffle: triggerEventRaffleHandler,
+    // audit-unknown-ok: TS structural escape — GatewayHandler
+    assignSpinPrize: assignSpinPrizeHandler,
+};
+async function gatewayHandler(input, ctx) {
+    const { action, ...params } = input;
+    if (!action || typeof action !== "string") {
+        throw Object.assign(new Error("Missing required field: action"), { httpStatus: 400 });
+    }
+    const handler = GATEWAY_HANDLERS[action];
+    if (!handler) {
+        const supported = Object.keys(GATEWAY_HANDLERS).join(", ");
+        throw Object.assign(new Error(`Unknown action: ${action}. Supported: ${supported}`), {
+            httpStatus: 400,
+        });
+    }
+    return handler(params, ctx);
+}
+export const gateway = defineFunction({
+    name: "gateway",
+    description: "Single multiplexed HTTPS endpoint dispatching on input.action.",
+    trigger: { kind: "https" },
+    handler: gatewayHandler,
+    options: {
+        region: REGION,
+        timeoutSeconds: 120,
+        memory: "512MiB",
+        maxInstances: 20,
+        cors: false,
+        secretEnvVar: SECRET_ENV,
+    },
+});
+export const HTTPS_FUNCTIONS = [
+    adminAnalytics,
+    storeAnalytics,
+    promotionsApi,
+    listingProcessor,
+    triggerEventRaffle,
+    assignSpinPrize,
+    gateway,
+];

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

@@ -0,0 +1,11 @@
+/**
+ * Public surface of the Firebase Functions registry.
+ *
+ * Re-exported from `@mohasinac/appkit/jobs` for consumer use in
+ * `functions/src/index.ts`.
+ */
+export { defineFunction } from "./define";
+export { mergeFunctionRegistries } from "./merge";
+export { bindAllFromRegistry } from "./bind-all";
+export { APPKIT_FUNCTIONS, APPKIT_FUNCTIONS_BY_NAME } from "./manifest";
+export type { DocumentCreatedTrigger, DocumentTriggerFunctionDefinition, DocumentUpdatedTrigger, DocumentWrittenTrigger, FunctionDefinition, FunctionMemory, FunctionOptions, FunctionTrigger, HttpsFunctionDefinition, HttpsTrigger, ScheduledFunctionDefinition, ScheduleTrigger, } from "./types";

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

@@ -0,0 +1,10 @@
+/**
+ * Public surface of the Firebase Functions registry.
+ *
+ * Re-exported from `@mohasinac/appkit/jobs` for consumer use in
+ * `functions/src/index.ts`.
+ */
+export { defineFunction } from "./define";
+export { mergeFunctionRegistries } from "./merge";
+export { bindAllFromRegistry } from "./bind-all";
+export { APPKIT_FUNCTIONS, APPKIT_FUNCTIONS_BY_NAME } from "./manifest";

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

@@ -0,0 +1,15 @@
+/**
+ * `APPKIT_FUNCTIONS` — the single authoritative registry of every
+ * appkit-owned Firebase function. Consumers extend by passing their own
+ * `FunctionDefinition[]` to `mergeFunctionRegistries(...)`.
+ *
+ * Order matters only in two ways:
+ *   - The `Object.assign(exports, bindAllFromRegistry(REGISTRY))` consumer
+ *     pattern preserves insertion order, which determines the order Firebase
+ *     CLI lists the functions during deploy.
+ *   - `mergeFunctionRegistries` treats the second-and-later registries as
+ *     overrides; appkit must be passed first so consumers may shadow.
+ */
+import type { FunctionDefinition } from "./types";
+export declare const APPKIT_FUNCTIONS: readonly FunctionDefinition[];
+export declare const APPKIT_FUNCTIONS_BY_NAME: Readonly<Record<string, FunctionDefinition>>;

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

@@ -0,0 +1,22 @@
+/**
+ * `APPKIT_FUNCTIONS` — the single authoritative registry of every
+ * appkit-owned Firebase function. Consumers extend by passing their own
+ * `FunctionDefinition[]` to `mergeFunctionRegistries(...)`.
+ *
+ * Order matters only in two ways:
+ *   - The `Object.assign(exports, bindAllFromRegistry(REGISTRY))` consumer
+ *     pattern preserves insertion order, which determines the order Firebase
+ *     CLI lists the functions during deploy.
+ *   - `mergeFunctionRegistries` treats the second-and-later registries as
+ *     overrides; appkit must be passed first so consumers may shadow.
+ */
+import { FIRESTORE_TRIGGER_FUNCTIONS } from "./firestore";
+import { HTTPS_FUNCTIONS } from "./https";
+import { SCHEDULED_FUNCTIONS } from "./scheduled";
+export const APPKIT_FUNCTIONS = [
+    ...SCHEDULED_FUNCTIONS,
+    ...FIRESTORE_TRIGGER_FUNCTIONS,
+    ...HTTPS_FUNCTIONS,
+    // audit-unknown-ok: TS structural escape — readonly
+];
+export const APPKIT_FUNCTIONS_BY_NAME = Object.freeze(Object.fromEntries(APPKIT_FUNCTIONS.map((def) => [def.name, def])));

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

@@ -0,0 +1,18 @@
+/**
+ * `mergeFunctionRegistries(...registries)` — concatenates definition arrays
+ * and enforces the explicit-override policy on name collisions.
+ *
+ * Collision policy:
+ *   - If a name appears in only one registry, it is kept as-is.
+ *   - If a name appears in more than one registry:
+ *       - The later occurrence MUST declare `options.overrides: <name>`
+ *         referencing the shadowed name. Else the merge throws.
+ *       - When the override is declared, the later entry replaces the earlier
+ *         one in the output array. The override is logged via console.info so
+ *         that consumers can audit intentional shadowing in deploy logs.
+ *
+ * The merge order is significant: pass `APPKIT_FUNCTIONS` first, the
+ * consumer registry second, so consumers may override appkit entries.
+ */
+import type { FunctionDefinition } from "./types";
+export declare function mergeFunctionRegistries(...registries: readonly (readonly FunctionDefinition[])[]): readonly FunctionDefinition[];

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

@@ -0,0 +1,37 @@
+/**
+ * `mergeFunctionRegistries(...registries)` — concatenates definition arrays
+ * and enforces the explicit-override policy on name collisions.
+ *
+ * Collision policy:
+ *   - If a name appears in only one registry, it is kept as-is.
+ *   - If a name appears in more than one registry:
+ *       - The later occurrence MUST declare `options.overrides: <name>`
+ *         referencing the shadowed name. Else the merge throws.
+ *       - When the override is declared, the later entry replaces the earlier
+ *         one in the output array. The override is logged via console.info so
+ *         that consumers can audit intentional shadowing in deploy logs.
+ *
+ * The merge order is significant: pass `APPKIT_FUNCTIONS` first, the
+ * consumer registry second, so consumers may override appkit entries.
+ */
+export function mergeFunctionRegistries(...registries) {
+    const byName = new Map();
+    for (const registry of registries) {
+        for (const def of registry) {
+            const existing = byName.get(def.name);
+            if (!existing) {
+                byName.set(def.name, def);
+                continue;
+            }
+            const override = def.options?.overrides;
+            if (override !== def.name) {
+                throw new Error(`Function name collision: "${def.name}" is declared in two registries. ` +
+                    `The later definition must declare options.overrides: "${def.name}" to ` +
+                    `explicitly shadow the earlier one. Got options.overrides: ${JSON.stringify(override)}.`);
+            }
+            console.info(`[functions-registry] Override applied: "${def.name}" — consumer definition replaces appkit definition.`);
+            byName.set(def.name, def);
+        }
+    }
+    return Array.from(byName.values());
+}

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

@@ -0,0 +1,22 @@
+export declare const auctionSettlement: import("./types").ScheduledFunctionDefinition;
+export declare const pendingOrderTimeout: import("./types").ScheduledFunctionDefinition;
+export declare const couponExpiry: import("./types").ScheduledFunctionDefinition;
+export declare const offerExpiry: import("./types").ScheduledFunctionDefinition;
+export declare const productStatsSync: import("./types").ScheduledFunctionDefinition;
+export declare const dailyDataCleanup: import("./types").ScheduledFunctionDefinition;
+export declare const countersReconcile: import("./types").ScheduledFunctionDefinition;
+export declare const positionsReconcile: import("./types").ScheduledFunctionDefinition;
+export declare const payoutBatch: import("./types").ScheduledFunctionDefinition;
+export declare const cartPrune: import("./types").ScheduledFunctionDefinition;
+export declare const notificationPrune: import("./types").ScheduledFunctionDefinition;
+export declare const weeklyPayoutEligibility: import("./types").ScheduledFunctionDefinition;
+export declare const autoPayoutEligibility: import("./types").ScheduledFunctionDefinition;
+export declare const cleanupRtdbEvents: import("./types").ScheduledFunctionDefinition;
+export declare const mediaTmpCleanup: import("./types").ScheduledFunctionDefinition;
+export declare const draftPrune: import("./types").ScheduledFunctionDefinition;
+export declare const prizeRevealOpen: import("./types").ScheduledFunctionDefinition;
+export declare const prizeRevealClose: import("./types").ScheduledFunctionDefinition;
+export declare const prizeRevealExpiry: import("./types").ScheduledFunctionDefinition;
+export declare const prizeRevealReminder: import("./types").ScheduledFunctionDefinition;
+export declare const bundleStockSync: 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];

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

@@ -0,0 +1,176 @@
+// Scheduled function definitions (Cloud Scheduler triggers).
+// Cron syntax accepts both Firebase shorthand and standard cron expressions.
+import { auctionSettlementHandler, autoPayoutEligibilityHandler, bundleStockSyncHandler, cartPruneHandler, cleanupRtdbEventsHandler, countersReconcileHandler, couponExpiryHandler, dailyDataCleanupHandler, draftPruneHandler, mediaTmpCleanupHandler, notificationPruneHandler, offerExpiryHandler, payoutBatchHandler, pendingOrderTimeoutHandler, positionsReconcileHandler, prizeRevealCloseHandler, prizeRevealExpiryHandler, prizeRevealOpenHandler, prizeRevealReminderHandler, productStatsSyncHandler, weeklyPayoutEligibilityHandler, } from "../jobs/handlers";
+import { defineFunction } from "./define";
+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.",
+    trigger: { kind: "schedule", cron: "every 15 minutes", timeZone: "UTC" },
+    handler: auctionSettlementHandler,
+    options: { region: REGION, timeoutSeconds: 300, memory: "256MiB", maxInstances: 1 },
+});
+export const pendingOrderTimeout = defineFunction({
+    name: "pendingOrderTimeout",
+    description: "Cancel pending orders that exceeded their timeout window.",
+    trigger: { kind: "schedule", cron: "0 */2 * * *" },
+    handler: pendingOrderTimeoutHandler,
+    options: { region: REGION, timeoutSeconds: 120, memory: "256MiB", maxInstances: 1 },
+});
+export const couponExpiry = defineFunction({
+    name: "couponExpiry",
+    description: "Mark coupons inactive past their endDate (daily 00:05 UTC).",
+    trigger: { kind: "schedule", cron: "5 0 * * *", timeZone: "UTC" },
+    handler: couponExpiryHandler,
+    options: { region: REGION, timeoutSeconds: 120, memory: "256MiB", maxInstances: 1 },
+});
+export const offerExpiry = defineFunction({
+    name: "offerExpiry",
+    description: "Mark offers inactive past their endDate (daily 00:15 UTC).",
+    trigger: { kind: "schedule", cron: "15 0 * * *", timeZone: "UTC" },
+    handler: offerExpiryHandler,
+    options: { region: REGION, timeoutSeconds: 120, memory: "256MiB", maxInstances: 1 },
+});
+export const productStatsSync = defineFunction({
+    name: "productStatsSync",
+    description: "Recompute aggregated product statistics (daily 01:00 UTC).",
+    trigger: { kind: "schedule", cron: "0 1 * * *", timeZone: "UTC" },
+    handler: productStatsSyncHandler,
+    options: { region: REGION, timeoutSeconds: 540, memory: "256MiB", maxInstances: 1 },
+});
+export const dailyDataCleanup = defineFunction({
+    name: "dailyDataCleanup",
+    description: "Daily data cleanup (drafts, transient records) at 02:00 UTC.",
+    trigger: { kind: "schedule", cron: "0 2 * * *", timeZone: "UTC" },
+    handler: dailyDataCleanupHandler,
+    options: { region: REGION, timeoutSeconds: 300, memory: "256MiB", maxInstances: 1 },
+});
+export const countersReconcile = defineFunction({
+    name: "countersReconcile",
+    description: "Reconcile aggregated counters against source-of-truth queries (daily 03:00 UTC).",
+    trigger: { kind: "schedule", cron: "0 3 * * *", timeZone: "UTC" },
+    handler: countersReconcileHandler,
+    options: { region: REGION, timeoutSeconds: 540, memory: "256MiB", maxInstances: 1 },
+});
+export const positionsReconcile = defineFunction({
+    name: "positionsReconcile",
+    description: "Reconcile bid/auction positions (daily 03:30 UTC).",
+    trigger: { kind: "schedule", cron: "30 3 * * *", timeZone: "UTC" },
+    handler: positionsReconcileHandler,
+    options: { region: REGION, timeoutSeconds: 120, memory: "256MiB", maxInstances: 1 },
+});
+export const payoutBatch = defineFunction({
+    name: "payoutBatch",
+    description: "Dispatch the day's payout batch (daily 06:00 UTC).",
+    trigger: { kind: "schedule", cron: "0 6 * * *", timeZone: "UTC" },
+    handler: payoutBatchHandler,
+    options: { region: REGION, timeoutSeconds: 540, memory: "256MiB", maxInstances: 1 },
+});
+export const cartPrune = defineFunction({
+    name: "cartPrune",
+    description: "Prune abandoned carts (weekly Sunday 04:00 UTC).",
+    trigger: { kind: "schedule", cron: "0 4 * * 0", timeZone: "UTC" },
+    handler: cartPruneHandler,
+    options: { region: REGION, timeoutSeconds: 120, memory: "256MiB", maxInstances: 1 },
+});
+export const notificationPrune = defineFunction({
+    name: "notificationPrune",
+    description: "Prune read notifications older than retention window (weekly Monday 01:00 UTC).",
+    trigger: { kind: "schedule", cron: "0 1 * * 1", timeZone: "UTC" },
+    handler: notificationPruneHandler,
+    options: { region: REGION, timeoutSeconds: 120, memory: "256MiB", maxInstances: 1 },
+});
+export const weeklyPayoutEligibility = defineFunction({
+    name: "weeklyPayoutEligibility",
+    description: "Recompute seller payout eligibility weekly (Saturday 05:00 UTC).",
+    trigger: { kind: "schedule", cron: "0 5 * * 6", timeZone: "UTC" },
+    handler: weeklyPayoutEligibilityHandler,
+    options: { region: REGION, timeoutSeconds: 540, memory: "256MiB", maxInstances: 1 },
+});
+export const autoPayoutEligibility = defineFunction({
+    name: "autoPayoutEligibility",
+    description: "Recompute auto-payout eligibility (daily 04:45 UTC).",
+    trigger: { kind: "schedule", cron: "45 4 * * *", timeZone: "UTC" },
+    handler: autoPayoutEligibilityHandler,
+    options: { region: REGION, timeoutSeconds: 540, memory: "256MiB", maxInstances: 1 },
+});
+export const cleanupRtdbEvents = defineFunction({
+    name: "cleanupRtdbEvents",
+    description: "Reap stale RTDB auth-event nodes every 5 minutes.",
+    trigger: { kind: "schedule", cron: EVERY_5_MIN },
+    handler: cleanupRtdbEventsHandler,
+    options: { region: REGION, timeoutSeconds: 60, memory: "256MiB", maxInstances: 1 },
+});
+export const mediaTmpCleanup = defineFunction({
+    name: "mediaTmpCleanup",
+    description: "Delete orphaned tmp/* media uploads (daily 04:30 IST).",
+    trigger: { kind: "schedule", cron: "30 4 * * *", timeZone: "Asia/Kolkata" },
+    handler: mediaTmpCleanupHandler,
+    options: { region: REGION, timeoutSeconds: 540, memory: "256MiB", maxInstances: 1 },
+});
+export const draftPrune = defineFunction({
+    name: "draftPrune",
+    description: "Prune store form drafts older than 30 days (weekly Sunday 03:00 UTC).",
+    trigger: { kind: "schedule", cron: "0 3 * * 0", timeZone: "UTC" },
+    handler: draftPruneHandler,
+    options: { region: REGION, timeoutSeconds: 300, memory: "256MiB", maxInstances: 1 },
+});
+export const prizeRevealOpen = defineFunction({
+    name: "prizeRevealOpen",
+    description: "Flip prize-draw reveals pending→open and send opening notifications.",
+    trigger: { kind: "schedule", cron: EVERY_5_MIN },
+    handler: prizeRevealOpenHandler,
+    options: { region: REGION, timeoutSeconds: 120, memory: "256MiB", maxInstances: 1 },
+});
+export const prizeRevealClose = defineFunction({
+    name: "prizeRevealClose",
+    description: "Flip prize-draw reveals open→closed.",
+    trigger: { kind: "schedule", cron: EVERY_5_MIN },
+    handler: prizeRevealCloseHandler,
+    options: { region: REGION, timeoutSeconds: 60, memory: "256MiB", maxInstances: 1 },
+});
+export const prizeRevealExpiry = defineFunction({
+    name: "prizeRevealExpiry",
+    description: "Auto-refund unrevealed prize-draw entries past deadline (every 6 hours UTC).",
+    trigger: { kind: "schedule", cron: "0 */6 * * *", timeZone: "UTC" },
+    handler: prizeRevealExpiryHandler,
+    options: { region: REGION, timeoutSeconds: 300, memory: "256MiB", maxInstances: 1 },
+});
+export const prizeRevealReminder = defineFunction({
+    name: "prizeRevealReminder",
+    description: "Nudge prize-draw buyers <24h to deadline (daily 10:00 IST).",
+    trigger: { kind: "schedule", cron: "0 10 * * *", timeZone: "Asia/Kolkata" },
+    handler: prizeRevealReminderHandler,
+    options: { region: REGION, timeoutSeconds: 300, memory: "256MiB", maxInstances: 1 },
+});
+export const bundleStockSync = defineFunction({
+    name: "bundleStockSync",
+    description: "Flip bundle isSold when any item runs OOS (daily 10:05 IST).",
+    trigger: { kind: "schedule", cron: "5 10 * * *", timeZone: "Asia/Kolkata" },
+    handler: bundleStockSyncHandler,
+    options: { region: REGION, timeoutSeconds: 540, memory: "256MiB", maxInstances: 1 },
+});
+export const SCHEDULED_FUNCTIONS = [
+    auctionSettlement,
+    pendingOrderTimeout,
+    couponExpiry,
+    offerExpiry,
+    productStatsSync,
+    dailyDataCleanup,
+    countersReconcile,
+    positionsReconcile,
+    payoutBatch,
+    cartPrune,
+    notificationPrune,
+    weeklyPayoutEligibility,
+    autoPayoutEligibility,
+    cleanupRtdbEvents,
+    mediaTmpCleanup,
+    draftPrune,
+    prizeRevealOpen,
+    prizeRevealClose,
+    prizeRevealExpiry,
+    prizeRevealReminder,
+    bundleStockSync,
+];