@mohasinac/appkit 2.6.3 → 2.6.4

package/dist/_internal/server/jobs/handlers/cleanupRtdbEvents.js

@@ -1,45 +1,2 @@
-import { getAdminAuth, getAdminRealtimeDb } from "../../../../providers/db-firebase";
-const AUTH_STALE_MS = 3 * 60 * 1000;
-const PAYMENT_STALE_MS = 15 * 60 * 1000;
-export const cleanupRtdbEventsHandler = async (ctx) => {
-    ctx.logger.info("Starting RTDB events cleanup");
-    const rtdb = getAdminRealtimeDb();
-    const auth = getAdminAuth();
-    const now = Date.now();
-    try {
-        const authSnap = await rtdb.ref("auth_events").get();
-        if (authSnap.exists()) {
-            const allEvents = authSnap.val();
-            const staleAuthIds = Object.entries(allEvents)
-                .filter(([, node]) => (node.createdAt ?? 0) < now - AUTH_STALE_MS)
-                .map(([id]) => id);
-            if (staleAuthIds.length > 0) {
-                await Promise.all(staleAuthIds.flatMap((id) => [
-                    rtdb.ref(`auth_events/${id}`).remove(),
-                    auth.deleteUser(`auth_event_${id}`).catch(() => { }),
-                ]));
-                ctx.logger.info("Auth events removed", { count: staleAuthIds.length });
-            }
-        }
-    }
-    catch (authErr) {
-        ctx.logger.error("Auth events cleanup failed (non-fatal)", authErr);
-    }
-    try {
-        const paySnap = await rtdb.ref("payment_events").get();
-        if (paySnap.exists()) {
-            const allPayments = paySnap.val();
-            const stalePayIds = Object.entries(allPayments)
-                .filter(([, node]) => (node.createdAt ?? 0) < now - PAYMENT_STALE_MS)
-                .map(([id]) => id);
-            if (stalePayIds.length > 0) {
-                await Promise.all(stalePayIds.map((id) => rtdb.ref(`payment_events/${id}`).remove()));
-                ctx.logger.info("Payment events removed", { count: stalePayIds.length });
-            }
-        }
-    }
-    catch (payErr) {
-        ctx.logger.error("Payment events cleanup failed (non-fatal)", payErr);
-    }
-    ctx.logger.info("RTDB events cleanup complete");
-};
+import { runCleanupRtdbEvents } from "../core/cleanupRtdbEvents";
+export const cleanupRtdbEventsHandler = runCleanupRtdbEvents;

package/dist/_internal/server/jobs/handlers/countersReconcile.js

@@ -1,109 +1,2 @@
-import { categoriesRepository, reviewRepository, storeRepository, } from "../../../../repositories";
-import { ProductStatusValues, PRODUCT_COLLECTION } from "../../../../features/products/schemas/firestore";
-import { QUERY_LIMIT } from "./messages";
-const STORES_COLLECTION = "stores";
-const ORDERS_COLLECTION = "orders";
-async function reconcileCategories(ctx) {
-    const snap = await ctx.db
-        .collection(PRODUCT_COLLECTION)
-        .where("status", "==", ProductStatusValues.PUBLISHED)
-        .limit(QUERY_LIMIT)
-        .get();
-    ctx.logger.info(`[categories] ${snap.size} published products found`);
-    const leafCounts = {};
-    for (const doc of snap.docs) {
-        // SB1-G — split off canonical listingType. Auctions go into auctionIds;
-        // everything else (standard, pre-order, prize-draw, bundle) into productIds.
-        const data = doc.data();
-        const catId = data.category;
-        if (!catId)
-            continue;
-        if (!leafCounts[catId])
-            leafCounts[catId] = { productIds: [], auctionIds: [] };
-        if (data.listingType === "auction")
-            leafCounts[catId].auctionIds.push(doc.id);
-        else
-            leafCounts[catId].productIds.push(doc.id);
-    }
-    const ancestorAggregates = {};
-    let leafUpdated = 0;
-    for (const [catId, { productIds, auctionIds }] of Object.entries(leafCounts)) {
-        await categoriesRepository.setMetrics(catId, productIds.length, auctionIds.length, productIds, auctionIds);
-        leafUpdated++;
-        const parentIds = (await categoriesRepository.findById(catId))?.parentIds ?? [];
-        for (const ancestorId of parentIds) {
-            if (!ancestorAggregates[ancestorId]) {
-                ancestorAggregates[ancestorId] = { productDelta: 0, auctionDelta: 0 };
-            }
-            ancestorAggregates[ancestorId].productDelta += productIds.length;
-            ancestorAggregates[ancestorId].auctionDelta += auctionIds.length;
-        }
-    }
-    const ancestorEntries = Object.entries(ancestorAggregates);
-    for (const [ancestorId, { productDelta, auctionDelta }] of ancestorEntries) {
-        await categoriesRepository.setMetrics(ancestorId, productDelta, auctionDelta, [], []);
-    }
-    ctx.logger.info("[categories] reconciliation complete", {
-        leafCategoriesUpdated: leafUpdated,
-        ancestorCategoriesUpdated: ancestorEntries.length,
-    });
-}
-async function reconcileStores(ctx) {
-    const storeIds = await storeRepository.listIds();
-    ctx.logger.info(`[stores] ${storeIds.length} stores found`);
-    let processed = 0;
-    let errors = 0;
-    for (const storeId of storeIds) {
-        try {
-            const storeSnap = await ctx.db.collection(STORES_COLLECTION).doc(storeId).get();
-            if (!storeSnap.exists)
-                continue;
-            const sellerId = storeSnap.data().ownerId;
-            if (!sellerId)
-                continue;
-            const [productsSnap, ordersSnap, reviewStats] = await Promise.all([
-                ctx.db
-                    .collection(PRODUCT_COLLECTION)
-                    .where("sellerId", "==", sellerId)
-                    .where("status", "==", ProductStatusValues.PUBLISHED)
-                    .limit(QUERY_LIMIT)
-                    .get(),
-                ctx.db
-                    .collection(ORDERS_COLLECTION)
-                    .where("sellerId", "==", sellerId)
-                    .where("status", "==", "delivered")
-                    .limit(QUERY_LIMIT)
-                    .get(),
-                reviewRepository.getApprovedRatingAggregateByStore(storeId),
-            ]);
-            await storeRepository.setStats(storeId, productsSnap.size, ordersSnap.size, reviewStats.count, reviewStats.count > 0 ? reviewStats.avgRating : null);
-            processed++;
-        }
-        catch (storeErr) {
-            errors++;
-            ctx.logger.error(`[stores] failed for store ${storeId}`, storeErr);
-        }
-    }
-    ctx.logger.info("[stores] reconciliation complete", {
-        processed,
-        errors,
-        total: storeIds.length,
-    });
-}
-export const countersReconcileHandler = async (ctx) => {
-    ctx.logger.info("Starting counters reconciliation (categories + stores)");
-    try {
-        await reconcileCategories(ctx);
-    }
-    catch (err) {
-        ctx.logger.error("Category reconciliation failed", err);
-    }
-    try {
-        await reconcileStores(ctx);
-    }
-    catch (err) {
-        ctx.logger.error("Store reconciliation failed", err);
-        throw err;
-    }
-    ctx.logger.info("Counters reconciliation complete");
-};
+import { runCountersReconcile } from "../core/countersReconcile";
+export const countersReconcileHandler = runCountersReconcile;

package/dist/_internal/server/jobs/handlers/couponExpiry.js

@@ -1,13 +1,2 @@
-import { couponsRepository } from "../../../../repositories";
-export const couponExpiryHandler = async (ctx) => {
-    ctx.logger.info("Starting coupon expiry sweep");
-    const refs = await couponsRepository.getExpiredActiveRefs(ctx.now);
-    if (refs.length === 0) {
-        ctx.logger.info("No expired active coupons found");
-        return;
-    }
-    const batch = ctx.db.batch();
-    refs.forEach((ref) => couponsRepository.deactivateInBatch(batch, ref));
-    await batch.commit();
-    ctx.logger.info("Coupon expiry complete", { deactivated: refs.length });
-};
+import { runCouponExpiry } from "../core/couponExpiry";
+export const couponExpiryHandler = runCouponExpiry;

package/dist/_internal/server/jobs/handlers/dailyDataCleanup.js

@@ -1,20 +1,2 @@
-import { sessionRepository, tokenRepository } from "../../../../repositories";
-import { batchDelete } from "./_helpers";
-export const dailyDataCleanupHandler = async (ctx) => {
-    ctx.logger.info("Starting daily data cleanup (sessions + tokens)");
-    const sessionRefs = await sessionRepository.getExpiredRefs(ctx.now);
-    const sessionsDeleted = await batchDelete(ctx, sessionRefs);
-    ctx.logger.info("Session cleanup complete", { deleted: sessionsDeleted });
-    const emailRefs = await tokenRepository.getExpiredEmailVerificationRefs(ctx.now);
-    const emailDeleted = await batchDelete(ctx, emailRefs);
-    const pwRefs = await tokenRepository.getExpiredPasswordResetRefs(ctx.now);
-    const pwDeleted = await batchDelete(ctx, pwRefs);
-    ctx.logger.info("Token cleanup complete", {
-        emailVerificationDeleted: emailDeleted,
-        passwordResetDeleted: pwDeleted,
-    });
-    ctx.logger.info("Daily data cleanup complete", {
-        sessionsDeleted,
-        tokensDeleted: emailDeleted + pwDeleted,
-    });
-};
+import { runDailyDataCleanup } from "../core/dailyDataCleanup";
+export const dailyDataCleanupHandler = runDailyDataCleanup;

package/dist/_internal/server/jobs/handlers/listingProcessor.d.ts

@@ -1,30 +1,5 @@
-/**
- * HTTPS callable handler: server-to-server listing proxy. Every appkit
- * repository routes its `.list()` through the same Sieve adapter, so adding
- * a new collection is a one-line addition to `LISTERS`.
- *
- * Cursor: opaque base64 over `{ page }`. Callers may use either page-mode
- * (`p` directly) or infinite-mode (forward `cursor` from previous response).
- */
 import type { CallableHandler } from "../runtime/types";
-export interface ListingRequestBody {
-    collection: string;
-    q?: string;
-    f?: string;
-    s?: string;
-    p?: number | string;
-    ps?: number | string;
-    cursor?: string;
-    baseOpts?: Record<string, unknown>;
-}
-export interface ListingResponseBody {
-    items: unknown[];
-    total: number;
-    page: number;
-    pageSize: number;
-    totalPages: number;
-    hasMore: boolean;
-    cursor: string | null;
-}
+import { supportedListingCollections, type ListingRequestBody, type ListingResponseBody } from "../core/listingProcessor";
+export type { ListingRequestBody, ListingResponseBody };
+export { supportedListingCollections };
 export declare const listingProcessorHandler: CallableHandler<ListingRequestBody, ListingResponseBody>;
-export declare const supportedListingCollections: string[];

package/dist/_internal/server/jobs/handlers/listingProcessor.js

@@ -1,138 +1,3 @@
-/**
- * HTTPS callable handler: server-to-server listing proxy. Every appkit
- * repository routes its `.list()` through the same Sieve adapter, so adding
- * a new collection is a one-line addition to `LISTERS`.
- *
- * Cursor: opaque base64 over `{ page }`. Callers may use either page-mode
- * (`p` directly) or infinite-mode (forward `cursor` from previous response).
- */
-import { bidRepository, blogRepository, categoriesRepository, couponsRepository, eventEntryRepository, eventRepository, faqsRepository, homepageSectionsRepository, notificationRepository, orderRepository, payoutRepository, productFeaturesRepository, productRepository, productTemplateRepository, reviewRepository, scammerRepository, storeRepository, userRepository, } from "../../../../repositories";
-const DEFAULT_SORT = "-createdAt";
-const DEFAULT_PAGE = 1;
-const DEFAULT_PAGE_SIZE = 20;
-const MAX_PAGE_SIZE = 100;
-class ListingError extends Error {
-    constructor(status, message) {
-        super(message);
-        this.name = "ListingError";
-        this.httpStatus = status;
-    }
-}
-function requireOpt(baseOpts, key, collection) {
-    const value = baseOpts[key];
-    if (typeof value !== "string" || value.length === 0) {
-        throw new ListingError(400, `${collection} listing requires baseOpts.${key}`);
-    }
-    return value;
-}
-function getBoolOpt(baseOpts, key, fallback) {
-    const value = baseOpts[key];
-    if (typeof value === "boolean")
-        return value;
-    if (value === "true")
-        return true;
-    if (value === "false")
-        return false;
-    return fallback;
-}
-const LISTERS = {
-    products: (m, o) => productRepository.list(m, o),
-    categories: (m) => categoriesRepository.list(m),
-    brands: (m) => categoriesRepository.list({
-        ...m,
-        filters: m.filters
-            ? `${m.filters},categoryType==brand`
-            : "categoryType==brand",
-    }),
-    orders: (m) => orderRepository.listAll(m),
-    reviews: (m) => reviewRepository.listAll(m),
-    coupons: (m) => couponsRepository.list(m),
-    bids: (m) => bidRepository.list(m),
-    payouts: (m) => payoutRepository.list(m),
-    blogPosts: (m) => blogRepository.listAll(m),
-    events: (m) => eventRepository.list(m),
-    faqs: (m) => faqsRepository.list(m),
-    notifications: (m) => notificationRepository.list(m),
-    scammers: (m) => scammerRepository.listAll(m),
-    sublistingCategories: (m) => categoriesRepository.list({
-        ...m,
-        filters: m.filters
-            ? `${m.filters},categoryType==sublisting`
-            : "categoryType==sublisting",
-    }),
-    productFeatures: (m) => productFeaturesRepository.list(m),
-    homepageSections: (m) => homepageSectionsRepository.list(m),
-    users: (m) => userRepository.list(m),
-    stores: (m, o) => storeRepository.listStores(m, getBoolOpt(o, "activeOnly", true)),
-    eventEntries: (m, o) => {
-        const eventId = requireOpt(o, "eventId", "eventEntries");
-        return eventEntryRepository.listForEvent(eventId, m);
-    },
-    productTemplates: (m, o) => {
-        const storeId = requireOpt(o, "storeId", "productTemplates");
-        return productTemplateRepository.listByStore(storeId, m);
-    },
-};
-const SUPPORTED_COLLECTIONS = Object.keys(LISTERS);
-function decodeCursor(cursor) {
-    if (!cursor)
-        return null;
-    try {
-        const json = Buffer.from(cursor, "base64").toString("utf8");
-        const parsed = JSON.parse(json);
-        const page = Number(parsed.page);
-        return Number.isFinite(page) && page > 0 ? page : null;
-    }
-    catch {
-        return null;
-    }
-}
-function encodeCursor(page) {
-    return Buffer.from(JSON.stringify({ page }), "utf8").toString("base64");
-}
-function clampPageSize(raw) {
-    const n = Number(raw);
-    if (!Number.isFinite(n) || n <= 0)
-        return DEFAULT_PAGE_SIZE;
-    return Math.min(Math.floor(n), MAX_PAGE_SIZE);
-}
-function clampPage(raw) {
-    const n = Number(raw);
-    if (!Number.isFinite(n) || n < 1)
-        return DEFAULT_PAGE;
-    return Math.floor(n);
-}
-export const listingProcessorHandler = async (body, ctx) => {
-    if (!body || typeof body.collection !== "string") {
-        throw new ListingError(400, "Missing collection");
-    }
-    const lister = LISTERS[body.collection];
-    if (!lister) {
-        throw new ListingError(400, `Unsupported collection: ${body.collection}. Supported: ${SUPPORTED_COLLECTIONS.join(",")}`);
-    }
-    const cursorPage = decodeCursor(body.cursor);
-    const page = cursorPage ?? clampPage(body.p);
-    const pageSize = clampPageSize(body.ps);
-    const result = await lister({
-        filters: body.f ?? "",
-        sorts: body.s ?? DEFAULT_SORT,
-        page: String(page),
-        pageSize: String(pageSize),
-    }, body.baseOpts ?? {});
-    ctx.logger.info("listing served", {
-        collection: body.collection,
-        page: result.page,
-        pageSize: result.pageSize,
-        total: result.total,
-    });
-    return {
-        items: result.items,
-        total: result.total,
-        page: result.page,
-        pageSize: result.pageSize,
-        totalPages: result.totalPages,
-        hasMore: result.hasMore,
-        cursor: result.hasMore ? encodeCursor(result.page + 1) : null,
-    };
-};
-export const supportedListingCollections = SUPPORTED_COLLECTIONS;
+import { runListingProcessor, supportedListingCollections, } from "../core/listingProcessor";
+export { supportedListingCollections };
+export const listingProcessorHandler = runListingProcessor;

package/dist/_internal/server/jobs/handlers/mediaTmpCleanup.d.ts

@@ -1,14 +1,2 @@
-/**
- * Job handler: media tmp cleanup.
- *
- * Sweeps Firebase Storage for stale objects under the tmp/ prefix. Layer 2 of
- * the dual-layer scheme — Layer 1 is the form-level onAbort() DELETE call;
- * this job mops up anything that escaped (crashes, expired sessions).
- *
- * Safety invariants:
- *  - Only touches objects whose name starts with `tmp/`.
- *  - Only deletes objects older than `ttlHours` (default 24).
- *  - Idempotent: 404s on delete are swallowed (Layer 1 already removed it).
- */
 import type { ScheduleHandler } from "../runtime/types";
 export declare const mediaTmpCleanupHandler: ScheduleHandler;

package/dist/_internal/server/jobs/handlers/mediaTmpCleanup.js

@@ -1,69 +1,2 @@
-/**
- * Job handler: media tmp cleanup.
- *
- * Sweeps Firebase Storage for stale objects under the tmp/ prefix. Layer 2 of
- * the dual-layer scheme — Layer 1 is the form-level onAbort() DELETE call;
- * this job mops up anything that escaped (crashes, expired sessions).
- *
- * Safety invariants:
- *  - Only touches objects whose name starts with `tmp/`.
- *  - Only deletes objects older than `ttlHours` (default 24).
- *  - Idempotent: 404s on delete are swallowed (Layer 1 already removed it).
- */
-import { getAdminStorageLite } from "../../../../providers/db-firebase/admin-storage-lite";
-const TMP_PREFIX = "tmp/";
-const DEFAULT_TTL_HOURS = 24;
-function getBucket() {
-    const bucketName = process.env.FIREBASE_ADMIN_STORAGE_BUCKET?.trim() ??
-        process.env.NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET?.trim();
-    return bucketName ? getAdminStorageLite().bucket(bucketName) : getAdminStorageLite().bucket();
-}
-export const mediaTmpCleanupHandler = async (ctx) => {
-    const ttlHours = Number(ctx.env("MEDIA_TMP_TTL_HOURS") ?? DEFAULT_TTL_HOURS);
-    const cutoff = new Date(Date.now() - ttlHours * 60 * 60 * 1000);
-    ctx.logger.info("Starting media tmp cleanup", { prefix: TMP_PREFIX, ttlHours });
-    let scanned = 0;
-    let deleted = 0;
-    let skipped = 0;
-    let errors = 0;
-    try {
-        const bucket = getBucket();
-        const [files] = await bucket.getFiles({ prefix: TMP_PREFIX, autoPaginate: true });
-        scanned = files.length;
-        ctx.logger.info("Objects under tmp prefix", { count: scanned });
-        for (const file of files) {
-            try {
-                if (!file.name.startsWith(TMP_PREFIX)) {
-                    skipped++;
-                    continue;
-                }
-                const [metadata] = await file.getMetadata();
-                const updated = metadata.updated ?? metadata.timeCreated;
-                if (!updated) {
-                    skipped++;
-                    continue;
-                }
-                if (new Date(updated) >= cutoff) {
-                    skipped++;
-                    continue;
-                }
-                await file.delete();
-                deleted++;
-            }
-            catch (fileError) {
-                errors++;
-                const code = fileError?.code;
-                if (code === 404) {
-                    // Already deleted by Layer 1 — ignore.
-                    continue;
-                }
-                ctx.logger.error("Failed to delete tmp file", fileError, { name: file.name });
-            }
-        }
-    }
-    catch (err) {
-        ctx.logger.error("Fatal error during media tmp cleanup", err);
-        throw err;
-    }
-    ctx.logger.info("Media tmp cleanup complete", { scanned, deleted, skipped, errors });
-};
+import { runMediaTmpCleanup } from "../core/mediaTmpCleanup";
+export const mediaTmpCleanupHandler = runMediaTmpCleanup;

package/dist/_internal/server/jobs/handlers/notificationPrune.js

@@ -1,13 +1,2 @@
-import { notificationRepository } from "../../../../repositories";
-import { NOTIFICATION_TTL_DAYS } from "./messages";
-import { batchDelete } from "./_helpers";
-export const notificationPruneHandler = async (ctx) => {
-    ctx.logger.info(`Pruning read notifications older than ${NOTIFICATION_TTL_DAYS} days`);
-    const refs = await notificationRepository.getOldReadRefs(NOTIFICATION_TTL_DAYS);
-    if (refs.length === 0) {
-        ctx.logger.info("No stale read notifications found");
-        return;
-    }
-    const deleted = await batchDelete(ctx, refs);
-    ctx.logger.info("Notification prune complete", { deleted });
-};
+import { runNotificationPrune } from "../core/notificationPrune";
+export const notificationPruneHandler = runNotificationPrune;

package/dist/_internal/server/jobs/handlers/offerExpiry.js

@@ -1,50 +1,2 @@
-import { offerRepository, notificationRepository } from "../../../../repositories";
-export const offerExpiryHandler = async (ctx) => {
-    ctx.logger.info("Starting offer expiry sweep");
-    let expiredOffers;
-    try {
-        expiredOffers = await offerRepository.findExpiredActive(ctx.now);
-    }
-    catch (err) {
-        ctx.logger.error("Failed to query expired offers", err);
-        throw err;
-    }
-    if (expiredOffers.length === 0) {
-        ctx.logger.info("No expired offers found");
-        return;
-    }
-    ctx.logger.info(`Found ${expiredOffers.length} expired offer(s) to process`);
-    const expiredIds = [];
-    for (const offer of expiredOffers) {
-        try {
-            expiredIds.push(offer.id);
-            await notificationRepository.create({
-                userId: offer.buyerUid,
-                type: "offer_expired",
-                priority: "normal",
-                title: "Offer expired",
-                message: `Your offer on "${offer.productTitle}" expired without a response.`,
-                relatedId: offer.id,
-                relatedType: "offer",
-            });
-        }
-        catch (err) {
-            ctx.logger.warn(`Failed to process expiry for offer ${offer.id}`, {
-                error: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-    if (expiredIds.length > 0) {
-        try {
-            await offerRepository.expireMany(expiredIds);
-        }
-        catch (err) {
-            ctx.logger.error("Failed to batch-expire offers", err);
-            throw err;
-        }
-    }
-    ctx.logger.info("Offer expiry complete", {
-        processed: expiredIds.length,
-        skipped: expiredOffers.length - expiredIds.length,
-    });
-};
+import { runOfferExpiry } from "../core/offerExpiry";
+export const offerExpiryHandler = runOfferExpiry;

package/dist/_internal/server/jobs/handlers/onBidPlaced.d.ts

@@ -1,12 +1,3 @@
 import type { FirestoreTriggerHandler } from "../runtime/types";
-interface NewBid {
-    id: string;
-    productId: string;
-    productTitle: string;
-    userId: string;
-    userName: string;
-    bidAmount: number;
-    currency: string;
-}
+import { type NewBid } from "../core/onBidPlaced";
 export declare const onBidPlacedHandler: FirestoreTriggerHandler<null, NewBid>;
-export {};

package/dist/_internal/server/jobs/handlers/onBidPlaced.js

@@ -1,63 +1,9 @@
-import { bidRepository, notificationRepository, productRepository, } from "../../../../repositories";
-import { decryptPii } from "../../../../security/index";
-import { getAdminRealtimeDb } from "../../../../providers/db-firebase";
-import { BID_MESSAGES } from "./messages";
-const BIDS_COLLECTION = "bids";
+import { handleBidPlaced } from "../core/onBidPlaced";
 export const onBidPlacedHandler = async (event, ctx) => {
     const newBid = event.after;
     if (!newBid) {
         ctx.logger.error("No snapshot data", null);
         return;
     }
-    newBid.userName = decryptPii(newBid.userName);
-    try {
-        const prevWinning = await bidRepository.getWinningBid(newBid.productId);
-        const batch = ctx.db.batch();
-        const newBidRef = ctx.db.collection(BIDS_COLLECTION).doc(event.params.bidId);
-        bidRepository.markWinning(batch, newBidRef);
-        let outbidUserId = null;
-        if (prevWinning && prevWinning.data.userId !== newBid.userId) {
-            outbidUserId = prevWinning.data.userId;
-            bidRepository.markOutbid(batch, prevWinning.ref);
-            notificationRepository.createInBatch(batch, {
-                userId: outbidUserId,
-                type: "bid_outbid",
-                priority: "high",
-                title: BID_MESSAGES.OUTBID_TITLE,
-                message: BID_MESSAGES.OUTBID_MESSAGE(newBid.productTitle, newBid.currency, newBid.bidAmount),
-                relatedId: newBid.productId,
-                relatedType: "product",
-            });
-        }
-        productRepository.incrementBidCountInBatch(batch, newBid.productId, newBid.bidAmount);
-        await batch.commit();
-        try {
-            if (outbidUserId) {
-                await getAdminRealtimeDb()
-                    .ref(`notifications/${outbidUserId}`)
-                    .push({
-                    type: "bid_outbid",
-                    title: BID_MESSAGES.OUTBID_TITLE,
-                    message: BID_MESSAGES.OUTBID_MESSAGE(newBid.productTitle, newBid.currency, newBid.bidAmount),
-                    timestamp: Date.now(),
-                    read: false,
-                });
-            }
-        }
-        catch (rtdbError) {
-            ctx.logger.error("Realtime DB push failed (non-fatal)", rtdbError);
-        }
-        ctx.logger.info(`Bid placed on ${newBid.productId}`, {
-            bidId: event.params.bidId,
-            amount: newBid.bidAmount,
-            outbidUserId,
-        });
-    }
-    catch (error) {
-        ctx.logger.error("Error handling bid placement", error, {
-            bidId: event.params.bidId,
-            productId: newBid.productId,
-        });
-        throw error;
-    }
+    await handleBidPlaced({ bidId: event.params.bidId, bid: newBid }, ctx);
 };

package/dist/_internal/server/jobs/handlers/onCategoryWrite.d.ts

@@ -1,10 +1,3 @@
-/**
- * Trigger handler: maintain DFS `position` + `subtreeSize` on every category
- * write. CREATE → insert into parent's subtree + shift later siblings;
- * DELETE → shift back; MOVE → mark `positionDirty` so the nightly reconcile
- * job rebuilds (real-time move would require repositioning an entire subtree).
- */
 import type { FirestoreTriggerHandler } from "../runtime/types";
-type CategoryDoc = Record<string, unknown>;
+import { type CategoryDoc } from "../core/onCategoryWrite";
 export declare const onCategoryWriteHandler: FirestoreTriggerHandler<CategoryDoc, CategoryDoc>;
-export {};